add-coder 0.3.27 → 0.3.29

package/templates/adapters/claude/hooks/prompt-submit.ts

@@ -0,0 +1,82 @@
+// prompt-submit.ts — UserPromptSubmit 入口（Claude 版，Task 3.1 继承体系）
+// 继承 core PromptRouter（模板方法固化 L1/L2/L3 分流）；仅 override 协议差异（bash 原文逐字对照）:
+//   ① extractPrompt: grep 正则提取（无 jq）
+//   ② acceptedText: 验收 4 行（无 ★ 同步检查行）
+//   ③ onAccepted: 无 review-checklist 子进程（core 有）
+//   ④ onDevKwMatched: stderr "[ADD PromptSubmit] 检测到开发关键词"
+//   ⑤ layer2ToStderr: false（Layer2 提示输出 stdout）
+//   ⑥ layer3Text: 「[ADD 当前状态]」多行块
+//   ⑦ dailyWarnText: 「建议创建 Plan」（无"或检查 hooks 误报"）
+//   ⑧ afterLayer3: 模板全文注入（--full --top 5，tpl-injected 去重）
+//   ⑨ shouldSkipDaily: MAGIC_DIR 未设置时跳过日报
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { PreloadTemplates } from "../../../core/governance/preload-templates.js"
+import { PromptRouter } from "../../../core/governance/prompt-router.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+
+class ClaudePromptRouter extends PromptRouter {
+  /** ① prompt 提取（对齐 bash grep/sed，无 jq） */
+  protected override extractPrompt(input: string): string {
+    return input.match(/"prompt"\s*:\s*"([^"]*)"/)?.[1] ?? ""
+  }
+
+  /** ② 验收幂等文本（claude 4 行，无 ★ 同步检查） */
+  protected override acceptedText(): string {
+    return `[ADD 验收] ⚠️ 已验收。进入 Review 模式:
+  ① 重新检查 checklist [T]/[R] 项
+  ② 审查 audit 记录完整性
+  ③ 如有差异 → Review 回流至 handoff（增量更新）
+  ④ 无差异 → 记录 'Review 已确认，无新发现'
+`
+  }
+
+  /** ③ 验收后置（claude 无 review-checklist 子进程） */
+  protected override onAccepted(_handoff: string, _addRoute: string): void {
+    // claude 协议: 无子进程调用
+  }
+
+  /** ④ 开发关键词命中提示（stderr） */
+  protected override onDevKwMatched(): void {
+    process.stderr.write("[ADD PromptSubmit] 检测到开发关键词\n")
+  }
+
+  /** ⑤ Layer 2 输出通道（claude: stdout） */
+  protected override layer2ToStderr(): boolean {
+    return false
+  }
+
+  /** ⑥ Layer 3 状态文本（多行块） */
+  protected override layer3Text(plan: string, rounds: string, step: string, handoff: string): string {
+    return `[ADD 当前状态]
+  Plan: ${plan}
+  轮次: ${rounds}
+  当前 Step: ${step}
+  handoff: ${handoff}
+`
+  }
+
+  /** ⑦ 日报告警文本（无"或检查 hooks 误报"） */
+  protected override dailyWarnText(noPlan: number, threshold: number): string {
+    return `[Hook ⚠️] 无 Plan 提示已达 ${noPlan} 次（≥${threshold}），建议创建 Plan\n`
+  }
+
+  /** ⑧ Layer 3 附加注入: 模板全文（--full --top 5） */
+  protected override afterLayer3(): void {
+    try {
+      process.stdout.write(new PreloadTemplates().full(5))
+    } catch {
+      /* 模板目录缺失 fail-fast：不阻断 */
+    }
+  }
+
+  /** ⑨ MAGIC_DIR 未设置时跳过日报（TS 修复: bash 空路径相对检查） */
+  protected override shouldSkipDaily(): boolean {
+    return !process.env.MAGIC_DIR
+  }
+}
+
+const input = readHookInput()
+process.exit(new ClaudePromptRouter(process.env.MAGIC_DIR || "").run(input))

