gradatum-core 0.3.6

Shared primitives: errors, IDs, types
Documentation

gradatum-core

Shared primitives: traits, canonical types, and typed errors. The L0 foundation every other gradatum crate depends on.

Status: Alpha (v0.3.x) — public, Apache-2.0. API not yet stable before v1.0. Part of gradatum — memory backbone for AI agents. · github · gradatum.org

Overview

gradatum-core is the dependency floor of the gradatum workspace. It defines the canonical types (NoteId, TenantId, SectionId, ContentHash, Tag, Scope), the three storage traits (DocumentStore, IndexStore, VectorStore), the Index blanket trait, and the top-level GradatumError enum (typed with thiserror, no Box<dyn Error>).

Every other gradatum crate depends on gradatum-core; gradatum-core itself has zero workspace dependencies.

Usage

[dependencies]
gradatum-core = "0.3.6"

use gradatum_core::error::GradatumError;
use gradatum_core::note::{Note, NoteId};
use gradatum_core::section::SectionId;
use gradatum_core::trust::TrustContext;

Key Modules

Module Contents
error GradatumError — typed error enum
note Note, NoteId (ULID), NoteStatus, ContentHash
section SectionId — vault section identifier
tag Tag — normalized kebab-case note tag
author AuthorId — note authorship
identity TenantId — multi-tenancy identifier
trust TrustContext — auth context propagated through layers
scope Scope — JWT audience scopes (read / write / admin)
document_store DocumentStore trait — raw Markdown persistence
index IndexStore trait + Index blanket
config GradatumConfig — root configuration deserialization
frontmatter Frontmatter — YAML frontmatter canonical type
acl ACL filter types and visibility markers
audit AuditEntry — immutable append-only audit trail

License

Apache-2.0