feat(reports): leftover residual on grouping comparison graphic (v2.72.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 / 0297 / 0298 / 0299 / 0300 / 0301 / 0302 / 0303 / 0304 / 0305 / 0306 / 0307 / 0308 / 0309 / 0310 / 0311 / 0312 / 0313 / 0314) 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 / 0298 / 0299 / 0300 / 0301 / 0302 / 0303 / 0304 / 0305 / 0306 / 0307 / 0308 / 0309 / 0310 / 0311 / 0312 / 0313 / 0314 / 0315) 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
@@ -581,6 +581,16 @@ and leftover-map comparison graphic incomplete items when those helpers return u
 leftover-map rank, leftover-map axis share, leftover-map post coverage, leftover-map item coverage,
 leftover-map incomplete post coverage, leftover-map incomplete item coverage, leftover pair
 count, or the count of unused axes.
+ADR 0315 captions leftover residual on that grouping comparison leftover-map
+graphic when formatLeftoverMapResidual returns a usable badge; a missing or
+non-finite `R` omits that leftover-map comparison graphic leftover residual caption and keeps
+leftover-map unexplained leftover `U`, leftover-map cross share `x`, leftover-map unexplained leftover share `s`, leftover-map explained leftover share `e`, leftover-map reconstruction `R̂`, leftover-map distance `d`, leftover-map comparison graphic coverage,
+leftover-map comparison graphic item coverage, leftover-map comparison graphic incomplete posts,
+and leftover-map comparison graphic incomplete items when those helpers return usable integers. Do not invent
+`R` from `Y` and `E`, from `U` and `R̂`, leftover-map reconstruction, leftover-map unexplained leftover, leftover-map distance, plotted coordinates,
+leftover-map rank, leftover-map axis share, leftover-map post coverage, leftover-map item coverage,
+leftover-map incomplete post coverage, leftover-map incomplete item coverage, leftover pair
+count, or the count of unused axes.
 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
@@ -658,6 +668,9 @@ share `x` when formatLeftoverMapCrossShare returns a usable badge.
 Grouping comparison leftover-map unexplained leftover (ADR 0314) captions
 that grouping comparison leftover-map graphic with persisted leftover-map unexplained leftover
 `U` when formatLeftoverMapUnexplained returns a usable badge.
+Grouping comparison leftover residual (ADR 0315) captions
+that grouping comparison leftover-map graphic with persisted leftover residual
+`R` when formatLeftoverMapResidual returns a usable badge.
 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

@@ -731,6 +731,9 @@ badge.
 ADR 0314 captions leftover-map unexplained leftover on that grouping
 comparison leftover-map graphic when formatLeftoverMapUnexplained returns a usable
 badge.
+ADR 0315 captions leftover residual on that grouping
+comparison leftover-map graphic when formatLeftoverMapResidual returns a usable
+badge.
 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
@@ -774,7 +777,8 @@ graphic (ADR 0310), leftover-map explained leftover share on the grouping compar
 graphic (ADR 0311), leftover-map unexplained leftover share on the grouping comparison leftover-map
 graphic (ADR 0312), leftover-map cross share on the grouping comparison leftover-map
 graphic (ADR 0313), leftover-map unexplained leftover on the grouping comparison leftover-map
