feat(reports): leftover-map axis share on graphic display (v2.26.0)

AGENTS.md

@@ -273,7 +273,7 @@ stops startup instead of leaving a healthy-looking partial schema, and
 application code must not compensate for a missing table.
 
 Period leftover pairs (ADR 0017 / 0018 / 0048 / 0049 / 0119 / 0158 / 0162 /
-0163 / 0164 / 0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268) are computed in `lineageweave/leftover_pairs.py` from the
+0163 / 0164 / 0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268 / 0269) are computed in `lineageweave/leftover_pairs.py` from the
 residual after a real GRM/GPCM score, never invented. Distances are
 Euclidean on the two-dimensional Gabriel leftover map; missing cells stay
 out of the factorization. Closest and farthest post–criterion pairs
@@ -288,10 +288,13 @@ ADR 0201 is the sole normative reconstruction formula,
 storage, and audit contract; do not duplicate or reinterpret it here.
 ADR 0233 is the sole unexplained leftover share contract. ADR 0266 is
 the sole explained leftover share contract. ADR 0267 is the sole
-leftover-map coordinate contract. ADR 0268 is the sole leftover-map
+leftover-map coordinate contract. ADR 0268 is the leftover-map
 graphic-display contract: draw persisted `ξ` and `ζ` above the pair
 buttons; omit the plot when coordinates are missing; click a post
-marker to open that post. When `R`, `R̂`, `U`, `x`,
+marker to open that post. ADR 0269 captions those leftover-map axes
+with persisted leftover-map axis share `σ_k² / Σ_j σ_j²` when finite,
+including rank-0 zero-share axes; a missing or non-finite share omits
+that axis badge and keeps the existing leftover-map axis text. When `R`, `R̂`, `U`, `x`,
 `s`, and `e` are finite, `e + s + x = 1`. When coordinates,
 reconstruction, and distance are finite, `R̂ = ξ · ζ` and
 `d = ‖ξ − ζ‖`. The pairs sit above the member

ARCHITECTURE.md

@@ -637,13 +637,14 @@ information at the group's mean θ (Lord, 1980 max-info CAT). Rankings
 persist to `report_item_information`. After those IRT main effects,
 residual SVD leftover pairs on two Gabriel axes (Jeon et al., 2021;
 ADR 0017 / 0048 / 0049 / 0119 / 0148 / 0158 / 0162 / 0163 / 0164 / 0168 /
-0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268) persist to `report_leftover_pair` with signed residual `R`,
+0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268 / 0269) persist to `report_leftover_pair` with signed residual `R`,
 observed `Y`, expected `E[Y|θ, item]`, full leftover-map rank, unexplained
 leftover, ADR 0201 reconstruction evidence, ADR 0185 cross-share evidence,
 ADR 0233 unexplained leftover share `s`, ADR 0266 explained leftover
 share `e`, and ADR 0267 leftover-map coordinates `ξ_{1:2}` / `ζ_{1:2}`.
 ADR 0268 draws those persisted coordinates as the leftover-map graphic
-display above the pair buttons. Click a post marker or a pair button
+display above the pair buttons. ADR 0269 captions leftover-map axes 1
+and 2 with persisted leftover-map axis share. Click a post marker or a pair button
 opens that post. Those ADRs are the normative mathematical, storage, and
 display contracts. Leftover-map axis share
 (Gabriel inertia of residual SVD axes 1 and 2; ADR 0148) persists to

CHANGELOG.d/2.26.0-leftover-map-axis-share-plot.md

@@ -0,0 +1,11 @@
+## 2.26.0 — Leftover-map axis share on the graphic display
+
+- Caption leftover-map graphic-display axes with persisted leftover-map
+  axis share `σ_k² / Σ_j σ_j²` (ADR 0269). After `make seed`, closest
+  and farthest leftover pairs sit above the member list with the
+  Gabriel biplot of already-named coordinates, and each leftover-map
+  axis names its inertia share; click a post marker or a pair button
+  opens that post. Rank-0 zero-share axes still name 0%. A missing or
+  non-finite share omits that axis badge and keeps the existing axis
+  text. Never invent a leftover score. Never invent a theta. No new
+  columns.

CHANGELOG.md

@@ -8,6 +8,16 @@ All notable changes to this project are documented here. Format follows
 
 ### Added
 
