8 runtime adapter integration #1

[lxsaah]

Closes #8.

Changelog: Runtime Adapter Integration

Overview

This PR implements comprehensive runtime adapter integration for AimDB, enabling seamless async operations across both standard (Tokio) and embedded (Embassy) runtimes. This addresses issue #8 and establishes the foundation for AimDB's cross-platform async capabilities.

🎯 Major Features

1. Unified Runtime Abstraction Layer

• Created aimdb-executor crate with runtime-agnostic traits:
  • RuntimeAdapter - Core runtime identification
  • Spawn - Dynamic task spawning capabilities
  • TimeOps - Unified time operations (now, duration, sleep)
  • Logger - Runtime-appropriate logging
  • Runtime - Composite trait combining all capabilities
• Feature-gated compilation for std, tokio-runtime, and embassy-runtime

2. Tokio Runtime Integration (aimdb-tokio-adapter)

• Full std runtime support with Tokio executor
• Implements all executor traits:
  • Dynamic task spawning with tokio::spawn
  • Time operations using tokio::time
  • Logging via tracing crate
• TokioDatabase with unified builder API
• Comprehensive example in examples/tokio-runtime-demo

3. Embassy Runtime Integration (aimdb-embassy-adapter)

• no_std embedded runtime support
• Implements executor traits for Embassy:
  • Static task spawning (via #[embassy_executor::task])
  • Time operations using embassy_time
  • Logging via defmt
• EmbassyDatabase with spawner-aware builder
• Complete example in examples/embassy-runtime-demo (STM32H563ZI target)

4. Enhanced Core Database (aimdb-core)

• New RuntimeContext for unified runtime access
• Emitter pattern for cross-record communication
• Typed record storage using TypeId for type safety
• Metrics tracking with tracked_fn macro
• Producer-consumer pattern with self-registering records
• Generic Database<A> over any runtime adapter
• Builder pattern API for ergonomic database construction

5. Shared Examples Infrastructure

• Created aimdb-examples-shared crate with reusable service implementations
• data_processor_service - Demonstrates async data processing
• monitoring_service - Shows metrics collection
• Services work across both Tokio and Embassy runtimes via RuntimeContext

🔧 Technical Improvements

Error Handling

• Enhanced DbError with runtime-specific variants
• ExecutorError for runtime operation failures
• Proper error propagation with tracing context preservation
• Conversion traits between error types

Time Operations

• Runtime-agnostic duration methods (millis, secs, micros)
• Unified sleep interface across runtimes
• TimeSource trait with instant comparisons

Logging

• Abstracted logging via Logger trait
• tracing for std environments
• defmt for embedded targets
• Runtime context provides convenient logging accessors

Build System

• Updated Makefile with:
  • examples target for building all examples
  • Improved all command includes examples
  • Feature validation tests
• CI enhancements:
  • Submodule support for Embassy dependency
  • Documentation generation
  • Multiple target testing

📦 New Crates & Modules

New Crates

1. aimdb-executor - Runtime trait definitions
2. aimdb-tokio-adapter - Tokio runtime implementation
3. aimdb-embassy-adapter - Embassy runtime implementation (refactored)
4. aimdb-examples-shared - Shared service code

New Modules in aimdb-core

• runtime.rs - Runtime context and base traits
• emitter.rs - Cross-record communication
• metrics.rs - Performance tracking
• producer_consumer.rs - Producer-consumer pattern
• tracked_fn.rs - Async function tracking
• typed_record.rs - Type-safe record storage

🧪 Examples & Demos

Producer-Consumer Demo (examples/producer-consumer-demo)

• Demonstrates typed record usage
• Shows producer-consumer pattern
• Metrics tracking with tracked_fn
• Emitter-based communication

Tokio Runtime Demo (examples/tokio-runtime-demo)

• Full Tokio integration
• Service spawning with RuntimeContext
• Standard Rust async/await patterns

Embassy Runtime Demo (examples/embassy-runtime-demo)

• STM32H563ZI target (Cortex-M33)
• Embedded async with Embassy executor
• LED feedback for visual status
• StaticCell for safe static initialization

[Copilot]

Pull Request Overview

This PR implements runtime adapter integration for AimDB, establishing the foundation for async task execution across different runtime environments (Tokio and Embassy). The implementation includes core traits for runtime and time operations, along with concrete adapters for both std and no_std environments.

Key changes:

• Core runtime and time traits defining the adapter interface
• Tokio adapter for std environments with full async runtime support
• Embassy adapter for embedded/no_std environments with Embassy executor integration

Reviewed Changes

Copilot reviewed 12 out of 13 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
aimdb-core/src/lib.rs	Exports new runtime and time traits
aimdb-core/src/runtime.rs	Defines core RuntimeAdapter and DelayCapableAdapter traits
aimdb-core/src/time.rs	Implements TimestampProvider and SleepCapable traits with utilities
aimdb-core/Cargo.toml	Adds tokio dev dependency for async testing
aimdb-tokio-adapter/src/lib.rs	Updates module structure and documentation for runtime integration
aimdb-tokio-adapter/src/runtime.rs	Implements TokioAdapter with RuntimeAdapter and DelayCapableAdapter
aimdb-tokio-adapter/src/time.rs	Provides Tokio-specific time implementations
aimdb-tokio-adapter/Cargo.toml	Adds tracing and futures dependencies
aimdb-embassy-adapter/src/lib.rs	Exports new runtime and time modules
aimdb-embassy-adapter/src/runtime.rs	Implements EmbassyAdapter for embedded environments
aimdb-embassy-adapter/src/time.rs	Provides Embassy-specific time implementations
aimdb-embassy-adapter/Cargo.toml	Adds tracing and testing dependencies

[Copilot]

Pull Request Overview

Copilot reviewed 56 out of 57 changed files in this pull request and generated 6 comments.