add-coder 0.3.25 → 0.3.27

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

@@ -1,217 +1,130 @@
 #!/bin/bash
-# pre-tool-use.sh — PreToolUse §A§B（阻断模式，通用适配版）
-# §A: Bash 裸写保护 — 拦截所有绕过 IDE 追踪的文件写操作
-# §B: Write/Edit 写入前置守卫 — Plan/Spec/Review 需要活跃 ADD Plan + 敏感文件保护
-# 治理卡位 #4: 危险命令拦截 / 模板路径兜底 / 写入前置守卫 / 敏感文件保护
+# pre-tool-use.sh — Codex PreToolUse：Bash 裸写保护 + apply_patch 文件守卫
 set -euo pipefail
 
 input=$(cat)
-
-# 探测 MAGIC_DIR 和 PROJECT_DIR（兼容多种 adapter）
 HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-PARENT="$(dirname "$HOOK_DIR")"
-MAGIC_DIR=".codex"
-PROJECT_DIR="$PWD"
-
-# ── Hook 通知: 拦截事件写入 jsonl（旁路，失败不阻断 exit 2）──
-source "${HOOK_DIR}/lib/notify.sh" 2>/dev/null || true
-ACTIVE_PLAN=$(detect_active_add 2>/dev/null || true)
-if [ -n "$ACTIVE_PLAN" ]; then
-  PLAN_KEYWORD="${ACTIVE_PLAN%%::*}"
-  PLAN_STATUS="active"
+export CURRENT_MAGIC=".codex"
+export MAGIC_DIR=".codex"
+export PROJECT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+# core notify helper 使用相对 MAGIC_DIR；统一 cwd，避免从 repo 子目录启动时写偏审计文件。
+cd "$PROJECT_DIR"
+
+COMMON_LIB="$HOOK_DIR/lib/common.sh"
+[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
+source "$HOOK_DIR/lib/notify.sh" 2>/dev/null || true
+
+tool_name=$(echo "$input" | jq -r '.tool_name // empty')
+tool_command=$(echo "$input" | jq -r '.tool_input.command // empty')
+active_plan=$(detect_active_add 2>/dev/null || true)
+if [ -n "$active_plan" ]; then
+  plan_keyword="${active_plan%%::*}"
+  plan_status="active"
 else
-  PLAN_KEYWORD="no-active-plan"
-  PLAN_STATUS="none"
+  plan_keyword="no-active-plan"
+  plan_status="none"
 fi
 
-# ── §A 辅助函数: 阻断日志 ──
 _log_block() {
-  local rule="$1" cmd="$2"
-  mkdir -p "$PROJECT_DIR/$MAGIC_DIR/debug-dump"
-  cat >> "$PROJECT_DIR/$MAGIC_DIR/debug-dump/stdin.log" <<BLOCKLOG
-=== $(date) [BLOCKED by §A: ${rule}] ===
-command: ${cmd:0:300}
-=== DONE ===
-BLOCKLOG
+  local rule="$1" detail="$2"
+  mkdir -p "$PROJECT_DIR/$MAGIC_DIR/debug-dump" 2>/dev/null || return 0
+  printf '=== %s [BLOCKED: %s] ===\n%s\n=== DONE ===\n' \
+    "$(date -Iseconds)" "$rule" "${detail:0:500}" \
+    >> "$PROJECT_DIR/$MAGIC_DIR/debug-dump/stdin.log" 2>/dev/null || true
 }
 
-# ═══════════════ §A: Bash 工具写入保护 ═══════════════
-# 任何通过 Bash 修改文件内容的操作都会绕过 IDE 工具层（Write/SearchReplace），
-# 导致 Plan 关联检查、doc-format-guard、审计追踪全部失效。
-# 因此全局阻断所有可写文件的 Bash 命令，强制走 IDE 工具通道。
-command=$(echo "$input" | jq -r '.tool_input.command // empty')
-if [ -n "$command" ]; then
-
-  # 检测 1: 脚本解释器 — 可写任意文件，无法解析脚本内容做细粒度拦截
-  if echo "$command" | grep -qE '(^|;|\|\||&&|\|)\s*(python3?|node|ruby|perl|php)(\s|$)'; then
-    _reason="禁止通过脚本解释器直接修改文件。请使用 Write 或 SearchReplace 工具操作文件。"
-    cat >&2 <<'EOF'
-⛔ [ADD PreToolUse §A] 阻断: 禁止通过脚本解释器直接修改文件。
-
-  python/node/ruby/perl/php 可在脚本中写入任意文件，绕过:
-    · Plan 关联检查（哪个文件属于哪个 ADD Plan？）
-    · doc-format-guard（章节/占位符/禁止词校验）
-    · 审计追踪（agentAudit 无法感知 Bash 内部的文件变更）
-
-  → 请改用 Write 或 SearchReplace 工具操作文件。
-  → 如需运行构建/测试脚本，使用 npx/pnpm/npm 命令。
-EOF
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"${_reason}\"}}"
-    _log_block "脚本解释器" "$command"
-    write_hook_event "pre-tool-use" "deny" "$command" "禁止通过脚本解释器直接修改文件" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-    exit 2
-  fi
+_deny() {
+  local rule="$1" reason="$2" detail="${3:-$tool_name}"
+  echo "⛔ [ADD PreToolUse] $reason" >&2
+  jq -nc --arg reason "$reason" '{
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      permissionDecision: "deny",
+      permissionDecisionReason: $reason
+    }
+  }'
+  _log_block "$rule" "$detail"
+  write_hook_event "pre-tool-use" "deny" "$tool_name" "$reason" "$plan_keyword" "$plan_status" 2>/dev/null || true
+  exit "${EXIT_BLOCK:-2}"
+}
 
