feat(reports): leftover-map unexplained leftover on grouping comparison strip (v2.54.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 / 0275 / 0276 / 0277 / 0278 / 0279 / 0280 / 0281 / 0282 / 0283 / 0284 / 0285 / 0286 / 0287 / 0288 / 0289 / 0290 / 0291 / 0292 / 0293 / 0294 / 0295 / 0296) 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 / 0276 / 0277 / 0278 / 0279 / 0280 / 0281 / 0282 / 0283 / 0284 / 0285 / 0286 / 0287 / 0288 / 0289 / 0290 / 0291 / 0292 / 0293 / 0294 / 0295 / 0296 / 0297) 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
@@ -440,6 +440,12 @@ compares leftover pairs can match the pair-row `2R̂U/R²` badge; a missing or n
 `x` omits that leftover-map comparison cross share badge and does not invent
 `x` from `R̂`, `U`, and `R` or from leftover-map distance. The strip does not gain the
 leftover-map graphic.
+ADR 0297 captions grouping comparison leftover-pair buttons with persisted leftover-map
+unexplained leftover `U` through formatLeftoverMapUnexplained so a buyer who
+compares leftover pairs can match the pair-row `U` badge; a missing or non-finite
+`U` omits that leftover-map comparison unexplained leftover badge and does not invent
+`U` from `R` and `R̂` or from leftover-map distance. The strip does not gain the
+leftover-map graphic.
 When `R`, `R̂`, `U`, `x`,
 `s`, and `e` are finite, `e + s + x = 1`. When `Y`, `E`, and `R` are
 finite, `Y − E = R`. When `R`, `R̂`, and `U` are
@@ -470,6 +476,8 @@ Grouping comparison unexplained leftover share (ADR 0295) captions grouping comp
 buttons with persisted leftover-map unexplained leftover share `s`.
 Grouping comparison leftover-map cross share (ADR 0296) captions grouping comparison leftover-pair
 buttons with persisted leftover-map cross share `x`.
+Grouping comparison leftover-map unexplained leftover (ADR 0297) captions grouping comparison leftover-pair
+buttons with persisted leftover-map unexplained leftover `U`.
 Item complete-case coverage
 (ADR 0282) captions the leftover-map graphic with how many scored criteria
 entered the map. Item complete-case coverage on the pair list (ADR 0285)

ARCHITECTURE.md

@@ -683,6 +683,8 @@ ADR 0295 captions grouping comparison leftover-pair buttons with persisted lefto
 unexplained leftover share `s` through formatLeftoverMapUnexplainedShare.
 ADR 0296 captions grouping comparison leftover-pair buttons with persisted leftover-map
 cross share `x` through formatLeftoverMapCrossShare.
+ADR 0297 captions grouping comparison leftover-pair buttons with persisted leftover-map
+unexplained leftover `U` through formatLeftoverMapUnexplained.
 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
@@ -706,8 +708,9 @@ coverage (ADR 0290), leftover-map incomplete post coverage (ADR 0291), leftover-
 incomplete item coverage (ADR 0292), leftover-map reconstruction `R̂`
 (ADR 0293), leftover-map explained leftover share `e`
 (ADR 0294), leftover-map unexplained leftover share `s`
-(ADR 0295), and leftover-map cross share `x`
-(ADR 0296);
+(ADR 0295), leftover-map cross share `x`
+(ADR 0296), and leftover-map unexplained leftover `U`
+(ADR 0297);
 `POST .../rebuild` scores every grouping kind (post_admin). `make seed`
 folds A-100/B-200 Event Lineage fixtures (and the Riverbend calendar
 post) that already have constructed IRT cells into the same shared

CHANGELOG.d/2.54.0-leftover-map-compare-unexplained.md

@@ -0,0 +1,49 @@
+## 2.54.0 — Leftover-map unexplained leftover on grouping comparison strip pair rows
+
+- Caption leftover-map unexplained leftover `U` on grouping comparison strip
+  leftover-pair buttons through formatLeftoverMapUnexplained (ADR 0297).
+  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, pair segments that match `2R̂U/R²` on the pair
+  row, pair segments that match `U` on the pair row, pair segments that
+  match `R` on the pair row, pair segments that match `Y` on the pair row,
+  pair segments that match `E` on the pair row, pair segments that match
+  leftover-map rank on the pair row, a plot caption that matches
+  leftover-map complete-case coverage above the pair list, a plot caption
+  that matches leftover-map item complete-case coverage, a plot caption
+  that matches leftover-map incomplete post coverage, a plot caption that
+  matches leftover-map incomplete item coverage, a pair-list note that
+  matches leftover-map post complete-case coverage, a pair-list note that
+  matches leftover-map item complete-case coverage, a pair-list note that
+  matches leftover-map incomplete post coverage, a pair-list note that
+  matches leftover-map incomplete item coverage, a grouping comparison
+  note that matches leftover-map post complete-case coverage, a grouping
+  comparison note that matches leftover-map item complete-case coverage,
+  a grouping comparison note that matches leftover-map incomplete post
+  coverage, a grouping comparison note that matches leftover-map
+  incomplete item coverage, grouping comparison leftover-pair buttons
+  that match leftover-map reconstruction `R̂` on the pair row, grouping
+  comparison leftover-pair buttons that match leftover-map explained
+  leftover share `e` on the pair row, grouping comparison leftover-pair
+  buttons that match leftover-map unexplained leftover share `s` on the
+  pair row, grouping comparison leftover-pair buttons that match
+  leftover-map cross share `x` on the pair row, and grouping comparison
+  leftover-pair buttons that match leftover-map unexplained leftover `U`
+  on the pair row; click a post marker or a pair button opens that post.
+  A missing or non-finite `U` omits that leftover-map comparison
+  unexplained leftover badge and keeps leftover-map cross share `x` when
+  finite, leftover-map unexplained leftover share `s` when finite,
+  leftover-map explained leftover share `e` when finite, leftover-map
+  reconstruction `R̂` when finite, leftover-map distance `d`, plus the
+  strip coverage notes. Do not invent `U` from `R` and `R̂`, leftover-map
+  distance, plotted coordinates, leftover-map reconstruction, leftover
+  residual, leftover-map rank, leftover-map post coverage, leftover-map
+  item coverage, leftover-map incomplete post coverage, leftover-map
+  incomplete item coverage, or the count of unused axes. A finite
+  negative leftover is shown, never clamped. The strip does not gain the
+  leftover-map graphic. Never invent a leftover score. Never invent a
+  theta. No new columns.

