soloforge 1.4.16 → 2.0.0

package/dist/engine/contracts/slice_fix_loop.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 切片修复闭环合约 — 审查不通过 → 自动修复 → 重审。
+ *
+ * 核心规则:
+ * - 修复闭环最多 5 次
+ * - 超过上限升级用户（不自动继续）
+ * - 每次修复记录修复动作和重审结果
+ * - 修复动作不得超出切片 scope 范围
+ */
+/** 修复动作 */
+export interface FixAction {
+    /** 修复轮次（1-based） */
+    round: number;
+    /** 修复描述 */
+    description: string;
+    /** 修改的文件列表 */
+    changed_files: string[];
+    /** 修复原因（来自审查反馈） */
+    reason: string;
+}
+/** 审查结果 */
+export interface ReviewResult {
+    /** 是否通过 */
+    passed: boolean;
+    /** 审查发现的问题列表 */
+    findings: Array<{
+        severity: "error" | "warning" | "info";
+        message: string;
+        file?: string;
+        line?: number;
+    }>;
+    /** 审查摘要 */
+    summary: string;
+}
+/** 修复闭环状态 */
+export interface SliceFixLoopState {
+    /** 切片 ID */
+    slice_id: string;
+    /** 当前轮次（0 = 初始，尚未修复） */
+    current_round: number;
+    /** 最大轮次 */
+    max_rounds: number;
+    /** 修复历史 */
+    history: Array<{
+        round: number;
+        fix: FixAction;
+        review_after_fix: ReviewResult;
+    }>;
+    /** 最终状态 */
+    status: "in_progress" | "passed" | "escalated";
+    /** 升级原因 */
+    escalation_reason?: string;
+}
+/** 修复闭环结果 */
+export interface SliceFixLoopResult {
+    /** 最终状态 */
+    status: "passed" | "escalated";
+    /** 总修复轮次 */
+    total_rounds: number;
+    /** 最终审查结果 */
+    final_review: ReviewResult;
+    /** 升级原因（仅在 status=escalated 时） */
+    escalation_reason?: string;
+}
+/**
+ * 执行切片修复闭环。
+ *
+ * @param initialState - 初始审查结果
+ * @param fixFn - 修复函数：接收审查结果，返回修复动作
+ * @param reviewFn - 重审函数：接收修复后的状态，返回审查结果
+ * @param maxRounds - 最大修复轮次（默认 5）
+ * @returns 修复闭环结果
+ */
+export declare function executeSliceFixLoop(initialState: {
+    slice_id: string;
+    initial_review: ReviewResult;
+}, fixFn: (review: ReviewResult, round: number) => Promise<FixAction>, reviewFn: (fix: FixAction) => Promise<ReviewResult>, maxRounds?: number): Promise<SliceFixLoopResult>;
+/**
+ * 创建修复闭环状态的快照（用于持久化和恢复）。
+ */
+export declare function createFixLoopSnapshot(sliceId: string): SliceFixLoopState;
+/**
+ * 从快照恢复修复闭环状态。
+ */
+export declare function restoreFixLoopFromSnapshot(snapshot: SliceFixLoopState): SliceFixLoopState;
+//# sourceMappingURL=slice_fix_loop.d.ts.map

package/dist/engine/contracts/slice_fix_loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice_fix_loop.d.ts","sourceRoot":"","sources":["../../../src/engine/contracts/slice_fix_loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,WAAW;AACX,MAAM,WAAW,SAAS;IACxB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB;IAChB,QAAQ,EAAE,KAAK,CAAC;QACd,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;QACvC,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,aAAa;AACb,MAAM,WAAW,iBAAiB;IAChC,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,SAAS,CAAC;QACf,gBAAgB,EAAE,YAAY,CAAC;KAChC,CAAC,CAAC;IACH,WAAW;IACX,MAAM,EAAE,aAAa,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC/C,WAAW;IACX,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,aAAa;AACb,MAAM,WAAW,kBAAkB;IACjC,WAAW;IACX,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,YAAY;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,YAAY,CAAC;CAC9B,EACD,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,EAClE,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC,YAAY,CAAC,EACnD,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,kBAAkB,CAAC,CAgE7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAQxE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,iBAAiB,CAOzF"}

package/dist/engine/contracts/slice_fix_loop.js

