Support Mixed-Mode Recording with Cross-Granularity Take Labeling

[chadw-eten]

Once the working unit is a live per-user toggle, a translator can switch modes mid-chapter, so recording must never be blocked by existing takes at the other granularity. This ticket removes any recording lock, and extends the existing takes model (#71) so every take is labeled by the granularity it was recorded in and the shared 5-take cap accounts for takes that span the other granularity.

Functional Requirements

Mixed-Mode Recording

• Allow recording a new take in whichever mode is currently active, regardless of any existing takes in the other granularity.
• Never block the Record action due to a granularity conflict; mixed verse-level and pericope-level takes may coexist within the same chapter.

Take Labeling

• Add a subtitle to each take card in the format "Take [N] - Pericope - vv. [X]-[Y]" or "Take [N] - Verse - v. [X]", naming the granularity it was recorded in and the verse(s) it covers.
• Show this subtitle regardless of which mode the take list is currently being viewed in.

Cross-Granularity Take Lists

• When a pericope take exists, show it in the take list of every verse it spans, labeled with its "Take [N] - Pericope - vv. [X]-[Y]" subtitle.
• Count a shared pericope take against each spanned verse's 5-take cap.
• If a verse's take list is at the 5-take cap because of a shared pericope take, require deleting a take from verse view before a new verse-level take can be recorded for that verse.

Note: Deleting a shared pericope take from one verse's list removes it entirely (from every verse it spans).

[mattrace-gloo]

Engineering context

Product intent

Allow recording in the active mode without blocking on the other granularity; label every take with granularity + verse coverage; show shared pericope takes on every spanned verse; apply the shared 5-take cap across granularities; deleting a shared pericope take removes it everywhere.

What exists today (#71 shipped)

• recordings rows: bible_text_id, take_number, is_selected, … — verse-keyed only; no granularity / range columns (src/db/schema.ts).
• Cap: MAX_TAKES = 5 in src/hooks/useVerseAudio.ts.
• Take row label: "Take {N}" only (DraftTakeRow) — no subtitle.
• Upload: FluentAPI.uploadVerseAudio → PUT /verse-audio/{projectUnitId}/{bibleTextId} — one verse id; server record is per (projectUnitId, bibleTextId).

Alignment notes

• “Never block Record due to granularity conflict” is a local policy change once we can store both kinds of takes.
• Cross-granularity list + shared cap need a data model for “this take covers verses X–Y at pericope granularity,” not only a UI subtitle.
• Subtitle formats from the mock: Take [N] - Pericope - vv. [X]-[Y] / Take [N] - Verse - v. [X] — add a subtitle slot on DraftTakeRow / shared rows; show regardless of current view mode.
• Delete of a shared pericope take is one underlying row (or one id) removed from all verse views — model accordingly.

Suggested approach

1. Extend local recordings model (migration): e.g. granularity (verse | pericope), start_verse / end_verse (and book/chapter as needed), keep bible_text_id as anchor (start verse) for join compatibility or introduce a clearer unit key — pick one scheme and document it.
2. Update list queries so verse V includes verse takes for V plus pericope takes whose range includes V.
3. Cap logic: count all takes visible for that verse (including shared pericope takes) against 5; disable Record New Take at cap.
4. Subtitle on take cards; ensure delete is global for shared ids.
5. Tests for cap, list membership, delete fan-out.

Dependencies

• Requires: Add Verse/Pericope Toggle to Mobile Settings #407 + pericope sync (to know ranges).
• Unblocks: Implement Cross-Granularity Playback with Stitching and Labeling #411 “Stitched” / pericope-on-verse labeling display.
• Upload path depends on API support below — local mixed-mode can proceed first only if product accepts deferred sync for pericope takes.

API gap (important)

Current /verse-audio cannot represent a multi-verse pericope take. Honest upload/sync for mixed-mode needs fluent-api support for pericope / verse-range translator recordings (granularity + verse span metadata; list/get/delete semantics; awareness of conflict work on fluent-api #271).

Until that exists: implement local mixed-mode + labeling; keep pericope-take upload behind an explicit waiver, or get product sign-off before mapping a pericope take onto a single-verse upload.

Out of scope

• Stitched playback label "Take N - Stitched - …" (Implement Cross-Granularity Playback with Stitching and Labeling #411)
• Partial-recorded Bible card indicator (Update Bible Tab for Verse/Pericope Toggle #408)
• Source player (Build Source Audio Player for Bible Tab #412/Wire Source audio dock to real fetch + playback #235)