aimdb-codegen 0.2.0

Code generation library for AimDB architecture agent — reads state.toml and emits Mermaid diagrams and Rust source
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

//! AimDB Codegen — architecture state to Mermaid and Rust source
//!
//! This library reads `.aimdb/state.toml` (the architecture agent's decision
//! record) and emits two artefacts:
//!
//! - **Mermaid diagram** — `.aimdb/architecture.mermaid`, a read-only graph
//!   projection of the architecture (see [`generate_mermaid`])
//! - **Rust source** — `src/generated_schema.rs`, compilable AimDB schema
//!   using the actual 0.5.x API (see [`generate_rust`])
//!
//! # Usage
//!
//! ```rust
//! use aimdb_codegen::{ArchitectureState, generate_mermaid, generate_rust, validate};
//!
//! let toml = r#"
//! [meta]
//! aimdb_version = "0.5.0"
//! created_at = "2026-02-22T14:00:00Z"
//! last_modified = "2026-02-22T14:00:00Z"
//!
//! [[records]]
//! name = "Temperature"
//! buffer = "SpmcRing"
//! capacity = 128
//! key_prefix = "sensor."
//! key_variants = ["room1"]
//! producers = ["sensor_task"]
//! consumers = ["dashboard"]
//!
//! [[records.fields]]
//! name = "celsius"
//! type = "f64"
//! description = "Temperature in Celsius"
//! "#;
//!
//! let state = ArchitectureState::from_toml(toml).unwrap();
//!
//! let errors = validate(&state);
//! assert!(errors.iter().all(|e| e.severity != validate::Severity::Error));
//!
//! let mermaid = generate_mermaid(&state);
//! assert!(mermaid.contains("flowchart LR"));
//!
//! let rust = generate_rust(&state);
//! assert!(rust.contains("pub struct TemperatureValue"));
//! ```

pub mod mermaid;
pub mod rust;
pub mod state;
pub mod validate;

// ── Convenience re-exports ────────────────────────────────────────────────────

pub use mermaid::generate_mermaid;
pub use rust::{
    generate_binary_cargo_toml, generate_cargo_toml, generate_hub_cargo_toml, generate_hub_main_rs,
    generate_hub_schema_rs, generate_hub_tasks_rs, generate_lib_rs, generate_main_rs,
    generate_rust, generate_schema_rs, generate_tasks_rs,
};
pub use rust::{to_pascal_case, to_snake_case};
pub use state::{
    ArchitectureState, BinaryDef, BufferType, ConnectorDef, ConnectorDirection, DecisionEntry,
    ExternalConnectorDef, FieldDef, Meta, ObservableDef, ProjectDef, RecordDef, SerializationType,
    TaskDef, TaskIo, TaskType,
};
pub use validate::{is_valid, validate, Severity, ValidationError};