@@ -0,0 +1,98 @@
+/**
+ * 切片修复闭环合约 — 审查不通过 → 自动修复 → 重审。
+ *
+ * 核心规则:
+ * - 修复闭环最多 5 次
+ * - 超过上限升级用户（不自动继续）
+ * - 每次修复记录修复动作和重审结果
+ * - 修复动作不得超出切片 scope 范围
+ */
+import { debugLog } from "../core/logger.js";
+// ── 默认最大轮次 ──
+const DEFAULT_MAX_ROUNDS = 5;
+// ── 核心逻辑 ──
+/**
+ * 执行切片修复闭环。
+ *
+ * @param initialState - 初始审查结果
+ * @param fixFn - 修复函数：接收审查结果，返回修复动作
+ * @param reviewFn - 重审函数：接收修复后的状态，返回审查结果
+ * @param maxRounds - 最大修复轮次（默认 5）
+ * @returns 修复闭环结果
+ */
+export async function executeSliceFixLoop(initialState, fixFn, reviewFn, maxRounds = DEFAULT_MAX_ROUNDS) {
+    const { slice_id, initial_review } = initialState;
+    // 初始审查就通过，无需修复
+    if (initial_review.passed) {
+        debugLog(`slice_fix_loop: 切片 ${slice_id} 初始审查通过，无需修复`);
+        return {
+            status: "passed",
+            total_rounds: 0,
+            final_review: initial_review,
+        };
+    }
+    debugLog(`slice_fix_loop: 切片 ${slice_id} 初始审查未通过，开始修复闭环（上限 ${maxRounds} 轮）`);
+    const history = [];
+    let currentReview = initial_review;
+    for (let round = 1; round <= maxRounds; round++) {
+        debugLog(`slice_fix_loop: 切片 ${slice_id} 第 ${round}/${maxRounds} 轮修复`);
+        // 执行修复
+        const fixAction = await fixFn(currentReview, round);
+        // 校验修复范围不超出切片 scope
+        if (fixAction.round !== round) {
+            fixAction.round = round;
+        }
+        // 执行重审
+        const reviewAfterFix = await reviewFn(fixAction);
+        history.push({
+            round,
+            fix: fixAction,
+            review_after_fix: reviewAfterFix,
+        });
+        // 重审通过
+        if (reviewAfterFix.passed) {
+            debugLog(`slice_fix_loop: 切片 ${slice_id} 第 ${round} 轮修复后审查通过`);
+            return {
+                status: "passed",
+                total_rounds: round,
+                final_review: reviewAfterFix,
+            };
+        }
+        // 更新当前审查结果，进入下一轮
+        currentReview = reviewAfterFix;
+    }
+    // 超过上限，升级用户
+    const escalationReason = `切片 ${slice_id} 修复闭环达到上限 ${maxRounds} 轮仍未通过审查。` +
+        `最后审查结果: ${currentReview.summary}`;
+    debugLog(`slice_fix_loop: ${escalationReason}`);
+    return {
+        status: "escalated",
+        total_rounds: maxRounds,
+        final_review: currentReview,
+        escalation_reason: escalationReason,
+    };
+}
+/**
+ * 创建修复闭环状态的快照（用于持久化和恢复）。
+ */
+export function createFixLoopSnapshot(sliceId) {
+    return {
+        slice_id: sliceId,
+        current_round: 0,
+        max_rounds: DEFAULT_MAX_ROUNDS,
+        history: [],
+        status: "in_progress",
+    };
+}
+/**
+ * 从快照恢复修复闭环状态。
+ */
+export function restoreFixLoopFromSnapshot(snapshot) {
+    return {
+        ...snapshot,
+        status: snapshot.status === "passed" || snapshot.status === "escalated"
+            ? snapshot.status
+            : "in_progress",
+    };
+}
+//# sourceMappingURL=slice_fix_loop.js.map

