memstead-base 0.8.0

Engine internals for Memstead — store, parser, validators, filesystem-mem engine. Internal library surface consumed by the memstead binaries — pre-1.0, experimental, no API stability promise.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

[package]
name = "memstead-base"
version.workspace = true
edition.workspace = true
rust-version.workspace = true
license.workspace = true
repository.workspace = true
homepage.workspace = true
description = "Engine internals for Memstead — store, parser, validators, filesystem-mem engine. Internal library surface consumed by the memstead binaries — pre-1.0, experimental, no API stability promise."
readme = "README.md"
keywords = ["agent-memory", "knowledge-graph", "markdown", "graph", "agents"]
categories = ["database-implementations"]

# docs.rs: build with all features so the opt-in `tokio` broadcast surface
# and the `file-watcher` cross-process event surface are documented.
[package.metadata.docs.rs]
all-features = true

[dependencies]
memstead-schema.workspace = true
globset.workspace = true
pulldown-cmark = { workspace = true, features = ["html"] }
indexmap.workspace = true
regex.workspace = true
schemars.workspace = true
semver.workspace = true
serde.workspace = true
serde_json.workspace = true
sha2.workspace = true
strsim = "0.11"
thiserror.workspace = true
toml.workspace = true
tracing.workspace = true
unicode-normalization.workspace = true
zip.workspace = true

# Optional — only pulled in when the `tokio` feature is enabled.
# The Core engine surface (callback-based subscribe) stays
# runtime-agnostic; tokio is opt-in for axum-resident consumers.
tokio = { version = "1", default-features = false, features = ["sync"], optional = true }
# Optional — only pulled in when the `file-watcher` feature is enabled.
# Used by `watch_mem_repo` to surface `MemChangedEvent`s for
# cross-process consumers (bridge HEAD-watcher, macOS live-update,
# audit-log workers) that don't share the writer's `Engine` instance.
notify = { version = "8", optional = true }

# Tantivy (full-text search) and its native-only transitive chain
# (getrandom 0.2.x without the `js` feature, memmap2, rayon, zstd-sys)
# block wasm32-unknown-unknown builds. Restricting the dependency to
# non-wasm targets keeps `memstead-base` portable; the `search_index`
# module and `Engine::search` are gated to match so wasm consumers
# see a typed `EngineError::SearchUnavailable` refuse instead of a
# compile error. WASM search lives behind the bridge (see plan 08).
[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
tantivy.workspace = true

# `SystemTime::now()` is unimplemented on wasm32-unknown-unknown (it
# traps), so time-reading paths (health staleness) use the JS-backed
# clock there. Same version pin as memstead-wasm.
[target.'cfg(target_arch = "wasm32")'.dependencies]
js-sys = "0.3"

[features]
default = []
# Opt-in tokio convenience: `Engine::subscribe_mem_changes_broadcast`
# wraps the Core callback API in a `tokio::sync::broadcast::Receiver`
# so axum-style consumers can consume events as a tokio stream without
# wiring the boilerplate themselves. Adds tokio (broadcast / sync only)
# to the dependency graph; consumers that don't need it keep tokio out.
tokio = ["dep:tokio"]
# Opt-in cross-process change-event surface: `watch_mem_repo` returns
# a `(handle, mpsc::Receiver<MemChangedEvent>)` pair that fires on
# every `refs/heads/<mem>` mutation in a mem-repo gitdir. Adds
# `notify` to the dependency graph; consumers that only need the
# in-process `Engine::subscribe_mem_changes` keep it out.
file-watcher = ["dep:notify"]

[dev-dependencies]
tempfile.workspace = true
tokio = { workspace = true, features = ["macros", "rt", "rt-multi-thread", "time"] }

[lints]
workspace = true