失败、document_gap 与质量检查

失败是可审计的终态或阻塞态。每次失败都保留阶段、时间、命令/响应、错误文本和 已写入的 registry，不通过重试隐藏原因。

阶段对应关系

执行阶段包括 plan_failed、submit_failed、upstream_failed、finalize_failed 和 downstream_failed；创作阶段包括 draft_failed、build_failed、test_failed、 publish_failed、register_failed 和 verification_failed。失败阶段不能跳回成功 阶段；只有重新开始一个新的、独立的工作区才可重做。

document_gap

当 AI docs 不可用（包括本次入口 404）或缺少决定所需的信息时，登记：

• topic：正在判断的主题；
• attempted_document_ids：已尝试的文档 ID；
• missing_information：缺失的字段、规则或示例；
• blocking_reason：为什么当前动作不能安全继续。

同时设置 detected: true、workflow.phase: document_gap 和 status: blocked， 停止在该阶段。不能用旧页面、记忆或隐含默认值填补缺口；获得新的权威文档后， 再由用户决定是否重开工作区。

交付前检查

1. 两个 registry 的 lane、schema_version、路径根和文档来源正确，字段没有跨车道混入。
2. 执行计划在 Job create 前已确认；创作 build/publish/register 各有独立确认记录。
3. tested 只代表静态验证通过：Tool/Tool Version 检查 config、双语 summary、命令字段和资源； Flow 检查精确节点 Tool 定义、端口、必需输入、参数、DAG、method 与 sourceGraph 读回。
4. 所有 ID 来自 fkit 响应并完成 list/config/summary/inspect read-back。
5. 下游准备精确 NAME:VERSION，验证双语 summary 与空 config command 后再 pull；网络为 none，stage 和任务 reproducibility 只读，脚本、镜像身份、日志和结果完整可追溯。