@winspan/claude-forge 2.3.0 → 2.4.1

package/dist/pipeline/step-orchestrator.js

@@ -0,0 +1,183 @@
+/**
+ * StepOrchestrator - 步骤编排器
+ *
+ * 职责：
+ * 1. 管理 Step 序列的加载和状态推进
+ * 2. 决定下一个要执行的 Step
+ * 3. 处理 Step 失败和重试逻辑
+ * 4. 集成 PendingPromptsManager 实现自动推进
+ */
+import { NodeTypeRegistry } from './node-type-registry.js';
+import { pendingPromptsManager } from '../daemon/pending-prompts.js';
+import { logger } from '../utils/logger.js';
+export class StepOrchestrator {
+    /**
+     * 获取当前应执行的 Step
+     */
+    getCurrentStep(pipeline, node) {
+        const nodeType = this.loadNodeType(node.nodeTypeId);
+        if (!nodeType?.steps || nodeType.steps.length === 0) {
+            return null; // 无 steps，走传统模式
+        }
+        // 从 node.stepExecutions 中找到当前正在执行的 Step
+        const currentExecution = node.stepExecutions?.find(se => se.status === 'running' || se.status === 'validating');
+        if (currentExecution) {
+            return currentExecution;
+        }
+        // 没有正在执行的 Step，找下一个 pending Step
+        const nextPendingExecution = node.stepExecutions?.find(se => se.status === 'pending');
+        return nextPendingExecution || null;
+    }
+    /**
+     * 获取下一个待执行的 Step（用于推进）
+     */
+    getNextPendingStep(pipeline, node) {
+        const nodeType = this.loadNodeType(node.nodeTypeId);
+        if (!nodeType?.steps || nodeType.steps.length === 0) {
+            return null;
+        }
+        // 找第一个 pending 状态的 Step
+        const nextPending = node.stepExecutions?.find(se => se.status === 'pending');
+        return nextPending || null;
+    }
+    /**
+     * 初始化 Node 的 Step 执行状态（Node 首次启动时调用）
+     */
+    initializeSteps(pipeline, node) {
+        const nodeType = this.loadNodeType(node.nodeTypeId);
+        if (!nodeType?.steps || nodeType.steps.length === 0) {
+            return [];
+        }
+        const now = new Date().toISOString();
+        return nodeType.steps.map((stepDef, index) => ({
+            id: `${pipeline.id}_${node.id}_step_${index}`,
+            stepDefinitionId: stepDef.id,
+            stepName: stepDef.name,
+            status: 'pending',
+            attempts: 0,
+            outputs: {},
+            createdAt: now,
+            updatedAt: now,
+        }));
+    }
+    /**
+     * 推进到下一个 Step
+     */
+    advanceToNextStep(pipeline, node, currentStepExecution) {
+        if (!node.stepExecutions)
+            return;
+        // 找到当前 Step 在列表中的索引
+        const currentIndex = node.stepExecutions.findIndex(se => se.id === currentStepExecution.id);
+        if (currentIndex === -1)
+            return;
+        // 下一个 Step
+        const nextStep = node.stepExecutions[currentIndex + 1];
+        if (nextStep) {
+            nextStep.status = 'running';
+            nextStep.startedAt = new Date().toISOString();
+            nextStep.updatedAt = new Date().toISOString();
+            logger.info(`[StepOrchestrator] 推进到下一步：${nextStep.stepDefinitionId}`);
+        }
+        else {
+            logger.info(`[StepOrchestrator] 所有 Step 已完成`);
+        }
+    }
+    /**
+     * 标记当前 Step 完成
+     */
+    markStepCompleted(stepExecution, outputs) {
+        stepExecution.status = 'passed';
+        stepExecution.outputs = outputs;
+        stepExecution.completedAt = new Date().toISOString();
+        stepExecution.updatedAt = new Date().toISOString();
+        logger.info(`[StepOrchestrator] Step 完成：${stepExecution.stepDefinitionId}`);
+    }
+    /**
+     * 标记当前 Step 失败
+     */
+    markStepFailed(stepExecution, reason) {
+        stepExecution.status = 'failed';
+        stepExecution.failureReason = reason;
+        stepExecution.updatedAt = new Date().toISOString();
+        logger.warn(`[StepOrchestrator] Step 失败：${stepExecution.stepDefinitionId} | ${reason}`);
+    }
+    /**
+     * 重试当前 Step
+     */
+    retryStep(stepExecution) {
+        stepExecution.status = 'running';
+        stepExecution.attempts += 1;
+        stepExecution.failureReason = undefined;
+        stepExecution.updatedAt = new Date().toISOString();
+        logger.info(`[StepOrchestrator] Step 重试：${stepExecution.stepDefinitionId}（第 ${stepExecution.attempts} 次）`);
+    }
+    /**
+     * Step 完成后，将下一个 Step 的 prompt 注入队列（自动推进）
+     */
+    injectNextStepPrompt(pipeline, node, sessionId, promptBuilder // StepPromptBuilder，避免循环依赖
+    ) {
+        const nextStep = this.getNextPendingStep(pipeline, node);
+        if (!nextStep) {
+            logger.info(`[StepOrchestrator] 无下一步，Node 完成`);
+            return;
+        }
+        const stepDef = this.loadStepDefinition(node.nodeTypeId, nextStep.stepDefinitionId);
+        if (!stepDef) {
+            logger.warn(`[StepOrchestrator] Step 定义未找到：${nextStep.stepDefinitionId}`);
+            return;
+        }
+        const inputs = this.collectStepInputs(nextStep, node);
+        const prompt = promptBuilder.buildPrompt(stepDef, inputs);
+        // 注入到待执行队列
+        pendingPromptsManager.add(prompt, sessionId);
+        logger.info(`[StepOrchestrator] 已注入下一步提示：${stepDef.name}`);
+    }
+    /**
+     * 收集 Step 的输入产物
+     */
+    collectStepInputs(stepExecution, node) {
+        const inputs = {};
+        // 从前序 Step 的 outputs 中收集
+        if (node.stepExecutions) {
+            for (const prevStep of node.stepExecutions) {
+                if (prevStep.id === stepExecution.id)
+                    break; // 只收集前序 Step
+                if (prevStep.status === 'passed' && prevStep.outputs) {
+                    Object.assign(inputs, prevStep.outputs);
+                }
+            }
+        }
+        return inputs;
+    }
+    /**
+     * 加载节点类型定义
+     */
+    loadNodeType(nodeTypeId) {
+        const registry = NodeTypeRegistry.getInstance();
+        return registry.resolve(nodeTypeId);
+    }
+    /**
+     * 加载 Step 定义
+     */
+    loadStepDefinition(nodeTypeId, stepDefinitionId) {
+        const nodeType = this.loadNodeType(nodeTypeId);
+        if (!nodeType?.steps)
+            return null;
+        return nodeType.steps.find(s => s.id === stepDefinitionId) || null;
+    }
+    /**
+     * 检查 Node 是否启用了 Step 模式
+     */
+    isStepModeEnabled(node) {
+        const nodeType = this.loadNodeType(node.nodeTypeId);
+        return !!(nodeType?.steps && nodeType.steps.length > 0);
+    }
+    /**
+     * 获取 Node 的所有 Step 定义
+     */
+    getStepDefinitions(nodeTypeId) {
+        const nodeType = this.loadNodeType(nodeTypeId);
+        return nodeType?.steps || [];
+    }
+}
+//# sourceMappingURL=step-orchestrator.js.map

