Release notes from aimdb

v1.0.0

2026-03-16T21:49:11Z

AimDB v1.0.0 Release Notes

Stable core API, real-time browser streaming, and LLM-driven architecture design!

Async in-memory database for MCU → edge → cloud data synchronization

🎯 Highlights

This release promotes aimdb-core to 1.0.0 — declaring a stable public API for the core database engine. It also ships four entirely new crates: a WebSocket connector for real-time browser streaming, a WASM adapter for running AimDB in the browser, a code generation library for architecture-to-code workflows, and a shared wire protocol for the WebSocket ecosystem. The MCP server gains a full architecture agent for LLM-driven system design, and the CLI adds code generation and live monitoring commands.

Headline: MCU → Edge → Cloud → Browser — AimDB now spans the full stack.

Extensible Streamable registry — the Streamable type dispatch system has been redesigned from a closed dispatcher to an open, extensible registry pattern. Users now register their own types via .register::<T>() on connector and adapter builders. Concrete contracts (Temperature, Humidity, GpsLocation) have moved to application-level crates.

✨ Major Features

🌐 WebSocket Connector (New Crate)

Real-time bidirectional streaming to browsers and between AimDB instances!

use aimdb_tokio_adapter::TokioAdapter;
use aimdb_websocket_connector::WebSocketConnector;

let db = AimDbBuilder::new()
    .runtime(TokioAdapter::new())
    .with_connector(
        WebSocketConnector::new()
            .bind("0.0.0.0:8080")
            .path("/ws")
            .with_late_join(true),
    );

// Push records to browser clients
builder.configure::<Temperature>(AppKey::Temp, |reg| {
    reg.buffer(BufferCfg::SingleLatest)
       .link_to("ws://temperature");  // ← streams to all subscribers
});

Two modes:

🖥️ Server mode (Axum-based) — accept incoming WebSocket connections via link_to("ws://topic")
🔗 Client mode (tokio-tungstenite) — connect out to remote servers via link_to("ws-client://host/topic") for AimDB-to-AimDB sync without a broker
🔐 Authentication via pluggable AuthHandler trait
📡 MQTT-style wildcards — # multi-level, * single-level topic matching
⏱️ Late-join — new subscribers receive current values immediately
📋 StreamableRegistry — extensible type-erased dispatch via .register::<T>() with schema-name collision detection

🕸️ WASM Adapter (New Crate)

Run AimDB in the browser — full dataflow engine via WebAssembly!

import { useRecord, useBridge } from 'aimdb-wasm-adapter/react';

function TemperatureDashboard() {
    const bridge = useBridge("ws://localhost:8080/ws");
    const temp = useRecord<Temperature>(bridge, "sensor.temperature");

    return <div>Current: {temp?.celsius}°C</div>;
}

Features:

🏗️ Full aimdb-executor trait implementations (RuntimeAdapter, Spawn, TimeOps, Logger)
🪶 Rc<RefCell<…>> buffers — zero-overhead for single-threaded WASM
🎯 WasmDb facade via #[wasm_bindgen]: configureRecord, get, set, subscribe
🌉 WsBridge — WebSocket bridge connecting browser to remote AimDB server
⚛️ React hooks: useRecord<T>, useSetRecord<T>, useBridge
📋 SchemaRegistry for type-erased record dispatch with extensible .register::<T>() API
no_std + alloc compatible (wasm32-unknown-unknown target)

📋 Data Contracts — Pure Trait Crate

aimdb-data-contracts refocused as a pure trait-definition crate (version reset to 0.1.0).

Trait definitions for self-describing data schemas that work identically across MCU, edge, and cloud:

SchemaType — unique identity and versioning
Streamable — capability marker for types crossing serialization boundaries
Linkable — wire format for connector transport
Simulatable — test data generation
Observable — signal extraction for monitoring
Migratable — schema evolution with MigrationChain and MigrationStep

