The context & memory layer
How Starlight combines local sovereign memory (SisGatewayDaemon FTS5 + RRF), build-time Orama indexes, and Streamable HTTP MCP endpoints.
Starlight-Intelligence-System/AGENTS.md, docs-platform/app/api/mcp/route.ts, docs-platform/app/api/search/route.ts, TRUTH.mdEvery page on this platform exposes machine-readable context to coding agents in three ways right now:
- Pull feeds: Append
.mdor sendAccept: text/markdownon any URL, or fetch/llms-full.mdx/<brand>for a single-file brand bundle. - Full-text search API: Query
/api/search?q=<query>&brand=<brand>against each brand's isolated Orama index. - Streamable HTTP MCP server (
/api/mcp): Calllist_docs,search_docs, andget_docover JSON-RPC 2.0 to retrieve Markdown with verified frontmatter citations (checkeddate andsources).
Two layers: local sovereign memory + cloud docs index
Rather than relying on a single external SaaS database, the estate separates operator memory from public product documentation:
| Layer | Substrate | Verified performance & scope (2026-10-25) |
|---|---|---|
Local sovereign memory (Starlight-Intelligence-System) | Append-only JSONL vaults (Strategic, Technical, Creative, Operational, Wisdom, Horizon) indexed in SQLite FTS5 + vector embeddings via SisGatewayDaemon (127.0.0.1:5200) with Reciprocal Rank Fusion (RRF) | 1,106 compiled memory atoms, 400 knowledge-graph rows, Eval-50 Hit@10 = 1.000, Recall@5 = 1.000, MRR@10 = 1.000 (p50 = 218.9ms), 0d vault staleness |
Public docs & MCP index (docs-platform) | Build-time Fumadocs MDX compilation + brand-isolated Orama search + /api/mcp Streamable HTTP server | Zero external DB latency; every page carries build-enforced status: verified, checked date, and sources |
| Cloud relational & vector store (when multi-source) | Supabase Postgres + pgvector + Row Level Security (RLS) | Used when joining documentation chunks with dynamic cloud records (DemandSignal, gate receipts) |
| Temporal knowledge graph (when edge queries earn it) | Graphiti on FalkorDB (bi-temporal validity windows) | Reserved for cross-artifact lineage ("which receipt superseded which release") |
Why local FTS5 + RRF and build-time Orama come before external SaaS
- Zero drift from Git: Documentation lives in version-controlled MDX with a Zod provenance gate in
lib/source.ts. If a page'sstatus: verifiedfrontmatter lacks acheckeddate orsourceslist,next buildfails immediately. - Progressive disclosure over heavy RAG: As recorded in
TRUTH.md§3b (arXiv 2607.17598), single-level index-to-passage lookup (llms.txt→.mdpage orsearch_docs→get_doc) outperforms multi-hop vector routing at corpus scales under 2M words while preserving exact file citations. - Sovereign privacy boundary: Private operator notes stay in
starlight-private-memoryand localSisGatewayDaemonloopback (127.0.0.1:5200with privacy tag scrubbing), never leaking into public cloud indexes.
Use Starlight from your own agent code
Connect an agent built with the Vercel AI SDK, the Claude Agent SDK, or Vercel Eve to the Starlight MCP endpoints.
After Smithery - move your MCP servers
Smithery's connection services end on 31 October 2026. Swap each Smithery address for the vendor's own, or host your server yourself on Cloudflare Workers and list it in the official MCP Registry.