package/dist/pipeline/step-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-orchestrator.js","sourceRoot":"","sources":["../../src/pipeline/step-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACH,cAAc,CAAC,QAAyB,EAAE,IAAiB;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC,CAAC,gBAAgB;QAC/B,CAAC;QAED,wCAAwC;QACxC,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,CAChD,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,CAAC,MAAM,KAAK,YAAY,CAC5D,CAAC;QAEF,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,iCAAiC;QACjC,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QACtF,OAAO,oBAAoB,IAAI,IAAI,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,QAAyB,EAAE,IAAiB;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,wBAAwB;QACxB,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAC7E,OAAO,WAAW,IAAI,IAAI,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,QAAyB,EAAE,IAAiB;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7C,EAAE,EAAE,GAAG,QAAQ,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,SAAS,KAAK,EAAE;YAC7C,gBAAgB,EAAE,OAAO,CAAC,EAAE;YAC5B,QAAQ,EAAE,OAAO,CAAC,IAAI;YACtB,MAAM,EAAE,SAAgC;YACxC,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,QAAyB,EACzB,IAAiB,EACjB,oBAAuC;QAEvC,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO;QAEjC,oBAAoB;QACpB,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAC5F,IAAI,YAAY,KAAK,CAAC,CAAC;YAAE,OAAO;QAEhC,WAAW;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;QACvD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;YAC5B,QAAQ,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,QAAQ,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,6BAA6B,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,aAAgC,EAChC,OAA+B;QAE/B,aAAa,CAAC,MAAM,GAAG,QAAQ,CAAC;QAChC,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC;QAChC,aAAa,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrD,aAAa,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,8BAA8B,aAAa,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,aAAgC,EAChC,MAAc;QAEd,aAAa,CAAC,MAAM,GAAG,QAAQ,CAAC;QAChC,aAAa,CAAC,aAAa,GAAG,MAAM,CAAC;QACrC,aAAa,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,8BAA8B,aAAa,CAAC,gBAAgB,MAAM,MAAM,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,aAAgC;QACxC,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC;QACjC,aAAa,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC5B,aAAa,CAAC,aAAa,GAAG,SAAS,CAAC;QACxC,aAAa,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,8BAA8B,aAAa,CAAC,gBAAgB,MAAM,aAAa,CAAC,QAAQ,KAAK,CAAC,CAAC;IAC7G,CAAC;IAED;;OAEG;IACH,oBAAoB,CAClB,QAAyB,EACzB,IAAiB,EACjB,SAAiB,EACjB,aAAkB,CAAC,2BAA2B;;QAE9C,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QACpF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,iCAAiC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE1D,WAAW;QACX,qBAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,+BAA+B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,aAAgC,EAChC,IAAiB;QAEjB,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,yBAAyB;QACzB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC3C,IAAI,QAAQ,CAAC,EAAE,KAAK,aAAa,CAAC,EAAE;oBAAE,MAAM,CAAC,aAAa;gBAC1D,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACrD,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,UAAkB;QACrC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,UAAkB,EAAE,gBAAwB;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,EAAE,KAAK;YAAE,OAAO,IAAI,CAAC;QAElC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,gBAAgB,CAAC,IAAI,IAAI,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,IAAiB;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,UAAkB;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC/C,OAAO,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/pipeline/step-prompt-builder.d.ts

