add-coder 0.3.27 → 0.3.28

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

@@ -1,157 +0,0 @@
-#!/bin/bash
-# review-checklist.sh — 验收 Review 模式：检查 checklist 质量
-# 被 prompt-submit.sh 的"验收"幂等检查后调用
-# 
-# 输入: handoff_path add_route_path
-# 输出: checklist 质量问题清单
-
-handoff="$1"
-add_route="$2"
-[ -z "$handoff" ] && exit 0
-
-# 从 handoff 关联找到 spec 目录
-plan_dir=$(dirname "$handoff")
-plan_kw=$(basename "$handoff" | sed 's/-handoff.*//')
-
-# 找 checklist
-spec_dir=".qoder/specs/${plan_kw}"
-checklist=""
-[ -d "$spec_dir" ] && checklist="$spec_dir/checklist.md"
-# fallback: 搜索
-[ ! -f "$checklist" ] && checklist=$(find .qoder/specs -name "checklist.md" -path "*${plan_kw}*" 2>/dev/null | head -1)
-
-tasks_file=""
-[ -d "$spec_dir" ] && tasks_file="$spec_dir/tasks.md"
-[ ! -f "$tasks_file" ] && tasks_file=$(find .qoder/specs -name "tasks.md" -path "*${plan_kw}*" 2>/dev/null | head -1)
-
-issues=""
-
-# ══════════════════════════════════════════════════════════════════════
-# 0. Step 0 准入: ADD 核心文档存在性（BLOCKING）
-# ══════════════════════════════════════════════════════════════════════
-_missing_docs=""
-if [ ! -f "$handoff" ]; then
-  _missing_docs="${_missing_docs} Handoff"
-else
-  # 章节完整性: 至少要有 spec 文件/你要改的文件/验证标准/完成后记录 四个关键小节
-  _h_sections=0
-  grep -q "spec 文件" "$handoff" 2>/dev/null && _h_sections=$((_h_sections + 1))
-  grep -q "你要改的文件" "$handoff" 2>/dev/null && _h_sections=$((_h_sections + 1))
-  grep -q "验证标准" "$handoff" 2>/dev/null && _h_sections=$((_h_sections + 1))
-  grep -q "完成后记录 ADD-7 审计" "$handoff" 2>/dev/null && _h_sections=$((_h_sections + 1))
-  if [ "$_h_sections" -lt 4 ]; then
-    _missing_docs="${_missing_docs} Handoff(缺章节:${_h_sections}/4)"
-  fi
-fi
-if [ ! -f "$add_route" ]; then
-  _missing_docs="${_missing_docs} add-route"
-else
-  # add-route 至少要有 Task 映射表 + 文件清单
-  if ! grep -q "Task 映射表" "$add_route" 2>/dev/null && ! grep -q "文件清单" "$add_route" 2>/dev/null; then
-    _missing_docs="${_missing_docs} add-route(缺Task映射/文件清单)"
-  fi
-fi
-if [ ! -f "$checklist" ]; then
-  _missing_docs="${_missing_docs} checklist"
-else
-  # checklist 至少要有 [T] 项
-  if ! grep -q '\[T\]' "$checklist" 2>/dev/null; then
-    _missing_docs="${_missing_docs} checklist(无[T]项)"
-  fi
-fi
-if [ ! -f "$tasks_file" ]; then
-  _missing_docs="${_missing_docs} tasks"
-else
-  # tasks 至少要有 Task 列表 + 验证
-  if ! grep -q 'Task\|\- \[ \]' "$tasks_file" 2>/dev/null; then
-    _missing_docs="${_missing_docs} tasks(无Task项)"
-  fi
-fi
-if [ -n "$_missing_docs" ]; then
-  echo "  ❌ Step 0 未完成:$(echo $_missing_docs | sed 's/ /, /g') 文件缺失。回退 Step 0.5/Step 1 补建后再进入代码实现。"
-  exit 1
-fi
-
-# 1. checklist [x] 数 vs tasks.md [x] 数 是否一致
-if [ -f "$checklist" ] && [ -f "$tasks_file" ]; then
-  cl_ck=$(grep -c '\[x\]' "$checklist" 2>/dev/null || true); cl_ck=${cl_ck:-0}
-  cl_open=$(grep -c '\[ \]' "$checklist" 2>/dev/null || true); cl_open=${cl_open:-0}
-  tk_ck=$(grep -c '\[x\]' "$tasks_file" 2>/dev/null || echo "0")
-
-  if [ "$cl_open" -gt 0 ]; then
-    issues="${issues}  ⚠️ checklist 有 ${cl_open} 项未勾选\n"
-  fi
-
-  # 2. [T] 项是否都有 [x]（编译期验证项）
-  t_items=$(grep -c '\[T\]' "$checklist" 2>/dev/null || true); t_items=${t_items:-0}
-  t_checked=$(grep '\[T\]' "$checklist" 2>/dev/null | grep -c '\[x\]' || true); t_checked=${t_checked:-0}
-  if [ "$t_items" -gt "$t_checked" ]; then
-    issues="${issues}  ⚠️ [T] 编译期验证: ${t_checked}/${t_items} 通过\n"
-  fi
-
-  # 3. 证据缺失检测：[x] 但缺 — 证据: 标记
-  _no_evidence=0
-  while IFS= read -r line; do
-    [ -z "$line" ] && continue
-    # 有证据: — 证据: 字段 + 具体内容（tsc/vitest/grep/审计ID 等）
-    if echo "$line" | grep -qE '—\s*证据:\s*\S' 2>/dev/null; then
-      continue
-    fi
-    # 有验证结果描述也行
-    if echo "$line" | grep -qE 'npx|tsc|vitest|grep|✅|cmq[0-9a-z]{10}|18/18|exit.*0' 2>/dev/null; then
-      continue
-    fi
-    _no_evidence=$((_no_evidence + 1))
-  done < <(grep '\[x\]' "$checklist" 2>/dev/null)
-
-  if [ "$_no_evidence" -gt 0 ]; then
-    issues="${issues}  ❌ ${_no_evidence} 项 [x] 缺少验收证据（需附 — 证据: tsc/vitest/grep/审计ID 等）\n"
-  fi
-
-  # 4. 审计链：[x] 项引用 audit ID 的比例
-  #    初验: 有证据即可，审计ID是证据产出物
-  #    复验: 有审计ID + 证据仍有效 → 不重复落库；证据失效 → 追写新审计
-  _with_audit=$(grep '\[x\]' "$checklist" 2>/dev/null | grep -cE 'cmq[a-z0-9]{10,}' || true); _with_audit=${_with_audit:-0}
-  _fake_audit=$(grep '\[x\]' "$checklist" 2>/dev/null | grep -cE 'cmq\.\.\.|cmqxxx|审计.*cmq\.\.' || true); _fake_audit=${_fake_audit:-0}
-  if [ "$_fake_audit" -gt 0 ]; then
-    issues="${issues}  ❌ ${_fake_audit} 项 [x] 使用了占位符审计ID（cmq.../cmqxxx），必须调 record_dev_operation 获取真实 cuid 后替换\n"
-  fi
-  _with_evidence=$(grep '\[x\]' "$checklist" 2>/dev/null | grep -cE 'tsc|vitest|npx|grep|✅|验证|确认|compgen|审计.*cmq[a-z0-9]{10}' || true); _with_evidence=${_with_evidence:-0}
-  if [ "$_with_evidence" -gt 0 ] && [ "$_with_audit" -eq 0 ]; then
-    issues="${issues}  📎 初验: ${_with_evidence}/${cl_ck} 项有证据但未写审计 ID（需调 record_dev_operation 落库）\n"
-  elif [ "$_with_audit" -gt 0 ] && [ "$_with_audit" -lt "$cl_ck" ]; then
-    issues="${issues}  📎 复验: ${_with_audit}/${cl_ck} 项引用审计 ID。${_with_evidence}/${cl_ck} 项有证据。证据一致则不需追写 devlog日志(走mcp)\n"
-  fi
-fi
-
-# 5. add-route Step 闭环
-if [ -f "$add_route" ]; then
-  ar_ck=$(grep -c '\[x\]' "$add_route" 2>/dev/null || true); ar_ck=${ar_ck:-0}
-  ar_open=$(grep -c '\[ \]' "$add_route" 2>/dev/null || true); ar_open=${ar_open:-0}
-  if [ "$ar_open" -gt 0 ]; then
-    issues="${issues}  ⚠️ add-route ${ar_open} Step 未闭环\n"
-  fi
-fi
-
-# 6. handoff 审计表同步：checklist 中的 cuid 是否在 handoff 中有记录
-if [ -f "$handoff" ] && [ -f "$checklist" ]; then
-  _new_cuids=""
-  while IFS= read -r cuid; do
-    [ -z "$cuid" ] && continue
-    if ! grep -q "$cuid" "$handoff" 2>/dev/null; then
-      [ -n "$_new_cuids" ] && _new_cuids="${_new_cuids}, "
-      _new_cuids="${_new_cuids}${cuid}"
-    fi
-  done < <(grep -oE 'cmq[a-z0-9]{10,}' "$checklist" 2>/dev/null | sort -u)
-  if [ -n "$_new_cuids" ]; then
-    _new_count=$(echo "$_new_cuids" | tr ',' '\n' | wc -l)
-    issues="${issues}  ❌ handoff 审计表未同步: ${_new_count} 个 cuid 在 checklist 中存在但 handoff 中缺失（需更新 handoff ADD-7 表 + query_audit_logs 命令）\n"
-  fi
-fi
-
-if [ -z "$issues" ]; then
-  echo "  ✅ Review: checklist 质量检查通过"
-else
-  echo "  📋 Review 发现问题:"
-  echo -e "$issues"
-fi

