new-crate

name	new-crate
description	Scaffold a new crate in the axiomdb workspace — create, wire to workspace, write initial test, update architecture.md

/new-crate — Scaffold a crate in the workspace

Complete process

1. Create the crate

cd /home/familia/axiomdb
cargo new --lib crates/axiomdb-NAME

2. Standard crate structure

crates/axiomdb-NAME/
├── Cargo.toml
├── src/
│   ├── lib.rs          ← only public re-exports and crate doc
│   ├── error.rs        ← DbError with thiserror
│   └── [modules].rs
└── tests/
    └── integration.rs  ← integration tests

3. New crate's Cargo.toml

[package]
name    = "axiomdb-NAME"
version = "0.1.0"
edition = "2021"

[dependencies]
# Use workspace versions when defined
axiomdb-core = { path = "../axiomdb-core" }
thiserror = { workspace = true }
tracing   = { workspace = true }

[dev-dependencies]
criterion = { version = "0.5", features = ["html_reports"] }
tempfile  = "3"

4. Minimal src/lib.rs

//! # axiomdb-NAME
//!
//! [One-line description of what this crate does]
//!
//! ## Example
//! ```rust
//! use axiomdb_name::MyTrait;
//! // minimal example
//! ```

mod error;
pub use error::Error;

// Public traits first
pub trait MyTrait: Send + Sync {
    fn operation(&self) -> Result<(), Error>;
}

5. Add to root workspace Cargo.toml

[workspace]
members = [
    # ... existing ...
    "crates/axiomdb-NAME",   # ← add here in alphabetical order
]

6. Verify no dependency cycle

cargo tree --workspace 2>&1 | grep -E "axiomdb-NAME|error\[E"

7. Initial compiling test

// tests/integration.rs
use axiomdb_name::MyTrait;

#[test]
fn crate_compiles_and_trait_exists() {
    // Just verify it compiles for now
    // Real tests are added in the implementation phase
}

cargo test -p axiomdb-NAME

8. Update memory/architecture.md

## Implemented crates
- `axiomdb-NAME` — [one-line description] (Phase N)

Checklist

[ ] cargo new --lib executed
[ ] crate's Cargo.toml with correct dependencies
[ ] Added to workspace members
[ ] src/lib.rs with documented public traits
[ ] Initial test compiling
[ ] cargo test -p axiomdb-NAME passes
[ ] cargo clippy -p axiomdb-NAME -- -D warnings passes
[ ] architecture.md updated