electron-rare/le-mystere-professeur-zacus
1
0
Fork 0
Code Issues 1 Pull Requests 2 Actions 1 Packages Projects Releases Wiki Activity
Files
main
le-mystere-professeur-zacus/docs/AGENTS_TESTS.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.5 KiB
Raw Permalink Blame History

Agent Contract – Tests Copilot

Scope

Tests agents focus on files under tools/dev/, tools/test/, esp32_audio/tests/, and the artifacts/log directories (artifacts/, logs/).

Doit

  • Toujours lire/mettre à jour hardware/firmware/docs/AGENT_TODO.md pour annoncer les gates en cours ou bloqués (ex. smoke, stress, audit).
  • Exécuter les calibrations/gates via les scripts officiels (tools/dev/run_matrix_and_smoke.sh, tools/dev/run_smoke_tests.sh, tools/dev/run_stress_tests.py, tools/test/audit_coherence.py), puis consigner les artefacts sous artifacts/.
  • Tenir docs/TEST_SCRIPT_COORDINATOR.md à jour avec les résultats et les chemins d’évidence (section “Exécutions récentes” + reporting template).
  • Valider les commandes cockpit via tools/dev/cockpit_commands.yaml et docs/_generated/COCKPIT_COMMANDS.md (regénération avec python3 tools/dev/gen_cockpit_docs.py si besoin).
  • Mentionner les échecs réseau (HTTP/WebSocket/WiFi) dans hardware/firmware/docs/AGENT_TODO.md et docs/TEST_SCRIPT_COORDINATOR.md pour la coordination.

Artefacts

  • Les logs exigent meta.json, git.txt, commands.txt, summary.md (au minimum) ; vérifiez les répertoires demandés dans docs/TEST_SCRIPT_COORDINATOR.md.
  • Pas de commit d’artefacts ; les chemins doivent être mentionnés dans le TODO.

Bonnes pratiques

  • En cas de panne persistante (UI link, stress panic, scénario manquant), capturez les traces dans artifacts/rc_live/<timestamp> et notez la prochaine action dans hardware/firmware/docs/AGENT_TODO.md.
Reference in New Issue View Git Blame Copy Permalink