v1.9.4 - Document kurikintons Compatibility and DAQ Framework Architecture (2025-12-29)

v1.9.4 - Document kurikintons Compatibility and DAQ Framework Architecture (2025-12-29)#

What Changed?#

This release enhances CLAUDE.md documentation with comprehensive information about firmware compatibility and framework architecture. It clarifies the relationship between haniwers and kurikintons (OSECHI firmware) across all versions, and documents the architectural evolution from monorepo-like (v1) to subsystem-integrated (v2) DAQ frameworks.


What’s Different from the Last Version?#

📝 Documentation Updates#

  • Added kurikintons firmware compatibility matrix with protocol and output format details

    • v0 = kurikintons v0 (archived prototype)

    • v1 = kurikintons v1 (text command + CSV output)

    • v2 = kurikintons v2 (unified device response + JSONL output)

  • Documented DAQ framework architecture patterns

    • v1: Monorepo-like framework with all subsystems bundled

    • v2: Subsystem-integrated framework delegating to specialized tools

  • Added subsystem integration strategy for v2

    • kazunoko: Serial communication tool (separate repository)

    • datemaki: Data conversion + management tool (separate repository)

  • Clarified protocol differences and version-specific constraints


Is It Safe to Upgrade?#

Backward Compatible: Yes

  • Documentation-only update, no code changes

  • v1 functionality completely unchanged

  • All existing tests pass (379 unit tests)

  • No impact on v1 or v2 operations


Tests Passed#

  • ✅ v1 unit tests: 379 passed

  • ✅ Package builds successfully

  • ✅ CLI functionality verified

  • ✅ All pre-commit hooks passed

  • ✅ Documentation formatting validated


Release Details#

  • Date: 2025-12-29

  • Version: v1.9.4

  • Files Changed: 1 (CLAUDE.md)

  • Commits: 3 commits

    • b80945d: Add kurikintons firmware compatibility information

    • 67ee190: Document detailed kurikintons firmware compatibility

    • eee7501: Document DAQ framework architecture and subsystem integration


Next Steps#

  • v2 development continues with kazunoko and datemaki subsystem integration

  • CLAUDE.md now serves as authoritative reference for framework architecture

  • Plan v2 alpha release with subsystem integration