@winspan/claude-forge 9.2.0 → 9.12.0

package/dist/web/services/agent-distill-manager.js

@@ -0,0 +1,397 @@
+/**
+ * AgentDistillManager — per-agent retro-distill job manager for the web
+ * `POST /api/agent/distill/run` path (decision 568a8c53).
+ *
+ * Structurally MIRRORS `distill-manager.ts` (session map / SSE event broadcast /
+ * TTL GC / AbortController cancel) but is a SEPARATE class so the proven skill
+ * distill path is never touched (Option B — blast-radius isolation). The two
+ * differ in lock semantics:
+ *   - skill distill: ONE global job at a time.
+ *   - agent distill: per-agent mutex (different agents may run in parallel; the
+ *     SAME agent's second run → AgentDistillConflictError / 409), plus a global
+ *     concurrency cap (MAX_CONCURRENT_AGENT_DISTILL) to avoid an LLM storm.
+ *
+ * 红线 (decision 568a8c53 / core-belief #2): the ONLY caller of `start()` is the
+ * human-triggered `POST /api/agent/distill/run` route. This module must NEVER be
+ * imported by daemon startup / loop / scheduler code (import-graph guard test).
+ *
+ * Cost safety: real spawns burn LLM. Tests inject a fake `spawn` returning a
+ * pre-baked envelope string — the real `spawnAgentRetroDistiller` is NEVER
+ * exercised by automated tests.
+ */
+import { randomBytes } from 'node:crypto';
+import { promises as fsp } from 'node:fs';
+import path from 'node:path';
+import { logger } from '../../core/utils/logger.js';
+import { SQLiteStorage } from '../../core/storage/sqlite.js';
+import { FORGE_PATHS } from '../../core/constants.js';
+import { spawnAgentRetroDistiller, parseAgentPatchEnvelope, } from '../../core/insights/agent-distill-spawn.js';
+import { scanAgentPatch } from '../../core/insights/agent-anchor-guard.js';
+import { buildAgentDistillContextFor, renderDraft, } from '../../cli/commands/agent.js';
+/** Finished sessions live this long before GC. */
+const SESSION_TTL_MS = 5 * 60 * 1000;
+/**
+ * Global cap on concurrently-running agent distills (independent of the per-agent
+ * mutex). Guards against an LLM-spawn storm (vitest IO-storm教训 / decision
+ * 8a51b15d analogue): even with N distinct agents, never spawn more than this at
+ * once.
+ */
+export const MAX_CONCURRENT_AGENT_DISTILL = 2;
+export class AgentDistillConflictError extends Error {
+    agent;
+    status = 409;
+    constructor(agent) {
+        super(`Agent distill already running for "${agent}"`);
+        this.agent = agent;
+        this.name = 'AgentDistillConflictError';
+    }
+}
+export class AgentDistillCapacityError extends Error {
+    status = 409;
+    constructor() {
+        super(`Too many agent distills running (cap ${MAX_CONCURRENT_AGENT_DISTILL})`);
+        this.name = 'AgentDistillCapacityError';
+    }
+}
+export class AgentDistillManager {
+    /** Per-agent mutex: agent → its in-flight session. */
+    running = new Map();
+    sessions = new Map();
+    listeners = new Map();
+    lastFinished = null;
+    /** True iff the given agent has an in-flight distill. */
+    isBusy(agent) {
+        const s = this.running.get(agent);
+        return s != null && s.doneAt === null;
+    }
+    /** Count of in-flight distills across all agents. */
+    runningCount() {
+        let n = 0;
+        for (const s of this.running.values())
+            if (s.doneAt === null)
+                n++;
+        return n;
+    }
+    /** Agent name of any single in-flight distill (UI convenience). */
+    getBusyAgent() {
+        for (const s of this.running.values())
+            if (s.doneAt === null)
+                return s.agent;
+        return null;
+    }
+    getSession(id) {
+        return this.sessions.get(id) ?? null;
+    }
+    getLastFinished() {
+        return this.lastFinished;
+    }
+    /**
+     * Kick off a per-agent distill run. Throws AgentDistillConflictError (same
+     * agent already running) or AgentDistillCapacityError (global cap reached).
+     * Returns immediately; the spawn runs in the background. Subscribers get
+     * events via subscribe().
+     */
+    start(options) {
+        const agent = (options.agent ?? '').trim();
+        if (this.isBusy(agent)) {
+            throw new AgentDistillConflictError(agent);
+        }
+        if (this.runningCount() >= MAX_CONCURRENT_AGENT_DISTILL) {
+            throw new AgentDistillCapacityError();
+        }
+        const runId = `agent-distill-${randomBytes(6).toString('hex')}`;
+        const session = {
+            runId,
+            agent,
+            startedAt: Date.now(),
+            doneAt: null,
+            events: [],
+            cancelRequested: false,
+            draftPath: null,
+            lastError: null,
+        };
+        this.running.set(agent, session);
+        this.sessions.set(runId, session);
+        this.pushEvent(runId, {
+            type: 'start',
+            at: new Date().toISOString(),
+            agent,
+            message: `Agent distill started: ${agent}`,
+            runId,
+        });
+        void this.runWithChildProcess(session, options).finally(() => {
+            session.doneAt = Date.now();
+            this.lastFinished = session;
+            if (this.running.get(agent) === session)
+                this.running.delete(agent);
+            setTimeout(() => {
+                this.sessions.delete(runId);
+                this.listeners.delete(runId);
+            }, SESSION_TTL_MS).unref?.();
+        });
+        return { runId };
+    }
+    subscribe(runId, listener) {
+        let set = this.listeners.get(runId);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(runId, set);
+        }
+        set.add(listener);
+        return () => {
+            const s = this.listeners.get(runId);
+            if (s)
+                s.delete(listener);
+        };
+    }
+    cancel(runId) {
+        const session = this.sessions.get(runId);
+        if (!session || session.doneAt !== null)
+            return false;
+        session.cancelRequested = true;
+        return true;
+    }
+    pushEvent(runId, ev) {
+        const session = this.sessions.get(runId);
+        if (!session)
+            return;
+        session.events.push(ev);
+        const subs = this.listeners.get(runId);
+        if (subs) {
+            for (const fn of subs) {
+                try {
+                    fn(ev);
+                }
+                catch (err) {
+                    logger.warn(`[AgentDistillManager] listener error: ${err}`);
+                }
+            }
+        }
+    }
+    /**
+     * Assemble read-only context → gate → spawn distiller → parse envelope →
+     * anchor-guard → write draft. Terminates with one of: done | cancelled |
+     * error. NEVER writes the template itself (that is the adopt path).
+     */
+    async runWithChildProcess(session, opts) {
+        const { runId, agent } = session;
+        const abort = new AbortController();
+        const cancelPoll = setInterval(() => {
+            if (session.cancelRequested && !abort.signal.aborted)
+                abort.abort();
+        }, 100).unref?.();
+        const clearPoll = () => {
+            if (cancelPoll)
+                clearInterval(cancelPoll);
+        };
+        this.pushEvent(runId, {
+            type: 'phase-changed',
+            at: new Date().toISOString(),
+            agent,
+            message: '组装信号 + 评估门槛…',
+            runId,
+        });
+        const ownStorage = !opts.storage;
+        let storage;
+        try {
+            storage = opts.storage ?? new SQLiteStorage(FORGE_PATHS.database());
+        }
+        catch (err) {
+            clearPoll();
+            this.pushEvent(runId, {
+                type: 'error',
+                at: new Date().toISOString(),
+                agent,
+                errorMessage: `cannot open storage: ${err instanceof Error ? err.message : String(err)}`,
+                runId,
+            });
+            return;
+        }
+        try {
+            if (session.cancelRequested) {
+                this.pushEvent(runId, {
+                    type: 'cancelled',
+                    at: new Date().toISOString(),
+                    agent,
+                    message: 'Cancelled before start',
+                    runId,
+                });
+                return;
+            }
+            // ── read-only signal context (shared with CLI). ────────────────────────
+            let built;
+            try {
+                built = buildAgentDistillContextFor(agent, {
+                    storage,
+                    templatesDir: opts.templatesDir,
+                    days: opts.days,
+                    maxFailures: opts.maxFailures,
+                });
+            }
+            catch (err) {
+                this.pushEvent(runId, {
+                    type: 'error',
+                    at: new Date().toISOString(),
+                    agent,
+                    errorMessage: err instanceof Error ? err.message : String(err),
+                    runId,
+                });
+                return;
+            }
+            const { ctx, currentVersion } = built;
+            // ── gate (门槛 1): honest degradation, NOT an error. ───────────────────
+            if (!ctx.enoughSignal) {
+                this.pushEvent(runId, {
+                    type: 'done',
+                    at: new Date().toISOString(),
+                    agent,
+                    message: ctx.insufficientReason ?? '数据不足，未产改进草案。',
+                    currentVersion,
+                    maturity: ctx.maturity,
+                    runId,
+                });
+                return;
+            }
+            // ── spawn the distiller (real LLM, or injected fake in tests). ─────────
+            this.pushEvent(runId, {
+                type: 'distiller-spawned',
+                at: new Date().toISOString(),
+                agent,
+                message: 'spawn agent-retro-distiller…',
+                maturity: ctx.maturity,
+                runId,
+            });
+            const spawnFn = opts.spawn ?? ((p, sig) => spawnAgentRetroDistiller(p, { cancelSignal: sig }));
+            let raw;
+            try {
+                raw = await spawnFn(ctx.prompt, abort.signal);
+            }
+            catch (err) {
+                if (session.cancelRequested) {
+                    this.pushEvent(runId, {
+                        type: 'cancelled',
+                        at: new Date().toISOString(),
+                        agent,
+                        message: 'Cancelled by user',
+                        runId,
+                    });
+                    return;
+                }
+                this.pushEvent(runId, {
+                    type: 'error',
+                    at: new Date().toISOString(),
+                    agent,
+                    errorMessage: `distiller spawn failed: ${err instanceof Error ? err.message : String(err)}`,
+                    runId,
+                });
+                return;
+            }
+            // ── parse the envelope. ────────────────────────────────────────────────
+            const envelope = parseAgentPatchEnvelope(raw);
+            if (envelope === null) {
+                this.pushEvent(runId, {
+                    type: 'error',
+                    at: new Date().toISOString(),
+                    agent,
+                    errorMessage: 'distiller output has no recognizable ---AGENT-PATCH--- or ---NOOP--- envelope; no draft written.',
+                    runId,
+                });
+                return;
+            }
+            if (envelope.kind === 'noop') {
+                this.pushEvent(runId, {
+                    type: 'done',
+                    at: new Date().toISOString(),
+                    agent,
+                    message: `distiller 判定无值得改的改动（NOOP）：${envelope.rationale}`,
+                    currentVersion,
+                    maturity: ctx.maturity,
+                    runId,
+                });
+                return;
+            }
+            // ── anchor-guard (校验 1 of 2; adopt re-checks). ───────────────────────
+            const violations = scanAgentPatch(envelope.patch);
+            if (violations.length > 0) {
+                this.pushEvent(runId, {
+                    type: 'anchor-rejected',
+                    at: new Date().toISOString(),
+                    agent,
+                    message: `patch 触碰 ${violations.length} 处保护区——草案 REJECTED，未写文件`,
+                    violations: violations.map((v) => ({ region: v.region, line: v.line, patchLine: v.patchLine })),
+                    runId,
+                });
+                this.pushEvent(runId, {
+                    type: 'error',
+                    at: new Date().toISOString(),
+                    agent,
+                    errorMessage: `anchor-guard rejected ${violations.length} protected-region edit(s)`,
+                    runId,
+                });
+                return;
+            }
+            // ── write the human-reviewed DRAFT (NEVER the template). ───────────────
+            const today = new Date().toISOString().slice(0, 10);
+            const outBase = opts.outBaseDir ?? path.join(process.cwd(), 'docs', 'design');
+            const outDir = path.join(outBase, today, 'agent-distill');
+            const targetVersion = envelope.targetVersion ?? currentVersion + 1;
+            const draftPath = path.join(outDir, `${agent}-v${targetVersion}-draft.md`);
+            await fsp.mkdir(outDir, { recursive: true });
+            await fsp.writeFile(draftPath, renderDraft(agent, currentVersion, targetVersion, ctx.maturity, envelope.rationale, envelope.patch), 'utf-8');
+            session.draftPath = draftPath;
+            this.pushEvent(runId, {
+                type: 'draft-written',
+                at: new Date().toISOString(),
+                agent,
+                message: `草案已写入（人审，未落模板）：${draftPath}`,
+                draftPath,
+                targetVersion,
+                currentVersion,
+                maturity: ctx.maturity,
+                runId,
+            });
+            this.pushEvent(runId, {
+                type: 'done',
+                at: new Date().toISOString(),
+                agent,
+                message: '草案生成完成',
+                draftPath,
+                targetVersion,
+                currentVersion,
+                maturity: ctx.maturity,
+                runId,
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            session.lastError = msg;
+            this.pushEvent(runId, {
+                type: 'error',
+                at: new Date().toISOString(),
+                agent,
+                errorMessage: msg,
+                runId,
+            });
+            logger.warn(`[AgentDistillManager] run failed: ${msg}`);
+        }
+        finally {
+            clearPoll();
+            if (ownStorage) {
+                try {
+                    storage.close();
+                }
+                catch { /* ignore */ }
+            }
+        }
+    }
+    /** Test-only: reset internal state. @internal */
+    _reset() {
+        this.running.clear();
+        this.sessions.clear();
+        this.listeners.clear();
+        this.lastFinished = null;
+    }
+}
+/** Module-level singleton (one manager per daemon; per-agent locks inside). */
+export const agentDistillManager = new AgentDistillManager();
+//# sourceMappingURL=agent-distill-manager.js.map

package/dist/web/services/agent-distill-manager.js.map

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

package/dist/web/services/distill-manager.d.ts

@@ -27,6 +27,16 @@
  *    JSON file (writeFile is atomic on POSIX — acceptable, documented in spec).
  */
 import { DEFAULT_STATE_PATH, type DistillState, type RunOptions, type RunResult } from '../../skills/distill/index.js';
+/**
+ * Minimal contract DistillManager needs from the daemon's SkillRegistry —
+ * just `reload()`. Typed structurally (not importing the class) so the web
+ * service stays decoupled from the daemon and no circular import is created
+ * (decision 4e592120). The daemon injects its real singleton via
+ * `setRegistry()` at startup.
+ */
+export interface ReloadableRegistry {
+    reload(): void;
+}
 /**
  * Event types emitted to SSE subscribers.
  * R-D: `gate-paused` removed (no sample-approve gate in R-B; never emitted).
@@ -75,6 +85,20 @@ export declare class DistillManager {
     private sessions;
     private listeners;
     private lastFinished;
+    /**
+     * The daemon's live SkillRegistry singleton. Injected at startup via
+     * `setRegistry()`. When set, a successful distill run that produced new
+     * skill files triggers `reload()` so the dashboard / MCP skill list reflect
+     * the new skill WITHOUT a daemon restart (decision 4e592120 invariant b).
+     * null in tests / pre-injection — sync + reload are then skipped fail-soft.
+     */
+    private registry;
+    /**
+     * Inject the daemon's SkillRegistry so post-distill `reload()` can refresh
+     * the in-memory skill list (used by /api/skills + MCP skill-list, all on the
+     * same singleton). Idempotent; safe to call once at daemon startup.
+     */
+    setRegistry(registry: ReloadableRegistry | null): void;
     /** True when a distill job is currently running. */
     isBusy(): boolean;
     getCurrent(): DistillSession | null;
@@ -108,6 +132,29 @@ export declare class DistillManager {
      * one of: `done`, `cancelled`, `error`.
      */
     private runWithChildProcess;
+    /**
+     * Decision 4e592120 (invariants c/d): copy each freshly-distilled .md from
+     * the runtime write dir into the git source-of-truth `src/skills/distilled`
+     * so a later `npm run build` (rm -rf dist + cp src→dist) does not delete the
+     * new skill. The companion NOTICE attribution stays where the distiller
+     * already wrote it (not touched here).
+     *
+     * Graceful degradation:
+     *  - Packaged/npm-global install → `srcDir` is null (no src/ checkout) → skip
+     *    silently; runtime-only write already satisfies invariant (a).
+     *  - When the runtime write dir IS the src dir (dev/vitest), there is nothing
+     *    to copy → skip.
+     *  - Any individual copy failure is logged at warn and swallowed — a persist
+     *    miss must never fail the distill run (the runtime copy still works).
+     */
+    private persistToSource;
+    /**
+     * Decision 4e592120 (invariant b): reload the injected live SkillRegistry so
+     * the dashboard `/api/skills` list + MCP `skill-list` (same singleton) show
+     * the new skill without a daemon restart. Fail-soft: no registry injected
+     * (tests / pre-wire) or a reload throw is logged and swallowed.
+     */
+    private reloadRegistry;
     /**
      * Test-only: reset internal state.
      * @internal

package/dist/web/services/distill-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distill-manager.d.ts","sourceRoot":"","sources":["../../../src/web/services/distill-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH,OAAO,EAGL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,+BAA+B,CAAC;AAmBvC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,OAAO,GACP,UAAU,GACV,eAAe,GACf,iBAAiB,GACjB,MAAM,GACN,WAAW,GACX,OAAO,CAAC;AAEZ,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,oFAAoF;IACpF,OAAO,EAAE,UAAU,CAAC;IACpB,oDAAoD;IACpD,UAAU,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,+DAA+D;IAC/D,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,MAAM,SAAO;gBACD,GAAG,EAAE,MAAM;CAIxB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,SAAS,CAAqD;IACtE,OAAO,CAAC,YAAY,CAA+B;IACnD,oDAAoD;IACpD,MAAM,IAAI,OAAO;IAIjB,UAAU,IAAI,cAAc,GAAG,IAAI;IAInC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAI7C,eAAe,IAAI,cAAc,GAAG,IAAI;IAIxC;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAyD7C;;;;OAIG;IACH,SAAS,CACP,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAClC,MAAM,IAAI;IAab;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAO9B,OAAO,CAAC,SAAS;IAgBjB;;;;;OAKG;YACW,mBAAmB;IA8GjC;;;OAGG;IACH,MAAM,IAAI,IAAI;CAMf;AAED,2DAA2D;AAC3D,eAAO,MAAM,cAAc,gBAAuB,CAAC;AAEnD,6DAA6D;AAC7D,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,uCAAuC;AACvC,wBAAsB,gBAAgB,CACpC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAE9B;AAED,8CAA8C;AAC9C,wBAAsB,kBAAkB,CACtC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAOlB"}
+{"version":3,"file":"distill-manager.d.ts","sourceRoot":"","sources":["../../../src/web/services/distill-manager.ts"],"names":[],"mappings":"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"}

package/dist/web/services/distill-manager.js

@@ -28,7 +28,9 @@
  */
 import { randomBytes } from 'node:crypto';
 import { promises as fsp } from 'node:fs';
+import path from 'node:path';
 import { logger } from '../../core/utils/logger.js';
+import { resolveDistilledWriteTargets } from '../../core/utils/binary-paths.js';
 import { distillRun, readState, DEFAULT_STATE_PATH, } from '../../skills/distill/index.js';
 // R-A (spec 1851): ClaudeProvider import dropped — distill no longer takes
 // a provider. R-B will replace `runWithPolling` with a child_process spawn.
@@ -57,6 +59,22 @@ export class DistillManager {
     sessions = new Map();
     listeners = new Map();
     lastFinished = null;
+    /**
+     * The daemon's live SkillRegistry singleton. Injected at startup via
+     * `setRegistry()`. When set, a successful distill run that produced new
+     * skill files triggers `reload()` so the dashboard / MCP skill list reflect
+     * the new skill WITHOUT a daemon restart (decision 4e592120 invariant b).
+     * null in tests / pre-injection — sync + reload are then skipped fail-soft.
+     */
+    registry = null;
+    /**
+     * Inject the daemon's SkillRegistry so post-distill `reload()` can refresh
+     * the in-memory skill list (used by /api/skills + MCP skill-list, all on the
+     * same singleton). Idempotent; safe to call once at daemon startup.
+     */
+    setRegistry(registry) {
+        this.registry = registry;
+    }
     /** True when a distill job is currently running. */
     isBusy() {
         return this.current !== null && this.current.doneAt === null;
@@ -175,6 +193,14 @@ export class DistillManager {
      */
     async runWithChildProcess(session, opts) {
         const statePath = opts.statePath ?? DEFAULT_STATE_PATH;
+        // Decision 4e592120 (invariant a): pin the write target to the RUNTIME
+        // read dir (dist in prod, src in dev) resolved binDir-relative — NOT
+        // process.cwd(). Without this, a launchd daemon (cwd=/) falls through to
+        // distillRun's `process.cwd()/src/skills/distilled` default which resolves
+        // to /src/skills/distilled and silently writes nowhere useful. Caller may
+        // still override via opts.outputDir (tests / explicit paths).
+        const writeTargets = resolveDistilledWriteTargets();
+        const outputDir = opts.outputDir ?? writeTargets.runtimeDir;
         // AbortController bridges DistillSession.cancelRequested → child.kill in
         // the distiller. We poll the flag every 100ms (cheaper than rewriting
         // cancel() to be Promise-based).
@@ -208,6 +234,7 @@ export class DistillManager {
             }
             const result = await distillRun({
                 ...opts,
+                outputDir,
                 cancelSignal: abort.signal,
                 onProgress: (ev) => {
                     // Forward partial-message char counts as `progress` events; emit
@@ -250,6 +277,18 @@ export class DistillManager {
                 });
             }
             else {
+                // Decision 4e592120 (invariants b/c/d): only when the run actually
+                // produced new skill files (skip / rejected outcomes yield no .md and
+                // must NOT trigger persist/reload). Persist each produced file into the
+                // git source-of-truth (src/) so a later `npm run build` rebuild does
+                // NOT delete it, then reload the live registry so the dashboard / MCP
+                // skill list reflect the new skill with no daemon restart. Both steps
+                // are fail-soft: a failure here must never turn a successful distill
+                // into a reported error.
+                if (result.distilled.length > 0) {
+                    await this.persistToSource(result, writeTargets);
+                    this.reloadRegistry();
+                }
                 this.pushEvent(session.runId, {
                     type: 'done',
                     at: new Date().toISOString(),
@@ -276,6 +315,69 @@ export class DistillManager {
             logger.warn(`[DistillManager] run failed: ${msg}`);
         }
     }
+    /**
+     * Decision 4e592120 (invariants c/d): copy each freshly-distilled .md from
+     * the runtime write dir into the git source-of-truth `src/skills/distilled`
+     * so a later `npm run build` (rm -rf dist + cp src→dist) does not delete the
+     * new skill. The companion NOTICE attribution stays where the distiller
+     * already wrote it (not touched here).
+     *
+     * Graceful degradation:
+     *  - Packaged/npm-global install → `srcDir` is null (no src/ checkout) → skip
+     *    silently; runtime-only write already satisfies invariant (a).
+     *  - When the runtime write dir IS the src dir (dev/vitest), there is nothing
+     *    to copy → skip.
+     *  - Any individual copy failure is logged at warn and swallowed — a persist
+     *    miss must never fail the distill run (the runtime copy still works).
+     */
+    async persistToSource(result, targets) {
+        const { runtimeDir, srcDir } = targets;
+        // No src checkout (packaged) or runtime IS the source (dev) → nothing to do.
+        if (!srcDir)
+            return;
+        if (path.resolve(srcDir) === path.resolve(runtimeDir))
+            return;
+        try {
+            await fsp.mkdir(srcDir, { recursive: true });
+        }
+        catch (err) {
+            logger.warn(`[DistillManager] persist: failed to ensure src dir ${srcDir}: ${err}`);
+            return;
+        }
+        for (const r of result.distilled) {
+            try {
+                const fileName = path.basename(r.outputPath);
+                // The distiller wrote to runtimeDir (we pinned outputDir). Copy that
+                // exact produced file into src so the two stay byte-identical.
+                const from = r.outputPath;
+                const to = path.join(srcDir, fileName);
+                await fsp.copyFile(from, to);
+                logger.info(`[DistillManager] persisted ${fileName} → ${to}`);
+            }
+            catch (err) {
+                logger.warn(`[DistillManager] persist: failed to copy ${r.outputPath} to src: ${err}`);
+            }
+        }
+    }
+    /**
+     * Decision 4e592120 (invariant b): reload the injected live SkillRegistry so
+     * the dashboard `/api/skills` list + MCP `skill-list` (same singleton) show
+     * the new skill without a daemon restart. Fail-soft: no registry injected
+     * (tests / pre-wire) or a reload throw is logged and swallowed.
+     */
+    reloadRegistry() {
+        if (!this.registry) {
+            logger.debug('[DistillManager] reload skipped: no registry injected');
+            return;
+        }
+        try {
+            this.registry.reload();
+            logger.info('[DistillManager] SkillRegistry reloaded after distill');
+        }
+        catch (err) {
+            logger.warn(`[DistillManager] registry reload failed (non-fatal): ${err}`);
+        }
+    }
     /**
      * Test-only: reset internal state.
      * @internal
@@ -285,6 +387,7 @@ export class DistillManager {
         this.sessions.clear();
         this.listeners.clear();
         this.lastFinished = null;
+        this.registry = null;
     }
 }
 /** Module-level singleton (one distill job per daemon). */