Goal Runner

The Goal Runner is the deterministic backend that materializes and dispatches goals. Its entrypoints are scripts/goal-runner/goal-run.ps1 (PowerShell) and scripts/goal-runner/orchestrator_cli.py (Python).

Architecture

Dispatch path

1. goal-run.ps1 -GoalId … is invoked.
2. The PowerShell module forwards to orchestrator_cli.py.
3. orchestrator_cli.py detects whether the goal is goal_type: PROGRAM and routes accordingly.
4. For normal goals, GoalRegistry.materialize is called.
5. Orchestrator.step advances the goal one tick.
6. role_dispatcher.dispatch issues the next task.
7. next_action_router.compute writes the next-action record.
8. The CLI prints a JSON summary.

CLI surface

Command	Purpose
goal-run.ps1	Run or resume a goal.
goal-status.ps1	Print durable state for a goal.
goal-pause.ps1	Pause a goal.
goal-resume.ps1	Resume a paused goal.
goal-cancel.ps1	Cancel a goal.
goal-recover.ps1	Recover from a known failure mode.
goal-doctor.ps1	Detect split-brain runtime.
goal-gate.ps1	List/inspect/approve/reject gates.
program-status.ps1	Read-only program-level snapshot.
ingest-github-review.ps1	Ingest a GitHub review into a gate.

See CLI Reference → for the full operator reference.