Configuration Reference
This page lists the configuration surfaces ASF50 reads at runtime. Only include values proven current; do not invent.
Goal contract fields
| Field | Type | Required | Purpose |
|---|---|---|---|
goal_id | string | yes | Unique goal identifier. |
parent_goal_id | string | yes | Parent goal (program or program-derived). |
goal_type | enum | yes | PROGRAM, IMPLEMENTATION_PHASE, INDEPENDENT_CODE_AUDIT, INDEPENDENT_REAUDIT, REPAIR_GOAL, DOCUMENTATION_PORTAL. |
current_state | enum | yes | One of the canonical states. |
required_role | enum | yes | Role required for the next dispatch. |
audit_target | string | yes (for auditor) | 40-char SHA or empty. |
worktree_policy | object | yes | mode, source_commit. |
clean_checkout_policy.required | bool | yes | Whether the worktree must be clean. |
allowed_paths | list | yes | Globs the goal may modify. |
forbidden_paths | list | yes | Globs the goal must not touch. |
acceptance_gates | list | yes | Acceptance criteria. |
evidence_requirements | list | yes | Required evidence files. |
model_class | enum | yes | DETERMINISTIC, INDEPENDENT_AUDIT_HIGH, PLANNING_ARCHITECTURE_HIGH, STANDARD_ENGINEERING, FAST_LOW_COST. |
preferred_model | string | yes | Primary model. |
fallback_model | string | yes | Fallback model. |
owner_gates | list | yes | Declared owner gates. |
next_action_policy | object | yes | on_pass, on_repair, on_fail. |
required_terminal_states | list | yes | Terminal states for the goal. |
context | path | yes | Path to CONTEXT.yaml. |
prompt | path | yes | Path to PROMPT.md. |
tasks | list | yes | Non-empty list of task dicts. |
Program contract fields
Same as goal contract fields plus:
| Field | Type | Required | Purpose |
|---|---|---|---|
program_layer | object | yes | Program-roadmap layer descriptor. |
execution_layer | object | yes | Execution layer descriptor. |
crosswalk_path | path | yes | Path to PHASE_EXECUTION_CROSSWALK.yaml. |
executable_sequence | list | yes | Ordered list of IMP-XX IDs. |
predecessor_terminal_state | string | yes | Terminal state for predecessor. |
Environment variables
| Variable | Default | Purpose |
|---|---|---|
ASF50_RUNTIME_ROOT | (unset) | Overrides the runtime root. |
GIT_COMMIT | (unset) | Build-time commit hash for the docs site. |
CLI flags
See CLI Reference → for the full CLI surface.
Policy constants
| Constant | Defined in | Value |
|---|---|---|
VALID_SCOPES | scoped_owner_gate.py | PAID_MODEL_DISPATCH_APPROVAL, MERGE_APPROVAL, TAG_APPROVAL, RELEASE_APPROVAL, PHASE_00_RESUME_APPROVAL, PRODUCTION_PROMOTION. |
EXTERNAL_HUMAN_SOURCES | scoped_owner_gate.py | github-review-approval, owner-cli, signed-ticket. |
APPROVAL_SCOPE_REQUIRES | scoped_owner_gate.py | Per-scope allowed sources. |
MODEL_CLASSES | model_router.py | INDEPENDENT_AUDIT_HIGH, PLANNING_ARCHITECTURE_HIGH, STANDARD_ENGINEERING, FAST_LOW_COST. |
PAID_ADAPTERS | model_router.py | cursor-agent, claude, claude_cli, codex. |
PROGRAM_TERMINAL_STATES | program_contracts.py | FROZEN_PASS, PROGRAM_PRODUCTION_CERTIFIED. |
PROGRAM_DISPATCHABLE_STATES | program_contracts.py | READY_FOR_PLAN, PLANNED, READY_FOR_BUILD, READY_FOR_AUDIT, READY_FOR_RELEASE, DRAFT. |
Git configuration
| Surface | Path | Purpose |
|---|---|---|
| Branch protection | GitHub UI / settings | main is branch-protected. |
| Required status checks | GitHub UI | CI workflows must pass before merge. |
| Code owners | .github/CODEOWNERS | Review routing. |