add-coder 0.1.0

package/templates/adapters/claude/hooks/doc-format-guard.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# doc-format-guard.sh — 文档格式守卫（Claude Code 适配）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+input=$(parse_input)
+file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+[ -z "$file_path" ] && exit 0
+
+# 检查 ADD 文档格式
+if echo "$file_path" | grep -qE '\.qoder/(specs|plans|reviews)/.*\.md$'; then
+  echo "[ADD DocFormatGuard] 检测到 ADD 文档变更，请确保格式符合模板规范。"
+fi
+exit 0

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

@@ -0,0 +1,9 @@
+#!/bin/bash
+# Notification — 通知事件处理（Claude Code 适配）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+exit 0

package/templates/adapters/claude/hooks/permission-gate.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# PermissionRequest — 权限请求门禁（Claude Code 适配）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+input=$(parse_input)
+tool_name=$(echo "$input" | jq -r '.tool_name // empty')
+
+# 高风险工具需要二次确认
+case "$tool_name" in
+  Bash|Write|Edit)
+    echo "[ADD PermissionGate] 高风险工具: ${tool_name}，请确认操作。"
+    ;;
+esac
+exit 0

package/templates/adapters/claude/hooks/post-tool-failure.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# PostToolUseFailure — 工具失败后处理（Claude Code 适配）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+echo "[ADD PostToolFailure] 工具调用失败，请检查错误信息并修复。"
+exit 0

package/templates/adapters/claude/hooks/post-tool-use.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# post-tool-use.sh — Claude Code PostToolUse 审计提醒
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+input=$(parse_input)
+file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+[ -z "$file_path" ] && exit 0
+
+if ! echo "$file_path" | grep -qE 'src/agents/|src/lib/agent-audit-logger\.ts|src/types/|prisma/schema\.prisma'; then
+  exit 0
+fi
+
+echo "[ADD PostToolUse] 文件已写入: ${file_path}。如果尚未记录，请执行 record_dev_operation 落库审计。"
+exit 0

package/templates/adapters/claude/hooks/pre-compact.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# PreCompact — 上下文压缩前检查（Claude Code 适配）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+# 检查是否有未完成的 ADD 审计记录
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
+[ -d "$PROJECT_DIR/.qoder/plans" ] || exit 0
+
+echo "[ADD PreCompact] 上下文压缩前，请确认 ADD-7 审计记录已落库。"
+exit 0

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

@@ -0,0 +1,28 @@
+#!/bin/bash
+# pre-tool-use.sh — Claude Code PreToolUse：源码 Plan 关联检查
+# 与 Qoder 版本共享核心逻辑，差异仅在工具名和环境变量
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+input=$(parse_input)
+file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+[ -z "$file_path" ] && exit 0
+
+if ! echo "$file_path" | grep -qE '(src/|/src/).*\.(ts|tsx)$'; then
+  exit 0
+fi
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
+MOD=$(basename "$file_path" | sed 's/\.[jt]sx\?$//')
+
+MATCHES=$(grep -rl "$MOD" "$PROJECT_DIR/.qoder/plans" "$PROJECT_DIR/.qoder/specs" "$PROJECT_DIR/.qoder/reports" 2>/dev/null | wc -l)
+
+if [ "$MATCHES" -gt 0 ]; then
+  exit 0
+fi
+
+echo "⛔ 阻断: ${file_path} 无相关 ADD Plan。请先创建 Plan。" >&2
+exit $EXIT_BLOCK

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

@@ -0,0 +1,16 @@
+#!/bin/bash
+# UserPromptSubmit — 用户输入提交前检查（ADD 关键词兜底）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+input=$(parse_input)
+prompt=$(echo "$input" | jq -r '.prompt // empty')
+
+# 检测 ADD 关键词触发
+if echo "$prompt" | grep -qiE '开发|改功能|修.?bug|加需求|新增|重构|实施|验收|继续'; then
+  echo "[ADD PromptSubmit] 检测到开发关键词，请确认已加载 ADD 工作流上下文。"
+fi
+exit 0

