Merge origin/main into chore/harmonize-zacus

audio/README.md

@@ -0,0 +1,24 @@
+# Pipeline audio Zacus v1
+
+Objectif: pipeline local IA-friendly sans dépendance cloud obligatoire.
+
+## Outils cibles
+- TTS: `espeak`, `mbrola`, ou `piper`
+- Conversion: `ffmpeg` (MP3 mono faible débit)
+
+## Convention export
+- Mono, 22.05 kHz ou 44.1 kHz
+- 48–96 kbps
+- Nommage depuis `audio/manifests/zacus_v1_audio.yaml`
+
+## Étapes
+1. Générer voix (hotline + messages U-SON).
+2. Générer textures/musiques via prompts (voir `game/prompts/audio/`).
+3. Normaliser volume.
+4. Valider présence des fichiers avec `tools/audio/validate_manifest.py`.
+
+## Génération locale rapide (placeholder)
+Si vous voulez débloquer rapidement des tests sans TTS externe:
+- `python3 tools/audio/generate_local_assets.py`
+
+Ce script crée `audio/generated/*` en réutilisant des MP3 présents dans le repo (placeholders techniques).

audio/generated/README.md

@@ -0,0 +1,11 @@
+# audio/generated
+
+Ce dossier contient des artefacts audio générés localement (MP3), non versionnés.
+
+Pourquoi: plusieurs workflows d'extraction/patch (et revues diff textuelles) ne gèrent pas bien les binaires.
+
+Génération locale:
+- `python3 tools/audio/generate_local_assets.py`
+
+Validation:
+- `python3 tools/audio/validate_manifest.py`