add-coder 0.2.8 → 0.3.0

package/README.md

@@ -1,11 +1,15 @@
 # add-coder
 
+Make 0.75 into one.
+
 > 🀄中文 | 🔤[English](#-english-readme)
 
 **AI 代码治理的落地方案** — [codein2027](https://github.com/xiaomingming92/codein2027) 快速构建 ADD 编程范式的完整脚手架。以「审计即基础设施」为核心，彻底打破编程过程黑盒与跨轮失忆，让编程范式进化为可审计、可追溯、可收敛的新时代。 [NPM](https://www.npmjs.com/package/add-coder) · [GitHub](https://github.com/xiaomingming92/add-coder)
 
 
 > 🧭 **从零上手实操？** 请参见 [GUIDE.md](https://github.com/xiaomingming92/add-coder/blob/main/GUIDE.md) — 包含触发词速查、需求转 Plan、完整链路演练。
+>
+> 🔄 **add-coder 升级后更新模板？** `npx add-coder sync --adapter=qoder --patch` — 实操看 [GUIDE.md §版本升级](#) | 原理看 [DEVELOPMENT.md](https://github.com/xiaomingming92/add-coder/blob/main/DEVELOPMENT.md)
 
 ```bash
 npx add-coder init
@@ -27,7 +31,22 @@ npx add-coder init
 | 审计靠开发者自觉记录 | **MCP 审计工具链** 自动记录每次操作，系统闸门强制检查 |
 | 无关联性 | 审计事件天然关联 Plan → Spec → Task → Step → Tool Call，形成完整证据链 |
 
-### ② Prompt Cache 原生友好 — 月费 ¥218，节省 98%
+### ② Caijuehub 规则引擎：业务规则直驱代码
+
+Caijuehub 是 add-coder 历史上第一个实现 **TOML 规则声明 → 自动生成策略 → 业务代码消费** 的裁决引擎。以 sync --patch 为例：
+
+```toml
+# sync-rules.toml — 改这里，不改代码
+[patch]
+on_conflict = "interactive"   # 内容冲突时：交互勾选
+on_missing = "write"          # 文件缺失时：静默写入
+[version]
+on_upgrade = "baseline"       # 版本升级时：自动覆盖
+```
+
+`npm run generate` 后，策略直驱 sync.ts 行为。**人类从"追踪散落的 if"升级为"读一张决策表"**——认知负担从 O(N×M) 降为 O(1)。产品经理、市场人员改 TOML 即可把控软件能力，决策权集中、单一入口绕不过去。更进一步：当业务规则以声明式集中管理，**AI Agent 可大规模索引、检索、修改规则**——人机协作不再局限于对话生成代码，而是共同操作同一张决策表。这是 [codein2027 集中裁决层理论](https://github.com/xiaomingming92/codein2027) 的第一个工程落地。详见 [docs/caijuehub.md](./docs/caijuehub.md)。
+
+### ③ Prompt Cache 原生友好 — 月费 ¥218，节省 98%
 
 ADD 范式不仅是方法论——它的结构化 Step 流程天然适配 DeepSeek Prompt Cache 的前缀匹配机制，带来极致的 Token 成本效率。**实测数据验证**：
 
@@ -46,7 +65,7 @@ ADD 范式 + Qoder:     cache 命中率 99.31%, 每次请求 MISS 仅 2,426 toke
 
 > 📊 [完整分析报告](./docs/ADD范式缓存命中分析报告.md) — 含 4 张 Mermaid 图表、17 天逐日数据、跨 IDE 对比与成本建模。
 
-### ③ 门禁驱动，而非自由对话
+### ④ 门禁驱动，而非自由对话
 
 传统 AI coding 是「你说我做」，质量完全依赖 LLM 当天状态。add-coder 在架构中嵌入了 **双质量闸门**：
 
@@ -57,7 +76,7 @@ RAHS (Runtime Architecture Health Score) — 运行时架构健康度，< 90% BL
 
 这不是「建议」，是**架构阻断** — 不通过闸门的 Step 无法推进到下一步。
 
-### ④ 跨轮记忆，而非每轮失忆
+### ⑤ 跨轮记忆，而非每轮失忆
 
 AI 对话的致命缺陷：上次讨论的架构决策、已修复的 Bug、达成的约定，下轮对话全部遗忘。add-coder 在架构层面解决：
 
@@ -65,7 +84,7 @@ AI 对话的致命缺陷：上次讨论的架构决策、已修复的 Bug、达
 - **Plan 索引** — 所有 Plan 通过 `index.md` 集中索引，支持模糊匹配快速定位
 - **DevLog 时序记录** — 每一步操作写入 `{YYYY-MM}/{DD}/` 时间轴，可回溯任意历史状态
 
-### ⑤ Policy-Update-Loop：治理自我进化(脚手架不包含此架构能力,接下来会给到DEMO仓库让大家更好理解Policy-Update-Loop和Report体系)
+### ⑥ Policy-Update-Loop：治理自我进化(脚手架不包含此架构能力,接下来会给到DEMO仓库让大家更好理解Policy-Update-Loop和Report体系)
 
 不是静态模板，而是**闭环自适应系统**：
 
@@ -75,7 +94,7 @@ AI 对话的致命缺陷：上次讨论的架构决策、已修复的 Bug、达
 
 运行时产生的 Report 会反过来更新 governance rules，实现治理策略的持续进化。
 
-### ⑥ 多 IDE 的 Hook 即治理层
+### ⑦ 多 IDE 的 Hook 即治理层
 
 hook 不是「通知推送」，而是 **ADD 范式在 IDE agent 生命周期中的 17 个确定性治理卡位**。每个 IDE（Claude Code / Qoder CN / VS Code Copilot / Trae / Codex）有各自的 hook 机制，但治理逻辑统一——架构一致，适配层不同。
 
@@ -89,6 +108,8 @@ hook 不是「通知推送」，而是 **ADD 范式在 IDE agent 生命周期中
 
 > 实施 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)
 
+
+
 ---
 
 ## 快速开始
@@ -158,16 +179,16 @@ npx add-coder init
 ```
 MCP 能力            方向              当前状态     说明
 ─────────────────────────────────────────────────────────────
-Tools              Client→Server     ✅ 已实现     17 个审计与治理工具（pull 模式）
-Resources+Sub      Client←Server     🔜 本轮       Plan/Review/Route/Task 状态实时推送
-Notifications      Server→Client     🔜 本轮       HITL 就绪通知 / Hook 结果推送
-Sampling           Server→Client     🔜 本轮       服务端回调 AI 生成 Review
+Tools              Client→Server     ✅ 已实现     18 个审计与治理工具（pull 模式）
+Resources+Sub      Client←Server     ✅ 已实现      8 个端点 Plan/Review/Route/Task/Hook 状态推送
+Notifications      Server→Client     ✅ 已实现      HITL 就绪 + Hook 拦截事件推送
+Sampling           Server→Client     ✅ 已实现      服务端回调 AI 生成 Review (HITL 两步法)
 ── 横切 ──
-Elicitation        Server→Client     🔜 本轮       向用户请求 HITL 确认/风险输入
-Tasks (实验性)     双向              🔜 本轮       长任务持久化 + 状态追踪
+Elicitation        Server→Client     ✅ 已实现      向用户请求 HITL 确认/风险输入
+Tasks (实验性)     双向              ✅ 已实现      长任务持久化 + 状态追踪
 ```
 
-**当前已实现的 17 个 Tools**：
+**当前已实现的 18 个 Tools**：
 
 | 工具 | 用途 | 触发场景 |
 |------|------|---------|
@@ -180,6 +201,7 @@ Tasks (实验性)     双向              🔜 本轮       长任务持久化 +
 | `check_add_route_status` | add-route 文件存在性校验 | Step 3 前 |
 | `check_spec_sync` | Spec 文档勾选状态与代码一致性 | Spec 执行后 |
 | `find_related_docs` | 检索相关架构/规范文档 | 语境理解 |
+| `get_hook_events` | 查询 Hook 拦截事件（planKeyword/hook/时间过滤+分组） | 治理审计、阈值告警 |
 
 > 完整六能力架构设计见 [MCP 重构 Plan](.qoder/plans/2026-07/23/add-coder-mcp-restructure-plan-v1.md)。
 
@@ -246,11 +268,12 @@ Tasks (实验性)     双向              🔜 本轮       长任务持久化 +
 
 ## 🎬 预告
 
-| 计划 | 说明 |
-|------|------|
-| Demo 仓库演示 | 提供完整示例仓库，展示 Policy-Update-Loop 与 Report 体系的端到端闭环实践 |
-| MCP 能力重构 | MCP 工具链架构升级，提升审计与门禁工具的可扩展性和独立部署能力 |
-| 对话记忆增强 | 长期项目知识记忆和plan级别的稀疏记忆 |
+| 计划 | 说明 |备注|
+|------|------|------|
+| Demo 仓库演示 | 提供完整示例仓库，展示 Policy-Update-Loop 与 Report 体系的端到端闭环实践 |--|
+| MCP 能力重构 | ✅ v0.2.9 MCP 工具链架构升级，提升审计与门禁工具的可扩展性和独立部署能力 | 2026-07/23/add-coder-mcp-restructure-plan-v1.md |
+| Hook 通知升级 | ✅ v0.2.9 Hook 拦截事件 jsonl → fs.watch → record_dev_operation 落库 + Notification + 治理信号 | 2026-07/24/add-coder-hook-notify-upgrade-plan-v1.md |
+| 对话记忆增强 | 长期项目知识记忆和plan级别的稀疏记忆 |--|
 
 
 
@@ -282,7 +305,22 @@ Traditional AI development: Chat → Generate code → Dig through chat history
 | Auditing relies on developer discipline | The **MCP audit toolchain** automatically records every operation; system gateways enforce checks |
 | No traceability | Audit events are naturally linked: Plan → Spec → Task → Step → Tool Call, forming a complete evidence chain |
 
-### ② Prompt Cache Native — ¥218/mo, 98% Savings
+### ② Caijuehub Rule Engine: Business Rules Drive Code
+
+Caijuehub is add-coder's first implementation of **TOML declaration → auto-generated strategy → business code consumption**. Using sync --patch as an example:
+
+```toml
+# sync-rules.toml — edit here, not code
+[patch]
+on_conflict = "interactive"   # content conflict → interactive checkbox
+on_missing = "write"          # file missing → silent write
+[version]
+on_upgrade = "baseline"       # version upgrade → auto overwrite
+```
+
+After `npm run generate`, the strategy directly drives sync.ts behavior. **Humans upgrade from "hunting scattered if-statements" to "reading a decision table"** — cognitive load drops from O(N×M) to O(1). Product managers and marketers edit TOML to control software capabilities, with decisions centralized at a single entry point that cannot be bypassed. Furthermore: when business rules are declaratively centralized, **AI Agents can index, search, and modify rules at scale** — human-AI collaboration extends beyond conversation-driven code generation to jointly operating the same decision table. This is the first engineering implementation of [codein2027's Centralized Decision Layer theory](https://github.com/xiaomingming92/codein2027). Details: [docs/caijuehub.md](./docs/caijuehub.md).
+
+### ③ Prompt Cache Native — ¥218/mo, 98% Savings
 
 The ADD paradigm isn't just methodology — its structured Step workflow naturally aligns with DeepSeek's Prompt Cache prefix-matching mechanism, delivering extreme token cost efficiency. **Real-world billing validation**:
 
@@ -301,7 +339,7 @@ ADD paradigm + Qoder:       cache hit rate 99.31%, only 2,426 MISS tokens/req
 
 > 📊 [Full analysis report](./docs/ADD范式缓存命中分析报告.md) — 4 Mermaid diagrams, 17-day daily data, cross-IDE comparison, and cost modeling.
 
-### ③ Gateway-Driven, Not Free-Form Conversation
+### ④ Gateway-Driven, Not Free-Form Conversation
 
 Traditional AI coding is "you say, I do" — quality depends entirely on the LLM's state that day. add-coder embeds **dual quality gateways** into the architecture:
 
@@ -312,7 +350,7 @@ RAHS (Runtime Architecture Health Score) — Runtime architecture health, < 90%
 
 These are not "suggestions" — they are **architectural blocks**. A Step cannot advance without passing its gateway.
 
-### ④ Cross-Session Memory, Not Per-Session Amnesia
+### ⑤ Cross-Session Memory, Not Per-Session Amnesia
 
 The fatal flaw of AI conversations: architectural decisions from last session, bugs fixed, agreements reached — all forgotten in the next conversation. add-coder solves this at the architecture level:
 
@@ -320,7 +358,7 @@ The fatal flaw of AI conversations: architectural decisions from last session, b
 - **Plan Index** — All Plans are centrally indexed via `index.md`, supporting fuzzy-match quick lookup
 - **DevLog Timeline** — Every operation is written to the `{YYYY-MM}/{DD}/` timeline, enabling full historical state traceability
 
-### ⑤ Policy-Update-Loop: Self-Evolving Governance (the scaffold itself does not include this architectural capability; a DEMO repo will be provided next to better illustrate the Policy-Update-Loop and Report system)
+### ⑥ Policy-Update-Loop: Self-Evolving Governance (the scaffold itself does not include this architectural capability; a DEMO repo will be provided next to better illustrate the Policy-Update-Loop and Report system)
 
 Not a static template, but a **closed-loop adaptive system**:
 
@@ -330,7 +368,7 @@ Execute → Audit → Boundary Report → Rule Adjustment → Next Execution
 
 Runtime-generated Reports feed back into governance rules, enabling continuous evolution of governance strategies.
 
-### ⑥ Multi-IDE Hooks as the Governance Layer
+### ⑦ Multi-IDE Hooks as the Governance Layer
 
 Hooks are not "notification push" — they are the **IDE runtime interception layer**:
 
@@ -497,10 +535,11 @@ npx add-coder init
 
 ## 🎬 Coming Soon
 
-| Plan | Description |
-|------|-------------|
-| Demo Repo | A full example repository showcasing end-to-end closed-loop practice of Policy-Update-Loop and the Report system |
-| MCP Restructure | MCP toolchain architecture upgrade, improving audit and gateway tool extensibility and standalone deployment capability |
-| Memory Enhancement | Long-term project knowledge memory and plan-level sparse memory |
+| Plan | Description | remark |
+|------|-------------|:---:|
+| Demo Repo | Full example repository showcasing Policy-Update-Loop with Report system end-to-end | 📋 |
+| ~~MCP Restructure~~ | ✅ v0.2.9 3,467-line monolith → 27 modules covering all six MCP primitives | 2026-07/23/... |
+| ~~Hook Notification Upgrade~~ | ✅ v0.2.9 ~36 files: hook intercept → jsonl → fs.watch → record_dev_operation | 2026-07/24/... |
+| Memory Enhancement | Long-term project knowledge memory and plan-level sparse memory | 📋 |
 
 ---

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli/index.ts
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync7 } from "fs";
 import { Command } from "commander";
 
 // src/caijuehub/strategies/detect.strategy.ts
@@ -155,7 +155,7 @@ function renderList(items, selected, startIdx, height) {
 `;
   }
   out += `
-\u547D\u4EE4: [a]\u5168\u9009 [n]\u53D6\u6D88\u5168\u9009 [1-${items.length}]\u5207\u6362 [\u2191\u2193]\u6EDA\u52A8 [Enter]\u786E\u8BA4 [q]\u9000\u51FA
+\u547D\u4EE4: [a]\u5168\u90E8\u8DF3\u8FC7 [A]\u5168\u90E8\u8986\u76D6 [1-${items.length}]\u5207\u6362 [Enter]\u786E\u8BA4 [q]\u9000\u51FA
 `;
   return out;
 }
@@ -197,12 +197,12 @@ async function selectFiles(projectRoot, files) {
       draw();
     });
     rl.on("line", (input2) => {
-      const trimmed = input2.trim().toLowerCase();
-      if (trimmed === "q" || trimmed === "quit") {
+      const trimmed = input2.trim();
+      if (trimmed === "q" || trimmed.toLowerCase() === "quit") {
         rl.close();
-      } else if (trimmed === "a") {
+      } else if (trimmed === "A") {
         items.forEach((_, i) => selected.add(i));
-      } else if (trimmed === "n") {
+      } else if (trimmed === "a") {
         selected.clear();
       } else {
         const num = parseInt(trimmed, 10);
@@ -444,7 +444,7 @@ var PRISMA_CONFIG = {
   autoGenerate: true,
   migrationName: "add_workflow_init",
   schemaArg: "--schema=prisma/",
-  requiresUserModel: false
+  requiresUserModel: true
 };
 function ensurePrismaConfig(projectRoot) {
   const configPath = resolve3(projectRoot, "prisma.config.ts");
@@ -629,6 +629,7 @@ async function injectPrisma2(projectRoot, options = {}) {
 
 // src/cli/commands/init.ts
 import { readFileSync as readFileSync5, writeFileSync as writeFileSync3, existsSync as existsSync6, mkdirSync as mkdirSync3, copyFileSync as copyFileSync2, readdirSync as readdirSync2 } from "fs";
+import { createHash } from "crypto";
 import { resolve as resolve5 } from "path";
 import { spawnSync as spawnSync2 } from "child_process";
 import { createConnection } from "net";
@@ -893,6 +894,33 @@ async function renderAndWrite(ctx) {
     for (const [p, c] of claudeFiles) allFiles.set(p, c);
     console.log(`claude adapter (via Agent Host): ${claudeFiles.size} \u6587\u4EF6`);
   }
+  for (const d of [".add", magicDir]) {
+    const reviewsDir = resolve5(projectRoot, d, "reviews");
+    if (!existsSync6(reviewsDir)) {
+      if (dry) {
+        console.log(`[dry-run] \u5C06\u521B\u5EFA ${reviewsDir}/`);
+      } else {
+        mkdirSync3(reviewsDir, { recursive: true });
+      }
+    }
+  }
+  if (!dry) {
+    const hashMap = {};
+    let npmVer = "";
+    try {
+      npmVer = JSON.parse(readFileSync5(resolve5(projectRoot, "node_modules", "add-coder", "templates", ".add-coder-src-hash.json"), "utf-8"))._version ?? "";
+    } catch {
+    }
+    for (const [rp, c] of allFiles) {
+      hashMap[rp] = createHash("sha256").update(c).digest("hex").slice(0, 8);
+    }
+    const hashOut = resolve5(projectRoot, magicDir, ".add-coder-hash.json");
+    writeFileSync3(hashOut, JSON.stringify(hashMap, null, 2) + "\n", "utf-8");
+    if (npmVer) {
+      writeFileSync3(resolve5(projectRoot, magicDir, ".add-coder-version"), npmVer + "\n", "utf-8");
+    }
+    console.log(`hash: ${Object.keys(hashMap).length} entries \u2192 ${magicDir}/.add-coder-hash.json`);
+  }
   return await writeFiles2(projectRoot, allFiles, { force: options.force, dryRun: options.dryRun });
 }
 async function deployDatabase(ctx) {
@@ -986,8 +1014,30 @@ function finalize(ctx, result) {
 }
 
 // src/cli/commands/sync.ts
-import { existsSync as existsSync7 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
 import { resolve as resolve6 } from "path";
+import { createHash as createHash2 } from "crypto";
+
+// src/caijuehub/strategies/sync.strategy.ts
+var SYNC_CONFIG = {
+  PATCH_GUARD: [/[/]plans[/]/, /[/]specs[/]/, /[/]reviews[/]/],
+  HASH_OUTPUT_FILE: ".add-coder-hash.json",
+  HASH_SRC_FILE: "templates/.add-coder-src-hash.json",
+  HASH_HEX_LENGTH: 8,
+  PATCH_ON_MISSING: "write",
+  PATCH_ON_CONFLICT: "interactive",
+  PATCH_ON_SAME: "skip",
+  VERSION_ON_FIRST: "baseline",
+  VERSION_ON_UPGRADE: "baseline",
+  VERSION_ON_HASH_LOST: "conflict",
+  VERSION_SENTINEL: ".add-coder-version",
+  DEFAULT_ON_MISSING: "write",
+  DEFAULT_ON_EXISTING: "skip",
+  PROMPT_FULL: "\u6240\u6709 ADD \u6A21\u677F\u6587\u4EF6\u5DF2\u5C31\u4F4D\u3002\u4F7F\u7528 --patch \u66F4\u65B0\u5DF2\u6709\u6587\u4EF6\u3002",
+  PROMPT_PATCH_DONE: "\u6240\u6709 ADD \u6A21\u677F\u6587\u4EF6\u5DF2\u662F\u6700\u65B0\u3002"
+};
+
+// src/cli/commands/sync.ts
 var ADAPTER_RENDERERS2 = {
   claude: renderAdapter,
   qoder: renderAdapter2,
@@ -1010,6 +1060,34 @@ function resolveAdapter2(projectRoot, specified) {
   console.log("\u672A\u68C0\u6D4B\u5230 IDE \u73AF\u5883\uFF0C\u9ED8\u8BA4 qoder");
   return "qoder";
 }
+function isUserData(p) {
+  return SYNC_CONFIG.PATCH_GUARD.some((r) => r.test(p));
+}
+function hash8(c) {
+  return createHash2("sha256").update(c).digest("hex").slice(0, SYNC_CONFIG.HASH_HEX_LENGTH);
+}
+function loadHashFile(root, magic) {
+  try {
+    return JSON.parse(readFileSync6(resolve6(root, magic, SYNC_CONFIG.HASH_OUTPUT_FILE), "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function loadVersionFile(root, magic) {
+  try {
+    return readFileSync6(resolve6(root, magic, SYNC_CONFIG.VERSION_SENTINEL), "utf-8").trim();
+  } catch {
+    return "";
+  }
+}
+function saveVersionFile(root, magic, version2) {
+  writeFileSync4(resolve6(root, magic, SYNC_CONFIG.VERSION_SENTINEL), version2 + "\n", "utf-8");
+}
+function saveHashFile(root, magic, files) {
+  const m = {};
+  for (const [p, c] of files) m[p] = hash8(c);
+  writeFileSync4(resolve6(root, magic, SYNC_CONFIG.HASH_OUTPUT_FILE), JSON.stringify(m, null, 2) + "\n", "utf-8");
+}
 async function syncCommand(options = {}) {
   const projectRoot = process.cwd();
   const target = resolveAdapter2(projectRoot, options.adapter);
@@ -1040,6 +1118,75 @@ async function syncCommand(options = {}) {
     for (const [p, c] of claudeFiles) allFiles.set(p, c);
     console.log(`claude adapter (via Agent Host): ${claudeFiles.size} \u6587\u4EF6`);
   }
+  if (options.patch) {
+    const candidates = /* @__PURE__ */ new Map();
+    let skipped = 0;
+    for (const [p, c] of allFiles) {
+      if (isUserData(p)) {
+        skipped++;
+        continue;
+      }
+      candidates.set(p, c);
+    }
+    const outHash = loadHashFile(projectRoot, magicDir);
+    const srcHashPath = resolve6(projectRoot, "node_modules", "add-coder", "templates", ".add-coder-src-hash.json");
+    let npmVersion = "";
+    try {
+      npmVersion = JSON.parse(readFileSync6(srcHashPath, "utf-8"))._version ?? "";
+    } catch {
+    }
+    const installedVersion = loadVersionFile(projectRoot, magicDir);
+    const isFirstPatch = !installedVersion;
+    const isUpgrade = installedVersion && npmVersion && installedVersion !== npmVersion;
+    const hashLost = installedVersion && !isUpgrade && Object.keys(outHash).length === 0;
+    const establishBaseline = isFirstPatch || isUpgrade;
+    if (isFirstPatch) {
+      console.log(`\u{1F3AF} \u9996\u6B21 patch\uFF0C\u5EFA\u7ACB\u57FA\u7EBF v${npmVersion}`);
+    } else if (isUpgrade) {
+      console.log(`\u{1F3AF} \u7248\u672C\u5347\u7EA7: ${installedVersion} \u2192 ${npmVersion}\uFF0C\u5EFA\u7ACB\u65B0\u57FA\u7EBF`);
+    } else if (hashLost) {
+      console.log(`\u26A0\uFE0F  hash \u4E22\u5931\uFF08\u7248\u672C ${installedVersion} \u672A\u53D8\uFF09\uFF0C\u5168\u90E8\u8FDB\u4EA4\u4E92\u786E\u8BA4`);
+    }
+    const missingFiles = /* @__PURE__ */ new Map();
+    const conflictFiles = /* @__PURE__ */ new Map();
+    let sameCount = 0;
+    for (const [relPath, content] of candidates) {
+      const absPath = resolve6(projectRoot, relPath);
+      if (!existsSync7(absPath)) {
+        missingFiles.set(relPath, content);
+      } else if (establishBaseline) {
+        missingFiles.set(relPath, content);
+      } else {
+        const curH = hash8(readFileSync6(absPath, "utf-8"));
+        const storedH = outHash[relPath];
+        if (storedH && curH === storedH) {
+          sameCount++;
+        } else {
+          conflictFiles.set(relPath, content);
+        }
+      }
+    }
+    console.log(`patch: ${allFiles.size} \u2192 skip user ${skipped} | missing ${missingFiles.size} | conflict ${conflictFiles.size} | same ${sameCount}`);
+    if (missingFiles.size > 0) {
+      const r = await writeFiles2(projectRoot, missingFiles, { force: true, yes: true });
+      console.log(`  missing: \u65B0\u5EFA ${r.created}`);
+    }
+    if (conflictFiles.size > 0) {
+      const sel = await selectFiles(projectRoot, conflictFiles);
+      if (sel.size > 0) {
+        const r = await writeFiles2(projectRoot, sel, { force: true, yes: true });
+        console.log(`  conflict: \u8986\u76D6 ${r.overwritten}, \u8DF3\u8FC7 ${conflictFiles.size - sel.size}`);
+      } else {
+        console.log(`  conflict: \u7528\u6237\u53D6\u6D88\uFF0C${conflictFiles.size} \u4E2A\u6587\u4EF6\u672A\u5199\u5165`);
+      }
+    }
+    if (missingFiles.size === 0 && conflictFiles.size === 0) {
+      console.log(SYNC_CONFIG.PROMPT_PATCH_DONE);
+    }
+    saveHashFile(projectRoot, magicDir, new Map([...missingFiles, ...conflictFiles]));
+    saveVersionFile(projectRoot, magicDir, npmVersion);
+    return;
+  }
   const missing = /* @__PURE__ */ new Map();
   for (const [relPath, content] of allFiles) {
     if (!existsSync7(resolve6(projectRoot, relPath))) {
@@ -1047,7 +1194,7 @@ async function syncCommand(options = {}) {
     }
   }
   if (missing.size === 0) {
-    console.log("\u6240\u6709 ADD \u6A21\u677F\u6587\u4EF6\u5DF2\u5C31\u4F4D\u3002");
+    console.log(SYNC_CONFIG.PROMPT_FULL);
     return;
   }
   let filesToWrite = missing;
@@ -1091,11 +1238,11 @@ async function statusCommand() {
 
 // src/cli/index.ts
 var { version } = JSON.parse(
-  readFileSync6(new URL("../package.json", import.meta.url), "utf-8")
+  readFileSync7(new URL("../package.json", import.meta.url), "utf-8")
 );
 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").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").action(initCommand);
-program.command("sync").description("\u589E\u91CF\u540C\u6B65\u7F3A\u5931\u6587\u4EF6").option("--adapter <type>", "\u76EE\u6807 IDE: claude | qoder | vscode").option("-i, --interactive", "\u4EA4\u4E92\u5F0F\u9009\u62E9\u8981\u540C\u6B65\u7684\u6587\u4EF6").action(syncCommand);
+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").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").action(syncCommand);
 program.command("status").description("\u68C0\u67E5 ADD \u6A21\u677F\u5B8C\u6574\u6027").action(statusCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-coder",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "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": {
@@ -32,25 +32,26 @@
     "vscode",
     "mcp",
     "workflow",
-    "codein2027"
+    "codein2027",
+    "裁决层",
+    "caijuehub"
   ],
   "author": "xiaomingming",
   "email": "wujixmm@gmail.com",
   "license": "AGPL-3.0-only",
   "dependencies": {
+    "@modelcontextprotocol/server": "2.0.0-beta.5",
     "commander": "^13.1.0",
     "smol-toml": "^1.7.0",
-    "zod": "^3.24.0"
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
     "@prisma/adapter-libsql": "^7.0.0",
     "@prisma/adapter-pg": "^7.0.0",
     "@prisma/client": "^7.0.0",
     "dotenv": "*",
     "prisma": "^7.0.0",
-    "tsx": "*",
-    "zod": "^3.24.0"
+    "tsx": ">=4"
   },
   "peerDependenciesMeta": {
     "@prisma/client": {
@@ -59,12 +60,6 @@
     "prisma": {
       "optional": false
     },
-    "@modelcontextprotocol/sdk": {
-      "optional": false
-    },
-    "zod": {
-      "optional": false
-    },
     "dotenv": {
       "optional": false
     },
@@ -96,6 +91,8 @@
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
     "generate": "tsx src/caijuehub/transcribe.ts",
+    "podman-add-coder-up": "podman-compose --env-file .env.development -f podman-compose.add.yml up -d",
+    "podman-add-coder-down": "podman-compose --env-file .env.development -f podman-compose.add.yml down",
     "test": "vitest run"
   }
 }