package/templates/adapters/claude/hooks/review-checklist.ts

@@ -0,0 +1,4 @@
+// review-checklist.ts — Review 检查清单校验（Claude 版，与 core 同构）
+
+process.stdout.write("[ADD ReviewChecklist] 请在提交前确认 checklist.md 全部项已勾选。\n")
+process.exit(0)

package/templates/adapters/claude/hooks/session-end.ts

@@ -0,0 +1,10 @@
+// session-end.ts — SessionEnd Claude 版（薄包装：source lib 并自动执行 main）
+// 治理卡位 #2: 标记清理 + 会话审计结算 + Stop未触发兜底
+// 薄包装语义: bash 版 source lib/session-end.sh 后 lib 的 main 自动执行（BASH_SOURCE 判定）。
+// TS 版等价: 直接调用 SessionEndGuard.run()（lib 版行为）。
+
+import { SessionEndGuard } from "../../../core/governance/session-end.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+process.exit(new SessionEndGuard(process.env.PROJECT_DIR).run())

package/templates/adapters/claude/hooks/session-start.ts

@@ -0,0 +1,24 @@
+// session-start.ts — SessionStart 入口（Claude 版，Task 3.1 继承体系）
+// 继承 core SessionStartGuard；仅 override 协议差异（bash 原文对照）:
+//   ① PROJECT_DIR 来源 CLAUDE_PROJECT_DIR（claude-env 注入链）
+//   ② 无 ③ 代办段、无 ④ HITL 待审批段（claude bash 版无此两段）
+
+import { SessionStartGuard } from "../../../core/governance/session-start-guard.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+const PROJECT_DIR = process.env.PROJECT_DIR
+
+class ClaudeSessionStartGuard extends SessionStartGuard {
+  /** ② claude 版无代办段 */
+  protected override emitTodoReminder(_state: string | null): void {
+    // claude 协议: 无代办刷新段
+  }
+
+  /** ② claude 版无 HITL 待审批段 */
+  protected override emitHitlPending(): void {
+    // claude 协议: 无 HITL 检测段
+  }
+}
+
+process.exit(new ClaudeSessionStartGuard(PROJECT_DIR).run())

package/templates/adapters/claude/hooks/stop-check.ts

@@ -0,0 +1,15 @@
+// stop-check.ts — Stop 入口薄壳（Claude 版，Task 3.1 收敛）
+// 治理逻辑: ../../../core/governance/stop-router.js（StopRouter Q0-Q4 分流）
+// 协议差异: PROJECT_DIR 来源 CLAUDE_PROJECT_DIR（claude-env 注入链）
+
+import { tryResolveMagicDir } from "../../../core/governance/common.js"
+import { StopRouter } from "../../../core/governance/stop-router.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+const inferredMagicDir = tryResolveMagicDir()
+if (inferredMagicDir && !process.env.MAGIC_DIR) {
+  process.env.MAGIC_DIR = inferredMagicDir
+}
+
+process.exit(new StopRouter().run())

package/templates/adapters/claude/hooks/stop-failure.ts

@@ -0,0 +1,34 @@
+// stop-failure.ts — Claude Code StopFailure 紧急审计转储（Claude 独有事件）
+// 治理卡位 #8: 紧急审计转储 + 异常标记
+
+import { writeFileSync } from "node:fs"
+import { detectActiveAdd, localIsoSeconds, projectHash } from "../../../core/governance/common.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+const PROJECT_DIR = resolveClaudeProjectDir()
+// 对齐 bash export PROJECT_DIR（后续 hash/路径均消费该值）
+process.env.PROJECT_DIR = PROJECT_DIR
+
+process.stderr.write(`[ADD StopFailure] ⚠️ Agent 异常退出 — ${localIsoSeconds()}\n`)
+
+// 尝试 dump 当前 ADD 状态
+const state = detectActiveAdd()
+if (state !== null) {
+  const [plan, step, rounds, handoff, addRoute] = state.split("::")
+  process.stderr.write(`[ADD StopFailure] 异常退出时 ADD 状态:
+  Plan: ${plan}
+  Step: ${step}
+  轮次: ${rounds}
+  handoff: ${handoff}
+  add-route: ${addRoute}
+`)
+}
+
+// 标记异常终止（供 SessionEnd 兜底识别）
+try {
+  writeFileSync(`/tmp/add_failure_${projectHash() || ""}`, "")
+} catch {
+  /* ignore（对齐 touch || true） */
+}
+
+process.exit(0)

