add-coder 0.3.27 → 0.3.29

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

@@ -7,7 +7,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash \"$(git rev-parse --show-toplevel)/.codex/hooks/session-start.sh\"",
+            "command": "node \"$(git rev-parse --show-toplevel)/.codex/hooks/session-start.mjs\"",
             "statusMessage": "Loading ADD state",
             "additionalContextLimit": 5000
           }
@@ -19,7 +19,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash \"$(git rev-parse --show-toplevel)/.codex/hooks/prompt-submit.sh\"",
+            "command": "node \"$(git rev-parse --show-toplevel)/.codex/hooks/prompt-submit.mjs\"",
             "statusMessage": "Routing ADD workflow"
           }
         ]
@@ -31,7 +31,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash \"$(git rev-parse --show-toplevel)/.codex/hooks/pre-tool-use.sh\"",
+            "command": "node \"$(git rev-parse --show-toplevel)/.codex/hooks/pre-tool-use.mjs\"",
             "statusMessage": "Checking ADD policy",
             "timeout": 30
           }
@@ -44,7 +44,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash \"$(git rev-parse --show-toplevel)/.codex/hooks/post-tool-use.sh\"",
+            "command": "node \"$(git rev-parse --show-toplevel)/.codex/hooks/post-tool-use.mjs\"",
             "statusMessage": "Recording ADD result",
             "timeout": 30
           }
@@ -56,7 +56,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash \"$(git rev-parse --show-toplevel)/.codex/hooks/stop-check.sh\"",
+            "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"

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

@@ -0,0 +1,34 @@
+// notification.ts — Notification 入口（Qoder CN 版，Task 4.1 继承体系补全）
+// 继承 core NotificationRouter，命名子类 QoderNotificationRouter:
+//   ① 兜底 magicDir = ".qoder"（构造参数注入——替代 bash 硬编码 ${PROJECT_DIR}/.qoder/reviews）
+//   ② emitReminder override: 无 Plan 前缀（qoder bash 原文逐字「[ADD Notification] 请检查 Review 文档」，
+//     与 core 的 Plan 前缀文本差异保留——非能力漂移，qoder bash 原文如此）
+//   ③ 输出通道: stdout（qoder bash 原文 echo 无 >&2 重定向——违反 qoder JSON 规范但缺陷照搬，
+//     归 Task 9.4 缺陷修复专项）
+// 协议差异仅剩: PROJECT_DIR 注入链（qoder-env）
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { NotificationRouter } from "../../../core/governance/notification-router.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+class QoderNotificationRouter extends NotificationRouter {
+  /** 协议差异封装: fallbackMagicDir = ".qoder"（qoder 端兜底，bash 原文硬编码语义） */
+  constructor(projectDir: string) {
+    super(projectDir, ".qoder")
+  }
+
+  /** ① qoder bash 原文硬编码 ${PROJECT_DIR}/.qoder/reviews——无跨端探测循环（协议差异，不做探测） */
+  protected override resolveMagicDir(): string {
+    return process.env.MAGIC_DIR ?? ".qoder"
+  }
+
+  /** ② qoder 提醒文本: 无 Plan 前缀（bash 原文逐字） */
+  protected override emitReminder(_plan: string, reviewsDir: string): void {
+    process.stdout.write(`[ADD Notification] 请检查 Review 文档: ${reviewsDir}\n`)
+  }
+}
+
+const input = readHookInput()
+const PROJECT_DIR = injectProjectDir()
+
+process.exit(new QoderNotificationRouter(PROJECT_DIR).run(input))

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

@@ -0,0 +1,26 @@
+// permission-gate.ts — PermissionRequest 入口（Qoder CN 版，Task 4.1 继承体系补全）
+// 继承 core PermissionGateRouter，命名子类 QoderPermissionGateRouter:
+//   ① emit override: 全量工具 stderr 日志（qoder bash 原文无条件输出——
+//      qoder 权限弹窗自行处理 Review 卡位；core 是仅高风险工具 stdout 提示）
+
+import { readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PermissionGateRouter } from "../../../core/governance/permission-gate-router.js"
+
+class QoderPermissionGateRouter extends PermissionGateRouter {
+  /** ① tool_name 缺失回退 "unknown"（bash jq `// \"unknown\"` 语义） */
+  protected override fallbackToolName(): string {
+    return "unknown"
+  }
+
+  /** ② qoder 协议: 全量工具 stderr 日志（bash 原文逐字） */
+  protected override emit(toolName: string): void {
+    process.stderr.write(`[ADD PermissionRequest] 工具 ${toolName} 请求权限。如有 Review 文档待确认，请先检查。\n`)
+  }
+}
+
+// 对齐 bash: MAGIC_DIR 由物理位置推导注入（替代 HOOK_DIR 局部变量 source 传递）
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+
+const input = readHookInput()
+process.exit(new QoderPermissionGateRouter().run(input))

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

