feat(typed_digraph): derive Clone on TypedDiGraph, bump 3.0.7

Author: oldnordic

CHANGELOG.md

@@ -1,5 +1,12 @@
 # SQLiteGraph Changelog
 
+## [3.0.7] - 2026-05-29
+
+### Added
+
+- **TypedDiGraph Clone derive** — `TypedDiGraph<N, E>` now implements `Clone`
+  (requires `N: Clone, E: Clone`).
+
 ## [3.0.6] - 2026-05-29
 
 ### Added

docs/CONTRIBUTING.md

@@ -40,7 +40,7 @@ cargo build --workspace
 cargo test --workspace
 
 # Run with Native V2 feature
-cargo build --workspace --features native-v2
+cargo build --workspace --features native-v3
 ```
 
 ### Development Tools
@@ -200,7 +200,7 @@ impl GraphBackend for MyBackend {
 
 ```bash
 # All tests
-cargo test --workspace --features native-v2
+cargo test --workspace --features native-v3
 
 # Integration tests
 cargo test --test api_ergonomics_tests
@@ -488,7 +488,7 @@ Brief description of changes.
 6. Add to MANUAL.md Section 4
 7. Add CLI command if applicable
 
-### Adding to Native V2 Backend
+### Adding to Native V3 Backend
 
 1. Understand the V2 format (see ARCHITECTURE.md)
 2. Update WAL records if adding new operations
@@ -521,7 +521,7 @@ Brief description of changes.
 Include:
 - Minimal reproduction case
 - Rust version (`rustc --version`)
-- Backend used (SQLite or Native V2)
+- Backend used (SQLite or Native V3)
 - Error messages and stack traces
 - Expected vs actual behavior
 

docs/INDEX.md

@@ -36,7 +36,7 @@ This index provides navigation for all SQLiteGraph documentation.
    - Performance benchmarks
 
 2. **[MANUAL.md](../MANUAL.md)** - Detailed guide
-   - Backend selection (SQLite vs Native V2)
+   - Backend selection (SQLite vs Native V3)
    - Core operations
    - Graph algorithms
    - Vector search (HNSW)
@@ -60,7 +60,7 @@ This index provides navigation for all SQLiteGraph documentation.
 | **Vector Search** | MANUAL.md | HNSW Vector Search |
 | **Pub/Sub Events** | MANUAL.md | Section 14: Pub/Sub Events |
 | **Error Handling** | MANUAL.md | Error Handling |
-| **Migration** | MIGRATION.md | SQLite to Native V2 |
+| **Migration** | MIGRATION.md | SQLite to Native V3 |
 | **Troubleshooting** | TROUBLESHOOTING.md | Common Issues |
 | **Design Philosophy** | PHILOSOPHY.md | Principles |
 

docs/PHILOSOPHY.md

@@ -35,7 +35,7 @@ The core principles that guide SQLiteGraph's development.
 
 **Examples:**
 
-### Clustered Storage (Native V2)
+### Clustered Storage (Native V3)
 
 We *could* make clustered storage faster with:
 - Complex rebalancing algorithms
@@ -99,7 +99,7 @@ Full MVCC includes:
 
 **Why two backends:**
 
-| SQLite Backend | Native V2 Backend |
+| SQLite Backend | Native V3 Backend |
 |----------------|-------------------|
 | Proven reliability | Performance for star patterns |
 | Ecosystem tooling | Smaller file sizes |
@@ -188,7 +188,7 @@ Each command:
 
 | Limitation | Why It Exists | Plan |
 |------------|---------------|------|
-| ~2,048 nodes (Native V2) | 8MB node region keeps format simple | V3 backend with dynamic allocation |
+| ~2,048 nodes (Native V3) | 8MB node region keeps format simple | V3 backend with dynamic allocation |
 | Single writer | Simplifies concurrency | Future: multi-writer with conflict resolution |
 | No distributed queries | Embedded-only design | Not planned |
 | Chain traversal regression (V2) | Cluster lookup overhead | Not planned; use SQLite for chains |
@@ -333,11 +333,11 @@ txn.commit()?;  // Clear when data is written
 
 ```toml
 # Bad: Features enabled by default
-sqlitegraph = "1.5.7"  # What features are enabled?
+sqlitegraph-core = "3.0"  # What features are enabled?
 
 # Good: Explicit opt-in
-sqlitegraph = { version = "1.5.7", features = ["native-v2"] }
-sqlitegraph = "1.5.7"  # SQLite only, no features
+sqlitegraph = { version = "1.5.7", features = ["native-v3"] }
+sqlitegraph-core = "3.0"  # SQLite only, no features
 ```
 
 ### No Global State

docs/TESTING.md

@@ -169,7 +169,7 @@ cargo test test_bfs_traversal
 cargo test --test bfs_tests
 
 # Run tests with Native V2 feature
-cargo test --workspace --features native-v2
+cargo test --workspace --features native-v3
 
 # Run tests with debug output
 cargo test --workspace --features debug
