diff --git a/AGENTS.md b/AGENTS.md index bcd435292..c1ec0adbc 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -764,6 +764,15 @@ item coordinate caption and keeps `Criterion ζ {label}`. Rank-0 unused axes sti item coordinates `(0.00, 0.00)`. Do not invent leftover-map item coordinates from leftover-map post `ξ`. Do not invent leftover-map post `ξ` from leftover-map item coordinates. Leftover-map graphic leftover-map criterion markers stay `leftover-map criterion {label} at ζ {item}` this increment. +ADR 0337 captions leftover-map comparison graphic leftover-map post markers with persisted leftover-map +person coordinates when leftoverMapComparePlotPostBadge returns a usable leftover-map comparison graphic leftover-map post leftover-map +person coordinate caption. Distinct accessible name +`Open leftover map comparison graphic leftover-map post {title} at ξ {person}`. +A missing or non-finite leftover-map person coordinate pair omits that leftover-map comparison graphic leftover-map post leftover-map +person coordinate caption and keeps `Open leftover-map post {title}`. 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 graphic leftover-map +post markers stay `Open 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 @@ -913,6 +922,10 @@ Leftover-map comparison graphic leftover-map criterion leftover-map item coordin (ADR 0336) captions leftover-map comparison graphic leftover-map criterion markers with persisted leftover-map item coordinates when leftoverMapComparePlotCriterionBadge returns a usable leftover-map comparison graphic leftover-map criterion leftover-map item coordinate caption. +Leftover-map comparison graphic leftover-map post leftover-map person coordinates independently of leftover-map criterion leftover-map item coordinates +(ADR 0337) captions leftover-map comparison graphic leftover-map post markers with persisted leftover-map +person coordinates when leftoverMapComparePlotPostBadge returns a usable leftover-map comparison graphic 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 8d2f0ff80..81e84bcc8 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -791,6 +791,9 @@ item coordinate caption independently of leftover-map post ξ markers. ADR 0336 captions leftover-map comparison graphic leftover-map criterion markers with persisted leftover-map item coordinates when leftoverMapComparePlotCriterionBadge returns a usable leftover-map comparison graphic leftover-map criterion leftover-map item coordinate caption independently of leftover-map post ξ markers. +ADR 0337 captions leftover-map comparison graphic leftover-map post markers with persisted leftover-map +person coordinates when leftoverMapComparePlotPostBadge returns a usable leftover-map comparison graphic leftover-map post leftover-map +person coordinate caption independently of 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 @@ -857,7 +860,8 @@ comparison graphic leftover-map axis leftover-map singular values as leftoverMap (ADR 0333), leftover-axis tick leftover-map axis share independently of leftover-map singular values (ADR 0334), leftover-map graphic leftover-map criterion leftover-map item coordinates independently of leftover-map post ξ markers (ADR 0335), leftover-map comparison graphic leftover-map criterion leftover-map item coordinates independently of leftover-map post ξ markers -(ADR 0336); +(ADR 0336), leftover-map comparison graphic leftover-map post leftover-map person coordinates independently of leftover-map criterion leftover-map item coordinates +(ADR 0337); `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 diff --git a/CHANGELOG.d/2.94.0-leftover-map-compare-plot-post-coordinates.md b/CHANGELOG.d/2.94.0-leftover-map-compare-plot-post-coordinates.md new file mode 100644 index 000000000..f7d1d64b0 --- /dev/null +++ b/CHANGELOG.d/2.94.0-leftover-map-compare-plot-post-coordinates.md @@ -0,0 +1,22 @@ +## 2.94.0 — Leftover-map person coordinates on leftover-map comparison graphic leftover-map post markers independently of leftover-map criterion leftover-map item coordinates + +- Caption leftover-map comparison graphic leftover-map post markers with persisted leftover-map + person coordinates through leftoverMapComparePlotPostBadge independently of leftover-map + criterion leftover-map item coordinates (ADR 0337). After `make seed`, leftover-map comparison graphic leftover-map + post markers name persisted leftover-map person coordinates when leftoverMapComparePlotPostBadge + returns a usable leftover-map comparison graphic 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 graphic leftover-map post leftover-map + person coordinate caption and keeps `Open leftover-map post {title}`. Rank-0 unused + axes still name leftover-map person coordinates `(0.00, 0.00)`. Leftover-map comparison graphic leftover-map + post markers stay + `Open leftover map comparison graphic leftover-map post {title} at ξ {person}` + when leftover-map person coordinates are finite so they stay distinct from leftover-map graphic leftover-map post markers + `Open leftover-map post {title} at ξ {person}` and from leftover-map comparison graphic leftover-map criterion markers + `leftover map comparison graphic leftover-map criterion {label} at ζ {item}`. 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 graphic leftover-map + post markers, leftover-map 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 b4f473e3c..c67e10873 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,27 @@ All notable changes to this project are documented here. Format follows ### Added +- Period leftover pairs now caption leftover-map comparison graphic leftover-map + post markers with persisted leftover-map person coordinates through leftoverMapComparePlotPostBadge + independently of leftover-map criterion leftover-map item coordinates (ADR 0337 / v2.94.0). After `make seed`, + leftover-map comparison graphic leftover-map post markers name persisted leftover-map + person coordinates when leftoverMapComparePlotPostBadge returns a usable leftover-map comparison graphic 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 graphic leftover-map post leftover-map person coordinate caption and keeps + `Open leftover-map post {title}`. + Rank-0 unused axes still name leftover-map person coordinates `(0.00, 0.00)`. Leftover-map comparison graphic leftover-map + post markers stay + `Open leftover map comparison graphic leftover-map post {title} at ξ {person}` + when leftover-map person coordinates are finite so they stay distinct from leftover-map graphic leftover-map post markers + `Open leftover-map post {title} at ξ {person}` and from leftover-map comparison graphic leftover-map criterion markers + `leftover map comparison graphic leftover-map criterion {label} at ζ {item}`. 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 graphic leftover-map + post markers, leftover-map 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 comparison graphic leftover-map criterion markers with persisted leftover-map item coordinates through leftoverMapComparePlotCriterionBadge independently of leftover-map post ξ markers (ADR 0336 / v2.93.0). After `make seed`, diff --git a/CLAUDE.md b/CLAUDE.md index 28204800e..ec125a6ca 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), 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), 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 31da6fb7b..a0bc006a3 100644 --- a/docs/adr/0267-leftover-map-coordinates.md +++ b/docs/adr/0267-leftover-map-coordinates.md @@ -10,7 +10,9 @@ [ADR 0335](0335-leftover-map-plot-criterion-coordinates.md) (leftover-map item coordinates on leftover-map graphic leftover-map criterion markers); [ADR 0336](0336-leftover-map-compare-plot-criterion-coordinates.md) -(leftover-map item coordinates on leftover-map comparison graphic leftover-map criterion markers) +(leftover-map item coordinates on leftover-map comparison graphic leftover-map criterion markers); +[ADR 0337](0337-leftover-map-compare-plot-post-coordinates.md) +(leftover-map person coordinates on leftover-map comparison graphic leftover-map post markers) Amends [ADR 0048](0048-persist-lsirm-leftover-pairs.md), [ADR 0049](0049-leftover-pair-report-ui.md), and diff --git a/docs/adr/0268-leftover-map-graphic-display.md b/docs/adr/0268-leftover-map-graphic-display.md index 2cdc0cf78..121e888a2 100644 --- a/docs/adr/0268-leftover-map-graphic-display.md +++ b/docs/adr/0268-leftover-map-graphic-display.md @@ -32,7 +32,9 @@ [ADR 0335](0335-leftover-map-plot-criterion-coordinates.md) (leftover-map item coordinates on leftover-map graphic leftover-map criterion markers); [ADR 0336](0336-leftover-map-compare-plot-criterion-coordinates.md) -(leftover-map item coordinates on leftover-map comparison graphic leftover-map criterion markers) +(leftover-map item coordinates on leftover-map comparison graphic leftover-map criterion markers); +[ADR 0337](0337-leftover-map-compare-plot-post-coordinates.md) +(leftover-map person coordinates on leftover-map comparison graphic leftover-map post markers) Amends [ADR 0049](0049-leftover-pair-report-ui.md) and [ADR 0267](0267-leftover-map-coordinates.md). Independent of leftover-map diff --git a/docs/adr/0304-leftover-map-compare-graphic.md b/docs/adr/0304-leftover-map-compare-graphic.md index 1396227fb..8d4dd35ed 100644 --- a/docs/adr/0304-leftover-map-compare-graphic.md +++ b/docs/adr/0304-leftover-map-compare-graphic.md @@ -14,7 +14,9 @@ [ADR 0309](0309-leftover-map-compare-plot-incomplete-item.md) (leftover-map incomplete item coverage on the grouping comparison leftover-map graphic), [ADR 0336](0336-leftover-map-compare-plot-criterion-coordinates.md) -(leftover-map item coordinates on leftover-map comparison graphic leftover-map criterion markers) +(leftover-map item coordinates on leftover-map comparison graphic leftover-map criterion markers); +[ADR 0337](0337-leftover-map-compare-plot-post-coordinates.md) +(leftover-map person coordinates on leftover-map comparison graphic leftover-map post markers) Amends leftover pairs on the grouping comparison strip ([ADR 0149](0149-leftover-pairs-on-comparison-strip.md)), leftover-map diff --git a/docs/adr/0334-leftover-map-axis-tick-share-badge.md b/docs/adr/0334-leftover-map-axis-tick-share-badge.md index 1eeffb5fb..7b3e90be4 100644 --- a/docs/adr/0334-leftover-map-axis-tick-share-badge.md +++ b/docs/adr/0334-leftover-map-axis-tick-share-badge.md @@ -121,7 +121,9 @@ axis share persistence ([ADR 0148](0148-leftover-map-axis-share.md)). Independen 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 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)). +([ADR 0336](0336-leftover-map-compare-plot-criterion-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)). ## References diff --git a/docs/adr/0336-leftover-map-compare-plot-criterion-coordinates.md b/docs/adr/0336-leftover-map-compare-plot-criterion-coordinates.md index 218d236c6..007bbce63 100644 --- a/docs/adr/0336-leftover-map-compare-plot-criterion-coordinates.md +++ b/docs/adr/0336-leftover-map-compare-plot-criterion-coordinates.md @@ -3,6 +3,9 @@ **Decision status:** Accepted **Date:** 2026-08-31 +**Amended by:** [ADR 0337](0337-leftover-map-compare-plot-post-coordinates.md) +(leftover-map person coordinates on leftover-map comparison graphic leftover-map post markers) + Amends leftover-map graphic display of persisted coordinates on the grouping comparison strip ([ADR 0304](0304-leftover-map-compare-graphic.md)), leftover-map graphic leftover-map criterion leftover-map item coordinates ([ADR 0335](0335-leftover-map-plot-criterion-coordinates.md)), leftover-map diff --git a/docs/adr/0337-leftover-map-compare-plot-post-coordinates.md b/docs/adr/0337-leftover-map-compare-plot-post-coordinates.md new file mode 100644 index 000000000..e204acb0c --- /dev/null +++ b/docs/adr/0337-leftover-map-compare-plot-post-coordinates.md @@ -0,0 +1,136 @@ +# ADR 0337 — Name leftover-map person coordinates on leftover-map comparison graphic leftover-map post markers independently of leftover-map criterion leftover-map item coordinates + +**Decision status:** Accepted +**Date:** 2026-08-31 + +Amends leftover-map graphic display of persisted coordinates on the grouping comparison strip +([ADR 0304](0304-leftover-map-compare-graphic.md)), leftover-map comparison graphic leftover-map criterion leftover-map item coordinates +([ADR 0336](0336-leftover-map-compare-plot-criterion-coordinates.md)), leftover-map +graphic leftover-map criterion leftover-map item coordinates +([ADR 0335](0335-leftover-map-plot-criterion-coordinates.md)), leftover-map +graphic display ([ADR 0268](0268-leftover-map-graphic-display.md)), leftover-map +coordinates ([ADR 0267](0267-leftover-map-coordinates.md)). Independent of leftover-axis +tick leftover-map axis share independently of leftover-map singular values +([ADR 0334](0334-leftover-map-axis-tick-share-badge.md)). Independent of leftover-map +comparison leftover-axis tick leftover-map axis share independently of leftover-map +singular values ([ADR 0333](0333-leftover-map-compare-axis-tick-share-badge.md)). Independent of leftover-map +graphic leftover-map axis tick leftover-map axis share independently of leftover-map +singular values ([ADR 0332](0332-leftover-map-plot-tick-share-badge.md)). Independent of leftover-map +comparison graphic leftover-map axis tick leftover-map axis share independently of leftover-map +singular values ([ADR 0331](0331-leftover-map-compare-plot-tick-share-badge.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 0268 already draws leftover-map graphic leftover-map +post markers at persisted `ξ` and leftover-map graphic leftover-map +criterion markers at persisted `ζ`. ADR 0304 reuses that graphic on the grouping +comparison strip. ADR 0335 already names leftover-map graphic leftover-map +criterion markers `leftover-map criterion {label} at ζ {item}` independently of leftover-map +post `ξ` markers. ADR 0336 already names leftover-map comparison graphic leftover-map +criterion markers `leftover map comparison graphic leftover-map criterion {label} at ζ {item}` +independently of leftover-map post `ξ` markers. Those leftover-map comparison graphic leftover-map +post markers still read `Open leftover-map post {title} at ξ {person}`, so a buyer who +reads leftover-map comparison graphic leftover-map post markers can treat leftover-map location as leftover-map graphic leftover-map +post `ξ` without a next action on leftover-map comparison graphic leftover-map post leftover-map person coordinates. A missing or +non-finite leftover-map person coordinate pair is not a leftover score and +must omit independently of leftover-map criterion leftover-map item 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 graphic leftover-map +post markers stay `Open leftover-map post {title} at ξ {person}` this increment. + +This increment names leftover-map comparison graphic leftover-map post markers leftover-map +person coordinates as leftoverMapComparePlotPostBadge, matching leftover-map +comparison graphic leftover-map criterion leftover-map item coordinates. Leftover-map comparison graphic leftover-map +post markers stay +`Open leftover map comparison graphic leftover-map post {title} at ξ {person}` +when leftover-map person coordinates are finite, so they stay distinct from leftover-map +graphic leftover-map post markers `Open leftover-map post {title} at ξ {person}` and from leftover-map +comparison graphic leftover-map criterion markers `leftover map comparison graphic leftover-map criterion {label} at ζ {item}`. +It does not add columns. Do not invent a leftover score. Do not invent a theta. + +This protected increment uses **0337** so it does not collide with 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-axis tick leftover-map axis share independently of leftover-map singular values +(0334), leftover-map comparison leftover-axis tick leftover-map axis share independently of leftover-map singular values +(0333), leftover-map graphic leftover-map axis tick leftover-map axis share independently of leftover-map singular values +(0332), leftover-map comparison graphic leftover-map axis tick leftover-map axis share independently of leftover-map singular values +(0331), leftover-map graphic display on the grouping comparison strip (0304), leftover-map graphic display (0268), leftover-map coordinates (0267), +or the dashboard stacks. + +## Decision + +On leftover-map comparison graphic leftover-map post markers, caption leftover-map +person coordinates `ξ_{1:2}` when leftoverMapComparePlotPostBadge +returns a usable leftover-map comparison graphic leftover-map post leftover-map person coordinate caption. +A missing or non-finite leftover-map person coordinate pair omits that leftover-map +comparison graphic leftover-map post leftover-map person coordinate caption and keeps +`Open leftover-map post {title}`. 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 graphic leftover-map post leftover-map person coordinates omit +independently of leftover-map criterion leftover-map item coordinates. This increment does not +change leftover-map graphic leftover-map post markers, +leftover-map 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 graphic leftover-map post markers name persisted +leftover-map person coordinates when leftoverMapComparePlotPostBadge returns a usable +leftover-map comparison graphic 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 graphic leftover-map post leftover-map person coordinates +`(0.00, 0.00)`. Leftover-map graphic leftover-map post markers stay +`Open leftover-map post {title} at ξ {person}`. 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-axis tick leftover-map axis share independently of leftover-map +singular values (ADR 0334), leftover-map comparison leftover-axis tick leftover-map axis share independently of leftover-map +singular values (ADR 0333), leftover-map graphic leftover-map axis tick leftover-map axis share independently of leftover-map +singular values (ADR 0332), leftover-map comparison graphic leftover-map axis tick leftover-map axis share independently of leftover-map +singular values (ADR 0331), leftover-map graphic display on the grouping comparison strip (ADR 0304), leftover-map graphic display (ADR 0268), and leftover-map +coordinates (ADR 0267) remain. + +## Related + +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-axis tick leftover-map axis share independently of leftover-map +singular values +([ADR 0334](0334-leftover-map-axis-tick-share-badge.md)). Independent of leftover-map +comparison leftover-axis tick leftover-map axis share independently of leftover-map +singular values +([ADR 0333](0333-leftover-map-compare-axis-tick-share-badge.md)). Independent of leftover-map +graphic leftover-map axis tick leftover-map axis share independently of leftover-map singular values +([ADR 0332](0332-leftover-map-plot-tick-share-badge.md)). Independent of leftover-map +comparison graphic leftover-map axis tick leftover-map axis share independently of leftover-map singular values +([ADR 0331](0331-leftover-map-compare-plot-tick-share-badge.md)). Independent of leftover-map +graphic display on the grouping comparison strip ([ADR 0304](0304-leftover-map-compare-graphic.md)). Independent of leftover-map +graphic display ([ADR 0268](0268-leftover-map-graphic-display.md)). Independent of leftover-map +coordinates ([ADR 0267](0267-leftover-map-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 9b14f4aa2..99a454dbb 100644 --- a/docs/product-technical-gap-baseline.md +++ b/docs/product-technical-gap-baseline.md @@ -1,5 +1,26 @@ # Product & Technical Gap Baseline +> Exact-head loop overlay: 2026-08-31 17:03 KST. Protected `main` is +> `cb187cadee5fb6c46d8a944815ccc154a1e028d1`. Writes work. Do not +> self-approve. #878 leftover-map item coordinates on leftover-map comparison graphic leftover-map +> criterion markers independently of leftover-map post ξ markers (v2.93.0 / ADR 0336) is +> `617b971`, stacked on #876 @ `89ed56b`. Independent APPROVE is missing (Devin COMMENTED, +> not APPROVE). Next buyer increment on this cycle: leftover-map comparison graphic leftover-map +> post markers naming persisted leftover-map person coordinates independently of leftover-map +> criterion leftover-map item coordinates (ADR 0337 / v2.94.0) delivered locally on +> `feat/leftover-map-compare-plot-post-coordinates-v2940`. Caption persisted leftover-map +> person coordinates on leftover-map comparison graphic leftover-map post markers when leftoverMapComparePlotPostBadge +> returns a usable leftover-map comparison graphic leftover-map post leftover-map person coordinate caption. Distinct accessible name +> `Open leftover map comparison graphic 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 criterion `ζ` and keeps +> `Open leftover-map post {title}`. Leftover-map graphic leftover-map post markers stay +> `Open 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 #878. +> 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 16:30 KST. Protected `main` is > `cb187cadee5fb6c46d8a944815ccc154a1e028d1`. Writes work. Do not > self-approve. #876 leftover-map item coordinates on leftover-map graphic leftover-map diff --git a/docs/storybook-inventory.md b/docs/storybook-inventory.md index c7bba994f..33885ead8 100644 --- a/docs/storybook-inventory.md +++ b/docs/storybook-inventory.md @@ -5,8 +5,8 @@ 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 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}`. `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. 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 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}` with distinct comparison labels when leftoverMapCoverageCounts / leftoverMapItemCoverageCounts / leftoverMapIncompletePostCount / leftoverMapIncompleteItemCount / leftoverMapCompareAxisBadge / leftoverMapCompareAxisTickBadge / leftoverMapComparePlotCriterionBadge return usable values. | `LeftoverPairList`, `LeftoverMapPlot`, `ticket-list`, `post-badge` | +| `Reports/LeftoverMapPlot` | Read the leftover-map graphic display of persisted `ξ` (posts) and `ζ` (criteria), 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. 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 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`, `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 2134be6d7..fe1eeb4fe 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,7 +1,7 @@ { "name": "frontend", "private": true, - "version": "2.93.0", + "version": "2.94.0", "type": "module", "scripts": { "dev": "vite", diff --git a/frontend/src/App.test.tsx b/frontend/src/App.test.tsx index fda9a50ba..35cc011f3 100644 --- a/frontend/src/App.test.tsx +++ b/frontend/src/App.test.tsx @@ -4234,9 +4234,14 @@ describe("App, authenticated", () => { expect(screen.getByText("leftover map comparison graphic leftover-map axis 2 σ 0.86 (18%)")).toBeInTheDocument(); expect( screen.getAllByRole("button", { - name: /open leftover-map post public post at ξ \(\+0\.50, \+0\.10\)/i, + name: "Open leftover-map post Public post at ξ (+0.50, +0.10)", }), - ).toHaveLength(2); + ).toHaveLength(1); + expect( + within(screen.getByLabelText("Grouping comparison")).getByRole("button", { + name: "Open leftover map comparison graphic leftover-map post Public post at ξ (+0.50, +0.10)", + }), + ).toBeInTheDocument(); expect(screen.getByLabelText("Leftover map coverage")).toHaveTextContent( "Leftover map used 2 of 3 scored posts (complete-case)", ); @@ -4438,7 +4443,7 @@ describe("App, authenticated", () => { ).toHaveTextContent("Open a leftover pair to read the post–criterion cell"); expect( within(screen.getByLabelText("Grouping comparison")).getByRole("button", { - name: "Open leftover-map post Public post at ξ (+0.50, +0.10)", + name: "Open leftover map comparison graphic leftover-map post Public post at ξ (+0.50, +0.10)", }), ).toBeInTheDocument(); expect( @@ -4958,7 +4963,7 @@ describe("App, authenticated", () => { const comparison = await screen.findByLabelText("Grouping comparison"); await userEvent.click( await within(comparison).findByRole("button", { - name: "Open leftover-map post Public post at ξ (+0.50, +0.10)", + name: "Open leftover map comparison graphic 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/components/LeftoverMapPlot.test.tsx b/frontend/src/components/LeftoverMapPlot.test.tsx index 80df55436..2ac835fb5 100644 --- a/frontend/src/components/LeftoverMapPlot.test.tsx +++ b/frontend/src/components/LeftoverMapPlot.test.tsx @@ -928,6 +928,16 @@ describe("LeftoverMapPlot", () => { expect(screen.getByText("leftover map comparison graphic leftover-map axis 2 σ 0.86 (18%)")).toBeInTheDocument(); expect(screen.getByLabelText("leftover map comparison graphic leftover-map criterion sales-lead at ζ (+0.50, −0.02)")).toBeInTheDocument(); expect(screen.getByLabelText("leftover map comparison graphic leftover-map criterion negative at ζ (−0.70, −0.40)")).toBeInTheDocument(); + expect( + screen.getByRole("button", { + name: "Open leftover map comparison graphic leftover-map post Public post at ξ (+0.50, +0.10)", + }), + ).toBeInTheDocument(); + expect( + screen.queryByRole("button", { + name: "Open leftover-map post Public post at ξ (+0.50, +0.10)", + }), + ).not.toBeInTheDocument(); expect(screen.queryByLabelText("Criterion ζ sales-lead")).not.toBeInTheDocument(); expect(screen.queryByLabelText("Criterion ζ negative")).not.toBeInTheDocument(); expect( @@ -979,6 +989,16 @@ describe("LeftoverMapPlot", () => { expect( screen.getByLabelText("leftover map comparison graphic leftover-map criterion sales-lead at ζ (0.00, 0.00)"), ).toBeInTheDocument(); + expect( + screen.getByRole("button", { + name: "Open leftover map comparison graphic leftover-map post Public post at ξ (0.00, 0.00)", + }), + ).toBeInTheDocument(); + expect( + screen.queryByRole("button", { + name: "Open leftover-map post Public post at ξ (0.00, 0.00)", + }), + ).not.toBeInTheDocument(); expect(screen.queryByLabelText("Criterion ζ sales-lead")).not.toBeInTheDocument(); expect(screen.queryByLabelText("leftover-map criterion sales-lead at ζ (0.00, 0.00)")).not.toBeInTheDocument(); }); diff --git a/frontend/src/components/LeftoverMapPlot.tsx b/frontend/src/components/LeftoverMapPlot.tsx index 9c155332e..5471529b5 100644 --- a/frontend/src/components/LeftoverMapPlot.tsx +++ b/frontend/src/components/LeftoverMapPlot.tsx @@ -36,6 +36,7 @@ import { layoutLeftoverMapPlot, leftoverMapPlotCriterionBadge, leftoverMapComparePlotCriterionBadge, + leftoverMapComparePlotPostBadge, LEFTOVER_MAP_COMPARE_PLOT_CAPTION, LEFTOVER_MAP_COMPARE_PLOT_LABEL, LEFTOVER_MAP_COMPARE_PLOT_SVG, @@ -51,6 +52,7 @@ import { LEFTOVER_MAP_COMPARE_PLOT_SEGMENT_DISTANCE, LEFTOVER_MAP_PLOT_CAPTION, LEFTOVER_MAP_PLOT_POST_ACTION, + LEFTOVER_MAP_PLOT_POST_ACTION_OMITTED, LEFTOVER_MAP_PLOT_SEGMENT_CROSS_SHARE, LEFTOVER_MAP_PLOT_SEGMENT_DISTANCE, LEFTOVER_MAP_PLOT_SEGMENT_EXPLAINED_SHARE, @@ -139,6 +141,24 @@ function leftoverMapPlotCriterionText( return tf(badge.key, badge.values); } +function leftoverMapPlotPostText( + marker: { label: string; axis1: number; axis2: number }, + variant: LeftoverMapPlotVariant, +): string { + if (variant === "comparison") { + const badge = leftoverMapComparePlotPostBadge(marker.label, marker.axis1, marker.axis2); + if (badge === null) { + return tf(LEFTOVER_MAP_PLOT_POST_ACTION_OMITTED, { title: marker.label }); + } + return tf(badge.key, badge.values); + } + const person = formatLeftoverMapCoordinatePair(marker.axis1, marker.axis2) ?? ""; + return tf(LEFTOVER_MAP_PLOT_POST_ACTION, { + title: marker.label, + person, + }); +} + /** * Gabriel leftover-map graphic display of persisted ``ξ_{1:2}`` / ``ζ_{1:2}``. * @@ -149,7 +169,10 @@ function leftoverMapPlotCriterionText( * leftover-map item coordinate caption. Caption leftover-map comparison graphic leftover-map * criterion markers with persisted leftover-map item coordinates ``ζ_{1:2}`` * when leftoverMapComparePlotCriterionBadge returns a usable leftover-map comparison - * graphic leftover-map criterion leftover-map item coordinate caption. Caption leftover-map axes with persisted + * graphic leftover-map criterion leftover-map item coordinate caption. Caption leftover-map + * comparison graphic leftover-map post markers with persisted leftover-map person coordinates + * ``ξ_{1:2}`` when leftoverMapComparePlotPostBadge returns a usable leftover-map comparison + * graphic leftover-map post leftover-map person coordinate caption. Caption leftover-map axes with persisted * leftover-map singular values ``σ_k`` and Gabriel inertia share when finite, * including rank-0 zero-share axes. * Axis ticks name persisted leftover-map coordinates so ξ / ζ on the @@ -581,17 +604,13 @@ export function LeftoverMapPlot({ ))} {layout.persons.map((marker) => { - const person = formatLeftoverMapCoordinatePair(marker.axis1, marker.axis2) ?? ""; return ( openPost(marker.id)} onKeyDown={(event) => { if (event.key === "Enter" || event.key === " ") { diff --git a/frontend/src/i18n.test.ts b/frontend/src/i18n.test.ts index 46afadebf..d060d0205 100644 --- a/frontend/src/i18n.test.ts +++ b/frontend/src/i18n.test.ts @@ -150,6 +150,8 @@ describe("i18n", () => { "Leftover map dropped {dropped} incomplete criteria", "Leftover map after IRT main effects. Axis ticks name persisted leftover-map coordinates. Pair segments name leftover-map distance d, leftover-map reconstruction R̂, leftover-map explained leftover share e, leftover-map unexplained leftover share s, leftover-map cross share x, leftover-map unexplained leftover U, leftover residual R, leftover observed Y, leftover expected E, and leftover-map rank. 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. Click a post marker to open that post. The plot does not invent a leftover score.", "Open leftover-map post {title} at ξ {person}", + "Open leftover-map post {title}", + "Open leftover map comparison graphic leftover-map post {title} at ξ {person}", "Read observed Y {observed} and expected E {expected} after IRT main effects, then open this post.", "Leftover map has no leftover structure after IRT main effects. Open this post.", "Leftover map rank {rank} after IRT main effects. Open this post.", @@ -462,6 +464,21 @@ describe("i18n", () => { ).toBe(expected); }); + it.each([ + ["ko", "잔여 지도 비교 그림 글 Public post 열기 (ξ (+0.50, +0.10))"], + ["zh", "打开残差地图比较图形帖子 Public post(ξ (+0.50, +0.10))"], + ["ja", "残差マップの比較図の投稿 Public post を開く(ξ (+0.50, +0.10))"], + ["vi", "Mở bài đồ họa so sánh bản đồ phần dư Public post tại ξ (+0.50, +0.10)"], + ] as const)("formats leftover map comparison graphic leftover-map post ξ in %s", (locale, expected) => { + setLocale(locale); + expect( + tf("Open leftover map comparison graphic leftover-map post {title} at ξ {person}", { + title: "Public post", + person: "(+0.50, +0.10)", + }), + ).toBe(expected); + }); + it.each([ ["ko", "잔여 지도 그림 포함 범위"], ["zh", "残差图图形覆盖范围"], diff --git a/frontend/src/i18n.ts b/frontend/src/i18n.ts index 69a060f79..dee53c062 100644 --- a/frontend/src/i18n.ts +++ b/frontend/src/i18n.ts @@ -666,6 +666,9 @@ const TRANSLATIONS: Partial>> = { "leftover-map criterion {label} at ζ {item}": "잔여 지도 기준 {label} (ζ {item})", "leftover map comparison graphic leftover-map criterion {label} at ζ {item}": "잔여 지도 비교 그림 기준 {label} (ζ {item})", + "Open leftover-map post {title}": "잔여 지도 글 {title} 열기", + "Open leftover map comparison graphic leftover-map post {title} at ξ {person}": + "잔여 지도 비교 그림 글 {title} 열기 (ξ {person})", "leftover-map axis 1": "잔여 지도 축 1", "leftover-map axis 2": "잔여 지도 축 2", "leftover-map axis {axis} ({share}%)": "잔여 지도 축 {axis} ({share}%)", @@ -1344,6 +1347,9 @@ const TRANSLATIONS: Partial>> = { "leftover-map criterion {label} at ζ {item}": "残差图准则 {label}(ζ {item})", "leftover map comparison graphic leftover-map criterion {label} at ζ {item}": "残差地图比较图形准则 {label}(ζ {item})", + "Open leftover-map post {title}": "打开残差图帖子 {title}", + "Open leftover map comparison graphic leftover-map post {title} at ξ {person}": + "打开残差地图比较图形帖子 {title}(ξ {person})", "leftover-map axis 1": "残差图轴 1", "leftover-map axis 2": "残差图轴 2", "leftover-map axis {axis} ({share}%)": "残差图轴 {axis} ({share}%)", @@ -2026,6 +2032,9 @@ const TRANSLATIONS: Partial>> = { "leftover-map criterion {label} at ζ {item}": "残差マップの基準 {label}(ζ {item})", "leftover map comparison graphic leftover-map criterion {label} at ζ {item}": "残差マップの比較図基準 {label}(ζ {item})", + "Open leftover-map post {title}": "残差マップの投稿 {title} を開く", + "Open leftover map comparison graphic leftover-map post {title} at ξ {person}": + "残差マップの比較図の投稿 {title} を開く(ξ {person})", "leftover-map axis 1": "残差マップ軸 1", "leftover-map axis 2": "残差マップ軸 2", "leftover-map axis {axis} ({share}%)": "残差マップ軸 {axis} ({share}%)", @@ -2712,6 +2721,9 @@ const TRANSLATIONS: Partial>> = { "leftover-map criterion {label} at ζ {item}": "tiêu chí bản đồ phần dư {label} tại ζ {item}", "leftover map comparison graphic leftover-map criterion {label} at ζ {item}": "tiêu chí đồ họa so sánh bản đồ phần dư {label} tại ζ {item}", + "Open leftover-map post {title}": "Mở bài viết bản đồ phần dư {title}", + "Open leftover map comparison graphic leftover-map post {title} at ξ {person}": + "Mở bài đồ họa so sánh bản đồ phần dư {title} tại ξ {person}", "leftover-map axis 1": "trục bản đồ phần dư 1", "leftover-map axis 2": "trục bản đồ phần dư 2", "leftover-map axis {axis} ({share}%)": "trục bản đồ phần dư {axis} ({share}%)", diff --git a/frontend/src/leftoverMapPlotLayout.test.ts b/frontend/src/leftoverMapPlotLayout.test.ts index a1b781abf..6783470db 100644 --- a/frontend/src/leftoverMapPlotLayout.test.ts +++ b/frontend/src/leftoverMapPlotLayout.test.ts @@ -7,6 +7,7 @@ import { layoutLeftoverMapPlot, leftoverMapPlotCriterionBadge, leftoverMapComparePlotCriterionBadge, + leftoverMapComparePlotPostBadge, LEFTOVER_MAP_COMPARE_PLOT_CAPTION, LEFTOVER_MAP_COMPARE_PLOT_LABEL, LEFTOVER_MAP_COMPARE_PLOT_SEGMENT_RECONSTRUCTION, @@ -24,6 +25,8 @@ import { LEFTOVER_MAP_PLOT_CRITERION, LEFTOVER_MAP_COMPARE_PLOT_CRITERION, LEFTOVER_MAP_PLOT_POST_ACTION, + LEFTOVER_MAP_PLOT_POST_ACTION_OMITTED, + LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION, LEFTOVER_MAP_PLOT_TICK, PLOT_HEIGHT, PLOT_PADDING, @@ -1245,6 +1248,9 @@ describe("leftoverMapPlotCriterionBadge", () => { expect(leftoverMapPlotCriterionBadge("sales-lead", 0.5, -0.02)?.key).not.toBe( LEFTOVER_MAP_COMPARE_PLOT_CRITERION, ); + expect(leftoverMapPlotCriterionBadge("sales-lead", 0.5, -0.02)?.key).not.toBe( + LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION, + ); }); }); @@ -1288,6 +1294,52 @@ describe("leftoverMapComparePlotCriterionBadge", () => { expect(leftoverMapComparePlotCriterionBadge("sales-lead", 0.5, -0.02)?.key).not.toBe( LEFTOVER_MAP_PLOT_POST_ACTION, ); + expect(leftoverMapComparePlotCriterionBadge("sales-lead", 0.5, -0.02)?.key).not.toBe( + LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION, + ); + }); +}); + +describe("leftoverMapComparePlotPostBadge", () => { + it("names persisted leftover-map person coordinates without inventing a leftover score", () => { + expect(leftoverMapComparePlotPostBadge("Public post", 0.5, 0.1)).toEqual({ + key: LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION, + values: { title: "Public post", person: "(+0.50, +0.10)" }, + }); + expect(leftoverMapComparePlotPostBadge("negative", -0.7, -0.4)).toEqual({ + key: LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION, + values: { title: "negative", person: "(\u22120.70, \u22120.40)" }, + }); + }); + + it("names rank-0 origin leftover-map person coordinates as ξ (0.00, 0.00)", () => { + expect(leftoverMapComparePlotPostBadge("Public post", 0, 0)).toEqual({ + key: LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION, + values: { title: "Public post", person: "(0.00, 0.00)" }, + }); + }); + + it("omits leftover-map person coordinates when ξ is missing or non-finite", () => { + expect(leftoverMapComparePlotPostBadge("Public post", null, 0.1)).toBeNull(); + expect(leftoverMapComparePlotPostBadge("Public post", 0.5, undefined)).toBeNull(); + expect(leftoverMapComparePlotPostBadge("Public post", Number.NaN, 0.1)).toBeNull(); + expect(leftoverMapComparePlotPostBadge("Public post", 0.5, Number.POSITIVE_INFINITY)).toBeNull(); + }); + + it("stays distinct from leftover-map graphic leftover-map post markers and leftover-map comparison graphic leftover-map criterion markers", () => { + expect(LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION).toBe( + "Open leftover map comparison graphic leftover-map post {title} at ξ {person}", + ); + expect(LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION).not.toBe(LEFTOVER_MAP_PLOT_POST_ACTION); + expect(LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION).not.toBe(LEFTOVER_MAP_PLOT_POST_ACTION_OMITTED); + expect(LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION).not.toBe(LEFTOVER_MAP_COMPARE_PLOT_CRITERION); + expect(LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION).not.toBe(LEFTOVER_MAP_PLOT_CRITERION); + expect(leftoverMapComparePlotPostBadge("Public post", 0.5, 0.1)?.key).not.toBe( + LEFTOVER_MAP_PLOT_POST_ACTION, + ); + expect(leftoverMapComparePlotPostBadge("Public post", 0.5, 0.1)?.key).not.toBe( + LEFTOVER_MAP_COMPARE_PLOT_CRITERION, + ); }); }); diff --git a/frontend/src/leftoverMapPlotLayout.ts b/frontend/src/leftoverMapPlotLayout.ts index cc5fefda6..d24fc196f 100644 --- a/frontend/src/leftoverMapPlotLayout.ts +++ b/frontend/src/leftoverMapPlotLayout.ts @@ -123,6 +123,10 @@ * markers leftover-map item coordinates ζ through leftoverMapComparePlotCriterionBadge * independently of leftover-map post ξ markers, not leftover-map graphic leftover-map * criterion markers. + * ADR 0337 fail-closes leftover-map comparison graphic leftover-map post + * markers leftover-map person coordinates ξ through leftoverMapComparePlotPostBadge + * independently of leftover-map criterion leftover-map item coordinates ζ, not leftover-map + * graphic leftover-map post markers. */ import { formatLeftoverMapCoordinatePair } from "./leftoverMapCoordinates"; @@ -152,6 +156,12 @@ export const LEFTOVER_MAP_COMPARE_PLOT_SVG = "Leftover map comparison"; export const LEFTOVER_MAP_PLOT_POST_ACTION = "Open leftover-map post {title} at ξ {person}"; +export const LEFTOVER_MAP_PLOT_POST_ACTION_OMITTED = + "Open leftover-map post {title}"; + +export const LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION = + "Open leftover map comparison graphic leftover-map post {title} at ξ {person}"; + export const LEFTOVER_MAP_PLOT_CRITERION = "leftover-map criterion {label} at ζ {item}"; @@ -163,6 +173,11 @@ export type LeftoverMapPlotCriterionBadge = { values: { label: string; item: string }; }; +export type LeftoverMapPlotPostBadge = { + key: string; + values: { title: string; person: string }; +}; + export function leftoverMapPlotCriterionBadge( label: string, axis1: number | null | undefined, @@ -187,6 +202,18 @@ export function leftoverMapComparePlotCriterionBadge( return { key: LEFTOVER_MAP_COMPARE_PLOT_CRITERION, values: { label, item } }; } +export function leftoverMapComparePlotPostBadge( + title: string, + axis1: number | null | undefined, + axis2: number | null | undefined, +): LeftoverMapPlotPostBadge | null { + const person = formatLeftoverMapCoordinatePair(axis1, axis2); + if (person === null) { + return null; + } + return { key: LEFTOVER_MAP_COMPARE_PLOT_POST_ACTION, values: { title, person } }; +} + export const LEFTOVER_MAP_PLOT_TICK = "leftover-map axis {axis} tick {value}"; diff --git a/pyproject.toml b/pyproject.toml index 580016ad8..b15260a9f 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "lineageweave" -version = "2.93.0" +version = "2.94.0" description = "Reconstructs git-branch-style lineage DAGs from scattered short records using multi-channel score fusion and LLM adjudication." readme = "README.md" license = { text = "MIT" }