@winspan/claude-forge 9.2.0 → 9.12.0

package/dist/core/insights/agent-evolution-sources.js

@@ -0,0 +1,36 @@
+/**
+ * Shared source resolvers for Agent 体检 / drift (decision 234f1ad4, Phase 1).
+ *
+ * Resolves the agent-template source-of-truth directory and the set of known
+ * skill_ids, so both the web endpoint and `cf agent retro` build identical
+ * trigger-ref / drift inputs without duplicating resolution logic.
+ *
+ * READ-ONLY: only reads template/skill files; never mutates them.
+ */
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { SkillRegistry } from '../../skills/registry.js';
+import { extractTriggerRefs } from './agent-drift.js';
+/**
+ * Resolve the agent template source-of-truth directory.
+ * Compiled: dist/core/insights/*.js → dist/daemon/templates/agents
+ * Dev (vitest): src/core/insights/*.ts → src/daemon/templates/agents
+ */
+export function resolveAgentTemplatesDir() {
+    return join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'daemon', 'templates', 'agents');
+}
+/** All skill_ids that currently exist (built-in distilled + user skills). */
+export function loadKnownSkillIds() {
+    try {
+        const registry = new SkillRegistry();
+        return new Set(registry.getAll().map((s) => s.id));
+    }
+    catch {
+        return new Set();
+    }
+}
+/** Scan the source-of-truth templates dir for trigger refs (convenience). */
+export function loadTriggerRefs(templatesDir) {
+    return extractTriggerRefs(templatesDir ?? resolveAgentTemplatesDir());
+}
+//# sourceMappingURL=agent-evolution-sources.js.map

