Troubleshooting

Troubleshooting

DB locked / timeout

Bun.sqlite uses WAL + busy_timeout=5000. Tests isolate via tmpDir + closeDb(). If urlencoded magnet adds times out under bun test --parallel, you have shared config/db state — see CONTRIBUTING.md §6.

*arr bridge connection refused

arrBridge previously threw pathToRegexpError on app.all('/api/v2/*') under Express 5 — fixed to /{*splat} (#57). Check GET /health on :8282.

429 / 503

Rate limiter backs off 60s → 15m, respects Retry-After. Download tokens rotate on 429/503 without global backoff. Check GET /api/tokens.

Mount empty / Transport not connected

mount.ts auto-force-unmounts stale FUSE on start and remounts after 5 health failures. Check docker logs and GET /health.

Guard fails on PR that deletes data/tokens.db

guard.yml now uses --diff-filter=A so deletions do not fail — only added *.db fails. Ensure .gitignore has data/*.db + *.db-shm|wal.

History scrub

data/tokens.db was purged via filter-branch on develop and synced to main via temp-sync-main. Old clones run bun run fix:history once.