tools/wire-cli.sh

@@ -3,7 +3,7 @@
 # 用法:
 #   wire-cli.sh {claude|codex|copilot|antigravity|kiro}         接線
 #   wire-cli.sh purge {claude|codex|copilot|antigravity|kiro}   備份後移除該 CLI 的所有 hook
-#   wire-cli.sh smoke {claude|codex|copilot|antigravity|kiro}   跑一輪五支 hook，驗執行期
+#   wire-cli.sh smoke {claude|codex|copilot|antigravity|kiro}   跑一輪六支 hook，驗執行期
 #   wire-cli.sh status {claude|codex|copilot|antigravity|kiro}  唯讀盤點接線現況，不寫檔也不執行 hook
 #
 # purge 移除的是「所有 hook」，含非 jsc 的第三方項目。安裝一律先 purge 再接線：混著別人的
@@ -14,22 +14,25 @@
 # 跑起來不出錯（缺 node、路徑錯、權限不足都只在真的執行時才現形）。
 #
 # 接線行為（依 CLI 而定，皆為冪等：重跑只取代既有的 jsc-hooks 標記段落，不會重複疊加）：
-#   claude       — 什麼都不用寫，hooks.json 已自動接線五支 hook
+#   claude       — 什麼都不用寫，hooks.json 已自動接線六支 hook
 #   codex        — 在 shell rc 檔加上 codex 別名，轉呼叫 tools/jsc-wrap.sh codex（開始計時）；
 #                  在 config.toml 設 notify（每輪補 session-timer.sh start 再 mark，JSC_CLI=codex）；
-#                  在 AGENTS.md 附加 STE100 規則段落（prompt 降級）
+#                  在 AGENTS.md 附加 STE100 與註解範圍規則段落（prompt 降級）
 #   copilot      — 在 shell rc 檔加上 copilot 別名，轉呼叫 tools/jsc-wrap.sh copilot；
-#                  在 copilot-instructions.md 附加 STE100 規則段落
+#                  在 copilot-instructions.md 附加 STE100 與註解範圍規則段落
 #   antigravity  — 在 shell rc 檔加上 agy 別名，轉呼叫 tools/jsc-wrap.sh antigravity；
-#                  在全域規則檔附加 STE100 規則段落
-#   kiro         — 在工作區 .kiro/hooks/ 下建立 jsc-hooks.json（每輪 mark 加 STE100）
-#                  與 jsc-hooks-session-start.json（sessionStart 開始計時），皆帶 JSC_CLI=kiro
+#                  在全域規則檔附加 STE100 與註解範圍規則段落
+#   kiro         — 在工作區 .kiro/hooks/ 下建立 jsc-hooks.json（每輪 mark 加 STE100
+#                  與註解範圍規則）與 jsc-hooks-session-start.json（sessionStart 開始計時），
+#                  皆帶 JSC_CLI=kiro
 #
 # 覆蓋範圍要據實回報，不得暗示每個 CLI 都有保護：
-#   claude                          五支 hook 全接，回報 wired
-#   codex、copilot、antigravity、kiro 只有別名或規則檔，接不上 PreToolUse 與
+#   claude                          六支 hook 全接，回報 wired
+#   codex、copilot、antigravity、kiro 只有別名或規則檔，接不上 PreToolUse、PostToolUse 與
 #                                   UserPromptSubmit，版本前置檢查與 SDLC 模型鎖
-#                                   都沒接上，一律回報 degraded 並在 reason 講明
+#                                   都沒接上，一律回報 degraded 並在 reason 講明。
+#                                   註解範圍檢查在這四個 CLI 只剩規則提示：沒有 post-tool
+#                                   hook，寫檔後的自動掃描接不上，違規註解只能靠模型自律
 #   所有 jsc 標記段落都採整段重寫，重跑等同先移除舊內容再重裝
 #
 # 寫入後自我驗證，通過才回報成功：每個寫過的檔案重新讀一次，確認標記段落存在且落在
@@ -76,6 +79,23 @@ esac
 # STE100 規則段落的唯一來源：ste100-guard.sh 的實際輸出
 ste100_text() { sh "$HOOKS/ste100-guard.sh" 2>/dev/null | sed '/^exit /d'; }
 
