@winspan/claude-forge 8.28.1 → 8.30.0

package/dist/daemon/methodology-pending-queue.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Methodology Pending Inject Queue
+ *
+ * 前台模式下，Claude 主对话有时会忽略 UserPromptSubmit 注入的阶段指令
+ * （3 小时进度 0% 就是这种情况）。Stop hook 检测到这种情况时，把"下
+ * 一次要注入的指令"写入队列；UserPromptSubmit 在下一轮响应前消费一次。
+ *
+ * 进程内 Map + 磁盘 JSON 双层：daemon 重启时从磁盘恢复。
+ */
+export interface PendingDirective {
+    session_id: string;
+    execution_id: number;
+    phase_index: number;
+    directive: string;
+    enqueued_at: number;
+    reason: 'stop-fallback' | 'cold-restart' | 'idle-timeout';
+}
+export declare class MethodologyPendingQueue {
+    private memory;
+    private queueDir;
+    constructor(queueDir?: string);
+    private loadFromDisk;
+    private filePath;
+    enqueue(entry: PendingDirective): void;
+    consume(session_id: string): PendingDirective | null;
+    peek(session_id: string): PendingDirective | null;
+    size(): number;
+    purgeByExecutionId(execution_id: number): void;
+}
+export declare function getMethodologyPendingQueue(): MethodologyPendingQueue;
+export declare function _resetMethodologyPendingQueueForTest(): void;
+export declare function getPendingQueueDir(): string;
+//# sourceMappingURL=methodology-pending-queue.d.ts.map

package/dist/daemon/methodology-pending-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methodology-pending-queue.d.ts","sourceRoot":"","sources":["../../src/daemon/methodology-pending-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,GAAG,cAAc,GAAG,cAAc,CAAC;CAC3D;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,CAAC,EAAE,MAAM;IAK7B,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IActC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAiBpD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIjD,IAAI,IAAI,MAAM;IAKd,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;CAW/C;AAID,wBAAgB,0BAA0B,IAAI,uBAAuB,CAGpE;AAGD,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAGD,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/daemon/methodology-pending-queue.js

@@ -0,0 +1,120 @@
+/**
+ * Methodology Pending Inject Queue
+ *
+ * 前台模式下，Claude 主对话有时会忽略 UserPromptSubmit 注入的阶段指令
+ * （3 小时进度 0% 就是这种情况）。Stop hook 检测到这种情况时，把"下
+ * 一次要注入的指令"写入队列；UserPromptSubmit 在下一轮响应前消费一次。
+ *
+ * 进程内 Map + 磁盘 JSON 双层：daemon 重启时从磁盘恢复。
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from 'fs';
+import path from 'path';
+import { homedir } from 'os';
+import { logger } from '../core/utils/logger.js';
+const DEFAULT_QUEUE_DIR = path.join(homedir(), '.claude-forge', 'pending-inject');
+function resolveQueueDir() {
+    return process.env.CLAUDE_FORGE_PENDING_DIR || DEFAULT_QUEUE_DIR;
+}
+export class MethodologyPendingQueue {
+    memory = new Map();
+    queueDir;
+    constructor(queueDir) {
+        this.queueDir = queueDir ?? resolveQueueDir();
+        this.loadFromDisk();
+    }
+    loadFromDisk() {
+        try {
+            if (!existsSync(this.queueDir)) {
+                mkdirSync(this.queueDir, { recursive: true });
+                return;
+            }
+            const files = readdirSync(this.queueDir).filter(f => f.endsWith('.json'));
+            for (const file of files) {
+                try {
+                    const raw = readFileSync(path.join(this.queueDir, file), 'utf-8');
+                    const entry = JSON.parse(raw);
+                    this.memory.set(entry.session_id, entry);
+                }
+                catch (err) {
+                    logger.debug(`[MethodologyPendingQueue] skip corrupt ${file}: ${err}`);
+                }
+            }
+            if (this.memory.size > 0) {
+                logger.info(`[MethodologyPendingQueue] restored ${this.memory.size} pending directives`);
+            }
+        }
+        catch (err) {
+            logger.warn(`[MethodologyPendingQueue] loadFromDisk failed: ${err}`);
+        }
+    }
+    filePath(session_id) {
+        const safe = session_id.replace(/[^a-zA-Z0-9_-]/g, '_');
+        return path.join(this.queueDir, `${safe}.json`);
+    }
+    enqueue(entry) {
+        this.memory.set(entry.session_id, entry);
+        try {
+            if (!existsSync(this.queueDir))
+                mkdirSync(this.queueDir, { recursive: true });
+            writeFileSync(this.filePath(entry.session_id), JSON.stringify(entry, null, 2), 'utf-8');
+            logger.info(`[MethodologyPendingQueue] enqueued ${entry.reason} for session=${entry.session_id.slice(0, 8)} phase=${entry.phase_index}`);
+        }
+        catch (err) {
+            logger.warn(`[MethodologyPendingQueue] persist failed: ${err}`);
+        }
+    }
+    // 取出并移除。返回 null 如果没有待注入。
+    consume(session_id) {
+        const entry = this.memory.get(session_id);
+        if (!entry)
+            return null;
+        this.memory.delete(session_id);
+        try {
+            const fp = this.filePath(session_id);
+            if (existsSync(fp))
+                unlinkSync(fp);
+        }
+        catch (err) {
+            logger.debug(`[MethodologyPendingQueue] cleanup failed: ${err}`);
+        }
+        logger.info(`[MethodologyPendingQueue] consumed ${entry.reason} for session=${session_id.slice(0, 8)} phase=${entry.phase_index}`);
+        return entry;
+    }
+    // 对外只用于调试/可观测，不建议修改返回值
+    peek(session_id) {
+        return this.memory.get(session_id) ?? null;
+    }
+    size() {
+        return this.memory.size;
+    }
+    // 强制清理指定 execution 的所有 pending（execution 被 cancel / 完成时调用）
+    purgeByExecutionId(execution_id) {
+        for (const [sid, entry] of this.memory.entries()) {
+            if (entry.execution_id === execution_id) {
+                this.memory.delete(sid);
+                try {
+                    const fp = this.filePath(sid);
+                    if (existsSync(fp))
+                        unlinkSync(fp);
+                }
+                catch { /* ignore */ }
+            }
+        }
+    }
+}
+// Daemon 单例
+let _instance = null;
+export function getMethodologyPendingQueue() {
+    if (!_instance)
+        _instance = new MethodologyPendingQueue();
+    return _instance;
+}
+// 测试用 reset
+export function _resetMethodologyPendingQueueForTest() {
+    _instance = null;
+}
+// 暴露给外部（用于避免测试时写真实 HOME）
+export function getPendingQueueDir() {
+    return resolveQueueDir();
+}
+//# sourceMappingURL=methodology-pending-queue.js.map