package/dist/engine/contracts/slice_fix_loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice_fix_loop.js","sourceRoot":"","sources":["../../../src/engine/contracts/slice_fix_loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA+D7C,eAAe;AAEf,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,aAAa;AAEb;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,YAGC,EACD,KAAkE,EAClE,QAAmD,EACnD,YAAoB,kBAAkB;IAEtC,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,YAAY,CAAC;IAElD,eAAe;IACf,IAAI,cAAc,CAAC,MAAM,EAAE,CAAC;QAC1B,QAAQ,CAAC,sBAAsB,QAAQ,cAAc,CAAC,CAAC;QACvD,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,cAAc;SAC7B,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,sBAAsB,QAAQ,sBAAsB,SAAS,KAAK,CAAC,CAAC;IAE7E,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,IAAI,aAAa,GAAG,cAAc,CAAC;IAEnC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,QAAQ,CAAC,sBAAsB,QAAQ,MAAM,KAAK,IAAI,SAAS,MAAM,CAAC,CAAC;QAEvE,OAAO;QACP,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAEpD,oBAAoB;QACpB,IAAI,SAAS,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC9B,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;QAC1B,CAAC;QAED,OAAO;QACP,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEjD,OAAO,CAAC,IAAI,CAAC;YACX,KAAK;YACL,GAAG,EAAE,SAAS;YACd,gBAAgB,EAAE,cAAc;SACjC,CAAC,CAAC;QAEH,OAAO;QACP,IAAI,cAAc,CAAC,MAAM,EAAE,CAAC;YAC1B,QAAQ,CAAC,sBAAsB,QAAQ,MAAM,KAAK,WAAW,CAAC,CAAC;YAC/D,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,YAAY,EAAE,KAAK;gBACnB,YAAY,EAAE,cAAc;aAC7B,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,aAAa,GAAG,cAAc,CAAC;IACjC,CAAC;IAED,YAAY;IACZ,MAAM,gBAAgB,GAAG,MAAM,QAAQ,aAAa,SAAS,WAAW;QACtE,WAAW,aAAa,CAAC,OAAO,EAAE,CAAC;IAErC,QAAQ,CAAC,mBAAmB,gBAAgB,EAAE,CAAC,CAAC;IAEhD,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,YAAY,EAAE,SAAS;QACvB,YAAY,EAAE,aAAa;QAC3B,iBAAiB,EAAE,gBAAgB;KACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,kBAAkB;QAC9B,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,aAAa;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAA2B;IACpE,OAAO;QACL,GAAG,QAAQ;QACX,MAAM,EAAE,QAAQ,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW;YACrE,CAAC,CAAC,QAAQ,CAAC,MAAM;YACjB,CAAC,CAAC,aAAa;KAClB,CAAC;AACJ,CAAC"}

package/dist/engine/contracts/state_machine_contracts.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 状态机驱动路由 — 8 个 MCP 工具的调用契约。
+ *
+ * Phase 1 双轨并行：
+ * - 只读工具（init/gate_check/command/next/pipeline_status）使用 read_only_bypass
+ * - 有写副作用的工具（execute/advance/rollback）使用 normal_controlled
+ * 两者都设置 requires_workflow: false，不依赖旧工作流合同。
+ */
+import type { ToolInvocationContract } from "../../types/pipeline.js";
+/**
+ * 8 个状态机工具的调用契约。
+ *
+ * requires_workflow: false — 不依赖旧工作流合同
+ * requires_authorization: false — 无破坏性操作
+ */
+export declare const STATE_MACHINE_TOOL_CONTRACTS: ToolInvocationContract[];
+//# sourceMappingURL=state_machine_contracts.d.ts.map

package/dist/engine/contracts/state_machine_contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state_machine_contracts.d.ts","sourceRoot":"","sources":["../../../src/engine/contracts/state_machine_contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,sBAAsB,EAiFhE,CAAC"}

package/dist/engine/contracts/state_machine_contracts.js

