@andyqiu/codeforge 0.5.19 → 0.5.20

package/dist/index.js

@@ -1069,17 +1069,17 @@ var require_visit = __commonJS((exports) => {
   visit.BREAK = BREAK;
   visit.SKIP = SKIP;
   visit.REMOVE = REMOVE;
-  function visit_(key, node, visitor, path18) {
-    const ctrl = callVisitor(key, node, visitor, path18);
+  function visit_(key, node, visitor, path19) {
+    const ctrl = callVisitor(key, node, visitor, path19);
     if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-      replaceNode(key, path18, ctrl);
-      return visit_(key, ctrl, visitor, path18);
+      replaceNode(key, path19, ctrl);
+      return visit_(key, ctrl, visitor, path19);
     }
     if (typeof ctrl !== "symbol") {
       if (identity.isCollection(node)) {
-        path18 = Object.freeze(path18.concat(node));
+        path19 = Object.freeze(path19.concat(node));
         for (let i = 0;i < node.items.length; ++i) {
-          const ci = visit_(i, node.items[i], visitor, path18);
+          const ci = visit_(i, node.items[i], visitor, path19);
           if (typeof ci === "number")
             i = ci - 1;
           else if (ci === BREAK)
@@ -1090,13 +1090,13 @@ var require_visit = __commonJS((exports) => {
           }
         }
       } else if (identity.isPair(node)) {
-        path18 = Object.freeze(path18.concat(node));
-        const ck = visit_("key", node.key, visitor, path18);
+        path19 = Object.freeze(path19.concat(node));
+        const ck = visit_("key", node.key, visitor, path19);
         if (ck === BREAK)
           return BREAK;
         else if (ck === REMOVE)
           node.key = null;
-        const cv = visit_("value", node.value, visitor, path18);
+        const cv = visit_("value", node.value, visitor, path19);
         if (cv === BREAK)
           return BREAK;
         else if (cv === REMOVE)
@@ -1117,17 +1117,17 @@ var require_visit = __commonJS((exports) => {
   visitAsync.BREAK = BREAK;
   visitAsync.SKIP = SKIP;
   visitAsync.REMOVE = REMOVE;
-  async function visitAsync_(key, node, visitor, path18) {
-    const ctrl = await callVisitor(key, node, visitor, path18);
+  async function visitAsync_(key, node, visitor, path19) {
+    const ctrl = await callVisitor(key, node, visitor, path19);
     if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-      replaceNode(key, path18, ctrl);
-      return visitAsync_(key, ctrl, visitor, path18);
+      replaceNode(key, path19, ctrl);
+      return visitAsync_(key, ctrl, visitor, path19);
     }
     if (typeof ctrl !== "symbol") {
       if (identity.isCollection(node)) {
-        path18 = Object.freeze(path18.concat(node));
+        path19 = Object.freeze(path19.concat(node));
         for (let i = 0;i < node.items.length; ++i) {
-          const ci = await visitAsync_(i, node.items[i], visitor, path18);
+          const ci = await visitAsync_(i, node.items[i], visitor, path19);
           if (typeof ci === "number")
             i = ci - 1;
           else if (ci === BREAK)
@@ -1138,13 +1138,13 @@ var require_visit = __commonJS((exports) => {
           }
         }
       } else if (identity.isPair(node)) {
-        path18 = Object.freeze(path18.concat(node));
-        const ck = await visitAsync_("key", node.key, visitor, path18);
+        path19 = Object.freeze(path19.concat(node));
+        const ck = await visitAsync_("key", node.key, visitor, path19);
         if (ck === BREAK)
           return BREAK;
         else if (ck === REMOVE)
           node.key = null;
-        const cv = await visitAsync_("value", node.value, visitor, path18);
+        const cv = await visitAsync_("value", node.value, visitor, path19);
         if (cv === BREAK)
           return BREAK;
         else if (cv === REMOVE)
@@ -1171,23 +1171,23 @@ var require_visit = __commonJS((exports) => {
     }
     return visitor;
   }
-  function callVisitor(key, node, visitor, path18) {
+  function callVisitor(key, node, visitor, path19) {
     if (typeof visitor === "function")
-      return visitor(key, node, path18);
+      return visitor(key, node, path19);
     if (identity.isMap(node))
-      return visitor.Map?.(key, node, path18);
+      return visitor.Map?.(key, node, path19);
     if (identity.isSeq(node))
-      return visitor.Seq?.(key, node, path18);
+      return visitor.Seq?.(key, node, path19);
     if (identity.isPair(node))
-      return visitor.Pair?.(key, node, path18);
+      return visitor.Pair?.(key, node, path19);
     if (identity.isScalar(node))
-      return visitor.Scalar?.(key, node, path18);
+      return visitor.Scalar?.(key, node, path19);
     if (identity.isAlias(node))
-      return visitor.Alias?.(key, node, path18);
+      return visitor.Alias?.(key, node, path19);
     return;
   }
-  function replaceNode(key, path18, node) {
-    const parent = path18[path18.length - 1];
+  function replaceNode(key, path19, node) {
+    const parent = path19[path19.length - 1];
     if (identity.isCollection(parent)) {
       parent.items[key] = node;
     } else if (identity.isPair(parent)) {
@@ -1746,10 +1746,10 @@ var require_Collection = __commonJS((exports) => {
   var createNode = require_createNode();
   var identity = require_identity();
   var Node = require_Node();
-  function collectionFromPath(schema, path18, value) {
+  function collectionFromPath(schema, path19, value) {
     let v = value;
-    for (let i = path18.length - 1;i >= 0; --i) {
-      const k = path18[i];
+    for (let i = path19.length - 1;i >= 0; --i) {
+      const k = path19[i];
       if (typeof k === "number" && Number.isInteger(k) && k >= 0) {
         const a = [];
         a[k] = v;
@@ -1768,7 +1768,7 @@ var require_Collection = __commonJS((exports) => {
       sourceObjects: new Map
     });
   }
-  var isEmptyPath = (path18) => path18 == null || typeof path18 === "object" && !!path18[Symbol.iterator]().next().done;
+  var isEmptyPath = (path19) => path19 == null || typeof path19 === "object" && !!path19[Symbol.iterator]().next().done;
 
   class Collection extends Node.NodeBase {
     constructor(type, schema) {
@@ -1789,11 +1789,11 @@ var require_Collection = __commonJS((exports) => {
         copy.range = this.range.slice();
       return copy;
     }
-    addIn(path18, value) {
-      if (isEmptyPath(path18))
+    addIn(path19, value) {
+      if (isEmptyPath(path19))
         this.add(value);
       else {
-        const [key, ...rest] = path18;
+        const [key, ...rest] = path19;
         const node = this.get(key, true);
         if (identity.isCollection(node))
           node.addIn(rest, value);
@@ -1803,8 +1803,8 @@ var require_Collection = __commonJS((exports) => {
           throw new Error(`Expected YAML collection at ${key}. Remaining path: ${rest}`);
       }
     }
-    deleteIn(path18) {
-      const [key, ...rest] = path18;
+    deleteIn(path19) {
+      const [key, ...rest] = path19;
       if (rest.length === 0)
         return this.delete(key);
       const node = this.get(key, true);
@@ -1813,8 +1813,8 @@ var require_Collection = __commonJS((exports) => {
       else
         throw new Error(`Expected YAML collection at ${key}. Remaining path: ${rest}`);
     }
-    getIn(path18, keepScalar) {
-      const [key, ...rest] = path18;
+    getIn(path19, keepScalar) {
+      const [key, ...rest] = path19;
       const node = this.get(key, true);
       if (rest.length === 0)
         return !keepScalar && identity.isScalar(node) ? node.value : node;
@@ -1829,15 +1829,15 @@ var require_Collection = __commonJS((exports) => {
         return n == null || allowScalar && identity.isScalar(n) && n.value == null && !n.commentBefore && !n.comment && !n.tag;
       });
     }
-    hasIn(path18) {
-      const [key, ...rest] = path18;
+    hasIn(path19) {
+      const [key, ...rest] = path19;
       if (rest.length === 0)
         return this.has(key);
       const node = this.get(key, true);
       return identity.isCollection(node) ? node.hasIn(rest) : false;
     }
-    setIn(path18, value) {
-      const [key, ...rest] = path18;
+    setIn(path19, value) {
+      const [key, ...rest] = path19;
       if (rest.length === 0) {
         this.set(key, value);
       } else {
@@ -4230,9 +4230,9 @@ var require_Document = __commonJS((exports) => {
       if (assertCollection(this.contents))
         this.contents.add(value);
     }
-    addIn(path18, value) {
+    addIn(path19, value) {
       if (assertCollection(this.contents))
-        this.contents.addIn(path18, value);
+        this.contents.addIn(path19, value);
     }
     createAlias(node, name) {
       if (!node.anchor) {
@@ -4281,30 +4281,30 @@ var require_Document = __commonJS((exports) => {
     delete(key) {
       return assertCollection(this.contents) ? this.contents.delete(key) : false;
     }
-    deleteIn(path18) {
-      if (Collection.isEmptyPath(path18)) {
+    deleteIn(path19) {
+      if (Collection.isEmptyPath(path19)) {
         if (this.contents == null)
           return false;
         this.contents = null;
         return true;
       }
-      return assertCollection(this.contents) ? this.contents.deleteIn(path18) : false;
+      return assertCollection(this.contents) ? this.contents.deleteIn(path19) : false;
     }
     get(key, keepScalar) {
       return identity.isCollection(this.contents) ? this.contents.get(key, keepScalar) : undefined;
     }
-    getIn(path18, keepScalar) {
-      if (Collection.isEmptyPath(path18))
+    getIn(path19, keepScalar) {
+      if (Collection.isEmptyPath(path19))
         return !keepScalar && identity.isScalar(this.contents) ? this.contents.value : this.contents;
-      return identity.isCollection(this.contents) ? this.contents.getIn(path18, keepScalar) : undefined;
+      return identity.isCollection(this.contents) ? this.contents.getIn(path19, keepScalar) : undefined;
     }
     has(key) {
       return identity.isCollection(this.contents) ? this.contents.has(key) : false;
     }
-    hasIn(path18) {
-      if (Collection.isEmptyPath(path18))
+    hasIn(path19) {
+      if (Collection.isEmptyPath(path19))
         return this.contents !== undefined;
-      return identity.isCollection(this.contents) ? this.contents.hasIn(path18) : false;
+      return identity.isCollection(this.contents) ? this.contents.hasIn(path19) : false;
     }
     set(key, value) {
       if (this.contents == null) {
@@ -4313,13 +4313,13 @@ var require_Document = __commonJS((exports) => {
         this.contents.set(key, value);
       }
     }
-    setIn(path18, value) {
-      if (Collection.isEmptyPath(path18)) {
+    setIn(path19, value) {
+      if (Collection.isEmptyPath(path19)) {
         this.contents = value;
       } else if (this.contents == null) {
-        this.contents = Collection.collectionFromPath(this.schema, Array.from(path18), value);
+        this.contents = Collection.collectionFromPath(this.schema, Array.from(path19), value);
       } else if (assertCollection(this.contents)) {
-        this.contents.setIn(path18, value);
+        this.contents.setIn(path19, value);
       }
     }
     setSchema(version, options = {}) {
@@ -6214,9 +6214,9 @@ var require_cst_visit = __commonJS((exports) => {
   visit.BREAK = BREAK;
   visit.SKIP = SKIP;
   visit.REMOVE = REMOVE;
-  visit.itemAtPath = (cst, path18) => {
+  visit.itemAtPath = (cst, path19) => {
     let item = cst;
-    for (const [field, index] of path18) {
+    for (const [field, index] of path19) {
       const tok = item?.[field];
       if (tok && "items" in tok) {
         item = tok.items[index];
@@ -6225,23 +6225,23 @@ var require_cst_visit = __commonJS((exports) => {
     }
     return item;
   };
-  visit.parentCollection = (cst, path18) => {
-    const parent = visit.itemAtPath(cst, path18.slice(0, -1));
-    const field = path18[path18.length - 1][0];
+  visit.parentCollection = (cst, path19) => {
+    const parent = visit.itemAtPath(cst, path19.slice(0, -1));
+    const field = path19[path19.length - 1][0];
     const coll = parent?.[field];
     if (coll && "items" in coll)
       return coll;
     throw new Error("Parent collection not found");
   };
-  function _visit(path18, item, visitor) {
-    let ctrl = visitor(item, path18);
+  function _visit(path19, item, visitor) {
+    let ctrl = visitor(item, path19);
     if (typeof ctrl === "symbol")
       return ctrl;
     for (const field of ["key", "value"]) {
       const token = item[field];
       if (token && "items" in token) {
         for (let i = 0;i < token.items.length; ++i) {
-          const ci = _visit(Object.freeze(path18.concat([[field, i]])), token.items[i], visitor);
+          const ci = _visit(Object.freeze(path19.concat([[field, i]])), token.items[i], visitor);
           if (typeof ci === "number")
             i = ci - 1;
           else if (ci === BREAK)
@@ -6252,10 +6252,10 @@ var require_cst_visit = __commonJS((exports) => {
           }
         }
         if (typeof ctrl === "function" && field === "key")
-          ctrl = ctrl(item, path18);
+          ctrl = ctrl(item, path19);
       }
     }
-    return typeof ctrl === "function" ? ctrl(item, path18) : ctrl;
+    return typeof ctrl === "function" ? ctrl(item, path19) : ctrl;
   }
   exports.visit = visit;
 });
@@ -8011,11 +8011,11 @@ function shouldStopByStuck(history, cfg) {
 async function withTimeout4(p, timeoutMs) {
   if (timeoutMs <= 0)
     return await p;
-  return await new Promise((resolve16, reject) => {
+  return await new Promise((resolve17, reject) => {
     const timer = setTimeout(() => reject(new Error(`timeout after ${timeoutMs}ms`)), timeoutMs);
     Promise.resolve(p).then((v) => {
       clearTimeout(timer);
-      resolve16(v);
+      resolve17(v);
     }, (err) => {
       clearTimeout(timer);
       reject(err);
@@ -14575,6 +14575,292 @@ async function execute28(input) {
     };
   }
 }
+// tools/adr-init.ts
+import { z as z30 } from "zod";
+
+// lib/adr-init.ts
+import { spawnSync } from "node:child_process";
+import { existsSync as existsSync4, promises as fsp } from "node:fs";
+import * as path16 from "node:path";
+import * as url from "node:url";
+function resolveAssetsRoot() {
+  const here = path16.dirname(url.fileURLToPath(import.meta.url));
+  let dir = here;
+  for (let i = 0;i < 6; i++) {
+    if (existsSync4(path16.join(dir, "package.json")) && existsSync4(path16.join(dir, "assets", "adr-init"))) {
+      return path16.join(dir, "assets", "adr-init");
+    }
+    const parent = path16.dirname(dir);
+    if (parent === dir)
+      break;
+    dir = parent;
+  }
+  throw new Error(`assets/adr-init/ 未找到（从 ${here} 上溯 6 层）；` + `如果是 npm 安装请检查 package.json "files" 字段是否包含 "assets/"`);
+}
+function isGitRepo2(cwd) {
+  try {
+    const r = spawnSync("git", ["rev-parse", "--show-toplevel"], {
+      cwd,
+      stdio: "pipe",
+      encoding: "utf8"
+    });
+    return r.status === 0;
+  } catch {
+    return false;
+  }
+}
+function runGitConfigHooksPath(cwd) {
+  try {
+    const r = spawnSync("git", ["config", "core.hooksPath", ".githooks"], {
+      cwd,
+      stdio: "pipe",
+      encoding: "utf8"
+    });
+    if (r.status === 0)
+      return { ok: true };
+    return { ok: false, error: (r.stderr ?? "").trim() || `exit=${r.status}` };
+  } catch (e) {
+    return { ok: false, error: e instanceof Error ? e.message : String(e) };
+  }
+}
+async function runAdrInit(opts = {}) {
+  const cwd = path16.resolve(opts.cwd ?? process.cwd());
+  const force = !!opts.force;
+  const dryRun = !!opts.dryRun;
+  const writePrepare = !!opts.writePrepare;
+  const installPrePush = opts.installPrePush !== false;
+  const result = {
+    ok: true,
+    wrote: [],
+    skipped: [],
+    backedUp: [],
+    suggestions: [],
+    warnings: [],
+    dryRun
+  };
+  if (!isGitRepo2(cwd)) {
+    result.ok = false;
+    result.reason = "not_git_repo";
+    result.warnings.push(`${cwd} 不是 git 仓库；adr-init 需要 git 才能下发 hooks`);
+    return result;
+  }
+  let assetsRoot;
+  try {
+    assetsRoot = resolveAssetsRoot();
+  } catch (e) {
+    result.ok = false;
+    result.reason = "assets_not_found";
+    result.warnings.push(e instanceof Error ? e.message : String(e));
+    return result;
+  }
+  const ts = new Date().toISOString().replace(/[:.]/g, "-");
+  const plan = [
+    { src: "scripts/adr-check.mjs", dst: "scripts/adr-check.mjs" },
+    { src: "scripts/adr-index-sync.mjs", dst: "scripts/adr-index-sync.mjs" },
+    { src: "docs/adr/README.md", dst: "docs/adr/README.md" },
+    { src: "docs/adr/template.md", dst: "docs/adr/template.md" },
+    {
+      src: ".github/pull_request_template.md",
+      dst: ".github/pull_request_template.md"
+    },
+    { src: "githooks/pre-commit.sh", dst: ".githooks/pre-commit", chmod: 493 }
+  ];
+  if (installPrePush) {
+    plan.push({
+      src: "githooks/pre-push.sh",
+      dst: ".githooks/pre-push",
+      chmod: 493
+    });
+  }
+  for (const item of plan) {
+    const srcAbs = path16.join(assetsRoot, item.src);
+    const dstAbs = path16.join(cwd, item.dst);
+    if (!existsSync4(srcAbs)) {
+      result.warnings.push(`资产缺失：${item.src}（跳过 ${item.dst}）`);
+      continue;
+    }
+    if (existsSync4(dstAbs)) {
+      if (!force) {
+        result.skipped.push(item.dst);
+        continue;
+      }
+      const bakRel = `${item.dst}.bak.${ts}`;
+      if (!dryRun) {
+        try {
+          await fsp.copyFile(dstAbs, path16.join(cwd, bakRel));
+        } catch (e) {
+          result.ok = false;
+          result.reason = "io_error";
+          result.warnings.push(`备份 ${item.dst} 失败：${e instanceof Error ? e.message : String(e)}`);
+          return result;
+        }
+      }
+      result.backedUp.push(bakRel);
+    }
+    if (!dryRun) {
+      try {
+        await fsp.mkdir(path16.dirname(dstAbs), { recursive: true });
+        await fsp.copyFile(srcAbs, dstAbs);
+        if (item.chmod !== undefined) {
+          try {
+            await fsp.chmod(dstAbs, item.chmod);
+          } catch (e) {
+            if (process.platform !== "win32") {
+              result.warnings.push(`chmod ${item.dst} 失败：${e instanceof Error ? e.message : String(e)}`);
+            }
+          }
+        }
+      } catch (e) {
+        result.ok = false;
+        result.reason = "io_error";
+        result.warnings.push(`写入 ${item.dst} 失败：${e instanceof Error ? e.message : String(e)}`);
+        return result;
+      }
+    }
+    result.wrote.push(item.dst);
+  }
+  if (!dryRun) {
+    const r = runGitConfigHooksPath(cwd);
+    if (r.ok) {
+      result.suggestions.push("已运行：git config core.hooksPath .githooks（hooks 已启用）");
+    } else {
+      result.warnings.push(`自动启用 hooks 失败：${r.error ?? "未知错误"}；请手动执行 git config core.hooksPath .githooks`);
+    }
+  } else {
+    result.suggestions.push("[dry-run] 将运行：git config core.hooksPath .githooks");
+  }
+  const pkgPath = path16.join(cwd, "package.json");
+  const isNpm = existsSync4(pkgPath);
+  if (isNpm) {
+    if (writePrepare) {
+      try {
+        const raw = await fsp.readFile(pkgPath, "utf8");
+        const pkg = JSON.parse(raw);
+        const existing = (pkg.scripts && typeof pkg.scripts.prepare === "string" ? pkg.scripts.prepare : "") ?? "";
+        const target = "git config core.hooksPath .githooks";
+        if (existing.includes(target)) {
+          result.suggestions.push(`package.json scripts.prepare 已含目标命令，无需改动`);
+        } else {
+          const bakRel = `package.json.bak.${ts}`;
+          if (!dryRun) {
+            try {
+              await fsp.copyFile(pkgPath, path16.join(cwd, bakRel));
+            } catch (e) {
+              result.warnings.push(`备份 package.json 失败：${e instanceof Error ? e.message : String(e)}`);
+            }
+          }
+          result.backedUp.push(bakRel);
+          if (existing.includes("husky")) {
+            result.warnings.push(`package.json scripts.prepare 已含 husky，仍合并写入；如有问题可回滚 ${bakRel}`);
+          }
+          const merged = existing ? `${existing} && ${target}` : target;
+          pkg.scripts = { ...pkg.scripts ?? {}, prepare: merged };
+          if (!dryRun) {
+            try {
+              await fsp.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + `
+`, "utf8");
+            } catch (e) {
+              result.ok = false;
+              result.reason = "io_error";
+              result.warnings.push(`写入 package.json 失败：${e instanceof Error ? e.message : String(e)}`);
+              return result;
+            }
+          }
+          result.wrote.push("package.json");
+        }
+      } catch (e) {
+        result.warnings.push(`读取 package.json 失败：${e instanceof Error ? e.message : String(e)}`);
+      }
+    } else {
+      result.suggestions.push(`(可选) 在 package.json scripts.prepare 追加："git config core.hooksPath .githooks"，` + `或下次跑 codeforge adr-init --write-prepare 自动合并（写前自动 backup package.json）`);
+    }
+  } else {
+    result.suggestions.push("非 npm 项目：请在 README / AGENTS.md 提醒首次 clone 后跑 git config core.hooksPath .githooks");
+  }
+  return result;
+}
+
+// tools/adr-init.ts
+var description29 = [
+  "把 CodeForge 的 ADR 体系（adr-check / adr-index-sync / pre-commit / pre-push / docs/adr 模板 / PR 模板）一键下发到当前 git 项目。",
+  "**何时调用**：",
+  "- 用户说「给这个项目加 ADR / 装一下 ADR 检查 / 同步一下 ADR 模板」",
+  "- 新项目 init 流程中希望把决策记录体系一起带上",
+  "**特点**：零 npm 依赖（用 git config core.hooksPath 而非 husky）；跟仓库走（提交 .githooks/ 进 git）；幂等（默认 skip 已存在文件，--force 自动 .bak.<ts> 备份）",
+  "**何时不需要**：当前项目已有完整的 ADR + hooks（默认 skip 行为会保护，但调用本身浪费一次 IO）"
+].join(`
+`);
+var ArgsSchema29 = z30.object({
+  cwd: z30.string().optional().describe("目标项目根目录，默认 process.cwd()；通常无需传"),
+  force: z30.boolean().optional().describe("已存在文件覆盖；覆盖前自动 .bak.<ts> 备份"),
+  dryRun: z30.boolean().optional().describe("只输出将要执行的写入计划，不实际写盘"),
+  writePrepare: z30.boolean().optional().describe("（npm 项目）自动合并 git config core.hooksPath 到 package.json scripts.prepare；写前自动 backup package.json；默认只建议不写"),
+  installPrePush: z30.boolean().optional().describe("是否同时生成 .githooks/pre-push hook，默认 true")
+});
+function summarize(r) {
+  const lines = [];
+  lines.push(`# adr-init 执行结果${r.dryRun ? "（dry-run）" : ""}`);
+  if (r.wrote.length > 0) {
+    lines.push(`
+## 写入（${r.wrote.length}）`);
+    for (const f of r.wrote)
+      lines.push(`- ${f}`);
+  }
+  if (r.skipped.length > 0) {
+    lines.push(`
+## 跳过 / 已存在（${r.skipped.length}） — 加 --force 覆盖`);
+    for (const f of r.skipped)
+      lines.push(`- ${f}`);
+  }
+  if (r.backedUp.length > 0) {
+    lines.push(`
+## 备份（${r.backedUp.length}）`);
+    for (const f of r.backedUp)
+      lines.push(`- ${f}`);
+  }
+  if (r.suggestions.length > 0) {
+    lines.push(`
+## 建议`);
+    for (const s of r.suggestions)
+      lines.push(`- ${s}`);
+  }
+  if (r.warnings.length > 0) {
+    lines.push(`
+## 警告`);
+    for (const w of r.warnings)
+      lines.push(`- ${w}`);
+  }
+  return lines.join(`
+`);
+}
+async function execute29(input) {
+  const parsed = ArgsSchema29.safeParse(input);
+  if (!parsed.success) {
+    return {
+      ok: false,
+      reason: "invalid_input",
+      message: parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")
+    };
+  }
+  try {
+    const result = await runAdrInit(parsed.data);
+    if (!result.ok) {
+      return {
+        ok: false,
+        reason: result.reason ?? "io_error",
+        message: result.warnings.join("; ") || "adr-init 执行失败",
+        result
+      };
+    }
+    return { ok: true, result, summary: summarize(result) };
+  } catch (e) {
+    return {
+      ok: false,
+      reason: "io_error",
+      message: e instanceof Error ? e.message : String(e)
+    };
+  }
+}
 // lib/opencode-runner.ts
 function makeOpencodeRunner(opts) {
   const log4 = opts.log ?? (() => {});
@@ -14732,20 +15018,20 @@ async function withTimeout3(p, ms, signal) {
       throw err;
     }
   }
-  return await new Promise((resolve13, reject) => {
+  return await new Promise((resolve14, reject) => {
     let settled = false;
     const timer = setTimeout(() => {
       if (settled)
         return;
       settled = true;
-      resolve13({ kind: "timeout" });
+      resolve14({ kind: "timeout" });
     }, ms);
     const onAbort = () => {
       if (settled)
         return;
       settled = true;
       clearTimeout(timer);
-      resolve13({ kind: "aborted" });
+      resolve14({ kind: "aborted" });
     };
     signal?.addEventListener("abort", onAbort, { once: true });
     p.then((value) => {
@@ -14754,7 +15040,7 @@ async function withTimeout3(p, ms, signal) {
       settled = true;
       clearTimeout(timer);
       signal?.removeEventListener("abort", onAbort);
-      resolve13({ kind: "ok", value });
+      resolve14({ kind: "ok", value });
     }, (err) => {
       if (settled)
         return;
@@ -14837,18 +15123,18 @@ init_decision_parser();
 // lib/parent-map-store.ts
 init_runtime_paths();
 import { promises as fs13 } from "node:fs";
-import * as path16 from "node:path";
+import * as path17 from "node:path";
 var PARENT_MAP_VERSION = 1;
 var PARENT_MAP_LOCK_TIMEOUT_MS = 2000;
 var PARENT_MAP_MAX_ENTRIES = 256;
 function parentMapDir(mainRoot) {
-  return path16.join(runtimeDir(path16.resolve(mainRoot), { ensure: false }), "session-worktrees");
+  return path17.join(runtimeDir(path17.resolve(mainRoot), { ensure: false }), "session-worktrees");
 }
 function parentMapPath(mainRoot) {
-  return path16.join(parentMapDir(mainRoot), "parent-map.json");
+  return path17.join(parentMapDir(mainRoot), "parent-map.json");
 }
 function parentMapLockPath(mainRoot) {
-  return path16.join(parentMapDir(mainRoot), "parent-map.lock");
+  return path17.join(parentMapDir(mainRoot), "parent-map.lock");
 }
 async function readParentMapFile(mainRoot) {
   const file = parentMapPath(mainRoot);
@@ -14868,7 +15154,7 @@ async function readParentMapFile(mainRoot) {
 }
 async function writeParentMapFile(mainRoot, payload) {
   const file = parentMapPath(mainRoot);
-  await fs13.mkdir(path16.dirname(file), { recursive: true });
+  await fs13.mkdir(path17.dirname(file), { recursive: true });
   const tmp = `${file}.tmp-${process.pid}-${Date.now()}`;
   await fs13.writeFile(tmp, JSON.stringify(payload, null, 2), "utf8");
   await fs13.rename(tmp, file);
@@ -14903,7 +15189,7 @@ async function loadParentMap(mainRoot) {
 }
 async function mutateParentMap(mainRoot, mutator, opts = {}) {
   const lockPath = parentMapLockPath(mainRoot);
-  await fs13.mkdir(path16.dirname(lockPath), { recursive: true });
+  await fs13.mkdir(path17.dirname(lockPath), { recursive: true });
   const lockOpts = {
     timeoutMs: opts.timeoutMs ?? PARENT_MAP_LOCK_TIMEOUT_MS,
     ...opts
@@ -14922,7 +15208,7 @@ async function appendParentEntry(mainRoot, childID, parentID, ts, opts = {}) {
   if (!childID || !parentID)
     return;
   const lockPath = parentMapLockPath(mainRoot);
-  await fs13.mkdir(path16.dirname(lockPath), { recursive: true });
+  await fs13.mkdir(path17.dirname(lockPath), { recursive: true });
   const lockOpts = {
     timeoutMs: opts.timeoutMs ?? PARENT_MAP_LOCK_TIMEOUT_MS,
     ...opts
@@ -15170,7 +15456,7 @@ async function raceAbortTimeout(p, signal, timeoutMs, label) {
     e.name = "AbortError";
     throw e;
   }
-  return await new Promise((resolve14, reject) => {
+  return await new Promise((resolve15, reject) => {
     let settled = false;
     const timer = setTimeout(() => {
       if (settled)
@@ -15195,7 +15481,7 @@ async function raceAbortTimeout(p, signal, timeoutMs, label) {
       settled = true;
       clearTimeout(timer);
       signal?.removeEventListener("abort", onAbort);
-      resolve14(v);
+      resolve15(v);
     }, (e) => {
       if (settled)
         return;
@@ -15256,7 +15542,7 @@ function clip4(s, max) {
 
 // lib/codeforge-runtime.ts
 import { promises as fs14 } from "node:fs";
-import * as path17 from "node:path";
+import * as path18 from "node:path";
 var DEFAULT_RUNTIME = {
   autonomy: {
     downgrade_on_risky: true
@@ -15299,7 +15585,7 @@ function loadRuntimeSync(opts = {}) {
 }
 async function loadRuntime(opts = {}) {
   const root = opts.root ?? process.cwd();
-  const abs = path17.resolve(root, opts.file ?? CONFIG_FILE);
+  const abs = path18.resolve(root, opts.file ?? CONFIG_FILE);
   let raw;
   try {
     raw = await fs14.readFile(abs, "utf8");
@@ -15583,7 +15869,7 @@ var toolHeartbeatServer = async (ctx) => {
 var handler7 = toolHeartbeatServer;
 
 // plugins/codeforge-tools.ts
-var z30 = tool.schema;
+var z31 = tool.schema;
 var PLUGIN_NAME8 = "codeforge-tools";
 logLifecycle(PLUGIN_NAME8, "import");
 function wrap(output, metadata) {
@@ -15630,15 +15916,15 @@ function buildKhWriteTools() {
     add_knowledge: tool({
       description: description3,
       args: {
-        title: z30.string().min(2).max(60).describe("简短标题（2-60 字）"),
-        content: z30.string().min(10).describe("详细内容（Markdown，独立可理解）"),
-        category: z30.string().optional().describe("分类（可选，自动推断）"),
-        tags: z30.array(z30.string()).optional(),
-        relatedFiles: z30.array(z30.string()).optional(),
-        relatedCommit: z30.string().optional(),
-        relatedPR: z30.string().optional(),
-        scope: z30.string().optional(),
-        preConfirmed: z30.boolean().optional()
+        title: z31.string().min(2).max(60).describe("简短标题（2-60 字）"),
+        content: z31.string().min(10).describe("详细内容（Markdown，独立可理解）"),
+        category: z31.string().optional().describe("分类（可选，自动推断）"),
+        tags: z31.array(z31.string()).optional(),
+        relatedFiles: z31.array(z31.string()).optional(),
+        relatedCommit: z31.string().optional(),
+        relatedPR: z31.string().optional(),
+        scope: z31.string().optional(),
+        preConfirmed: z31.boolean().optional()
       },
       async execute(args) {
         return await runSafe("add_knowledge", async () => {
@@ -15653,18 +15939,18 @@ function buildKhWriteTools() {
     upload_document: tool({
       description: description4,
       args: {
-        name: z30.string().min(1).describe("文件名（含扩展名）"),
-        content: z30.string().min(1).describe("文件完整内容"),
-        encoding: z30.enum(["utf8", "base64"]).optional(),
-        chunk_strategy: z30.enum(["auto", "heading", "fixed", "paragraph", "separator"]).optional(),
-        chunk_size: z30.number().int().optional(),
-        chunk_overlap: z30.number().int().optional(),
-        separator: z30.string().optional(),
-        distill: z30.boolean().optional(),
-        category: z30.string().optional(),
-        tags: z30.array(z30.string()).optional(),
-        scope: z30.string().optional(),
-        pre_confirmed: z30.boolean().optional()
+        name: z31.string().min(1).describe("文件名（含扩展名）"),
+        content: z31.string().min(1).describe("文件完整内容"),
+        encoding: z31.enum(["utf8", "base64"]).optional(),
+        chunk_strategy: z31.enum(["auto", "heading", "fixed", "paragraph", "separator"]).optional(),
+        chunk_size: z31.number().int().optional(),
+        chunk_overlap: z31.number().int().optional(),
+        separator: z31.string().optional(),
+        distill: z31.boolean().optional(),
+        category: z31.string().optional(),
+        tags: z31.array(z31.string()).optional(),
+        scope: z31.string().optional(),
+        pre_confirmed: z31.boolean().optional()
       },
       async execute(args) {
         return await runSafeTracked("upload_document", async () => {
@@ -15679,16 +15965,16 @@ function buildKhWriteTools() {
     upload_document_from_url: tool({
       description: description5,
       args: {
-        url: z30.string().min(1).describe("HTTP(s) URL"),
-        chunk_strategy: z30.enum(["auto", "heading", "fixed", "paragraph", "separator"]).optional(),
-        chunk_size: z30.number().int().optional(),
-        chunk_overlap: z30.number().int().optional(),
-        separator: z30.string().optional(),
-        distill: z30.boolean().optional(),
-        category: z30.string().optional(),
-        tags: z30.array(z30.string()).optional(),
-        scope: z30.string().optional(),
-        pre_confirmed: z30.boolean().optional()
+        url: z31.string().min(1).describe("HTTP(s) URL"),
+        chunk_strategy: z31.enum(["auto", "heading", "fixed", "paragraph", "separator"]).optional(),
+        chunk_size: z31.number().int().optional(),
+        chunk_overlap: z31.number().int().optional(),
+        separator: z31.string().optional(),
+        distill: z31.boolean().optional(),
+        category: z31.string().optional(),
+        tags: z31.array(z31.string()).optional(),
+        scope: z31.string().optional(),
+        pre_confirmed: z31.boolean().optional()
       },
       async execute(args) {
         return await runSafeTracked("upload_document_from_url", async () => {
@@ -15703,11 +15989,11 @@ function buildKhWriteTools() {
     update_knowledge: tool({
       description: description6,
       args: {
-        knowledgeId: z30.string().min(1).describe("知识 ID（从 smart_search 获取）"),
-        appendContent: z30.string().optional(),
-        replaceContent: z30.string().optional(),
-        additionalTags: z30.array(z30.string()).optional(),
-        category: z30.string().optional()
+        knowledgeId: z31.string().min(1).describe("知识 ID（从 smart_search 获取）"),
+        appendContent: z31.string().optional(),
+        replaceContent: z31.string().optional(),
+        additionalTags: z31.array(z31.string()).optional(),
+        category: z31.string().optional()
       },
       async execute(args) {
         return await runSafe("update_knowledge", async () => {
@@ -15722,8 +16008,8 @@ function buildKhWriteTools() {
     flag_outdated: tool({
       description: description7,
       args: {
-        knowledgeId: z30.string().min(1).describe("知识 ID"),
-        reason: z30.string().min(5).max(500).describe("过时原因简述")
+        knowledgeId: z31.string().min(1).describe("知识 ID"),
+        reason: z31.string().min(5).max(500).describe("过时原因简述")
       },
       async execute(args) {
         return await runSafe("flag_outdated", async () => {
@@ -15738,8 +16024,8 @@ function buildKhWriteTools() {
     delete_knowledge: tool({
       description: description8,
       args: {
-        knowledgeId: z30.string().min(1).describe("知识 ID"),
-        reason: z30.string().min(3).max(300).describe("删除原因（写入审计日志）")
+        knowledgeId: z31.string().min(1).describe("知识 ID"),
+        reason: z31.string().min(3).max(300).describe("删除原因（写入审计日志）")
       },
       async execute(args) {
         return await runSafe("delete_knowledge", async () => {
@@ -15754,9 +16040,9 @@ function buildKhWriteTools() {
     list_recent: tool({
       description: description9,
       args: {
-        days: z30.number().int().min(1).max(90).optional().describe("最近几天（默认 7）"),
-        limit: z30.number().int().min(1).max(50).optional().describe("返回条数（默认 10）"),
-        category: z30.string().optional()
+        days: z31.number().int().min(1).max(90).optional().describe("最近几天（默认 7）"),
+        limit: z31.number().int().min(1).max(50).optional().describe("返回条数（默认 10）"),
+        category: z31.string().optional()
       },
       async execute(args) {
         return await runSafe("list_recent", async () => {
@@ -15771,12 +16057,12 @@ function buildKhWriteTools() {
     update_working_memory: tool({
       description: description10,
       args: {
-        section: z30.string().min(1).describe("分区名（constraints / in_progress / topic:xxx 等）"),
-        items: z30.array(z30.object({
-          content: z30.string().min(1),
-          priority: z30.number().optional()
+        section: z31.string().min(1).describe("分区名（constraints / in_progress / topic:xxx 等）"),
+        items: z31.array(z31.object({
+          content: z31.string().min(1),
+          priority: z31.number().optional()
         })),
-        replace: z30.boolean().optional().describe("是否替换分区全部内容（默认 false=追加）")
+        replace: z31.boolean().optional().describe("是否替换分区全部内容（默认 false=追加）")
       },
       async execute(args) {
         return await runSafe("update_working_memory", async () => {
@@ -15791,7 +16077,7 @@ function buildKhWriteTools() {
     get_working_memory: tool({
       description: description11,
       args: {
-        section: z30.string().optional().describe("分区名；不传则返回全部")
+        section: z31.string().optional().describe("分区名；不传则返回全部")
       },
       async execute(args) {
         return await runSafe("get_working_memory", async () => {
@@ -15806,9 +16092,9 @@ function buildKhWriteTools() {
     update_user_preference: tool({
       description: description12,
       args: {
-        key: z30.string().min(1).max(64).describe("偏好键名（language / coding_style / signature 等）"),
-        value: z30.string().min(1).max(500).describe("偏好值"),
-        action: z30.enum(["set", "delete"]).optional()
+        key: z31.string().min(1).max(64).describe("偏好键名（language / coding_style / signature 等）"),
+        value: z31.string().min(1).max(500).describe("偏好值"),
+        action: z31.enum(["set", "delete"]).optional()
       },
       async execute(args) {
         return await runSafe("update_user_preference", async () => {
@@ -15823,9 +16109,9 @@ function buildKhWriteTools() {
     web_search: tool({
       description: description13,
       args: {
-        query: z30.string().min(1).describe("搜索词"),
-        limit: z30.number().int().min(1).max(10).optional(),
-        time_range: z30.enum(["", "day", "week", "month", "year"]).optional()
+        query: z31.string().min(1).describe("搜索词"),
+        limit: z31.number().int().min(1).max(10).optional(),
+        time_range: z31.enum(["", "day", "week", "month", "year"]).optional()
       },
       async execute(args) {
         return await runSafeTracked("web_search", async () => {
@@ -15840,11 +16126,11 @@ function buildKhWriteTools() {
     generate_image: tool({
       description: description14,
       args: {
-        prompt: z30.string().min(4).max(4000).describe("画面描述"),
-        n: z30.number().int().min(1).max(3).optional(),
-        size: z30.string().optional(),
-        transparent: z30.boolean().optional(),
-        alt: z30.string().optional()
+        prompt: z31.string().min(4).max(4000).describe("画面描述"),
+        n: z31.number().int().min(1).max(3).optional(),
+        size: z31.string().optional(),
+        transparent: z31.boolean().optional(),
+        alt: z31.string().optional()
       },
       async execute(args) {
         return await runSafeTracked("generate_image", async () => {
@@ -15863,7 +16149,7 @@ function buildBrowserTools() {
     browser_navigate: tool({
       description: description19,
       args: {
-        url: z30.string().min(1).describe("要打开的 URL；必须是 http(s)")
+        url: z31.string().min(1).describe("要打开的 URL；必须是 http(s)")
       },
       async execute(args) {
         return await runSafe("browser_navigate", async () => {
@@ -15878,7 +16164,7 @@ function buildBrowserTools() {
     browser_click: tool({
       description: description20,
       args: {
-        selector: z30.string().min(1).describe("CSS / Playwright locator，必须能唯一定位")
+        selector: z31.string().min(1).describe("CSS / Playwright locator，必须能唯一定位")
       },
       async execute(args) {
         return await runSafe("browser_click", async () => {
@@ -15893,8 +16179,8 @@ function buildBrowserTools() {
     browser_fill: tool({
       description: description21,
       args: {
-        selector: z30.string().min(1).describe("CSS / Playwright locator"),
-        value: z30.string().describe("要填入的文本；原样写入不转义")
+        selector: z31.string().min(1).describe("CSS / Playwright locator"),
+        value: z31.string().describe("要填入的文本；原样写入不转义")
       },
       async execute(args) {
         return await runSafe("browser_fill", async () => {
@@ -15909,8 +16195,8 @@ function buildBrowserTools() {
     browser_screenshot: tool({
       description: description22,
       args: {
-        fullPage: z30.boolean().optional().describe("是否截全长页面（默认仅可视区）"),
-        selector: z30.string().optional().describe("CSS 选择器；指定时只截该元素")
+        fullPage: z31.boolean().optional().describe("是否截全长页面（默认仅可视区）"),
+        selector: z31.string().optional().describe("CSS 选择器；指定时只截该元素")
       },
       async execute(args) {
         return await runSafe("browser_screenshot", async () => {
@@ -15925,8 +16211,8 @@ function buildBrowserTools() {
     browser_console: tool({
       description: description23,
       args: {
-        level: z30.enum(["log", "info", "warn", "error", "debug"]).optional().describe("过滤级别"),
-        sinceTs: z30.number().optional().describe("timestamp >= sinceTs 的条目")
+        level: z31.enum(["log", "info", "warn", "error", "debug"]).optional().describe("过滤级别"),
+        sinceTs: z31.number().optional().describe("timestamp >= sinceTs 的条目")
       },
       async execute(args) {
         return await runSafe("browser_console", async () => {
@@ -15941,8 +16227,8 @@ function buildBrowserTools() {
     browser_network: tool({
       description: description24,
       args: {
-        method: z30.string().optional().describe("HTTP 方法过滤（GET/POST/...）"),
-        sinceTs: z30.number().optional().describe("start_ts >= sinceTs 的请求")
+        method: z31.string().optional().describe("HTTP 方法过滤（GET/POST/...）"),
+        sinceTs: z31.number().optional().describe("start_ts >= sinceTs 的请求")
       },
       async execute(args) {
         return await runSafe("browser_network", async () => {
@@ -15978,7 +16264,8 @@ var CORE_TOOL_NAMES = [
   "model_chain",
   "session_merge",
   "plan_write",
-  "plan_read"
+  "plan_read",
+  "adr_init"
 ];
 var BROWSER_TOOL_NAMES = [
   "browser_navigate",
@@ -16022,9 +16309,9 @@ var codeforgeToolsServer = async (ctx) => {
       smart_search: tool({
         description,
         args: {
-          query: z30.string().min(1).describe("自然语言查询词，例如「登录限流方案」「dev 服务器部署流程」"),
-          limit: z30.number().int().min(1).max(15).optional().describe("返回条数，默认 5；超过 15 会被 KH 截断"),
-          prefer: z30.array(z30.string()).optional().describe("偏好分类（best-effort）；常用 architecture / anti_pattern / convention")
+          query: z31.string().min(1).describe("自然语言查询词，例如「登录限流方案」「dev 服务器部署流程」"),
+          limit: z31.number().int().min(1).max(15).optional().describe("返回条数，默认 5；超过 15 会被 KH 截断"),
+          prefer: z31.array(z31.string()).optional().describe("偏好分类（best-effort）；常用 architecture / anti_pattern / convention")
         },
         async execute(args) {
           return await runSafe("smart_search", async () => {
@@ -16043,8 +16330,8 @@ var codeforgeToolsServer = async (ctx) => {
       save_chat_insight: tool({
         description: description2,
         args: {
-          insight: z30.string().min(20).max(5000).describe("完整知识条目（Markdown）。推荐三段式：## 问题 / ## 原因 / ## 解决"),
-          category: z30.enum([
+          insight: z31.string().min(20).max(5000).describe("完整知识条目（Markdown）。推荐三段式：## 问题 / ## 原因 / ## 解决"),
+          category: z31.enum([
             "convention",
             "anti_pattern",
             "architecture",
@@ -16054,7 +16341,7 @@ var codeforgeToolsServer = async (ctx) => {
             "tooling",
             "decision"
           ]).describe("分类"),
-          tags: z30.array(z30.string().min(1)).optional().describe("标签数组，建议 `tech:xxx` / `platform:xxx`")
+          tags: z31.array(z31.string().min(1)).optional().describe("标签数组，建议 `tech:xxx` / `platform:xxx`")
         },
         async execute(args) {
           return await runSafe("save_chat_insight", async () => {
@@ -16077,25 +16364,25 @@ var codeforgeToolsServer = async (ctx) => {
       ast_edit: tool({
         description: description15,
         args: {
-          action: z30.enum([
+          action: z31.enum([
             "replace_anchor",
             "insert_after_anchor",
             "insert_before_anchor",
             "delete_range",
             "rename_symbol"
           ]).describe("编辑类型；不同 action 需要的字段不同"),
-          target: z30.string().min(1).describe("目标文件路径（相对 cwd 或绝对）"),
-          before_hash: z30.string().optional().describe("操作前的 sha256 hex（强烈建议传，新文件传 null/省略）"),
-          auto_stage: z30.boolean().optional().describe("已废弃（保留兼容字段）：Phase 5 后 ast_edit 直接写入 session worktree，无需独立 stage"),
-          description: z30.string().optional().describe("可选变更说明（写入 audit log）"),
-          anchor: z30.string().optional().describe("anchor 类用：anchor 文本或 regex 源"),
-          regex: z30.boolean().optional().describe("anchor 是否按 RegExp 解释，默认 false"),
-          occurrence: z30.number().int().min(1).optional().describe("第几次匹配（1-based），默认 1"),
-          payload: z30.string().optional().describe("anchor 类用：要写入的内容"),
-          start: z30.number().int().min(1).optional().describe("delete_range 用：起始行（1-based）"),
-          end: z30.number().int().min(1).optional().describe("delete_range 用：结束行（1-based）"),
-          old_name: z30.string().optional().describe("rename_symbol 用：旧标识符"),
-          new_name: z30.string().optional().describe("rename_symbol 用：新标识符")
+          target: z31.string().min(1).describe("目标文件路径（相对 cwd 或绝对）"),
+          before_hash: z31.string().optional().describe("操作前的 sha256 hex（强烈建议传，新文件传 null/省略）"),
+          auto_stage: z31.boolean().optional().describe("已废弃（保留兼容字段）：Phase 5 后 ast_edit 直接写入 session worktree，无需独立 stage"),
+          description: z31.string().optional().describe("可选变更说明（写入 audit log）"),
+          anchor: z31.string().optional().describe("anchor 类用：anchor 文本或 regex 源"),
+          regex: z31.boolean().optional().describe("anchor 是否按 RegExp 解释，默认 false"),
+          occurrence: z31.number().int().min(1).optional().describe("第几次匹配（1-based），默认 1"),
+          payload: z31.string().optional().describe("anchor 类用：要写入的内容"),
+          start: z31.number().int().min(1).optional().describe("delete_range 用：起始行（1-based）"),
+          end: z31.number().int().min(1).optional().describe("delete_range 用：结束行（1-based）"),
+          old_name: z31.string().optional().describe("rename_symbol 用：旧标识符"),
+          new_name: z31.string().optional().describe("rename_symbol 用：新标识符")
         },
         async execute(args) {
           return await runSafeTracked("ast_edit", async () => {
@@ -16118,10 +16405,10 @@ var codeforgeToolsServer = async (ctx) => {
       repo_map: tool({
         description: description16,
         args: {
-          root: z30.string().optional().describe("扫描根目录，默认 cwd"),
-          top: z30.number().int().min(1).max(100).optional().describe("展示 top N 文件，默认 20"),
-          focus: z30.string().optional().describe("聚焦文件（POSIX 相对路径）"),
-          max_files: z30.number().int().min(10).max(5000).optional().describe("扫描上限，默认 500")
+          root: z31.string().optional().describe("扫描根目录，默认 cwd"),
+          top: z31.number().int().min(1).max(100).optional().describe("展示 top N 文件，默认 20"),
+          focus: z31.string().optional().describe("聚焦文件（POSIX 相对路径）"),
+          max_files: z31.number().int().min(10).max(5000).optional().describe("扫描上限，默认 500")
         },
         async execute(args) {
           return await runSafeTracked("repo_map", async () => {
@@ -16142,14 +16429,14 @@ var codeforgeToolsServer = async (ctx) => {
       rules_debug: tool({
         description: description17,
         args: {
-          current_agent: z30.string().optional().describe("当前 agent 名"),
-          root: z30.string().optional().describe("项目根目录"),
-          home_dir: z30.string().optional().describe("覆盖个人规则目录"),
-          project_dir: z30.string().optional().describe("覆盖项目规则目录"),
-          skip_personal: z30.boolean().optional(),
-          skip_project: z30.boolean().optional(),
-          skip_agent: z30.boolean().optional(),
-          markdown: z30.boolean().optional().describe("默认 true：渲染 markdown 摘要")
+          current_agent: z31.string().optional().describe("当前 agent 名"),
+          root: z31.string().optional().describe("项目根目录"),
+          home_dir: z31.string().optional().describe("覆盖个人规则目录"),
+          project_dir: z31.string().optional().describe("覆盖项目规则目录"),
+          skip_personal: z31.boolean().optional(),
+          skip_project: z31.boolean().optional(),
+          skip_agent: z31.boolean().optional(),
+          markdown: z31.boolean().optional().describe("默认 true：渲染 markdown 摘要")
         },
         async execute(args) {
           return await runSafe("rules_debug", async () => {
@@ -16164,14 +16451,14 @@ var codeforgeToolsServer = async (ctx) => {
       review_approval: tool({
         description: description18,
         args: {
-          verdict: z30.enum(["APPROVE", "APPROVE_WITH_NOTES"]).describe("审批裁决；REQUEST_CHANGES / BLOCK 不应调本工具"),
-          pendingIds: z30.array(z30.string().min(1)).min(1).describe("本次 APPROVE 覆盖的 pending change id 列表"),
-          notes: z30.string().min(1).max(2000).describe("审阅意见摘要（建议 ≤ 500 字）"),
-          decisionLine: z30.string().optional().describe("`## Decision` 节首行原文（默认 verdict 字面量，机审证据）"),
-          source: z30.enum(["reviewer", "codeforge-fallback"]).optional().describe("写入来源；默认 'reviewer'，codeforge 补写时传 'codeforge-fallback'"),
-          reviewerAgent: z30.string().optional().describe("写入 agent name（默认 'reviewer'；fallback 时为 'codeforge'）"),
-          sessionId: z30.string().optional().describe("reviewer 子 session id（boomerang 溯源用，可选）"),
-          model: z30.string().optional().describe("审批模型 id（审计用，可选）")
+          verdict: z31.enum(["APPROVE", "APPROVE_WITH_NOTES"]).describe("审批裁决；REQUEST_CHANGES / BLOCK 不应调本工具"),
+          pendingIds: z31.array(z31.string().min(1)).min(1).describe("本次 APPROVE 覆盖的 pending change id 列表"),
+          notes: z31.string().min(1).max(2000).describe("审阅意见摘要（建议 ≤ 500 字）"),
+          decisionLine: z31.string().optional().describe("`## Decision` 节首行原文（默认 verdict 字面量，机审证据）"),
+          source: z31.enum(["reviewer", "codeforge-fallback"]).optional().describe("写入来源；默认 'reviewer'，codeforge 补写时传 'codeforge-fallback'"),
+          reviewerAgent: z31.string().optional().describe("写入 agent name（默认 'reviewer'；fallback 时为 'codeforge'）"),
+          sessionId: z31.string().optional().describe("reviewer 子 session id（boomerang 溯源用，可选）"),
+          model: z31.string().optional().describe("审批模型 id（审计用，可选）")
         },
         async execute(args) {
           return await runSafe("review_approval", async () => {
@@ -16192,10 +16479,10 @@ var codeforgeToolsServer = async (ctx) => {
       model_chain: tool({
         description: description25,
         args: {
-          agent: z30.string().optional().describe("查指定 agent；不传 → 列出全部"),
-          current: z30.string().optional().describe("当前已用过的模型（<provider>/<id>），用于算下一档"),
-          root: z30.string().optional().describe("项目根目录，默认 cwd"),
-          config_file: z30.string().optional().describe("配置文件名；默认 codeforge.json")
+          agent: z31.string().optional().describe("查指定 agent；不传 → 列出全部"),
+          current: z31.string().optional().describe("当前已用过的模型（<provider>/<id>），用于算下一档"),
+          root: z31.string().optional().describe("项目根目录，默认 cwd"),
+          config_file: z31.string().optional().describe("配置文件名；默认 codeforge.json")
         },
         async execute(args) {
           return await runSafe("model_chain", async () => {
@@ -16216,11 +16503,11 @@ var codeforgeToolsServer = async (ctx) => {
       session_merge: tool({
         description: description26,
         args: {
-          action: z30.enum(["merge", "status", "discard", "diff"]).describe("操作类型：merge=合并到主仓（orchestrator 专用）/ status=查询状态 / discard=放弃 / diff=查看 worktree 改动"),
-          session_id: z30.string().optional().describe("目标 session id；不传则用当前 session"),
-          plan_id: z30.string().optional().describe("关联的 plan_id（reviewer 校验时用），格式 plan-YYYYMMDD-HHmmss-NNN"),
-          force: z30.boolean().optional().describe("action=merge 时跳过 review 直接 squash merge（写审计）"),
-          stat: z30.boolean().optional().describe("action=diff 时：true=只显示文件列表+统计，false=完整 diff（默认 false）")
+          action: z31.enum(["merge", "status", "discard", "diff"]).describe("操作类型：merge=合并到主仓（orchestrator 专用）/ status=查询状态 / discard=放弃 / diff=查看 worktree 改动"),
+          session_id: z31.string().optional().describe("目标 session id；不传则用当前 session"),
+          plan_id: z31.string().optional().describe("关联的 plan_id（reviewer 校验时用），格式 plan-YYYYMMDD-HHmmss-NNN"),
+          force: z31.boolean().optional().describe("action=merge 时跳过 review 直接 squash merge（写审计）"),
+          stat: z31.boolean().optional().describe("action=diff 时：true=只显示文件列表+统计，false=完整 diff（默认 false）")
         },
         async execute(args, input) {
           return await runSafe("session_merge", async () => {
@@ -16256,9 +16543,9 @@ var codeforgeToolsServer = async (ctx) => {
       plan_write: tool({
         description: description27,
         args: {
-          title: z30.string().min(2).max(80).describe('方案简短标题（2-80 字），如 "实现 worktree session 隔离 Phase 1"'),
-          content: z30.string().min(10).describe("方案 markdown 全文，建议 ≥ 50 行"),
-          tags: z30.array(z30.string().min(1)).optional().describe('标签（可选），如 ["phase:1", "arch:worktree"]')
+          title: z31.string().min(2).max(80).describe('方案简短标题（2-80 字），如 "实现 worktree session 隔离 Phase 1"'),
+          content: z31.string().min(10).describe("方案 markdown 全文，建议 ≥ 50 行"),
+          tags: z31.array(z31.string().min(1)).optional().describe('标签（可选），如 ["phase:1", "arch:worktree"]')
         },
         async execute(args) {
           return await runSafeTracked("plan_write", async () => {
@@ -16277,8 +16564,8 @@ var codeforgeToolsServer = async (ctx) => {
       plan_read: tool({
         description: description28,
         args: {
-          plan_id: z30.string().optional().describe("方案 ID（推荐），格式 plan-YYYYMMDD-HHmmss-NNN"),
-          path: z30.string().optional().describe("方案绝对路径（兜底用，没有 plan_id 元数据时退而求其次）")
+          plan_id: z31.string().optional().describe("方案 ID（推荐），格式 plan-YYYYMMDD-HHmmss-NNN"),
+          path: z31.string().optional().describe("方案绝对路径（兜底用，没有 plan_id 元数据时退而求其次）")
         },
         async execute(args) {
           return await runSafe("plan_read", async () => {
@@ -16297,6 +16584,25 @@ var codeforgeToolsServer = async (ctx) => {
             return wrap(result, meta);
           });
         }
+      }),
+      adr_init: tool({
+        description: description29,
+        args: {
+          cwd: z31.string().optional().describe("目标项目根目录，默认 process.cwd()；通常无需传"),
+          force: z31.boolean().optional().describe("已存在文件覆盖；覆盖前自动 .bak.<ts> 备份"),
+          dryRun: z31.boolean().optional().describe("只输出将要执行的写入计划，不实际写盘"),
+          writePrepare: z31.boolean().optional().describe("（npm 项目）自动合并 git config core.hooksPath 到 package.json scripts.prepare；写前自动 backup"),
+          installPrePush: z31.boolean().optional().describe("是否同时生成 .githooks/pre-push hook，默认 true")
+        },
+        async execute(args) {
+          return await runSafe("adr_init", async () => {
+            const v = projectValidate("adr_init", ArgsSchema29, args);
+            if (!v.ok)
+              return wrap(JSON.parse(v.output));
+            const result = await execute29(v.data);
+            return wrap(result, { title: "adr_init" });
+          });
+        }
       })
     }
   };
@@ -16305,10 +16611,10 @@ var handler8 = codeforgeToolsServer;
 
 // plugins/discover-spec-suggest.ts
 import { readFileSync as readFileSync3, readdirSync, statSync as statSync3 } from "node:fs";
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 
 // lib/handoff-schema.ts
-import { z as z31 } from "zod";
+import { z as z32 } from "zod";
 
 // node_modules/yaml/dist/index.js
 var composer = require_composer();
@@ -16361,92 +16667,92 @@ var MAX_HANDOFF_SIZE = 100 * 1024;
 var SLUG_REGEX = /^[a-z0-9][a-z0-9-]{0,49}$/;
 var SCORE_DIMENSIONS = ["functional", "ux", "technical", "constraints", "edge_cases"];
 var COMBO_VALUES = ["A", "B", "C", "D"];
-var NeedSchema = z31.object({
-  id: z31.string().min(1),
-  type: z31.enum(["must", "should", "nice-to-have"]),
-  statement: z31.string().min(1),
-  rationale: z31.string().optional(),
-  acceptance: z31.array(z31.string()).optional()
+var NeedSchema = z32.object({
+  id: z32.string().min(1),
+  type: z32.enum(["must", "should", "nice-to-have"]),
+  statement: z32.string().min(1),
+  rationale: z32.string().optional(),
+  acceptance: z32.array(z32.string()).optional()
 });
-var BoundarySchema = z31.object({
-  excluded: z31.string().min(1),
-  reason: z31.string().min(1)
+var BoundarySchema = z32.object({
+  excluded: z32.string().min(1),
+  reason: z32.string().min(1)
 });
-var AssumptionSchema = z31.object({
-  statement: z31.string().min(1),
-  confidence: z31.enum(["verified", "speculation", "high-risk-unknown"]),
-  needs_validation_by: z31.enum(["plan", "coder", "runtime"]).optional()
+var AssumptionSchema = z32.object({
+  statement: z32.string().min(1),
+  confidence: z32.enum(["verified", "speculation", "high-risk-unknown"]),
+  needs_validation_by: z32.enum(["plan", "coder", "runtime"]).optional()
 });
-var OpenIssueSchema = z31.union([
-  z31.string().min(1),
-  z31.object({
-    id: z31.string().optional(),
-    question: z31.string().min(1),
-    blocking: z31.boolean().optional()
+var OpenIssueSchema = z32.union([
+  z32.string().min(1),
+  z32.object({
+    id: z32.string().optional(),
+    question: z32.string().min(1),
+    blocking: z32.boolean().optional()
   })
 ]);
-var RedFlagsSchema = z31.object({
-  raised: z31.boolean(),
-  combos: z31.array(z31.enum(COMBO_VALUES)).default([]),
-  reasons: z31.array(z31.string()).default([]),
-  user_persisted_rounds: z31.number().int().nonnegative().default(0),
-  downstream_advisory: z31.string().nullable().optional()
+var RedFlagsSchema = z32.object({
+  raised: z32.boolean(),
+  combos: z32.array(z32.enum(COMBO_VALUES)).default([]),
+  reasons: z32.array(z32.string()).default([]),
+  user_persisted_rounds: z32.number().int().nonnegative().default(0),
+  downstream_advisory: z32.string().nullable().optional()
 }).superRefine((rf, ctx) => {
   if (rf.raised) {
     if (rf.combos.length === 0) {
       ctx.addIssue({
-        code: z31.ZodIssueCode.custom,
+        code: z32.ZodIssueCode.custom,
         message: "red_flags.raised=true 时 combos 必须 >=1",
         path: ["combos"]
       });
     }
     if (rf.reasons.length === 0) {
       ctx.addIssue({
-        code: z31.ZodIssueCode.custom,
+        code: z32.ZodIssueCode.custom,
         message: "red_flags.raised=true 时 reasons 必须 >=1",
         path: ["reasons"]
       });
     }
   }
 });
-var ScoresSchema = z31.object(Object.fromEntries(SCORE_DIMENSIONS.map((d) => [d, z31.number().min(0).max(1)])));
-var PreCodingBlockerSchema = z31.object({
-  id: z31.string().regex(/^PRE-\d+$/, "id 必须形如 PRE-1 / PRE-2"),
-  blocker: z31.string().min(1),
-  source: z31.enum(["assumption", "red_flag", "open_issue"]),
-  must_resolve_by: z31.enum(["user", "codeforge"])
+var ScoresSchema = z32.object(Object.fromEntries(SCORE_DIMENSIONS.map((d) => [d, z32.number().min(0).max(1)])));
+var PreCodingBlockerSchema = z32.object({
+  id: z32.string().regex(/^PRE-\d+$/, "id 必须形如 PRE-1 / PRE-2"),
+  blocker: z32.string().min(1),
+  source: z32.enum(["assumption", "red_flag", "open_issue"]),
+  must_resolve_by: z32.enum(["user", "codeforge"])
 });
-var KhRefSchema = z31.object({
-  kh_id: z31.string(),
-  title: z31.string(),
-  relevance: z31.enum(["positive", "negative", "neutral"]).optional()
+var KhRefSchema = z32.object({
+  kh_id: z32.string(),
+  title: z32.string(),
+  relevance: z32.enum(["positive", "negative", "neutral"]).optional()
 });
-var HandoffSchema = z31.object({
-  schema_version: z31.string().regex(/^\d+\.\d+\.\d+$/, "schema_version 必须形如 1.1.0 / 1.2.0"),
-  slug: z31.string().regex(SLUG_REGEX, "slug 仅允许 [a-z0-9-]，长度 1-50，首字符为字母数字"),
-  title: z31.string().min(1).max(200),
-  created_at: z31.string().optional(),
-  discover_session_id: z31.string().optional(),
-  weighted_score: z31.number().min(0).max(1),
+var HandoffSchema = z32.object({
+  schema_version: z32.string().regex(/^\d+\.\d+\.\d+$/, "schema_version 必须形如 1.1.0 / 1.2.0"),
+  slug: z32.string().regex(SLUG_REGEX, "slug 仅允许 [a-z0-9-]，长度 1-50，首字符为字母数字"),
+  title: z32.string().min(1).max(200),
+  created_at: z32.string().optional(),
+  discover_session_id: z32.string().optional(),
+  weighted_score: z32.number().min(0).max(1),
   scores: ScoresSchema,
-  needs: z31.array(NeedSchema).min(1, "needs 必须 >=1"),
-  boundaries: z31.array(BoundarySchema).min(1, "boundaries 必须 >=1"),
-  assumptions: z31.array(AssumptionSchema),
-  open_issues: z31.array(OpenIssueSchema).default([]),
-  rejected_alternatives: z31.array(z31.object({ option: z31.string(), reason: z31.string() })).default([]),
-  acceptance_criteria: z31.array(z31.object({
-    id: z31.string().regex(/^AC-/, "AC id 必须以 AC- 开头"),
-    description: z31.string().min(1),
-    measurable: z31.boolean().optional(),
-    metric: z31.string().optional()
+  needs: z32.array(NeedSchema).min(1, "needs 必须 >=1"),
+  boundaries: z32.array(BoundarySchema).min(1, "boundaries 必须 >=1"),
+  assumptions: z32.array(AssumptionSchema),
+  open_issues: z32.array(OpenIssueSchema).default([]),
+  rejected_alternatives: z32.array(z32.object({ option: z32.string(), reason: z32.string() })).default([]),
+  acceptance_criteria: z32.array(z32.object({
+    id: z32.string().regex(/^AC-/, "AC id 必须以 AC- 开头"),
+    description: z32.string().min(1),
+    measurable: z32.boolean().optional(),
+    metric: z32.string().optional()
   })).default([]),
   red_flags: RedFlagsSchema,
-  pre_coding_blockers: z31.array(PreCodingBlockerSchema).default([]),
-  kh_references: z31.array(KhRefSchema).default([]),
-  adr_refs: z31.array(z31.string()).default([]),
-  related_artifacts: z31.object({
-    prd: z31.string().optional(),
-    transcript: z31.string().optional()
+  pre_coding_blockers: z32.array(PreCodingBlockerSchema).default([]),
+  kh_references: z32.array(KhRefSchema).default([]),
+  adr_refs: z32.array(z32.string()).default([]),
+  related_artifacts: z32.object({
+    prd: z32.string().optional(),
+    transcript: z32.string().optional()
   }).optional()
 });
 function validateHandoff(rawYaml, fileSize) {
@@ -16472,9 +16778,9 @@ function validateHandoff(rawYaml, fileSize) {
   const result = HandoffSchema.safeParse(parsed);
   if (!result.success) {
     const first = result.error.issues[0];
-    const path18 = first?.path?.join(".") ?? "(root)";
+    const path19 = first?.path?.join(".") ?? "(root)";
     const msg = first?.message ?? "unknown";
-    return { ok: false, reason: `schema 校验失败：${path18}: ${msg}` };
+    return { ok: false, reason: `schema 校验失败：${path19}: ${msg}` };
   }
   return { ok: true, data: result.data, schemaVersion: result.data.schema_version };
 }
@@ -16491,7 +16797,7 @@ var SESSION_TTL_MS2 = 24 * 60 * 60 * 1000;
 var MATCH_THRESHOLD = 0.15;
 var MAX_CANDIDATES = 3;
 var NUDGE_MAX_LEN = 1500;
-var SPECS_REL_DIR = join14(".codeforge", "specs");
+var SPECS_REL_DIR = join15(".codeforge", "specs");
 var sessionMap = new Map;
 function pruneIfOversize2() {
   while (sessionMap.size > SESSION_CAP2) {
@@ -16598,7 +16904,7 @@ function loadSpecs(rootDir, opts = {}) {
   const dirExists = opts.dirExists ?? defaultDirExists;
   const statReader = opts.statReader ?? defaultStatReader;
   const log6 = makePluginLogger(PLUGIN_NAME9);
-  const specsRoot = join14(rootDir, SPECS_REL_DIR);
+  const specsRoot = join15(rootDir, SPECS_REL_DIR);
   const records = [];
   if (!dirExists(specsRoot)) {
     log6.info(`specs 目录不存在，plugin 将 no-op`, { specsRoot });
@@ -16619,7 +16925,7 @@ function loadSpecs(rootDir, opts = {}) {
       log6.info(`跳过非合法 slug 命名的条目`, { entry });
       continue;
     }
-    const specDir = join14(specsRoot, entry);
+    const specDir = join15(specsRoot, entry);
     let dirStat;
     try {
       dirStat = statReader(specDir);
@@ -16632,7 +16938,7 @@ function loadSpecs(rootDir, opts = {}) {
     }
     if (!dirStat.isDirectory)
       continue;
-    const handoffPath = join14(specDir, "handoff.yaml");
+    const handoffPath = join15(specDir, "handoff.yaml");
     let fileStat;
     try {
       fileStat = statReader(handoffPath);
@@ -17639,13 +17945,13 @@ var handler11 = khReminderServer;
 
 // lib/memories.ts
 import { promises as fs15 } from "node:fs";
-import * as path18 from "node:path";
+import * as path19 from "node:path";
 import * as os5 from "node:os";
 function resolveConfig(c) {
   return {
     projectRoot: c.projectRoot,
     homeDir: c.homeDir ?? os5.homedir(),
-    projectName: c.projectName ?? path18.basename(c.projectRoot),
+    projectName: c.projectName ?? path19.basename(c.projectRoot),
     kh: c.kh,
     now: c.now ?? Date.now,
     log: c.log ?? (() => {}),
@@ -17654,9 +17960,9 @@ function resolveConfig(c) {
 }
 function fileFor(scope, cfg) {
   if (scope === "project") {
-    return path18.join(cfg.projectRoot, ".codeforge", "memories.json");
+    return path19.join(cfg.projectRoot, ".codeforge", "memories.json");
   }
-  return path18.join(cfg.homeDir, ".codeforge", "memories.json");
+  return path19.join(cfg.homeDir, ".codeforge", "memories.json");
 }
 async function readBank(p) {
   try {
@@ -17670,7 +17976,7 @@ async function readBank(p) {
   }
 }
 async function writeBank(p, items) {
-  await fs15.mkdir(path18.dirname(p), { recursive: true });
+  await fs15.mkdir(path19.dirname(p), { recursive: true });
   const tmp = `${p}.tmp`;
   await fs15.writeFile(tmp, JSON.stringify(items, null, 2), "utf8");
   await fs15.rename(tmp, p);
@@ -18217,7 +18523,7 @@ var handler13 = modelFallbackServer;
 
 // plugins/subtask-heartbeat.ts
 import { promises as fsPromises } from "node:fs";
-import * as path19 from "node:path";
+import * as path20 from "node:path";
 init_runtime_paths();
 init_global_config();
 var recordSessionParent2 = recordSessionParent;
@@ -18305,11 +18611,11 @@ function extractTaskArgs(args) {
   const a = args;
   const rawDesc = typeof a["description"] === "string" ? a["description"] : null;
   const rawPrompt = typeof a["prompt"] === "string" ? a["prompt"] : null;
-  const description29 = rawDesc ?? (rawPrompt ? rawPrompt.slice(0, 60) : null);
+  const description30 = rawDesc ?? (rawPrompt ? rawPrompt.slice(0, 60) : null);
   const subagentType = typeof a["subagent_type"] === "string" && a["subagent_type"] || typeof a["agent"] === "string" && a["agent"] || typeof a["agentType"] === "string" && a["agentType"] || typeof a["agent_type"] === "string" && a["agent_type"] || null;
-  if (!description29 && !subagentType)
+  if (!description30 && !subagentType)
     return null;
-  return { description: description29, subagentType };
+  return { description: description30, subagentType };
 }
 function enqueuePendingTask(parentID, entry, now = Date.now()) {
   const ts = entry.ts ?? now;
@@ -18519,7 +18825,7 @@ function buildAfterLogLine(toolName, ok, durationMs, now = Date.now()) {
 }
 async function appendSubagentLog(filePath, line, log8) {
   try {
-    await fsPromises.mkdir(path19.dirname(filePath), { recursive: true });
+    await fsPromises.mkdir(path20.dirname(filePath), { recursive: true });
     await fsPromises.appendFile(filePath, line + `
 `, "utf8");
   } catch (err) {
@@ -18853,7 +19159,7 @@ var handler15 = parallelStatusServer;
 
 // plugins/parallel-tool-nudge.ts
 import { readFileSync as readFileSync4, readdirSync as readdirSync2, statSync as statSync4 } from "node:fs";
-import { join as join16 } from "node:path";
+import { join as join17 } from "node:path";
 import { homedir as homedir6 } from "node:os";
 var PLUGIN_NAME16 = "parallel-tool-nudge";
 logLifecycle(PLUGIN_NAME16, "import", {});
@@ -18909,10 +19215,10 @@ function loadAgentToolsMap(rootDir, opts = {}) {
   const reader = opts.reader ?? defaultReader2;
   const dirReader = opts.dirReader ?? defaultDirReader2;
   const dirExists = opts.dirExists ?? defaultDirExists2;
-  const homeAgentsDir = opts.homeAgentsDir ?? join16(homedir6(), ".config", "opencode", "agents");
+  const homeAgentsDir = opts.homeAgentsDir ?? join17(homedir6(), ".config", "opencode", "agents");
   const candidateDirs = [
-    join16(rootDir, ".codeforge", "agents"),
-    join16(rootDir, "agents"),
+    join17(rootDir, ".codeforge", "agents"),
+    join17(rootDir, "agents"),
     homeAgentsDir
   ];
   const result = new Map;
@@ -18935,20 +19241,20 @@ function loadAgentToolsMap(rootDir, opts = {}) {
     for (const entry of entries) {
       if (!entry.endsWith(".md"))
         continue;
-      const path20 = join16(dir, entry);
+      const path21 = join17(dir, entry);
       let content;
       try {
-        content = reader(path20);
+        content = reader(path21);
       } catch (err) {
         log9.warn(`agent.md 读取失败（已跳过）`, {
-          path: path20,
+          path: path21,
           error: err instanceof Error ? err.message : String(err)
         });
         continue;
       }
       const parsed = parseAgentFrontmatter(content);
       if (!parsed) {
-        log9.warn(`agent frontmatter 解析失败（已跳过）`, { path: path20 });
+        log9.warn(`agent frontmatter 解析失败（已跳过）`, { path: path21 });
         continue;
       }
       if (result.has(parsed.name))
@@ -19141,7 +19447,7 @@ var handler17 = async (_ctx3) => {
 // lib/event-stream.ts
 import { promises as fs16 } from "node:fs";
 init_runtime_paths();
-import * as path20 from "node:path";
+import * as path21 from "node:path";
 async function loadSession(id, opts = {}) {
   const file = resolveSessionFile(id, opts);
   const raw = await fs16.readFile(file, "utf8");
@@ -19161,7 +19467,7 @@ async function listSessions(opts = {}) {
   for (const e of entries) {
     if (!e.isFile() || !e.name.endsWith(".jsonl"))
       continue;
-    const file = path20.join(dir, e.name);
+    const file = path21.join(dir, e.name);
     const id = e.name.replace(/\.jsonl$/, "");
     try {
       const stat = await fs16.stat(file);
@@ -19188,11 +19494,11 @@ async function listSessions(opts = {}) {
   return out;
 }
 function resolveDir(opts = {}) {
-  const root = path20.resolve(opts.root ?? process.cwd());
-  return opts.sessions_dir ? path20.resolve(root, opts.sessions_dir) : path20.join(runtimeDir(root), "sessions");
+  const root = path21.resolve(opts.root ?? process.cwd());
+  return opts.sessions_dir ? path21.resolve(root, opts.sessions_dir) : path21.join(runtimeDir(root), "sessions");
 }
 function resolveSessionFile(id, opts = {}) {
-  return path20.join(resolveDir(opts), `${id}.jsonl`);
+  return path21.join(resolveDir(opts), `${id}.jsonl`);
 }
 function parseJsonl(id, raw) {
   const events = [];
@@ -19457,10 +19763,10 @@ function isRecoveryWorthShowing(plan) {
 // lib/block-pending.ts
 init_runtime_paths();
 import { promises as fs17 } from "node:fs";
-import * as path21 from "node:path";
+import * as path22 from "node:path";
 function blockPendingFilePath(absRoot) {
   const rd = runtimeDir(absRoot, { ensure: false });
-  return path21.join(rd, "sessions", "autonomous-blocks.ndjson");
+  return path22.join(rd, "sessions", "autonomous-blocks.ndjson");
 }
 function consumeLockPath(absRoot) {
   return blockPendingFilePath(absRoot) + ".consume.lock";
@@ -19525,7 +19831,7 @@ async function markBlocksConsumed(absRoot, entries) {
   if (entries.length === 0)
     return;
   const file = blockPendingFilePath(absRoot);
-  await fs17.mkdir(path21.dirname(file), { recursive: true });
+  await fs17.mkdir(path22.dirname(file), { recursive: true });
   const now = new Date().toISOString();
   const lines = entries.map((e) => ({
     type: "consume",
@@ -19675,7 +19981,7 @@ var handler18 = sessionRecoveryServer;
 
 // plugins/subtasks.ts
 import { promises as fs18 } from "node:fs";
-import * as path22 from "node:path";
+import * as path23 from "node:path";
 
 // lib/parallel-merge.ts
 init_worktree_ops();
@@ -20290,7 +20596,7 @@ function buildSystemPrompt(maxSubtasks) {
   ].join(`
 `);
 }
-async function decomposeTask(description29, opts) {
+async function decomposeTask(description30, opts) {
   const log11 = opts.log ?? (() => {});
   if (opts.mockResponse) {
     return validateAndFinalize(opts.mockResponse, undefined, log11, opts.maxSubtasks ?? DEFAULT_MAX_SUBTASKS);
@@ -20300,7 +20606,7 @@ async function decomposeTask(description29, opts) {
   let childSessionId;
   try {
     const created = await opts.client.session.create({
-      body: { title: `decompose:${clip6(description29, 60)}` },
+      body: { title: `decompose:${clip6(description30, 60)}` },
       query: opts.directory ? { directory: opts.directory } : undefined
     });
     if (created.error || !created.data?.id) {
@@ -20317,7 +20623,7 @@ async function decomposeTask(description29, opts) {
       path: { id: childSessionId },
       body: {
         system: systemText,
-        parts: [{ type: "text", text: description29 }]
+        parts: [{ type: "text", text: description30 }]
       },
       query: opts.directory ? { directory: opts.directory } : undefined
     }));
@@ -20493,14 +20799,14 @@ function describe8(err) {
   }
 }
 function sleep2(ms) {
-  return new Promise((resolve16) => setTimeout(resolve16, ms));
+  return new Promise((resolve17) => setTimeout(resolve17, ms));
 }
 
 // plugins/subtasks.ts
 init_runtime_paths();
 var PLUGIN_NAME19 = "subtasks";
 function getLogFile(root = process.cwd()) {
-  return path22.join(runtimeDir(root), "logs", "subtasks.log");
+  return path23.join(runtimeDir(root), "logs", "subtasks.log");
 }
 var VERB_RE = /^([a-zA-Z]{3,12})/;
 var CN_VERBS = [
@@ -20805,7 +21111,7 @@ async function writeLog(level, msg, data) {
 `;
   try {
     const logFile = getLogFile();
-    await fs18.mkdir(path22.dirname(logFile), { recursive: true });
+    await fs18.mkdir(path23.dirname(logFile), { recursive: true });
     await fs18.appendFile(logFile, line, "utf8");
   } catch {}
 }
@@ -20822,8 +21128,8 @@ var subtasksServer = async (ctx) => {
       try {
         if (input?.command !== "parallel")
           return;
-        const description29 = (input.arguments ?? "").trim();
-        if (!description29) {
+        const description30 = (input.arguments ?? "").trim();
+        if (!description30) {
           return;
         }
         let autoMerge = false;
@@ -20862,7 +21168,7 @@ var subtasksServer = async (ctx) => {
         } : undefined;
         const replyLines = [];
         const messageCtx = {
-          content: `/parallel ${description29}`,
+          content: `/parallel ${description30}`,
           reply: (s) => {
             replyLines.push(s);
             return Promise.resolve();
@@ -21323,7 +21629,7 @@ var handler21 = tokenManagerServer;
 
 // plugins/tool-policy.ts
 import { promises as fs19 } from "node:fs";
-import * as path24 from "node:path";
+import * as path25 from "node:path";
 
 // lib/tool-risk.ts
 var RISK_PATTERNS = [
@@ -21491,7 +21797,7 @@ function buildHaystackFor(args, matchOn) {
 }
 
 // lib/file-regex-acl.ts
-import * as path23 from "node:path";
+import * as path24 from "node:path";
 function compileRule(r) {
   if (r instanceof RegExp)
     return r;
@@ -21557,7 +21863,7 @@ function normalizePath2(p) {
   let s = p.replace(/\\/g, "/");
   if (s.startsWith("./"))
     s = s.slice(2);
-  s = path23.posix.normalize(s);
+  s = path24.posix.normalize(s);
   return s;
 }
 function checkFileAccess(acl, file, op) {
@@ -21660,9 +21966,9 @@ function decideToolCall(ctx, cfg = {}, currentAgent) {
   const action = risks.length > 0 || worstAcl === "deny" ? "deny" : "allow";
   return { action, reasons, risks, acl: aclResults };
 }
-var POLICY_PATH = path24.join(".codeforge", "policy.json");
+var POLICY_PATH = path25.join(".codeforge", "policy.json");
 async function loadPolicy(root = process.cwd()) {
-  const file = path24.join(root, POLICY_PATH);
+  const file = path25.join(root, POLICY_PATH);
   try {
     const raw = await fs19.readFile(file, "utf8");
     const data = JSON.parse(raw);
@@ -21760,15 +22066,15 @@ var toolPolicyServer = async (ctx) => {
 var handler22 = toolPolicyServer;
 
 // plugins/update-checker.ts
-import { existsSync as existsSync5 } from "node:fs";
+import { existsSync as existsSync6 } from "node:fs";
 import { homedir as homedir8 } from "node:os";
-import { join as join22 } from "node:path";
+import { join as join23 } from "node:path";
 
 // lib/update-checker-impl.ts
 import { createHash as createHash5 } from "node:crypto";
 import {
   copyFileSync,
-  existsSync as existsSync4,
+  existsSync as existsSync5,
   mkdirSync as mkdirSync3,
   mkdtempSync,
   readFileSync as readFileSync5,
@@ -21779,15 +22085,15 @@ import {
   writeFileSync as writeFileSync2
 } from "node:fs";
 import { homedir as homedir7, tmpdir } from "node:os";
-import { dirname as dirname13, join as join21 } from "node:path";
-import { fileURLToPath } from "node:url";
+import { dirname as dirname14, join as join22 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 import * as https from "node:https";
 import * as zlib from "node:zlib";
 
 // lib/version-injected.ts
 function getInjectedVersion() {
   try {
-    const v = "0.5.19";
+    const v = "0.5.20";
     if (typeof v === "string" && /^\d+\.\d+\.\d+/.test(v)) {
       return v;
     }
@@ -21875,23 +22181,23 @@ function readLocalVersion() {
   if (injected)
     return injected;
   try {
-    const here = fileURLToPath(import.meta.url);
-    const root = dirname13(dirname13(here));
-    const pkg = JSON.parse(readFileSync5(join21(root, "package.json"), "utf8"));
+    const here = fileURLToPath2(import.meta.url);
+    const root = dirname14(dirname14(here));
+    const pkg = JSON.parse(readFileSync5(join22(root, "package.json"), "utf8"));
     return typeof pkg.version === "string" ? pkg.version : "0.0.0";
   } catch {
     return "0.0.0";
   }
 }
 function defaultCacheDir() {
-  return process.env["CODEFORGE_CACHE_DIR"] ?? join21(homedir7(), ".cache", "codeforge");
+  return process.env["CODEFORGE_CACHE_DIR"] ?? join22(homedir7(), ".cache", "codeforge");
 }
 function defaultCacheFile() {
-  return join21(defaultCacheDir(), "update-check.json");
+  return join22(defaultCacheDir(), "update-check.json");
 }
 function readCache(file) {
   try {
-    if (!existsSync4(file))
+    if (!existsSync5(file))
       return null;
     const raw = readFileSync5(file, "utf8");
     const obj = JSON.parse(raw);
@@ -21905,7 +22211,7 @@ function readCache(file) {
 }
 function writeCache(file, entry) {
   try {
-    mkdirSync3(dirname13(file), { recursive: true });
+    mkdirSync3(dirname14(file), { recursive: true });
     writeFileSync2(file, JSON.stringify(entry, null, 2), "utf8");
   } catch {}
 }
@@ -21923,9 +22229,9 @@ function fetchLatestTagFromGitHub(repo) {
     }
   });
 }
-function getJsonWithRedirect(url, hopsLeft) {
-  return new Promise((resolve16, reject) => {
-    const u = new URL(url);
+function getJsonWithRedirect(url2, hopsLeft) {
+  return new Promise((resolve17, reject) => {
+    const u = new URL(url2);
     const headers = {
       "User-Agent": "codeforge-update-checker",
       Accept: "application/vnd.github+json"
@@ -21947,13 +22253,13 @@ function getJsonWithRedirect(url, hopsLeft) {
           reject(new Error("too_many_redirects"));
           return;
         }
-        const next = new URL(res.headers.location, url).toString();
-        getJsonWithRedirect(next, hopsLeft - 1).then(resolve16, reject);
+        const next = new URL(res.headers.location, url2).toString();
+        getJsonWithRedirect(next, hopsLeft - 1).then(resolve17, reject);
         return;
       }
       if (status === 404) {
         res.resume();
-        resolve16(null);
+        resolve17(null);
         return;
       }
       if (status >= 400) {
@@ -21964,7 +22270,7 @@ function getJsonWithRedirect(url, hopsLeft) {
       let body = "";
       res.setEncoding("utf8");
       res.on("data", (chunk) => body += chunk);
-      res.on("end", () => resolve16(body));
+      res.on("end", () => resolve17(body));
     });
     req.on("timeout", () => {
       req.destroy();
@@ -21979,9 +22285,9 @@ async function fetchLatestFromNpm(opts) {
   const channel = opts.channel ?? "latest";
   const timeoutMs = opts.timeoutMs ?? 5000;
   const encodedPkg = opts.pkg.startsWith("@") ? opts.pkg.replace("/", "%2F") : opts.pkg;
-  const url = `${registry}/${encodedPkg}/${encodeURIComponent(channel)}`;
+  const url2 = `${registry}/${encodedPkg}/${encodeURIComponent(channel)}`;
   const fetcher = opts.httpFetcher ?? defaultHttpFetcher;
-  const body = await fetcher(url, timeoutMs);
+  const body = await fetcher(url2, timeoutMs);
   if (body === null)
     return null;
   let parsed;
@@ -22003,9 +22309,9 @@ async function fetchLatestFromNpm(opts) {
   }
   return { version, tarballUrl, integrity };
 }
-function defaultHttpFetcher(url, timeoutMs) {
-  return new Promise((resolve16, reject) => {
-    const u = new URL(url);
+function defaultHttpFetcher(url2, timeoutMs) {
+  return new Promise((resolve17, reject) => {
+    const u = new URL(url2);
     const headers = {
       "User-Agent": "codeforge-update-checker",
       Accept: "application/json"
@@ -22021,7 +22327,7 @@ function defaultHttpFetcher(url, timeoutMs) {
       const status = res.statusCode ?? 0;
       if (status === 404) {
         res.resume();
-        resolve16(null);
+        resolve17(null);
         return;
       }
       if (status >= 400) {
@@ -22032,7 +22338,7 @@ function defaultHttpFetcher(url, timeoutMs) {
       let body = "";
       res.setEncoding("utf8");
       res.on("data", (chunk) => body += chunk);
-      res.on("end", () => resolve16(body));
+      res.on("end", () => resolve17(body));
     });
     req.on("timeout", () => {
       req.destroy();
@@ -22043,15 +22349,15 @@ function defaultHttpFetcher(url, timeoutMs) {
   });
 }
 async function downloadAndExtractBundle(opts) {
-  const tmpRoot = opts.tmpDir ?? mkdtempSync(join21(tmpdir(), "codeforge-update-"));
+  const tmpRoot = opts.tmpDir ?? mkdtempSync(join22(tmpdir(), "codeforge-update-"));
   mkdirSync3(tmpRoot, { recursive: true });
   const fetcher = opts.tarballFetcher ?? defaultBinaryFetcher;
   const tarballBuf = await fetcher(opts.tarballUrl);
   verifyIntegrity(tarballBuf, opts.expectedIntegrity);
   const tarBuf = zlib.gunzipSync(tarballBuf);
   extractTarToDir(tarBuf, tmpRoot);
-  const bundlePath = join21(tmpRoot, "package", "dist", "index.js");
-  if (!existsSync4(bundlePath)) {
+  const bundlePath = join22(tmpRoot, "package", "dist", "index.js");
+  if (!existsSync5(bundlePath)) {
     throw new Error(`bundle_not_found: ${bundlePath}`);
   }
   return { bundlePath, extractDir: tmpRoot };
@@ -22090,21 +22396,21 @@ function extractTarToDir(tarBuf, destRoot) {
     offset += 512;
     if (typeFlag === "0" || typeFlag === "" || typeFlag === "\x00") {
       const fileBuf = tarBuf.subarray(offset, offset + size);
-      const dest = join21(destRoot, fullName);
-      mkdirSync3(dirname13(dest), { recursive: true });
+      const dest = join22(destRoot, fullName);
+      mkdirSync3(dirname14(dest), { recursive: true });
       writeFileSync2(dest, fileBuf);
     } else if (typeFlag === "5") {
-      mkdirSync3(join21(destRoot, fullName), { recursive: true });
+      mkdirSync3(join22(destRoot, fullName), { recursive: true });
     }
     offset += Math.ceil(size / 512) * 512;
   }
 }
-function defaultBinaryFetcher(url) {
-  return downloadBinary(url, 3);
+function defaultBinaryFetcher(url2) {
+  return downloadBinary(url2, 3);
 }
-function downloadBinary(url, hopsLeft) {
-  return new Promise((resolve16, reject) => {
-    const u = new URL(url);
+function downloadBinary(url2, hopsLeft) {
+  return new Promise((resolve17, reject) => {
+    const u = new URL(url2);
     const req = https.request({
       host: u.hostname,
       port: u.port || undefined,
@@ -22120,8 +22426,8 @@ function downloadBinary(url, hopsLeft) {
           reject(new Error("too_many_redirects"));
           return;
         }
-        const next = new URL(res.headers.location, url).toString();
-        downloadBinary(next, hopsLeft - 1).then(resolve16, reject);
+        const next = new URL(res.headers.location, url2).toString();
+        downloadBinary(next, hopsLeft - 1).then(resolve17, reject);
         return;
       }
       if (status >= 400) {
@@ -22131,7 +22437,7 @@ function downloadBinary(url, hopsLeft) {
       }
       const chunks = [];
       res.on("data", (chunk) => chunks.push(chunk));
-      res.on("end", () => resolve16(Buffer.concat(chunks)));
+      res.on("end", () => resolve17(Buffer.concat(chunks)));
     });
     req.on("timeout", () => {
       req.destroy();
@@ -22144,16 +22450,16 @@ function downloadBinary(url, hopsLeft) {
 function atomicReplaceBundle(opts) {
   const { source, target, oldVersion } = opts;
   const keep = opts.keepBackups ?? 3;
-  if (!existsSync4(source)) {
+  if (!existsSync5(source)) {
     throw new Error(`atomic_source_missing: ${source}`);
   }
-  mkdirSync3(dirname13(target), { recursive: true });
+  mkdirSync3(dirname14(target), { recursive: true });
   const newPath = `${target}.new`;
   const backupPath = `${target}.bak.${oldVersion}`;
   let strategy = "rename";
   try {
     copyFileSync(source, newPath);
-    if (existsSync4(target)) {
+    if (existsSync5(target)) {
       try {
         renameSync(target, backupPath);
       } catch (e) {
@@ -22189,7 +22495,7 @@ function atomicReplaceBundle(opts) {
     return { backupPath, strategy };
   } catch (e) {
     try {
-      if (existsSync4(newPath))
+      if (existsSync5(newPath))
         unlinkSync(newPath);
     } catch {}
     throw e;
@@ -22199,11 +22505,11 @@ function cleanupOldBackups(target, keep) {
   if (keep <= 0)
     return;
   try {
-    const dir = dirname13(target);
+    const dir = dirname14(target);
     const base = target.substring(dir.length + 1);
     const prefix = `${base}.bak.`;
     const all = readdirSync3(dir).filter((f) => f.startsWith(prefix)).map((f) => {
-      const full = join21(dir, f);
+      const full = join22(dir, f);
       let mtimeMs = 0;
       try {
         mtimeMs = statSync5(full).mtimeMs;
@@ -22225,9 +22531,9 @@ function loadCompatibility(opts) {
       const root = opts?.cwd ?? inferPluginRoot();
       if (!root)
         return null;
-      file = join21(root, "compatibility.json");
+      file = join22(root, "compatibility.json");
     }
-    if (!existsSync4(file))
+    if (!existsSync5(file))
       return null;
     const raw = readFileSync5(file, "utf8");
     const obj = JSON.parse(raw);
@@ -22249,8 +22555,8 @@ function loadCompatibility(opts) {
 }
 function inferPluginRoot() {
   try {
-    const here = fileURLToPath(import.meta.url);
-    return dirname13(dirname13(here));
+    const here = fileURLToPath2(import.meta.url);
+    return dirname14(dirname14(here));
   } catch {
     return null;
   }
@@ -22445,17 +22751,17 @@ function detectOpencodeVersion() {
 }
 function getOpencodeBundlePath() {
   const candidates = [];
-  candidates.push(join22(homedir8(), ".config", "opencode", "codeforge", "index.js"));
+  candidates.push(join23(homedir8(), ".config", "opencode", "codeforge", "index.js"));
   if (process.platform === "win32") {
     const appData = process.env["APPDATA"];
     if (appData)
-      candidates.push(join22(appData, "opencode", "codeforge", "index.js"));
+      candidates.push(join23(appData, "opencode", "codeforge", "index.js"));
     const localAppData = process.env["LOCALAPPDATA"];
     if (localAppData)
-      candidates.push(join22(localAppData, "opencode", "codeforge", "index.js"));
+      candidates.push(join23(localAppData, "opencode", "codeforge", "index.js"));
   }
   for (const c of candidates) {
-    if (existsSync5(c))
+    if (existsSync6(c))
       return c;
   }
   return candidates[0] ?? null;
@@ -22513,60 +22819,60 @@ async function postToast(ctx, message) {
 var handler23 = updateCheckerServer;
 
 // plugins/workflow-engine.ts
-import * as path26 from "node:path";
+import * as path27 from "node:path";
 
 // lib/workflow-loader.ts
 import { promises as fs20 } from "node:fs";
-import * as path25 from "node:path";
-import { z as z32 } from "zod";
-var ActionSchema = z32.object({
-  tool: z32.string().min(1, "action.tool 不能为空"),
-  args: z32.record(z32.string(), z32.unknown()).optional().default({}),
-  on_error: z32.enum(["retry", "skip", "abort"]).optional()
+import * as path26 from "node:path";
+import { z as z33 } from "zod";
+var ActionSchema = z33.object({
+  tool: z33.string().min(1, "action.tool 不能为空"),
+  args: z33.record(z33.string(), z33.unknown()).optional().default({}),
+  on_error: z33.enum(["retry", "skip", "abort"]).optional()
 });
-var StepSchema = z32.object({
-  name: z32.string().min(1, "step.name 不能为空"),
-  agent: z32.string().min(1, "step.agent 不能为空").describe("agent 名（与 agents/<name>.md 对应）"),
-  description: z32.string().optional(),
-  inject_context: z32.record(z32.string(), z32.unknown()).optional(),
-  requires_human_approval: z32.boolean().optional().default(false),
-  actions: z32.array(ActionSchema).optional().default([]),
-  on_error: z32.enum(["retry", "skip", "abort"]).optional().default("abort"),
-  max_retries: z32.number().int().min(0).max(10).optional().default(2),
-  timeout: z32.string().regex(/^\d+(?:ms|s|m|h)$/, "timeout 必须是 数字+单位（ms/s/m/h），如 5m").optional(),
-  auto_feedback: z32.object({
-    test_cmd: z32.string().optional().describe("测试命令，如 npm test"),
-    lint_cmd: z32.string().optional().describe("lint 命令，如 npm run lint"),
-    max_retries: z32.number().int().min(1).max(10).optional().default(3),
-    error_excerpt_lines: z32.number().int().min(1).max(50).optional().default(5),
-    escalate_to: z32.string().optional().default("reviewer").describe("超上限后兜底 agent，默认 reviewer")
+var StepSchema = z33.object({
+  name: z33.string().min(1, "step.name 不能为空"),
+  agent: z33.string().min(1, "step.agent 不能为空").describe("agent 名（与 agents/<name>.md 对应）"),
+  description: z33.string().optional(),
+  inject_context: z33.record(z33.string(), z33.unknown()).optional(),
+  requires_human_approval: z33.boolean().optional().default(false),
+  actions: z33.array(ActionSchema).optional().default([]),
+  on_error: z33.enum(["retry", "skip", "abort"]).optional().default("abort"),
+  max_retries: z33.number().int().min(0).max(10).optional().default(2),
+  timeout: z33.string().regex(/^\d+(?:ms|s|m|h)$/, "timeout 必须是 数字+单位（ms/s/m/h），如 5m").optional(),
+  auto_feedback: z33.object({
+    test_cmd: z33.string().optional().describe("测试命令，如 npm test"),
+    lint_cmd: z33.string().optional().describe("lint 命令，如 npm run lint"),
+    max_retries: z33.number().int().min(1).max(10).optional().default(3),
+    error_excerpt_lines: z33.number().int().min(1).max(50).optional().default(5),
+    escalate_to: z33.string().optional().default("reviewer").describe("超上限后兜底 agent，默认 reviewer")
   }).refine((d) => Boolean(d.test_cmd || d.lint_cmd), { message: "auto_feedback 必须至少配置 test_cmd 或 lint_cmd 之一" }).optional(),
-  on_decision: z32.object({
-    APPROVE: z32.union([
-      z32.literal("continue"),
-      z32.literal("abort"),
-      z32.object({ action: z32.literal("goto"), target: z32.string().min(1) })
+  on_decision: z33.object({
+    APPROVE: z33.union([
+      z33.literal("continue"),
+      z33.literal("abort"),
+      z33.object({ action: z33.literal("goto"), target: z33.string().min(1) })
     ]).optional(),
-    REQUEST_CHANGES: z32.union([
-      z32.literal("continue"),
-      z32.literal("abort"),
-      z32.object({ action: z32.literal("goto"), target: z32.string().min(1) })
+    REQUEST_CHANGES: z33.union([
+      z33.literal("continue"),
+      z33.literal("abort"),
+      z33.object({ action: z33.literal("goto"), target: z33.string().min(1) })
     ]).optional(),
-    BLOCK: z32.union([
-      z32.literal("continue"),
-      z32.literal("abort"),
-      z32.object({ action: z32.literal("goto"), target: z32.string().min(1) })
+    BLOCK: z33.union([
+      z33.literal("continue"),
+      z33.literal("abort"),
+      z33.object({ action: z33.literal("goto"), target: z33.string().min(1) })
     ]).optional()
   }).refine((d) => Boolean(d.APPROVE || d.REQUEST_CHANGES || d.BLOCK), { message: "on_decision 必须至少配置 APPROVE / REQUEST_CHANGES / BLOCK 之一" }).optional()
 }).strict();
-var WorkflowSchema = z32.object({
-  name: z32.string().min(1, "workflow.name 不能为空"),
-  description: z32.string().optional().default(""),
-  version: z32.string().optional().default("1.0.0"),
-  trigger: z32.string().min(1).refine((v) => /^\/[a-z][\w-]*$/.test(v) || /^event:[a-z][\w.-]+$/.test(v), "trigger 必须是 /command-name 或 event:xxx 形式"),
-  context_template: z32.string().optional(),
-  max_loops: z32.number().int().min(1).max(10).optional().default(3),
-  steps: z32.array(StepSchema).min(1, "workflow.steps 不能为空")
+var WorkflowSchema = z33.object({
+  name: z33.string().min(1, "workflow.name 不能为空"),
+  description: z33.string().optional().default(""),
+  version: z33.string().optional().default("1.0.0"),
+  trigger: z33.string().min(1).refine((v) => /^\/[a-z][\w-]*$/.test(v) || /^event:[a-z][\w.-]+$/.test(v), "trigger 必须是 /command-name 或 event:xxx 形式"),
+  context_template: z33.string().optional(),
+  max_loops: z33.number().int().min(1).max(10).optional().default(3),
+  steps: z33.array(StepSchema).min(1, "workflow.steps 不能为空")
 }).strict();
 function parseWorkflowYaml(yaml, sourcePath = "<inline>") {
   let raw;
@@ -22630,7 +22936,7 @@ async function loadWorkflowsFromDir(dir) {
       continue;
     if (!/\.ya?ml$/i.test(name))
       continue;
-    const full = path25.join(dir, name);
+    const full = path26.join(dir, name);
     const r = await loadWorkflowFromFile(full);
     if (r.ok)
       loaded.push(r);
@@ -23020,7 +23326,7 @@ async function handleCommandInvoked(raw, workflowsDir = "workflows") {
 }
 var workflowEngineServer = async (ctx) => {
   const directory = ctx.directory ?? process.cwd();
-  const workflowsDir = path26.join(directory, "workflows");
+  const workflowsDir = path27.join(directory, "workflows");
   ensureRegistry(workflowsDir).catch((err) => fallbackLog2.warn(`[${PLUGIN_NAME24}] preload workflows failed`, {
     error: err instanceof Error ? err.message : String(err)
   }));
@@ -23064,7 +23370,7 @@ var workflowEngineServer = async (ctx) => {
 var handler24 = workflowEngineServer;
 
 // plugins/session-worktree-guard.ts
-import path27 from "node:path";
+import path28 from "node:path";
 var PLUGIN_NAME25 = "session-worktree-guard";
 logLifecycle(PLUGIN_NAME25, "import", {});
 var WRITE_INTENT_RE = />(?![=&])(?!\s*\/dev\/(?:null|stdout|stderr|fd\/\d+)\b)|\btee\b|\brm\b|\bmv\b|\bcp\b|\bmkdir\b|\btouch\b|\bchmod\b|\bchown\b|\bln\b/;
@@ -23169,23 +23475,23 @@ var CLASS_B_CALLER_WHITELIST = new Set([
   "reviewer-lite",
   "general"
 ]);
-var CODEFORGE_WORKTREE_DIR_NAME = path27.join(".git", "codeforge-worktrees");
+var CODEFORGE_WORKTREE_DIR_NAME = path28.join(".git", "codeforge-worktrees");
 function worktreesRoot(mainRoot) {
-  return path27.join(mainRoot, CODEFORGE_WORKTREE_DIR_NAME);
+  return path28.join(mainRoot, CODEFORGE_WORKTREE_DIR_NAME);
 }
 function isInsideAnyWorktreeDir(absPath, mainRoot) {
-  if (!path27.isAbsolute(absPath))
+  if (!path28.isAbsolute(absPath))
     return false;
   const root = worktreesRoot(mainRoot);
   if (absPath === root)
     return false;
-  const prefix = root.endsWith(path27.sep) ? root : root + path27.sep;
+  const prefix = root.endsWith(path28.sep) ? root : root + path28.sep;
   return absPath.startsWith(prefix);
 }
 function rewritePath(value, mainRoot, worktreeRoot) {
   if (!value)
     return null;
-  const resolved = path27.isAbsolute(value) ? value : path27.resolve(mainRoot, value);
+  const resolved = path28.isAbsolute(value) ? value : path28.resolve(mainRoot, value);
   const wtPrefix2 = worktreeRoot.endsWith("/") ? worktreeRoot : worktreeRoot + "/";
   if (resolved === worktreeRoot || resolved.startsWith(wtPrefix2)) {
     return null;
@@ -23223,7 +23529,7 @@ function commandContainsMainRootExcludingWorktree(command, mainRoot, worktreePat
     }
   }
   const wtRoot = worktreesRoot(mainRoot);
-  const wtRootPrefix = wtRoot + path27.sep;
+  const wtRootPrefix = wtRoot + path28.sep;
   const escapedWtRootPrefix = escapeRegex2(wtRootPrefix);
   const wtPathPattern = escapedWtRootPrefix + `[^\\s'"\\x60)]*`;
   const allWorktreePathsReForEscape = new RegExp(wtPathPattern, "g");
@@ -23278,8 +23584,8 @@ function collectWritePaths(toolName, argsObj, worktreeRoot) {
   const candidate = toolName === "write" || toolName === "edit" ? argsObj["filePath"] : toolName === "ast_edit" ? argsObj["target"] : undefined;
   if (typeof candidate !== "string" || candidate.length === 0)
     return out;
-  const abs = path27.isAbsolute(candidate) ? candidate : path27.resolve(worktreeRoot, candidate);
-  const rel = path27.relative(worktreeRoot, abs).split(path27.sep).join("/");
+  const abs = path28.isAbsolute(candidate) ? candidate : path28.resolve(worktreeRoot, candidate);
+  const rel = path28.relative(worktreeRoot, abs).split(path28.sep).join("/");
   out.push(rel);
   return out;
 }
@@ -23670,12 +23976,12 @@ var sessionWorktreeGuardPlugin = async (ctx) => {
 var handler25 = sessionWorktreeGuardPlugin;
 
 // lib/opencode-session-probe.ts
-import * as path28 from "node:path";
+import * as path29 from "node:path";
 import * as os6 from "node:os";
 import { createRequire as createRequire2 } from "node:module";
 var requireFromHere = createRequire2(import.meta.url);
 var DEFAULT_LIVENESS_MS = 6 * 60 * 60000;
-var DEFAULT_DB_PATH = path28.join(os6.homedir(), ".local/share/opencode/opencode.db");
+var DEFAULT_DB_PATH = path29.join(os6.homedir(), ".local/share/opencode/opencode.db");
 function createSessionProbe(opts = {}) {
   const dbPath = opts.dbPath ?? DEFAULT_DB_PATH;
   const httpBaseUrl = opts.httpBaseUrl ?? process.env["OPENCODE_SERVER_URL"];