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>

src/services/snapshotService.js

@@ -188,6 +188,9 @@ async function runSnapshot(sport, opts = {}) {
     notify: opts.notify || require('../utils/opsNotify').notify,
     sleep: opts.sleep || ((ms) => new Promise((r) => setTimeout(r, ms))),
     retryDelayMs: opts.retryDelayMs != null ? opts.retryDelayMs : 60_000,
+    // Session 58 — Phase 1 truth infrastructure. ledger no-ops without
+    // SUPABASE env, so tests / local dev never touch a database.
+    ledger: opts.ledger || require('./ledgerService'),
   };
   const start = deps.nowMs();
   const ts = deps.now();
@@ -291,6 +294,20 @@ async function runSnapshot(sport, opts = {}) {
   const events = generateTickerEvents(sp, enriched, deltas, ts);
   await pushTickerItems(events, deps);
 
+  // Session 58 — Phase 1 truth infrastructure. (a) Upsert the public model
+  // record (user_id NULL, idempotent — re-runs never duplicate or overwrite
+  // the original lock). (b) Overwrite today's closing_line/odds from the
+  // CURRENT feed — the last capture before game start IS the closing line.
+  // Best-effort: the ledger must never break the snapshot.
+  let ledgerWritten = 0;
+  try {
+    const rec = await deps.ledger.recordPipelineGrades(sp, enriched, props, { now: deps.now });
+    ledgerWritten = rec.written || 0;
+    await deps.ledger.captureClosing(sp, props);
+  } catch (e) {
+    console.warn(`[snapshot] ledger write failed for ${sp}:`, e.message);
+  }
+
   // Session 56 — success alert, enriched with the rolling accuracy (if settled).
   let accPart = '';
   try {
@@ -307,6 +324,7 @@ async function runSnapshot(sport, opts = {}) {
     sport: sp,
     status: 'ok',
     gradeCount: enriched.length,
+    ledgerWritten,
     topGrades: enriched.filter((g) => isTopGrade(g.grade)).slice(0, 5).map((g) => ({
       player: g.player || g.player_name, stat: g.stat_type || g.stat, grade: g.grade, archetype: g.archetype,
     })),