Project Brief
dent8
Origin: dentate gyrus, the hippocampal structure associated with pattern separation in human memory.
Tagline: Pattern separation for agent memory.
Thesis
Section titled “Thesis”Long-running agents need memory integrity, not just memory persistence. A stored memory is useful only if an agent can tell where it came from, whether it is fresh, what evidence supports it, whether stronger evidence replaced it, and whether it conflicts with other facts.
dent8 exists to make those integrity properties explicit and replayable.
Product Category
Section titled “Product Category”Memory integrity platform for agentic systems.
It combines three surfaces over one event model:
- Memory firewall: validates writes and read eligibility.
- Versioned memory store: records append-only fact events and projections.
- Memory debugger: explains provenance, replay, drift, contradictions, and supersession.
Differentiator
Section titled “Differentiator”dent8 should not become “another memory provider.” The differentiator is that memory is governed by an event-sourced fact model with provenance, authority, freshness, contradiction handling, supersession, replay, and auditability built in from the first release.
Stated precisely (and honestly): no single one of those primitives is novel — Zep/Graphiti, PROV, SQL:2011, and transparency logs cover most of them (related-work.md). The defensible wedge is the combination as substrate plus typed authority-weighted supersession as a poisoning mitigation. Formally, dent8 is a belief base with paraconsistent contradiction tolerance (belief-revision.md). The headline arbitration is enforced at the write boundary (EventStore::append) and runnable end-to-end — the CLI/MCP run on either a file dev store or, with DENT8_STORE_URL, a transactional async backend (embedded SQLite in stock builds, or DB-verified Postgres with --features postgres). The remaining gap is productization — operating signed source identity well (key distribution/rotation and stronger secret storage; the default CLI includes dent8 init --identity, dent8 init --agent <profile>, and dent8 identity) and an operated witness service (the signed-tree-head witness primitive is built — dent8 witness) — see STATUS.md.
MVP User
Section titled “MVP User”The first user is multiple coding agents (and a human) sharing one verified fact base about one repository — the stale-CLAUDE.md problem. Today that shared knowledge lives in flat instruction files that go stale silently: nothing records who asserted a convention, whether CI later contradicted it, or which agent is still acting on a superseded fact. This wedge is where dent8’s model earns its keep naturally: authority differentiation falls out of the setting (human > CI > agent), staleness is a felt pain rather than a hypothetical one, and repository facts are naturally structured subject–predicate–value triples. A single agent remembering things is a feature; several writers with different trust levels converging on one fact base is where integrity — not persistence — becomes the product.
Example facts:
- “This repo uses Postgres as the operational source of truth.”
- “The CLI binary is named
dent8.” - “A user correction superseded an earlier project assumption.”
- “This branch has a failing test that should not be treated as resolved.”
Non-Goals
Section titled “Non-Goals”- Generic vector memory as the primary product.
- Chat history summarization as the primary abstraction.
- Notebook-first evals.
- SQLite prototype semantics that later need a different correctness model.
- MCP-only architecture.
First Principles
Section titled “First Principles”- Facts are event streams.
- State is replayed, not trusted blindly.
- Reads must expose integrity metadata.
- Provenance and evidence are mandatory for accepted assertions.
- Authority is typed and policy-visible.
- TTL and freshness are first-class.
- Contradiction is not failure; hidden contradiction is failure.
- Supersession must preserve lineage.