Skip to content

feat(reports): preserve leftover-axis singular badges for serialized reconstruction - #823

Draft
seonghobae wants to merge 2 commits into
feat/leftover-map-compare-item-coverage-v2470from
feat/leftover-map-axis-singular-v2470
Draft

feat(reports): preserve leftover-axis singular badges for serialized reconstruction#823
seonghobae wants to merge 2 commits into
feat/leftover-map-compare-item-coverage-v2470from
feat/leftover-map-axis-singular-v2470

Conversation

@seonghobae

@seonghobae seonghobae commented Aug 30, 2026

Copy link
Copy Markdown
Contributor

Summary

Reconstruct the valid leftover-axis singular-value report-badge delta on the exact current #822 parent without preserving the historical ADR/release collision or stale ancestry.

Current ancestry / identity authority

#823 now targets and contains exact #822@724872a34469c84064d5a72b07c6acf16de8a760. Product head is d9db46353c4a5ca5298b1376d27570b7091b59b3; it preserves historical #823 head eb172c40d8ecd08f3e1c220cbf3117b488cddb30 as first parent and exact #822 as second parent, with the independently GREEN clean tree from reconstruction run 34068005539. Promotion was non-force.

Current identity order is #820 ADR0289/v2.46.0 → #821 ADR0290/v2.47.0 → #822 ADR0291/v2.48.0 → #823 ADR0292/v2.49.0. ADR0292 remains Proposed while this PR is Draft. The historical ADR0290/v2.47.0 identity is evidence only and is not promoted.

The product delta remains deliberately narrow: leftover-axis report badges name persisted finite, non-negative σ_k, including rank-0 σ 0.00, independently of axis share; missing/non-finite/negative singular values omit only the singular-value caption; never infer σ_k from share. No SQL/schema/new measurement authority.

RED → repair → GREEN evidence

Fresh review 5127059551 confirmed the stale-parent/identity collision. Reconstruction r1 proved that the historical UI delta reapplies cleanly and reproduced the ADR0292 governance RED, then failed only because its ARCHITECTURE documentation insertion marker did not match current #822 wording; no product GREEN was claimed from r1.

r2 34068005539 restarted from exact #822, reproduced the same governance RED, applied the minimal ADR0292/v2.49 identity/documentation repair, then passed ADR0290/0291/0292 governance and package-version tests, focused singular-badge/App/i18n tests, oxlint, production build, Storybook build, reconstructed-authority verification, and workflow-free clean staging creation. Clean staging commit 82bad547a89e765386f431fc6d7ac2d97369f2b9 has tree 07beee3a173ea915c8dc0004366056802ae931e7 and exact #822 as its sole parent; the product merge commit uses that exact tree.

Descendant boundary

#824 is now refreshed to this exact product head as its base and remains the next serialized valid delta, planned as ADR0293/v2.50.0. #825 remains after #824. Their historical ADR/release numbers remain evidence only; do not close valid deltas, bypass parents, force-push, destructively rebase, self-approve, or reuse predecessor GREEN.

UI / i18n delivery boundary

This is material report UI. The canonical eight-locale/versioned translation-ledger and material-screen consumer path remain owned by #922/#929/#932; this PR does not create a competing translation ledger. Current reconstruction proves source contracts, lint, production build, and Storybook build, but fresh exact-product-head rendered browser/responsive/keyboard/focus/a11y evidence and eight-locale ledger consumption are still required before UI delivery can be called complete.

Evidence boundary

Keep Draft. Isolated reconstruction GREEN is not hosted exact-product-head required-check GREEN, authenticated PostgreSQL/k6 acceptance, browser/a11y acceptance, immutable release evidence, or a qualifying independent current-head APPROVE.

Jeon, M., Jin, I. H., Schweinberger, M., & Baugh, S. (2021). Mapping unobserved item–respondent interactions: A latent space item response model with interaction map. Psychometrika, 86(2), 378–403.

Gabriel, K. R. (1971). The biplot graphic display of matrices with application to principal component analysis. Biometrika, 58(3), 453–467.

…v2.47.0)

Caption leftover-axis report badges with persisted leftover-map singular
values σ_k when finite and non-negative (ADR 0290). Pair-list leftover-axis
badges stay distinct from leftover-map graphic axis captions. Do not invent
σ_k from leftover-map axis share. UI-only; no SQL; no new columns. Never
invent a leftover score. Never invent a theta.
@coderabbitai

coderabbitai Bot commented Aug 30, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Copy link
Copy Markdown
Contributor Author

Write-retry this cycle (seonghobae gh). #823 is leftover-map v2.47 leftover-axis badge singular values at eb172c40 (ADR 0290), stacked on #820. Do not squash-merge onto an unprotected leftover base. Do not self-approve. Independent APPROVE still required. Copilot/Devin COMMENT is not independent APPROVE. Do not merge #808 without independent APPROVE. Issues #79 and #87 stay open. Grouping comparison strip (ADR 0149) does not gain leftover-map captions.

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 2 potential issues.

