Restructure include-humain-IA to scenario-ai-coherence and cleanup artifacts

Co-authored-by: electron-rare <108685187+electron-rare@users.noreply.github.com>

.gitignore

@@ -1,8 +1,23 @@
 # macOS Finder metadata
 .DS_Store
+.AppleDouble
+.LSOverride
+
+# macOS Thumbnails
+._*
+
+# macOS Directories that might appear in the root
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
 
 # Local IDE settings
 .vscode/
+.idea/
 
 # Generated game exports
 game/exports/*
@@ -14,14 +29,36 @@ audio/generated/*
 !audio/generated/README.md
 
 # Locally generated printable PDFs (not versioned)
-<<<<<<< Updated upstream
-printables/export/pdf/zacus_v1/*
-!printables/export/pdf/zacus_v1/README.md
-=======
 printables/export/pdf/**
 !printables/export/pdf/zacus_v1/README.md
 
 # Locally generated printable PNGs (not versioned)
 printables/export/png/**
 !printables/export/png/zacus_v1/.gitkeep
->>>>>>> Stashed changes
+
+# Firmware build artifacts
+hardware/firmware/**/build/
+hardware/firmware/**/.pio/
+hardware/firmware/**/.pioenvs/
+hardware/firmware/**/.piolibdeps/
+hardware/firmware/**/lib/
+hardware/firmware/**/bin/
+hardware/firmware/**/*.hex
+hardware/firmware/**/*.bin
+hardware/firmware/**/*.elf
+
+# PlatformIO specific
+.pio
+.pioenvs
+.piolibdeps
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv/
+venv/
+env/
+ENV/

CODEX_RULES.md