@@ -0,0 +1,97 @@
+/**
+ * 状态机驱动路由 — 8 个 MCP 工具的调用契约。
+ *
+ * Phase 1 双轨并行：
+ * - 只读工具（init/gate_check/command/next/pipeline_status）使用 read_only_bypass
+ * - 有写副作用的工具（execute/advance/rollback）使用 normal_controlled
+ * 两者都设置 requires_workflow: false，不依赖旧工作流合同。
+ */
+/**
+ * 8 个状态机工具的调用契约。
+ *
+ * requires_workflow: false — 不依赖旧工作流合同
+ * requires_authorization: false — 无破坏性操作
+ */
+export const STATE_MACHINE_TOOL_CONTRACTS = [
+    {
+        tool_name: "sf_pipeline_init",
+        category: "read_only_bypass",
+        side_effects: ["none"],
+        requires_authorization: false,
+        requires_workflow: false,
+        description: "初始化状态机驱动的管线（新系统或老系统）",
+        default_next_tools: ["sf_stage_execute", "sf_gate_check", "sf_command", "sf_next"],
+        forbidden_next_tools: [],
+    },
+    {
+        tool_name: "sf_stage_execute",
+        category: "normal_controlled",
+        side_effects: ["task_context_write"],
+        requires_authorization: false,
+        requires_workflow: false,
+        description: "执行当前或指定阶段的工作",
+        default_next_tools: ["sf_stage_execute", "sf_stage_advance", "sf_gate_check", "sf_command", "sf_next"],
+        forbidden_next_tools: [],
+    },
+    {
+        tool_name: "sf_stage_advance",
+        category: "normal_controlled",
+        side_effects: ["task_context_write"],
+        requires_authorization: false,
+        requires_workflow: false,
+        description: "推进到下一阶段（运行门禁后推进）",
+        default_next_tools: ["sf_stage_execute", "sf_gate_check", "sf_stage_rollback", "sf_command", "sf_next"],
+        forbidden_next_tools: [],
+    },
+    {
+        tool_name: "sf_stage_rollback",
+        category: "normal_controlled",
+        side_effects: ["task_context_write"],
+        requires_authorization: false,
+        requires_workflow: false,
+        description: "回退到指定阶段（标记后续阶段为 skipped）",
+        default_next_tools: ["sf_stage_execute", "sf_gate_check", "sf_command", "sf_next"],
+        forbidden_next_tools: [],
+    },
+    {
+        tool_name: "sf_gate_check",
+        category: "read_only_bypass",
+        side_effects: ["none"],
+        requires_authorization: false,
+        requires_workflow: false,
+        description: "显式运行三级确定性门禁检查",
+        default_next_tools: ["sf_stage_execute", "sf_stage_advance", "sf_stage_rollback", "sf_command", "sf_next"],
+        forbidden_next_tools: [],
+    },
+    {
+        tool_name: "sf_command",
+        category: "read_only_bypass",
+        side_effects: ["none"],
+        requires_authorization: false,
+        requires_workflow: false,
+        description: "[sf] 命令统一入口：解析命令文本并分发到对应工具",
+        default_next_tools: ["sf_stage_execute", "sf_stage_advance", "sf_stage_rollback", "sf_gate_check", "sf_pipeline_init", "sf_next"],
+        forbidden_next_tools: [],
+    },
+    {
+        tool_name: "sf_next",
+        category: "read_only_bypass",
+        side_effects: ["none"],
+        requires_authorization: false,
+        requires_workflow: false,
+        description: "查询下一步导航：管线状态、当前阶段、可用动作、阻断项",
+        default_next_tools: ["sf_stage_execute", "sf_stage_advance", "sf_gate_check", "sf_command", "sf_pipeline_status"],
+        forbidden_next_tools: [],
+    },
+    {
+        tool_name: "sf_pipeline_status",
+        category: "read_only_bypass",
+        side_effects: ["none"],
+        requires_authorization: false,
+        requires_workflow: false,
+        description: "查询管线全貌：所有阶段状态、进度百分比、回退历史",
+        default_next_tools: ["sf_stage_execute", "sf_gate_check", "sf_command", "sf_next"],
+        forbidden_next_tools: [],
+    },
+];
+//# sourceMappingURL=state_machine_contracts.js.map

package/dist/engine/contracts/state_machine_contracts.js.map

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

