omnigraph/docs/dev
Ragnor Comerford 4f9ab8d455
docs: reconcile RFC-002 with shipped/planned CLI tickets
Align with reality found in existing tickets:
- Noun is graph/graphs, not target/targets (MR-603 done renamed the
  config key targets->graphs, flag --graph). Use graphs:/--graph; an
  entry is embedded (uri) XOR remote (server + remote graph name).
- ~/.omnigraph/ confirmed by MR-581 (og template pull, done) which
  already quick-starts templates there.
- Templates already exist (MR-581/MR-531) — not invented here.
- The init family is already specced (init, quickstart MR-973, serve
  MR-970, prune MR-972, mcp install MR-974, agent-mode MR-981); this
  RFC only adds the user route (~/.omnigraph/config.yaml + login).
- aliases: -> operations: planned (MR-839).
- bearer_token_env gap tracked in MR-971.
- query lint/check already exist (MR-639) — registry validator must not
  collide with the singular `query check`.
Add a Reconciliation section; fix the canonical example to graphs:/--graph.
Also: merge semantics refined (deep-merge settings, replace named
entries, replace lists, config view --resolved --show-origin).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-05-30 18:03:43 +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: reconcile RFC-002 with shipped/planned CLI tickets 2026-05-30 18:03:43 +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