feat(reports): leftover-map item coverage on grouping comparison graphic (v2.64.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) 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) 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
@@ -503,8 +503,18 @@ Do not invent leftover-map coverage from plotted marker count, leftover pair
 count, leftover-map rank, leftover-map distance, leftover-map axis share,
 leftover-map reconstruction, leftover residual, leftover-map item coverage,
 leftover-map incomplete post coverage, leftover-map incomplete item coverage,
-or the count of unused axes. This increment does not caption leftover-map item
-coverage or leftover-map incomplete coverage on the comparison graphic.
+or the count of unused axes. ADR 0307 captions leftover-map item complete-case
+coverage on that grouping comparison leftover-map graphic when leftoverMapItemCoverageCounts
+returns usable complete-case integers; a missing, non-integer, negative-used,
+non-positive-scored, or used-greater-than-scored item coverage omits that leftover-map
+comparison graphic item coverage caption and keeps leftover-map comparison graphic
+coverage when leftoverMapCoverageCounts returns usable complete-case integers.
+Do not invent leftover-map item coverage from plotted criterion marker count,
+leftover pair count, leftover-map rank, leftover-map distance, leftover-map
+axis share, leftover-map reconstruction, leftover residual, leftover-map post
+coverage, leftover-map incomplete post coverage, leftover-map incomplete item
+coverage, or the count of unused axes. This increment does not caption leftover-map
+incomplete coverage on the comparison 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
@@ -557,6 +567,10 @@ comparison leftover-map graphic with persisted leftover-map axis share.
 Grouping comparison leftover-map complete-case coverage (ADR 0306) captions that
 grouping comparison leftover-map graphic with persisted leftover-map complete-case
 coverage when leftoverMapCoverageCounts returns usable complete-case integers.
+Grouping comparison leftover-map item complete-case coverage (ADR 0307) captions
+that grouping comparison leftover-map graphic with persisted leftover-map item
+complete-case coverage when leftoverMapItemCoverageCounts returns usable
+complete-case integers.
 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

@@ -706,8 +706,11 @@ on that grouping comparison leftover-map graphic when the persisted share
 is finite.
 ADR 0306 captions leftover-map complete-case coverage on that grouping
 comparison leftover-map graphic when leftoverMapCoverageCounts returns usable
-complete-case integers and does not caption leftover-map item coverage or
-leftover-map incomplete coverage on that comparison plot.
+complete-case integers.
+ADR 0307 captions leftover-map item complete-case coverage on that grouping
+comparison leftover-map graphic when leftoverMapItemCoverageCounts returns usable
+complete-case integers and does not caption leftover-map incomplete coverage
+on that comparison plot.
 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
@@ -741,8 +744,9 @@ incomplete item coverage (ADR 0292), leftover-map reconstruction `R̂`
 (ADR 0302), leftover-map coordinates on the compare leftover-pair payload
 (ADR 0303), leftover-map graphic display on the grouping comparison strip
 (ADR 0304), leftover-map axis share on the grouping comparison leftover-map