+# 註解範圍規則段落的唯一來源：comment-scope.sh prompt 的實際輸出。
+# 規則正文不在這裡抄一份：抄了就會跟腳本各自漂移，兩邊講的規則對不起來。
+comment_scope_text() { sh "$HOOKS/comment-scope.sh" prompt 2>/dev/null | sed '/^exit /d'; }
+
+# 寫進規則檔的完整段落：語言規則加註解範圍規則，共用同一組 jsc-hooks 標記。
+# 兩段合在一個標記段落裡，purge 與重跑接線都是整段處理，不必各自再記一組標記。
+rules_text() { ste100_text; comment_scope_text; }
+
+# 驗證：規則檔真的收到註解範圍那一段了嗎。比對字串取自腳本的第一行實際輸出，
+# 不是另外抄一句關鍵字——抄的關鍵字改腳本時不會跟著改，驗證就會永遠通過。
+# $1=檔案
+has_comment_scope() {
+  _first=$(comment_scope_text | head -n1)
+  [ -n "$_first" ] || return 1
+  grep -qF "$_first" "$1" 2>/dev/null
+}
+
 # 以標記整段取代（冪等）；標記不存在就在檔尾新增；檔案不存在就建立。
 # 適用 markdown 規則檔與 shell rc 檔：這兩種檔案沒有「區段」概念，附在檔尾就對了。
 # $1=檔案 $2=開頭標記行 $3=結尾標記行 $4=標記之間要寫入的內容
@@ -588,7 +608,10 @@ if [ "$action" = smoke ]; then
     _h="$1"; _s="${2:-}"
     # 技能名一律清空：冒煙要驗的是「沒有技能情境時腳本跑得完」。留著繼承來的 JSC_SKILL，
     # sdlc-gate.sh wp-check skill 會拿它當真實呼叫判定，有未結清 PR 時就誤報成執行期錯誤。
-    _out=$(printf '{}' | JSC_CLI="$cli" JSC_SKILL="" SKILL="" sh "$HOOKS/$_h" $_s 2>&1); _rc=$?
+    # JSC_CHANGED_FILE 同理清空：留著繼承來的檔名，comment-scope.sh 會真的去掃那個檔，
+    # 掃到違規註解就 exit 2，冒煙測試變成看環境臉色，測不出腳本本身跑不跑得完。
+    _out=$(printf '{}' | JSC_CLI="$cli" JSC_SKILL="" SKILL="" JSC_CHANGED_FILE="" \
+      sh "$HOOKS/$_h" $_s 2>&1); _rc=$?
     if [ "$_rc" -eq 0 ]; then
       printf '[jsc] %s%s：exit 0，正常。\n' "$_h" "${_s:+ $_s}" >> "$smoke_out"
     elif [ "$_h" = sdlc-gate.sh ] && [ "$_s" = check ] && [ "$_rc" -eq 2 ]; then
@@ -596,6 +619,10 @@ if [ "$action" = smoke ]; then
       # （見 hooks/lib.sh 開頭）——鎖存在且模型不符時就該擋下該輪提示。那是 hook 正常
       # 工作，不是執行期錯誤；把它算成錯誤會讓每個正在上鎖的工作階段都誤報一次失敗。
       printf '[jsc] %s check：exit 2，SDLC 階段鎖擋下該輪提示，屬設計行為，不算錯誤。\n' "$_h" >> "$smoke_out"
+    elif [ "$_h" = comment-scope.sh ] && [ -z "$_s" ] && [ "$_rc" -eq 2 ]; then
+      # 同一類放行：comment-scope.sh 無參數模式的 exit 2 是「掃到違規註解」的設計行為。
+      # 冒煙時取不到檔名，正常會走 exit 0；真的走到 exit 2 也代表腳本判定跑完了，不是出錯。
+      printf '[jsc] %s：exit 2，掃到違規註解並發出警告，屬設計行為，不算錯誤。\n' "$_h" >> "$smoke_out"
     else
       smoke_fails=$((smoke_fails + 1))
       printf '[jsc] %s%s：exit %s，執行期出錯：%s\n' "$_h" "${_s:+ $_s}" "$_rc" \
