@winspan/claude-forge 0.1.1

package/dist/pattern-engine/types.js

@@ -0,0 +1,8 @@
+/**
+ * Pattern-Agent 编排系统类型定义
+ *
+ * Pattern 是有状态工作流的声明式描述，可配置、可进化、可自动触发。
+ * 每个 Pattern 由多个 Phase 组成，Phase 间支持依赖关系和质量门禁。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pattern-engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pattern-engine/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/pipeline/analyzer.d.ts

@@ -0,0 +1,17 @@
+import { ClaudeAPI } from '../utils/claude-api.js';
+import type { PipelineTask } from './types.js';
+export declare class PipelineAnalyzer {
+    private api;
+    private detector;
+    constructor(api: ClaudeAPI);
+    /**
+     * 将一句话需求分解为任务树
+     */
+    decompose(requirement: string, projectPath: string): Promise<{
+        tasks: Array<Omit<PipelineTask, 'id'>>;
+        techStack: string;
+    }>;
+    private parseTasksFromResponse;
+    private defaultTasks;
+}
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/pipeline/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/pipeline/analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,QAAQ,CAAoB;gBAExB,GAAG,EAAE,SAAS;IAK1B;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QACjE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;QACvC,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IA6DF,OAAO,CAAC,sBAAsB;IAgC9B,OAAO,CAAC,YAAY;CASrB"}

package/dist/pipeline/analyzer.js

