@winspan/claude-forge 9.2.0 → 9.12.0

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

@@ -0,0 +1,146 @@
+/**
+ * agent-distill-context.ts — Phase 3 retro-distill prompt assembly (decision
+ * 234f1ad4). Pure function: turns the read-only health/drift/failure signals
+ * into the structured prompt fed to the `agent-retro-distiller` template, plus a
+ * human-readable signal summary used by `--dry-run` (which never spawns the LLM).
+ *
+ * READ-ONLY: takes already-aggregated data + the template text, returns strings.
+ * No IO, no spawn, no template writes.
+ */
+import { MIN_DELEGATIONS_FOR_SIGNAL, SUGGESTION_MIN_RATED } from './agent-health.js';
+/**
+ * Command-level gate (门槛 1, spec §数据稀薄退化): below this delegation count we
+ * do NOT spawn the LLM — there is not enough usage signal to draft a confident
+ * change. = MIN_DELEGATIONS_FOR_SIGNAL × 5 (spec recommendation ≈ 15).
+ */
+export const DISTILL_MIN_DELEGATIONS = MIN_DELEGATIONS_FOR_SIGNAL * 5;
+/**
+ * Build the distill context (gates + maturity + summary + prompt + proposed
+ * change types) from read-only signals. Pure.
+ */
+export function buildDistillContext(input) {
+    const delegations = input.health?.delegations ?? 0;
+    const maturity = `delegations=${delegations} rated_pairs=${input.ratedPairs} window_days=${input.windowDays}`;
+    // ── Gate (门槛 1): not enough delegations to trust the signal. ──────────────
+    let enoughSignal = true;
+    let insufficientReason = null;
+    if (delegations < DISTILL_MIN_DELEGATIONS) {
+        enoughSignal = false;
+        insufficientReason =
+            `数据不足（delegations=${delegations} < 阈值 ${DISTILL_MIN_DELEGATIONS}），建议先观测，未产改进草案。`;
+    }
+    // ── Collect the change types the evidence would support (门槛 2 per-pair). ──
+    const proposedChangeTypes = [];
+    const dead = [];
+    const weak = [];
+    if (input.health) {
+        for (const r of input.health.recommended_skills) {
+            // 门槛 2: a pair must clear SUGGESTION_MIN_RATED to drive a change.
+            if (r.recommendation_health === 'dead' && r.total_rated >= SUGGESTION_MIN_RATED) {
+                dead.push(`${r.skill_id} (${r.pulls} pull / actionable ${(r.actionable_rate * 100).toFixed(1)}%)`);
+            }
+        }
+        for (const w of input.health.weak_skills) {
+            // dead pairs are already surfaced above — don't double-count.
+            const rec = input.health.recommended_skills.find((r) => r.skill_id === w.skill_id);
+            if (rec?.recommendation_health === 'dead')
+                continue;
+            weak.push(`${w.skill_id} (actionable ${(w.actionable_rate * 100).toFixed(1)}%, sample ${w.total_rated})`);
+        }
+    }
+    if (dead.length > 0) {
+        proposedChangeTypes.push(`skill-discovery 段降权死推荐: ${dead.join('; ')}`);
+    }
+    if (weak.length > 0) {
+        proposedChangeTypes.push(`复核弱推荐 pull 步: ${weak.join('; ')}`);
+    }
+    for (const d of input.drift) {
+        if (d.kind === 'dangling-ref')
+            proposedChangeTypes.push(`删/换悬空引用: ${d.skill_id}`);
+        else if (d.kind === 'orphan-skill')
+            proposedChangeTypes.push(`提示孤儿高分 skill: ${d.skill_id}`);
+        else if (d.kind === 'no-pull')
+            proposedChangeTypes.push(`核查声明但零 pull 的步骤 (${d.agent})`);
+    }
+    if (input.failureSamples.length > 0) {
+        proposedChangeTypes.push(`据 ${input.failureSamples.length} 条 failed 执行补防线说明`);
+    }
+    // ── Human-readable summary (the --dry-run payload). ────────────────────────
+    const summaryLines = [];
+    summaryLines.push(`# Agent distill 信号摘要: ${input.agent}`);
+    summaryLines.push(`> 当前 version: ${input.currentVersion}  |  信号成熟度: ${maturity}`);
+    summaryLines.push('');
+    if (!enoughSignal) {
+        summaryLines.push(`⚠ ${insufficientReason}`);
+        summaryLines.push('');
+    }
+    summaryLines.push('## 死/弱推荐信号');
+    if (input.health && input.health.recommended_skills.length > 0) {
+        for (const r of input.health.recommended_skills) {
+            const flag = r.recommendation_health === 'dead' ? ' ⚠ 死推荐' : '';
+            summaryLines.push(`- ${r.skill_id}: ${r.pulls} pull / actionable ${(r.actionable_rate * 100).toFixed(1)}% [${r.recommendation_health}]${flag}`);
+        }
+    }
+    else {
+        summaryLines.push('- （无推荐 skill 信号）');
+    }
+    summaryLines.push('');
+    summaryLines.push('## drift');
+    if (input.drift.length > 0) {
+        for (const d of input.drift)
+            summaryLines.push(`- [${d.kind}] ${d.message}`);
+    }
+    else {
+        summaryLines.push('- （无）');
+    }
+    summaryLines.push('');
+    summaryLines.push('## failed 执行样本');
+    if (input.failureSamples.length > 0) {
+        for (const f of input.failureSamples) {
+            summaryLines.push(`- ${f.title}  (session ${f.session_id})`);
+        }
+    }
+    else {
+        summaryLines.push('- （无 failed 样本）');
+    }
+    summaryLines.push('');
+    summaryLines.push('## 拟改动类型（会喂给 distiller）');
+    if (proposedChangeTypes.length > 0) {
+        for (const t of proposedChangeTypes)
+            summaryLines.push(`- ${t}`);
+    }
+    else {
+        summaryLines.push('- （无足够信号支撑改动，distiller 预期产 NOOP）');
+    }
+    const summary = summaryLines.join('\n');
+    // ── Structured prompt for the distiller (real spawn only). ─────────────────
+    const healthJson = input.health
+        ? JSON.stringify({
+            recommended_skills: input.health.recommended_skills,
+            weak_skills: input.health.weak_skills,
+            suggestions: input.health.suggestions,
+        }, null, 2)
+        : '{}';
+    const driftJson = JSON.stringify(input.drift, null, 2);
+    const failuresText = input.failureSamples.length > 0
+        ? input.failureSamples.map((f) => `- ${f.title} (session ${f.session_id})`).join('\n')
+        : '(none)';
+    const prompt = [
+        `<agent_name>${input.agent}</agent_name>`,
+        `<current_version>${input.currentVersion}</current_version>`,
+        `<current_template>\n${input.currentTemplate}\n</current_template>`,
+        `<health_signals>\n${healthJson}\n</health_signals>`,
+        `<drift>\n${driftJson}\n</drift>`,
+        `<failure_samples>\n${failuresText}\n</failure_samples>`,
+        `<maturity>${maturity}</maturity>`,
+    ].join('\n\n');
+    return {
+        enoughSignal,
+        insufficientReason,
+        maturity,
+        summary,
+        prompt,
+        proposedChangeTypes,
+    };
+}
+//# sourceMappingURL=agent-distill-context.js.map

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

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

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":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C;QACE,KAAK,CACH,0HAA0H,CAC3H,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAOD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAc,EACd,OAAiC,EAAE;IAEnC,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,qBAAqB,EAAE,CAAC;IAElD,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,SAAS,EAAE,uBAAuB;QAClC,iBAAiB,EAAE,aAAa;QAChC,WAAW;QACX,4BAA4B;QAC5B,gBAAgB,EAAE,MAAM;KACzB,CAAC;IAEF,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE;YACnC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,0BAA0B,EAAE,GAAG,EAAE;SACzD,CAAC,CAAC;QACH,IAAI,aAAa,GAAG,EAAE,CAAC;QACvB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,MAAM,GAAG,CAAC,EAAc,EAAE,EAAE;YAChC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,EAAE,EAAE,CAAC;QACP,CAAC,CAAC;QAEF,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,IAAI,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACrD,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC;QACF,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAE5D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,kBAAkB,CAAC;QACvD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACrD,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4CAA4C,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7F,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,EAAU,CAAC;YACf,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC9B,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,IAAI,CAAC;oBACH,MAAM,EAAE,GAA4C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACrE,IAAI,EAAE,CAAC,IAAI,KAAK,WAAW,IAAI,EAAE,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;wBAC/D,MAAM,OAAO,GAAI,EAA4B,CAAC,OAAO,CAAC;wBACtD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;4BAC3B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gCACxB,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAQ,CAAwB,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oCACrF,aAAa,IAAK,CAAsB,CAAC,IAAI,CAAC;gCAChD,CAAC;4BACH,CAAC;wBACH,CAAC;6BAAM,IAAI,OAAQ,EAAyB,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;4BAC/D,aAAa,IAAK,EAAuB,CAAC,IAAI,CAAC;wBACjD,CAAC;oBACH,CAAC;yBAAM,IAAI,EAAE,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;wBAC7C,MAAM,KAAK,GAAI,EAAqC,CAAC,KAAK,CAAC;wBAC3D,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;4BAAE,aAAa,IAAI,KAAK,CAAC,IAAI,CAAC;oBAC3E,CAAC;yBAAM,IAAI,EAAE,CAAC,IAAI,KAAK,eAAe,IAAI,EAAE,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;wBACnE,MAAM,KAAK,GAAI,EAA0B,CAAC,KAAK,CAAC;wBAChD,IAAI,OAAO,KAAK,KAAK,QAAQ;4BAAE,aAAa,IAAI,KAAK,CAAC;oBACxD,CAAC;yBAAM,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAChC,MAAM,MAAM,GAAI,EAA2B,CAAC,MAAM,CAAC;wBACnD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,aAAa;4BAAE,aAAa,GAAG,MAAM,CAAC;oBAC3E,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAC/D,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACxG,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAC/D,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,2CAA2C,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5F,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC;AAqBD;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAC9D,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,gBAAgB,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAClE,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnB,sBAAsB;IACtB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE1D,sEAAsE;IACtE,8EAA8E;IAC9E,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAClE,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACxD,KAAK,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3D,CAAC;IAED,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;IAC/F,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAEnE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC5D,CAAC"}

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