Skip to main content

Module orchestrate

Module orchestrate 

Source
Expand description

Orchestrator configuration helpers (user prompt + presets). Orchestrator configuration and shared helpers.

Structs§

ChangePlanInput
Input required to plan a change.
OrchestrateChangeState
Persisted per-change state (changes/<change-id>.json).
OrchestrateEvent
One record appended to events.jsonl.
OrchestrateGateRecord
One terminal gate result recorded for a change.
OrchestratePreset
One built-in orchestrator preset.
OrchestrateRun
Persisted run.json record for an orchestration run.
OrchestrateRunConfig
Resolved run configuration used to build a RunPlan.
OrchestrateUserPrompt
Parsed orchestrate.md user prompt.
OrchestrateUserPromptFrontMatter
YAML front matter for orchestrate.md.
PlannedChange
Planned execution for a single change.
PlannedGate
One gate in a planned pipeline.
RunPlan
Resolved plan for an orchestration run.

Enums§

FailurePolicy
Run-level behavior when a gate fails.
GateOutcome
Terminal outcome for a gate execution.
GatePolicy
Whether a gate should run or be recorded as skipped.
OrchestrateEventKind
Event kinds written to events.jsonl.
OrchestrateRunStatus
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.json for a previously started orchestrate run.
load_orchestrate_preset
Load a built-in orchestrator preset (embedded YAML).
load_orchestrate_run
Load the persisted run.json record for a previously started orchestrate run.
load_orchestrate_user_prompt
Load .ito/user-prompts/orchestrate.md and 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_parallel selector 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.