jiantw83
04225a7a2d
共用函式庫與各支腳本的檔頭各補一段結束碼宣告，逐個子命令寫明哪些情況放行、 哪些情況擋下。說明文件改寫成九支 hook 的現況，補上寫入與提交閘門、唯讀模式、 建議子命令與新的環境變數。異常目錄範本補上「一律附加、不整頁覆蓋」的寫入語意。 呼叫端要靠結束碼決定下一步，但多數腳本只寫用法、沒寫結束碼， 讀的人得自己翻程式碼推，推錯就把安靜降級當成失敗處理。 共用函式庫載不到時，殼層會就地結束並回非零，接在工具呼叫前的閘門遇到這一下 等於無聲擋人，腳本自己的放行路徑一條都跑不到，這件事非寫進每一支檔頭不可。 文件停在八支 hook 的舊敘述，看的人會誤判覆蓋範圍，以為每支 CLI 都擋得住。 目錄頁的寫入語意只寫在腳本裡，換一支工具來寫就會整頁覆蓋。 一支腳本一段檔頭，逐子命令列出結束碼，並各自註明共用函式庫載入失敗會回哪一個碼。 文件的行數一律引用腳本自己印出來的那一行，不另抄一份數字， 判定路徑增減時就不會漂移。覆蓋範圍逐支 CLI 分開寫，接不上的就寫接不上。
58 lines
3.4 KiB
Bash
Executable File
58 lines
3.4 KiB
Bash
Executable File
#!/usr/bin/env sh
|
||
# session-timer.sh — 記錄工作階段花費時間（供 jsc-log:worklog 取用）。
|
||
# 用法:
|
||
# session-timer.sh start # SessionStart：記錄起始時間（已有紀錄就不動）
|
||
# session-timer.sh restart # SessionStart：一律覆寫起始時間
|
||
# session-timer.sh mark # Stop/SessionEnd：更新最後活動時間
|
||
# session-timer.sh report [sid] # 印出 {sid} {seconds}；無紀錄印 0
|
||
#
|
||
# 結束碼：0=一律成功，四個子命令都走到最後那一行 exit 0，不認得的子命令也一樣（case 沒有
|
||
# 相符分支就直接落到那一行）。這支接在 SessionStart 與 Stop／SessionEnd 上，本來就不擋人：
|
||
# 狀態檔寫不進去只是少一筆計時，report 讀不到起始時間就印 0，都照樣 exit 0。
|
||
# 唯一的非零來源是 lib.sh 載入失敗：本檔以 `. "$HERE/lib.sh"` 載入，沒有接 `|| true`，
|
||
# 檔案不在時 sh 會就地結束並回 2。這兩個事件不擋工具呼叫，回 2 只會在宿主留下一筆 hook 錯誤。
|
||
#
|
||
# start 與 restart 的差別在「同一個 session id 會不會重複開始」：
|
||
# start 給 Claude 這種每個工作階段都有自己 session id 的 CLI。續接同一階段時
|
||
# SessionStart 會再觸發一次，覆寫起始時間會讓花費時間歸零。
|
||
# restart 給接不到 session id 的 CLI（kiro）。那些 CLI 的紀錄共用 default，
|
||
# 不覆寫就會把上一個工作階段的起始時間算進來，花費時間虛胖。
|
||
#
|
||
# 這兩個子命令另外兼一件事：判定為「新的工作階段」時清除部署後的重啟閘門
|
||
# （restart-gate.sh clear）。新工作階段代表 CLI 行程是新起的，新版技能組一定已經載入。
|
||
# 判準只有這裡知道——start 分支的「起始檔不存在」就是這個 session id 第一次開始，
|
||
# 所以清除掛在這裡，不在 restart-gate.sh 裡自己再判一次。
|
||
# 清除的範圍是「跑到這一支腳本的那個 CLI 自己那一份狀態檔」，由 restart-gate.sh clear 認定，
|
||
# 這裡不必也不能過問：這個工作階段開始的只有一支 CLI，別支沒重啟，閘門要留著。
|
||
HERE=$(dirname "$0"); . "$HERE/lib.sh"
|
||
read_stdin
|
||
sid=$(session_id)
|
||
|
||
# 放下這一支 CLI 的部署後重啟閘門。狀態檔的路徑、範圍與格式只留在 restart-gate.sh，
|
||
# 這裡不碰檔案，所以改成一支 CLI 一份狀態檔之後這裡不用跟著改。
|
||
# 一律 </dev/null：clear 不讀標準輸入，但這裡的標準輸入是宿主餵進來的管線，不關掉會卡住。
|
||
clear_restart_gate() {
|
||
sh "$HERE/restart-gate.sh" clear </dev/null 2>/dev/null || true
|
||
}
|
||
|
||
case "${1:-mark}" in
|
||
start)
|
||
f="$JSC_HOME/sessions/$sid.start"
|
||
if [ ! -f "$f" ]; then
|
||
now_epoch > "$f"
|
||
clear_restart_gate # 起始檔不存在＝這個工作階段第一次開始，也就是行程新起的那一次
|
||
fi ;;
|
||
restart)
|
||
now_epoch > "$JSC_HOME/sessions/$sid.start"
|
||
rm -f "$JSC_HOME/sessions/$sid.end"
|
||
clear_restart_gate ;; # 接不到 session id 的 CLI 每次工作階段開始都算新的，一律清
|
||
mark)
|
||
now_epoch > "$JSC_HOME/sessions/$sid.end" ;;
|
||
report)
|
||
rsid="${2:-$sid}"
|
||
s=$(cat "$JSC_HOME/sessions/$rsid.start" 2>/dev/null || echo "")
|
||
e=$(cat "$JSC_HOME/sessions/$rsid.end" 2>/dev/null || now_epoch)
|
||
if [ -n "$s" ]; then echo "$rsid $((e - s))"; else echo "$rsid 0"; fi ;;
|
||
esac
|
||
exit 0
|