instar 0.28.77 → 0.28.78

package/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-05-02T01:08:33.142Z",
-  "instarVersion": "0.28.77",
+  "generatedAt": "2026-05-02T05:23:38.389Z",
+  "instarVersion": "0.28.78",
   "entryCount": 187,
   "entries": {
     "hook:session-start": {
@@ -384,7 +384,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:agents": {
@@ -392,7 +392,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:backups": {
@@ -400,7 +400,7 @@
       "type": "route-group",
       "domain": "operations",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:git": {
@@ -408,7 +408,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:memory": {
@@ -416,7 +416,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:semantic": {
@@ -424,7 +424,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:status": {
@@ -432,7 +432,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:capabilities": {
@@ -440,7 +440,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:project-map": {
@@ -448,7 +448,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:coherence": {
@@ -456,7 +456,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:topic-bindings": {
@@ -464,7 +464,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:context": {
@@ -472,7 +472,7 @@
       "type": "route-group",
       "domain": "context",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:scope-coherence": {
@@ -480,7 +480,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:canonical-state": {
@@ -488,7 +488,7 @@
       "type": "route-group",
       "domain": "state",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:ci": {
@@ -496,7 +496,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:sessions": {
@@ -504,7 +504,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:jobs": {
@@ -512,7 +512,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:skip-ledger": {
@@ -520,7 +520,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:telegram": {
@@ -528,7 +528,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:attention": {
@@ -536,7 +536,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:relationships": {
@@ -544,7 +544,7 @@
       "type": "route-group",
       "domain": "relationships",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:feedback": {
@@ -552,7 +552,7 @@
       "type": "route-group",
       "domain": "feedback",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:updates": {
@@ -560,7 +560,7 @@
       "type": "route-group",
       "domain": "updates",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:dispatches": {
@@ -568,7 +568,7 @@
       "type": "route-group",
       "domain": "dispatches",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:quota": {
@@ -576,7 +576,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:publishing": {
@@ -584,7 +584,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:private-views": {
@@ -592,7 +592,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:tunnel": {
@@ -600,7 +600,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:events": {
@@ -608,7 +608,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:evolution": {
@@ -616,7 +616,7 @@
       "type": "route-group",
       "domain": "evolution",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:watchdog": {
@@ -624,7 +624,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:topic-memory": {
@@ -632,7 +632,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:state-sync": {
@@ -640,7 +640,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:intent": {
@@ -648,7 +648,7 @@
       "type": "route-group",
       "domain": "intent",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:triage": {
@@ -656,7 +656,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:operations": {
@@ -664,7 +664,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:sentinel": {
@@ -672,7 +672,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:trust": {
@@ -680,7 +680,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:monitoring": {
@@ -688,7 +688,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:commitments": {
@@ -696,7 +696,7 @@
       "type": "route-group",
       "domain": "commitments",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:episodes": {
@@ -704,7 +704,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:messages": {
@@ -712,7 +712,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:system-reviews": {
@@ -720,7 +720,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "route-group:machine-mesh": {
@@ -736,7 +736,7 @@
       "type": "route-group",
       "domain": "security",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "674740fc474b7f7a63823a80418a84e14e298772bca3e9209e54d5d53467160e",
+      "contentHash": "2f75380a8bf19777fb1e44a1d80a728c7b0747ba06c266fcc4f5f3887afdd251",
       "since": "2025-01-01"
     },
     "cli:init": {
@@ -1408,7 +1408,7 @@
       "type": "subsystem",
       "domain": "server",
       "sourcePath": "src/server/AgentServer.ts",
-      "contentHash": "04480cb37014c2b3791a8135eb14102b9755e7ac4ce5466fc8fb9725477726c7",
+      "contentHash": "699f34ca3364384b00a722407aa728d529dc869c2c4947200fed5753a3b52a3e",
       "since": "2025-01-01"
     },
     "subsystem:session-manager": {

package/upgrades/0.28.78.md

@@ -0,0 +1,90 @@
+# Upgrade Guide — vNEXT
+
+<!-- bump: patch -->
+
+## What Changed
+
+The Token Ledger (shipped in v0.28.77 as Phase 1 read-only token-usage
+observability) had an unbounded synchronous first scan. On agents with
+deep Claude Code history this blocked the Node event loop for minutes —
+one local agent had 119,130 JSONL transcripts totaling 12 GB, and on
+boot the server stopped responding to its own `/health` endpoint, which
+caused the lifeline supervisor to declare the agent dead and restart it
+in a loop.
+
+This release bounds the scan in three independent ways:
+
+1. **Per-tick file cap** (default 500) with a persistent in-memory
+   cursor across ticks. The first poll backfills 500 files; the next
+   poll picks up where the previous one stopped; once the tree is fully
+   walked the cursor wraps back to the start so newly-written sessions
+   are still picked up.
+2. **Intra-tick yielding** (default every 25 files) via `setImmediate`.
+   Even within a single tick the event loop gets to drain HTTP and
+   health-check traffic — the server stays responsive while the ledger
+   is doing its work.
+3. **Optional max file age** (default 30 days at the wiring layer). The
+   ledger ignores transcripts whose mtime is older than the backfill
+   window. Active sessions are never blackholed: appending a new turn
+   updates the file's mtime, which brings it back into the window. The
+   source JSONLs in `~/.claude/projects/` remain the ground truth, so an
+   operator can widen the window later by passing a larger
+   `maxFileAgeMs` and the ledger will pick up the older data on the
+   next scan.
+
+A new `scanAllAsync()` method is the path the poller now uses; the
+original `scanAll()` sync entry point is preserved for tests and any
+caller that doesn't need yielding (and now honors the per-tick cap and
+age cutoff too).
+
+No schema migration. No new routes. No new external surfaces. Pure
+containment fix for the v0.28.77 regression.
+
+## What to Tell Your User
+
+- **Quieter, more reliable startup with the new Tokens tab**: I no
+  longer get stuck staring at years of old session transcripts on boot.
+  When I start up, I look at the most recent month of activity first,
+  in small batches, and I keep answering you in between batches. The
+  Tokens tab will fill in over the first few minutes instead of being
+  empty until everything has been read at once.
+
+## Summary of New Capabilities
+
+| Capability | How to Use |
+|-----------|-----------|
+| Bounded first-boot scan of the token ledger | Automatic on upgrade |
+| Configurable backfill window for the token ledger | Pass `maxFileAgeMs` to TokenLedger constructor (defaults to 30 days at the wiring layer) |
+| Per-tick scan cap and event-loop yielding | Automatic on upgrade |
+
+## Evidence
+
+Reproduction (before fix):
+
+1. Start v0.28.77 on a host with deep Claude Code history (the local
+   reproduction host had 119,130 JSONL files / 12 GB under
+   `~/.claude/projects/`).
+2. `curl -m 5 http://localhost:4042/health` hangs — connection accepted
+   but no response within timeout.
+3. `sample <pid> 1` shows the main thread spending 100% of its time in
+   `uv_fs_stat` callbacks under
+   `Builtins_InterpreterEntryTrampoline` — a JS loop hammering the
+   filesystem with no event-loop yields.
+4. The lifeline supervisor's health probe times out, declares the
+   server unhealthy, and restarts it. The next boot starts the same
+   scan over again.
+
+After fix:
+
+1. Same host, same `~/.claude/projects/` tree. Server boots and
+   `curl http://localhost:4042/health` returns a normal JSON response
+   within a few hundred ms.
+2. `curl http://localhost:4042/tokens/summary` returns valid JSON
+   immediately (initially with a small subset of recent sessions).
+   Subsequent ticks fill in the rest of the 30-day window.
+3. The lifeline supervisor sees a healthy server and stops restarting.
+
+Unit tests: `tests/unit/token-ledger.test.ts` — 15/15 passing locally
+on the `fix/token-ledger-bounded-scan` branch. Three new tests cover
+the cursor resume, age cutoff, and async yielding behavior. Typecheck
+clean (`npx tsc --noEmit`).