package/templates/adapters/qoder/hooks/session-end.sh

@@ -1,24 +0,0 @@
-#!/bin/bash
-# SessionEnd — Qoder CN 专用（独立实现，stdout JSON additionalContext 注入）
-# 治理卡位 #2: 标记清理 + 会话审计结算 + Stop未触发兜底
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
-export PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
-source "$HOOK_DIR/lib/common.sh" 2>/dev/null || true
-
-# ── ① 清理标记文件 ──
-project_hash=$(echo "${PROJECT_DIR:-$PWD}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")
-rm -f "/tmp/add_tpl_${project_hash}" 2>/dev/null || true
-rm -f "/tmp/add_dev_${project_hash}" 2>/dev/null || true
-
-# ── ② Stop 未触发兜底 ──
-fallback_msg=""
-if has_dev_action 2>/dev/null; then
-  fallback_msg="⚠️ 检测到 dev action 标记未清除——Stop 可能未触发验收检查"
-fi
-
-# ── ③ stdout JSON additionalContext ──
-echo "{\"hookSpecificOutput\":{\"hookEventName\":\"SessionEnd\",\"additionalContext\":\"[ADD SessionEnd] 会话结束 — $(date -Iseconds)。标记已清理。${fallback_msg}\"}}"
-exit 0

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

