[davior]

Every audio upload was sent to Deepgram when a key was configured, so music was billed per minute and transcribed to nothing. Voice recordings still need their transcripts, so this PR adds a label saying what an audio file is, and transcription follows that label.

audio_kind on audio assets

music, speech, sfx, or NULL for not known. One nullable column; existing rows stay NULL.

Kind	Set by	Transcribed on upload	Analysed (tempo/key/energy)
music	A genre or BPM tag; a music page import; by hand	No	Yes
speech	A speech-genre tag (Podcast, Speech, Spoken Word, Audiobook, …); by hand	Yes	No
sfx	By hand	No	No
not known	Anything else	Yes, as before	Yes

• Unknown is transcribed on purpose. A voice recording losing its transcript is the costly mistake, so only a confident kind skips transcription.
• The kind is never guessed from the sound. A podcast over a music bed has a beat and a key.
• It is decided at upload, from tags or from the importer, because transcription is queued the moment a file lands. Page import passes audio_kind="music" to ingest_file so the kind is on the row before that decision.
• "This is" in the Music tab changes the kind by hand. A change catches up on what upload would have done: marking a file as speech transcribes it if it never was; marking it as music measures it. Nothing is undone, and the Transcribe button still works on any kind.
• Only audio assets can have a kind. Setting one on a video returns 400 not_audio.
• When page import finds a duplicate by checksum, it sets the existing copy to music if that copy has no kind yet.

A follow-up in gvc will let Video Creator prefer music and skip speech when choosing a soundtrack.

Testing

• pytest -q: 1385 passed. The new tests/test_audio_kind.py covers:
  • the tag rules;
  • that a tagged song isn't transcribed while an untagged recording still is;
  • kind changes catching up;
  • a podcast-tagged file not being analysed as music;
  • video refusal and invalid values;
  • page import.
• npm run format:check, npm run lint, npm test (426 passed) and npm run build all clean.

---

Generated by Claude Code