add-coder 0.3.25 → 0.3.27

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

@@ -34,99 +34,58 @@ json_get() {
 
 # ── 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 初始态，视为活跃
+# lifecycle 的唯一真相源是 scoped DB。短生命周期 Hook 不常驻 LISTEN；每次触发
+# 都通过当前 adapter 生成态的机器桥（plan-status-bridge）调用 shared resolver。
+# Handoff/add-route 不再参与 active 裁决，禁止跨 adapter 或文件系统 fallback
+# （含 .add 回退与 mtime/勾选数推断）。
+#
+# magicDir 解析（Review P1 #5）: 入口必须注入自身 magicDir；未注入时从生成态
+# 脚本物理位置（<magicDir>/hooks/...）反推；推导失败 → STATUS_UNAVAILABLE，
+# 禁止任何 adapter 名称默认值。
 #
 # 前置条件: 调用方需设置 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")
+# 返回: "plan_keyword::step_n/total::round_n/total::handoff_path::add_route_path"
+#       或 "__STATUS_UNAVAILABLE__::reason::database::none::none"（调用方必须 fail-closed）
+
+query_plan_status() {
+  local bridge=""
+  if [ -n "${MAGIC_DIR:-}" ]; then
+    bridge="${PROJECT_DIR:-$PWD}/${MAGIC_DIR}/scripts/plan-status-bridge.ts"
+  elif [ -n "${HOOK_DIR:-}" ]; then
+    # 物理位置反推: <magicDir>/hooks/lib/common.sh → <magicDir>
+    bridge="${PROJECT_DIR:-$PWD}/$(basename "$(dirname "$(dirname "$HOOK_DIR")")")/scripts/plan-status-bridge.ts"
   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
+    echo '{"availability":"STATUS_UNAVAILABLE","source":"database","reason":"magicDir 未注入且无法从物理位置推导"}'
+    return 3
   fi
-
-  # 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)
+  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 追踪 ──
@@ -223,8 +182,8 @@ Plan 不是"文档开销"——它是代码治理的基础设施。跳过 Plan
 方案 B — 补不上则回滚:
   如果改动太复杂无法追溯生成 Plan，则:
   ① git diff 确认改动范围
-  ② git checkout -- <改动的文件> 撤回
-  ③ 告知用户 "以下改动已回滚，请先走 ADD 流程再重新实施: <文件列表>"
+  ② 仅对已确认属于本轮的文件生成反向 apply_patch
+  ③ 无法安全确认改动所有权时停止，并请求用户决定
 
 无论选 A 还是 B，完成后告诉用户下次执行 session-init 恢复上下文。
 EOF

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

@@ -45,8 +45,8 @@ Plan 不是"文档开销"——它是代码治理的基础设斻。跳过 Plan
 方案 B — 补不上则回滚:
   如果改动太复杂无法追溯生成 Plan，则:
   ① git diff 确认改动范围
-  ② git checkout -- <改动的文件> 撤回
-  ③ 告知用户 "以下改动已回滚，请先走 ADD 流程再重新实施: <文件列表>"
+  ② 仅对已确认属于本轮的文件生成反向 apply_patch
+  ③ 无法安全确认改动所有权时停止，并请求用户决定
 
 无论选 A 还是 B，完成后告诉用户下次执行 session-init 恢复上下文。
 EOF

package/templates/adapters/vscode/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="${MAGIC_DIR}/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/vscode/hooks/lib/preload-templates.sh

@@ -21,9 +21,10 @@
 
 set -euo pipefail
 
-# 模板目录（相对于本脚本）
+# 模板目录（分发期物化到各 adapter 本地：<magicDir>/templates；禁止回指源仓）
+# 协议层契约（模板预载）: 读 ${magicDir}/templates 本地物化副本；目录/标准模板缺失 fail-fast
 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")
@@ -88,6 +89,27 @@ read_template_content() {
   fi
 }
 
+# ── 模板目录存在性校验（fail-fast）──
+
+validate_templates_dir() {
+  if [ ! -d "$TEMPLATES_DIR" ]; then
+    echo "[ADD preload] 模板目录不存在: $TEMPLATES_DIR（生成态物化缺失，请执行 add-coder sync 后重试）" >&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（缺失清单: ${PRIORITY_ORDER[*]}）" >&2
+    exit 1
+  fi
+}
+
 # ── --index 模式：输出模板清单 ──
 
 output_index() {
@@ -165,6 +187,9 @@ main() {
     esac
   done
 
+  # 入口校验：目录缺失/标准模板缺失 → fail-fast（不再静默空输出）
+  validate_templates_dir
+
   case "$mode" in
     index)
       output_index

package/templates/adapters/vscode/hooks/lib/state-detect.sh

@@ -1,117 +1,13 @@
 #!/bin/bash
-# state-detect.sh — ADD 活跃流程检测 + dev action 追踪
-# 共享库
+# state-detect.sh — 兼容入口；状态裁决统一委托 common.sh，禁止维护第二套 magicDir 探测。
+# 协议层契约（Review P1 #5）: 仅当前 magicDir scope；禁止跨端扫描与 .add fallback；
+# 禁止 adapter 名称默认值（入口注入 MAGIC_DIR 或物理位置推导）。
 
+# 宿主注入链（Claude/Qoder 私有协议：项目根由 IDE 注入；VS Code 经 Claude Agent Host 运行）
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}}"
 
-# 动态探测 MAGIC_DIR（兼容多 adapter，source 自 hook 脚本时继承调用者的 HOOK_DIR）
-if [ -z "${MAGIC_DIR:-}" ]; then
-  if [ -n "${HOOK_DIR:-}" ]; then
-    MAGIC_DIR="$(basename "$(dirname "$HOOK_DIR")")"
-  else
-    for m in ".claude" ".qoder" ".vscode" ".add"; do
-      [ -d "$PROJECT_DIR/$m" ] && { MAGIC_DIR="$m"; break; }
-    done
-    MAGIC_DIR="${MAGIC_DIR:-.add}"
-  fi
+if ! type detect_active_add >/dev/null 2>&1; then
+  HOOK_LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  # shellcheck source=common.sh
+  source "$HOOK_LIB_DIR/common.sh"
 fi
-
-MAGIC_PATH="$PROJECT_DIR/$MAGIC_DIR"
-PLANS_DIR="$MAGIC_PATH/plans"
-
-# dev action 标记文件（项目级，PreToolUse 写入，Stop 读取）
-DEV_FLAG="/tmp/add_dev_$(echo "$PROJECT_DIR" | md5sum 2>/dev/null | cut -c1-8 || echo "default")"
-
-# 检测活跃 ADD 流程
-# 返回: "plan_keyword::step_x/total::round_n/total_r::handoff_path::add_route_path" 或 ""
-detect_active_add() {
-  local handoff=""
-  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)
-  [ -z "$handoff" ] && return 1
-
-  local plan_kw=$(basename "$handoff" | sed 's/-handoff.*//')
-
-  # add-route
-  local add_route=$(find "$PLANS_DIR" -name "*add-route*.md" -type f 2>/dev/null | head -1)
-
-  # Step 统计（从 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}"
-  fi
-
-  # 轮次统计（从 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"
-  fi
-
-  echo "${plan_kw}::${step_info}::${round_info}::${handoff}::${add_route:-none}"
-}
-
-# 标记 dev action
-mark_dev_action() {
-  touch "$DEV_FLAG" 2>/dev/null || true
-}
-
-# 检测 dev action
-has_dev_action() {
-  [ -f "$DEV_FLAG" ]
-}
-
-# 清理 dev action 标记（验收闭环后调用）
-clear_dev_action() {
-  rm -f "$DEV_FLAG" 2>/dev/null || true
-}
-
-# 检查验收完整度，返回 issues 文本
-check_add_completeness() {
-  local handoff="$1" add_route="$2"
-  local issues=""
-
-  # devlog（内容已回流至 handoff，检查 handoff 是否含验收结果）
-  if [ -f "$handoff" ] && ! grep -qE '验收|收敛|闭环|本轮改了什么|devlog' "$handoff" 2>/dev/null; then
-    issues="${issues}  [ ] devlog 缺失（handoff 无验收记录）\n"
-  fi
-
-  # handoff 验证标准
-  if [ -f "$handoff" ]; then
-    local uc=$(grep -c '\[ \]' "$handoff" 2>/dev/null || echo "0")
-    [ "$uc" -gt 0 ] && issues="${issues}  [ ] handoff ${uc} 项未勾选\n"
-  fi
-
-  # add-route Step
-  if [ -f "$add_route" ]; then
-    local uc=$(grep -c '\[ \]' "$add_route" 2>/dev/null || echo "0")
-    [ "$uc" -gt 0 ] && issues="${issues}  [ ] add-route ${uc} Step 未闭环\n"
-  fi
-
-  echo -e "$issues"
-}
-
-# 检查是否已验收（幂等保护）
-# 返回 0 = 未验收，1 = 已验收
-is_already_accepted() {
-  local add_route="$1" handoff="$2"
-  # add-route Step 8 是否已 [x]
-  if [ -f "$add_route" ]; then
-    # 检查 Step 8 产出项是否勾选
-    if grep -A 10 'Step 8' "$add_route" 2>/dev/null | grep -q '\[x\].*验证并更新项目状态'; then
-      # handoff 是否有验收记录
-      if [ -f "$handoff" ] && grep -qE '✅.*验收|收敛|全部闭环|全部.*完成' "$handoff" 2>/dev/null; then
-        return 0
-      fi
-    fi
-  fi
-  return 1
-}

