@winspan/claude-forge 2.2.0 → 2.4.0

package/dist/pipeline/semantic-validator.js

@@ -27,6 +27,16 @@ export class SemanticValidator {
         try {
             // 1. 提取执行上下文摘要
             const contextSummary = await this.extractContextSummary(recentEvents, nodeDescription);
+            // 无调研事件时跳过语义比对，直接通过
+            if (contextSummary === '__NO_RESEARCH_EVENTS__') {
+                logger.info('[SemanticValidator] 无调研事件，跳过语义比对，默认通过');
+                return {
+                    consistent: true,
+                    coverage: 100,
+                    missing_points: [],
+                    summary: '无调研事件，跳过语义比对',
+                };
+            }
             // 2. 提取产物文档摘要
             const artifactSummary = await this.extractArtifactSummary(artifact, projectPath);
             // 3. 语义比对
@@ -54,7 +64,8 @@ export class SemanticValidator {
             e.tool_name === 'Grep' ||
             e.tool_name === 'Agent');
         if (meaningfulEvents.length === 0) {
-            return '无明显调研活动';
+            // 无调研事件时直接返回空标记，调用方据此跳过语义比对
+            return '__NO_RESEARCH_EVENTS__';
         }
         // 构建上下文摘要 prompt
         const eventsSummary = meaningfulEvents.slice(-10).map(e => {

package/dist/pipeline/semantic-validator.js.map

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

package/dist/pipeline/step-gate-keeper.d.ts

@@ -0,0 +1,28 @@
+/**
+ * StepGateKeeper - 步骤门禁守卫
+ *
+ * 职责：
+ * 1. 在 PreToolUse Hook 中检查工具是否在当前 Step 的白名单内
+ * 2. 拦截不允许的工具调用
+ * 3. 集成 deniedTools 机制（与现有机制一致）
+ */
+import type { ForgeEvent } from '../types/index.js';
+import type { NodeStepExecution } from './dynamic-node-types.js';
+import type { StepDefinition } from './step-types.js';
+import type { HandlerContext } from '../daemon/handler-context.js';
+export declare class StepGateKeeper {
+    private ctx;
+    constructor(ctx: HandlerContext);
+    /**
+     * 检查工具是否在当前 Step 的白名单内
+     */
+    checkTool(event: ForgeEvent, currentStep: NodeStepExecution, stepDef: StepDefinition): {
+        allowed: boolean;
+        reason?: string;
+    };
+    /**
+     * 检查是否有活跃的 Step 门禁（用于 PreToolUse 快速判断）
+     */
+    hasActiveStepGate(projectPath: string): boolean;
+}
+//# sourceMappingURL=step-gate-keeper.d.ts.map

package/dist/pipeline/step-gate-keeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-gate-keeper.d.ts","sourceRoot":"","sources":["../../src/pipeline/step-gate-keeper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,qBAAa,cAAc;IAEvB,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,cAAc;IAG7B;;OAEG;IACH,SAAS,CACP,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,cAAc,GACtB;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAyBD;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;CAKhD"}

package/dist/pipeline/step-gate-keeper.js

@@ -0,0 +1,47 @@
+/**
+ * StepGateKeeper - 步骤门禁守卫
+ *
+ * 职责：
+ * 1. 在 PreToolUse Hook 中检查工具是否在当前 Step 的白名单内
+ * 2. 拦截不允许的工具调用
+ * 3. 集成 deniedTools 机制（与现有机制一致）
+ */
+import { logger } from '../utils/logger.js';
+export class StepGateKeeper {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    /**
+     * 检查工具是否在当前 Step 的白名单内
+     */
+    checkTool(event, currentStep, stepDef) {
+        // 如果白名单为空，允许所有工具
+        const allowed_tools = stepDef.allowed_tools;
+        if (allowed_tools.length === 0) {
+            return { allowed: true };
+        }
+        // 检查工具是否在白名单内
+        const toolName = event.tool_name || '';
+        if (!allowed_tools.includes(toolName)) {
+            // 记录到 deniedTools（与现有机制一致）
+            const denyKey = `${event.session_id}:${event.project_path}:${toolName}:${JSON.stringify(event.tool_input ?? {})}`;
+            this.ctx.deniedTools.set(denyKey, (this.ctx.deniedTools.get(denyKey) ?? 0) + 1);
+            logger.warn(`[StepGateKeeper] 工具被拦截：${toolName} | Step: ${stepDef.name}`);
+            return {
+                allowed: false,
+                reason: `[Forge:StepGate] 当前步骤 "${stepDef.name}" 只允许使用：${allowed_tools.join(', ')}。\n\n你尝试使用的工具 "${toolName}" 不在白名单内。请使用允许的工具完成当前步骤。`,
+            };
+        }
+        return { allowed: true };
+    }
+    /**
+     * 检查是否有活跃的 Step 门禁（用于 PreToolUse 快速判断）
+     */
+    hasActiveStepGate(projectPath) {
+        // TODO: 这里需要从 PipelineEngine 获取当前 Pipeline 和 Node
+        // 暂时返回 false，避免阻塞现有流程
+        return false;
+    }
+}
+//# sourceMappingURL=step-gate-keeper.js.map

package/dist/pipeline/step-gate-keeper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-gate-keeper.js","sourceRoot":"","sources":["../../src/pipeline/step-gate-keeper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,OAAO,cAAc;IAEf;IADV,YACU,GAAmB;QAAnB,QAAG,GAAH,GAAG,CAAgB;IAC1B,CAAC;IAEJ;;OAEG;IACH,SAAS,CACP,KAAiB,EACjB,WAA8B,EAC9B,OAAuB;QAKvB,iBAAiB;QACjB,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC5C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,cAAc;QACd,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtC,2BAA2B;YAC3B,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,YAAY,IAAI,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;YAClH,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAEhF,MAAM,CAAC,IAAI,CAAC,0BAA0B,QAAQ,YAAY,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAE1E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,0BAA0B,OAAO,CAAC,IAAI,WAAW,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,QAAQ,0BAA0B;aACtI,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,WAAmB;QACnC,kDAAkD;QAClD,sBAAsB;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

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

@@ -0,0 +1,66 @@
+/**
+ * StepOrchestrator - 步骤编排器
+ *
+ * 职责：
+ * 1. 管理 Step 序列的加载和状态推进
+ * 2. 决定下一个要执行的 Step
+ * 3. 处理 Step 失败和重试逻辑
+ * 4. 集成 PendingPromptsManager 实现自动推进
+ */
+import type { DynamicPipeline, DynamicNode, NodeStepExecution } from './dynamic-node-types.js';
+import type { StepDefinition } from './step-types.js';
+export declare class StepOrchestrator {
+    /**
+     * 获取当前应执行的 Step
+     */
+    getCurrentStep(pipeline: DynamicPipeline, node: DynamicNode): NodeStepExecution | null;
+    /**
+     * 获取下一个待执行的 Step（用于推进）
+     */
+    getNextPendingStep(pipeline: DynamicPipeline, node: DynamicNode): NodeStepExecution | null;
+    /**
+     * 初始化 Node 的 Step 执行状态（Node 首次启动时调用）
+     */
+    initializeSteps(pipeline: DynamicPipeline, node: DynamicNode): NodeStepExecution[];
+    /**
+     * 推进到下一个 Step
+     */
+    advanceToNextStep(pipeline: DynamicPipeline, node: DynamicNode, currentStepExecution: NodeStepExecution): void;
+    /**
+     * 标记当前 Step 完成
+     */
+    markStepCompleted(stepExecution: NodeStepExecution, outputs: Record<string, string>): void;
+    /**
+     * 标记当前 Step 失败
+     */
+    markStepFailed(stepExecution: NodeStepExecution, reason: string): void;
+    /**
+     * 重试当前 Step
+     */
+    retryStep(stepExecution: NodeStepExecution): void;
+    /**
+     * Step 完成后，将下一个 Step 的 prompt 注入队列（自动推进）
+     */
+    injectNextStepPrompt(pipeline: DynamicPipeline, node: DynamicNode, sessionId: string, promptBuilder: any): void;
+    /**
+     * 收集 Step 的输入产物
+     */
+    collectStepInputs(stepExecution: NodeStepExecution, node: DynamicNode): Record<string, string>;
+    /**
+     * 加载节点类型定义
+     */
+    private loadNodeType;
+    /**
+     * 加载 Step 定义
+     */
+    loadStepDefinition(nodeTypeId: string, stepDefinitionId: string): StepDefinition | null;
+    /**
+     * 检查 Node 是否启用了 Step 模式
+     */
+    isStepModeEnabled(node: DynamicNode): boolean;
+    /**
+     * 获取 Node 的所有 Step 定义
+     */
+    getStepDefinitions(nodeTypeId: string): StepDefinition[];
+}
+//# sourceMappingURL=step-orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"step-orchestrator.d.ts","sourceRoot":"","sources":["../../src/pipeline/step-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAuB,MAAM,yBAAyB,CAAC;AACpH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAOtD,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,GAAG,iBAAiB,GAAG,IAAI;IAoBtF;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,GAAG,iBAAiB,GAAG,IAAI;IAW1F;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,GAAG,iBAAiB,EAAE;IAmBlF;;OAEG;IACH,iBAAiB,CACf,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,WAAW,EACjB,oBAAoB,EAAE,iBAAiB,GACtC,IAAI;IAmBP;;OAEG;IACH,iBAAiB,CACf,aAAa,EAAE,iBAAiB,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI;IAQP;;OAEG;IACH,cAAc,CACZ,aAAa,EAAE,iBAAiB,EAChC,MAAM,EAAE,MAAM,GACb,IAAI;IAOP;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,iBAAiB,GAAG,IAAI;IAQjD;;OAEG;IACH,oBAAoB,CAClB,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,GAAG,GACjB,IAAI;IAqBP;;OAEG;IACH,iBAAiB,CACf,aAAa,EAAE,iBAAiB,EAChC,IAAI,EAAE,WAAW,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAgBzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAOvF;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAK7C;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE;CAIzD"}

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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"}