package/templates/adapters/claude/hooks/subagent-guard.ts

@@ -0,0 +1,25 @@
+// subagent-guard.ts — SubagentStart 入口（Claude 版，Task 3.1 继承体系）
+// 继承 core SubagentGuardRouter（状态注入模板方法——能力对齐）；仅 override 协议差异:
+//   ① 输出形态: 纯文本状态块（core/qoder 是 hookSpecificOutput JSON）
+//   ② PROJECT_DIR 来源 CLAUDE_PROJECT_DIR（claude-env 注入链）
+
+import { SubagentGuardRouter } from "../../../core/governance/subagent-guard-router.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+
+class ClaudeSubagentGuardRouter extends SubagentGuardRouter {
+  /** ① 纯文本状态块（claude 协议） */
+  protected override emit(state: string): void {
+    const [plan, step, rounds, handoff] = state.split("::")
+    process.stdout.write(`[ADD SubagentStart] 子代理上下文注入:
+  Plan: ${plan}
+  Step: ${step}
+  轮次: ${rounds}
+  handoff: ${handoff}
+  遵循 ADD 规范，完成后请检查 checklist 对应项
+`)
+  }
+}
+
+process.exit(new ClaudeSubagentGuardRouter().run())

package/templates/adapters/claude/hooks/subagent-stop.ts

@@ -0,0 +1,12 @@
+// subagent-stop.ts — SubagentStop 入口薄壳（Claude 版，Task 3.1 继承体系）
+// 治理逻辑: core SubagentStopRouter（边界校验 + 审计聚合，与 core 完全同构）
+// 协议差异: PROJECT_DIR 来源 CLAUDE_PROJECT_DIR（依赖注入，无 override 需求）
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { SubagentStopRouter } from "../../../core/governance/subagent-stop-router.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+
+const input = readHookInput()
+process.exit(new SubagentStopRouter().run(input))

package/templates/adapters/claude/settings.json

@@ -5,7 +5,7 @@
                 "hooks": [
                     {
                         "type": "command",
-                        "command": ".claude/hooks/session-start.sh"
+                        "command": "node .claude/hooks/session-start.mjs"
                     }
                 ]
             }
@@ -15,7 +15,7 @@
                 "hooks": [
                     {
                         "type": "command",
-                        "command": ".claude/hooks/prompt-submit.sh"
+                        "command": "node .claude/hooks/prompt-submit.mjs"
                     }
                 ]
             }
@@ -26,11 +26,11 @@
                 "hooks": [
                     {
                         "type": "command",
-                        "command": ".claude/hooks/pre-tool-use.sh"
+                        "command": "node .claude/hooks/pre-tool-use.mjs"
                     },
                     {
                         "type": "command",
-                        "command": ".claude/hooks/doc-format-guard.sh"
+                        "command": "node .claude/hooks/doc-format-guard.mjs"
                     }
                 ]
             }
@@ -41,11 +41,11 @@
                 "hooks": [
                     {
                         "type": "command",
-                        "command": ".claude/hooks/post-tool-use.sh"
+                        "command": "node .claude/hooks/post-tool-use.mjs"
                     },
                     {
                         "type": "command",
-                        "command": ".claude/hooks/doc-format-guard.sh"
+                        "command": "node .claude/hooks/doc-format-guard.mjs"
                     }
                 ]
             }
