diff --git a/AGENTS.md b/AGENTS.md index c4b34cac2..f47dea06d 100644 --- a/AGENTS.md +++ b/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) 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) 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 @@ -361,6 +361,12 @@ 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. +ADR 0285 captions the leftover pair list with persisted leftover-map item +complete-case coverage so a `used N of M scored posts` note is not read as +the scored-criterion census; a missing, non-integer, negative-used, +non-positive-scored, or used-greater-than-scored item coverage omits that +leftover-map item coverage note and does not invent item coverage 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 @@ -375,7 +381,8 @@ and are not a leftover score. Complete-case coverage (ADR 0168) persists to `report_leftover_map_coverage` and captions the pair list and the leftover-map 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 +entered the map. Item complete-case coverage on the pair list (ADR 0285) +captions the pair list 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. Incomplete item coverage (ADR 0284) captions the leftover-map graphic with how many scored criteria stayed out of the factorization. diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 6ceeeb4b2..10a849ac3 100644 --- a/ARCHITECTURE.md +++ b/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) 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) 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 @@ -663,14 +663,16 @@ 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. ADR 0284 captions the leftover-map graphic display with persisted leftover-map incomplete -item coverage. Click a post marker or a pair button +item coverage. ADR 0285 captions the leftover pair list with persisted leftover-map +item complete-case 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 criteria entered the factorization on the graphic +and on the pair list, 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`. diff --git a/CHANGELOG.d/2.42.0-leftover-map-list-item-coverage.md b/CHANGELOG.d/2.42.0-leftover-map-list-item-coverage.md new file mode 100644 index 000000000..b13e6884b --- /dev/null +++ b/CHANGELOG.d/2.42.0-leftover-map-list-item-coverage.md @@ -0,0 +1,27 @@ +## 2.42.0 — Leftover-map item complete-case coverage on the pair list + +- Caption the leftover pair list with persisted leftover-map item + complete-case coverage (ADR 0285). 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, and a pair-list 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 item + coverage note. Coverage `0 of M` is shown when that persisted used + count is a non-negative integer. Do not invent item coverage from + plotted criterion marker count, leftover-map distance, leftover-map + rank, leftover-map post coverage, or the count of unused axes. Never + invent a leftover score. Never invent a theta. No new columns. diff --git a/CHANGELOG.md b/CHANGELOG.md index 568249bf9..754045060 100644 --- a/CHANGELOG.md +++ b/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 pair list with persisted + leftover-map item complete-case coverage (ADR 0285 / v2.42.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, and a pair-list 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 item coverage note. Coverage `0 of M` + is shown when that persisted used count is a non-negative integer. Do + not invent item coverage from plotted criterion marker count, + leftover-map distance, leftover-map rank, leftover-map 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 item coverage (ADR 0284 / v2.41.0). After `make seed`, closest and farthest leftover pairs sit above the member diff --git a/CLAUDE.md b/CLAUDE.md index f6d2b42aa..0884fdca8 100644 --- a/CLAUDE.md +++ b/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), 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), 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), diff --git a/docs/adr/0285-leftover-map-list-item-coverage.md b/docs/adr/0285-leftover-map-list-item-coverage.md new file mode 100644 index 000000000..ba8633cde --- /dev/null +++ b/docs/adr/0285-leftover-map-list-item-coverage.md @@ -0,0 +1,175 @@ +# ADR 0285 — Name leftover-map item complete-case coverage on the pair list + +**Decision status:** Proposed +**Date:** 2026-08-30 + +Amends [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 +leftover-map incomplete item coverage on the graphic display +([ADR 0284](0284-leftover-map-plot-incomplete-item.md)), leftover-map incomplete +post coverage on the graphic display +([ADR 0283](0283-leftover-map-plot-incomplete.md)), leftover-map item +complete-case coverage on the graphic display +([ADR 0282](0282-leftover-map-plot-item-coverage.md)), leftover-map complete-case +coverage on the graphic display +([ADR 0281](0281-leftover-map-plot-coverage.md)), leftover-map rank on pair +segments ([ADR 0280](0280-leftover-map-segment-rank.md)), leftover expected on pair +segments ([ADR 0279](0279-leftover-map-segment-expected.md)), leftover observed on +pair segments ([ADR 0278](0278-leftover-map-segment-observed.md)), leftover +residual on pair segments ([ADR 0277](0277-leftover-map-segment-residual.md)), +leftover-map unexplained leftover on pair segments +([ADR 0276](0276-leftover-map-segment-unexplained-leftover.md)), leftover-map +cross share on pair segments ([ADR 0275](0275-leftover-map-segment-cross-share.md)), +leftover-map unexplained leftover share on pair segments +([ADR 0274](0274-leftover-map-segment-unexplained-share.md)), leftover-map +explained leftover share on pair segments +([ADR 0273](0273-leftover-map-segment-explained-share.md)), leftover-map +reconstruction on pair segments +([ADR 0272](0272-leftover-map-segment-reconstruction.md)), leftover-map +distance on pair segments ([ADR 0271](0271-leftover-map-segment-distance.md)), +leftover-map coordinate ticks ([ADR 0270](0270-leftover-map-coordinate-ticks.md)), +leftover-map axis share on the graphic display +([ADR 0269](0269-leftover-map-axis-share-plot.md)), leftover residual +disclosure ([ADR 0162](0162-leftover-residual-disclosure.md)), leftover +observed `Y` / expected `E` ([ADR 0163](0163-leftover-observed-expected.md)), +leftover-map explained leftover share persistence +([ADR 0266](0266-leftover-map-explained-share.md)), leftover-map +unexplained leftover share persistence +([ADR 0233](0233-leftover-map-unexplained-share.md)), leftover-map +reconstruction persistence ([ADR 0201](0201-leftover-map-reconstruction.md)), +leftover-map cross share persistence +([ADR 0185](0185-leftover-map-cross-share.md)), leftover-map unexplained leftover +persistence ([ADR 0182](0182-leftover-map-unexplained.md)), leftover-map rank +persistence ([ADR 0164](0164-leftover-map-rank.md)), and leftover-map axis +share persistence ([ADR 0148](0148-leftover-map-axis-share.md)). + +## Context + +ADR 0168 already persists `map_item_count` / `scored_item_count` on +`report_leftover_map_coverage` and captions the pair list with post +complete-case coverage. ADR 0282 already names persisted leftover-map item +complete-case coverage on the leftover-map graphic display. The pair-list +note still names only posts, so a buyer who reads `used N of M scored posts +(complete-case)` above the pair buttons can treat those pair criteria as +the scored-criterion census even after incomplete columns were dropped. +Incomplete columns are dropped from Gabriel factorization; hiding item +coverage on the pair list lets a sparse criterion with one missing post +vanish without a next action. + +This increment names leftover-map item complete-case coverage on the +pair-list note. It does not add columns. It does not recompute item coverage +from plotted criterion marker count, leftover-map distance, or leftover-map +rank. It does not persist leftover-map inner product, cosine, or length as +separate columns. It does not land Post quality on the leftover criterion. +Leftover-map distance stays two-axis Euclidean. Do not invent a leftover +score. Do not invent a theta. + +The dashboard stack already used neighbouring leftover facts under other +numbers. This protected increment uses **0285** so it does not collide with +leftover-map incomplete item coverage on the graphic display (0284), +leftover-map incomplete post coverage on the graphic display (0283), +leftover-map item complete-case coverage on the graphic display (0282), +leftover-map complete-case coverage on the graphic display (0281), leftover-map +rank on pair segments (0280), leftover expected on pair segments (0279), leftover +observed on pair segments (0278), leftover residual on pair segments (0277), +leftover-map unexplained leftover on pair segments (0276), leftover-map cross +share on pair segments (0275), leftover-map unexplained leftover share on pair +segments (0274), leftover-map explained leftover share on pair segments (0273), +leftover-map reconstruction on pair segments (0272), leftover-map distance on +pair segments (0271), leftover-map coordinate ticks (0270), leftover-map axis +share on the graphic display (0269), leftover-map graphic display (0268), +leftover-map coordinates (0267 / migration 0245), leftover-map explained leftover +share persistence (0266 / migration 0244), leftover-map unexplained leftover +share persistence (0233 / migration 0233), leftover-map reconstruction +persistence (0201 / migration 0206), leftover-map cross share persistence (0185), +leftover-map unexplained leftover persistence (0182), leftover residual +disclosure (0162), leftover observed `Y` / expected `E` persistence (0163), +leftover-map rank persistence (0164), leftover coverage persistence (0168), +two-axis leftover-map distance persistence, leftover-map axis share persistence +(0148), leftover interaction-map persistence, occupational construct catalog +search (0265), or the dashboard stacks. + +## Decision + +On the leftover pair list, caption persisted leftover-map item complete-case +coverage as `Leftover map used N of M scored criteria (complete-case)`, using +the persisted `map_item_count` / `scored_item_count` integers. A missing +coverage row, a non-integer count, a negative used count, a non-positive +scored count, or used greater than scored omits that leftover-map item +coverage note and keeps the pair-list post coverage note and any leftover-map +distance, reconstruction, explained leftover share, unexplained leftover share, +leftover-map cross share, unexplained leftover, leftover residual, leftover +observed, leftover expected, leftover-map rank, leftover-map post coverage, +leftover-map item coverage, leftover-map incomplete post, or leftover-map +incomplete item caption on the graphic. 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 plotted criterion marker count, +leftover-map distance, leftover-map rank, leftover-map post coverage, or the +count of unused axes. Click a pair button to open that post. The grouping +comparison strip (ADR 0149) stays on its reduced leftover payload and does +not gain this leftover-map item coverage caption. + +Do not add SQL. Do not edit shipped migrations. Do not persist inner +product, cosine, or length as separate columns. Do not invent a leftover +score. Do not invent a theta. + +## Consequences + +After `make seed`, closest and farthest leftover pairs sit above the member +list with the leftover-map graphic display of persisted `ξ` and `ζ`, +leftover-map axes name persisted Gabriel inertia share when finite, +leftover-map axis ticks name the same coordinates shown on the pair row, +pair segments name persisted leftover-map distance `d`, persisted leftover-map +reconstruction `R̂`, persisted leftover-map explained leftover share `e`, +persisted leftover-map unexplained leftover share `s`, persisted leftover-map +cross share `x`, persisted leftover-map unexplained leftover `U`, persisted +leftover residual `R`, persisted leftover observed `Y`, persisted leftover +expected `E`, persisted leftover-map rank, the plot names persisted leftover-map +complete-case coverage, the plot names persisted leftover-map item +complete-case coverage, the plot names persisted leftover-map incomplete +post coverage, the plot names persisted leftover-map incomplete item +coverage, and the pair list names persisted leftover-map item complete-case +coverage; click a post marker or a pair button opens that post. +Hidden posts stay hidden. Rank-0 unused axes still plot at the origin and still +name item coverage on the pair list when that coverage is persisted. + +## Related + +Independent of leftover interaction-map persistence, leftover-criterion +evaluation landing, leftover residual disclosure, leftover-map +complete-case coverage persistence, leftover-map axis share persistence, +leftover pairs on the grouping comparison strip, two-axis leftover-map +distance persistence, leftover-map rank persistence, leftover-map inner +product, leftover-map cosine, leftover-map length, leftover-map +reconstruction persistence, leftover-map unexplained leftover persistence, +leftover-map cross share persistence, leftover-map unexplained leftover +share persistence, leftover-map explained leftover share persistence, +leftover-map coordinate persistence, leftover-map graphic display, +leftover-map axis share on the graphic display, leftover-map coordinate +ticks, leftover-map distance on pair segments, leftover-map reconstruction +on pair segments, leftover-map explained leftover share on pair segments, +leftover-map unexplained leftover share on pair segments, leftover-map +cross share on pair segments, leftover-map unexplained leftover on pair +segments, leftover residual on pair segments, leftover observed on pair +segments, leftover expected on pair segments, leftover-map rank on pair +segments, leftover-map complete-case coverage on the graphic display, +leftover-map item complete-case coverage on the graphic display, +leftover-map incomplete post coverage on the graphic display, and +leftover-map incomplete item coverage on the graphic display. + +## References + +Gabriel, K. R. (1971). The biplot graphic display of matrices with +application to principal component analysis. *Biometrika, 58*(3), +453–467. https://doi.org/10.1093/biomet/58.3.453 + +Jeon, M., Jin, I. H., Schweinberger, M., & Baugh, S. (2021). Mapping +unobserved item–respondent interactions: A latent space item response +model with interaction map. *Psychometrika, 86*(2), 378–403. +https://doi.org/10.1007/s11336-021-09762-5 +(LSIRM interaction `−γ‖ξ_j − ζ_i‖` after main effects +`α_j − β_i`; typically `p = 2` for the interaction map. Gabriel +reconstruction of the leftover cell is the two-axis inner product +`R̂ = ξ_{1:2} · ζ_{1:2}`. Incomplete columns are dropped from the +complete-case residual rectangle; pair-list item coverage names how many +scored criteria entered that factorization.) diff --git a/docs/product-technical-gap-baseline.md b/docs/product-technical-gap-baseline.md index a5d79a0b6..becb5fa26 100644 --- a/docs/product-technical-gap-baseline.md +++ b/docs/product-technical-gap-baseline.md @@ -1,5 +1,58 @@ # Product & Technical Gap Baseline +> Exact-head loop overlay: 2026-08-30 21:22 KST. Protected `main` is +> `cb187cadee5fb6c46d8a944815ccc154a1e028d1` after unauthorized squash +> of leftover-map coordinates (v2.24.0 / #782). Revert #808 +> (`revert-pr782-unauthorized` @ `1af3e53e`) restores `main` toward +> `fc13acaa` (v2.23.0) and still needs independent APPROVE. GitHub +> writes work (comment/close/create-PR/push). Token still has empty +> `X-OAuth-Scopes`; repo permission is ADMIN. Open leftover stack +> still lacks independent APPROVE. Do not self-approve. +> #782 leftover-map coordinates through pair-segment distance +> (v2.24.0–v2.28.0 / ADR 0267–0271) is `9bdd3e4d`. #802 explained +> leftover share on pair segments (v2.30.0 / ADR 0273, includes v2.29 +> reconstruction) is `79ec22f0`. #803 unexplained leftover share on pair +> segments (v2.31.0 / ADR 0274) is `089a1571`. #804 leftover-map cross +> share on pair segments (v2.32.0 / ADR 0275) is `c513002b`. #805 leftover-map +> unexplained leftover `U` on pair segments (v2.33.0 / ADR 0276) is +> `e3fdfd74`. #806 leftover residual `R` on pair segments (v2.34.0 / +> ADR 0277) is `33f6c3dd`. #809 leftover observed `Y` on pair segments +> (v2.35.0 / ADR 0278) is `b334b00e`. #810 leftover expected `E` on pair +> segments (v2.36.0 / ADR 0279) is `6e37757a`. #811 leftover-map rank on +> pair segments (v2.37.0 / ADR 0280) is `e626a1d0`. #812 leftover-map +> complete-case coverage on the graphic (v2.38.0 / ADR 0281) is `64964cb6`. +> #813 leftover-map item complete-case coverage on the graphic (v2.39.0 / +> ADR 0282) is `de2a8a8b`. #814 leftover-map incomplete post coverage on +> the graphic (v2.40.0 / ADR 0283) is `77292872`. #815 leftover-map +> incomplete item coverage on the graphic (v2.41.0 / ADR 0284) is +> `63092de`. Leave +> #782/#802/#803/#804/#805/#806/#808/#809/#810/#811/#812/#813/#814/#815 open for +> independent review. Do not squash-merge stacked leftover PRs onto an +> unprotected leftover base. Do not merge #808 without independent APPROVE. +> Strix on #782 failed closed at `Run Strix (quick)`; do not weaken +> fail-closed on `Vulnerabilities [1-9]`. Org Strix `ModelBehaviorError` +> classifier is already on ContextualWisdomLab/.github. Copilot review is +> not independent APPROVE. Issues #79 and #87 stay open. #96 is already +> closed. Only collaborator is `seonghobae`; no independent reviewer can +> be requested from this token. +> +> Next buyer increment on this cycle: leftover-map item complete-case +> coverage on the pair list (ADR 0285 / v2.42.0) delivered locally on +> `feat/leftover-map-list-item-coverage-v2420`. Caption the pair-list +> note with persisted leftover-map item complete-case coverage so a +> `used N of M scored posts` note is not read as the scored-criterion +> census. UI-only; no new columns. Missing, non-integer, negative-used, +> non-positive-scored, or used-greater-than-scored item coverage omits +> that leftover-map item coverage note. Coverage `0 of M` is shown when +> persisted. Do not invent item coverage from plotted criterion marker +> count, leftover-map distance, leftover-map rank, leftover-map post +> coverage, or the count of unused axes. Do not invent leftover scores. +> Stack onto leftover branch `feat/leftover-map-plot-incomplete-item-v2410` +> / #815; leave the PR open for independent review. Do not squash-merge +> onto the leftover base. Do not persist leftover-map inner product, +> cosine, or length as separate columns. Grouping comparison strip +> (ADR 0149) does not gain this caption. + > Exact-head loop overlay: 2026-08-30 20:35 KST. Protected `main` is > `cb187cadee5fb6c46d8a944815ccc154a1e028d1` after unauthorized squash > of leftover-map coordinates (v2.24.0 / #782). Revert #808 diff --git a/docs/storybook-inventory.md b/docs/storybook-inventory.md index 78bcc406e..5b595bf07 100644 --- a/docs/storybook-inventory.md +++ b/docs/storybook-inventory.md @@ -6,7 +6,7 @@ operator-facing control you can click before changing product CSS. | Story | Operator next action | Token / module | |---|---|---| | `Reports/LeftoverMapPlot` | Read the leftover-map graphic display of persisted `ξ` (posts) and `ζ` (criteria), match axis ticks to those coordinates, pair-segment `d` to leftover-map distance, pair-segment `R̂` to leftover-map reconstruction, pair-segment `R̂²/R²` to leftover-map explained leftover share, pair-segment `U²/R²` to leftover-map unexplained leftover share, pair-segment `2R̂U/R²` to leftover-map cross share, pair-segment `U` to leftover-map unexplained leftover, pair-segment `R` to leftover residual, pair-segment `Y` to leftover observed, pair-segment `E` to leftover expected, and pair-segment leftover-map rank, then click a post marker to open that post. Leftover-map axes name persisted leftover-map axis share when finite. The plot names leftover-map complete-case coverage, leftover-map item complete-case coverage, leftover-map incomplete post coverage, and leftover-map incomplete item coverage when persisted. `ClosestAndFarthest`, `RankZeroOrigin`, `MissingCoordinates`, and `MissingAxisShare` cover two-pair maps, rank-0 origin with 0% share, a `0` tick, `d 0.00`, `R̂ 0.00`, `R̂²/R² 0.00`, `U²/R² 0.00`, `2R̂U/R² 0.00`, `U 0.00`, `R 0.00`, `Y 0.00`, `E 0.00`, and `rank 0`, omitted plots, and missing share that keeps existing leftover-map axis text. The plot does not invent a leftover score. | `LeftoverMapPlot`, `leftoverMapPlotLayout`, `leftoverMapPlotAxisShare`, `--color-primary`, `--color-palette-blue-mid` | -| `Reports/LeftoverPairList` | Read closest/farthest leftover pairs with named `R`, `Y`/`E`, rank, `U`, `s`, `e`, `x`, `R̂`, `ξ`/`ζ`, and `d`, then open that post. The leftover-map graphic display sits above the pair buttons when coordinates are finite, leftover-map axes name persisted leftover-map axis share, leftover-map axis ticks name persisted coordinates, pair segments name persisted leftover-map distance, pair segments name persisted leftover-map reconstruction, pair segments name persisted leftover-map explained leftover share, pair segments name persisted leftover-map unexplained leftover share, pair segments name persisted leftover-map cross share, pair segments name persisted leftover-map unexplained leftover, pair segments name persisted leftover residual, pair segments name persisted leftover observed, pair segments name persisted leftover expected, and pair segments name persisted leftover-map rank. | `LeftoverPairList`, `LeftoverMapPlot`, `ticket-list`, `post-badge` | +| `Reports/LeftoverPairList` | Read closest/farthest leftover pairs with named `R`, `Y`/`E`, rank, `U`, `s`, `e`, `x`, `R̂`, `ξ`/`ζ`, and `d`, then open that post. The leftover-map graphic display sits above the pair buttons when coordinates are finite, leftover-map axes name persisted leftover-map axis share, leftover-map axis ticks name persisted coordinates, pair segments name persisted leftover-map distance, pair segments name persisted leftover-map reconstruction, pair segments name persisted leftover-map explained leftover share, pair segments name persisted leftover-map unexplained leftover share, pair segments name persisted leftover-map cross share, pair segments name persisted leftover-map unexplained leftover, pair segments name persisted leftover residual, pair segments name persisted leftover observed, pair segments name persisted leftover expected, and pair segments name persisted leftover-map rank. The pair-list note names leftover-map complete-case coverage and leftover-map item complete-case coverage when persisted. | `LeftoverPairList`, `LeftoverMapPlot`, `ticket-list`, `post-badge` | | `Workspace/OperationsDashboard` | Compare Event and post counts, inspect external-information coverage, then open the cited source behind a claim, handover, or repeat-issue fact. `EvidenceReady`, `NarrowViewport`, `AnalysisPendingAndMissingEvidence`, `AnalysisFailed`, and `LoadError` cover populated, mobile, unavailable-evidence, analysis-pending, retryable failure, and transport-error states. | `--color-dashboard-*`, `OperationsDashboard` | | `Post/SimilarVocPanel` | Compare ontology/semantic similar VOC and prior action evidence, then open the source; unavailable states show no fabricated TEPP theta or weight. | `SimilarVocPanel.css`, `SimilarVocPanel` | | `Post/Recorded perspectives` | Read the imported primary and every evidence-connected additional Voice with its recorded truth state instead of flattening them into one compound category. `CombinedEvidence`, `RejectedEvidence`, and `NarrowViewport` cover desktop, rejected-evidence, and narrow layouts. | `VoicePerspectiveList`, `ticket-list`, `post-meta` | diff --git a/frontend/package.json b/frontend/package.json index 8dbd0fbda..819c3ae04 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,7 +1,7 @@ { "name": "frontend", "private": true, - "version": "2.41.0", + "version": "2.42.0", "type": "module", "scripts": { "dev": "vite", diff --git a/frontend/src/App.test.tsx b/frontend/src/App.test.tsx index d151aabe9..06fc4e489 100644 --- a/frontend/src/App.test.tsx +++ b/frontend/src/App.test.tsx @@ -4154,6 +4154,9 @@ describe("App, authenticated", () => { expect(screen.getByLabelText("Leftover map coverage")).toHaveTextContent( "Leftover map used 2 of 3 scored posts (complete-case)", ); + expect(screen.getByLabelText("Leftover map item coverage")).toHaveTextContent( + "Leftover map used 2 of 2 scored criteria (complete-case)", + ); expect(screen.getByLabelText("Leftover-map graphic coverage")).toHaveTextContent( "Leftover map used 2 of 3 scored posts (complete-case)", ); @@ -4231,6 +4234,9 @@ describe("App, authenticated", () => { render(); expect(await screen.findByLabelText("Grouping comparison")).toBeInTheDocument(); + expect( + within(screen.getByLabelText("Grouping comparison")).queryByLabelText("Leftover map item coverage"), + ).not.toBeInTheDocument(); expect( screen.getByRole("button", { name: "Compare Business unit (PU): Demo Report High, mean θ 0.81" }), ).toHaveTextContent("mean θ 0.81"); diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx index 4e9e95a59..c5a8647e3 100644 --- a/frontend/src/App.tsx +++ b/frontend/src/App.tsx @@ -119,6 +119,11 @@ import { tf, useLocale, } from "./i18n"; +import { + leftoverMapItemCoverageCounts, + LEFTOVER_MAP_LIST_ITEM_COVERAGE_LABEL, + LEFTOVER_MAP_PLOT_ITEM_COVERAGE, +} from "./leftoverMapCoverage"; import "./App.css"; const AdminPanel = lazy(() => import("./components/AdminPanel").then((module) => ({ default: module.AdminPanel }))); @@ -3811,7 +3816,9 @@ function ReportsPanel({ className="ticket-list" aria-label={openedGroupingLabel ? "Opened grouping report" : "Period report groups"} > - {orderedReports.map((report) => ( + {orderedReports.map((report) => { + const itemCoverageCounts = leftoverMapItemCoverageCounts(report.leftover_map_coverage); + return (
  • )} + {itemCoverageCounts !== null ? ( +

    + {tf(LEFTOVER_MAP_PLOT_ITEM_COVERAGE, itemCoverageCounts)} +

    + ) : null} {report.leftover_map_axes?.map((axis) => ( {tf("leftover axis {axis} {share}%", { @@ -3915,7 +3927,8 @@ function ReportsPanel({ )}
    • - ))} + ); + })} ) : null; diff --git a/frontend/src/components/LeftoverPairList.tsx b/frontend/src/components/LeftoverPairList.tsx index cae6e6c47..8481b1a44 100644 --- a/frontend/src/components/LeftoverPairList.tsx +++ b/frontend/src/components/LeftoverPairList.tsx @@ -76,7 +76,8 @@ export type LeftoverPairListProps = { * complete-case coverage on the graphic. ADR 0282 names persisted leftover-map * item complete-case coverage on the graphic. ADR 0283 names persisted leftover-map * incomplete post coverage on the graphic. ADR 0284 names persisted leftover-map - * incomplete item coverage on the graphic. Every badge still + * incomplete item coverage on the graphic. ADR 0285 names persisted leftover-map + * item complete-case coverage on the pair-list note. Every badge still * renders together before opening the named post. */ export function LeftoverPairList({ diff --git a/frontend/src/i18n.test.ts b/frontend/src/i18n.test.ts index 81a89622d..c46b22d21 100644 --- a/frontend/src/i18n.test.ts +++ b/frontend/src/i18n.test.ts @@ -78,6 +78,7 @@ describe("i18n", () => { "leftover-map rank {label}", "Leftover-map graphic coverage", "Leftover-map graphic item coverage", + "Leftover map item coverage", "Leftover-map graphic incomplete posts", "Leftover-map graphic incomplete items", "Leftover map used {used} of {scored} scored criteria (complete-case)", @@ -387,6 +388,16 @@ describe("i18n", () => { expect(t("Leftover-map graphic item coverage")).toBe(expected); }); + it.each([ + ["ko", "잔여 지도 기준 포함 범위"], + ["zh", "残差地图准则覆盖范围"], + ["ja", "残差マップの基準対象範囲"], + ["vi", "Phạm vi tiêu chí bản đồ phần dư"], + ] as const)("formats leftover map item coverage label in %s", (locale, expected) => { + setLocale(locale); + expect(t("Leftover map item coverage")).toBe(expected); + }); + it.each([ ["ko", "잔여 지도 그림 불완전 글"], ["zh", "残差图图形不完整帖文"], diff --git a/frontend/src/i18n.ts b/frontend/src/i18n.ts index 2cfc7c66c..1b0c0295b 100644 --- a/frontend/src/i18n.ts +++ b/frontend/src/i18n.ts @@ -268,6 +268,7 @@ const TRANSLATIONS: Partial>> = { "Analysis runs": "분석 실행", "Period reports": "기간 리포트", "Leftover map coverage": "잔여 지도 포함 범위", + "Leftover map item coverage": "잔여 지도 기준 포함 범위", "Leftover map used {used} of {scored} scored posts (complete-case)": "잔여 지도는 채점된 글 {scored}개 중 {used}개를 사용했습니다(완전사례)", "Leftover map used {used} of {scored} scored criteria (complete-case)": @@ -871,6 +872,7 @@ const TRANSLATIONS: Partial>> = { "Analysis runs": "分析运行", "Period reports": "周期报告", "Leftover map coverage": "残差地图覆盖范围", + "Leftover map item coverage": "残差地图准则覆盖范围", "Leftover map used {used} of {scored} scored posts (complete-case)": "残差地图使用了 {scored} 篇已评分帖文中的 {used} 篇（完全案例）", "Leftover map used {used} of {scored} scored criteria (complete-case)": @@ -1495,6 +1497,7 @@ const TRANSLATIONS: Partial>> = { "Analysis runs": "分析実行", "Period reports": "期間レポート", "Leftover map coverage": "残差マップの対象範囲", + "Leftover map item coverage": "残差マップの基準対象範囲", "Leftover map used {used} of {scored} scored posts (complete-case)": "残差マップは採点済み投稿 {scored} 件のうち {used} 件を使いました（完全ケース）", "Leftover map used {used} of {scored} scored criteria (complete-case)": @@ -2098,6 +2101,7 @@ const TRANSLATIONS: Partial>> = { "Analysis runs": "Lần chạy phân tích", "Period reports": "Báo cáo theo kỳ", "Leftover map coverage": "Phạm vi bản đồ phần dư", + "Leftover map item coverage": "Phạm vi tiêu chí bản đồ phần dư", "Leftover map used {used} of {scored} scored posts (complete-case)": "Bản đồ phần dư dùng {used} trên {scored} bài đã chấm (trường hợp đầy đủ)", "Leftover map used {used} of {scored} scored criteria (complete-case)": diff --git a/frontend/src/leftoverMapCoverage.test.ts b/frontend/src/leftoverMapCoverage.test.ts index d5aa62c37..7fb82f653 100644 --- a/frontend/src/leftoverMapCoverage.test.ts +++ b/frontend/src/leftoverMapCoverage.test.ts @@ -5,6 +5,8 @@ import { leftoverMapIncompleteItemCount, leftoverMapIncompletePostCount, leftoverMapItemCoverageCounts, + LEFTOVER_MAP_LIST_ITEM_COVERAGE_LABEL, + LEFTOVER_MAP_PLOT_ITEM_COVERAGE_LABEL, } from "./leftoverMapCoverage"; function coverage(overrides: Partial = {}): LeftoverMapCoverage { @@ -94,6 +96,12 @@ describe("leftoverMapItemCoverageCounts", () => { scored: 2, }); }); + + it("keeps the pair-list item coverage label distinct from the graphic item coverage label", () => { + expect(LEFTOVER_MAP_LIST_ITEM_COVERAGE_LABEL).toBe("Leftover map item coverage"); + expect(LEFTOVER_MAP_PLOT_ITEM_COVERAGE_LABEL).toBe("Leftover-map graphic item coverage"); + expect(LEFTOVER_MAP_LIST_ITEM_COVERAGE_LABEL).not.toBe(LEFTOVER_MAP_PLOT_ITEM_COVERAGE_LABEL); + }); }); describe("leftoverMapIncompletePostCount", () => { diff --git a/frontend/src/leftoverMapCoverage.ts b/frontend/src/leftoverMapCoverage.ts index f6c2c6a67..ec0dada46 100644 --- a/frontend/src/leftoverMapCoverage.ts +++ b/frontend/src/leftoverMapCoverage.ts @@ -1,4 +1,4 @@ -/** Leftover-map complete-case coverage after IRT main effects (ADR 0168 / ADR 0281 / ADR 0282 / ADR 0283 / ADR 0284). */ +/** Leftover-map complete-case coverage after IRT main effects (ADR 0168 / ADR 0281 / ADR 0282 / ADR 0283 / ADR 0284 / ADR 0285). */ import type { LeftoverMapCoverage } from "./api"; @@ -12,6 +12,8 @@ export const LEFTOVER_MAP_PLOT_ITEM_COVERAGE_LABEL = "Leftover-map graphic item export const LEFTOVER_MAP_PLOT_ITEM_COVERAGE = "Leftover map used {used} of {scored} scored criteria (complete-case)"; +export const LEFTOVER_MAP_LIST_ITEM_COVERAGE_LABEL = "Leftover map item coverage"; + export const LEFTOVER_MAP_PLOT_INCOMPLETE_POST_LABEL = "Leftover-map graphic incomplete posts"; export const LEFTOVER_MAP_PLOT_INCOMPLETE_POST = diff --git a/frontend/src/leftoverMapPlotLayout.ts b/frontend/src/leftoverMapPlotLayout.ts index 25293ac62..fce6b71ff 100644 --- a/frontend/src/leftoverMapPlotLayout.ts +++ b/frontend/src/leftoverMapPlotLayout.ts @@ -12,7 +12,9 @@ * rank (ADR 0280). The plot names persisted leftover-map complete-case * coverage (ADR 0281), leftover-map item complete-case coverage * (ADR 0282), leftover-map incomplete post coverage (ADR 0283), and - * leftover-map incomplete item coverage (ADR 0284). + * leftover-map incomplete item coverage (ADR 0284). Pair-list item + * complete-case coverage (ADR 0285) captions the pair list, not this + * graphic layout. */ import { formatLeftoverMapCoordinatePair } from "./leftoverMapCoordinates"; diff --git a/lineageweave/__init__.py b/lineageweave/__init__.py index 226794a62..85d384a6b 100644 --- a/lineageweave/__init__.py +++ b/lineageweave/__init__.py @@ -130,4 +130,4 @@ "serialize_lineage_analysis_result", ] -__version__ = "2.41.0" +__version__ = "2.42.0" diff --git a/pyproject.toml b/pyproject.toml index d3f001d61..e70306f1e 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "lineageweave" -version = "2.41.0" +version = "2.42.0" description = "Reconstructs git-branch-style lineage DAGs from scattered short records using multi-channel score fusion and LLM adjudication." readme = "README.md" license = { text = "MIT" } diff --git a/tests/test_adr_0285_governance.py b/tests/test_adr_0285_governance.py new file mode 100644 index 000000000..394c88e26 --- /dev/null +++ b/tests/test_adr_0285_governance.py @@ -0,0 +1,13 @@ +"""Governance regression for the draft ADR 0285 decision state.""" + +from pathlib import Path + + +ADR_PATH = Path(__file__).parents[1] / "docs/adr/0285-leftover-map-list-item-coverage.md" + + +def test_draft_adr_0285_remains_proposed() -> None: + """Keep the unmerged decision proposed until independent acceptance exists.""" + text = ADR_PATH.read_text(encoding="utf-8") + assert "**Decision status:** Proposed" in text + assert "**Decision status:** Accepted" not in text