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/snapshotScheduler.js

@@ -55,6 +55,9 @@ function startSnapshotScheduler(opts = {}) {
   // real (now-completed) results BEFORE grading the fresh slate, so the accuracy
   // record reflects yesterday's games each cycle.
   const settleAll = opts.settleAllOutcomes || require('./services/outcomeService').settleAllOutcomes;
+  // Session 58 — Phase 1 truth infrastructure: settle the persistent ledger
+  // (outcome + actual + CLV) in the same pre-grade settle pass.
+  const settleLedgers = opts.settleAllLedgers || require('./services/ledgerService').settleAllLedgers;
   const notify = opts.notify || require('./utils/opsNotify').notify;
   const cacheGet = opts.cacheGet || require('./utils/redis').cacheGet;
   const now = opts.now || (() => new Date());
@@ -96,6 +99,13 @@ function startSnapshotScheduler(opts = {}) {
     } catch (e) {
       console.warn('[outcomes] settle run failed:', e.message);
     }
+    try {
+      const ledger = await settleLedgers();
+      const n = ledger.reduce((t, r) => t + (r.settled || 0), 0);
+      console.log(`[ledger] settle pass — ${n} entries settled (outcome + CLV)`);
+    } catch (e) {
+      console.warn('[ledger] settle run failed:', e.message);
+    }
     try {
       const results = await runAll();
       const ok = results.filter((r) => r.status === 'ok');