add-coder 0.3.25 → 0.3.27

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

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

@@ -1,117 +1,8 @@
 #!/bin/bash
-# state-detect.sh — ADD 活跃流程检测 + dev action 追踪
-# 共享库
+# state-detect.sh — 兼容入口；状态裁决统一委托 common.sh，禁止维护第二套 magicDir 探测。
 
-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/codex/hooks/lib/vocabulary.sh

@@ -1,14 +1,9 @@
 #!/bin/bash
 # vocabulary.sh — 从 vocabulary markdown 表格加载触发词
-# 单一数据源: .qoder/vocabulary/add-governance-vocabulary.md §类别 A-F 表格
+# 单一数据源: 当前 adapter 的 vocabulary/add-governance-vocabulary.md §类别 A-F 表格
 
-# 动态探测 MAGIC_DIR
-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}"
-fi
+# Codex 真源固定读取 `.codex`，禁止遍历或回退其他 magicDir。
+MAGIC_DIR=".codex"
 VOCABULARY_FILE="${PROJECT_DIR:-$PWD}/$MAGIC_DIR/vocabulary/add-governance-vocabulary.md"
 
 # 输出格式: 优先级::触发词正则::响应文本（:: 避免与触发词内的 | 冲突）

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

@@ -1,5 +1,5 @@
 #!/bin/bash
-# Notification — Review 提醒 + Token 预警（Claude Code 适配）
+# Notification — Review 提醒 + Token 预警（Codex 适配）
 # 治理卡位 #12: 开发提醒/Token 预警
 set -euo pipefail
 
@@ -11,7 +11,8 @@ if [ "$ntype" != "result" ]; then
 fi
 
 HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+export CURRENT_MAGIC=".codex"
