Files
le-mystere-professeur-zacus/specs/CONVERSATION_BUNDLE_INTAKE.md
L'électron rare 20aed903ba feat: AI integration — voice pipeline, hints engine, MCP server, analytics, security
- Voice pipeline: ESP32 WebSocket client → voice bridge → LLM → Piper TTS (Tower :8001)
- Hints engine: 3 puzzles (LA_440, LEFOU_PIANO, QR_FINALE), anti-cheat, 3 hint levels
- MCP hardware server: 6 tools (puzzle, audio, LED, camera, scenario, status), stdio transport
- Analytics: ESP32 module + 6 web endpoints + Dashboard UI with chat interface
- Security: auth middleware (Bearer NVS), rate limiting, input validation on 30 endpoints
- Frontend: code-split (1.1MB → 210KB initial), ErrorBoundary, API timeout, WS reconnect
- Tests: 24 Python + 38 TypeScript + 18 MCP = 80 project tests (+ 19 mascarade)
- Specs: AI_INTEGRATION_SPEC, MCP_HARDWARE_SERVER_SPEC, QA_TEST_MATRIX_SPEC
- Docs: SECURITY, DEPLOYMENT_RUNBOOK, voice pipeline guide, AI architecture map
- 6 AI agent definitions (.github/agents/ai_*.md)
- TUI orchestration script (tools/dev/zacus_tui.py)
- Docker compose TTS for Tower + KXKM-AI
- CHANGELOG, README, mkdocs.yml updated
- Cycle detection (DFS) in runtime3 validator
- Sprint plan: plans/SPRINT_AI_INTEGRATION.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-22 13:52:45 +01:00

1.6 KiB

Conversation bundle intake — statut courant (G0 Spec Freeze)

Contexte

Le bundle conversationnel est maintenu dans : scenario-ai-coherence/zacus_conversation_bundle_v3/.

Critères d'acceptation (AC)

  • Les fichiers du bundle sont présents localement dans le même chemin.
  • Le contenu est importé tel quel (pas de transformation fonctionnelle).
  • La traçabilité est mise à jour (artifacts/... + evidence/manifest.json).
  • Les validateurs scénario/audio/printables existants passent après import.
  • L'installation des validateurs est reproductible par script versionné.

Non-goals

  • Aucune promotion automatique de zacus_v2.yaml vers game/scenarios/*.yaml (promotion manuelle validée dans ce lot).
  • Aucune modification firmware/hardware.
  • Aucune refonte des manifests audio/printables.

Risques

  • Le bundle peut diverger du scénario canonique game/scenarios/zacus_v2.yaml.
  • Les formats scenario_runtime.json/templates peuvent nécessiter une validation dédiée ultérieure.

Prochaine étape proposée

  • Validateur dédié implémenté: tools/scenario/validate_runtime_bundle.py (cohérence runtime/canonical/template).
  • Diff fonctionnel implémenté: tools/scenario/diff_gameplay_scenarios.py (rapport markdown QA).
  • Étape suivante: brancher le validateur runtime-bundle dans l'automatisation CI (gate G3 systématique).

Statut Gates

  • G0 Spec Freeze : satisfait pour l'import brut du bundle.

TODO transverse (issue restante)

  • Analyse transverse du repo ajoutée dans docs/repo-deep-analysis-2026-02-25.md pour planifier PR-A/PR-B/PR-C.