soloforge 1.5.0 → 2.0.0

package/dist/engine/pipeline/state_machine/command_state_verifier.js

@@ -0,0 +1,160 @@
+/**
+ * 命令状态校验器 — 基于管线阶段校验命令合法性。
+ * 基于管线阶段而非路由决策进行命令合法性校验。
+ */
+import { debug } from "../../core/logger.js";
+/** 合法阶段推进路径 */
+const VALID_ADVANCE_PATHS = {
+    "需求分析": ["架构设计", "现有系统分析"],
+    "现有系统分析": ["架构设计"],
+    "架构设计": ["详细设计"],
+    "详细设计": ["任务规划"],
+    "任务规划": ["编码与单元测试"],
+    "编码与单元测试": ["代码审查"],
+    "代码审查": ["联调验证"],
+    "联调验证": [],
+};
+/** 允许执行（源码修改）的阶段 */
+const EXECUTION_ALLOWED_STAGES = ["编码与单元测试", "代码审查", "联调验证"];
+/** 允许回退的阶段 */
+function getRollbackTargets(stage) {
+    const rollbackMap = {
+        "需求分析": [],
+        "现有系统分析": ["需求分析"],
+        "架构设计": ["需求分析"],
+        "详细设计": ["架构设计"],
+        "任务规划": [],
+        "编码与单元测试": ["详细设计"],
+        "代码审查": ["编码与单元测试"],
+        "联调验证": ["编码与单元测试", "架构设计"],
+    };
+    return rollbackMap[stage] ?? [];
+}
+/**
+ * 校验命令状态合法性 — 11 条规则驱动。
+ *
+ * 11 条规则：
+ * 1. init 只能在无活跃管线时调用
+ * 2. execute/advance/rollback 需要 active pipeline
+ * 3. advance 目标必须是合法下一阶段
+ * 4. execute 只在 EXECUTION_ALLOWED_STAGES 阶段允许
+ * 5. rollback 目标必须是合法回退目标
+ * 6. gate_check 任何阶段都可调用
+ * 7. status/command/next 任何状态都可调用
+ * 8. 不能从联调验证推进（最终阶段）
+ * 9. 需求分析阶段不允许 rollback（起始阶段）
+ * 10. 编码与单元测试阶段必须有切片计划才能 execute
+ * 11. 非编码阶段不能执行源码修改操作
+ */
+export function verifyCommandState(input) {
+    const findings = [];
+    const allowedActions = [];
+    // 规则 7: status/command/next 始终允许
+    if (input.action === "status" || input.action === "command" || input.action === "next") {
+        return { valid: true, findings: [], allowed_actions: [input.action], blocked_reason_zh: null };
+    }
+    // 规则 6: gate_check 任何阶段都可调用
+    if (input.action === "gate_check") {
+        return { valid: true, findings: [], allowed_actions: ["gate_check"], blocked_reason_zh: null };
+    }
+    // 规则 1: init 只能在无活跃管线时调用
+    if (input.action === "init") {
+        if (input.has_active_pipeline) {
+            findings.push({
+                rule_id: "CMD-01",
+                severity: "hard_fail",
+                message_zh: "已有活跃管线，不能重复初始化。请先完成或归档当前管线。",
+                recovery: "[sf] 状态 查看当前管线，或 [sf] 归档 归档陈旧管线",
+            });
+        }
+        return { valid: findings.length === 0, findings, allowed_actions: ["init"], blocked_reason_zh: findings.length > 0 ? findings[0].message_zh : null };
+    }
+    // 规则 2: execute/advance/rollback 需要 active pipeline
+    if (!input.has_active_pipeline) {
+        findings.push({
+            rule_id: "CMD-02",
+            severity: "hard_fail",
+            message_zh: "无活跃管线，请先初始化。",
+            recovery: "[sf] 开始 <任务描述>",
+        });
+        return { valid: false, findings, allowed_actions: ["init"], blocked_reason_zh: findings[0].message_zh };
+    }
+    // 规则 3: advance 目标必须是合法下一阶段
+    if (input.action === "advance" && input.target_stage) {
+        const validTargets = VALID_ADVANCE_PATHS[input.current_stage] ?? [];
+        if (!validTargets.includes(input.target_stage)) {
+            findings.push({
+                rule_id: "CMD-03",
+                severity: "hard_fail",
+                message_zh: `阶段 ${input.current_stage} 不能推进到 ${input.target_stage}。合法目标: ${validTargets.join("、") || "无（最终阶段）"}`,
+                recovery: `[sf] 状态 查看当前阶段，[sf] 推进 推进到下一阶段`,
+            });
+        }
+    }
+    // 规则 4: execute 只在允许的阶段可用
+    if (input.action === "execute" && !EXECUTION_ALLOWED_STAGES.includes(input.current_stage)) {
+        findings.push({
+            rule_id: "CMD-04",
+            severity: "hard_fail",
+            message_zh: `阶段 ${input.current_stage} 不允许执行操作。允许执行阶段: ${EXECUTION_ALLOWED_STAGES.join("、")}`,
+            recovery: `[sf] 推进 推进到执行阶段`,
+        });
+    }
+    // 规则 5: rollback 目标必须是合法回退目标
+    if (input.action === "rollback" && input.target_stage) {
+        const rollbackTargets = getRollbackTargets(input.current_stage);
+        if (!rollbackTargets.includes(input.target_stage)) {
+            findings.push({
+                rule_id: "CMD-05",
+                severity: "hard_fail",
+                message_zh: `阶段 ${input.current_stage} 不能回退到 ${input.target_stage}。合法回退目标: ${rollbackTargets.join("、") || "无（起始阶段）"}`,
+                recovery: `[sf] 状态 查看合法回退路径`,
+            });
+        }
+    }
+    // 规则 8: 最终阶段不能推进
+    if (input.action === "advance" && input.current_stage === "联调验证") {
+        findings.push({
+            rule_id: "CMD-08",
+            severity: "warning",
+            message_zh: "联调验证是最终阶段，无法继续推进。",
+            recovery: "[sf] 状态 查看管线完成情况",
+        });
+    }
+    // 规则 9: 起始阶段不能回退
+    if (input.action === "rollback" && input.current_stage === "需求分析") {
+        findings.push({
+            rule_id: "CMD-09",
+            severity: "warning",
+            message_zh: "需求分析是起始阶段，无回退目标。",
+        });
+    }
+    // 规则 11: 非编码阶段不能执行源码修改
+    if (input.action === "execute" && input.tool_name && input.tool_name.includes("write") && !EXECUTION_ALLOWED_STAGES.includes(input.current_stage)) {
+        findings.push({
+            rule_id: "CMD-11",
+            severity: "hard_fail",
+            message_zh: `当前阶段 ${input.current_stage} 不允许源码修改。`,
+            recovery: `推进到编码阶段后再执行修改`,
+        });
+    }
+    // 计算允许的操作
+    allowedActions.push("status", "command", "next");
+    if (input.current_stage !== "联调验证")
+        allowedActions.push("advance");
+    if (getRollbackTargets(input.current_stage).length > 0)
+        allowedActions.push("rollback");
+    allowedActions.push("gate_check");
+    if (EXECUTION_ALLOWED_STAGES.includes(input.current_stage))
+        allowedActions.push("execute");
+    const hardFailFindings = findings.filter(f => f.severity === "hard_fail");
+    const result = {
+        valid: hardFailFindings.length === 0,
+        findings,
+        allowed_actions: allowedActions,
+        blocked_reason_zh: hardFailFindings.length > 0 ? hardFailFindings[0].message_zh : null,
+    };
+    debug("命令状态校验", "阶段=%s 动作=%s 有效=%s 发现=%d", input.current_stage, input.action, result.valid, findings.length);
+    return result;
+}
+//# sourceMappingURL=command_state_verifier.js.map

