Audience: researchers and engineers running lab evals on the video pipeline and job-level agents
Scope: methodology and backlog for evaluating Overwatch outputs — not Factorio (see factorio_report.md)
Complements technical_report.md. The technical report §13 notes there is no golden eval for agent quality yet; this document is the plan to add one.
- Measure structured correctness (JSON/schema), temporal grounding (claims vs timestamps/chunks), and actionability (useful next steps without unsafe leakage).
- Keep runs reproducible: model id, prompt/version hash, clip-set version, and environment knobs recorded on every run.
- Validate chunk outputs (
scene_summary, merged chunk payloads) and jobsummary_jsonagainst Pydantic models. - Golden fixtures for JSON repair and extraction (
analysis/json_extract.py). - Regression tests with stubbed vLLM responses (no network).
- Small frozen clip set (10–30 short segments).
- Short rubrics: 1–3 Likert scales + one optional free-text note per clip.
- Two annotators where feasible; report simple agreement (e.g. Cohen’s kappa or % within 1 point).
- Roll the same clips into synthetic or real
JobSummaryPayloadfixtures. - Judge synthesis, risk, privacy, and related agent outputs against rubrics (human preferred; model-as-judge only with documented bias caveats).
- Assert step ordering, 409 when a second orchestration is started, and queue-to-terminal status transitions with mocked persistence where needed.
- Extend toward HTTP integration tests when the stack stabilizes.
Each eval run should record at minimum:
| Field | Example |
|---|---|
| Date (UTC) | 2026-04-12 |
| Git commit | abc123f |
| Model id | served id on vLLM |
VLLM_* knobs |
timeouts, max tokens |
| Clip / fixture set version | tag or manifest hash |
Optional layout under repo root: evals/ — manifest of clips, expected JSON snippets, rubric CSVs (add when you start human annotation). Factorio parser fixtures under evals/factorio_parser/ are documented in factorio_report.md.
- Production authentication, retention, or backup work for this track unless separately prioritized.
End of eval report.