+- Period leftover pairs now caption leftover-map graphic-display axes
+  with persisted leftover-map axis share `σ_k² / Σ_j σ_j²` (ADR 0269 /
+  v2.26.0). After `make seed`, closest and farthest leftover pairs sit
+  above the member list with the Gabriel biplot of already-named
+  coordinates, and each leftover-map axis names its inertia share;
+  click a post marker or a pair button opens that post. Rank-0
+  zero-share axes still name 0%. A missing or non-finite share omits
+  that axis badge and keeps the existing leftover-map axis text. Never
+  invent a leftover score or a theta. No new columns.
+
 - Period leftover pairs now draw the leftover-map graphic display of
   persisted `ξ_{1:2}` and `ζ_{1:2}` (ADR 0268 / v2.25.0). After
   `make seed`, closest and farthest leftover pairs sit above the

CLAUDE.md

@@ -49,7 +49,7 @@ cutoff. Global Ask optional `knowledge_cutoff` uses the same cover
 
 Create/start endpoint rules (ADR 0017 / 0021), tie-vs-miss similarity
 (ADR 0026), R&R catalog ids (ADR 0019 / 0027), leftover pairs
-(ADR 0048–0164 / 0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268), occupational construct catalog search
+(ADR 0048–0164 / 0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268 / 0269), occupational construct catalog search
 (ADR 0257), the text-channel embedding swap and cosine
 clamp (ADR 0190), per-edge channel-score persistence (ADR 0195),
 token-backed status notices (ADR 0220),

docs/adr/0048-persist-lsirm-leftover-pairs.md

@@ -11,7 +11,8 @@
 [ADR 0233](0233-leftover-map-unexplained-share.md) (unexplained leftover share s);
 [ADR 0266](0266-leftover-map-explained-share.md) (explained leftover share e);
 [ADR 0267](0267-leftover-map-coordinates.md) (leftover-map coordinates ξ, ζ);
-[ADR 0268](0268-leftover-map-graphic-display.md) (leftover-map graphic display)
+[ADR 0268](0268-leftover-map-graphic-display.md) (leftover-map graphic display);
+[ADR 0269](0269-leftover-map-axis-share-plot.md) (leftover-map axis share on the graphic display)
 
 ## Context
 
@@ -66,7 +67,9 @@ When `R`, `R̂`, `U`, `x`, `s`, and `e` are finite, `e + s + x = 1`.
 ADR 0267 persists leftover-map coordinates `ξ_{1:2}` and `ζ_{1:2}` so
 reconstruction `R̂ = ξ · ζ` and distance `d = ‖ξ − ζ‖` stay auditable
 from the pair row. ADR 0268 draws those persisted coordinates as the
-leftover-map graphic display; it adds no columns.
+leftover-map graphic display; it adds no columns. ADR 0269 captions
+those leftover-map axes with persisted leftover-map axis share; it
+adds no columns.
 
 Cascade the rows with `report_period_score`. A leftover post must
 also be a `report_member_score` row, and the leftover criterion

docs/adr/0049-leftover-pair-report-ui.md

@@ -12,7 +12,8 @@
 [ADR 0233](0233-leftover-map-unexplained-share.md) (unexplained leftover share s);
 [ADR 0266](0266-leftover-map-explained-share.md) (explained leftover share e);
 [ADR 0267](0267-leftover-map-coordinates.md) (leftover-map coordinates ξ, ζ);
-[ADR 0268](0268-leftover-map-graphic-display.md) (leftover-map graphic display)
+[ADR 0268](0268-leftover-map-graphic-display.md) (leftover-map graphic display);
+[ADR 0269](0269-leftover-map-axis-share-plot.md) (leftover-map axis share on the graphic display)
 
 ## Context
 
@@ -37,7 +38,8 @@ leftover-map coordinates `ξ_{1:2}` and `ζ_{1:2}` when finite, and
 leftover-map cross share next to distance when finite. When four finite
 coordinates exist, the leftover-map graphic display of those positions
 sits above the pair buttons (ADR 0268); click a post marker to open
-that post. The next action names every available
+that post. Leftover-map axis share captions those leftover-map axes
+when finite (ADR 0269). The next action names every available
 measurement before opening the post; no amendment hides another, rank 0
 explicitly names no leftover structure, and unexplained leftover names
 "leftover map leaves unexplained `U` after IRT main effects; open this

docs/adr/0148-leftover-map-axis-share.md

