soloforge 1.1.37 → 1.1.38

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

@@ -0,0 +1,218 @@
+/**
+ * 阶段命令注册表 — 每阶段可用动作、参数 schema、委托工具映射。
+ *
+ * 纯查表模块，零 I/O，零副作用。
+ */
+import { ALLOWED_MUTATION_STAGES } from "../../../types/state_machine.js";
+// ═══════════════════════════════════════════
+// 阶段动作注册表
+// ═══════════════════════════════════════════
+/** 每阶段可用动作 */
+const REGISTRY = {
+    "需求分析": [
+        {
+            action_id: "collect_requirements",
+            name_zh: "收集需求",
+            description_zh: "从用户描述中提取和确认需求",
+            delegate_tool: null, // Phase 1: 无委托
+            mutation_allowed: false,
+        },
+    ],
+    "现有系统分析": [
+        {
+            action_id: "analyze_existing",
+            name_zh: "分析现有系统",
+            description_zh: "分析现有代码库，识别改造点",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+    ],
+    "架构设计": [
+        {
+            action_id: "design_architecture",
+            name_zh: "架构设计",
+            description_zh: "设计系统架构，确认技术决策",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+        {
+            action_id: "confirm_decisions",
+            name_zh: "确认决策",
+            description_zh: "确认架构决策记录 (ADR)",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+        {
+            action_id: "brainstorm",
+            name_zh: "头脑风暴",
+            description_zh: "对架构方案进行头脑风暴",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+        {
+            action_id: "first_principles",
+            name_zh: "第一性原理",
+            description_zh: "从第一性原理重新审视架构决策",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+    ],
+    "详细设计": [
+        {
+            action_id: "execute",
+            name_zh: "详细设计",
+            description_zh: "生成详细设计文档（数据库、接口、前端等）",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+        {
+            action_id: "execute_db",
+            name_zh: "数据库设计",
+            description_zh: "生成数据库详细设计",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+        {
+            action_id: "execute_api",
+            name_zh: "接口设计",
+            description_zh: "生成 API 接口详细设计",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+    ],
+    "任务规划": [
+        {
+            action_id: "execute",
+            name_zh: "任务规划",
+            description_zh: "拆解任务为开发切片",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+    ],
+    "编码与单元测试": [
+        {
+            action_id: "start_slice",
+            name_zh: "开始切片",
+            description_zh: "开始实现一个开发切片",
+            delegate_tool: null,
+            mutation_allowed: true,
+        },
+        {
+            action_id: "complete_slice",
+            name_zh: "完成切片",
+            description_zh: "标记切片完成",
+            delegate_tool: null,
+            mutation_allowed: true,
+        },
+        {
+            action_id: "check_coverage",
+            name_zh: "检查覆盖率",
+            description_zh: "检查单元测试覆盖率",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+        {
+            action_id: "execute",
+            name_zh: "编码实现",
+            description_zh: "默认编码动作",
+            delegate_tool: null,
+            mutation_allowed: true,
+        },
+    ],
+    "代码审查": [
+        {
+            action_id: "execute",
+            name_zh: "代码审查",
+            description_zh: "审查代码变更",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+    ],
+    "联调验证": [
+        {
+            action_id: "execute",
+            name_zh: "联调验证",
+            description_zh: "端到端验证和集成测试",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+        {
+            action_id: "run_e2e",
+            name_zh: "端到端测试",
+            description_zh: "运行端到端集成测试",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+        {
+            action_id: "run_trial",
+            name_zh: "试运行",
+            description_zh: "试运行验证系统功能",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+        {
+            action_id: "upload_logs",
+            name_zh: "上传日志",
+            description_zh: "收集并上传试运行日志",
+            delegate_tool: null,
+            mutation_allowed: false,
+        },
+    ],
+};
+// ═══════════════════════════════════════════
+// 公共接口
+// ═══════════════════════════════════════════
+/**
+ * 获取阶段所有可用动作。
+ *
+ * @param stage - 任务阶段
+ * @returns 动作列表
+ */
+export function getStageActions(stage) {
+    return REGISTRY[stage] ?? [];
+}
+/**
+ * 按动作 ID 查找阶段动作。
+ *
+ * @param stage - 任务阶段
+ * @param actionId - 动作 ID
+ * @returns 动作定义，不存在返回 undefined
+ */
+export function findActionById(stage, actionId) {
+    return REGISTRY[stage]?.find((a) => a.action_id === actionId);
+}
+/**
+ * 获取阶段默认动作（第一个）。
+ *
+ * @param stage - 任务阶段
+ * @returns 默认动作
+ */
+export function getDefaultAction(stage) {
+    const actions = REGISTRY[stage];
+    if (!actions || actions.length === 0) {
+        // 兜底：返回通用 execute 动作
+        return {
+            action_id: "execute",
+            name_zh: "执行",
+            description_zh: "阶段默认执行动作",
+            delegate_tool: null,
+            mutation_allowed: ALLOWED_MUTATION_STAGES.has(stage),
+        };
+    }
+    return actions[0];
+}
+/**
+ * 检查阶段+动作是否允许修改源码。
+ *
+ * @param stage - 任务阶段
+ * @param actionId - 动作 ID（可选，空则使用默认动作）
+ * @returns 是否允许修改
+ */
+export function isMutationAllowed(stage, actionId) {
+    if (actionId) {
+        const action = findActionById(stage, actionId);
+        return action?.mutation_allowed ?? false;
+    }
+    return ALLOWED_MUTATION_STAGES.has(stage);
+}
+//# sourceMappingURL=stage_command_registry.js.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * 阶段执行器 — 5 阶段新执行流程。
+ *
+ * 替代 expand.ts 的执行逻辑：
+ * 1. certainty gate → 门禁评估
+ * 2. knowledge resolution → 知识查询
+ * 3. scope/acceptance → 范围和验收标准解析
+ * 4. template rendering → 提示模板选择
+ * 5. result assembly → 结果组装
+ *
+ * Phase 1: 骨架实现，核心逻辑委托给 pipeline_state_machine。
+ */
+import type { TaskStage } from "../../workflow/workflow_navigation_contract.js";
+import type { KnowledgeIndexManager } from "../../../knowledge/index_manager.js";
+import type { ProjectConfig } from "../../../types/index.js";
+import type { PipelineState, StageExecuteResult } from "../../../types/state_machine.js";
+import type { TechnologyDecisionContract, TechnologyDecisionRecord } from "../../contracts/extension_platform_contracts.js";
+export interface StageExecuteInput {
+    stage: TaskStage;
+    action?: string;
+    description?: string;
+    pipelineState: PipelineState;
+    knowledgeIndex: KnowledgeIndexManager;
+    config: ProjectConfig;
+    /** 架构设计阶段可选的技术决策契约 */
+    technologyDecisionContract?: TechnologyDecisionContract;
+    /** 架构设计阶段可选的技术决策记录（已批准/已实现时放行） */
+    technologyDecisionRecord?: TechnologyDecisionRecord;
+}
+/**
+ * 执行阶段工作 — 5 阶段流程。
+ *
+ * @param input - 阶段执行输入
+ * @returns 阶段执行结果
+ */
+export declare function executeStageWorkflow(input: StageExecuteInput): Promise<Partial<StageExecuteResult>>;
+//# sourceMappingURL=stage_executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stage_executor.d.ts","sourceRoot":"","sources":["../../../../src/engine/pipeline/state_machine/stage_executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAMzF,OAAO,KAAK,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAM5H,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,qBAAqB,CAAC;IACtC,MAAM,EAAE,aAAa,CAAC;IACtB,sBAAsB;IACtB,0BAA0B,CAAC,EAAE,0BAA0B,CAAC;IACxD,kCAAkC;IAClC,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;CACrD;AAMD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAgDzG"}

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

@@ -0,0 +1,67 @@
+/**
+ * 阶段执行器 — 5 阶段新执行流程。
+ *
+ * 替代 expand.ts 的执行逻辑：
+ * 1. certainty gate → 门禁评估
+ * 2. knowledge resolution → 知识查询
+ * 3. scope/acceptance → 范围和验收标准解析
+ * 4. template rendering → 提示模板选择
+ * 5. result assembly → 结果组装
+ *
+ * Phase 1: 骨架实现，核心逻辑委托给 pipeline_state_machine。
+ */
+import { evaluateCertaintyGate } from "./certainty_gate.js";
+import { queryKnowledgeForStage } from "./knowledge_stage_query.js";
+import { findStageContract } from "../../workflow/workflow_contract_registry.js";
+import { selectPromptTemplateByStage } from "../prompt_template_resolver.js";
+import { evaluateArchitectureDecisionGate } from "../../contracts/technology_decision.js";
+// ═══════════════════════════════════════════
+// 公共接口
+// ═══════════════════════════════════════════
+/**
+ * 执行阶段工作 — 5 阶段流程。
+ *
+ * @param input - 阶段执行输入
+ * @returns 阶段执行结果
+ */
+export async function executeStageWorkflow(input) {
+    const { stage, description, pipelineState, knowledgeIndex, config } = input;
+    // 阶段 1: certainty gate
+    const gateResult = evaluateCertaintyGate({
+        stage,
+        knowledgeIndex,
+        workDescription: description ?? "",
+        pipelineState,
+        config,
+    });
+    // 阶段 2: knowledge resolution
+    const knowledgeResults = queryKnowledgeForStage(stage, knowledgeIndex, { limit: 50 });
+    const knowledgeHitCount = knowledgeResults.length;
+    // 阶段 3: scope/acceptance — 从 StageContract 解析
+    const stageContract = findStageContract(stage);
+    // 阶段 4: template rendering — D15: 基于 stage 选择模板
+    const templateName = selectPromptTemplateByStage(stage);
+    void stageContract; // D3: Phase 2 接入 scope/acceptance 逻辑时使用
+    void templateName; // D15: Phase 2 接入模板渲染时使用
+    // 阶段 4.5: 架构设计决策门控 — 在架构设计阶段评估技术决策合规性
+    let architectureDecisionGate;
+    if (stage === "架构设计" && input.technologyDecisionContract) {
+        architectureDecisionGate = evaluateArchitectureDecisionGate(input.technologyDecisionContract, input.technologyDecisionRecord);
+    }
+    // 阶段 5: result assembly
+    return {
+        stage,
+        action: input.action ?? "execute",
+        status: pipelineState.stages.find((s) => s.stage === stage)?.status ?? "in_progress",
+        outputs: pipelineState.stages.find((s) => s.stage === stage)?.outputs ?? [],
+        knowledge_hit_count: knowledgeHitCount,
+        gate_result: gateResult,
+        next_actions: [],
+        delegate_hint: null,
+        // 架构设计阶段附加决策门控结果
+        ...(architectureDecisionGate && {
+            architecture_decision_gate: architectureDecisionGate,
+        }),
+    };
+}
+//# sourceMappingURL=stage_executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stage_executor.js","sourceRoot":"","sources":["../../../../src/engine/pipeline/state_machine/stage_executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAC;AAoB1F,8CAA8C;AAC9C,OAAO;AACP,8CAA8C;AAE9C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAwB;IACjE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAE5E,uBAAuB;IACvB,MAAM,UAAU,GAAG,qBAAqB,CAAC;QACvC,KAAK;QACL,cAAc;QACd,eAAe,EAAE,WAAW,IAAI,EAAE;QAClC,aAAa;QACb,MAAM;KACP,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACtF,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAElD,8CAA8C;IAC9C,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAE/C,gDAAgD;IAChD,MAAM,YAAY,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACxD,KAAK,aAAa,CAAC,CAAC,wCAAwC;IAC5D,KAAK,YAAY,CAAC,CAAC,yBAAyB;IAE5C,sCAAsC;IACtC,IAAI,wBAAyF,CAAC;IAC9F,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,0BAA0B,EAAE,CAAC;QACzD,wBAAwB,GAAG,gCAAgC,CACzD,KAAK,CAAC,0BAA0B,EAChC,KAAK,CAAC,wBAAwB,CAC/B,CAAC;IACJ,CAAC;IAED,wBAAwB;IACxB,OAAO;QACL,KAAK;QACL,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,SAAS;QACjC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,MAAM,IAAI,aAAa;QACpF,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,OAAO,IAAI,EAAE;QAC3E,mBAAmB,EAAE,iBAAiB;QACtC,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,EAAE;QAChB,aAAa,EAAE,IAAI;QACnB,iBAAiB;QACjB,GAAG,CAAC,wBAAwB,IAAI;YAC9B,0BAA0B,EAAE,wBAAwB;SACrD,CAAC;KACH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * 状态迁移器 — 将旧 task-*.json 格式迁移到新 pipeline-*.yaml 格式。
+ * sf_command 启动时自动检测旧格式并提示迁移。
+ */
+/** 迁移结果 */
+export interface MigrationResult {
+    success: boolean;
+    migrated_count: number;
+    skipped_count: number;
+    failed_count: number;
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+    migrated_files: string[];
+}
+/** 检测旧格式任务文件 */
+export declare function detectLegacyTaskFiles(stateDir: string): string[];
+/** 检测并迁移旧状态文件 */
+export declare function migrateLegacyStates(stateDir: string, dryRun?: boolean): MigrationResult;
+//# sourceMappingURL=state_migrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state_migrator.d.ts","sourceRoot":"","sources":["../../../../src/engine/pipeline/state_machine/state_migrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,WAAW;AACX,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAgFD,gBAAgB;AAChB,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAWhE;AAED,iBAAiB;AACjB,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe,GAAG,eAAe,CAuE9F"}

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

@@ -0,0 +1,130 @@
+/**
+ * 状态迁移器 — 将旧 task-*.json 格式迁移到新 pipeline-*.yaml 格式。
+ * sf_command 启动时自动检测旧格式并提示迁移。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { debug, internalWarn } from "../../core/logger.js";
+/** 旧状态到新阶段的映射 */
+const STATUS_TO_STAGE_MAP = {
+    "classifying": "需求分析",
+    "clarifying": "需求分析",
+    "expanding": "任务规划",
+    "executing": "编码与单元测试",
+    "verifying": "联调验证",
+    "learning": "联调验证",
+    "done": "联调验证",
+    "retrying": "编码与单元测试",
+    "failed": "编码与单元测试",
+};
+/** 旧状态到新阶段映射 */
+function mapStatusToStage(status) {
+    if (!status)
+        return "需求分析";
+    return STATUS_TO_STAGE_MAP[status] ?? "需求分析";
+}
+/** 读取旧 JSON 状态文件 */
+function readLegacyTaskState(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch (e) {
+        internalWarn("状态迁移", `读取旧状态文件失败 ${filePath}: ${e}`);
+        return null;
+    }
+}
+/** 将管线状态转换为 YAML 格式字符串（简化 YAML 序列化） */
+function toPipelineYaml(state) {
+    const lines = [
+        `pipeline_id: "${state.pipeline_id}"`,
+        `pipeline_type: "${state.pipeline_type}"`,
+        `current_stage: "${state.current_stage}"`,
+        `status: "${state.status}"`,
+        `created_at: "${state.created_at}"`,
+        `updated_at: "${state.updated_at}"`,
+        `version: ${state.version}`,
+        `metadata:`,
+        `  migrated_from: "${state.metadata.migrated_from}"`,
+    ];
+    lines.push("");
+    return lines.join("\n");
+}
+/** 检测旧格式任务文件 */
+export function detectLegacyTaskFiles(stateDir) {
+    if (!fs.existsSync(stateDir))
+        return [];
+    try {
+        const files = fs.readdirSync(stateDir);
+        return files
+            .filter(f => f.startsWith("task-") && f.endsWith(".json"))
+            .map(f => path.join(stateDir, f));
+    }
+    catch {
+        return [];
+    }
+}
+/** 检测并迁移旧状态文件 */
+export function migrateLegacyStates(stateDir, dryRun = false) {
+    const result = {
+        success: true,
+        migrated_count: 0,
+        skipped_count: 0,
+        failed_count: 0,
+        errors: [],
+        migrated_files: [],
+    };
+    const legacyFiles = detectLegacyTaskFiles(stateDir);
+    if (legacyFiles.length === 0) {
+        debug("状态迁移", "未发现旧格式状态文件");
+        return result;
+    }
+    debug("状态迁移", "发现 %d 个旧格式状态文件%s", legacyFiles.length, dryRun ? " (dry-run)" : "");
+    for (const filePath of legacyFiles) {
+        const legacyState = readLegacyTaskState(filePath);
+        if (!legacyState) {
+            result.skipped_count++;
+            result.errors.push({ file: filePath, error: "无法读取旧状态文件" });
+            continue;
+        }
+        // 跳过已迁移的文件
+        if (legacyState._migrated_to_pipeline) {
+            result.skipped_count++;
+            continue;
+        }
+        try {
+            const pipelineState = {
+                pipeline_id: legacyState.task_id,
+                pipeline_type: "new_system",
+                current_stage: mapStatusToStage(legacyState.status),
+                status: legacyState.status === "done" ? "completed" : "active",
+                created_at: legacyState.created_at ?? new Date().toISOString(),
+                updated_at: legacyState.updated_at ?? new Date().toISOString(),
+                version: 1,
+                metadata: {
+                    migrated_from: path.basename(filePath),
+                },
+            };
+            if (!dryRun) {
+                // 写入新 YAML 文件
+                const yamlFileName = `pipeline-${pipelineState.pipeline_id}.yaml`;
+                const yamlPath = path.join(stateDir, yamlFileName);
+                fs.writeFileSync(yamlPath, toPipelineYaml(pipelineState), "utf-8");
+                // 标记旧文件已迁移（而非删除，保留备份）
+                const backupPath = filePath.replace(".json", ".migrated.json");
+                fs.renameSync(filePath, backupPath);
+                result.migrated_files.push(yamlPath);
+                debug("状态迁移", "迁移 %s → %s", path.basename(filePath), yamlFileName);
+            }
+            result.migrated_count++;
+        }
+        catch (e) {
+            result.failed_count++;
+            result.success = false;
+            result.errors.push({ file: filePath, error: String(e) });
+            internalWarn("状态迁移", `迁移失败 ${filePath}: ${e}`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=state_migrator.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * 自诊断引擎 — 管线状态健康检查。
+ *
+ * 在 sf_stage_execute / sf_stage_advance / sf_next 入口自动运行。
+ * 检测：产出丢失、后阶段产出先存在、YAML 损坏、版本号冲突。
+ *
+ * 纯函数，仅读取磁盘状态，不修改任何文件。
+ */
+/** 单项诊断检查结果 */
+export interface DiagnosticCheckResult {
+    /** 检查通过 */
+    passed: boolean;
+    /** 严重程度 */
+    severity: "info" | "warning" | "error";
+    /** 问题描述 */
+    issue: string;
+    /** 修复建议 */
+    fix_hint: string;
+    /** D17: 边界情况分类 */
+    category?: "state_persistence" | "stage_flow" | "coding_stage" | "pipeline_lifecycle" | "tool_coordination";
+    /** D17: 是否可自动修复 */
+    auto_repairable?: boolean;
+    /** D17: 修复命令 */
+    fix_command?: string;
+}
+/** 诊断报告 */
+export interface DiagnosticReport {
+    /** 诊断时间戳 */
+    checked_at: string;
+    /** 总体通过 */
+    healthy: boolean;
+    /** 各项检查结果 */
+    checks: DiagnosticCheckResult[];
+}
+/**
+ * 运行自诊断。
+ *
+ * 检查管线状态的 4 项健康指标：
+ * 1. 已完成阶段产出是否丢失
+ * 2. 后阶段产出是否先于前阶段存在
+ * 3. YAML 文件是否可正常解析
+ * 4. 版本号是否一致
+ *
+ * @param stateDir - 状态目录路径
+ * @returns 诊断报告
+ */
+export declare function runSelfDiagnostic(stateDir: string): Promise<DiagnosticReport>;
+//# sourceMappingURL=state_self_diagnostic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state_self_diagnostic.d.ts","sourceRoot":"","sources":["../../../../src/engine/pipeline/state_machine/state_self_diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,eAAe;AACf,MAAM,WAAW,qBAAqB;IACpC,WAAW;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,QAAQ,CAAC,EAAE,mBAAmB,GAAG,YAAY,GAAG,cAAc,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;IAC5G,mBAAmB;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,WAAW;AACX,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa;IACb,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuEnF"}