package/dist/engine/pipeline/state_machine/command_state_verifier.js.map

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

package/dist/engine/pipeline/state_machine/hook_classifier.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Hook 分类器 — pre-prompt Hook 三路分流核心模块。
+ *
+ * Phase 2 新增。确定性三路分流（替代旧 NLP 级联路由）：
+ * - 路径 A: [sf] 命令 → 直接转发 sf_command
+ * - 路径 B: 开发关键词 → 注入翻译指令
+ * - 路径 C: 普通对话 → 不注入
+ *
+ * 纯函数（除 readPipelineStateSync 使用同步文件 I/O），零 MCP 依赖。
+ * 被 validate.ts (cmdPrePrompt)、check_write.ts (L1.5) 和测试文件导入。
+ */
+import type { PipelineState } from "../../../types/state_machine.js";
+import type { FailClosedResult } from "../../../engine/core/fail_closed.js";
+/** 从管线状态提取的精简 Hook 上下文 */
+export interface StageContext {
+    hasPipeline: boolean;
+    pipeline_type?: string;
+    current_stage?: string;
+    stage_status?: string;
+}
+/** 三路分流结果 */
+export interface HookClassifyResult {
+    /** 路径标识 */
+    path: "sf_command" | "dev_nl" | "general_chat";
+    /** 注入指令（general_chat 时为 null） */
+    instruction: string | null;
+    /** 管线上下文 */
+    context: StageContext;
+}
+/**
+ * 同步安全读取管线状态 — 区分"无活跃管线"和"状态损坏"。
+ *
+ * Hook 是 CLI 子进程，使用同步 I/O 避免异步初始化问题。
+ * 管线 YAML 通常 < 1KB，阻塞时间可忽略。
+ *
+ * @param projectPath - 项目根目录
+ * @returns FailClosedResult：
+ *   - ok: true, value: PipelineState | null（null = 无活跃管线）
+ *   - ok: false, corrupt: true（YAML 损坏/IO 错误/结构无效）
+ */
+export declare function readPipelineStateSyncSafe(projectPath: string): FailClosedResult<PipelineState | null>;
+/**
+ * 同步读取管线状态（向后兼容版本）。
+ *
+ * 内部调用 readPipelineStateSyncSafe，损坏时返回 null 以保持兼容。
+ * 新代码应优先使用 readPipelineStateSyncSafe 以获取 fail-closed 语义。
+ *
+ * @param projectPath - 项目根目录
+ * @returns PipelineState 或 null（无活跃管线或读取失败时）
+ */
+export declare function readPipelineStateSync(projectPath: string): PipelineState | null;
+/**
+ * 从管线状态构建精简 Hook 上下文。
+ *
+ * @param state - PipelineState 或 null
+ * @returns 精简的阶段上下文
+ */
+export declare function buildStageContext(state: PipelineState | null): StageContext;
+/**
+ * 三路分流 — 基于阶段上下文的确定性分流。
+ *
+ * 路径 A: [sf] 命令 → 注入 sf_command 调用指令
+ * 路径 B: 开发关键词 → 注入翻译指令 + 管线状态
+ * 路径 C: 普通对话 → 不注入（静默退出）
+ *
+ * @param input - 用户输入文本
+ * @param context - 阶段上下文（来自 buildStageContext）
+ * @returns 三路分流结果
+ */
+export declare function classifyInput(input: string, context: StageContext): HookClassifyResult;
+//# sourceMappingURL=hook_classifier.d.ts.map

