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
13 changes: 11 additions & 2 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) 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) 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 @@ -481,7 +481,13 @@ ADR 0303 returns persisted leftover-map coordinates `ξ` / `ζ` on
compares leftover pairs can match the pair-row coordinate badge on live
responses; a missing axis stays null and does not invent coordinates from
leftover-map rank, leftover-map distance, leftover-map reconstruction, or
leftover residual. The strip does not gain the leftover-map graphic.
leftover residual. ADR 0304 draws the leftover-map graphic display of those
already-named `ξ` / `ζ` coordinates above grouping comparison leftover-pair
buttons when four leftover-map axes are finite; a missing or non-finite axis
omits that pair from the comparison graphic and does not invent coordinates
from leftover-map rank, leftover-map distance, leftover-map reconstruction, or
leftover residual. Omit the comparison graphic when no leftover pair has four
finite leftover-map coordinates.
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 @@ -526,6 +532,9 @@ Grouping comparison leftover-map coordinates (ADR 0302) captions grouping compar
buttons with persisted leftover-map coordinates `ξ` / `ζ`.
Grouping comparison leftover-map coordinates payload (ADR 0303) returns persisted leftover-map
coordinates `ξ` / `ζ` on `GET /api/reports/compare/{period}` leftover pairs.
Grouping comparison leftover-map graphic display (ADR 0304) draws the leftover-map
graphic of those already-named coordinates above grouping comparison leftover-pair
buttons when four leftover-map axes are finite.
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
8 changes: 6 additions & 2 deletions ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -697,6 +697,9 @@ ADR 0302 captions grouping comparison leftover-pair buttons with persisted lefto
coordinates `ξ` / `ζ` through formatLeftoverMapCoordinates.
ADR 0303 returns persisted leftover-map coordinates `ξ` / `ζ` on
`GET /api/reports/compare/{period}` leftover pairs.
ADR 0304 draws the leftover-map graphic display of those already-named
coordinates above grouping comparison leftover-pair buttons when four
leftover-map axes are finite.
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 @@ -727,8 +730,9 @@ incomplete item coverage (ADR 0292), leftover-map reconstruction `R̂`
(ADR 0299), leftover expected `E`
(ADR 0300), leftover-map rank
(ADR 0301), leftover-map coordinates `ξ` / `ζ`
(ADR 0302), and leftover-map coordinates on the compare leftover-pair payload
(ADR 0303);
(ADR 0302), leftover-map coordinates on the compare leftover-pair payload
(ADR 0303), and leftover-map graphic display on the grouping comparison strip
(ADR 0304);
`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
15 changes: 15 additions & 0 deletions CHANGELOG.d/2.61.0-leftover-map-compare-graphic.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
## 2.61.0 — Leftover-map graphic display on grouping comparison strip

- Draw the leftover-map graphic display of persisted `ξ` / `ζ` above
grouping comparison leftover-pair buttons (ADR 0304). After `make seed`,
closest and farthest leftover pairs sit above the member list with the
Gabriel biplot of already-named coordinates on the grouping comparison
strip when four leftover-map axes are finite; click a post marker or a
pair button opens that post. Omit the plot when no leftover pair has four
finite leftover-map coordinates. Rank-0 origin cells still plot at
`(0, 0)` when those persisted coordinates are stored. Do not invent
coordinates from leftover-map rank, leftover-map distance, or leftover-map
reconstruction. A finite negative leftover is shown, never clamped. This
increment does not caption leftover-map axis share or leftover-map coverage
on the comparison graphic. Never invent a leftover score. Never invent a
theta. No new columns.
62 changes: 62 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,68 @@ All notable changes to this project are documented here. Format follows

### Added

- Period leftover pairs now draw the leftover-map graphic display of
persisted leftover-map coordinates `ξ` / `ζ` above grouping comparison
leftover-pair buttons (ADR 0304 / v2.61.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, 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,
and the grouping comparison leftover-map graphic of those already-named
coordinates when four leftover-map axes are finite; click a post marker or
a pair button opens that post. A missing axis stays null and omits that
leftover-map comparison coordinates badge and keeps 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. Rank-0 origin cells still plot at `(0, 0)` when those
persisted coordinates are stored. Do not invent coordinates from leftover-map
rank, leftover-map distance, 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, 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. This increment does not caption leftover-map axis share or
leftover-map coverage on the comparison graphic. Never invent a leftover
score or a theta. No new columns.

- Period leftover pairs now return persisted leftover-map coordinates
`ξ` / `ζ` on `GET /api/reports/compare/{period}` leftover pairs
(ADR 0303 / v2.60.0). After `make seed`, closest and farthest leftover
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), 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), 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
8 changes: 5 additions & 3 deletions docs/adr/0268-leftover-map-graphic-display.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,9 @@
[ADR 0279](0279-leftover-map-segment-expected.md)
(leftover expected E on pair segments);
[ADR 0280](0280-leftover-map-segment-rank.md)
(leftover-map rank on pair segments)
(leftover-map rank on pair segments);
[ADR 0304](0304-leftover-map-compare-graphic.md)
(leftover-map graphic display on the grouping comparison strip)

Amends [ADR 0049](0049-leftover-pair-report-ui.md) and
[ADR 0267](0267-leftover-map-coordinates.md). Independent of leftover-map
Expand Down Expand Up @@ -87,8 +89,8 @@ that pair from the plot rather than inventing a location. When no
pair has four finite coordinates, omit the plot and keep the existing
pair-list next action. Duplicate posts share one person marker;
duplicate criteria share one item marker. The grouping comparison
strip (ADR 0149) stays on its reduced leftover payload and does not
gain this plot.
strip (ADR 0149) later gains this plot from already-named leftover-map
coordinates (ADR 0304).

Do not add SQL. Do not edit shipped migrations. Do not persist inner
product, cosine, or length as separate columns.
Expand Down
Loading
Loading