@@ -1,45 +0,0 @@
-#!/bin/bash
-# SessionStart — ADD 上下文恢复 + 模板索引注入（Qoder CN 适配，stdout additionalContext 注入）
-# 治理卡位 #1: ADD状态恢复 + 模板索引注入
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
-export PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
-source "$HOOK_DIR/lib/common.sh"
-source "$HOOK_DIR/lib/state-detect.sh" 2>/dev/null || true
-source "$HOOK_DIR/lib/context-inject.sh" 2>/dev/null || true
-
-# ── ① ADD 状态恢复 ──
-state=$(detect_active_add 2>/dev/null || true)
-if [ -n "$state" ]; then
-  IFS='::' read -r plan step rounds handoff add_route <<< "$state"
-  add_ctx="ADD: ${plan} Step${step} Round${rounds}"
-  # §代办刷新：提醒加载 IDE 代办清单
-  add_ctx="${add_ctx}\n[代办] 如有未加载的 IDE 代办清单，请从 tasks.md §IDE JSON 刷新 TodoWrite"
-  cat <<EOJSON
-{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"${add_ctx}"}}
-EOJSON
-fi
-
-# ── ② 模板索引注入 ──
-TPL_SCRIPT="$HOOK_DIR/lib/preload-templates.sh"
-if [ -f "$TPL_SCRIPT" ]; then
-  lines=$(bash "$TPL_SCRIPT" --index 2>/dev/null | wc -l)
-  cat <<EOJSON
-{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"${lines} ADD templates available. Use preload-templates.sh --index for list."}}
-EOJSON
-fi
-
-# ── ③ §HITL 待审批检测 ──
-PLANS_DIR="${PROJECT_DIR}/${MAGIC_DIR}/plans"
-if [ -d "$PLANS_DIR" ]; then
-  hitl_count=$(find "$PLANS_DIR" -name "*.hitl.md" -mtime -7 -type f 2>/dev/null | wc -l)
-  if [ "$hitl_count" -gt 0 ] 2>/dev/null; then
-    cat <<EOJSON
-{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"[HITL 待审批] 检测到 ${hitl_count} 个待审批 HITL 提案，请检查并处理"}}
-EOJSON
-  fi
-fi
-
-exit 0

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

