Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 14 additions & 4 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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) 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) 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
Expand Down Expand Up @@ -513,8 +513,7 @@ 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 item coverage on the comparison graphic. ADR 0308 captions leftover-map
coverage, or the count of unused axes. ADR 0308 captions leftover-map
incomplete post coverage on that grouping comparison leftover-map graphic when leftoverMapIncompletePostCount
returns a usable dropped integer; a missing, negative, non-integer, or scored-minus-used
mismatch omits that leftover-map comparison graphic incomplete posts caption and keeps leftover-map
Expand All @@ -523,7 +522,15 @@ return usable complete-case integers. Do not invent leftover-map incomplete post
used, plotted 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 item coverage, leftover-map incomplete item coverage, or the count of unused
axes.
axes. ADR 0309 captions leftover-map incomplete item coverage on that grouping comparison leftover-map
graphic when leftoverMapIncompleteItemCount returns a usable dropped integer; a missing, negative,
non-integer, or scored-minus-used mismatch omits that leftover-map comparison graphic incomplete items
caption and keeps leftover-map comparison graphic coverage, leftover-map comparison graphic item
coverage, and leftover-map comparison graphic incomplete posts when those helpers return usable
integers. Do not invent leftover-map incomplete items from scored minus used, 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
item coverage, leftover-map incomplete post coverage, 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
Expand Down Expand Up @@ -583,6 +590,9 @@ complete-case integers.
Grouping comparison leftover-map incomplete post coverage (ADR 0308) captions
that grouping comparison leftover-map graphic with persisted leftover-map incomplete
post coverage when leftoverMapIncompletePostCount returns a usable dropped integer.
Grouping comparison leftover-map incomplete item coverage (ADR 0309) captions
that grouping comparison leftover-map graphic with persisted leftover-map incomplete
item coverage when leftoverMapIncompleteItemCount returns a usable dropped integer.
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)
Expand Down
12 changes: 8 additions & 4 deletions ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -712,8 +712,10 @@ comparison leftover-map graphic when leftoverMapItemCoverageCounts returns usabl
complete-case integers.
ADR 0308 captions leftover-map incomplete post coverage on that grouping
comparison leftover-map graphic when leftoverMapIncompletePostCount returns a usable
dropped integer and does not caption leftover-map incomplete item coverage
on that comparison plot.
dropped integer.
ADR 0309 captions leftover-map incomplete item coverage on that grouping
comparison leftover-map graphic when leftoverMapIncompleteItemCount returns a usable
dropped integer.
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
Expand Down Expand Up @@ -749,8 +751,10 @@ incomplete item coverage (ADR 0292), leftover-map reconstruction `R̂`
(ADR 0304), leftover-map axis share on the grouping comparison leftover-map
graphic (ADR 0305), leftover-map complete-case coverage on the grouping
comparison leftover-map graphic (ADR 0306), leftover-map item complete-case
coverage on the grouping comparison leftover-map graphic (ADR 0307), and leftover-map
incomplete post coverage on the grouping comparison leftover-map graphic (ADR 0308);
coverage on the grouping comparison leftover-map graphic (ADR 0307), leftover-map
incomplete post coverage on the grouping comparison leftover-map graphic (ADR 0308),
and leftover-map incomplete item coverage on the grouping comparison leftover-map
graphic (ADR 0309);
`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
Expand Down
27 changes: 27 additions & 0 deletions CHANGELOG.d/2.66.0-leftover-map-compare-plot-incomplete-item.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
## 2.66.0 — Leftover-map incomplete item coverage on grouping comparison leftover-map graphic

- Caption leftover-map incomplete item coverage on the grouping comparison
leftover-map graphic (ADR 0309). 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, and a plot caption that matches leftover-map incomplete item
coverage on the grouping comparison leftover-map graphic; click a post marker
or a pair button opens that post. A missing, negative, non-integer, or
scored-minus-used mismatch omits that leftover-map comparison graphic incomplete
items caption and keeps leftover-map comparison graphic coverage, leftover-map
comparison graphic item coverage, and leftover-map comparison graphic incomplete
posts when those helpers return usable integers. Dropped `0` is shown when that
persisted dropped count is a non-negative integer. Comparison copy uses
`Leftover map comparison graphic incomplete items` so it stays distinct from
hyphen `Leftover-map graphic incomplete items` and from strip
`Leftover map comparison incomplete items`. This increment does not caption
leftover-map reconstruction on the comparison graphic. Do not invent incomplete
items from scored minus used, 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 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.
37 changes: 35 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,40 @@ All notable changes to this project are documented here. Format follows

### Added

- Period leftover pairs now name leftover-map incomplete item coverage on the
grouping comparison leftover-map graphic (ADR 0309 / v2.66.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, and leftover map dropped N incomplete
criteria on that grouping comparison leftover-map graphic when
leftoverMapIncompleteItemCount returns a usable dropped integer; click a post
marker or a pair button opens that post. A missing, negative, non-integer, or
scored-minus-used mismatch omits that leftover-map comparison graphic
incomplete items caption and keeps leftover-map comparison graphic coverage,
leftover-map comparison graphic item coverage, and leftover-map comparison
graphic incomplete posts when those helpers return usable integers. Dropped
`0` is shown when that persisted dropped count is a non-negative integer.
Rank-0 origin cells still plot at `(0, 0)` and still name incomplete items
when that dropped count is persisted. Comparison copy uses `Leftover map
comparison graphic incomplete items` so it stays distinct from hyphen
`Leftover-map graphic incomplete items` and from strip `Leftover map
comparison incomplete items`. Incomplete item coverage omits independently of
post coverage, item coverage, and incomplete post coverage. This increment
does not caption leftover-map reconstruction on the comparison graphic. Do
not invent leftover-map incomplete items from scored minus used, 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 item coverage,
leftover-map incomplete post 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 incomplete post coverage on the
grouping comparison leftover-map graphic (ADR 0308 / v2.65.0). After
`make seed`, closest and farthest leftover pairs sit above the member list
Expand All @@ -27,8 +61,7 @@ All notable changes to this project are documented here. Format follows
Comparison copy uses `Leftover map comparison graphic incomplete posts` so it
stays distinct from hyphen `Leftover-map graphic incomplete posts` and from
strip `Leftover map comparison incomplete posts`. Incomplete post coverage omits
independently of post coverage and item coverage. This increment does not
caption leftover-map incomplete item coverage on the comparison graphic. Do
independently of post coverage and item coverage. Do
not invent leftover-map incomplete posts from scored minus used, plotted marker
count, leftover pair count, leftover-map rank, leftover-map distance,
leftover-map axis share, leftover expected, leftover observed, leftover residual,
Expand Down
2 changes: 1 addition & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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), 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), 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),
Expand Down
3 changes: 3 additions & 0 deletions docs/adr/0284-leftover-map-plot-incomplete-item.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@
**Decision status:** Accepted
**Date:** 2026-08-30

**Amended by:** [ADR 0309](0309-leftover-map-compare-plot-incomplete-item.md)
(leftover-map incomplete item 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
Expand Down
3 changes: 3 additions & 0 deletions docs/adr/0292-leftover-map-compare-incomplete-item.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@
**Decision status:** Accepted
**Date:** 2026-08-30

**Amended by:** [ADR 0309](0309-leftover-map-compare-plot-incomplete-item.md)
(leftover-map incomplete item 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)),
Expand Down
4 changes: 3 additions & 1 deletion docs/adr/0304-leftover-map-compare-graphic.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,9 @@
[ADR 0307](0307-leftover-map-compare-plot-item-coverage.md)
(leftover-map item complete-case coverage on the grouping comparison leftover-map graphic),
[ADR 0308](0308-leftover-map-compare-plot-incomplete-post.md)
(leftover-map incomplete post coverage on the grouping comparison leftover-map graphic)
(leftover-map incomplete post coverage on the grouping comparison leftover-map graphic),
[ADR 0309](0309-leftover-map-compare-plot-incomplete-item.md)
(leftover-map incomplete item 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
Expand Down
4 changes: 3 additions & 1 deletion docs/adr/0307-leftover-map-compare-plot-item-coverage.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,9 @@
**Date:** 2026-08-31

**Amended by:** [ADR 0308](0308-leftover-map-compare-plot-incomplete-post.md)
(leftover-map incomplete post coverage on the grouping comparison leftover-map graphic)
(leftover-map incomplete post coverage on the grouping comparison leftover-map graphic),
[ADR 0309](0309-leftover-map-compare-plot-incomplete-item.md)
(leftover-map incomplete item coverage on the grouping comparison leftover-map graphic)

Amends leftover-map item complete-case coverage on the graphic display
([ADR 0282](0282-leftover-map-plot-item-coverage.md)), leftover-map item
Expand Down
3 changes: 3 additions & 0 deletions docs/adr/0308-leftover-map-compare-plot-incomplete-post.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@
**Decision status:** Accepted
**Date:** 2026-08-31

**Amended by:** [ADR 0309](0309-leftover-map-compare-plot-incomplete-item.md)
(leftover-map incomplete item coverage on the grouping comparison leftover-map graphic)

Amends leftover-map incomplete post coverage on the graphic display
([ADR 0283](0283-leftover-map-plot-incomplete.md)), leftover-map incomplete
post coverage on the grouping comparison strip
Expand Down
Loading
Loading