@@ -612,9 +639,13 @@ if [ "$action" = smoke ]; then
   # wp-check skill 在取不到技能名時放行（上面已清空技能名），所以兩者都不需要白名單例外。
   smoke_one sdlc-gate.sh "wp-check prompt"
   smoke_one sdlc-gate.sh "wp-check skill"
+  # comment-scope.sh 也有兩個接在不同事件的模式，兩個都要驗：prompt 一律 exit 0，
+  # 無參數模式在取不到檔名時安靜 exit 0（上面已清空 JSC_CHANGED_FILE，stdin 也只有 {}）。
+  smoke_one comment-scope.sh prompt
+  smoke_one comment-scope.sh
 
   if [ "$smoke_fails" -eq 0 ]; then
-    printf 'status=ok reason=%s\n' "五支 hook 的每個接線模式都跑得完，沒有執行期錯誤"
+    printf 'status=ok reason=%s\n' "六支 hook 的每個接線模式都跑得完，沒有執行期錯誤"
     cat "$smoke_out"; rm -f "$smoke_out"; exit 0
   fi
   printf 'status=failed reason=%s\n' "$smoke_fails 支 hook 有執行期錯誤"
@@ -644,6 +675,13 @@ if [ "$action" = status ]; then
     else st_item "$1" "$2" missing; fi
   }
 
+  # 註解範圍規則寫進規則檔了嗎。與 STE100 共用同一個標記段落，所以要單獨比對內容：
+  # 標記在、內容卻是舊版只有 STE100 的那一份時，這一項才看得出來缺了。$1=項目名 $2=檔案
+  st_comment_scope() {
+    if [ -f "$2" ] && has_comment_scope "$2"; then st_item "$1" "$2" present
+    else st_item "$1" "$2" missing; fi
+  }
+
   # 別名段落只要任何一個既有 rc 檔帶有標記就算接上。$1=項目名 $2=標記名
   st_rc_alias() {
     for _rc in "$HOME/.bashrc" "$HOME/.zshrc" "$HOME/.config/fish/config.fish"; do
@@ -656,7 +694,12 @@ if [ "$action" = status ]; then
   case "$cli" in
     claude)
       if [ -f "$HOOKS/hooks.json" ]; then st_item hooks.json "$HOOKS/hooks.json" present
-      else st_item hooks.json "$HOOKS/hooks.json" missing; fi ;;
+      else st_item hooks.json "$HOOKS/hooks.json" missing; fi
+      # 六支 hook 全靠這一個檔宣告，只看檔案在不在會漏掉「檔在、某支沒接進去」。
+      # 最後加進來的 comment-scope.sh 是最可能漏的一支，所以單獨列一項。
+      if [ -f "$HOOKS/hooks.json" ] && grep -qF 'comment-scope.sh' "$HOOKS/hooks.json" 2>/dev/null
+      then st_item comment-scope "$HOOKS/hooks.json" present
+      else st_item comment-scope "$HOOKS/hooks.json" missing; fi ;;
 
     codex)
       config="${CODEX_HOME:-$HOME/.codex}/config.toml"
@@ -669,17 +712,20 @@ if [ "$action" = status ]; then
       fi
       st_rc_alias alias jsc-hooks:codex
       st_block ste100 "${CODEX_HOME:-$HOME/.codex}/AGENTS.md" "<!-- jsc-hooks -->"
-      st_degrade="STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查" ;;
+      st_comment_scope comment-scope "${CODEX_HOME:-$HOME/.codex}/AGENTS.md"
+      st_degrade="STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查，註解範圍只剩規則提示、無 post-tool hook 可接寫檔後掃描" ;;
 
     copilot)
       st_rc_alias alias jsc-hooks:copilot
       st_block ste100 "${JSC_COPILOT_INSTRUCTIONS:-$HOME/.config/copilot/copilot-instructions.md}" "<!-- jsc-hooks -->"
-      st_degrade="STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查" ;;
+      st_comment_scope comment-scope "${JSC_COPILOT_INSTRUCTIONS:-$HOME/.config/copilot/copilot-instructions.md}"
+      st_degrade="STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查，註解範圍只剩規則提示、無 post-tool hook 可接寫檔後掃描" ;;
 
     antigravity)
       st_rc_alias alias jsc-hooks:antigravity
       st_block ste100 "${JSC_ANTIGRAVITY_RULES:-$HOME/.antigravity/AGENTS.md}" "<!-- jsc-hooks -->"
