add-coder 0.3.26 → 0.3.28

package/templates/adapters/claude/hooks/permission-denied.ts

@@ -0,0 +1,33 @@
+// permission-denied.ts — Claude Code PermissionDenied 拒绝记录 + 替代方案（Claude 独有事件）
+// 治理卡位 #14: 拒绝原因记录 + 替代方案注入
+
+import { jsonGet, readHookInput } from "../../../core/governance/common.js"
+
+const input = readHookInput()
+let toolName = jsonGet(input, "tool_name")
+if (toolName === "") {
+  toolName = input.match(/"tool_name"\s*:\s*"([^"]*)"/)?.[1] ?? "unknown"
+}
+let reason = jsonGet(input, "reason")
+if (reason === "") {
+  reason = input.match(/"reason"\s*:\s*"([^"]*)"/)?.[1] ?? "权限被拒绝"
+}
+
+// 记录拒绝
+process.stderr.write(`[ADD PermissionDenied] ${toolName} 被拒绝: ${reason}\n`)
+
+// 按工具类型提供替代建议
+switch (toolName) {
+  case "Bash":
+    process.stderr.write("[ADD PermissionDenied] 建议: 使用安全的等价命令，或通过 permission-gate.sh 白名单放行\n")
+    break
+  case "Write":
+  case "Edit":
+    process.stderr.write("[ADD PermissionDenied] 建议: 检查目标路径是否在项目范围内，敏感文件（.env等）不可写入\n")
+    break
+  case "Read":
+    process.stderr.write("[ADD PermissionDenied] 建议: 该文件可能受读保护，尝试读取项目公有文件替代\n")
+    break
+}
+
+process.exit(0)

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

@@ -0,0 +1,12 @@
+// permission-gate.ts — PermissionRequest 权限请求门禁（Claude 版，与 core 同构）
+
+import { jsonGet, readHookInput } from "../../../core/governance/common.js"
+
+const input = readHookInput()
+const toolName = jsonGet(input, "tool_name")
+
+// 高风险工具需要二次确认
+if (toolName === "Bash" || toolName === "Write" || toolName === "Edit") {
+  process.stdout.write(`[ADD PermissionGate] 高风险工具: ${toolName}，请确认操作。\n`)
+}
+process.exit(0)

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

@@ -0,0 +1,4 @@
+// post-tool-failure.ts — PostToolUseFailure 工具失败后处理（Claude 版，与 core 同构）
+
+process.stdout.write("[ADD PostToolFailure] 工具调用失败，请检查错误信息并修复。\n")
+process.exit(0)

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

@@ -0,0 +1,17 @@
+// post-tool-use.ts — PostToolUse 入口薄壳（Claude 版，Task 4.1 能力对齐）
+// 继承 core PostToolRouter 无 override——六端实态核验（2026-08-14）:
+//   post-tool-use 六端均为纯文本 stderr（无协议形态差异），此前 claude 的
+//   「无 §1 DPS / 无 §2b-d / 增量修订文本」为 bash 时代能力漂移——统一收敛 core 全段。
+// 协议差异仅剩: PROJECT_DIR 来源 CLAUDE_PROJECT_DIR（claude-env 注入链）
+
+import { jsonGet, readHookInput } from "../../../core/governance/common.js"
+import { PostToolRouter } from "../../../core/governance/post-tool-router.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+
+const input = readHookInput()
+const toolName = jsonGet(input, "tool_name")
+if (toolName === "") process.exit(0)
+
+process.exit(new PostToolRouter(process.env.PROJECT_DIR, process.env.MAGIC_DIR || ".claude").run(input, toolName))

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

@@ -0,0 +1,10 @@
+// pre-compact.ts — 上下文压缩前 ADD 状态保存（Claude 版，Task 3.1 继承体系）
+// 治理逻辑: core PreCompactGuard（状态保存 + tpl 标记清理，与 core 同构）
+// 协议差异: PROJECT_DIR 来源 CLAUDE_PROJECT_DIR（依赖注入）
+
+import { PreCompactGuard } from "../../../core/governance/pre-compact-guard.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+
+process.exit(new PreCompactGuard().run())

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

