mnemoir-provenance 0.2.0

Source-grounded memory for agents that learn over time.

Mnemoir Provenance

Source-grounded memory for agents that learn over time.

Mnemoir Provenance (pronounced “nem-wahr”) is a local-first, source-grounded memory core for agents, assistants, and multi-agent systems. It preserves citations, correction history, source coverage, and recoverable maintenance receipts so memory remains inspectable as it evolves.

Mnemoir Provenance is an independent open-source project and is not affiliated with other projects using similar names.

Why it is different

• Cited recall reports which sources were searched and which were missing or degraded.
• Evidence, proposals, review, and durable writes are separate operations.
• Revisions, supersession, tombstones, and rollback preserve history.
• Overflow maintenance is preconditioned, authorized, auditable, and recoverable.
• The core works through Python or a JSON CLI; Hermes is an optional reference adapter.

Quick start

python -m venv .venv
. .venv/bin/activate
python -m pip install .
export MNEMOIR_DB="$PWD/demo.sqlite"
mnemoir ingest --limit 5
mnemoir recall "source grounded memory" --limit 3

The response is JSON. A healthy result includes cited_results and source_coverage; insufficient evidence returns an explicit empty or degraded state instead of an uncited fallback.

Mental model

sources -> raw events -> evidence -> proposals -> versioned memories
   |                                               |
   +------ cited recall + coverage + receipts -----+

Canonical state is SQLite. Markdown/wiki output is derived and never becomes canonical merely because it is readable.

Integration paths

• Python API
• CLI JSON
• Generic harness
• Hermes reference adapter
• Working-memory adapters

Documentation

Start at docs/index.md. Security boundaries are in SECURITY.md and the threat model. Overflow and writeback are explained in the operations guide.

Boundaries

This project is local/self-hosted software, not a hosted service. Installation does not grant access to arbitrary files, enable live writeback, start a network service, configure a host, or promote memory automatically. Citations identify evidence; they do not guarantee truth. Ranking heat affects attention, not authority.

License

MIT. See LICENSE.