add-coder 0.3.26 → 0.3.28

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

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

@@ -0,0 +1,38 @@
+// prompt-submit.ts — UserPromptSubmit 入口（Codex 版，Task 7.1 继承体系）
+// 继承 core PromptRouter（L1/L2/L3 模板方法）；仅 override 协议差异（bash 原文逐字对照）:
+//   ① extractPrompt = 基类默认（jsonGet 与 bash jq 同语义）
+//   ② acceptedText = 基类默认（codex bash 原文 6 行含 ★ 同步检查，与 core 逐字一致）
+//   ③ onAccepted: 输出 review-checklist 占位文本（codex bash 调占位脚本；core 是子进程 stdio ignore）
+//   ④ layer2ToStderr = 基类默认 true（codex bash 原文 Layer2 走 stderr）
+//   ⑤ layer3Text/日报 = 基类默认（codex bash 原文与 core 逐字一致）
+// 入口差异: PROJECT_DIR=git toplevel + cd 统一 cwd（codex 大文件协议）+ MAGIC_DIR 注入
+
+import { execSync } from "node:child_process"
+import { readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PromptRouter } from "../../../core/governance/prompt-router.js"
+
+class CodexPromptRouter extends PromptRouter {
+  /** ③ 验收后置: 输出 review-checklist 占位文本（codex bash 调占位脚本逐字） */
+  protected override onAccepted(_handoff: string, _addRoute: string): void {
+    process.stdout.write("[ADD ReviewChecklist] 请在提交前确认 checklist.md 全部项已勾选。\n")
+  }
+
+  // 其余（extractPrompt/acceptedText/layer2ToStderr/layer3Text/dailyWarnText）与 core 基线一致
+}
+
+// 对齐 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
+process.env.MAGIC_DIR = tryResolveMagicDir() || ".codex"
+process.chdir(PROJECT_DIR) // 对齐 bash cd "$PROJECT_DIR"
+
+const input = readHookInput()
+process.exit(new CodexPromptRouter(process.env.MAGIC_DIR).run(input))

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

@@ -0,0 +1,5 @@
+// review-checklist.ts — Review 检查清单校验（Codex 版）
+// bash 版缺陷修复: SHARED_LIB 路径断裂，TS 版 import core common.js（内联）。
+
+process.stdout.write("[ADD ReviewChecklist] 请在提交前确认 checklist.md 全部项已勾选。\n")
+process.exit(0)

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