@@ -0,0 +1,32 @@
+/**
+ * StepPromptBuilder - 步骤提示构造器
+ *
+ * 职责：
+ * 1. 根据当前 Step 构造精准的 prompt
+ * 2. 只包含当前步骤的信息，不泄露后续步骤
+ * 3. 注入输入产物和完成信号说明
+ */
+import type { StepDefinition } from './step-types.js';
+export declare class StepPromptBuilder {
+    /**
+     * 构造 Step 专用 prompt
+     */
+    buildPrompt(step: StepDefinition, inputs: Record<string, string>): string;
+    /**
+     * 格式化工具白名单说明
+     */
+    formatToolConstraints(allowed_tools: string[]): string;
+    /**
+     * 格式化完成信号说明
+     */
+    formatDoneSignal(done_definition: StepDefinition['done_definition']): string;
+    /**
+     * 格式化单个检查项
+     */
+    private formatCheck;
+    /**
+     * 格式化输入产物列表
+     */
+    private formatInputs;
+}
+//# sourceMappingURL=step-prompt-builder.d.ts.map

package/dist/pipeline/step-prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-prompt-builder.d.ts","sourceRoot":"","sources":["../../src/pipeline/step-prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAoDzE;;OAEG;IACH,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM;IAOtD;;OAEG;IACH,gBAAgB,CAAC,eAAe,EAAE,cAAc,CAAC,iBAAiB,CAAC,GAAG,MAAM;IAa5E;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,YAAY;CAQrB"}

