Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Glossary

TermMeaning
AbstentionReturning zero results on purpose, with a reason, when nothing passes the semantic floor
AddressA memo://<kind>/<id> URI identifying one record; it resolves even after the record is forgotten
ArmOne retrieval method producing a ranked list: keyword, exact, semantic, fact, entity, graph
as_ofA time-travel view: what the knowledge base had recorded, and believed valid, at a given time
AuditThe table recording every write: actor, channel, operation, target
BandA relevance class (strong, moderate, weak) from the best raw cosine, using thresholds per model
BM25The term-frequency ranking function FTS5 uses for the keyword and exact arms
ChannelHow a write arrived: tool, cli, elicitation, worker. It determines trust
Chunk / passageA section of a document of about 200 tokens: the unit of indexing and retrieval
CompactionAgent-performed maintenance: writing pages, settling conflicts, deciding merges
CutoffWhere a result list ends: a score gap, the limit, the token budget, or none
DegradedA search served without a capability, usually the embedding model
ElicitationThe MCP mechanism by which a server asks the human a question through the client
EmbeddingA vector representing a text’s meaning; compared with cosine similarity
EntityA named thing (system, person, identifier) extracted from passages into the graph layer
FactOne-sentence claim with evidence, a subject list and a validity window
FTS5SQLite’s full-text search extension; memo-mcp keeps two indexes (stemmed, and identifier-preserving)
FusionCombining arm lists into one ranking: RRF (rank-based) or min-max (score-based)
GranularityWhat a search returns: chunk, document, fact or page
Knowledge base (KB)One SQLite file, selected by MEMO_KB; the isolation boundary
MCPModel Context Protocol: the JSON-RPC protocol between AI clients and tool servers
Merge candidateTwo entity names similar enough to possibly be the same thing; queued for a human
NamespaceA label grouping sources inside one knowledge base; searches span all by default
OriginDeclared provenance class: web, user-said, agent-derived
PageAgent-written markdown about an entity, stored as an inference with its cited passages
PPRPersonalised PageRank: the random walk the graph arm runs from each named entity
ProfileA named set of ranking constants (MEMO_PROFILE)
RecencyA multiplicative score factor that decays with age for kinds that age
RevisionOne version of a source’s document; changed content creates a new revision
RRFReciprocal rank fusion: sum of weight / (k + rank) over arms
SourceWhere content came from (URI or file), with library, version and trust
StaleA page whose sources changed or were forgotten since it was built
SupersedeReplace a revision or fact with a newer one, keeping the old one as history
TraceThe per-query explanation: arms run, candidates, latency, filters, cutoff, budget
TrustWho vouched for a record: agent < user < curated; only humans raise it
WALSQLite’s write-ahead log mode, which lets readers and a writer work concurrently
WhyThe per-result explanation: each arm’s rank and contribution, fused and final scores
Work itemOne compaction task with everything needed to do it in its payload