feat(接線): status 加 --verdict,把狀態與成敗兩種語意分開
status 的結束碼帶的是狀態:0 是接好、1 是接好但這支 CLI 做不到、5 是有東西 沒接。那是給人看的三分法,本身沒有錯。 問題出在被當成檢查用。助理的內建檢查項照結束碼判成敗,非零就是那一筆失敗、 失敗次數加一。於是有先天限制的那一支 CLI 每一輪都讓那一筆失敗一次,一天 96 次,而沒有人修得動——那支 CLI 擋不下技能叫用是它的架構限制,不是接線缺漏, 16 個接線項目全部就位。 那個計數存在的理由是指出「有一筆壞掉的項目每輪重試而沒人知道」。被一個修不動 的數字填滿,就等於用假的壞掉把真的壞掉蓋掉。 修在這一邊而不是修在讀的那一邊:狀態與成敗是兩種語意,混在同一個通道上才是 根因。這個旗標把成敗那一種單獨拉出來,status 保持原樣給人看。 --verdict 之下輸出一字不變——degraded 那一行照印,人看得到——只有結束碼換一套 語意:該接的都接了就回 0,先天限制不算;真的缺項目照樣回 5。 只有 status 收這個旗標,別的子命令帶了回 2:另外三個子命令的結束碼本來就是 成敗語意,多一個旗標只會讓人以為它們也有兩套。 實測:五支 CLI 兩種模式各跑一次,只有帶先天限制那一支從 1 變 0;輸出逐字 相同;暫時拿掉一個接線項目之後 --verdict 回 5,還原後回 0;旗標的三條錯誤 路徑都回 2。 三份 manifest 版號 0.4.4 升到 0.4.5。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "jsc-hooks",
|
||||
"version": "0.4.4",
|
||||
"version": "0.4.5",
|
||||
"description": "跨 CLI hooks:STE100 語言強制、工時計時、技能用量記錄、SDLC 模型鎖、版本前置檢查、註解範圍守門、繁中編碼守門、部署後強制重啟、寫入與提交閘門",
|
||||
"skills": "./skills",
|
||||
"author": {
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"hooks": "./hooks/codex-hooks.json",
|
||||
"name": "jsc-hooks",
|
||||
"version": "0.4.4",
|
||||
"version": "0.4.5",
|
||||
"description": "跨 CLI hooks:STE100 語言強制、工時計時、技能用量記錄、SDLC 模型鎖、版本前置檢查、註解範圍守門、繁中編碼守門、部署後強制重啟、寫入與提交閘門",
|
||||
"skills": "./skills",
|
||||
"jsc": {
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "jsc-hooks",
|
||||
"version": "0.4.4",
|
||||
"version": "0.4.5",
|
||||
"description": "跨 CLI hooks:STE100 語言強制、工時計時、技能用量記錄、SDLC 模型鎖、版本前置檢查、註解範圍守門、繁中編碼守門、部署後強制重啟、寫入與提交閘門",
|
||||
"skills": "./skills/",
|
||||
"jsc": {
|
||||
|
||||
+34
-2
@@ -4,7 +4,9 @@
|
||||
# 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 status {claude|codex|copilot|antigravity|kiro} 唯讀盤點接線現況,不寫檔也不執行 hook
|
||||
# wire-cli.sh status {claude|codex|copilot|antigravity|kiro} [--verdict]
|
||||
# 唯讀盤點接線現況,不寫檔也不執行 hook。
|
||||
# --verdict 只換結束碼語意,輸出一字不變
|
||||
#
|
||||
# JSC_READONLY=1 時只准 status 與 smoke,purge 與接線一律拒絕並回 exit 6。體檢類技能全程帶著
|
||||
# 這個變數跑,「子命令打錯一個字就重新接線或刪檔」的風險就由程式擋掉,不靠呼叫端自我約束。
|
||||
@@ -128,6 +130,9 @@
|
||||
# 結束碼(purge): 0=purged 2=用法錯誤 3=skipped 4=failed
|
||||
# 結束碼(smoke): 0=ok 2=用法錯誤 4=failed(含結果行數與預期不符)
|
||||
# 結束碼(status): 0=wired 1=degraded 2=用法錯誤 3=skipped 5=unwired(該接的段落缺了至少一項)
|
||||
# 結束碼(status --verdict): 0=該接的都接了(含 degraded——先天限制不算缺漏)
|
||||
# 2=用法錯誤 3=skipped 5=unwired
|
||||
# 給拿結束碼判成敗的呼叫端用,例如助理的內建檢查項。理由見下方 --verdict 那一段。
|
||||
# 結束碼(唯讀模式): 6=readonly(JSC_READONLY=1 之下拒絕 purge 與接線),status 與 smoke 不受影響
|
||||
# status 之外的動作都會寫檔,體檢類技能(/jsc-cli:doctor)只能呼叫 status。判讀邏輯跟接線
|
||||
# 共用同一組檔案位置與標記字串,分兩份實作就會各自漂移,體檢說沒接、實際上接著。
|
||||
@@ -169,6 +174,30 @@ case "$cli" in
|
||||
claude|codex|copilot|antigravity|kiro) ;;
|
||||
*) usage ;;
|
||||
esac
|
||||
shift 2>/dev/null || true
|
||||
|
||||
# --verdict:輸出一字不變,只有結束碼換一套語意——該接的都接了就回 0,先天限制不算。
|
||||
#
|
||||
# 為什麼要有這個旗標。status 的結束碼帶的是狀態:0 是接好、1 是接好但這支 CLI 做不到、
|
||||
# 5 是有東西沒接。那是給人看的三分法,也是對的。問題出在被當成檢查用:助理的內建檢查項
|
||||
# 照結束碼判成敗,非零就是那一筆失敗、失敗次數加一。
|
||||
# 於是有先天限制的那一支 CLI 每一輪都讓那一筆失敗一次,一天 96 次,而沒有人修得動——
|
||||
# 那支 CLI 擋不下技能叫用是它的架構,不是接線缺漏,16 個接線項目全部就位。
|
||||
# 那個計數存在的理由是指出「有一筆壞掉的項目每輪重試而沒人知道」,被這樣填滿就等於用
|
||||
# 一個修不動的數字把真的壞掉蓋掉。
|
||||
# 修在這裡而不是修在讀的那一邊:狀態與成敗是兩種語意,混在同一個通道上才是根因。這個
|
||||
# 旗標把成敗那一種單獨拉出來,`status` 保持原樣給人看。
|
||||
VERDICT_ONLY=0
|
||||
while [ "$#" -gt 0 ]; do
|
||||
case "$1" in
|
||||
--verdict) VERDICT_ONLY=1; shift ;;
|
||||
*) usage ;;
|
||||
esac
|
||||
done
|
||||
case "$action:$VERDICT_ONLY" in
|
||||
status:1|*:0) ;;
|
||||
*) printf '[jsc] --verdict 只有 status 用得到,%s 不收這個旗標。\n' "$action" >&2; exit 2 ;;
|
||||
esac
|
||||
|
||||
# 唯讀契約在程式層把關,不靠呼叫端記得只打 status。子命令解析完就判:預設動作是接線,
|
||||
# 所以少打一個子命令就會直接改環境,這個判定要擋的正是那一次手滑。
|
||||
@@ -2519,7 +2548,10 @@ if [ "$action" = status ]; then
|
||||
fi
|
||||
if [ -n "$st_degrade" ]; then
|
||||
printf 'status=degraded reason=%s\n' "$st_degrade"
|
||||
cat "$st_items"; rm -f "$st_items"; exit 1
|
||||
cat "$st_items"; rm -f "$st_items"
|
||||
# --verdict 之下先天限制不算失敗:輸出照印,讓人看得到,但結束碼說「該接的都接了」。
|
||||
[ "$VERDICT_ONLY" -eq 1 ] && exit 0
|
||||
exit 1
|
||||
fi
|
||||
printf 'status=wired reason=%s\n' "$st_wired"
|
||||
cat "$st_items"; rm -f "$st_items"; exit 0
|
||||
|
||||
Reference in New Issue
Block a user