omnigraph/docs/dev
Ragnor Comerford 5c788de5e4
docs(rfc-003): canonical implementation blueprint for a from-scratch build
Make RFC-003 the authoritative build-from-scratch spec, folding in what the
#157 reference implementation proved out plus the architecture for a clean redo.

- New "Implementation Blueprint" (B.1-B.13): the omnigraph-mcp transport crate
  + McpBackend trait (dependency must be server -> mcp to avoid a Cargo cycle),
  the verified rmcp 1.7 transport (conformance MUSTs for free), backend reuse
  (do_* / run_query / run_mutate / authorize / api), the 13-tool catalog +
  Cedar mapping, ParamKind -> JSON Schema, list/call deny-masking + isError
  split, resources, auth + client-compat matrix, tests, and locked decisions.
- Routing resolved: per-graph /mcp; graphs_list + omnigraph://graphs dropped
  from MCP (graph discovery stays REST-only via GET /graphs); no flat
  graph_id-in-call endpoint.
- Marked the old "Reconciliation" section historical and the section-5 sketches
  as design rationale (superseded by the blueprint where they differ); resolved
  the Open Questions.
2026-06-10 21:48:57 +02:00
..
architecture.md docs: rename runs.md/runs.rs → writes and repoint all references (#131) 2026-05-30 23:20:56 +02:00
branch-protection.md ci(codeowners): un-trap required checks, auto-render, generate owner tables (#142) 2026-06-06 18:09:47 +03:00
ci.md Add Windows release binaries (#127) 2026-05-30 14:23:40 +02:00
codeowners.md ci(codeowners): add aaltshuler to engineering role (#147) 2026-06-07 18:05:01 +03:00
execution.md docs: rename runs.md/runs.rs → writes and repoint all references (#131) 2026-05-30 23:20:56 +02:00
index.md governance: external contribution model (issues/discussions/RFCs/PRs) (#143) 2026-06-06 23:58:08 +03:00
invariants.md fix(maintenance): route uncovered drift through repair (#156) 2026-06-09 14:42:54 +02:00
lance.md fix(optimize): skip blob-bearing tables to avoid Lance compaction crash (#138) 2026-06-02 17:12:00 +02:00
merge.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03:00
rfc-001-queries-envelope-mcp.md feat: inline query strings in CLI and HTTP server (#110) 2026-05-29 13:41:54 +02:00
rfc-002-config-cli-architecture.md Stored-query registry foundation + config/CLI RFC-002 (#128) 2026-06-01 22:50:31 +02:00
rfc-003-mcp-server-surface.md docs(rfc-003): canonical implementation blueprint for a from-scratch build 2026-06-10 21:48:57 +02:00
schema-lint-v1-plan.md schema-lint chassis v1.0: DropProperty Soft + code-tagged diagnostics (MR-694) (#90) 2026-05-16 16:30:03 +03:00
testing.md docs: document the in-server MCP surface (RFC-003) 2026-06-09 15:15:46 +02:00
writes.md fix: optimize publishes compaction; recovery roll-back converges manifest (#141) 2026-06-08 02:50:12 +03:00