# Field Issues

Problems found when the pipeline meets **real footage** (or real APIs), logged here instead of
being rushed into fixes mid-field-test (per plan/10-integration.md item 4). Coordinator triages;
polish/fixes land in a later phase.

**Format** (newest at the bottom):

```
### ISSUE-<n> — <area> — <date> — <one-line title>
- **Symptom:** what was observed (exact error / measurement)
- **Root cause:** why (if known; else "unknown — needs investigation")
- **Fix / workaround:** what was done, or "OPEN"
- **Evidence:** command output, test name, or measurement proving symptom/fix
- **Status:** OPEN | FIXED | WONTFIX
```

---

<!-- entries below -->

### ISSUE-1 — events (AI classifier) — 2026-07-16 — gemini-2.5-flash 404 for new API keys
- **Symptom:** `events` with a valid `GEMINI_API_KEY` returned `404 NOT_FOUND … models/gemini-2.5-flash is no longer available to new users`; 0/3 candidates classified (degraded to candidates-only).
- **Root cause:** Google retired `gemini-2.5-flash` for newly-provisioned API keys; the model id was hardcoded in `GeminiClassifier`.
- **Fix / workaround:** made the Gemini model env-overridable (`FESTIVAL4D_GEMINI_MODEL`), default `gemini-3.1-flash-lite` (verified to accept inline video + JSON-schema structured output). Coordinator hotfix, commit `8dca2f5`.
- **Evidence:** post-fix run `classified=3 candidates_only=0`; labels `light_show` / `bass_drop` with coherent descriptions; suite 101 passed.
- **Status:** FIXED