@@ -552,7 +552,7 @@ The project uses GitHub Actions for CI. Key workflows:
 
 ```bash
 # Run what CI runs
-cargo test --workspace --features native-v2
+cargo test --workspace --features native-v3
 cargo test --workspace --doc
 cargo clippy -- --deny warnings
 ```
@@ -588,7 +588,7 @@ cargo clippy -- --deny warnings
 cargo install cargo-tarpaulin
 
 # Generate coverage report
-cargo tarpaulin --workspace --features native-v2 --out Html
+cargo tarpaulin --workspace --features native-v3 --out Html
 
 # Open report
 open tarpaulin-report.html

docs/TROUBLESHOOTING.md

@@ -47,9 +47,9 @@ vcpkg install sqlite3
 # Then set SQLITE3_LIB_PATH environment variable
 ```
 
-### "Feature native-v2 not found"
+### "Feature native-v3 not found"
 
-**Symptom:** Build fails with `error: unused manifest key: sqlitegraph/native-v2`
+**Symptom:** Build fails with `error: unused manifest key: sqlitegraph-core/native-v3`
 
 **Cause:** Native V2 is a feature flag, not a separate crate.
 
@@ -58,7 +58,7 @@ vcpkg install sqlite3
 ```toml
 # In your Cargo.toml
 [dependencies]
-sqlitegraph = { version = "1.5.7", features = ["native-v2"] }
+sqlitegraph = { version = "3.0", features = ["native-v3"] }
 ```
 
 ### "Functionality mismatch: expected 7, found 5" (Internal)
@@ -125,7 +125,7 @@ for handle in handles {
 }
 ```
 
-**Solution (Native V2):** Native V2 also serializes writes via WAL. Use a similar approach.
+**Solution (Native V2):** Native V3 also serializes writes via WAL. Use a similar approach.
 
 ### "Node not found: 12345"
 
@@ -222,7 +222,7 @@ println!("Cache hits: {}/{}", stats.cache_hits(), stats.cache_lookups());
    }
    ```
 
-3. **Consider Native V2 for star-pattern graphs:**
+3. **Consider Native V3 for star-pattern graphs:**
    ```bash
    # Benchmark both backends
    time sqlitegraph --backend sqlite --db mygraph.db bfs --start 1 --max-depth 5
@@ -282,8 +282,8 @@ let graph = open_graph("mygraph.db", &cfg)?;
    let graph = open_graph("mygraph.db", &cfg)?;
    ```
 
-3. **Use Native V2 for write-heavy workloads:**
-   - Native V2: 1.3-3.2x faster inserts
+3. **Use Native V3 for write-heavy workloads:**
+   - Native V3: 1.3-3.2x faster inserts
 
 ---
 
@@ -400,7 +400,7 @@ let value = graph.kv_get(&key)?;
 **Solution:** Upgrade to latest version:
 ```toml
 [dependencies]
-sqlitegraph = "1.5.7"
+sqlitegraph-core = "3.0"
 ```
 
 If the issue persists, the database may be corrupted:

sqlitegraph-cli/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sqlitegraph-cli"
-version = "3.0.6"
+version = "3.0.7"
 edition = "2021"
 description = "Command-line interface for SQLiteGraph — embedded graph and vector runtime with Cypher-inspired queries"
 license = "GPL-3.0-only"
@@ -20,7 +20,7 @@ name = "sqlitegraph"
 path = "src/main.rs"
 
 [dependencies]
-sqlitegraph = { path = "../sqlitegraph-core", version = "3.0.6", default-features = false }
+sqlitegraph = { path = "../sqlitegraph-core", version = "3.0.7", default-features = false }
 serde_json = "1"
 clap = { version = "4", features = ["derive"] }
 anyhow = "1"

sqlitegraph-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sqlitegraph"
-version = "3.0.6"
+version = "3.0.7"
 edition = "2024"
 rust-version = "1.89"
 description = "Embedded graph database with full ACID transactions, HNSW vector search, dual backend support, and comprehensive graph algorithms library"

sqlitegraph-core/src/typed_digraph/graph.rs

@@ -36,12 +36,14 @@ impl From<usize> for EdgeIndex {
     }
 }
 
+#[derive(Clone)]
 struct EdgeEntry<E> {
     from: usize,
     to: usize,
     weight: Option<E>,
 }
 
+#[derive(Clone)]
 pub struct TypedDiGraph<N, E> {
     nodes: Vec<Option<N>>,
     edges: Vec<Option<EdgeEntry<E>>>,

sqlitegraph-py/Cargo.toml

@@ -16,7 +16,7 @@ default = []
 inference = ["dep:numpy", "dep:ndarray"]
 
 [dependencies]
-sqlitegraph = { version = "3.0.6", path = "../sqlitegraph-core" }
+sqlitegraph = { version = "3.0.7", path = "../sqlitegraph-core" }
 pyo3 = { version = "0.28", features = ["extension-module", "abi3-py310"] }
 serde_json = "1"
 numpy = { version = "0.28", optional = true }