package/dist/engine/pipeline/state_machine/hook_classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook_classifier.d.ts","sourceRoot":"","sources":["../../../../src/engine/pipeline/state_machine/hook_classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAO5E,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,aAAa;AACb,MAAM,WAAW,kBAAkB;IACjC,WAAW;IACX,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,cAAc,CAAC;IAC/C,iCAAiC;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY;IACZ,OAAO,EAAE,YAAY,CAAC;CACvB;AAaD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,GAClB,gBAAgB,CAAC,aAAa,GAAG,IAAI,CAAC,CA8BxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAG/E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,YAAY,CAU3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,GACpB,kBAAkB,CA0CpB"}

package/dist/engine/pipeline/state_machine/hook_classifier.js

@@ -0,0 +1,146 @@
+/**
+ * Hook 分类器 — pre-prompt Hook 三路分流核心模块。
+ *
+ * Phase 2 新增。确定性三路分流（替代旧 NLP 级联路由）：
+ * - 路径 A: [sf] 命令 → 直接转发 sf_command
+ * - 路径 B: 开发关键词 → 注入翻译指令
+ * - 路径 C: 普通对话 → 不注入
+ *
+ * 纯函数（除 readPipelineStateSync 使用同步文件 I/O），零 MCP 依赖。
+ * 被 validate.ts (cmdPrePrompt)、check_write.ts (L1.5) 和测试文件导入。
+ */
+import fss from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { isSfCommand } from "./sf_command_parser.js";
+// ═══════════════════════════════════════════
+// 开发关键词正则（设计文档 15.2 节）
+// ═══════════════════════════════════════════
+const DEV_KEYWORDS = /开发|编码|设计|实现|修复|重构|测试|需求|架构|接口|数据库|(?:开始).*(?:阶段|编码|开发|实现)|(?:推进).*(?:阶段|编码|开发|实现)|(?:继续).*(?:开发|编码|实现)|回退|代码|部署|上线|发布/;
+// ═══════════════════════════════════════════
+// 公共函数
+// ═══════════════════════════════════════════
+/**
+ * 同步安全读取管线状态 — 区分"无活跃管线"和"状态损坏"。
+ *
+ * Hook 是 CLI 子进程，使用同步 I/O 避免异步初始化问题。
+ * 管线 YAML 通常 < 1KB，阻塞时间可忽略。
+ *
+ * @param projectPath - 项目根目录
+ * @returns FailClosedResult：
+ *   - ok: true, value: PipelineState | null（null = 无活跃管线）
+ *   - ok: false, corrupt: true（YAML 损坏/IO 错误/结构无效）
+ */
+export function readPipelineStateSyncSafe(projectPath) {
+    const stateDir = path.join(projectPath, ".soloforge", "state");
+    try {
+        // 读取管线指针
+        const pointerPath = path.join(stateDir, "current-pipeline.json");
+        if (!fss.existsSync(pointerPath))
+            return { ok: true, value: null };
+        const pointer = JSON.parse(fss.readFileSync(pointerPath, "utf-8"));
+        if (!pointer?.pipeline_id)
+            return { ok: true, value: null };
+        // 读取管线 YAML
+        const pipelinePath = path.join(stateDir, `${pointer.pipeline_id}.yaml`);
+        if (!fss.existsSync(pipelinePath))
+            return { ok: true, value: null };
+        const content = fss.readFileSync(pipelinePath, "utf-8");
+        const parsed = YAML.parse(content);
+        // 结构校验失败：文件存在但内容损坏 → corrupt
+        if (!parsed || typeof parsed !== "object" || !parsed.current_stage || !Array.isArray(parsed.stages)) {
+            return {
+                ok: false,
+                error: new Error("管线 YAML 结构无效：缺少 current_stage 或 stages 字段"),
+                corrupt: true,
+            };
+        }
+        return { ok: true, value: parsed };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            error: e instanceof Error ? e : new Error(`管线状态读取失败: ${String(e)}`),
+            corrupt: true,
+        };
+    }
+}
+/**
+ * 同步读取管线状态（向后兼容版本）。
+ *
+ * 内部调用 readPipelineStateSyncSafe，损坏时返回 null 以保持兼容。
+ * 新代码应优先使用 readPipelineStateSyncSafe 以获取 fail-closed 语义。
+ *
+ * @param projectPath - 项目根目录
+ * @returns PipelineState 或 null（无活跃管线或读取失败时）
+ */
+export function readPipelineStateSync(projectPath) {
+    const result = readPipelineStateSyncSafe(projectPath);
+    return result.ok ? result.value : null;
+}
+/**
+ * 从管线状态构建精简 Hook 上下文。
+ *
+ * @param state - PipelineState 或 null
+ * @returns 精简的阶段上下文
+ */
+export function buildStageContext(state) {
+    if (!state)
+        return { hasPipeline: false };
+    const currentEntry = state.stages.find((s) => s.stage === state.current_stage);
+    return {
+        hasPipeline: true,
+        pipeline_type: state.system_type,
+        current_stage: state.current_stage,
+        stage_status: currentEntry?.status,
+    };
+}
+/**
+ * 三路分流 — 基于阶段上下文的确定性分流。
+ *
+ * 路径 A: [sf] 命令 → 注入 sf_command 调用指令
+ * 路径 B: 开发关键词 → 注入翻译指令 + 管线状态
+ * 路径 C: 普通对话 → 不注入（静默退出）
+ *
+ * @param input - 用户输入文本
+ * @param context - 阶段上下文（来自 buildStageContext）
+ * @returns 三路分流结果
+ */
+export function classifyInput(input, context) {
+    const trimmed = input.trim();
+    // 路径 A: [sf] 命令 → 直接转发
+    if (isSfCommand(trimmed)) {
+        return {
+            path: "sf_command",
+            instruction: "检测到 [sf] 命令。请调用 sf_command 工具，"
+                + "将用户的完整输入作为 text 参数传入，不要修改内容。",
+            context,
+        };
+    }
+    // 路径 B: 开发相关自然语言 → 注入翻译指令
+    if (DEV_KEYWORDS.test(input)) {
+        const pipelineInfo = context.hasPipeline
+            ? `\n当前管线状态：${context.current_stage}（${context.stage_status}）`
+            : "\n当前无活跃管线，建议先调用 [sf] 初始化。";
+        return {
+            path: "dev_nl",
+            instruction: "用户输入涉及开发工作。请将自然语言翻译为等效的 [sf] 命令，"
+                + "然后调用 sf_command 工具，将翻译后的 [sf] 命令作为 text 参数传入。\n"
+                + "翻译规则：\n"
+                + "- 提取动作（开始/推进/回退/检查/状态）→ 映射为 [sf] 动词\n"
+                + "- 提取阶段名（如果可确定）→ 映射为阶段参数\n"
+                + "- 提取具体工作内容 → 作为工作描述保留\n"
+                + "- 如果无法确定阶段，省略阶段名（sf_command 会使用当前阶段）"
+                + pipelineInfo
+                + "\n执行完成后，在回复末尾附上：下次可直接使用：<等效 [sf] 命令>",
+            context,
+        };
+    }
+    // 路径 C: 普通对话 → 不注入
+    return {
+        path: "general_chat",
+        instruction: null,
+        context,
+    };
+}
+//# sourceMappingURL=hook_classifier.js.map

