 jiantw83
|
9377c2fbc7
|
feat(config-spec): 設定規格表補上重啟閘門、兩份指引與四項既有設定共九列
What：`tools/config-spec.tsv` 新增九列。這次新增的五項：`JSC_RESTART_GATE`、`JSC_WIKI_REPO_SKILLSET`、`$JSC_HOME/update-guide.md`、`$JSC_HOME/remove-guide.md`、`$JSC_HOME/restart-required`；補登既有但漏列的四項：`JSC_LANG_GUARD`、`JSC_COMMENT_SCOPE`、`JSC_CHANGED_FILE`、`JSC_SIMPLIFIED_FILE`。
Why：這一份是體檢與設定共用的唯一規格表，`scan-config.sh` 與 `/jsc-cli:doctor` 都讀它。沒登錄的設定項體檢查不到，等於機器上有一批設定沒人管；`orphans` 那一側也對不起來。準則寫的「新增設定時要同步補一列」就是為了這件事。
How：兩份指引標 `manual`，缺了就重跑 `/jsc-cli:deploy`，不由體檢自動補。`$JSC_HOME/restart-required` 與 `JSC_CHANGED_FILE`、`JSC_SIMPLIFIED_FILE` 都是執行期暫態，驗證與修法欄一律標 `none` 與 `-`：不存在是正常狀態，標成必要項會讓體檢把「沒有待重啟的部署」誤判成缺失。三個 `off` 開關（`JSC_RESTART_GATE`、`JSC_LANG_GUARD`、`JSC_COMMENT_SCOPE`）預設值一律寫 `on`，說明欄講明什麼情況才關。九列的欄位數與既有列一致為 8 欄。
Who：`scan-config.sh`、`/jsc-cli:doctor` 的執行環境體檢與 `/jsc-cli:setup` 的引導設定。
|
2026-08-27 16:34:16 +08:00 |
|
|
jiantw83
|
ffff2152c2
|
feat(config-spec): 登錄 JSC_PR_WATCH_INTERVAL 設定項
What：`tools/config-spec.tsv` 新增一列 `JSC_PR_WATCH_INTERVAL`：型別 `env`、全域、非必填、預設 `60`、檢查方式 `set`、缺少時 `ask`，說明寫明它是 `pr-watch.sh` 輪詢 PR 狀態的間隔秒數，實作在 `jsc-gitea/tools/pr-watch.sh`。
Why：設定規格表是 jsc 環境變數的清單正本，`jsc-cli` 的部署與體檢都讀它。新變數沒登錄進來，體檢就看不到它，使用者也無從得知有這個旋鈕可以調。
How：只加一列，排在同為 `jsc-hooks` 系列旋鈕的 `JSC_VERSION_TTL` 之後，欄位順序與既有各列相同；說明點名實作位置，讀表的人才知道去哪裡查行為。
Who：`jsc-cli:deploy` 與環境體檢，以及要調整盯 PR 頻率的使用者。
|
2026-08-27 11:20:30 +08:00 |
|
|
jiantw83
|
2adf9a172e
|
feat(doctor): 新增執行環境體檢技能
What: 新增 jsc-cli:doctor，一次體檢技能版本、Hook 接線、全域設定與自我設定，只讀不改，結果寫進 wiki CHECK_{HASH}。
Why: 安裝或更新技能組之後，沒有任何工具說得出這台機器還缺什麼。設定散在環境變數、rc 檔與專案目錄，出錯時只能一個一個猜。
How: 版本比對複用 jsc-hooks 的 version-guard.sh report，接線狀態複用新加的 wire-cli.sh status（唯讀），設定則由 tools/scan-config.sh 比對 tools/config-spec.tsv 判定必要或選擇。規格表是必要性的唯一判準，掃描只負責抓出漏登錄的變數。
Who: 體檢與修復流程，搭配 jsc-cli:setup 收尾。
|
2026-08-26 10:43:37 +08:00 |
|