package/dist/pipeline/step-prompt-builder.js

@@ -0,0 +1,111 @@
+/**
+ * StepPromptBuilder - 步骤提示构造器
+ *
+ * 职责：
+ * 1. 根据当前 Step 构造精准的 prompt
+ * 2. 只包含当前步骤的信息，不泄露后续步骤
+ * 3. 注入输入产物和完成信号说明
+ */
+import { logger } from '../utils/logger.js';
+export class StepPromptBuilder {
+    /**
+     * 构造 Step 专用 prompt
+     */
+    buildPrompt(step, inputs) {
+        let prompt = `[Forge:Step] 当前步骤：${step.name}\n\n`;
+        // 1. 目标
+        prompt += `目标：${step.goal}\n\n`;
+        // 2. 输入产物
+        if (Object.keys(inputs).length > 0) {
+            prompt += `输入产物：\n`;
+            for (const [key, value] of Object.entries(inputs)) {
+                prompt += `- ${key}: ${value}\n`;
+            }
+            prompt += `\n`;
+        }
+        // 3. 工具约束
+        if (step.allowed_tools.length > 0) {
+            prompt += `工具约束：\n`;
+            prompt += `本步骤只允许使用以下工具：${step.allowed_tools.join(', ')}\n`;
+            prompt += `（其他工具调用将被拦截）\n\n`;
+        }
+        // 4. 完成信号
+        const signal = step.done_definition.signal || 'FORGE_STEP_DONE';
+        prompt += `完成信号：\n`;
+        prompt += `完成后请执行：echo "${signal}"\n\n`;
+        // 5. 验证标准
+        if (step.checks.length > 0) {
+            prompt += `验证标准：\n`;
+            for (const check of step.checks) {
+                const severity = check.severity ? `[${check.severity}] ` : '';
+                prompt += `- ${severity}${this.formatCheck(check)}\n`;
+            }
+            prompt += `\n`;
+        }
+        // 6. 期望产物
+        if (step.expected_artifacts && step.expected_artifacts.length > 0) {
+            prompt += `期望产物：\n`;
+            for (const artifact of step.expected_artifacts) {
+                const required = artifact.required !== false ? '（必需）' : '（可选）';
+                const pathHint = artifact.path_pattern ? ` - 路径：${artifact.path_pattern}` : '';
+                prompt += `- ${artifact.description}${required}${pathHint}\n`;
+            }
+            prompt += `\n`;
+        }
+        logger.debug(`[StepPromptBuilder] 构造 Step prompt：${step.name}`);
+        return prompt;
+    }
+    /**
+     * 格式化工具白名单说明
+     */
+    formatToolConstraints(allowed_tools) {
+        if (allowed_tools.length === 0) {
+            return '无工具限制';
+        }
+        return `只允许：${allowed_tools.join(', ')}`;
+    }
+    /**
+     * 格式化完成信号说明
+     */
+    formatDoneSignal(done_definition) {
+        if (done_definition.signal) {
+            return `执行：echo "${done_definition.signal}"`;
+        }
+        if (done_definition.required_artifacts) {
+            return `生成必需产物：${done_definition.required_artifacts.join(', ')}`;
+        }
+        if (done_definition.custom_detector) {
+            return `自定义检测：${done_definition.custom_detector}`;
+        }
+        return '执行：echo "FORGE_STEP_DONE"';
+    }
+    /**
+     * 格式化单个检查项
+     */
+    formatCheck(check) {
+        switch (check.type) {
+            case 'command':
+                return `执行命令：${check.config.command}`;
+            case 'file_exists':
+                return `文件存在：${check.config.path}`;
+            case 'content_match':
+                return `内容匹配：${check.config.path} 包含 ${check.config.pattern}`;
+            case 'semantic':
+                return `语义校验：${check.config.prompt}（覆盖率 >= ${check.config.min_coverage || 70}%）`;
+            default:
+                return `未知检查类型：${check.type}`;
+        }
+    }
+    /**
+     * 格式化输入产物列表
+     */
+    formatInputs(inputs) {
+        if (Object.keys(inputs).length === 0) {
+            return '无输入产物';
+        }
+        return Object.entries(inputs)
+            .map(([key, value]) => `- ${key}: ${value}`)
+            .join('\n');
+    }
+}
+//# sourceMappingURL=step-prompt-builder.js.map

