Skip to main content

Runtime State Plane

The runtime state plane is the SQLite-backed RuntimeStore. The schema is created by runtime_store.py's migrate() step and consists of the following tables.

Tables

TablePurpose
goalsGoal rows; goal_id is the primary key.
phasesPhase rows, one per declared phase.
tasksTask rows, one per declared task.
next_actionsComputed next-action record per goal.
evidence_recordsEvidence pointers and SHA-256 digests.
owner_gatesGate rows; gate_id is the primary key.
worktreesWorktree bookkeeping.
pull_requestsPR rows with head SHA and status.
agent_sessionsAgent session bookkeeping.
runsRun rows with role, adapter, status.
task_dependenciesTask graph edges.
state_transitionsHistory of state transitions.
repair_attemptsBounded repair attempts.
findingsAudit findings.
ci_runsCI run bookkeeping.
commitsCommit bookkeeping.
processesProcess supervisor records.
quota_eventsQuota consumption.
role_runsPer-role run records.
locksConcurrency locks.
schema_migrationsSchema version table.

Open vs read-only modes

program-status.ps1 opens the SQLite in mode=ro via uri=...mode=ro. The orchestrator opens it for write through RuntimeStore. There is no "shared" mode; the two modes are explicit and the CLI rejects operations that require write access when only read access is granted.