From 23c5de38bf8423e2f364b3db985351a499d3c820 Mon Sep 17 00:00:00 2001 From: Mikael Hugo Date: Sat, 2 May 2026 23:52:38 +0200 Subject: [PATCH] docs: clarify memory-relations.ts is storage-only today MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The architecture.md entry implied memory-relations.ts contributes to ranking ("knowledge-graph edges between memories"). The read consumer doesn't exist yet — getRelevantMemoriesRanked uses cosine + static score, not graph traversal. Relations are written via /sf memory import / createMemoryRelation but never read for ranking. Updated the description so a contributor reading this file knows the graph-traversal pipeline is the next logical extension, not something that currently runs. Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/dev/architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/dev/architecture.md b/docs/dev/architecture.md index 0b24f2dde..847bbfb23 100644 --- a/docs/dev/architecture.md +++ b/docs/dev/architecture.md @@ -167,7 +167,7 @@ Phase skipping (from token profile) gates steps 2-3: if a phase is skipped, the | `memory-store.ts` | Persistent memory store for cross-session knowledge; query-aware ranking | | `memory-embeddings.ts` | Vector storage + cosine ranking + agent_end backfill driver | | `memory-embeddings-llm-gateway.ts` | OpenAI-shaped /v1/embeddings + /v1/rerank adapter for the inference-fabric llm-gateway (env-driven; opt-in via `SF_LLM_GATEWAY_KEY`) | -| `memory-relations.ts` | Knowledge-graph edges between memories (typed relations) | +| `memory-relations.ts` | Knowledge-graph edges between memories (typed relations). Storage + import/export wired; no ranker consumer yet — the ranking pipeline currently uses cosine + static score, not graph traversal. | | `memory-source-store.ts` | Raw source rows preserved separately from extracted memories (idempotent re-extraction) | | `queue-order.ts` | Milestone queue ordering | | `context-masker.ts` | Context masking for model routing optimization |