| Runner 执行的 engine 代码比配置的 source 通道旧(2026-09-07 事故) | 两层启动防线:服务的 ExecStartPre 步骤在 Runner 进程存在之前同步 engine checkout;Runner 自己的 source 新鲜度门禁检查进程实际 import 的代码 | 记录 runner_source_stale 并退出,不占 slot、不 claim、不改 label。仅主机可设的 allow_stale_runner 会把它降级为警告。 | tests/test_runner_source_freshness.py::test_real_tick_with_a_stale_source_exits_before_any_slot, tests/test_systemd_timer.py::test_service_syncs_the_engine_source_channel_before_the_runner_starts |
经 Issue 正文、diff 或评审者读到的评论注入的 REVIEW_VERDICT 行 | Verdict 解析器:被引用或被提及的 verdict 不算 verdict 行,出现两个不同的 verdict 行时拒绝 | 以评审者自己的结论 verdict 为准;verdict 互相冲突时本轮失败,不会任选其一 | tests/test_review_verdict.py::test_parse_review_verdict_last_line_beats_injected_marker, tests/test_review_verdict.py::test_parse_review_verdict_rejects_conflicting_verdicts |
| clean verdict 指向的 head 不是正在审查的 head | Verdict 携带被审查的 head SHA,并与它绑定 | 不调用 merge 门禁;本轮失败,交付保持可恢复 | tests/test_review_verdict.py::test_parse_review_verdict_requires_head, tests/test_review_merge.py::test_review_and_merge_verdict_head_mismatch_real_commit_is_recoverable |
| PR head 在审查和 merge 之间发生变化 | Merge 门禁重新读取 PR;gh pr merge --match-head-commit 锁定被审查的 head | 以 head moved since review 拒绝;merge 落地的只会是被审查的 head | tests/test_review_merge.py::test_merge_gate_rejects_head_that_moved_since_review, tests/test_review_merge.py::test_merge_gate_merges_reviewed_head_with_match_head_commit |
| clean review 之后 base 分支前进 | Merge 门禁重新 fetch base,并要求 head 包含它 | 用普通 merge 吸收无冲突的 base、推送,并把 merge 推迟到之后的 tick,先读取新 head 的 CI。这是 Runner 自己的更新,不是违规。base 有冲突时交付保持可恢复。 | tests/test_git_merge_smoke.py::test_merge_gate_absorbs_clean_behind_base_then_defers, tests/test_git_merge_smoke.py::test_merge_gate_conflicted_absorb_stays_recoverable |
| 被审查 head 的 CI 失败或仍在运行 | Merge 门禁读取 GitHub 上该 head 的检查 | CI 失败时门禁失败;CI 未完成时把 merge 推迟到下一个 tick。两种情况都不 merge。 | tests/test_review_merge.py::test_merge_gate_rejects_failed_github_ci, tests/test_review_merge.py::test_merge_gate_defers_when_ci_pending |
| 公开评论携带格式完整的恢复现场,试图操纵 resume | 可信评论过滤:只读取对该仓库有 write 或 admin 权限的作者,以及 Runner 自己的账号;不使用评论的 authorAssociation | 绝不采用该现场。没有可信现场时 Issue 变为 ai-blocked,tick 继续。 | tests/test_resume_e2e.py::test_e2e_public_comment_scene_is_never_resumed, tests/test_github.py::test_comment_is_trusted_by_repository_permission_and_by_bot_login |
仓库的 .github/orbi.toml 声明了仅主机可设的 key | 仓库配置解析器:按名字拒绝 host-only key,只接受交付策略 key | 停止 claim,在 Issue 上报告违规的 key,Issue 变为 ai-blocked。无法识别的 key 则只是被忽略并给出警告。 | tests/test_repo_config.py::test_parse_repo_config_rejects_host_only_keys, tests/test_repo_config.py::test_main_blocks_a_claim_when_the_repo_config_is_invalid, tests/test_blocked_comment.py::test_repo_config_blocked_ends_with_the_help_line |
| agent 会话自己 merge 或 push 受保护分支 | Prompt 契约要求实现者和评审者不这样做;真正执行拦截的是 GitHub branch protection 和 ruleset | 没有动作:Runner 不拦截 agent 会话内部发起的 push | (no test) |
| 审查与修复循环永不结束 | 每次交付五轮的预算(不可信评论无法改变它),加上相同失败的防护 | 第六轮不会开始:交付离开自动循环,变为 ai-blocked,等待人的决定。同一个失败连续三个 tick 出现也会升级为 ai-blocked。人工恢复后开始新的预算。 | tests/test_fix_needed_loop.py::test_review_rounds_exhausted_raises_unrecoverable, tests/test_fix_needed_loop.py::test_delivery_step_unrecoverable_failure_marks_blocked_with_reason, tests/test_fix_needed_loop.py::test_report_failure_three_identical_ticks_escalate_the_dead_loop, tests/test_comment_identity.py::test_untrusted_history_cannot_change_the_review_budget |
| 模型请求挂死:已被接受但一直没有回答,或从未被调度 | 会话监视:model_wait_dead 阈值,以及可选的 /slots 探测(用于模型服务吞掉的请求) | 杀掉 Pi 会话,记录 model_wait_dead 或 model_wait_swallowed 以及 run_failed。交付保持可恢复:Issue 保留 ai-in-progress,下一个 tick 恢复同一个 run。模型慢但仍在产生事件时不会被杀。 | tests/test_bootstrap_pi.py::test_stream_pi_frozen_model_wait_at_default_kills_with_configured_threshold, tests/test_bootstrap_pi.py::test_stream_pi_swallowed_model_request_killed_fast, tests/test_bootstrap_pi.py::test_stream_pi_frozen_model_wait_just_before_default_survives, tests/test_bootstrap_runner_outcome.py::test_process_issue_model_wait_dead_failure_stays_in_progress |