@winspan/claude-forge 8.54.4 → 9.12.0

package/dist/core/insights/agent-distill-spawn.d.ts

@@ -0,0 +1,56 @@
+/**
+ * agent-distill-spawn.ts — Phase 3 retro-distiller headless spawn + envelope
+ * parsing (decision 234f1ad4). A near-copy of the proven skill-distiller spawn
+ * chain (`src/skills/distill/distiller.ts spawnSkillDistillerAgent`), retargeted
+ * at the `agent-retro-distiller` template.
+ *
+ * 红线: this module is invoked ONLY from `cf agent distill` (a human-typed CLI
+ * command), never from the daemon. It spawns `claude -p --agent
+ * agent-retro-distiller` headless (same OAuth-via-subscription path as the skill
+ * distiller, NO `--bare`), with `CLAUDE_FORGE_DISTILL_SPAWN=1` so the hook
+ * entry-points short-circuit and no fan-out loop forms.
+ *
+ * The distiller emits ONE envelope:
+ *   - `---AGENT-PATCH---...---END---`  (target_version + unified diff + rationale)
+ *   - `---NOOP---...---END---`         (signals too thin to draft a confident change)
+ */
+export declare class ClaudeCliMissingError extends Error {
+    constructor();
+}
+export interface AgentDistillSpawnOptions {
+    cancelSignal?: AbortSignal;
+    timeoutMs?: number;
+}
+/**
+ * Spawn `claude -p --agent agent-retro-distiller --output-format stream-json
+ * --verbose --include-partial-messages --input-format text` with the prompt on
+ * stdin. Accumulates assistant text and returns it raw (pre-envelope-parse).
+ *
+ * Exported for testing — but the real LLM call is NEVER exercised by automated
+ * tests (cost). Tests inject a fake spawn via the `runDistill` deps.
+ */
+export declare function spawnAgentRetroDistiller(prompt: string, opts?: AgentDistillSpawnOptions): Promise<string>;
+export interface AgentPatchEnvelope {
+    kind: 'patch';
+    /** target_version field from the envelope (informational; adoption bumps it). */
+    targetVersion: number | null;
+    /** The unified-diff / patch body. */
+    patch: string;
+    /** Free-form rationale block (everything that is not target_version/patch). */
+    rationale: string;
+}
+export interface AgentNoopEnvelope {
+    kind: 'noop';
+    rationale: string;
+}
+export type ParsedAgentEnvelope = AgentPatchEnvelope | AgentNoopEnvelope;
+/**
+ * Parse the distiller's single envelope. Returns:
+ *   - { kind: 'patch', ... } for `---AGENT-PATCH---...---END---`
+ *   - { kind: 'noop', ... }  for `---NOOP---...---END---`
+ *   - null if neither envelope is present (caller treats as a spawn error).
+ *
+ * Tolerant to surrounding chatter (mirrors parseSkillBlock/parseSkipBlock).
+ */
+export declare function parseAgentPatchEnvelope(raw: string): ParsedAgentEnvelope | null;
+//# sourceMappingURL=agent-distill-spawn.d.ts.map

package/dist/core/insights/agent-distill-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-distill-spawn.d.ts","sourceRoot":"","sources":["../../../src/core/insights/agent-distill-spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,qBAAa,qBAAsB,SAAQ,KAAK;;CAO/C;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC,MAAM,CAAC,CAoGjB;AAID,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,iFAAiF;IACjF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAEzE;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CA8B/E"}

package/dist/core/insights/agent-distill-spawn.js

