@winspan/claude-forge 8.54.3 → 9.2.0

package/dist/web/routes/violations.js

@@ -0,0 +1,111 @@
+/**
+ * /api/violations — recent main-thread violations API
+ *
+ * Reads from the same two signal sources as the Stop-hook violation reporter:
+ *   1. routing_events.obeyed = 0 (rolling window)
+ *   2. UserPromptSubmit user_prompt matching violation keywords
+ *
+ * No new schema — wraps `collectViolations()` (which is already covered by
+ * unit tests in tests/unit/daemon/services/violation-reporter.test.ts).
+ */
+import { collectViolations, countViolationsBySignal, formatRelative, } from '../../daemon/services/violation-reporter.js';
+function toApi(v) {
+    return {
+        timestamp: v.timestamp,
+        summary: v.user_prompt_summary,
+        signal: v.signal,
+        detectedKeyword: v.detected_keyword ?? null,
+        expectedAgent: v.expected_agent ?? null,
+        relativeTime: formatRelative(v.timestamp),
+    };
+}
+export function registerViolationsRoutes(app, ctx) {
+    const { storage } = ctx;
+    app.get('/api/violations', (req, res) => {
+        // days: default 7, clamp [1, 30]
+        const daysRaw = req.query.days;
+        const days = parseInt(typeof daysRaw === 'string' ? daysRaw : '7', 10);
+        if (Number.isNaN(days) || days < 1 || days > 30) {
+            res.status(400).json({ error: 'invalid_days' });
+            return;
+        }
+        // limit: default 5, clamp [1, 100]
+        // 2026-05-26: widened ceiling from 20 → 100 to support the ViolationsPage
+        // pagination control (page sizes 20/40/80). Old default + lower-bound clamp
+        // unchanged for backward compat with existing /violations consumers.
+        const limitRaw = req.query.limit;
+        const limit = parseInt(typeof limitRaw === 'string' ? limitRaw : '5', 10);
+        if (Number.isNaN(limit) || limit < 1 || limit > 100) {
+            res.status(400).json({ error: 'invalid_limit' });
+            return;
+        }
+        // offset: default 0, must be >= 0 (added 2026-05-26 for paginator support)
+        const offsetRaw = req.query.offset;
+        const offset = parseInt(typeof offsetRaw === 'string' ? offsetRaw : '0', 10);
+        if (Number.isNaN(offset) || offset < 0) {
+            res.status(400).json({ error: 'invalid_offset' });
+            return;
+        }
+        const projectPath = typeof req.query.project === 'string' && req.query.project.length > 0
+            ? req.query.project
+            : undefined;
+        try {
+            // 2026-05-26: server-side pagination via offset. We pull a high cap
+            // through collectViolations and slice [offset, offset+limit] ourselves
+            // so dedupe + sort logic stays inside one place. MAX_SCAN inside the
+            // collect helper bounds the per-source scan; the deduped set caps at
+            // ~3 * MAX_SCAN = 600 rows, so a synthetic 1000 ceiling here will never
+            // truncate before our own slice.
+            const PAGINATION_CEILING = 1000;
+            const rawAll = collectViolations(storage, {
+                days,
+                limit: PAGINATION_CEILING,
+                projectPath,
+            });
+            const paged = rawAll.slice(offset, offset + limit);
+            const violations = paged.map(toApi);
+            // Unbounded counts for the Web KPI "近 7d 共 N 条 violation" and the
+            // InterceptsTab "tool intercept (7d)" stat. Frontend used to bind to
+            // `count` (= violations.length AFTER slice(0, limit)) which capped the
+            // KPI at limit (≤20). total_in_window is the deduped true count;
+            // total_by_signal_in_window splits it by source so the InterceptsTab
+            // can show the unbounded tool-intercept count without re-fetching with
+            // a higher limit. Added 2026-05-26 — see changelog.
+            //
+            // Pagination note: total_in_window MUST stay invariant across offset
+            // values so the paginator can compute total pages = ceil(total/pageSize).
+            let totalInWindow = rawAll.length;
+            let totalBySignal = {
+                routing_disobeyed: 0,
+                user_keyword: 0,
+                tool_intercept: 0,
+            };
+            try {
+                const counts = countViolationsBySignal(storage, { days, projectPath });
+                totalInWindow = counts.total;
+                totalBySignal = counts.by_signal;
+            }
+            catch {
+                // Best-effort: fall back to capped count so the page still renders
+                // even if the count helper hits a storage hiccup.
+            }
+            res.json({
+                generatedAt: new Date().toISOString(),
+                windowDays: days,
+                limit,
+                offset,
+                count: violations.length,
+                total_in_window: totalInWindow,
+                total_by_signal_in_window: totalBySignal,
+                violations,
+            });
+        }
+        catch (err) {
+            res.status(500).json({
+                error: 'internal',
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+}
+//# sourceMappingURL=violations.js.map

package/dist/web/routes/violations.js.map

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

package/dist/web/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AA0BrE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,qBAAa,SAAS;IAIR,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,MAAM,CAA0D;gBAEpD,OAAO,EAAE,gBAAgB;IAU7C,OAAO,CAAC,WAAW;IAqDb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAuDrE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,qBAAa,SAAS;IAIR,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,MAAM,CAA0D;gBAEpD,OAAO,EAAE,gBAAgB;IA4B7C,OAAO,CAAC,WAAW;IAmEb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}

package/dist/web/server.js

@@ -5,6 +5,7 @@
  * modules under src/web/routes/, and owns lifecycle (start/stop).
  */
 import express from 'express';
+import compression from 'compression';
 import { logger } from '../core/utils/logger.js';
 import { ErrorHandler } from '../core/utils/error-handler.js';
 import { requireAuth } from './auth-middleware.js';
@@ -13,20 +14,49 @@ import { errorHandler, notFoundHandler } from './routes/error-handler.js';
 import { registerAuthRoutes } from './routes/auth.js';
 import { registerStaticAssets, registerStaticFallback } from './routes/static.js';
 import { registerStatusRoutes } from './routes/status.js';
-import { registerEventsRoutes } from './routes/events.js';
 import { registerSessionsRoutes } from './routes/sessions.js';
-import { registerTokenUsageRoutes } from './routes/token-usage.js';
-import { registerAIRoutes } from './routes/ai.js';
-import { registerPatchRoutes } from './routes/patch.js';
-import { registerSkillsRoutes } from './routes/skills.js';
+// AI routes removed by sub-spec D R-C (spec 0902 / decision f5a5b030):
+// `/api/ai/*` + `/api/config/ai` 端点全部下线，AI 流程改走 `claude` CLI 子进程
+// (sub-spec A/B/C)。SettingsPage 的 AI 配置面与 CLI menu 的 model picker
+// 一同删除；前端不再有任何 `/api/ai/*` 消费者。R-D 阶段会进一步删
+// ConfigManager.ai.* schema。
 import { registerTasksRoutes } from './routes/tasks.js';
-import { registerStatsRoutes } from './routes/stats.js';
-import { registerSkillStatsRoutes } from './routes/skill-stats.js';
+import { registerTaskTimelineRoutes } from './routes/task-timeline.js'; // v6 Batch 2 spec 1750
 import { registerRulesRoutes } from './routes/rules.js';
 import { registerDriftRoutes } from './routes/drift.js';
-import { registerTraceRoutes } from './routes/trace.js';
-import { registerReportsRoutes } from './routes/reports.js';
 import { registerInsightsRoutes } from './routes/insights.js';
+import { registerViolationsRoutes } from './routes/violations.js';
+// spec 3 partial revert (2026-05-27): originally 12 route modules were
+// disabled (Option B = FE 隐藏 + 后端 register 注释), but user feedback
+// restored 4 FE pages (/context, /context/skill, /context/agent, /settings)
+// so 6 of the 12 route modules are re-enabled to back those pages.
+//
+// Re-enabled (6 / FE deps):
+//   - knowledge       (ContextInsightsPage 知识库 tab)
+//   - skills          (ContextInsightsPage skills tab)
+//   - skill-stats     (ContextInsightsPage skills tab 详情)
+//   - skill-content   (SkillContentPage)
+//   - agent-content   (AgentContentPage)
+//   - skills-distill  (ContextInsightsPage skills tab)
+//
+// Still disabled (6 / no FE consumer): events, patch, stats, trace, reports,
+// pipeline. Revert recipe (any single one): uncomment its import below + its
+// register*Routes(app, ctx) call in setupRoutes() and rebuild.
+import { registerKnowledgeRoutes } from './routes/knowledge.js';
+import { registerSkillsRoutes } from './routes/skills.js';
+import { registerSkillStatsRoutes } from './routes/skill-stats.js';
+import { registerSkillContentRoutes } from './routes/skill-content.js';
+import { registerAgentContentRoutes } from './routes/agent-content.js';
+import { registerSkillsDistillRoutes } from './routes/skills-distill.js';
+import { registerHealthRoutes } from './routes/health.js';
+import { registerDecisionsRoutes } from './routes/decisions.js';
+import { registerPatchRoutes } from './routes/patch.js'; // sub-spec C R-B: shell-out to patch-applier agent
+import { registerDiagnosticsRoutes } from './routes/diagnostics.js'; // spec 1a41b43a: cf doctor + cf fix Web surface
+import { registerEventsRoutes } from './routes/events.js'; // re-enabled 2026-06-02: TasksHubPage SSE realtime (/api/events/stream) consumer restored
+// import { registerStatsRoutes } from './routes/stats.js';
+// import { registerTraceRoutes } from './routes/trace.js';
+// import { registerReportsRoutes } from './routes/reports.js';
+import { registerPipelineRoutes } from './routes/pipeline.js'; // re-enabled 2026-06-08 (decision 5266724a): DetailDrawer ?prompt= → /api/insights/pipeline?event_id= was 404 because this route was never mounted
 export class WebServer {
     options;
     app;
@@ -34,6 +64,22 @@ export class WebServer {
     constructor(options) {
         this.options = options;
         this.app = express();
+        // perf P1.4 (2026-05-25): gzip middleware. Default threshold 1KB; cuts
+        // first-load wire size ~3x for the SPA bundle (1.8MB → ~600KB) and most
+        // JSON APIs (insights/agent-board especially benefits). Already-compressed
+        // assets (images, woff2) are skipped automatically.
+        // SSE (text/event-stream) MUST be excluded: compression buffers the stream
+        // and never flushes per-event, so /api/events/stream would hang (client gets
+        // 200 headers but zero body). Skip compression for SSE; compress everything
+        // else via the package's default heuristic.
+        this.app.use(compression({
+            filter: (req, res) => {
+                const ct = String(res.getHeader('Content-Type') ?? '');
+                if (ct.includes('text/event-stream'))
+                    return false;
+                return compression.filter(req, res);
+            },
+        }));
         // Security: limit request body size to prevent DoS attacks
         this.app.use(express.json({ limit: '10mb' }));
         this.app.use(express.urlencoded({ extended: true, limit: '10mb' }));
@@ -53,22 +99,36 @@ export class WebServer {
         registerAuthRoutes(this.app, ctx);
         // 2. Static assets (serves UI; fallback registered last)
         registerStaticAssets(this.app, ctx);
-        // 3. API routes
+        // 3. API routes — spec 3 partial revert (2026-05-27): 6 register* lines
+        //    re-enabled to back restored FE pages (/context, /context/skill/:id,
+        //    /context/agent/:name, /settings). 6 still disabled (no FE consumer).
+        //
+        //    sub-spec D R-C (2026-05-29, spec 0902): registerAIRoutes 永久删除 ——
+        //    `/api/ai/*` 与 `/api/config/ai` 全部下线，CLI menu 的 model picker /
+        //    SettingsPage 的 AI 配置面同步删除。
         registerStatusRoutes(this.app, ctx);
-        registerEventsRoutes(this.app, ctx);
         registerSessionsRoutes(this.app, ctx);
-        registerTokenUsageRoutes(this.app, ctx);
-        registerAIRoutes(this.app, ctx);
-        registerPatchRoutes(this.app, ctx);
-        registerSkillsRoutes(this.app, ctx);
         registerTasksRoutes(this.app, ctx);
-        registerStatsRoutes(this.app, ctx);
-        registerSkillStatsRoutes(this.app, ctx);
+        registerTaskTimelineRoutes(this.app, ctx); // v6 Batch 2 spec 1750: GET /api/tasks/:id/timeline
         registerRulesRoutes(this.app, ctx);
         registerDriftRoutes(this.app, ctx);
-        registerTraceRoutes(this.app, ctx);
-        registerReportsRoutes(this.app, ctx);
         registerInsightsRoutes(this.app, ctx);
+        registerViolationsRoutes(this.app, ctx);
+        registerKnowledgeRoutes(this.app, ctx); // restored: ContextInsightsPage KB tab
+        registerSkillsRoutes(this.app, ctx); // restored: ContextInsightsPage skills tab
+        registerSkillStatsRoutes(this.app, ctx); // restored: ContextInsightsPage skills tab 详情
+        registerSkillContentRoutes(this.app, ctx); // restored: SkillContentPage
+        registerAgentContentRoutes(this.app, ctx); // restored: AgentContentPage
+        registerSkillsDistillRoutes(this.app, ctx); // restored: ContextInsightsPage skills tab
+        registerHealthRoutes(this.app, ctx); // watchdog spec 0843: /api/health for daemon badge
+        registerDecisionsRoutes(this.app, ctx); // decision-flow-overhaul 2026-05-28: /api/decisions
+        registerPatchRoutes(this.app, ctx); // sub-spec C R-B (2026-05-29): patch web 接通 claude CLI shell-out
+        registerDiagnosticsRoutes(this.app, ctx); // spec 1a41b43a (2026-06-01): /api/diagnostics + /api/diagnostics/fix
+        registerEventsRoutes(this.app, ctx); // re-enabled 2026-06-02: /api/events/stream SSE feeds TasksHubPage realtime
+        // registerStatsRoutes(this.app, ctx);           // disabled by spec 3
+        // registerTraceRoutes(this.app, ctx);           // disabled by spec 3
+        // registerReportsRoutes(this.app, ctx);         // disabled by spec 3 (CLI `forge report` uses weekly-report.ts directly, not HTTP)
+        registerPipelineRoutes(this.app, ctx); // re-enabled 2026-06-08 (decision 5266724a): backs DetailDrawer ?prompt= 5-step view via /api/insights/pipeline?event_id=
         // 4. MCP server — mounted on /mcp (Streamable HTTP)
         if (this.options.skillRegistry) {
             mountMcpServer(this.app, {

package/dist/web/server.js.map

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

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

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