Bloqr Compiler — Operations & Troubleshooting KB

Bloqr Compiler — Operations & Troubleshooting KB

This directory contains the Knowledge Base (KB) troubleshooting series for the bloqr-backend Cloudflare Worker and its supporting services.

Each article follows a consistent structure: symptom, diagnostic commands, root cause decision tree, and resolution summary.

---

Table of Contents

Article	Title	Status
KB-001	”Getting API is not available” on the main page	✅ Active
KB-002	Hyperdrive binding connected but database service reports down	✅ Active
KB-003	Database Down After Deploy — Live Debugging Session (2026-03-25)	✅ Active
KB-004	Prisma WASM binary not found in Cloudflare Workers	✅ Active
KB-005	Better Auth Cloudflare integration — Worker CPU timeout & rate limiting	✅ Active
KB-006	D1 Authorization Error (7403) — API Token Missing D1:Edit Permission	✅ Active
KB-007	Production Debugging Session — Sign-up 500 / curl 403 / Migration Drift (2026-04)	✅ Active
KB-008	Prisma 7 + Cloudflare Workers: WebAssembly.Module() Disallowed by Embedder	✅ Active
KB-009	Better Auth + Neon: Version Sync, UUID Enforcement, KV Secondary Storage, and Login Failures	✅ Active

---

Contributing

If you encounter a new failure mode not covered by an existing article, please open an issue tagged troubleshooting and documentation in bloqr-systems/bloqr-compiler. Include:

• The symptom observed
• Any diagnostic output (curl responses, wrangler tail logs, etc.)
• The root cause if identified
• The fix applied

New KB articles should be named KB-NNN-short-description.md and added to the table above.