package/dist/engine/pipeline/state_machine/hook_classifier.js.map

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

package/dist/engine/pipeline/state_machine/human_uncertainty_detector.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 人类不确定性检测 — 基于管线状态信号识别用户犹豫。
+ *
+ * Phase 1 实现简单启发式：
+ * - 回退次数过多
+ * - 阶段停留时间过长
+ * - 反复执行同一阶段
+ *
+ * 纯函数，零 I/O。
+ */
+import type { PipelineState } from "../../../types/state_machine.js";
+import type { TaskStage } from "../../workflow/workflow_navigation_contract.js";
+/** 不确定性信号 */
+export interface UncertaintySignal {
+    /** 信号类型 */
+    signal_type: "high_rollback_rate" | "long_stage_dwell" | "repeated_execution";
+    /** 严重程度 */
+    severity: "info" | "warning";
+    /** 信号描述 */
+    description_zh: string;
+    /** 建议操作 */
+    suggestion: string;
+    /** 关联阶段 */
+    stage?: TaskStage;
+}
+/**
+ * 检测人类不确定性信号。
+ *
+ * @param pipelineState - 管线状态
+ * @returns 不确定性信号列表
+ */
+export declare function detectHumanUncertainty(pipelineState: PipelineState): UncertaintySignal[];
+//# sourceMappingURL=human_uncertainty_detector.d.ts.map

