getDomain/docs/schemas/ops_go_live_bundle_contract.md

ops_go_live_bundle_contract

目标

把发布前证据包与 manifest.json 复核结论压成一份统一 contract，供：

• Ops Center 交付面板
• CLI go-live-export / go-live-review
• 海外 Codex 驾驶员

共同消费。

它解决的问题不是“现在能不能上线”，而是：

现在有没有一份足够完整、足够可信、可交付可复盘的上线证据包

主接口

• GET /api/v1/ops/go-live-bundle

核心字段

• status
  • missing
  • ready
  • attention
  • blocked
• status_label
• headline
• bundle_available
• report_dir
• manifest_path
• artifact_total
• failure_total
• critical_failures
• noncritical_failures
• env_audit
• summary
• recommended_commands

判定原则

• 如果当前还没有 bundle / manifest
  • status = missing
• 如果 manifest 明确标记 review_status_hint=blocked
  • status = blocked
• 如果 manifest 已存在，但：
  • 仍有非关键失败
  • 环境审计提示 attention
  • launchpad 摘要存在漂移
  • 则 status = attention
• 只有当 manifest 可读、review 为 ready、关键摘要一致
  • 才允许 status = ready

设计约束

• 页面不直接触发 shell 导出 bundle
• 后端默认只读最新 bundle / manifest，不负责替代 CLI 执行导出
• 当 bundle 缺失时，必须明确给出固定命令，而不是让操作者自己猜路径