Personal Finance Notion — runbooks

Operational guides for failure scenarios. Each runbook answers "what do I do when X happens" with concrete commands.

Entries

• [[Projects/personal-finance-notion/runbooks/runbook-mongodb-down|MongoDB down / connection refused]]
• [[Projects/personal-finance-notion/runbooks/runbook-openrouter-failure|OpenRouter failure during bulk import]]
• [[Projects/personal-finance-notion/runbooks/runbook-pwa-outbox-stuck|PWA outbox won't drain after reconnect]]
• [[Projects/personal-finance-notion/runbooks/runbook-agent-push-401|Integrations API rejects agent push (401/403)]]

Candidates to write

• Service worker won't update (stale cache after deploy)
• JWT secret rotation / forced sign-out
• Backup + restore (npm run backup:export round-trip)

Hub

• [[Projects/personal-finance-notion/personal-finance-notion|MOC]]