-      st_degrade="STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查" ;;
+      st_comment_scope comment-scope "${JSC_ANTIGRAVITY_RULES:-$HOME/.antigravity/AGENTS.md}"
+      st_degrade="STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查，註解範圍只剩規則提示、無 post-tool hook 可接寫檔後掃描" ;;
 
     kiro)
       # kiro 的 hook 檔綁在工作區，這裡看的一律是目前工作目錄底下那一份
@@ -687,7 +733,12 @@ if [ "$action" = status ]; then
         if [ -f "$_f" ] && json_top_key "$_f" run; then st_item "$(basename "$_f" .json)" "$_f" present
         else st_item "$(basename "$_f" .json)" "$_f" missing; fi
       done
-      st_degrade="SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查" ;;
+      # userPromptSubmit 那一筆的 run 串了兩支腳本，只驗 JSON 讀得懂會漏掉少接的那一支
+      if [ -f ./.kiro/hooks/jsc-hooks.json ] &&
+         grep -qF 'comment-scope.sh' ./.kiro/hooks/jsc-hooks.json 2>/dev/null
+      then st_item comment-scope ./.kiro/hooks/jsc-hooks.json present
+      else st_item comment-scope ./.kiro/hooks/jsc-hooks.json missing; fi
+      st_degrade="SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查，註解範圍只剩規則提示、無 post-tool hook 可接寫檔後掃描" ;;
   esac
 
   if [ "$st_missing" -gt 0 ]; then
@@ -698,7 +749,7 @@ if [ "$action" = status ]; then
     printf 'status=degraded reason=%s\n' "$st_degrade"
     cat "$st_items"; rm -f "$st_items"; exit 1
   fi
-  printf 'status=wired reason=%s\n' "hooks.json 自動接線全部五支 hook"
+  printf 'status=wired reason=%s\n' "hooks.json 自動接線全部六支 hook"
   cat "$st_items"; rm -f "$st_items"; exit 0
 fi
 
@@ -707,8 +758,11 @@ case "$cli" in
     bin=$(cli_bin claude)
     command -v "$bin" >/dev/null 2>&1 || skip "未偵測到 claude 執行檔"
     [ -f "$HOOKS/hooks.json" ] || fail "找不到 $HOOKS/hooks.json，claude 接不到任何 hook"
+    grep -qF 'comment-scope.sh' "$HOOKS/hooks.json" 2>/dev/null \
+      || fail "$HOOKS/hooks.json 沒有接上 comment-scope.sh，註解範圍檢查不會生效"
     printf 'status=wired reason=%s\n' "hooks.json 自動接線"
-    echo "[jsc] claude：由 hooks/hooks.json 自動接線全部五支 hook，無需寫入設定。"
+    echo "[jsc] claude：由 hooks/hooks.json 自動接線全部六支 hook，無需寫入設定。"
+    echo "[jsc] claude：只有 claude 有 post-tool hook，comment-scope.sh 的寫檔後自動掃描只在這裡接得上。"
     exit 0 ;;
 
   codex)
@@ -731,16 +785,18 @@ case "$cli" in
     toml_root_key "$config" notify \
       || fail "$config 的 notify 沒有落在根層（被歸進某張表，codex 讀不到，hook 會靜靜失效）"
     write_alias_rc "jsc-hooks:codex" "$alias_line" || fail "無法把 $bin 別名寫進 shell rc 檔"
-    replace_block "$agents" "<!-- jsc-hooks -->" "<!-- /jsc-hooks -->" "$(ste100_text)" \
+    replace_block "$agents" "<!-- jsc-hooks -->" "<!-- /jsc-hooks -->" "$(rules_text)" \
       || fail "無法寫入 $agents"
     has_block "$agents" "<!-- jsc-hooks -->" || fail "$agents 寫入後讀不到 jsc-hooks 標記段落"
