Crate gradatum_vault 

gradatum-vault

Vault domain logic : registry + lifecycle + overrides + drift + effective_note cache.

Couche L2 de l’architecture Gradatum — composition au-dessus des couches L1 :

• gradatum-core : primitives, traits, erreurs.
• gradatum-markdown : parse + write .md.
• gradatum-cache : EffectiveNoteCache moka.
• gradatum-index : SqliteIndex impl Index trait.
• gradatum-storage : FileStorage OpenDAL.

Modules

• registry : Vault::create / Vault::open — layout init, tenant_id, handles.
• lifecycle : write_note — ContentHash + persist .md + upsert index.
• overrides : NoteMetadataOverride — Overridable + OverridePayload impl.
• drift : drift_check — scan Phase A via gradatum-index::scan_phase_a.
• effective_note : get_effective_note — cache moka avec validation checksum.
• history : NoteHistoryEntry — entrée d’historique CoW.
• error : VaultError — erreurs typées sans Box<dyn Error>.

Stabilité

0.x — aucune garantie de stabilité API. Voir RELEASE-POLICY.md.

Re-exports

pub use error::VaultError;

pub use history::NoteHistoryEntry;

pub use lifecycle::HISTORY_DIR_PREFIX;

pub use overrides::NoteMetadataOverride;

pub use registry::Vault;

pub use write::WriteResult;

Modules

drift

Détection de drift entre l’index SQLite et les fichiers .md sur disque.

effective_note

Cache EffectiveNote avec validation de checksum sur hit.

error

Erreurs propres au crate gradatum-vault.

history

Historique des versions d’une note — NoteHistoryEntry.

lifecycle

Lifecycle CRUD des notes — création, persistance, mise à jour de statut.

overrides

Override de métadonnées de note — NoteMetadataOverride.

registry

Vault registry — création, ouverture et accès au vault root.

write

F-41 — Optimistic locking.

Constants

VERSION

Crate version (from workspace.package.version).

Traits

Registry

Trait d’accès registre vault — exposé à AppState pour découpler le serveur de l’implémentation concrète Vault.