@@ -2,6 +2,8 @@
 
 **Decision status:** Accepted
 **Date:** 2026-08-24
+**Amended by:** [ADR 0269](0269-leftover-map-axis-share-plot.md)
+(leftover-map axis share on the graphic display)
 
 ## Context
 
@@ -45,7 +47,9 @@ Rebuild and seed write leftover-map axes in the same transaction as
 leftover pairs. `GET /api/reports/{grouping}/{period}` returns
 `leftover_map_axes` next to `leftover_pairs`. The Period reports panel
 shows leftover-axis share badges and a caption that tells the buyer to
-open a leftover pair. Migration `0169_report_leftover_map_axis.sql`
+open a leftover pair. The leftover-map graphic display captions those
+same leftover-map axes with the persisted share when finite (ADR 0269).
+Migration `0169_report_leftover_map_axis.sql`
 upgrades volumes that already applied `0001`.
 
 ## References

docs/adr/0267-leftover-map-coordinates.md

@@ -103,7 +103,8 @@ leftover-map distance, leftover-map rank, leftover-map inner product,
 leftover-map cosine, leftover-map length, leftover-map reconstruction,
 leftover-map unexplained leftover, leftover-map cross share,
 leftover-map unexplained leftover share, leftover-map explained
-leftover share, and leftover-map graphic display.
+leftover share, leftover-map graphic display, and leftover-map axis
+share on the graphic display.
 
 ## References
 

docs/adr/0268-leftover-map-graphic-display.md

@@ -3,6 +3,9 @@
 **Decision status:** Accepted
 **Date:** 2026-08-28
 
+**Amended by:** [ADR 0269](0269-leftover-map-axis-share-plot.md)
+(leftover-map axis share on the graphic display)
+
 Amends [ADR 0049](0049-leftover-pair-report-ui.md) and
 [ADR 0267](0267-leftover-map-coordinates.md). Independent of leftover-map
 explained leftover share ([ADR 0266](0266-leftover-map-explained-share.md)),
@@ -73,7 +76,8 @@ product, cosine, or length as separate columns.
 After `make seed`, closest and farthest leftover pairs sit above the
 member list with the leftover-map graphic display of persisted `ξ`
 and `ζ`; click a post marker or a pair button opens that post.
-Hidden posts stay hidden. When coordinates, reconstruction, and
+Hidden posts stay hidden. Leftover-map axis share captions those
+leftover-map axes when finite (ADR 0269). When coordinates, reconstruction, and
 distance are all finite, `R̂ = ξ_{1:2} · ζ_{1:2}` and
 `d = ‖ξ_{1:2} − ζ_{1:2}‖` remain the same identities already
 persisted by ADR 0267.
@@ -88,7 +92,8 @@ leftover-map distance, leftover-map rank, leftover-map inner product,
 leftover-map cosine, leftover-map length, leftover-map reconstruction,
 leftover-map unexplained leftover, leftover-map cross share,
 leftover-map unexplained leftover share, leftover-map explained
-leftover share, and leftover-map coordinate persistence.
+leftover share, leftover-map coordinate persistence, and leftover-map
+axis share on the graphic display.
 
 ## References
 

docs/adr/0269-leftover-map-axis-share-plot.md