package/dist/core/insights/agent-evolution-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-evolution-sources.js","sourceRoot":"","sources":["../../../src/core/insights/agent-evolution-sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAoB,MAAM,kBAAkB,CAAC;AAExE;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AACpG,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QACrC,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAU,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,YAAqB;IACnD,OAAO,kBAAkB,CAAC,YAAY,IAAI,wBAAwB,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/core/insights/agent-health.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Agent 体检 — per-agent health aggregation (decision 234f1ad4, Phase 1).
+ *
+ * Pure read-side aggregator + suggestion rules. Combines:
+ *   - delegation / success-rate / duration  ← aggregateAgentSpawns (events,
+ *     read-time Pre/Post pairing; success_rate口径标 INDIRECT，跨 session 边缘有误差)
+ *   - skill usefulness by agent             ← aggregateSkillUsefulnessByAgent
+ *     (reason-prefix proxy key, NOT agent_id — agent_id empirically all-NULL)
+ *   - KB usefulness by agent                ← aggregateKbUsefulnessByAgent
+ *   - (agent, skill) closed-loop status     ← derived recommendation_health
+ *   - main-thread violations                ← tool_intercepts (by session; these
+ *     are orchestration discipline, NOT agent template defects — shown separately)
+ *
+ * 不变量 (cross-Phase): this module is READ-ONLY. It NEVER mutates agent
+ * templates; it only produces health objects + readable suggestion strings.
+ * The daemon does not call this — only the web endpoint and `cf agent retro`.
+ */
+import type { SQLiteStorage } from '../storage/sqlite.js';
+/**
+ * Reason-prefix (proxy agent key from skill_invocations.reason) → agent template
+ * name (the `src/daemon/templates/agents/*.md` source-of-truth basename). The
+ * reason prefix is what agents hardcode in `--reason "coder/<phase>"`, but the
+ * trigger-table / template name differs for several agents.
+ */
+export declare const REASON_PREFIX_TO_AGENT: Record<string, string>;
+/** Map a reason prefix to its canonical agent template name (identity fallback). */
+export declare function agentForReasonPrefix(prefix: string): string;
+/**
+ * recommendation_health classification thresholds (decision 234f1ad4 Q7).
+ * `dead`: pulls >= DEAD_MIN_PULLS && actionable_rate < DEAD_ACTIONABLE_RATE
+ *   (STRICT helped-only rate). The coder × distilled-executing-plans pair
+ *   (70 pull / actionable≈1.5%) is the live `dead` sample.
+ */
+export declare const DEAD_MIN_PULLS = 20;
+export declare const DEAD_ACTIONABLE_RATE = 0.1;
+/** `live`: enough pulls AND actionable_rate at/above this healthy floor. */
+export declare const LIVE_ACTIONABLE_RATE = 0.5;
+/** `unrated`: pulls >= threshold but rated-ratio below this (can't judge). */
+export declare const UNRATED_MIN_PULLS = 20;
+export declare const UNRATED_RATED_RATIO = 0.3;
+/** Min total_rated before a (agent,skill) pair is allowed to产 a suggestion. */
+export declare const SUGGESTION_MIN_RATED = 10;
+/** A skill is "weak" for an agent when actionable_rate < this (with enough evidence). */
+export declare const WEAK_ACTIONABLE_RATE = 0.25;
+/** Min delegations before per-agent success-rate / drift signals are trusted. */
+export declare const MIN_DELEGATIONS_FOR_SIGNAL = 3;
+/**
+ * Muted (agent, skill) pairs — operator can silence noisy suggestions here.
+ * Format: `"<agent>::<skill_id>"`. Empty by default; spec R1 anti-noise.
+ */
+export declare const MUTED_SUGGESTIONS: ReadonlySet<string>;
+export type RecommendationHealth = 'live' | 'dead' | 'unrated' | 'unused';
+export interface RecommendedSkillHealth {
+    skill_id: string;
+    pulls: number;
+    helped: number;
+    partial: number;
+    not_actionable: number;
+    total_rated: number;
+    pending: number;
+    actionable_rate: number;
+    recommendation_health: RecommendationHealth;
+}
+export interface WeakSkill {
+    skill_id: string;
+    actionable_rate: number;
+    total_rated: number;
+    pulls: number;
+}
+export interface AgentKbUsage {
+    pulls: number;
+    total_rated: number;
+    helped: number;
+    actionable_rate: number;
+}
+export type SuccessRateBasis = 'indirect' | 'insufficient_data';
+export interface AgentHealth {
+    agent: string;
+    source: 'builtin' | 'project';
+    delegations: number;
+    success: number;
+    partial: number;
+    failed: number;
+    unrated: number;
+    success_rate: number | null;
+    success_rate_basis: SuccessRateBasis;
+    avg_duration_ms: number | null;
+    last_ts: number;
+    weak_skills: WeakSkill[];
+    recommended_skills: RecommendedSkillHealth[];
+    kb_usage: AgentKbUsage | null;
+    suggestions: string[];
+}
+export interface MainThreadViolations {
+    total: number;
+    by_rule: Array<{
+        rule_id: string;
+        count: number;
+    }>;
+    note: string;
+}
+export interface AgentHealthResult {
+    generated_at: string;
+    since: string;
+    until: string | null;
+    agents: AgentHealth[];
+    main_thread_violations: MainThreadViolations;
+}
+declare const DAY_MS: number;
+/**
+ * Classify a (agent, skill) pairing into a closed-loop health bucket.
+ * `triggerReferenced` = whether the agent template trigger table references the
+ * skill (used to distinguish `unused`: referenced but zero pulls).
+ */
+export declare function classifyRecommendationHealth(pair: {
+    pulls: number;
+    total_rated: number;
+    actionable_rate: number;
+}, triggerReferenced: boolean): RecommendationHealth;
+export interface ComputeAgentHealthOptions {
+    /** Window start (epoch ms). */
+    since: number;
+    /** Window end (epoch ms); omit → open-ended (now). */
+    until?: number;
+    /** Optional project scope for the usefulness aggregations. */
+    projectPath?: string;
+    /**
+     * Trigger-table references per agent (agent template name → set of skill_ids
+     * it recommends). Used to mark `unused` pairs + surface zero-pull recommended
+     * skills. Optional — when omitted, `unused` detection is skipped.
+     */
+    triggerRefs?: Map<string, Set<string>>;
+    /** Whether an agent name is a Claude-Code builtin (for the `source` tag). */
+    isBuiltin?: (agent: string) => boolean;
+}
+/**
+ * Compute per-agent health objects + suggestions over the window.
+ * Pure: takes a storage handle, returns plain data (no side effects).
+ */
+export declare function computeAgentHealth(storage: SQLiteStorage, opts: ComputeAgentHealthOptions): AgentHealthResult;
+export { DAY_MS };
+//# sourceMappingURL=agent-health.d.ts.map

package/dist/core/insights/agent-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-health.d.ts","sourceRoot":"","sources":["../../../src/core/insights/agent-health.ts"],"names":[],"mappings":"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"}

package/dist/core/insights/agent-health.js

