agentwrangler 0.1.1-next.bca85ea → 0.1.1-next.bdce596

package/README.md

@@ -84,9 +84,11 @@ five hooks; **Copy install prompt** prepares instructions for three. Copying alo
 ## Privacy and limits
 
 - The daemon binds to **127.0.0.1**. There is no telemetry or hosted product backend.
-- SQLite contains aggregates and structural data, and can also contain local command text
-  and filesystem paths. Treat it as sensitive. The optional PreCompact hook makes separate
-  raw transcript copies on your machine.
+- SQLite contains aggregates and structural data, plus filesystem paths. Command rows keep
+  only `/compact`, `/clear`, or an unclassified marker — other commands and arguments are
+  discarded, though databases or backups from before the upgrade can still hold raw command
+  text (sanitation is logical, not physical erasure). Treat it as sensitive. The optional
+  PreCompact hook makes separate raw transcript copies on your machine.
 - Usage refresh can contact Anthropic using your existing Claude Code sign-in. GitHub
   outcomes sync requires a configured token. [Privacy details](https://github.com/Doogit/AgentWrangler/blob/main/docs/privacy.md).
 - Claude Code format changes can require parser updates. This is a single-user tool.

package/dist/daemon/http.js

@@ -27,53 +27,178 @@ import * as http from "node:http";
 import { isReady } from "./readiness.js";
 import { handleApiRequest } from "./router.js";
 import { createStaticHandler } from "./static.js";
-/** Inline loading page served while the daemon's initial back-scan is running. */
+/**
+ * Inline loading page served while the daemon's initial back-scan is running
+ * (BOOT-2, Option E): docked terminal panel streaming boot_scan_events on top,
+ * three live counters + a determinate progress bar below, fade into the app on
+ * ready (no white-flash hard reload). Self-contained by design — the SPA's
+ * assets are not servable pre-ready, so design-token VALUES are copied from
+ * src/ui/styles.css (dark theme) with that file as the source of truth.
+ * Falls back to the plain "Scanning transcripts — N of M files" line when the
+ * BOOT-1 fields are absent (older daemon mid-upgrade).
+ */
 const LOADING_HTML = `<!doctype html>
 <html lang="en">
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width,initial-scale=1">
+<meta name="color-scheme" content="dark">
 <title>AgentWrangler — Starting up</title>
 <style>
+/* Token values copied from src/ui/styles.css (dark theme) — keep in sync. */
+:root{
+  --bg:#0b0f1a;--panel:#111827;--panel2:#1a2233;--line:rgba(255,255,255,.07);
+  --text:#e2e8f0;--text2:#94a3b8;--muted:#9aa9bd;
+  --cyan:#22d3ee;--violet:#a78bfa;--green:#34d399;
+  --sans:system-ui,-apple-system,"Segoe UI",sans-serif;
+  --mono:ui-monospace,Consolas,Menlo,monospace;
+}
 *{box-sizing:border-box;margin:0;padding:0}
-body{background:#0b0f17;color:#c9d1d9;font-family:system-ui,sans-serif;display:flex;align-items:center;justify-content:center;min-height:100vh;text-align:center}
-.wrap{padding:2rem}
-h1{font-size:1.5rem;font-weight:700;color:#f0f6fc;letter-spacing:.05em}
-h2{font-size:1rem;font-weight:400;color:#38bdf8;margin:.75rem 0 .5rem}
-p{font-size:.875rem;color:#8b949e;max-width:36ch;margin:0 auto 2rem}
-.spinner{width:40px;height:40px;border:3px solid #1e293b;border-top-color:#38bdf8;border-radius:50%;animation:spin 1s linear infinite;margin:0 auto}
-.count{font-variant-numeric:tabular-nums;color:#8b949e;font-size:.875rem;margin:1.25rem auto 0;min-height:1.2em}
-@keyframes spin{to{transform:rotate(360deg)}}
+html{background:var(--bg)}
+body{
+  background:var(--bg);
+  color:var(--text);font-family:var(--sans);min-height:100vh;
+  display:grid;place-content:center;gap:28px;padding:24px 0;
+}
+body.leaving .log,body.leaving .hero{opacity:0}
+.log,.hero{opacity:1;transition:opacity .4s ease}
+.log{
+  background:#0a0e16;margin:0 auto;width:min(480px,calc(100vw - 36px));
+  border:1px solid var(--line);border-radius:8px;overflow:hidden;
+  display:grid;grid-template-rows:26px 1fr;height:158px;
+}
+.log-head{
+  display:flex;align-items:center;gap:8px;padding:0 12px;
+  background:var(--panel);border-bottom:1px solid var(--line);
+  font-family:var(--mono);font-size:10px;color:var(--muted);
+  letter-spacing:.08em;text-transform:uppercase;
+}
+.log-head .dot{width:7px;height:7px;border-radius:50%;background:var(--green)}
+.log-body{
+  padding:8px 12px;font-family:var(--mono);font-size:10.5px;line-height:1.7;
+  color:var(--text2);overflow:hidden;display:flex;flex-direction:column;justify-content:flex-end;
+}
+.log-body .ln{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.log-body .ok{color:var(--green)}
+.log-body .hl{color:var(--cyan)}
+.hero{display:grid;place-content:center;gap:16px;text-align:center;padding:0 16px}
+.headline{font-size:15px;font-weight:600}
+.headline span{color:var(--cyan)}
+.counters{display:flex;gap:34px;justify-content:center;flex-wrap:wrap}
+.counter .cv{font-family:var(--mono);font-size:30px;font-weight:600;font-variant-numeric:tabular-nums;letter-spacing:-.01em}
+.counter:nth-child(1) .cv{color:var(--cyan)}
+.counter:nth-child(2) .cv{color:var(--violet)}
+.counter:nth-child(3) .cv{color:var(--green)}
+.counter .cl{font-size:10.5px;color:var(--muted);text-transform:uppercase;letter-spacing:.1em;margin-top:2px}
+.pbar{width:300px;max-width:80vw;height:6px;background:var(--panel2);border-radius:99px;overflow:hidden;margin:0 auto}
+.pbar i{display:block;height:100%;width:0;background:linear-gradient(90deg,var(--cyan),var(--violet));border-radius:99px;transition:width .25s ease-out}
+.status{font-family:var(--mono);font-size:11.5px;color:var(--muted);min-height:1.2em;font-variant-numeric:tabular-nums}
+@media (prefers-reduced-motion:reduce){
+  .log,.hero,.pbar i{transition:none}
+}
 </style>
 </head>
 <body>
-<div class="wrap">
-  <h1>AgentWrangler</h1>
-  <h2>Starting up…</h2>
-  <p>Scanning your Claude Code transcripts — this can take a few minutes on first run; later loads are instant.</p>
-  <div class="spinner"></div>
-  <p class="count" id="count" aria-live="polite"></p>
+<div class="log" id="log" hidden>
+  <div class="log-head"><span class="dot"></span>boot scan · <span id="rate">— files/s</span></div>
+  <div class="log-body" id="logbody"></div>
+</div>
+<div class="hero">
+  <div class="headline">Preparing your <span>Claude Code</span> data…</div>
+  <div class="counters">
+    <div class="counter"><div class="cv" id="c-files">0</div><div class="cl">files scanned</div></div>
+    <div class="counter"><div class="cv" id="c-sess">0</div><div class="cl">sessions found</div></div>
+    <div class="counter"><div class="cv" id="c-tok">0</div><div class="cl">tokens counted</div></div>
+  </div>
+  <div class="pbar"><i id="fill"></i></div>
+  <div class="status" id="status" aria-live="polite">Scanning transcript roots…</div>
 </div>
 <script>
-(function poll(){
-  fetch('/api/ready')
-    .then(function(r){return r.json();})
-    .then(function(d){
-      if(d.ready){location.reload();return;}
-      // Reuse the first-run onboarding counter so a large first scan shows live
-      // progress instead of a bare spinner. Cadence unchanged (1s).
-      fetch('/api/status')
-        .then(function(r){return r.json();})
-        .then(function(s){
-          if(s&&typeof s.files_seen==='number'&&s.files_seen>0){
-            document.getElementById('count').textContent=
-              'Scanning transcripts — '+s.files_parsed+' of '+s.files_seen+' files';
-          }
-        })
-        .catch(function(){})
-        .then(function(){setTimeout(poll,1000);});
-    })
-    .catch(function(){setTimeout(poll,1000);});
+(function(){
+  var reduced=false;
+  try{reduced=matchMedia('(prefers-reduced-motion: reduce)').matches;}catch(e){}
+  var lastSeq=0,prevFiles=null,prevT=null,rateEma=null,leaving=false;
+  function $(id){return document.getElementById(id);}
+  function fmt(n){return Number(n||0).toLocaleString('en-US');}
+  function fmtTok(n){
+    n=Number(n||0);
+    if(n>=1e9)return (n/1e9).toFixed(1)+'B';
+    if(n>=1e6)return (n/1e6).toFixed(1)+'M';
+    if(n>=1e3)return (n/1e3).toFixed(1)+'K';
+    return String(n);
+  }
+  function finish(){
+    if(leaving)return;
+    leaving=true;
+    // Fade out, then swap to the app behind the transition — no white flash.
+    document.body.className='leaving';
+    setTimeout(function(){location.reload();},reduced?0:450);
+  }
+  function renderLog(events){
+    var body=$('logbody');
+    for(var i=0;i<events.length;i++){
+      var ev=events[i];
+      if(!ev||typeof ev.seq!=='number'||ev.seq<=lastSeq)continue;
+      lastSeq=ev.seq;
+      var el=document.createElement('div');
+      el.className='ln'+(ev.kind==='stage'?' hl':ev.kind==='root'?' ok':'');
+      el.textContent=String(ev.text||'');
+      body.appendChild(el);
+      while(body.children.length>6)body.removeChild(body.firstChild);
+    }
+  }
+  function render(s){
+    if(!s)return;
+    var files=typeof s.files_parsed==='number'?s.files_parsed:0;
+    var seen=typeof s.files_seen==='number'?s.files_seen:0;
+    var hasBoot=Array.isArray(s.boot_scan_events);
+    // Progress denominator: discovery's up-front total. files_seen only counts
+    // files visited so far, which would pin a determinate bar at ~100%.
+    var total=hasBoot&&typeof s.boot_files_total==='number'&&s.boot_files_total>0?s.boot_files_total:seen;
+    $('c-files').textContent=fmt(files);
+    $('c-sess').textContent=fmt(typeof s.boot_sessions_found==='number'?s.boot_sessions_found:(s.sessions||0));
+    $('c-tok').textContent=hasBoot?fmtTok(s.boot_tokens_counted):'—';
+    var pct=total>0?Math.min(100,Math.round(100*files/total)):0;
+    $('fill').style.width=pct+'%';
+    // Client-side ETA from the parse-rate delta between polls (EMA-smoothed).
+    var now=Date.now();
+    if(prevFiles!==null&&now>prevT){
+      var r=(files-prevFiles)/((now-prevT)/1000);
+      if(r>0)rateEma=rateEma===null?r:(rateEma*0.7+r*0.3);
+    }
+    prevFiles=files;prevT=now;
+    if(hasBoot){
+      $('log').hidden=false;
+      renderLog(s.boot_scan_events);
+      var rr=typeof s.boot_files_per_sec==='number'?s.boot_files_per_sec:0;
+      $('rate').textContent=(rr>0?rr:'—')+' files/s';
+      if(total===0){
+        $('status').textContent='Scanning transcript roots…';
+      }else if(pct<100){
+        var eta=rateEma&&rateEma>0?Math.max(1,Math.round((total-files)/rateEma)):null;
+        $('status').textContent='Parsing sessions'+(eta!==null?' — '+eta+'s remaining':'…');
+      }else{
+        $('status').textContent='Opening your dashboard…';
+      }
+    }else if(seen>0){
+      // Fallback for an older daemon without BOOT-1 fields: keep the plain
+      // first-run counter line ("N of M files"), never a blank page.
+      $('status').textContent='Scanning transcripts — '+files+' of '+seen+' files';
+    }
+  }
+  (function poll(){
+    fetch('/api/ready')
+      .then(function(r){return r.json();})
+      .then(function(d){
+        if(d.ready){finish();return;}
+        fetch('/api/status')
+          .then(function(r){return r.json();})
+          .then(render)
+          .catch(function(){})
+          .then(function(){setTimeout(poll,1000);});
+      })
+      .catch(function(){setTimeout(poll,1000);});
+  })();
 })();
 </script>
 </body>
@@ -132,6 +257,14 @@ function requiresSessionToken(pathname) {
     if (pathname === "/api/recommendations/adopt" || pathname === "/api/recommendations/dismiss") {
         return true;
     }
+    if (pathname === "/api/recommendations/feedback")
+        return true;
+    if (pathname === "/api/recommendations/feedback/undo")
+        return true;
+    if (pathname === "/api/recommendations/goal")
+        return true;
+    if (pathname === "/api/recommendations/goal/reset")
+        return true;
     if (/^\/api\/recommendations\/[^/]+\/apply$/.test(pathname))
         return true;
     if (/^\/api\/recommendations\/[^/]+\/open-terminal$/.test(pathname))
@@ -140,6 +273,14 @@ function requiresSessionToken(pathname) {
         return true;
     if (/^\/api\/esf\/effects\/(track|stop|close|rollback|attest-rollback)$/.test(pathname))
         return true;
+    if (pathname === "/api/work-records" || pathname === "/api/work-records/ids")
+        return true;
+    if (/^\/api\/work-records\/[^/]+\/(edit|closeout|archive|reopen|sessions|contexts|delete)$/.test(pathname))
+        return true;
+    if (/^\/api\/work-records\/[^/]+\/(sessions|contexts)\/[^/]+\/detach$/.test(pathname))
+        return true;
+    if (pathname === "/api/work-records/allocations/recompute")
+        return true;
     return false;
 }
 /**

package/dist/daemon/index.js

@@ -23,6 +23,7 @@ import { configGet as bptConfigGet, calibrateBytesPerToken } from "../detector/c
 import { runContextProbe } from "../detector/context-probe.js";
 import { runDetectors } from "../detector/index.js";
 import { installHook, uninstallHook } from "../hook/install.js";
+import { getBootProgress, pushBootEvent } from "../ingest/boot-progress.js";
 import { collectSessionChurn } from "../ingest/churn-collector.js";
 import { runPostProbeHook, setPostIngestHook, setPostProbeHook } from "../ingest/detector-hook.js";
 import { Ingestor } from "../ingest/index.js";
@@ -38,6 +39,7 @@ import { getSettingsData, setHealthInstance, setRuntimeResetHook, } from "../que
 import { loadConfig } from "./config.js";
 import { runEffectMeasurementPass } from "./effect-pass.js";
 import { createServer } from "./http.js";
+import { createDaemonLifecycle } from "./lifecycle.js";
 import { createOutcomesPassRunner } from "./outcomes-pass.js";
 import { setReady, setScanRoots, setScanState } from "./readiness.js";
 const VERSION = "0.1.0";
@@ -171,10 +173,6 @@ runProbePass("boot");
 // The runner (src/daemon/outcomes-pass.ts) adds a hard 15-min per-pass deadline:
 // a hung pass can no longer wedge the poll cadence forever — the running flag
 // always clears and the next poll resumes.
-let outcomesTimer = null;
-let reportsTimer = null;
-let reportsRunning = false;
-let bptCalibrationTimer = null;
 const outcomesRunner = createOutcomesPassRunner({
     db,
     probe: () => runProbePass("poll"),
@@ -188,29 +186,31 @@ const outcomesRunner = createOutcomesPassRunner({
 function runOutcomesPass() {
     return outcomesRunner.run();
 }
+// R12 bytes→token calibration — best-effort, never crash the daemon.
+// Runs on boot (deferred) and weekly when: opt-in enabled AND ratio is absent
+// or older than 30 days. Mirrors the outcomes bootstrap pattern.
+const THIRTY_DAYS_MS = 30 * 24 * 60 * 60 * 1000;
+function runBptCalibrationIfStale() {
+    const enabled = bptConfigGet(db, "bytes_per_token_calibration_enabled");
+    if (enabled !== "true")
+        return;
+    const measuredAt = bptConfigGet(db, "bytes_per_token_measured_at");
+    if (measuredAt !== null && Date.now() - new Date(measuredAt).getTime() < THIRTY_DAYS_MS)
+        return;
+    calibrateBytesPerToken(db).catch((e) => {
+        console.error(`Bytes-per-token calibration failed (non-fatal): ${e instanceof Error ? e.message : String(e)}`);
+    });
+}
 // ── Deferred boot scan (runs AFTER the HTTP port is bound) ───────────────────
 // startTailBatched() performs a yielding initial back-scan (ingestAllKnown +
 // reconcile), then arms the tail/discovery timers. We do NOT
 // also call runBackscan — that would spin up a second Ingestor whose separate
 // Health instance is the one surfaced in Settings. One Ingestor, one Health.
 // Bounded: if ingestion fails to start, still serve the dashboard (degraded).
-let handle = null;
-// One-shot guard: runBootScan executes exactly once regardless of how many
-// requests or timers fire kickBootScan concurrently.
-let scanKicked = false;
-function kickBootScan() {
-    if (scanKicked)
-        return;
-    scanKicked = true;
-    // Use setImmediate so the triggering HTTP response flushes before boot work
-    // starts. The scan itself also yields between bounded batches.
-    setImmediate(() => {
-        runBootScan().catch((e) => {
-            console.error(`Boot scan failed: ${e instanceof Error ? e.message : String(e)}`);
-        });
-    });
-}
+// The one-shot kick guard, the daemon-owned intervals, and shutdown ordering
+// live in the lifecycle harness (src/daemon/lifecycle.ts).
 async function runBootScan() {
+    let handle = null;
     try {
         const scanRoots = getSettingsData(db).scan_roots;
         setScanRoots(scanRoots);
@@ -225,6 +225,7 @@ async function runBootScan() {
         setHealthInstance(ingestor.health);
         handle = await ingestor.startTailBatched();
         setScanState("complete");
+        pushBootEvent("stage", `parse complete — ${getBootProgress().boot_sessions_found} sessions found`);
         setRuntimeResetHook(() => ingestor.clearRuntimeState());
         console.log(`Ingestion: initial scan complete — health ${JSON.stringify(ingestor.healthSnapshot())}`);
     }
@@ -237,6 +238,7 @@ async function runBootScan() {
     // boot probe ran before any workspace existed and could only size the global sources.
     // Then re-evaluate detectors so D1 surfaces its per-source context recs on the first run
     // instead of waiting for the next 10-minute poll.
+    pushBootEvent("stage", "building aggregates…");
     runProbePass("post-scan");
     try {
         runDetectors(db, { now: new Date() });
@@ -246,6 +248,7 @@ async function runBootScan() {
     }
     // Signal readiness BEFORE the outcomes pass — outcomes is a slow ~97s I/O
     // pass that yields on `gh` subprocess I/O; the loading page must not wait on it.
+    pushBootEvent("stage", "ready — opening dashboard");
     setReady();
     // Outcomes bootstrap — deferred until after the back-scan so the event loop
     // is free and readGithubToken() execFile (10 s timeout) cannot be starved.
@@ -263,21 +266,8 @@ async function runBootScan() {
             console.error(`Self-churn collection failed (non-fatal): ${e instanceof Error ? e.message : String(e)}`);
         }
     });
-    // R12 bytes→token calibration — best-effort, never crash the daemon.
-    // Runs on boot (deferred) and weekly when: opt-in enabled AND ratio is absent
-    // or older than 30 days. Mirrors the outcomes bootstrap pattern.
-    const THIRTY_DAYS_MS = 30 * 24 * 60 * 60 * 1000;
-    function runBptCalibrationIfStale() {
-        const enabled = bptConfigGet(db, "bytes_per_token_calibration_enabled");
-        if (enabled !== "true")
-            return;
-        const measuredAt = bptConfigGet(db, "bytes_per_token_measured_at");
-        if (measuredAt !== null && Date.now() - new Date(measuredAt).getTime() < THIRTY_DAYS_MS)
-            return;
-        calibrateBytesPerToken(db).catch((e) => {
-            console.error(`Bytes-per-token calibration failed (non-fatal): ${e instanceof Error ? e.message : String(e)}`);
-        });
-    }
+    // Deferred boot calibration check (the weekly interval is armed by the
+    // lifecycle harness after this scan resolves).
     setImmediate(() => {
         try {
             runBptCalibrationIfStale();
@@ -286,42 +276,31 @@ async function runBootScan() {
             console.error(`Bytes-per-token calibration boot failed (non-fatal): ${e instanceof Error ? e.message : String(e)}`);
         }
     });
-    bptCalibrationTimer = setInterval(() => {
-        try {
-            runBptCalibrationIfStale();
-        }
-        catch (e) {
-            console.error(`Bytes-per-token calibration poll failed (non-fatal): ${e instanceof Error ? e.message : String(e)}`);
-        }
-    }, 7 * 24 * 60 * 60 * 1000);
-    // 10-minute poll — guarded by outcomesRunning to prevent overlap
-    outcomesTimer = setInterval(() => {
+    return handle;
+}
+// ── Lifecycle harness: boot-kick guard, daemon intervals, shutdown ordering ──
+// closeServer closes over `server` (declared below); shutdown only ever runs
+// after listen, so the reference is initialized by then.
+const lifecycle = createDaemonLifecycle({
+    bootScan: runBootScan,
+    calibrationTick: runBptCalibrationIfStale,
+    outcomesTick: () => {
         runOutcomesPass().catch((e) => {
             console.error(`Outcomes poll failed: ${e instanceof Error ? e.message : String(e)}`);
         });
-    }, 10 * 60 * 1000);
-    reportsTimer = setInterval(async () => {
-        if (reportsRunning)
-            return;
-        reportsRunning = true;
-        try {
-            await Promise.resolve(generateWeeklyReport(db, new Date()));
-        }
-        catch (e) {
-            console.error(`Weekly report poll failed: ${e instanceof Error ? e.message : String(e)}`);
-        }
-        finally {
-            reportsRunning = false;
-        }
-    }, 7 * 24 * 60 * 60 * 1000);
-}
+    },
+    reportsTick: () => generateWeeklyReport(db, new Date()),
+    closeServer: (onClosed) => server.close(onClosed),
+    closeDb: () => db.close(),
+    onClosed: () => process.exit(0),
+});
 // ── 4. Start HTTP server ──────────────────────────────────────────────────────
 // Bind the port BEFORE the back-scan so the loading page is delivered
 // immediately while the initial scan yields between file batches.
 // Generate a random in-memory session token for the CSRF token gate.
 // NEVER log it, NEVER persist it — it lives only in process memory.
 const sessionToken = randomUUID();
-const server = createServer(db, config.port, config.uiRoot, sessionToken, kickBootScan);
+const server = createServer(db, config.port, config.uiRoot, sessionToken, lifecycle.kickBootScan);
 server.listen(config.port, "127.0.0.1", () => {
     const url = `http://127.0.0.1:${config.port}`;
     console.log(`Listening on ${url}`);
@@ -334,7 +313,7 @@ server.listen(config.port, "127.0.0.1", () => {
     // Fallback: kick the back-scan after 3 s even if no browser request arrives
     // (headless mode, --no-open, CI). The one-shot guard in kickBootScan() makes
     // whichever trigger fires first the only one that runs the scan.
-    setTimeout(kickBootScan, 3000);
+    lifecycle.armBootFallback();
 });
 /** Open `url` in the system default browser (best-effort; never crashes the daemon). */
 function openBrowser(url) {
@@ -357,24 +336,8 @@ function openBrowser(url) {
 // ── Graceful shutdown ─────────────────────────────────────────────────────────
 process.on("SIGINT", () => {
     console.log("Shutting down…");
-    handle?.stop();
-    if (outcomesTimer !== null)
-        clearInterval(outcomesTimer);
-    if (reportsTimer !== null)
-        clearInterval(reportsTimer);
-    server.close(() => {
-        db.close();
-        process.exit(0);
-    });
+    lifecycle.shutdown();
 });
 process.on("SIGTERM", () => {
-    handle?.stop();
-    if (outcomesTimer !== null)
-        clearInterval(outcomesTimer);
-    if (reportsTimer !== null)
-        clearInterval(reportsTimer);
-    server.close(() => {
-        db.close();
-        process.exit(0);
-    });
+    lifecycle.shutdown();
 });

package/dist/daemon/lifecycle.js

@@ -0,0 +1,122 @@
+/**
+ * src/daemon/lifecycle.ts — daemon timer registration and graceful shutdown.
+ *
+ * Extracted from daemon/index.ts (PERF5) so the boot-kick guard, the three
+ * daemon-owned intervals (calibration / outcomes / weekly reports), and the
+ * shutdown ordering are deterministically unit-testable without booting the
+ * daemon. The signal handlers in index.ts stay thin: both call shutdown().
+ *
+ * Shutdown contract:
+ *   - idempotent — a second signal is a no-op
+ *   - clears the boot-fallback timeout so a shutdown during the 3 s window
+ *     cannot start a scan afterwards
+ *   - a pending boot-kick setImmediate checks the flag and never starts the
+ *     scan after shutdown
+ *   - when shutdown lands while the boot scan is still in flight, the timers
+ *     are never armed and the tail handle is stopped as soon as the scan
+ *     resolves (previously both leaked past db.close())
+ *   - stopping the tail does NOT drain a suspended tail pass; the Ingestor's
+ *     stopped flag makes it quit at the next file boundary (its contract)
+ */
+const WEEK_MS = 7 * 24 * 60 * 60 * 1000;
+export function createDaemonLifecycle(deps) {
+    const error = deps.error ?? ((msg) => console.error(msg));
+    const calibrationIntervalMs = deps.calibrationIntervalMs ?? WEEK_MS;
+    const outcomesIntervalMs = deps.outcomesIntervalMs ?? 10 * 60 * 1000;
+    const reportsIntervalMs = deps.reportsIntervalMs ?? WEEK_MS;
+    const bootFallbackMs = deps.bootFallbackMs ?? 3000;
+    let scanKicked = false;
+    let shutDown = false;
+    let handle = null;
+    let calibrationTimer = null;
+    let outcomesTimer = null;
+    let reportsTimer = null;
+    let fallbackTimer = null;
+    let reportsRunning = false;
+    function armTimers() {
+        calibrationTimer = setInterval(() => {
+            try {
+                deps.calibrationTick();
+            }
+            catch (e) {
+                error(`Bytes-per-token calibration poll failed (non-fatal): ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }, calibrationIntervalMs);
+        outcomesTimer = setInterval(() => {
+            try {
+                deps.outcomesTick();
+            }
+            catch (e) {
+                error(`Outcomes poll failed: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }, outcomesIntervalMs);
+        reportsTimer = setInterval(() => {
+            if (reportsRunning)
+                return;
+            reportsRunning = true;
+            Promise.resolve()
+                .then(() => deps.reportsTick())
+                .catch((e) => {
+                error(`Weekly report poll failed: ${e instanceof Error ? e.message : String(e)}`);
+            })
+                .finally(() => {
+                reportsRunning = false;
+            });
+        }, reportsIntervalMs);
+    }
+    function kickBootScan() {
+        if (scanKicked || shutDown)
+            return;
+        scanKicked = true;
+        // setImmediate so the triggering HTTP response flushes before boot work
+        // starts. The scan itself also yields between bounded batches.
+        setImmediate(() => {
+            if (shutDown)
+                return;
+            deps
+                .bootScan()
+                .then((h) => {
+                handle = h;
+                if (shutDown) {
+                    // Shutdown landed mid-scan: never arm timers; stop the tail now.
+                    handle?.stop();
+                    handle = null;
+                    return;
+                }
+                armTimers();
+            })
+                .catch((e) => {
+                error(`Boot scan failed: ${e instanceof Error ? e.message : String(e)}`);
+            });
+        });
+    }
+    function shutdown() {
+        if (shutDown)
+            return;
+        shutDown = true;
+        if (fallbackTimer !== null)
+            clearTimeout(fallbackTimer);
+        handle?.stop();
+        handle = null;
+        if (calibrationTimer !== null)
+            clearInterval(calibrationTimer);
+        if (outcomesTimer !== null)
+            clearInterval(outcomesTimer);
+        if (reportsTimer !== null)
+            clearInterval(reportsTimer);
+        deps.closeServer(() => {
+            deps.closeDb();
+            deps.onClosed?.();
+        });
+    }
+    return {
+        kickBootScan,
+        armBootFallback() {
+            fallbackTimer = setTimeout(kickBootScan, bootFallbackMs);
+        },
+        shutdown,
+        get isShutDown() {
+            return shutDown;
+        },
+    };
+}