omnigraph/docs/dev
Ragnor Comerford 917b8dfa84
docs: add RFC-002 config & CLI architecture
Layered config (user-global ~/.config/omnigraph/ + per-project), a
unifying `target` abstraction resolving to (locus, graph, sub-state,
credential) with embedded-URI XOR remote-server loci, multi-server ×
multi-graph client targeting, credentials by-reference, and the
file-naming decision: project and server config are one artifact
(`omnigraph.yaml`); the only differently-named file is the user-global
`config.yaml`, split by scope not role. Includes the 12-factor bind
portability rule (prefer --bind/OMNIGRAPH_BIND over a committed
server.bind) and the defined-locally / invoked-remotely model for
stored queries. Derived from first principles working backwards from
what the engine enables; validated against kube/Helix/git/compose.

Linked from docs/dev/index.md. Proposed; phased rollout for the
MR-973/974/981 family.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-05-30 16:46:57 +02:00
..
architecture.md Rename repo terminology to graph (#118) 2026-05-24 16:46:00 +01:00
branch-protection.md Rename repo terminology to graph (#118) 2026-05-24 16:46:00 +01:00
ci.md docs: align release artifact docs 2026-05-29 14:04:16 +02:00
codeowners.md chore(codeowners): remove aaltshuler as owner 2026-05-28 11:41:38 +02:00
execution.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03:00
index.md docs: add RFC-002 config & CLI architecture 2026-05-30 16:46:57 +02:00
invariants.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03:00
lance.md Rename repo terminology to graph (#118) 2026-05-24 16:46:00 +01: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 docs: add RFC-002 config & CLI architecture 2026-05-30 16:46:57 +02:00
runs.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03: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 Rename repo terminology to graph (#118) 2026-05-24 16:46:00 +01:00