Orch State

orch-state

State inspection skill: reduce event log to OrchState, print summaries, query current phase.

scripts/reduce.py

Replays all events and prints the full OrchState as a JSON object. Exit 0 on success, 1 on error.

python3 .claude/skills/orch-state/scripts/reduce.py

Output schema (top-level keys):

| Key | Type | Description | |-----|------|-------------| | workflow_id | string\|null | Workflow identifier | | run_status | string | active, escalated, etc. | | current_phase | string\|null | Active phase name | | tasks | object | Map of task_id → TaskState | | phases | object | Map of phase name → PhaseState | | escalation | object\|null | Escalation payload if present | | circuit_breaker | object\|null | Circuit breaker state if present | | last_seq | int | Last event seq processed | | last_snapshot_seq | int | Seq of last snapshot event |

scripts/summary.py

Prints a human-readable summary to stdout. Not JSON — intended for operator inspection.

python3 .claude/skills/orch-state/scripts/summary.py

Example output:

Workflow : wf_001
Status   : active
Phase    : dev
Last seq : 42

Tasks
─────
  pending              ████████░░░░░░░░░░░░    4 / 10
  completed            ██████████████░░░░░░    7 / 10

Tasks by phase
──────────────
  dev                  pending=4, completed=6

Phases
──────
  ▶ 1. dev                  active
    2. qa                   pending

scripts/current_phase.py

Prints the current phase and its status as JSON. Exit 0 always (errors also JSON).

python3 .claude/skills/orch-state/scripts/current_phase.py

Output when a phase is active:

{"current_phase": "dev", "status": "active", "order": 1}

Output when no phase has been entered:

{"current_phase": null, "status": null}

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: zig999
• Source: zig999/siegard-code
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.