Files
le-mystere-professeur-zacus/docs/benchmark-oss.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

2.0 KiB

OSS Benchmark

Adopt / Align

Tool Why it matters Reference
Blockly Canonical block-based authoring model for the Zacus studio. https://developers.google.com/blockly
Mermaid Lightweight diagrams embedded in docs and specs. https://mermaid.js.org/
Material for MkDocs Fast documentation shell for the rebuilt knowledge base. https://squidfunk.github.io/mkdocs-material/
Charm Gum Optional shell TUI layer with graceful fallback. https://github.com/charmbracelet/gum

Benchmark / Inspiration

Project Why it is relevant Reference
Node-RED Flow-based authoring patterns and graph ergonomics. https://nodered.org/
Ink Narrative authoring and branching conventions. https://www.inklestudios.com/ink/
Yarn Spinner Dialogue/runtime separation patterns. https://www.yarnspinner.dev/
LVGL Embedded UI runtime constraints and display patterns. https://lvgl.io/
SquareLine Studio Embedded UI workflow inspiration for screen authoring. https://squareline.io/
EEZ Studio Embedded UI/editor workflow benchmark for device tooling. https://www.envox.eu/studio/studio-introduction/

Zacus-specific Decision

  • Zacus Runtime 3 remains custom and portable.
  • External OSS is used as a reference or shell, not as a drop-in replacement for the story runtime.

Fresh Notes (2026-03-16)

  • Blockly remains the strongest fit for Zacus authoring because it is still positioned as a customizable client-side block editor for application-specific languages.
  • Node-RED remains the best ergonomics benchmark for event-driven flows that can run both on low-cost edge devices and in the cloud.
  • LVGL stays the right embedded UI reference because it explicitly targets small memory footprints and broad MCU/OS/display portability.
  • EEZ Studio is the strongest workflow benchmark for embedded authoring because it combines templates, visual debugging, execution logs, and timeline-driven UI tooling.