add-coder 0.3.27 → 0.3.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (262) hide show
  1. package/README.md +252 -150
  2. package/package.json +2 -1
  3. package/templates/.add-coder-src-hash.json +126 -148
  4. package/templates/adapters/claude/hooks/doc-format-guard.ts +32 -0
  5. package/templates/adapters/claude/hooks/lib/claude-env.ts +7 -0
  6. package/templates/adapters/claude/hooks/notification.ts +24 -0
  7. package/templates/adapters/claude/hooks/permission-denied.ts +33 -0
  8. package/templates/adapters/claude/hooks/permission-gate.ts +12 -0
  9. package/templates/adapters/claude/hooks/post-tool-failure.ts +4 -0
  10. package/templates/adapters/claude/hooks/post-tool-use.ts +17 -0
  11. package/templates/adapters/claude/hooks/pre-compact.ts +10 -0
  12. package/templates/adapters/claude/hooks/pre-tool-use.ts +81 -0
  13. package/templates/adapters/claude/hooks/prompt-submit.ts +82 -0
  14. package/templates/adapters/claude/hooks/review-checklist.ts +4 -0
  15. package/templates/adapters/claude/hooks/session-end.ts +10 -0
  16. package/templates/adapters/claude/hooks/session-start.ts +24 -0
  17. package/templates/adapters/claude/hooks/stop-check.ts +15 -0
  18. package/templates/adapters/claude/hooks/stop-failure.ts +34 -0
  19. package/templates/adapters/claude/hooks/subagent-guard.ts +25 -0
  20. package/templates/adapters/claude/hooks/subagent-stop.ts +12 -0
  21. package/templates/adapters/claude/settings.json +13 -13
  22. package/templates/adapters/codex/hooks/doc-format-guard.ts +30 -0
  23. package/templates/adapters/codex/hooks/notification.ts +26 -0
  24. package/templates/adapters/codex/hooks/permission-gate.ts +15 -0
  25. package/templates/adapters/codex/hooks/post-tool-failure.ts +14 -0
  26. package/templates/adapters/codex/hooks/post-tool-use.ts +85 -0
  27. package/templates/adapters/codex/hooks/pre-compact.ts +20 -0
  28. package/templates/adapters/codex/hooks/pre-tool-use.ts +141 -0
  29. package/templates/adapters/codex/hooks/prompt-submit.ts +38 -0
  30. package/templates/adapters/codex/hooks/review-checklist.ts +5 -0
  31. package/templates/adapters/codex/hooks/session-end.ts +19 -0
  32. package/templates/adapters/codex/hooks/session-start.ts +45 -0
  33. package/templates/adapters/codex/hooks/stop-check.ts +59 -0
  34. package/templates/adapters/codex/hooks/subagent-guard.ts +22 -0
  35. package/templates/adapters/codex/hooks/subagent-stop.ts +20 -0
  36. package/templates/adapters/codex/hooks.json +5 -5
  37. package/templates/adapters/qoder/hooks/doc-format-guard.ts +34 -0
  38. package/templates/adapters/qoder/hooks/lib/context-inject.ts +61 -0
  39. package/templates/adapters/qoder/hooks/lib/qoder-env.ts +23 -0
  40. package/templates/adapters/qoder/hooks/lib/review-checklist.ts +5 -0
  41. package/templates/adapters/qoder/hooks/notification.ts +34 -0
  42. package/templates/adapters/qoder/hooks/permission-gate.ts +26 -0
  43. package/templates/adapters/qoder/hooks/post-tool-failure.ts +30 -0
  44. package/templates/adapters/qoder/hooks/post-tool-use.ts +32 -0
  45. package/templates/adapters/qoder/hooks/pre-compact.ts +16 -0
  46. package/templates/adapters/qoder/hooks/pre-tool-use.ts +112 -0
  47. package/templates/adapters/qoder/hooks/prompt-submit.ts +66 -0
  48. package/templates/adapters/qoder/hooks/review-checklist.ts +24 -0
  49. package/templates/adapters/qoder/hooks/session-end.ts +27 -0
  50. package/templates/adapters/qoder/hooks/session-start.ts +83 -0
  51. package/templates/adapters/qoder/hooks/stop-check.ts +69 -0
  52. package/templates/adapters/qoder/hooks/subagent-guard.ts +16 -0
  53. package/templates/adapters/qoder/hooks/subagent-stop.ts +33 -0
  54. package/templates/adapters/qoder/settings.json +13 -13
  55. package/templates/adapters/trae/hooks/doc-format-guard.ts +30 -0
  56. package/templates/adapters/trae/hooks/notification.ts +22 -0
  57. package/templates/adapters/trae/hooks/permission-gate.ts +15 -0
  58. package/templates/adapters/trae/hooks/post-tool-failure.ts +14 -0
  59. package/templates/adapters/trae/hooks/post-tool-use.ts +24 -0
  60. package/templates/adapters/trae/hooks/pre-compact.ts +15 -0
  61. package/templates/adapters/trae/hooks/pre-tool-use.ts +40 -0
  62. package/templates/adapters/trae/hooks/prompt-submit.ts +29 -0
  63. package/templates/adapters/trae/hooks/review-checklist.ts +5 -0
  64. package/templates/adapters/trae/hooks/session-end.ts +16 -0
  65. package/templates/adapters/trae/hooks/session-start.ts +15 -0
  66. package/templates/adapters/trae/hooks/stop-check.ts +20 -0
  67. package/templates/adapters/trae/hooks/subagent-guard.ts +22 -0
  68. package/templates/adapters/trae/hooks/subagent-stop.ts +15 -0
  69. package/templates/adapters/trae/hooks.json +1 -1
  70. package/templates/adapters/vscode/hooks/doc-format-guard.ts +27 -0
  71. package/templates/adapters/vscode/hooks/notification.ts +22 -0
  72. package/templates/adapters/vscode/hooks/permission-gate.ts +15 -0
  73. package/templates/adapters/vscode/hooks/post-tool-failure.ts +32 -0
  74. package/templates/adapters/vscode/hooks/post-tool-use.ts +25 -0
  75. package/templates/adapters/vscode/hooks/pre-compact.ts +15 -0
  76. package/templates/adapters/vscode/hooks/pre-tool-use.ts +78 -0
  77. package/templates/adapters/vscode/hooks/prompt-submit.ts +74 -0
  78. package/templates/adapters/vscode/hooks/review-checklist.ts +5 -0
  79. package/templates/adapters/vscode/hooks/session-end.ts +16 -0
  80. package/templates/adapters/vscode/hooks/session-start.ts +24 -0
  81. package/templates/adapters/vscode/hooks/stop-check.ts +21 -0
  82. package/templates/adapters/vscode/hooks/subagent-guard.ts +21 -0
  83. package/templates/adapters/vscode/hooks/subagent-stop.ts +15 -0
  84. package/templates/core/docs/ADD-governance-claude-code.md +3 -3
  85. package/templates/core/docs/ADD-governance-codex.md +5 -5
  86. package/templates/core/docs/ADD-governance-qoder-cn.md +4 -4
  87. package/templates/core/docs/ADD-governance-trae.md +2 -2
  88. package/templates/core/docs/ADD-governance-vscode-copilot.md +21 -22
  89. package/templates/core/governance/audit-bridge.ts +47 -0
  90. package/templates/core/governance/common.ts +299 -0
  91. package/templates/core/governance/context-inject.ts +53 -0
  92. package/templates/core/governance/doc-format-guard.ts +440 -0
  93. package/templates/core/governance/notification-router.ts +62 -0
  94. package/templates/core/governance/notify.ts +66 -0
  95. package/templates/core/governance/permission-gate-router.ts +42 -0
  96. package/templates/core/governance/post-tool-failure-router.ts +56 -0
  97. package/templates/core/governance/post-tool-router.ts +212 -0
  98. package/templates/core/governance/pre-compact-guard.ts +41 -0
  99. package/templates/core/governance/pre-tool-guard.ts +309 -0
  100. package/templates/core/governance/preload-templates.ts +241 -0
  101. package/templates/core/governance/prompt-router.ts +222 -0
  102. package/templates/core/governance/review-checklist-guard.ts +186 -0
  103. package/templates/core/governance/rules.ts +720 -0
  104. package/templates/core/governance/session-end.ts +88 -0
  105. package/templates/core/governance/session-start-guard.ts +99 -0
  106. package/templates/core/governance/state-detect.ts +6 -0
  107. package/templates/core/governance/stop-router.ts +140 -0
  108. package/templates/core/governance/subagent-guard-router.ts +35 -0
  109. package/templates/core/governance/subagent-stop-router.ts +93 -0
  110. package/templates/core/governance/subagent-stop.ts +75 -0
  111. package/templates/core/governance/vocabulary.ts +109 -0
  112. package/templates/core/hooks/doc-format-guard.ts +21 -0
  113. package/templates/core/hooks/notification.ts +11 -0
  114. package/templates/core/hooks/permission-gate.ts +7 -0
  115. package/templates/core/hooks/post-tool-failure.ts +7 -0
  116. package/templates/core/hooks/post-tool-use.ts +23 -0
  117. package/templates/core/hooks/pre-compact.ts +9 -0
  118. package/templates/core/hooks/pre-tool-use.ts +30 -0
  119. package/templates/core/hooks/prompt-submit.ts +11 -0
  120. package/templates/core/hooks/review-checklist.ts +4 -0
  121. package/templates/core/hooks/session-end.ts +10 -0
  122. package/templates/core/hooks/session-start.ts +9 -0
  123. package/templates/core/hooks/stop-check.ts +14 -0
  124. package/templates/core/hooks/subagent-guard.ts +8 -0
  125. package/templates/core/hooks/subagent-stop.ts +9 -0
  126. package/templates/core/scripts/mcp-server/tools/gateway/check_rahs.ts +12 -1
  127. package/templates/core/scripts/mcp-server/tools/plan.ts +12 -2
  128. package/templates/adapters/claude/hooks/doc-format-guard.sh +0 -283
  129. package/templates/adapters/claude/hooks/lib/common.sh +0 -220
  130. package/templates/adapters/claude/hooks/lib/context-inject.sh +0 -96
  131. package/templates/adapters/claude/hooks/lib/notify.sh +0 -36
  132. package/templates/adapters/claude/hooks/lib/preload-templates.sh +0 -212
  133. package/templates/adapters/claude/hooks/lib/session-end.sh +0 -76
  134. package/templates/adapters/claude/hooks/lib/state-detect.sh +0 -13
  135. package/templates/adapters/claude/hooks/lib/subagent-stop.sh +0 -90
  136. package/templates/adapters/claude/hooks/lib/vocabulary.sh +0 -62
  137. package/templates/adapters/claude/hooks/notification.sh +0 -45
  138. package/templates/adapters/claude/hooks/permission-denied.sh +0 -42
  139. package/templates/adapters/claude/hooks/permission-gate.sh +0 -18
  140. package/templates/adapters/claude/hooks/post-tool-failure.sh +0 -10
  141. package/templates/adapters/claude/hooks/post-tool-use.sh +0 -35
  142. package/templates/adapters/claude/hooks/pre-compact.sh +0 -37
  143. package/templates/adapters/claude/hooks/pre-tool-use.sh +0 -153
  144. package/templates/adapters/claude/hooks/prompt-submit.sh +0 -99
  145. package/templates/adapters/claude/hooks/review-checklist.sh +0 -10
  146. package/templates/adapters/claude/hooks/session-end.sh +0 -21
  147. package/templates/adapters/claude/hooks/session-start.sh +0 -36
  148. package/templates/adapters/claude/hooks/stop-check.sh +0 -54
  149. package/templates/adapters/claude/hooks/stop-failure.sh +0 -44
  150. package/templates/adapters/claude/hooks/subagent-guard.sh +0 -36
  151. package/templates/adapters/claude/hooks/subagent-stop.sh +0 -20
  152. package/templates/adapters/codex/hooks/doc-format-guard.sh +0 -343
  153. package/templates/adapters/codex/hooks/lib/common.sh +0 -209
  154. package/templates/adapters/codex/hooks/lib/context-inject.sh +0 -96
  155. package/templates/adapters/codex/hooks/lib/notify.sh +0 -36
  156. package/templates/adapters/codex/hooks/lib/preload-templates.sh +0 -208
  157. package/templates/adapters/codex/hooks/lib/session-end.sh +0 -76
  158. package/templates/adapters/codex/hooks/lib/state-detect.sh +0 -8
  159. package/templates/adapters/codex/hooks/lib/subagent-stop.sh +0 -90
  160. package/templates/adapters/codex/hooks/lib/vocabulary.sh +0 -51
  161. package/templates/adapters/codex/hooks/notification.sh +0 -30
  162. package/templates/adapters/codex/hooks/permission-gate.sh +0 -18
  163. package/templates/adapters/codex/hooks/post-tool-failure.sh +0 -10
  164. package/templates/adapters/codex/hooks/post-tool-use.sh +0 -43
  165. package/templates/adapters/codex/hooks/pre-compact.sh +0 -37
  166. package/templates/adapters/codex/hooks/pre-tool-use.sh +0 -130
  167. package/templates/adapters/codex/hooks/prompt-submit.sh +0 -92
  168. package/templates/adapters/codex/hooks/review-checklist.sh +0 -10
  169. package/templates/adapters/codex/hooks/session-end.sh +0 -38
  170. package/templates/adapters/codex/hooks/session-start.sh +0 -63
  171. package/templates/adapters/codex/hooks/stop-check.sh +0 -71
  172. package/templates/adapters/codex/hooks/subagent-guard.sh +0 -15
  173. package/templates/adapters/codex/hooks/subagent-stop.sh +0 -47
  174. package/templates/adapters/qoder/hooks/doc-format-guard.sh +0 -341
  175. package/templates/adapters/qoder/hooks/lib/common.sh +0 -223
  176. package/templates/adapters/qoder/hooks/lib/context-inject.sh +0 -96
  177. package/templates/adapters/qoder/hooks/lib/notify.sh +0 -36
  178. package/templates/adapters/qoder/hooks/lib/preload-templates.sh +0 -212
  179. package/templates/adapters/qoder/hooks/lib/session-end.sh +0 -76
  180. package/templates/adapters/qoder/hooks/lib/state-detect.sh +0 -13
  181. package/templates/adapters/qoder/hooks/lib/subagent-stop.sh +0 -90
  182. package/templates/adapters/qoder/hooks/lib/vocabulary.sh +0 -62
  183. package/templates/adapters/qoder/hooks/notification.sh +0 -25
  184. package/templates/adapters/qoder/hooks/permission-gate.sh +0 -8
  185. package/templates/adapters/qoder/hooks/post-tool-failure.sh +0 -8
  186. package/templates/adapters/qoder/hooks/post-tool-use.sh +0 -121
  187. package/templates/adapters/qoder/hooks/pre-compact.sh +0 -37
  188. package/templates/adapters/qoder/hooks/pre-tool-use.sh +0 -154
  189. package/templates/adapters/qoder/hooks/prompt-submit.sh +0 -96
  190. package/templates/adapters/qoder/hooks/review-checklist.sh +0 -157
  191. package/templates/adapters/qoder/hooks/session-end.sh +0 -24
  192. package/templates/adapters/qoder/hooks/session-start.sh +0 -45
  193. package/templates/adapters/qoder/hooks/stop-check.sh +0 -59
  194. package/templates/adapters/qoder/hooks/subagent-guard.sh +0 -27
  195. package/templates/adapters/qoder/hooks/subagent-stop.sh +0 -26
  196. package/templates/adapters/trae/hooks/doc-format-guard.sh +0 -343
  197. package/templates/adapters/trae/hooks/lib/common.sh +0 -220
  198. package/templates/adapters/trae/hooks/lib/context-inject.sh +0 -96
  199. package/templates/adapters/trae/hooks/lib/notify.sh +0 -36
  200. package/templates/adapters/trae/hooks/lib/preload-templates.sh +0 -212
  201. package/templates/adapters/trae/hooks/lib/session-end.sh +0 -76
  202. package/templates/adapters/trae/hooks/lib/state-detect.sh +0 -10
  203. package/templates/adapters/trae/hooks/lib/subagent-stop.sh +0 -90
  204. package/templates/adapters/trae/hooks/lib/vocabulary.sh +0 -62
  205. package/templates/adapters/trae/hooks/notification.sh +0 -45
  206. package/templates/adapters/trae/hooks/permission-gate.sh +0 -18
  207. package/templates/adapters/trae/hooks/post-tool-failure.sh +0 -10
  208. package/templates/adapters/trae/hooks/post-tool-use.sh +0 -138
  209. package/templates/adapters/trae/hooks/pre-compact.sh +0 -37
  210. package/templates/adapters/trae/hooks/pre-tool-use.sh +0 -223
  211. package/templates/adapters/trae/hooks/prompt-submit.sh +0 -87
  212. package/templates/adapters/trae/hooks/review-checklist.sh +0 -10
  213. package/templates/adapters/trae/hooks/session-end.sh +0 -38
  214. package/templates/adapters/trae/hooks/session-start.sh +0 -53
  215. package/templates/adapters/trae/hooks/stop-check.sh +0 -54
  216. package/templates/adapters/trae/hooks/subagent-guard.sh +0 -15
  217. package/templates/adapters/trae/hooks/subagent-stop.sh +0 -47
  218. package/templates/adapters/vscode/hooks/doc-format-guard.sh +0 -282
  219. package/templates/adapters/vscode/hooks/lib/common.sh +0 -220
  220. package/templates/adapters/vscode/hooks/lib/context-inject.sh +0 -96
  221. package/templates/adapters/vscode/hooks/lib/notify.sh +0 -36
  222. package/templates/adapters/vscode/hooks/lib/preload-templates.sh +0 -212
  223. package/templates/adapters/vscode/hooks/lib/session-end.sh +0 -76
  224. package/templates/adapters/vscode/hooks/lib/state-detect.sh +0 -13
  225. package/templates/adapters/vscode/hooks/lib/subagent-stop.sh +0 -90
  226. package/templates/adapters/vscode/hooks/lib/vocabulary.sh +0 -62
  227. package/templates/adapters/vscode/hooks/notification.sh +0 -43
  228. package/templates/adapters/vscode/hooks/permission-gate.sh +0 -18
  229. package/templates/adapters/vscode/hooks/post-tool-failure.sh +0 -28
  230. package/templates/adapters/vscode/hooks/post-tool-use.sh +0 -35
  231. package/templates/adapters/vscode/hooks/pre-compact.sh +0 -37
  232. package/templates/adapters/vscode/hooks/pre-tool-use.sh +0 -153
  233. package/templates/adapters/vscode/hooks/prompt-submit.sh +0 -99
  234. package/templates/adapters/vscode/hooks/review-checklist.sh +0 -10
  235. package/templates/adapters/vscode/hooks/session-end.sh +0 -13
  236. package/templates/adapters/vscode/hooks/session-start.sh +0 -35
  237. package/templates/adapters/vscode/hooks/stop-check.sh +0 -62
  238. package/templates/adapters/vscode/hooks/subagent-guard.sh +0 -37
  239. package/templates/adapters/vscode/hooks/subagent-stop.sh +0 -12
  240. package/templates/core/hooks/doc-format-guard.sh +0 -343
  241. package/templates/core/hooks/lib/common.sh +0 -220
  242. package/templates/core/hooks/lib/context-inject.sh +0 -96
  243. package/templates/core/hooks/lib/notify.sh +0 -36
  244. package/templates/core/hooks/lib/preload-templates.sh +0 -212
  245. package/templates/core/hooks/lib/session-end.sh +0 -76
  246. package/templates/core/hooks/lib/state-detect.sh +0 -10
  247. package/templates/core/hooks/lib/subagent-stop.sh +0 -90
  248. package/templates/core/hooks/lib/vocabulary.sh +0 -62
  249. package/templates/core/hooks/notification.sh +0 -45
  250. package/templates/core/hooks/permission-gate.sh +0 -18
  251. package/templates/core/hooks/post-tool-failure.sh +0 -10
  252. package/templates/core/hooks/post-tool-use.sh +0 -138
  253. package/templates/core/hooks/pre-compact.sh +0 -37
  254. package/templates/core/hooks/pre-tool-use.sh +0 -223
  255. package/templates/core/hooks/prompt-submit.sh +0 -87
  256. package/templates/core/hooks/review-checklist.sh +0 -10
  257. package/templates/core/hooks/session-end.sh +0 -38
  258. package/templates/core/hooks/session-start.sh +0 -53
  259. package/templates/core/hooks/stop-check.sh +0 -54
  260. package/templates/core/hooks/subagent-guard.sh +0 -15
  261. package/templates/core/hooks/subagent-stop.sh +0 -47
  262. package/templates/shared/hooks-lib/common.sh +0 -22