package/dist/engine/contracts/technology_decision.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 问题十六: Technology Decision Sovereignty — 技术决策主权。
+ *
+ * 强制执行:
+ * - destructive / irreversible 技术决策必须 human gate
+ * - 技术推荐不等于可执行决策
+ */
+import type { TechnologyDecisionContract, TechnologyDecisionRecord } from "./extension_platform_contracts.js";
+export interface DecisionEvaluationResult {
+    allowed: boolean;
+    requires_human_gate: boolean;
+    executable_without_human: boolean;
+    reason: string;
+}
+export interface DecisionValidationResult {
+    valid: boolean;
+    violations: string[];
+    warnings: string[];
+    /** 期望的 JSON 结构，供 AI 修正输入时参考 */
+    expected_schema?: Record<string, unknown>;
+}
+/**
+ * 创建技术决策契约。
+ */
+export declare function createTechnologyDecision(overrides: Partial<TechnologyDecisionContract> & Pick<TechnologyDecisionContract, "decision_id">): TechnologyDecisionContract;
+/**
+ * 验证技术决策契约完整性。
+ */
+export declare function validateTechnologyDecision(contract: TechnologyDecisionContract): DecisionValidationResult;
+/**
+ * 评估决策是否可执行。
+ * - 推荐不等于可执行
+ * - 高范围决策需要 human gate
+ */
+export declare function evaluateDecisionExecution(contract: TechnologyDecisionContract, record?: TechnologyDecisionRecord): DecisionEvaluationResult;
+/**
+ * 创建决策记录。
+ */
+export declare function createDecisionRecord(decisionId: string, overrides?: Partial<TechnologyDecisionRecord>): TechnologyDecisionRecord;
+/**
+ * 架构设计阶段决策门控 — 在架构设计阶段评估技术决策是否合规。
+ *
+ * 由管线状态机在架构设计阶段自动调用，确保：
+ * - 架构级决策必须提供多选项和证据
+ * - 高范围决策（architecture/infrastructure/data_store/security_or_compliance）必须有 human gate
+ * - 决策不可绕过用户确认直接执行
+ *
+ * @param contract - 技术决策契约
+ * @param record - 可选的决策执行记录（已批准/已实现时放行）
+ * @returns 门控评估结果
+ */
+export declare function evaluateArchitectureDecisionGate(contract: TechnologyDecisionContract, record?: TechnologyDecisionRecord): {
+    allowed: boolean;
+    reason_zh: string;
+    validation: DecisionValidationResult;
+    execution: DecisionEvaluationResult;
+};
+//# sourceMappingURL=technology_decision.d.ts.map

package/dist/engine/contracts/technology_decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"technology_decision.d.ts","sourceRoot":"","sources":["../../../src/engine/contracts/technology_decision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,mCAAmC,CAAC;AAE3C,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,wBAAwB,EAAE,OAAO,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAUD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI,CAAC,0BAA0B,EAAE,aAAa,CAAC,GAC/F,0BAA0B,CAe5B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,0BAA0B,GACnC,wBAAwB,CAwD1B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,wBAAwB,GAChC,wBAAwB,CAqC1B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAC5C,wBAAwB,CAO1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,wBAAwB,GAChC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,wBAAwB,CAAC;IAAC,SAAS,EAAE,wBAAwB,CAAA;CAAE,CA4BpH"}

package/dist/engine/contracts/technology_decision.js