@@ -0,0 +1,103 @@
+import { TechStackDetector } from '../claudemd/detector.js';
+import { logger } from '../utils/logger.js';
+export class PipelineAnalyzer {
+    api;
+    detector;
+    constructor(api) {
+        this.api = api;
+        this.detector = new TechStackDetector();
+    }
+    /**
+     * 将一句话需求分解为任务树
+     */
+    async decompose(requirement, projectPath) {
+        // 检测项目技术栈
+        const profile = this.detector.detect(projectPath);
+        const techStack = [
+            ...profile.languages.map(l => l.name),
+            ...profile.frameworks.map(f => f.name),
+        ].join(', ') || '未检测到（新项目）';
+        logger.info(`[Pipeline] 正在分解："${requirement}" | 技术栈：${techStack}`);
+        const prompt = `你是一个资深软件架构师。请将以下一句话需求分解为可执行的任务列表。
+
+## 需求
+${requirement}
+
+## 项目技术栈
+${techStack}
+${profile.packageManager ? `包管理器: ${profile.packageManager}` : ''}
+${profile.testFramework ? `测试框架: ${profile.testFramework}` : ''}
+
+## 输出格式
+输出 JSON 数组，每个任务包含：
+- title: 任务标题（简短）
+- phase: 所属阶段（analyze/design/code/test/review）
+- description: 详细描述（包含具体操作步骤）
+- dependencies: 依赖的任务 title 数组
+
+## 要求
+1. 按 SDLC 阶段划分：analyze → design → code → test → review
+2. 每个阶段至少 1 个任务，不超过 3 个
+3. code 阶段按模块拆分（如前端/后端/数据库）
+4. test 阶段包含单元测试和集成测试
+5. description 要具体到文件和命令
+6. 如果是新项目，analyze 阶段要包含项目初始化（目录结构、依赖安装）
+7. 用中文
+8. 只输出 JSON 数组，不要其他内容
+
+示例格式：
+[
+  {"title":"需求分析","phase":"analyze","description":"...","dependencies":[]},
+  {"title":"技术方案设计","phase":"design","description":"...","dependencies":["需求分析"]}
+]`;
+        try {
+            const response = await this.api.complete(prompt, 'pipeline');
+            const tasks = this.parseTasksFromResponse(response);
+            if (tasks.length === 0) {
+                logger.warn('[Pipeline] No tasks parsed from AI response, falling back to defaults');
+                return { tasks: this.defaultTasks(requirement), techStack };
+            }
+            logger.info(`[Pipeline] 已分解为 ${tasks.length} 个任务`);
+            return { tasks, techStack };
+        }
+        catch (err) {
+            logger.error(`[Pipeline] 分解失败：${err}`);
+            // 降级：使用默认任务模板
+            return { tasks: this.defaultTasks(requirement), techStack };
+        }
+    }
+    parseTasksFromResponse(response) {
+        // 去除代码围栏
+        let cleaned = response.replace(/```json\s*/g, '').replace(/```\s*/g, '');
+        // 提取 JSON 数组
+        const jsonMatch = cleaned.match(/\[[\s\S]*\]/);
+        if (!jsonMatch) {
+            logger.warn('[Pipeline] No JSON array found in response');
+            return [];
+        }
+        try {
+            const raw = JSON.parse(jsonMatch[0]);
+            return raw.map(t => ({
+                title: t.title,
+                phase: t.phase,
+                status: 'pending',
+                description: t.description,
+                dependencies: t.dependencies || [],
+            }));
+        }
+        catch (err) {
+            logger.warn(`[Pipeline] 任务 JSON 解析失败：${err}`);
+            return [];
+        }
+    }
+    defaultTasks(requirement) {
+        return [
+            { title: '需求分析', phase: 'analyze', status: 'pending', description: `分析需求：${requirement}，列出功能点和技术方案`, dependencies: [] },
+            { title: '架构设计', phase: 'design', status: 'pending', description: '设计系统架构，输出目录结构和核心接口', dependencies: ['需求分析'] },
+            { title: '核心功能实现', phase: 'code', status: 'pending', description: '按设计方案编写核心代码', dependencies: ['架构设计'] },
+            { title: '单元测试', phase: 'test', status: 'pending', description: '为核心模块编写单元测试', dependencies: ['核心功能实现'] },
+            { title: '代码审查', phase: 'review', status: 'pending', description: '检查代码质量、安全性、性能', dependencies: ['单元测试'] },
+        ];
+    }
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/pipeline/analyzer.js.map

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

package/dist/pipeline/index.d.ts

@@ -0,0 +1,68 @@
+import type { ForgeEvent } from '../types/index.js';
+import { ClaudeAPI } from '../utils/claude-api.js';
+import type { SQLiteStorage } from '../storage/sqlite.js';
+import { PhaseManager } from './phase-manager.js';
+import type { Pipeline } from './types.js';
+export { type Pipeline, type PipelineTask, type PipelinePhase } from './types.js';
+export declare class PipelineEngine {
+    private store;
+    private analyzer;
+    private phaseManager;
+    /** 内存缓存：最多保留 50 个最近访问的项目 pipeline，防止无界增长 */
+    private activePipelines;
+    /** 上次注入的指令指纹（pipelineId:phase:completed/total），相同则跳过重复注入 */
+    private lastInstructionKey;
+    private static readonly MAX_CACHED_PROJECTS;
+    constructor(storage: SQLiteStorage, api: ClaudeAPI);
+    /**
+     * 向 activePipelines 写入时，如果超出上限则淘汰最旧的条目（LRU 策略）
+     */
+    private setCached;
+    /**
+     * PreToolUse 处理：如果有活跃 Pipeline，注入阶段指令
+     */
+    handlePreToolUse(event: ForgeEvent): Promise<string | null>;
+    /**
+     * PostToolUse 处理：跟踪进度，检查阶段推进
+     */
+    handlePostToolUse(event: ForgeEvent): Promise<string | null>;
+    /**
+     * 启动新 Pipeline
+     */
+    startPipeline(requirement: string, projectPath: string, sessionId: string): Promise<Pipeline>;
+    /**
+     * 检查项目是否有活跃 Pipeline
+     */
+    hasActivePipeline(projectPath: string): boolean;
+    /**
+     * 获取 Pipeline 状态摘要（用于 resume 注入）
+     */
+    getStatusSummary(projectPath: string): string | null;
+    /**
+     * 获取 PhaseManager 引用（用于注入知识上下文）
+     */
+    getPhaseManager(): PhaseManager;
+    /**
+     * 获取活跃 Pipeline 对象
+     */
+    getActivePipelineForProject(projectPath: string): Pipeline | null;
+    /**
+     * 手动关闭指定项目（或指定 ID）的 Pipeline。
+     * 供 CLI 和 daemon 启动时调用。
+     */
+    closePipeline(projectPathOrId: string, byId?: boolean): void;
+    /**
+     * 清理所有超过 ttlMs 未更新的过期 Pipeline（daemon 启动时调用）。
+     * 默认 2 小时。
+     */
+    cleanupExpired(ttlMs?: number): void;
+    /** 列出所有活跃 Pipeline（跨项目，供 CLI 展示） */
+    listActive(): Array<{
+        id: string;
+        requirement: string;
+        projectPath: string;
+        phase: string;
+        updatedAt: string;
+    }>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/pipeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAElF,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,4CAA4C;IAC5C,OAAO,CAAC,eAAe,CAA+B;IACtD,4DAA4D;IAC5D,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAM;gBAErC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS;IAMlD;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA2BjE;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgClE;;OAEG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAqBnG;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAM/C;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAWpD;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;OAEG;IACH,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAIjE;;;OAGG;IACH,aAAa,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,IAAI;IAoB1D;;;OAGG;IACH,cAAc,CAAC,KAAK,SAAqB,GAAG,IAAI;IAUhD,oCAAoC;IACpC,UAAU,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAGhH"}

package/dist/pipeline/index.js

@@ -0,0 +1,183 @@
+import { PipelineStore } from './store.js';
+import { PipelineAnalyzer } from './analyzer.js';
+import { PhaseManager } from './phase-manager.js';
+import { PHASE_LABELS } from './types.js';
+import { logger } from '../utils/logger.js';
+export class PipelineEngine {
+    store;
+    analyzer;
+    phaseManager;
+    /** 内存缓存：最多保留 50 个最近访问的项目 pipeline，防止无界增长 */
+    activePipelines = new Map();
+    /** 上次注入的指令指纹（pipelineId:phase:completed/total），相同则跳过重复注入 */
+    lastInstructionKey = new Map();
+    static MAX_CACHED_PROJECTS = 50;
+    constructor(storage, api) {
+        this.store = new PipelineStore(storage);
+        this.analyzer = new PipelineAnalyzer(api);
+        this.phaseManager = new PhaseManager(this.store);
+    }
+    /**
+     * 向 activePipelines 写入时，如果超出上限则淘汰最旧的条目（LRU 策略）
+     */
+    setCached(projectPath, pipeline) {
+        // Map 的迭代顺序是插入顺序；先删再插相当于 touch（移到末尾）
+        this.activePipelines.delete(projectPath);
+        this.activePipelines.set(projectPath, pipeline);
+        if (this.activePipelines.size > PipelineEngine.MAX_CACHED_PROJECTS) {
+            // 删除最旧（第一个）条目
+            const oldest = this.activePipelines.keys().next().value;
+            if (oldest)
+                this.activePipelines.delete(oldest);
+        }
+    }
+    /**
+     * PreToolUse 处理：如果有活跃 Pipeline，注入阶段指令
+     */
+    async handlePreToolUse(event) {
+        const projectPath = event.project_path;
+        // 加载或恢复 Pipeline
+        let pipeline = this.activePipelines.get(projectPath);
+        if (!pipeline) {
+            pipeline = this.store.getActivePipeline(projectPath) || undefined;
+            if (pipeline) {
+                this.setCached(projectPath, pipeline);
+                logger.info(`[Pipeline] 已续接：${pipeline.requirement} (${PHASE_LABELS[pipeline.phase]})`);
+            }
+        }
+        if (!pipeline || pipeline.phase === 'done')
+            return null;
+        // 刷新任务列表
+        pipeline.tasks = this.store.getTasks(pipeline.id);
+        // 计算当前进度指纹，相同时跳过注入（避免每次 PreToolUse 重复输出相同进度）
+        const progress = this.store.getPhaseProgress(pipeline.id, pipeline.phase);
+        const instrKey = `${pipeline.id}:${pipeline.phase}:${progress.completed}/${progress.total}`;
+        if (this.lastInstructionKey.get(projectPath) === instrKey)
+            return null;
+        this.lastInstructionKey.set(projectPath, instrKey);
+        return this.phaseManager.getPhaseInstruction(pipeline);
+    }
+    /**
+     * PostToolUse 处理：跟踪进度，检查阶段推进
+     */
+    async handlePostToolUse(event) {
+        // 加载或恢复 Pipeline（与 handlePreToolUse 保持一致）
+        let pipeline = this.activePipelines.get(event.project_path);
+        if (!pipeline) {
+            pipeline = this.store.getActivePipeline(event.project_path) || undefined;
+            if (pipeline) {
+                this.setCached(event.project_path, pipeline);
+            }
+        }
+        if (!pipeline || pipeline.phase === 'done')
+            return null;
+        // 刷新任务列表
+        pipeline.tasks = this.store.getTasks(pipeline.id);
+        const result = this.phaseManager.checkAndAdvance(pipeline, event);
+        if (result.advanced && result.newPhase) {
+            pipeline.phase = result.newPhase;
+            // 阶段推进后清除指纹缓存，确保新阶段指令能正常注入
+            this.lastInstructionKey.delete(event.project_path);
+            if (result.newPhase === 'done') {
+                this.activePipelines.delete(event.project_path);
+                return `[Forge Pipeline] 项目已完成所有阶段！需求：${pipeline.requirement}`;
+            }
+            return `[Forge Pipeline] 阶段推进：${PHASE_LABELS[result.newPhase]}`;
+        }
+        return null;
+    }
+    /**
+     * 启动新 Pipeline
+     */
+    async startPipeline(requirement, projectPath, sessionId) {
+        logger.info(`[Pipeline] 启动中："${requirement}"`);
+        // 用 Claude API 分解需求
+        const { tasks, techStack } = await this.analyzer.decompose(requirement, projectPath);
+        // 创建 Pipeline
+        const pipeline = this.store.createPipeline(requirement, projectPath, sessionId, techStack);
+        // 添加任务
+        if (tasks.length > 0) {
+            pipeline.tasks = this.store.addTasks(pipeline.id, tasks);
+        }
+        // 缓存
+        this.setCached(projectPath, pipeline);
+        logger.info(`[Pipeline] 已启动，共 ${pipeline.tasks.length} 个任务`);
+        return pipeline;
+    }
+    /**
+     * 检查项目是否有活跃 Pipeline
+     */
+    hasActivePipeline(projectPath) {
+        if (this.activePipelines.has(projectPath))
+            return true;
+        const db = this.store.getActivePipeline(projectPath);
+        return db !== null;
+    }
+    /**
+     * 获取 Pipeline 状态摘要（用于 resume 注入）
+     */
+    getStatusSummary(projectPath) {
+        const pipeline = this.activePipelines.get(projectPath) || this.store.getActivePipeline(projectPath);
+        if (!pipeline || pipeline.phase === 'done')
+            return null;
+        const tasks = this.store.getTasks(pipeline.id);
+        const done = tasks.filter(t => t.status === 'completed').length;
+        return `Pipeline 进行中：${pipeline.requirement}
+阶段：${PHASE_LABELS[pipeline.phase]} | 进度：${done}/${tasks.length}`;
+    }
+    /**
+     * 获取 PhaseManager 引用（用于注入知识上下文）
+     */
+    getPhaseManager() {
+        return this.phaseManager;
+    }
+    /**
+     * 获取活跃 Pipeline 对象
+     */
+    getActivePipelineForProject(projectPath) {
+        return this.activePipelines.get(projectPath) || this.store.getActivePipeline(projectPath);
+    }
+    /**
+     * 手动关闭指定项目（或指定 ID）的 Pipeline。
+     * 供 CLI 和 daemon 启动时调用。
+     */
+    closePipeline(projectPathOrId, byId = false) {
+        if (byId) {
+            this.store.closeById(projectPathOrId);
+            // 清理内存缓存（遍历找到对应条目）
+            for (const [key, p] of this.activePipelines) {
+                if (p.id === projectPathOrId) {
+                    this.activePipelines.delete(key);
+                    this.lastInstructionKey.delete(key);
+                    break;
+                }
+            }
+        }
+        else {
+            const pipeline = this.store.getActivePipeline(projectPathOrId);
+            if (pipeline)
+                this.store.closeById(pipeline.id);
+            this.activePipelines.delete(projectPathOrId);
+            this.lastInstructionKey.delete(projectPathOrId);
+        }
+        logger.info(`[Pipeline] 已手动关闭：${projectPathOrId}`);
+    }
+    /**
+     * 清理所有超过 ttlMs 未更新的过期 Pipeline（daemon 启动时调用）。
+     * 默认 2 小时。
+     */
+    cleanupExpired(ttlMs = 2 * 60 * 60 * 1000) {
+        const closed = this.store.closeExpired(ttlMs);
+        if (closed > 0) {
+            logger.info(`[Pipeline] 已自动关闭 ${closed} 个过期 Pipeline（超过 ${ttlMs / 60000} 分钟未更新）`);
+            // 清空内存缓存，避免残留
+            this.activePipelines.clear();
+            this.lastInstructionKey.clear();
+        }
+    }
+    /** 列出所有活跃 Pipeline（跨项目，供 CLI 展示） */
+    listActive() {
+        return this.store.listActive();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/pipeline/index.js.map

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

package/dist/pipeline/phase-manager.d.ts

@@ -0,0 +1,32 @@
+import type { ForgeEvent } from '../types/index.js';
+import type { Pipeline, PipelinePhase } from './types.js';
+import { PipelineStore } from './store.js';
+export declare class PhaseManager {
+    private store;
+    private knowledgeContext;
+    private phaseEventCount;
+    constructor(store: PipelineStore);
+    /**
+     * 注入知识库内容到特定 Pipeline
+     */
+    setKnowledgeContext(pipelineId: string, knowledge: string): void;
+    /**
+     * 生成当前阶段的执行指令（注入 additionalContext）
+     */
+    getPhaseInstruction(pipeline: Pipeline): string;
+    /**
+     * 根据 PostToolUse 事件判断是否推进阶段
+     */
+    checkAndAdvance(pipeline: Pipeline, event: ForgeEvent): {
+        advanced: boolean;
+        newPhase?: PipelinePhase;
+    };
+    /** 每个阶段兜底推进所需的最少工具调用次数 */
+    private getPhaseActivityThreshold;
+    private getPhaseDirective;
+    /**
+     * 检测任务是否完成（基于工具调用模式）
+     */
+    private detectTaskCompletion;
+}
+//# sourceMappingURL=phase-manager.d.ts.map

package/dist/pipeline/phase-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-manager.d.ts","sourceRoot":"","sources":["../../src/pipeline/phase-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,eAAe,CAAkC;gBAE7C,KAAK,EAAE,aAAa;IAIhC;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAIhE;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAyE/C;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,aAAa,CAAA;KAAE;IA8CvG,0BAA0B;IAC1B,OAAO,CAAC,yBAAyB;IAWjC,OAAO,CAAC,iBAAiB;IAiCzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAyC7B"}

package/dist/pipeline/phase-manager.js

@@ -0,0 +1,188 @@
+import { PHASE_LABELS, PHASE_ORDER, nextPhase } from './types.js';
+import { logger } from '../utils/logger.js';
+export class PhaseManager {
+    store;
+    knowledgeContext = new Map(); // pipeline.id → 知识注入内容
+    phaseEventCount = new Map(); // `${pipelineId}:${phase}` → count
+    constructor(store) {
+        this.store = store;
+    }
+    /**
+     * 注入知识库内容到特定 Pipeline
+     */
+    setKnowledgeContext(pipelineId, knowledge) {
+        this.knowledgeContext.set(pipelineId, knowledge);
+    }
+    /**
+     * 生成当前阶段的执行指令（注入 additionalContext）
+     */
+    getPhaseInstruction(pipeline) {
+        const phase = pipeline.phase;
+        if (phase === 'done')
+            return '';
+        const progress = this.store.getPhaseProgress(pipeline.id, phase);
+        // 没有任务时提前退出，避免显示 (0/0)
+        if (progress.total === 0) {
+            logger.warn(`[Pipeline] 阶段 ${phase} 无任务，Pipeline 可能已损坏`);
+            return '';
+        }
+        const phaseTasks = pipeline.tasks.filter(t => t.phase === phase);
+        const currentTask = phaseTasks.find(t => t.status === 'pending' || t.status === 'in_progress');
+        // 标记当前任务为进行中
+        if (currentTask && currentTask.status === 'pending') {
+            this.store.updateTaskStatus(currentTask.id, 'in_progress');
+        }
+        const parts = [];
+        // Pipeline 状态头
+        parts.push(`[Forge Pipeline] 当前阶段：${PHASE_LABELS[phase]}（${progress.completed}/${progress.total}）`);
+        // 根据阶段显示不同的上下文标签
+        const contextLabel = {
+            analyze: '需求',
+            design: '设计目标',
+            code: '实现任务',
+            test: '测试范围',
+            review: '审查重点',
+            done: '已完成',
+        };
+        parts.push(`${contextLabel[phase]}：${pipeline.requirement}`);
+        parts.push('');
+        // 阶段指令
+        parts.push(this.getPhaseDirective(phase, currentTask, pipeline));
+        // 注入知识库内容（analyze 和 design 阶段）
+        const knowledge = this.knowledgeContext.get(pipeline.id);
+        if (knowledge && (phase === 'analyze' || phase === 'design')) {
+            parts.push('');
+            parts.push('--- 最佳实践参考 ---');
+            parts.push(knowledge.substring(0, 1500)); // 限制注入长度
+        }
+        // 质量门禁提醒
+        if (phase === 'code' || phase === 'test') {
+            parts.push('');
+            parts.push('[质量门禁] 每步完成后，Forge 会自动审查代码质量和安全性。');
+        }
+        // 任务列表
+        if (phaseTasks.length > 1) {
+            parts.push('');
+            parts.push('当前阶段任务：');
+            for (const t of phaseTasks) {
+                const icon = t.status === 'completed' ? '[完成]' : t.status === 'in_progress' ? '[进行中]' : '[待处理]';
+                parts.push(`  ${icon} ${t.title}`);
+            }
+        }
+        // 总进度
+        const totalDone = pipeline.tasks.filter(t => t.status === 'completed').length;
+        parts.push('');
+        parts.push(`总进度：${totalDone}/${pipeline.tasks.length} 任务 | 阶段 ${PHASE_ORDER.indexOf(phase) + 1}/${PHASE_ORDER.length - 1}`);
+        return parts.join('\n');
+    }
+    /**
+     * 根据 PostToolUse 事件判断是否推进阶段
+     */
+    checkAndAdvance(pipeline, event) {
+        const phase = pipeline.phase;
+        const toolName = event.tool_name || '';
+        const inputStr = event.tool_input ? JSON.stringify(event.tool_input) : '';
+        // 标记当前任务完成的信号
+        const pendingTasks = pipeline.tasks.filter(t => t.phase === phase && (t.status === 'in_progress' || t.status === 'pending'));
+        for (const currentTask of pendingTasks) {
+            const completed = this.detectTaskCompletion(phase, toolName, inputStr, event);
+            if (completed) {
+                this.store.updateTaskStatus(currentTask.id, 'completed', inputStr.substring(0, 200));
+                logger.info(`[Pipeline] 任务已完成：${currentTask.title}`);
+                break; // 每次事件只完成一个任务
+            }
+        }
+        // 兜底推进：同一阶段累积了足够多的工具调用，强制将剩余任务标记完成
+        const progress = this.store.getPhaseProgress(pipeline.id, phase);
+        const activityThreshold = this.getPhaseActivityThreshold(phase);
+        const phaseEventCount = this.phaseEventCount.get(`${pipeline.id}:${phase}`) || 0;
+        this.phaseEventCount.set(`${pipeline.id}:${phase}`, phaseEventCount + 1);
+        if (progress.completed < progress.total && phaseEventCount + 1 >= activityThreshold) {
+            logger.info(`[Pipeline] 活动阈值（${activityThreshold}）已达到，强制完成 ${PHASE_LABELS[phase]} 阶段剩余任务`);
+            const remaining = pipeline.tasks.filter(t => t.phase === phase && t.status !== 'completed');
+            for (const t of remaining) {
+                this.store.updateTaskStatus(t.id, 'completed');
+            }
+        }
+        // 检查阶段是否全部完成
+        const updatedProgress = this.store.getPhaseProgress(pipeline.id, phase);
+        if (updatedProgress.total > 0 && updatedProgress.completed >= updatedProgress.total) {
+            const newPh = nextPhase(phase);
+            this.store.updatePhase(pipeline.id, newPh);
+            this.phaseEventCount.delete(`${pipeline.id}:${phase}`);
+            logger.info(`[Pipeline] 阶段推进：${PHASE_LABELS[phase]} → ${PHASE_LABELS[newPh]}`);
+            return { advanced: true, newPhase: newPh };
+        }
+        return { advanced: false };
+    }
+    /** 每个阶段兜底推进所需的最少工具调用次数 */
+    getPhaseActivityThreshold(phase) {
+        switch (phase) {
+            case 'analyze': return 6; // 6 次工具调用后强制完成分析
+            case 'design': return 8;
+            case 'code': return 15;
+            case 'test': return 5;
+            case 'review': return 4;
+            default: return 10;
+        }
+    }
+    getPhaseDirective(phase, currentTask, pipeline) {
+        const taskDesc = currentTask?.description || '';
+        switch (phase) {
+            case 'analyze':
+                return `请分析需求并列出功能点和技术方案。${taskDesc ? `\n当前任务：${currentTask.title}\n${taskDesc}` : ''}
+完成后请明确告知"分析完成"。`;
+            case 'design':
+                return `请设计系统架构，输出目录结构和核心接口定义。${taskDesc ? `\n当前任务：${currentTask.title}\n${taskDesc}` : ''}
+请创建设计文档或直接创建目录结构。`;
+            case 'code':
+                return `请按设计方案编写代码。${taskDesc ? `\n当前任务：${currentTask.title}\n${taskDesc}` : ''}
+编写完成后继续下一个模块。`;
+            case 'test':
+                return `请为已编写的代码添加测试。${taskDesc ? `\n当前任务：${currentTask.title}\n${taskDesc}` : ''}
+${pipeline.techStack?.includes('Vitest') ? '使用 Vitest 框架。' : pipeline.techStack?.includes('Jest') ? '使用 Jest 框架。' : ''}
+编写测试后请运行测试确认通过。`;
+            case 'review':
+                return `请审查已编写的代码：
+1. 安全性检查（注入、XSS、敏感信息泄露）
+2. 代码规范检查
+3. 性能优化建议
+${taskDesc}`;
+            default:
+                return '';
+        }
+    }
+    /**
+     * 检测任务是否完成（基于工具调用模式）
+     */
+    detectTaskCompletion(phase, toolName, inputStr, event) {
+        switch (phase) {
+            case 'analyze':
+                // 分析阶段：Read/Glob/Grep 探索代码、Write/Edit 输出分析、或用户确认
+                return toolName === 'Write' || toolName === 'Edit' ||
+                    toolName === 'Read' || toolName === 'Glob' || toolName === 'Grep' ||
+                    (toolName === 'Bash' && !inputStr.includes('npm install') && !inputStr.includes('npm run')) ||
+                    inputStr.includes('分析完成') || inputStr.includes('需求明确') ||
+                    inputStr.includes('已分析') || inputStr.includes('analysis complete');
+            case 'design':
+                // 设计阶段：创建了目录结构或设计文档
+                return (toolName === 'Write' && (inputStr.includes('README') || inputStr.includes('design'))) ||
+                    (toolName === 'Bash' && inputStr.includes('mkdir'));
+            case 'code':
+                // 编码阶段：创建了源代码文件
+                return toolName === 'Write' && (inputStr.includes('.ts') || inputStr.includes('.js') ||
+                    inputStr.includes('.py') || inputStr.includes('.go') ||
+                    inputStr.includes('.java') || inputStr.includes('.rs'));
+            case 'test':
+                // 测试阶段：创建测试文件 + 测试通过
+                return (toolName === 'Write' && (inputStr.includes('test') || inputStr.includes('spec'))) ||
+                    (toolName === 'Bash' && (inputStr.includes('test') || inputStr.includes('vitest') || inputStr.includes('jest')));
+            case 'review':
+                // 审查阶段：任何 Edit 操作（修复问题）
+                return toolName === 'Edit';
+            default:
+                return false;
+        }
+    }
+}
+//# sourceMappingURL=phase-manager.js.map