feat(reports): leftover-map cross share on pair segments (v2.32.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 / 0272 / 0273 / 0274) are computed in `lineageweave/leftover_pairs.py` from the
+0163 / 0164 / 0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268 / 0269 / 0270 / 0271 / 0272 / 0273 / 0274 / 0275) 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
@@ -313,7 +313,11 @@ explained leftover share caption and does not invent `e` from `R̂` and
 segments with persisted leftover-map unexplained leftover share `s` so
 the pair-row `U²/R²` badge matches the graphic; a missing or non-finite
 `s` omits that unexplained leftover share caption and does not invent
-`s` from `U` and `R` or from plotted coordinates. When `R`, `R̂`, `U`, `x`,
+`s` from `U` and `R` or from plotted coordinates. ADR 0275 captions leftover-map pair
+segments with persisted leftover-map cross share `x` so
+the pair-row `2R̂U/R²` badge matches the graphic; a missing or non-finite
+`x` omits that leftover-map cross share caption and does not invent
+`x` from `R̂`, `U`, 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 / 0272 / 0273 / 0274) persist to `report_leftover_pair` with signed residual `R`,
+0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268 / 0269 / 0270 / 0271 / 0272 / 0273 / 0274 / 0275) 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
@@ -651,7 +651,9 @@ 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`. ADR 0274 captions leftover-map pair
-segments with persisted leftover-map unexplained leftover share `s`. Click a post marker or a pair button
+segments with persisted leftover-map unexplained leftover share `s`.
+ADR 0275 captions leftover-map pair segments with persisted leftover-map
+cross share `x`. 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.32.0-leftover-map-segment-cross-share.md

@@ -0,0 +1,16 @@
+## 2.32.0 — Leftover-map cross share on graphic-display pair segments
+
+- Caption leftover-map graphic-display pair segments with persisted
+  leftover-map cross share `x = 2 R̂ U / R²` (ADR 0275). 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, pair segments that match
+  `R̂²/R²` on the pair row, pair segments that match `U²/R²` on the
+  pair row, and pair segments that match `2R̂U/R²` on the pair row;
+  click a post marker or a pair button opens that post. A missing or
+  non-finite `x` omits that leftover-map cross share caption. A finite
+  negative share is shown; do not clamp to nonnegative. Do not invent
+  `x` from `R̂`, `U`, and `R` or from plotted coordinates. Never invent
+  a leftover score. Never invent a theta. No new columns.

CHANGELOG.md

@@ -8,6 +8,22 @@ 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 cross share
+  `x = 2 R̂ U / R²` (ADR 0275 / v2.32.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, pair segments that match `R̂²/R²` on
+  the pair row, pair segments that match `U²/R²` on the pair row, and
+  pair segments that match `2R̂U/R²` on the pair row; click a post
+  marker or a pair button opens that post. A missing or non-finite `x`
+  omits that leftover-map cross share caption. A finite negative share
+  is shown; do not clamp to nonnegative. Do not invent `x` from `R̂`,
+  `U`, 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 unexplained leftover share
   `s = U² / R²` (ADR 0274 / v2.31.0). After `make seed`, closest and

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

@@ -17,7 +17,8 @@
 [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);
-[ADR 0274](0274-leftover-map-segment-unexplained-share.md) (leftover-map unexplained leftover share on pair segments)
+[ADR 0274](0274-leftover-map-segment-unexplained-share.md) (leftover-map unexplained leftover share on pair segments);
+[ADR 0275](0275-leftover-map-segment-cross-share.md) (leftover-map cross share on pair segments)
 
 ## Context
 
@@ -82,7 +83,8 @@ 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. ADR 0274 captions leftover-map pair
 segments with persisted leftover-map unexplained leftover share `s`; it
-adds no columns.
+adds no columns. ADR 0275 captions leftover-map pair segments with
+persisted leftover-map cross share `x`; 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

@@ -18,7 +18,8 @@
 [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);
-[ADR 0274](0274-leftover-map-segment-unexplained-share.md) (leftover-map unexplained leftover share on pair segments)
+[ADR 0274](0274-leftover-map-segment-unexplained-share.md) (leftover-map unexplained leftover share on pair segments);
+[ADR 0275](0275-leftover-map-segment-cross-share.md) (leftover-map cross share on pair segments)
 
 ## Context
 
@@ -49,7 +50,8 @@ when finite (ADR 0269). Leftover-map axis ticks name persisted `ξ` /
 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). Pair segments name persisted leftover-map
-unexplained leftover share `s` (ADR 0274). The pair renders every available finite measurement.
+unexplained leftover share `s` (ADR 0274). Pair segments name persisted leftover-map
+cross share `x` (ADR 0275). 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
@@ -88,6 +90,8 @@ Leftover-map explained leftover share on pair segments is
 [ADR 0273](0273-leftover-map-segment-explained-share.md).
 Leftover-map unexplained leftover share on pair segments is
 [ADR 0274](0274-leftover-map-segment-unexplained-share.md).
+Leftover-map cross share on pair segments is
+[ADR 0275](0275-leftover-map-segment-cross-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/0185-leftover-map-cross-share.md

@@ -2,6 +2,8 @@
 
 **Decision status:** Draft
 **Date:** 2026-08-24
+**Amended by:** [ADR 0275](0275-leftover-map-segment-cross-share.md)
+(leftover-map cross share on graphic-display pair segments)
 
 Amends [ADR 0048](0048-persist-lsirm-leftover-pairs.md) and
 [ADR 0049](0049-leftover-pair-report-ui.md).
@@ -83,7 +85,9 @@ invent a leftover score. Do not invent a theta.
 `GET /api/reports/{grouping}/{period}` returns
 `leftover_map_cross_share`. After `make seed`, closest and farthest
 leftover pairs sit above the member list with named `2R̂U/R²` next
-to `d`; click opens that post. Hidden posts stay hidden.
+to `d`; click opens that post. Hidden posts stay hidden. ADR 0275
+captions leftover-map graphic-display pair segments with that same
+persisted leftover-map cross share; it adds no columns.
 
 ## Related
 

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

@@ -14,7 +14,9 @@
 [ADR 0273](0273-leftover-map-segment-explained-share.md)
 (leftover-map explained leftover share on pair segments);
 [ADR 0274](0274-leftover-map-segment-unexplained-share.md)
-(leftover-map unexplained leftover share on pair segments)
+(leftover-map unexplained leftover share on pair segments);
+[ADR 0275](0275-leftover-map-segment-cross-share.md)
+(leftover-map cross 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
@@ -92,7 +94,8 @@ persisted `ξ` / `ζ` coordinates (ADR 0270). Pair segments name
 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). Pair segments name
-persisted leftover-map unexplained leftover share `s` (ADR 0274). When coordinates, reconstruction, and
+persisted leftover-map unexplained leftover share `s` (ADR 0274). Pair segments name
+persisted leftover-map cross share `x` (ADR 0275). 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/0273-leftover-map-segment-explained-share.md

@@ -4,7 +4,9 @@
 **Date:** 2026-08-29
 
 **Amended by:** [ADR 0274](0274-leftover-map-segment-unexplained-share.md)
-(leftover-map unexplained leftover share on pair segments)
+(leftover-map unexplained leftover share on pair segments);
+[ADR 0275](0275-leftover-map-segment-cross-share.md)
+(leftover-map cross 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
@@ -88,7 +90,8 @@ finite, leftover-map axis ticks name the same coordinates shown on
 the pair row, pair segments name persisted leftover-map distance `d`,
 persisted leftover-map reconstruction `R̂`, and persisted leftover-map
 explained leftover share `e`, and pair segments name persisted leftover-map
-unexplained leftover share `s` (ADR 0274); click a post marker or a pair button
+unexplained leftover share `s` (ADR 0274) and leftover-map cross share `x`
+(ADR 0275); click a post marker or a pair button
 opens that post. Hidden posts stay hidden. Rank-0 unused axes still
 plot at the origin, still name zero leftover-map axis share with a `0`
 tick, still name `d 0.00` when that distance is persisted, still name

docs/adr/0274-leftover-map-segment-unexplained-share.md

@@ -2,6 +2,8 @@
 
 **Decision status:** Accepted
 **Date:** 2026-08-29
+**Amended by:** [ADR 0275](0275-leftover-map-segment-cross-share.md)
+(leftover-map cross 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
@@ -88,13 +90,15 @@ finite, leftover-map axis ticks name the same coordinates shown on
 the pair row, pair segments name persisted leftover-map distance `d`,
 persisted leftover-map reconstruction `R̂`, persisted leftover-map
 explained leftover share `e`, and persisted leftover-map unexplained
-leftover share `s`; click a post marker or a pair button opens that
+leftover share `s`, and pair segments name persisted leftover-map
+cross share `x` (ADR 0275); click a post marker or a pair button opens that
 post. Hidden posts stay hidden. Rank-0 unused axes still plot at the
 origin, still name zero leftover-map axis share with a `0` tick, still
 name `d 0.00` when that distance is persisted, still name `R̂ 0.00`
 when that reconstruction is persisted, still name `R̂²/R² 0.00` when
 that explained leftover share is persisted, and still name `U²/R² 0.00`
-when that unexplained leftover share is persisted. When `R`, `R̂`, `U`,
+when that unexplained leftover share is persisted, and still name `2R̂U/R² 0.00`
+when that leftover-map cross share is persisted. When `R`, `R̂`, `U`,
 `x`, `s`, and `e` are all finite, `e + s + x = 1` remains the same
 identity already persisted by ADR 0233 and ADR 0266.