@@ -0,0 +1,30 @@
+// post-tool-failure.ts — PostToolUseFailure 入口（Qoder CN 版，Task 4.1 继承体系补全）
+// 继承 core PostToolFailureRouter，命名子类 QoderPostToolFailureRouter:
+//   ① emit override: stderr 回退建议（qoder bash 原文逐字——
+//      「检查是否需要回退到上一 ADD Step 重新执行」；core 是 stdout 固定提示）
+
+import { readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PostToolFailureRouter } from "../../../core/governance/post-tool-failure-router.js"
+
+class QoderPostToolFailureRouter extends PostToolFailureRouter {
+  /** ① tool_name/error 缺失回退 "unknown"（bash jq `// \"unknown\"` 语义） */
+  protected override fallbackToolName(): string {
+    return "unknown"
+  }
+
+  protected override fallbackError(): string {
+    return "unknown"
+  }
+
+  /** ② qoder 协议: stderr 回退建议（bash 原文逐字） */
+  protected override emit(toolName: string, error: string): void {
+    process.stderr.write(`[ADD PostToolUseFailure] 工具 ${toolName} 失败: ${error}。检查是否需要回退到上一 ADD Step 重新执行。\n`)
+  }
+}
+
+// 对齐 bash: MAGIC_DIR 由物理位置推导注入
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+
+const input = readHookInput()
+process.exit(new QoderPostToolFailureRouter().run(input))

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

@@ -0,0 +1,32 @@
+// post-tool-use.ts — PostToolUse 入口（Qoder CN 版，Task 4.1 能力演进）
+// 继承 core PostToolRouter；协议能力实证（2026-08-14 Qoder 官方文档）:
+//   Qoder PostToolUse 事件支持 stdout JSON，专属字段 hookSpecificOutput.feedback
+//   （「反馈信息，会展示给用户」）——qoder 输出通道用 feedback JSON（能力演进，
+//   非收敛降级）；段落能力（§1 DPS + §2a-e + §3）对齐 core 全段（此前 qoder §1
+//   缺分支为 bash 时代漂移，已补齐）。
+// 协议差异: 输出通道 collectJson=true（feedback JSON）+ PROJECT_DIR 注入链
+
+import { jsonGet, readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PostToolRouter } from "../../../core/governance/post-tool-router.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+injectProjectDir()
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+const MAGIC_DIR = process.env.MAGIC_DIR || ".qoder"
+
+class QoderPostToolRouter extends PostToolRouter {
+  /** 输出通道: feedback JSON（Qoder 文档实证 PostToolUse 专属字段） */
+  protected override collectJson(): boolean {
+    return true
+  }
+}
+
+const input = readHookInput()
+let toolName = jsonGet(input, "tool_name")
+if (toolName === "") {
+  toolName = input.match(/"tool_name"\s*:\s*"([^"]*)"/)?.[1] ?? ""
+}
+
+process.exit(new QoderPostToolRouter(PROJECT_DIR, MAGIC_DIR).run(input, toolName))

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

@@ -0,0 +1,16 @@
+// pre-compact.ts — 上下文压缩前 ADD 状态保存（Qoder CN 版，Task 4.1 继承体系补全）
+// 继承 core PreCompactGuard，命名子类 QoderPreCompactGuard:
+//   ① 状态保存到恢复标记 + ② tpl 标记清理 = 基类（与 qoder bash 原文逐字同构，
+//   2026-08-14 实态核验——手写版逻辑与 core 基类完全一致，收敛为子类）
+// 协议差异仅剩: PROJECT_DIR 注入链（qoder-env）
+
+import { PreCompactGuard } from "../../../core/governance/pre-compact-guard.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+class QoderPreCompactGuard extends PreCompactGuard {
+  // 当前无 override（状态保存/恢复清单/tpl 清理与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+injectProjectDir()
+
+process.exit(new QoderPreCompactGuard().run())

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