Concrete contracts (Temperature, Humidity, GpsLocation) and the closed StreamableVisitor dispatcher have been removed — see Breaking Changes below.

🏗️ Code Generation (New Crate)

Architecture-to-code: generate Rust source and Mermaid diagrams from .aimdb/state.toml!

# Generate Mermaid architecture diagram
aimdb generate mermaid

# Generate Rust schema code
aimdb generate schema

# Scaffold a new common crate
aimdb generate common-crate

# Scaffold a hub binary crate
aimdb generate hub-crate

aimdb-codegen features:

📄 ArchitectureState type for reading .aimdb/state.toml decision records
📊 Mermaid diagram generation from architecture state
🦀 Rust source generation — value structs, key enums, SchemaType/Linkable impls, configure_schema() functions
🏗️ Common crate, hub crate, and binary crate scaffolding
✅ State validation module for architecture integrity checks

🤖 Architecture Agent (MCP)

LLM-driven system design — propose, validate, and apply architecture changes through conversation!

The MCP server now includes a full architecture agent with a session state machine:

Idle → Gathering → Proposing → Resolve

16+ new MCP tools:

Tool	Description
`propose_add_record`	Add a new record to the architecture
`propose_add_connector`	Add a connector (MQTT, WebSocket, etc.)
`propose_modify_buffer`	Change buffer type/capacity
`propose_modify_fields`	Modify record fields
`propose_modify_key_variants`	Change key variants
`remove_record`	Remove a record
`rename_record`	Rename a record
`reset_session`	Reset agent session state
`resolve_proposal`	Apply or reject pending proposals
`save_memory`	Persist architecture decisions
`validate_against_instance`	Validate architecture against running instance
`get_architecture`	Get current architecture state
`get_buffer_metrics`	Get buffer performance metrics

Architecture MCP resources provide Mermaid diagrams and validation results as live resources.

📡 Wire Protocol (New Crate)

Shared wire protocol types for the WebSocket ecosystem.

aimdb-ws-protocol provides ServerMessage and ClientMessage enums used by both the WebSocket connector (server side) and the WASM adapter (browser side). JSON-encoded with "type" discriminant tag.

🔧 Other Changes

aimdb-core

Added ws:// and wss:// URL scheme support in ConnectorUrl for WebSocket connectors
ConnectorUrl::default_port() now handles WebSocket schemes
ConnectorUrl::is_secure() includes wss://

aimdb-cli

New aimdb generate subcommand for code generation via aimdb-codegen
New aimdb watch subcommand for live record monitoring

Dependency Updates

aimdb-knx-connector 0.3.1 — Updated Embassy dependency versions (executor 0.10.0, time 0.5.1, sync 0.8.0, futures 0.1.2, net 0.9.0)
aimdb-mqtt-connector 0.5.1 — Updated Embassy dependency versions (executor 0.10.0, time 0.5.1, sync 0.8.0, net 0.9.0)
Embassy submodules updated to latest upstream commits

📦 Published Crates

New Crates

🆕 [email protected] — real-time bidirectional WebSocket streaming
🆕 [email protected] — shared wire protocol types
🆕 [email protected] — WebAssembly runtime adapter with React hooks
🆕 [email protected] — architecture-to-code generation

Updated

Crate	Previous	New
`aimdb-core`	0.5.0	1.0.0
`aimdb-data-contracts`	0.5.0	0.1.0 (reset — pure trait crate)
`aimdb-cli`	0.5.0	0.6.0
`aimdb-mcp`	0.5.0	0.6.0
`aimdb-mqtt-connector`	0.5.0	0.5.1
`aimdb-knx-connector`	0.3.0	0.3.1

Unchanged

⚠️ Breaking Changes

