README.md

Technical references

Architecture describes the current implementation. These references describe public interfaces, resource lifetimes and physical board constraints. Headers and behavioral tests should change with their docs.

Native apps

• App Runtime: start, event, render, stop and failure unwind
• App Manifest: build-time app composition
• App SDK: public C/C++ entry surface

Typed hardware services

• Shared rules
• Time
• Input
• Lights
• Display
• External Link

Camera and Storage use existing typed firmware services. They do not need additional public wrappers without a concrete consumer.

Other references

• Board Port
• Glossary
• Versioning
• HMPY Protocol
• MicroPython API
• External Link Protocol
• AI Model Package

Change process

Update affected headers, build inputs, consumers, tests and API documentation together. Explain observable changes and compatibility or migration impact in the change description. Preserve MicroPython API v1, HMPY and persisted data compatibility. Validate the affected behavior and hardware paths; documentation cleanup alone changes no wire or API constants.