-  # 检测 2: sed -i 原地编辑
-  if echo "$command" | grep -qE '\bsed\b.*-i'; then
-    _reason="禁止通过 sed -i 直接编辑文件。请使用 SearchReplace 工具。"
-    cat >&2 <<'EOF'
-⛔ [ADD PreToolUse §A] 阻断: 禁止通过 sed -i 原地编辑文件。
-
-  sed -i 直接写入文件，绕过 IDE 工具层的所有校验。
-  → 请改用 SearchReplace 工具。
-EOF
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"${_reason}\"}}"
-    _log_block "sed -i" "$command"
-    write_hook_event "pre-tool-use" "deny" "$command" "禁止通过 sed -i 原地编辑" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-    exit 2
-  fi
+_require_hitl_for() {
+  local file_path="$1" do_hitl=false plan_name marker_base marker_full
 
-  # 检测 3: 输出重定向 (>/>>) 写入文件
-  if echo "$command" | grep -qE '[>]{1,2}\s+\S'; then
-    _reason="禁止通过重定向写入文件。请使用 Write 工具。"
-    cat >&2 <<'EOF'
-⛔ [ADD PreToolUse §A] 阻断: 禁止通过重定向(>/>>)写入文件。
-
-  重定向写入绕过 IDE 工具层，变更无法追踪。
-  → 请改用 Write 工具。
-EOF
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"${_reason}\"}}"
-    _log_block "重定向" "$command"
-    write_hook_event "pre-tool-use" "deny" "$command" "禁止通过重定向写入文件" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-    exit 2
+  if echo "$file_path" | grep -qE '(^|/)\.codex/plans/'; then
+    if ! echo "$file_path" | grep -qE -- '-handoff'; then
+      do_hitl=true
+    fi
+  elif echo "$file_path" | grep -qE '(^|/)\.codex/reviews/'; then
+    # Runtime Review 是运行时证据容器；Plan Review 与 Implementation Review 都必须走 create_hitl。
+    if ! echo "$file_path" | grep -qE -- '-runtime'; then
+      do_hitl=true
+    fi
   fi
 
-  # 检测 4: tee / dd 写入
-  if echo "$command" | grep -qE '\btee\b|\bdd\b.*of='; then
-    _reason="禁止通过 tee/dd 写入文件。请使用 Write 或 SearchReplace 工具。"
-    cat >&2 <<'EOF'
-⛔ [ADD PreToolUse §A] 阻断: 禁止通过 tee/dd 写入文件。
-
-  → 请改用 Write 或 SearchReplace 工具。
-EOF
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"${_reason}\"}}"
-    _log_block "tee/dd" "$command"
-    write_hook_event "pre-tool-use" "deny" "$command" "禁止通过 tee/dd 写入文件" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-    exit 2
-  fi
+  [ "$do_hitl" = true ] || return 0
 
-  # 检测 5: cp / mv / touch — 可创建或覆盖文件
-  if echo "$command" | grep -qE '(^|;|\|\||&&|\|)\s*(cp|mv|touch)\b'; then
-    _reason="禁止通过 cp/mv/touch 操作文件。请使用 Write 或 SearchReplace 工具。"
-    cat >&2 <<'EOF'
-⛔ [ADD PreToolUse §A] 阻断: 禁止通过 cp/mv/touch 操作文件。
-
-  → 请改用 Write 或 SearchReplace 工具。
-EOF
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"${_reason}\"}}"
-    _log_block "cp/mv/touch" "$command"
-    write_hook_event "pre-tool-use" "deny" "$command" "禁止通过 cp/mv/touch 操作文件" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-    exit 2
+  plan_name=$(basename "$file_path" .md | sed 's/\.hitl$//')
+  marker_full="$PROJECT_DIR/$MAGIC_DIR/hitl/.tongyi-${plan_name}"
+  marker_base="$PROJECT_DIR/$MAGIC_DIR/hitl/.tongyi-$(echo "$plan_name" | sed 's/-plan-v[0-9]*$//;s/-add-route-v[0-9]*$//;s/-review-v[0-9]*$//;s/-review-implementation[^/]*$//')"
+  if [ ! -f "$marker_full" ] && [ ! -f "$marker_base" ]; then
+    _deny "hitl" "HITL 未同意: $file_path。请先 create_hitl，再由人工 update_hitl(TONGYI)。" "$file_path"
   fi
+}
 