aimdb-data-contracts: Concrete contracts removed from this crate. If you depended on Temperature, Humidity, or GpsLocation from aimdb-data-contracts, define them in your own application crate or shared common crate (see examples/weather-mesh-demo/weather-mesh-common for a reference).
aimdb-data-contracts: for_each_streamable() and StreamableVisitor removed. Use .register::<T>() on connector/adapter builders instead.
aimdb-data-contracts: ts feature removed (ts-rs dependency dropped).
aimdb-data-contracts: Version reset from 1.0.0 to 0.1.0 to reflect the reduced, stabilizing scope as a pure trait crate.

🖥️ New CLI Commands

# Code generation
aimdb generate mermaid           # Generate Mermaid architecture diagram
aimdb generate schema            # Generate Rust schema code
aimdb generate common-crate      # Scaffold a common crate
aimdb generate hub-crate         # Scaffold a hub binary crate

# Live monitoring
aimdb watch <record>             # Watch live record updates

🚀 Migration Guide

Step 1: Update dependencies

[dependencies]
aimdb-core = "1.0"
aimdb-data-contracts = "0.1"  # reset — now a pure trait crate
aimdb-tokio-adapter = "0.5"   # unchanged
# Optional: add WebSocket streaming
aimdb-websocket-connector = "0.1"
# Optional: add WASM support
aimdb-wasm-adapter = "0.1"

Step 2: Move concrete contracts to your crate

If you used Temperature, Humidity, or GpsLocation from aimdb-data-contracts, copy them into your own application or shared common crate. See examples/weather-mesh-demo/weather-mesh-common for a working example.

Step 3: Replace `StreamableVisitor` with `.register::<T>()`

// Before (closed dispatcher):
// for_each_streamable(visitor);

// After (extensible registry):
let connector = WebSocketConnector::new()
    .register::<Temperature>()
    .register::<Humidity>()
    .register::<GpsLocation>();

Step 4: No other breaking API changes

The 0.5.0 → 1.0.0 upgrade for aimdb-core has no breaking changes — only additive features (WebSocket URL scheme support). All existing code continues to compile unchanged.

Step 5: Try the new tools

# Update CLI
cargo install aimdb-cli

# Generate architecture diagrams from running instances
aimdb generate mermaid

# Watch live data
aimdb watch sensor.temperature

📚 Examples

All examples updated for v1.0.0:

git clone https://github.com/aimdb-dev/aimdb.git && cd aimdb

# MQTT connector demo
cargo run -p tokio-mqtt-connector-demo

# Weather mesh demo (multi-station with WebSocket streaming)
cargo run -p weather-hub

# Sync API demo
cargo run -p sync-api-demo

# Embedded (cross-compile)
cd examples/embassy-mqtt-connector-demo
cargo build --release --target thumbv7em-none-eabihf

📖 New Design Documents

023 — Architecture Agent: LLM-powered session-based architecture design workflow
024 — Codegen Common Crate: Architecture state to compilable Rust source
025 — WASM Adapter: Full browser runtime design with React integration

🤝 Contributing

git clone https://github.com/aimdb-dev/aimdb.git
cd aimdb
make check  # fmt + clippy + test + embedded + wasm cross-compile

📄 License

Apache License 2.0 — see LICENSE.

v0.5.0 - Transforms, Persistence, Graph Introspection & Dynamic Routing

2026-02-22T18:45:08Z

AimDB v0.5.0 Release Notes

Transforms, persistence, graph introspection, and dynamic routing!

🎯 What's New in v0.5.0

This release introduces reactive data transformations, a pluggable persistence layer, a dependency graph introspection API, and dynamic topic/address routing for connectors. It also ships two new crates (aimdb-persistence, aimdb-persistence-sqlite).

✨ Major Features

🔄 Transform API (Design 020)

Reactive data transformations between records — computed values that update automatically!

use aimdb_core::{AimDbBuilder, RecordKey};

// Single-input transform: derive Fahrenheit from Celsius
builder.configure::<Celsius>(AppKey::TempCelsius, |reg| {
    reg.buffer(BufferCfg::SingleLatest);
});

