soloforge 1.2.1 → 1.2.2

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/server.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAqBD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DjE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDjE"}

package/dist/adapters/claude_code/server.js

@@ -1,27 +1,6 @@
-import fs from "node:fs";
-import path from "node:path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { registerTools } from "./tools.js";
-/**
- * 检查当前项目是否为 SoloForge 自身项目（内部方法）。
- * @description 通过检查 package.json 中的 name 字段判断是否为 SoloForge 自身。
- *              SoloForge 自身项目会额外注册知识维护工具（sf_knowledge_audit/add/update）。
- * @param config - 项目配置对象
- * @returns 是否为 SoloForge 自身项目
- */
-function isSoloForgeProject(config) {
-    const projectPath = config._projectPath || process.cwd();
-    try {
-        const pkgPath = path.join(projectPath, "package.json");
-        const raw = fs.readFileSync(pkgPath, "utf-8");
-        const pkg = JSON.parse(raw);
-        return pkg.name === "soloforge";
-    }
-    catch {
-        return false;
-    }
-}
 /**
  * 启动 SoloForge MCP 服务器。
  * @description 创建 McpServer 实例，注册工具，通过 stdio 传输连接 Claude Code，
@@ -32,11 +11,9 @@ export async function startServer(deps) {
     const { config, knowledgeIndex, taskContext } = deps;
     const server = new McpServer({
         name: "soloforge",
-        version: "0.1.0",
-    });
-    registerTools(server, { config, knowledgeIndex, taskContext }, {
-        isSelfProject: isSoloForgeProject(config),
+        version: "1.2.1",
     });
+    registerTools(server, { config, knowledgeIndex, taskContext });
     const transport = new StdioServerTransport();
     await server.connect(transport);
     let shuttingDown = false;

package/dist/adapters/claude_code/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/adapters/claude_code/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsB3C;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,MAAqB;IAC/C,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAgB;IAChD,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAErD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE;QAC7D,aAAa,EAAE,kBAAkB,CAAC,MAAM,CAAC;KAC1C,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5C,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAChD,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/adapters/claude_code/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsB3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAgB;IAChD,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAErD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IAE/D,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5C,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAChD,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -2,17 +2,18 @@ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { ProjectConfig } from "../../types.js";
 import type { KnowledgeIndexManager } from "../../knowledge/index_manager.js";
 import type { TaskContextManager } from "../../engine/task_context.js";
+import { LLMGateway } from "../../engine/llm_gateway.js";
 /**
  * MCP 工具注册模块。
  * @description 将 SoloForge 的全部功能封装为 MCP 工具，注册到 McpServer 实例。
  *              每个工具通过统一的错误处理包装器（registerSafeTool）注册，确保异常不会导致服务崩溃。
  *              工具分为三类：核心流程工具（classify/expand/verify/learn/status）、
- *              辅助工具（plan/review/scaffold/deliver 等）、自维护工具（knowledge_audit/add/update）。
- *              自维护工具仅在 SoloForge 自身项目中注册。
+ *              辅助工具（plan/review/scaffold/deliver 等）、知识维护工具（knowledge_audit/add/update/resume_workspace）。
+ *              所有工具在所有项目中均注册。
  */
 /**
  * SoloForge 核心依赖项。
- * @description 封装所有 MCP 工具共享的依赖：项目配置、知识索引和任务上下文。
+ * @description 封装所有 MCP 工具共享的依赖：项目配置、知识索引、任务上下文和可选的 LLM 网关。
  */
 export interface SoloForgeDeps {
     /** 项目配置对象 */
@@ -21,13 +22,8 @@ export interface SoloForgeDeps {
     knowledgeIndex: KnowledgeIndexManager;
     /** 任务上下文管理器 */
     taskContext: TaskContextManager;
-}
-/**
- * 工具注册选项。
- */
-export interface RegisterToolsOptions {
-    /** 是否为 SoloForge 自身项目（true 时注册自维护工具） */
-    isSelfProject?: boolean;
+    /** 可选的 LLM 网关（测试时注入 depleted gateway 以验证 H1 advisory） */
+    gateway?: LLMGateway;
 }
 /**
  * 注册所有 SoloForge MCP 工具。
@@ -37,10 +33,9 @@ export interface RegisterToolsOptions {
  *              sf_deliver、sf_coord_check、sf_team_status、sf_contract_check、
  *              sf_onboard、sf_feasibility_check、sf_debug、sf_observability、
  *              sf_migration_check、sf_test_guide、sf_test_quality、sf_dependency_scan、
- *              sf_debt_report，以及条件注册的 sf_knowledge_audit/add/update。
+ *              sf_debt_report、sf_explore、sf_knowledge_audit/add/update、sf_resume_workspace。
  * @param server - MCP 服务器实例
  * @param deps - SoloForge 核心依赖项
- * @param options - 注册选项（控制自维护工具是否注册）
  */
-export declare function registerTools(server: McpServer, deps: SoloForgeDeps, options?: RegisterToolsOptions): void;
+export declare function registerTools(server: McpServer, deps: SoloForgeDeps): void;
 //# sourceMappingURL=tools.d.ts.map

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":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AA8BvE;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc;IACd,cAAc,EAAE,qBAAqB,CAAC;IACtC,eAAe;IACf,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAuHD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CA+5B1G"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AA2BvE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAIzD;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc;IACd,cAAc,EAAE,qBAAqB,CAAC;IACtC,eAAe;IACf,WAAW,EAAE,kBAAkB,CAAC;IAChC,yDAAyD;IACzD,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAwHD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAygC1E"}

package/dist/adapters/claude_code/tools.js

@@ -25,6 +25,9 @@ import { scanDependencies } from "../../engine/dependency_scanner.js";
 import { generateDebtReport } from "../../engine/debt_reporter.js";
 import { exploreSolutions } from "../../engine/exploration.js";
 import { scanAndResume } from "../../engine/workspace_resumer.js";
+import { LLMGateway } from "../../engine/llm_gateway.js";
+import { IOController } from "../../engine/io_controller.js";
+import { getSummary as getCapabilitySummary } from "../../engine/capability_registry.js";
 // ── Zod Schema 定义 ──
 const ClassifySchema = {
     intent: z.string().describe("开发者意图描述"),
@@ -126,14 +129,17 @@ const ExploreSchema = {
  *              sf_deliver、sf_coord_check、sf_team_status、sf_contract_check、
  *              sf_onboard、sf_feasibility_check、sf_debug、sf_observability、
  *              sf_migration_check、sf_test_guide、sf_test_quality、sf_dependency_scan、
- *              sf_debt_report，以及条件注册的 sf_knowledge_audit/add/update。
+ *              sf_debt_report、sf_explore、sf_knowledge_audit/add/update、sf_resume_workspace。
  * @param server - MCP 服务器实例
  * @param deps - SoloForge 核心依赖项
- * @param options - 注册选项（控制自维护工具是否注册）
  */
-export function registerTools(server, deps, options) {
+export function registerTools(server, deps) {
     const { config, knowledgeIndex, taskContext } = deps;
     const projectPath = config._projectPath || process.cwd();
+    // H1: LLM Gateway — Token 预算熔断，防止单任务 Token 超支
+    const gateway = deps.gateway ?? new LLMGateway();
+    // H4: IO Controller — 工作区互斥锁，防止外部修改导致的静默覆盖
+    const ioController = new IOController(projectPath);
     // 统一错误处理包装器，捕获工具执行中的异常并返回结构化错误响应
     function registerSafeTool(name, desc, schema, handler) {
         server.tool(name, desc, schema, async (args) => {
@@ -173,8 +179,9 @@ export function registerTools(server, deps, options) {
         const classification = classify(input);
         // 存储分类结果
         await taskContext.setClassification(ctx.task_id, classification);
-        // 转换到膨胀阶段
-        await taskContext.updateStatus(ctx.task_id, "expanding");
+        if (classification.strategy === "skip_soloForge") {
+            await taskContext.updateStatus(ctx.task_id, "done");
+        }
         return {
             content: [{
                     type: "text",
@@ -194,6 +201,16 @@ export function registerTools(server, deps, options) {
                 isError: true,
             };
         }
+        // 状态守卫：classifying → expanding 或允许 expanding 恢复（中断重试）
+        if (ctx.status === "classifying") {
+            await taskContext.updateStatus(args.task_id, "expanding");
+        }
+        else if (ctx.status !== "expanding") {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: `任务状态 ${ctx.status} 不可膨胀，需要 classifying 或 expanding`, status: ctx.status }) }],
+                isError: true,
+            };
+        }
         // 构建计划上下文（如果存在计划）
         let planContext;
         if (ctx.planning && ctx.planning.sub_tasks.length > 0 && ctx.planning.current_step_index < ctx.planning.sub_tasks.length) {
@@ -215,24 +232,88 @@ export function registerTools(server, deps, options) {
             }
             planContext = { current_step: currentStep, previous_outputs: previousOutputs };
         }
-        const expansion = await expand({
-            intent: ctx.intent,
-            classification: ctx.classification,
-            projectPath,
-            config,
-            knowledgeIndex,
-            clarificationAnswers: args.clarification_answers,
-            plan_context: planContext,
-        });
+        // H1: Token 预算检查 — advisory 模式，仅警告不阻断
+        gateway.beginTask(args.task_id);
+        let h1Warning;
+        try {
+            const gateResult = gateway.request("solution_brainstorm");
+            if (!gateResult.allowed) {
+                h1Warning = { warning: `H1 advisory: ${gateResult.reason}`, budget_remaining: gateResult.remaining_budget };
+            }
+        }
+        catch (e) {
+            h1Warning = { warning: `H1 advisory: ${e.message}`, budget_remaining: 0 };
+        }
+        // H4: advisory-only — 不获取持久锁，仅检查当前锁定状态
+        let h4LockWarning;
+        const lockStatus = await ioController.isLocked();
+        if (lockStatus.locked && lockStatus.task_id !== args.task_id) {
+            h4LockWarning = `H4 advisory: 工作区已被任务 ${lockStatus.task_id} 锁定（${lockStatus.reason ?? "未知"}），当前 H4 未进入强制层`;
+        }
+        let expansion;
+        try {
+            expansion = await expand({
+                intent: ctx.intent,
+                classification: ctx.classification,
+                projectPath,
+                config,
+                knowledgeIndex,
+                clarificationAnswers: args.clarification_answers,
+                plan_context: planContext,
+            });
+        }
+        catch (expandErr) {
+            // 尝试回退到 failed 状态，避免任务停留在 expanding
+            try {
+                await taskContext.updateStatus(args.task_id, "failed");
+            }
+            catch {
+                // 状态转换非法（如已非 expanding），忽略
+            }
+            throw expandErr;
+        }
+        finally {
+            if (!h1Warning)
+                gateway.completeOperation();
+            gateway.endTask();
+        }
         expansion.task_id = args.task_id;
+        // 注入 H1/H4 advisory warnings
+        const advisories = {};
+        if (h1Warning)
+            advisories.h1_advisory = h1Warning;
+        if (h4LockWarning)
+            advisories.h4_advisory = h4LockWarning;
         // 存储膨胀结果
-        await taskContext.setExpansion(args.task_id, expansion);
+        try {
+            await taskContext.setExpansion(args.task_id, expansion);
+        }
+        catch (setErr) {
+            try {
+                await taskContext.updateStatus(args.task_id, "failed");
+            }
+            catch {
+                // 状态转换非法，忽略
+            }
+            throw setErr;
+        }
         // 转换到执行阶段
-        await taskContext.updateStatus(args.task_id, "executing");
+        try {
+            await taskContext.updateStatus(args.task_id, "executing");
+        }
+        catch (updateErr) {
+            try {
+                await taskContext.updateStatus(args.task_id, "failed");
+            }
+            catch {
+                // 状态转换非法，忽略
+            }
+            throw updateErr;
+        }
         return {
             content: [{
                     type: "text",
-                    text: JSON.stringify(expansion, null, 2),
+                    text: JSON.stringify(Object.keys(advisories).length > 0 ? { ...expansion, advisories } : expansion, null, 2),
                 }],
         };
     });
@@ -245,9 +326,21 @@ export function registerTools(server, deps, options) {
                 isError: true,
             };
         }
+        const VALID_VERIFY_STATES = ["executing", "retrying"];
+        if (!VALID_VERIFY_STATES.includes(ctx.status)) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: `任务状态 ${ctx.status} 不可验证，需要 executing 或 retrying`, status: ctx.status }) }],
+                isError: true,
+            };
+        }
         const acceptanceItems = ctx.expansion
             ? [...ctx.expansion.acceptance.automated, ...ctx.expansion.acceptance.manual]
             : [];
