Module domain

Module domain 

Source
Expand description

The memory domain model — the vocabulary shared by every stage of the pipeline (capture → staging → retrieval → reconciliation → promotion).

Types here are deliberately serialization-stable: they are the schema of the OKF front matter, the event log, and the structured-output contracts handed to out-of-band extraction models.

Structs§

CanonicalMemory
A reconciled, durable memory — the canonical unit of the OKF repository.
CanonicalPredicate
A canonicalized predicate name such as dietary_identity.
EntityRef
A reference to the subject of a memory.
EvidenceCounters
How much evidence stands behind a memory.
FactFingerprint
A deduplication key for “the same fact stated twice”.
MemoryObservation
A structured interpretation of one specific user statement.
MemorySource
Where a memory came from.
PrivacyMetadata
User-facing data rights for a record.
RetrievalMetadata
The fields a memory is matched on during lexical retrieval.
TemporalMetadata
Validity and freshness metadata.
TranscriptEvidence
The evidence span an observation was drawn from.

Enums§

Explicitness
How directly the user stated the thing being remembered.
MemoryKind
What sort of thing a memory records.
MemoryStatus
Lifecycle state of a canonical memory record.
MemoryValue
The value side of a memory triple.
MutationIntent
An explicit user instruction about memory itself.
ProposedPersistence
What the extractor proposes should happen to a candidate over time.
SensitivityClass
Privacy classification, gating automatic promotion.
SpeakerAttribution
Who actually said the thing an observation was drawn from.
TemporalScope
How long a fact is expected to hold.

Functions§

normalize_token
Lowercase a string and collapse everything non-alphanumeric to single spaces.
stable_hash
A stable, dependency-free 64-bit content hash rendered as hex.