package/templates/adapters/claude/hooks/review-checklist.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# review-checklist.sh — Review 检查清单校验（Claude Code 适配）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+echo "[ADD ReviewChecklist] 请在提交前确认 checklist.md 全部项已勾选。"
+exit 0

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

@@ -0,0 +1,23 @@
+#!/bin/bash
+# SessionStart — ADD 上下文恢复（Claude Code 适配）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+# 尝试加载 Qoder 的 state-detect 和 context-inject 库
+QODER_LIB="$HOOK_DIR/../../qoder/hooks/lib"
+[ -f "$QODER_LIB/state-detect.sh" ] && source "$QODER_LIB/state-detect.sh"
+[ -f "$QODER_LIB/context-inject.sh" ] && source "$QODER_LIB/context-inject.sh"
+
+export QODER_PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
+
+state=$(detect_active_add 2>/dev/null || true)
+if [ -z "$state" ]; then
+  exit 0
+fi
+
+IFS='::' read -r plan step rounds handoff <<< "$state"
+build_session_start_json "$plan" "$step" "$rounds" "$handoff"
+exit 0

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

@@ -0,0 +1,10 @@
+#!/bin/bash
+# Stop — 停止前合规检查（Claude Code 适配）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+echo "[ADD Stop] 会话结束前，请确认所有 checklist 项已勾选、ADD-7 审计已落库。"
+exit 0

package/templates/adapters/claude/hooks/subagent-guard.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# SubagentStart/SubagentStop — 子代理门禁（Claude Code 适配）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+input=$(parse_input)
+event=$(echo "$input" | jq -r '.hook_event_name // empty')
+
+if [ "$event" = "SubagentStart" ]; then
+  echo "[ADD SubagentGuard] 子代理启动，请确认其遵循 ADD 规范。"
+fi
+exit 0

package/templates/adapters/claude/mcp.json

@@ -0,0 +1,13 @@
+{
+    "mcpServers": {
+        "add-dev-tools": {
+            "command": "{{mcpServerCommand}}",
+            "args": [
+                "{{projectRoot}}/.claude/scripts/mcp-server.ts"
+            ],
+            "env": {
+                "NODE_ENV": "development"
+            }
+        }
+    }
+}

package/templates/adapters/claude/settings.json

@@ -0,0 +1,125 @@
+{
+    "hooks": {
+        "SessionStart": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/session-start.sh"
+                    }
+                ]
+            }
+        ],
+        "UserPromptSubmit": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/prompt-submit.sh"
+                    }
+                ]
+            }
+        ],
+        "PreToolUse": [
+            {
+                "matcher": "Write|Edit|Bash",
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/pre-tool-use.sh"
+                    },
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/doc-format-guard.sh"
+                    }
+                ]
+            }
+        ],
+        "PostToolUse": [
+            {
+                "matcher": "Write|Edit|Bash",
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/post-tool-use.sh"
+                    },
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/doc-format-guard.sh"
+                    }
+                ]
+            }
+        ],
+        "PostToolUseFailure": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/post-tool-failure.sh"
+                    }
+                ]
+            }
+        ],
+        "Stop": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/stop-check.sh"
+                    }
+                ]
+            }
+        ],
+        "SubagentStart": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/subagent-guard.sh"
+                    }
+                ]
+            }
+        ],
+        "SubagentStop": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/subagent-guard.sh"
+                    }
+                ]
+            }
+        ],
+        "PreCompact": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/pre-compact.sh"
+                    }
+                ]
+            }
+        ],
+        "Notification": [
+            {
+                "matcher": "result",
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/notification.sh"
+                    }
+                ]
+            }
+        ],
+        "PermissionRequest": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/permission-gate.sh"
+                    }
+                ]
+            }
+        ]
+    }
+}

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

