20aed903ba
- 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>
2.0 KiB
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.