package/dist/pipeline/step-prompt-builder.js.map

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

package/dist/pipeline/step-types.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Step 分步驱动执行模型 - 类型定义
+ *
+ * 实现"每次只告诉 Claude Code 当前这一步要干什么"的分步驱动模式
+ */
+import type { ArtifactConstraint } from '../convention/types.js';
+/** Step 状态 */
+export type StepStatus = 'pending' | 'running' | 'validating' | 'passed' | 'failed' | 'need_human';
+/** Step 检查类型 */
+export type StepCheckType = 'command' | 'file_exists' | 'content_match' | 'semantic';
+/** Step 检查严重程度 */
+export type StepCheckSeverity = 'must' | 'should' | 'may';
+/**
+ * Step 检查配置
+ */
+export interface StepCheck {
+    /** 检查 ID（用于结果关联） */
+    id: string;
+    /** 检查类型 */
+    type: StepCheckType;
+    /** 检查配置 */
+    config: {
+        /** command: 要执行的命令 */
+        command?: string;
+        /** file_exists: 文件路径 */
+        path?: string;
+        /** content_match: 文件路径 + 正则 */
+        pattern?: string;
+        /** semantic: 语义校验提示词 */
+        prompt?: string;
+        /** semantic: 产物路径 */
+        artifact_path?: string;
+        /** semantic: 覆盖率阈值（0-100） */
+        min_coverage?: number;
+    };
+    /** 严重程度（影响复杂度驱动） */
+    severity?: StepCheckSeverity;
+    /** 失败时的提示 */
+    failure_message?: string;
+}
+/**
+ * Step 定义（节点内的步骤定义）
+ */
+export interface StepDefinition {
+    /** 步骤 ID（节点内唯一） */
+    id: string;
+    /** 步骤名称 */
+    name: string;
+    /** 步骤目标（会注入到 prompt） */
+    goal: string;
+    /** 允许的工具白名单（空数组 = 允许所有） */
+    allowed_tools: string[];
+    /** 输入要求（引用上一步的产物 key） */
+    inputs?: Array<{
+        /** 产物 key（如 "design_doc", "test_file"） */
+        artifact_key: string;
+        /** 是否必需 */
+        required: boolean;
+    }>;
+    /** 验证检查（命令或断言） */
+    checks: StepCheck[];
+    /** 完成条件定义 */
+    done_definition: {
+        /** 完成信号（默认 "FORGE_STEP_DONE"） */
+        signal?: string;
+        /** 或：必需产物路径模式 */
+        required_artifacts?: string[];
+        /** 或：自定义检测函数名 */
+        custom_detector?: string;
+    };
+    /** 最大重试次数 */
+    max_retries?: number;
+    /** 超时时间（秒） */
+    timeout?: number;
+    /** 语义类别（继承自 Node，用于质量标准过滤） */
+    semantic_category?: 'analyze' | 'design' | 'code' | 'test' | 'review' | 'deploy';
+    /** 期望产物（与 Node 的 expected_artifacts 类似） */
+    expected_artifacts?: ArtifactConstraint[];
+}
+/**
+ * Step 执行状态（运行时）
+ */
+export interface StepExecution {
+    /** 执行 ID */
+    id: string;
+    /** 所属 Pipeline ID */
+    pipeline_id: string;
+    /** 所属 Node ID */
+    node_id: string;
+    /** 步骤定义 ID */
+    step_definition_id: string;
+    /** 当前状态 */
+    status: StepStatus;
+    /** 当前重试次数 */
+    attempts: number;
+    /** 产物输出（key-value） */
+    outputs: Record<string, string>;
+    /** 验证结果 */
+    validation_results?: Array<{
+        check_id: string;
+        passed: boolean;
+        message?: string;
+    }>;
+    /** 失败原因 */
+    failure_reason?: string;
+    /** 开始时间 */
+    started_at?: string;
+    /** 完成时间 */
+    completed_at?: string;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Step 验证结果
+ */
+export interface StepValidationResult {
+    /** 是否通过验证 */
+    passed: boolean;
+    /** 检查结果列表 */
+    check_results: Array<{
+        check_id: string;
+        passed: boolean;
+        message?: string;
+    }>;
+    /** 验证摘要 */
+    summary: string;
+}
+/**
+ * Step 完成决策
+ */
+export interface StepCompletionDecision {
+    /** 是否应该完成当前 Step */
+    shouldComplete: boolean;
+    /** 置信度（0-100） */
+    confidence: number;
+    /** 决策原因 */
+    reasons: string[];
+    /** 检测方法 */
+    method: 'explicit_signal' | 'artifact_based' | 'custom';
+}
+//# sourceMappingURL=step-types.d.ts.map

package/dist/pipeline/step-types.d.ts.map

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

package/dist/pipeline/step-types.js

@@ -0,0 +1,7 @@
+/**
+ * Step 分步驱动执行模型 - 类型定义
+ *
+ * 实现"每次只告诉 Claude Code 当前这一步要干什么"的分步驱动模式
+ */
+export {};
+//# sourceMappingURL=step-types.js.map

package/dist/pipeline/step-types.js.map

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

package/dist/pipeline/step-validator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * StepValidator - 步骤验证器
+ *
+ * 职责：
+ * 1. 运行 Step 的 checks
+ * 2. 判定是否通过
+ * 3. 生成验证报告
+ * 4. 集成复杂度驱动逻辑（simple/moderate/complex）
+ */
+import type { StepDefinition, StepValidationResult } from './step-types.js';
+import type { NodeStepExecution } from './dynamic-node-types.js';
+import type { SemanticValidator } from './semantic-validator.js';
+export declare class StepValidator {
+    private semanticValidator?;
+    constructor(semanticValidator?: SemanticValidator | undefined);
+    /**
+     * 验证 Step 是否完成
+     */
+    validate(step: StepDefinition, execution: NodeStepExecution, projectPath: string, complexity?: 'simple' | 'moderate' | 'complex'): Promise<StepValidationResult>;
+    /**
+     * 运行单个 check
+     */
+    private runCheck;
+    /**
+     * 获取语义校验阈值（复杂度驱动）
+     */
+    private getSemanticThreshold;
+}
+//# sourceMappingURL=step-validator.d.ts.map

package/dist/pipeline/step-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-validator.d.ts","sourceRoot":"","sources":["../../src/pipeline/step-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAa,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAMjE,qBAAa,aAAa;IAEtB,OAAO,CAAC,iBAAiB,CAAC;gBAAlB,iBAAiB,CAAC,EAAE,iBAAiB,YAAA;IAG/C;;OAEG;IACG,QAAQ,CACZ,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAC7C,OAAO,CAAC,oBAAoB,CAAC;IAkChC;;OAEG;YACW,QAAQ;IA0HtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAY7B"}