builder.configure::<Fahrenheit>(AppKey::TempFahrenheit, |reg| {
    reg.transform_raw(AppKey::TempCelsius, |c: Celsius| {
        Fahrenheit { value: c.value * 9.0 / 5.0 + 32.0 }
    });
});

// Multi-input join: combine humidity + temperature into comfort index
builder.configure::<ComfortIndex>(AppKey::Comfort, |reg| {
    reg.transform_join_raw(|join| {
        join.input::<Celsius>(AppKey::TempCelsius)
            .input::<Humidity>(AppKey::Humidity)
            .on_trigger(|trigger, state| {
                // Called whenever any input changes
                Some(ComfortIndex::compute(state))
            })
    });
});

Features:

🔗 Single-input transform_raw() for simple derivations
🔗 Multi-input transform_join_raw() with JoinTrigger event dispatch
🔒 Mutual exclusion: a record cannot have both .source() and .transform()
🚀 Automatic spawning: transforms run as async tasks during AimDb::build()
🔍 Tracing integration: full lifecycle event logging

📊 Graph Introspection API (Design 021)

Visualize the dependency graph of your AimDB instance!

// Get full dependency graph
let nodes = db.graph_nodes();
let edges = db.graph_edges();
let order = db.graph_topo_order();

// Nodes show origin type and buffer config
for node in &nodes {
    println!("{}: {:?} ({:?})", node.key, node.origin, node.buffer_info);
}

// Edges show data flow
for edge in &edges {
    println!("{} → {} ({:?})", edge.from, edge.to, edge.edge_type);
}

RecordOrigin variants:

Source — direct producer writes
Link — connector-bridged external data
Transform — single-input reactive derivation
TransformJoin — multi-input reactive join
Passive — no producer (consumer-only)

Also available via aimdb-client and aimdb-mcp tools.

💾 Persistence Layer (New Crates)

Long-term record history with pluggable backends!

use aimdb_persistence::AimDbBuilderPersistExt;
use aimdb_persistence_sqlite::SqliteBackend;

// Set up SQLite persistence with 7-day retention
let backend = SqliteBackend::new("./aimdb_history.db")?;
builder.with_persistence(backend, Duration::from_secs(7 * 24 * 3600));

// Mark records to persist
builder.configure::<Temperature>(AppKey::Temp, |reg| {
    reg.buffer(BufferCfg::SingleLatest)
       .persist("sensor.temperature");  // ← stored to SQLite
});

let db = builder.build().await?;

// Query historical data
let last_100 = db.query_latest::<Temperature>("sensor.*", Some(100)).await;
let this_week = db.query_range::<Temperature>(
    "sensor.*",
    week_start_ms,
    week_end_ms,
    None,  // no per-record limit
).await;

aimdb-persistence features:

PersistenceBackend trait — implement your own storage
Automatic retention cleanup task (24-hour interval)
query_latest, query_range, query_raw APIs

aimdb-persistence-sqlite features:

WAL journal mode for concurrent reads
Window-function queries for efficient top-N per record
* wildcard pattern matching
Actor-model writer thread; Clone = O(1) handle copy

🌐 Dynamic Topic/Address Routing (Design 018)

Resolve MQTT topics or KNX group addresses at runtime based on data values!

// Outbound: per-message topic from payload
builder.configure::<SensorReading>(AppKey::Reading, |reg| {
    reg.link_to("mqtt://broker/sensors/default")
       .with_topic_provider(|reading: &SensorReading| {
           format!("sensors/{}/data", reading.sensor_id)
       });
});

// Inbound: late-binding topic from config/discovery
builder.configure::<Command>(AppKey::Command, |reg| {
    reg.link_from("mqtt://broker/")
       .with_topic_resolver(|| {
           // Called once at connector startup
           format!("commands/{}", load_device_id())
       });
});

Works in both std and no_std + alloc environments.

📡 Record Drain API (Design 019)

Non-blocking batch pull for accumulated history — perfect for LLM analysis!

