feat(reports): leftover-map explained leftover share on pair segments (v2.30.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 / 0269 / 0270 / 0271) are computed in `lineageweave/leftover_pairs.py` from the
+0163 / 0164 / 0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268 / 0269 / 0270 / 0271 / 0272 / 0273) 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
@@ -301,7 +301,15 @@ plot; rank-0 unused axes name only `0` and do not invent drawing-scale
 ticks. ADR 0271 captions leftover-map pair segments with persisted
 leftover-map distance `d` so the pair-row badge matches the graphic;
 a missing or non-finite `d` omits that segment caption and does not
-invent `d` from plotted coordinates. When `R`, `R̂`, `U`, `x`,
+invent `d` from plotted coordinates. ADR 0272 captions leftover-map
+pair segments with persisted leftover-map reconstruction `R̂` so the
+pair-row badge matches the graphic; a missing or non-finite `R̂` omits
+that reconstruction caption and does not invent `R̂` from plotted
+coordinates. ADR 0273 captions leftover-map pair segments with persisted
+leftover-map explained leftover share `e` so the pair-row `R̂²/R²`
+badge matches the graphic; a missing or non-finite `e` omits that
+explained leftover share caption and does not invent `e` from `R̂` and
+`R` or from plotted coordinates. 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,7 +637,7 @@ 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 / 0269 / 0270 / 0271) persist to `report_leftover_pair` with signed residual `R`,
+0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268 / 0269 / 0270 / 0271 / 0272 / 0273) 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
@@ -647,7 +647,10 @@ display above the pair buttons. ADR 0269 captions leftover-map axes 1
 and 2 with persisted leftover-map axis share. ADR 0270 ticks those
 leftover-map axes at persisted `ξ` / `ζ` coordinates so the pair-row
 badge matches the plot. ADR 0271 captions leftover-map pair segments
-with persisted leftover-map distance `d`. Click a post marker or a pair button
+with persisted leftover-map distance `d`. ADR 0272 captions leftover-map
+pair segments with persisted leftover-map reconstruction `R̂`. ADR 0273
+captions leftover-map pair segments with persisted leftover-map
+explained leftover share `e`. 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.29.0-leftover-map-segment-reconstruction.md

@@ -0,0 +1,12 @@
+## 2.29.0 — Leftover-map reconstruction on graphic-display pair segments
+
+- Caption leftover-map graphic-display pair segments with persisted
+  leftover-map reconstruction `R̂` (ADR 0272). After `make seed`,
+  closest and farthest leftover pairs sit above the member list with
+  the Gabriel biplot of already-named coordinates, leftover-map axis
+  share when finite, axis ticks that match `ξ (x, y) ζ (x, y)` on the
+  pair row, pair segments that match `d` on the pair row, and pair
+  segments that match `R̂` on the pair row; click a post marker or a
+  pair button opens that post. A missing or non-finite `R̂` omits that
+  reconstruction caption. Do not invent `R̂` from plotted coordinates.
+  Never invent a leftover score. Never invent a theta. No new columns.

CHANGELOG.d/2.30.0-leftover-map-segment-explained-share.md

@@ -0,0 +1,14 @@
+## 2.30.0 — Leftover-map explained leftover share on graphic-display pair segments
+
+- Caption leftover-map graphic-display pair segments with persisted
+  leftover-map explained leftover share `e = R̂² / R²` (ADR 0273). After
+  `make seed`, closest and farthest leftover pairs sit above the member
+  list with the Gabriel biplot of already-named coordinates, leftover-map
+  axis share when finite, axis ticks that match `ξ (x, y) ζ (x, y)` on
+  the pair row, pair segments that match `d` on the pair row, pair
+  segments that match `R̂` on the pair row, and pair segments that match
+  `R̂²/R²` on the pair row; click a post marker or a pair button opens
+  that post. A missing or non-finite `e` omits that explained leftover
+  share caption. A share greater than 1 is shown, never clamped. Do not
+  invent `e` from `R̂` and `R` or from plotted coordinates. Never invent
+  a leftover score. Never invent a theta. No new columns.

CHANGELOG.md

@@ -8,6 +8,32 @@ All notable changes to this project are documented here. Format follows
 
 ### Added
 