package/dist/engine/pipeline/state_machine/human_uncertainty_detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human_uncertainty_detector.d.ts","sourceRoot":"","sources":["../../../../src/engine/pipeline/state_machine/human_uncertainty_detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAC;AAMhF,aAAa;AACb,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,WAAW,EAAE,oBAAoB,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;IAC9E,WAAW;IACX,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,aAAa,GAAG,iBAAiB,EAAE,CAyDxF"}

package/dist/engine/pipeline/state_machine/human_uncertainty_detector.js

@@ -0,0 +1,72 @@
+/**
+ * 人类不确定性检测 — 基于管线状态信号识别用户犹豫。
+ *
+ * Phase 1 实现简单启发式：
+ * - 回退次数过多
+ * - 阶段停留时间过长
+ * - 反复执行同一阶段
+ *
+ * 纯函数，零 I/O。
+ */
+// ═══════════════════════════════════════════
+// 公共接口
+// ═══════════════════════════════════════════
+/**
+ * 检测人类不确定性信号。
+ *
+ * @param pipelineState - 管线状态
+ * @returns 不确定性信号列表
+ */
+export function detectHumanUncertainty(pipelineState) {
+    const signals = [];
+    // 信号 1: 回退次数过多（≥ 3 次）
+    const rollbackCount = pipelineState.rollback_history.length;
+    if (rollbackCount >= 3) {
+        signals.push({
+            signal_type: "high_rollback_rate",
+            severity: "warning",
+            description_zh: `已回退 ${rollbackCount} 次，决策反复`,
+            suggestion: "建议暂停执行，与用户确认整体方向",
+            stage: pipelineState.current_stage,
+        });
+    }
+    // 信号 2: 阶段停留时间过长（started_at 距今超过 30 分钟）
+    const currentEntry = pipelineState.stages.find((s) => s.stage === pipelineState.current_stage);
+    if (currentEntry?.started_at) {
+        const startedAt = new Date(currentEntry.started_at).getTime();
+        const elapsedMinutes = (Date.now() - startedAt) / (1000 * 60);
+        if (elapsedMinutes > 30) {
+            signals.push({
+                signal_type: "long_stage_dwell",
+                severity: "info",
+                description_zh: `当前阶段 ${pipelineState.current_stage} 已停留 ${Math.round(elapsedMinutes)} 分钟`,
+                suggestion: "检查是否遇到阻碍，考虑是否需要回退或调整方案",
+                stage: pipelineState.current_stage,
+            });
+        }
+    }
+    // 信号 3: 审计日志中同一阶段反复执行（≥ 3 次 execute）
+    if (pipelineState.audit_log) {
+        const executeCounts = new Map();
+        for (const entry of pipelineState.audit_log) {
+            // 通过审计日志推断重复执行
+            if (entry.operation === "advance" && entry.from_stage) {
+                const count = (executeCounts.get(entry.from_stage) ?? 0) + 1;
+                executeCounts.set(entry.from_stage, count);
+            }
+        }
+        for (const [stage, count] of executeCounts) {
+            if (count >= 3) {
+                signals.push({
+                    signal_type: "repeated_execution",
+                    severity: "warning",
+                    description_zh: `阶段 ${stage} 已推进 ${count} 次（含回退后重做）`,
+                    suggestion: "建议与用户确认该阶段的验收标准",
+                    stage,
+                });
+            }
+        }
+    }
+    return signals;
+}
+//# sourceMappingURL=human_uncertainty_detector.js.map

