Architecture Decision Records¶
This directory contains the Architecture Decision Records (ADRs) for the cosalette framework. ADRs document significant architectural decisions with their context, rationale, and consequences.
ADR Index¶
| ADR | Title | Status | Date |
|---|---|---|---|
| ADR-001 | Framework Architecture Style | Accepted | 2026-02-14 |
| ADR-002 | MQTT Topic Conventions | Accepted | 2026-02-14 |
| ADR-003 | Configuration System | Accepted | 2026-02-14 |
| ADR-004 | Logging Strategy | Accepted | 2026-02-14 |
| ADR-005 | CLI Framework | Accepted | 2026-02-14 |
| ADR-006 | Hexagonal Architecture (Ports & Adapters) | Accepted | 2026-02-14 |
| ADR-007 | Testing Strategy | Accepted | 2026-02-14 |
| ADR-008 | Packaging and Distribution | Accepted | 2026-02-14 |
| ADR-009 | Python Version and Dependencies | Accepted | 2026-02-14 |
| ADR-010 | Device Archetypes | Accepted | 2026-02-14 |
| ADR-011 | Error Handling and Publishing | Accepted | 2026-02-14 |
| ADR-012 | Health and Availability Reporting | Accepted | 2026-02-14 |
| ADR-013 | Telemetry Publish Strategies | Accepted | 2026-02-22 |
| ADR-014 | Signal Filters | Accepted | 2026-02-22 |
| ADR-015 | Persistence | Accepted | 2026-02-25 |
| ADR-016 | Adapter Lifecycle Protocol | Accepted | 2026-02-26 |
| ADR-017 | SBOM Generation | Accepted | 2026-02-27 |
| ADR-018 | Telemetry Coalescing Groups | Accepted | 2026-03-03 |
| ADR-019 | Scoped Name Uniqueness | Accepted | 2026-03-04 |
| ADR-020 | Deferred Interval Resolution | Accepted | 2026-03-04 |
| ADR-021 | JSON Serialisation | Accepted | 2026-03-07 |
| ADR-022 | Rust-Only Signal Filters | Accepted | 2026-03-09 |
| ADR-023 | on_configure Lifecycle Phase and Dict-Name |
Accepted | 2026-03-31 |
| ADR-024 | Telemetry Retry with Configurable Backoff | Accepted | 2026-03-31 |
| ADR-025 | Command Channel and Sub-Topic Routing | Accepted | 2026-03-31 |
| ADR-026 | Immutable Releases | Accepted | 2026-04-02 |
| ADR-027 | Lifespan-Yielded Injectable State | Accepted | 2026-04-02 |
| ADR-028 | Adapter Health Check Protocol | Accepted | 2026-04-02 |
| ADR-029 | Adapter Auto-Restart Strategy | Accepted | 2026-04-03 |