+- Period leftover pairs now caption leftover-map graphic-display pair
+  segments with persisted leftover-map explained leftover share
+  `e = R̂² / R²` (ADR 0273 / v2.30.0). After `make seed`, closest and
+  farthest leftover pairs sit above the member list with the Gabriel
+  biplot of already-named coordinates, leftover-map axis share when
+  finite, axis ticks that match `ξ (x, y) ζ (x, y)` on the pair row,
+  pair segments that match `d` on the pair row, pair segments that
+  match `R̂` on the pair row, and pair segments that match `R̂²/R²`
+  on the pair row; click a post marker or a pair button opens that
+  post. A missing or non-finite `e` omits that explained leftover
+  share caption. A share greater than 1 is shown, never clamped. Do
+  not invent `e` from `R̂` and `R` or from plotted coordinates. Never
+  invent a leftover score or a theta. No new columns.
+
+- Period leftover pairs now caption leftover-map graphic-display pair
+  segments with persisted leftover-map reconstruction `R̂` (ADR 0272 /
+  v2.29.0). After `make seed`, closest and farthest leftover pairs sit
+  above the member list with the Gabriel biplot of already-named
+  coordinates, leftover-map axis share when finite, axis ticks that
+  match `ξ (x, y) ζ (x, y)` on the pair row, pair segments that match
+  `d` on the pair row, and pair segments that match `R̂` on the pair
+  row; click a post marker or a pair button opens that post. A missing
+  or non-finite `R̂` omits that reconstruction caption. Do not invent
+  `R̂` from plotted coordinates. Never invent a leftover score or a
+  theta. No new columns.
+
 - Period leftover pairs now caption leftover-map graphic-display pair
   segments with persisted leftover-map distance `d` (ADR 0271 /
   v2.28.0). After `make seed`, closest and farthest leftover pairs sit

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 / 0269 / 0270 / 0271), occupational construct catalog search
+(ADR 0048–0164 / 0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268 / 0269 / 0270 / 0271 / 0272 / 0273), 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

@@ -14,7 +14,9 @@
 [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);
 [ADR 0270](0270-leftover-map-coordinate-ticks.md) (leftover-map coordinate ticks);
-[ADR 0271](0271-leftover-map-segment-distance.md) (leftover-map distance on pair segments)
+[ADR 0271](0271-leftover-map-segment-distance.md) (leftover-map distance on pair segments);
+[ADR 0272](0272-leftover-map-segment-reconstruction.md) (leftover-map reconstruction on pair segments);
+[ADR 0273](0273-leftover-map-segment-explained-share.md) (leftover-map explained leftover share on pair segments)
 
 ## Context
 
@@ -74,7 +76,10 @@ those leftover-map axes with persisted leftover-map axis share; it
 adds no columns. ADR 0270 ticks leftover-map axes at persisted `ξ` /
 `ζ` coordinates; it adds no columns. ADR 0271 captions leftover-map
 pair segments with persisted leftover-map distance `d`; it adds no
-columns.
+columns. ADR 0272 captions leftover-map pair segments with persisted
+leftover-map reconstruction `R̂`; it adds no columns. ADR 0273 captions
+leftover-map pair segments with persisted leftover-map explained leftover
+share `e`; 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

@@ -15,7 +15,9 @@
 [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);
 [ADR 0270](0270-leftover-map-coordinate-ticks.md) (leftover-map coordinate ticks);
-[ADR 0271](0271-leftover-map-segment-distance.md) (leftover-map distance on pair segments)
+[ADR 0271](0271-leftover-map-segment-distance.md) (leftover-map distance on pair segments);
+[ADR 0272](0272-leftover-map-segment-reconstruction.md) (leftover-map reconstruction on pair segments);
+[ADR 0273](0273-leftover-map-segment-explained-share.md) (leftover-map explained leftover share on pair segments)
 
 ## Context
 
@@ -43,7 +45,9 @@ sits above the pair buttons (ADR 0268); click a post marker to open
 that post. Leftover-map axis share captions those leftover-map axes
 when finite (ADR 0269). Leftover-map axis ticks name persisted `ξ` /
 `ζ` coordinates (ADR 0270). Pair segments name persisted leftover-map
-distance `d` (ADR 0271). The pair renders every available finite measurement.
+distance `d` (ADR 0271). Pair segments name persisted leftover-map
+reconstruction `R̂` (ADR 0272). Pair segments name persisted leftover-map
+explained leftover share `e` (ADR 0273). The pair renders every available finite measurement.
 The next action uses the first available value in the priority below; no
 amendment hides another badge, rank 0
 explicitly names no leftover structure, and unexplained leftover names