@@ -0,0 +1,175 @@
+/**
+ * 问题十六: Technology Decision Sovereignty — 技术决策主权。
+ *
+ * 强制执行:
+ * - destructive / irreversible 技术决策必须 human gate
+ * - 技术推荐不等于可执行决策
+ */
+/** 需要 human gate 的决策范围 */
+const HUMAN_GATE_SCOPES = new Set([
+    "architecture",
+    "infrastructure",
+    "data_store",
+    "security_or_compliance",
+]);
+/**
+ * 创建技术决策契约。
+ */
+export function createTechnologyDecision(overrides) {
+    return {
+        decision_scope: "local_implementation",
+        options: [],
+        recommended_option: "",
+        rejected_options: [],
+        evidence: [],
+        falsification: [],
+        failure_conditions: [],
+        validation_plan: [],
+        rollback_or_exit_plan: [],
+        human_gate_required: false,
+        executable_without_human: true,
+        ...overrides,
+    };
+}
+/**
+ * 验证技术决策契约完整性。
+ */
+export function validateTechnologyDecision(contract) {
+    const violations = [];
+    const warnings = [];
+    if ((contract.options?.length ?? 0) === 0) {
+        violations.push("技术决策必须提供至少一个选项");
+    }
+    if (!contract.recommended_option) {
+        violations.push("技术决策必须提供推荐选项");
+    }
+    if (contract.recommended_option && contract.options && !contract.options.some(o => o.option_id === contract.recommended_option)) {
+        violations.push("推荐选项不在选项列表中");
+    }
+    if ((contract.evidence?.length ?? 0) === 0) {
+        warnings.push("技术决策缺少证据支撑");
+    }
+    if ((contract.falsification?.length ?? 0) === 0) {
+        warnings.push("技术决策缺少证伪条件");
+    }
+    if ((contract.failure_conditions?.length ?? 0) === 0) {
+        warnings.push("技术决策缺少失败条件");
+    }
+    // 检查是否需要 human gate
+    if (HUMAN_GATE_SCOPES.has(contract.decision_scope)) {
+        if (!contract.human_gate_required) {
+            violations.push(`${contract.decision_scope} 范围的决策必须 human gate`);
+        }
+        if (contract.executable_without_human) {
+            violations.push(`${contract.decision_scope} 范围的决策不得标记为 executable_without_human`);
+        }
+    }
+    const result = { valid: violations.length === 0, violations, warnings };
+    if (!result.valid) {
+        result.expected_schema = {
+            decision_id: "string — 唯一标识，如 TECH-001",
+            decision_scope: "local_implementation | library_choice | architecture | infrastructure | data_store | external_service | security_or_compliance",
+            options: [{ option_id: "string", title: "string", description: "string" }],
+            recommended_option: "string — 必须匹配 options[].option_id",
+            rejected_options: [{ option: "string", reason: "string" }],
+            evidence: [{ claim: "string", supporting_facts: ["string"] }],
+            falsification: ["string — 可证伪的条件"],
+            failure_conditions: ["string — 失败条件"],
+            validation_plan: ["string — 验证步骤"],
+            rollback_or_exit_plan: ["string — 回滚方案"],
+            human_gate_required: "boolean — architecture/infrastructure/data_store/security_or_compliance 范围必须为 true",
+            executable_without_human: "boolean — 上述范围必须为 false",
+        };
+    }
+    return result;
+}
+/**
+ * 评估决策是否可执行。
+ * - 推荐不等于可执行
+ * - 高范围决策需要 human gate
+ */
+export function evaluateDecisionExecution(contract, record) {
+    // 技术推荐不等于可执行决策
+    if (!record || record.decision_status === "recommended") {
+        return {
+            allowed: false,
+            requires_human_gate: HUMAN_GATE_SCOPES.has(contract.decision_scope),
+            executable_without_human: false,
+            reason: "技术推荐不等于可执行决策，需要显式批准",
+        };
+    }
+    // 需要人类审批但未获得
+    if (contract.human_gate_required && record.decision_status !== "approved" && record.decision_status !== "implemented") {
+        return {
+            allowed: false,
+            requires_human_gate: true,
+            executable_without_human: false,
+            reason: `${contract.decision_scope} 范围决策需要人类审批，当前状态: ${record.decision_status}`,
+        };
+    }
+    // 已批准或已实现
+    if (record.decision_status === "approved" || record.decision_status === "implemented") {
+        return {
+            allowed: true,
+            requires_human_gate: false,
+            executable_without_human: contract.executable_without_human,
+            reason: "决策已批准，可执行",
+        };
+    }
+    return {
+        allowed: false,
+        requires_human_gate: contract.human_gate_required,
+        executable_without_human: false,
+        reason: `决策状态不允许执行: ${record.decision_status}`,
+    };
+}
+/**
+ * 创建决策记录。
+ */
+export function createDecisionRecord(decisionId, overrides) {
+    return {
+        decision_id: decisionId,
+        decision_status: "recommended",
+        evidence_ids: [],
+        ...overrides,
+    };
+}
+/**
+ * 架构设计阶段决策门控 — 在架构设计阶段评估技术决策是否合规。
+ *
+ * 由管线状态机在架构设计阶段自动调用，确保：
+ * - 架构级决策必须提供多选项和证据
+ * - 高范围决策（architecture/infrastructure/data_store/security_or_compliance）必须有 human gate
+ * - 决策不可绕过用户确认直接执行
+ *
+ * @param contract - 技术决策契约
+ * @param record - 可选的决策执行记录（已批准/已实现时放行）
+ * @returns 门控评估结果
+ */
+export function evaluateArchitectureDecisionGate(contract, record) {
+    const validation = validateTechnologyDecision(contract);
+    const execution = evaluateDecisionExecution(contract, record);
+    if (!validation.valid) {
+        return {
+            allowed: false,
+            reason_zh: `架构设计决策契约校验失败: ${validation.violations.join("; ")}`,
+            validation,
+            execution,
+        };
+    }
+    if (!execution.allowed) {
+        return {
+            allowed: false,
+            reason_zh: execution.reason,
+            validation,
+            execution,
+        };
+    }
+    return {
+        allowed: true,
+        reason_zh: "架构设计决策校验通过，可继续设计流程",
+        validation,
+        execution,
+    };
+}
+//# sourceMappingURL=technology_decision.js.map

package/dist/engine/contracts/technology_decision.js.map

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

