Checkpoint 对象

​

字段

​

合法示例

apiVersion: huoban.dev/v1alpha1
kind: Checkpoint
metadata:
  name: idea-to-spec-review-001-direction
spec:
  runRef:
    name: idea-to-spec-review-001
  stage: sharpen-idea
  reason: ConfirmDirectionBeforeSpec
  requiredActions:
    - approve
    - requestChanges
    - reject
  artifactRefs:
    - name: review-notes
status:
  phase: Pending
  conditions:
    - type: CheckpointRequired
      status: "True"
      reason: HumanDesignDecisionRequired

​

当前 CLI 行为

• validate 检查对象形状、动作枚举和 Artifact 引用形状。
• explain 输出 runRef、stage、reason、required actions、Artifact refs 和通用 conditions。
• 当前 Preflight 不收集独立 Checkpoint 对象，不解析其 runRef、stage 或 Artifact refs。
• Lifecycle schema 提供 checkpoint.requested 与 checkpoint.resolved 事件名，但当前仓库没有 dispatcher。

​

验证边界

• local runRef schema 只要求 name；它不会强制 kind: Run 或目标存在。
• schema 不检查 stage 是否属于 Run 引用的 Flow。
• schema 不检查 Artifact 是否来自同一 Run 或 stage。
• schema 不定义 status.phase 的 Pending/Approved/Rejected 状态机。
• expiresAt 只验证为字符串，不检查过期行为。

​

相邻概念边界

​

常见错误

• 把 requiredActions 当成已经发生的 action。
• 发明 schema 未定义的 decision 或 resolvedBy spec 字段。
• 声称当前 CLI 会验证 stage、Run、Artifact 的关系。
• 用 PreflightReady=True 替代 Checkpoint 审批。
• 把 Policy 规则内联到 Checkpoint。
• 假设 expiresAt 已由 runtime 强制执行。