-    printf 'status=degraded reason=%s\n' "STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查"
+    has_comment_scope "$agents" || fail "$agents 寫入後讀不到註解範圍規則"
+    printf 'status=degraded reason=%s\n' "STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查，註解範圍只剩規則提示、無 post-tool hook 可接寫檔後掃描"
     echo "[jsc] codex：已在 shell rc 加上 $bin 別名，轉呼叫 tools/jsc-wrap.sh codex，啟動當下開始計時。"
     echo "[jsc] codex：別名要開新的 shell 或重新 source rc 檔才生效。"
     echo "[jsc] codex：已設定 $config 的 notify（根層鍵，已驗證），每輪補 session-timer.sh start 再 mark。"
-    echo "[jsc] codex：已在 $agents 寫入 STE100 規則段落（prompt 降級）。"
+    echo "[jsc] codex：已在 $agents 寫入 STE100 與註解範圍規則段落（prompt 降級）。"
     echo "[jsc] codex：SDLC 模型鎖降級為技能步驟檢查，鎖檔仍由 sdlc-gate.sh lock 寫入。"
     echo "[jsc] codex：版本前置檢查接不上（codex 沒有 pre-tool hook），改由 /jsc-cli:deploy 定期更新。"
+    echo "[jsc] codex：註解範圍檢查只接得到規則提示（codex 沒有 post-tool hook），寫檔後的自動掃描接不上，違規註解要靠 /jsc-review:code-review 補。"
     exit 1 ;;
 
   copilot)
@@ -749,15 +805,17 @@ case "$cli" in
     instr="${JSC_COPILOT_INSTRUCTIONS:-$HOME/.config/copilot/copilot-instructions.md}"
     alias_line="alias $bin='sh \"$HERE/jsc-wrap.sh\" copilot'"
     write_alias_rc "jsc-hooks:copilot" "$alias_line" || fail "無法把 $bin 別名寫進 shell rc 檔"
-    replace_block "$instr" "<!-- jsc-hooks -->" "<!-- /jsc-hooks -->" "$(ste100_text)" \
+    replace_block "$instr" "<!-- jsc-hooks -->" "<!-- /jsc-hooks -->" "$(rules_text)" \
       || fail "無法寫入 $instr"
     has_block "$instr" "<!-- jsc-hooks -->" || fail "$instr 寫入後讀不到 jsc-hooks 標記段落"
-    printf 'status=degraded reason=%s\n' "STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查"
+    has_comment_scope "$instr" || fail "$instr 寫入後讀不到註解範圍規則"
+    printf 'status=degraded reason=%s\n' "STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查，註解範圍只剩規則提示、無 post-tool hook 可接寫檔後掃描"
     echo "[jsc] copilot：已在 shell rc 加上 $bin 別名，轉呼叫 tools/jsc-wrap.sh copilot。"
-    echo "[jsc] copilot：已在 $instr 寫入 STE100 規則段落（prompt 降級）。"
+    echo "[jsc] copilot：已在 $instr 寫入 STE100 與註解範圍規則段落（prompt 降級）。"
     echo "[jsc] copilot：別名要開新的 shell 或重新 source rc 檔才生效。"
     echo "[jsc] copilot：SDLC 模型鎖降級為技能步驟檢查，鎖檔仍由 sdlc-gate.sh lock 寫入。"
     echo "[jsc] copilot：版本前置檢查接不上（copilot 沒有 pre-tool hook），改由 /jsc-cli:deploy 定期更新。"
+    echo "[jsc] copilot：註解範圍檢查只接得到規則提示（copilot 沒有 post-tool hook），寫檔後的自動掃描接不上，違規註解要靠 /jsc-review:code-review 補。"
     exit 1 ;;
 
   antigravity)
@@ -766,15 +824,17 @@ case "$cli" in
     rules="${JSC_ANTIGRAVITY_RULES:-$HOME/.antigravity/AGENTS.md}"
     alias_line="alias $bin='sh \"$HERE/jsc-wrap.sh\" antigravity'"
     write_alias_rc "jsc-hooks:antigravity" "$alias_line" || fail "無法把 $bin 別名寫進 shell rc 檔"
-    replace_block "$rules" "<!-- jsc-hooks -->" "<!-- /jsc-hooks -->" "$(ste100_text)" \
+    replace_block "$rules" "<!-- jsc-hooks -->" "<!-- /jsc-hooks -->" "$(rules_text)" \
       || fail "無法寫入 $rules"
     has_block "$rules" "<!-- jsc-hooks -->" || fail "$rules 寫入後讀不到 jsc-hooks 標記段落"
