Troubleshooting
Initialization, payment, tool and build issues.
Common issues
- Env checks fail: correct the named fields; values are never printed. Initialization does not overwrite existing configuration.
- Missing generated .source types: run pnpm docs:prepare or pnpm typecheck, do not hand-create generated files.
- payments_disabled: expected default; configure your merchant before enabling.
- Return still pending: URL parameters are not proof. Inspect local order/provider signed notification/inquiry. Unknown Creem checkout IDs need webhook/operator recovery, never another request.
- subscription_exists: resolve the paid/review/unfinished subscription first. Refund review needs manual reconciliation, not deletion to bypass it.
- Tools: 401 login, 402 insufficient credits, 429 retry after Retry-After, compensation_pending reconcile by requestId.
- DB tests skipped: TEST_DATABASE_URL missing; only an isolated disposable DB may be used.
- CI/deploy guard fails: skipping checks is not a fix. Rerun the failing command and record evidence.
External merchant/email/OAuth/Sentry acceptance needs real credentials; green local tests do not replace it.