fix(gates): 修好會蓋掉異常目錄、把修復路徑鎖死與誤擋計畫階段的缺陷
異常回報依 wiki 讀取的結束碼分流，只有頁面確定不存在才套範本建新頁。 版本閘門與重啟閘門的豁免清單各補上 hook 修復技能。 階段閘門把計畫階段移出擋人名單，改成只注入提醒。 錯誤掃描的自家 hook 判定補齊九支腳本，並加一條路徑判定。 修復技能與接線技能的內文改成真的走得到的路徑與真的存在的關卡數。 原本 wiki 讀取失敗會一路落到套範本那一步，金鑰失效或 API 出狀況時， 就拿一份空白範本蓋掉整份異常目錄，而寫入不做合併也不留備份，蓋掉就救不回來。 兩道閘門把唯一的 hook 修復路徑一起擋住，hook 一壞就沒有任何方法修回來， 閘門等於鎖掉解除自己的路徑。工作包閘門擋下計畫階段是誤擋： 計畫是純邏輯階段、不碰程式碼，而閘門只知道有 PR 未合併，判不出跟新計畫有沒有關聯。 自家 hook 判定只認得早期那五支，後來加的四支出錯會被當成第三方的，只回報不修正。 修復技能裡三個指向流程的路徑指到不存在的位置，照著走一定撲空； 接線流程寫四道關卡，實際上有五道，兩段中文說明也混在英文內文裡。 異常目錄改成先讀回舊頁、把新列附在文末、再整頁寫回；讀不回來就放棄寫目錄頁並回報， 寧可少一列索引，也不覆蓋別人的紀錄。兩份豁免清單各補一項，理由逐項寫在腳本檔頭。 計畫階段改印提醒後放行，放棄的在製品上限與代價一併寫在檔頭。 自家 hook 判定逐支列出腳本名，再加一條安裝路徑判定，日後新增 hook 忘了補清單也還認得出來。 三個路徑改指到擁有它的技能組，關卡數改成五道並逐關寫明結束碼，兩段中文說明改回英文。 版本閘門在同一次改動另補唯讀的建議子命令，把版本比對表收斂成一行結論， 部署技能不必自己再解一次那張表。
This commit is contained in:
+33
-6
@@ -17,6 +17,15 @@
|
||||
# gitea.sh）時安靜降級：不輸出、exit 0。回報失敗不該再變成一次失敗。
|
||||
# 寫入 wiki 失敗才以 exit 4 回報，訊息走 stderr。
|
||||
#
|
||||
# 結束碼: 0=已寫入 wiki 並印出「{頁名} {網址}」，或安靜降級（找不到 gitea.sh、解析不出
|
||||
# wiki 存取庫、算不出 HASH、建不出暫存檔）——回報失敗不該再變成一次失敗
|
||||
# 2=用法錯誤（缺 --hook 或 --summary）
|
||||
# 4=寫入 wiki 失敗（異常頁與索引目錄頁，任一支寫不進去就算），或目錄頁的舊內容
|
||||
# 讀不回來（wiki-get 回 7 金鑰失效、8 其他 API 失敗）而放棄寫入；訊息走 stderr。
|
||||
# 讀不回來就不寫，是為了不拿範本蓋掉一份還在的目錄頁
|
||||
# 註: 本檔以 `. "$ROOT/hooks/lib.sh"` 載入共用函式，沒有接 `|| true`。lib.sh 讀不到時 sh 會
|
||||
# 就地結束並回 2，跟用法錯誤同碼；分不出是哪一種時，先確認 hooks/lib.sh 在不在。
|
||||
#
|
||||
# 頁名:
|
||||
# ERROR_{HASH}，HASH 取「{owner}/{repo} {hook} {時間}」的 SHA-1 前 8 碼（共用 hash 規則）。
|
||||
# 時間放進 hash：同一種失敗再發生時要另開新頁，不覆寫舊紀錄。
|
||||
@@ -110,11 +119,7 @@ fill '{HASH}' "$hash" < "$ROOT/templates/error-page.md" \
|
||||
row=$(printf '| %s | [[%s|%s]] | %s | %s | %s | %s |' \
|
||||
"$ts" "$hook 異常 $ts" "$page" "$repo" "$hook" "$code" "$summary")
|
||||
|
||||
# 目錄頁：已存在就把新列附在文末（最新一筆在最後）；不存在就用範本建立
|
||||
if sh "$gsh" wiki-get "$wrepo" ERROR_CONTENTS > "$tmp_list" 2>/dev/null \
|
||||
&& [ -s "$tmp_list" ]; then
|
||||
printf '%s\n' "$row" >> "$tmp_list"
|
||||
else
|
||||
build_contents() { # 用範本建一份全新的目錄頁；只有確定舊頁不存在時才可以呼叫
|
||||
fill '{yyyy-MM-dd HH:mm:ss}' "$ts" < "$ROOT/templates/error-contents.md" \
|
||||
| fill '{HASH}' "$hash" \
|
||||
| fill '{error title}' "$hook 異常 $ts" \
|
||||
@@ -122,12 +127,34 @@ else
|
||||
| fill '{hook_name}' "$hook" \
|
||||
| fill '{exit_code}' "$code" \
|
||||
| fill '{error_summary}' "$summary" > "$tmp_list"
|
||||
fi
|
||||
}
|
||||
|
||||
# 異常目錄頁一律附加，不整頁覆蓋。頁上每一列都是別人回報的異常，本腳本沒有從別處讀過
|
||||
# 那些列，所以先把舊頁讀回來、把新列附在文末（最新一筆在最後），再整頁寫回。
|
||||
# 這個語意完全靠「讀得回舊內容」撐著，因此依 wiki-get 的結束碼分流：
|
||||
# 0 → 讀到既有內容，附加新列（讀得到但整頁是空的，沒有既有列會被蓋掉，套範本才安全）
|
||||
# 4 → 頁面真的還不存在，只有這個碼可以用範本建立新頁
|
||||
# 7 → 金鑰失效或權限不足，舊內容未知，放棄目錄頁寫入
|
||||
# 8 → 其他 API 失敗，舊內容一樣未知，處置同 7
|
||||
# 為什麼 7 與 8 不能當成「頁面不存在」：拿範本蓋掉一份讀不回來的目錄頁，等於刪光所有既有
|
||||
# 列，而 wiki-put 不做合併、也不留備份，蓋掉就救不回來。
|
||||
sh "$gsh" wiki-get "$wrepo" ERROR_CONTENTS > "$tmp_list" 2>/dev/null
|
||||
get_code=$?
|
||||
contents_skip=''
|
||||
case "$get_code" in
|
||||
0) if [ -s "$tmp_list" ]; then printf '%s\n' "$row" >> "$tmp_list"; else build_contents; fi ;;
|
||||
4) build_contents ;;
|
||||
*) contents_skip=$get_code ;;
|
||||
esac
|
||||
|
||||
if ! sh "$gsh" wiki-put "$wrepo" "$page" "$tmp_page" >/dev/null 2>&1; then
|
||||
echo "[jsc] 寫入 $page 失敗（$wrepo）。" >&2
|
||||
exit 4
|
||||
fi
|
||||
if [ -n "$contents_skip" ]; then
|
||||
echo "[jsc] 讀取 ERROR_CONTENTS 失敗（$wrepo，wiki-get 結束碼 $contents_skip），舊內容未知，不寫目錄頁；$page 已建立。" >&2
|
||||
exit 4
|
||||
fi
|
||||
if ! sh "$gsh" wiki-put "$wrepo" ERROR_CONTENTS "$tmp_list" >/dev/null 2>&1; then
|
||||
echo "[jsc] 寫入 ERROR_CONTENTS 失敗（$wrepo），$page 已建立。" >&2
|
||||
exit 4
|
||||
|
||||
@@ -18,9 +18,9 @@
|
||||
#
|
||||
# 產出: 每筆錯誤附加一行 JSON 到 $JSC_HOME/errors/hooks.jsonl（格式比照 hooks/skill-usage.sh）：
|
||||
# {ts,cli,hook,event,exit,detail,jsc}
|
||||
# jsc 欄位：command 或 stderr 命中 ste100-guard.sh、session-timer.sh、skill-usage.sh、
|
||||
# sdlc-gate.sh、version-guard.sh 任一支就是 true，否則 false。分得出來才用得上——
|
||||
# 非 jsc 的 hook 錯誤不是 jsc 該修的，hooks-install 只回報、不轉 jsc-hooks:repair。
|
||||
# jsc 欄位：command 或 stderr 命中九支 hook 腳本任一支，或命中 jsc-hooks 路徑，就是 true，
|
||||
# 否則 false。分得出來才用得上——非 jsc 的 hook 錯誤不是 jsc 該修的，hooks-install 只回報、
|
||||
# 不轉 jsc-hooks:repair。
|
||||
#
|
||||
# 輸出: 第一行 `status={clean|errors|unavailable} reason=...`（可供程式判讀），
|
||||
# errors 時其後每筆一行人類可讀的繁中摘要（hook 名、退出碼、是否屬 jsc）。
|
||||
@@ -52,7 +52,7 @@ case "$cli" in
|
||||
codex|copilot|antigravity|kiro)
|
||||
printf 'status=unavailable reason=%s\n' "$cli 沒有 hook 結果紀錄，執行期錯誤掃不到"
|
||||
echo "[jsc] $cli：原生紀錄只留工作階段與提示內容，沒有記下 hook 的退出碼與 stderr。"
|
||||
echo "[jsc] $cli：改跑 tools/wire-cli.sh smoke $cli，主動執行五支 hook 驗執行期。"
|
||||
echo "[jsc] $cli：改跑 tools/wire-cli.sh smoke $cli，主動執行九支 hook 驗執行期。"
|
||||
exit 0 ;;
|
||||
esac
|
||||
|
||||
@@ -92,10 +92,16 @@ extract_errors() {
|
||||
}
|
||||
return out
|
||||
}
|
||||
# 判定這筆錯誤是不是 jsc 自己的 hook。腳本名逐支列，再補一條 jsc-hooks 路徑判定：
|
||||
# 接線寫進設定的命令一律走 $JSC_HOME/current/jsc-hooks，路徑本身就是證據，新增 hook 時
|
||||
# 就算忘了補進下面這張清單也還認得出來。認錯邊的代價不對稱——漏認會把 jsc 的錯誤當成
|
||||
# 第三方的，只回報不修正。
|
||||
function is_jsc(t) {
|
||||
if (index(t, "ste100-guard.sh") || index(t, "session-timer.sh") \
|
||||
|| index(t, "skill-usage.sh") || index(t, "sdlc-gate.sh") \
|
||||
|| index(t, "version-guard.sh")) return "true"
|
||||
|| index(t, "version-guard.sh") || index(t, "restart-gate.sh") \
|
||||
|| index(t, "comment-scope.sh") || index(t, "lang-guard.sh") \
|
||||
|| index(t, "write-guard.sh") || index(t, "jsc-hooks")) return "true"
|
||||
return "false"
|
||||
}
|
||||
# 摘要收斂成單行短字串：TSV 欄位不能有 tab，jsonl 欄位不能有裸換行；
|
||||
|
||||
Reference in New Issue
Block a user