@@ -12,7 +12,7 @@ Allowed:
 - tools/qa/** (optional)
 - .github/workflows/firmware-*.yml
 Forbidden:
-- game/** audio/** printables/** kit-maitre-du-jeu/** include-humain-IA/** docs/**
+- game/** audio/** printables/** kit-maitre-du-jeu/** scenario-ai-coherence/** docs/**
 
 ### generation/story-esp
 Allowed:
@@ -31,7 +31,7 @@ Allowed:
 - audio/**
 - printables/**
 - kit-maitre-du-jeu/**
-- include-humain-IA/**
+- scenario-ai-coherence/**
 Forbidden:
 - hardware/** (firmware), tools/**
 

LICENSE.md

@@ -8,7 +8,7 @@ S’applique à : firmware, scripts, outils (répertoires `hardware/`, `tools/`,
 Texte : `LICENSES/MIT.txt`
 
 ## Contenus créatifs & documentation — CC BY-NC 4.0
-S’applique à : documents de jeu, guides, prompts, printables, illustrations, textes narratifs et assets (`kit-maitre-du-jeu/`, `printables/`, `docs/`, `game/`, `audio/`, `include-humain-IA/`).
+S’applique à : documents de jeu, guides, prompts, printables, illustrations, textes narratifs et assets (`kit-maitre-du-jeu/`, `printables/`, `docs/`, `game/`, `audio/`, `scenario-ai-coherence/`).
 
 Texte : `LICENSES/CC-BY-NC-4.0.txt`
 

README.md

@@ -35,13 +35,13 @@ Dossier : `printables/`
 - `docs/QUICKSTART.md` (mise en place express, licences)
 - `docs/STYLEGUIDE.md` (ton, structure, prompts)
 - `docs/index.md` + `docs/repo-status.md` pour la navigation et l’état du dépôt
-- `include-humain-IA/` (contenus annexes, renommé pour la portabilité)
+- `scenario-ai-coherence/` (cohérence scénario générée par IA, validée par humain)
 
 ## État du projet
 - **Kit MJ** : complet (script, plan, antic-chaos, solution, checklists, export PDF).
 - **Printables** : prompts prêts, workflow documenté (`printables/WORKFLOW.md`), exports par thème organisés.
 - **Game/audio** : scénario canon `zacus_v1`, manifestes, audio narratif et scripts de validation.
-- **Outils** : scripts Python ded validation scenario/audio + guide rapide.
+- **Outils** : scripts Python de validation scenario/audio + guide rapide.
 
 ## Licence / Contribution
 - Contenus créatifs (documents, PDFs, PNG, SVG, assets, prompts) : **CC BY-NC 4.0** (`LICENSES/CC-BY-NC-4.0.txt`).

docs/BRANCHES.md

@@ -15,7 +15,7 @@ Scope: story engine files listed in CODEX_RULES.md
 
 ## generation/story-ia
 Canonical game/story content, prompts, printables, audio manifests.
-Scope: game/** audio/** printables/** kit-maitre-du-jeu/** include-humain-IA/**
+Scope: game/** audio/** printables/** kit-maitre-du-jeu/** scenario-ai-coherence/**
 
 ## scripts/generation
 Generators/validators/exporters + CI validate workflow.

docs/repo-status.md

@@ -5,7 +5,7 @@
 - `printables/`: `src/` plus `export/{pdf,png}/` for invitations, cards, badges, and the one-page rule set.
 - `hardware/`: BOMs, wiring docs, and the ESP32/Arduino firmware flow with `.pio` dependencies (libraries such as Adafruit and ESP8266Audio naturally expand here).
 - `docs/`: maintenance plan, repo audit, and asset folder (`docs/assets/` contains the repo map SVG already referenced in `README.md`).
-- `examples/` and `include-humain-IA/` (renamed for portability): auxiliary content and tools, now safe for Windows/CI.
+- `examples/` and `scenario-ai-coherence/` (renamed for portability): auxiliary content and tools, now safe for Windows/CI.
 
 ## Empty / TODO files
 - `printables/invitations/export/pdf/.gitkeep`
@@ -20,7 +20,7 @@
 - `hardware/firmware/esp32/.pio/libdeps/esp32_release/Mozzi/README.md` line 116 → same missing `extras/NEWS.txt`.
 
 ## Naming / portability issues
-- `include-humain-IA/` and `include-humain-IA/version-finale/` now avoid spaces/colon, keeping the tree stable sur Windows/CI tooling. Continue to prefer hyphenated, lowercase identifiers pour tout nouveau sous-dossier.
+- `scenario-ai-coherence/` and `scenario-ai-coherence/version-finale/` now avoid spaces/colon, keeping the tree stable sur Windows/CI tooling. Continue to prefer hyphenated, lowercase identifiers pour tout nouveau sous-dossier.
 
 ## Licences
 - `README.md`, `CONTRIBUTING.md`, and `LICENSE.md` sont alignés autour du modèle CC BY-NC 4.0 pour les contenus créatifs et MIT pour le code (`LICENSES/CC-BY-NC-4.0.txt`, `LICENSES/MIT.txt`). Garder la même nomenclature accélère la revue des contributions.

ops/check_scope.sh

@@ -21,7 +21,7 @@ case "$branch" in
     bad=$(echo "$changed" | egrep -v '^(hardware/firmware/esp32/src/story/|hardware/firmware/esp32/src/controllers/story/|hardware/firmware/esp32/src/services/serial/serial_commands_story\.(cpp|h)$|hardware/firmware/esp32/src/la_detector\.(cpp|h)$|hardware/firmware/esp32/GENERER_UN_SCENARIO_STORY_V2\.md$|hardware/firmware/esp32/RELEASE_STORY_V2\.md$|hardware/firmware/esp32/docs/workstreams/).*' || true)
     ;;
   generation/story-ia)
-    bad=$(echo "$changed" | egrep -v '^(game/|audio/|printables/|kit-maitre-du-jeu/|include-humain-IA/).*' || true)
+    bad=$(echo "$changed" | egrep -v '^(game/|audio/|printables/|kit-maitre-du-jeu/|scenario-ai-coherence/).*' || true)
     ;;
   scripts/generation)
     bad=$(echo "$changed" | egrep -v '^(tools/|Makefile$|\.github/workflows/validate\.yml$).*' || true)

ops/codex_story_ia.sh

@@ -2,5 +2,5 @@
 set -euo pipefail
 git switch generation/story-ia
 git pull --ff-only
-echo "Scope: game/** audio/** printables/** kit-maitre-du-jeu/** include-humain-IA/**"
+echo "Scope: game/** audio/** printables/** kit-maitre-du-jeu/** scenario-ai-coherence/**"
 echo "Tip: In Codex, say: 'ONLY edit those folders. Do not touch hardware/** or tools/**.'"

scenario-ai-coherence/README.md

@@ -0,0 +1,21 @@
+# Scenario AI Coherence
+
+## Rôle de ce dossier
+
+Ce dossier contient les artefacts de cohérence scénario générés par IA et validés par des humains.
+
+### Structure
+
+- **`version-finale/`** : Contenus finaux validés et approuvés pour utilisation dans le jeu
+- *Futurs artefacts* : Versions intermédiaires, logs de génération, et autres documents de travail IA
+
+## Processus
+
+1. **Génération IA** : Création initiale de contenu scénario via outils d'IA
+2. **Validation humaine** : Révision et approbation par les mainteneurs
+3. **Intégration** : Déplacement vers `version-finale/` une fois validé
+4. **Utilisation** : Référencé par les autres composants du kit d'enquête
+
+## Licence
+
+Contenus de ce dossier : **CC BY-NC 4.0** (voir `LICENSES/CC-BY-NC-4.0.txt`)