@@ -1,90 +0,0 @@
1
- #!/bin/bash
2
- ###
3
- # @Author : xiaomingming wujixmm@gmail.com
4
- # @Date : 2026-07-17 13:21:03
5
- # @LastEditors : xiaomingming wujixmm@gmail.com
6
- # @LastEditTime : 2026-07-17 13:21:22
7
- # @FilePath : /add-coder/templates/core/hooks/lib/subagent-stop.sh
8
- # @Description : SubagentStop 治理卡位
9
- ###
10
- # subagent-stop.sh — SubagentStop 治理卡位
11
- # 路径: templates/core/hooks/lib/subagent-stop.sh
12
- #
13
- # 治理职能(卡位 #11):
14
- # ① 子 agent 结果边界校验: 检查交付物是否在 spec 边界内(不越界、不遗漏)
15
- # ② 审计聚合: 将子 agent 的 sub-traceId 审计记录合并回主 traceId
16
- # ③ 阻断能力: 子 agent 结果不符合 spec → exit 2 要求重做
17
- #
18
- # 用法: 被各 IDE adapter 的 SubagentStop hook 脚本 source 并调用 main
19
-
20
- SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
21
- source "$SCRIPT_DIR/common.sh" 2>/dev/null || true
22
-
23
- # 边界校验: 检查子 agent 交付物是否超出 spec 定义的文件范围
24
- # 参数: $1 = subagent_name, $2 = 子 agent 交付物文件列表(空格分隔)
25
- check_boundary() {
26
- local subagent_name="$1"
27
- local deliverables="$2"
28
-
29
- # 获取活跃 ADD 状态
30
- local state=""
31
- if type detect_active_add >/dev/null 2>&1; then
32
- state=$(detect_active_add 2>/dev/null || true)
33
- fi
34
-
35
- if [ -z "$state" ]; then
36
- # 无活跃 Plan —— 无 spec 可参考,仅告警不阻断
37
- echo "[ADD SubagentStop] ⚠️ 无活跃 ADD Plan,无法校验 $subagent_name 的交付物边界" >&2
38
- return 0
39
- fi
40
-
41
- local plan_kw=$(echo "$state" | awk -F'::' '{print $1}')
42
- local handoff=$(echo "$state" | awk -F'::' '{print $4}')
43
-
44
- echo "[ADD SubagentStop] $subagent_name 已完成,交付物: $deliverables" >&2
45
- echo "[ADD SubagentStop] 关联 Plan: $plan_kw | handoff: $handoff" >&2
46
-
47
- # best-effort: 如果 handoff 中列出了允许的文件范围,检查交付物是否在其中
48
- if [ -f "$handoff" ] && [ -n "$deliverables" ]; then
49
- local violations=""
50
- for f in $deliverables; do
51
- if ! grep -q "$f" "$handoff" 2>/dev/null; then
52
- violations="${violations} $f"
53
- fi
54
- done
55
- if [ -n "$violations" ]; then
56
- echo "[ADD SubagentStop] ❌ $subagent_name 交付物超出 spec 边界: $violations" >&2
57
- echo "[ADD SubagentStop] 请检查这些文件是否属于本轮 spec 范围,或更新 handoff 文件清单" >&2
58
- return 1
59
- fi
60
- fi
61
-
62
- return 0
63
- }
64
-
65
- main() {
66
- local subagent_name="${1:-unknown}"
67
-
68
- # 从 stdin 解析 JSON(hook 事件传入)
69
- local input=$(parse_input 2>/dev/null || echo "{}")
70
- local deliverables=""
71
-
72
- # 尝试从 stdin JSON 提取交付物信息
73
- local agent_type=$(echo "$input" | grep -o '"agent_type"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
74
- [ -n "$agent_type" ] && subagent_name="${subagent_name}($agent_type)"
75
-
76
- # ① 边界校验
77
- if ! check_boundary "$subagent_name" "$deliverables"; then
78
- echo "[ADD SubagentStop] 要求重做——交付物超出 spec 边界" >&2
79
- exit "${EXIT_BLOCK:-2}"
80
- fi
81
-
82
- # ② 审计聚合(输出到 stderr 供日志记录)
83
- echo "[ADD SubagentStop] $subagent_name 边界校验通过 — $(date -Iseconds)" >&2
84
-
85
- exit 0
86
- }
87
-
88
- if [ "${BASH_SOURCE[0]}" = "$0" ]; then
89
- main "$@"
90
- fi
@@ -1,51 +0,0 @@
1
- #!/bin/bash
2
- # vocabulary.sh — 从 vocabulary markdown 表格加载触发词
3
- # 单一数据源: 当前 adapter 的 vocabulary/add-governance-vocabulary.md §类别 A-F 表格
4
-
5
- # Codex 真源固定读取 `.codex`,禁止遍历或回退其他 magicDir。
6
- MAGIC_DIR=".codex"
7
- VOCABULARY_FILE="${PROJECT_DIR:-$PWD}/$MAGIC_DIR/vocabulary/add-governance-vocabulary.md"
8
-
9
- # 输出格式: 优先级::触发词正则::响应文本(:: 避免与触发词内的 | 冲突)
10
- load_triggers() {
11
- [ ! -f "$VOCABULARY_FILE" ] && return 1
12
- sed -n '/^## 类别 A: 文档类型/,/^## 类别 [G-Z]/p' "$VOCABULARY_FILE" \
13
- | grep -E '^\| (P0|P1|P2) ' \
14
- | while IFS='|' read -r _ prio raw_trigger action; do
15
- prio=$(echo "$prio" | xargs)
16
- trigger=$(echo "$raw_trigger" | sed 's/`//g;s/ *\/ */|/g;s/^ *//;s/ *$//')
17
- action=$(echo "$action" | xargs)
18
- [ -z "$trigger" ] && continue
19
- echo "${prio}::${trigger}::${action}"
20
- done || true
21
- }
22
-
23
- match_trigger() {
24
- local prompt="$1"
25
- while IFS= read -r line; do
26
- [ -z "$line" ] && continue
27
- local prio="${line%%::*}"
28
- local rest="${line#*::}"
29
- local regex="${rest%%::*}"
30
- local action="${rest#*::}"
31
- # 跳过开发关键词检测行(由 Layer 2/3 分流处理,特征:超长regex含"修bug")
32
- if echo "$regex" | grep -qE '修\.\?bug|fix\.\?bug' 2>/dev/null; then
33
- continue
34
- fi
35
- if echo "$prompt" | grep -qiE "$regex" 2>/dev/null; then
36
- echo "[ADD 触发] ${regex} → ${action}"
37
- fi
38
- done < <(load_triggers 2>/dev/null)
39
- }
40
-
41
- load_dev_keywords() {
42
- load_triggers 2>/dev/null | while IFS= read -r line; do
43
- [ -z "$line" ] && continue
44
- # 只取包含"开发|改功能"的开发关键词检测行
45
- if echo "$line" | grep -q '开发|改功能' 2>/dev/null; then
46
- local rest="${line#*::}"
47
- local regex="${rest%%::*}"
48
- echo "$regex"
49
- fi
50
- done || true
51
- }
@@ -1,30 +0,0 @@
1
- #!/bin/bash
2
- # Notification — Review 提醒 + Token 预警(Codex 适配)
3
- # 治理卡位 #12: 开发提醒/Token 预警
4
- set -euo pipefail
5
-
6
- input=$(cat)
7
- ntype=$(echo "$input" | jq -r '.notification_type // ""' 2>/dev/null || echo "")
8
-
9
- if [ "$ntype" != "result" ]; then
10
- exit 0
11
- fi
12
-
13
- HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
14
- export CURRENT_MAGIC=".codex"
15
- export MAGIC_DIR=".codex"
16
- COMMON_LIB="$HOOK_DIR/lib/common.sh"
17
- [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
18
-
19
- export PROJECT_DIR="$PWD"
20
-
21
- state=$(detect_active_add 2>/dev/null || true)
22
- [ -z "$state" ] && exit 0
23
-
24
- IFS='::' read -r plan _ _ _ _ <<< "$state"
25
-
26
- reviews_dir="${PROJECT_DIR}/$MAGIC_DIR/reviews"
27
- if ls "$reviews_dir"/*.md >/dev/null 2>&1; then
28
- echo "[ADD Notification] Plan: ${plan} — 请检查 Review 文档: ${reviews_dir}"
29
- fi
30
- exit 0
@@ -1,18 +0,0 @@
1
- #!/bin/bash
2
- # PermissionRequest — 权限请求门禁(Claude Code 适配)
3
- set -euo pipefail
4
-
5
- HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
6
- SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
7
- [ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
8
-
9
- input=$(parse_input)
10
- tool_name=$(echo "$input" | jq -r '.tool_name // empty')
11
-
12
- # 高风险工具需要二次确认
13
- case "$tool_name" in
14
- Bash|Write|Edit)
15
- echo "[ADD PermissionGate] 高风险工具: ${tool_name},请确认操作。"
16
- ;;
17
- esac
18
- exit 0
@@ -1,10 +0,0 @@
1
- #!/bin/bash
2
- # PostToolUseFailure — 工具失败后处理(Claude Code 适配)
3
- set -euo pipefail
4
-
5
- HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
6
- SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
7
- [ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
8
-
9
- echo "[ADD PostToolFailure] 工具调用失败,请检查错误信息并修复。"
10
- exit 0
@@ -1,43 +0,0 @@
1
- #!/bin/bash
2
- # post-tool-use.sh — Codex PostToolUse:ADD 文档提示与开发操作审计提醒
3
- set -euo pipefail
4
-
5
- HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
6
- export CURRENT_MAGIC=".codex"
7
- export MAGIC_DIR=".codex"
8
- export PROJECT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
9
- COMMON_LIB="$HOOK_DIR/lib/common.sh"
10
- [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
11
-
12
- input=$(cat)
13
- tool_name=$(echo "$input" | jq -r '.tool_name // empty')
14
-
15
- _report_file() {
16
- local file_path="$1"
17
- [ -n "$file_path" ] || return 0
18
- if echo "$file_path" | grep -qE '(^|/)\.codex/(plans|specs|reviews)/'; then
19
- echo "[ADD PostToolUse] ADD 文档已写入: $file_path;请检查双向链接与 Plan/Spec 状态。" >&2
20
- fi
21
- echo "[ADD PostToolUse] 文件已写入: $file_path;请执行 record_dev_operation 落库审计。" >&2
22
- }
23
-
24
- if [ "$tool_name" = "apply_patch" ]; then
25
- patch_command=$(echo "$input" | jq -r '.tool_input.command // empty')
26
- patch_paths=$(printf '%s\n' "$patch_command" | sed -nE 's/^\*\*\* (Add|Update|Delete) File: (.+)$/\2/p')
27
- while IFS= read -r file_path; do
28
- _report_file "$file_path"
29
- done <<< "$patch_paths"
30
- exit 0
31
- fi
32
-
33
- if [ "$tool_name" = "Write" ] || [ "$tool_name" = "Edit" ] || [ "$tool_name" = "SearchReplace" ]; then
34
- file_path=$(echo "$input" | jq -r '.tool_input.file_path // .tool_input.path // empty')
35
- _report_file "$file_path"
36
- exit 0
37
- fi
38
-
39
- if [ "$tool_name" = "Bash" ]; then
40
- echo "[ADD PostToolUse] Bash 命令完成;若产生 lint/typecheck/test 错误,请在本轮闭环。" >&2
41
- fi
42
-
43
- exit 0
@@ -1,37 +0,0 @@
1
- #!/bin/bash
2
- # pre-compact.sh — 上下文压缩前 ADD 状态保存(Claude Code 适配)
3
- # 治理卡位 #9: ADD状态保存 + 恢复清单导出 + tpl标记清理
4
- set -euo pipefail
5
-
6
- HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
7
- export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
8
- COMMON_LIB="$HOOK_DIR/lib/common.sh"
9
- [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
10
-
11
- export PROJECT_DIR="$PWD"
12
-
13
- # ── ① 获取 ADD 状态并保存到标记文件 ──
14
- if type detect_active_add >/dev/null 2>&1; then
15
- state=$(detect_active_add 2>/dev/null || true)
16
- if [ -n "$state" ]; then
17
- IFS='::' read -r plan step rounds handoff add_route <<< "$state"
18
-
19
- # 写入恢复标记文件(SessionStart 恢复时读取)
20
- RECOVERY_FILE="/tmp/add_recovery_$(echo "${PROJECT_DIR}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")"
21
- cat > "$RECOVERY_FILE" <<EOF
22
- plan=${plan}
23
- step=${step}
24
- rounds=${rounds}
25
- handoff=${handoff}
26
- add_route=${add_route}
27
- EOF
28
-
29
- echo "[ADD PreCompact] ADD 状态已保存: Plan=${plan}, Step=${step}" >&2
30
- fi
31
- fi
32
-
33
- # ── ② 清理 tpl-injected 标记(compact 后上下文丢失,下次需重注) ──
34
- TPL_FLAG="/tmp/add_tpl_$(echo "${PROJECT_DIR}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")"
35
- rm -f "$TPL_FLAG" 2>/dev/null || true
36
-
37
- exit 0
@@ -1,130 +0,0 @@
1
- #!/bin/bash
2
- # pre-tool-use.sh — Codex PreToolUse:Bash 裸写保护 + apply_patch 文件守卫
3
- set -euo pipefail
4
-
5
- input=$(cat)
6
- HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
7
- export CURRENT_MAGIC=".codex"
8
- export MAGIC_DIR=".codex"
9
- export PROJECT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
10
- # core notify helper 使用相对 MAGIC_DIR;统一 cwd,避免从 repo 子目录启动时写偏审计文件。
11
- cd "$PROJECT_DIR"
12
-
13
- COMMON_LIB="$HOOK_DIR/lib/common.sh"
14
- [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
15
- source "$HOOK_DIR/lib/notify.sh" 2>/dev/null || true
16
-
17
- tool_name=$(echo "$input" | jq -r '.tool_name // empty')
18
- tool_command=$(echo "$input" | jq -r '.tool_input.command // empty')
19
- active_plan=$(detect_active_add 2>/dev/null || true)
20
- if [ -n "$active_plan" ]; then
21
- plan_keyword="${active_plan%%::*}"
22
- plan_status="active"
23
- else
24
- plan_keyword="no-active-plan"
25
- plan_status="none"
26
- fi
27
-
28
- _log_block() {
29
- local rule="$1" detail="$2"
30
- mkdir -p "$PROJECT_DIR/$MAGIC_DIR/debug-dump" 2>/dev/null || return 0
31
- printf '=== %s [BLOCKED: %s] ===\n%s\n=== DONE ===\n' \
32
- "$(date -Iseconds)" "$rule" "${detail:0:500}" \
33
- >> "$PROJECT_DIR/$MAGIC_DIR/debug-dump/stdin.log" 2>/dev/null || true
34
- }
35
-
36
- _deny() {
37
- local rule="$1" reason="$2" detail="${3:-$tool_name}"
38
- echo "⛔ [ADD PreToolUse] $reason" >&2
39
- jq -nc --arg reason "$reason" '{
40
- hookSpecificOutput: {
41
- hookEventName: "PreToolUse",
42
- permissionDecision: "deny",
43
- permissionDecisionReason: $reason
44
- }
45
- }'
46
- _log_block "$rule" "$detail"
47
- write_hook_event "pre-tool-use" "deny" "$tool_name" "$reason" "$plan_keyword" "$plan_status" 2>/dev/null || true
48
- exit "${EXIT_BLOCK:-2}"
49
- }
50
-
51
- _require_hitl_for() {
52
- local file_path="$1" do_hitl=false plan_name marker_base marker_full
53
-
54
- if echo "$file_path" | grep -qE '(^|/)\.codex/plans/'; then
55
- if ! echo "$file_path" | grep -qE -- '-handoff'; then
56
- do_hitl=true
57
- fi
58
- elif echo "$file_path" | grep -qE '(^|/)\.codex/reviews/'; then
59
- # Runtime Review 是运行时证据容器;Plan Review 与 Implementation Review 都必须走 create_hitl。
60
- if ! echo "$file_path" | grep -qE -- '-runtime'; then
61
- do_hitl=true
62
- fi
63
- fi
64
-
65
- [ "$do_hitl" = true ] || return 0
66
-
67
- plan_name=$(basename "$file_path" .md | sed 's/\.hitl$//')
68
- marker_full="$PROJECT_DIR/$MAGIC_DIR/hitl/.tongyi-${plan_name}"
69
- marker_base="$PROJECT_DIR/$MAGIC_DIR/hitl/.tongyi-$(echo "$plan_name" | sed 's/-plan-v[0-9]*$//;s/-add-route-v[0-9]*$//;s/-review-v[0-9]*$//;s/-review-implementation[^/]*$//')"
70
- if [ ! -f "$marker_full" ] && [ ! -f "$marker_base" ]; then
71
- _deny "hitl" "HITL 未同意: $file_path。请先 create_hitl,再由人工 update_hitl(TONGYI)。" "$file_path"
72
- fi
73
- }
74
-
75
- _guard_file_path() {
76
- local file_path="$1"
77
- [ -n "$file_path" ] || return 0
78
-
79
- if echo "$file_path" | grep -qE '(^|/)(\.env|\.env\.production|\.env\.local)$|credentials|secrets'; then
80
- _deny "sensitive-file" "敏感文件受保护,禁止写入: $file_path" "$file_path"
81
- fi
82
-
83
- _require_hitl_for "$file_path"
84
-
85
- if echo "$file_path" | grep -qE '(^|/)\.codex/(plans|specs|reviews)/'; then
86
- if [ -z "$active_plan" ]; then
87
- echo "[ADD PreToolUse] 正在修改 ADD 文档但未检测到活跃 Plan: $file_path" >&2
88
- fi
89
- fi
90
- }
91
-
92
- # Codex 对 Bash 与 apply_patch 都把 payload 放在 tool_input.command。
93
- # 只有 canonical Bash 才执行 shell 命令检查,避免把 patch body 误判成 shell。
94
- if [ "$tool_name" = "Bash" ]; then
95
- if echo "$tool_command" | grep -qE '(^|;|\|\||&&|\|)[[:space:]]*(python3?|node|ruby|perl|php)([[:space:]]|$)'; then
96
- _deny "script-interpreter" "禁止通过脚本解释器直接修改文件;请使用 apply_patch。" "$tool_command"
97
- fi
98
- # `-i` 必须是 sed 命令中的独立 option;不能把 session-init 等后续路径子串当成原地写入。
99
- if echo "$tool_command" | grep -qE '(^|[;&|][[:space:]]*)sed[[:space:]]+([^;&|]*[[:space:]])?(-[[:alpha:]]*i[^[:space:];&|]*|--in-place(=[^[:space:];&|]*)?)([[:space:];&|]|$)'; then
100
- _deny "sed-i" "禁止通过 sed -i 直接编辑文件;请使用 apply_patch。" "$tool_command"
101
- fi
102
- if echo "$tool_command" | grep -qE '[>]{1,2}[[:space:]]+[^[:space:]]'; then
103
- _deny "redirect" "禁止通过重定向写入文件;请使用 apply_patch。" "$tool_command"
104
- fi
105
- if echo "$tool_command" | grep -qE '\btee\b|\bdd\b.*of='; then
106
- _deny "tee-dd" "禁止通过 tee/dd 写入文件;请使用 apply_patch。" "$tool_command"
107
- fi
108
- if echo "$tool_command" | grep -qE '(^|;|\|\||&&|\|)[[:space:]]*(cp|mv|touch)\b'; then
109
- _deny "copy-move-touch" "禁止通过 cp/mv/touch 改变文件;请使用 apply_patch。" "$tool_command"
110
- fi
111
- exit 0
112
- fi
113
-
114
- if [ "$tool_name" = "apply_patch" ]; then
115
- patch_paths=$(printf '%s\n' "$tool_command" | sed -nE 's/^\*\*\* (Add|Update|Delete) File: (.+)$/\2/p')
116
- while IFS= read -r file_path; do
117
- [ -n "$file_path" ] && _guard_file_path "$file_path"
118
- done <<< "$patch_paths"
119
- mark_dev_action 2>/dev/null || true
120
- exit 0
121
- fi
122
-
123
- # 兼容尚未 canonicalize 的宿主输入;当前 Codex 正常上报 apply_patch。
124
- if [ "$tool_name" = "Write" ] || [ "$tool_name" = "Edit" ] || [ "$tool_name" = "SearchReplace" ]; then
125
- file_path=$(echo "$input" | jq -r '.tool_input.file_path // .tool_input.path // empty')
126
- _guard_file_path "$file_path"
127
- mark_dev_action 2>/dev/null || true
128
- fi
129
-
130
- exit 0
@@ -1,92 +0,0 @@
1
- #!/bin/bash
2
- # prompt-submit.sh — Codex UserPromptSubmit 触发词智能路由
3
- # 治理卡位 #3: Layer 1 精准触发 → Layer 2 阻断 → Layer 3 状态注入
4
- set -euo pipefail
5
-
6
- input=$(cat)
7
- prompt=$(echo "$input" | jq -r '.prompt // empty')
8
- [ -z "$prompt" ] && exit 0
9
-
10
- HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
11
- export CURRENT_MAGIC=".codex"
12
- export MAGIC_DIR=".codex"
13
- export PROJECT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
14
- # Codex hook command 继承 session cwd;先统一 git root,确保状态与报告路径稳定。
15
- cd "$PROJECT_DIR"
16
- source "$HOOK_DIR/lib/vocabulary.sh" 2>/dev/null || true
17
- source "$HOOK_DIR/lib/common.sh" 2>/dev/null || true
18
- source "$HOOK_DIR/lib/notify.sh" 2>/dev/null || true
19
-
20
- # ─── Layer 1: 精准 P0 触发词 ───
21
- matched=$(match_trigger "$prompt" 2>/dev/null || true)
22
- if [ -n "$matched" ]; then
23
- # 验收幂等保护: 如果已验收,提示不重复
24
- if echo "$prompt" | grep -qiE '验收|收敛' 2>/dev/null; then
25
- add_state=$(detect_active_add 2>/dev/null || true)
26
- if [ -n "$add_state" ]; then
27
- _handoff=$(echo "$add_state" | awk -F'::' '{print $4}')
28
- _add_route=$(echo "$add_state" | awk -F'::' '{print $5}')
29
- if is_already_accepted "$_add_route" "$_handoff" 2>/dev/null; then
30
- cat <<EOF
31
- [ADD 验收] ⚠️ 已验收。进入 Review 模式:
32
- ① 重新检查 checklist [T]/[R] 项
33
- ② 审查 audit 记录完整性
34
- ③ 如有差异 → Review 回流至 handoff(增量更新,不覆盖已有结论)
35
- ④ 无差异 → 记录 'Review 已确认,无新发现'
36
- ★ 同步检查: 如 checklist 有新 cuid 但 handoff 审计表缺失 → 更新 handoff ADD-7 表 + query_audit_logs 命令
37
- EOF
38
- HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
39
- "$HOOK_DIR/review-checklist.sh" "$_handoff" "$_add_route" 2>/dev/null || true
40
- exit 0
41
- fi
42
- fi
43
- fi
44
- echo "$matched"
45
- exit 0
46
- fi
47
-
48
- # ─── 开发关键词检测(动态加载) ───
49
- dev_kw=$(load_dev_keywords 2>/dev/null || true)
50
- if [ -z "$dev_kw" ]; then
51
- exit 0
52
- fi
53
-
54
- if ! echo "$prompt" | grep -qiE "$dev_kw"; then
55
- exit 0
56
- fi
57
-
58
- # ─── Layer 2/3: 按活跃 ADD 分流 ───
59
- state=$(detect_active_add 2>/dev/null || true)
60
- if [ -z "$state" ]; then
61
- # Layer 2: 无活跃 ADD → 提示启动(不阻断)
62
- cat >&2 <<'EOF'
63
- [ADD 提示] 检测到开发任务,但无活跃 ADD Plan。建议先执行 add-paradigm SKILL:
64
- Step 0: 文档先行 (Plan → Review → Specs)
65
- Step 3: 代码实现 + 审计植入
66
- Step 8: 收敛判断
67
- EOF
68
- write_hook_event "prompt-submit" "info" "$prompt" "无活跃 ADD Plan 下检测到开发任务" "no-active-plan" "none" 2>/dev/null || true
69
- exit 0
70
- fi
71
-
72
- # Layer 3: 有活跃 ADD → 注入状态
73
- plan=$(echo "$state" | awk -F'::' '{print $1}')
74
- step=$(echo "$state" | awk -F'::' '{print $2}')
75
- rounds=$(echo "$state" | awk -F'::' '{print $3}')
76
- handoff=$(echo "$state" | awk -F'::' '{print $4}')
77
- echo "[ADD 状态] Plan: ${plan}, 轮次: ${rounds}, Step: ${step}, handoff: ${handoff}"
78
-
79
- # ─── Hook 治理日报(注入 AI 上下文)───
80
- HOOK_JSONL="${MAGIC_DIR:-.codex}/reports/hook-events.jsonl"
81
- if [ -f "$HOOK_JSONL" ]; then
82
- TODAY="$(date +%Y-%m-%d)"
83
- TOTAL=$(grep -c "\"ts\":\"${TODAY}" "$HOOK_JSONL" 2>/dev/null || echo 0)
84
- NO_PLAN=$(grep "\"ts\":\"${TODAY}" "$HOOK_JSONL" 2>/dev/null | grep -c '"planKeyword":"no-active-plan"' || echo 0)
85
- if [ "$TOTAL" -gt 0 ] 2>/dev/null; then
86
- echo "[Hook 治理] 今日提示: ${TOTAL} 次 | 无 Plan 提示: ${NO_PLAN} 次"
87
- if [ "$NO_PLAN" -ge 10 ] 2>/dev/null; then
88
- echo "[Hook ⚠️] 无 Plan 提示已达 ${NO_PLAN} 次(≥10),建议创建 Plan 或检查 hooks 误报"
89
- fi
90
- fi
91
- fi
92
- exit 0
@@ -1,10 +0,0 @@
1
- #!/bin/bash
2
- # review-checklist.sh — Review 检查清单校验(Claude Code 适配)
3
- set -euo pipefail
4
-
5
- HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
6
- SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
7
- [ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
8
-
9
- echo "[ADD ReviewChecklist] 请在提交前确认 checklist.md 全部项已勾选。"
10
- exit 0
@@ -1,38 +0,0 @@
1
- #!/bin/bash
2
- # SessionEnd — 通用版(核心模板,Trae 等适配器继承)
3
- # 治理卡位 #2: 标记清理 + 会话审计结算 + Stop未触发兜底
4
- set -euo pipefail
5
-
6
- HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
7
- COMMON_LIB="$HOOK_DIR/lib/common.sh"
8
- [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
9
-
10
- export PROJECT_DIR="$PWD"
11
-
12
- # ── ① 清理 tpl-injected 标记 ──
13
- project_hash=$(echo "${PROJECT_DIR:-$PWD}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")
14
- rm -f "/tmp/add_tpl_${project_hash}" 2>/dev/null || true
15
-
16
- # ── ② 清理 dev action 标记 ──
17
- rm -f "/tmp/add_dev_${project_hash}" 2>/dev/null || true
18
-
19
- # ── ③ Stop 未触发兜底: 如果 dev action 标记还在,补执行 checklist 快照 ──
20
- if has_dev_action 2>/dev/null; then
21
- echo "[ADD SessionEnd] ⚠️ 检测到 dev action 标记未清除——Stop 可能未触发验收检查" >&2
22
-
23
- state=$(detect_active_add 2>/dev/null || true)
24
- if [ -n "$state" ]; then
25
- handoff=$(echo "$state" | awk -F'::' '{print $4}')
26
- add_route=$(echo "$state" | awk -F'::' '{print $5}')
27
- if [ -f "$handoff" ]; then
28
- echo "[ADD SessionEnd] 补执行 checklist 快照(best-effort,不阻断)" >&2
29
- if type check_add_completeness >/dev/null 2>&1; then
30
- check_add_completeness "$handoff" "$add_route" >&2 2>/dev/null || true
31
- fi
32
- fi
33
- fi
34
- fi
35
-
36
- # ── ④ 审计结算 ──
37
- echo "[ADD SessionEnd] 会话结束 — $(date -Iseconds)" >&2
38
- exit 0
@@ -1,63 +0,0 @@
1
- #!/bin/bash
2
- # SessionStart — ADD 上下文恢复 + 模板索引注入(Codex 适配)
3
- # 治理卡位 #1: ADD状态恢复 + 模板索引注入
4
- set -euo pipefail
5
-
6
- HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
7
- export CURRENT_MAGIC=".codex"
8
- export MAGIC_DIR=".codex"
9
- export PROJECT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
10
-
11
- # 加载四端通用函数(路径统一后: .claude/hooks/lib/common.sh)
12
- COMMON_LIB="$HOOK_DIR/lib/common.sh"
13
- [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
14
-
15
- # Codex 可能从 repo 子目录启动;状态仍只读取 Codex 自己的 `.codex`。
16
- export PLANS_DIR="$PROJECT_DIR/$MAGIC_DIR/plans"
17
-
18
- # ── ① ADD 状态恢复 ──
19
- state=$(detect_active_add 2>/dev/null || true)
20
- if [ -n "$state" ]; then
21
- plan=$(echo "$state" | awk -F'::' '{print $1}')
22
- step=$(echo "$state" | awk -F'::' '{print $2}')
23
- rounds=$(echo "$state" | awk -F'::' '{print $3}')
24
- handoff=$(echo "$state" | awk -F'::' '{print $4}')
25
- add_route=$(echo "$state" | awk -F'::' '{print $5}')
26
- cat <<EOF
27
- [ADD SessionStart] 检测到活跃 ADD Plan:
28
- Plan: ${plan}
29
- 轮次: ${rounds}
30
- 当前 Step: ${step}
31
- handoff: ${handoff}
32
- 恢复命令: query_audit_logs({ planKeyword: '${plan}' })
33
- EOF
34
- fi
35
-
36
- # ── ② 模板索引注入 ──
37
- # core lib 的相对路径面向其他 adapter;Codex 直接读取项目 `.codex/templates`。
38
- TEMPLATES_DIR="$PROJECT_DIR/$CURRENT_MAGIC/templates"
39
- if [ -d "$TEMPLATES_DIR" ]; then
40
- echo "## ADD 可用模板清单"
41
- for template_path in "$TEMPLATES_DIR"/*.md; do
42
- [ -f "$template_path" ] || continue
43
- echo "- $(basename "$template_path")"
44
- done
45
- fi
46
-
47
- # ── ③ §代办刷新:活跃 Plan 时提醒加载 IDE 代办 ──
48
- # session-init Step 2.6 依赖 IDE resume invoke SKILL,本段作为兜底
49
- if [ -n "$state" ]; then
50
- cat <<EOF
51
- [代办] 检测到活跃 Plan: ${plan}。如有未加载的 IDE 代办清单,请从 tasks.md §IDE JSON 刷新 TodoWrite。
52
- EOF
53
- fi
54
-
55
- # ── ④ §HITL 待审批检测 ──
56
- if [ -d "$PLANS_DIR" ]; then
57
- hitl_count=$(find "$PLANS_DIR" -name "*.hitl.md" -mtime -7 -type f 2>/dev/null | wc -l)
58
- if [ "$hitl_count" -gt 0 ] 2>/dev/null; then
59
- echo "[HITL 待审批] 检测到 ${hitl_count} 个待审批 HITL 提案,请检查并处理"
60
- fi
61
- fi
62
-
63
- exit 0