Phase Checkpoint

Schema for SNIPER phase checkpoint files that track progress through lifecycle phases.

Properties

Property	Type	Required	Description
protocol	string	Yes	The SNIPER protocol version identifier.
phase	string	Yes	The lifecycle phase this checkpoint belongs to (e.g. discover, plan, implement, review).
timestamp	string	Yes
status	string	Yes
agents	array	No	List of agents participating in this phase.
artifacts_produced	array	No	List of artifacts produced during this phase.
commits	array	No	Git commits made during this phase, used for logical revert.
notes	string	No	Free-form notes about the checkpoint.

Full Schema

117 lines

$schema: "https://json-schema.org/draft/2020-12/schema"
$id: "https://sniper.ai/schemas/checkpoint"
title: Phase Checkpoint
description: Schema for SNIPER phase checkpoint files that track progress through lifecycle phases.
type: object
required:
  - protocol
  - phase
  - timestamp
  - status
properties:
  protocol:
    type: string
    description: The SNIPER protocol version identifier.
  phase:
    type: string
    description: The lifecycle phase this checkpoint belongs to (e.g. discover, plan, implement, review).
  timestamp:
    type: string
    format: date-time
    description: ISO 8601 timestamp of when this checkpoint was recorded.
  status:
    type: string
    enum:
      - in_progress
      - completed
      - failed
    description: Current status of the phase.
  agents:
    type: array
    description: List of agents participating in this phase.
    items:
      type: object
      required:
        - name
        - status
        - tasks_completed
        - tasks_total
      properties:
        name:
          type: string
          description: Agent persona name.
        status:
          type: string
          enum:
            - active
            - completed
            - failed
          description: Current status of the agent.
        tasks_completed:
          type: integer
          minimum: 0
          description: Number of tasks the agent has completed.
        tasks_total:
          type: integer
          minimum: 0
          description: Total number of tasks assigned to the agent.
  gate_result:
    oneOf:
      - type: "null"
      - type: object
        required:
          - result
          - blocking_failures
        properties:
          result:
            type: string
            enum:
              - pass
              - fail
            description: Overall gate review result.
          blocking_failures:
            type: integer
            minimum: 0
            description: Number of blocking check failures.
    description: Gate review result, or null if the gate has not been run yet.
  artifacts_produced:
    type: array
    description: List of artifacts produced during this phase.
    items:
      type: object
      required:
        - path
        - status
      properties:
        path:
          type: string
          description: File path of the produced artifact.
        status:
          type: string
          enum:
            - draft
            - complete
          description: Whether the artifact is a draft or complete.
  commits:
    type: array
    description: Git commits made during this phase, used for logical revert.
    items:
      type: object
      required:
        - sha
        - message
        - agent
      properties:
        sha:
          type: string
          description: Git commit SHA.
        message:
          type: string
          description: Commit message.
        agent:
          type: string
          description: Agent that produced this commit.
  notes:
    type: string
    description: Free-form notes about the checkpoint.
additionalProperties: false