Merge release/aimdb-v0.3.0 into main

Release v0.3.0 - RecordId/RecordKey Architecture & Buffer Metrics

Major features:
- Multi-instance records with RecordId/RecordKey system
- Buffer metrics API (feature-gated)
- Enhanced introspection APIs
- O(1) record access optimization

See docs/releases/v0.3.0.md for complete details.

Author: lxsaah

Cargo.lock

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

Cargo.toml

@@ -11,8 +11,8 @@
 [![Docs](https://docs.rs/aimdb-core/badge.svg)](https://docs.rs/aimdb-core)
 [![Website](https://img.shields.io/badge/website-aimdb.dev-blue.svg)](https://aimdb.dev)
 
-> **⚠️ PRE-RELEASE v0.2.0**  
-> AimDB v0.2.0 includes core functionality, MQTT/KNX connectors, and developer tools. The architecture is stable, but APIs may evolve based on community feedback. Production use is possible but proceed with caution and thorough testing.
+> **⚠️ PRE-RELEASE v0.3.0**  
+> AimDB v0.3.0 includes core functionality, multi-instance records, buffer metrics, MQTT/KNX connectors, and developer tools. The architecture is stable, but APIs may evolve based on community feedback. Production use is possible but proceed with caution and thorough testing.
 
 > **One codebase. Any hardware. Always in sync.**
 
@@ -45,21 +45,24 @@ Modern IoT stacks are fragmented:
 
 ---
 
-## 🎉 What's New in v0.2.0
+## 🎉 What's New in v0.3.0
 
-**Latest Release** - November 21, 2025
+**Latest Release** - December 6, 2025
 
 Recent additions and improvements:
 
+- ✅ **Multi-Instance Records**: Register multiple records of the same type with unique keys
+- ✅ **RecordId/RecordKey Architecture**: O(1) stable indexing with zero-allocation static keys
+- ✅ **Buffer Metrics**: Comprehensive metrics for monitoring and debugging (feature-gated)
+- ✅ **Enhanced Introspection**: New APIs for runtime record exploration (NEW in v0.3.0)
 - ✅ **Type-Safe Core**: `TypeId`-based record routing eliminates runtime string lookups
 - ✅ **Dual Runtime**: Works on both Tokio (std) and Embassy (no_std/embedded)
 - ✅ **Three Buffer Types**: SPMC Ring, SingleLatest, and Mailbox patterns
 - ✅ **MQTT Integration**: Connector works in both std and embedded environments
-- ✅ **KNX Integration**: Building automation support for std and embedded (NEW in v0.2.0)
+- ✅ **KNX Integration**: Building automation support for std and embedded
 - ✅ **Remote Access**: AimX protocol for cross-process introspection
 - ✅ **Sync API**: Blocking wrapper for non-async codebases
 - ✅ **Developer Tools**: MCP server for LLM-powered debugging, CLI tools, and client library
-- ✅ **Production Ready**: Comprehensive tests, CI/CD, security audits, and documentation
 
 See [CHANGELOG.md](CHANGELOG.md) for complete details.
 
@@ -72,30 +75,34 @@ Add AimDB to your project:
 ```toml
 # For standard library (Tokio runtime)
 [dependencies]
-aimdb-core = "0.2"
-aimdb-tokio-adapter = "0.2"
+aimdb-core = "0.3"
+aimdb-tokio-adapter = "0.3"
 
 # Optional: MQTT connector
-aimdb-mqtt-connector = { version = "0.2", features = ["tokio-runtime"] }
+aimdb-mqtt-connector = { version = "0.3", features = ["tokio-runtime"] }
 
 # Optional: KNX connector (building automation)
-aimdb-knx-connector = { version = "0.1", features = ["tokio-runtime"] }
+aimdb-knx-connector = { version = "0.2", features = ["tokio-runtime"] }
 
 # Optional: Synchronous API
-aimdb-sync = "0.2"
+aimdb-sync = "0.3"
 
 # Optional: Remote client
-aimdb-client = "0.2"
+aimdb-client = "0.3"
+
+# Optional: Enable buffer metrics
+# aimdb-core = { version = "0.3", features = ["metrics"] }
+# aimdb-tokio-adapter = { version = "0.3", features = ["metrics"] }
 ```
 
 For embedded systems using Embassy:
 
 ```toml
 [dependencies]
-aimdb-core = { version = "0.2", default-features = false }
-aimdb-embassy-adapter = { version = "0.2", default-features = false, features = ["embassy-runtime"] }
-aimdb-mqtt-connector = { version = "0.2", default-features = false, features = ["embassy-runtime"] }
-aimdb-knx-connector = { version = "0.1", default-features = false, features = ["embassy-runtime"] }
+aimdb-core = { version = "0.3", default-features = false }
+aimdb-embassy-adapter = { version = "0.3", default-features = false, features = ["embassy-runtime"] }
+aimdb-mqtt-connector = { version = "0.3", default-features = false, features = ["embassy-runtime"] }
+aimdb-knx-connector = { version = "0.2", default-features = false, features = ["embassy-runtime"] }
 ```
 
 ---
@@ -164,7 +171,7 @@ async fn main() -> DbResult<()> {
 
     let mut builder = AimDbBuilder::new().runtime(runtime);
 
-    builder.configure::<Temperature>(|reg| {
+    builder.configure::<Temperature>("sensor.temperature", |reg| {
         reg.buffer(BufferCfg::SpmcRing { capacity: 32 })
            .source(temperature_producer);
     });

README.md

@@ -1,6 +1,6 @@
 [package]
 name = "aimdb-client"
-version = "0.2.0"
+version = "0.3.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.2.0", path = "../aimdb-core", features = ["std"] }
+aimdb-core = { version = "0.3.0", path = "../aimdb-core", features = ["std"] }
 
 # Serialization
 serde = { version = "1", features = ["derive"] }

aimdb-client/Cargo.toml

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

aimdb-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "aimdb-embassy-adapter"
-version = "0.2.0"
+version = "0.3.0"
 edition = "2021"
 license.workspace = true
 repository.workspace = true
@@ -45,7 +45,7 @@ aimdb-executor = { version = "0.1.0", path = "../aimdb-executor", default-featur
 ] }
 
 # Core AimDB types - no_std for Embassy (for DbError integration)
-aimdb-core = { version = "0.2.0", path = "../aimdb-core", default-features = false }
+aimdb-core = { version = "0.3.0", path = "../aimdb-core", default-features = false }
 
 # Stream trait for bidirectional connectors (minimal, no_std compatible)
 futures-core = { version = "0.3", default-features = false }

aimdb-embassy-adapter/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "aimdb-knx-connector"
-version = "0.1.0"
+version = "0.2.0"
 edition = "2021"
 authors.workspace = true
 license.workspace = true
@@ -34,9 +34,9 @@ defmt = [
 ] # Only use knx-pico's defmt for logging
 
 [dependencies]
-aimdb-core = { version = "0.2.0", path = "../aimdb-core", default-features = false }
+aimdb-core = { version = "0.3.0", path = "../aimdb-core", default-features = false }
 aimdb-executor = { version = "0.1.0", path = "../aimdb-executor", default-features = false }
-aimdb-embassy-adapter = { version = "0.2.0", path = "../aimdb-embassy-adapter", default-features = false, optional = true }
+aimdb-embassy-adapter = { version = "0.3.0", path = "../aimdb-embassy-adapter", default-features = false, optional = true }
 
 # Use official crates.io version
 # External users should patch this to aimdb-dev/knx-pico fork until fixes are upstreamed

aimdb-knx-connector/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "aimdb-mqtt-connector"
-version = "0.2.0"
+version = "0.3.0"
 edition = "2021"
 authors.workspace = true
 license.workspace = true
@@ -38,9 +38,9 @@ tracing = ["dep:tracing", "aimdb-core/tracing"]
 defmt = ["dep:defmt", "aimdb-core/defmt"]
 
 [dependencies]
-aimdb-core = { version = "0.2.0", path = "../aimdb-core", default-features = false }
+aimdb-core = { version = "0.3.0", path = "../aimdb-core", default-features = false }
 aimdb-executor = { version = "0.1.0", path = "../aimdb-executor", default-features = false }
-aimdb-embassy-adapter = { version = "0.2.0", path = "../aimdb-embassy-adapter", default-features = false, optional = true }
+aimdb-embassy-adapter = { version = "0.3.0", path = "../aimdb-embassy-adapter", default-features = false, optional = true }
 
 # Error handling (std only)
 thiserror = { workspace = true, optional = true }

aimdb-mqtt-connector/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "aimdb-sync"
-version = "0.2.0"
+version = "0.3.0"
 edition = "2021"
 authors.workspace = true
 license.workspace = true
@@ -11,8 +11,8 @@ categories = ["database", "api-bindings"]
 
 [dependencies]
 # Core dependencies
-aimdb-core = { path = "../aimdb-core", version = "0.2.0" }
-aimdb-tokio-adapter = { path = "../aimdb-tokio-adapter", version = "0.2.0" }
+aimdb-core = { path = "../aimdb-core", version = "0.3.0" }
+aimdb-tokio-adapter = { path = "../aimdb-tokio-adapter", version = "0.3.0" }
 
 # Tokio for channels and runtime
 tokio = { version = "1.40", features = ["sync", "rt", "time"] }

aimdb-sync/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "aimdb-tokio-adapter"
-version = "0.2.0"
+version = "0.3.0"
 edition = "2021"
 authors.workspace = true
 license.workspace = true
@@ -35,7 +35,7 @@ aimdb-executor = { version = "0.1.0", path = "../aimdb-executor", default-featur
 ] }
 
 # Core AimDB types - std version for Tokio (for DbError integration)
-aimdb-core = { version = "0.2.0", path = "../aimdb-core", default-features = false, features = [
+aimdb-core = { version = "0.3.0", path = "../aimdb-core", default-features = false, features = [
     "std",
 ] }