# V2 AI Commentary Model Card

## Purpose

V2 AI Commentary generates play-by-play, highlight-reel, and per-match analysis
presentation for broadcast, replay, and second-screen surfaces. It never feeds
gameplay simulation, ranking, matchmaking, anti-cheat, or enforcement.

## Packages

- Commentary orchestration: `@v2/iris-commentary-orchestration` over
  `@iris/conversation-orchestration`.
- Music ducking: `@v2/euterpe-commentary-ducking`.
- Commentator face animation: `@v2/psyche-commentary-face-animation`.
- Runtime model metadata and Model Card hosting: `@nous/safety`.
- AI-system-of-record and conformity audit export: `@themis/accountability`.
- V2 adapter: `@v2/eu-ai-act-surface`.

## EU AI Act Classification

Risk class: Limited risk.

Disclosure text: AI commentary is machine-generated presentation content. It is
labeled on screen and never feeds gameplay simulation, ranking, or enforcement.

## Inputs

- KO, round-end, replay, and scoreboard event summaries.
- Ruleset, fighter, stage, and broadcast-mode metadata.
- Approved commentator persona and locale settings.
- Safety-filtered match analysis context.

## Player Controls

Opt-out path: Settings > Audio > Commentary > Human/authored commentary only.

When disabled or unavailable, V2 falls back to preauthored commentary decks,
muted commentary, or subtitle-only presentation.

## Safety And Evaluation

- Rollback isolation: no commentary output is deterministic gameplay input.
- Latency gate: p99 KO commentary must remain at or below 800 ms from gameplay
  event to subtitle/audio enqueue.
- Safety fallback: failed, blocked, or over-budget generation falls back to
  authored commentary.
- Audit export: `@themis/accountability` retains the AI-system-of-record with
  regulator-ready evidence links.