core/docs/handoff
Shay 4d8aa1dac9 feat(workbench): the Replay Moment — turn-keyed hero + retire W-026 artifact replay (Wave R3)
First R3 (Theater) piece. Reworks the stale artifact-keyed ReplayRoute into
the turn-keyed hero over the #716 sealed-replay backend, and fully retires
the dead W-026 artifact-keyed machinery on both sides (the NOT_YET_MIRRORED
comment anticipated this).

The hero makes determinism *felt*: pick a journaled turn, CORE re-executes
its prompt in a sealed fresh runtime, and the result renders as a hash
verdict (≡ equivalent / ≠ diverged) + the original/replay DigestBadges + a
leaf diff (critical weighted above informational, each with a ≠ glyph). The
'What this proves' card surfaces comparison_basis + origin_state and states
the honest limit: a divergence means nondeterminism OR origin-state
influence, never rendered on its own as a determinism failure.

Retirement (verified zero serving uses):
- Python schemas.py: removed ReplayComparison/ReplayDivergence/ReplayStatus/
  ReplayDivergenceSeverity; scripts/dump-enums.py drops the two replay enums;
  both snapshots regenerated (deterministic: dump == committed)
- TS: removed ReplayComparison/ReplayDivergence/ReplayDivergenceSeverity;
  added TurnReplayComparison/TurnReplayDivergence (+ basis/origin/severity
  unions); NOT_YET_MIRRORED now empty (every engine schema mirrored)
- badges: removed ReplayStatusBadge + ReplayDivergenceSeverityBadge +
  meta/enums + their enumCoverage cases (hero renders severity inline)
- api: fetchReplayComparison/useReplayComparison -> fetchTurnReplay/
  useTurnReplay (/replay/<turnId>)
- deleted ArtifactList, ReplayComparisonPanel, ReplayDiffViewer,
  ReplayMetadataTable, old replay.test.tsx
- App route /replay/:artifactId? -> /replay/:turnId?; conformance row
  turn-keyed (loading 'Loading turns...', empty 'No turns recorded yet.')

Tests: ReplayRoute.test.tsx (equivalence hero + honesty card, diverged
critical leaf, informational-only label, replace-mode select, j/k spine).
Full vitest 358 green; workbench Python 34 green; both snapshots deterministic.

Follow-up flagged (not in this PR to keep it focused): the artifact query
hooks (useArtifacts/useArtifactDetail/fetchArtifacts*) are now orphaned but
entangled with the still-live artifact EvidenceSubject kind — a separate
cleanup once an Artifacts route or that subject's fate is decided.

Brief: docs/handoff/wave-R3-briefs-2026-06-13.md (all four R3 pieces).
2026-06-12 22:07:34 -07:00
..
phase-3b-4-skeleton
ADR-0084-pack-content-brief.md
ADR-0085-content-style-pass-brief.md
ADR-0085-content-style-pass-v2-brief.md
ADR-0167-FOLLOWUPS.md
ADR-0167-PARALLEL-WORK-PLAN.md
ADR-0167-W2C-cross-domain-audit.md
ADR-0172-TIER1-BRIEF-PACK.md
ADR-0174-PHASE-3B-4-COMBINED-SCOPE.md
arithmetic-comprehension-via-binding-graph-2026-06-05.md
AUDIT-ADR-0178-GB1-GB2.md
AUDIT-ADR-0179-EX-RECONCILE.md
BACKLOG-everyday-atoms-grounding-pack.md
BRIEF-11-phase-2-reader-closure-and-capability-snapshot.md
CHATGPT-REMOTE-BRIEF.md
CLEANUP-C2-run-lane-migration.md
CLEANUP-C4-compositions-compile.md
CODEX-domain-pack-closure-cleanup-brief.md
CODEX-greek-hebrew-content-phase-ii-brief.md
COMPOSITION-FRAME-CONSUMPTION-WIRING-BRIEF.md
COMPOSITIONCLAIM-BRIEF-PACK.md
COMPREHENSION-READER-AUDIT.md
CONSUMPTION-WIRING-DISPATCH-PACK.md
DCS-S1-FINDING.md
discrete_count_statement-injector-spec.md
MATCHER-EXTENSION-DISPATCH-PACK.md
ME1-ME5-MILESTONE.md
NEXT-SUBJECTS-CHATGPT-HANDOFF.md
PARALLEL-WORK-PLAN-2026-05-29.md
PHASE-3.1-FOLLOWUP-RECOGNIZER-EXPANSION.md
POST-RAT1-PARALLEL-BRIEFS.md
RB-GSM-SOLVER-DESIGN-INPUT.md
sealed-measurement-obligation-2026-06-04.md
SEMANTIC-STATE-TRANSITION-BLUEPRINT.md
stage-c-composition-investigation-2026-06-03.md
TIER2-AND-FRAMECLAIM-BRIEF-PACK.md
VERB-EXPANSION-DISPATCH-PACK.md
wave-1-evidence-spine-briefs-2026-06-12.md docs(handoff): commit Wave 1 + Wave R2 brief packs incl. part 2 (R2-S/Runs/Packs/Vault/Settings) 2026-06-12 16:34:53 -07:00
WAVE-NEXT-REVISED.md
wave-R-mastery-briefs-2026-06-12.md docs(workbench): R0a CI path filter includes the workflow file itself 2026-06-12 10:29:29 -07:00
wave-R2-backend-brief-2026-06-12.md docs(handoff): commit Wave 1 + Wave R2 brief packs incl. part 2 (R2-S/Runs/Packs/Vault/Settings) 2026-06-12 16:34:53 -07:00
wave-R2-route-briefs-2026-06-12.md docs(handoff): commit Wave 1 + Wave R2 brief packs incl. part 2 (R2-S/Runs/Packs/Vault/Settings) 2026-06-12 16:34:53 -07:00
wave-R2-route-briefs-part2-2026-06-12.md docs(handoff): commit Wave 1 + Wave R2 brief packs incl. part 2 (R2-S/Runs/Packs/Vault/Settings) 2026-06-12 16:34:53 -07:00
wave-R3-briefs-2026-06-13.md feat(workbench): the Replay Moment — turn-keyed hero + retire W-026 artifact replay (Wave R3) 2026-06-12 22:07:34 -07:00
WORKBENCH-UI-WAVE-BRIEF-PACK.md
WORKBENCH-UI-WAVE-SCOPING.md
WORKBENCH-W3-RATIFICATION-CORRIDOR-BRIEF.md