Component Architecture

This page is a tour of the canonical Python modules under scripts/goal-runner/.

Module responsibilities

Module	Responsibility
`orchestrator.py`	Per-step dispatch and state transitions.
`orchestrator_cli.py`	The CLI entrypoint (`goal-run.ps1` → this).
`goal_registry.py`	Materializes contracts into the runtime store.
`program_controller.py`	Coordinates IMPs across the program.
`program_driver.py`	Delegates child goal execution.
`program_driver_cli.py`	Program Goal CLI seam.
`runtime_store.py`	SQLite-backed state API.
`state_machine.py`	Foundation-artifact terminalization rule.
`next_action_router.py`	Computes the next dispatch record.
`receipt_writer.py`	Persists task receipts.
`scoped_owner_gate.py`	Gate scope / source / approver validation.
`owner_gate_manager.py`	Gate CRUD helpers.
`goal_gate_cli.py`	The `goal-gate.ps1` CLI.
`signed_ticket_schema.py`	Ticket payload schema.
`signed_ticket_verifier.py`	`ssh-keygen -Y verify` wrapper.
`audit_integrity.py`	SHA1 validation, deviation accounting.
`adapters/*`	Adapter implementations.