@@ -55,7 +55,7 @@
                 "hooks": [
                     {
                         "type": "command",
-                        "command": ".claude/hooks/post-tool-failure.sh"
+                        "command": "node .claude/hooks/post-tool-failure.mjs"
                     }
                 ]
             }
@@ -65,7 +65,7 @@
                 "hooks": [
                     {
                         "type": "command",
-                        "command": ".claude/hooks/stop-check.sh"
+                        "command": "node .claude/hooks/stop-check.mjs"
                     }
                 ]
             }
@@ -75,7 +75,7 @@
                 "hooks": [
                     {
                         "type": "command",
-                        "command": ".claude/hooks/subagent-guard.sh"
+                        "command": "node .claude/hooks/subagent-guard.mjs"
                     }
                 ]
             }
@@ -85,7 +85,7 @@
                 "hooks": [
                     {
                         "type": "command",
-                        "command": ".claude/hooks/subagent-guard.sh"
+                        "command": "node .claude/hooks/subagent-guard.mjs"
                     }
                 ]
             }
@@ -95,7 +95,7 @@
                 "hooks": [
                     {
                         "type": "command",
-                        "command": ".claude/hooks/pre-compact.sh"
+                        "command": "node .claude/hooks/pre-compact.mjs"
                     }
                 ]
             }
@@ -106,7 +106,7 @@
                 "hooks": [
                     {
                         "type": "command",
-                        "command": ".claude/hooks/notification.sh"
+                        "command": "node .claude/hooks/notification.mjs"
                     }
                 ]
             }
@@ -116,7 +116,7 @@
                 "hooks": [
                     {
                         "type": "command",
-                        "command": ".claude/hooks/permission-gate.sh"
+                        "command": "node .claude/hooks/permission-gate.mjs"
                     }
                 ]
             }

package/templates/adapters/codex/hooks/doc-format-guard.ts

@@ -0,0 +1,30 @@
+// doc-format-guard.ts — schema.json 驱动的 ADD 文档格式守卫（Codex 版，Task 7.1 继承体系）
+// 继承 core DocFormatGuard，命名子类 CodexDocFormatGuard:
+//   ① 探测链与 core 数据驱动同语义（PLAN 元信息 → 一、Plan 概述 → 四、Handoff → simple-plan，
+//      2026-08-14 实态核验 codex 独立类 L133-135 与 core 基线一致）→ 当前无 override
+//      （空子类承载端身份 + 未来演进位）
+// 协议差异仅剩: MAGIC_DIR 兜底 = ".codex"（构造参数）
+
+import { readFileSync } from "node:fs"
+import { DocFormatGuard } from "../../../core/governance/doc-format-guard.js"
+
+class CodexDocFormatGuard extends DocFormatGuard {
+  /** 协议差异封装: MAGIC_DIR 兜底 = ".codex"（codex 端） */
+  constructor(projectDir: string, magicDir: string) {
+    super(projectDir, magicDir)
+  }
+
+  // 当前无 override（探测链/算法段同 core）；未来 codex 协议演进在此扩展，不改 core
+}
+
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+const MAGIC_DIR = process.env.MAGIC_DIR || ".codex"
+
+const guard = new CodexDocFormatGuard(PROJECT_DIR, MAGIC_DIR)
+let raw = ""
+try {
+  raw = readFileSync(0, "utf-8")
+} catch {
+  raw = ""
+}
+process.exitCode = guard.run(raw)

package/templates/adapters/codex/hooks/notification.ts