@@ -0,0 +1,95 @@
+# ADR 0269 — Name leftover-map axis share on the graphic display
+
+**Decision status:** Accepted
+**Date:** 2026-08-28
+
+Amends [ADR 0148](0148-leftover-map-axis-share.md) and
+[ADR 0268](0268-leftover-map-graphic-display.md). Independent of leftover-map
+explained leftover share ([ADR 0266](0266-leftover-map-explained-share.md)),
+leftover-map unexplained leftover share ([ADR 0233](0233-leftover-map-unexplained-share.md)),
+leftover-map reconstruction ([ADR 0201](0201-leftover-map-reconstruction.md)),
+and leftover-map coordinates ([ADR 0267](0267-leftover-map-coordinates.md)).
+
+## Context
+
+ADR 0148 already persists leftover-map axis share
+`σ_k² / Σ_j σ_j²` on each period report as two leftover-map axes.
+ADR 0268 already draws the leftover-map graphic display of persisted
+`ξ_{1:2}` and `ζ_{1:2}`. Those plot axes still read only
+"leftover-map axis 1" and "leftover-map axis 2", so Gabriel inertia
+lives on report badges and not on the graphic display Gabriel (1971)
+captioned. Hiding share on the axes lets leftover residual `R`,
+leftover-map distance `d`, or reconstruction `R̂` be read as leftover-map
+structure even after axis share itself is persisted.
+
+This increment captions the leftover-map graphic display with already
+persisted leftover-map axis share. It does not add columns. It does not
+persist leftover-map inner product, cosine, or length. It does not land
+Post quality on the leftover criterion. Leftover-map distance stays
+two-axis Euclidean. Do not invent a leftover score. Do not invent a
+theta.
+
+The dashboard stack already used neighbouring leftover facts under
+other numbers. This protected increment uses **0269** so it does not
+collide with leftover-map graphic display (0268), leftover-map
+coordinates (0267 / migration 0245), leftover-map explained leftover
+share (0266 / migration 0244), leftover-map unexplained leftover share
+(0233 / migration 0233), leftover-map reconstruction (0201 / migration
+0206), leftover-map cross share (0185), leftover residual disclosure,
+leftover observed `Y` / expected `E`, leftover-map rank, two-axis
+leftover-map distance, leftover coverage, leftover-map axis share
+persistence (0148), leftover interaction-map persistence, occupational
+construct catalog search (0265), or the dashboard stacks.
+
+## Decision
+
+On the leftover-map graphic display, caption leftover-map axis `k`
+with persisted leftover-map axis share when that share is finite,
+including rank-0 zero-share axes. The caption is
+`leftover-map axis {k} ({share}%)` from `σ_k² / Σ_j σ_j²`. A missing
+or non-finite share omits that axis badge and keeps the existing
+leftover-map axis text. Axis 1 and axis 2 stay independently named:
+one missing share does not hide the other. Click a post marker to
+open that post. Criterion markers are not post buttons. The grouping
+comparison strip (ADR 0149) stays on its reduced leftover payload and
+does not gain this caption.
+
+Do not add SQL. Do not edit shipped migrations. Do not persist inner
+product, cosine, or length as separate columns. Do not invent a
+leftover score. Do not invent a theta.
+
+## Consequences
+
+After `make seed`, closest and farthest leftover pairs sit above the
+member list with the leftover-map graphic display of persisted `ξ`
+and `ζ`, and each leftover-map axis names its persisted Gabriel
+inertia share; click a post marker or a pair button opens that post.
+Hidden posts stay hidden. Rank-0 unused axes still plot at the origin
+and still name zero leftover-map axis share. Report-level leftover-axis
+badges (ADR 0148) remain.
+
+## Related
+
+Independent of leftover interaction-map persistence, leftover-criterion
+evaluation landing, leftover residual disclosure, leftover observed
+`Y` / expected `E`, leftover-map complete-case coverage, leftover-map
+axis share persistence, leftover pairs on the grouping comparison
+strip, two-axis leftover-map distance, leftover-map rank, leftover-map
+inner product, leftover-map cosine, leftover-map length, leftover-map
+reconstruction, leftover-map unexplained leftover, leftover-map cross
+share, leftover-map unexplained leftover share, leftover-map explained
+leftover share, leftover-map coordinate persistence, and leftover-map
+graphic display.
+
+## References
+
+Gabriel, K. R. (1971). The biplot graphic display of matrices with
+application to principal component analysis. *Biometrika, 58*(3),
+453–467. https://doi.org/10.1093/biomet/58.3.453
+
+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.
+https://doi.org/10.1007/s11336-021-09762-5
+(LSIRM interaction `−γ‖ξ_j − ζ_i‖` after main effects
+`α_j − β_i`; typically `p = 2` for the interaction map.)

docs/product-technical-gap-baseline.md

@@ -1,5 +1,24 @@
 # Product & Technical Gap Baseline
 