-  # 放行: 构建工具(npx/pnpm/npm/yarn)、版本控制(git)、
-  #        只读操作(ls/cat/grep/find/head/tail/wc)、目录操作(mkdir/rmdir) 等
-  exit 0
-fi
+_guard_file_path() {
+  local file_path="$1"
+  [ -n "$file_path" ] || return 0
 
-# ═══════════════ §B: Write/Edit 文件写入前置守卫 ═══════════════
-# 非 Bash 工具（Write/Edit）的文件写入需要经过:
-#   1. Plan/Spec/Review 文档写入 → 需要活跃 ADD Plan
-#   2. 敏感文件保护 → 阻断写入
-#   3. Dev Action 标记 → 用于 Stop 检查
-# 注意: 不再对 src/**/*.ts 做 Plan 白名单放行，避免绕过 skill/rules 规定的 HITL。
-tool_name=$(echo "$input" | jq -r '.tool_name // empty')
-if [ "$tool_name" = "Write" ] || [ "$tool_name" = "Edit" ] || [ "$tool_name" = "SearchReplace" ]; then
-  file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
-  [ -z "$file_path" ] && exit 0
-
-  if echo "$file_path" | grep -qE '\.(qoder|claude|add)/(plans|specs|reviews)/'; then
-    if type detect_active_add >/dev/null 2>&1; then
-      state=$(detect_active_add 2>/dev/null || true)
-      if [ -z "$state" ]; then
-        echo "[ADD 提示] 正在写入 Plan/Spec/Review 文档但无活跃 ADD Plan——首次创建场景放行，建议先执行 add-paradigm 生成 Plan+add-route" >&2
-        echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"permissionDecisionReason\":\"无活跃 ADD Plan 但为 Plan/Spec/Review 写入（首次创建场景），提示而非拦截\"}}"
-        write_hook_event "pre-tool-use" "info" "$tool_name $file_path" "无活跃 ADD Plan 下写入 Plan/Spec/Review（首次创建放行）" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-        exit 0
-      fi
-    fi
+  if echo "$file_path" | grep -qE '(^|/)(\.env|\.env\.production|\.env\.local)$|credentials|secrets'; then
+    _deny "sensitive-file" "敏感文件受保护，禁止写入: $file_path" "$file_path"
   fi
 
-  if echo "$file_path" | grep -qE '\.env$|\.env\.production$|\.env\.local$|credentials|secrets'; then
-    echo "⛔ 敏感文件受保护，禁止写入: $file_path" >&2
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"deny\",\"permissionDecisionReason\":\"敏感文件受保护\"}}"
-    exit 2
-  fi
+  _require_hitl_for "$file_path"
 
-  # §C: 模板类型前置注入 — plans/ 写入前提示应选模板
-  if echo "$file_path" | grep -qE '\.(qoder|claude|add|vscode|trae)/(plans)/'; then
-    fname=$(basename "$file_path")
-    if echo "$fname" | grep -qE 'plan-v[0-9]'; then
-      echo "💡 [ADD PreToolUse] 写入 Plan → 模板: standard-plan-template.md（标准）或 simple-plan-template.md（≤3文件）" >&2
-    elif echo "$fname" | grep -qE 'add-route'; then
-      echo "💡 [ADD PreToolUse] 写入 ADD Route → 模板: add-route-template.md" >&2
-    elif echo "$fname" | grep -qE 'handoff'; then
-      echo "💡 [ADD PreToolUse] 写入 Handoff → 模板: handoff-single-round-template.md（单轮）或 handoff-multi-round-template.md（多轮）" >&2
-    fi
-    # Write 大文件适配 — 已存在大文件建议用 SearchReplace 分块
-    if echo "$tool_name" | grep -qE 'Write' && [ -f "$file_path" ]; then
-      fsize=$(wc -c < "$file_path" 2>/dev/null || echo "0")
-      if [ "$fsize" -gt 2000 ] 2>/dev/null; then
-        echo "⚠️ [ADD PreToolUse] 文件已有 ${fsize} 字节，Write 全量覆盖可能触发工具 payload 限制。建议用 SearchReplace 分块追加。" >&2
-      fi
+  if echo "$file_path" | grep -qE '(^|/)\.codex/(plans|specs|reviews)/'; then
+    if [ -z "$active_plan" ]; then
+      echo "[ADD PreToolUse] 正在修改 ADD 文档但未检测到活跃 Plan: $file_path" >&2
     fi
   fi
+}
 