@@ -0,0 +1,81 @@
+// pre-tool-use.ts — PreToolUse 入口（Claude 版，Task 3.1 继承体系）
+// 继承 core PreToolUseGuard（模板方法固化治理流程）；仅 override 协议差异:
+//   ① 检测链: 构造传 adapterName="claude" → 加载 [guard.adapter_detectors] 独立链
+//   ② onBlock: 纯 stderr（无 askJson / 无 logBlock）+ exit 2
+//   ③ onNoPlanAllow: 输出同 core 但 exit 2（bash 原文 L73 exit $EXIT_BLOCK）→ Task 9.4.2 修复对齐 exit 0
+//   ④ onSensitiveDeny: 纯 stderr（无 denyJson）+ 事件 + exit 2
+//   ⑤ onOtherTool: ③ Read matcher 模板提示（claude 特有）
+
+import { detectActiveAdd, 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"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+const PROJECT_DIR = process.env.PROJECT_DIR
+
+const magicDir = tryResolveMagicDir()
+if (magicDir && !process.env.MAGIC_DIR) {
+  process.env.MAGIC_DIR = magicDir
+}
+const MAGIC_DIR = process.env.MAGIC_DIR || ""
+
+class ClaudePreToolUseGuard extends PreToolUseGuard {
+  constructor(projectDir: string, magicDir: string) {
+    super(projectDir, magicDir, "claude")
+  }
+
+  /** ② §A 阻断: 纯 stderr（{{cmd}} 模板替换）+ 事件 + exit 2（无 askJson / logBlock） */
+  protected override onBlock(blocked: { reason: string; stderr: string }, command: string): number {
+    process.stderr.write(blocked.stderr.replaceAll("{{cmd}}", command))
+    writeHookEvent("pre-tool-use", "deny", command, blocked.reason, this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** §A 放行后处理: bash 原文 L56 mark_dev_action（core 无此行为） */
+  protected override onSectionAPass(_command: string): void {
+    markDevAction()
+  }
+
+  /** ③ §B 无 Plan 放行: 输出同 core（提示 + allowJson + 事件）+ exit 0（Task 9.4.2 修复: bash 原文 exit 2 缺陷对齐 core） */
+  protected override onNoPlanAllow(toolName: string, filePath: string): number {
+    process.stderr.write("[ADD 提示] 正在写入 Plan/Spec/Review 文档但无活跃 ADD Plan——首次创建场景放行，建议先执行 add-paradigm 生成 Plan+add-route\n")
+    process.stdout.write('{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"allow","permissionDecisionReason":"无活跃 ADD Plan 但为 Plan/Spec/Review 写入（首次创建场景），提示而非拦截"}}\n')
+    writeHookEvent("pre-tool-use", "info", filePath, "无活跃 ADD Plan 下写入 Plan/Spec/Review（首次创建放行）", this.planKeyword, this.planStatus)
+    return 0
+  }
+
+  /** ④ §B 敏感文件: 纯 stderr（无 denyJson）+ 事件 + exit 2 */
+  protected override onSensitiveDeny(filePath: string): number {
+    process.stderr.write(`⛔ 敏感文件受保护，禁止写入: ${filePath}\n`)
+    writeHookEvent("pre-tool-use", "deny", filePath, "敏感文件受保护", this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** ⑤ ③ Read matcher: 模板路径兜底提示（claude 特有） */
+  protected override onOtherTool(input: string, toolName: string): number {
+    if (toolName === "Read") {
+      const filePath = jsonGet(input, "file_path")
+      if (filePath.includes("templates/")) {
+        process.stderr.write("[ADD PreToolUse] 提示: 模板文件已通过 hook 预读到上下文，可跳过重复读取\n")
+      }
+    }
+    return 0
+  }
+}
+
+const input = readHookInput()
+let toolName = jsonGet(input, "tool_name")
+if (toolName === "") {
+  toolName = input.match(/"tool_name"\s*:\s*"([^"]*)"/)?.[1] ?? ""
+}
+
+const guard = new ClaudePreToolUseGuard(PROJECT_DIR, MAGIC_DIR)
+
+if (toolName === "Bash") {
+  process.exit(guard.runSectionA(input))
+} else if (toolName === "Write" || toolName === "Edit" || toolName === "SearchReplace") {
+  process.exit(guard.runSectionB(input, toolName))
+} else {
+  process.exit(guard.runSectionC(input, toolName))
+}

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/config.toml.example

@@ -0,0 +1,12 @@
+# Codex 项目级 MCP 配置模板（adapter 真源）
+# add-coder init/sync --adapter codex 会把该 server table 合并到 .codex/config.toml。
+# 只写项目配置；不会自动修改 ~/.codex/config.toml。
+
+[mcp_servers.add_coder]
+command = {{codexCommandToml}}
+args = {{codexArgsToml}}
+cwd = {{codexProjectRootToml}}
+startup_timeout_sec = 30
+
+[mcp_servers.add_coder.env]
+PROJECT_ROOT = {{codexProjectRootToml}}

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))