add-coder 0.3.26 → 0.3.27

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

@@ -1,10 +1,12 @@
 #!/bin/bash
 # stop-check.sh — Claude Code Stop：四象限分流 + 验收检查（few-shot 上下文注入）
 # 治理卡位 #7: 验收检查 + devlog + 阻断
+# DB lifecycle 真相源（协议层）：DB 不可用时 fail-closed，禁止回退 Handoff/add-route 猜测
 set -euo pipefail
 
 HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
 export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+export MAGIC_DIR=$(basename "$(dirname "$HOOK_DIR")")
 COMMON_LIB="$HOOK_DIR/lib/common.sh"
 [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
 
@@ -13,6 +15,13 @@ export PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
 state=$(detect_active_add 2>/dev/null || true)
 has_dev=$(has_dev_action 2>/dev/null && echo "true" || echo "false")
 
+# ═══════ Q0: DB 不可用 → fail closed（禁止当“无 Plan”） ═══════
+if [ "${state%%::*}" = "__STATUS_UNAVAILABLE__" ]; then
+  reason=$(echo "$state" | awk -F'::' '{print $2}')
+  echo "[ADD Stop] ⛔ Plan status 暂不可用（${reason}）。未回退 Handoff/add-route 猜测，请恢复数据库或 MCP resolver 后重试。" >&2
+  exit "${EXIT_BLOCK:-2}"
+fi
+
 # ═══════ Q1: 无 ADD + 无 dev → 正常停 ═══════
 if [ -z "$state" ] && [ "$has_dev" != "true" ]; then
   exit 0

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.sh

@@ -52,7 +52,7 @@ CONTENT=$(echo "$input" | jq -r '
   elif .tool_input.replacements then .tool_input.replacements[0].new_text
   else "" end')
 # L24: PostToolUse 不可阻断（仅反馈），PreToolUse exit 2 + ask 可拦截
-# L24: 文件在 .qoder/(plans|specs)/ 下但 Write 工具未传 content → 无法校验，阻断
+# L24: 文件在 .codex/(plans|specs)/ 下但 Write 工具未传 content → 无法校验，阻断
 if [ -z "$CONTENT" ]; then
   echo "⛔ 拒绝：Write 工具未传 file_content，无法校验手写文档格式" >&2
   echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"ask","permissionDecisionReason":"Write 工具未传 file_content，无法校验手写文档。请用 SearchReplace 改写已有文件，或用 Write 工具重试。"}}'
@@ -63,45 +63,54 @@ fi
 PROJECT_DIR="$PWD"
 TEMPLATES_DIR="$PROJECT_DIR/$MAGIC_DIR/templates"
 
-# 通过 filename 匹配模板名
+# 文件名类型 token 匹配（特异性排序，取代子串 grep；R5/Task 1.4）
+# review/handoff 不在此层绑定（需内容特征细分单多轮/运行时），留给下方探测链
 TEMPLATE_NAME=""