-  # §C: HITL tongyi 检查 — plans/ + PLAN_REVIEW reviews/ 写入前必须有 .hitl-tongyi-{planName} 哨兵
-  # implementation/runtime review 不需要 HITL，走 §B 活跃 Plan 检查
-  # handoff 是 Step 8 收敛产物（多轮交接手册），不经 HITL 审批，同样豁免
-  # TODO 应该caijuehub管理
-  if echo "$file_path" | grep -qE '\.(qoder|claude|add|vscode|trae)/(plans)/'; then
-    if echo "$file_path" | grep -qE '\-handoff'; then
-      _do_hitl=false  # handoff 不被 HITL 拦截（Step 8 产物，无独立审批）
-    else
-      _do_hitl=true
-    fi
-  elif echo "$file_path" | grep -qE '\.(qoder|claude|add|vscode|trae)/(reviews)/'; then
-    if echo "$file_path" | grep -qE '-(implementation|runtime)'; then
-      _do_hitl=false  # implementation/runtime review 不被 HITL 拦截
-    else
-      _do_hitl=true   # PLAN_REVIEW 需要 HITL
-    fi
-  else
-    _do_hitl=false
+# Codex 对 Bash 与 apply_patch 都把 payload 放在 tool_input.command。
+# 只有 canonical Bash 才执行 shell 命令检查，避免把 patch body 误判成 shell。
+if [ "$tool_name" = "Bash" ]; then
+  if echo "$tool_command" | grep -qE '(^|;|\|\||&&|\|)[[:space:]]*(python3?|node|ruby|perl|php)([[:space:]]|$)'; then
+    _deny "script-interpreter" "禁止通过脚本解释器直接修改文件；请使用 apply_patch。" "$tool_command"
   fi