@@ -0,0 +1,164 @@
+#!/bin/bash
+# doc-format-guard.sh — schema.json 驱动的 ADD 文档格式守卫
+set -euo pipefail
+
+input=$(cat)
+
+# DEBUG: dump stdin for investigation
+mkdir -p .qoder/debug-dump
+echo "=== $(date) ===" >> .qoder/debug-dump/stdin.log
+echo "file_path: $(echo "$input" | jq -r '.tool_input.file_path // "EMPTY"')" >> .qoder/debug-dump/stdin.log
+echo "has_file_content: $(echo "$input" | jq 'has("tool_input") and (.tool_input | has("file_content"))')" >> .qoder/debug-dump/stdin.log
+echo "has_replacements: $(echo "$input" | jq 'has("tool_input") and (.tool_input | has("replacements"))')" >> .qoder/debug-dump/stdin.log
+echo "top_keys: $(echo "$input" | jq -r 'keys | join(", ")')" >> .qoder/debug-dump/stdin.log
+echo "tool_input_keys: $(echo "$input" | jq -r '.tool_input | keys | join(", ") // "NO_TOOL_INPUT"')" >> .qoder/debug-dump/stdin.log
+echo "=== DONE ===" >> .qoder/debug-dump/stdin.log
+file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+# L17: 非文件工具事件（空 stdin）→ 不拦截（由 matcher 层过滤）
+[ -z "$file_path" ] && exit 0
+
+if ! echo "$file_path" | grep -qE '\.qoder/(plans|specs)/'; then
+  exit 0
+fi
+
+CONTENT=$(echo "$input" | jq -r '
+  if .tool_input.file_content then .tool_input.file_content
+  elif .tool_input.content then .tool_input.content
+  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 → 无法校验，阻断
+if [ -z "$CONTENT" ]; then
+  echo "⛔ 拒绝：Write 工具未传 file_content，无法校验手写文档格式" >&2
+  echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"ask","permissionDecisionReason":"Write 工具未传 file_content，无法校验手写文档。请用 SearchReplace 改写已有文件，或用 Write 工具重试。"}}'
+  exit 2
+fi
+
+PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
+TEMPLATES_DIR="$PROJECT_DIR/.qoder/templates"
+
+# 通过 filename 匹配模板名
+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
+
+# 退一步：根据文件内容特征猜测模板类型
+if [ -z "$TEMPLATE_NAME" ]; then
+  if echo "$CONTENT" | grep -q "## 四、Handoff"; then
+    TEMPLATE_NAME="simple-standard-plan-template.md"
+  elif echo "$CONTENT" | grep -q "## PLAN 元信息"; then
+    TEMPLATE_NAME="standard-plan-template.md"
+  elif echo "$CONTENT" | grep -q "## Review 元信息"; then
+    if echo "$CONTENT" | grep -q "运行时验证"; then
+      TEMPLATE_NAME="review-runtime-template.md"
+    elif echo "$CONTENT" | grep -q "跨仓库格式契约"; then
+      TEMPLATE_NAME="review-implementation-template.md"
+    else
+      TEMPLATE_NAME="review-template.md"
+    fi
+  elif echo "$CONTENT" | grep -q "## Why"; then
+    TEMPLATE_NAME="spec-template.md"
+  elif echo "$CONTENT" | grep -q "## Preconditions"; then
+    TEMPLATE_NAME="tasks-template.md"
+  elif echo "$CONTENT" | grep -q "审计链（证据→devlog→checklist）"; then
+    TEMPLATE_NAME="checklist-template.md"
+  else
+    case "$file_path" in
+      *handoff*)
+        # ★ 按内容特征区分单/多轮 handoff，不依赖文件名
+        if echo "$CONTENT" | grep -qF "## 全局元信息"; then
+          TEMPLATE_NAME="handoff-multi-round-template.md"
+        elif echo "$CONTENT" | grep -qF "## 1. 交接前状态"; then
+          TEMPLATE_NAME="handoff-single-round-template.md"
+        else
+          echo "⛔ handoff 文件内容无法识别模板类型（缺 '## 全局元信息' 或 '## 1. 交接前状态'），拒绝写入" >&2
+          echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"ask","permissionDecisionReason":"handoff 内容不符合 single/multi 模板规范"}}'
+          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" ;;
+      *report*runtime*)  TEMPLATE_NAME="runtime-report-template.md" ;;
+      *report*)          TEMPLATE_NAME="report-template.md" ;;
+      *fix-verif*)       TEMPLATE_NAME="fix-verification-template.md" ;;
+      *) 
+        echo "⛔ 拒绝：无法识别文档类型 (file_path: $file_path)，缺少模板匹配规则" >&2
+        echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"ask","permissionDecisionReason":"无法识别 ADD 文档类型，请联系管理员更新 doc-format-guard.sh"}}'
+        exit 2
+        ;;
+    esac
+  fi
+fi
+
+SCHEMA_FILE="$TEMPLATES_DIR/${TEMPLATE_NAME%.md}.schema.json"
+# L84: schema 文件不存在 → 无校验规则，阻断（不允许无规则放行）
+if [ ! -f "$SCHEMA_FILE" ]; then
+  echo "⛔ 阻断：模板 ${TEMPLATE_NAME} 缺少对应的 .schema.json 校验规则" >&2
+  echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"ask","permissionDecisionReason":"缺少 .schema.json 校验规则文件，禁止无规则放行"}}'
+  exit 2
+fi
+
+# SearchReplace 只传 patch（replacements[].new_text），不传全文件 → 跳过章节校验
+IS_SEARCH_REPLACE=$(echo "$input" | jq -r '.tool_input.replacements | length > 0 // false')
+
+ISSUES=""
+
+# ── 章节校验 ──
+# 使用项目目录下的临时文件，避免 /tmp 在沙箱中不可写导致静默跳过
+TMPFILE="$PROJECT_DIR/.qoder/.doc-guard-issues.tmp"
+: > "$TMPFILE"
+trap "rm -f $TMPFILE" EXIT
+# 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
+      echo "  缺章节: $heading"
+    fi
+  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
+      echo "  缺子章节: $sub"
+    fi
+  done >> "$TMPFILE"
+fi
+
+# ── 占位符校验 ──
+jq -r '.placeholders[]?' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r ph; do
+  if echo "$CONTENT" | grep -qF "$ph"; then
+    echo "  未替换占位符: $ph"
+  fi
+done >> "$TMPFILE"
+
+# ── 禁止词校验 ──
+jq -r '.forbidden_terms[]?' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r term; do
+  if echo "$CONTENT" | grep -qw "$term"; then
+    echo "  禁止词: $term"
+  fi
+done >> "$TMPFILE"
+
+ISSUES=$(cat "$TMPFILE" 2>/dev/null)
+
+# ── 阻断或放行 ──
+if [ -n "$ISSUES" ]; then
+  echo "⛔ $TEMPLATE_NAME 校验不通过:
+$ISSUES" >&2
+  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"文档格式校验不通过，请对照模板修正\"}}"
+  exit 2
+fi
+
+# ── 自动更新 index.md ──
+if echo "$file_path" | grep -q '\.qoder/plans/'; then
+  if [ -x "$PROJECT_DIR/scripts/gen-plan-index.sh" ]; then
+    "$PROJECT_DIR/scripts/gen-plan-index.sh" 2>/dev/null || true
+  fi
+fi
+
+exit 0

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

