@winspan/claude-forge 8.54.4 → 9.12.0

package/dist/daemon/services/feedback-aggregator.js

@@ -0,0 +1,415 @@
+/**
+ * FeedbackAggregator — Phase 8 of the master roadmap (master-roadmap-full-loop-
+ * 20260522-0200.md §2). Reads tool_intercepts /
+ * injections / skill_invocations / sessions rollup metrics and folds them into
+ * a single "tuning report" structure with three classes of suggestion:
+ *
+ *   • RuleTuningSuggestion   — too-noisy or never-firing tool_intercept rules
+ *   • SkillTuningSuggestion  — skills that match too rarely / always fail /
+ *                              never match (stale keywords)
+ *   • KbTuningSuggestion     — KB pages that never appear in injection
+ *                              metadata, or always appear with low scores
+ *
+ * Apply contract: this service NEVER edits CLAUDE.md / skill .md / KB .md
+ * files. Every `apply_action` is whitelisted in routes/insights.ts and only
+ * writes to the `forge_config` table (so users see suggestions in the Web UI
+ * and choose to flip a flag — fully reversible via `cf config set ...`).
+ *
+ * D7 thresholds (master roadmap §1):
+ *   • C4 intercept obeyed ratio    target >= 0.70
+ *   (C8 workflow adoption retired 2026-06-10 — decision fe6f98cd)
+ *
+ * Acceptance:
+ *   • `cf insights weekly` renders a markdown weekly report (see CLI)
+ *   • `GET /api/insights/tuning?window=7` returns suggestions + summary
+ *   • Feature flag `feedback_loop.enabled` (Phase 0) gates the endpoint —
+ *     this class never probes the flag itself; the route does.
+ */
+import { logger } from '../../core/utils/logger.js';
+import { formatError } from '../../core/utils/format.js';
+import { daysAgoIso, daysAgoMs } from '../../core/utils/time.js';
+// ─── Thresholds (D7 + sensible defaults) ──────────────────────────────────
+/** Master roadmap C4 target for intercept obedience. */
+export const C4_OBEYED_TARGET = 0.7;
+export const C4_RED_BELOW = 0.5;
+export const C4_GREEN_AT = 0.7;
+// Suggestion-emit thresholds — kept conservative for v1 so we don't drown
+// the UI in low-confidence noise. All exported so tests can drive them.
+export const RULE_NOISY_FIRES_PER_DAY = 5; // a rule firing > 5/day is "loud"
+export const RULE_OBEYED_RATIO_FLOOR = 0.3; // less than 30% obeyed → noisy
+export const RULE_OVERRIDE_FLOOR = 5; // ≥5 overrides → worth a card
+export const RULE_DEAD_FIRES_7D = 0; // never fired → suggest disable
+export const SKILL_ZERO_RESULT_THRESHOLD = 5; // ≥5 failed invocations → tag
+export const SKILL_LOW_SUCCESS_FLOOR = 0.5;
+export const KB_ARCHIVE_TARGET_CITES = 0; // page never cited in window → archive
+export const KB_LOW_SCORE_FLOOR = 10; // avg < 10 → suggest regenerate
+// ─── Helpers ──────────────────────────────────────────────────────────────
+function sinceIso(windowDays) {
+    return daysAgoIso(windowDays);
+}
+function sinceMs(windowDays) {
+    return daysAgoMs(windowDays);
+}
+function ratioBand(value, redBelow, greenAt) {
+    if (value < redBelow)
+        return 'red';
+    if (value >= greenAt)
+        return 'green';
+    return 'yellow';
+}
+// ─── Aggregator ───────────────────────────────────────────────────────────
+export class FeedbackAggregator {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    generateReport(opts = { windowDays: 7 }) {
+        const window = opts.windowDays === 30 ? 30 : 7;
+        const since = sinceIso(window);
+        const sinceMillis = sinceMs(window);
+        // decision 39839e30 (2026-06-13): optional per-project scope for the
+        // workplace KPIs (KB注入 / 听劝率 / 结果分布). Empty/undefined → all-projects
+        // (legacy behavior). Only the summary KPIs are scoped; the tuning
+        // suggestion lists stay global (they drive cross-project tuning advice).
+        const projectPath = opts.projectPath && opts.projectPath.trim() ? opts.projectPath.trim() : undefined;
+        let summary;
+        let suggestions = [];
+        try {
+            summary = this.computeSummary(since, sinceMillis, window, projectPath);
+        }
+        catch (err) {
+            logger.warn(`[FeedbackAggregator] summary failed: ${formatError(err)}`);
+            summary = this.emptySummary();
+        }
+        try {
+            suggestions = [
+                ...this.buildRuleSuggestions(since, window),
+                ...this.buildSkillSuggestions(sinceMillis, window),
+                ...this.buildKbSuggestions(since, window),
+            ];
+        }
+        catch (err) {
+            logger.warn(`[FeedbackAggregator] suggestion build failed: ${formatError(err)}`);
+        }
+        return {
+            generated_at: new Date().toISOString(),
+            window_days: window,
+            suggestions,
+            summary,
+        };
+    }
+    // ── Summary computation ────────────────────────────────────────────────
+    computeSummary(since, sinceMillis, window, projectPath) {
+        // F-medium #1 (2026-05-26): all raw SQL down-sunk to FeedbackOperations.
+        // Aggregator only orchestrates + applies business rules (band thresholds,
+        // metadata_json parsing for KB top pages).
+        // C4 intercept obeyed ratio. Numerator = obeyed; denominator = obeyed +
+        // override. `unknown` excluded. KPI relax: PostToolUseHandler back-fills
+        // outcome for BOTH `deny` and `dry_run` intercept rows so this ratio is
+        // meaningful even before pre_tool_intercept.enabled is flipped on.
+        const obeyedRow = this.storage.queryInterceptObeyedSummary(since, projectPath);
+        const interceptObeyed = obeyedRow.ratio;
+        // H4 contract — per-decision counts behind the obeyed ratio. See
+        // TuningReportSummary.intercept_{denied,dry_run,warn,bypass}.
+        const decisionCounts = this.storage.queryInterceptDecisionCounts(since);
+        // Top noisy intercept rules in window (by row count).
+        const ruleViolationsTop = this.storage.queryTopInterceptRuleViolations(since, 10);
+        // C1 KB inject count.
+        const kbInjectCount = this.storage.countKbInjections(since, projectPath);
+        // 「KB 调用」— genuine agent KB pulls in window (decision 64d37b1d). Window
+        // is the same N days; storage computes the ms cutoff internally (kb_query_log
+        // ts is INTEGER ms). project_path filter is on kb_query_log's own column.
+        const agentKbPullCount = this.storage.countAgentKbPulls({ windowDays: window, projectPath });
+        // KB top pages — parse metadata_json from KB injection rows. Done in JS to
+        // sidestep JSON1 portability (some sqlite builds don't have JSON1).
+        const kbPagesCounter = new Map();
+        const kbInjectionRows = this.storage.queryKbInjectionMetadata(since);
+        for (const row of kbInjectionRows) {
+            try {
+                const arr = JSON.parse(row.metadata_json);
+                if (Array.isArray(arr)) {
+                    for (const item of arr) {
+                        if (item && typeof item.name === 'string') {
+                            kbPagesCounter.set(item.name, (kbPagesCounter.get(item.name) ?? 0) + 1);
+                        }
+                    }
+                }
+            }
+            catch {
+                /* malformed metadata_json → skip */
+            }
+        }
+        const kbTopPages = Array.from(kbPagesCounter.entries())
+            .map(([name, cited]) => ({ name, cited }))
+            .sort((a, b) => b.cited - a.cited)
+            .slice(0, 10);
+        // Skill top — count by skill_id, with success rate.
+        const skillRows = this.storage.queryTopSkillInvocations(sinceMillis, 10);
+        const skillTop = skillRows.map((r) => ({
+            skill_id: r.skill_id,
+            n: r.n,
+            success_rate: r.sr ?? 0,
+        }));
+        // Session outcome distribution in window. classified_at is the canonical
+        // "when did outcome get written" timestamp.
+        const outcomeRows = this.storage.querySessionOutcomeDistribution(since, projectPath);
+        const outcome = { success: 0, partial: 0, failed: 0, abandoned: 0, unclassified: 0 };
+        for (const row of outcomeRows) {
+            if (row.o === 'success' || row.o === 'partial' || row.o === 'failed' || row.o === 'abandoned') {
+                outcome[row.o] = row.n;
+            }
+            else {
+                outcome.unclassified += row.n;
+            }
+        }
+        void window; // window is captured by caller; placeholder for future per-window deltas
+        return {
+            rule_violations_top: ruleViolationsTop,
+            intercept_obeyed_ratio: interceptObeyed,
+            intercept_obeyed_band: ratioBand(interceptObeyed, C4_RED_BELOW, C4_GREEN_AT),
+            kb_inject_count: kbInjectCount,
+            agent_kb_pull_count: agentKbPullCount,
+            kb_top_pages: kbTopPages,
+            skill_top: skillTop,
+            session_outcome: outcome,
+            intercept_denied: decisionCounts.denied,
+            intercept_dry_run: decisionCounts.dry_run,
+            intercept_warn: decisionCounts.warn,
+            intercept_bypass: decisionCounts.bypass,
+        };
+    }
+    emptySummary() {
+        return {
+            rule_violations_top: [],
+            intercept_obeyed_ratio: 0,
+            intercept_obeyed_band: 'red',
+            kb_inject_count: 0,
+            agent_kb_pull_count: 0,
+            kb_top_pages: [],
+            skill_top: [],
+            session_outcome: { success: 0, partial: 0, failed: 0, abandoned: 0, unclassified: 0 },
+            // H4 contract — emptySummary is the catch-block fallback when aggregation
+            // itself throws. Distinguished from "true zero" (returned by SQL on
+            // empty tool_intercepts) by using null. Callers (curl/jq) can tell apart
+            // "no data observed" vs "computation failed".
+            intercept_denied: null,
+            intercept_dry_run: null,
+            intercept_warn: null,
+            intercept_bypass: null,
+        };
+    }
+    // ── Rule suggestions (tool_intercepts) ─────────────────────────────────
+    buildRuleSuggestions(since, windowDays) {
+        const out = [];
+        // tool_intercept rules grouped by rule_id — per-rule fire count / obeyed / override.
+        const interceptRows = this.storage.queryInterceptRuleAggregates(since);
+        for (const row of interceptRows) {
+            const firesPerDay = row.fires / Math.max(1, windowDays);
+            const decided = row.obeyed + row.overrides;
+            const obeyedRatio = decided > 0 ? row.obeyed / decided : 0;
+            // Noisy + low obey → propose disabling / loosening.
+            if (firesPerDay >= RULE_NOISY_FIRES_PER_DAY && obeyedRatio < RULE_OBEYED_RATIO_FLOOR) {
+                out.push({
+                    kind: 'rule_tuning',
+                    rule_id: row.rule_id,
+                    rule_kind: 'tool_intercept',
+                    metric: {
+                        fires_per_day: round(firesPerDay, 2),
+                        obeyed_ratio: round(obeyedRatio, 2),
+                        override_count_7d: row.overrides,
+                        fires_7d: row.fires,
+                    },
+                    suggestion: `Rule "${row.rule_id}" fires ${row.fires} time(s) in the window (${round(firesPerDay, 1)}/day) ` +
+                        `but only ${Math.round(obeyedRatio * 100)}% are obeyed. Consider loosening or disabling.`,
+                    apply_action: {
+                        type: 'loosen_threshold',
+                        payload: { rule_id: row.rule_id, rule_kind: 'tool_intercept' },
+                    },
+                });
+                continue;
+            }
+            // Many overrides relative to total → worth surfacing even if obey ratio
+            // is OK; user is regularly bypassing.
+            if (row.overrides >= RULE_OVERRIDE_FLOOR && row.overrides > row.obeyed) {
+                out.push({
+                    kind: 'rule_tuning',
+                    rule_id: row.rule_id,
+                    rule_kind: 'tool_intercept',
+                    metric: {
+                        fires_per_day: round(firesPerDay, 2),
+                        obeyed_ratio: round(obeyedRatio, 2),
+                        override_count_7d: row.overrides,
+                        fires_7d: row.fires,
+                    },
+                    suggestion: `Rule "${row.rule_id}" has ${row.overrides} overrides vs ${row.obeyed} obeyed. ` +
+                        `Users routinely bypass — consider loosening or disabling.`,
+                    apply_action: {
+                        type: 'loosen_threshold',
+                        payload: { rule_id: row.rule_id, rule_kind: 'tool_intercept' },
+                    },
+                });
+            }
+        }
+        return out;
+    }
+    // ── Skill suggestions ──────────────────────────────────────────────────
+    buildSkillSuggestions(sinceMillis, windowDays) {
+        const out = [];
+        const rows = this.storage.querySkillAggregates(sinceMillis);
+        for (const row of rows) {
+            const successRate = row.n > 0 ? row.succ / row.n : 0;
+            const zeroRate = row.n > 0 ? row.zero / row.n : 0;
+            const matchedPerDay = row.n / Math.max(1, windowDays);
+            if (row.zero >= SKILL_ZERO_RESULT_THRESHOLD && successRate < SKILL_LOW_SUCCESS_FLOOR) {
+                out.push({
+                    kind: 'skill_tuning',
+                    skill_id: row.skill_id,
+                    metric: {
+                        matched_per_day: round(matchedPerDay, 2),
+                        success_rate: round(successRate, 2),
+                        zero_result_rate: round(zeroRate, 2),
+                        invocations_7d: row.n,
+                    },
+                    suggestion: `Skill "${row.skill_id}" has ${row.zero} failed invocations out of ${row.n} ` +
+                        `(${Math.round(zeroRate * 100)}% failure rate). Review keywords or disable.`,
+                    apply_action: {
+                        type: 'update_keywords',
+                        payload: { skill_id: row.skill_id },
+                    },
+                });
+            }
+        }
+        return out;
+    }
+    // ── KB suggestions ─────────────────────────────────────────────────────
+    buildKbSuggestions(since, windowDays) {
+        const out = [];
+        // Aggregate cite count + score sum + top-2 count per page from
+        // injections.metadata_json. metadata is JSON array of {name, score, refs}.
+        const rows = this.storage.queryKbInjectionMetadata(since);
+        const map = new Map();
+        for (const row of rows) {
+            try {
+                const arr = JSON.parse(row.metadata_json);
+                if (!Array.isArray(arr))
+                    continue;
+                arr.forEach((item, idx) => {
+                    if (!item || typeof item.name !== 'string')
+                        return;
+                    const cur = map.get(item.name) ?? { cited: 0, scoreSum: 0, inTop2: 0 };
+                    cur.cited += 1;
+                    cur.scoreSum += typeof item.score === 'number' ? item.score : 0;
+                    if (idx < 2)
+                        cur.inTop2 += 1;
+                    map.set(item.name, cur);
+                });
+            }
+            catch {
+                /* skip malformed */
+            }
+        }
+        for (const [name, acc] of map.entries()) {
+            const avgScore = acc.cited > 0 ? acc.scoreSum / acc.cited : 0;
+            const citedPerDay = acc.cited / Math.max(1, windowDays);
+            // Page cited but always low score → suggest regenerate (probably stale).
+            if (acc.cited >= 3 && avgScore < KB_LOW_SCORE_FLOOR) {
+                out.push({
+                    kind: 'kb_tuning',
+                    page_name: name,
+                    metric: {
+                        cited_per_day: round(citedPerDay, 2),
+                        avg_score: round(avgScore, 1),
+                        in_top_2_count_7d: acc.inTop2,
+                        cited_7d: acc.cited,
+                    },
+                    suggestion: `KB page "${name}" cited ${acc.cited} time(s) but avg score is ${round(avgScore, 1)} ` +
+                        `(below ${KB_LOW_SCORE_FLOOR}). Run \`cf knowledge build --apply --module=<name>\` to refresh.`,
+                    apply_action: {
+                        type: 'regenerate_module',
+                        payload: { page_name: name },
+                    },
+                });
+            }
+        }
+        // Pages that are NEVER cited in window → suggest archive. We only know
+        // about pages that DID get cited (from metadata_json), so "never cited"
+        // is computed against a caller-supplied list. v1: skip this — it would
+        // require walking .forge-knowledge/, which the daemon does not own.
+        return out;
+    }
+}
+function round(n, digits) {
+    const m = Math.pow(10, digits);
+    return Math.round(n * m) / m;
+}
+// ─── Markdown rendering (CLI weekly report) ───────────────────────────────
+/**
+ * Render a TuningReport as a markdown document. Used by `cf insights weekly`.
+ * Kept here (not in CLI) so the same renderer can power email digests later.
+ */
+export function renderReportMarkdown(report) {
+    const lines = [];
+    lines.push(`# Forge tuning report (${report.window_days}d window)`);
+    lines.push('');
+    lines.push(`Generated at: ${report.generated_at}`);
+    lines.push('');
+    lines.push(`## KPIs`);
+    lines.push('');
+    lines.push(`- **C4 intercept obeyed**: ${pct(report.summary.intercept_obeyed_ratio)} ` +
+        `(${band(report.summary.intercept_obeyed_band)}, target ${pct(C4_OBEYED_TARGET)})`);
+    lines.push(`- **C1 KB injections**: ${report.summary.kb_inject_count}`);
+    const outcome = report.summary.session_outcome;
+    lines.push(`- **Session outcome**: ${outcome.success} success / ${outcome.partial} partial / ` +
+        `${outcome.failed} failed / ${outcome.abandoned} abandoned / ${outcome.unclassified} unclassified`);
+    lines.push('');
+    if (report.summary.rule_violations_top.length > 0) {
+        lines.push(`## Top intercept rules (by fire count)`);
+        lines.push('');
+        for (const r of report.summary.rule_violations_top) {
+            lines.push(`- \`${r.rule_id}\` — ${r.n} fires`);
+        }
+        lines.push('');
+    }
+    if (report.summary.kb_top_pages.length > 0) {
+        lines.push(`## Top cited KB pages`);
+        lines.push('');
+        for (const p of report.summary.kb_top_pages) {
+            lines.push(`- \`${p.name}\` — cited ${p.cited}x`);
+        }
+        lines.push('');
+    }
+    if (report.summary.skill_top.length > 0) {
+        lines.push(`## Top skill invocations`);
+        lines.push('');
+        for (const s of report.summary.skill_top) {
+            lines.push(`- \`${s.skill_id}\` — ${s.n} invocations, ${pct(s.success_rate)} success`);
+        }
+        lines.push('');
+    }
+    lines.push(`## Suggestions (${report.suggestions.length})`);
+    lines.push('');
+    if (report.suggestions.length === 0) {
+        lines.push('_No tuning suggestions — system in balance._');
+    }
+    else {
+        for (const s of report.suggestions) {
+            const id = s.kind === 'rule_tuning' ? s.rule_id : s.kind === 'skill_tuning' ? s.skill_id : s.page_name;
+            lines.push(`### [${s.kind}] ${id}`);
+            lines.push('');
+            lines.push(s.suggestion);
+            if (s.apply_action) {
+                lines.push('');
+                lines.push(`Suggested action: \`${s.apply_action.type}\` — ${JSON.stringify(s.apply_action.payload)}`);
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+function pct(n) {
+    return `${Math.round(n * 100)}%`;
+}
+function band(b) {
+    return b === 'green' ? 'green' : b === 'yellow' ? 'yellow' : 'red';
+}
+//# sourceMappingURL=feedback-aggregator.js.map

package/dist/daemon/services/feedback-aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-aggregator.js","sourceRoot":"","sources":["../../../src/daemon/services/feedback-aggregator.ts"],"names":[],"mappings":"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"}

package/dist/daemon/services/heartbeat-writer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Daemon heartbeat writer.
+ *
+ * Writes a small JSON file to ~/.claude-forge/daemon.heartbeat every
+ * HEARTBEAT_INTERVAL_MS (60s default).  The file is updated with an atomic
+ * rename so readers never see a partial write.
+ *
+ * Consumers:
+ *   - `cf daemon status` — reads the file to display "Last seen Xs ago"
+ *   - `cf daemon ensure-running` — compares `ts` to HEARTBEAT_STALE_MS (3min)
+ *   - Web `/api/health` — surfaces heartbeat_age_ms to the frontend badge
+ *
+ * Design notes:
+ *   - Uses fs.renameSync (POSIX atomic) to avoid torn reads.
+ *   - On graceful shutdown, the heartbeat file is removed so
+ *     `cf daemon ensure-running` treats the daemon as not running.
+ *   - On macOS sleep/wake, all setInterval callbacks fire immediately after
+ *     the machine wakes.  The first catch-up tick refreshes the heartbeat
+ *     within seconds of wake-up, which is the desired behaviour.
+ */
+/**
+ * Read side moved to `core/diagnostics/heartbeat-reader.ts` (decision
+ * ed98c8e8) so core never imports from the daemon layer. Re-exported here
+ * for back-compat with existing CLI / test callers.
+ */
+export { readHeartbeat, formatHeartbeatAge, type HeartbeatPayload, } from '../../core/diagnostics/heartbeat-reader.js';
+export interface HeartbeatOptions {
+    /** Heartbeat file path (override for tests). */
+    heartbeatPath?: string;
+    /** Write interval in ms.  Defaults to DEFAULTS.HEARTBEAT_INTERVAL_MS. */
+    intervalMs?: number;
+    /** daemon version string (e.g. from package.json) */
+    version: string;
+}
+export interface HeartbeatHandle {
+    /** Call to stop the interval and remove the heartbeat file. */
+    stop: () => void;
+}
+/**
+ * Start the heartbeat writer.
+ *
+ * Writes immediately, then every `intervalMs` ms.
+ * Returns a handle whose `.stop()` clears the interval and removes the file.
+ */
+export declare function startHeartbeat(opts: HeartbeatOptions): HeartbeatHandle;
+//# sourceMappingURL=heartbeat-writer.d.ts.map

package/dist/daemon/services/heartbeat-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-writer.d.ts","sourceRoot":"","sources":["../../../src/daemon/services/heartbeat-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAcH;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,gBAAgB,GACtB,MAAM,4CAA4C,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAmDtE"}

package/dist/daemon/services/heartbeat-writer.js

@@ -0,0 +1,82 @@
+/**
+ * Daemon heartbeat writer.
+ *
+ * Writes a small JSON file to ~/.claude-forge/daemon.heartbeat every
+ * HEARTBEAT_INTERVAL_MS (60s default).  The file is updated with an atomic
+ * rename so readers never see a partial write.
+ *
+ * Consumers:
+ *   - `cf daemon status` — reads the file to display "Last seen Xs ago"
+ *   - `cf daemon ensure-running` — compares `ts` to HEARTBEAT_STALE_MS (3min)
+ *   - Web `/api/health` — surfaces heartbeat_age_ms to the frontend badge
+ *
+ * Design notes:
+ *   - Uses fs.renameSync (POSIX atomic) to avoid torn reads.
+ *   - On graceful shutdown, the heartbeat file is removed so
+ *     `cf daemon ensure-running` treats the daemon as not running.
+ *   - On macOS sleep/wake, all setInterval callbacks fire immediately after
+ *     the machine wakes.  The first catch-up tick refreshes the heartbeat
+ *     within seconds of wake-up, which is the desired behaviour.
+ */
+import { writeFileSync, renameSync, unlinkSync, existsSync, mkdirSync, } from 'node:fs';
+import { dirname } from 'node:path';
+import { FORGE_PATHS, DEFAULTS } from '../../core/constants.js';
+import { logger } from '../../core/utils/logger.js';
+/**
+ * Read side moved to `core/diagnostics/heartbeat-reader.ts` (decision
+ * ed98c8e8) so core never imports from the daemon layer. Re-exported here
+ * for back-compat with existing CLI / test callers.
+ */
+export { readHeartbeat, formatHeartbeatAge, } from '../../core/diagnostics/heartbeat-reader.js';
+/**
+ * Start the heartbeat writer.
+ *
+ * Writes immediately, then every `intervalMs` ms.
+ * Returns a handle whose `.stop()` clears the interval and removes the file.
+ */
+export function startHeartbeat(opts) {
+    const heartbeatPath = opts.heartbeatPath ?? FORGE_PATHS.daemonHeartbeat();
+    const intervalMs = opts.intervalMs ?? DEFAULTS.HEARTBEAT_INTERVAL_MS;
+    const started_at = Date.now();
+    const write = () => {
+        try {
+            const payload = {
+                pid: process.pid,
+                ts: Date.now(),
+                started_at,
+                version: opts.version,
+            };
+            const json = JSON.stringify(payload);
+            const tmp = heartbeatPath + '.tmp';
+            // Ensure directory exists (may not exist on first run)
+            const dir = dirname(heartbeatPath);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            writeFileSync(tmp, json, { encoding: 'utf-8', mode: 0o644 });
+            renameSync(tmp, heartbeatPath);
+        }
+        catch (err) {
+            logger.warn(`[Heartbeat] write failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    };
+    // Write immediately (before first interval tick).
+    write();
+    const timer = setInterval(write, intervalMs);
+    // Allow the process to exit even if the timer is still pending.
+    timer.unref?.();
+    return {
+        stop: () => {
+            clearInterval(timer);
+            try {
+                if (existsSync(heartbeatPath)) {
+                    unlinkSync(heartbeatPath);
+                }
+            }
+            catch (err) {
+                logger.warn(`[Heartbeat] remove failed on shutdown: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=heartbeat-writer.js.map

package/dist/daemon/services/heartbeat-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-writer.js","sourceRoot":"","sources":["../../../src/daemon/services/heartbeat-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,kBAAkB,GAEnB,MAAM,4CAA4C,CAAC;AAgBpD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAsB;IACnD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;IAC1E,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,qBAAqB,CAAC;IACrE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE9B,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,OAAO,GAAqB;gBAChC,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;gBACd,UAAU;gBACV,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC;YACF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,GAAG,GAAG,aAAa,GAAG,MAAM,CAAC;YAEnC,uDAAuD;YACvD,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;YACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;YAED,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7D,UAAU,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC,CAAC;IAEF,kDAAkD;IAClD,KAAK,EAAE,CAAC;IAER,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAE7C,gEAAgE;IAChE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAEhB,OAAO;QACL,IAAI,EAAE,GAAG,EAAE;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,IAAI,CAAC;gBACH,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC9B,UAAU,CAAC,aAAa,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CACT,0CAA0C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC7F,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/daemon/services/idle-session-sweeper.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Idle-session sweeper (Phase 9.5 — daemon hardening).
+ *
+ * Background
+ * ----------
+ * Outcome classification normally happens in the Stop hook (see
+ * `daemon/handlers/stop.ts`). However a session can end up with `outcome IS
+ * NULL` forever in pathological scenarios:
+ *   - Claude Code crashed / was force-killed before Stop fired
+ *   - Synthetic UserPromptSubmit events injected by tooling that bypass the
+ *     hook protocol (no matching Stop event)
+ *   - Daemon was down during Stop and the event got dropped from the queue
+ *
+ * Those rows then show up in the Web UI as "in progress" forever, polluting
+ * KPIs and confusing users. The sweeper closes that loop: once a session's
+ * last activity is older than `idleThresholdMs` (default 24h), we run the
+ * existing classifier with whatever signals we have on hand (event_count +
+ * user_violation_count from the sessions row). Typical outcome is
+ * `abandoned/no_work` or `abandoned/too_short` — exactly what we want for
+ * UI surface area.
+ *
+ * Design notes
+ * ------------
+ * - **Pure I/O wrapper** over `classifyOutcome` — no new heuristic, no new
+ *   thresholds. Audited behavior stays in one place (outcome-classifier).
+ * - **Race-safe**: `updateSessionOutcome` only writes when the row's outcome
+ *   is still NULL (SQL `WHERE outcome IS NULL`). If a delayed Stop hook
+ *   beats us to the write, we no-op.
+ * - **Defensive cap**: `maxPerSweep` (default 500) prevents runaway processing
+ *   if the table has a huge backlog after a long daemon outage.
+ * - **No git lookup**: the abandoned path doesn't need commit stats. Skipping
+ *   `collectCommitStats` keeps the sweep fast (no subprocess fork per row).
+ */
+import type { SQLiteStorage } from '../../core/storage/sqlite.js';
+export interface SweepOptions {
+    /** Sessions whose effective last-activity is older than this are candidates. Default 24h. */
+    idleThresholdMs?: number;
+    /** Hard cap on rows processed per sweep (defensive). Default 500. */
+    maxPerSweep?: number;
+}
+export interface SweepResult {
+    /** Number of candidate rows the query returned (≤ maxPerSweep). */
+    scanned: number;
+    /** Number of rows we successfully UPDATEd with an outcome. */
+    swept: number;
+    /** Reserved for race / skip reasons. Currently always 0 (UPDATE is best-effort). */
+    skipped: number;
+    /** Number of rows where the update threw. Logged at warn level. */
+    errors: number;
+}
+/**
+ * Find sessions whose outcome is NULL but whose last-activity timestamp is
+ * older than `idleThresholdMs`. For each, run the existing `classifyOutcome`
+ * over the data we have (event_count / user_violation_count from the row) and
+ * stamp the result. Returns aggregate counters for logging.
+ *
+ * Idempotent — running twice in a row produces `scanned=0` on the second call
+ * because the first sweep set `outcome` to non-NULL.
+ */
+export declare function sweepIdleSessions(storage: SQLiteStorage, opts?: SweepOptions): SweepResult;
+//# sourceMappingURL=idle-session-sweeper.d.ts.map

package/dist/daemon/services/idle-session-sweeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-session-sweeper.d.ts","sourceRoot":"","sources":["../../../src/daemon/services/idle-session-sweeper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,MAAM,WAAW,YAAY;IAC3B,6FAA6F;IAC7F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,YAAiB,GACtB,WAAW,CAuDb"}