package/templates/adapters/vscode/hooks/lib/vocabulary.sh

@@ -1,15 +1,21 @@
 #!/bin/bash
 # vocabulary.sh — 从 vocabulary markdown 表格加载触发词
-# 单一数据源: .qoder/vocabulary/add-governance-vocabulary.md §类别 A-F 表格
+# 单一数据源: {MAGIC_DIR}/vocabulary/add-governance-vocabulary.md §类别 A-F 表格
+# 协议层契约（Review P1 #5）: 仅当前 magicDir scope；入口注入 MAGIC_DIR 或物理位置推导；
+# 禁止跨端扫描与 .add fallback，禁止 adapter 名称默认值。
 
-# 动态探测 MAGIC_DIR
+# MAGIC_DIR 解析: 入口注入优先；未注入时从脚本物理位置（<magicDir>/hooks/lib/）反推
 if [ -z "${MAGIC_DIR:-}" ]; then
-  for m in ".claude" ".qoder" ".vscode" ".add"; do
-    [ -d "${PROJECT_DIR:-$PWD}/$m" ] && { MAGIC_DIR="$m"; break; }
-  done
-  MAGIC_DIR="${MAGIC_DIR:-.add}"
+  if [ -n "${HOOK_DIR:-}" ]; then
+    MAGIC_DIR="$(basename "$(dirname "$HOOK_DIR")")"
+  else
+    # 无注入且无物理位置 → 无法判定 → 返回空（调用方 fail-closed，禁止猜测 adapter）
+    VOCABULARY_FILE=""
+  fi
+fi
+if [ -n "${MAGIC_DIR:-}" ]; then
+  VOCABULARY_FILE="${PROJECT_DIR:-$PWD}/$MAGIC_DIR/vocabulary/add-governance-vocabulary.md"
 fi