@@ -0,0 +1,26 @@
+// notification.ts — Notification 入口（Codex 版，Task 7.1 继承体系）
+// 继承 core NotificationRouter，命名子类 CodexNotificationRouter:
+//   ① resolveMagicDir override: 无探测循环（codex bash 原文硬编码 .codex；
+//      TS 用唯一解析链：注入优先 → 物理推导 → .codex 兜底，2026-08-14 轮次 7 治理契约落实）
+//   ② 提醒文本 = 基类默认（含 Plan 前缀，与 codex bash 原文一致）
+// 协议差异仅剩: PROJECT_DIR = $PWD（codex 小文件无 git toplevel，bash 原文逐字）
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { NotificationRouter } from "../../../core/governance/notification-router.js"
+
+class CodexNotificationRouter extends NotificationRouter {
+  /** ① codex 无跨端探测循环（bash 原文硬编码 .codex；唯一解析链 + 兜底） */
+  protected override resolveMagicDir(): string {
+    return process.env.MAGIC_DIR ?? ".codex"
+  }
+
+  /** 协议差异封装: fallbackMagicDir = ".codex" */
+  constructor(projectDir: string) {
+    super(projectDir, ".codex")
+  }
+}
+
+const input = readHookInput()
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+
+process.exit(new CodexNotificationRouter(PROJECT_DIR).run(input))

package/templates/adapters/codex/hooks/permission-gate.ts