+        // H4: 工作区完整性检查 — advisory 模式，仅警告不阻断
+        const integrity = await ioController.verify();
+        const h4Warning = !integrity.clean
+            ? { warning: `H4 advisory: ${integrity.message}`, dirty_files: integrity.dirty_files }
+            : undefined;
         const verifyResult = generateVerifyCommands(config, args.changed_files, acceptanceItems);
         verifyResult.task_id = args.task_id;
         // 记录变更文件
@@ -259,7 +352,7 @@ export function registerTools(server, deps, options) {
         return {
             content: [{
                     type: "text",
-                    text: JSON.stringify(verifyResult, null, 2),
+                    text: JSON.stringify(h4Warning ? { ...verifyResult, h4_advisory: h4Warning } : verifyResult, null, 2),
                 }],
         };
     });
@@ -272,6 +365,13 @@ export function registerTools(server, deps, options) {
                 isError: true,
             };
         }
+        const VALID_LEARN_STATES = ["verifying", "executing"];
+        if (!VALID_LEARN_STATES.includes(ctx.status)) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: `任务状态 ${ctx.status} 不可学习，需要 verifying 或 executing`, status: ctx.status }) }],
+                isError: true,
+            };
+        }
         // 如适用，记录失败
         if (args.result === "failure" && args.failure_type) {
             await taskContext.setExecution(args.task_id, [], {
@@ -574,6 +674,11 @@ export function registerTools(server, deps, options) {
                 isError: true,
             };
         }
+        // H4: 交付前工作区完整性检查 — advisory 模式，仅警告不阻断
+        const deliverIntegrity = await ioController.verify();
+        const h4DeliverWarning = !deliverIntegrity.clean
+            ? { warning: `H4 advisory: ${deliverIntegrity.message}`, dirty_files: deliverIntegrity.dirty_files }
+            : undefined;
         const result = await deliver({
             taskContext: ctx,
             config,
@@ -585,7 +690,10 @@ export function registerTools(server, deps, options) {
         });
         await taskContext.setDelivery(args.task_id, result);
         return {
-            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(h4DeliverWarning ? { ...result, h4_advisory: h4DeliverWarning } : result, null, 2),
+                }],
         };
     });
     // ── sf_coord_check: 预测性冲突检测和跨仓库协调 ──