@@ -0,0 +1,296 @@
+/**
+ * Agent 体检 — per-agent health aggregation (decision 234f1ad4, Phase 1).
+ *
+ * Pure read-side aggregator + suggestion rules. Combines:
+ *   - delegation / success-rate / duration  ← aggregateAgentSpawns (events,
+ *     read-time Pre/Post pairing; success_rate口径标 INDIRECT，跨 session 边缘有误差)
+ *   - skill usefulness by agent             ← aggregateSkillUsefulnessByAgent
+ *     (reason-prefix proxy key, NOT agent_id — agent_id empirically all-NULL)
+ *   - KB usefulness by agent                ← aggregateKbUsefulnessByAgent
+ *   - (agent, skill) closed-loop status     ← derived recommendation_health
+ *   - main-thread violations                ← tool_intercepts (by session; these
+ *     are orchestration discipline, NOT agent template defects — shown separately)
+ *
+ * 不变量 (cross-Phase): this module is READ-ONLY. It NEVER mutates agent
+ * templates; it only produces health objects + readable suggestion strings.
+ * The daemon does not call this — only the web endpoint and `cf agent retro`.
+ */
+// ── Tunable thresholds + rules (top-of-file constants, per spec) ────────────
+/**
+ * Reason-prefix (proxy agent key from skill_invocations.reason) → agent template
+ * name (the `src/daemon/templates/agents/*.md` source-of-truth basename). The
+ * reason prefix is what agents hardcode in `--reason "coder/<phase>"`, but the
+ * trigger-table / template name differs for several agents.
+ */
+export const REASON_PREFIX_TO_AGENT = {
+    coder: 'coder',
+    verify: 'verify-agent',
+    decision: 'decision-maker',
+    safetynet: 'safety-net-implementer',
+    planner: 'planner',
+    harness: 'harness-debug-full',
+};
+/** Map a reason prefix to its canonical agent template name (identity fallback). */
+export function agentForReasonPrefix(prefix) {
+    return REASON_PREFIX_TO_AGENT[prefix] ?? prefix;
+}
+/**
+ * recommendation_health classification thresholds (decision 234f1ad4 Q7).
+ * `dead`: pulls >= DEAD_MIN_PULLS && actionable_rate < DEAD_ACTIONABLE_RATE
+ *   (STRICT helped-only rate). The coder × distilled-executing-plans pair
+ *   (70 pull / actionable≈1.5%) is the live `dead` sample.
+ */
+export const DEAD_MIN_PULLS = 20;
+export const DEAD_ACTIONABLE_RATE = 0.1; // < 10%
+/** `live`: enough pulls AND actionable_rate at/above this healthy floor. */
+export const LIVE_ACTIONABLE_RATE = 0.5; // >= 50%
+/** `unrated`: pulls >= threshold but rated-ratio below this (can't judge). */
+export const UNRATED_MIN_PULLS = DEAD_MIN_PULLS;
+export const UNRATED_RATED_RATIO = 0.3; // < 30% of pulls rated → unrated
+/** Min total_rated before a (agent,skill) pair is allowed to产 a suggestion. */
+export const SUGGESTION_MIN_RATED = 10;
+/** A skill is "weak" for an agent when actionable_rate < this (with enough evidence). */
+export const WEAK_ACTIONABLE_RATE = 0.25;
+/** Min delegations before per-agent success-rate / drift signals are trusted. */
+export const MIN_DELEGATIONS_FOR_SIGNAL = 3;
+/**
+ * Muted (agent, skill) pairs — operator can silence noisy suggestions here.
+ * Format: `"<agent>::<skill_id>"`. Empty by default; spec R1 anti-noise.
+ */
+export const MUTED_SUGGESTIONS = new Set();
+const DAY_MS = 24 * 60 * 60 * 1000;
+/**
+ * Classify a (agent, skill) pairing into a closed-loop health bucket.
+ * `triggerReferenced` = whether the agent template trigger table references the
+ * skill (used to distinguish `unused`: referenced but zero pulls).
+ */
+export function classifyRecommendationHealth(pair, triggerReferenced) {
+    if (triggerReferenced && pair.pulls === 0)
+        return 'unused';
+    // `dead` is STRICTLY gated on pulls >= DEAD_MIN_PULLS (decision 234f1ad4 Q7):
+    // a low-pull pair with 0% actionable is just under-sampled, NOT a dead推荐.
+    if (pair.pulls >= DEAD_MIN_PULLS && pair.actionable_rate < DEAD_ACTIONABLE_RATE)
+        return 'dead';
+    const ratedRatio = pair.pulls > 0 ? pair.total_rated / pair.pulls : 0;
+    if (pair.pulls >= UNRATED_MIN_PULLS && ratedRatio < UNRATED_RATED_RATIO)
+        return 'unrated';
+    if (pair.pulls >= DEAD_MIN_PULLS && pair.actionable_rate >= LIVE_ACTIONABLE_RATE)
+        return 'live';
+    // Below the dead/live pull threshold: classify as live only when it clears the
+    // healthy floor with enough rated evidence; otherwise unrated (under-sampled).
+    if (pair.total_rated >= SUGGESTION_MIN_RATED && pair.actionable_rate >= LIVE_ACTIONABLE_RATE)
+        return 'live';
+    return 'unrated';
+}
+/**
+ * Compute per-agent health objects + suggestions over the window.
+ * Pure: takes a storage handle, returns plain data (no side effects).
+ */
+export function computeAgentHealth(storage, opts) {
+    const sinceIso = new Date(opts.since).toISOString();
+    const untilIso = opts.until !== undefined ? new Date(opts.until).toISOString() : undefined;
+    const spawns = storage.aggregateAgentSpawns({
+        since: sinceIso,
+        until: untilIso,
+        recentLimit: 8,
+        // decision dd79010a: scope delegation/success/duration to the project too
+        // (skill/kb usefulness below were already project-scoped via opts.projectPath).
+        projectPath: opts.projectPath,
+    });
+    const skillByAgent = storage.aggregateSkillUsefulnessByAgent({
+        since: opts.since,
+        until: opts.until,
+        projectPath: opts.projectPath,
+    });
+    const kbByAgent = storage.aggregateKbUsefulnessByAgent({
+        since: opts.since,
+        until: opts.until,
+        project_path: opts.projectPath,
+    });
+    // Bug-fix (insights project filter parity, 2026-06-15): when a SPECIFIC
+    // project is requested, the triggerRefs-driven `unused` synthesis below MUST
+    // be suppressed. `triggerRefs` is a global agent-template ⇄ skill metadata map
+    // (project-independent), so injecting its zero-pull `unused` pairs — and
+    // unioning its agent names into `agentNames` (see further down) — would
+    // manufacture agents that have NO project-scoped activity. That made
+    // /api/insights/agent-health?project=<bogus> return 1 agent (verify-agent,
+    // delegations=0, one `unused` skill) while /agent-stats?project=<bogus>
+    // correctly returned 0. Strict equality on the project-scoped aggregations
+    // (events / skill / kb usefulness, all `project_path = ?`) already excludes
+    // NULL/other-project rows; the only remaining leak was this global template
+    // synthesis. So: only honour triggerRefs (unused detection + name union) in
+    // the all-projects view (no project filter). agent-stats has no triggerRefs
+    // path at all, which is why it never leaked — this brings the two to parity.
+    const projectScoped = opts.projectPath !== undefined && opts.projectPath !== '';
+    const effectiveTriggerRefs = projectScoped ? undefined : opts.triggerRefs;
+    // Index usefulness by canonical agent name.
+    const skillsByAgentName = new Map();
+    for (const row of skillByAgent) {
+        if (row.agent === '<unknown>')
+            continue;
+        const agentName = agentForReasonPrefix(row.agent);
+        const refs = effectiveTriggerRefs?.get(agentName);
+        const triggerReferenced = refs ? refs.has(row.skill_id) : false;
+        const rec = {
+            skill_id: row.skill_id,
+            pulls: row.pulls,
+            helped: row.helped,
+            partial: row.partial,
+            not_actionable: row.not_actionable,
+            total_rated: row.total_rated,
+            pending: row.pending,
+            actionable_rate: row.actionable_rate,
+            recommendation_health: classifyRecommendationHealth(row, triggerReferenced),
+        };
+        const arr = skillsByAgentName.get(agentName) ?? [];
+        arr.push(rec);
+        skillsByAgentName.set(agentName, arr);
+    }
+    // Add `unused` pairs: trigger-referenced skills with zero pulls in window.
+    // Suppressed under a specific project scope (see projectScoped note above).
+    if (effectiveTriggerRefs) {
+        for (const [agentName, refSkills] of effectiveTriggerRefs) {
+            const existing = skillsByAgentName.get(agentName) ?? [];
+            const seen = new Set(existing.map((s) => s.skill_id));
+            for (const skillId of refSkills) {
+                if (seen.has(skillId))
+                    continue;
+                existing.push({
+                    skill_id: skillId,
+                    pulls: 0,
+                    helped: 0,
+                    partial: 0,
+                    not_actionable: 0,
+                    total_rated: 0,
+                    pending: 0,
+                    actionable_rate: 0,
+                    recommendation_health: 'unused',
+                });
+            }
+            skillsByAgentName.set(agentName, existing);
+        }
+    }
+    const kbByAgentName = new Map();
+    for (const row of kbByAgent) {
+        if (row.agent === '<unknown>')
+            continue;
+        const agentName = agentForReasonPrefix(row.agent);
+        kbByAgentName.set(agentName, {
+            pulls: row.pulls,
+            total_rated: row.total_rated,
+            helped: row.helped,
+            actionable_rate: row.actionable_rate,
+        });
+    }
+    // Union of agent names from spawns + usefulness + trigger refs.
+    const agentNames = new Set();
+    for (const s of spawns)
+        agentNames.add(s.agent);
+    for (const k of skillsByAgentName.keys())
+        agentNames.add(k);
+    for (const k of kbByAgentName.keys())
+        agentNames.add(k);
+    if (effectiveTriggerRefs)
+        for (const k of effectiveTriggerRefs.keys())
+            agentNames.add(k);
+    const spawnByName = new Map(spawns.map((s) => [s.agent, s]));
+    const isBuiltin = opts.isBuiltin ?? (() => false);
+    const agents = [];
+    for (const name of agentNames) {
+        const spawn = spawnByName.get(name);
+        const delegations = spawn?.delegations ?? 0;
+        const success = spawn?.success ?? 0;
+        const partial = spawn?.partial ?? 0;
+        const failed = spawn?.failed ?? 0;
+        const unrated = spawn?.unrated ?? 0;
+        const rated = success + partial + failed;
+        const hasSignal = delegations >= MIN_DELEGATIONS_FOR_SIGNAL && rated > 0;
+        const success_rate = hasSignal ? Math.round((success / rated) * 1000) / 1000 : null;
+        const success_rate_basis = hasSignal ? 'indirect' : 'insufficient_data';
+        const recommended = (skillsByAgentName.get(name) ?? []).sort((a, b) => a.actionable_rate - b.actionable_rate || b.pulls - a.pulls);
+        const weak_skills = recommended
+            .filter((r) => r.total_rated >= SUGGESTION_MIN_RATED && r.actionable_rate < WEAK_ACTIONABLE_RATE)
+            .map((r) => ({
+            skill_id: r.skill_id,
+            actionable_rate: r.actionable_rate,
+            total_rated: r.total_rated,
+            pulls: r.pulls,
+        }));
+        const suggestions = buildSuggestions(name, recommended, weak_skills);
+        agents.push({
+            agent: name,
+            source: isBuiltin(name) ? 'builtin' : 'project',
+            delegations,
+            success,
+            partial,
+            failed,
+            unrated,
+            success_rate,
+            success_rate_basis,
+            avg_duration_ms: spawn?.avg_duration_ms ?? null,
+            last_ts: spawn?.last_ts ?? 0,
+            weak_skills,
+            recommended_skills: recommended,
+            kb_usage: kbByAgentName.get(name) ?? null,
+            suggestions,
+        });
+    }
+    agents.sort((a, b) => b.delegations - a.delegations || a.agent.localeCompare(b.agent));
+    return {
+        generated_at: new Date().toISOString(),
+        since: sinceIso,
+        until: untilIso ?? null,
+        agents,
+        main_thread_violations: computeMainThreadViolations(storage, sinceIso, untilIso),
+    };
+}
+/**
+ * Build readable improvement suggestions for an agent (decision 234f1ad4).
+ * High-threshold (SUGGESTION_MIN_RATED) + mutable mute list to avoid noise (R1).
+ */
+function buildSuggestions(agent, recommended, weakSkills) {
+    const out = [];
+    for (const w of weakSkills) {
+        if (MUTED_SUGGESTIONS.has(`${agent}::${w.skill_id}`))
+            continue;
+        const rec = recommended.find((r) => r.skill_id === w.skill_id);
+        const ratePct = (w.actionable_rate * 100).toFixed(1);
+        if (rec && rec.recommendation_health === 'dead') {
+            out.push(`${agent} 推荐 ${w.skill_id}：${w.pulls} pull / ${rec.helped} helped / ${rec.partial} partial（actionable_rate ${ratePct}%，样本 ${w.total_rated}≥阈值）→ 死推荐，建议换 skill 或精简该 pull 步措辞。`);
+        }
+        else {
+            out.push(`${agent} 推荐 ${w.skill_id}：actionable_rate ${ratePct}%（样本 ${w.total_rated}≥阈值）→ 弱推荐，建议复核该 pull 步。`);
+        }
+    }
+    return out;
+}
+/**
+ * Aggregate main-thread (orchestration discipline) violations from
+ * tool_intercepts in window. These are NOT agent template defects — surfaced
+ * separately with an explicit note (decision实测: 违规 != agent 缺陷).
+ */
+function computeMainThreadViolations(storage, sinceIso, untilIso) {
+    const note = '主线程编排纪律（edit/write-multi-file-hard 等），非 agent 模板缺陷——与 agent 自身信号分开展示。';
+    try {
+        // tool_intercepts.timestamp is ISO TEXT (NOT INTEGER ms) — compare ISO直接.
+        const db = storage.db;
+        const conditions = ['decision = ?', 'timestamp >= ?'];
+        const params = ['deny', sinceIso];
+        if (untilIso !== undefined) {
+            conditions.push('timestamp < ?');
+            params.push(untilIso);
+        }
+        const rows = db
+            .prepare(`SELECT rule_id, COUNT(*) AS count FROM tool_intercepts
+         WHERE ${conditions.join(' AND ')}
+         GROUP BY rule_id ORDER BY count DESC`)
+            .all(...params);
+        const total = rows.reduce((s, r) => s + r.count, 0);
+        return { total, by_rule: rows, note };
+    }
+    catch {
+        return { total: 0, by_rule: [], note };
+    }
+}
+export { DAY_MS };
+//# sourceMappingURL=agent-health.js.map

