ADR-141: Knowledge graph as evidential memory backend#198
Merged
Conversation
Architecture proposal (Draft) for integrating an external evidential knowledge graph as an optional, presence-gated memory backend. - Activation contract: ontology presence is the combined capability + opt-in gate (zero-config); ways.json flag is a veto only. - Detection is fail-safe and never blocks the session (fire-and-forget). - Outbound: copy ledger entries + auto-memory writes to the ontology ingest target (refines ADR-112 Tier 2 with an activation contract). - Inbound (staged): project the KG into the native memory surface as read-only files; documents the three blockers (Auto-Dream, write redirect, populated-mountpoint overlay). - Generalizes to: artifact-presence-gated, evidentially-curated memory; the framework routes, the backend curates; backends are substitutable. Related: ADR-112 (session ledger), ADR-128 (memory-as-repo redirect).
Reviewed; outbound ingest path empirically validated via the live kg-fuse demo. Inbound projection remains staged behind its three documented blockers (Auto-Dream disable, write-redirect, populated- mountpoint overlay) — accepting the decision, not the unbuilt path.
…-memory-backend # Conflicts: # docs/architecture/INDEX.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds ADR-141 (Draft) — an architecture proposal for integrating an external evidential knowledge graph (a
kg-compatible system) as an optional, presence-gated cross-session memory backend. Architecture-first: this PR is the decision record; no code.Why
Both existing memory homes are editorial — they keep one current view and discard what they supersede:
/memory).ADR-112 anticipated a KG tier but left two things unspecified, which this ADR settles:
ways.jsonflag is a veto only. Detection is fail-safe and never blocks a turn (fire-and-forget).CONTESTED/CONTRADICTORY) signal reaches the session through the slot it already reads. Staged behind the outbound bridge; the three blockers (Auto-Dream, write-redirect, populated-mountpoint overlay) are documented rather than assumed away.Generalizes to: artifact-presence-gated, evidentially-curated memory — the framework routes, the backend curates, backends are substitutable.
Type
Testing
Related: ADR-112 (session ledger), ADR-128 (memory-as-repo redirect).