feat(reports): leftover-map incomplete item coverage on graphic display (v2.41.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) 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) 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
@@ -354,6 +354,13 @@ scored post entering the map; a missing, non-integer, or negative dropped
 count, or a dropped count that contradicts usable complete-case integers,
 omits that leftover-map incomplete post caption and does not invent dropped
 posts from scored minus used or from plotted marker count.
+ADR 0284 captions the leftover-map graphic display with persisted leftover-map
+incomplete item coverage so a `used N of M scored criteria` caption is not
+read as every scored criterion entering the map; a missing, non-integer, or
+negative dropped count, or a dropped count that contradicts usable item
+complete-case integers, omits that leftover-map incomplete item caption and
+does not invent dropped criteria from scored minus used or from 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
@@ -369,7 +376,9 @@ and are not a leftover score. Complete-case coverage (ADR 0168) persists to
 graphic with how many scored posts entered the map. Item complete-case coverage
 (ADR 0282) captions the leftover-map graphic with how many scored criteria
 entered the map. Incomplete post coverage (ADR 0283) captions the leftover-map
-graphic with how many scored posts stayed out of the factorization.
+graphic with how many scored posts stayed out of the factorization. Incomplete
+item coverage (ADR 0284) captions the leftover-map graphic with how many
+scored criteria stayed out of the factorization.
 
 Authorized occupational construct catalog search (ADR 0257) matches official
 O*NET preferred labels or descriptions only when a source-eligible, ABAC-visible

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) 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) 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
@@ -661,15 +661,18 @@ expected `E`. ADR 0280 captions leftover-map pair segments with persisted leftov
 rank. ADR 0281 captions the leftover-map graphic display with persisted leftover-map
 complete-case coverage. ADR 0282 captions the leftover-map graphic display with
 persisted leftover-map item complete-case coverage. ADR 0283 captions the leftover-map
-graphic display with persisted leftover-map incomplete post coverage. Click a post marker or a pair button
+graphic display with persisted leftover-map incomplete post coverage. ADR 0284
+captions the leftover-map graphic display with persisted leftover-map incomplete
+item coverage. 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
 `report_leftover_map_axis`. Complete-case leftover-map coverage (ADR
 0168) persists to `report_leftover_map_coverage` so readers see how
 many scored posts entered the factorization, including on the graphic,
 and how many scored criteria entered the factorization on the graphic,
-and how many scored posts stayed incomplete and out of the factorization. Results persist to
+and how many scored posts stayed incomplete and out of the factorization,
+and how many scored criteria stayed incomplete and out of the factorization. Results persist to
 `report_period_score` / `report_member_score`.
 `GET /api/reports/{grouping}` lists the trend;
 `GET /api/reports/{grouping}/{period}` is ABAC-filtered;

CHANGELOG.d/2.41.0-leftover-map-plot-incomplete-item.md

@@ -0,0 +1,28 @@
+## 2.41.0 — Leftover-map incomplete item coverage on the graphic display
+
+- Caption the leftover-map graphic display with persisted leftover-map
+  incomplete item coverage (ADR 0284). 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, and a plot caption that matches leftover-map incomplete item
+  coverage; click a post marker or a pair button opens that post.
+  A missing, non-integer, or negative dropped count, or a dropped count
+  that contradicts usable item complete-case integers, omits that leftover-map
+  incomplete item caption. Dropped `0` is shown when that persisted
+  dropped count is a non-negative integer. Do not invent dropped criteria
+  from scored minus used, plotted criterion marker count, leftover-map
+  distance, leftover-map rank, leftover-map post coverage, leftover-map
+  item coverage, leftover-map incomplete post coverage, or the count of
+  unused axes. Never invent a leftover score. Never invent a theta. No
+  new columns.

CHANGELOG.md

@@ -8,6 +8,33 @@ All notable changes to this project are documented here. Format follows
 
 ### Added
 
+- Period leftover pairs now caption the leftover-map graphic display with
+  persisted leftover-map incomplete item coverage (ADR 0284 / v2.41.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, and a plot caption that matches
+  leftover-map incomplete item coverage; click a post marker or a
+  pair button opens that post. A missing, non-integer, or negative
+  dropped count, or a dropped count that contradicts usable item
+  complete-case integers, omits that leftover-map incomplete item caption.
+  Dropped `0` is shown when that persisted dropped count is a non-negative
+  integer. Do not invent dropped criteria from scored minus used, plotted
+  criterion marker count, leftover-map distance, leftover-map rank,
+  leftover-map post coverage, leftover-map item coverage, leftover-map
+  incomplete post coverage, or the count of unused axes. Never invent a
+  leftover score or a theta. No new columns.
+
 - Period leftover pairs now caption the leftover-map graphic display with
   persisted leftover-map incomplete post coverage (ADR 0283 / v2.40.0). After
   `make seed`, closest and farthest leftover pairs sit above the member

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), 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), 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),