memstead_base/
lib.rs

1//! Backend-agnostic graph kernel for Memstead.
2//!
3//! Hosts the parts of the engine that do not assume a git-backed
4//! storage: token-budget chunking, workspace-root utilities, the
5//! entity types and markdown pipeline (parse / generate / write), the
6//! in-memory store, graph queries and community detection, the mem
7//! router, the operation request/response types (including the
8//! gix-free read paths in `ops::health` / `ops::search`), the search
9//! index, validators, and rendering.
10//!
11//! Consumers that need only graph operations against directory or
12//! archive storage depend on this crate alone — its dependency closure
13//! does not include `gix`. Code that needs git-backed mems depends on
14//! `memstead-git-branch`, which builds on `memstead-base`.
15
16pub mod anchor;
17pub mod backend;
18pub mod binding;
19pub mod binding_migrate;
20pub mod build_info;
21pub mod check;
22pub mod chunking;
23pub mod derivation;
24pub mod domain_authority_wire;
25pub mod engine;
26pub mod entity;
27pub mod filesystem;
28pub mod friction;
29pub mod graph;
30pub mod ingest;
31pub mod markdown;
32pub mod mem;
33pub mod mem_management;
34pub mod ops;
35pub mod overview;
36pub mod pipeline;
37pub mod pipeline_edit;
38pub mod pipeline_migrate;
39pub mod pipeline_store;
40pub mod preparation;
41pub mod provenance;
42pub mod render;
43pub mod runtime_validator;
44pub mod schema_source;
45#[cfg(not(target_arch = "wasm32"))]
46pub mod search_index;
47pub mod section_format;
48pub mod storage;
49pub mod store;
50pub mod validator;
51pub mod vcs;
52pub mod workspace;
53pub mod workspace_root;
54pub mod workspace_store;
55
56use std::sync::Arc;
57
58use memstead_schema::{TypeDefinition, type_by_name};
59
60pub use anchor::{
61    ANCHOR_SIDECAR_PATH, Anchor, AnchorGrain, AnchorHashStability, AnchorInput,
62    AnchorProvenanceClass, AnchorSidecar, AnchorState, AnchorValidationError, AnchorVersion,
63    ArtifactObservation, EntityAnchorComposition, INVALID_ANCHOR_CODE, compose_entity_anchors,
64    resolve_anchor,
65};
66pub use backend::{BackendError, MemBackend};
67pub use binding_migrate::{
68    BindingMigrateError, LegacyBindingV1, MigratedBinding, check_all_consumed, fold_v1_binding,
69    migrate_gen2_bindings,
70};
71pub use engine::{
72    BackendFactory, BootError, CreateEntityArgs, CreateEntityOutcome, DeleteEntityArgs,
73    DeleteEntityOutcome, DeleteReferrers, Engine, EngineError, EntityHistoryReport, EntityTouch,
74    FromArchiveBytesError, GitBranchBranchResetFn, GitBranchChangesSinceFn, GitBranchDiffFn,
75    GitBranchExportFn, GitBranchExportToBytesFn, GitBranchFetchFn, GitBranchOps, GitBranchPullFn,
76    GitBranchPushFn, GitBranchReadTreeFn, HISTORY_PAGE_DEFAULT, HISTORY_PAGE_MAX, INLINE_LIST_CAP,
77    MutationClock, ReferrerInfo, RelateAction, RelateEntityArgs, RelateEntityOutcome,
78    RenameEntityArgs, RenameEntityOutcome, ReviewMarkStatus, SchemaSourceDiagnostic, SchemaStaging,
79    SetReviewMarkOutcome, StoryStart, UpdateEntityArgs, UpdateEntityOutcome,
80    format_inline_list_overflow,
81};
82pub use entity::id::{ENTITY_ID_MAX_LEN, SlugError, TITLE_GRAMMAR_RULE};
83pub use entity::{Entity, EntityId, MetadataValue, ParseResult, Relationship};
84pub use graph::{ClusterInfo, LouvainOutput};
85pub use mem::{MEM_META_DIR, MemOrigin, MemRouterSnapshot};
86
87/// The engine crate SEMVER of the running binary. Version-carrying
88/// surfaces — the per-mem mutation stamp (`MemConfig.mutation_stamp`),
89/// the boot-time `ENGINE_VERSION_SKEW` comparison, the overview's
90/// `_engine_version`, CLI `--version`, MCP `serverInfo.version` — use
91/// [`build_info::full_version`] instead (semver plus the git build sha
92/// when present), so dev builds between releases stay distinguishable;
93/// this constant is the bare semver component.
94pub const ENGINE_VERSION: &str = env!("CARGO_PKG_VERSION");
95pub use mem_management::{CreateRuleSet, DeleteRuleSet, MatcherSet, MatcherSetError};
96pub use ops::{
97    BackendChanges, BatchEntry, BatchError, BatchResult, ChangeEnvelope, ChangesReport,
98    ContextResult, CreateArgs, CreateResult, DeleteResult, EMPTY_TREE_SHA, ExportResult, Facets,
99    HealthReport, HealthSummary, ListResult, MemExportResult, ModifiedMetadata, ModifiedSections,
100    Query, RENAME_SIMILARITY_DEFAULT, RENAME_SIMILARITY_MAX, RENAME_SIMILARITY_MIN, RelateArg,
101    RelateResult, ReloadReport, ReloadResult, RenameResult, SearchHit, SearchResult, SearchScope,
102    SetMemVersionOutcome, UpdateArgs, UpdateResult, WarningHint,
103};
104pub use pipeline::{
105    Facet, IngestTrigger, Medium, MediumType, PatternEntry, PatternMode, Projection,
106};
107pub use pipeline_edit::PipelineEditError;
108pub use pipeline_migrate::{migrate_legacy_pipeline, read_legacy_pipeline_configs};
109pub use pipeline_store::{
110    BindingConfigs, MemPipelineRecord, PipelineConfigs, PipelineRecord,
111    load_legacy_pipeline_configs, load_pipeline_configs,
112};
113pub use provenance::{Provenance, ProvenanceKind};
114pub use store::{Edge, EdgeSource, InEdge, Store};
115pub use workspace::{
116    CreateRuleSetting, DeleteRuleSetting, Mount, MountCapability, MountLifecycle, MountStorage,
117    SCHEMA_WILDCARD, Workspace, WorkspaceSettings,
118};
119pub use workspace_store::{
120    FileWorkspaceStore, InstantiateError, Layout, StoreError, WORKSPACE_STORE_DIR,
121    WorkspaceStoreAdapter, detect_layout, instantiate_lean_backend, is_mem_repo_shaped,
122    is_workspace_root, standalone_workspace, workspace_shape_label,
123};
124
125/// Lowercase hex encoding of a digest. Byte-identical to the `{:x}`
126/// formatting that `sha2 < 0.11` digests carried; hash strings persisted
127/// under the old encoding must keep matching.
128pub fn hex_lower(bytes: &[u8]) -> String {
129    use std::fmt::Write;
130    bytes
131        .iter()
132        .fold(String::with_capacity(bytes.len() * 2), |mut s, b| {
133            let _ = write!(s, "{b:02x}");
134            s
135        })
136}
137
138/// Engine-wide sentinel type. Used by ops that need a shared reference
139/// type at the Engine level (search, health, list) — always resolves to
140/// `default@1.0.0::spec`. Per-entity resolution still goes through
141/// `type_by_name` + schema lookup.
142pub fn engine_fallback_type() -> Arc<TypeDefinition> {
143    type_by_name("spec").expect("spec type must exist in the default builtin schema")
144}
memstead_base/lib.rs

memstead_base/
lib.rs
