soloforge 1.4.10 → 1.4.12

package/dist/adapters/claude_code/tools.d.ts

@@ -172,6 +172,7 @@ export declare function checkDecisionSovereigntyGate(params: {
     reason_zh?: string;
     requires_human_gate?: boolean;
     not_applicable_with_reason?: string;
+    expected_schema?: Record<string, unknown>;
 }>;
 /**
  * 细节纪律门 — 复杂任务缺关键细节维度时阻断。
@@ -200,6 +201,7 @@ export declare function checkFirstPrinciplesGate(params: {
     reason_zh?: string;
     failures?: string[];
     not_applicable_with_reason?: string;
+    expected_schema?: Record<string, unknown>;
 }>;
 /**
  * 脑暴/方案探索门 — 不确定项需多方案+推荐理由+用户确认。
@@ -214,6 +216,7 @@ export declare function checkBrainstormGate(params: {
     reason_zh?: string;
     violations?: string[];
     not_applicable_with_reason?: string;
+    expected_schema?: Record<string, unknown>;
 }>;
 /**
  */

package/dist/adapters/claude_code/tools.d.ts.map

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

package/dist/adapters/claude_code/tools.js

@@ -125,21 +125,38 @@ function decodeIndexedJsonString(value) {
 function parseContractObject(value, fieldName) {
     if (value === undefined || value === null)
         return {};
-    const candidate = decodeIndexedJsonString(typeof value === "string"
-        ? (() => {
-            try {
-                return JSON.parse(value);
-            }
-            catch {
-                return undefined;
-            }
-        })()
-        : value);
+    // 字符串 → 尝试 JSON 解析（可能被 MCP 客户端序列化为 JSON 字符串）
+    let parsed;
+    if (typeof value === "string") {
+        try {
+            parsed = JSON.parse(value);
+        }
+        catch (parseErr) {
+            return { error: `${fieldName} 的 JSON 解析失败: ${parseErr.message}。请检查 JSON 格式是否正确` };
+        }
+    }
+    else {
+        parsed = value;
+    }
+    const candidate = decodeIndexedJsonString(parsed);
     if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) {
-        return { error: `${fieldName} 必须是对象或可解析为对象的 JSON 字符串` };
+        return { error: `${fieldName} 必须是 JSON 对象（当前类型: ${Array.isArray(candidate) ? "array" : typeof candidate}）。期望格式请参考 expected_schema` };
     }
     return { value: candidate };
 }
+/** 需要通过 parseContractObject 校验的契约字段列表 */
+const CONTRACT_OBJECT_FIELDS = [
+    "architecture_decision_workshop", "decision_workshop",
+    "technology_decision_contract", "technology_decision_record",
+    "detail_discipline_contract", "provided_details",
+    "first_principles_frame", "brainstorm_session",
+    "design_artifact_pack", "ood_solid_summary",
+    "backend_implementation_work_package", "code_observability_work_package",
+];
+/** 需要规范化的字段 */
+const NORMALIZED_FIELDS = {
+    decision_workshop: "decision_workshop",
+};
 // ── Zod Schema 定义 ──
 const ClassifySchema = {
     intent: z.string().describe("开发者意图描述"),
@@ -149,18 +166,18 @@ const ExpandSchema = {
     task_id: z.string().describe("sf_classify 返回的任务 ID"),
     clarification_answers: z.array(z.string()).optional().describe("对澄清问题的回答"),
     input_material_confirmations: z.array(z.string()).optional().describe("已确认安全的输入材料路径列表"),
-    architecture_decision_workshop: z.unknown().optional().describe("架构设计前已讨论并确认的六域决策记录"),
-    decision_workshop: z.unknown().optional().describe("通用决策研讨合同（技术选型/数据迁移/安全策略/部署/重构/第三方集成等）"),
-    technology_decision_contract: z.unknown().optional().describe("技术决策主权契约，含选项、推荐、证据、回滚计划和 human_gate_evidence"),
-    technology_decision_record: z.unknown().optional().describe("技术决策执行记录，记录已批准/已实现等显式决策状态"),
-    detail_discipline_contract: z.unknown().optional().describe("细节纪律契约，声明必须覆盖的边界、失败路径、回滚和证据维度"),
-    provided_details: z.unknown().optional().describe("细节纪律已提供证据，按 required_dimensions 映射为字符串数组"),
-    first_principles_frame: z.unknown().optional().describe("高影响任务的第一性原理框架"),
-    brainstorm_session: z.unknown().optional().describe("不确定项/方案选择的脑暴与方案探索会话"),
-    design_artifact_pack: z.unknown().optional().describe("设计产物包路径映射或已复验状态"),
-    ood_solid_summary: z.unknown().optional().describe("复杂编码任务的 OOD/SOLID 设计摘要"),
-    backend_implementation_work_package: z.unknown().optional().describe("后端接口实现的工程工作包"),
-    code_observability_work_package: z.unknown().optional().describe("代码可维护性与可观测性工作包"),
+    architecture_decision_workshop: z.record(z.unknown()).optional().describe("架构设计前六域决策记录。示例 {domains:[{domain:'backend',options:[{id:'opt-a',title:'...'}],recommended_option_id:'opt-a',user_confirmation_ref:'confirm:...'}],status:'confirmed'}"),
+    decision_workshop: z.record(z.unknown()).optional().describe("通用决策研讨合同。示例 {activated_packs:['delivery_validation'],domains:[{domain:'delivery_validation',options:[{id:'opt-a',title:'...'}],recommended_option_id:'opt-a',user_confirmation_ref:'confirm:...'}],status:'confirmed'}"),
+    technology_decision_contract: z.record(z.unknown()).optional().describe("技术决策主权契约。示例 {decision_id:'TECH-001',decision_scope:'architecture',options:[{option_id:'opt-a',title:'A',description:'...'}],recommended_option:'opt-a',rejected_options:[{option:'opt-b',reason:'...'}],evidence:[{claim:'...',supporting_facts:['...']}],falsification:['...'],failure_conditions:['...'],validation_plan:['...'],rollback_or_exit_plan:['...'],human_gate_required:true,human_gate_evidence:'confirm:...',executable_without_human:false}"),
+    technology_decision_record: z.record(z.unknown()).optional().describe("技术决策执行记录。示例 {decision_id:'TECH-001',selected_option:'opt-a',status:'approved',approved_by:'user',evidence_refs:['confirm:...']}"),
+    detail_discipline_contract: z.record(z.unknown()).optional().describe("细节纪律契约。示例 {contract_id:'detail-001',required_dimensions:['boundary','failure_path','rollback'],blocking_dimensions:['boundary'],status:'ready'}"),
+    provided_details: z.record(z.unknown()).optional().describe("细节纪律已提供证据。示例 {boundary:['只检查 readiness，不改代码'],failure_path:['unknown 时标记证据不足'],rollback:['无写入，无需回滚']}"),
+    first_principles_frame: z.record(z.unknown()).optional().describe("高影响任务第一性原理框架。示例 {fundamental_need:'...',known_facts:['...'],assumptions:['...'],candidate_solutions:[{solution_id:'s1',description:'...',complexity:'low'}],simplest_viable_solution:'s1',chosen_solution:'s1',falsification_questions:['...'],why_not_legacy_path:'...'}"),
+    brainstorm_session: z.record(z.unknown()).optional().describe("不确定项/方案选择会话。示例 {trigger:'uncertainty',options:[{option_id:'opt-a',title:'...',description:'...',pros:['...'],cons:['...']}],recommended_option_id:'opt-a',rejected_option_ids:['opt-b'],failure_conditions:['...'],brainstorm_status:'options_ready'}"),
+    design_artifact_pack: z.record(z.unknown()).optional().describe("设计产物包路径映射或复验状态。示例 {status:'implementation_ready',paths:{architecture_document:'docs/architecture/01-架构设计文档.md'},verification_refs:['verification:...']}"),
+    ood_solid_summary: z.record(z.unknown()).optional().describe("复杂编码任务 OOD/SOLID 摘要。示例 {status:'confirmed',responsibilities:['...'],interfaces:['...'],risks:['...'],evidence_refs:['...']}"),
+    backend_implementation_work_package: z.record(z.unknown()).optional().describe("后端接口实现工程工作包。示例 {status:'confirmed',api_boundary:['...'],transaction_boundary:['...'],error_contract:['...'],evidence_refs:['...']}"),
+    code_observability_work_package: z.record(z.unknown()).optional().describe("代码可维护性与可观测性工作包。示例 {status:'confirmed',logging_plan:['...'],comment_plan:['...'],sensitive_logging_policy:'redact',evidence_refs:['...']}"),
 };
 const VerifySchema = {
     task_id: z.string().describe("任务 ID"),
@@ -178,7 +195,7 @@ const LearnSchema = {
 };
 const StatusSchema = {
     task_id: z.string().optional().describe("任务 ID（不传则查当前任务）"),
-    action: z.enum(["current", "recent", "resume", "cancel", "archive_stale"]).optional().describe("操作类型"),
+    action: z.enum(["current", "recent", "resume", "cancel", "archive_stale", "retry_expand"]).optional().describe("操作类型"),
     confirm: z.boolean().optional().describe("确认执行会写入状态的操作，例如 cancel/archive_stale/job_cancel"),
     authorized: z.boolean().optional().describe("confirm 的兼容别名"),
     job_id: z.string().optional().describe("Job ID（用于 job_status / job_resume / job_cancel）"),
@@ -607,7 +624,7 @@ export async function checkDecisionSovereigntyGate(params) {
     const decisionModule = await lazyTechnologyDecision();
     const validation = decisionModule.validateTechnologyDecision(decisionContract);
     if (!validation.valid) {
-        return { allowed: false, reason_zh: `技术选型决策校验失败: ${validation.violations.join("; ")}` };
+        return { allowed: false, reason_zh: `技术选型决策校验失败: ${validation.violations.join("; ")}`, expected_schema: validation.expected_schema };
     }
     // 有决策记录时评估执行状态
     const decisionRecord = params.ctx.technology_decision_record;
@@ -672,7 +689,7 @@ export async function checkFirstPrinciplesGate(params) {
     const fpModule = await lazyFirstPrinciples();
     const validation = fpModule.validateFirstPrinciplesForHighImpact(fpFrame);
     if (!validation.passed) {
-        return { allowed: false, reason_zh: `高影响任务缺第一性原理推理: ${validation.violations.join("; ")}`, failures: validation.violations };
+        return { allowed: false, reason_zh: `高影响任务缺第一性原理推理: ${validation.violations.join("; ")}`, failures: validation.violations, expected_schema: validation.expected_schema };
     }
     return { allowed: true };
 }
@@ -695,7 +712,7 @@ export async function checkBrainstormGate(params) {
     const brainstormModule = await lazyBrainstormContract();
     const validation = brainstormModule.validateBrainstormSession(brainstormSession);
     if (!validation.valid) {
-        return { allowed: false, reason_zh: `方案探索不完整: ${validation.violations.join("; ")}`, violations: validation.violations };
+        return { allowed: false, reason_zh: `方案探索不完整: ${validation.violations.join("; ")}`, violations: validation.violations, expected_schema: validation.expected_schema };
     }
     // 脑暴推荐永远不能自动执行 — 需 Decision Sovereignty human gate
     const canAutoExec = brainstormModule.canBrainstormAutoExecute(brainstormSession);
@@ -1329,7 +1346,7 @@ export async function registerTools(server, deps) {
             }
             catch (err) {
                 const errorNextTools = name === "sf_expand"
-                    ? ["sf_status", "sf_debug", "sf_governance_report"]
+                    ? ["sf_expand", "sf_status", "sf_debug", "sf_governance_report"]
                     : contract.default_next_tools;
                 const errorForbiddenTools = name === "sf_expand"
                     ? ["sf_verify", "sf_review", "sf_deliver", "sf_scaffold"]
@@ -1484,161 +1501,27 @@ export async function registerTools(server, deps) {
         if (!ctx || !ctx.classification) {
             return { result: { error: "任务不存在或尚未分类，请先调用 sf_classify" } };
         }
-        const existingArchitectureWorkshop = parseContractObject(ctx.architecture_decision_workshop, "architecture_decision_workshop");
-        if (existingArchitectureWorkshop.error) {
-            return { result: { error: existingArchitectureWorkshop.error, status: "invalid_input" } };
-        }
-        const existingDecisionWorkshop = parseContractObject(ctx.decision_workshop, "decision_workshop");
-        if (existingDecisionWorkshop.error) {
-            return { result: { error: existingDecisionWorkshop.error, status: "invalid_input" } };
-        }
-        const existingTechnologyDecisionContract = parseContractObject(ctx.technology_decision_contract, "technology_decision_contract");
-        if (existingTechnologyDecisionContract.error) {
-            return { result: { error: existingTechnologyDecisionContract.error, status: "invalid_input" } };
-        }
-        const existingTechnologyDecisionRecord = parseContractObject(ctx.technology_decision_record, "technology_decision_record");
-        if (existingTechnologyDecisionRecord.error) {
-            return { result: { error: existingTechnologyDecisionRecord.error, status: "invalid_input" } };
-        }
-        const existingDetailContract = parseContractObject(ctx.detail_discipline_contract, "detail_discipline_contract");
-        if (existingDetailContract.error) {
-            return { result: { error: existingDetailContract.error, status: "invalid_input" } };
-        }
-        const existingProvidedDetails = parseContractObject(ctx.provided_details, "provided_details");
-        if (existingProvidedDetails.error) {
-            return { result: { error: existingProvidedDetails.error, status: "invalid_input" } };
-        }
-        const existingFirstPrinciplesFrame = parseContractObject(ctx.first_principles_frame, "first_principles_frame");
-        if (existingFirstPrinciplesFrame.error) {
-            return { result: { error: existingFirstPrinciplesFrame.error, status: "invalid_input" } };
-        }
-        const existingBrainstormSession = parseContractObject(ctx.brainstorm_session, "brainstorm_session");
-        if (existingBrainstormSession.error) {
-            return { result: { error: existingBrainstormSession.error, status: "invalid_input" } };
-        }
-        const existingDesignArtifactPack = parseContractObject(ctx.design_artifact_pack, "design_artifact_pack");
-        if (existingDesignArtifactPack.error) {
-            return { result: { error: existingDesignArtifactPack.error, status: "invalid_input" } };
-        }
-        const existingOodSolidSummary = parseContractObject(ctx.ood_solid_summary, "ood_solid_summary");
-        if (existingOodSolidSummary.error) {
-            return { result: { error: existingOodSolidSummary.error, status: "invalid_input" } };
-        }
-        const existingBackendImplementationWorkPackage = parseContractObject(ctx.backend_implementation_work_package, "backend_implementation_work_package");
-        if (existingBackendImplementationWorkPackage.error) {
-            return { result: { error: existingBackendImplementationWorkPackage.error, status: "invalid_input" } };
-        }
-        const existingCodeObservabilityWorkPackage = parseContractObject(ctx.code_observability_work_package, "code_observability_work_package");
-        if (existingCodeObservabilityWorkPackage.error) {
-            return { result: { error: existingCodeObservabilityWorkPackage.error, status: "invalid_input" } };
-        }
-        if (existingArchitectureWorkshop.value)
-            ctx.architecture_decision_workshop = existingArchitectureWorkshop.value;
-        if (existingDecisionWorkshop.value) {
-            ctx.decision_workshop = (await lazyDecisionWorkshop()).normalizeDecisionWorkshopContract(existingDecisionWorkshop.value, args.task_id) ?? existingDecisionWorkshop.value;
-        }
-        if (existingTechnologyDecisionContract.value)
-            ctx.technology_decision_contract = existingTechnologyDecisionContract.value;
-        if (existingTechnologyDecisionRecord.value)
-            ctx.technology_decision_record = existingTechnologyDecisionRecord.value;
-        if (existingDetailContract.value)
-            ctx.detail_discipline_contract = existingDetailContract.value;
-        if (existingProvidedDetails.value)
-            ctx.provided_details = existingProvidedDetails.value;
-        if (existingFirstPrinciplesFrame.value)
-            ctx.first_principles_frame = existingFirstPrinciplesFrame.value;
-        if (existingBrainstormSession.value)
-            ctx.brainstorm_session = existingBrainstormSession.value;
-        if (existingDesignArtifactPack.value)
-            ctx.design_artifact_pack = existingDesignArtifactPack.value;
-        if (existingOodSolidSummary.value)
-            ctx.ood_solid_summary = existingOodSolidSummary.value;
-        if (existingBackendImplementationWorkPackage.value)
-            ctx.backend_implementation_work_package = existingBackendImplementationWorkPackage.value;
-        if (existingCodeObservabilityWorkPackage.value)
-            ctx.code_observability_work_package = existingCodeObservabilityWorkPackage.value;
-        if (args.architecture_decision_workshop) {
-            const parsed = parseContractObject(args.architecture_decision_workshop, "architecture_decision_workshop");
-            if (parsed.error)
-                return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.architecture_decision_workshop = parsed.value;
-        }
-        if (args.decision_workshop) {
-            const parsed = parseContractObject(args.decision_workshop, "decision_workshop");
-            if (parsed.error)
-                return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.decision_workshop = (await lazyDecisionWorkshop()).normalizeDecisionWorkshopContract(parsed.value, args.task_id) ?? parsed.value;
-        }
-        if (args.technology_decision_contract) {
-            const parsed = parseContractObject(args.technology_decision_contract, "technology_decision_contract");
-            if (parsed.error)
-                return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.technology_decision_contract = parsed.value;
-        }
-        if (args.technology_decision_record) {
-            const parsed = parseContractObject(args.technology_decision_record, "technology_decision_record");
-            if (parsed.error)
-                return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.technology_decision_record = parsed.value;
-        }
-        if (args.detail_discipline_contract) {
-            const parsed = parseContractObject(args.detail_discipline_contract, "detail_discipline_contract");
-            if (parsed.error)
-                return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.detail_discipline_contract = parsed.value;
-        }
-        if (args.provided_details) {
-            const parsed = parseContractObject(args.provided_details, "provided_details");
-            if (parsed.error)
-                return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.provided_details = parsed.value;
-        }
-        if (args.first_principles_frame) {
-            const parsed = parseContractObject(args.first_principles_frame, "first_principles_frame");
-            if (parsed.error)
-                return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.first_principles_frame = parsed.value;
-        }
-        if (args.brainstorm_session) {
-            const parsed = parseContractObject(args.brainstorm_session, "brainstorm_session");
-            if (parsed.error)
-                return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.brainstorm_session = parsed.value;
-        }
-        if (args.design_artifact_pack) {
-            const parsed = parseContractObject(args.design_artifact_pack, "design_artifact_pack");
-            if (parsed.error)
-                return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.design_artifact_pack = parsed.value;
-        }
-        if (args.ood_solid_summary) {
-            const parsed = parseContractObject(args.ood_solid_summary, "ood_solid_summary");
-            if (parsed.error)
-                return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.ood_solid_summary = parsed.value;
-        }
-        if (args.backend_implementation_work_package) {
-            const parsed = parseContractObject(args.backend_implementation_work_package, "backend_implementation_work_package");
+        // 合并校验 + 应用：ctx 已存储值 → args 覆盖值，统一解析和规范化
+        let needsSave = false;
+        for (const field of CONTRACT_OBJECT_FIELDS) {
+            // args 优先，其次 ctx 已存储值
+            const raw = args[field] ?? ctx[field];
+            if (!raw)
+                continue;
+            const parsed = parseContractObject(raw, field);
             if (parsed.error)
                 return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.backend_implementation_work_package = parsed.value;
+            if (parsed.value) {
+                ctx[field] = field === "decision_workshop"
+                    ? ((await lazyDecisionWorkshop()).normalizeDecisionWorkshopContract(parsed.value, args.task_id) ?? parsed.value)
+                    : parsed.value;
+                needsSave = true;
+            }
         }
-        if (args.code_observability_work_package) {
-            const parsed = parseContractObject(args.code_observability_work_package, "code_observability_work_package");
-            if (parsed.error)
-                return { result: { error: parsed.error, status: "invalid_input" } };
-            ctx.code_observability_work_package = parsed.value;
-        }
-        if (args.architecture_decision_workshop || args.decision_workshop
-            || args.technology_decision_contract || args.technology_decision_record
-            || args.detail_discipline_contract || args.provided_details
-            || args.first_principles_frame || args.brainstorm_session
-            || args.design_artifact_pack
-            || args.ood_solid_summary || args.backend_implementation_work_package || args.code_observability_work_package) {
+        if (needsSave)
             await taskContext.save(ctx);
-        }
-        // 状态守卫：classifying/expanding/clarifying → expanding
-        if (ctx.status === "classifying" || ctx.status === "clarifying") {
+        // 状态守卫：classifying/expanding/clarifying/failed → expanding
+        if (ctx.status === "classifying" || ctx.status === "clarifying" || ctx.status === "failed") {
             await taskContext.updateStatus(args.task_id, "expanding");
             ctx.status = "expanding";
         }
@@ -1699,6 +1582,7 @@ export async function registerTools(server, deps) {
                 plan_context: planContext,
                 input_material_confirmations: args.input_material_confirmations,
                 task_id: args.task_id,
+                brainstorm_session: ctx.brainstorm_session ?? undefined,
             });
         }
         catch (expandErr) {
@@ -1960,7 +1844,8 @@ export async function registerTools(server, deps) {
                     result: {
                         error: decisionGate.reason_zh,
                         status: "blocked",
-                        recovery: decisionGate.requires_human_gate ? "请提供技术决策确认证据（human_gate_evidence）" : "技术选型决策校验失败，请提供 technology_decision_contract",
+                        expected_schema: decisionGate.expected_schema,
+                        recovery: decisionGate.requires_human_gate ? "请提供技术决策确认证据（human_gate_evidence）" : "技术选型决策校验失败，请按照 expected_schema 格式提供 technology_decision_contract",
                     },
                 };
             }
@@ -1987,8 +1872,9 @@ export async function registerTools(server, deps) {
                     result: {
                         error: fpGate.reason_zh,
                         failures: fpGate.failures,
+                        expected_schema: fpGate.expected_schema,
                         status: "blocked",
-                        recovery: "高影响任务缺 first_principles_frame，请提供后重新 sf_expand",
+                        recovery: "高影响任务缺 first_principles_frame，请按照 expected_schema 格式提供后重新 sf_expand",
                     },
                 };
             }
@@ -2001,8 +1887,9 @@ export async function registerTools(server, deps) {
                     result: {
                         error: brainstormGate.reason_zh,
                         violations: brainstormGate.violations,
+                        expected_schema: brainstormGate.expected_schema,
                         status: "blocked",
-                        recovery: "不确定项/方案选择缺 brainstorm_session，请提供后重新 sf_expand",
+                        recovery: "不确定项/方案选择缺 brainstorm_session，请按照 expected_schema 格式提供后重新 sf_expand",
                     },
                 };
             }
@@ -2318,6 +2205,40 @@ export async function registerTools(server, deps) {
         if (!decisionContract.passed) {
             advisories.decision_contract_advisory = decisionContract.advisory;
         }
+        // 设置 plan_proposal_gate — sf_expand 成功后必须设置，否则 sf_verify 等写工具会被阻断
+        {
+            const { evaluatePlanProposalGate, inferPlanGateTaskType } = await import("../../engine/plan_proposal_gate.js");
+            const routeForGate = expansion.workflow_trace?.route ?? expansionRoute ?? "code_change";
+            const taskTypeForGate = inferPlanGateTaskType(ctx.intent);
+            // 轻量路径（acceptance/review/read_only）自动通过
+            const isLightweight = routeForGate === "acceptance" || routeForGate === "review"
+                || routeForGate === "direct_answer" || routeForGate === "analysis";
+            if (isLightweight) {
+                await taskContext.setPlanProposalGate(args.task_id, {
+                    passed: true,
+                    plan_gate_status: "passed",
+                    required_level: "brief_plan",
+                    reason_zh: "轻量路径自动通过",
+                    violations: [],
+                    evidence_refs: [],
+                    blocked_actions: [],
+                });
+            }
+            else {
+                const gateResult = evaluatePlanProposalGate({
+                    task_id: args.task_id,
+                    task_type: taskTypeForGate,
+                    user_intent: ctx.intent,
+                    plan_level: "execution_plan",
+                    plan_summary_zh: ctx.intent.slice(0, 200),
+                    proposed_steps: [expansionRoute ?? "execute"],
+                    verification_plan: (expansion.acceptance?.automated ?? []).map((a) => a.description ?? String(a)),
+                    risks: [],
+                    evidence_refs: expansion.matched_knowledge ?? [],
+                });
+                await taskContext.setPlanProposalGate(args.task_id, gateResult);
+            }
+        }
         // 存储膨胀结果
         try {
             await taskContext.setExpansion(args.task_id, expansion);
@@ -3160,6 +3081,22 @@ export async function registerTools(server, deps) {
                     result: { task_id: args.task_id, cancelled },
                 };
             }
+            case "retry_expand": {
+                if (!args.task_id) {
+                    return {
+                        result: { error: "重试 expand 需要 task_id" },
+                    };
+                }
+                const retried = await taskContext.retryExpand(args.task_id);
+                if (!retried) {
+                    return {
+                        result: { error: "任务不存在、非 failed 状态或缺少 classification，无法重试 expand", task_id: args.task_id },
+                    };
+                }
+                return {
+                    result: { task_id: args.task_id, retried: true, hint: "任务已恢复到 expanding 状态，可重新调用 sf_expand" },
+                };
+            }
             case "archive_stale": {
                 const stale = await detectStaleCurrentTask(taskContext.getStateDir());
                 const taskId = args.task_id ?? stale.task_id;