-graphic (ADR 0314);
+graphic (ADR 0314), leftover residual on the grouping comparison leftover-map
+graphic (ADR 0315);
 `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.72.0-leftover-map-compare-plot-residual.md

@@ -0,0 +1,38 @@
+## 2.72.0 — Leftover residual on grouping comparison leftover-map graphic
+
+- Caption leftover residual on the grouping comparison leftover-map
+  graphic (ADR 0315). 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, leftover-map complete-case
+  coverage when leftoverMapCoverageCounts returns usable complete-case integers,
+  leftover-map item complete-case coverage when leftoverMapItemCoverageCounts
+  returns usable complete-case integers, leftover-map incomplete post coverage
+  when leftoverMapIncompletePostCount returns a usable dropped integer,
+  leftover-map incomplete item coverage when leftoverMapIncompleteItemCount
+  returns a usable dropped integer, leftover-map reconstruction `R̂` when
+  formatLeftoverMapReconstruction returns a usable signed badge, leftover-map
+  explained leftover share `e` when formatLeftoverMapExplainedShare returns a
+  usable badge, leftover-map unexplained leftover share `s` when
+  formatLeftoverMapUnexplainedShare returns a usable badge, leftover-map
+  cross share `x` when formatLeftoverMapCrossShare returns a usable badge, leftover-map
+  unexplained leftover `U` when formatLeftoverMapUnexplained returns a usable badge,
+  and leftover residual `R` on that grouping comparison leftover-map graphic; click a
+  post marker or a pair button opens that post. A missing or non-finite `R`
+  omits that leftover-map comparison graphic leftover residual caption and keeps
+  leftover-map unexplained leftover `U`, leftover-map cross share `x`, leftover-map unexplained leftover share `s`, leftover-map explained leftover
+  share `e`, leftover-map reconstruction `R̂`, leftover-map distance `d`, leftover-map
+  comparison graphic coverage, leftover-map comparison graphic item coverage,
+  leftover-map comparison graphic incomplete posts, and leftover-map comparison
+  graphic incomplete items when those helpers return usable integers. Rank-0 origin
+  cells still name `R 0.00` when that persisted leftover residual is
+  finite. Comparison copy uses `leftover map comparison graphic leftover residual
+  {label}` so it stays distinct from `leftover residual
+  {label}` and from strip `Leftover map comparison residual`.
+  This increment does not caption leftover observed on the comparison graphic
+  with a distinct name. Do not invent `R` from `Y` and `E`, from `U` and `R̂`, leftover-map reconstruction,
+  leftover-map unexplained leftover, leftover-map distance, plotted coordinates, leftover-map rank,
+  leftover-map axis share, leftover-map post coverage, leftover-map item coverage,
+  leftover-map incomplete post coverage, leftover-map incomplete item coverage,
+  leftover pair count, or the count of unused axes. A finite negative leftover
+  residual is shown, never clamped. Never invent a leftover score.
+  Never invent a theta. No new columns.

CHANGELOG.md

@@ -8,6 +8,48 @@ All notable changes to this project are documented here. Format follows
 
 ### Added
 
+- Period leftover pairs now name leftover residual on the grouping
+  comparison leftover-map graphic (ADR 0315 / v2.72.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, leftover-map complete-case coverage when leftoverMapCoverageCounts
+  returns usable complete-case integers, leftover-map item complete-case
+  coverage when leftoverMapItemCoverageCounts returns usable complete-case
+  integers, leftover-map incomplete post coverage when leftoverMapIncompletePostCount
+  returns a usable dropped integer, leftover-map incomplete item coverage when
+  leftoverMapIncompleteItemCount returns a usable dropped integer, leftover-map
+  reconstruction `R̂` when formatLeftoverMapReconstruction returns a usable signed
+  badge, leftover-map explained leftover share `e` when formatLeftoverMapExplainedShare
+  returns a usable badge, leftover-map unexplained leftover share `s` when
+  formatLeftoverMapUnexplainedShare returns a usable badge, leftover-map
+  cross share `x` when formatLeftoverMapCrossShare returns a usable badge, leftover-map
+  unexplained leftover `U` when formatLeftoverMapUnexplained returns a usable badge,
+  and leftover residual `R` on that grouping comparison leftover-map graphic when
+  formatLeftoverMapResidual returns a usable badge; click a post marker or a pair
+  button opens that post. A missing or non-finite `R` omits that leftover-map
+  comparison graphic leftover residual caption and keeps leftover-map unexplained leftover
+  `U`, leftover-map cross share `x`, leftover-map unexplained leftover share `s`, leftover-map explained leftover
+  share `e`, leftover-map reconstruction `R̂`, leftover-map distance `d`, leftover-map
+  comparison graphic coverage, leftover-map comparison graphic item coverage,
+  leftover-map comparison graphic incomplete posts, and leftover-map comparison
+  graphic incomplete items when those helpers return usable integers. Rank-0 origin
+  cells still plot at `(0, 0)` and still name `R 0.00` when that persisted leftover
+  residual is finite. Comparison copy uses `leftover map comparison graphic
+  leftover residual {label}` so it stays distinct from
+  `leftover residual {label}` and from strip `Leftover map comparison residual`.
+  Leftover residual omits independently of leftover-map unexplained leftover,
+  leftover-map cross share, leftover-map unexplained leftover share, leftover-map explained leftover share,
+  leftover-map reconstruction, leftover-map distance, and coverage notes. This
+  increment does not caption leftover observed on the comparison
+  graphic with a distinct name. Do not invent `R` from `Y` and `E`, from `U` and `R̂`, leftover-map
+  reconstruction, leftover-map unexplained leftover, leftover-map distance, plotted coordinates,
+  leftover-map rank, leftover-map axis share, leftover expected, leftover observed,
+  leftover-map post coverage, leftover-map item coverage, leftover-map incomplete
+  post coverage, leftover-map incomplete item coverage, leftover pair count, or the
+  count of unused axes. A finite negative leftover residual is shown,
+  never clamped. Omit the comparison graphic when no leftover pair has four finite
+  leftover-map coordinates. Never invent a leftover score or a theta. No new columns.
+
 - Period leftover pairs now name leftover-map unexplained leftover on the grouping
   comparison leftover-map graphic (ADR 0314 / v2.71.0). After `make seed`,
   closest and farthest leftover pairs sit above the member list with 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 / 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 / 0298 / 0299 / 0300 / 0301 / 0302 / 0303 / 0304 / 0305 / 0306 / 0307 / 0308 / 0309 / 0310 / 0311 / 0312 / 0313 / 0314), 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 / 0298 / 0299 / 0300 / 0301 / 0302 / 0303 / 0304 / 0305 / 0306 / 0307 / 0308 / 0309 / 0310 / 0311 / 0312 / 0313 / 0314 / 0315), 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/0277-leftover-map-segment-residual.md

@@ -2,6 +2,8 @@
 
 **Decision status:** Accepted
 **Date:** 2026-08-30
+**Amended by:** [ADR 0315](0315-leftover-map-compare-plot-residual.md)
+(leftover residual on the grouping comparison leftover-map graphic)
 
 Amends [ADR 0268](0268-leftover-map-graphic-display.md),
 [ADR 0049](0049-leftover-pair-report-ui.md), and leftover residual

docs/adr/0298-leftover-map-compare-residual.md

@@ -3,6 +3,9 @@
 **Decision status:** Accepted
 **Date:** 2026-08-31
 
+**Amended by:** [ADR 0315](0315-leftover-map-compare-plot-residual.md)
+(leftover residual on the grouping comparison leftover-map graphic)
+
 Amends leftover pairs on the grouping comparison strip
 ([ADR 0149](0149-leftover-pairs-on-comparison-strip.md)), leftover residual
 disclosure ([ADR 0162](0162-leftover-residual-disclosure.md)), leftover residual

docs/adr/0314-leftover-map-compare-plot-unexplained-leftover.md

@@ -3,6 +3,9 @@
 **Decision status:** Accepted
 **Date:** 2026-08-31
 
+**Amended by:** [ADR 0315](0315-leftover-map-compare-plot-residual.md)
+(leftover residual on the grouping comparison leftover-map graphic)
+
 Amends leftover-map unexplained leftover on graphic-display pair segments
 ([ADR 0276](0276-leftover-map-segment-unexplained-leftover.md)), leftover-map
 unexplained leftover on grouping comparison strip pair rows