@winspan/claude-forge 8.54.4 → 9.12.0

package/dist/core/diagnostics/entropy-checks.js

@@ -0,0 +1,400 @@
+/**
+ * cf doctor — entropy checks (spec f3dc1397, decision 018a1269 Option B1/B2).
+ *
+ * Pure module mirroring the shape of `checks.ts` checkN_* functions. Each
+ * function returns a `CheckResult`. These are registered as doctor checks
+ * 10–12 in `checks.ts` so they automatically surface in `cf doctor`,
+ * `cf doctor --json`, and the Web `/api/diagnostics` + DiagnosticsPage table
+ * (both consume `runDoctorReport`). No new DB table, no daemon scheduling, no
+ * frontend change.
+ *
+ * Entropy = accumulated-but-uncleaned state that doctor surfaces as `warn`
+ * (never `fail`), so it never trips `Doctor: FAIL`. Cleanup is always manual
+ * (see `fix_hint`) — entropy checks are deliberately NOT in `FIXABLE_COMMANDS`
+ * so `cf fix --apply` never auto-deletes decisions/specs (Risk 3).
+ *
+ * Static dead-code scanning (knip) lives OUT of doctor (see `cf entropy
+ * --static`): knip needs build artifacts, is slower, and has occasional false
+ * positives that would pollute the always-on doctor signal.
+ *
+ * @see docs/design/2026-06-02/2023-entropy-scanner-spec.md
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { FORGE_PATHS } from '../constants.js';
+import { DAY_MS } from '../utils/time.js';
+// ─── Thresholds (spec §Implementation plan;命名规范: 全大写常量) ─────────────
+/** A pending empty decision shell older than this (days) is reported. */
+export const STALE_DECISION_DAYS = 7;
+/** A *-spec.md older than this (days) with no changelog is reported. */
+export const STALE_SPEC_DAYS = 30;
+/**
+ * Orphan-event rate over this fraction (0..1) in the last 7d → warn. This is a
+ * regression sentinel for the orphan-event bug fixed this session: if the rate
+ * suddenly spikes, the orphan fix likely regressed.
+ */
+const ORPHAN_EVENT_WARN_RATE = 0.2;
+/**
+ * Count `kind='decision' AND status IN ('advisory','pending') AND options_json
+ * IS NULL` rows older than STALE_DECISION_DAYS. These are decision shells the
+ * decision-maker
+ * never filled in — stale clutter that `abandon-stale-decisions.mjs` (or
+ * `expireOldDecisions`) can clear. Report only; never auto-fix.
+ */
+export async function check10_staleDecisions(deps) {
+    const dbPath = deps?.dbPath ?? FORGE_PATHS.database();
+    const now = deps?.now ?? Date.now;
+    if (!fs.existsSync(dbPath)) {
+        return {
+            id: 10,
+            name: 'entropy-stale-decisions',
+            status: 'skip',
+            message: 'DB not present — no decisions to scan',
+        };
+    }
+    let DB;
+    try {
+        if (deps?.load) {
+            DB = await deps.load();
+        }
+        else {
+            const mod = await import('better-sqlite3');
+            DB = mod.default;
+        }
+    }
+    catch (err) {
+        return {
+            id: 10,
+            name: 'entropy-stale-decisions',
+            status: 'warn',
+            message: 'Could not load DB driver to scan decisions',
+            details: err instanceof Error ? err.message : String(err),
+            fixable_by: 'manual',
+        };
+    }
+    const cutoffIso = new Date(now() - STALE_DECISION_DAYS * DAY_MS).toISOString();
+    try {
+        const db = new DB(dbPath, { readonly: true });
+        try {
+            let n = 0;
+            try {
+                const stmt = db.prepare(
+                // decision 93e8fff1: advisory is the new mint default, so empty
+                // unfilled shells now carry status='advisory'; include both so the
+                // stale-shell entropy count stays accurate.
+                `SELECT COUNT(*) AS n FROM decisions
+             WHERE kind = 'decision'
+               AND status IN ('advisory','pending')
+               AND options_json IS NULL
+               AND created_at < ?`);
+                const row = stmt.get(cutoffIso);
+                n = row?.n ?? 0;
+            }
+            catch {
+                // Table missing on a fresh DB → treat as no entropy.
+                n = 0;
+            }
+            if (n === 0) {
+                return {
+                    id: 10,
+                    name: 'entropy-stale-decisions',
+                    status: 'pass',
+                    message: `No empty decision shells older than ${STALE_DECISION_DAYS}d`,
+                };
+            }
+            return {
+                id: 10,
+                name: 'entropy-stale-decisions',
+                status: 'warn',
+                message: `${n} empty decision shell(s) older than ${STALE_DECISION_DAYS}d`,
+                details: 'Pending decisions whose decision-maker never filled options_json — safe to abandon.',
+                fix_hint: 'node scripts/abandon-stale-decisions.mjs --apply',
+                fixable_by: 'manual',
+            };
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch (err) {
+        return {
+            id: 10,
+            name: 'entropy-stale-decisions',
+            status: 'warn',
+            message: 'Decision-shell scan failed',
+            details: err instanceof Error ? err.message : String(err),
+            fixable_by: 'manual',
+        };
+    }
+}
+/**
+ * Strip assorted timestamp/spec shapes off a basename so spec and changelog
+ * basenames match by stem. Mirrors `spec_stem()` in check-spec-changelog.sh.
+ */
+export function specStem(base) {
+    return base
+        .replace(/-spec-\d+-\d+$/, '')
+        .replace(/-\d{8}-\d{4}$/, '')
+        .replace(/^\d{4}-/, '')
+        .replace(/-spec$/, '');
+}
+function defaultListSpecs(designDir) {
+    const out = [];
+    if (!fs.existsSync(designDir))
+        return out;
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const full = path.join(dir, e.name);
+            if (e.isDirectory())
+                walk(full);
+            else if (e.isFile() && e.name.endsWith('-spec.md'))
+                out.push(full);
+        }
+    };
+    walk(designDir);
+    return out;
+}
+function defaultListChangelogs(implDir) {
+    const out = [];
+    if (!fs.existsSync(implDir))
+        return out;
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const full = path.join(dir, e.name);
+            if (e.isDirectory())
+                walk(full);
+            else if (e.isFile() && e.name.includes('changelog') && e.name.endsWith('.md')) {
+                out.push(e.name);
+            }
+        }
+    };
+    walk(implDir);
+    return out;
+}
+/**
+ * Scan docs/design/**\/*-spec.md; flag specs older than STALE_SPEC_DAYS that
+ * have no stem-matched changelog under docs/implementation. Mirrors the
+ * pairing logic of check-spec-changelog.sh, but scans historical backlog
+ * (CI gate only checks *changed* specs). Report-only; cleanup is manual.
+ *
+ * Age is derived from the spec path's `docs/design/YYYY-MM-DD/HHMM-` prefix
+ * when present, else from file mtime — no file-content reads (Risk 4: fast).
+ */
+export async function check11_staleSpecs(deps) {
+    const docsRoot = deps?.docsRoot ?? process.cwd();
+    const now = deps?.now ?? Date.now;
+    const designDir = path.join(docsRoot, 'docs', 'design');
+    const implDir = path.join(docsRoot, 'docs', 'implementation');
+    const listSpecs = deps?.listSpecs ?? defaultListSpecs;
+    const listChangelogs = deps?.listChangelogs ?? defaultListChangelogs;
+    let specs;
+    let changelogNames;
+    try {
+        specs = listSpecs(designDir);
+        changelogNames = listChangelogs(implDir);
+    }
+    catch (err) {
+        return {
+            id: 11,
+            name: 'entropy-stale-specs',
+            status: 'warn',
+            message: 'Spec scan failed',
+            details: err instanceof Error ? err.message : String(err),
+            fixable_by: 'manual',
+        };
+    }
+    if (specs.length === 0) {
+        return {
+            id: 11,
+            name: 'entropy-stale-specs',
+            status: 'pass',
+            message: 'No specs under docs/design',
+        };
+    }
+    // Mirror check-spec-changelog.sh `*${prefix}*changelog*` glob: a spec is
+    // paired iff SOME changelog basename CONTAINS the spec's stem. One-directional
+    // (changelog ⊇ spec-stem) — matching the shell gate exactly; the reverse
+    // direction would over-pair short stems and silently under-report entropy.
+    const changelogBasenames = changelogNames.map((name) => path.basename(name, '.md'));
+    const cutoffMs = now() - STALE_SPEC_DAYS * DAY_MS;
+    const stale = [];
+    for (const specPath of specs) {
+        const base = path.basename(specPath, '.md');
+        const stem = specStem(base);
+        const hasChangelog = stem.length > 0 && changelogBasenames.some((cl) => cl.includes(stem));
+        if (hasChangelog)
+            continue;
+        const ageMs = specAgeMs(specPath, now());
+        if (ageMs >= now() - cutoffMs) {
+            stale.push(path.relative(docsRoot, specPath));
+        }
+    }
+    if (stale.length === 0) {
+        return {
+            id: 11,
+            name: 'entropy-stale-specs',
+            status: 'pass',
+            message: `No stale specs (>${STALE_SPEC_DAYS}d, no changelog)`,
+        };
+    }
+    stale.sort();
+    const preview = stale.slice(0, 5).join('\n  ');
+    const more = stale.length > 5 ? `\n  …and ${stale.length - 5} more` : '';
+    return {
+        id: 11,
+        name: 'entropy-stale-specs',
+        status: 'warn',
+        message: `${stale.length} stale spec(s) (>${STALE_SPEC_DAYS}d, no changelog)`,
+        details: `  ${preview}${more}`,
+        fix_hint: 'Write a changelog under docs/implementation/ or rm the stale spec',
+        fixable_by: 'manual',
+    };
+}
+/**
+ * Derive a spec file's age in ms. Prefers the `YYYY-MM-DD/HHMM-` path prefix
+ * (cheap, deterministic, survives git checkout mtime churn); falls back to
+ * mtime. Returns age relative to `nowMs`.
+ */
+function specAgeMs(specPath, nowMs) {
+    const m = /(\d{4})-(\d{2})-(\d{2})[/\\](\d{2})(\d{2})-/.exec(specPath);
+    if (m) {
+        const [, y, mo, d, hh, mm] = m;
+        const t = Date.parse(`${y}-${mo}-${d}T${hh}:${mm}:00`);
+        if (!Number.isNaN(t))
+            return nowMs - t;
+    }
+    try {
+        return nowMs - fs.statSync(specPath).mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Cheap regression sentinel for the orphan-event bug fixed this session.
+ * Computes the fraction of `events` rows in the last 7d that have NO matching
+ * `task_events` row. A non-zero baseline is expected (UserPromptSubmit/Stop
+ * events legitimately aren't all attached to user tasks), so this is purely
+ * informational: only warns when the rate exceeds ORPHAN_EVENT_WARN_RATE,
+ * which would suggest the orphan fix regressed. Never fixable.
+ *
+ * Both counts are single COUNT(*) queries (indexed by event_id) → cheap.
+ */
+export async function check12_orphanEvents(deps) {
+    const dbPath = deps?.dbPath ?? FORGE_PATHS.database();
+    const now = deps?.now ?? Date.now;
+    if (!fs.existsSync(dbPath)) {
+        return {
+            id: 12,
+            name: 'entropy-orphan-events',
+            status: 'skip',
+            message: 'DB not present — no events to scan',
+        };
+    }
+    let DB;
+    try {
+        if (deps?.load) {
+            DB = await deps.load();
+        }
+        else {
+            const mod = await import('better-sqlite3');
+            DB = mod.default;
+        }
+    }
+    catch (err) {
+        return {
+            id: 12,
+            name: 'entropy-orphan-events',
+            status: 'warn',
+            message: 'Could not load DB driver to scan events',
+            details: err instanceof Error ? err.message : String(err),
+            fixable_by: 'manual',
+        };
+    }
+    const cutoffIso = new Date(now() - 7 * DAY_MS).toISOString();
+    try {
+        const db = new DB(dbPath, { readonly: true });
+        try {
+            let total = 0;
+            let orphans = 0;
+            try {
+                const totalRow = db
+                    .prepare(`SELECT COUNT(*) AS n FROM events WHERE timestamp >= ?`)
+                    .get(cutoffIso);
+                total = totalRow?.n ?? 0;
+                const orphanRow = db
+                    .prepare(`SELECT COUNT(*) AS n FROM events e
+               WHERE e.timestamp >= ?
+                 AND NOT EXISTS (
+                   SELECT 1 FROM task_events te WHERE te.event_id = e.event_id
+                 )`)
+                    .get(cutoffIso);
+                orphans = orphanRow?.n ?? 0;
+            }
+            catch {
+                // events / task_events table missing on a fresh DB.
+                return {
+                    id: 12,
+                    name: 'entropy-orphan-events',
+                    status: 'skip',
+                    message: 'events/task_events not present yet',
+                };
+            }
+            if (total === 0) {
+                return {
+                    id: 12,
+                    name: 'entropy-orphan-events',
+                    status: 'pass',
+                    message: 'No events in last 7d',
+                };
+            }
+            const rate = orphans / total;
+            const pct = (rate * 100).toFixed(1);
+            if (rate > ORPHAN_EVENT_WARN_RATE) {
+                return {
+                    id: 12,
+                    name: 'entropy-orphan-events',
+                    status: 'warn',
+                    message: `Orphan-event rate ${pct}% (${orphans}/${total}, last 7d) — orphan fix may have regressed`,
+                    details: `Threshold ${(ORPHAN_EVENT_WARN_RATE * 100).toFixed(0)}%. Events with no task_events link.`,
+                    fix_hint: 'Investigate task-segmenter / event-task linking',
+                    fixable_by: 'manual',
+                };
+            }
+            return {
+                id: 12,
+                name: 'entropy-orphan-events',
+                status: 'pass',
+                message: `Orphan-event rate ${pct}% (${orphans}/${total}, last 7d)`,
+            };
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch (err) {
+        return {
+            id: 12,
+            name: 'entropy-orphan-events',
+            status: 'warn',
+            message: 'Orphan-event scan failed',
+            details: err instanceof Error ? err.message : String(err),
+            fixable_by: 'manual',
+        };
+    }
+}
+//# sourceMappingURL=entropy-checks.js.map

package/dist/core/diagnostics/entropy-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entropy-checks.js","sourceRoot":"","sources":["../../../src/core/diagnostics/entropy-checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAQ1C,uEAAuE;AAEvE,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAUnC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAkB;IAC7D,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IAElC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,EAAE,EAAE,EAAE;YACN,IAAI,EAAE,yBAAyB;YAC/B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,uCAAuC;SACjD,CAAC;IACJ,CAAC;IAED,IAAI,EAAgB,CAAC;IACrB,IAAI,CAAC;QACH,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;YACf,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC3C,EAAE,GAAG,GAAG,CAAC,OAAkC,CAAC;QAC9C,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,EAAE;YACN,IAAI,EAAE,yBAAyB;YAC/B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,4CAA4C;YACrD,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,mBAAmB,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAE/E,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO;gBACrB,gEAAgE;gBAChE,mEAAmE;gBACnE,4CAA4C;gBAC5C;;;;kCAIwB,CACzB,CAAC;gBACF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAA8B,CAAC;gBAC7D,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,qDAAqD;gBACrD,CAAC,GAAG,CAAC,CAAC;YACR,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACZ,OAAO;oBACL,EAAE,EAAE,EAAE;oBACN,IAAI,EAAE,yBAAyB;oBAC/B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,uCAAuC,mBAAmB,GAAG;iBACvE,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,EAAE;gBACN,IAAI,EAAE,yBAAyB;gBAC/B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,GAAG,CAAC,uCAAuC,mBAAmB,GAAG;gBAC1E,OAAO,EACL,qFAAqF;gBACvF,QAAQ,EAAE,kDAAkD;gBAC5D,UAAU,EAAE,QAAQ;aACrB,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,EAAE;YACN,IAAI,EAAE,yBAAyB;YAC/B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,4BAA4B;YACrC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;AACH,CAAC;AAcD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI;SACR,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;SAC5B,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB;IACzC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1C,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,CAAC,WAAW,EAAE;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;iBAC3B,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,SAAS,CAAC,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAe;IAC5C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,CAAC;IACxC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,CAAC,WAAW,EAAE;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;iBAC3B,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9E,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,CAAC;IACd,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAkB;IACzD,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE9D,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,gBAAgB,CAAC;IACtD,MAAM,cAAc,GAAG,IAAI,EAAE,cAAc,IAAI,qBAAqB,CAAC;IAErE,IAAI,KAAe,CAAC;IACpB,IAAI,cAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QAC7B,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,EAAE;YACN,IAAI,EAAE,qBAAqB;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,kBAAkB;YAC3B,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,EAAE,EAAE,EAAE;YACN,IAAI,EAAE,qBAAqB;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,4BAA4B;SACtC,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,+EAA+E;IAC/E,yEAAyE;IACzE,2EAA2E;IAC3E,MAAM,kBAAkB,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAG,eAAe,GAAG,MAAM,CAAC;IAElD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3F,IAAI,YAAY;YAAE,SAAS;QAE3B,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QACzC,IAAI,KAAK,IAAI,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,EAAE,EAAE,EAAE;YACN,IAAI,EAAE,qBAAqB;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,oBAAoB,eAAe,kBAAkB;SAC/D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,EAAE,CAAC;IACb,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,OAAO;QACL,EAAE,EAAE,EAAE;QACN,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,oBAAoB,eAAe,kBAAkB;QAC7E,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,EAAE;QAC9B,QAAQ,EAAE,mEAAmE;QAC7E,UAAU,EAAE,QAAQ;KACrB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,QAAgB,EAAE,KAAa;IAChD,MAAM,CAAC,GAAG,6CAA6C,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvE,IAAI,CAAC,EAAE,CAAC;QACN,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC;QACH,OAAO,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAUD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAkB;IAC3D,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IAElC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,EAAE,EAAE,EAAE;YACN,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,oCAAoC;SAC9C,CAAC;IACJ,CAAC;IAED,IAAI,EAAgB,CAAC;IACrB,IAAI,CAAC;QACH,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;YACf,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC3C,EAAE,GAAG,GAAG,CAAC,OAAkC,CAAC;QAC9C,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,EAAE;YACN,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,yCAAyC;YAClD,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAE7D,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,EAAE;qBAChB,OAAO,CAAC,uDAAuD,CAAC;qBAChE,GAAG,CAAC,SAAS,CAA8B,CAAC;gBAC/C,KAAK,GAAG,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;gBACzB,MAAM,SAAS,GAAG,EAAE;qBACjB,OAAO,CACN;;;;mBAIO,CACR;qBACA,GAAG,CAAC,SAAS,CAA8B,CAAC;gBAC/C,OAAO,GAAG,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;gBACpD,OAAO;oBACL,EAAE,EAAE,EAAE;oBACN,IAAI,EAAE,uBAAuB;oBAC7B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,oCAAoC;iBAC9C,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,OAAO;oBACL,EAAE,EAAE,EAAE;oBACN,IAAI,EAAE,uBAAuB;oBAC7B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,sBAAsB;iBAChC,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,CAAC;YAC7B,MAAM,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,IAAI,GAAG,sBAAsB,EAAE,CAAC;gBAClC,OAAO;oBACL,EAAE,EAAE,EAAE;oBACN,IAAI,EAAE,uBAAuB;oBAC7B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,qBAAqB,GAAG,MAAM,OAAO,IAAI,KAAK,4CAA4C;oBACnG,OAAO,EAAE,aAAa,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,qCAAqC;oBACpG,QAAQ,EAAE,iDAAiD;oBAC3D,UAAU,EAAE,QAAQ;iBACrB,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,EAAE;gBACN,IAAI,EAAE,uBAAuB;gBAC7B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,qBAAqB,GAAG,MAAM,OAAO,IAAI,KAAK,YAAY;aACpE,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,EAAE;YACN,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,0BAA0B;YACnC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/diagnostics/fix-runner.d.ts

@@ -0,0 +1,54 @@
+/**
+ * cf fix — consume doctor report + run fix actions (spec 1a41b43a).
+ *
+ * Default mode: dry-run (print "Would run: <cmd>" without spawning).
+ * `--apply` mode: spawn subprocess for each fixable check.
+ *
+ * After all fixes apply, the runner re-runs the affected checks so the caller
+ * can show before/after state.
+ *
+ * @see docs/design/2026-06-01/1030-cf-doctor-diagnostic-spec.md
+ */
+import { type SpawnSyncReturns } from 'node:child_process';
+import { type CheckResult, type RunChecksOptions } from './checks.js';
+export interface FixPlanEntry {
+    check_id: number;
+    check_name: string;
+    command: string;
+    /** Pre-fix status (always non-pass for plan entries). */
+    before: CheckResult['status'];
+}
+export interface FixApplyOutcome {
+    check_id: number;
+    command: string;
+    ok: boolean;
+    exit_code: number | null;
+    stdout: string;
+    stderr: string;
+    /** Post-fix status after re-running the check (if available). */
+    after?: CheckResult['status'];
+    after_message?: string;
+}
+export interface RunFixOptions extends RunChecksOptions {
+    /** When false (default), do not spawn anything — just plan. */
+    apply?: boolean;
+    /** Restrict to a subset of check ids. */
+    checkIds?: number[];
+    /** Override subprocess runner for tests. */
+    runCommand?: (cmd: string) => SpawnSyncReturns<string>;
+    /** Override "re-run after fix" hook for tests. */
+    rerunChecks?: (ids: number[]) => Promise<CheckResult[]>;
+    /** Pre-supplied report (e.g. from a prior `runChecks()` call). */
+    preReport?: CheckResult[];
+    /** Per-fix subprocess timeout. Default 60s. */
+    timeoutMs?: number;
+}
+export interface RunFixResult {
+    plan: FixPlanEntry[];
+    applied: FixApplyOutcome[];
+    /** True when nothing matched the fixable filter. */
+    empty: boolean;
+}
+export declare function buildFixPlan(checks: CheckResult[], checkIds?: number[]): FixPlanEntry[];
+export declare function runFix(opts?: RunFixOptions): Promise<RunFixResult>;
+//# sourceMappingURL=fix-runner.d.ts.map

package/dist/core/diagnostics/fix-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-runner.d.ts","sourceRoot":"","sources":["../../../src/core/diagnostics/fix-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,KAAK,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACvD,kDAAkD;IAClD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,kEAAkE;IAClE,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;CAChB;AAaD,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAgBvF;AAED,wBAAsB,MAAM,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiD5E"}

package/dist/core/diagnostics/fix-runner.js

@@ -0,0 +1,90 @@
+/**
+ * cf fix — consume doctor report + run fix actions (spec 1a41b43a).
+ *
+ * Default mode: dry-run (print "Would run: <cmd>" without spawning).
+ * `--apply` mode: spawn subprocess for each fixable check.
+ *
+ * After all fixes apply, the runner re-runs the affected checks so the caller
+ * can show before/after state.
+ *
+ * @see docs/design/2026-06-01/1030-cf-doctor-diagnostic-spec.md
+ */
+import { spawnSync } from 'node:child_process';
+import { FIXABLE_COMMANDS, runChecks, } from './checks.js';
+function defaultRunCommand(cmd, timeoutMs) {
+    // We intentionally use the shell so command strings like
+    //   "cf daemon ensure-running"
+    // can be expanded without us pre-parsing them.
+    return spawnSync(cmd, [], {
+        shell: true,
+        encoding: 'utf-8',
+        timeout: timeoutMs,
+    });
+}
+export function buildFixPlan(checks, checkIds) {
+    const filterIds = checkIds && checkIds.length > 0 ? new Set(checkIds) : null;
+    const plan = [];
+    for (const c of checks) {
+        if (filterIds && !filterIds.has(c.id))
+            continue;
+        if (c.status === 'pass' || c.status === 'skip')
+            continue;
+        const command = FIXABLE_COMMANDS[c.id];
+        if (!command)
+            continue;
+        plan.push({
+            check_id: c.id,
+            check_name: c.name,
+            command,
+            before: c.status,
+        });
+    }
+    return plan;
+}
+export async function runFix(opts = {}) {
+    const apply = Boolean(opts.apply);
+    const timeoutMs = opts.timeoutMs ?? 60_000;
+    const runCommand = opts.runCommand ?? ((cmd) => defaultRunCommand(cmd, timeoutMs));
+    const initialReport = opts.preReport ?? (await runChecks(opts));
+    const plan = buildFixPlan(initialReport, opts.checkIds);
+    if (plan.length === 0) {
+        return { plan, applied: [], empty: true };
+    }
+    if (!apply) {
+        return { plan, applied: [], empty: false };
+    }
+    // Apply phase.
+    const applied = [];
+    for (const entry of plan) {
+        const res = runCommand(entry.command);
+        const exit_code = res.status ?? null;
+        const ok = res.status === 0 && !res.error;
+        applied.push({
+            check_id: entry.check_id,
+            command: entry.command,
+            ok,
+            exit_code,
+            stdout: (res.stdout ?? '').toString(),
+            stderr: res.error
+                ? `${res.error.message}\n${(res.stderr ?? '').toString()}`
+                : (res.stderr ?? '').toString(),
+        });
+    }
+    // Re-run affected checks for before/after parity.
+    const rerunIds = plan.map((p) => p.check_id);
+    const rerun = opts.rerunChecks
+        ? await opts.rerunChecks(rerunIds)
+        : await runChecks({ ...opts, ids: rerunIds });
+    const rerunMap = new Map();
+    for (const r of rerun)
+        rerunMap.set(r.id, r);
+    for (const outcome of applied) {
+        const post = rerunMap.get(outcome.check_id);
+        if (post) {
+            outcome.after = post.status;
+            outcome.after_message = post.message;
+        }
+    }
+    return { plan, applied, empty: false };
+}
+//# sourceMappingURL=fix-runner.js.map

package/dist/core/diagnostics/fix-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-runner.js","sourceRoot":"","sources":["../../../src/core/diagnostics/fix-runner.ts"],"names":[],"mappings":"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"}

package/dist/core/diagnostics/heartbeat-reader.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Daemon heartbeat READ side (decision ed98c8e8, 2026-06-10).
+ *
+ * Extracted from `src/daemon/services/heartbeat-writer.ts` to break the
+ * core→daemon reverse dependency: `core/diagnostics/daemon-status.ts` needs
+ * to read the heartbeat file, and core must never import from the daemon
+ * layer. The write side (`startHeartbeat`) stays in the daemon service;
+ * it re-exports these symbols for back-compat with existing callers.
+ *
+ * The heartbeat file is a small JSON written atomically (write tmp + rename)
+ * by the daemon to `~/.claude-forge/daemon.heartbeat`.
+ */
+export interface HeartbeatPayload {
+    pid: number;
+    ts: number;
+    started_at: number;
+    version: string;
+}
+/**
+ * Read the heartbeat file and return its payload, or null if absent / corrupt.
+ */
+export declare function readHeartbeat(heartbeatPath?: string): HeartbeatPayload | null;
+/**
+ * Return a human-readable age string for a heartbeat timestamp.
+ * e.g. "23s ago", "5m 12s ago", "no heartbeat"
+ */
+export declare function formatHeartbeatAge(ts: number | null | undefined): string;
+//# sourceMappingURL=heartbeat-reader.d.ts.map

package/dist/core/diagnostics/heartbeat-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-reader.d.ts","sourceRoot":"","sources":["../../../src/core/diagnostics/heartbeat-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAW7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CASxE"}

package/dist/core/diagnostics/heartbeat-reader.js

@@ -0,0 +1,50 @@
+/**
+ * Daemon heartbeat READ side (decision ed98c8e8, 2026-06-10).
+ *
+ * Extracted from `src/daemon/services/heartbeat-writer.ts` to break the
+ * core→daemon reverse dependency: `core/diagnostics/daemon-status.ts` needs
+ * to read the heartbeat file, and core must never import from the daemon
+ * layer. The write side (`startHeartbeat`) stays in the daemon service;
+ * it re-exports these symbols for back-compat with existing callers.
+ *
+ * The heartbeat file is a small JSON written atomically (write tmp + rename)
+ * by the daemon to `~/.claude-forge/daemon.heartbeat`.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { FORGE_PATHS } from '../constants.js';
+/**
+ * Read the heartbeat file and return its payload, or null if absent / corrupt.
+ */
+export function readHeartbeat(heartbeatPath) {
+    const p = heartbeatPath ?? FORGE_PATHS.daemonHeartbeat();
+    if (!existsSync(p))
+        return null;
+    try {
+        const raw = readFileSync(p, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.ts !== 'number')
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Return a human-readable age string for a heartbeat timestamp.
+ * e.g. "23s ago", "5m 12s ago", "no heartbeat"
+ */
+export function formatHeartbeatAge(ts) {
+    if (ts == null)
+        return 'no heartbeat';
+    const ageMs = Date.now() - ts;
+    if (ageMs < 0)
+        return 'just now';
+    const secs = Math.floor(ageMs / 1000);
+    if (secs < 60)
+        return `${secs}s ago`;
+    const mins = Math.floor(secs / 60);
+    const rem = secs % 60;
+    return `${mins}m ${rem}s ago`;
+}
+//# sourceMappingURL=heartbeat-reader.js.map

package/dist/core/diagnostics/heartbeat-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-reader.js","sourceRoot":"","sources":["../../../src/core/diagnostics/heartbeat-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAS9C;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,aAAsB;IAClD,MAAM,CAAC,GAAG,aAAa,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;QACnD,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC/C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAA6B;IAC9D,IAAI,EAAE,IAAI,IAAI;QAAE,OAAO,cAAc,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAC9B,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACtC,IAAI,IAAI,GAAG,EAAE;QAAE,OAAO,GAAG,IAAI,OAAO,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACtB,OAAO,GAAG,IAAI,KAAK,GAAG,OAAO,CAAC;AAChC,CAAC"}