electron-rare/le-mystere-professeur-zacus
1
0
Fork 0
Code Issues 1 Pull Requests 2 Actions 1 Packages Projects Releases Wiki Activity
Files
20aed903babbe48f6f252810bd48e92008f79384
le-mystere-professeur-zacus/docs/AGENTS_FIRMWARE.md
T
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.4 KiB
Raw Blame History

Agent Contract – Firmware Copilot

Scope

Firmware agents cover esp32_audio/, ui/esp8266_oled/, ui/rp2040_tft/, and shared protocol/ code that drives the MCU binaries.

Doit

  • Lire puis mettre à jour hardware/firmware/docs/AGENT_TODO.md avant d’agir (le tracker unique garde la trace de l’état de chaque gate).
  • Respecter le contrat global (AGENTS.md) et les règles d’outillage de tools/dev/AGENTS.md (gates/scripts centralisés, artefacts hors git).
  • S’assurer que tout build se passe via platformio.ini/build_all.sh ou Makefile fast-*, et documenter les artefacts dans hardware/firmware/docs/AGENT_TODO.md.
  • Pour les modifications de structure, ajouter un commentaire dans hardware/firmware/docs/AGENT_TODO.md + mentionner le commit dans docs/TEST_SCRIPT_COORDINATOR.md.
  • Toujours signaler l’état des UI Link / LittleFS / I2S dans hardware/firmware/docs/AGENT_TODO.md:6-14 lorsqu’on manipule ces composants.

Reporting

  • Chaque run doit produire des artefacts artifacts/<phase>/<timestamp> ; les chemins doivent figurer dans la case correspondante du TODO.
  • Données hardware (logs, ports) restent hors git : référencer les fichiers dans hardware/firmware/docs/AGENT_TODO.md ou le rapport final.

References

  • Branche principale : docs/SPRINT_RECOMMENDATIONS.md, README.md, protocol/ui_link_v2.md
  • Evidence tracker : docs/TEST_SCRIPT_COORDINATOR.md, docs/TEST_COHERENCE_AUDIT_RUNBOOK.md
Reference in New Issue View Git Blame Copy Permalink