Expand description
§gradatum-core
Shared primitives: traits, canonical types, errors. The L0 crate every other Gradatum crate depends on.
§Stability
0.x — no API stability guarantee. All public traits are tagged
[#[stability::unstable]] or [#[stability::experimental]].
See the versioning policy.
§Contents
Shared primitives used across all Gradatum crates: note identity (identity),
canonical frontmatter (frontmatter), provenance and trust scoring (provenance,
trust), JCS-canonical hashing (history), job types and the QueueStore trait
(job), storage traits (DocumentStore, IndexStore, VectorStore),
ACL evaluation (acl), and error types (error).
§Multi-tenancy invariant
Every persisted row carries tenant_id TEXT NOT NULL.
Default tenant: "main". Aliased to vault in user-facing UI/CLI/SDK.
Enforced at storage layer; ACL filters by tenant_id first.
Re-exports§
pub use job::job_kind_str;pub use job::ConflictStrategy;pub use job::CurateSpec;pub use job::DryRunAware;pub use job::EmbedSpec;pub use job::ExportFormat;pub use job::ExportSource;pub use job::ForgetScope;pub use job::ForgetSpec;pub use job::GradatumJob;pub use job::IngestInputSource;pub use job::IngestSource;pub use job::IngestStrategy;pub use job::Job;pub use job::JobClass;pub use job::JobError;pub use job::JobFilter;pub use job::JobLifecycle;pub use job::JobLineage;pub use job::JobMode;pub use job::JobOutput;pub use job::JobOutputFile;pub use job::JobPriority;pub use job::JobProgress;pub use job::JobRecord;pub use job::JobResult;pub use job::JobRetry;pub use job::JobScheduling;pub use job::JobScope;pub use job::JobSource;pub use job::JobSpec;pub use job::JobStatus;pub use job::JobTrigger;pub use job::JobWorkspace;pub use job::MigrateMode;pub use job::MigrateSource;pub use job::NotifyChannel;pub use job::NotifySource;pub use job::PurgeMode;pub use job::PurgeSpec;pub use job::QueueError;pub use job::QueueEvent;pub use job::QueueStore;pub use job::ReIndexMode;pub use job::RetryBackoff;pub use job::TriggerCondition;pub use job::TriggerSource;pub use job::VaultScope;pub use document_store::DocumentStore;pub use index_store::AuthorRow;pub use index_store::IndexStore;pub use index_store::Lineage;pub use index_store::SearchHitRaw;pub use vector_store::VectorStore;
Modules§
- acl
- Traits ACL (Access Control List) pour Gradatum.
- audit
- Événements d’audit typés pour le trail Gradatum.
- author
- Référence auteur typée multi-agent.
- config
- Configuration runtime chargée depuis
<vault_root>/.gradatum/config.toml. - document_
store - Contrat de stockage CRUD des notes (documents).
- error
- Taxonomie des erreurs Gradatum.
- event_
sink - Contrat d’émission d’événements engine, agnostique du transport.
- frontmatter
- Frontmatter canonique d’une note Gradatum.
- history
- F-40 — Hash d’historique pour le Copy-on-Write.
- identity
- Identity immutable : NoteId, ContentHash, NoteVersion, IntegritySignature.
- index
- Trait d’abstraction de l’index Gradatum.
- index_
store - Contrat de stockage et recherche full-text + overrides + checksums.
- job
- Types primitifs pour le système de jobs (ARCH-D15).
- note
- Note canonique Gradatum.
- overrides
- Override distribués — traits + types + FrontmatterPatch.
- provenance
- Provenance trust scores.
- schema_
registry - Registre de schémas d’overrides — embedded via
include_dir!. - scope
- Identifiants de scope pour les overrides distribués.
- secrets
- SecretsProvider — abstraction DI pour les secrets applicatifs (F-13).
- section
- Les 11 sections canoniques de Gradatum.
- status
- Cycle de vie d’une note Gradatum —
NoteStatus+ state machine. - tag
- Tag de note Gradatum — newtype String validé.
- trust
- Trust context — caveat C10 (design spec P2.0a).
- vector_
store - Contrat de stockage et recherche vectorielle.
Constants§
- VERSION
- Crate version (from
workspace.package.version).