add-coder 0.3.25-0 → 0.3.25

package/README.en.md

@@ -90,11 +90,11 @@ Each IDE（Claude Code / Qoder CN / VS Code Copilot / Trae / Codex）has its own
 
 | IDE | Governance Doc | Events Covered | Hook Config |
 |---|---|---|---|
-| Claude Code | [ADD-governance-claude-code.md](./ADD-governance-claude-code.md) | 14/17 | `.claude/hooks/*.sh` |
-| Qoder CN | [ADD-governance-qoder-cn.md](./ADD-governance-qoder-cn.md) | 10/17 | `.qoder/hooks/*.sh` |
-| VS Code Copilot | [ADD-governance-vscode-copilot.md](./ADD-governance-vscode-copilot.md) | 10/17 | `.github/hooks/*.json` → `.vscode/hooks/*.sh` |
-| Trae | [ADD-governance-trae.md](./ADD-governance-trae.md) | 6/17 | `hooks.json` → `.trae/hooks/*.sh` |
-| Codex | [ADD-governance-codex.md](./ADD-governance-codex.md) | 0 native / 14 (via Claude import) | `.codex/hooks.json` |
+| Claude Code | [ADD-governance-claude-code.md](./templates/core/docs/ADD-governance-claude-code.md) | 14/17 | `.claude/hooks/*.sh` |
+| Qoder CN | [ADD-governance-qoder-cn.md](./templates/core/docs/ADD-governance-qoder-cn.md) | 10/17 | `.qoder/hooks/*.sh` |
+| VS Code Copilot | [ADD-governance-vscode-copilot.md](./templates/core/docs/ADD-governance-vscode-copilot.md) | 10/17 | `.github/hooks/*.json` → `.vscode/hooks/*.sh` |
+| Trae | [ADD-governance-trae.md](./templates/core/docs/ADD-governance-trae.md) | 6/17 | `hooks.json` → `.trae/hooks/*.sh` |
+| Codex | [ADD-governance-codex.md](./templates/core/docs/ADD-governance-codex.md) | 0 native / 14 (via Claude import) | `.codex/hooks.json` |
 
 ---
 
@@ -290,11 +290,11 @@ RAHS (Runtime Architecture Health Score) — 运行时架构健康度，< 90% BL
 ### ⑤ 多 IDE 的 Hook 即治理层
 | IDE | 治理文档 | 覆盖事件 | Hook 配置 |
 |---|---|---|---|