Devin Review

Comment on lines +13 to +17
export function leftoverMapAxisBadgeShare(
leftoverShare: LeftoverMapAxis["leftover_share"] | null | undefined,
): string {
return ((leftoverShare ?? Number.NaN) * 100).toFixed(0);
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 Info: Malformed shares remain contract-excluded

leftoverMapAxisBadgeShare can render NaN%, matching the previous formatter. Database constraints and backend serialization exclude such values from this API.

Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Comment on lines +19 to +27
export function leftoverMapAxisBadgeSingular(
axis: Pick<LeftoverMapAxis, "axis_index"> & {
leftover_singular_value?: LeftoverMapAxis["leftover_singular_value"] | null;
},
): string | null {
return formatLeftoverMapPlotAxisSingular(
leftoverSingularForAxis([axis], axis.axis_index),
);
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 Info: Badge validation matches plot validation

leftoverMapAxisBadgeSingular reuses the plot helpers. Invalid values remain hidden, while rank-zero values render as 0.00.

Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Copy link
Copy Markdown
Contributor Author

Write-retry this cycle (seonghobae gh). #823 leftover-axis badge σ_k (v2.47.0 / ADR 0290) stays open at eb172c40 on #820. Do not squash-merge onto an unprotected leftover base. Do not self-approve. Independent APPROVE still required. Copilot/Devin COMMENT is not independent APPROVE. Do not merge #808 without independent APPROVE. Issues #79 and #87 stay open. Next buyer increment on the coverage stack: leftover-map incomplete post coverage on the grouping comparison strip (explicitly deferred by #822).

Copy link
Copy Markdown
Contributor Author

Cycle 2026-08-30T14:20Z: still waiting on independent APPROVE of exact head eb172c40 (leftover-axis σ_k badges, ADR 0290 / v2.47.0). Copilot/Devin COMMENT is not independent APPROVE. Do not self-approve. Do not squash-merge this leftover stack onto unprotected leftover base. Next buyer gap on this stack after independent APPROVE is leftover-map incomplete item coverage on the grouping comparison strip (or the next deferred graphic/list increment). #79 and #87 stay open.

Copy link
Copy Markdown
Contributor Author

Cycle 2026-08-30T14:24Z: write probe (comment). Independent APPROVE still required. Do not self-approve. Stack continues leftover-map singular values after v2.47.0.

@seonghobae seonghobae left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Parent-first finding: this Ready child depends on #820, which is already Draft behind the unmerged leftover-map stack. Preserve the singular-value badge delta, but return #823 to Draft until #820 and its prerequisites converge normally.

@seonghobae seonghobae left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fresh ancestry/identity review after #820 promotion:

  • This head still targets the #820 branch at stale base SHA b7222713...; current authoritative #820 is 503d043e165e0ae4c6b5c8cca4366c114c74ef2d. Treat the old merge-base and predecessor test counts as historical evidence only.
  • The product delta (persisted σ_k on leftover-axis report badges, fail-closed independently of share) is valid and must be preserved, but ADR 0290 / v2.47.0 is no longer a valid identity here. #821 is now reconstructing grouping-comparison post coverage as the explicit #820 child under ADR 0290 / v2.47.0. Reusing that identity here would recreate the collision we just repaired at #821.
  • The body instruction to retarget around the stack to #782 is stale and violates the current parent/single-writer convergence policy. Do not bypass #820/#821 or close this PR. After the current chain converges, reconstruct this valid delta on the current serialized parent with a unique later ADR/release identity, preserve #820 singular-value semantics and the #821 authorization fail-close, and keep the ADR Proposed while Draft.

No predecessor GREEN/approval is transferred. No force push/destructive rebase or squash-around-parent.

@seonghobae seonghobae changed the title feat(reports): leftover-map singular values on leftover-axis badges (v2.47.0) feat(reports): preserve leftover-axis singular badges for serialized reconstruction Sep 6, 2026
@seonghobae
seonghobae changed the base branch from feat/leftover-map-plot-singular-v2460 to feat/leftover-map-compare-item-coverage-v2470 September 6, 2026 23:17
seonghobae added a commit that referenced this pull request Sep 6, 2026
seonghobae added a commit that referenced this pull request Sep 6, 2026
seonghobae added a commit that referenced this pull request Sep 6, 2026

@seonghobae seonghobae left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fresh review against current #822 authority confirms the existing repair finding is now executable: this head still carries the historical ADR 0290 / v2.47.0 identity and diverges from exact parent #822724872a, while the valid leftover-axis singular-value UI delta remains distinct. I started an exact-parent reconstruction from #822 that preserves the current ADR 0290/0291 authorization contracts, reproduces a governance RED before creating ADR 0292 / v2.49.0 as Proposed, reuses the persisted singular-value formatter, and requires focused frontend, lint, production-build, Storybook, package-version, and ADR GREEN before any non-force product promotion. No predecessor GREEN or historical identity will be reused.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant