@winspan/claude-forge 8.54.4 → 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/build-manager.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Knowledge build manager — single-instance concurrency control + event broadcast
+ * for `cf knowledge build` invocations issued via the web API.
+ *
+ * Design (v9.4):
+ *  - Only one build can run at a time (global singleton).
+ *  - Build events accumulate in `session.events[]` so SSE clients can replay
+ *    history after reconnect.
+ *  - Finished sessions live for 5 minutes (SESSION_TTL_MS) then are garbage-collected.
+ *  - Listener errors are caught — they never propagate to the builder.
+ *  - Persistence: in-memory only (decision D3). Daemon restart loses state.
+ */
+import type { BuildOptions, BuildEvent, BuildResult } from '../../knowledge/builder.js';
+import type { SQLiteStorage } from '../../core/storage/sqlite.js';
+export interface BuildSession {
+    buildId: string;
+    startedAt: number;
+    doneAt: number | null;
+    events: BuildEvent[];
+    /** Original options the caller passed (sans `onEvent`). */
+    options: BuildOptions;
+    /** Final `BuildResult.stats` once `done` fires; null on error/early state. */
+    lastStats: BuildResult['stats'] | null;
+}
+export declare class ConflictError extends Error {
+    status: number;
+    constructor(msg: string);
+}
+export declare class BuildManager {
+    private current;
+    private sessions;
+    private listeners;
+    /** Last finished session — kept around so /stats can show "last build" info. */
+    private lastFinished;
+    /** Storage handle for kb_build_log telemetry (v9.5). Injected by daemon bootstrap. */
+    private storage;
+    /**
+     * Inject a storage handle for telemetry (v9.5). Called once from daemon
+     * bootstrap. Tests can skip this — when storage is null, no rows are written.
+     */
+    setStorage(storage: SQLiteStorage): void;
+    /** True when a build is currently running. */
+    isBusy(): boolean;
+    getCurrent(): BuildSession | null;
+    getSession(id: string): BuildSession | null;
+    /** Returns the most recently completed session (any status). */
+    getLastFinished(): BuildSession | null;
+    /**
+     * Kick off a new build. Throws ConflictError if one is already running.
+     *
+     * Returns immediately — the actual buildKnowledge call runs in the
+     * background. Subscribers receive events via `subscribe()`.
+     */
+    start(options: BuildOptions): {
+        buildId: string;
+    };
+    /**
+     * Subscribe to future events for this build. Returns an unsubscribe fn.
+     *
+     * Note: does NOT replay history — callers (e.g. SSE handler) replay
+     * `session.events` directly before subscribing.
+     */
+    subscribe(buildId: string, listener: (e: BuildEvent) => void): () => void;
+    /**
+     * Test-only: reset internal state.
+     * @internal
+     */
+    _reset(): void;
+}
+/** Module-level singleton (one build per daemon). */
+export declare const buildManager: BuildManager;
+//# sourceMappingURL=build-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-manager.d.ts","sourceRoot":"","sources":["../../../src/web/services/build-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAExF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAIlE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,2DAA2D;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,8EAA8E;IAC9E,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CACxC;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,MAAM,SAAO;gBACD,GAAG,EAAE,MAAM;CAIxB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,SAAS,CAAmD;IACpE,gFAAgF;IAChF,OAAO,CAAC,YAAY,CAA6B;IACjD,sFAAsF;IACtF,OAAO,CAAC,OAAO,CAA8B;IAE7C;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIxC,8CAA8C;IAC9C,MAAM,IAAI,OAAO;IAIjB,UAAU,IAAI,YAAY,GAAG,IAAI;IAIjC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAI3C,gEAAgE;IAChE,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;IAuGjD;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAazE;;;OAGG;IACH,MAAM,IAAI,IAAI;CAMf;AAED,qDAAqD;AACrD,eAAO,MAAM,YAAY,cAAqB,CAAC"}

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