-
-  if [ "$_do_hitl" = true ]; then
-    _relative=$(echo "$file_path" | sed 's|.*/\.\(qoder\|claude\|add\|vscode\|trae\)/\(plans\|reviews\)/||')
-    _planName=$(basename "$_relative" .md | sed 's/\.hitl$//;s/-plan-v[0-9]*$//;s/-add-route-v[0-9]*$//;s/-review-v[0-9]*$//;s/-review-implementation$//;s/-review-runtime$//')
-    if [ -n "$_planName" ]; then
-      _tongyi_marker="${PROJECT_DIR}/${MAGIC_DIR}/hitl/.tongyi-${_planName}"
-      if [ ! -f "$_tongyi_marker" ]; then
-        echo "⛔ [ADD PreToolUse §C] HITL 未 tongyi: $file_path" >&2
-        echo "   原因: 哨兵文件 $_tongyi_marker 不存在" >&2
-        echo "   操作: 请先调用 create_hitl 创建审批，再 update_hitl({ status: \"TONGYI\" })" >&2
-        _reason="HITL 未 tongyi: 哨兵 ${_tongyi_marker} 不存在。请先 create_hitl → 人工 tongyi → update_hitl 后再写入"
-        echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"deny\",\"permissionDecisionReason\":\"${_reason}\",\"additionalContext\":\"${_reason}\"}}"
-        write_hook_event "pre-tool-use" "deny" "$tool_name $file_path" "HITL 未 tongyi: $_tongyi_marker" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-        exit 0
-      fi
-    fi
+  # `-i` 必须是 sed 命令中的独立 option；不能把 session-init 等后续路径子串当成原地写入。
+  if echo "$tool_command" | grep -qE '(^|[;&|][[:space:]]*)sed[[:space:]]+([^;&|]*[[:space:]])?(-[[:alpha:]]*i[^[:space:];&|]*|--in-place(=[^[:space:];&|]*)?)([[:space:];&|]|$)'; then
+    _deny "sed-i" "禁止通过 sed -i 直接编辑文件；请使用 apply_patch。" "$tool_command"
+  fi
+  if echo "$tool_command" | grep -qE '[>]{1,2}[[:space:]]+[^[:space:]]'; then
+    _deny "redirect" "禁止通过重定向写入文件；请使用 apply_patch。" "$tool_command"
   fi
+  if echo "$tool_command" | grep -qE '\btee\b|\bdd\b.*of='; then
+    _deny "tee-dd" "禁止通过 tee/dd 写入文件；请使用 apply_patch。" "$tool_command"
+  fi
+  if echo "$tool_command" | grep -qE '(^|;|\|\||&&|\|)[[:space:]]*(cp|mv|touch)\b'; then
+    _deny "copy-move-touch" "禁止通过 cp/mv/touch 改变文件；请使用 apply_patch。" "$tool_command"
+  fi
+  exit 0
+fi
 