-graphic (ADR 0305), and leftover-map complete-case coverage on the grouping
-comparison leftover-map graphic (ADR 0306);
+graphic (ADR 0305), leftover-map complete-case coverage on the grouping
+comparison leftover-map graphic (ADR 0306), and leftover-map item complete-case
+coverage on the grouping comparison leftover-map graphic (ADR 0307);
 `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.64.0-leftover-map-compare-plot-item-coverage.md

@@ -0,0 +1,25 @@
+## 2.64.0 — Leftover-map item complete-case coverage on grouping comparison leftover-map graphic
+
+- Caption leftover-map item complete-case coverage on the grouping comparison
+  leftover-map graphic (ADR 0307). 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, and a plot caption that matches leftover-map item
+  complete-case coverage on the grouping comparison leftover-map graphic; click
+  a post marker or a pair button opens that post. A missing, non-integer,
+  negative-used, non-positive-scored, or used-greater-than-scored item coverage
+  omits that leftover-map comparison graphic item coverage caption and keeps
+  leftover-map comparison graphic coverage when leftoverMapCoverageCounts
+  returns usable complete-case integers. Coverage `0 of M` is shown when that
+  persisted used count is a non-negative integer. Comparison copy uses
+  `Leftover map comparison graphic item coverage` so it stays distinct from
+  hyphen `Leftover-map graphic item coverage` and from strip
+  `Leftover map comparison item coverage`. This increment does not caption
+  leftover-map incomplete post coverage or leftover-map incomplete item coverage
+  on the comparison graphic. Do not invent item coverage from plotted criterion
+  marker count, leftover pair count, leftover-map rank, leftover-map distance,
+  leftover-map axis share, leftover-map reconstruction, leftover-map post
+  coverage, leftover-map incomplete post coverage, leftover-map incomplete item
+  coverage, or the count of unused axes. Never invent a leftover score. Never
+  invent a theta. No new columns.

CHANGELOG.md

@@ -8,6 +8,78 @@ All notable changes to this project are documented here. Format follows
 
 ### Added
 
+- Period leftover pairs now name leftover-map item complete-case coverage on the
+  grouping comparison leftover-map graphic (ADR 0307 / v2.64.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 axis share on the grouping comparison leftover-map
+  graphic 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, grouping comparison
+  leftover-pair buttons that match leftover-map unexplained leftover `U` on the
+  pair row, grouping comparison leftover-pair buttons that match leftover residual
+  `R` on the pair row, grouping comparison leftover-pair buttons that match leftover
+  observed `Y` on the pair row, grouping comparison leftover-pair buttons that match
+  leftover expected `E` on the pair row, grouping comparison leftover-pair buttons
+  that match leftover-map rank on the pair row, grouping comparison leftover-pair
+  buttons that match leftover-map coordinates `ξ` / `ζ` on the pair row, a live
+  compare payload that carries those persisted leftover-map coordinates, the
+  grouping comparison leftover-map graphic of those already-named coordinates when
+  four leftover-map axes are finite, leftover-map axis share on that grouping
+  comparison leftover-map graphic when the persisted share is finite, leftover-map
+  complete-case coverage on that grouping comparison leftover-map graphic when
+  leftoverMapCoverageCounts returns usable complete-case integers, and leftover-map
+  item complete-case coverage on that grouping comparison leftover-map graphic when
+  leftoverMapItemCoverageCounts returns usable complete-case integers; click a post
+  marker or a pair button opens that post. A missing, non-integer, negative-used,
+  non-positive-scored, or used-greater-than-scored item coverage omits that leftover-map
+  comparison graphic item coverage caption and keeps leftover-map comparison graphic
+  coverage when leftoverMapCoverageCounts returns usable complete-case integers,
+  leftover map comparison axis share when finite, leftover map comparison axis text,
+  leftover-map rank when that rank is a non-negative integer, leftover expected `E`
+  when finite, leftover observed `Y` when finite, leftover residual `R` when finite,
+  leftover-map unexplained leftover `U` when finite, 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. Coverage `0 of M`
+  is shown when that persisted used count is a non-negative integer. Rank-0 origin
+  cells still plot at `(0, 0)` and still name item coverage when that item coverage
+  is persisted. Comparison copy uses `Leftover map comparison graphic item coverage`
+  so it stays distinct from hyphen `Leftover-map graphic item coverage` and from
+  strip `Leftover map comparison item coverage`. Post coverage and item coverage omit
+  independently. This increment does not caption leftover-map incomplete post coverage
+  or leftover-map incomplete item coverage on the comparison graphic. Do not invent
+  leftover-map item coverage from plotted criterion marker count, leftover pair count,
+  leftover-map rank, leftover-map distance, leftover-map axis share, leftover expected,
+  leftover observed, leftover residual, leftover-map reconstruction, leftover-map
+  unexplained leftover, leftover-map post 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. 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 complete-case coverage on the
   grouping comparison leftover-map graphic (ADR 0306 / v2.63.0). After
   `make seed`, closest and farthest leftover pairs sit above the member list

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), 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), 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/0282-leftover-map-plot-item-coverage.md

@@ -3,6 +3,9 @@
 **Decision status:** Accepted
 **Date:** 2026-08-30
 
+**Amended by:** [ADR 0307](0307-leftover-map-compare-plot-item-coverage.md)
+(leftover-map item complete-case coverage 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-map complete-case
 coverage ([ADR 0168](0168-leftover-map-complete-case-coverage.md)). Independent of

docs/adr/0290-leftover-map-compare-item-coverage.md

@@ -3,6 +3,9 @@
 **Decision status:** Accepted
 **Date:** 2026-08-30
 
+**Amended by:** [ADR 0307](0307-leftover-map-compare-plot-item-coverage.md)
+(leftover-map item complete-case coverage 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-map
 complete-case coverage ([ADR 0168](0168-leftover-map-complete-case-coverage.md)),

docs/adr/0304-leftover-map-compare-graphic.md

@@ -6,7 +6,9 @@
 **Amended by:** [ADR 0305](0305-leftover-map-compare-plot-axis-share.md)
 (leftover-map axis share on the grouping comparison leftover-map graphic),
 [ADR 0306](0306-leftover-map-compare-plot-coverage.md)
-(leftover-map complete-case coverage on the grouping comparison leftover-map graphic)
+(leftover-map complete-case coverage on the grouping comparison leftover-map graphic),
+[ADR 0307](0307-leftover-map-compare-plot-item-coverage.md)
+(leftover-map item complete-case coverage 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-map

docs/adr/0306-leftover-map-compare-plot-coverage.md

@@ -3,6 +3,9 @@
 **Decision status:** Accepted
 **Date:** 2026-08-31
 
+**Amended by:** [ADR 0307](0307-leftover-map-compare-plot-item-coverage.md)
+(leftover-map item complete-case coverage on the grouping comparison leftover-map graphic)
+
 Amends leftover-map complete-case coverage on the graphic display
 ([ADR 0281](0281-leftover-map-plot-coverage.md)), leftover-map graphic
 display on the grouping comparison strip