Session 58: Phase 1 — Truth Infrastructure (2327 tests)

ledger_entries is live (migration 019 applied to prod, RLS + NULLS NOT
DISTINCT dedupe verified against the real database). Every grade now
persists, settles against the real result, and carries closing-line value.

- ledgerService: pipeline pre-grade upserts (public model record, user_id
  null, idempotent), closing capture on every snapshot (last write before
  game start = the close), settlement with SIGNED CLV (over = locked -
  closing; beat/faded/flat), 30d model aggregate with the hard n>=20 rule.
- Write paths: snapshotService -> ledger (priority path); Next /api/scan ->
  ledger for authenticated users only (anon never touches the public
  record). Refused reads write nothing and don't burn a scan.
- Honest refusal (work-order 1.5): no projection => insufficient_data,
  grade null, "INSUFFICIENT DATA - no read" UI. The web gradeAdapter no
  longer displays the line as the model projection (the audit's
  model==line / +0% edge degenerate); the card renders absent states.
  projectionFor is sport-aware (l5 -> l20 -> {stat}_per_90 -> xG).
- /ledger: MY READS | MODEL tabs; model header shows hit% + beat-close%
  only at n>=20, else RECORD BUILDING + live pending count. ModelRecord
  deferred-render strip on landing + player hero. CLV + outcome chips,
  revised_from_grade strikethrough (Phase 2.5 ready).
- SYNC (Task 5): thresholds vs SNAPSHOT_EXPECTED_INTERVAL (normal <1.5x,
  amber >=1.5x, STALE red >=3x) via /api/snapshot/summary.
- Phase 2.5 logged in specs/vyndr-roadmap.md (build after Phase 3).
- Data-semantics hardening: strict null-safe numeric parsing everywhere a
  market value is handled (Number(null)===0 would have fabricated lines).

Backend 2309 -> 2327 tests (201 suites), web build exit 0.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

specs/vyndr-roadmap.md

@@ -60,6 +60,35 @@ build-out target.
 
 Scope key: S ≈ ½ session, M ≈ 1 session, L ≈ 1–2 sessions.
 
+> NOTE (Session 58): the numbered plan above predates the overhaul work
+> order. The work order's phases (0 = kill the lies ✅ S57, 1 = truth
+> infrastructure ✅ S58, 2 = slate UX, 3 = mobile, **2.5 below**, 4 = scan/
+> parlay, 5 = records, 6 = landing/content) take sequencing priority; the
+> table's items slot in where they don't conflict.
+
+## Phase 2.5 — Intraday line refresh + directional movement (LOGGED Session 58)
+
+Authoritative scope from the Phase 1 GO prompt. **Build after Phase 3
+(mobile), before Phase 4.** During slate hours (~noon–midnight ET):
+
+- Lightweight ODDS-ONLY refresh every 15–30 min (no full re-grade run).
+  Recompute the signed delta per graded prop RELATIVE TO THE GRADED SIDE —
+  direction is the signal, not magnitude alone.
+- **Moved WITH the grade** (market chasing our number): PropRow badge
+  `STEAM ▲ +N`. Good for the record; entry edge compressed. No re-grade.
+- **Moved AGAINST the grade ≥ 1.0** (or odds-equivalent): auto re-grade THAT
+  PROP ONLY.
+  - Grade holds → badge `VALUE ▲ better entry` (better number, same read).
+  - Grade drops → update the grade with `revised_from_grade` set (column
+    already exists in `ledger_entries`) + a visible revision marker
+    (original grade struck through — the ledger UI already renders it).
+    Revisions are ALWAYS public — never silently regrade, per Ledger ethos.
+- All displayed lines remain real book values from the refresh — the
+  refresh CAPTURES market numbers, never computes them.
+- After ship: drop `SNAPSHOT_EXPECTED_INTERVAL` to the refresh cadence —
+  the HeartbeatBar SYNC badge (normal <1.5x · amber ≥1.5x · STALE ≥3x)
+  goes genuinely live with zero further UI changes.
+
 ---
 
 ## Stat-type coverage target (fully built)