-for tmpl in "$TEMPLATES_DIR"/*.md; do
-  base=$(basename "$tmpl")
-  if echo "$file_path" | grep -q "$base"; then
-    TEMPLATE_NAME="$base"
-    break
-  fi
-done
+base=$(basename "$file_path")
+base=${base%-v[0-9]*}
+case "$base" in
+  *add-route*heavy*) TEMPLATE_NAME="add-route-template-heavyweight.md" ;;
+  *add-route*)       TEMPLATE_NAME="add-route-template.md" ;;
+  *hitl*)            TEMPLATE_NAME="hitl-template.md" ;;
+  *handoff*)         : ;;  # R15: 跳过 token 层，交内容探测链（单/多轮细分）；必须在 *report* 前，防文件名含 report 的 handoff 被误吞
+  *checklist*)       TEMPLATE_NAME="checklist-template.md" ;;
+  *fix-verif*)       TEMPLATE_NAME="fix-verification-template.md" ;;
+  *report*runtime*)  TEMPLATE_NAME="runtime-report-template.md" ;;
+  *report*)          TEMPLATE_NAME="report-template.md" ;;
+  *tasks*)           TEMPLATE_NAME="tasks-template.md" ;;
+  *spec*)            TEMPLATE_NAME="spec-template.md" ;;
+  *plan*)            TEMPLATE_NAME="standard-plan-template.md" ;;
+esac
 
 # 退一步：根据文件内容特征猜测模板类型
 if [ -z "$TEMPLATE_NAME" ]; then
-  if echo "$CONTENT" | grep -q "## PLAN 元信息"; then
+  if grep -q "## PLAN 元信息" <<< "$CONTENT"; then
     TEMPLATE_NAME="standard-plan-template.md"
-  elif echo "$CONTENT" | grep -q "## 一、Plan 概述"; then
+  elif grep -q "## 一、Plan 概述" <<< "$CONTENT"; then
     TEMPLATE_NAME="simple-plan-template.md"
-  elif echo "$CONTENT" | grep -q "## 四、Handoff"; then
+  elif grep -q "## 四、Handoff" <<< "$CONTENT"; then
     TEMPLATE_NAME="simple-plan-template.md"
-  elif echo "$CONTENT" | grep -q "## Review 元信息"; then
-    if echo "$CONTENT" | grep -q "运行时验证"; then
+  elif grep -q "## Review 元信息" <<< "$CONTENT"; then
+    if grep -q "运行时验证" <<< "$CONTENT"; then
       TEMPLATE_NAME="review-runtime-template.md"
-    elif echo "$CONTENT" | grep -q "跨仓库格式契约"; then
+    elif grep -q "跨仓库格式契约" <<< "$CONTENT"; then
       TEMPLATE_NAME="review-implementation-template.md"
     else
       TEMPLATE_NAME="review-template.md"
     fi
-  elif echo "$CONTENT" | grep -q "## Why"; then
+  elif grep -q "## Why" <<< "$CONTENT"; then
     TEMPLATE_NAME="spec-template.md"
-  elif echo "$CONTENT" | grep -q "## Preconditions"; then
+  elif grep -q "## Preconditions" <<< "$CONTENT"; then
     TEMPLATE_NAME="tasks-template.md"
-  elif echo "$CONTENT" | grep -q "审计链（证据→devlog→checklist）"; then
+  elif grep -q "审计链（证据→devlog→checklist）" <<< "$CONTENT"; then
     TEMPLATE_NAME="checklist-template.md"
   else
     case "$file_path" in
       *handoff*)
         # ★ 按内容特征区分单/多轮 handoff，不依赖文件名
-        if echo "$CONTENT" | grep -qF "## 全局元信息"; then
+        if grep -qF "## 全局元信息" <<< "$CONTENT"; then
           TEMPLATE_NAME="handoff-multi-round-template.md"
-        elif echo "$CONTENT" | grep -qF "## 1. 交接前状态"; then
+        elif grep -qF "## 1. 交接前状态" <<< "$CONTENT"; then
           TEMPLATE_NAME="handoff-single-round-template.md"
         else
           echo "⛔ handoff 文件内容无法识别模板类型（缺 '## 全局元信息' 或 '## 1. 交接前状态'），拒绝写入" >&2
@@ -110,9 +119,9 @@ if [ -z "$TEMPLATE_NAME" ]; then
           exit 2
         fi
         ;;
-      *plan*)            TEMPLATE_NAME="standard-plan-template.md" ;;
       *add-route*heavy*) TEMPLATE_NAME="add-route-template-heavyweight.md" ;;
       *add-route*)       TEMPLATE_NAME="add-route-template.md" ;;
+      *plan*)            TEMPLATE_NAME="standard-plan-template.md" ;;
       *tasks*)           TEMPLATE_NAME="tasks-template.md" ;;
       *spec*)            TEMPLATE_NAME="spec-template.md" ;;
       *checklist*)       TEMPLATE_NAME="checklist-template.md" ;;
@@ -122,7 +131,7 @@ if [ -z "$TEMPLATE_NAME" ]; then
       *hitl*)           TEMPLATE_NAME="hitl-template.md" ;;
       *) 
         # 增量修订识别：包含 ~~删除线~~ / → 新增标记 / [修订日期] 任意一个 → 视为增量更新，放行
-        if echo "$CONTENT" | grep -qE '~~.+~~|→|\[[0-9]{4}-[0-9]{2}-[0-9]{2}\s+修订'; then
+        if grep -qE '~~.+~~|→|\[[0-9]{4}-[0-9]{2}-[0-9]{2}\s+修订' <<< "$CONTENT"; then
           echo "[doc-format-guard] 检测到增量修订格式，跳过完整章节校验" >&2
           exit 0
         fi
@@ -154,17 +163,56 @@ ISSUES=""
 TMPFILE="$PROJECT_DIR/$MAGIC_DIR/.doc-guard-issues.tmp"
 : > "$TMPFILE"
 trap "rm -f $TMPFILE" EXIT
+
+# ── 锚定校验（锚定制：schema 声明 anchor，参照内容从模板现场提取；Task 1.2）──
+# 锚点不在模板 → 跳过该规则 + stderr 告警（不阻塞写入，冒烟巡检兑底）
+# within 前缀匹配；heading 缺失 → 跳过规则 + 告警（不误拦）
+if [ "$IS_SEARCH_REPLACE" != "true" ]; then
+  jq -r '.sections[] | select(.anchor != null) | .id + "|" + .anchor + "|" + (.within // "")' "$SCHEMA_FILE" 2>/dev/null | while IFS='|' read -r aid anchor within; do
+    [ -z "$anchor" ] && continue
+    ref_line=$(grep -m1 -F "$anchor" "$TEMPLATES_DIR/$TEMPLATE_NAME" 2>/dev/null || true)
+    if [ -z "$ref_line" ]; then
+      echo "[doc-format-guard] anchor_miss: schema ${aid} 声明的 anchor '${anchor}' 在 ${TEMPLATE_NAME} 中未定位，跳过该规则（冒烟巡检兑底）" >&2
+      continue
+    fi
+    # 参照行剖 token：去 markdown 符号与括号 → 空白切分 → 去空 → 去占位符 token → 去重
+    tokens=$(echo "$ref_line" | tr '#*`|(){' '         ' | tr -s ' ' '\n' | grep -v '^$' | grep -vF '{' | sort -u)
+    [ -z "$tokens" ] && continue
+    # within 作用域（前缀匹配，heading 缺失 → 跳过该规则 + 告警）
+    scope="$CONTENT"
+    if [ -n "$within" ]; then
+      if grep -q "^${within}" <<< "$CONTENT"; then
+        scope=$(sed -n "/^${within}/,/^## /p" <<< "$CONTENT")
+      else
+        echo "[doc-format-guard] within_miss: schema ${aid} 的 within '${within}' 在文档中未定位，跳过该规则" >&2
+        continue
+      fi
+    fi
+    # 声明级缺失统计：一个锚点声明的必选 token 有任一缺失即记 1 条规则缺失（struct_score 精确语义）
+    miss_tokens=""
+    for tok in $tokens; do
+      if ! grep -qF "$tok" <<< "$scope"; then
+        miss_tokens="${miss_tokens}${tok} "
+      fi
+    done
+    # if 语句（非 && 链）：miss_tokens 为空时返回 0，避免 while 管道退出码非零触发 set -e
+    if [ -n "$miss_tokens" ]; then
+      echo "  缺锚点(${aid}): ${miss_tokens}"
+    fi
+  done >> "$TMPFILE"
+fi
+
 # SearchReplace 只传 patch → 跳过章节/子章节校验（无法从 patch 推断完整文档结构）
 if [ "$IS_SEARCH_REPLACE" != "true" ]; then
-  jq -r '.sections[] | select(.required == true) | .heading' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r heading; do
-    if ! echo "$CONTENT" | grep -qF "$heading"; then
+  jq -r '.sections[] | select(.required == true) | select(.heading != null) | .heading' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r heading; do
+    if ! grep -qF "$heading" <<< "$CONTENT"; then
       echo "  缺章节: $heading"
     fi
-  done > "$TMPFILE"
+  done >> "$TMPFILE"
 
   # 子章节
-  jq -r '.sections[].subsections[]?.heading' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r sub; do
-    if ! echo "$CONTENT" | grep -qF "$sub"; then
+  jq -r '.sections[].subsections[]? | select(.heading != null) | .heading' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r sub; do
+    if ! grep -qF "$sub" <<< "$CONTENT"; then
       echo "  缺子章节: $sub"
     fi
   done >> "$TMPFILE"
@@ -172,15 +220,22 @@ fi
 
 # ── 占位符校验 ──
 jq -r '.placeholders[]?' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r ph; do
-  if echo "$CONTENT" | grep -qF "$ph"; then
+  if grep -qF "$ph" <<< "$CONTENT"; then
     echo "  未替换占位符: $ph"
   fi
 done >> "$TMPFILE"
 
-# ── 禁止词校验 ──
+# ── 结构位禁词校验（仅标题行 + schema 声明的 groupColumn；正文叙述免疫；Task 1.2）──
+struct_text=$(grep -E '^#{2,}[[:space:]]' <<< "$CONTENT")
+col=$(jq -r '.groupColumn // empty' "$SCHEMA_FILE" 2>/dev/null)
+if [ -n "$col" ]; then
+  struct_text="${struct_text}
+$(awk -F'|' -v c="$col" 'NF>c {gsub(/^[[:space:]]+|[[:space:]]+$/, "", $(c+1)); print $(c+1)}' <<< "$CONTENT")"
+fi
 jq -r '.forbidden_terms[]?' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r term; do
-  if echo "$CONTENT" | grep -qw "$term"; then
-    echo "  禁止词: $term"
+  # 结构位（标题行/分组列）是原子单元：定串匹配即可命中；正文不参与（豁免由提取范围保证）
+  if grep -qF "$term" <<< "$struct_text"; then
+    echo "  结构位禁词: $term"
   fi
 done >> "$TMPFILE"
 
@@ -192,29 +247,29 @@ ALGO_ISSUES=""
 # 规则1: 精简版 Plan 反作弊
 if echo "$TEMPLATE_NAME" | grep -q 'simple-plan'; then
   # 1a. 文件数 ≤ 3
-  file_count=$(echo "$CONTENT" | grep -cP '^\|\s*`[^`]+`' 2>/dev/null || echo "0")
+  file_count=$(grep -cP '^\|\s*`[^`]+`' <<< "$CONTENT" 2>/dev/null || echo "0")
   if [ "$file_count" -gt 3 ] 2>/dev/null; then
     ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: 涉及 ${file_count} 个文件（超过 3 个限制），应改用 standard-plan-template.md\n"
   fi
   # 1b. HITL 表不能写 "等 N 个文件"
-  if echo "$CONTENT" | grep -qP '等\s*\d*\s*个文件|等\s*若干'; then
+  if grep -qP '等\s*\d*\s*个文件|等\s*若干' <<< "$CONTENT"; then
     ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: HITL 表文件清单使用模糊描述（'等 N 个文件'），必须列出实际完整路径\n"
   fi
   # 1c. HITL 方案/设计决策不能写 "等若干决策"
-  if echo "$CONTENT" | grep -qP '等\s*若干\s*(决策|方案|设计)'; then
+  if grep -qP '等\s*若干\s*(决策|方案|设计)' <<< "$CONTENT"; then
     ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: HITL 表方案/设计决策使用模糊描述（'等若干决策'），必须逐条列出\n"
   fi
   # 1d. 不能包含架构设计章节（精简版无架构设计）
-  if echo "$CONTENT" | grep -q '## 三、架构设计'; then
+  if grep -q '## 三、架构设计' <<< "$CONTENT"; then
     ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: 包含 '## 三、架构设计' 章节，精简版不应有架构设计——应改用 standard-plan-template.md\n"
   fi
 fi
 
 # 规则2: HITL 表非空校验（所有 Plan + Review 模板）
 if echo "$TEMPLATE_NAME" | grep -qE 'plan|review'; then
-  if echo "$CONTENT" | grep -q '## HITL'; then
+  if grep -q '## HITL' <<< "$CONTENT"; then
     # HITL 表至少要有 1 行非占位符内容（不包含 { } 占位符）
-    hitl_rows=$(echo "$CONTENT" | sed -n '/## HITL/,/^## /p' | grep -cP '^\|\s*[^|{]*\s*\|' 2>/dev/null || echo "0")
+    hitl_rows=$(sed -n '/## HITL/,/^## /p' <<< "$CONTENT" | grep -cP '^\|\s*[^|{]*\s*\|' 2>/dev/null || echo "0")
     # rows 包含表头行和分隔行，实际数据行 = rows - 2
     hitl_data=$((hitl_rows - 2))
     if [ "$hitl_data" -lt 1 ] 2>/dev/null; then
@@ -242,12 +297,36 @@ fi
 
 ISSUES=$(cat "$TMPFILE" 2>/dev/null)
 
+# ── 判定回流 extra（Task 1.5 数据契约：anchor_hit/struct_score 精确语义；override 由上层 hook 在人类推翻时追加）──
+# struct_score = (适用规则数 - 缺失规则数) / 适用规则数 × 100，适用规则从 schema 实况计数
+anchor_total=$(jq -r '[.sections[] | select(.anchor != null)] | length' "$SCHEMA_FILE" 2>/dev/null || echo 0)
+heading_total=$(jq -r '[.sections[] | select(.required == true and .heading != null)] | length' "$SCHEMA_FILE" 2>/dev/null || echo 0)
+sub_total=$(jq -r '[.sections[].subsections[]? | select(.heading != null)] | length' "$SCHEMA_FILE" 2>/dev/null || echo 0)
+term_total=$(jq -r '.forbidden_terms | length' "$SCHEMA_FILE" 2>/dev/null || echo 0)
+if [ "$IS_SEARCH_REPLACE" = "true" ]; then
+  applied=$term_total  # patch 路径仅禁词规则适用
+else
+  applied=$(( anchor_total + heading_total + sub_total + term_total ))
+fi
+missed=$(wc -l < "$TMPFILE" 2>/dev/null | tr -d ' ')
+missed=${missed:-0}
+anchor_hit=true
+grep -q "缺锚点" "$TMPFILE" 2>/dev/null && anchor_hit=false
+struct_score=100
+if [ "$applied" -gt 0 ] 2>/dev/null && [ "$missed" -gt 0 ] 2>/dev/null; then
+  struct_score=$(( (applied - missed) * 100 / applied ))
+  [ "$struct_score" -lt 0 ] && struct_score=0
+fi
+BACKFLOW_EXTRA="\"anchor_hit\":${anchor_hit},\"struct_score\":${struct_score}"
+
 # ── 阻断或放行 ──
 if [ -n "$ISSUES" ]; then
   echo "⛔ $TEMPLATE_NAME 校验不通过:
 $ISSUES" >&2
-  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"文档格式校验不通过，请对照模板修正\"}}"
-  write_hook_event "doc-format-guard" "deny" "$file_path" "文档格式校验不通过" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
+  # 明细注入 stdout reason（去引号防 JSON 破坏，截断 180 字），让被拦方第一时间知道改什么
+  ISSUES_BRIEF=$(printf '%s' "$ISSUES" | tr '\n' ' ' | tr -d '"' | tr -s ' ' | cut -c1-180)
+  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"文档格式校验不通过: ${ISSUES_BRIEF}\"}}"
+  write_hook_event "doc-format-guard" "deny" "$file_path" "文档格式校验不通过" "$PLAN_KEYWORD" "$PLAN_STATUS" "$BACKFLOW_EXTRA" 2>/dev/null || true
   exit 2
 fi
 
@@ -258,4 +337,7 @@ if echo "$file_path" | grep -q "$MAGIC_DIR/plans/"; then
   fi
 fi
 
+# 放行回流（Task 1.5：anchor_hit/struct_score 正样本底座）
+write_hook_event "doc-format-guard" "allow" "$file_path" "校验通过" "$PLAN_KEYWORD" "$PLAN_STATUS" "$BACKFLOW_EXTRA" 2>/dev/null || true
+
 exit 0

package/templates/adapters/codex/hooks/lib/common.sh

@@ -4,17 +4,25 @@
  # @Date         : 2026-07-17 13:14:46
  # @LastEditors  : xiaomingming wujixmm@gmail.com
  # @LastEditTime : 2026-07-17 13:21:36
- # @FilePath     : /add-coder/templates/core/hooks/lib/common.sh
- # @Description  : ADD Hook 共享库 — 四端通用函数
+ # @FilePath     : /add-coder/templates/adapters/codex/hooks/lib/common.sh
+ # @Description  : Codex ADD Hook 自治库
 ### 
-# ADD Hook 共享库 — 四端通用函数
-# 被 Claude/Qoder/VS Code/Trae adapter 的 hook 脚本 source 引用
-# 路径: templates/core/hooks/lib/common.sh
+# Codex ADD Hook 自治库
+# 路径: templates/adapters/codex/hooks/lib/common.sh
 
 # 退出码常量,目前适配的ide都一样
 export EXIT_PASS=0   # 放行
 export EXIT_BLOCK=2  # 阻断
 
+# ── 当前 adapter 自治目录 ──
+# 每个 adapter 只读取、写入自己的 magicDir；禁止跨 adapter fallback。
+if [ -z "${PROJECT_DIR:-}" ]; then
+  PROJECT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+fi
+export PROJECT_DIR
+export MAGIC_DIR=".codex"
+export PLANS_DIR="$PROJECT_DIR/$MAGIC_DIR/plans"
+
 # ── 输入解析 ──
 
 # 从 stdin 解析 JSON 输入（hook 事件通过 stdin 传入 JSON）
@@ -32,101 +40,41 @@ json_get() {
   echo "$1" | grep -o "\"$2\"[[:space:]]*:[[:space:]]*\"[^\"]*\"" | head -1 | sed 's/.*: *"\([^"]*\)".*/\1/'
 }
 