@@ -76,6 +80,10 @@ Leftover-map coordinate ticks are
 [ADR 0270](0270-leftover-map-coordinate-ticks.md).
 Leftover-map distance on pair segments is
 [ADR 0271](0271-leftover-map-segment-distance.md).
+Leftover-map reconstruction on pair segments is
+[ADR 0272](0272-leftover-map-segment-reconstruction.md).
+Leftover-map explained leftover share on pair segments is
+[ADR 0273](0273-leftover-map-segment-explained-share.md).
 
 After `make seed`, closest and farthest leftover pairs sit above the
 member list. Click a pair to open that post with the leftover

docs/adr/0201-leftover-map-reconstruction.md

@@ -4,7 +4,11 @@
 **Date:** 2026-08-25
 
 **Amended by:** [ADR 0267](0267-leftover-map-coordinates.md)
-(leftover-map coordinates ξ, ζ)
+(leftover-map coordinates ξ, ζ);
+[ADR 0272](0272-leftover-map-segment-reconstruction.md)
+(leftover-map reconstruction on graphic-display pair segments);
+[ADR 0273](0273-leftover-map-segment-explained-share.md)
+(leftover-map explained leftover share on graphic-display pair segments)
 
 Amends [ADR 0048](0048-persist-lsirm-leftover-pairs.md),
 [ADR 0049](0049-leftover-pair-report-ui.md), and

docs/adr/0266-leftover-map-explained-share.md

@@ -4,7 +4,9 @@
 **Date:** 2026-08-28
 
 **Amended by:** [ADR 0267](0267-leftover-map-coordinates.md)
-(leftover-map coordinates ξ, ζ)
+(leftover-map coordinates ξ, ζ);
+[ADR 0273](0273-leftover-map-segment-explained-share.md)
+(leftover-map explained leftover share on graphic-display pair segments)
 
 Amends [ADR 0048](0048-persist-lsirm-leftover-pairs.md) and
 [ADR 0049](0049-leftover-pair-report-ui.md). Independent of leftover-map

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

@@ -8,7 +8,11 @@
 [ADR 0270](0270-leftover-map-coordinate-ticks.md)
 (leftover-map coordinate ticks);
 [ADR 0271](0271-leftover-map-segment-distance.md)
-(leftover-map distance on pair segments)
+(leftover-map distance on pair segments);
+[ADR 0272](0272-leftover-map-segment-reconstruction.md)
+(leftover-map reconstruction on pair segments);
+[ADR 0273](0273-leftover-map-segment-explained-share.md)
+(leftover-map explained leftover share on pair segments)
 
 Amends [ADR 0049](0049-leftover-pair-report-ui.md) and
 [ADR 0267](0267-leftover-map-coordinates.md). Independent of leftover-map
@@ -83,7 +87,9 @@ and `ζ`; click a post marker or a pair button opens that post.
 Hidden posts stay hidden. Leftover-map axis share captions those
 leftover-map axes when finite (ADR 0269). Leftover-map axis ticks name
 persisted `ξ` / `ζ` coordinates (ADR 0270). Pair segments name
-persisted leftover-map distance `d` (ADR 0271). When coordinates, reconstruction, and
+persisted leftover-map distance `d` (ADR 0271). Pair segments name
+persisted leftover-map reconstruction `R̂` (ADR 0272). Pair segments name
+persisted leftover-map explained leftover share `e` (ADR 0273). 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.

docs/adr/0271-leftover-map-segment-distance.md

@@ -3,6 +3,11 @@
 **Decision status:** Accepted
 **Date:** 2026-08-29
 
+**Amended by:** [ADR 0272](0272-leftover-map-segment-reconstruction.md)
+(leftover-map reconstruction on pair segments);
+[ADR 0273](0273-leftover-map-segment-explained-share.md)
+(leftover-map explained leftover share on pair segments)
+
 Amends [ADR 0268](0268-leftover-map-graphic-display.md) and
 [ADR 0049](0049-leftover-pair-report-ui.md). Independent of leftover-map
 coordinate ticks ([ADR 0270](0270-leftover-map-coordinate-ticks.md)),