-| Claude Code | [ADD-governance-claude-code.md](./ADD-governance-claude-code.md) | 14/17 | `.claude/hooks/*.sh` |
-| Qoder CN | [ADD-governance-qoder-cn.md](./ADD-governance-qoder-cn.md) | 10/17 | `.qoder/hooks/*.sh` |
-| VS Code Copilot | [ADD-governance-vscode-copilot.md](./ADD-governance-vscode-copilot.md) | 10/17 | `.github/hooks/*.json` → `.vscode/hooks/*.sh` |
-| Trae | [ADD-governance-trae.md](./ADD-governance-trae.md) | 6/17 | `hooks.json` → `.trae/hooks/*.sh` |
-| Codex | [ADD-governance-codex.md](./ADD-governance-codex.md) | 0 (原生) / 14 (导入 Claude) | `.codex/hooks.json` |
+| Claude Code | [ADD-governance-claude-code.md](./templates/core/docs/ADD-governance-claude-code.md) | 14/17 | `.claude/hooks/*.sh` |
+| Qoder CN | [ADD-governance-qoder-cn.md](./templates/core/docs/ADD-governance-qoder-cn.md) | 10/17 | `.qoder/hooks/*.sh` |
+| VS Code Copilot | [ADD-governance-vscode-copilot.md](./templates/core/docs/ADD-governance-vscode-copilot.md) | 10/17 | `.github/hooks/*.json` → `.vscode/hooks/*.sh` |
+| Trae | [ADD-governance-trae.md](./templates/core/docs/ADD-governance-trae.md) | 6/17 | `hooks.json` → `.trae/hooks/*.sh` |
+| Codex | [ADD-governance-codex.md](./templates/core/docs/ADD-governance-codex.md) | 0 (原生) / 14 (导入 Claude) | `.codex/hooks.json` |
 
 ## 快速开始
 ```bash

package/README.md

@@ -193,11 +193,11 @@ hook 不是「通知推送」，而是 **ADD 范式在 IDE agent 生命周期中
 
 | IDE | 治理文档 | 覆盖事件 | Hook 配置 |
 |---|---|---|---|
-| Claude Code | [ADD-governance-claude-code.md](./ADD-governance-claude-code.md) | 14/17 | `.claude/hooks/*.sh` |
-| Qoder CN | [ADD-governance-qoder-cn.md](./ADD-governance-qoder-cn.md) | 10/17 | `.qoder/hooks/*.sh` |
-| VS Code Copilot | [ADD-governance-vscode-copilot.md](./ADD-governance-vscode-copilot.md) | 10/17 | `.github/hooks/*.json` → `.vscode/hooks/*.sh` |
-| Trae | [ADD-governance-trae.md](./ADD-governance-trae.md) | 6/17 | `hooks.json` → `.trae/hooks/*.sh` |
-| Codex | [ADD-governance-codex.md](./ADD-governance-codex.md) | 0 (原生) / 14 (导入 Claude) | `.codex/hooks.json` |
+| Claude Code | [ADD-governance-claude-code.md](./templates/core/docs/ADD-governance-claude-code.md) | 14/17 | `.claude/hooks/*.sh` |
+| Qoder CN | [ADD-governance-qoder-cn.md](./templates/core/docs/ADD-governance-qoder-cn.md) | 10/17 | `.qoder/hooks/*.sh` |
+| VS Code Copilot | [ADD-governance-vscode-copilot.md](./templates/core/docs/ADD-governance-vscode-copilot.md) | 10/17 | `.github/hooks/*.json` → `.vscode/hooks/*.sh` |
+| Trae | [ADD-governance-trae.md](./templates/core/docs/ADD-governance-trae.md) | 6/17 | `hooks.json` → `.trae/hooks/*.sh` |
+| Codex | [ADD-governance-codex.md](./templates/core/docs/ADD-governance-codex.md) | 0 (原生) / 14 (导入 Claude) | `.codex/hooks.json` |
 
 > 实施 Plan: [add-coder-hook-full-alignment-plan-v1](./.qoder/plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md) | 触发源: [GitHub Issue #6](https://github.com/xiaomingming92/add-coder/issues/6)
 
@@ -220,47 +220,21 @@ Plan 里的 Task 不应该停留在文档里。add-coder 将 tasks.md 末尾的
 tasks.md §IDE JSON → TodoWrite → IDE 面板
 ```
 
-### ⑩ 并发契约体系：协作层 + 进程层双层
+### ⑩ 并发协作契约：多智能体协作即契约
 
-多个 Agent 同时改一个仓库，没有契约必然冲突——改同一批文件、审计归因混乱。add-coder 把并行协作变成**经 HITL 审批的契约体系**，分两层：
+多个 Agent 同时改一个仓库，没有契约必然冲突——改同一批文件、审计归因混乱。add-coder 把并行协作变成一份**经 HITL 审批的契约**：
 
-| 层 | 契约 | 版本 | 职责 |
-|----|------|------|------|
-| **协作层** | 并发协作契约（collab-contract） | v1（v0.3.18） | 多智能体协作秩序：总控 Plan + N 个子 Plan / 文件边界 / 仲裁链路 / 审计分桶 |
-| **进程层** | [多 IDE 进程并发契约](./docs/multi-ide-concurrency-contract.md) | v2（v0.3.25） | MCP Server 并发行为承诺：连接模型 / 幂等键 / PROJECT_ID 校验 / 断开隔离四态 / 生命周期拆分 / client 编排差异矩阵 |
+| 机制 | 实现 |
+|------|------|
+| **总控 Plan + N 个子 Plan** | Lead Agent 调度，专家按 description 触发条件委派，满足即拉起 |
+| **文件边界** | 默认软隔离（git diff 交叉检查），大改升级 git worktree 硬隔离 |
+| **仲裁链路** | 跨边界修改走 BOUNDARY_REQUEST → Lead 裁决 → 落库可查 |
+| **审计分桶** | 每个专家独立 planKeyword，query_audit_logs 各域各查 |
 
-> 协作层模板：`templates/core/templates/collab-contract-template.md`（契约新建/重大变更走 `COLLAB_CONTRACT` 审批）。
-> 进程层文档：`docs/multi-ide-concurrency-contract.md`（Codex Parallel MCP / TAgent / Claude Code 并发行为对齐基准）。
+> 契约模板：`templates/core/templates/collab-contract-template.md`（init 后同步到项目 `.add/templates/`），契约新建/重大变更走 `COLLAB_CONTRACT` 审批。
 >
 > 📜 溯源：并发契约原创时间戳 → [CHANGELOG v0.3.18「并发协作契约」](https://github.com/xiaomingming92/add-coder/blob/main/CHANGELOG.md#0318---2026-08-05)；"酷"的工程学定义 → [what-makes-software-cool.md](https://github.com/xiaomingming92/add-coder/blob/main/docs/what-makes-software-cool.md)——契约的审计分桶与完成判定（DPS ≥ 80）正长在"熵值管控"四维上。
 
-### ⑪ Codex MCP 原生接入（v0.3.25）
-
-> **状态区分**："已生成 Codex 模板" ≠ "Codex MCP 端到端已验证"——以下 6 步是**已验证闭环**，不写自定义脚本即可完成接入。
-
-```bash
-# 1. 安装 add-coder（已安装可跳过）
-npm i -g add-coder
-
-# 2. 初始化 Codex 适配（hooks 模板 + config.toml 真源）
-add-coder init --adapter=codex
-
-# 3. 输出可直接使用的 config.toml 片段（不写盘，不初始化项目）
-add-coder init --adapter=codex --print-mcp-config
-
-# 4a. 粘贴片段到 ~/.codex/config.toml（Windows: %USERPROFILE%\.codex\config.toml）
-# 4b. 或自动写入（显式确认 + 先备份 + 防重复）
-add-coder init --adapter=codex --write-user-config
-
-# 5. 重启 Codex（App/CLI/IDE 扩展通用，修改 config.toml 后需重启生效）
-
-# 6. 验证：Codex 中发现 add_coder MCP Server，完整工具集可调用（29 tools）
-```
-
-**Windows 分支**：`--print-mcp-config` 在 win32 平台自动输出 `cmd /c npx.cmd` 启动分支（原生 PowerShell 场景，不依赖 WSL）。
-
-**命名兼容**：MCP Server ID 归一化为 `add_coder`（连字符→下划线，Codex 约束）；`env.PROJECT_ROOT` 由渲染时注入，多项目粘贴错误配置时 mcp-server 启动即校验退出（进程层契约 §4）。
-
 ---
 
 ## 📖 案例示范：老安卓设备续命工程
@@ -377,7 +351,7 @@ npx add-coder init
 | `.qoder/` | Qoder 适配（hooks、settings.json、mcp.json） |
 | `.vscode/` | VS Code 适配（settings.json、tasks.json） |
 | `.trae/` | Trae 适配（hooks.json、settings.json） |
-| `.codex/` | Codex 适配（hooks.json、settings.json、config.toml.example） |
+| `.codex/` | Codex 适配（hooks.json、settings.json） |
 
 ## MCP 审计工具链
 
@@ -604,11 +578,11 @@ Each IDE（Claude Code / Qoder CN / VS Code Copilot / Trae / Codex）has its own
 
 | IDE | Governance Doc | Events Covered | Hook Config |
 |---|---|---|---|
-| Claude Code | [ADD-governance-claude-code.md](./ADD-governance-claude-code.md) | 14/17 | `.claude/hooks/*.sh` |
-| Qoder CN | [ADD-governance-qoder-cn.md](./ADD-governance-qoder-cn.md) | 10/17 | `.qoder/hooks/*.sh` |
-| VS Code Copilot | [ADD-governance-vscode-copilot.md](./ADD-governance-vscode-copilot.md) | 10/17 | `.github/hooks/*.json` → `.vscode/hooks/*.sh` |
-| Trae | [ADD-governance-trae.md](./ADD-governance-trae.md) | 6/17 | `hooks.json` → `.trae/hooks/*.sh` |
-| Codex | [ADD-governance-codex.md](./ADD-governance-codex.md) | 0 native / 14 (via Claude import) | `.codex/hooks.json` |
+| Claude Code | [ADD-governance-claude-code.md](./templates/core/docs/ADD-governance-claude-code.md) | 14/17 | `.claude/hooks/*.sh` |
+| Qoder CN | [ADD-governance-qoder-cn.md](./templates/core/docs/ADD-governance-qoder-cn.md) | 10/17 | `.qoder/hooks/*.sh` |
+| VS Code Copilot | [ADD-governance-vscode-copilot.md](./templates/core/docs/ADD-governance-vscode-copilot.md) | 10/17 | `.github/hooks/*.json` → `.vscode/hooks/*.sh` |
+| Trae | [ADD-governance-trae.md](./templates/core/docs/ADD-governance-trae.md) | 6/17 | `hooks.json` → `.trae/hooks/*.sh` |
+| Codex | [ADD-governance-codex.md](./templates/core/docs/ADD-governance-codex.md) | 0 native / 14 (via Claude import) | `.codex/hooks.json` |
 
 ### ⑧ HITL Human-in-the-Loop: Approval as Infrastructure
 

package/dist/index.js

@@ -547,9 +547,6 @@ function renderCore(config, dryRun) {
         const rendered = render(content, config);
         const targetRel = join4(CORE_TARGET, relative(CORE_DIR, full));
         files.set(targetRel, rendered);
-        if (relative(CORE_DIR, full).startsWith("docs/")) {
-          files.set(name, rendered);
-        }
       }
     }
   }
@@ -623,18 +620,8 @@ function renderAdapter4(config, targetDir, dryRun, magicDir) {
 }
 
 // src/adapters/codex/renderer.ts
-function codexCommandFor(platform) {
-  return platform === "win32" ? "cmd /c npx.cmd" : "npx";
-}
 function renderAdapter5(config, targetDir, dryRun, magicDir) {
-  const files = renderAdapterBase(config, magicDir, magicDir === ".vscode", dryRun);
-  const codexCommand = codexCommandFor(process.platform);
-  for (const [rel, content] of files) {
-    if (rel.endsWith("config.toml.example") || rel.endsWith("config.toml")) {
-      files.set(rel, content.replaceAll("{{codexCommand}}", codexCommand));
-    }
-  }
-  return files;
+  return renderAdapterBase(config, magicDir, magicDir === ".vscode", dryRun);
 }
 
 // src/lib/utils.ts
@@ -1376,8 +1363,7 @@ async function injectPrisma2(projectRoot, options = {}) {
 // src/cli/commands/init.ts
 import { readFileSync as readFileSync9, writeFileSync as writeFileSync6, existsSync as existsSync11, mkdirSync as mkdirSync6, copyFileSync as copyFileSync2, readdirSync as readdirSync4 } from "fs";
 import { createHash } from "crypto";
-import { resolve as resolve8, dirname as dirname5, join as pathJoin } from "path";
-import { homedir as homedir2 } from "os";
+import { resolve as resolve8 } from "path";
 import { createConnection as createConnection2 } from "net";
 
 // src/lib/model-predownload.ts
@@ -1466,10 +1452,6 @@ var ADAPTER_RENDERERS = {
 };
 var MAGIC_DIR_MAP = { claude: ".claude", qoder: ".qoder", vscode: ".vscode", trae: ".trae", codex: ".codex" };
 async function initCommand(options) {
-  if (options.printMcpConfig || options.writeUserConfig) {
-    await handleCodexMcpConfig(options);
-    return;
-  }
   const ctx = await prepare(options);
   writeComposeEnv(ctx);
   if (!options.dryRun) {
@@ -1492,51 +1474,6 @@ async function initCommand(options) {
     }
   }
 }
-async function handleCodexMcpConfig(options) {
-  const projectRoot = process.cwd();
-  const magicDir = MAGIC_DIR_MAP[options.adapter ?? "codex"] ?? ".codex";
-  const config = await loadConfig(projectRoot, options.config, { force: true });
-  config.projectRoot = projectRoot;
-  config.magicDir = magicDir;
-  const files = renderAdapter5(config, projectRoot, !!options.dryRun, magicDir);
-  const tomlEntry = [...files.entries()].find(
-    ([rel]) => rel.endsWith("config.toml.example") || rel.endsWith("config.toml")
-  );
-  if (!tomlEntry) {
-    console.error("\u2717 config.toml \u6E32\u67D3\u4EA7\u7269\u7F3A\u5931\uFF08\u68C0\u67E5 templates/adapters/codex/config.toml.example\uFF09");
-    process.exit(1);
-  }
-  const toml = tomlEntry[1];
-  if (options.printMcpConfig) {
-    console.log("\n# \u5C06\u4EE5\u4E0B\u7247\u6BB5\u7C98\u8D34\u5230 ~/.codex/config.toml\uFF08\u6216\u4F7F\u7528 --write-user-config \u81EA\u52A8\u5199\u5165\uFF09");
-    console.log(toml);
-  }
-  if (options.writeUserConfig) {
-    const userConfigPath = pathJoin(homedir2(), ".codex", "config.toml");
-    if (options.dryRun) {
-      console.log(`[dry-run] \u5C06\u5199\u5165 ${userConfigPath}`);
-      return;
-    }
-    if (existsSync11(userConfigPath) && readFileSync9(userConfigPath, "utf-8").includes("mcp_servers.add_coder")) {
-      console.log(`\u26A0\uFE0F ${userConfigPath} \u5DF2\u5B58\u5728 mcp_servers.add_coder \u914D\u7F6E\uFF0C\u8DF3\u8FC7\uFF08\u907F\u514D\u91CD\u590D\uFF09`);
-      return;
-    }
-    const answer = await ask(`\u5199\u5165 ${userConfigPath}\uFF1F\uFF08y/N\uFF09 \u2192 `);
-    if (answer.trim().toLowerCase() !== "y") {
-      console.log("\u5DF2\u53D6\u6D88\u5199\u5165");
-      return;
-    }
-    if (existsSync11(userConfigPath)) {
-      const backup = `${userConfigPath}.bak-${Date.now()}`;
-      copyFileSync2(userConfigPath, backup);
-      console.log(`\u5DF2\u5907\u4EFD\u539F\u914D\u7F6E \u2192 ${backup}`);
-    }
-    mkdirSync6(dirname5(userConfigPath), { recursive: true });
-    writeFileSync6(userConfigPath, `
-${toml}`, { flag: "a" });
-    console.log(`\u2705 \u5DF2\u5199\u5165 ${userConfigPath}\uFF0C\u91CD\u542F Codex \u751F\u6548`);
-  }
-}
 async function resolveAdapter(projectRoot, specified) {
   if (specified) {
     if (!MAGIC_DIR_MAP[specified]) throw new Error(`\u672A\u77E5 adapter: ${specified}`);
@@ -1959,7 +1896,7 @@ function finalize(ctx, result, dbFail) {
 
 // src/cli/commands/sync.ts
 import { existsSync as existsSync12, readFileSync as readFileSync10, writeFileSync as writeFileSync7, mkdirSync as mkdirSync7 } from "fs";
-import { resolve as resolve9, dirname as dirname6 } from "path";
+import { resolve as resolve9, dirname as dirname5 } from "path";
 import { createHash as createHash2 } from "crypto";
 
 // src/lib/path-normalize.ts
@@ -2204,7 +2141,7 @@ async function syncCommand(options = {}) {
 }
 function printMigrateGuidance(targetPath, changed) {
   const g = SYNC_PRISMA_CONFIG.POST_SYNC;
-  const isManaged = existsSync12(resolve9(dirname6(targetPath), "migrations"));
+  const isManaged = existsSync12(resolve9(dirname5(targetPath), "migrations"));
   const actions = isManaged ? g.MANAGED_ACTIONS : g.UNMANAGED_ACTIONS;
   console.log(`  \u25B6 \u5DF2\u5199\u5165 ${changed} \u5904\u53D8\u66F4\uFF0C${g.HEADER}`);
   for (const a of actions) {
@@ -2398,7 +2335,7 @@ async function checkPrismaDiff(projectRoot, options) {
   } else {
     console.log(`
   \u76EE\u6807 schema \u6587\u4EF6\u4E0D\u5B58\u5728: ${result.targetPath}`);
-    mkdirSync7(dirname6(targetPath), { recursive: true });
+    mkdirSync7(dirname5(targetPath), { recursive: true });
     writeFileSync7(targetPath, "// add.prisma \u2014 ADD \u6CBB\u7406\u6A21\u578B\n\n", "utf-8");
     const n = injectMissingModels(targetPath, result.missing);
     console.log(`  \u2705 \u5DF2\u521B\u5EFA\u5E76\u6CE8\u5165 ${n} \u4E2A\u6A21\u578B/\u679A\u4E3E`);
@@ -2728,7 +2665,7 @@ async function modelDownloadCommand(options) {
 }
 var program = new Command();
 program.name("add-coder").description("\u521D\u59CB\u5316 ADD \u8303\u5F0F\u5DE5\u4F5C\u6D41\u6A21\u677F").version(version);
-program.command("init").description("\u521D\u59CB\u5316 ADD \u6A21\u677F\u5230\u5F53\u524D\u9879\u76EE").option("--adapter <type>", "\u76EE\u6807 IDE: claude | qoder | vscode | trae | codex").option("--config <path>", "\u6307\u5B9A\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84").option("--force", "\u8986\u76D6\u5DF2\u6709\u6587\u4EF6\uFF0C\u4E0D\u4EA4\u4E92").option("--dry-run", "\u9884\u89C8\u6A21\u5F0F\uFF0C\u4E0D\u5B9E\u9645\u5199\u5165").option("--stack <name>", "\u6280\u672F\u6808\u7EA6\u675F profile \u540D\uFF08\u5982 machineserver\uFF0C\u53EF\u9009\uFF09").option("--skip-model", "\u8DF3\u8FC7 embedding \u6A21\u578B\u9884\u4E0B\u8F7D").option("--print-mcp-config", "Codex: stdout \u8F93\u51FA config.toml \u7247\u6BB5\uFF08\u4E0D\u5199\u76D8\uFF0C\u4E0D\u521D\u59CB\u5316\u9879\u76EE\uFF09").option("--write-user-config", "Codex: \u663E\u5F0F\u786E\u8BA4\u540E\u5199\u5165 ~/.codex/config.toml\uFF08\u5148\u5907\u4EFD\uFF09").action(initCommand);
+program.command("init").description("\u521D\u59CB\u5316 ADD \u6A21\u677F\u5230\u5F53\u524D\u9879\u76EE").option("--adapter <type>", "\u76EE\u6807 IDE: claude | qoder | vscode | trae | codex").option("--config <path>", "\u6307\u5B9A\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84").option("--force", "\u8986\u76D6\u5DF2\u6709\u6587\u4EF6\uFF0C\u4E0D\u4EA4\u4E92").option("--dry-run", "\u9884\u89C8\u6A21\u5F0F\uFF0C\u4E0D\u5B9E\u9645\u5199\u5165").option("--stack <name>", "\u6280\u672F\u6808\u7EA6\u675F profile \u540D\uFF08\u5982 machineserver\uFF0C\u53EF\u9009\uFF09").option("--skip-model", "\u8DF3\u8FC7 embedding \u6A21\u578B\u9884\u4E0B\u8F7D").action(initCommand);
 program.command("sync").description("\u589E\u91CF\u540C\u6B65\u7F3A\u5931\u6587\u4EF6\uFF08--patch \u8986\u76D6\u5DF2\u6709\u6A21\u677F\uFF09").option("--adapter <type>", "\u76EE\u6807 IDE: claude | qoder | vscode | trae | codex").option("--patch", "\u8986\u76D6\u5DF2\u6709\u6A21\u677F\u6587\u4EF6\uFF08\u4E0D\u78B0 plans/specs/reviews\uFF09").option("-i, --interactive", "\u4EA4\u4E92\u5F0F\u9009\u62E9\u8981\u540C\u6B65\u7684\u6587\u4EF6").option("--model", "\u68C0\u6D4B\u5230\u7F3A\u5931\u65F6\u4E0B\u8F7D embedding \u6A21\u578B").action(syncCommand);
 program.command("status").description("\u68C0\u67E5 ADD \u6A21\u677F\u5B8C\u6574\u6027").action(statusCommand);
 program.command("stack").description("\u7BA1\u7406\u6280\u672F\u6808\u7EA6\u675F profile\uFF08list / set <name> / show / --clear\uFF09").argument("[sub]", "list | set | show").argument("[name]", "set <name>: profile \u540D\uFF08\u5185\u7F6E\u6216\u81EA\u5B9A\u4E49\uFF09").option("--adapter <type>", "\u76EE\u6807 IDE: claude | qoder | vscode | trae | codex").option("--clear", "\u6E05\u9664\u6280\u672F\u6808\u8BBE\u7F6E\uFF08\u4E2D\u6027\uFF09").action(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-coder",
-  "version": "0.3.25-0",
+  "version": "0.3.25",
   "private": false,
   "description": "[codein2027](https://github.com/xiaomingming92/codein2027) - A complete scaffolding for building the ADD programming paradigm, the implementation layer for AI code governance. Core principle: Audit as Infrastructure. Breaks the black-box programming process and cross-session amnesia, evolving programming paradigms into an auditable, traceable, and convergent new era. npx-ready.\n\n[codein2027](https://github.com/xiaomingming92/codein2027) 快速构建 ADD 编程范式的完整脚手架——AI 代码治理的落地方案。以「审计即基础设施」为核心，彻底打破编程过程黑盒与跨轮失忆，让编程范式进化为可审计、可追溯、可收敛的新时代。npx 即用，人人可体验。",
   "repository": {

package/templates/.add-coder-src-hash.json

@@ -1,5 +1,5 @@
 {
-  "_version": "0.3.25-0",
+  "_version": "0.3.25",
   "adapters/claude/hooks/doc-format-guard.sh": "ec59ad3f",
   "adapters/claude/hooks/lib/common.sh": "4f3e64ad",
   "adapters/claude/hooks/lib/context-inject.sh": "cfc8c65e",
@@ -26,7 +26,6 @@
   "adapters/claude/hooks/subagent-stop.sh": "0f89e28c",
   "adapters/claude/mcp.json": "4ddc5120",
   "adapters/claude/settings.json": "067ccc45",
-  "adapters/codex/config.toml.example": "de1634aa",
   "adapters/codex/hooks/doc-format-guard.sh": "8e134e78",
   "adapters/codex/hooks/lib/common.sh": "4f3e64ad",
   "adapters/codex/hooks/lib/context-inject.sh": "cfc8c65e",
@@ -164,9 +163,6 @@
   "core/hooks/stop-check.sh": "dc4829be",
   "core/hooks/subagent-guard.sh": "47d04662",
   "core/hooks/subagent-stop.sh": "0a34648b",
-  "core/plans/2026-07/08/add-coder-npm-package-add-route-v1.md": "b05fce99",
-  "core/plans/2026-07/08/add-coder-npm-package-handoff-v1.md": "1bd40a4a",
-  "core/plans/2026-07/08/add-coder-npm-package-plan-v1.md": "a678d98e",
   "core/prisma/add.prisma": "037bd7e9",
   "core/reports/REPORT-WORKFLOW.md": "03d39b21",
   "core/reports/boundary-runtime-report.md": "6fd8053f",
@@ -181,7 +177,7 @@
   "core/rules/profiles/webapp-profile.md": "e493ae7b",
   "core/rules/project_rules.md": "82b25e08",
   "core/rules/theory-practice-map.toml": "b1db99fd",
-  "core/scripts/db-ensure.sh": "94a5ff92",
+  "core/scripts/db-ensure.sh": "1ef7a9f3",
   "core/scripts/gen-plan-index.sh": "bfc6ad3e",
   "core/scripts/mcp-server/elicitation/confirm.ts": "924857b8",
   "core/scripts/mcp-server/elicitation/index.ts": "44c5dc3f",
@@ -196,6 +192,7 @@
   "core/scripts/mcp-server/resources/round-task.ts": "104a0d74",
   "core/scripts/mcp-server/sampling/index.ts": "7ee26d92",
   "core/scripts/mcp-server/sampling/review.ts": "5db7a8df",
+  "core/scripts/mcp-server/shared/db-types.ts": "299915ee",
   "core/scripts/mcp-server/shared/dps-scoring.strategy.ts": "f1c901dc",
   "core/scripts/mcp-server/shared/env.ts": "57f4c2f2",
   "core/scripts/mcp-server/shared/fs.ts": "0e66a214",
@@ -203,33 +200,32 @@
   "core/scripts/mcp-server/shared/package.json": "e3d5a4a2",
   "core/scripts/mcp-server/shared/prisma.ts": "a9618f99",
   "core/scripts/mcp-server/shared/project-root-strategy.ts": "1a5bdc57",
-  "core/scripts/mcp-server/shared/redact.ts": "22e008aa",
-  "core/scripts/mcp-server/shared/response.ts": "0d1539a8",
+  "core/scripts/mcp-server/shared/response.ts": "f7806b67",
   "core/scripts/mcp-server/shared/run-command.ts": "42caf972",
   "core/scripts/mcp-server/tasks/index.ts": "c040eb75",
   "core/scripts/mcp-server/tasks/runner.ts": "d84bd35d",
   "core/scripts/mcp-server/tasks/store.ts": "2fce1a92",
-  "core/scripts/mcp-server/tools/audit.ts": "71a38969",
-  "core/scripts/mcp-server/tools/context.ts": "9ce21255",
-  "core/scripts/mcp-server/tools/contract.ts": "c894e64a",
+  "core/scripts/mcp-server/tools/audit.ts": "8564e46f",
+  "core/scripts/mcp-server/tools/context.ts": "99a2ac03",
+  "core/scripts/mcp-server/tools/contract.ts": "93dea040",
   "core/scripts/mcp-server/tools/docs.ts": "034e473c",
   "core/scripts/mcp-server/tools/gateway/check_add_route_completeness.ts": "b58e76ee",
   "core/scripts/mcp-server/tools/gateway/check_add_route_status.ts": "23fbbb6b",
   "core/scripts/mcp-server/tools/gateway/check_dps.ts": "4d599b38",
-  "core/scripts/mcp-server/tools/gateway/check_rahs.ts": "3ce99c7c",
-  "core/scripts/mcp-server/tools/gateway/check_spec_sync.ts": "8d6efd83",
+  "core/scripts/mcp-server/tools/gateway/check_rahs.ts": "4078b0f1",
+  "core/scripts/mcp-server/tools/gateway/check_spec_sync.ts": "486df441",
   "core/scripts/mcp-server/tools/gateway/helpers.ts": "f8794a92",
   "core/scripts/mcp-server/tools/gateway/index.ts": "559acb75",
   "core/scripts/mcp-server/tools/gateway.backup": "65eae393",
-  "core/scripts/mcp-server/tools/hitl.ts": "f447345f",
+  "core/scripts/mcp-server/tools/hitl.ts": "d61277f5",
   "core/scripts/mcp-server/tools/hook-event-report.ts": "3f21836e",
-  "core/scripts/mcp-server/tools/index.ts": "3e6b6135",
-  "core/scripts/mcp-server/tools/plan.ts": "477fd80d",
+  "core/scripts/mcp-server/tools/index.ts": "884172ba",
+  "core/scripts/mcp-server/tools/plan.ts": "8ce5a7ab",
   "core/scripts/mcp-server/tools/quality.ts": "c4634453",
   "core/scripts/mcp-server/tools/registrar.ts": "efd81b3a",
-  "core/scripts/mcp-server/tools/review.ts": "370f84f2",
+  "core/scripts/mcp-server/tools/review.ts": "52d78450",
   "core/scripts/mcp-server/types.ts": "6c5e60bc",
-  "core/scripts/mcp-server.ts": "48b1fd69",
+  "core/scripts/mcp-server.ts": "99cc6833",
   "core/skills/add-paradigm/SKILL.md": "5d4fa389",
   "core/skills/session-init/SKILL.md": "bb1205b0",
   "core/specs/add-coder-npm-package/checklist.md": "ed92032c",
@@ -269,12 +265,12 @@
   "core/templates/review-template.schema.json": "abc2ece6",
   "core/templates/runtime-report-template.md": "7b35208a",
   "core/templates/runtime-report-template.schema.json": "6c1143e6",
-  "core/templates/simple-plan-template.md": "db5c247f",
-  "core/templates/simple-plan-template.schema.json": "99d53cc1",
+  "core/templates/simple-plan-template.md": "5b2d8dd6",
+  "core/templates/simple-plan-template.schema.json": "02718806",
   "core/templates/spec-template.md": "619b01cc",
   "core/templates/spec-template.schema.json": "051b6e5d",
-  "core/templates/standard-plan-template.md": "2129931c",
-  "core/templates/standard-plan-template.schema.json": "2b767928",
+  "core/templates/standard-plan-template.md": "7beafc59",
+  "core/templates/standard-plan-template.schema.json": "ca2bbb11",
   "core/templates/tasks-template.md": "2b9d0d52",
   "core/templates/tasks-template.schema.json": "fff6eb47",
   "core/tools/README.md": "26a63460",

package/templates/core/scripts/db-ensure.sh

@@ -156,14 +156,6 @@ apply_atlas_diff() {
 # ⑦ Atlas 同步主流程（探测 → dev-url → 目标 → baseline → diff → apply）
 atlas_sync() {
   [ "$ENGINE" = "sqlite" ] && return 0
-  # 迁移锁（进程层契约 v2 §6）：多 IDE 并发 init 时仅一个进程执行迁移
-  # 非阻塞拿锁（pg_try_advisory_lock），会话级锁——脚本退出连接断开自动释放
-  LOCK_KEY="0xADD001"
-  LOCKED="$(podman exec "${PROJECT_NAME:-add-project}-postgres" psql -U "${DATABASE_USER:-admin}" -d "${PROJECT_NAME:-add-project}" -tAc "SELECT pg_try_advisory_lock(${LOCK_KEY});" 2>/dev/null || true)"
-  if [ "$LOCKED" != "t" ]; then
-    echo "!!! 另一个进程正在迁移，请稍后重试"
-    return 1
-  fi
   if ! atlas_cmd version > /dev/null 2>&1; then
     echo "!!! Atlas 不可用。add-coder sync --patch 可自动安装 @ariga/atlas；或手动: pnpm add -D @ariga/atlas"
     echo "    降级路径: prisma-diff（免 shadow）→ db-push + 强制备份；文档: README「Atlas 数据库同步能力」"

package/templates/core/scripts/mcp-server/shared/db-types.ts

@@ -0,0 +1,208 @@
+/*
+ * 数据层结构化类型（MCP server）— zod 托管版（D1）
+ *
+ * 背景：shared/prisma.ts 运行时动态 require 生成的 Prisma client（模板会被复制到任意
+ * 消费方项目，不能静态依赖特定生成类型）——加载点的「无类型」不可避免。
+ *
+ * 本文件职责（边界从「盲信 cast」升级为「运行期验证」）：
+ * 1. zod schema 为单一真源：行类型一律 z.infer 派生（编译期约束不丢）
+ * 2. validatedDelegate 包装 findFirst/findMany/create/update/delete：
+ *    DB 返回行过 schema.parse —— 消费方迁移滞后/schema 漂移时**立即显式报错**，
+ *    而非让 undefined 字段静默漂移到下游
+ * 3. z.looseObject 前瞻兼容（zod v4 替代已弃用的 .passthrough()）：add.prisma 未来加列不误伤旧模板
+ * 4. parse 失败出处方式报错（弱模型可执行），不裸抛 zod issue 堆栈
+ *
+ * 契约：schema 须与 prisma/add.prisma 模型对齐（字段名/可空性）。
+ */
+import * as z from "zod/v4"
+
+// ===== 行 schema（对齐 prisma/add.prisma；looseObject 前瞻兼容） =====
+
+export const PlanRowSchema = z.looseObject({
+  id: z.string(),
+  planName: z.string(),
+  planPath: z.string(),
+  planKeyword: z.string().nullable(),
+  specPath: z.string().nullable(),
+  tasksPath: z.string().nullable(),
+  checklistPath: z.string().nullable(),
+  addRoutePath: z.string().nullable(),
+  totalTasks: z.number(),
+  doneTasks: z.number(),
+  checklistT: z.number(),
+  checklistTDone: z.number(),
+  checklistR: z.number(),
+  dpsStructScore: z.number().nullable(),
+  dpsSemScore: z.number().nullable(),
+  dpsEntropyScore: z.number().nullable(),
+  dpsCpmScore: z.number().nullable(),
+  dpsComposite: z.number().nullable(),
+  contractRole: z.string().nullable(),
+  contractName: z.string().nullable(),
+  createdAt: z.date(),
+  updatedAt: z.date(),
+})
+
+export const HitlRowSchema = z.looseObject({
+  id: z.string(),
+  planName: z.string(),
+  round: z.number(),
+  type: z.enum(["PLAN", "PLAN_REVIEW", "COLLAB_CONTRACT"]),
+  status: z.enum(["DRAFT", "SUBMITTED", "TONGYI", "BOHUI"]),
+  approvedAt: z.date().nullable(),
+  rejectedAt: z.date().nullable(),
+  rejectReason: z.string().nullable(),
+  createdAt: z.date(),
+  updatedAt: z.date(),
+})
+
+export const ReviewRowSchema = z.looseObject({
+  id: z.string(),
+  planName: z.string(),
+  type: z.enum(["PLAN_REVIEW", "IMPLEMENTATION", "RUNTIME"]),
+  reviewPath: z.string().nullable(),
+  p0Count: z.number(),
+  p1Count: z.number(),
+  backflowRate: z.number(),
+  createdAt: z.date(),
+  updatedAt: z.date(),
+})
+
+export const AuditLogRowSchema = z.looseObject({
+  id: z.string(),
+  action: z.string(),
+  targetType: z.string(),
+  targetId: z.string(),
+  beforeState: z.unknown().nullable(),
+  afterState: z.unknown().nullable(),
+  reason: z.string().nullable(),
+  planKeyword: z.string().nullable(),
+  createdAt: z.date(),
+})
+
+export const DevOperationRowSchema = z.looseObject({
+  id: z.string(),
+  userId: z.string(),
+  planKeyword: z.string(),
+  action: z.string(),
+  targetType: z.string(),
+  targetId: z.string(),
+  beforeState: z.unknown().nullable(),
+  afterState: z.unknown().nullable(),
+  reason: z.string().nullable(),
+  createdAt: z.date(),
+})
+
+// AddUser 仅消费 id（select { id } 场景），username/email 宽容可空
+// （避免 select 裁剪导致必填字段缺失误伤——机器占位机器回刷原则）
+export const AddUserRowSchema = z.looseObject({
+  id: z.string(),
+  username: z.string().optional(),
+  email: z.string().nullable().optional(),
+})
+
+export const CollabContractRowSchema = z.looseObject({
+  id: z.string(),
+  contractName: z.string(),
+  contractPath: z.string(),
+  masterPlanName: z.string(),
+  participants: z.unknown(),
+  abilityMatrix: z.unknown().nullable(),
+  stages: z.unknown(),
+  dependencyGraph: z.string().nullable(),
+  fileBoundaries: z.unknown(),
+  completionCriteria: z.unknown().nullable(),
+  status: z.string(),
+  version: z.number(),
+  createdAt: z.date(),
+  updatedAt: z.date(),
+})
+
+// ===== 类型派生（单一真源：schema → 类型） =====
+
+export type PlanRow = z.infer<typeof PlanRowSchema>
+export type HitlRow = z.infer<typeof HitlRowSchema>
+export type ReviewRow = z.infer<typeof ReviewRowSchema>
+export type AuditLogRow = z.infer<typeof AuditLogRowSchema>
+export type DevOperationRow = z.infer<typeof DevOperationRowSchema>
+export type AddUserRow = z.infer<typeof AddUserRowSchema>
+export type CollabContractRow = z.infer<typeof CollabContractRowSchema>
+
+// ===== 查询参数（Prisma 最常用子集，结构化约束 + 运算符支持） =====
+
+export type OrderDirection = "asc" | "desc"
+
+// where 放开为 Record<string, unknown>：Prisma 运算符（contains/gte/OR 等）
+// 动态组合，键名约束会阻碍合法查询（如 review.ts 的 contains、audit.ts 的 OR）
+export interface QueryArgs<T> {
+  where?: Record<string, unknown>
+  orderBy?: { [K in keyof T]?: OrderDirection }
+  take?: number
+  skip?: number
+  include?: Record<string, unknown>
+}
+
+export interface BatchResult { count: number }
+
+// ===== 泛型委托接口：业务层唯一依赖的数据访问契约 =====
+
+export interface TableDelegate<T> {
+  findFirst(args: Pick<QueryArgs<T>, "where" | "orderBy">): Promise<T | null>
+  findMany(args?: QueryArgs<T>): Promise<T[]>
+  findUnique(args: { where: Record<string, unknown>; select?: Record<string, unknown> }): Promise<T | null>
+  create(args: { data: Partial<T> }): Promise<T>
+  update(args: { where: Partial<T>; data: Partial<T> }): Promise<T>
+  updateMany(args: { where: Record<string, unknown>; data: Partial<T> }): Promise<BatchResult>
+  delete(args: { where: Partial<T> }): Promise<T>
+  deleteMany(args: { where: Partial<T> }): Promise<BatchResult>
+}
+
+// ===== 边界升级：validating delegate（无类型收敛单点 + 运行期行校验） =====
+
+/**
+ * 把动态加载的无类型 delegate 包装为**运行期校验**的泛型委托。
+ * - 读路径（findFirst/findMany）与写返回值（create/update/delete）过 schema.parse
+ * - parse 失败 → 可读处方报错（表名 + 首个问题 + 迁移指引），不裸抛 zod 堆栈
+ * - deleteMany 仅返回计数，无行结构可校验，直通
+ */
+export function validatedDelegate<T>(
+  rawDelegate: unknown,
+  rowSchema: z.ZodType<T>,
+  tableName: string,
+): TableDelegate<T> {
+  const raw = rawDelegate as TableDelegate<unknown>
+
+  const parseRow = (row: unknown): T => {
+    const result = rowSchema.safeParse(row)
+    if (!result.success) {
+      const issue = result.error.issues[0]
+      const field = issue?.path?.join(".") || "(未知字段)"
+      throw new Error(
+        `DB 行结构与预期不符（表 ${tableName}）: ${field} — ${issue?.message ?? "校验失败"}\n` +
+        `处方: 检查项目是否已迁移至最新 prisma/add.prisma（bash scripts/db-ensure.sh），或核对 db-types.ts schema 与 add.prisma 是否同步`
+      )
+    }
+    return result.data
+  }
+
+  return {
+    async findFirst(args) {
+      const row = await raw.findFirst(args as never)
+      return row === null ? null : parseRow(row)
+    },
+    async findMany(args) {
+      const rows = await raw.findMany(args as never)
+      return rows.map(parseRow)
+    },
+    async findUnique(args) {
+      if (!raw.findUnique) throw new Error(`表 ${tableName} 不支持 findUnique`)
+      const row = await raw.findUnique(args as never)
+      return row === null ? null : parseRow(row)
+    },
+    async create(args) { return parseRow(await raw.create(args as never)) },
+    async update(args) { return parseRow(await raw.update(args as never)) },
+    async updateMany(args) { return raw.updateMany(args as never) as Promise<BatchResult> },
+    async delete(args) { return parseRow(await raw.delete(args as never)) },
+    async deleteMany(args) { return raw.deleteMany(args as never) as Promise<BatchResult> },
+  }
+}

package/templates/core/scripts/mcp-server/shared/response.ts

@@ -1,10 +1,9 @@
 import type { ToolResponse } from "../types.js"
-import { redact } from "./redact.js"
 
 export function textResponse(text: string): { content: ToolResponse } {
-  return { content: [{ type: "text", text: redact(text) }] }
+  return { content: [{ type: "text", text }] }
 }
 
 export function errorResponse(message: string): { content: ToolResponse; isError: boolean } {
-  return { content: [{ type: "text", text: redact(message) }], isError: true }
+  return { content: [{ type: "text", text: message }], isError: true }
 }