Skip to content

The memory graph

Memory in Vectadyne is a graph of typed nodes joined by typed edges, not a pile of embedded text. Both halves of that carry weight.

Every memory has a kind, and the kind determines how it behaves:

KindWhat it isNotes
factSomething true about the systemThe weakest claim; easily superseded
decisionA choice that was madeCan be superseded by a later decision
lessonSomething learned, usually the hard wayTypically born from an incident
policyA rule that must be followedOutranks a lesson or a fact in conflict
skillA reusable procedure
guideThe standing answer for a topicResolved, not stored stale
evidenceA pointer to raw activityThe provenance layer

Kind is not a tag. When a policy and a lesson disagree, the policy wins — because a rule someone committed to outranks a pattern someone noticed.

StatusMeaning
activeCurrent and returned normally
disputedContradicted by something else; returned with that flagged
staleAged past its confidence horizon
deprecatedSuperseded; not returned as current

Status changes as the corpus grows. A decision does not become wrong because it is old, but it does stop being current once a later one supersedes it — and a good answer distinguishes those.

Relationships are typed:

supersedesapplies_tocaused_bycontradictsdecision'use the event bus'decision'use the legacy queue'lesson'reconcile breaks on fixturedrift'scoperepo:paymentsevidenceincident #412policy'migrations need a plan'lesson'just run it'
EdgeMeaning
supportsCorroborates
contradictsDirectly disagrees
supersedesReplaces an earlier claim
applies_toBinds a memory to a scope or entity
caused_byTraces to origin
inherits_fromDraws from a broader memory

Retrieval returns one hop of edges alongside each hit, so an agent sees not only the memory but what it is connected to — including what contradicts it. Multi-hop traversal does not exist; see What we do not claim.

When two memories disagree, Vectadyne shows you the disagreement rather than silently picking a winner. A disputed hit arrives flagged, with the contradicting edge available.

This is deliberate. A retrieval system that quietly returns one side of a live disagreement is a system that will confidently tell an agent something half your team believes is wrong. Surfacing disputes is less tidy and much more honest — and a warn verdict citing contradicts_decision or disputed_memory is exactly this working.

Every memory carries a sensitivity: public, internal, restricted, secret. A principal’s clearance determines what it may see, enforced at admission on every read.

Clearance is not advisory. A principal cannot read above its clearance, and a request asking to widen it is refused rather than clamped.