// Via AimDbClient (remote access)
let response = client.drain_record("sensor.temperature").await?;
println!("Drained {} values", response.count);
// First call is always empty (cold start — creates the reader)
// Subsequent calls return everything since last drain

Cold-start semantics: the first drain call creates a reader and returns empty. Subsequent calls return all values accumulated since the previous drain. This enables stateful batch analysis without missing data.

💥 Breaking Changes

1. `.with_serialization()` → `.with_remote_access()`

// Before (v0.4.x)
reg.buffer(...).with_serialization();

// After (v0.5.0)
reg.buffer(...).with_remote_access();

2. `RecordId::new()` requires `RecordOrigin`

This affects custom buffer/record implementations only:

// Before (v0.4.x)
RecordId::new(type_id, idx)

// After (v0.5.0)
RecordId::new(type_id, idx, RecordOrigin::Source)

3. MCP subscription tools removed

The subscribe_record, unsubscribe_record, list_subscriptions, and get_notification_directory MCP tools have been replaced by drain_record. Update any LLM prompts or MCP tool configurations accordingly.

📦 Published Crates

New Crates

🆕 [email protected] — pluggable persistence layer
🆕 [email protected] — SQLite backend for persistence

Updated

Crate	Version
`aimdb-core`	0.5.0
`aimdb-tokio-adapter`	0.5.0
`aimdb-embassy-adapter`	0.5.0
`aimdb-client`	0.5.0
`aimdb-sync`	0.5.0
`aimdb-mqtt-connector`	0.5.0
`aimdb-knx-connector`	0.3.0
`aimdb-cli`	0.5.0
`aimdb-mcp`	0.5.0

Unchanged

[email protected]
[email protected]

🔧 New MCP Tools

The aimdb-mcp server now provides these tools:

Tool	Description
`discover_instances`	Find running AimDB servers
`list_records`	List all records with metadata
`get_record`	Get current value
`set_record`	Set writable record value
`query_schema`	Infer JSON Schema from value
`get_instance_info`	Server version and capabilities
`drain_record`	Batch pull accumulated history
`graph_nodes`	All graph nodes with origin/buffer info
`graph_edges`	Directed data-flow edges
`graph_topo_order`	Topological record ordering

🖥️ New CLI Commands (`aimdb graph`)

# List all graph nodes (color-coded by origin)
aimdb graph nodes

# Show directed data-flow edges
aimdb graph edges

# Show topological (spawn) order
aimdb graph order

# Export to Graphviz DOT format
aimdb graph dot > pipeline.dot
dot -Tsvg pipeline.dot -o pipeline.svg

🚀 Migration Guide

Step 1: Update dependencies

[dependencies]
aimdb-core = "0.5.0"
aimdb-tokio-adapter = "0.5.0"
# Optional: add persistence
aimdb-persistence = "0.1.0"
aimdb-persistence-sqlite = "0.1.0"

Step 2: Rename `.with_serialization()` → `.with_remote_access()`

# Quick find & replace
grep -rn "with_serialization" src/
# Replace with:
#   .with_remote_access()

Step 3: Update `RecordId::new()` calls (custom buffer implementations only)

// Add RecordOrigin argument
RecordId::new(type_id, idx, RecordOrigin::Source)

Step 4: Update MCP tool usage

Replace subscribe_record / unsubscribe_record workflows with drain_record polling:

# Old: subscribe → wait → unsubscribe
# New: call drain_record periodically (first call always empty)
drain_record(socket_path: "...", record_name: "sensor.*")

📚 Examples

All examples updated for v0.5.0:

git clone https://github.com/aimdb-dev/aimdb.git && cd aimdb

# MQTT connector demo
cargo run -p tokio-mqtt-connector-demo

# KNX connector demo
cargo run -p tokio-knx-connector-demo

# Sync API demo
cargo run -p sync-api-demo

# Weather mesh demo (multi-station)
cargo run -p weather-hub

# Embedded (cross-compile)
cd examples/embassy-mqtt-connector-demo
cargo build --release --target thumbv7em-none-eabihf

