疑難排解

先看只讀證據#

這些恢復步驟針對的是鎖定版本的 1.1.1 命令面。

別去猜工作區、Task 或遠端是不是健康的。先跑一條和症狀對得上的窄範圍 只讀命令。

ait status --json
ait diff --stat
ait queue summary
ait worktree status --json

把確切的報錯和下一步提示原樣留著。AIT 的決策面是有意把那條能安全推進 或安全檢視目前狀態的命令報出來的。

儲存庫沒有初始化#

在打算作為儲存庫根的目錄下執行 ait init。如果 .ait 目錄已經存在但不 完整，別盲目替換它；先看報錯，只有在確實對得上所報狀況時，才使用那個 有界的修復選項。

某個迴歸需要定位歸屬#

選定修復方案之前，先對最小的有用原始碼範圍跑 ait blame。

ait blame <path> --line <number>

把修復記進新的 sprint 條目和 Task。已完成的沿革仍然是歷史證據。

Task 工作區丟失或過期#

重新物化之前，先查 Task 和 worktree。

ait task audit <task-id>
ait worktree doctor --refresh --json

照著那個 Task 報出來的確切恢復命令走。保留無關的工作區改動，別刪任何 沒被精確認定為 AIT 所有的路徑。

遠端就緒一直卡著#

再跑一次純文字的就緒檢視面，照它寫明的關卡走。

ait workflow ready <change-id> --apply

本地測試透過，替代不了必需的遠端 CI。評審、策略、attestation 或 CI 關 卡掛了，就得一直顯示出來，直到對應的證據被修好為止。

server 或 runner 不可用#

檢查設定的遠端、server 健康狀況、儲存庫索引、runner 相容性，以及儲存庫自己 持有的 CI 入口。別為了繞開故障，就把一個有遠端支撐的 Task 切到另一個 權威上去。

上報時別毀掉證據#

當恢復需要使用者做新決定時，就地停下，保持目前 Task、Snapshot 和 worktree 原樣。報出確切的識別符號、失敗的關卡、命令輸出，以及上一次成功的驗證。