+export MAGIC_DIR=".codex"
 COMMON_LIB="$HOOK_DIR/lib/common.sh"
 [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
 
@@ -22,24 +23,8 @@ state=$(detect_active_add 2>/dev/null || true)
 
 IFS='::' read -r plan _ _ _ _ <<< "$state"
 
-# 动态探测
-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}"
-fi
 reviews_dir="${PROJECT_DIR}/$MAGIC_DIR/reviews"
 if ls "$reviews_dir"/*.md >/dev/null 2>&1; then
   echo "[ADD Notification] Plan: ${plan} — 请检查 Review 文档: ${reviews_dir}"
 fi
 exit 0
-#!/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/codex/hooks/post-tool-use.sh

@@ -1,138 +1,43 @@
 #!/bin/bash
-# post-tool-use.sh — PostToolUse：格式化 + 文档守卫 + 审计提醒 + DPS 自动化
-# 治理卡位 #5: 格式化 + ADD文档守卫 + 审计落库 + 结果增强 + 哨兵自动化
+# post-tool-use.sh — Codex PostToolUse：ADD 文档提示与开发操作审计提醒
 set -euo pipefail
 
 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)"
 COMMON_LIB="$HOOK_DIR/lib/common.sh"
 [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
 
-input=$(parse_input)
-tool_name=$(json_get "$input" "tool_name")
-[ -z "$tool_name" ] && tool_name=$(echo "$input" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
+input=$(cat)
+tool_name=$(echo "$input" | jq -r '.tool_name // empty')
 
-# ═══════════════ §1: HITL DPS 自动化 — check_dps ≥ 80 → 自动建哨兵 ═══════════════
-# 检测 MCP check_dps 调用结果，DPS ≥ 80 自动 touch .tongyi-{plan} 哨兵
-if echo "$input" | grep -q '"check_dps"'; then
-  tool_output=$(echo "$input" | grep -o '"output"[[:space:]]*:[[:space:]]*"[^"]*"\|"content"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null || echo "")
-  dps_score=$(echo "$tool_output" | grep -oP 'DPS\s*=\s*\K\d+' 2>/dev/null || echo "")
-  plan_keyword=$(echo "$input" | grep -oP '"planKeyword"\s*:\s*"\K[^"]+' 2>/dev/null || echo "")
-
-  if [ -n "$dps_score" ] && [ -n "$plan_keyword" ]; then
-    if [ "$dps_score" -ge 80 ] 2>/dev/null; then
-      sentinel="${PROJECT_DIR:-$PWD}/${MAGIC_DIR:-.qoder}/hitl/.tongyi-${plan_keyword}"
-      if [ ! -f "$sentinel" ]; then
-        touch "$sentinel" 2>/dev/null && echo "[ADD PostToolUse] ✅ DPS=${dps_score} ≥80, HITL 自动通过 → ${sentinel}" >&2 || true
-        echo "[ADD PostToolUse] DPS=${dps_score} ≥80, 已自动建哨兵 ${sentinel}" >&2
-      else
-        echo "[ADD PostToolUse] DPS=${dps_score} ≥80, 哨兵已存在 → ${sentinel}" >&2
-      fi
-    else
-      echo "[ADD PostToolUse] ⚠️ DPS=${dps_score} <80, 需 Review 后手动建哨兵 .tongyi-${plan_keyword}" >&2
-      echo "[ADD PostToolUse] 修复文档后重新 check_dps，通过即自动放行。" >&2
-    fi
-  fi
-fi
-
-# ═══════════════ §2: Edit/Write matcher: 格式化 + 文档守卫 + 自动 plan_track ═══════════════
-if [ "$tool_name" = "Edit" ] || [ "$tool_name" = "Write" ]; then
-  file_path=$(echo "$input" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
-  [ -z "$file_path" ] && exit 0
-
-  # §2a: ADD 文档结构守卫
-  if echo "$file_path" | grep -qE '\.(qoder|claude|add)/(plans|specs|reviews)/'; then
-    echo "[ADD PostToolUse] ADD 文档已写入: ${file_path}。请确保章节完整、双向链接齐全。" >&2
-  fi
-
-  # §2b: plan_track 自动触发 — specs/ 或 add-route 写入后自动落库
-  if echo "$file_path" | grep -qE '/(specs|plans)/.*add-route'; then
-    plan_name=$(basename "$file_path" | sed 's/-add-route.*//' | sed 's/-plan-v[0-9]*$//')
-    # 从路径提取完整 planName（含 -plan-vN 后缀）
-    if echo "$file_path" | grep -qE 'add-route'; then
-      # add-route 写入：从文件名反推 planName
-      plan_prefix=$(basename "$file_path" | sed 's/-add-route-v[0-9]*\.md$//')
-      plan_dir=$(dirname "$file_path")
-      if [ -d "$plan_dir" ]; then
-        plan_file=$(ls "$plan_dir"/*-plan-v*.md 2>/dev/null | head -1 || echo "")
-        if [ -n "$plan_file" ]; then
-          plan_name=$(basename "$plan_file" .md)
-        fi
-      fi
-    fi
-    if [ -n "$plan_name" ]; then
-      echo "[ADD PostToolUse] 📊 自动同步 PlanRecord: plan_track({ planName: \"${plan_name}\" }) — 请执行" >&2
-    fi
+_report_file() {
+  local file_path="$1"
+  [ -n "$file_path" ] || return 0
+  if echo "$file_path" | grep -qE '(^|/)\.codex/(plans|specs|reviews)/'; then
+    echo "[ADD PostToolUse] ADD 文档已写入: $file_path；请检查双向链接与 Plan/Spec 状态。" >&2
   fi
-
-  # §2c: devlog 自动提醒 — add-route Step 8 全 [x] 时提醒
-  if echo "$file_path" | grep -qE 'add-route.*\.md$'; then
-    if [ -f "$file_path" ]; then
-      step8_content=$(sed -n '/## Step 8/,/^## /p' "$file_path" 2>/dev/null || echo "")
-      unchecked=$(echo "$step8_content" | grep -c '^\- \[ \]' 2>/dev/null || echo "0")
-      checked=$(echo "$step8_content" | grep -c '^\- \[x\]' 2>/dev/null || echo "0")
-      if [ "$unchecked" = "0" ] && [ "$checked" -gt 0 ]; then
-        echo "[ADD PostToolUse] ⚠️ Step 8 全部收敛完成！请写 devlog日志(走mcp) → 更新 handoff" >&2
-      fi
-    fi
-  fi
-
-  # §2d: schema.json 自动 regen — 模板 .md 修改后更新对应 schema
-  if echo "$file_path" | grep -qE 'templates/.*\.md$'; then
-    schema_file="${file_path%.md}.schema.json"
-    if [ -f "$schema_file" ]; then
-      # 扫描模板实际 ## 标题，更新 schema sections
-      headings=$(grep -oP '^## \K.+' "$file_path" 2>/dev/null | head -20 || echo "")
-      if [ -n "$headings" ]; then
-        echo "[ADD PostToolUse] 🔄 模板已修改，请检查 ${schema_file} 是否需更新（§ sections）" >&2
-        echo "[ADD PostToolUse] 模板标题: $(echo "$headings" | tr '\n' ' ')" >&2
-      fi
-    fi
-  fi
-
-  # §2e: 审计提醒
-  echo "[ADD PostToolUse] 文件已写入: ${file_path}。请执行 record_dev_operation 落库审计（ADD-7）。" >&2
+  echo "[ADD PostToolUse] 文件已写入: $file_path；请执行 record_dev_operation 落库审计。" >&2
+}
+
+if [ "$tool_name" = "apply_patch" ]; then
+  patch_command=$(echo "$input" | jq -r '.tool_input.command // empty')
+  patch_paths=$(printf '%s\n' "$patch_command" | sed -nE 's/^\*\*\* (Add|Update|Delete) File: (.+)$/\2/p')
+  while IFS= read -r file_path; do
+    _report_file "$file_path"
+  done <<< "$patch_paths"
   exit 0
 fi
 
-# ═══════════════ §3: Bash matcher: 结果增强 ═══════════════
-if [ "$tool_name" = "Bash" ]; then
-  echo "[ADD PostToolUse] 命令执行完成。如有 lint/tsc 错误请修复。" >&2
+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')
+  _report_file "$file_path"
   exit 0
 fi
 
-exit 0
-#!/bin/bash
-# post-tool-use.sh — Claude Code PostToolUse：格式化 + 文档守卫 + 审计提醒
-# 治理卡位 #5: 格式化 + ADD文档守卫 + 审计落库 + 结果增强
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-COMMON_LIB="$HOOK_DIR/lib/common.sh"
-[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
-
-input=$(parse_input)
-tool_name=$(json_get "$input" "tool_name")
-[ -z "$tool_name" ] && tool_name=$(echo "$input" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
-
-# ── Edit/Write matcher: 格式化 + ADD文档守卫 ──
-if [ "$tool_name" = "Edit" ] || [ "$tool_name" = "Write" ]; then
-  file_path=$(echo "$input" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
-  [ -z "$file_path" ] && exit 0
-
-  # ADD 文档结构守卫：写入 plans/specs/reviews 后提示
-  if echo "$file_path" | grep -qE '\.(qoder|claude|add)/(plans|specs|reviews)/'; then
-    echo "[ADD PostToolUse] ADD 文档已写入: ${file_path}。请确保章节完整、双向链接齐全、增量修订格式正确。" >&2
-  fi
-
-  # 审计提醒（所有文件写入）
-  echo "[ADD PostToolUse] 文件已写入: ${file_path}。请执行 record_dev_operation 落库审计（ADD-7）。" >&2
-  exit 0
-fi
-
-# ── Bash matcher: 结果增强 ──
 if [ "$tool_name" = "Bash" ]; then
-  echo "[ADD PostToolUse] 命令执行完成。如有 lint/tsc 错误请修复。" >&2
-  exit 0
+  echo "[ADD PostToolUse] Bash 命令完成；若产生 lint/typecheck/test 错误，请在本轮闭环。" >&2
 fi
 
 exit 0