🤝 Contributing

git clone https://github.com/aimdb-dev/aimdb.git
cd aimdb
make check  # fmt + clippy + test + embedded cross-compile

📄 License

Apache License 2.0 — see LICENSE.

aimdb-tokio-adapter-v0.5.0

2026-02-22T18:44:40Z

aimdb-tokio-adapter v0.5.0

aimdb-sync-v0.5.0

2026-02-22T18:44:40Z

aimdb-sync v0.5.0

aimdb-persistence-v0.1.0

2026-02-22T18:44:40Z

aimdb-persistence v0.1.0

aimdb-persistence-sqlite-v0.1.0

2026-02-22T18:44:40Z

aimdb-persistence-sqlite v0.1.0

aimdb-mqtt-connector-v0.5.0

2026-02-22T18:44:40Z

aimdb-mqtt-connector v0.5.0

aimdb-mcp-v0.5.0

2026-02-22T18:44:40Z

aimdb-mcp v0.5.0

aimdb-knx-connector-v0.3.0

2026-02-22T18:44:40Z

aimdb-knx-connector v0.3.0

aimdb-embassy-adapter-v0.5.0

2026-02-22T18:44:40Z

aimdb-embassy-adapter v0.5.0

Release notes from aimdb

v1.0.0

AimDB v1.0.0 Release Notes

🎯 Highlights

✨ Major Features

🌐 WebSocket Connector (New Crate)

🕸️ WASM Adapter (New Crate)

📋 Data Contracts — Pure Trait Crate

🏗️ Code Generation (New Crate)

🤖 Architecture Agent (MCP)

📡 Wire Protocol (New Crate)

🔧 Other Changes

aimdb-core

aimdb-cli

Dependency Updates

📦 Published Crates

New Crates

Updated

Unchanged

⚠️ Breaking Changes

🖥️ New CLI Commands

🚀 Migration Guide

Step 1: Update dependencies

Step 2: Move concrete contracts to your crate

Step 3: Replace StreamableVisitor with .register::<T>()

Step 4: No other breaking API changes

Step 5: Try the new tools

📚 Examples

📖 New Design Documents

🤝 Contributing

📄 License

v0.5.0 - Transforms, Persistence, Graph Introspection & Dynamic Routing

AimDB v0.5.0 Release Notes

🎯 What's New in v0.5.0

✨ Major Features

🔄 Transform API (Design 020)

📊 Graph Introspection API (Design 021)

💾 Persistence Layer (New Crates)

🌐 Dynamic Topic/Address Routing (Design 018)

📡 Record Drain API (Design 019)

💥 Breaking Changes

1. .with_serialization() → .with_remote_access()

2. RecordId::new() requires RecordOrigin

3. MCP subscription tools removed

📦 Published Crates

New Crates

Updated

Unchanged

🔧 New MCP Tools

🖥️ New CLI Commands (aimdb graph)

🚀 Migration Guide

Step 1: Update dependencies

Step 2: Rename .with_serialization() → .with_remote_access()

Step 3: Update RecordId::new() calls (custom buffer implementations only)

Step 4: Update MCP tool usage

📚 Examples

🤝 Contributing

📄 License

aimdb-tokio-adapter-v0.5.0

aimdb-sync-v0.5.0

aimdb-persistence-v0.1.0

aimdb-persistence-sqlite-v0.1.0

aimdb-mqtt-connector-v0.5.0

aimdb-mcp-v0.5.0

aimdb-knx-connector-v0.3.0

aimdb-embassy-adapter-v0.5.0

Step 3: Replace `StreamableVisitor` with `.register::<T>()`

1. `.with_serialization()` → `.with_remote_access()`

2. `RecordId::new()` requires `RecordOrigin`

🖥️ New CLI Commands (`aimdb graph`)

Step 2: Rename `.with_serialization()` → `.with_remote_access()`

Step 3: Update `RecordId::new()` calls (custom buffer implementations only)