Oracle converge and stack locks

When a box is wedged or a Pulumi stack lock will not clear through the normal cancel path, use the oracle admin surfaces. Companion runbooks: pulumi-runtime.runbook.md · box-troubleshooting.runbook.md.

CLI-first recipes

# Boxes the oracle considers wedged
nayaone-admin api adminListWedgedBoxes

# Held stack locks
nayaone-admin api adminListOracleStackLocks

# Converge failure / audit trails
nayaone-admin api adminListOracleConvergeFailures
nayaone-admin api adminListOracleConvergeAudit

# Dispatch an oracle converge pass
nayaone-admin api adminRunOracleConverge --body '{}'

# Refresh the converge-oracle rollup
nayaone-admin api adminRefreshConvergeOracleRollup --body '{}'

REST fallback: GET /admin-api/oracle/wedged-boxes · GET /admin-api/oracle/stack-locks · POST /admin-api/oracle/converge · POST /admin-api/converge-oracle/refresh.

Area listing: CLI reference → oracle.

Escalation ladder

1. adminListWedgedBoxes + adminListOracleStackLocks — name the stuck scope.
2. adminCancelPulumiState (see Pulumi converge) — clear a held engine lock.
3. adminClearPulumiStateCache + adminRunPulumiConverge with action: up — wipe + reconverge.
4. adminRunOracleConverge — force the oracle reconciliation pass when D1 projection drifted from R2/cloud.