Skip to main content

Handle incorrect runtime root

If ASF50_RUNTIME_ROOT points to the wrong directory, the orchestrator may operate on a stale DB.

Symptoms​

  • goal-status.ps1 shows old or empty state.
  • goal-doctor.ps1 reports split-brain runtime.
  • goal-run.ps1 errors with runtime_root mismatch.

Steps​

  1. Run goal-doctor.ps1 -RuntimeRoot … to confirm.
  2. Compare the runtime root with the canonical location:
    • D:\Projects\ASF50-Platform\ASF50\scripts\goal-runner\local\runtime (local dev).
    • The production runtime root (if different).
  3. Set ASF50_RUNTIME_ROOT to the correct value.
  4. Re-run goal-doctor.ps1 to confirm the runtime is no longer split-brain.
  5. Re-run goal-status.ps1 to confirm state is correct.

What this playbook is NOT​

  • It does not move the runtime DB. Moving the DB requires a migration step.
  • It does not change the canonical runtime location without explicit owner authorization.