@@ -0,0 +1,189 @@
+/**
+ * Knowledge build manager — single-instance concurrency control + event broadcast
+ * for `cf knowledge build` invocations issued via the web API.
+ *
+ * Design (v9.4):
+ *  - Only one build can run at a time (global singleton).
+ *  - Build events accumulate in `session.events[]` so SSE clients can replay
+ *    history after reconnect.
+ *  - Finished sessions live for 5 minutes (SESSION_TTL_MS) then are garbage-collected.
+ *  - Listener errors are caught — they never propagate to the builder.
+ *  - Persistence: in-memory only (decision D3). Daemon restart loses state.
+ */
+import { randomBytes } from 'node:crypto';
+import { buildKnowledge } from '../../knowledge/builder.js';
+import { logger } from '../../core/utils/logger.js';
+const SESSION_TTL_MS = 5 * 60 * 1000;
+export class ConflictError extends Error {
+    status = 409;
+    constructor(msg) {
+        super(msg);
+        this.name = 'ConflictError';
+    }
+}
+export class BuildManager {
+    current = null;
+    sessions = new Map();
+    listeners = new Map();
+    /** Last finished session — kept around so /stats can show "last build" info. */
+    lastFinished = null;
+    /** Storage handle for kb_build_log telemetry (v9.5). Injected by daemon bootstrap. */
+    storage = null;
+    /**
+     * Inject a storage handle for telemetry (v9.5). Called once from daemon
+     * bootstrap. Tests can skip this — when storage is null, no rows are written.
+     */
+    setStorage(storage) {
+        this.storage = storage;
+    }
+    /** True when a build is currently running. */
+    isBusy() {
+        return this.current !== null && this.current.doneAt === null;
+    }
+    getCurrent() {
+        return this.current;
+    }
+    getSession(id) {
+        return this.sessions.get(id) ?? null;
+    }
+    /** Returns the most recently completed session (any status). */
+    getLastFinished() {
+        return this.lastFinished;
+    }
+    /**
+     * Kick off a new build. Throws ConflictError if one is already running.
+     *
+     * Returns immediately — the actual buildKnowledge call runs in the
+     * background. Subscribers receive events via `subscribe()`.
+     */
+    start(options) {
+        if (this.isBusy()) {
+            throw new ConflictError(`Build already running: ${this.current.buildId}`);
+        }
+        const buildId = `build-${randomBytes(6).toString('hex')}`;
+        const session = {
+            buildId,
+            startedAt: Date.now(),
+            doneAt: null,
+            events: [],
+            options,
+            lastStats: null,
+        };
+        this.current = session;
+        this.sessions.set(buildId, session);
+        // Telemetry: write 'running' row immediately (v9.5).
+        if (this.storage) {
+            try {
+                this.storage.writeKbBuildLog({
+                    build_id: buildId,
+                    ts: session.startedAt,
+                    project_path: options.projectRoot ?? process.cwd(),
+                    options_json: JSON.stringify({
+                        apply: options.apply,
+                        force: options.force,
+                        skipCrossModule: options.skipCrossModule,
+                        modules: options.modules,
+                    }),
+                    status: 'running',
+                });
+            }
+            catch (err) {
+                logger.warn(`[BuildManager] telemetry write failed: ${err}`);
+            }
+        }
+        const onEvent = (ev) => {
+            session.events.push(ev);
+            if (ev.type === 'done') {
+                session.lastStats = ev.stats;
+            }
+            const subs = this.listeners.get(buildId);
+            if (subs) {
+                for (const fn of subs) {
+                    try {
+                        fn(ev);
+                    }
+                    catch (err) {
+                        logger.warn(`[BuildManager] listener error: ${err}`);
+                    }
+                }
+            }
+        };
+        // Fire-and-forget. Capture failures as a synthetic 'error' event so SSE
+        // clients always see a terminal event.
+        void buildKnowledge({ ...options, onEvent })
+            .catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            onEvent({ type: 'error', message });
+            // Telemetry: mark as 'error' (v9.5).
+            if (this.storage) {
+                try {
+                    this.storage.updateKbBuildLog(buildId, {
+                        status: 'error',
+                        error_message: message,
+                        duration_ms: Date.now() - session.startedAt,
+                    });
+                }
+                catch (e) {
+                    logger.warn(`[BuildManager] telemetry update failed: ${e}`);
+                }
+            }
+        })
+            .finally(() => {
+            session.doneAt = Date.now();
+            this.lastFinished = session;
+            if (this.current === session)
+                this.current = null;
+            // Telemetry: mark as 'done' if lastStats exists (v9.5).
+            if (this.storage && session.lastStats) {
+                try {
+                    this.storage.updateKbBuildLog(buildId, {
+                        status: 'done',
+                        stats_json: JSON.stringify(session.lastStats),
+                        duration_ms: session.doneAt - session.startedAt,
+                    });
+                }
+                catch (e) {
+                    logger.warn(`[BuildManager] telemetry update failed: ${e}`);
+                }
+            }
+            // Schedule GC after TTL.
+            setTimeout(() => {
+                this.sessions.delete(buildId);
+                this.listeners.delete(buildId);
+            }, SESSION_TTL_MS).unref?.();
+        });
+        return { buildId };
+    }
+    /**
+     * Subscribe to future events for this build. Returns an unsubscribe fn.
+     *
+     * Note: does NOT replay history — callers (e.g. SSE handler) replay
+     * `session.events` directly before subscribing.
+     */
+    subscribe(buildId, listener) {
+        let set = this.listeners.get(buildId);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(buildId, set);
+        }
+        set.add(listener);
+        return () => {
+            const s = this.listeners.get(buildId);
+            if (s)
+                s.delete(listener);
+        };
+    }
+    /**
+     * Test-only: reset internal state.
+     * @internal
+     */
+    _reset() {
+        this.current = null;
+        this.sessions.clear();
+        this.listeners.clear();
+        this.lastFinished = null;
+    }
+}
+/** Module-level singleton (one build per daemon). */
+export const buildManager = new BuildManager();
+//# sourceMappingURL=build-manager.js.map