@@ -0,0 +1,15 @@
+// permission-gate.ts — PermissionRequest 入口（Codex 版，Task 7.1 继承体系）
+// 继承 core PermissionGateRouter，命名子类 CodexPermissionGateRouter:
+//   ① tool_name 缺失回退 ""（bash `// empty` 语义）——基类默认，无 override
+//   ② emit = 基类默认（仅高风险工具 Bash/Write/Edit stdout 二次确认，bash 原文逐字）
+// 协议差异: 无（与 core 同构）；命名子类承载端身份 + 未来演进位
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { PermissionGateRouter } from "../../../core/governance/permission-gate-router.js"
+
+class CodexPermissionGateRouter extends PermissionGateRouter {
+  // 当前无 override（`// empty` 回退 + 高风险工具提示与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+const input = readHookInput()
+process.exit(new CodexPermissionGateRouter().run(input))

package/templates/adapters/codex/hooks/post-tool-failure.ts

@@ -0,0 +1,14 @@
+// post-tool-failure.ts — PostToolUseFailure 入口（Codex 版，Task 7.1 继承体系）
+// 继承 core PostToolFailureRouter，命名子类 CodexPostToolFailureRouter:
+//   ① emit = 基类默认（stdout 固定文本——bash 原文逐字，codex 为占位实现）
+// 协议差异: 无（与 core 同构）；命名子类承载端身份 + 未来演进位
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { PostToolFailureRouter } from "../../../core/governance/post-tool-failure-router.js"
+
+class CodexPostToolFailureRouter extends PostToolFailureRouter {
+  // 当前无 override（stdout 固定提示与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+const input = readHookInput()
+process.exit(new CodexPostToolFailureRouter().run(input))

package/templates/adapters/codex/hooks/post-tool-use.ts

@@ -0,0 +1,85 @@
+// post-tool-use.ts — PostToolUse 入口（Codex 版，Task 7.1 继承体系）
+// 继承 core PostToolRouter，命名子类 CodexPostToolRouter（codex 私有协议差异 override）:
+//   ① isFileTool: +SearchReplace（codex 支持 file_path/path 双字段）
+//   ② extractFilePath: file_path ?? path（codex 工具输入形态）
+//   ③ emitAuditReminder: 简化文本（无 ADD-7 字样，bash 原文逐字）
+//   ④ emitBashDone: lint/typecheck/test 闭环提示（bash 原文逐字）
+//   ⑤ applyPatchMatcher: 解析 `*** Add|Update|Delete File:` 行逐文件 report（codex apply_patch 特有）
+//   ⑥ docGuardText: 「请检查双向链接与 Plan/Spec 状态」（bash 原文逐字）
+// 入口差异: PROJECT_DIR=git toplevel（codex 大文件协议）+ MAGIC_DIR 注入
+
+import { execSync } from "node:child_process"
+import { jsonGet, readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PostToolRouter } from "../../../core/governance/post-tool-router.js"
+
+class CodexPostToolRouter extends PostToolRouter {
+  /** ① codex 文件写工具含 SearchReplace */
+  protected override isFileTool(toolName: string): boolean {
+    return toolName === "Edit" || toolName === "Write" || toolName === "SearchReplace"
+  }
+
+  /** ② file_path ?? path（codex 工具输入形态） */
+  protected override extractFilePath(input: string): string {
+    const fp = jsonGet(input, "file_path")
+    if (fp !== "") return fp
+    return jsonGet(input, "path")
+  }
+
+  /** ③ 审计提醒（codex bash 原文逐字——无 ADD-7 字样） */
+  protected override emitAuditReminder(filePath: string): string {
+    return `[ADD PostToolUse] 文件已写入: ${filePath}；请执行 record_dev_operation 落库审计。\n`
+  }
+
+  /** ④ Bash 增强（codex bash 原文逐字——lint/typecheck/test 闭环） */
+  protected override emitBashDone(): string {
+    return "[ADD PostToolUse] Bash 命令完成；若产生 lint/typecheck/test 错误，请在本轮闭环。\n"
+  }
+
+  /** ⑤ apply_patch: 解析 `*** Add|Update|Delete File:` 行逐文件 report（codex 特有） */
+  protected override applyPatchMatcher(input: string): void {
+    let patchCommand = ""
+    if (input.trim() !== "") {
+      try {
+        const parsed = JSON.parse(input) as { tool_input?: { command?: unknown } }
+        patchCommand = typeof parsed.tool_input?.command === "string" ? parsed.tool_input.command : ""
+      } catch {
+        patchCommand = ""
+      }
+    }
+    const patchPaths: string[] = []
+    for (const line of patchCommand.split("\n")) {
+      const m = line.match(/^\*\*\* (Add|Update|Delete) File: (.+)$/)
+      if (m) patchPaths.push(m[2])
+    }
+    for (const p of patchPaths) this.reportFile(p)
+  }
+
+  /** 对齐 bash _report_file：ADD 文档守卫 + 审计提醒（codex 版） */
+  private reportFile(filePath: string): void {
+    if (filePath === "") return
+    if (/(^|\/)\.codex\/(plans|specs|reviews)\//.test(filePath)) {
+      this.emitLine(`[ADD PostToolUse] ADD 文档已写入: ${filePath}；请检查双向链接与 Plan/Spec 状态。\n`)
+    }
+    this.emitLine(`[ADD PostToolUse] 文件已写入: ${filePath}；请执行 record_dev_operation 落库审计。\n`)
+    // Task 8.1: apply_patch 也是文件写入路径——接入审计桥接（ADD-7 自动化）
+    this.emitWriteEvent(filePath)
+  }
+}
+
+// 对齐 bash: git rev-parse --show-toplevel || pwd
+function resolveProjectDir(): string {
+  try {
+    return execSync("git rev-parse --show-toplevel", { encoding: "utf-8" }).trim()
+  } catch {
+    return process.cwd()
+  }
+}
+const PROJECT_DIR = resolveProjectDir()
+process.env.PROJECT_DIR = PROJECT_DIR
+process.env.MAGIC_DIR = tryResolveMagicDir() || ".codex"
+
+const input = readHookInput()
+const toolName = jsonGet(input, "tool_name")
+if (toolName === "") process.exit(0)
+
+process.exit(new CodexPostToolRouter(PROJECT_DIR, process.env.MAGIC_DIR).run(input, toolName))

package/templates/adapters/codex/hooks/pre-compact.ts

@@ -0,0 +1,20 @@
+// pre-compact.ts — 上下文压缩前 ADD 状态保存（Codex 版，Task 7.1 继承体系）
+// 继承 core PreCompactGuard，命名子类 CodexPreCompactGuard:
+//   ① 状态保存到恢复标记 + ② tpl 标记清理 = 基类（与 codex bash 原文逐字同构，
+//   2026-08-14 实态核验——手写版逻辑与 core 基类完全一致，收敛为子类）
+// 协议差异仅剩: PROJECT_DIR = $PWD（codex 小文件无 git toplevel，bash 原文逐字）
+//               + MAGIC_DIR 唯一解析链注入（.codex 兜底）
+
+import { tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PreCompactGuard } from "../../../core/governance/pre-compact-guard.js"
+
+class CodexPreCompactGuard extends PreCompactGuard {
+  // 当前无 override（状态保存/恢复清单/tpl 清理与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+process.env.PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+// 对齐 bash export MAGIC_DIR=".codex"：唯一解析链（注入优先 → 物理推导），推导失败回退 .codex
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+
+process.exit(new CodexPreCompactGuard().run())

package/templates/adapters/codex/hooks/pre-tool-use.ts

@@ -0,0 +1,141 @@
+// pre-tool-use.ts — PreToolUse 入口（Codex 版，Task 7.1 继承体系）
+// 继承 core PreToolUseGuard，命名子类 CodexPreToolUseGuard（codex 私有协议差异 override）:
+//   ① 检测链: adapterName="codex" → [guard.adapter_detectors] codex 链（同 core 正则 + codex reason）
+//   ② onBlock/onSensitiveDeny/onHitlDeny: JSON **deny** 形态（core 是 ask；codex bash 原文 _deny 逐字，
+//      stderr `⛔ [ADD PreToolUse] reason` + logBlock + 事件 + exit 2）
+//   ③ onOtherTool: apply_patch 特有（解析 `*** Add|Update|Delete File:` 路径 → guardFilePath 逐文件 + markDevAction）
+//   ④ ~~sensitiveFileRegex / hitlExemptReviews / hitlMarkers~~ → Task 9.4.4 三项上提 core 默认（2026-08-14）
+//   ⑤ noPlanHint: true——无 Plan 仅 stderr 提示后继续（codex 协议差异保留）
+// 入口差异: PROJECT_DIR=git toplevel + cd 统一 cwd + MAGIC_DIR 注入
+
+import { execSync } from "node:child_process"
+import { existsSync } from "node:fs"
+import { join } from "node:path"
+import { jsonGet, markDevAction, readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { writeHookEvent } from "../../../core/governance/notify.js"
+import { PreToolUseGuard } from "../../../core/governance/pre-tool-guard.js"
+
+class CodexPreToolUseGuard extends PreToolUseGuard {
+  constructor(projectDir: string, magicDir: string) {
+    super(projectDir, magicDir, "codex")
+  }
+
+  /** ② §A 阻断: JSON deny（core 是 ask——codex bash 原文 _deny 逐字） */
+  protected override onBlock(blocked: { reason: string; stderr: string }, command: string): number {
+    process.stderr.write(`⛔ [ADD PreToolUse] ${blocked.reason}\n`)
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: "PreToolUse",
+          permissionDecision: "deny",
+          permissionDecisionReason: blocked.reason,
+        },
+      }) + "\n"
+    )
+    this.logBlock("检测器链", command)
+    writeHookEvent("pre-tool-use", "deny", command, blocked.reason, this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** ② 敏感文件: JSON deny + 事件 + exit 2（core 无事件） */
+  protected override onSensitiveDeny(filePath: string): number {
+    const reason = `敏感文件受保护，禁止写入: ${filePath}`
+    process.stderr.write(`⛔ [ADD PreToolUse] ${reason}\n`)
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: "PreToolUse",
+          permissionDecision: "deny",
+          permissionDecisionReason: reason,
+        },
+      }) + "\n"
+    )
+    this.logBlock("sensitive-file", filePath)
+    writeHookEvent("pre-tool-use", "deny", `Write ${filePath}`, reason, this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** ② HITL: JSON deny + 事件 + exit 2（core 是 exit 0 放行——codex 阻断） */
+  protected override onHitlDeny(toolName: string, filePath: string, tongyiMarker: string): number {
+    const reason = `HITL 未同意: ${filePath}。请先 create_hitl，再由人工 update_hitl(TONGYI)。`
+    process.stderr.write(`⛔ [ADD PreToolUse] ${reason}\n`)
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: "PreToolUse",
+          permissionDecision: "deny",
+          permissionDecisionReason: reason,
+        },
+      }) + "\n"
+    )
+    this.logBlock("hitl", filePath)
+    writeHookEvent("pre-tool-use", "deny", `${toolName} ${filePath}`, `HITL 未同意: ${tongyiMarker}`, this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** ③ apply_patch: 解析 patch 路径 → guardFilePath 逐文件 + markDevAction（codex 特有） */
+  protected override onOtherTool(input: string, toolName: string): number {
+    if (toolName !== "apply_patch") return 0
+    let patchCommand = ""
+    if (input.trim() !== "") {
+      try {
+        const parsed = JSON.parse(input) as { tool_input?: { command?: unknown } }
+        patchCommand = typeof parsed.tool_input?.command === "string" ? parsed.tool_input.command : ""
+      } catch {
+        patchCommand = ""
+      }
+    }
+    const patchPaths: string[] = []
+    for (const line of patchCommand.split("\n")) {
+      const m = line.match(/^\*\*\* (Add|Update|Delete) File: (.+)$/)
+      if (m) patchPaths.push(m[2])
+    }
+    for (const p of patchPaths) {
+      if (p !== "") {
+        // Task 9.4 修复: guardFilePath 返回阻断码（敏感/HITL），apply_patch 路径必须透传 exit
+        const guardCode = this.guardFilePath(p, "apply_patch")
+        if (guardCode !== 0) return guardCode
+      }
+    }
+    markDevAction()
+    return 0
+  }
+
+  /** ⑦ 无 Plan 仅提示后继续（codex bash 原文） */
+  protected override noPlanHint(): boolean {
+    return true
+  }
+}
+// 注: ④ sensitiveFileRegex / ⑤ hitlExemptReviews / ⑥ hitlMarkers override 已删除——
+// 2026-08-14 Task 9.4.4 三项上提 core 默认（锚定正则 / 仅 -runtime 豁免 / 双哨兵），收敛无 diff。
+
+// 对齐 bash: git rev-parse --show-toplevel || pwd + cd
+function resolveProjectDir(): string {
+  try {
+    return execSync("git rev-parse --show-toplevel", { encoding: "utf-8" }).trim()
+  } catch {
+    return process.cwd()
+  }
+}
+const PROJECT_DIR = resolveProjectDir()
+process.env.PROJECT_DIR = PROJECT_DIR
+// 对齐 bash export MAGIC_DIR=".codex"：唯一解析链（注入优先 → 物理推导），推导失败回退 .codex
+const MAGIC_DIR = tryResolveMagicDir() || ".codex"
+process.env.MAGIC_DIR = MAGIC_DIR
+process.chdir(PROJECT_DIR) // 统一 cwd，避免从 repo 子目录启动时写偏审计文件
+
+const input = readHookInput()
+const toolName = jsonGet(input, "tool_name")
+// Task 9.4 修复: Bash 与 apply_patch 的 command 均在 tool_input——分流依据 tool_name
+// （原 jsonGet 顶层 command 判断会把 apply_patch 的 patch body 误当 Bash 命令走 §A）
+
+const guard = new CodexPreToolUseGuard(PROJECT_DIR, MAGIC_DIR)
+
+if (toolName === "Bash") {
+  process.exit(guard.runSectionA(input))
+} else if (toolName === "apply_patch") {
+  // apply_patch 的 payload 在 tool_input.command——只走 §C matcher（避免把 patch body 误判成 shell）
+  process.exit(guard.runSectionC(input, toolName))
+} else {
+  process.exit(guard.runSectionB(input, toolName))
+}