Live Status

Schema for SNIPER real-time progress tracking across the project lifecycle.

Properties

Property	Type	Required	Description
protocol	string	Yes	The SNIPER protocol version identifier.
status	string	Yes
current_phase	string	No	The phase currently being executed.
started_at	string	No
updated_at	string	No
phases	array	No	Per-phase status and progress.
stories	array	No	Per-story status tracking for the current protocol run.
gate_results	array	No	Results from completed gate reviews.
next_action	string	No	Description of the next expected action or step.

Full Schema

132 lines

$schema: "https://json-schema.org/draft/2020-12/schema"
$id: "https://sniper.ai/schemas/live-status"
title: Live Status
description: Schema for SNIPER real-time progress tracking across the project lifecycle.
type: object
required:
  - protocol
  - status
properties:
  protocol:
    type: string
    description: The SNIPER protocol version identifier.
  status:
    type: string
    enum:
      - idle
      - running
      - paused
      - completed
      - failed
    description: Overall lifecycle execution status.
  current_phase:
    type: string
    description: The phase currently being executed.
  started_at:
    type: string
    format: date-time
    description: ISO 8601 timestamp of when the lifecycle run started.
  updated_at:
    type: string
    format: date-time
    description: ISO 8601 timestamp of the most recent status update.
  phases:
    type: array
    description: Per-phase status and progress.
    items:
      type: object
      required:
        - name
        - status
        - progress
      properties:
        name:
          type: string
          description: Phase name.
        status:
          type: string
          enum:
            - pending
            - running
            - paused
            - completed
            - failed
          description: Current status of this phase.
        agents:
          type: array
          description: Agents active in this phase.
          items:
            type: object
            required:
              - name
              - status
            properties:
              name:
                type: string
                description: Agent persona name.
              status:
                type: string
                enum:
                  - active
                  - completed
                  - failed
                description: Current status of the agent.
        progress:
          type: number
          minimum: 0
          maximum: 100
          description: Phase completion percentage.
  stories:
    type: array
    description: Per-story status tracking for the current protocol run.
    items:
      type: object
      required:
        - id
        - title
        - status
      properties:
        id:
          type: string
          description: Story identifier (e.g., "001", "002").
        title:
          type: string
          description: Story title.
        status:
          type: string
          enum:
            - pending
            - in_progress
            - completed
            - skipped
          description: Current status of the story.
        assigned_agent:
          type: string
          description: Agent assigned to implement this story.
  gate_results:
    type: array
    description: Results from completed gate reviews.
    items:
      type: object
      required:
        - phase
        - result
        - timestamp
      properties:
        phase:
          type: string
          description: Phase that was reviewed.
        result:
          type: string
          enum:
            - pass
            - fail
          description: Gate review outcome.
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp of when the gate review completed.
  next_action:
    type: string
    description: Description of the next expected action or step.
additionalProperties: false