@winspan/claude-forge 8.26.3 → 8.28.0

package/dist/daemon/routing-state.js

@@ -0,0 +1,189 @@
+/**
+ * RoutingState — in-memory session routing state for PreToolUse enforcement
+ *
+ * Tracks which sessions have active routing decisions, so PreToolUse can
+ * enforce "must use Agent tool" when Claude tries to bypass the routing.
+ */
+import { logger } from '../core/utils/logger.js';
+// Auto-cleanup stale routing state after 30 minutes
+const ROUTING_STATE_TTL_MS = 30 * 60 * 1000;
+/**
+ * Global routing state manager (singleton pattern)
+ */
+class RoutingStateManager {
+    state = new Map();
+    /**
+     * Record that a session has been routed to a specific agent
+     */
+    setRouting(sessionId, decision) {
+        try {
+            // Parameter validation
+            if (!sessionId || typeof sessionId !== 'string') {
+                logger.error(`[RoutingState] setRouting: invalid sessionId: ${JSON.stringify(sessionId)}`);
+                return;
+            }
+            if (!decision || typeof decision !== 'object') {
+                logger.error(`[RoutingState] setRouting: invalid decision object for session ${sessionId}`);
+                return;
+            }
+            if (!decision.agentName || typeof decision.agentName !== 'string') {
+                logger.error(`[RoutingState] setRouting: invalid agentName for session ${sessionId}: ${JSON.stringify(decision)}`);
+                return;
+            }
+            if (!decision.routeRequestId || typeof decision.routeRequestId !== 'string') {
+                logger.error(`[RoutingState] setRouting: invalid routeRequestId for session ${sessionId}: ${JSON.stringify(decision)}`);
+                return;
+            }
+            if (typeof decision.timestamp !== 'number' || decision.timestamp <= 0) {
+                logger.error(`[RoutingState] setRouting: invalid timestamp for session ${sessionId}: ${JSON.stringify(decision)}`);
+                return;
+            }
+            this.state.set(sessionId, decision);
+            logger.debug(`[RoutingState] Set routing for session ${sessionId} → ${decision.agentName}`);
+        }
+        catch (error) {
+            logger.error(`[RoutingState] setRouting: unexpected error for session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get the active routing decision for a session (if any)
+     * Returns null if no routing exists or if routing has expired
+     */
+    getRouting(sessionId) {
+        try {
+            // Parameter validation
+            if (!sessionId || typeof sessionId !== 'string') {
+                logger.error(`[RoutingState] getRouting: invalid sessionId: ${JSON.stringify(sessionId)}`);
+                return null;
+            }
+            const decision = this.state.get(sessionId);
+            if (!decision)
+                return null;
+            // Check if routing has expired
+            const age = Date.now() - decision.timestamp;
+            if (age > ROUTING_STATE_TTL_MS) {
+                logger.debug(`[RoutingState] Routing expired for session ${sessionId} (age: ${Math.round(age / 1000)}s)`);
+                this.state.delete(sessionId);
+                return null;
+            }
+            return decision;
+        }
+        catch (error) {
+            logger.error(`[RoutingState] getRouting: unexpected error for session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`);
+            return null;
+        }
+    }
+    /**
+     * Clear routing state for a session (called after agent is invoked or session ends)
+     */
+    clearRouting(sessionId) {
+        try {
+            // Parameter validation
+            if (!sessionId || typeof sessionId !== 'string') {
+                logger.error(`[RoutingState] clearRouting: invalid sessionId: ${JSON.stringify(sessionId)}`);
+                return;
+            }
+            const decision = this.state.get(sessionId);
+            if (decision) {
+                logger.debug(`[RoutingState] Cleared routing for session ${sessionId} (was: ${decision.agentName})`);
+            }
+            this.state.delete(sessionId);
+        }
+        catch (error) {
+            logger.error(`[RoutingState] clearRouting: unexpected error for session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Check if a session has an active routing decision
+     */
+    hasRouting(sessionId) {
+        try {
+            // Parameter validation
+            if (!sessionId || typeof sessionId !== 'string') {
+                logger.error(`[RoutingState] hasRouting: invalid sessionId: ${JSON.stringify(sessionId)}`);
+                return false;
+            }
+            return this.getRouting(sessionId) !== null;
+        }
+        catch (error) {
+            logger.error(`[RoutingState] hasRouting: unexpected error for session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
+    /**
+     * Get statistics about current routing state (for debugging/monitoring)
+     */
+    getStats() {
+        try {
+            if (this.state.size === 0) {
+                return { totalSessions: 0, oldestAge: null };
+            }
+            const now = Date.now();
+            let oldestAge = 0;
+            for (const decision of this.state.values()) {
+                // Validate decision object
+                if (!decision || typeof decision.timestamp !== 'number') {
+                    logger.warn(`[RoutingState] getStats: invalid decision object in state: ${JSON.stringify(decision)}`);
+                    continue;
+                }
+                const age = now - decision.timestamp;
+                if (age > oldestAge)
+                    oldestAge = age;
+            }
+            return {
+                totalSessions: this.state.size,
+                oldestAge: Math.round(oldestAge / 1000), // seconds
+            };
+        }
+        catch (error) {
+            logger.error(`[RoutingState] getStats: unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+            return { totalSessions: 0, oldestAge: null };
+        }
+    }
+    /**
+     * Cleanup expired routing states (called periodically by daemon)
+     */
+    cleanup() {
+        try {
+            const now = Date.now();
+            let removed = 0;
+            for (const [sessionId, decision] of this.state.entries()) {
+                try {
+                    // Validate decision object
+                    if (!decision || typeof decision.timestamp !== 'number') {
+                        logger.warn(`[RoutingState] cleanup: invalid decision object for session ${sessionId}, removing: ${JSON.stringify(decision)}`);
+                        this.state.delete(sessionId);
+                        removed++;
+                        continue;
+                    }
+                    const age = now - decision.timestamp;
+                    if (age > ROUTING_STATE_TTL_MS) {
+                        this.state.delete(sessionId);
+                        removed++;
+                        logger.debug(`[RoutingState] Cleaned up expired routing for session ${sessionId}`);
+                    }
+                }
+                catch (error) {
+                    logger.error(`[RoutingState] cleanup: error processing session ${sessionId}, removing: ${error instanceof Error ? error.message : String(error)}`);
+                    this.state.delete(sessionId);
+                    removed++;
+                }
+            }
+            if (removed > 0) {
+                logger.info(`[RoutingState] Cleanup: removed ${removed} expired routing state(s)`);
+            }
+            return removed;
+        }
+        catch (error) {
+            logger.error(`[RoutingState] cleanup: unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+            return 0;
+        }
+    }
+}
+// Singleton instance
+export const routingState = new RoutingStateManager();
+// Auto-cleanup every 10 minutes
+setInterval(() => {
+    routingState.cleanup();
+}, 10 * 60 * 1000).unref();
+//# sourceMappingURL=routing-state.js.map

package/dist/daemon/routing-state.js.map

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

package/dist/engine/conventions/routing.yaml

@@ -137,8 +137,13 @@ rules:
   - when:
       taskType: compare_solutions
     action: { type: route_to_agent, name: researcher }
+  # Only route "explain" when the topic is complex enough to warrant a
+  # researcher dive. Plain clarification questions ("what does X mean",
+  # "does this work?") should stay with the main Claude — routing them out
+  # just produces disobey events since the main session will answer inline.
   - when:
       taskType: explain
+      complexity: complex
     action: { type: route_to_agent, name: researcher }
 
   # -- Documentation ---------------------------------------------------------

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAS3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,qBAAa,SAAS;IAMR,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,MAAM,CAA0D;IACxE,OAAO,CAAC,MAAM,CAAC,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAc;gBAET,OAAO,EAAE,gBAAgB;IAQ7C,OAAO,CAAC,WAAW;IAkyEb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAS3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,qBAAa,SAAS;IAMR,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,MAAM,CAA0D;IACxE,OAAO,CAAC,MAAM,CAAC,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAc;gBAET,OAAO,EAAE,gBAAgB;IAQ7C,OAAO,CAAC,WAAW;IA+6Eb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}

package/dist/web/server.js

@@ -59,8 +59,23 @@ export class WebServer {
         ];
         const staticDir = candidates.find(dir => fs.existsSync(dir));
         if (staticDir) {
-            this.app.use(express.static(staticDir));
+            // Static files with content-hash in filename: long cache
+            // index.html: no cache (always fetch latest)
+            this.app.use(express.static(staticDir, {
+                setHeaders: (res, filePath) => {
+                    if (filePath.endsWith('index.html')) {
+                        res.setHeader('Cache-Control', 'no-cache, no-store, must-revalidate');
+                        res.setHeader('Pragma', 'no-cache');
+                        res.setHeader('Expires', '0');
+                    }
+                    else if (filePath.includes('/assets/')) {
+                        // Vite assets are content-hashed, safe to cache forever
+                        res.setHeader('Cache-Control', 'public, max-age=31536000, immutable');
+                    }
+                },
+            }));
             this.app.get('/', (_req, res) => {
+                res.setHeader('Cache-Control', 'no-cache, no-store, must-revalidate');
                 res.sendFile(path.join(staticDir, 'index.html'));
             });
             logger.info(`[Web] Serving static files from ${staticDir}`);
@@ -638,6 +653,99 @@ export class WebServer {
             const rows = storage.queryRoutingEvents(filter);
             res.json(rows);
         });
+        // Methodology Executions: list all executions
+        this.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);
+        });
+        // Methodology Execution Detail: get single execution with phases
+        this.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,
+            });
+        });
+        // Methodology Execution: cancel a running execution
+        this.app.post('/api/methodology-executions/:id/cancel', (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;
+            }
+            db.prepare(`
+        UPDATE methodology_executions
+        SET status = 'cancelled', completed_at = ?
+        WHERE id = ?
+      `).run(Date.now(), executionId);
+            // Also mark any running phase 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' });
+        });
+        // Methodology Execution: delete an execution
+        this.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
+        this.app.get('/api/methodologies', (_req, res) => {
+            try {
+                const candidates = [
+                    path.join(__dirname, '../capability/methodologies'),
+                    path.join(__dirname, '../../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 });
+            }
+        });
         // Refusal clustering (Plan A: SQL GROUP BY by taskType × agent)
         this.app.get('/api/routing/refusals', (req, res) => {
             const windowHours = parseInt(req.query.window || '168');
@@ -2104,6 +2212,19 @@ Return ONLY a JSON object with this exact structure (no markdown, no explanation
                 storage.removeListener('decision', onDecision);
             });
         });
+        // SPA fallback: serve index.html for any non-API route
+        // (must be the LAST route to not interfere with API routes)
+        const spaCandidates = [
+            path.join(__dirname, 'static'),
+            path.join(__dirname, '../../src/web/static'),
+        ];
+        const spaStaticDir = spaCandidates.find(dir => fs.existsSync(dir));
+        if (spaStaticDir) {
+            this.app.get(/^(?!\/api).*$/, (_req, res) => {
+                res.setHeader('Cache-Control', 'no-cache, no-store, must-revalidate');
+                res.sendFile(path.join(spaStaticDir, 'index.html'));
+            });
+        }
     }
     async start() {
         return new Promise((resolve, reject) => {