@@ -0,0 +1,96 @@
+#!/bin/bash
+# context-inject.sh — 上下文注入模板
+# 共享库
+
+# 结构化 SessionStart JSON 注入
+build_session_start_json() {
+  local plan="$1" step="$2" round="$3" handoff="$4"
+  cat <<EOF
+{
+  "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}"
+  }
+}
+EOF
+}
+
+# Stop 四象限分流 few-shot 上下文
+build_stop_context() {
+  local quadrant="$1" info="$2"
+  case "$quadrant" in
+    "no_add_no_dev")
+      echo "[ADD Stop] 无活跃 Plan，无代码改动。正常结束。"
+      ;;
+    "no_add_has_dev")
+      cat <<'EOF'
+[ADD Stop] ⚠️ 检测到代码修改但无活跃 ADD Plan。
+
+Plan 不是"文档开销"——它是代码治理的基础设斻。跳过 Plan 的后果:
+  · 没有 add-route → 每次改动无法追溯到具体 Task
+  · 没有 tasks.md → 后续 AI Session 不知道改了哪些文件
+  · 没有 handoff → 交接时上下文全丢，只能靠 git log 猜
+
+你必须立即补救，二选一:
+
+方案 A — 补 ADD 流程（招安）:
+  Step 0: 读 .qoder/templates/plan-template.md → 生成 Plan → .qoder/plans/{today}/{keyword}-plan-v1.md
+          生成 add-route → check_dps ≥ 85
+  Step 1: 扩展 AgentAuditPhase（如需要）
+  Step 2: 确认 agentAudit() 通道
+  Step 3: 将已写代码关联到 tasks.md
+  完成后可正常停止。
+
+方案 B — 补不上则回滚:
+  如果改动太复杂无法追溯生成 Plan，则:
+  ① git diff 确认改动范围
+  ② git checkout -- <改动的文件> 撤回
+  ③ 告知用户 "以下改动已回滚，请先走 ADD 流程再重新实施: <文件列表>"
+
+无论选 A 还是 B，完成后告诉用户下次执行 session-init 恢复上下文。
+EOF
+      ;;
+    "has_add_no_dev")
+      echo "[ADD Stop] ADD 流程进行中 (${info})，本次无代码改动。下次继续时执行 session-init 恢复上下文。"
+      ;;
+    "has_add_dev_step02")
+      echo "[ADD Stop] ADD Step 0-2: 文档先行/审计准备阶段。无需验收闭环。下一步: 进入 Step 3 代码实现。"
+      ;;
+    "has_add_dev_step3")
+      echo "[ADD Stop] ADD Step 3: 代码实现进行中 (${info})。完成后进入 Step 3.5 实现审查。"
+      ;;
+    "has_add_dev_unclosed")
+      cat <<'EOF'
+[ADD Stop] ⚠️ 代码已完成但验收未闭环:
+${info}
+
+请依次执行（不要等下次会话）:
+  ① Write devlog → handoff 同目录 devlog-{plan}-v{n}.md
+     格式: # Devlog: {plan}\n 日期 / Plan / 轮次 / 本轮改了什么 / 验收结果 / 遗留项 / 架构回看
+  ② Edit handoff → 更新 §验证标准 全部 [x] + 补充审计 ID
+     ★ 同步: checklist 有新 cuid → handoff ADD-7 表必须对应新增行
+     ★ Step 0 准入: handoff + add-route + Specs 三元组缺一不可，缺则回退 Step 0.5
+  ③ Read docs/ → 回看架构文档确认一致性
+  ④ Edit add-route → 勾选对应 Step [x]
+
+以上全部完成后 Agent 才能停止。
+
+下次恢复: 读 handoff → 查同目录 devlog-*.md → query_audit_logs
+EOF
+      ;;
+        "has_add_dev_closed")
+      echo "[ADD Stop] ✅ 验收闭环: add-route全部[x], devlog已记录, handoff已更新。验收幂等——重复触发不覆盖已有结论。"
+      ;;
+  esac
+}
+
+# 写操作前置守卫上下文
+build_pretool_context() {
+  local plan="$1" round="$2"
+  cat <<EOF
+[ADD PreToolUse] 当前 Plan: ${plan}，轮次: ${round}。
+本次写入应属于 ADD Step 3 代码实现阶段。
+完成后执行 record_dev_operation 记录审计。
+EOF
+}