+if [ "$tool_name" = "apply_patch" ]; then
+  patch_paths=$(printf '%s\n' "$tool_command" | sed -nE 's/^\*\*\* (Add|Update|Delete) File: (.+)$/\2/p')
+  while IFS= read -r file_path; do
+    [ -n "$file_path" ] && _guard_file_path "$file_path"
+  done <<< "$patch_paths"
   mark_dev_action 2>/dev/null || true
   exit 0
 fi
 
+# 兼容尚未 canonicalize 的宿主输入；当前 Codex 正常上报 apply_patch。
+if [ "$tool_name" = "Write" ] || [ "$tool_name" = "Edit" ] || [ "$tool_name" = "SearchReplace" ]; then
+  file_path=$(echo "$input" | jq -r '.tool_input.file_path // .tool_input.path // empty')
+  _guard_file_path "$file_path"
+  mark_dev_action 2>/dev/null || true
+fi
+
 exit 0

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

@@ -1,5 +1,5 @@
 #!/bin/bash
-# prompt-submit.sh — UserPromptSubmit 触发词智能路由（通用适配版）
+# prompt-submit.sh — Codex UserPromptSubmit 触发词智能路由
 # 治理卡位 #3: Layer 1 精准触发 → Layer 2 阻断 → Layer 3 状态注入
 set -euo pipefail
 
@@ -8,8 +8,13 @@ prompt=$(echo "$input" | jq -r '.prompt // empty')
 [ -z "$prompt" ] && exit 0
 
 HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+export CURRENT_MAGIC=".codex"
+export MAGIC_DIR=".codex"
+export PROJECT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+# Codex hook command 继承 session cwd；先统一 git root，确保状态与报告路径稳定。
+cd "$PROJECT_DIR"
 source "$HOOK_DIR/lib/vocabulary.sh" 2>/dev/null || true
-source "$HOOK_DIR/lib/state-detect.sh" 2>/dev/null || true
+source "$HOOK_DIR/lib/common.sh" 2>/dev/null || true
 source "$HOOK_DIR/lib/notify.sh" 2>/dev/null || true
 
 # ─── Layer 1: 精准 P0 触发词 ───
@@ -72,7 +77,7 @@ handoff=$(echo "$state" | awk -F'::' '{print $4}')
 echo "[ADD 状态] Plan: ${plan}, 轮次: ${rounds}, Step: ${step}, handoff: ${handoff}"
 
 # ─── Hook 治理日报（注入 AI 上下文）───
-HOOK_JSONL="${MAGIC_DIR:-.qoder}/reports/hook-events.jsonl"
+HOOK_JSONL="${MAGIC_DIR:-.codex}/reports/hook-events.jsonl"
 if [ -f "$HOOK_JSONL" ]; then
   TODAY="$(date +%Y-%m-%d)"
   TOTAL=$(grep -c "\"ts\":\"${TODAY}" "$HOOK_JSONL" 2>/dev/null || echo 0)

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

@@ -1,22 +1,28 @@
 #!/bin/bash
-# SessionStart — ADD 上下文恢复 + 模板索引注入（Claude Code 适配）
+# SessionStart — ADD 上下文恢复 + 模板索引注入（Codex 适配）
 # 治理卡位 #1: ADD状态恢复 + 模板索引注入
 set -euo pipefail
 
 HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+export CURRENT_MAGIC=".codex"
