@winspan/claude-forge 8.28.2 → 8.33.0

package/dist/web/routes/methodology.js

@@ -0,0 +1,228 @@
+import fs from 'fs';
+import path from 'path';
+import yaml from 'js-yaml';
+import { fileURLToPath } from 'url';
+import { WorkerAuthError } from '../../capability/executor/worker-auth-probe.js';
+import { logger } from '../../core/utils/logger.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * /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 function registerMethodologyRoutes(app, ctx) {
+    const { storage, executionManager, methodologyRegistry } = ctx;
+    // List executions
+    app.get('/api/methodology-executions', (req, res) => {
+        const limit = parseInt(req.query.limit) || 50;
+        const sessionId = req.query.session;
+        const db = storage.getDatabase();
+        const query = sessionId
+            ? 'SELECT * FROM methodology_executions WHERE session_id = ? ORDER BY started_at DESC LIMIT ?'
+            : 'SELECT * FROM methodology_executions ORDER BY started_at DESC LIMIT ?';
+        const params = sessionId ? [sessionId, limit] : [limit];
+        const executions = db.prepare(query).all(...params);
+        res.json(executions);
+    });
+    // SSE stream — MUST be before `/:id`
+    app.get('/api/methodology-executions/events', (req, res) => {
+        if (!executionManager) {
+            res.status(503).json({ error: 'Execution manager not available' });
+            return;
+        }
+        const filterId = req.query.execution_id ? parseInt(String(req.query.execution_id)) : null;
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-cache');
+        res.setHeader('Connection', 'keep-alive');
+        res.flushHeaders();
+        const unsub = executionManager.subscribe(ev => {
+            if (filterId !== null && ev.execution_id !== filterId)
+                return;
+            try {
+                res.write(`event: ${ev.type}\ndata: ${JSON.stringify(ev)}\n\n`);
+            }
+            catch { /* client gone */ }
+        });
+        const heartbeat = setInterval(() => {
+            try {
+                res.write(`: heartbeat ${Date.now()}\n\n`);
+            }
+            catch { /* ignore */ }
+        }, 25_000);
+        req.on('close', () => {
+            clearInterval(heartbeat);
+            unsub();
+        });
+    });
+    // Execution detail: get single execution with phases
+    app.get('/api/methodology-executions/:id', (req, res) => {
+        const executionId = parseInt(req.params.id);
+        const db = storage.getDatabase();
+        const execution = db.prepare('SELECT * FROM methodology_executions WHERE id = ?').get(executionId);
+        if (!execution) {
+            res.status(404).json({ error: 'Execution not found' });
+            return;
+        }
+        const phases = db.prepare(`
+      SELECT * FROM phase_executions
+      WHERE methodology_execution_id = ?
+      ORDER BY phase_index ASC
+    `).all(executionId);
+        res.json({
+            ...execution,
+            plan: JSON.parse(execution.plan_json),
+            phases,
+        });
+    });
+    // Cancel a running execution
+    app.post('/api/methodology-executions/:id/cancel', async (req, res) => {
+        const executionId = parseInt(req.params.id);
+        const db = storage.getDatabase();
+        const execution = db.prepare('SELECT * FROM methodology_executions WHERE id = ?').get(executionId);
+        if (!execution) {
+            res.status(404).json({ error: 'Execution not found' });
+            return;
+        }
+        if (execution.status !== 'running') {
+            res.status(400).json({ error: `Cannot cancel execution in ${execution.status} state` });
+            return;
+        }
+        // Prefer ExecutionManager — it kills the worker process for background mode
+        if (executionManager) {
+            try {
+                await executionManager.cancel(executionId);
+            }
+            catch (err) {
+                logger.warn(`[web] cancel via ExecutionManager failed: ${err}`);
+                res.status(500).json({ error: `Cancel failed: ${err instanceof Error ? err.message : String(err)}` });
+                return;
+            }
+        }
+        else {
+            // Fallback: DB-only cancel (pre-Phase-C behavior)
+            db.prepare(`
+        UPDATE methodology_executions
+        SET status = 'cancelled', completed_at = ?
+        WHERE id = ?
+      `).run(Date.now(), executionId);
+        }
+        // Mark any still-running phase rows as cancelled
+        db.prepare(`
+      UPDATE phase_executions
+      SET status = 'cancelled', completed_at = ?
+      WHERE methodology_execution_id = ? AND status = 'running'
+    `).run(Date.now(), executionId);
+        res.json({ success: true, message: 'Execution cancelled' });
+    });
+    // Start a new execution (Phase C)
+    app.post('/api/methodology-executions', async (req, res) => {
+        if (!executionManager || !methodologyRegistry) {
+            res.status(503).json({ error: 'Execution manager not available' });
+            return;
+        }
+        const { session_id, methodology_id, plan, mode } = req.body ?? {};
+        if (!session_id) {
+            res.status(400).json({ error: 'session_id is required' });
+            return;
+        }
+        if (mode !== 'foreground' && mode !== 'background') {
+            res.status(400).json({ error: 'mode must be foreground or background' });
+            return;
+        }
+        let planObj = null;
+        if (plan && typeof plan === 'object' && Array.isArray(plan.phases)) {
+            planObj = plan;
+        }
+        else if (methodology_id) {
+            const methodology = methodologyRegistry.get(methodology_id);
+            if (!methodology) {
+                res.status(404).json({ error: `methodology ${methodology_id} not found` });
+                return;
+            }
+            const templates = methodology.phase_templates ?? {};
+            const phaseIds = Object.keys(templates);
+            if (phaseIds.length === 0) {
+                res.status(400).json({ error: `methodology ${methodology_id} has no phase_templates` });
+                return;
+            }
+            planObj = {
+                methodology_id: methodology.id,
+                rationale: `Started via API (default phases from ${methodology.id})`,
+                phases: phaseIds.map(id => {
+                    const tpl = templates[id];
+                    return {
+                        id,
+                        agent: tpl.agent,
+                        prompt: tpl.description ?? tpl.prompt_template.slice(0, 400),
+                        rationale: 'default phase from methodology template',
+                    };
+                }),
+            };
+        }
+        else {
+            res.status(400).json({ error: 'either methodology_id or plan must be provided' });
+            return;
+        }
+        try {
+            const id = executionManager.start({
+                session_id,
+                methodology_id: planObj.methodology_id,
+                plan: planObj,
+                mode,
+            });
+            res.status(201).json({ id, mode });
+        }
+        catch (err) {
+            logger.warn(`[web] start execution failed: ${err}`);
+            const message = err instanceof Error ? err.message : String(err);
+            const isAuthError = err instanceof WorkerAuthError
+                || (err instanceof Error && err.code === 'AUTH_REQUIRED')
+                || message.includes('Background mode requires');
+            if (isAuthError) {
+                res.status(503).json({ error: message, code: 'AUTH_REQUIRED' });
+            }
+            else {
+                res.status(500).json({ error: message });
+            }
+        }
+    });
+    // Delete an execution
+    app.delete('/api/methodology-executions/:id', (req, res) => {
+        const executionId = parseInt(req.params.id);
+        const db = storage.getDatabase();
+        db.prepare('DELETE FROM phase_executions WHERE methodology_execution_id = ?').run(executionId);
+        const result = db.prepare('DELETE FROM methodology_executions WHERE id = ?').run(executionId);
+        if (result.changes === 0) {
+            res.status(404).json({ error: 'Execution not found' });
+            return;
+        }
+        res.json({ success: true });
+    });
+    // Methodology: list all available methodologies
+    app.get('/api/methodologies', (_req, res) => {
+        try {
+            const candidates = [
+                path.join(__dirname, '../../capability/methodologies'), // dist/web/routes -> dist/capability/methodologies
+                path.join(__dirname, '../../../src/capability/methodologies'), // dev: src/web/routes -> src/capability/methodologies
+            ];
+            const dir = candidates.find(d => fs.existsSync(d));
+            if (!dir) {
+                res.json([]);
+                return;
+            }
+            const files = fs.readdirSync(dir).filter(f => f.endsWith('.yaml'));
+            const methodologies = files.map(f => {
+                const content = fs.readFileSync(path.join(dir, f), 'utf-8');
+                return yaml.load(content);
+            });
+            res.json(methodologies);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+}
+//# sourceMappingURL=methodology.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { Application } from 'express';
+import type { RouteContext } from './types.js';
+/**
+ * /api/patch/* — AI-assisted patch preview + apply (with backup).
+ */
+export declare function registerPatchRoutes(app: Application, _ctx: RouteContext): void;
+//# sourceMappingURL=patch.d.ts.map

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

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

package/dist/web/routes/patch.js

@@ -0,0 +1,106 @@
+import fs from 'fs';
+import path from 'path';
+import { ConfigManager } from '../../core/config.js';
+import { ClaudeProvider } from '../../core/ai/provider.js';
+import { logger } from '../../core/utils/logger.js';
+import { resolvePatchTarget } from './types.js';
+/**
+ * /api/patch/* — AI-assisted patch preview + apply (with backup).
+ */
+export function registerPatchRoutes(app, _ctx) {
+    // POST /api/patch/preview — generate structured patch preview
+    app.post('/api/patch/preview', async (req, res) => {
+        const { targetType, targetName, recommendation, rationale } = req.body ?? {};
+        if (!targetType || !targetName || !recommendation) {
+            res.status(400).json({ error: 'targetType, targetName, and recommendation are required' });
+            return;
+        }
+        try {
+            const config = new ConfigManager().get();
+            const apiKey = config.distill.api_key || process.env.ANTHROPIC_API_KEY || '';
+            if (!apiKey) {
+                res.status(400).json({ error: 'AI API key not configured' });
+                return;
+            }
+            const { filePath } = resolvePatchTarget(targetType, targetName);
+            if (!fs.existsSync(filePath)) {
+                res.status(404).json({ error: `Target file not found: ${filePath}` });
+                return;
+            }
+            const currentContent = fs.readFileSync(filePath, 'utf-8');
+            const ai = new ClaudeProvider(apiKey, config.distill.model, config.distill.base_url);
+            const prompt = `You are a code/config optimization assistant. Given the current file content and a recommended change, generate the updated content.
+
+Current file (${targetType}/${targetName}):
+\`\`\`
+${currentContent}
+\`\`\`
+
+Recommendation: ${recommendation}
+${rationale ? `Rationale: ${rationale}` : ''}
+
+Return ONLY a JSON object with this exact structure (no markdown, no explanation):
+{
+  "summary": "brief description of what changed",
+  "afterContent": "the complete updated file content",
+  "risk": "low|medium|high"
+}`;
+            const response = await ai.complete(prompt, { maxTokens: 4096 });
+            const parsed = JSON.parse(response.trim());
+            res.json({
+                targetType,
+                targetName,
+                filePath,
+                before: currentContent,
+                after: parsed.afterContent,
+                summary: parsed.summary,
+                risk: parsed.risk || 'medium',
+                recommendation,
+                rationale: rationale || null,
+            });
+        }
+        catch (err) {
+            logger.warn(`[Web] Patch preview failed: ${err}`);
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // POST /api/patch/apply — apply patch with backup
+    app.post('/api/patch/apply', (req, res) => {
+        const { targetType, targetName, afterContent } = req.body ?? {};
+        if (!targetType || !targetName || typeof afterContent !== 'string') {
+            res.status(400).json({ error: 'targetType, targetName, and afterContent are required' });
+            return;
+        }
+        try {
+            const { filePath, backupDir } = resolvePatchTarget(targetType, targetName);
+            if (!fs.existsSync(filePath)) {
+                res.status(404).json({ error: `Target file not found: ${filePath}` });
+                return;
+            }
+            // Create backup
+            if (!fs.existsSync(backupDir)) {
+                fs.mkdirSync(backupDir, { recursive: true });
+            }
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const backupName = `${targetName}_${timestamp}${path.extname(filePath)}`;
+            const backupPath = path.join(backupDir, backupName);
+            fs.copyFileSync(filePath, backupPath);
+            // Apply patch
+            fs.writeFileSync(filePath, afterContent, 'utf-8');
+            logger.info(`[Web] Patch applied to ${targetType}/${targetName}, backup: ${backupPath}`);
+            res.json({
+                success: true,
+                targetType,
+                targetName,
+                filePath,
+                backupPath,
+                timestamp,
+            });
+        }
+        catch (err) {
+            logger.warn(`[Web] Patch apply failed: ${err}`);
+            res.status(500).json({ error: String(err) });
+        }
+    });
+}
+//# sourceMappingURL=patch.js.map

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

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

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

@@ -0,0 +1,17 @@
+import type { Application } from 'express';
+import type { RouteContext } from './types.js';
+/**
+ * /api/routing/* — Agent Routing analytics + config + recommendations.
+ *
+ * Covers:
+ *   - /api/routing/stats, /performance, /events
+ *   - /api/routing/refusals, /violations
+ *   - /api/routing/config (GET/PUT)
+ *   - /api/routing/rule-states (GET/PUT)
+ *   - /api/routing/recommendations, /ai-optimization
+ *
+ * A/B testing endpoints (/api/routing/experiments/*) are intentionally split
+ * out to experiments.ts because they have their own config file & helpers.
+ */
+export declare function registerRoutingRoutes(app: Application, ctx: RouteContext): void;
+//# sourceMappingURL=routing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../src/web/routes/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAU3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CAmjB/E"}