@@ -0,0 +1,112 @@
+// pre-tool-use.ts — PreToolUse 入口（Qoder CN 版，Task 4.1 继承体系）
+// 继承 core PreToolUseGuard（模板方法固化治理流程）；仅 override 协议差异（bash 原文逐字对照）:
+//   ① 检测链: 构造传 adapterName="qoder" → 加载 [guard.adapter_detectors] qoder 独立链
+//      （与 claude 同构四段链，2026-08-14 实态核验）
+//   ② onBlock: stderr + stdout JSON deny（permissionDecision: deny）+ 事件 + exit 2（无 logBlock）
+//   ③ onSensitiveDeny: stderr + JSON deny + 事件 + exit 2（core 无事件上报）
+//   ④ onSectionAPass: Bash 放行 markDevAction（同 claude）
+//   ⑤ largeFileText: 「Qoder 40500」错误码提示（qoder IDE 特有）
+//   ⑥ onHitlDeny: JSON deny + additionalContext + exit 2 + event "ask"（core exit 0 + event "deny"）
+//   ⑦ onOtherTool: ③ Read matcher 模板提示（同 claude）
+
+import { jsonGet, readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { writeHookEvent } from "../../../core/governance/notify.js"
+import { PreToolUseGuard } from "../../../core/governance/pre-tool-guard.js"
+import { markDevAction } from "../../../core/governance/common.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+injectProjectDir()
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+const MAGIC_DIR = process.env.MAGIC_DIR || ".qoder"
+
+/** JSON deny 输出（Qoder PreToolUse 协议: permissionDecision deny） */
+function denyJsonOut(reason: string): string {
+  return JSON.stringify({
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      permissionDecision: "deny",
+      permissionDecisionReason: reason,
+    },
+  }) + "\n"
+}
+
+class QoderPreToolUseGuard extends PreToolUseGuard {
+  constructor(projectDir: string, magicDir: string) {
+    super(projectDir, magicDir, "qoder")
+  }
+
+  /** ② §A 阻断: stderr + JSON deny + 事件 + exit 2（无 logBlock） */
+  protected override onBlock(blocked: { reason: string; stderr: string }, command: string): number {
+    process.stderr.write(blocked.stderr.replaceAll("{{cmd}}", command))
+    process.stdout.write(denyJsonOut(blocked.reason))
+    writeHookEvent("pre-tool-use", "deny", command, blocked.reason, this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** ③ §B 敏感文件: stderr + JSON deny + 事件 + exit 2 */
+  protected override onSensitiveDeny(filePath: string): number {
+    process.stderr.write(`⛔ 敏感文件受保护，禁止写入: ${filePath}\n`)
+    process.stdout.write(denyJsonOut("敏感文件受保护"))
+    writeHookEvent("pre-tool-use", "deny", filePath, "敏感文件受保护", this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** ④ §A 放行后处理: bash 原文 mark_dev_action */
+  protected override onSectionAPass(_command: string): void {
+    markDevAction()
+  }
+
+  /** ⑤ 大文件提示: Qoder 40500 错误码（qoder IDE 特有） */
+  protected override largeFileText(fsize: number): string {
+    return `⚠️ [ADD PreToolUse] 文件已有 ${fsize} 字节，Write 全量覆盖可能触发 Qoder 40500。建议用 SearchReplace 分块追加。\n`
+  }
+
+  /** ⑥ HITL 未 tongyi: JSON deny + additionalContext + exit 2 + event "ask" */
+  protected override onHitlDeny(toolName: string, filePath: string, tongyiMarker: string): number {
+    process.stderr.write(`⛔ [ADD PreToolUse §C] HITL 未 tongyi: ${filePath}\n`)
+    process.stderr.write(`   原因: 哨兵文件 ${tongyiMarker} 不存在\n`)
+    process.stderr.write(`   操作: 请先调用 create_hitl 创建审批，再 update_hitl({ status: "TONGYI" })\n`)
+    const msg = `⛔ HITL 未 tongyi: 哨兵 ${tongyiMarker} 不存在。请先 create_hitl → 人工 tongyi → update_hitl 后再写入`
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: "PreToolUse",
+          permissionDecision: "deny",
+          permissionDecisionReason: msg,
+          additionalContext: msg,
+        },
+      }) + "\n"
+    )
+    writeHookEvent("pre-tool-use", "ask", `${toolName} ${filePath}`, `HITL 未 tongyi: ${tongyiMarker}`, this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** ⑦ ③ Read matcher: 模板路径兜底提示 */
+  protected override onOtherTool(input: string, toolName: string): number {
+    if (toolName === "Read") {
+      const filePath = jsonGet(input, "file_path")
+      if (/templates\//.test(filePath)) {
+        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 QoderPreToolUseGuard(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))
+}