CHANGELOG.md

@@ -8,6 +8,54 @@ All notable changes to this project are documented here. Format follows
 
 ### Added
 
+- Period leftover pairs now caption grouping comparison leftover-pair
+  buttons with persisted leftover-map unexplained leftover `U` through
+  formatLeftoverMapUnexplained (ADR 0297 / v2.54.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, pair segments that match
+  `2R̂U/R²` on the pair row, pair segments that match `U` on the pair row,
+  pair segments that match `R` on the pair row, pair segments that match
+  `Y` on the pair row, pair segments that match `E` on the pair row, pair
+  segments that match leftover-map rank on the pair row, a plot caption
+  that matches leftover-map complete-case coverage above the pair list, a
+  plot caption that matches leftover-map item complete-case coverage, a
+  plot caption that matches leftover-map incomplete post coverage, a plot
+  caption that matches leftover-map incomplete item coverage, a pair-list
+  note that matches leftover-map post complete-case coverage, a pair-list
+  note that matches leftover-map item complete-case coverage, a pair-list
+  note that matches leftover-map incomplete post coverage, a pair-list
+  note that matches leftover-map incomplete item coverage, a grouping
+  comparison note that matches leftover-map post complete-case coverage,
+  a grouping comparison note that matches leftover-map item
+  complete-case coverage, a grouping comparison note that matches
+  leftover-map incomplete post coverage, a grouping comparison note
+  that matches leftover-map incomplete item coverage, grouping comparison
+  leftover-pair buttons that match leftover-map reconstruction `R̂` on the
+  pair row, grouping comparison leftover-pair buttons that match
+  leftover-map explained leftover share `e` on the pair row, grouping
+  comparison leftover-pair buttons that match leftover-map unexplained
+  leftover share `s` on the pair row, grouping comparison leftover-pair
+  buttons that match leftover-map cross share `x` on the pair row, and
+  grouping comparison leftover-pair buttons that match leftover-map
+  unexplained leftover `U` on the pair row; click a post marker or a pair
+  button opens that post. A missing or non-finite `U` omits that leftover-map
+  comparison unexplained leftover badge and keeps leftover-map cross share
+  `x` when finite, leftover-map unexplained leftover share `s` when finite,
+  leftover-map explained leftover share `e` when finite, leftover-map
+  reconstruction `R̂` when finite, leftover-map distance `d`, plus the strip
+  coverage notes. Do not invent `U` from `R` and `R̂`, leftover-map distance,
+  plotted coordinates, leftover-map reconstruction, leftover residual,
+  leftover-map rank, leftover-map post coverage, leftover-map item
+  coverage, leftover-map incomplete post coverage, leftover-map
+  incomplete item coverage, or the count of unused axes. A finite
+  negative leftover is shown, never clamped. The strip does not gain the
+  leftover-map graphic. Never invent a leftover score or a theta. No new
+  columns.
+
 - Period leftover pairs now caption grouping comparison leftover-pair
   buttons with persisted leftover-map cross share `x` through
   formatLeftoverMapCrossShare (ADR 0296 / v2.53.0). After `make seed`,

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 / 0275 / 0276 / 0277 / 0278 / 0279 / 0280 / 0281 / 0282 / 0283 / 0284 / 0285 / 0286 / 0287 / 0288 / 0289 / 0290 / 0291 / 0292 / 0293 / 0294 / 0295 / 0296), occupational construct catalog search
+(ADR 0048–0164 / 0182 / 0185 / 0201 / 0233 / 0266 / 0267 / 0268 / 0269 / 0270 / 0271 / 0272 / 0273 / 0274 / 0275 / 0276 / 0277 / 0278 / 0279 / 0280 / 0281 / 0282 / 0283 / 0284 / 0285 / 0286 / 0287 / 0288 / 0289 / 0290 / 0291 / 0292 / 0293 / 0294 / 0295 / 0296 / 0297), 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),