package/dist/core/insights/agent-health.js.map

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

package/dist/core/insights/agent-patch-apply.d.ts

@@ -0,0 +1,45 @@
+/**
+ * agent-patch-apply.ts — pure-JS unified-diff applier for agent-template
+ * adoption (decision 568a8c53, user Open-Q1).
+ *
+ * Why NOT `git apply`: the daemon runs under launchd with cwd=`/` (no working
+ * tree), so `git apply` fails there (same landmine documented in
+ * skills-distill.ts:559). The web adopt path needs a working tree-INDEPENDENT
+ * application that resolves the patch against the in-memory template text.
+ *
+ * Scope: this is a deliberately small, strict context-matching applier — NOT a
+ * full GNU patch / git-apply re-implementation. It handles the unified-diff
+ * shape the `agent-retro-distiller` emits:
+ *   - one or more `@@ ... @@` hunks
+ *   - context lines (leading space), additions (`+`), removals (`-`)
+ *   - optional `--- a/...` / `+++ b/...` file headers (ignored)
+ *
+ * It is ATOMIC: if any hunk fails to match its context against the current text
+ * it throws `PatchApplyError` and returns NOTHING (no partial write). Callers
+ * map the throw to HTTP 422. Pure: no IO.
+ */
+export declare class PatchApplyError extends Error {
+    /** Index (1-based) of the hunk that failed, when known. */
+    readonly hunkIndex: number | null;
+    constructor(message: string, hunkIndex?: number | null);
+}
+/**
+ * Apply a unified-diff `patch` to `source` text, returning the new text.
+ *
+ * Atomic + strict: every hunk's context (+removed) side must match exactly once
+ * in the current text, else throw (no partial application). The trailing newline
+ * convention of `source` is preserved.
+ *
+ * Pure: no IO, no template writes.
+ */
+export declare function applyUnifiedDiff(source: string, patch: string): string;
+/**
+ * Mechanically set the `version:` line inside the leading YAML frontmatter to
+ * `targetVersion`. The anchor-guard forbids the distiller from touching the
+ * version line; adoption bumps it here, deterministically. Returns the new text.
+ *
+ * Throws if no frontmatter `version:` line is found (the template invariant
+ * requires one). Pure.
+ */
+export declare function setFrontmatterVersion(template: string, targetVersion: number): string;
+//# sourceMappingURL=agent-patch-apply.d.ts.map

package/dist/core/insights/agent-patch-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-patch-apply.d.ts","sourceRoot":"","sources":["../../../src/core/insights/agent-patch-apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;gBACtB,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW;CAK7D;AAuGD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAmBtE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAQrF"}