package/dist/daemon/methodology-pending-queue.js.map

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

package/dist/web/server.d.ts

@@ -7,12 +7,18 @@ import type { SQLiteStorage } from '../core/storage/sqlite.js';
 import type { RuleEngine } from '../engine/rule-engine.js';
 import type { AgentRouter } from '../engine/agent-router.js';
 import type { AgentRegistry } from '../agents/registry.js';
+import type { ExecutionManager } from '../capability/execution-manager.js';
+import type { MethodologyRegistry } from '../capability/methodology-registry.js';
+import type { MethodologyPlanner } from '../capability/methodology-planner.js';
 export interface WebServerOptions {
     port: number;
     storage: SQLiteStorage;
     ruleEngine: RuleEngine;
     router?: AgentRouter;
     agents?: AgentRegistry;
+    executionManager?: ExecutionManager;
+    methodologyRegistry?: MethodologyRegistry;
+    methodologyPlanner?: MethodologyPlanner;
 }
 export declare class WebServer {
     private options;

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;IA+6Eb,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;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAW/E,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;IACvB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;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;IAiiFb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}

package/dist/web/server.js

@@ -9,6 +9,7 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 import { homedir } from 'os';
 import yaml from 'js-yaml';
+import { WorkerAuthError } from '../capability/executor/worker-auth-probe.js';
 import { Recommender } from '../engine/recommender.js';
 import { logger } from '../core/utils/logger.js';
 import { ErrorHandler } from '../core/utils/error-handler.js';
@@ -686,7 +687,7 @@ export class WebServer {
             });
         });
         // Methodology Execution: cancel a running execution
-        this.app.post('/api/methodology-executions/:id/cancel', (req, res) => {
+        this.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);
@@ -698,12 +699,26 @@ export class WebServer {
                 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
+            // Prefer ExecutionManager — it kills the worker process for background mode
+            if (this.options.executionManager) {
+                try {
+                    await this.options.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 = ?
@@ -711,6 +726,111 @@ export class WebServer {
       `).run(Date.now(), executionId);
             res.json({ success: true, message: 'Execution cancelled' });
         });
+        // Methodology Execution: start a new execution (Phase C)
+        // Body: { session_id, methodology_id?, plan?, mode: 'foreground' | 'background', requirement? }
+        this.app.post('/api/methodology-executions', async (req, res) => {
+            const { executionManager, methodologyRegistry } = this.options;
+            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 });
+                }
+            }
+        });
+        // Methodology Execution: SSE stream of executor events (Phase C)
+        this.app.get('/api/methodology-executions/events', (req, res) => {
+            const { executionManager } = this.options;
+            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();
+            });
+        });
         // Methodology Execution: delete an execution
         this.app.delete('/api/methodology-executions/:id', (req, res) => {
             const executionId = parseInt(req.params.id);