Expand description
Orchestrator configuration helpers (user prompt + presets). Orchestrator configuration and shared helpers.
Structs§
- Change
Plan Input - Input required to plan a change.
- Orchestrate
Change State - Persisted per-change state (
changes/<change-id>.json). - Orchestrate
Event - One record appended to
events.jsonl. - Orchestrate
Gate Record - One terminal gate result recorded for a change.
- Orchestrate
Preset - One built-in orchestrator preset.
- Orchestrate
Run - Persisted
run.jsonrecord for an orchestration run. - Orchestrate
RunConfig - Resolved run configuration used to build a
RunPlan. - Orchestrate
User Prompt - Parsed
orchestrate.mduser prompt. - Orchestrate
User Prompt Front Matter - YAML front matter for
orchestrate.md. - Planned
Change - Planned execution for a single change.
- Planned
Gate - One gate in a planned pipeline.
- RunPlan
- Resolved plan for an orchestration run.
Enums§
- Failure
Policy - Run-level behavior when a gate fails.
- Gate
Outcome - Terminal outcome for a gate execution.
- Gate
Policy - Whether a gate should run or be recorded as skipped.
- Orchestrate
Event Kind - Event kinds written to
events.jsonl. - Orchestrate
RunStatus - High-level run status persisted in
run.json.
Constants§
- GATE_
IMPLEMENTATION_ READINESS - Non-skippable gate proving a dispatch checkout is based on accepted main.
Functions§
- append_
orchestrate_ event - Append an event to
events.jsonl. - build_
run_ plan - Build a dependency-aware run plan.
- default_
gate_ order - Default orchestrator gate order.
- ensure_
implementation_ readiness_ first - Return a gate order with implementation readiness present exactly once at the front.
- generate_
orchestrate_ run_ id - Generate a sortable run id in the form
YYYYMMDD-HHMMSS-<short-uuid>. - init_
orchestrate_ run_ state - Initialize the on-disk run state directory and write
run.json+plan.json. - list_
orchestrate_ presets - List the names of all embedded orchestrator presets.
- load_
orchestrate_ change_ state - Load the per-change state file if present.
- load_
orchestrate_ plan - Load the resolved
plan.jsonfor a previously started orchestrate run. - load_
orchestrate_ preset - Load a built-in orchestrator preset (embedded YAML).
- load_
orchestrate_ run - Load the persisted
run.jsonrecord for a previously started orchestrate run. - load_
orchestrate_ user_ prompt - Load
.ito/user-prompts/orchestrate.mdand parse its front matter + sections. - orchestrate_
readiness_ gate_ record - Convert a shared readiness report into a persisted orchestration gate result.
- parse_
max_ parallel - Resolve a
max_parallelselector into an integer concurrency limit. - remaining_
gates_ for_ change - Compute remaining gates for a change when resuming an interrupted run.
- remediation_
packet_ for_ failure - Construct a remediation packet for a specific gate failure.
- write_
orchestrate_ change_ state - Write the per-change state file.