feat(reports): leftover-map item complete-case coverage on grouping comparison strip (v2.47.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) 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) 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
@@ -391,9 +391,15 @@ compares leftover pairs can read how many scored posts entered each grouping's
 Gabriel factorization; a missing, non-integer, negative-used, non-positive-scored,
 or used-greater-than-scored coverage omits that leftover-map comparison coverage
 note and does not invent post coverage from leftover pair count or plotted
-marker count. The strip does not gain leftover-map item coverage, leftover-map
-incomplete post coverage, leftover-map incomplete item coverage, or the
-leftover-map graphic.
+marker count. The strip does not gain leftover-map incomplete post coverage,
+leftover-map incomplete item coverage, or the leftover-map graphic.
+ADR 0290 captions the grouping comparison strip with persisted leftover-map
+item complete-case coverage through leftoverMapItemCoverageCounts so a buyer who
+compares leftover pairs can read how many scored criteria entered each grouping's
+Gabriel factorization; a missing, non-integer, negative-used, non-positive-scored,
+or used-greater-than-scored item coverage omits that leftover-map comparison item
+coverage note and does not invent item coverage from leftover pair count or plotted
+criterion marker count.
 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
@@ -410,6 +416,8 @@ graphic with how many scored posts entered the map. Pair-list post complete-case
 coverage (ADR 0288) fail-closes that pair-list note through leftoverMapCoverageCounts.
 Grouping comparison complete-case coverage (ADR 0289) captions the grouping
 comparison strip with how many scored posts entered each grouping's map.
+Grouping comparison item complete-case coverage (ADR 0290) captions the grouping
+comparison strip with how many scored criteria entered each grouping's map.
 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

@@ -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 / 0275 / 0276 / 0277 / 0278 / 0279 / 0280 / 0281 / 0282 / 0283 / 0284 / 0285 / 0286 / 0287 / 0288 / 0289) persist to `report_leftover_pair` with signed residual `R`,
+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) 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
@@ -669,7 +669,9 @@ incomplete post coverage. ADR 0287 captions the leftover pair list with persiste
 incomplete item coverage. ADR 0288 fail-closes leftover-map post complete-case coverage
 on the leftover pair list through leftoverMapCoverageCounts. ADR 0289 captions the
 grouping comparison strip with persisted leftover-map post complete-case coverage
-through leftoverMapCoverageCounts. Click a post marker or a pair button
+through leftoverMapCoverageCounts. ADR 0290 captions the grouping comparison strip
+with persisted leftover-map item complete-case coverage through leftoverMapItemCoverageCounts.
+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
@@ -687,7 +689,8 @@ including on the pair list. Results persist to
 `GET /api/reports/{grouping}/{period}` is ABAC-filtered;
 `GET /api/reports/compare/{period}` is the home-page grouping strip
 and carries the same ABAC-filtered leftover pairs (ADR 0149) plus persisted
-leftover-map complete-case coverage (ADR 0289);
+leftover-map complete-case coverage (ADR 0289) and leftover-map item complete-case
+coverage (ADR 0290);
 `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.47.0-leftover-map-compare-item-coverage.md

@@ -0,0 +1,36 @@
+## 2.47.0 — Leftover-map item complete-case coverage on the grouping comparison strip
+
+- Caption leftover-map item complete-case coverage on the grouping comparison
+  strip through leftoverMapItemCoverageCounts (ADR 0290). 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,
+  and a grouping comparison note that matches leftover-map item
+  complete-case coverage; 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
+  item coverage note. Coverage `0 of M` is shown when that persisted used
+  count is a non-negative integer and scored is a positive integer. Do not
+  invent item coverage from leftover pair count, plotted criterion marker
+  count, leftover-map distance, leftover-map rank, leftover-map post
+  coverage, leftover-map incomplete post coverage, leftover-map incomplete
+  item coverage, or the count of unused axes. The strip does not gain
+  leftover-map incomplete post coverage, leftover-map incomplete item
+  coverage, or the leftover-map graphic. Never invent a leftover score.
+  Never invent a theta. No new columns.

CHANGELOG.md

@@ -8,6 +8,42 @@ All notable changes to this project are documented here. Format follows
 
 ### Added
 
+- Period leftover pairs now caption the grouping comparison strip with
+  persisted leftover-map item complete-case coverage through
+  leftoverMapItemCoverageCounts (ADR 0290 / v2.47.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,
+  and a grouping comparison note that matches leftover-map item
+  complete-case coverage; 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
+  item coverage note. Coverage `0 of M` is shown when that persisted used
+  count is a non-negative integer and scored is a positive integer. Do not
+  invent item coverage from leftover pair count, plotted criterion marker
+  count, leftover-map distance, leftover-map rank, leftover-map post
+  coverage, leftover-map incomplete post coverage, leftover-map incomplete
+  item coverage, or the count of unused axes. The strip does not gain
+  leftover-map incomplete post coverage, leftover-map incomplete item
+  coverage, or the leftover-map graphic. Never invent a leftover score or
+  a theta. No new columns.
+
 - Period leftover pairs now caption the grouping comparison strip with
   persisted leftover-map post complete-case coverage through
   leftoverMapCoverageCounts (ADR 0289 / v2.46.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), 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), 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),