+> Exact-head loop overlay: 2026-08-28 19:15 KST. Protected `main` is
+> `fc13acaa20adca11968238e398d4aafcf62b6cee` (v2.23.0 leftover-map
+> explained leftover share, #775). Open ready PRs still lack independent
+> APPROVE. #782 leftover-map coordinates + graphic display (v2.24.0 /
+> v2.25.0 / ADR 0267 / ADR 0268) is on
+> `2f7e9c8df695f12d03964d5caa68fa3355bdd923`; Strix fail-closed and no
+> independent APPROVE. Drafts remain dirty against `main`. #96 stays
+> closed as a weaker duplicate of #91. GitHub writes through MCP succeed
+> (comment/create-branch/git push/auto-merge). Copilot review is not
+> independent APPROVE. Do not self-approve.
+>
+> Next buyer increment on this cycle: leftover-map axis share on the
+> graphic display (ADR 0269 / v2.26.0). Caption plot axes with persisted
+> ADR 0148 `leftover_map_axes` inertia `σ_k² / Σ_j σ_j²`. UI-only; no
+> new columns. Rank-0 zero-share axes still named. Missing/non-finite
+> share omits that axis badge and keeps existing leftover-map axis
+> text. Do not invent leftover scores. Do not mix into dashboard stacks
+> #640/#778/#781.
+
 > Exact-head loop overlay: 2026-08-28 16:05 KST. Protected `main` is
 > `fc13acaa20adca11968238e398d4aafcf62b6cee` (v2.23.0 leftover-map
 > explained leftover share, #775). Open ready PRs still lack independent

docs/storybook-inventory.md

@@ -5,8 +5,8 @@ operator-facing control you can click before changing product CSS.
 
 | Story | Operator next action | Token / module |
 |---|---|---|
-| `Reports/LeftoverMapPlot` | Read the leftover-map graphic display of persisted `ξ` (posts) and `ζ` (criteria), then click a post marker to open that post. `ClosestAndFarthest`, `RankZeroOrigin`, and `MissingCoordinates` cover two-pair maps, rank-0 origin, and omitted plots. The plot does not invent a leftover score. | `LeftoverMapPlot`, `leftoverMapPlotLayout`, `--color-primary`, `--color-palette-blue-mid` |
-| `Reports/LeftoverPairList` | Read closest/farthest leftover pairs with named `R`, `Y`/`E`, rank, `U`, `s`, `e`, `x`, `R̂`, `ξ`/`ζ`, and `d`, then open that post. The leftover-map graphic display sits above the pair buttons when coordinates are finite. | `LeftoverPairList`, `LeftoverMapPlot`, `ticket-list`, `post-badge` |
+| `Reports/LeftoverMapPlot` | Read the leftover-map graphic display of persisted `ξ` (posts) and `ζ` (criteria), then click a post marker to open that post. Leftover-map axes name persisted leftover-map axis share when finite. `ClosestAndFarthest`, `RankZeroOrigin`, `MissingCoordinates`, and `MissingAxisShare` cover two-pair maps, rank-0 origin with 0% share, omitted plots, and missing share that keeps existing leftover-map axis text. The plot does not invent a leftover score. | `LeftoverMapPlot`, `leftoverMapPlotLayout`, `leftoverMapPlotAxisShare`, `--color-primary`, `--color-palette-blue-mid` |
+| `Reports/LeftoverPairList` | Read closest/farthest leftover pairs with named `R`, `Y`/`E`, rank, `U`, `s`, `e`, `x`, `R̂`, `ξ`/`ζ`, and `d`, then open that post. The leftover-map graphic display sits above the pair buttons when coordinates are finite, and leftover-map axes name persisted leftover-map axis share. | `LeftoverPairList`, `LeftoverMapPlot`, `ticket-list`, `post-badge` |
 | `Workspace/OperationsDashboard` | Compare Event and post counts, inspect external-information coverage, then open the cited source behind a claim, handover, or repeat-issue fact. `EvidenceReady`, `NarrowViewport`, `AnalysisPendingAndMissingEvidence`, `AnalysisFailed`, and `LoadError` cover populated, mobile, unavailable-evidence, analysis-pending, retryable failure, and transport-error states. | `--color-dashboard-*`, `OperationsDashboard` |
 | `Post/SimilarVocPanel` | Compare ontology/semantic similar VOC and prior action evidence, then open the source; unavailable states show no fabricated TEPP theta or weight. | `SimilarVocPanel.css`, `SimilarVocPanel` |
 | `Post/Recorded perspectives` | Read the imported primary and every evidence-connected additional Voice with its recorded truth state instead of flattening them into one compound category. `CombinedEvidence`, `RejectedEvidence`, and `NarrowViewport` cover desktop, rejected-evidence, and narrow layouts. | `VoicePerspectiveList`, `ticket-list`, `post-meta` |

frontend/package.json

@@ -1,7 +1,7 @@
 {
   "name": "frontend",
   "private": true,
-  "version": "2.25.0",
+  "version": "2.26.0",
   "type": "module",
   "scripts": {
     "dev": "vite",