@winspan/claude-forge 8.30.0 → 8.33.2

package/dist/web/routes/execution-trace.js

@@ -0,0 +1,308 @@
+import { logger } from '../../core/utils/logger.js';
+/**
+ * /api/execution-trace/* — routing-event-centric traces + SSE live status.
+ *
+ * Registration order mirrors the original server.ts exactly. In particular,
+ * `/stream` is registered AFTER `/:id`, which means Express matches `/stream`
+ * against `/:id` first (Number('stream') = NaN → 400). This preserves the
+ * original behaviour; fixing it is out of scope for this split.
+ * FIXME: `/api/execution-trace/stream` is shadowed by `/:id` — out of scope for this split.
+ */
+export function registerExecutionTraceRoutes(app, ctx) {
+    const { storage } = ctx;
+    // GET /api/execution-trace — list execution traces with routing info
+    app.get('/api/execution-trace', (req, res) => {
+        try {
+            const limit = parseInt(req.query.limit) || 50;
+            const agentFilter = req.query.agent;
+            const obeyedFilter = req.query.obeyed;
+            const db = storage.getDatabase();
+            let sql = `
+        SELECT
+          re.id,
+          re.session_id,
+          re.route_request_id,
+          re.project_path,
+          re.ts,
+          re.prompt,
+          re.intent_json,
+          re.routed_to_type,
+          re.routed_to_name,
+          re.obeyed,
+          re.classification_ms,
+          re.fallback_used,
+          re.first_tool_name,
+          re.first_tool_ts,
+          re.completed_ts,
+          re.total_execution_ms,
+          re.completion_reason,
+          re.downstream_task_chain,
+          s.status as session_status,
+          s.start_time,
+          s.end_time,
+          s.event_count
+        FROM routing_events re
+        LEFT JOIN sessions s ON re.session_id = s.session_id
+        WHERE 1=1
+      `;
+            const params = [];
+            if (agentFilter) {
+                sql += ` AND re.routed_to_name = ?`;
+                params.push(agentFilter);
+            }
+            // TRACE_APPEND
+            if (obeyedFilter === 'true') {
+                sql += ` AND re.obeyed = 1`;
+            }
+            else if (obeyedFilter === 'false') {
+                sql += ` AND re.obeyed = 0`;
+            }
+            sql += ` ORDER BY re.ts DESC LIMIT ?`;
+            params.push(limit);
+            const rows = db.prepare(sql).all(...params);
+            const traces = rows.map(row => ({
+                id: row.id,
+                sessionId: row.session_id,
+                routeRequestId: row.route_request_id,
+                projectPath: row.project_path,
+                timestamp: row.ts,
+                prompt: row.prompt,
+                intent: JSON.parse(row.intent_json || '{}'),
+                routedToType: row.routed_to_type,
+                routedToName: row.routed_to_name,
+                obeyed: row.obeyed,
+                classificationMs: row.classification_ms,
+                fallbackUsed: row.fallback_used === 1,
+                firstTool: row.first_tool_name,
+                firstToolTs: row.first_tool_ts,
+                completedTs: row.completed_ts,
+                totalExecutionMs: row.total_execution_ms,
+                completionReason: row.completion_reason,
+                taskChain: row.downstream_task_chain ? JSON.parse(row.downstream_task_chain) : [],
+                sessionStatus: row.session_status,
+                sessionStart: row.start_time,
+                sessionEnd: row.end_time,
+                eventCount: row.event_count,
+            }));
+            res.json({ traces });
+        }
+        catch (err) {
+            logger.warn(`[Web] Failed to get execution traces: ${err}`);
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // GET /api/execution-trace/:id — detailed trace for a routing event
+    app.get('/api/execution-trace/:id', (req, res) => {
+        try {
+            const id = Number(req.params.id);
+            if (!Number.isFinite(id)) {
+                res.status(400).json({ error: 'Invalid trace id' });
+                return;
+            }
+            const db = storage.getDatabase();
+            const routing = db.prepare(`SELECT * FROM routing_events WHERE id = ?`).get(id);
+            if (!routing) {
+                res.status(404).json({ error: 'Trace not found' });
+                return;
+            }
+            const sessionId = routing.session_id;
+            const routeRequestId = routing.route_request_id ?? null;
+            const events = db.prepare(`
+        SELECT event_id, timestamp, hook_type, tool_name, user_prompt
+        FROM events
+        WHERE session_id = ?
+        ORDER BY timestamp ASC
+      `).all(sessionId);
+            const injections = db.prepare(`
+        SELECT injection_type, content, timestamp
+        FROM injections
+        WHERE session_id = ?
+        ORDER BY timestamp ASC
+      `).all(sessionId);
+            const agentCallRows = routeRequestId
+                ? db.prepare(`
+            SELECT id, tool, args, success, error, timestamp
+            FROM v2_tool_events
+            WHERE route_request_id = ? AND tool IN ('Agent','Task')
+            ORDER BY timestamp ASC
+          `).all(routeRequestId)
+                : [];
+            const postUseRows = db.prepare(`
+        SELECT event_id, timestamp, tool_name
+        FROM events
+        WHERE session_id = ? AND hook_type = 'PostToolUse' AND tool_name IN ('Agent','Task')
+          AND timestamp >= ?
+        ORDER BY timestamp ASC
+      `).all(sessionId, new Date(routing.ts).toISOString());
+            const agentCalls = agentCallRows.map(r => {
+                let subagent = null;
+                try {
+                    const parsed = JSON.parse(r.args || '{}');
+                    if (typeof parsed.subagent_type === 'string')
+                        subagent = parsed.subagent_type;
+                }
+                catch { /* ignore */ }
+                const completed = postUseRows.find(p => p.tool_name === r.tool && new Date(p.timestamp).getTime() >= r.timestamp);
+                return {
+                    toolEventId: r.id,
+                    tool: r.tool,
+                    subagent,
+                    startedTs: r.timestamp,
+                    allowed: r.success === 1,
+                    error: r.error,
+                    completedTs: completed ? new Date(completed.timestamp).getTime() : null,
+                    completedEventId: completed?.event_id ?? null,
+                    status: !completed ? 'started' : 'completed',
+                };
+            });
+            res.json({
+                routing: {
+                    id: routing.id,
+                    sessionId,
+                    routeRequestId,
+                    prompt: routing.prompt,
+                    timestamp: routing.ts,
+                    intent: JSON.parse(routing.intent_json || '{}'),
+                    routedToType: routing.routed_to_type,
+                    routedToName: routing.routed_to_name,
+                    obeyed: routing.obeyed,
+                    classificationMs: routing.classification_ms,
+                    fallbackUsed: routing.fallback_used === 1,
+                    refusalReason: routing.refusal_reason,
+                    firstTool: routing.first_tool_name,
+                    firstToolTs: routing.first_tool_ts,
+                    completedTs: routing.completed_ts,
+                    totalExecutionMs: routing.total_execution_ms,
+                    completionReason: routing.completion_reason,
+                    taskChain: routing.downstream_task_chain ? JSON.parse(routing.downstream_task_chain) : [],
+                },
+                events,
+                injections,
+                agentCalls,
+            });
+        }
+        catch (err) {
+            logger.warn(`[Web] Failed to get trace details for ${req.params.id}: ${err}`);
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // GET /api/execution-trace/:session_id/status — current status snapshot
+    app.get('/api/execution-trace/:session_id/status', (req, res) => {
+        try {
+            const { session_id } = req.params;
+            const db = storage.getDatabase();
+            const routing = db.prepare(`SELECT * FROM routing_events WHERE session_id = ? ORDER BY ts DESC LIMIT 1`).get(session_id);
+            if (!routing) {
+                res.status(404).json({ error: 'Trace not found' });
+                return;
+            }
+            const latestToolEvent = db.prepare(`
+        SELECT tool, success, error, timestamp
+        FROM v2_tool_events
+        WHERE session_id = ? AND timestamp >= ?
+        ORDER BY timestamp DESC LIMIT 1
+      `).get(session_id, routing.ts);
+            const latestDecision = db.prepare(`
+        SELECT level, reason, timestamp
+        FROM v2_decisions
+        WHERE session_id = ? AND timestamp >= ?
+        ORDER BY timestamp DESC LIMIT 1
+      `).get(session_id, routing.ts);
+            let status = 'routing';
+            if (latestDecision?.level === 'block' || latestToolEvent?.success === 0)
+                status = 'failed';
+            else if (routing.completed_ts)
+                status = 'completed';
+            else if (routing.first_tool_ts || latestToolEvent)
+                status = 'executing';
+            res.json({
+                status,
+                timestamp: routing.ts,
+                firstTool: routing.first_tool_name ?? latestToolEvent?.tool ?? null,
+                firstToolTs: routing.first_tool_ts ?? latestToolEvent?.timestamp ?? null,
+                completedTs: routing.completed_ts ?? null,
+                totalExecutionMs: routing.total_execution_ms ?? null,
+                completionReason: routing.completion_reason ?? null,
+                error: latestToolEvent?.success === 0 ? latestToolEvent.error : (latestDecision?.level === 'block' ? latestDecision.reason : null),
+            });
+        }
+        catch (err) {
+            logger.warn(`[Web] Failed to get trace status for ${req.params.session_id}: ${err}`);
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // SSE: execution trace live status stream
+    // NOTE: registered AFTER /:id to match original server.ts ordering.
+    app.get('/api/execution-trace/stream', (req, res) => {
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+        });
+        res.write('data: {"type":"connected"}\n\n');
+        const filterSession = req.query.session;
+        const readOnlyTools = new Set(['Read', 'Grep', 'Glob', 'LS', 'NotebookRead', 'WebFetch', 'WebSearch']);
+        const writeStatus = (payload) => {
+            if (filterSession && payload.sessionId !== filterSession)
+                return;
+            res.write(`data: ${JSON.stringify(payload)}\n\n`);
+        };
+        const onEvent = (event) => {
+            const hookType = event.hook_type;
+            const toolName = event.tool_name;
+            const sessionId = event.session_id;
+            const timestamp = event.timestamp;
+            if (!sessionId || !hookType)
+                return;
+            if (hookType === 'UserPromptSubmit') {
+                writeStatus({ type: 'execution-status', status: 'routing', sessionId, timestamp, prompt: event.user_prompt ?? null });
+                return;
+            }
+            if (hookType === 'PreToolUse' && toolName && !readOnlyTools.has(toolName)) {
+                writeStatus({ type: 'execution-status', status: 'executing', sessionId, timestamp, tool: toolName });
+                return;
+            }
+            if (hookType === 'Stop') {
+                writeStatus({ type: 'execution-status', status: 'completed', sessionId, timestamp });
+            }
+        };
+        const onToolEvent = (event) => {
+            const sessionId = event.session_id;
+            if (!sessionId)
+                return;
+            if (event.success === false || event.success === 0) {
+                writeStatus({
+                    type: 'execution-status',
+                    status: 'failed',
+                    sessionId,
+                    timestamp: event.timestamp ?? Date.now(),
+                    tool: event.tool ?? null,
+                    error: event.error ?? null,
+                });
+            }
+        };
+        const onDecision = (decision) => {
+            const sessionId = decision.session_id;
+            if (!sessionId)
+                return;
+            if (decision.level === 'block') {
+                writeStatus({
+                    type: 'execution-status',
+                    status: 'failed',
+                    sessionId,
+                    timestamp: decision.timestamp ?? Date.now(),
+                    error: decision.reason ?? null,
+                });
+            }
+        };
+        storage.on('event', onEvent);
+        storage.on('tool-event', onToolEvent);
+        storage.on('decision', onDecision);
+        req.on('close', () => {
+            storage.removeListener('event', onEvent);
+            storage.removeListener('tool-event', onToolEvent);
+            storage.removeListener('decision', onDecision);
+        });
+    });
+}
+//# sourceMappingURL=execution-trace.js.map

package/dist/web/routes/execution-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-trace.js","sourceRoot":"","sources":["../../../src/web/routes/execution-trace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CAAC,GAAgB,EAAE,GAAiB;IAC9E,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IAExB,qEAAqE;IACrE,GAAG,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAe,CAAC,IAAI,EAAE,CAAC;YACxD,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,KAA2B,CAAC;YAC1D,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,MAA4B,CAAC;YAE5D,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BT,CAAC;YAEF,MAAM,MAAM,GAAwB,EAAE,CAAC;YAEvC,IAAI,WAAW,EAAE,CAAC;gBAChB,GAAG,IAAI,4BAA4B,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC3B,CAAC;YACD,eAAe;YAEf,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;gBAC5B,GAAG,IAAI,oBAAoB,CAAC;YAC9B,CAAC;iBAAM,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC;gBACpC,GAAG,IAAI,oBAAoB,CAAC;YAC9B,CAAC;YAED,GAAG,IAAI,8BAA8B,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEnB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAuBxC,CAAC;YAEH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC9B,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,SAAS,EAAE,GAAG,CAAC,UAAU;gBACzB,cAAc,EAAE,GAAG,CAAC,gBAAgB;gBACpC,WAAW,EAAE,GAAG,CAAC,YAAY;gBAC7B,SAAS,EAAE,GAAG,CAAC,EAAE;gBACjB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC;gBAC3C,YAAY,EAAE,GAAG,CAAC,cAAc;gBAChC,YAAY,EAAE,GAAG,CAAC,cAAc;gBAChC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,gBAAgB,EAAE,GAAG,CAAC,iBAAiB;gBACvC,YAAY,EAAE,GAAG,CAAC,aAAa,KAAK,CAAC;gBACrC,SAAS,EAAE,GAAG,CAAC,eAAe;gBAC9B,WAAW,EAAE,GAAG,CAAC,aAAa;gBAC9B,WAAW,EAAE,GAAG,CAAC,YAAY;gBAC7B,gBAAgB,EAAE,GAAG,CAAC,kBAAkB;gBACxC,gBAAgB,EAAE,GAAG,CAAC,iBAAiB;gBACvC,SAAS,EAAE,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,EAAE;gBACjF,aAAa,EAAE,GAAG,CAAC,cAAc;gBACjC,YAAY,EAAE,GAAG,CAAC,UAAU;gBAC5B,UAAU,EAAE,GAAG,CAAC,QAAQ;gBACxB,UAAU,EAAE,GAAG,CAAC,WAAW;aAC5B,CAAC,CAAC,CAAC;YAEJ,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,yCAAyC,GAAG,EAAE,CAAC,CAAC;YAC5D,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,oEAAoE;IACpE,GAAG,CAAC,GAAG,CAAC,0BAA0B,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC/C,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YACD,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAEjC,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC,GAAG,CAAC,EAAE,CAmBjE,CAAC;YAEd,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;YACrC,MAAM,cAAc,GAAI,OAAgD,CAAC,gBAAgB,IAAI,IAAI,CAAC;YAElG,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;OAKzB,CAAC,CAAC,GAAG,CAAC,SAAS,CAMd,CAAC;YAEH,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;OAK7B,CAAC,CAAC,GAAG,CAAC,SAAS,CAA0E,CAAC;YAE3F,MAAM,aAAa,GAAG,cAAc;gBAClC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;WAKV,CAAC,CAAC,GAAG,CAAC,cAAc,CAOnB;gBACJ,CAAC,CAAC,EAAE,CAAC;YAEP,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;OAM9B,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAIlD,CAAC;YAEH,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;gBACvC,IAAI,QAAQ,GAAkB,IAAI,CAAC;gBACnC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;oBAC1C,IAAI,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ;wBAAE,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC;gBAChF,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBACxB,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;gBAClH,OAAO;oBACL,WAAW,EAAE,CAAC,CAAC,EAAE;oBACjB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ;oBACR,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,OAAO,EAAE,CAAC,CAAC,OAAO,KAAK,CAAC;oBACxB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;oBACvE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,IAAI,IAAI;oBAC7C,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;iBAC7C,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,IAAI,CAAC;gBACP,OAAO,EAAE;oBACP,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,SAAS;oBACT,cAAc;oBACd,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,SAAS,EAAE,OAAO,CAAC,EAAE;oBACrB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;oBAC/C,YAAY,EAAE,OAAO,CAAC,cAAc;oBACpC,YAAY,EAAE,OAAO,CAAC,cAAc;oBACpC,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,gBAAgB,EAAE,OAAO,CAAC,iBAAiB;oBAC3C,YAAY,EAAE,OAAO,CAAC,aAAa,KAAK,CAAC;oBACzC,aAAa,EAAE,OAAO,CAAC,cAAc;oBACrC,SAAS,EAAE,OAAO,CAAC,eAAe;oBAClC,WAAW,EAAE,OAAO,CAAC,aAAa;oBAClC,WAAW,EAAE,OAAO,CAAC,YAAY;oBACjC,gBAAgB,EAAE,OAAO,CAAC,kBAAkB;oBAC5C,gBAAgB,EAAE,OAAO,CAAC,iBAAiB;oBAC3C,SAAS,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,EAAE;iBAC1F;gBACD,MAAM;gBACN,UAAU;gBACV,UAAU;aACX,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,yCAAyC,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;YAC9E,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,wEAAwE;IACxE,GAAG,CAAC,GAAG,CAAC,yCAAyC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC9D,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;YAClC,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,4EAA4E,CAAC,CAAC,GAAG,CAAC,UAAU,CAO1G,CAAC;YACd,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YAED,MAAM,eAAe,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;OAKlC,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAA2F,CAAC;YAEzH,MAAM,cAAc,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;OAKjC,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAA4E,CAAC;YAE1G,IAAI,MAAM,GAAqD,SAAS,CAAC;YACzE,IAAI,cAAc,EAAE,KAAK,KAAK,OAAO,IAAI,eAAe,EAAE,OAAO,KAAK,CAAC;gBAAE,MAAM,GAAG,QAAQ,CAAC;iBACtF,IAAI,OAAO,CAAC,YAAY;gBAAE,MAAM,GAAG,WAAW,CAAC;iBAC/C,IAAI,OAAO,CAAC,aAAa,IAAI,eAAe;gBAAE,MAAM,GAAG,WAAW,CAAC;YAExE,GAAG,CAAC,IAAI,CAAC;gBACP,MAAM;gBACN,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,SAAS,EAAE,OAAO,CAAC,eAAe,IAAI,eAAe,EAAE,IAAI,IAAI,IAAI;gBACnE,WAAW,EAAE,OAAO,CAAC,aAAa,IAAI,eAAe,EAAE,SAAS,IAAI,IAAI;gBACxE,WAAW,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;gBACzC,gBAAgB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI;gBACpD,gBAAgB,EAAE,OAAO,CAAC,iBAAiB,IAAI,IAAI;gBACnD,KAAK,EAAE,eAAe,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;aACnI,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,wCAAwC,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC,CAAC;YACrF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,0CAA0C;IAC1C,oEAAoE;IACpE,GAAG,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAClD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,mBAAmB;YACnC,eAAe,EAAE,UAAU;YAC3B,UAAU,EAAE,YAAY;SACzB,CAAC,CAAC;QACH,GAAG,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAE5C,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,OAA6B,CAAC;QAC9D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;QAEvG,MAAM,WAAW,GAAG,CAAC,OAAgC,EAAE,EAAE;YACvD,IAAI,aAAa,IAAI,OAAO,CAAC,SAAS,KAAK,aAAa;gBAAE,OAAO;YACjE,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,CAAC,KAA8B,EAAE,EAAE;YACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAA+B,CAAC;YACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAA+B,CAAC;YACvD,MAAM,SAAS,GAAG,KAAK,CAAC,UAAgC,CAAC;YACzD,MAAM,SAAS,GAAG,KAAK,CAAC,SAA+B,CAAC;YACxD,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAEpC,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;gBACpC,WAAW,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC,CAAC;gBACtH,OAAO;YACT,CAAC;YACD,IAAI,QAAQ,KAAK,YAAY,IAAI,QAAQ,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1E,WAAW,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACrG,OAAO;YACT,CAAC;YACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,WAAW,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;YACvF,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,CAAC,KAA8B,EAAE,EAAE;YACrD,MAAM,SAAS,GAAG,KAAK,CAAC,UAAgC,CAAC;YACzD,IAAI,CAAC,SAAS;gBAAE,OAAO;YACvB,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;gBACnD,WAAW,CAAC;oBACV,IAAI,EAAE,kBAAkB;oBACxB,MAAM,EAAE,QAAQ;oBAChB,SAAS;oBACT,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;oBACxC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;oBACxB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;iBAC3B,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,CAAC,QAAiC,EAAE,EAAE;YACvD,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAgC,CAAC;YAC5D,IAAI,CAAC,SAAS;gBAAE,OAAO;YACvB,IAAI,QAAQ,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBAC/B,WAAW,CAAC;oBACV,IAAI,EAAE,kBAAkB;oBACxB,MAAM,EAAE,QAAQ;oBAChB,SAAS;oBACT,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;oBAC3C,KAAK,EAAE,QAAQ,CAAC,MAAM,IAAI,IAAI;iBAC/B,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QACtC,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACnC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACzC,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;YAClD,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/web/routes/experiments.d.ts

@@ -0,0 +1,15 @@
+import type { Application } from 'express';
+import type { RouteContext } from './types.js';
+/**
+ * /api/routing/experiments/* — Phase 5 A/B testing.
+ *
+ * Kept separate from routing.ts because:
+ *   - dedicated config file (routing-experiments.yaml)
+ *   - lazy dynamic import of experiment-router validator
+ *   - promote endpoint touches routing.yaml with backup semantics
+ *
+ * NOTE: `experimentsPath` is evaluated lazily (per request) rather than at
+ * module load so tests can redirect `process.env.HOME` after import.
+ */
+export declare function registerExperimentsRoutes(app: Application, ctx: RouteContext): void;
+//# sourceMappingURL=experiments.d.ts.map

package/dist/web/routes/experiments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiments.d.ts","sourceRoot":"","sources":["../../../src/web/routes/experiments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAM3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CA8KnF"}

package/dist/web/routes/experiments.js

@@ -0,0 +1,187 @@
+import fs from 'fs';
+import path from 'path';
+import yaml from 'js-yaml';
+import { homedir } from 'os';
+import { logger } from '../../core/utils/logger.js';
+/**
+ * /api/routing/experiments/* — Phase 5 A/B testing.
+ *
+ * Kept separate from routing.ts because:
+ *   - dedicated config file (routing-experiments.yaml)
+ *   - lazy dynamic import of experiment-router validator
+ *   - promote endpoint touches routing.yaml with backup semantics
+ *
+ * NOTE: `experimentsPath` is evaluated lazily (per request) rather than at
+ * module load so tests can redirect `process.env.HOME` after import.
+ */
+export function registerExperimentsRoutes(app, ctx) {
+    const { storage } = ctx;
+    const getExperimentsPath = () => path.join(homedir(), '.claude-forge', 'routing-experiments.yaml');
+    app.get('/api/routing/experiments/config', (_req, res) => {
+        const experimentsPath = getExperimentsPath();
+        let content = '';
+        let source = 'none';
+        if (fs.existsSync(experimentsPath)) {
+            content = fs.readFileSync(experimentsPath, 'utf-8');
+            source = 'user';
+        }
+        res.json({ content, source, path: experimentsPath });
+    });
+    app.put('/api/routing/experiments/config', async (req, res) => {
+        const experimentsPath = getExperimentsPath();
+        const { content } = req.body;
+        if (typeof content !== 'string') {
+            res.status(400).json({ error: 'content must be a string' });
+            return;
+        }
+        try {
+            const parsed = yaml.load(content, { schema: yaml.CORE_SCHEMA });
+            const { validateConfig } = await import('../../engine/experiment-router.js');
+            const cfg = validateConfig(parsed);
+            if (!cfg) {
+                res.status(400).json({ error: 'experiments YAML failed validation (see daemon logs)' });
+                return;
+            }
+            const dir = path.dirname(experimentsPath);
+            if (!fs.existsSync(dir))
+                fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(experimentsPath, content, 'utf-8');
+            logger.info(`[Web] Experiments config updated: ${experimentsPath}`);
+            res.json({ success: true, path: experimentsPath });
+        }
+        catch (err) {
+            logger.warn(`[Web] Failed to save experiments config: ${err}`);
+            res.status(400).json({ error: String(err) });
+        }
+    });
+    app.get('/api/routing/experiments/analysis', async (_req, res) => {
+        const experimentsPath = getExperimentsPath();
+        try {
+            if (!fs.existsSync(experimentsPath)) {
+                res.json({ enabled: false, experimentId: null, groups: [] });
+                return;
+            }
+            const raw = fs.readFileSync(experimentsPath, 'utf-8');
+            const parsed = yaml.load(raw, { schema: yaml.CORE_SCHEMA });
+            const { validateConfig } = await import('../../engine/experiment-router.js');
+            const cfg = validateConfig(parsed);
+            if (!cfg || !cfg.experiment) {
+                res.json({ enabled: cfg?.enabled ?? false, experimentId: null, groups: [] });
+                return;
+            }
+            const stats = storage.queryExperimentStats(cfg.experiment.id);
+            const groups = cfg.experiment.groups.map(g => {
+                const s = stats.find(row => row.group_id === g.id);
+                const total = s?.total ?? 0;
+                const obeyed = s?.obeyed ?? 0;
+                const refused = s?.refused ?? 0;
+                return {
+                    id: g.id,
+                    name: g.name,
+                    weight: g.weight,
+                    total,
+                    obeyed,
+                    refused,
+                    unknown: s?.unknown ?? 0,
+                    obeyedRate: total > 0 ? obeyed / total : null,
+                    avgClassificationMs: s?.avg_classification_ms ?? null,
+                };
+            });
+            // Simple z-test between the two groups with the largest samples.
+            let zScore = null;
+            let sampleAdequate = false;
+            let suggestedWinner = null;
+            if (groups.length >= 2) {
+                const sorted = [...groups].sort((a, b) => b.total - a.total).slice(0, 2);
+                const [g1, g2] = sorted;
+                sampleAdequate = g1.total >= 50 && g2.total >= 50;
+                if (sampleAdequate) {
+                    const p1 = g1.obeyed / g1.total;
+                    const p2 = g2.obeyed / g2.total;
+                    const pPool = (g1.obeyed + g2.obeyed) / (g1.total + g2.total);
+                    const se = Math.sqrt(pPool * (1 - pPool) * (1 / g1.total + 1 / g2.total));
+                    zScore = se > 0 ? (p1 - p2) / se : 0;
+                    if (Math.abs(zScore) > 1.96) {
+                        suggestedWinner = p1 > p2 ? g1.id : g2.id;
+                    }
+                }
+            }
+            res.json({
+                enabled: cfg.enabled,
+                experimentId: cfg.experiment.id,
+                experimentName: cfg.experiment.name,
+                startedAt: cfg.experiment.startedAt,
+                endedAt: cfg.experiment.endedAt,
+                groups,
+                zScore,
+                sampleAdequate,
+                suggestedWinner,
+            });
+        }
+        catch (err) {
+            logger.warn(`[Web] Experiments analysis failed: ${err}`);
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    app.post('/api/routing/experiments/promote', async (req, res) => {
+        const experimentsPath = getExperimentsPath();
+        const { groupId } = req.body;
+        if (typeof groupId !== 'string' || groupId.length === 0) {
+            res.status(400).json({ error: 'groupId is required' });
+            return;
+        }
+        try {
+            if (!fs.existsSync(experimentsPath)) {
+                res.status(400).json({ error: 'experiments config does not exist' });
+                return;
+            }
+            const raw = fs.readFileSync(experimentsPath, 'utf-8');
+            const parsed = yaml.load(raw, { schema: yaml.CORE_SCHEMA });
+            const { validateConfig } = await import('../../engine/experiment-router.js');
+            const cfg = validateConfig(parsed);
+            if (!cfg || !cfg.experiment) {
+                res.status(400).json({ error: 'experiments config has no active experiment' });
+                return;
+            }
+            const group = cfg.experiment.groups.find(g => g.id === groupId);
+            if (!group) {
+                res.status(404).json({ error: `group '${groupId}' not found` });
+                return;
+            }
+            // Step 1: backup existing routing.yaml if present
+            const routingPath = path.join(homedir(), '.claude-forge', 'routing.yaml');
+            const ts = new Date().toISOString().replace(/[:.]/g, '-');
+            let backupPath = null;
+            if (fs.existsSync(routingPath)) {
+                backupPath = `${routingPath}.bak-${ts}`;
+                fs.copyFileSync(routingPath, backupPath);
+            }
+            else {
+                const dir = path.dirname(routingPath);
+                if (!fs.existsSync(dir))
+                    fs.mkdirSync(dir, { recursive: true });
+            }
+            // Step 2: write the winner's rules as the new routing.yaml
+            const newRouting = yaml.dump({ schemaVersion: '1.0', rules: group.rules });
+            fs.writeFileSync(routingPath, newRouting, 'utf-8');
+            // Step 3: mark experiment as ended (enabled=false, endedAt=now)
+            const endedAt = new Date().toISOString();
+            const updated = yaml.dump({
+                schemaVersion: '1.0',
+                enabled: false,
+                experiment: {
+                    ...cfg.experiment,
+                    endedAt,
+                },
+            });
+            fs.writeFileSync(experimentsPath, updated, 'utf-8');
+            logger.info(`[Web] Promoted group '${groupId}' from experiment '${cfg.experiment.id}'; backup: ${backupPath}`);
+            res.json({ promoted: groupId, routingPath, backupPath, endedAt });
+        }
+        catch (err) {
+            logger.warn(`[Web] Failed to promote experiment group: ${err}`);
+            res.status(500).json({ error: String(err) });
+        }
+    });
+}
+//# sourceMappingURL=experiments.js.map

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

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

package/dist/web/routes/methodology.d.ts

@@ -0,0 +1,12 @@
+import type { Application } from 'express';
+import type { RouteContext } from './types.js';
+/**
+ * /api/methodology-executions/* and /api/methodologies.
+ *
+ * Also owns the SSE stream for live execution updates. Note: the SSE route
+ * `/api/methodology-executions/events` must be registered before the
+ * parameterized `/:id` route on Express 4 (Express matches in definition
+ * order and `:id` would otherwise swallow the literal `events` segment).
+ */
+export declare function registerMethodologyRoutes(app: Application, ctx: RouteContext): void;
+//# sourceMappingURL=methodology.d.ts.map

package/dist/web/routes/methodology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methodology.d.ts","sourceRoot":"","sources":["../../../src/web/routes/methodology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQ3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CAkOnF"}