@@ -0,0 +1,179 @@
+/**
+ * agent-distill-spawn.ts — Phase 3 retro-distiller headless spawn + envelope
+ * parsing (decision 234f1ad4). A near-copy of the proven skill-distiller spawn
+ * chain (`src/skills/distill/distiller.ts spawnSkillDistillerAgent`), retargeted
+ * at the `agent-retro-distiller` template.
+ *
+ * 红线: this module is invoked ONLY from `cf agent distill` (a human-typed CLI
+ * command), never from the daemon. It spawns `claude -p --agent
+ * agent-retro-distiller` headless (same OAuth-via-subscription path as the skill
+ * distiller, NO `--bare`), with `CLAUDE_FORGE_DISTILL_SPAWN=1` so the hook
+ * entry-points short-circuit and no fan-out loop forms.
+ *
+ * The distiller emits ONE envelope:
+ *   - `---AGENT-PATCH---...---END---`  (target_version + unified diff + rationale)
+ *   - `---NOOP---...---END---`         (signals too thin to draft a confident change)
+ */
+import { spawn } from 'node:child_process';
+import { findClaudeBin } from '../utils/claude-cli-resolver.js';
+const DEFAULT_TIMEOUT_MS = 600_000;
+export class ClaudeCliMissingError extends Error {
+    constructor() {
+        super('[agent-distill] claude CLI not found on PATH. Install via `brew install claude` or `npm i -g @anthropic-ai/claude-code`.');
+        this.name = 'ClaudeCliMissingError';
+    }
+}
+/**
+ * Spawn `claude -p --agent agent-retro-distiller --output-format stream-json
+ * --verbose --include-partial-messages --input-format text` with the prompt on
+ * stdin. Accumulates assistant text and returns it raw (pre-envelope-parse).
+ *
+ * Exported for testing — but the real LLM call is NEVER exercised by automated
+ * tests (cost). Tests inject a fake spawn via the `runDistill` deps.
+ */
+export async function spawnAgentRetroDistiller(prompt, opts = {}) {
+    const claudeBin = findClaudeBin();
+    if (!claudeBin)
+        throw new ClaudeCliMissingError();
+    const args = [
+        '-p',
+        '--agent', 'agent-retro-distiller',
+        '--output-format', 'stream-json',
+        '--verbose',
+        '--include-partial-messages',
+        '--input-format', 'text',
+    ];
+    return new Promise((resolve, reject) => {
+        const child = spawn(claudeBin, args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env, CLAUDE_FORGE_DISTILL_SPAWN: '1' },
+        });
+        let assistantText = '';
+        let stderr = '';
+        let buffer = '';
+        let settled = false;
+        const settle = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            fn();
+        };
+        const cancelHandler = () => {
+            try {
+                child.kill('SIGTERM');
+            }
+            catch { /* ignore */ }
+            settle(() => reject(new Error('[agent-distill] cancelled by user')));
+        };
+        opts.cancelSignal?.addEventListener('abort', cancelHandler);
+        const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        const timeoutId = setTimeout(() => {
+            try {
+                child.kill('SIGTERM');
+            }
+            catch { /* ignore */ }
+            settle(() => reject(new Error(`[agent-distill] claude CLI timeout after ${timeoutMs}ms`)));
+        }, timeoutMs);
+        child.stdout.on('data', (chunk) => {
+            buffer += chunk.toString('utf-8');
+            let nl;
+            while ((nl = buffer.indexOf('\n')) >= 0) {
+                const line = buffer.slice(0, nl).trim();
+                buffer = buffer.slice(nl + 1);
+                if (!line)
+                    continue;
+                try {
+                    const ev = JSON.parse(line);
+                    if (ev.type === 'assistant' || ev.type === 'assistant_message') {
+                        const content = ev.content;
+                        if (Array.isArray(content)) {
+                            for (const c of content) {
+                                if (c && typeof c === 'object' && typeof c.text === 'string') {
+                                    assistantText += c.text;
+                                }
+                            }
+                        }
+                        else if (typeof ev.text === 'string') {
+                            assistantText += ev.text;
+                        }
+                    }
+                    else if (ev.type === 'content_block_delta') {
+                        const delta = ev.delta;
+                        if (delta && typeof delta.text === 'string')
+                            assistantText += delta.text;
+                    }
+                    else if (ev.type === 'message_delta' || ev.type === 'text_delta') {
+                        const delta = ev.delta;
+                        if (typeof delta === 'string')
+                            assistantText += delta;
+                    }
+                    else if (ev.type === 'result') {
+                        const result = ev.result;
+                        if (typeof result === 'string' && !assistantText)
+                            assistantText = result;
+                    }
+                }
+                catch {
+                    // ignore non-JSON lines
+                }
+            }
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += chunk.toString('utf-8');
+        });
+        child.on('close', (code) => {
+            clearTimeout(timeoutId);
+            opts.cancelSignal?.removeEventListener('abort', cancelHandler);
+            if (code === 0) {
+                settle(() => resolve(assistantText));
+            }
+            else {
+                settle(() => reject(new Error(`[agent-distill] claude CLI exited ${code}: ${stderr.slice(0, 500)}`)));
+            }
+        });
+        child.on('error', (err) => {
+            clearTimeout(timeoutId);
+            opts.cancelSignal?.removeEventListener('abort', cancelHandler);
+            settle(() => reject(new Error(`[agent-distill] claude CLI spawn error: ${err.message}`)));
+        });
+        child.stdin.write(prompt);
+        child.stdin.end();
+    });
+}
+/**
+ * Parse the distiller's single envelope. Returns:
+ *   - { kind: 'patch', ... } for `---AGENT-PATCH---...---END---`
+ *   - { kind: 'noop', ... }  for `---NOOP---...---END---`
+ *   - null if neither envelope is present (caller treats as a spawn error).
+ *
+ * Tolerant to surrounding chatter (mirrors parseSkillBlock/parseSkipBlock).
+ */
+export function parseAgentPatchEnvelope(raw) {
+    const noop = raw.match(/---NOOP---\s*([\s\S]*?)\s*---END---/);
+    if (noop) {
+        return { kind: 'noop', rationale: noop[1].trim() || '(no rationale)' };
+    }
+    const m = raw.match(/---AGENT-PATCH---\s*([\s\S]*?)\s*---END---/);
+    if (!m)
+        return null;
+    const inner = m[1];
+    // target_version: <N>
+    const tvMatch = inner.match(/target_version:\s*([0-9]+)/);
+    const targetVersion = tvMatch ? Number(tvMatch[1]) : null;
+    // The patch body is delimited by a fenced ```diff block when present,
+    // otherwise everything after a `patch:` marker. Fall back to the whole inner.
+    let patch = '';
+    const fence = inner.match(/```(?:diff|patch)?\s*\n([\s\S]*?)```/);
+    if (fence) {
+        patch = fence[1].trimEnd();
+    }
+    else {
+        const patchMarker = inner.match(/patch:\s*\n([\s\S]+)/);
+        patch = (patchMarker ? patchMarker[1] : inner).trimEnd();
+    }
+    // Rationale = lines that look like rationale, else the inner minus the patch.
+    const ratMatch = inner.match(/rationale:\s*([\s\S]+?)(?:\n```|\npatch:|\ntarget_version:|$)/i);
+    const rationale = ratMatch ? ratMatch[1].trim() : '(no rationale)';
+    return { kind: 'patch', targetVersion, patch, rationale };
+}
+//# sourceMappingURL=agent-distill-spawn.js.map

package/dist/core/insights/agent-distill-spawn.js.map

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

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

@@ -0,0 +1,66 @@
+/**
+ * Agent↔Skill 双向 drift 检测 (decision 234f1ad4, Phase 1 / P1-5).
+ *
+ * 三条规则（全部 READ-ONLY，只产 nudge / 报告行，绝不自动改模板）：
+ *   ① 行为 drift：模板声明「必 pull skill」但窗口内对该 agent 零 pull（委托量≥阈值）。
+ *   ② trigger → skill 悬空引用：模板 trigger table 引用的 skill_id 在 skill 目录已不存在/改名。
+ *   ③ skill → agent 悬空 skill：高 actionable_rate skill 没有任何 agent trigger table 引用。
+ *
+ * 检测口径：正则 `cf skill invoke (distilled-[a-z-]+)` 从 templates/agents/*.md 抽引用集合；
+ * 与 (a) 已知 skill_id 集合做差集（②），(b) aggregateSkillUsefulness 结果做差集（③）。
+ *
+ * 不变量：扫模板只读、产建议/nudge，绝不自动改模板。
+ */
+export interface TriggerRefs {
+    /** agent template name (basename without .md) → set of referenced skill_ids. */
+    byAgent: Map<string, Set<string>>;
+    /** Union of all referenced skill_ids across all agent templates. */
+    all: Set<string>;
+}
+/**
+ * Scan agent template markdown for `cf skill invoke distilled-*` trigger rows.
+ * READ-ONLY. Returns per-agent referenced skill_id sets + their union.
+ *
+ * @param templatesDir directory holding `*.md` agent templates (source of truth).
+ */
+export declare function extractTriggerRefs(templatesDir: string): TriggerRefs;
+export type DriftKind = 'no-pull' | 'dangling-ref' | 'orphan-skill';
+export interface DriftNudge {
+    kind: DriftKind;
+    agent?: string;
+    skill_id?: string;
+    message: string;
+}
+/** Min total_rated + helped ratio for a skill to count as "high usefulness" (③). */
+export declare const ORPHAN_MIN_RATED = 10;
+export declare const ORPHAN_MIN_ACTIONABLE_RATE = 0.5;
+/** Min delegations for a "声明 pull 但零 pull" (①) drift to fire. */
+export declare const NO_PULL_MIN_DELEGATIONS = 3;
+export interface DetectAgentDriftInput {
+    /** Trigger refs scanned from templates (extractTriggerRefs). */
+    triggerRefs: TriggerRefs;
+    /** Set of skill_ids that currently EXIST (skill dir + builtin distilled). */
+    knownSkillIds: Set<string>;
+    /**
+     * Skill usefulness rows (aggregateSkillUsefulness) — used for ③ orphan-skill.
+     * Each row: skill_id + total_rated + actionable_rate.
+     */
+    skillUsefulness: Array<{
+        skill_id: string;
+        total_rated: number;
+        actionable_rate: number;
+    }>;
+    /**
+     * Per-agent observed pull counts (reason-prefix proxy → distinct skill pulls)
+     * for ① no-pull. Map agent-template-name → set of skill_ids actually pulled
+     * in window. Optional — when omitted, rule ① is skipped.
+     */
+    pulledByAgent?: Map<string, Set<string>>;
+    /** Per-agent delegation count (for ① threshold). Optional. */
+    delegationsByAgent?: Map<string, number>;
+}
+/**
+ * Run all three drift rules. Pure: no IO (callers pass scanned inputs).
+ */
+export declare function detectAgentDrift(input: DetectAgentDriftInput): DriftNudge[];
+//# sourceMappingURL=agent-drift.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-drift.d.ts","sourceRoot":"","sources":["../../../src/core/insights/agent-drift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAClC,oEAAoE;IACpE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,CA2BpE;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,WAAW,EAAE,WAAW,CAAC;IACzB,6EAA6E;IAC7E,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B;;;OAGG;IACH,eAAe,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3F;;;;OAIG;IACH,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,UAAU,EAAE,CA8C3E"}

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

@@ -0,0 +1,109 @@
+/**
+ * Agent↔Skill 双向 drift 检测 (decision 234f1ad4, Phase 1 / P1-5).
+ *
+ * 三条规则（全部 READ-ONLY，只产 nudge / 报告行，绝不自动改模板）：
+ *   ① 行为 drift：模板声明「必 pull skill」但窗口内对该 agent 零 pull（委托量≥阈值）。
+ *   ② trigger → skill 悬空引用：模板 trigger table 引用的 skill_id 在 skill 目录已不存在/改名。
+ *   ③ skill → agent 悬空 skill：高 actionable_rate skill 没有任何 agent trigger table 引用。
+ *
+ * 检测口径：正则 `cf skill invoke (distilled-[a-z-]+)` 从 templates/agents/*.md 抽引用集合；
+ * 与 (a) 已知 skill_id 集合做差集（②），(b) aggregateSkillUsefulness 结果做差集（③）。
+ *
+ * 不变量：扫模板只读、产建议/nudge，绝不自动改模板。
+ */
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const SKILL_INVOKE_RE = /cf skill invoke\s+(distilled-[a-z0-9-]+)/g;
+/**
+ * Scan agent template markdown for `cf skill invoke distilled-*` trigger rows.
+ * READ-ONLY. Returns per-agent referenced skill_id sets + their union.
+ *
+ * @param templatesDir directory holding `*.md` agent templates (source of truth).
+ */
+export function extractTriggerRefs(templatesDir) {
+    const byAgent = new Map();
+    const all = new Set();
+    let files;
+    try {
+        files = readdirSync(templatesDir).filter((f) => f.endsWith('.md'));
+    }
+    catch {
+        return { byAgent, all };
+    }
+    for (const file of files) {
+        const agent = file.replace(/\.md$/, '');
+        let content;
+        try {
+            content = readFileSync(join(templatesDir, file), 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const refs = new Set();
+        SKILL_INVOKE_RE.lastIndex = 0;
+        let m;
+        while ((m = SKILL_INVOKE_RE.exec(content)) !== null) {
+            refs.add(m[1]);
+            all.add(m[1]);
+        }
+        if (refs.size > 0)
+            byAgent.set(agent, refs);
+    }
+    return { byAgent, all };
+}
+/** Min total_rated + helped ratio for a skill to count as "high usefulness" (③). */
+export const ORPHAN_MIN_RATED = 10;
+export const ORPHAN_MIN_ACTIONABLE_RATE = 0.5;
+/** Min delegations for a "声明 pull 但零 pull" (①) drift to fire. */
+export const NO_PULL_MIN_DELEGATIONS = 3;
+/**
+ * Run all three drift rules. Pure: no IO (callers pass scanned inputs).
+ */
+export function detectAgentDrift(input) {
+    const nudges = [];
+    // ② trigger → skill 悬空引用：引用了不存在的 skill_id。
+    for (const [agent, refs] of input.triggerRefs.byAgent) {
+        for (const skillId of refs) {
+            if (!input.knownSkillIds.has(skillId)) {
+                nudges.push({
+                    kind: 'dangling-ref',
+                    agent,
+                    skill_id: skillId,
+                    message: `agent ${agent} 的 trigger table 指向死/改名 skill「${skillId}」（skill 目录中不存在），建议更新引用。`,
+                });
+            }
+        }
+    }
+    // ③ skill → agent 悬空 skill：高 usefulness 但无任何 agent 引用。
+    for (const row of input.skillUsefulness) {
+        if (row.total_rated < ORPHAN_MIN_RATED)
+            continue;
+        if (row.actionable_rate < ORPHAN_MIN_ACTIONABLE_RATE)
+            continue;
+        if (input.triggerRefs.all.has(row.skill_id))
+            continue;
+        nudges.push({
+            kind: 'orphan-skill',
+            skill_id: row.skill_id,
+            message: `skill「${row.skill_id}」实测高 usefulness（actionable_rate ${(row.actionable_rate * 100).toFixed(0)}%，样本 ${row.total_rated}）但无任何 agent trigger table 引用，建议某 agent 纳入推荐。`,
+        });
+    }
+    // ① 行为 drift：模板声明 pull 但窗口内零 pull（委托量≥阈值）。
+    if (input.pulledByAgent && input.delegationsByAgent) {
+        for (const [agent, refs] of input.triggerRefs.byAgent) {
+            const delegations = input.delegationsByAgent.get(agent) ?? 0;
+            if (delegations < NO_PULL_MIN_DELEGATIONS)
+                continue;
+            const pulled = input.pulledByAgent.get(agent) ?? new Set();
+            if (pulled.size === 0) {
+                nudges.push({
+                    kind: 'no-pull',
+                    agent,
+                    message: `agent ${agent} 模板声明了 skill 推荐（${refs.size} 个），但窗口内被委托 ${delegations} 次却零对应 skill pull——行为 drift，建议核查 pull 步是否被忽略。`,
+                });
+            }
+        }
+    }
+    return nudges;
+}
+//# sourceMappingURL=agent-drift.js.map

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

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

package/dist/core/insights/agent-evolution-sources.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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 { type TriggerRefs } 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 declare function resolveAgentTemplatesDir(): string;
+/** All skill_ids that currently exist (built-in distilled + user skills). */
+export declare function loadKnownSkillIds(): Set<string>;
+/** Scan the source-of-truth templates dir for trigger refs (convenience). */
+export declare function loadTriggerRefs(templatesDir?: string): TriggerRefs;
+//# sourceMappingURL=agent-evolution-sources.d.ts.map

package/dist/core/insights/agent-evolution-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-evolution-sources.d.ts","sourceRoot":"","sources":["../../../src/core/insights/agent-evolution-sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,CAAC,CAO/C;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAElE"}

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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"}