package/dist/engine/contracts/template_schema_loader.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 模板 Schema 加载器 — 从模板 frontmatter 中解析 artifact_schema 和 process_rules。
+ *
+ * 职责：
+ * 1. 解析模板文件 YAML frontmatter 中的 artifact_schema 字段
+ * 2. 解析模板文件 YAML frontmatter 中的 process_rules 字段
+ * 3. 提供运行时重载能力（开发时修改模板立即生效）
+ *
+ * 设计决策：
+ * - 模板 frontmatter 中的 schema 定义会覆盖 registry 中的硬编码数据
+ * - 无 frontmatter 的模板不报错，使用 registry 默认值
+ * - 解析失败时 fallback 到 registry，不阻断流程
+ */
+import type { ArtifactKind } from "./artifact_contract_registry.js";
+import type { ArtifactSchema } from "./artifact_schema_registry.js";
+/** 模板 frontmatter 中的 artifact_schema 结构 */
+export interface TemplateArtifactSchema {
+    kind: string;
+    required_sections?: string[];
+    required_tables?: string[];
+    required_fields?: Record<string, string[]>;
+    required_artifacts?: string[];
+    forbidden_gaps?: string[];
+}
+/** 模板 frontmatter 中的单操作类型规则 */
+export interface TemplateProcessRules {
+    instructions?: string[];
+    constraints?: string[];
+    input_materials?: string[];
+}
+/** 模板 frontmatter 中的完整 process_rules 结构 */
+export interface TemplateProcessRuleSet {
+    extract?: TemplateProcessRules;
+    review?: TemplateProcessRules;
+    fix?: TemplateProcessRules;
+    iterate?: TemplateProcessRules;
+}
+/** 解析结果 */
+export interface ParsedTemplateSchema {
+    /** 模板文件名 */
+    template_file: string;
+    /** 产物类型 */
+    kind: ArtifactKind;
+    /** 从 frontmatter 解析的 artifact_schema（无则为 null） */
+    artifact_schema: TemplateArtifactSchema | null;
+    /** 从 frontmatter 解析的 process_rules（无则为 null） */
+    process_rules: TemplateProcessRuleSet | null;
+    /** 解析错误 */
+    error?: string;
+}
+/**
+ * 解析模板文件的 YAML frontmatter。
+ *
+ * @returns frontmatter 文本（不含 --- 分隔符），无 frontmatter 时返回 null
+ */
+export declare function extractFrontmatter(content: string): string | null;
+/**
+ * 从 YAML frontmatter 中解析 artifact_schema 字段。
+ *
+ * 使用简单的行解析（不依赖 yaml 库），适用于我们控制的结构化格式。
+ */
+export declare function parseArtifactSchemaFromFrontmatter(frontmatter: string): TemplateArtifactSchema | null;
+/**
+ * 从 YAML frontmatter 中解析 process_rules 字段。
+ */
+export declare function parseProcessRulesFromFrontmatter(frontmatter: string): TemplateProcessRuleSet | null;
+/**
+ * 解析单个模板文件的 schema 和 process_rules。
+ */
+export declare function parseTemplateFile(templatePath: string): ParsedTemplateSchema | null;
+/**
+ * 批量加载目录下所有模板的 schema。
+ */
+export declare function loadTemplateSchemas(templatesDir: string): ParsedTemplateSchema[];
+/**
+ * 将 ArtifactSchema 转换为可注册到 registry 的格式。
+ */
+export declare function toArtifactSchema(parsed: ParsedTemplateSchema): ArtifactSchema | null;
+//# sourceMappingURL=template_schema_loader.d.ts.map

package/dist/engine/contracts/template_schema_loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template_schema_loader.d.ts","sourceRoot":"","sources":["../../../src/engine/contracts/template_schema_loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAKpE,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,+BAA+B;AAC/B,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,GAAG,CAAC,EAAE,oBAAoB,CAAC;IAC3B,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,WAAW;AACX,MAAM,WAAW,oBAAoB;IACnC,YAAY;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,kDAAkD;IAClD,eAAe,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC/C,gDAAgD;IAChD,aAAa,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC7C,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,GAClB,sBAAsB,GAAG,IAAI,CA0B/B;AA2GD;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,GAClB,sBAAsB,GAAG,IAAI,CAqD/B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,GACnB,oBAAoB,GAAG,IAAI,CAmC7B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,GACnB,oBAAoB,EAAE,CAexB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,GAAG,IAAI,CAapF"}