@@ -1,59 +0,0 @@
-#!/bin/bash
-# stop-check.sh — Qoder CN Stop：四象限分流 + 验收检查（保留 few-shot 上下文注入）
-# 治理卡位 #7: 验收检查 + devlog + 阻断
-# DB lifecycle 真相源（协议层）：DB 不可用时 fail-closed，禁止回退 Handoff/add-route 猜测
-# Qoder stdout 规范: stdout 只输出合法 JSON（hookSpecificOutput）；非 JSON 一律走 stderr
-set -euo pipefail
-
-input=$(cat)
-stop_active=$(echo "$input" | jq -r '.stop_hook_active // false' 2>/dev/null || echo "false")
-[ "$stop_active" = "true" ] && exit 0
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
-export MAGIC_DIR=$(basename "$(dirname "$HOOK_DIR")")
-export PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
-source "$HOOK_DIR/lib/common.sh" 2>/dev/null || true
-source "$HOOK_DIR/lib/context-inject.sh" 2>/dev/null || true
-
-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”；stdout 保持 JSON 规范） ═══════
-if [ "${state%%::*}" = "__STATUS_UNAVAILABLE__" ]; then
-  reason=$(echo "$state" | awk -F'::' '{print $2}')
-  echo "[ADD Stop] ⛔ Plan status 暂不可用（${reason}）。未回退 Handoff/add-route 猜测，请恢复数据库或 MCP resolver 后重试。" >&2
-  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"Stop\",\"additionalContext\":\"[ADD Stop] Plan status 暂不可用（${reason}），fail-closed 阻断\"}}"
-  exit "${EXIT_BLOCK:-2}"
-fi
-
-# ═══════ Q1: 无 ADD + 无 dev → 正常停 ═══════
-if [ -z "$state" ] && [ "$has_dev" != "true" ]; then
-  exit 0
-fi
-
-# ═══════ Q2: 无 ADD + 有 dev → 严重违规，few-shot 注入 ═══════
-if [ -z "$state" ] && [ "$has_dev" = "true" ]; then
-  build_stop_context "no_add_has_dev" >&2
-  exit $EXIT_BLOCK
-fi
-
-# 解析 state
-IFS='::' read -r plan step rounds handoff add_route <<< "$state"
-
-# ═══════ Q3: 有 ADD + 无 dev → 注入状态（stdout JSON） ═══════
-if [ "$has_dev" != "true" ]; then
-  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"Stop\",\"additionalContext\":\"[ADD Stop] Plan: ${plan}, 轮次: ${rounds}, Step: ${step}。本次无代码改动，下次继续时执行 session-init 恢复上下文。\"}}"
-  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
-fi
-
-clear_dev_action 2>/dev/null || true
-echo "{\"hookSpecificOutput\":{\"hookEventName\":\"Stop\",\"additionalContext\":\"[ADD Stop] ✅ 验收通过——checklist 全部勾选，devlog 已记录。\"}}"
-exit 0

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

@@ -1,27 +0,0 @@
-#!/bin/bash
-###
- # @Author       : xiaomingming wujixmm@gmail.com
- # @Date         : 2026-07-07 17:44:23
- # @LastEditors  : xiaomingming wujixmm@gmail.com
- # @LastEditTime : 2026-07-17 18:04:31
- # @FilePath     : /add-coder/templates/adapters/qoder/hooks/subagent-guard.sh
- # @Description  : 
-### 
-# SubagentStart — 子代理 ADD 上下文注入（Qoder CN 适配）
-# 治理卡位 #10: ADD上下文注入子agent + 审计初始化
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
-export PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
-source "$HOOK_DIR/lib/common.sh" 2>/dev/null || true
-
-if type detect_active_add >/dev/null 2>&1; then
-  state=$(detect_active_add 2>/dev/null || true)
-  if [ -n "$state" ]; then
-    IFS='::' read -r plan step rounds handoff add_route <<< "$state"
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"SubagentStart\",\"additionalContext\":\"[ADD SubagentStart] Plan: ${plan}, Step: ${step}, Round: ${rounds}, handoff: ${handoff}。遵循 ADD 规范，完成后检查 checklist。\"}}"
-  fi
-fi
-
-exit 0

package/templates/adapters/qoder/hooks/subagent-stop.sh

@@ -1,26 +0,0 @@
-#!/bin/bash
-# SubagentStop — Qoder CN 专用（独立实现，stdout JSON additionalContext 注入）
-# 治理卡位 #11: 子agent边界校验 + 审计聚合 + 阻断
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
-export PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
-source "$HOOK_DIR/lib/common.sh" 2>/dev/null || true
-
-input=$(cat)
-agent_name=$(echo "$input" | jq -r '.agent_type // .subagent_name // "unknown"' 2>/dev/null || echo "unknown")
-
-# ── ① 边界校验 ──
-state=$(detect_active_add 2>/dev/null || true)
-if [ -z "$state" ]; then
-  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"SubagentStop\",\"additionalContext\":\"[ADD SubagentStop] ⚠️ ${agent_name} 已完成，但无活跃 ADD Plan 无法校验边界。\"}}"
-  exit 0
-fi
-
-plan_kw=$(echo "$state" | awk -F'::' '{print $1}')
-handoff=$(echo "$state" | awk -F'::' '{print $4}')
-
-# ── ② stdout JSON additionalContext ──
-echo "{\"hookSpecificOutput\":{\"hookEventName\":\"SubagentStop\",\"additionalContext\":\"[ADD SubagentStop] ${agent_name} 子代理结束。Plan: ${plan_kw}, handoff: ${handoff}。边界校验通过，审计已聚合。\"}}"
-exit 0