-    printf 'status=degraded reason=%s\n' "STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查"
+    has_comment_scope "$rules" || fail "$rules 寫入後讀不到註解範圍規則"
+    printf 'status=degraded reason=%s\n' "STE100 降級為 prompt 檔，SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查，註解範圍只剩規則提示、無 post-tool hook 可接寫檔後掃描"
     echo "[jsc] antigravity：已在 shell rc 加上 $bin 別名，轉呼叫 tools/jsc-wrap.sh antigravity。"
-    echo "[jsc] antigravity：已在 $rules 寫入 STE100 規則段落（prompt 降級）。"
+    echo "[jsc] antigravity：已在 $rules 寫入 STE100 與註解範圍規則段落（prompt 降級）。"
     echo "[jsc] antigravity：別名要開新的 shell 或重新 source rc 檔才生效。"
     echo "[jsc] antigravity：SDLC 模型鎖降級為技能步驟檢查，鎖檔仍由 sdlc-gate.sh lock 寫入。"
     echo "[jsc] antigravity：版本前置檢查接不上（antigravity 沒有 pre-tool hook），改由 /jsc-cli:deploy 定期更新。"
+    echo "[jsc] antigravity：註解範圍檢查只接得到規則提示（antigravity 沒有 post-tool hook），寫檔後的自動掃描接不上，違規註解要靠 /jsc-review:code-review 補。"
     exit 1 ;;
 
   kiro)
@@ -798,10 +858,10 @@ EOF
     cat > "$hookfile" 2>/dev/null <<EOF || fail "無法寫入 $hookfile"
 {
   "name": "jsc-hooks",
-  "description": "jsc session timer + STE100 guard bridge (auto-generated by jsc-hooks:hooks-install, do not edit by hand)",
+  "description": "jsc session timer + STE100 guard + comment scope bridge (auto-generated by jsc-hooks:hooks-install, do not edit by hand)",
   "on": ["sessionEnd", "userPromptSubmit"],
   "env": { "JSC_CLI": "kiro" },
-  "run": "sh \\"$HOOKS/session-timer.sh\\" mark </dev/null; sh \\"$HOOKS/ste100-guard.sh\\" </dev/null"
+  "run": "sh \\"$HOOKS/session-timer.sh\\" mark </dev/null; sh \\"$HOOKS/ste100-guard.sh\\" </dev/null; sh \\"$HOOKS/comment-scope.sh\\" prompt </dev/null"
 }
 EOF
     for f in "$startfile" "$hookfile"; do
@@ -812,9 +872,11 @@ EOF
     done
     grep -qF '"sessionStart"' "$startfile" 2>/dev/null || fail "$startfile 沒有接在 sessionStart"
     grep -qF '"userPromptSubmit"' "$hookfile" 2>/dev/null || fail "$hookfile 沒有接在 userPromptSubmit"
-    printf 'status=degraded reason=%s\n' "SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查"
+    grep -qF 'comment-scope.sh' "$hookfile" 2>/dev/null || fail "$hookfile 的 run 沒有接到 comment-scope.sh"
+    printf 'status=degraded reason=%s\n' "SDLC 模型鎖降級為技能步驟檢查，無 pre-tool hook 可接版本前置檢查，註解範圍只剩規則提示、無 post-tool hook 可接寫檔後掃描"
     echo "[jsc] kiro：已建立 $startfile（sessionStart 開始計時）與 $hookfile（JSC_CLI=kiro），兩份都已驗證。"
     echo "[jsc] kiro：SDLC 模型鎖降級為技能步驟檢查，鎖檔仍由 sdlc-gate.sh lock 寫入。"
     echo "[jsc] kiro：版本前置檢查接不上（kiro 沒有 pre-tool hook），改由 /jsc-cli:deploy 定期更新。"
+    echo "[jsc] kiro：註解範圍檢查只接得到規則提示（kiro 沒有 post-tool hook），寫檔後的自動掃描接不上，違規註解要靠 /jsc-review:code-review 補。"
     exit 1 ;;
 esac