-VOCABULARY_FILE="${PROJECT_DIR:-$PWD}/$MAGIC_DIR/vocabulary/add-governance-vocabulary.md"
 
 # 输出格式: 优先级::触发词正则::响应文本（:: 避免与触发词内的 | 冲突）
 load_triggers() {

package/templates/adapters/vscode/hooks/notification.sh

@@ -22,12 +22,10 @@ state=$(detect_active_add 2>/dev/null || true)
 
 IFS='::' read -r plan _ _ _ _ <<< "$state"
 
-# 动态探测
+# 当前 magicDir 解析（入口注入优先；未注入时物理位置反推）
 if [ -z "${MAGIC_DIR:-}" ]; then
-  for m in ".claude" ".qoder" ".vscode" ".add"; do
-    [ -d "${PROJECT_DIR:-$PWD}/$m" ] && { MAGIC_DIR="$m"; break; }
-  done
-  MAGIC_DIR="${MAGIC_DIR:-.add}"
+  HOOK_DIR_ABS="$(cd "$(dirname "$0")" && pwd)"
+  MAGIC_DIR="$(basename "$(dirname "$HOOK_DIR_ABS")")"
 fi
 reviews_dir="${PROJECT_DIR}/$MAGIC_DIR/reviews"
 if ls "$reviews_dir"/*.md >/dev/null 2>&1; then

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

@@ -77,7 +77,7 @@ cat <<EOF
 EOF
 
 # ─── Hook 治理日报（注入 AI 上下文）───
-HOOK_JSONL="${MAGIC_DIR:-.qoder}/reports/hook-events.jsonl"
+HOOK_JSONL="${MAGIC_DIR}/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/vscode/hooks/stop-check.sh

@@ -9,10 +9,12 @@
 ### 
 # stop-check.sh — VS Code Copilot Stop：四象限分流 + 验收检查
 # 治理卡位 #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"
 
@@ -21,6 +23,13 @@ export 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/core/docs/ADD-governance-claude-code.md

@@ -1,7 +1,7 @@
 # ADD 范式在 Claude Code 上的确定性运行
 
 > **定位**：描述 ADD 范式如何通过 Claude Code 的 Hook 机制在 agent 生命周期中确定性运行。面向 add-coder 用户和贡献者，说明每个 hook 事件的治理职能和注入通道。
-> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../.qoder/plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md) | [issue-6-report](../.qoder/reports/issue-6-tool-call-throttling-report.md)
+> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md) | [issue-6-report](../reports/issue-6-tool-call-throttling-report.md)
 > **Hook 参考**: https://code.claude.com/docs/zh-CN/hooks
 
 ---

package/templates/core/docs/ADD-governance-codex.md

@@ -1,7 +1,7 @@
 # ADD 范式在 Codex 上的确定性运行
 
 > **定位**：描述 ADD 范式如何通过 Codex 的 Hook 机制在 agent 生命周期中确定性运行。
-> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../.qoder/plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
+> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
 > **Hook 参考**: https://www.runoob.com/codex/codex-hooks.html | Codex 设置 → 导入其他 agent 配置
 
 ---

package/templates/core/docs/ADD-governance-qoder-cn.md

@@ -1,7 +1,7 @@
 # ADD 范式在 Qoder CN 上的确定性运行
 
 > **定位**：描述 ADD 范式如何通过 Qoder CN 的 Hook 机制在 agent 生命周期中确定性运行。
-> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../.qoder/plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
+> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
 > **Hook 参考**: https://help.aliyun.com/zh/lingma/qoder-cn-update-log
 
 ---

package/templates/core/docs/ADD-governance-trae.md

@@ -1,7 +1,7 @@
 # ADD 范式在 Trae 上的确定性运行
 
 > **定位**：描述 ADD 范式如何通过 Trae 的 Hook 机制在 agent 生命周期中确定性运行。
-> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../.qoder/plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
+> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
 > **Hook 参考**: https://docs.trae.cn/ide_automate-actions-with-hooks | https://docs.trae.cn/ide_hook-configuration-reference
 
 ---

package/templates/core/docs/ADD-governance-vscode-copilot.md

@@ -1,7 +1,7 @@
 # ADD 范式在 VS Code Copilot 上的确定性运行
 
 > **定位**：描述 ADD 范式如何通过 VS Code Copilot 的 Agent Hook 机制在 agent 生命周期中确定性运行。
-> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../.qoder/plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md) | [issue-6-report](../.qoder/reports/issue-6-tool-call-throttling-report.md)
+> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md) | [issue-6-report](../reports/issue-6-tool-call-throttling-report.md)
 > **Hook 参考**: https://docs.github.com/zh/copilot/concepts/agents/hooks | https://vscode.js.cn/docs/agent-customization/hooks
 > **VS Code 版本要求**: 1.127+（Agent Hook 预览），1.129+（Agent Host 架构，支持 `.claude/settings.json`）