System Diagnostics

D1 Database

Symptom: DB not configured or query failed

Fix: Verify database_id in wrangler.toml is set to a real D1 database ID. Run: wrangler d1 list

KV Cache

Symptom: KV binding not configured or read/write mismatch

Fix: Verify KV namespace IDs in wrangler.toml. Run: wrangler kv:namespace list

OpenRouter AI

Symptom: OPENROUTER_API_KEY not set or OpenRouter returned error

Fix: Set OPENROUTER_API_KEY via wrangler secret put OPENROUTER_API_KEY or add to .dev.vars

GitHub API

Symptom: github_token not found or GitHub returned 401

Fix: Store a valid GitHub PAT in CONFIG KV: echo "your_token" | wrangler kv:key put --binding=CONFIG github_token

Cloudflare API

Symptom: CLOUDFLARE_API_TOKEN not set or invalid

Fix: Set CLOUDFLARE_API_TOKEN via wrangler secret put CLOUDFLARE_API_TOKEN. Token needs Account:Read and Zone:Read permissions.