@@ -0,0 +1,19 @@
+// session-end.ts — SessionEnd 入口（Codex 版，Task 7.1 继承体系）
+// 继承 core SessionEndGuard，命名子类 CodexSessionEndGuard:
+//   ① 清理标记（tpl + dev）+ ② 审计结算（stderr）+ ③ Stop 兜底 = 基类
+//   （2026-08-14 实态核验: codex 手写版与 core SessionEndGuard 逐字同构，收敛为子类）
+// 协议差异仅剩: PROJECT_DIR = $PWD（codex 小文件无 git toplevel）+ MAGIC_DIR 注入
+
+import { tryResolveMagicDir } from "../../../core/governance/common.js"
+import { SessionEndGuard } from "../../../core/governance/session-end.js"
+
+class CodexSessionEndGuard extends SessionEndGuard {
+  // 当前无 override（清理/结算/兜底与 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 CodexSessionEndGuard(process.env.PROJECT_DIR).run())

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

@@ -0,0 +1,45 @@
+// session-start.ts — SessionStart 入口（Codex 版，Task 7.1 继承体系）
+// 继承 core SessionStartGuard，命名子类 CodexSessionStartGuard:
+//   ① emitState/emitTodoReminder/emitHitlPending = 基类默认（bash 原文逐字一致）
+//   ② emitIndex override: 自定义列表格式（codex bash 原文——`## ADD 可用模板清单` + `- f` 简单列出，
+//      非 PreloadTemplates 表格格式）
+// 入口差异: PROJECT_DIR=git toplevel（codex 大文件协议）+ MAGIC_DIR 注入（.codex 兜底）
+
+import { existsSync, readdirSync } from "node:fs"
+import { join } from "node:path"
+import { execSync } from "node:child_process"
+import { tryResolveMagicDir } from "../../../core/governance/common.js"
+import { SessionStartGuard } from "../../../core/governance/session-start-guard.js"
+
+class CodexSessionStartGuard extends SessionStartGuard {
+  /** ② 模板索引: 自定义列表格式（codex bash 原文逐字，非表格） */
+  protected override emitIndex(): void {
+    const TEMPLATES_DIR = join(this.projectDir, this.magicDir, "templates")
+    if (existsSync(TEMPLATES_DIR)) {
+      process.stdout.write("## ADD 可用模板清单\n")
+      try {
+        for (const f of readdirSync(TEMPLATES_DIR)) {
+          if (f.endsWith(".md")) process.stdout.write(`- ${f}\n`)
+        }
+      } catch {
+        /* ignore（对齐 bash 读取失败跳过） */
+      }
+    }
+  }
+}
+
+// 对齐 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
+// 对齐 bash export MAGIC_DIR=".codex"：唯一解析链（注入优先 → 物理推导），推导失败回退 .codex
+const MAGIC_DIR = tryResolveMagicDir() || ".codex"
+process.env.MAGIC_DIR = MAGIC_DIR
+
+process.exit(new CodexSessionStartGuard(PROJECT_DIR).run())

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

@@ -0,0 +1,59 @@
+// stop-check.ts — Stop 入口（Codex 版，Task 7.1 继承体系）
+// 继承 core StopRouter，命名子类 CodexStopRouter:
+//   ① Q0/Q1/Q2 = 基类默认（stderr + exit 语义，与 codex bash 原文逐字一致）
+//   ② emitQ3 override: {systemMessage} JSON（codex 私有协议——plan/approval/tasks 字段）
+//   ③ emitQ4Pass override: {systemMessage} JSON（codex stdout 契约——Q4 通过形态；
+//      ~~q4Check override~~ → 2026-08-14 Task 9.4.4④ 删除，回归 core 双维度组合（DB 进度 + checklist 质量））
+// 入口差异: PROJECT_DIR=git toplevel（codex 大文件协议）+ stopHookActive 续跑保护 + MAGIC_DIR 注入
+
+import { execSync } from "node:child_process"
+import { readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { StopRouter } from "../../../core/governance/stop-router.js"
+
+/** 对齐 bash jq -nc --arg message '{systemMessage: $message}'（codex 私有协议） */
+function systemMessage(message: string): string {
+  return JSON.stringify({ systemMessage: message })
+}
+
+class CodexStopRouter extends StopRouter {
+  /** ② Q3: systemMessage JSON（codex 协议——approval/tasks 字段，bash 原文逐字） */
+  protected override emitQ3(plan: string, approval: string, tasks: string): number {
+    process.stdout.write(systemMessage(`[ADD Stop] Plan: ${plan}；approval: ${approval}；tasks: ${tasks}。本次无代码改动。`) + "\n")
+    return 0
+  }
+
+  /** ③ Q4 通过: systemMessage JSON（codex stdout 契约——Task 9.4.4④ 新增，
+   *  原 q4Check 完成分支的 systemMessage 语义保留到协议层） */
+  protected override emitQ4Pass(): number {
+    process.stdout.write(systemMessage("[ADD Stop] ✅ 验收通过——checklist 全部勾选，devlog 已记录。DB Plan tasks 已完成；可进入 Review/closure。") + "\n")
+    return 0
+  }
+}
+
+// 对齐 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
+// 对齐 bash export MAGIC_DIR=".codex"：唯一解析链（注入优先 → 物理推导），推导失败回退 .codex
+process.env.MAGIC_DIR = tryResolveMagicDir() || ".codex"
+
+const input = readHookInput()
+let stopHookActive = false
+if (input.trim() !== "") {
+  try {
+    const parsed = JSON.parse(input) as { stop_hook_active?: unknown }
+    stopHookActive = parsed.stop_hook_active === true
+  } catch {
+    stopHookActive = false
+  }
+}
+// codex 续跑保护: 内部 Stop 触发时跳过（bash 原文逐字）
+if (stopHookActive) process.exit(0)
+
+process.exit(new CodexStopRouter().run())

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

@@ -0,0 +1,22 @@
+// subagent-guard.ts — SubagentStart 入口（Codex 版，Task 3.1 继承体系）
+// 继承 core SubagentGuardRouter（状态注入模板方法——能力对齐）:
+//   能力对齐注: 原 codex 为弱版（事件提示空话），已对齐强版（状态注入）
+//   ① 输出形态: 纯文本状态块（core/qoder 是 hookSpecificOutput JSON）
+
+import { SubagentGuardRouter } from "../../../core/governance/subagent-guard-router.js"
+
+class CodexSubagentGuardRouter extends SubagentGuardRouter {
+  /** ① 纯文本状态块（codex 协议，与 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 CodexSubagentGuardRouter().run())

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

@@ -0,0 +1,20 @@
+// subagent-stop.ts — SubagentStop 入口（Codex 版，Task 7.1 继承体系）
+// 继承 core SubagentStopRouter，命名子类 CodexSubagentStopRouter:
+//   ① 边界校验 + deliverables 越界检查 + 审计聚合 = 基类（与 codex bash 原文逐字同构，
+//   2026-08-14 实态核验——手写版逻辑与 core 基类完全一致，收敛为子类）
+// 协议差异仅剩: PROJECT_DIR = $PWD（codex 小文件无 git toplevel）+ MAGIC_DIR 注入
+
+import { readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { SubagentStopRouter } from "../../../core/governance/subagent-stop-router.js"
+
+class CodexSubagentStopRouter extends SubagentStopRouter {
+  // 当前无 override（边界校验 + 审计聚合与 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
+
+const input = readHookInput()
+process.exit(new CodexSubagentStopRouter().run(input))

package/templates/adapters/codex/hooks.json

@@ -1 +1,67 @@
-{"hooks":{"SessionStart":[{"command":"bash .codex/hooks/session-start.sh"}],"UserPromptSubmit":[{"command":"bash .codex/hooks/prompt-submit.sh"}],"PreToolUse":[{"command":"bash .codex/hooks/pre-tool-use.sh"}],"PostToolUse":[{"command":"bash .codex/hooks/post-tool-use.sh"}],"Stop":[{"command":"bash .codex/hooks/stop-check.sh"}],"Notification":[{"matcher":"result","command":"bash .codex/hooks/notification.sh"}]}}
+{
+  "description": "ADD governance hooks for Codex.",
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "^(startup|resume|clear|compact)$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.codex/hooks/session-start.mjs\"",
+            "statusMessage": "Loading ADD state",
+            "additionalContextLimit": 5000
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.codex/hooks/prompt-submit.mjs\"",
+            "statusMessage": "Routing ADD workflow"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "^(Bash|apply_patch|Edit|Write)$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.codex/hooks/pre-tool-use.mjs\"",
+            "statusMessage": "Checking ADD policy",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "^(Bash|apply_patch|Edit|Write)$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.codex/hooks/post-tool-use.mjs\"",
+            "statusMessage": "Recording ADD result",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.codex/hooks/stop-check.mjs\"",
+            "statusMessage": "Checking ADD closure",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}

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

@@ -0,0 +1,34 @@
+// doc-format-guard.ts — schema.json 驱动的 ADD 文档格式守卫（Qoder CN 版，Task 4.1 继承体系）
+// 继承 core DocFormatGuard，命名子类 QoderDocFormatGuard——六端实态核验（2026-08-14）:
+//   探测链与 core 数据驱动同语义（PLAN 元信息 → 一、Plan 概述 → 四、Handoff → simple-plan，
+//   无 claude 的 Handoff 前置差异）→ 当前无 override（空子类承载端身份 + 未来演进位）；
+//   文本漂移（「doc-format-guard.sh」残留）已在 core 修正（TS 时代无 .sh）。
+// 协议差异仅剩: PROJECT_DIR 注入链（qoder-env）
+
+import { readFileSync } from "node:fs"
+import { DocFormatGuard } from "../../../core/governance/doc-format-guard.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+/**
+ * Qoder DocFormatGuard（命名子类）:
+ *   当前无 override（探测链同 core）；未来 qoder 协议演进（如 hookSpecificOutput 新字段）
+ *   在此扩展，不改 core 基类。
+ */
+class QoderDocFormatGuard extends DocFormatGuard {
+  constructor(projectDir: string, magicDir: string) {
+    super(projectDir, magicDir)
+  }
+}
+
+injectProjectDir()
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+const MAGIC_DIR = process.env.MAGIC_DIR || ".qoder"
+
+const guard = new QoderDocFormatGuard(PROJECT_DIR, MAGIC_DIR)
+let raw = ""
+try {
+  raw = readFileSync(0, "utf-8")
+} catch {
+  raw = ""
+}
+process.exitCode = guard.run(raw)

package/templates/adapters/qoder/hooks/lib/context-inject.ts

@@ -0,0 +1,61 @@
+// lib/context-inject.ts — 上下文注入模板（Qoder CN 版，Task 4.1 diff 合并 core）
+// R2 回流: context-inject diff 已合并——7 象限文本真源 = hook-context-rules.toml
+//   （[context.quadrants] core 基线 + [context.adapter_quadrants] qoder 差异）
+// 差异保留（行为等价红线）:
+//   has_add_dev_unclosed: qoder 版含「（不要等下次会话）」文本差异
+//   ~~{{info}} 字面量不插值~~ → 2026-08-14 Task 9.4.1 修复: 回归统一 replaceAll 插值语义
+//   （bash <<'EOF' 单引号 heredoc 缺陷照搬——issues 参数实际不生效，已修复）
+
+import { context } from "../../../../core/governance/rules.js"
+
+/** 象限条目（rules.context.quadrants / adapter_quadrants 结构） */
+interface Quadrant {
+  adapter?: string
+  id: string
+  consumed: boolean
+  text: string
+}
+
+/** 结构化 SessionStart JSON 注入（与 core buildSessionStartJson 逐字一致） */
+export function buildSessionStartJson(
+  plan: string,
+  step: string,
+  round: string,
+  handoff: string
+): string {
+  return `{
+  "continue": true,
+  "hookSpecificOutput": {
+    "hookEventName": "SessionStart",
+    "additionalContext": "上次 ADD 流程未完成:\\n  Plan: ${plan}\\n  轮次: ${round}\\n  当前 Step: ${step} (add-route)\\n  恢复命令: query_audit_logs({ planKeyword: '${plan}' })\\n  handoff: ${handoff}"
+  }
+}
+`
+}
+
+/** 象限文本索引（adapter 差异优先，回退 core 基线） */
+const QUADRANTS: Map<string, Quadrant> = new Map()
+for (const q of ((context.adapter_quadrants as unknown as Quadrant[]) ?? []).filter((x) => x.adapter === "qoder")) {
+  QUADRANTS.set(q.id, q)
+}
+for (const q of ((context.quadrants as unknown as Quadrant[]) ?? [])) {
+  if (!QUADRANTS.has(q.id)) QUADRANTS.set(q.id, q)
+}
+
+/**
+ * Stop 七象限分流 few-shot 上下文（Qoder CN 版）。
+ * Task 9.4.1 修复: has_add_dev_unclosed 的 {{info}} 正常插值（原 bash <<'EOF' 缺陷照搬——不 replace）
+ */
+export function buildStopContext(quadrant: string, info: string): string {
+  const q = QUADRANTS.get(quadrant)
+  if (!q) return ""
+  return q.text.replaceAll("{{info}}", info)
+}
+
+/** 写操作前置守卫上下文（与 core buildPretoolContext 逐字对齐） */
+export function buildPretoolContext(plan: string, round: string): string {
+  return `[ADD PreToolUse] 当前 Plan: ${plan}，轮次: ${round}。
+本次写入应属于 ADD Step 3 代码实现阶段。
+完成后执行 record_dev_operation 记录审计。
+`
+}

package/templates/adapters/qoder/hooks/lib/qoder-env.ts

@@ -0,0 +1,23 @@
+// lib/qoder-env.ts — Qoder CN 私有环境解析（PROJECT_DIR 注入链）
+// 契约: qoder 端所有 hook 的 PROJECT_DIR 来源 = ${CLAUDE_PROJECT_DIR:-${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}}
+// （对齐 qoder state-detect.sh 宿主注入链，与 claude-env.ts 同构）
+
+/** 解析项目根目录（对齐 bash ${CLAUDE_PROJECT_DIR:-${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}}） */
+export function resolveQoderProjectDir(): string {
+  return (
+    process.env.CLAUDE_PROJECT_DIR ||
+    process.env.QODER_PROJECT_DIR ||
+    process.env.QODERCN_PROJECT_DIR ||
+    process.cwd()
+  )
+}
+
+/**
+ * 注入 PROJECT_DIR 到 process.env（对齐 bash export PROJECT_DIR）。
+ * 入口统一调用；后续 hash/路径计算均消费该值。
+ */
+export function injectProjectDir(): string {
+  const dir = resolveQoderProjectDir()
+  process.env.PROJECT_DIR = dir
+  return dir
+}

package/templates/adapters/qoder/hooks/lib/review-checklist.ts

@@ -0,0 +1,5 @@
+// lib/review-checklist.ts — 验收 Review 模式（Qoder CN 版，Task 4.1 收敛）
+// R2 回流: review-checklist 逻辑已收敛 core governance/review-checklist-guard.ts
+// （checkReviewQuality 逐字迁移 + specRoot 参数化）；本文件仅 re-export 保持 import 兼容。
+
+export { checkReviewQuality } from "../../../../core/governance/review-checklist-guard.js"