chore: prepare v0.5.0 release (#76)

* chore: prepare v0.5.0 release

## Version bumps
- aimdb-core: 0.4.0 → 0.5.0
- aimdb-tokio-adapter: 0.4.0 → 0.5.0
- aimdb-embassy-adapter: 0.4.0 → 0.5.0
- aimdb-client: 0.4.0 → 0.5.0
- aimdb-sync: 0.4.0 → 0.5.0
- aimdb-mqtt-connector: 0.4.0 → 0.5.0
- aimdb-knx-connector: 0.2.0 → 0.3.0
- aimdb-cli: 0.4.0 → 0.5.0
- aimdb-mcp: 0.4.0 → 0.5.0
- workspace: 0.3.0 → 0.5.0

## New features in this release
- Transform API (Design 020): reactive single/multi-input data transforms
- Graph Introspection API (Design 021): dependency graph visualization
- Record Drain API (Design 019): non-blocking batch history access
- Persistence layer: aimdb-persistence + aimdb-persistence-sqlite (v0.1.0)
- Dynamic topic/destination routing (Design 018) for MQTT and KNX
- Graph commands in aimdb-cli (nodes, edges, order, dot export)
- Graph introspection tools in aimdb-mcp (graph_nodes, graph_edges, graph_topo_order)
- Drain tool in aimdb-mcp replacing subscription system

## Breaking changes
- aimdb-core: RecordId constructor now requires RecordOrigin parameter
- aimdb-core: .with_serialization() renamed to .with_remote_access()
- aimdb-core: set_from_json rejects writes on records with active transforms
- aimdb-mcp: subscription tools removed in favour of drain_record

* fix: remove aimdb-data-contracts version entry from changelog

Author: lxsaah

CHANGELOG.md

@@ -15,13 +15,85 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 > - [aimdb-knx-connector/CHANGELOG.md](aimdb-knx-connector/CHANGELOG.md)
 > - [aimdb-sync/CHANGELOG.md](aimdb-sync/CHANGELOG.md)
 > - [aimdb-client/CHANGELOG.md](aimdb-client/CHANGELOG.md)
+> - [aimdb-persistence/CHANGELOG.md](aimdb-persistence/CHANGELOG.md)
+> - [aimdb-persistence-sqlite/CHANGELOG.md](aimdb-persistence-sqlite/CHANGELOG.md)
 > - [tools/aimdb-cli/CHANGELOG.md](tools/aimdb-cli/CHANGELOG.md)
 > - [tools/aimdb-mcp/CHANGELOG.md](tools/aimdb-mcp/CHANGELOG.md)
 
 ## [Unreleased]
 
 No changes yet.
 
+## [0.5.0] - 2026-02-21
+
+### Added
+
+- **aimdb-persistence**: New crate providing a pluggable persistence layer for long-term record history
+  - `PersistenceBackend` trait with `store`, `query`, `cleanup`, and `initialize` hooks
+  - `AimDbBuilderPersistExt` trait adding `.with_persistence(backend, retention)` to `AimDbBuilder<R>`
+  - `RecordRegistrarPersistExt` trait adding `.persist(record_name)` to `RecordRegistrar<T, R>`
+  - `AimDbQueryExt` trait with `query_latest`, `query_range`, and `query_raw` methods
+  - Automatic 24-hour retention cleanup task registration
+- **aimdb-persistence-sqlite**: New crate providing a SQLite backend for `aimdb-persistence`
+  - `SqliteBackend` with WAL journal mode, actor-model command dispatch, and window-function queries
+  - Pattern-based queries with `*` wildcard support and optional time/row-count limits
+  - Dedicated OS writer thread; `Clone` = `O(1)` handle copy
+- **aimdb-data-contracts**: New crate for portable, versioned AimDB data schemas
+  - Optional features: `observable`, `simulatable`, `migratable`, `ts` (TypeScript bindings via `ts-rs`)
+  - Schema versioning and migration support
+- **Transform API (Design 020)** in `aimdb-core`: Reactive data transformations between records
+  - `transform_raw()` for single-input derivations and `transform_join_raw()` for multi-input joins
+  - `TransformBuilder` and `JoinBuilder` fluent APIs with optional stateful handlers
+  - Transforms spawned as tasks during `AimDb::build()`; mutual exclusion with `.source()` enforced
+- **Graph Introspection API (Design 021)** in `aimdb-core` and `aimdb-client`:
+  - `RecordOrigin` enum classifying record sources (`Source`, `Link`, `Transform`, `TransformJoin`, `Passive`)
+  - `GraphNode`, `GraphEdge`, `DependencyGraph` types for full graph representation
+  - `graph_nodes()`, `graph_edges()`, `graph_topo_order()` methods on `AimDb` and `AimDbClient`
+- **Record Drain API (Design 019)** in `aimdb-core`, `aimdb-tokio-adapter`, and `aimdb-client`:
+  - `try_recv()` on `BufferReader` for non-blocking batch pulls
+  - `record.drain` AimX protocol method with cold-start semantics and optional limit
+  - `DrainResponse` type in `aimdb-client`
+- **Dynamic Topic/Address Routing (Design 018)** in `aimdb-core`, `aimdb-mqtt-connector`, `aimdb-knx-connector`:
+  - `TopicProvider<T>` trait for per-message outbound topic/address determination
+  - `TopicResolverFn` for late-binding inbound topic resolution at connector startup
+  - `with_topic_provider()` and `with_topic_resolver()` builder methods on connector links
+- **Graph Tools** in `tools/aimdb-mcp`:
+  - `graph_nodes`, `graph_edges`, `graph_topo_order` MCP tools for LLM-powered graph exploration
+  - `drain_record` MCP tool for batch history access with persistent cold-start reader
+- **Graph Commands** in `tools/aimdb-cli`:
+  - `aimdb graph nodes`, `graph edges`, `graph order`, `graph dot` subcommands
+  - Color-coded output and DOT format export for Graphviz visualization
+- **Extension Macro** in `aimdb-core`: `impl_record_registrar_ext!` for generating runtime adapter extension traits
+
+### Changed
+
+- **aimdb-core**: Renamed `.with_serialization()` to `.with_remote_access()` for clearer semantics (breaking)
+- **aimdb-core**: `RecordId::new()` now requires a `RecordOrigin` parameter for dependency graph support (breaking)
+- **aimdb-core**: `set_from_json` now also rejects writes on records with active transforms
+- **aimdb-core**: `collect_outbound_routes()` returns `OutboundRoute` tuples with optional `TopicProviderFn`
+- **aimdb-core**: `collect_inbound_routes()` calls `link.resolve_topic()` for dynamic topic resolution
+- **tools/aimdb-mcp**: Replaced real-time subscription system with simpler drain-based polling
+  - Removed `subscribe_record`, `unsubscribe_record`, `list_subscriptions`, `get_notification_directory` tools
+  - Simplified architecture reduces infrastructure complexity for LLM clients
+
+### Published Crates
+
+| Crate | Previous | New |
+|-------|----------|-----|
+| `aimdb-core` | 0.4.0 | **0.5.0** |
+| `aimdb-tokio-adapter` | 0.4.0 | **0.5.0** |
+| `aimdb-embassy-adapter` | 0.4.0 | **0.5.0** |
+| `aimdb-client` | 0.4.0 | **0.5.0** |
+| `aimdb-sync` | 0.4.0 | **0.5.0** |
+| `aimdb-mqtt-connector` | 0.4.0 | **0.5.0** |
+| `aimdb-knx-connector` | 0.2.0 | **0.3.0** |
+| `aimdb-cli` | 0.4.0 | **0.5.0** |
+| `aimdb-mcp` | 0.4.0 | **0.5.0** |
+| `aimdb-persistence` | — | **0.1.0** (new) |
+| `aimdb-persistence-sqlite` | — | **0.1.0** (new) |
+| `aimdb-derive` | 0.1.0 | unchanged |
+| `aimdb-executor` | 0.1.0 | unchanged |
+
 ## [0.4.0] - 2025-12-25
 
 ### Added
@@ -469,7 +541,8 @@ https://github.com/aimdb-dev/aimdb
 
 ---
 
-[Unreleased]: https://github.com/aimdb-dev/aimdb/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/aimdb-dev/aimdb/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/aimdb-dev/aimdb/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/aimdb-dev/aimdb/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/aimdb-dev/aimdb/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/aimdb-dev/aimdb/compare/v0.1.0...v0.2.0

Cargo.lock

@@ -34,7 +34,7 @@ resolver = "2"
 default-members = ["aimdb-core"]
 
 [workspace.package]
-version = "0.3.0"
+version = "0.5.0"
 edition = "2021"
 authors = ["AimDB Team <team@aimdb.dev>"]
 license = "Apache-2.0"

Cargo.toml

@@ -294,47 +294,55 @@ publish:
 	else \
 		printf "$(BLUE)Running in CI mode - skipping confirmation$(NC)\n"; \
 	fi
-	@printf "$(YELLOW)  → Publishing aimdb-executor (1/11)$(NC)\n"
+	@printf "$(YELLOW)  → Publishing aimdb-executor (1/13)$(NC)\n"
 	@cargo publish -p aimdb-executor
 	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
 	@sleep 10
-	@printf "$(YELLOW)  → Publishing aimdb-derive (2/11)$(NC)\n"
+	@printf "$(YELLOW)  → Publishing aimdb-derive (2/13)$(NC)\n"
 	@cargo publish -p aimdb-derive
 	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
 	@sleep 10
-	@printf "$(YELLOW)  → Publishing aimdb-core (3/11)$(NC)\n"
+	@printf "$(YELLOW)  → Publishing aimdb-core (3/13)$(NC)\n"
 	@cargo publish -p aimdb-core
 	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
 	@sleep 10
-	@printf "$(YELLOW)  → Publishing aimdb-tokio-adapter (4/11)$(NC)\n"
+	@printf "$(YELLOW)  → Publishing aimdb-tokio-adapter (4/13)$(NC)\n"
 	@cargo publish -p aimdb-tokio-adapter
 	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
 	@sleep 10
-	@printf "$(YELLOW)  → Publishing aimdb-embassy-adapter (5/11)$(NC)\n"
+	@printf "$(YELLOW)  → Publishing aimdb-embassy-adapter (5/13)$(NC)\n"
 	@cargo publish -p aimdb-embassy-adapter --no-verify
 	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
 	@sleep 10
-	@printf "$(YELLOW)  → Publishing aimdb-client (6/11)$(NC)\n"
+	@printf "$(YELLOW)  → Publishing aimdb-client (6/13)$(NC)\n"
 	@cargo publish -p aimdb-client
 	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
 	@sleep 10
-	@printf "$(YELLOW)  → Publishing aimdb-sync (7/11)$(NC)\n"
+	@printf "$(YELLOW)  → Publishing aimdb-sync (7/13)$(NC)\n"
 	@cargo publish -p aimdb-sync
 	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
 	@sleep 10
-	@printf "$(YELLOW)  → Publishing aimdb-mqtt-connector (8/11)$(NC)\n"
+	@printf "$(YELLOW)  → Publishing aimdb-persistence (8/13)$(NC)\n"
+	@cargo publish -p aimdb-persistence
+	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
+	@sleep 10
+	@printf "$(YELLOW)  → Publishing aimdb-persistence-sqlite (9/13)$(NC)\n"
+	@cargo publish -p aimdb-persistence-sqlite
+	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
+	@sleep 10
+	@printf "$(YELLOW)  → Publishing aimdb-mqtt-connector (10/13)$(NC)\n"
 	@cargo publish -p aimdb-mqtt-connector
 	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
 	@sleep 10
-	@printf "$(YELLOW)  → Publishing aimdb-knx-connector (9/11)$(NC)\n"
+	@printf "$(YELLOW)  → Publishing aimdb-knx-connector (11/13)$(NC)\n"
 	@cargo publish -p aimdb-knx-connector
 	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
 	@sleep 10
-	@printf "$(YELLOW)  → Publishing aimdb-cli (10/11)$(NC)\n"
+	@printf "$(YELLOW)  → Publishing aimdb-cli (12/13)$(NC)\n"
 	@cargo publish -p aimdb-cli
 	@printf "$(YELLOW)  → Waiting 10s for crates.io propagation...$(NC)\n"
 	@sleep 10
-	@printf "$(YELLOW)  → Publishing aimdb-mcp (11/11)$(NC)\n"
+	@printf "$(YELLOW)  → Publishing aimdb-mcp (13/13)$(NC)\n"
 	@cargo publish -p aimdb-mcp
 	@printf "$(GREEN)✓ All crates published successfully!$(NC)\n"
 	@printf "$(BLUE)🎉 AimDB v$(shell grep '^version' Cargo.toml | head -1 | cut -d '"' -f 2) is now live on crates.io!$(NC)\n"

Makefile

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+No changes yet.
+
+## [0.5.0] - 2026-02-21
+
 ### Added
 
 - **Record Drain API**: New methods for batch history access
@@ -57,7 +61,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-[Unreleased]: https://github.com/aimdb-dev/aimdb/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/aimdb-dev/aimdb/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/aimdb-dev/aimdb/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/aimdb-dev/aimdb/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/aimdb-dev/aimdb/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/aimdb-dev/aimdb/compare/v0.1.0...v0.2.0

aimdb-client/CHANGELOG.md

@@ -1,6 +1,6 @@
 [package]
 name = "aimdb-client"
-version = "0.4.0"
+version = "0.5.0"
 edition = "2021"
 license.workspace = true
 repository.workspace = true
@@ -11,7 +11,7 @@ categories = ["database", "network-programming"]
 
 [dependencies]
 # Core dependencies - protocol types from aimdb-core
-aimdb-core = { version = "0.4.0", path = "../aimdb-core", features = ["std"] }
+aimdb-core = { version = "0.5.0", path = "../aimdb-core", features = ["std"] }
 
 # Serialization
 serde = { version = "1", features = ["derive"] }

aimdb-client/Cargo.toml

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+No changes yet.
+
+## [0.5.0] - 2026-02-21
+
 ### Added
 
 - **Transform API (Design 020)**: Reactive data transformations between records
@@ -35,13 +39,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Supports `SpmcRing` (full history), `SingleLatest` (at most 1), `Mailbox` (at most 1)
   - Handler maintains per-connection drain readers via `ConnectionState`
 - **Extension Macro**: `impl_record_registrar_ext!` macro in `ext_macros.rs` for generating runtime adapter extension traits
-
-### Changed
-
-- **Renamed `.with_serialization()` to `.with_remote_access()`**: Clearer naming for JSON serialization configuration
-- **`RecordId` constructor**: Now requires `RecordOrigin` parameter for dependency graph support
-- **`set_from_json` protection**: Now also rejects writes on records with active transforms (in addition to sources)
-
 - **Dynamic Topic/Destination Routing (Design 018)**: Complete support for dynamic topic resolution
   - **Outbound (`TopicProvider` trait)**: Dynamically determine MQTT topics or KNX group addresses based on data being published
     - New `TopicProvider<T>` trait for type-safe topic determination
@@ -63,6 +60,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- **Renamed `.with_serialization()` to `.with_remote_access()`**: Clearer naming for JSON serialization configuration
+- **`RecordId` constructor**: Now requires `RecordOrigin` parameter for dependency graph support
+- **`set_from_json` protection**: Now also rejects writes on records with active transforms (in addition to sources)
 - **Outbound Route Collection**: `collect_outbound_routes()` now returns `OutboundRoute` tuples with optional `TopicProviderFn`
 - **Inbound Topic Resolution**: `collect_inbound_routes()` now calls `link.resolve_topic()` instead of `link.url.resource_id()` directly, enabling dynamic topic resolution
 
@@ -255,7 +255,8 @@ warning fires if you exceed 1000 interned keys.
 
 ---
 
-[Unreleased]: https://github.com/aimdb-dev/aimdb/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/aimdb-dev/aimdb/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/aimdb-dev/aimdb/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/aimdb-dev/aimdb/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/aimdb-dev/aimdb/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/aimdb-dev/aimdb/compare/v0.1.0...v0.2.0

aimdb-core/CHANGELOG.md

@@ -1,6 +1,6 @@
 [package]
 name = "aimdb-core"
-version = "0.4.0"
+version = "0.5.0"
 edition = "2021"
 license.workspace = true
 repository.workspace = true