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: 12 additions & 1 deletion 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 / 0309 / 0310 / 0311 / 0312 / 0313 / 0314 / 0315 / 0316 / 0317 / 0318 / 0319 / 0320 / 0321 / 0322 / 0323 / 0324 / 0325) 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 / 0310 / 0311 / 0312 / 0313 / 0314 / 0315 / 0316 / 0317 / 0318 / 0319 / 0320 / 0321 / 0322 / 0323 / 0324 / 0325 / 0326) 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 @@ -668,6 +668,14 @@ returns a usable leftover-axis caption. Distinct accessible name
Rank-0 unused axes still name leftover-axis `σ 0.00`. Do not invent leftover-map
singular values from leftover-map axis share. Do not invent leftover-map axis
share from leftover-map singular values.
ADR 0326 captions leftover-map comparison graphic leftover-map axes with persisted leftover-map
singular values `σ_k` when leftoverMapComparePlotAxisBadge returns a usable leftover-map
axis caption. Distinct accessible name
`leftover map comparison graphic leftover-map axis {axis} σ {value}`. Share and
singular value omit independently. Rank-0 unused axes still name leftover-map
comparison graphic leftover-map axis `σ 0.00`. Do not invent leftover-map
singular values from leftover-map axis share. Do not invent leftover-map axis
share from leftover-map singular values.
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 @@ -778,6 +786,9 @@ returns a usable leftover-map axis caption.
Leftover-axis report badge leftover-map singular values independently of leftover-map axis share
(ADR 0325) captions leftover-axis report badges with persisted leftover-map singular values
`σ_k` when leftoverMapAxisBadge returns a usable leftover-axis caption.
Leftover-map comparison graphic leftover-map axis leftover-map singular values as leftoverMapComparePlotAxisBadge
(ADR 0326) captions leftover-map comparison graphic leftover-map axes with persisted leftover-map
singular values `σ_k` when leftoverMapComparePlotAxisBadge returns a usable leftover-map axis caption.
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
7 changes: 6 additions & 1 deletion ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -758,6 +758,9 @@ ADR 0324 captions leftover-map graphic-display axes with persisted leftover-map
singular values `σ_k`.
ADR 0325 captions leftover-axis report badges with persisted leftover-map
singular values `σ_k` independently of leftover-map axis share.
ADR 0326 captions leftover-map comparison graphic leftover-map axes with persisted leftover-map
singular values `σ_k` when leftoverMapComparePlotAxisBadge returns a usable leftover-map
axis caption.
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 @@ -812,7 +815,9 @@ graphic (ADR 0321), leftover-map singular values on leftover-axis report badges
(ADR 0322), leftover-map singular values on leftover-axis report badges on the
grouping comparison strip (ADR 0323), leftover-map singular values on leftover-map
graphic-display axes (ADR 0324), leftover-map singular values on leftover-axis
report badges independently of leftover-map axis share (ADR 0325);
report badges independently of leftover-map axis share (ADR 0325), leftover-map
comparison graphic leftover-map axis leftover-map singular values as leftoverMapComparePlotAxisBadge
(ADR 0326);
`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
24 changes: 24 additions & 0 deletions CHANGELOG.d/2.83.0-leftover-map-compare-plot-axis-badge.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
## 2.83.0 — Leftover-map comparison graphic leftover-map axis leftover-map singular values as leftoverMapComparePlotAxisBadge

- Caption leftover-map comparison graphic leftover-map axes with persisted
leftover-map singular values `σ_k` through leftoverMapComparePlotAxisBadge
(ADR 0326). After `make seed`, grouping comparison leftover-map graphic
leftover-map axes name persisted leftover-map singular values when
leftoverMapComparePlotAxisBadge returns a usable leftover-map axis caption
even when leftover-map axis share is omitted; click a leftover pair opens
that post. A missing or non-finite leftover-map axis share omits that share
caption and keeps `leftover map comparison graphic leftover-map axis {k} σ {value}`.
A missing, non-finite, or negative singular value omits that `σ` badge and
keeps `leftover map comparison axis {k} ({share}%)`. Rank-0 unused axes still
name `σ 0.00`. Leftover-map comparison graphic leftover-map axes stay
`leftover map comparison graphic leftover-map axis {k} σ {value}` when share
is omitted so they stay distinct from leftover-axis
`leftover axis {k} σ {value}`, from hyphen `leftover-map axis {k} σ {value}`,
and from comparison leftover-axis
`leftover map comparison leftover axis {k} σ {value}`. Do not invent `σ_k`
from leftover-map axis share. Do not invent leftover-map axis share from
`σ_k`. This increment does not change leftover-map singular values on leftover-map
graphic-display axes, leftover-axis report badges, or leftover-axis report
badges on the grouping comparison strip. A finite negative leftover is shown,
never clamped. Never invent a leftover score. Never invent a theta. No new
columns.
23 changes: 23 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,29 @@ All notable changes to this project are documented here. Format follows

### Added

- Period leftover pairs now caption leftover-map comparison graphic leftover-map
axes with persisted leftover-map singular values `σ_k` through
leftoverMapComparePlotAxisBadge (ADR 0326 / v2.83.0). After `make seed`,
grouping comparison leftover-map graphic leftover-map axes name persisted
leftover-map singular values when leftoverMapComparePlotAxisBadge returns a
usable leftover-map axis caption even when leftover-map axis share is omitted;
click a leftover pair opens that post. A missing or non-finite leftover-map
axis share omits that share caption and keeps
`leftover map comparison graphic leftover-map axis {k} σ {value}`. A missing,
non-finite, or negative singular value omits that `σ` badge and keeps
`leftover map comparison axis {k} ({share}%)`. Rank-0 unused axes still name
`σ 0.00`. Leftover-map comparison graphic leftover-map axes stay
`leftover map comparison graphic leftover-map axis {k} σ {value}` when share
is omitted so they stay distinct from leftover-axis
`leftover axis {k} σ {value}`, from hyphen `leftover-map axis {k} σ {value}`,
and from comparison leftover-axis
`leftover map comparison leftover axis {k} σ {value}`. Do not invent `σ_k`
from leftover-map axis share. Do not invent leftover-map axis share from
`σ_k`. This increment does not change leftover-map singular values on leftover-map
graphic-display axes, leftover-axis report badges, or leftover-axis report
badges on the grouping comparison strip. A finite negative leftover is shown,
never clamped. Never invent a leftover score or a theta. No new columns.

- Period leftover pairs now caption leftover-axis report badges with persisted
leftover-map singular values `σ_k` independently of leftover-map axis share
(ADR 0325 / v2.82.0). After `make seed`, leftover-axis report badges name
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 / 0309 / 0310 / 0311 / 0312 / 0313 / 0314 / 0315 / 0316 / 0317 / 0318 / 0319 / 0320 / 0321 / 0322 / 0323 / 0324 / 0325), 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 / 0310 / 0311 / 0312 / 0313 / 0314 / 0315 / 0316 / 0317 / 0318 / 0319 / 0320 / 0321 / 0322 / 0323 / 0324 / 0325 / 0326), 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
4 changes: 3 additions & 1 deletion docs/adr/0148-leftover-map-axis-share.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,9 @@
[ADR 0324](0324-leftover-map-plot-axis-singular.md)
(leftover-map singular values on leftover-map graphic-display axes);
[ADR 0325](0325-leftover-map-axis-singular-only.md)
(leftover-map singular values on leftover-axis report badges independently of leftover-map axis share)
(leftover-map singular values on leftover-axis report badges independently of leftover-map axis share);
[ADR 0326](0326-leftover-map-compare-plot-axis-badge.md)
(leftover-map comparison graphic leftover-map axis leftover-map singular values as leftoverMapComparePlotAxisBadge)

## Context

Expand Down
4 changes: 3 additions & 1 deletion docs/adr/0321-leftover-map-compare-plot-singular.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,7 +100,9 @@ leftover-map axis share is `σ_k² / Σ_j σ_j²`.
## Related

Independent of leftover-map singular values on leftover-axis report badges
([ADR 0322](0322-leftover-map-axis-singular.md)).
([ADR 0322](0322-leftover-map-axis-singular.md)). Independent of leftover-map
comparison graphic leftover-map axis leftover-map singular values as leftoverMapComparePlotAxisBadge
([ADR 0326](0326-leftover-map-compare-plot-axis-badge.md)).

## References

Expand Down
4 changes: 3 additions & 1 deletion docs/adr/0322-leftover-map-axis-singular.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,9 @@ not caption leftover-map singular values on leftover-map graphic-display axes
([ADR 0324](0324-leftover-map-plot-axis-singular.md)). This increment does not
caption leftover-map singular values on leftover-axis report badges independently
of leftover-map axis share
([ADR 0325](0325-leftover-map-axis-singular-only.md)).
([ADR 0325](0325-leftover-map-axis-singular-only.md)). This increment does not
caption leftover-map comparison graphic leftover-map axes through leftoverMapComparePlotAxisBadge
([ADR 0326](0326-leftover-map-compare-plot-axis-badge.md)).

## References

Expand Down
4 changes: 3 additions & 1 deletion docs/adr/0323-leftover-map-compare-axis-singular.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,9 @@ Independent of leftover-map singular values on leftover-map graphic-display
axes ([ADR 0324](0324-leftover-map-plot-axis-singular.md)).
Independent of leftover-map singular values on leftover-axis report badges
independently of leftover-map axis share
([ADR 0325](0325-leftover-map-axis-singular-only.md)).
([ADR 0325](0325-leftover-map-axis-singular-only.md)). Independent of leftover-map
comparison graphic leftover-map axis leftover-map singular values as leftoverMapComparePlotAxisBadge
([ADR 0326](0326-leftover-map-compare-plot-axis-badge.md)).

## References

Expand Down
4 changes: 3 additions & 1 deletion docs/adr/0324-leftover-map-plot-axis-singular.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,7 +115,9 @@ strip ([ADR 0323](0323-leftover-map-compare-axis-singular.md)). Independent of
leftover-map singular values on the grouping comparison leftover-map graphic
([ADR 0321](0321-leftover-map-compare-plot-singular.md)). Independent of leftover-map
singular values on leftover-axis report badges independently of leftover-map axis
share ([ADR 0325](0325-leftover-map-axis-singular-only.md)).
share ([ADR 0325](0325-leftover-map-axis-singular-only.md)). Independent of leftover-map
comparison graphic leftover-map axis leftover-map singular values as leftoverMapComparePlotAxisBadge
([ADR 0326](0326-leftover-map-compare-plot-axis-badge.md)).

## References

Expand Down
4 changes: 3 additions & 1 deletion docs/adr/0325-leftover-map-axis-singular-only.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,9 @@ leftover-map singular values on leftover-axis report badges on the grouping
comparison strip ([ADR 0323](0323-leftover-map-compare-axis-singular.md)).
Independent of leftover-map singular values on leftover-axis report badges
that still require leftover-map axis share in the combined caption
([ADR 0322](0322-leftover-map-axis-singular.md)).
([ADR 0322](0322-leftover-map-axis-singular.md)). Independent of leftover-map
comparison graphic leftover-map axis leftover-map singular values as leftoverMapComparePlotAxisBadge
([ADR 0326](0326-leftover-map-compare-plot-axis-badge.md)).

## References

Expand Down
Loading