@@ -670,11 +778,13 @@ export function registerTools(server, deps, options) {
         };
     });
     // ── sf_observability: 系统可观测和运行报告 ──
-    registerSafeTool("sf_observability", "系统可观测：运行指标、成本估算、告警检测、周期报告", ObservabilitySchema, async (args) => {
+    registerSafeTool("sf_observability", "系统可观测：运行指标、成本估算、告警检测、能力状态、周期报告", ObservabilitySchema, async (args) => {
         const stateDir = taskContext.getStateDir();
         const result = await generateReport(stateDir, args.period_days);
+        const capability = getCapabilitySummary();
+        const output = { ...result, capability };
         return {
-            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
         };
     });
     // ── sf_migration_check: 数据库迁移安全性分析 ──
@@ -730,72 +840,69 @@ export function registerTools(server, deps, options) {
             content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
     });
-    // ── 自维护工具（仅在 SoloForge 自身项目中注册） ──
-    if (options?.isSelfProject) {
-        // ── sf_knowledge_audit: 知识库健康审计 ──
-        registerSafeTool("sf_knowledge_audit", "审计知识库：识别过时条目、重复触发词、格式缺失、覆盖缺口。定期执行或手动触发", {}, async () => {
-            const result = await auditKnowledge(knowledgeIndex, config);
-            return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-            };
-        });
-        // ── sf_knowledge_add: 新增知识条目（默认保存为草稿） ──
-        const KnowledgeAddSchema = {
-            title: z.string().describe("知识条目标题（英文 kebab-case，如 payment-rules）"),
-            type: z.enum(["pattern", "procedure", "pipeline_procedure", "domain", "acceptance_template", "review_rule"]).describe("知识类型"),
-            scope: z.array(z.string()).describe("适用范围（如 [backend]、[frontend]、[backend, frontend]）"),
-            when_triggers: z.string().describe("触发关键词（逗号分隔）"),
-            decision_rules: z.string().optional().describe("决策规则（每行一条）"),
-            save_to_drafts: z.boolean().optional().describe("是否保存为草稿（默认 true，需人工 review 后移入正式目录）"),
-            auto_enrich: z.boolean().optional().describe("是否返回行业最佳实践探索指引（默认 true，宿主 AI 将自动执行探索并填充内容）"),
+    // ── sf_knowledge_audit: 知识库健康审计 ──
+    registerSafeTool("sf_knowledge_audit", "审计知识库：识别过时条目、重复触发词、格式缺失、覆盖缺口。定期执行或手动触发", {}, async () => {
+        const result = await auditKnowledge(knowledgeIndex, config);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
-        registerSafeTool("sf_knowledge_add", "新增知识条目。默认保存为草稿到 .soloforge/knowledge/drafts/，人工确认后移入正式目录", KnowledgeAddSchema, async (args) => {
-            const result = await addKnowledge({
-                title: args.title,
-                type: args.type,
-                scope: args.scope,
+    });
+    // ── sf_knowledge_add: 新增知识条目（默认保存为草稿） ──
+    const KnowledgeAddSchema = {
+        title: z.string().describe("知识条目标题（英文 kebab-case，如 payment-rules）"),
+        type: z.enum(["pattern", "procedure", "pipeline_procedure", "domain", "acceptance_template", "review_rule"]).describe("知识类型"),
+        scope: z.array(z.string()).describe("适用范围（如 [backend]、[frontend]、[backend, frontend]）"),
+        when_triggers: z.string().describe("触发关键词（逗号分隔）"),
+        decision_rules: z.string().optional().describe("决策规则（每行一条）"),
+        save_to_drafts: z.boolean().optional().describe("是否保存为草稿（默认 true，需人工 review 后移入正式目录）"),
+        auto_enrich: z.boolean().optional().describe("是否返回行业最佳实践探索指引（默认 true，宿主 AI 将自动执行探索并填充内容）"),
+    };
+    registerSafeTool("sf_knowledge_add", "新增知识条目。默认保存为草稿到 .soloforge/knowledge/drafts/，人工确认后移入正式目录", KnowledgeAddSchema, async (args) => {
+        const result = await addKnowledge({
+            title: args.title,
+            type: args.type,
+            scope: args.scope,
+            when_triggers: args.when_triggers,
+            decision_rules: args.decision_rules,
+            save_to_drafts: args.save_to_drafts,
+            auto_enrich: args.auto_enrich,
+        }, config);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    // ── sf_knowledge_update: 更新已有知识条目（自动创建备份） ──
+    const KnowledgeUpdateSchema = {
+        entry_name: z.string().describe("要更新的知识条目名称（如 payment-rules）"),
+        when_triggers: z.string().optional().describe("新的触发关键词（替换现有）"),
+        add_decision_rules: z.array(z.string()).optional().describe("追加的决策规则"),
+        add_acceptance_criteria: z.array(z.string()).optional().describe("追加的验收项"),
+        status: z.enum(["active", "deprecated"]).optional().describe("更新条目状态"),
+    };
+    registerSafeTool("sf_knowledge_update", "更新已有知识条目：追加规则、更新触发词、标记废弃。自动创建备份", KnowledgeUpdateSchema, async (args) => {
+        const result = await updateKnowledge({
+            entry_name: args.entry_name,
+            updates: {
                 when_triggers: args.when_triggers,
-                decision_rules: args.decision_rules,
-                save_to_drafts: args.save_to_drafts,
-                auto_enrich: args.auto_enrich,
-            }, config);
-            return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-            };
-        });
-        // ── sf_knowledge_update: 更新已有知识条目（自动创建备份） ──
-        const KnowledgeUpdateSchema = {
-            entry_name: z.string().describe("要更新的知识条目名称（如 payment-rules）"),
-            when_triggers: z.string().optional().describe("新的触发关键词（替换现有）"),
-            add_decision_rules: z.array(z.string()).optional().describe("追加的决策规则"),
-            add_acceptance_criteria: z.array(z.string()).optional().describe("追加的验收项"),
-            status: z.enum(["active", "deprecated"]).optional().describe("更新条目状态"),
+                add_decision_rules: args.add_decision_rules,
+                add_acceptance_criteria: args.add_acceptance_criteria,
+                status: args.status,
+            },
+        }, knowledgeIndex, config);
+        // 重载知识索引
+        if (result.success) {
+            await knowledgeIndex.reload();
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
-        registerSafeTool("sf_knowledge_update", "更新已有知识条目：追加规则、更新触发词、标记废弃。自动创建备份", KnowledgeUpdateSchema, async (args) => {
-            const result = await updateKnowledge({
-                entry_name: args.entry_name,
-                updates: {
-                    when_triggers: args.when_triggers,
-                    add_decision_rules: args.add_decision_rules,
-                    add_acceptance_criteria: args.add_acceptance_criteria,
-                    status: args.status,
-                },
-            }, knowledgeIndex, config);
-            // 重载知识索引
-            if (result.success) {
-                await knowledgeIndex.reload();
-            }
-            return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-            };
-        });
-        // ── sf_resume_workspace: 工作区状态唤醒（解决前端刷新导致UUID丢失） ──
-        registerSafeTool("sf_resume_workspace", "扫描 .soloforge/state/ 目录，恢复中断工单并播报当前进度。新会话启动时必须优先调用", {}, async () => {
-            const result = await scanAndResume(taskContext);
-            return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-            };
-        });
-    } // end isSelfProject guard
+    });
+    // ── sf_resume_workspace: 工作区状态唤醒（解决前端刷新导致UUID丢失） ──
+    registerSafeTool("sf_resume_workspace", "扫描 .soloforge/state/ 目录，恢复中断工单并播报当前进度。新会话启动时必须优先调用", {}, async () => {
+        const result = await scanAndResume(taskContext);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
 }
 //# sourceMappingURL=tools.js.map