package/dist/engine/pipeline/state_machine/human_uncertainty_detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"human_uncertainty_detector.js","sourceRoot":"","sources":["../../../../src/engine/pipeline/state_machine/human_uncertainty_detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuBH,8CAA8C;AAC9C,OAAO;AACP,8CAA8C;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,aAA4B;IACjE,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,sBAAsB;IACtB,MAAM,aAAa,GAAG,aAAa,CAAC,gBAAgB,CAAC,MAAM,CAAC;IAC5D,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC;YACX,WAAW,EAAE,oBAAoB;YACjC,QAAQ,EAAE,SAAS;YACnB,cAAc,EAAE,OAAO,aAAa,SAAS;YAC7C,UAAU,EAAE,kBAAkB;YAC9B,KAAK,EAAE,aAAa,CAAC,aAAa;SACnC,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAC5C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,aAAa,CAAC,aAAa,CAC/C,CAAC;IACF,IAAI,YAAY,EAAE,UAAU,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9D,MAAM,cAAc,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAC9D,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC;gBACX,WAAW,EAAE,kBAAkB;gBAC/B,QAAQ,EAAE,MAAM;gBAChB,cAAc,EAAE,QAAQ,aAAa,CAAC,aAAa,QAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK;gBAC1F,UAAU,EAAE,wBAAwB;gBACpC,KAAK,EAAE,aAAa,CAAC,aAAa;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAqB,CAAC;QACnD,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC;YAC5C,eAAe;YACf,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACtD,MAAM,KAAK,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,UAAuB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC1E,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,UAAuB,EAAE,KAAK,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QACD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;YAC3C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC;oBACX,WAAW,EAAE,oBAAoB;oBACjC,QAAQ,EAAE,SAAS;oBACnB,cAAc,EAAE,MAAM,KAAK,QAAQ,KAAK,YAAY;oBACpD,UAAU,EAAE,iBAAiB;oBAC7B,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/engine/pipeline/state_machine/knowledge_stage_query.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 知识阶段查询 — byStage 查询接口。
+ *
+ * 直接按 TaskStage 查询知识资产，不再依赖 STAGE_ROUTE_MAP 中间映射。
+ */
+import type { TaskStage } from "../../workflow/workflow_navigation_contract.js";
+import type { KnowledgeIndexManager } from "../../../knowledge/index_manager.js";
+/**
+ * 按阶段查询知识资产。
+ *
+ * 优先按 stage 字段查询，知识索引不支持时按路由标签兼容查询。
+ *
+ * @param stage - 任务阶段
+ * @param knowledgeIndex - 知识索引管理器
+ * @param filters - 可选过滤条件
+ * @returns 知识条目数组
+ */
+export declare function queryKnowledgeForStage(stage: TaskStage, knowledgeIndex: KnowledgeIndexManager, filters?: {
+    limit?: number;
+}): unknown[];
+//# sourceMappingURL=knowledge_stage_query.d.ts.map

package/dist/engine/pipeline/state_machine/knowledge_stage_query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_stage_query.d.ts","sourceRoot":"","sources":["../../../../src/engine/pipeline/state_machine/knowledge_stage_query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAMjF;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,EAChB,cAAc,EAAE,qBAAqB,EACrC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,EAAE,CAcX"}

package/dist/engine/pipeline/state_machine/knowledge_stage_query.js

@@ -0,0 +1,33 @@
+/**
+ * 知识阶段查询 — byStage 查询接口。
+ *
+ * 直接按 TaskStage 查询知识资产，不再依赖 STAGE_ROUTE_MAP 中间映射。
+ */
+// ═══════════════════════════════════════════
+// 公共接口
+// ═══════════════════════════════════════════
+/**
+ * 按阶段查询知识资产。
+ *
+ * 优先按 stage 字段查询，知识索引不支持时按路由标签兼容查询。
+ *
+ * @param stage - 任务阶段
+ * @param knowledgeIndex - 知识索引管理器
+ * @param filters - 可选过滤条件
+ * @returns 知识条目数组
+ */
+export function queryKnowledgeForStage(stage, knowledgeIndex, filters) {
+    const limit = filters?.limit ?? 50;
+    // 按阶段查询知识索引
+    try {
+        const results = knowledgeIndex.query({ stages: [stage], limit });
+        if (results.length > 0) {
+            return results;
+        }
+    }
+    catch {
+        // 阶段查询失败，返回空数组
+    }
+    return [];
+}
+//# sourceMappingURL=knowledge_stage_query.js.map

package/dist/engine/pipeline/state_machine/knowledge_stage_query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_stage_query.js","sourceRoot":"","sources":["../../../../src/engine/pipeline/state_machine/knowledge_stage_query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,8CAA8C;AAC9C,OAAO;AACP,8CAA8C;AAE9C;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAgB,EAChB,cAAqC,EACrC,OAA4B;IAE5B,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;IAEnC,YAAY;IACZ,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}