diff --git a/AGENTS.md b/AGENTS.md index d3d2c7e3e..9f1f28318 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -803,6 +803,17 @@ item coordinates `(0.00, 0.00)`. Do not invent leftover-map item coordinates fro post leftover-map person coordinates stay `leftover pair leftover-map post {title} at ξ {person}` this increment. Leftover-map graphic leftover-map criterion markers stay `leftover-map criterion {label} at ζ {item}` this increment. Leftover-map comparison graphic leftover-map criterion markers stay `leftover map comparison graphic leftover-map criterion {label} at ζ {item}` this increment. +ADR 0341 captions leftover-map comparison leftover-pair leftover-map post with persisted leftover-map +person coordinates when leftoverMapCompareListPostBadge returns a usable leftover-map comparison leftover-pair leftover-map post leftover-map +person coordinate caption. Distinct accessible name +`leftover map comparison leftover pair leftover-map post {title} at ξ {person}`. +A missing or non-finite leftover-map person coordinate pair omits that leftover-map comparison leftover-pair leftover-map post leftover-map +person coordinate caption and keeps `Open leftover {kind} pair from comparison: {title} · {criterion}`. Rank-0 unused axes still name leftover-map +person coordinates `(0.00, 0.00)`. Do not invent leftover-map person coordinates from leftover-map item coordinates +`ζ`. Do not invent leftover-map item coordinates `ζ` from leftover-map person coordinates `ξ`. Leftover-map pair leftover-map +post leftover-map person coordinates stay `leftover pair leftover-map post {title} at ξ {person}` this increment. Leftover-map graphic leftover-map +post markers stay `Open leftover-map post {title} at ξ {person}` this increment. Leftover-map comparison graphic leftover-map +post markers stay `Open leftover map comparison graphic leftover-map post {title} at ξ {person}` this increment. 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 @@ -968,6 +979,10 @@ Leftover-map pair leftover-map criterion leftover-map item coordinates independe (ADR 0340) captions leftover-map pair leftover-map criterion with persisted leftover-map item coordinates when leftoverMapListCriterionBadge returns a usable leftover-map pair leftover-map criterion leftover-map item coordinate caption. +Leftover-map comparison leftover-pair leftover-map post leftover-map person coordinates independently of leftover-map comparison leftover-pair leftover-map criterion leftover-map item coordinates +(ADR 0341) captions leftover-map comparison leftover-pair leftover-map post with persisted leftover-map +person coordinates when leftoverMapCompareListPostBadge returns a usable leftover-map comparison leftover-pair leftover-map post leftover-map +person coordinate 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) diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 946cee918..85fbab8b1 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -803,6 +803,9 @@ person coordinate caption independently of leftover-map pair leftover-map criter ADR 0340 captions leftover-map pair leftover-map criterion with persisted leftover-map item coordinates when leftoverMapListCriterionBadge returns a usable leftover-map pair leftover-map criterion leftover-map item coordinate caption independently of leftover-map pair leftover-map post leftover-map person coordinates. +ADR 0341 captions leftover-map comparison leftover-pair leftover-map post with persisted leftover-map +person coordinates when leftoverMapCompareListPostBadge returns a usable leftover-map comparison leftover-pair leftover-map post leftover-map +person coordinate caption independently of leftover-map comparison leftover-pair leftover-map criterion leftover-map item coordinates. 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 diff --git a/CHANGELOG.d/2.98.0-leftover-map-compare-list-post-coordinates.md b/CHANGELOG.d/2.98.0-leftover-map-compare-list-post-coordinates.md new file mode 100644 index 000000000..99fa5da33 --- /dev/null +++ b/CHANGELOG.d/2.98.0-leftover-map-compare-list-post-coordinates.md @@ -0,0 +1,26 @@ +## 2.98.0 — Leftover-map person coordinates on leftover-map comparison leftover pair leftover-map post independently of leftover-map comparison leftover pair leftover-map criterion leftover-map item coordinates + +- Caption leftover-map comparison leftover-pair leftover-map post with persisted leftover-map + person coordinates through leftoverMapCompareListPostBadge independently of leftover-map + comparison leftover-pair leftover-map criterion leftover-map item coordinates (ADR 0341). After `make seed`, leftover-map comparison leftover-pair leftover-map + post name persisted leftover-map person coordinates when leftoverMapCompareListPostBadge + returns a usable leftover-map comparison leftover-pair leftover-map post leftover-map person coordinate caption; click a leftover pair + or a leftover-map post marker opens that post. A missing or + non-finite leftover-map person coordinate pair omits that leftover-map comparison leftover-pair leftover-map post leftover-map + person coordinate caption and keeps + `Open leftover {kind} pair from comparison: {title} · {criterion}`. + Rank-0 unused + axes still name leftover-map person coordinates `(0.00, 0.00)`. Leftover-map comparison leftover-pair leftover-map + post stay + `leftover map comparison leftover pair leftover-map post {title} at ξ {person}` + when leftover-map person coordinates are finite so they stay distinct from leftover-map pair leftover-map post leftover-map person coordinates + `leftover pair leftover-map post {title} at ξ {person}`, leftover-map graphic leftover-map post markers + `Open leftover-map post {title} at ξ {person}`, and leftover-map comparison graphic leftover-map post markers + `Open leftover map comparison graphic leftover-map post {title} at ξ {person}`. Do not invent leftover-map + person coordinates from leftover-map item coordinates `ζ`. Do not invent leftover-map item coordinates `ζ` from leftover-map + person coordinates `ξ`. This increment does not change leftover-map pair leftover-map + post leftover-map person coordinates, leftover-map pair leftover-map criterion leftover-map item coordinates, leftover-map graphic leftover-map + post markers, leftover-map comparison graphic leftover-map post markers, leftover-map graphic leftover-map criterion markers, leftover-map comparison graphic leftover-map criterion markers, leftover-axis ticks, leftover-map graphic leftover-map axis ticks, + leftover-map comparison leftover-axis ticks, or leftover-map comparison graphic leftover-map axis ticks. + A finite negative leftover is shown, never clamped. Never invent a leftover score. + Never invent a theta. No new columns. diff --git a/CHANGELOG.md b/CHANGELOG.md index 08b791b84..aa27921d7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,29 @@ All notable changes to this project are documented here. Format follows ### Added +- Period leftover pairs now caption leftover-map comparison leftover-pair leftover-map + post with persisted leftover-map person coordinates through leftoverMapCompareListPostBadge + independently of leftover-map comparison leftover-pair leftover-map criterion leftover-map item coordinates (ADR 0341 / v2.98.0). After `make seed`, + leftover-map comparison leftover-pair leftover-map post name persisted leftover-map + person coordinates when leftoverMapCompareListPostBadge returns a usable leftover-map comparison leftover-pair leftover-map post + leftover-map person coordinate caption; click a leftover pair or a leftover-map post marker + opens that post. A missing or non-finite leftover-map person coordinate pair omits that leftover-map + comparison leftover-pair leftover-map post leftover-map person coordinate caption and keeps + `Open leftover {kind} pair from comparison: {title} · {criterion}`. + Rank-0 unused axes still name leftover-map person coordinates `(0.00, 0.00)`. Leftover-map comparison leftover-pair leftover-map + post stay + `leftover map comparison leftover pair leftover-map post {title} at ξ {person}` + when leftover-map person coordinates are finite so they stay distinct from leftover-map pair leftover-map post leftover-map person coordinates + `leftover pair leftover-map post {title} at ξ {person}`, leftover-map graphic leftover-map post markers + `Open leftover-map post {title} at ξ {person}`, and leftover-map comparison graphic leftover-map post markers + `Open leftover map comparison graphic leftover-map post {title} at ξ {person}`. Do not invent leftover-map + person coordinates from leftover-map item coordinates `ζ`. Do not invent leftover-map item coordinates `ζ` from leftover-map + person coordinates `ξ`. This increment does not change leftover-map pair leftover-map + post leftover-map person coordinates, leftover-map pair leftover-map criterion leftover-map item coordinates, leftover-map graphic leftover-map + post markers, leftover-map comparison graphic leftover-map post markers, leftover-map graphic leftover-map criterion markers, leftover-map comparison graphic leftover-map criterion markers, leftover-axis ticks, leftover-map graphic leftover-map axis ticks, + leftover-map comparison leftover-axis ticks, or leftover-map comparison graphic leftover-map axis ticks. 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-map pair leftover-map criterion with persisted leftover-map item coordinates through leftoverMapListCriterionBadge independently of leftover-map pair leftover-map post leftover-map person coordinates (ADR 0340 / v2.97.0). After `make seed`, diff --git a/CLAUDE.md b/CLAUDE.md index e01c0d2eb..12333cbd0 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 / 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 / 0327 / 0328 / 0329 / 0330 / 0331 / 0332 / 0333 / 0334 / 0335 / 0336 / 0337 / 0338 / 0339 / 0340), 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 / 0327 / 0328 / 0329 / 0330 / 0331 / 0332 / 0333 / 0334 / 0335 / 0336 / 0337 / 0338 / 0339 / 0340 / 0341), 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/0267-leftover-map-coordinates.md b/docs/adr/0267-leftover-map-coordinates.md index e316c2dfb..c831be7e8 100644 --- a/docs/adr/0267-leftover-map-coordinates.md +++ b/docs/adr/0267-leftover-map-coordinates.md @@ -18,7 +18,9 @@ [ADR 0339](0339-leftover-map-list-post-coordinates.md) (leftover-map person coordinates on leftover-map pair leftover-map post independently of leftover-map pair leftover-map criterion leftover-map item coordinates); [ADR 0340](0340-leftover-map-list-criterion-coordinates.md) -(leftover-map item coordinates on leftover-map pair leftover-map criterion independently of leftover-map pair leftover-map post leftover-map person coordinates) +(leftover-map item coordinates on leftover-map pair leftover-map criterion independently of leftover-map pair leftover-map post leftover-map person coordinates); +[ADR 0341](0341-leftover-map-compare-list-post-coordinates.md) +(leftover-map person coordinates on leftover-map comparison leftover pair leftover-map post independently of leftover-map comparison leftover pair leftover-map criterion leftover-map item coordinates) Amends [ADR 0048](0048-persist-lsirm-leftover-pairs.md), [ADR 0049](0049-leftover-pair-report-ui.md), and diff --git a/docs/adr/0302-leftover-map-compare-coordinates.md b/docs/adr/0302-leftover-map-compare-coordinates.md index 2fb578f41..f491691b6 100644 --- a/docs/adr/0302-leftover-map-compare-coordinates.md +++ b/docs/adr/0302-leftover-map-compare-coordinates.md @@ -3,6 +3,9 @@ **Decision status:** Accepted **Date:** 2026-08-31 +**Amended by:** [ADR 0341](0341-leftover-map-compare-list-post-coordinates.md) +(leftover-map person coordinates on leftover-map comparison leftover pair leftover-map post independently of leftover-map comparison leftover pair leftover-map criterion leftover-map item coordinates) + Amends leftover pairs on the grouping comparison strip ([ADR 0149](0149-leftover-pairs-on-comparison-strip.md)), leftover-map coordinates ([ADR 0267](0267-leftover-map-coordinates.md)), leftover-map diff --git a/docs/adr/0340-leftover-map-list-criterion-coordinates.md b/docs/adr/0340-leftover-map-list-criterion-coordinates.md index aec9907e4..5611e668e 100644 --- a/docs/adr/0340-leftover-map-list-criterion-coordinates.md +++ b/docs/adr/0340-leftover-map-list-criterion-coordinates.md @@ -3,6 +3,9 @@ **Decision status:** Accepted **Date:** 2026-08-31 +**Amended by:** [ADR 0341](0341-leftover-map-compare-list-post-coordinates.md) +(leftover-map person coordinates on leftover-map comparison leftover pair leftover-map post independently of leftover-map comparison leftover pair leftover-map criterion leftover-map item coordinates) + Amends leftover-map coordinates ([ADR 0267](0267-leftover-map-coordinates.md)). Independent of leftover-map pair leftover-map post leftover-map person coordinates independently of leftover-map pair leftover-map criterion leftover-map item coordinates diff --git a/docs/adr/0341-leftover-map-compare-list-post-coordinates.md b/docs/adr/0341-leftover-map-compare-list-post-coordinates.md new file mode 100644 index 000000000..1045a2986 --- /dev/null +++ b/docs/adr/0341-leftover-map-compare-list-post-coordinates.md @@ -0,0 +1,153 @@ +# ADR 0341 — Name leftover-map person coordinates on leftover-map comparison leftover pair leftover-map post independently of leftover-map comparison leftover pair leftover-map criterion leftover-map item coordinates + +**Decision status:** Accepted +**Date:** 2026-08-31 + +Amends leftover-map coordinates +([ADR 0267](0267-leftover-map-coordinates.md)) and leftover-map coordinates on grouping comparison strip pair rows +([ADR 0302](0302-leftover-map-compare-coordinates.md)). Independent of leftover-map +item coordinates on leftover-map pair leftover-map criterion independently of leftover-map pair leftover-map post leftover-map person coordinates +([ADR 0340](0340-leftover-map-list-criterion-coordinates.md)). Independent of leftover-map +pair leftover-map post leftover-map person coordinates independently of leftover-map pair leftover-map criterion leftover-map item coordinates +([ADR 0339](0339-leftover-map-list-post-coordinates.md)). Independent of leftover-map +graphic leftover-map post leftover-map person coordinates independently of leftover-map comparison graphic leftover-map post markers +([ADR 0338](0338-leftover-map-plot-post-coordinates.md)). Independent of leftover-map +comparison graphic leftover-map post leftover-map person coordinates independently of leftover-map criterion leftover-map item coordinates +([ADR 0337](0337-leftover-map-compare-plot-post-coordinates.md)). Independent of leftover-map +comparison graphic leftover-map criterion leftover-map item coordinates independently of leftover-map post ξ markers +([ADR 0336](0336-leftover-map-compare-plot-criterion-coordinates.md)). Independent of leftover-map +graphic leftover-map criterion leftover-map item coordinates independently of leftover-map post ξ markers +([ADR 0335](0335-leftover-map-plot-criterion-coordinates.md)). Independent of leftover-map +graphic display ([ADR 0268](0268-leftover-map-graphic-display.md)). Independent of leftover-map +comparison graphic ([ADR 0304](0304-leftover-map-compare-graphic.md)). + +## Context + +ADR 0267 already persists two-axis Gabriel person coordinates +`ξ_{1:2}` and item coordinates `ζ_{1:2}` on leftover pair rows so +`R̂ = ξ_{1:2} · ζ_{1:2}` and `d = ‖ξ_{1:2} − ζ_{1:2}‖` stay +auditable. ADR 0302 already names leftover-map coordinates on grouping +comparison leftover-pair buttons through `formatLeftoverMapCoordinates`, +which requires both leftover-map person coordinates `ξ` and leftover-map +item coordinates `ζ`. ADR 0339 already names leftover-map pair leftover-map +post leftover-map person coordinates +`leftover pair leftover-map post {title} at ξ {person}` +independently of leftover-map pair leftover-map criterion leftover-map +item coordinates. Grouping comparison leftover-pair leftover-map post leftover-map +person coordinates still interpolate leftover-map person coordinates only through +`formatLeftoverMapCoordinates`. A missing or non-finite leftover-map comparison leftover-pair leftover-map criterion leftover-map +item coordinate pair hides leftover-map comparison leftover-pair leftover-map post leftover-map +person coordinates. Rank-0 unused axes still persist leftover-map +person coordinates `(0.00, 0.00)`. A finite negative leftover is shown, never +clamped. Do not invent leftover-map person coordinates from leftover-map item +coordinates `ζ`. Do not invent leftover-map item coordinates `ζ` from leftover-map +person coordinates `ξ`. Leftover-map pair leftover-map post leftover-map person coordinates stay +`leftover pair leftover-map post {title} at ξ {person}` +this increment. Leftover-map graphic leftover-map post markers stay +`Open leftover-map post {title} at ξ {person}` +this increment. Leftover-map comparison graphic leftover-map post markers stay +`Open leftover map comparison graphic leftover-map post {title} at ξ {person}` +this increment. + +This increment names leftover-map comparison leftover-pair leftover-map post leftover-map +person coordinates as leftoverMapCompareListPostBadge, matching leftover-map +pair leftover-map post leftover-map person coordinates independently of leftover-map +comparison leftover-pair leftover-map criterion leftover-map item coordinates. Leftover-map comparison leftover-pair leftover-map +post leftover-map person coordinates stay +`leftover map comparison leftover pair leftover-map post {title} at ξ {person}` +when leftover-map person coordinates are finite, so they stay distinct from leftover-map +pair leftover-map post leftover-map person coordinates +`leftover pair leftover-map post {title} at ξ {person}`, +leftover-map graphic leftover-map post markers +`Open leftover-map post {title} at ξ {person}`, +and leftover-map comparison graphic leftover-map post markers +`Open leftover map comparison graphic leftover-map post {title} at ξ {person}`. +It does not add columns. Do not invent a leftover score. Do not invent a theta. + +This protected increment uses **0341** so it does not collide with leftover-map +item coordinates on leftover-map pair leftover-map criterion independently of leftover-map pair leftover-map post leftover-map person coordinates +(0340), leftover-map pair leftover-map post leftover-map person coordinates independently of leftover-map pair leftover-map criterion leftover-map item coordinates +(0339), leftover-map graphic leftover-map post leftover-map person coordinates independently of leftover-map comparison graphic leftover-map post markers +(0338), leftover-map comparison graphic leftover-map post leftover-map person coordinates independently of leftover-map criterion leftover-map item coordinates +(0337), leftover-map comparison graphic leftover-map criterion leftover-map item coordinates independently of leftover-map post ξ markers +(0336), leftover-map graphic leftover-map criterion leftover-map item coordinates independently of leftover-map post ξ markers +(0335), leftover-map graphic display (0268), leftover-map coordinates (0267), leftover-map coordinates on grouping comparison strip pair rows +(0302), or the dashboard stacks. + +## Decision + +On leftover-map comparison leftover-pair leftover-map post, caption leftover-map +person coordinates `ξ_{1:2}` when leftoverMapCompareListPostBadge +returns a usable leftover-map comparison leftover-pair leftover-map post leftover-map person coordinate caption. +A missing or non-finite leftover-map person coordinate pair omits that leftover-map +comparison leftover-pair leftover-map post leftover-map person coordinate caption and keeps +`Open leftover {kind} pair from comparison: {title} · {criterion}`. Rank-0 unused axes still name leftover-map +person coordinates `(0.00, 0.00)`. Click a leftover pair or a leftover-map +post marker to open that post. Criterion markers are not post buttons. + +Leftover-map comparison leftover-pair leftover-map post leftover-map person coordinates omit +independently of leftover-map comparison leftover-pair leftover-map criterion leftover-map item +coordinates. This increment does not change leftover-map pair leftover-map +post leftover-map person coordinates, leftover-map pair leftover-map criterion leftover-map item coordinates, leftover-map graphic leftover-map +post markers, leftover-map comparison graphic leftover-map +post markers, leftover-map graphic leftover-map criterion markers, +leftover-map comparison graphic leftover-map criterion markers, +leftover-axis ticks, leftover-map graphic leftover-map axis ticks, leftover-map +comparison leftover-axis ticks, or leftover-map comparison graphic leftover-map +axis ticks. This increment does not persist leftover-map inner product, cosine, or length. + +Do not add SQL. Do not edit shipped migrations. Do not invent a leftover +score. Do not invent a theta. + +## Consequences + +After `make seed`, leftover-map comparison leftover-pair leftover-map post name persisted +leftover-map person coordinates when leftoverMapCompareListPostBadge returns a usable +leftover-map comparison leftover-pair leftover-map post leftover-map person coordinate caption; click a leftover pair +or a leftover-map post marker opens that post. Hidden posts stay hidden. Rank-0 unused +axes still name leftover-map comparison leftover-pair leftover-map post leftover-map person coordinates +`(0.00, 0.00)`. Leftover-map pair leftover-map post leftover-map person coordinates stay +`leftover pair leftover-map post {title} at ξ {person}`. Leftover-map graphic leftover-map post markers stay +`Open leftover-map post {title} at ξ {person}`. Leftover-map comparison graphic leftover-map post markers stay +`Open leftover map comparison graphic leftover-map post {title} at ξ {person}`. Leftover-map pair leftover-map criterion leftover-map item coordinates independently of leftover-map +pair leftover-map post leftover-map person coordinates (ADR 0340), leftover-map pair leftover-map post leftover-map person coordinates independently of leftover-map +pair leftover-map criterion leftover-map item coordinates (ADR 0339), leftover-map graphic leftover-map post leftover-map person coordinates independently of leftover-map +comparison graphic leftover-map post markers (ADR 0338), leftover-map comparison graphic leftover-map post leftover-map person coordinates independently of leftover-map +criterion leftover-map item coordinates (ADR 0337), leftover-map comparison graphic leftover-map criterion leftover-map item coordinates independently of leftover-map +post ξ markers (ADR 0336), leftover-map graphic leftover-map criterion leftover-map item coordinates independently of leftover-map +post ξ markers (ADR 0335), leftover-map graphic display (ADR 0268), leftover-map +coordinates (ADR 0267), and leftover-map coordinates on grouping comparison strip pair rows (ADR 0302) remain. + +## Related + +Independent of leftover-map item coordinates on leftover-map pair leftover-map criterion independently of leftover-map +pair leftover-map post leftover-map person coordinates +([ADR 0340](0340-leftover-map-list-criterion-coordinates.md)). Independent of leftover-map pair leftover-map post leftover-map person coordinates independently of leftover-map +pair leftover-map criterion leftover-map item coordinates +([ADR 0339](0339-leftover-map-list-post-coordinates.md)). Independent of leftover-map graphic leftover-map post leftover-map person coordinates independently of leftover-map +comparison graphic leftover-map post markers +([ADR 0338](0338-leftover-map-plot-post-coordinates.md)). Independent of leftover-map comparison graphic leftover-map post leftover-map person coordinates independently of leftover-map +criterion leftover-map item coordinates +([ADR 0337](0337-leftover-map-compare-plot-post-coordinates.md)). Independent of leftover-map comparison graphic leftover-map criterion leftover-map item coordinates independently of leftover-map +post ξ markers +([ADR 0336](0336-leftover-map-compare-plot-criterion-coordinates.md)). Independent of leftover-map graphic leftover-map criterion leftover-map item coordinates independently of leftover-map +post ξ markers +([ADR 0335](0335-leftover-map-plot-criterion-coordinates.md)). Independent of leftover-map +graphic display ([ADR 0268](0268-leftover-map-graphic-display.md)). Independent of leftover-map +comparison graphic ([ADR 0304](0304-leftover-map-compare-graphic.md)). Independent of leftover-map +coordinates ([ADR 0267](0267-leftover-map-coordinates.md)). Independent of leftover-map +coordinates on grouping comparison strip pair rows +([ADR 0302](0302-leftover-map-compare-coordinates.md)). + +## 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.) diff --git a/docs/product-technical-gap-baseline.md b/docs/product-technical-gap-baseline.md index 792c230c2..9f6fc6ac7 100644 --- a/docs/product-technical-gap-baseline.md +++ b/docs/product-technical-gap-baseline.md @@ -1,5 +1,28 @@ # Product & Technical Gap Baseline +> Exact-head loop overlay: 2026-08-31 18:45 KST. Protected `main` is +> `cb187cadee5fb6c46d8a944815ccc154a1e028d1`. Writes work. Do not +> self-approve. #882 leftover-map item coordinates on leftover-map pair leftover-map +> criterion independently of leftover-map pair leftover-map post leftover-map person coordinates (v2.97.0 / ADR 0340) is +> `094d1a0`, stacked on #881 @ `167888d`. Independent APPROVE is missing (Devin COMMENTED, +> not APPROVE). Next buyer increment on this cycle: leftover-map comparison leftover-pair leftover-map +> post naming persisted leftover-map person coordinates independently of leftover-map +> comparison leftover-pair leftover-map criterion leftover-map item coordinates (ADR 0341 / v2.98.0) delivered locally on +> `feat/leftover-map-compare-list-post-coordinates-v2980`. Caption persisted leftover-map +> person coordinates on leftover-map comparison leftover-pair leftover-map post when leftoverMapCompareListPostBadge +> returns a usable leftover-map comparison leftover-pair leftover-map post leftover-map person coordinate caption. Distinct accessible name +> `leftover map comparison leftover pair leftover-map post {title} at ξ {person}`. +> Rank-0 unused axes still name leftover-map person coordinates `(0.00, 0.00)`. A missing or +> non-finite leftover-map person coordinate pair omits independently of leftover-map comparison leftover-pair leftover-map criterion leftover-map item `ζ` and keeps +> `Open leftover {kind} pair from comparison: {title} · {criterion}`. Leftover-map pair leftover-map post leftover-map person coordinates stay +> `leftover pair leftover-map post {title} at ξ {person}` this increment. Leftover-map graphic leftover-map post markers stay +> `Open leftover-map post {title} at ξ {person}` this increment. Leftover-map comparison graphic leftover-map post markers stay +> `Open leftover map comparison graphic leftover-map post {title} at ξ {person}` this increment. Do not invent leftover-map +> person coordinates from leftover-map item coordinates `ζ`. Do not invent leftover-map +> item coordinates `ζ` from leftover-map person coordinates `ξ`. Do not persist leftover-map inner product, cosine, or length. Stack onto #882. +> Leave open for independent review. Do not squash-merge. Do not self-approve. Issues #79 +> and #87 stay open. Do not merge #808 without independent APPROVE. Never self-approve. Do not mix #877. + > Exact-head loop overlay: 2026-08-31 18:20 KST. Protected `main` is > `cb187cadee5fb6c46d8a944815ccc154a1e028d1`. Writes work. Do not > self-approve. #881 leftover-map person coordinates on leftover-map pair leftover-map diff --git a/docs/storybook-inventory.md b/docs/storybook-inventory.md index f6f6dae0a..970848374 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 leftover-map graphic leftover-map post markers to `Open leftover-map post {title} at ξ {person}`, match leftover-map graphic leftover-map criterion markers to `leftover-map criterion {label} at ζ {item}`, 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 singular values `σ_k` and 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. The comparison variant names leftover-map complete-case coverage under `Leftover map comparison graphic coverage` and leftover-map item complete-case coverage under `Leftover map comparison graphic item coverage` and leftover-map incomplete post coverage under `Leftover map comparison graphic incomplete posts` and leftover-map incomplete item coverage under `Leftover map comparison graphic incomplete items` and leftover-map comparison graphic leftover-map criterion markers under `leftover map comparison graphic leftover-map criterion {label} at ζ {item}` and leftover-map comparison graphic leftover-map post markers under `Open leftover map comparison graphic leftover-map post {title} at ξ {person}`. `ClosestAndFarthest`, `RankZeroOrigin`, `MissingCoordinates`, `MissingAxisShare`, `Comparison`, `ComparisonMissingCoverage`, `ComparisonMissingItemCoverage`, `ComparisonMissingIncompletePosts`, and `ComparisonMissingIncompleteItems` 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, missing share that keeps leftover-map axis `σ` without share, grouping comparison leftover-map graphic coverage that matches leftover map used N of M scored posts, omitted comparison graphic coverage when leftoverMapCoverageCounts fail-closes, grouping comparison leftover-map graphic item coverage that matches leftover map used N of M scored criteria, omitted comparison graphic item coverage when leftoverMapItemCoverageCounts fail-closes, grouping comparison leftover-map graphic incomplete posts that matches leftover map dropped N incomplete posts, omitted comparison graphic incomplete posts when leftoverMapIncompletePostCount fail-closes, grouping comparison leftover-map graphic incomplete items that matches leftover map dropped N incomplete criteria, and omitted comparison graphic incomplete items when leftoverMapIncompleteItemCount fail-closes. 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. Leftover-map pair leftover-map post name persisted leftover-map person coordinates under `leftover pair leftover-map post {title} at ξ {person}` independently of leftover-map pair leftover-map criterion leftover-map item coordinates when leftoverMapListPostBadge returns a usable leftover-map pair leftover-map post leftover-map person coordinate caption. Leftover-map pair leftover-map criterion name persisted leftover-map item coordinates under `leftover pair leftover-map criterion {label} at ζ {item}` independently of leftover-map pair leftover-map post leftover-map person coordinates when leftoverMapListCriterionBadge returns a usable leftover-map pair leftover-map criterion leftover-map item coordinate caption. The leftover-map graphic display sits above the pair buttons when coordinates are finite, leftover-map axes name persisted leftover-map singular values and leftover-map axis share, leftover-map axis ticks name persisted coordinates, leftover-map graphic leftover-map post markers name persisted leftover-map person coordinates under `Open leftover-map post {title} at ξ {person}`, leftover-map graphic leftover-map criterion markers name persisted leftover-map item coordinates under `leftover-map criterion {label} at ζ {item}`, leftover-axis ticks name persisted leftover-map singular values and leftover-map axis share independently under `leftover axis {axis} tick {value} σ {singular} {share}%`, 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 only when leftoverMapCoverageCounts returns usable complete-case integers, leftover-map item complete-case coverage, leftover-map incomplete post coverage, and leftover-map incomplete item coverage when persisted. The grouping comparison strip names leftover-map complete-case coverage, leftover-map item complete-case coverage, leftover-map incomplete post coverage, leftover-map incomplete item coverage, leftover-axis report badges with persisted leftover-map singular values under `leftover map comparison leftover axis {axis} σ {value}`, leftover-axis ticks with persisted leftover-map singular values and leftover-map axis share under `leftover map comparison leftover axis {axis} tick {value} σ {singular} {share}%` independently of leftover-map singular values, and leftover-map comparison graphic leftover-map criterion markers under `leftover map comparison graphic leftover-map criterion {label} at ζ {item}` and leftover-map comparison graphic leftover-map post markers under `Open leftover map comparison graphic leftover-map post {title} at ξ {person}` with distinct comparison labels when leftoverMapCoverageCounts / leftoverMapItemCoverageCounts / leftoverMapIncompletePostCount / leftoverMapIncompleteItemCount / leftoverMapCompareAxisBadge / leftoverMapCompareAxisTickBadge / leftoverMapComparePlotCriterionBadge / leftoverMapComparePlotPostBadge return usable values. | `LeftoverPairList`, `LeftoverMapPlot`, `leftoverMapCoordinates`, `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. Leftover-map pair leftover-map post name persisted leftover-map person coordinates under `leftover pair leftover-map post {title} at ξ {person}` independently of leftover-map pair leftover-map criterion leftover-map item coordinates when leftoverMapListPostBadge returns a usable leftover-map pair leftover-map post leftover-map person coordinate caption. Leftover-map pair leftover-map criterion name persisted leftover-map item coordinates under `leftover pair leftover-map criterion {label} at ζ {item}` independently of leftover-map pair leftover-map post leftover-map person coordinates when leftoverMapListCriterionBadge returns a usable leftover-map pair leftover-map criterion leftover-map item coordinate caption. The leftover-map graphic display sits above the pair buttons when coordinates are finite, leftover-map axes name persisted leftover-map singular values and leftover-map axis share, leftover-map axis ticks name persisted coordinates, leftover-map graphic leftover-map post markers name persisted leftover-map person coordinates under `Open leftover-map post {title} at ξ {person}`, leftover-map graphic leftover-map criterion markers name persisted leftover-map item coordinates under `leftover-map criterion {label} at ζ {item}`, leftover-axis ticks name persisted leftover-map singular values and leftover-map axis share independently under `leftover axis {axis} tick {value} σ {singular} {share}%`, 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 only when leftoverMapCoverageCounts returns usable complete-case integers, leftover-map item complete-case coverage, leftover-map incomplete post coverage, and leftover-map incomplete item coverage when persisted. The grouping comparison strip names leftover-map complete-case coverage, leftover-map item complete-case coverage, leftover-map incomplete post coverage, leftover-map incomplete item coverage, leftover-axis report badges with persisted leftover-map singular values under `leftover map comparison leftover axis {axis} σ {value}`, leftover-axis ticks with persisted leftover-map singular values and leftover-map axis share under `leftover map comparison leftover axis {axis} tick {value} σ {singular} {share}%` independently of leftover-map singular values, and leftover-map comparison graphic leftover-map criterion markers under `leftover map comparison graphic leftover-map criterion {label} at ζ {item}` and leftover-map comparison graphic leftover-map post markers under `Open leftover map comparison graphic leftover-map post {title} at ξ {person}` with distinct comparison labels when leftoverMapCoverageCounts / leftoverMapItemCoverageCounts / leftoverMapIncompletePostCount / leftoverMapIncompleteItemCount / leftoverMapCompareAxisBadge / leftoverMapCompareAxisTickBadge / leftoverMapComparePlotCriterionBadge / leftoverMapComparePlotPostBadge return usable values. Leftover-map comparison leftover-pair leftover-map post name persisted leftover-map person coordinates under `leftover map comparison leftover pair leftover-map post {title} at ξ {person}` independently of leftover-map comparison leftover-pair leftover-map criterion leftover-map item coordinates when leftoverMapCompareListPostBadge returns a usable leftover-map comparison leftover-pair leftover-map post leftover-map person coordinate caption. | `LeftoverPairList`, `LeftoverMapPlot`, `leftoverMapCoordinates`, `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 9d7265c62..7aeceed61 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,7 +1,7 @@ { "name": "frontend", "private": true, - "version": "2.97.0", + "version": "2.98.0", "type": "module", "scripts": { "dev": "vite", diff --git a/frontend/src/App.test.tsx b/frontend/src/App.test.tsx index 0044c5fa4..209031c70 100644 --- a/frontend/src/App.test.tsx +++ b/frontend/src/App.test.tsx @@ -4885,64 +4885,74 @@ describe("App, authenticated", () => { ); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("Closest leftover: Public post · sales-lead"); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("d 0.12"); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("R̂ +0.25"); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("R̂²/R² 0.76"); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("U²/R² 0.02"); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("2R̂U/R² 0.12"); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("U +0.05"); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("R +0.40"); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("Y 2.40"); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("E 2.00"); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("rank 1"); expect( screen.getByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toHaveTextContent("ξ (+0.50, +0.10) ζ (+0.50, −0.02)"); + expect( + screen.getByRole("button", { + name: "leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", + }), + ).toBeInTheDocument(); + expect( + screen.getByRole("button", { + name: "Open leftover map comparison graphic leftover-map post Public post at ξ (+0.50, +0.10)", + }), + ).toBeInTheDocument(); await waitFor(() => expect(fetchMock).toHaveBeenCalledWith( expect.stringContaining("/api/reports/thread_group/2026-W02"), @@ -4966,7 +4976,7 @@ describe("App, authenticated", () => { await userEvent.click( await screen.findByRole("button", { - name: /open leftover closest pair from comparison: public post/i, + name: "leftover map comparison leftover pair leftover-map post Public post at ξ (+0.50, +0.10)", }), ); await waitFor(() => expect(screen.getByText("The full body text.")).toBeInTheDocument()); diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx index e814144e5..e766bb42b 100644 --- a/frontend/src/App.tsx +++ b/frontend/src/App.tsx @@ -186,6 +186,7 @@ import { } from "./leftoverMapRank"; import { formatLeftoverMapCoordinates, + leftoverMapCompareListPostBadge, LEFTOVER_MAP_COMPARE_COORDINATES_LABEL, } from "./leftoverMapCoordinates"; import "./App.css"; @@ -4221,6 +4222,11 @@ function ReportsPanel({ pair.leftover_map_item_axis_1, pair.leftover_map_item_axis_2, ); + const listPostBadge = leftoverMapCompareListPostBadge( + pair.post_title, + pair.leftover_map_person_axis_1, + pair.leftover_map_person_axis_2, + ); return (