Skip to main content

Database looks empty

Symptom​

goal-status.ps1 returns no rows; program-status.ps1 shows all UNKNOWN.

Decision tree​

Database looks empty?
├── Is this the right DB file?
│   ├── NO  → set ASF50_RUNTIME_ROOT
│   └── YES → continue
├── Has the orchestrator ever run?
│   ├── NO  → run goal-run.ps1 -DryRun once per goal
│   └── YES → continue
└── Was the DB recently restored from backup?
    ├── NO  → reconcile_all() to rebuild from contracts
    └── YES → continue

Resolution​

  1. Run goal-doctor.ps1 to confirm runtime root.
  2. For each goal in goals/, run goal-run.ps1 -DryRun.
  3. If still empty, run GoalRegistry.reconcile_all() from the Python REPL.

What this is NOT​

  • It is not a sign that the runtime DB is corrupt. The DB may simply be uninitialized.
  • It is not a reason to direct-edit the SQLite.