+export MAGIC_DIR=".codex"
+export PROJECT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
 
 # 加载四端通用函数（路径统一后: .claude/hooks/lib/common.sh）
 COMMON_LIB="$HOOK_DIR/lib/common.sh"
 [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
 
-# 设置项目目录
-export PROJECT_DIR="$PWD"
+# Codex 可能从 repo 子目录启动；状态仍只读取 Codex 自己的 `.codex`。
+export PLANS_DIR="$PROJECT_DIR/$MAGIC_DIR/plans"
 
 # ── ① ADD 状态恢复 ──
 state=$(detect_active_add 2>/dev/null || true)
 if [ -n "$state" ]; then
-  IFS='::' read -r plan step rounds handoff add_route <<< "$state"
+  plan=$(echo "$state" | awk -F'::' '{print $1}')
+  step=$(echo "$state" | awk -F'::' '{print $2}')
+  rounds=$(echo "$state" | awk -F'::' '{print $3}')
+  handoff=$(echo "$state" | awk -F'::' '{print $4}')
+  add_route=$(echo "$state" | awk -F'::' '{print $5}')
   cat <<EOF
 [ADD SessionStart] 检测到活跃 ADD Plan:
   Plan: ${plan}
@@ -28,15 +34,19 @@ EOF
 fi
 
 # ── ② 模板索引注入 ──
-TPL_SCRIPT="$HOOK_DIR/lib/preload-templates.sh"
-if [ -f "$TPL_SCRIPT" ]; then
-  bash "$TPL_SCRIPT" --index
+# core lib 的相对路径面向其他 adapter；Codex 直接读取项目 `.codex/templates`。
+TEMPLATES_DIR="$PROJECT_DIR/$CURRENT_MAGIC/templates"
+if [ -d "$TEMPLATES_DIR" ]; then
+  echo "## ADD 可用模板清单"
+  for template_path in "$TEMPLATES_DIR"/*.md; do
+    [ -f "$template_path" ] || continue
+    echo "- $(basename "$template_path")"
+  done
 fi
 
 # ── ③ §代办刷新：活跃 Plan 时提醒加载 IDE 代办 ──
 # session-init Step 2.6 依赖 IDE resume invoke SKILL，本段作为兜底
 if [ -n "$state" ]; then
-  IFS='::' read -r plan step rounds handoff add_route <<< "$state"
   cat <<EOF
 [代办] 检测到活跃 Plan: ${plan}。如有未加载的 IDE 代办清单，请从 tasks.md §IDE JSON 刷新 TodoWrite。
 EOF

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

@@ -1,45 +1,71 @@
 #!/bin/bash
-# stop-check.sh — Claude Code Stop：四象限分流 + 验收检查（few-shot 上下文注入）
-# 治理卡位 #7: 验收检查 + devlog + 阻断
+# stop-check.sh — Codex Stop：四象限分流 + 验收检查
 set -euo pipefail
 
 HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+export CURRENT_MAGIC=".codex"
+export MAGIC_DIR=".codex"
+export PROJECT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
 COMMON_LIB="$HOOK_DIR/lib/common.sh"
 [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
 
-export PROJECT_DIR="$PWD"
+input=$(cat 2>/dev/null || echo '{}')
+
+# Stop 已经续跑过一次时不再次阻断，避免递归 continuation。
+if echo "$input" | jq -e '.stop_hook_active == true' >/dev/null 2>&1; then
+  exit 0
+fi
+
+_system_message() {
+  local message="$1"
+  jq -nc --arg message "$message" '{systemMessage: $message}'
+}
 
 state=$(detect_active_add 2>/dev/null || true)
 has_dev=$(has_dev_action 2>/dev/null && echo "true" || echo "false")
 
-# ═══════ Q1: 无 ADD + 无 dev → 正常停 ═══════
+# DB 是 lifecycle 真相源；不可用时 fail closed，不能谎报“无活跃 Plan”。
+if [ "${state%%::*}" = "__STATUS_UNAVAILABLE__" ]; then
+  reason=$(echo "$state" | awk -F'::' '{print $2}')
+  printf '%s\n' "[ADD Stop] ⛔ Plan status 暂不可用（${reason}）。未回退 Handoff/add-route 猜测，请恢复数据库或 MCP resolver 后重试。" >&2
+  exit "${EXIT_BLOCK:-2}"
+fi
+
+# Q1: 无 ADD + 无 dev → exit 0 且 stdout 为空。
 if [ -z "$state" ] && [ "$has_dev" != "true" ]; then
   exit 0
 fi
 
-# ═══════ Q2: 无 ADD + 有 dev → 严重违规，few-shot 注入 ═══════
+# Q2: 无 ADD + 有 dev → exit 2，stderr 成为 continuation reason。
 if [ -z "$state" ] && [ "$has_dev" = "true" ]; then
-  build_stop_context "no_add_has_dev" >&2
-  exit $EXIT_BLOCK
+  build_stop_context "no_add_has_dev" "" >&2
+  exit "${EXIT_BLOCK:-2}"
 fi
 
-IFS='::' read -r plan step rounds handoff add_route <<< "$state"
+plan=$(echo "$state" | awk -F'::' '{print $1}')
+step=$(echo "$state" | awk -F'::' '{print $2}')
+approval=$(echo "$state" | awk -F'::' '{print $3}')
 
-# ═══════ Q3: 有 ADD + 无 dev → 注入状态 ═══════
+# Q3: 有 ADD + 无 dev → 合法 JSON，不输出纯文本。
 if [ "$has_dev" != "true" ]; then
-  echo "[ADD Stop] Plan: ${plan}, 轮次: ${rounds}, Step: ${step}"
-  echo "本次无代码改动。下次继续时执行 session-init 恢复上下文。"
+  _system_message "[ADD Stop] Plan: ${plan}；approval: ${approval}；tasks: ${step}。本次无代码改动。"
   exit 0
 fi
 
-# ═══════ Q4: 有 ADD + 有 dev → 验收检查 ═══════
-issues=$(check_add_completeness "$handoff" "$add_route" 2>/dev/null || true)
-if [ -n "$issues" ]; then
-  build_stop_context "has_add_dev_unclosed" "$issues" >&2
-  exit $EXIT_BLOCK
+# Q4: 有 ADD + 有 dev。DB progress 决定本轮是否仍有任务；Handoff 只在
+# Step 8 生成，不能参与 active 判定，也不能因缺失而把 ACTIVE Plan 判成无 Plan。
+done_tasks=${step%%/*}
+total_tasks=${step##*/}
+if [[ "$done_tasks" =~ ^[0-9]+$ ]] && [[ "$total_tasks" =~ ^[0-9]+$ ]] && [ "$done_tasks" -lt "$total_tasks" ]; then
+  cat >&2 <<EOF
+[ADD Stop] ⚠️ 当前 DB Plan 仍为 ACTIVE，任务进度 ${done_tasks}/${total_tasks}：${plan}
+
+请继续执行当前 Plan 的未完成 Task，并为本轮改动补齐 record_dev_operation 审计。
+Handoff 只在 Step 8 生成；本提示没有使用 Handoff/add-route 猜测 active 状态。
+EOF
+  exit "${EXIT_BLOCK:-2}"
 fi
 
 clear_dev_action 2>/dev/null || true
-echo "[ADD Stop] ✅ 验收通过——checklist 全部勾选，devlog 已记录。"
+_system_message "[ADD Stop] DB Plan ${plan} 的 tasks 已完成（${done_tasks}/${total_tasks}）；可进入 Review/closure。"
 exit 0

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": "bash \"$(git rev-parse --show-toplevel)/.codex/hooks/session-start.sh\"",
+            "statusMessage": "Loading ADD state",
+            "additionalContextLimit": 5000
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$(git rev-parse --show-toplevel)/.codex/hooks/prompt-submit.sh\"",
+            "statusMessage": "Routing ADD workflow"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "^(Bash|apply_patch|Edit|Write)$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$(git rev-parse --show-toplevel)/.codex/hooks/pre-tool-use.sh\"",
+            "statusMessage": "Checking ADD policy",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "^(Bash|apply_patch|Edit|Write)$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$(git rev-parse --show-toplevel)/.codex/hooks/post-tool-use.sh\"",
+            "statusMessage": "Recording ADD result",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$(git rev-parse --show-toplevel)/.codex/hooks/stop-check.sh\"",
+            "statusMessage": "Checking ADD closure",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}