Skip to main content

Module v2

Module v2 

Source
Expand description

V2 clustered edge kernel implementation.

This module implements the Phase 14 redesign with compact edge records and clustered adjacency for optimal I/O locality and storage efficiency.

§V2 Modules

  • edge_cluster: Compact edge records with clustered adjacency
  • kv_store: Transactional key-value store with MVCC
  • pubsub: In-process pub/sub with ID-only events
  • storage: Delta index and MVCC support
  • wal: Write-Ahead Log with commit sequencing
  • snapshot: Multi-version concurrency control
  • free_space: Contiguous allocation management
  • backup/restore: Backup and recovery utilities

Re-exports§

pub use backup::BackupConfig;
pub use backup::BackupResult;
pub use backup::backup;
pub use backup::create_backup;
pub use edge_cluster::CompactEdgeRecord;
pub use edge_cluster::Direction;
pub use edge_cluster::EdgeCluster;
pub use edge_cluster::EdgeRecordCompactExt;
pub use export::ExportConsistencyReport;
pub use export::ExportFactory;
pub use export::ExportManifest;
pub use export::ExportResult;
pub use export::V2ExportConfig;
pub use export::V2Exporter;
pub use free_space::FreeSpaceManager;
pub use import::ImportFactory;
pub use import::ImportMode;
pub use import::ImportResult;
pub use import::ImportValidationReport;
pub use import::ImportValidator;
pub use import::PostImportValidator;
pub use import::SnapshotImportConfig;
pub use import::SnapshotImportResult;
pub use import::SnapshotImportValidationReport;
pub use import::SnapshotImporter;
pub use import::V2ImportConfig;
pub use import::V2Importer;
pub use kv_store::KvEntry;
pub use kv_store::KvMetadata;
pub use kv_store::KvStore;
pub use kv_store::KvStoreError;
pub use kv_store::KvValue;
pub use migration::FormatVersion;
pub use migration::MigrationResult;
pub use migration::detect_format_version;
pub use migration::migrate_file;
pub use node_record_v2::NodeRecordV2;
pub use node_record_v2::NodeRecordV2Ext;
pub use planner::DecisionReason;
pub use planner::ExportPlanner;
pub use planner::PlannerDecision;
pub use planner::WalAnalysis;
pub use pubsub::PubSubEvent;
pub use pubsub::PubSubEventType;
pub use pubsub::SubscriptionFilter;
pub use restore::RestoreConfig;
pub use restore::RestoreResult;
pub use restore::restore;
pub use restore::restore_backup;
pub use storage::DeltaIndex;
pub use storage::DeltaRecord;
pub use storage::JsonLimits;
pub use storage::JsonValidationError;
pub use storage::SharedDeltaIndex;
pub use storage::parse_and_validate_json;
pub use storage::parse_and_validate_json_str;
pub use string_table::StringTable;
pub use wal::GraphOperationResult;
pub use wal::GraphWALIntegrationConfig;
pub use wal::IsolationLevel;
pub use wal::NodeRecordV2WALExt;
pub use wal::OperationMetrics;
pub use wal::V2GraphWALIntegrator;
pub use wal::V2WALConfig;
pub use wal::V2WALHeader;
pub use wal::V2WALManager;
pub use wal::V2WALRecord;
pub use wal::V2WALRecordType;
pub use wal::WALManagerMetrics;

Modules§

backup
Database backup API for SQLiteGraph
edge_cluster
Edge clustering primitives for the V2 storage kernel.
export
V2 Export Module for SQLiteGraph
free_space
Free space management rewritten as small modules (<300 LOC each).
import
V2 Import Module for SQLiteGraph
kv_store
Transactional Key-Value Store Module
migration
File format migration for SQLiteGraph
node_record_v2
V2 node record implementation (V1 conversion removed).
performance_targets
Expected performance targets for V2 format
planner
Minimal Export/Import Planner for SQLiteGraph V2
pubsub
In-process pub/sub for SQLiteGraph
restore
Database restore API for SQLiteGraph
snapshot
SQLiteGraph V2 Snapshot Management Module
storage
Storage module for V2 backend
string_table
Shared string table split into focused modules to satisfy the ≤300 LOC rule.
wal
Write-Ahead Logging (WAL) for V2 clustered edge format.

Structs§

ValidationMetrics
Validation utilities for V2 format compliance

Constants§

V2_FORMAT_VERSION
V2_MAGIC
V2 magic bytes for file format identification (SAME AS V1 - magic never changes!)

Functions§

rebuild_v2_index_if_enabled