故障排查

先看只读证据#

这些恢复步骤针对的是锁定版本的 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 原样。报出确切的标识符、失败的关卡、命令输出，以及上一次成功的验证。