-# ── ADD 活跃 Plan 检测（裁决定逻辑，SKILL §0.7.1） ──
-#
-# 活跃判定标准：
-#   1. magicDir 优先级: 由 Hook 脚本自身的路径推断（.claude/hooks/xxx.sh → .claude）→ .add → stderr 提示全局搜索
-#   2. 索引优先: 先读 plans/index.md 匹配 → 无匹配才 glob *-handoff*.md
-#   3. 活跃定义: add-route 中存在 [ ] 未勾选项 = 活跃；全部 [x] = 已收敛
-#   4. 多 Plan 冲突: 取 add-route 最近 mtime
-#   5. 无 add-route: Plan 初始态，视为活跃
-#
-# 前置条件: 调用方需设置 PROJECT_DIR 环境变量（项目根目录）
-# 返回: "plan_keyword::step_n/total::round_n/total::handoff_path::add_route_path" 或 ""
-
-detect_active_add() {
-  local plans_dir=""
-
-  # 1. magicDir 回退: 当前 IDE（CURRENT_MAGIC）→ 目录检测 → .add → 提示全局搜索
-  local magic_dirs=()
-  if [ -n "${CURRENT_MAGIC:-}" ]; then
-    magic_dirs+=("$CURRENT_MAGIC")
-  else
-    # 兜底: 检测 PROJECT_DIR 下哪个 magicDir 存在
-    for m in ".claude" ".qoder" ".vscode" ".trae"; do
-      [ -d "${PROJECT_DIR:-$PWD}/$m" ] && { magic_dirs+=("$m"); break; }
-    done
-  fi
-  magic_dirs+=(".add")
-
-  for magic in "${magic_dirs[@]}"; do
-    if [ -d "${PROJECT_DIR:-$PWD}/$magic/plans" ]; then
-      plans_dir="${PROJECT_DIR:-$PWD}/$magic/plans"
-      break
-    fi
-  done
-
-  if [ -z "$plans_dir" ]; then
-    echo "[ADD detect] 未在当前 IDE magicDir 和 .add 中找到 plans 目录。是否需要全局搜索所有 magicDir？" >&2
-    return 1
-  fi
-
-  local handoff=""
-  local add_route=""
-
-  # 2. 索引优先: 先读 index.md
-  if [ -f "$plans_dir/index.md" ]; then
-    # 从 index.md 表格提取最近一个 handoff 相对路径
-    # 表格格式: | YYYY-MM/DD/path-to-handoff.md | ...
-    handoff=$(grep -oE '[0-9]{4}-[0-9]{2}/[0-9]{2}/[^|]*handoff[^|]*\.md' "$plans_dir/index.md" 2>/dev/null | head -1 | xargs)
-    if [ -n "$handoff" ] && [ -f "$plans_dir/$handoff" ]; then
-      handoff="$plans_dir/$handoff"
-    else
-      handoff=""
-    fi
-  fi
+# ── ADD 活跃 Plan 检测 ──
+# lifecycle 的唯一真相源是 scoped DB。短生命周期 Hook 不常驻 LISTEN；每次触发
+# 都通过当前 adapter 生成态的机器桥调用 shared resolver。Handoff/add-route 不参与
+# active 裁决，也不允许跨 adapter 或文件系统 fallback。
 
-  # 3. 退路: glob handoff 文件（mtime 7 天内）
-  if [ -z "$handoff" ]; then
-    local today_dir="$plans_dir/$(date +%Y-%m)"
-    [ -d "$today_dir" ] && handoff=$(find "$today_dir" -name "*handoff*.md" -mtime -7 -type f 2>/dev/null | head -1)
-    [ -z "$handoff" ] && handoff=$(find "$plans_dir" -name "*handoff*.md" -mtime -7 -type f 2>/dev/null | head -1)
+query_plan_status() {
+  local bridge="${PROJECT_DIR:-$PWD}/${MAGIC_DIR:-.codex}/scripts/plan-status-bridge.ts"
+  if [ ! -f "$bridge" ]; then
+    echo '{"availability":"STATUS_UNAVAILABLE","source":"database","reason":"plan-status bridge missing"}'
+    return 3
   fi
-  [ -z "$handoff" ] && return 1
-
-  # 提取 plan keyword
-  local plan_kw=$(basename "$handoff" | sed 's/-handoff.*//')
-
-  # 查找 add-route
-  local handoff_dir=$(dirname "$handoff")
-  add_route=$(find "$handoff_dir" -name "*add-route*.md" -type f 2>/dev/null | head -1)
-  [ -z "$add_route" ] && add_route=$(find "$plans_dir" -name "*add-route*.md" -type f 2>/dev/null | head -1)
+  node --import tsx "$bridge"
+}
 
-  # 4. 活跃判定: 读 add-route，存在 [ ] 未勾选项 = 活跃
-  local step_info="?"
-  if [ -f "$add_route" ]; then
-    local ck=$(grep -c '\[x\]' "$add_route" 2>/dev/null || true)
-    local uc=$(grep -c '\[ \]' "$add_route" 2>/dev/null || true)
-    ck=${ck:-0}; uc=${uc:-0}
-    local total=$((ck + uc))
-    [ "$total" -gt 0 ] && step_info="${ck}/${total}"
-    # 全部 [x] → 已收敛（但 handoff 还存在 → 可能是遗留，仍返回但标记）
-  else
-    # 无 add-route → Plan 初始态，视为活跃
-    step_info="init"
+# 兼容既有 Hook 字段协议：
+# "planName::done/total::approvalStatus::none::none"；后两个路径不参与 active 判定。
+# DB 不可用时返回特殊首字段，调用方必须 fail closed，不能当作“无 Plan”。
+detect_active_add() {
+  local snapshot="" rc=0
+  snapshot="$(query_plan_status 2>/dev/null)" || rc=$?
+  if [ "$rc" -ne 0 ]; then
+    local reason
+    reason=$(printf '%s' "$snapshot" | jq -r '.reason // "database status unavailable"' 2>/dev/null || echo "database status unavailable")
+    echo "__STATUS_UNAVAILABLE__::${reason}::database::none::none"
+    return 0
   fi
-
-  # 5. 轮次统计（从 handoff）
-  local round_info="?"
-  if grep -q '<第[0-9]轮>' "$handoff" 2>/dev/null; then
-    local ck=$(grep -c '\[x\]' "$handoff" 2>/dev/null || true); ck=${ck:-0}
-    local total=$(grep -c '<第[0-9]轮>' "$handoff" 2>/dev/null || true); total=${total:-0}
-    [ "$total" -gt 0 ] && round_info="${ck}/${total}"
-  else
-    round_info="1/1"
+  if ! printf '%s' "$snapshot" | jq -e '.availability == "READY" and .isActive == true' >/dev/null 2>&1; then
+    return 1
   fi
-
-  echo "${plan_kw}::${step_info}::${round_info}::${handoff}::${add_route:-none}"
+  local plan done total approval
+  plan=$(printf '%s' "$snapshot" | jq -r '.planName')
+  done=$(printf '%s' "$snapshot" | jq -r '.progress.doneTasks // 0')
+  total=$(printf '%s' "$snapshot" | jq -r '.progress.totalTasks // 0')
+  approval=$(printf '%s' "$snapshot" | jq -r '.approvalStatus // "none"')
+  echo "${plan}::${done}/${total}::${approval}::none::none"
 }
 
 # ── Dev Action 追踪 ──
@@ -202,7 +150,7 @@ build_stop_context() {
       echo "[ADD Stop] 无活跃 Plan，无代码改动。正常结束。"
       ;;
     "no_add_has_dev")
-      cat <<'EOF'
+      cat <<EOF
 [ADD Stop] ⚠️ 检测到代码修改但无活跃 ADD Plan。
 
 Plan 不是"文档开销"——它是代码治理的基础设施。跳过 Plan 的后果:
@@ -213,7 +161,7 @@ Plan 不是"文档开销"——它是代码治理的基础设施。跳过 Plan
 你必须立即补救，二选一:
 
 方案 A — 补 ADD 流程（招安）:
-  Step 0: 读 .qoder/templates/plan-template.md → 生成 Plan
+  Step 0: 读 ${MAGIC_DIR}/templates/standard-plan-template.md → 生成 Plan
           生成 add-route → check_dps ≥ {{dpsPass}}
   Step 1: 扩展 AgentAuditPhase（如需要）
   Step 2: 确认 agentAudit() 通道
@@ -223,8 +171,8 @@ Plan 不是"文档开销"——它是代码治理的基础设施。跳过 Plan
 方案 B — 补不上则回滚:
   如果改动太复杂无法追溯生成 Plan，则:
   ① git diff 确认改动范围
-  ② git checkout -- <改动的文件> 撤回
-  ③ 告知用户 "以下改动已回滚，请先走 ADD 流程再重新实施: <文件列表>"
+  ② 仅对已确认属于本轮的文件生成反向 apply_patch
+  ③ 无法安全确认改动所有权时停止，并请求用户决定
 
 无论选 A 还是 B，完成后告诉用户下次执行 session-init 恢复上下文。
 EOF

package/templates/adapters/codex/hooks/lib/context-inject.sh

@@ -24,7 +24,7 @@ build_stop_context() {
       echo "[ADD Stop] 无活跃 Plan，无代码改动。正常结束。"
       ;;
     "no_add_has_dev")
-      cat <<'EOF'
+      cat <<EOF
 [ADD Stop] ⚠️ 检测到代码修改但无活跃 ADD Plan。
 
 Plan 不是"文档开销"——它是代码治理的基础设斻。跳过 Plan 的后果:
@@ -35,7 +35,7 @@ Plan 不是"文档开销"——它是代码治理的基础设斻。跳过 Plan
 你必须立即补救，二选一:
 
 方案 A — 补 ADD 流程（招安）:
-  Step 0: 读 .qoder/templates/plan-template.md → 生成 Plan → .qoder/plans/{today}/{keyword}-plan-v1.md
+  Step 0: 读 ${MAGIC_DIR}/templates/standard-plan-template.md → 生成 Plan → ${MAGIC_DIR}/plans/{today}/{keyword}-plan-v1.md
           生成 add-route → check_dps ≥ {{dpsPass}}
   Step 1: 扩展 AgentAuditPhase（如需要）
   Step 2: 确认 agentAudit() 通道
@@ -45,8 +45,8 @@ Plan 不是"文档开销"——它是代码治理的基础设斻。跳过 Plan
 方案 B — 补不上则回滚:
   如果改动太复杂无法追溯生成 Plan，则:
   ① git diff 确认改动范围
-  ② git checkout -- <改动的文件> 撤回
-  ③ 告知用户 "以下改动已回滚，请先走 ADD 流程再重新实施: <文件列表>"
+  ② 仅对已确认属于本轮的文件生成反向 apply_patch
+  ③ 无法安全确认改动所有权时停止，并请求用户决定
 
 无论选 A 还是 B，完成后告诉用户下次执行 session-init 恢复上下文。
 EOF

package/templates/adapters/codex/hooks/lib/notify.sh

@@ -11,8 +11,8 @@
 #   - MCP Server 宕机不丢事件，重启后从文件恢复消费
 
 write_hook_event() {
-  local hook="$1" decision="$2" cmd="$3" reason="$4" plan="${5:-unknown}" status="${6:-none}"
-  local dir="${MAGIC_DIR:-.qoder}/reports"
+  local hook="$1" decision="$2" cmd="$3" reason="$4" plan="${5:-unknown}" status="${6:-none}" extra="${7:-}"
+  local dir=".codex/reports"
   mkdir -p "$dir" 2>/dev/null || true
   local file="$dir/hook-events.jsonl"
 
@@ -23,12 +23,14 @@ write_hook_event() {
     [ "$sz" -gt 262144 ] && mv "$file" "${file}.old" 2>/dev/null || true
   fi
 
-  printf '{"ts":"%s","hook":"%s","decision":"%s","cmd":"%s","reason":"%s","planKeyword":"%s","planStatus":"%s"}\n' \
+  # extra 为可选 JSON 片段（Task 1.5 数据契约：anchor_hit/struct_score/override 等），非空时以逗号拼接
+  printf '{"ts":"%s","hook":"%s","decision":"%s","cmd":"%s","reason":"%s","planKeyword":"%s","planStatus":"%s"%s}\n' \
     "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
     "$hook" \
     "$decision" \
     "$cmd" \
     "$reason" \
     "$plan" \
-    "$status" >> "$file"
+    "$status" \
+    "${extra:+,$extra}" >> "$file"
 }

package/templates/adapters/codex/hooks/lib/preload-templates.sh

@@ -4,11 +4,11 @@
  # @Date         : 2026-07-17 13:19:01
  # @LastEditors  : xiaomingming wujixmm@gmail.com
  # @LastEditTime : 2026-07-17 13:21:29
- # @FilePath     : /add-coder/templates/core/hooks/lib/preload-templates.sh
+ # @FilePath     : /add-coder/templates/adapters/codex/hooks/lib/preload-templates.sh
  # @Description  : ADD 模板预读脚本
 ### 
 # preload-templates.sh — ADD 模板预读脚本
-# 路径: templates/core/hooks/lib/preload-templates.sh
+# 路径: templates/adapters/codex/hooks/lib/preload-templates.sh
 #
 # 用法:
 #   preload-templates.sh --index              # 输出模板清单（文件名 + 用途）
@@ -16,14 +16,14 @@
 #   preload-templates.sh --full --top 5       # 输出前 5 个最常用模板全文
 #   preload-templates.sh --full --mark        # 全文输出 + 落 tpl-injected 标记
 #
-# 被 SessionStart（--index）和 UserPromptSubmit（--full）调用。
+# 可由 Codex 生命周期 hook 或人工按需调用。
 # tpl-injected 标记文件用于去重——同会话二次命中时不重复注入。
 
 set -euo pipefail
 
-# 模板目录（相对于本脚本）
+# core 标准模板在分发期物化到 `.codex/templates`；生成态只读取当前 adapter 本地副本。
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-TEMPLATES_DIR="${SCRIPT_DIR}/../../../core/templates"
+TEMPLATES_DIR="${SCRIPT_DIR}/../../templates"
 
 # tpl-injected 标记文件路径（项目级，/tmp 下按项目 hash 区分）
 PROJECT_HASH=$(echo "${PROJECT_DIR:-$PWD}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")
@@ -74,6 +74,25 @@ PRIORITY_ORDER=(
   "TERMINOLOGY.md"
 )
 
+validate_templates_dir() {
+  if [ ! -d "$TEMPLATES_DIR" ]; then
+    echo "[ADD preload] 模板目录不存在: $TEMPLATES_DIR" >&2
+    exit 1
+  fi
+
+  local available=0
+  local tmpl
+  for tmpl in "${PRIORITY_ORDER[@]}"; do
+    if [ -f "$TEMPLATES_DIR/$tmpl" ]; then
+      available=$((available + 1))
+    fi
+  done
+  if [ "$available" -eq 0 ]; then
+    echo "[ADD preload] 模板目录中未找到 ADD 标准模板: $TEMPLATES_DIR" >&2
+    exit 1
+  fi
+}
+
 # 读取模板文件内容（strip frontmatter）
 read_template_content() {
   local file="$1"
@@ -99,7 +118,7 @@ output_index() {
   for tmpl in "${PRIORITY_ORDER[@]}"; do
     if [ -f "$TEMPLATES_DIR/$tmpl" ]; then
       echo "| $i | $tmpl | ${TEMPLATES[$tmpl]:-模板文件} |"
-      ((i++))
+      i=$((i + 1))
     fi
   done
 }
@@ -165,6 +184,8 @@ main() {
     esac
   done
 
+  validate_templates_dir
+
   case "$mode" in
     index)
       output_index