omnigraph/docs/dev
Ragnor Comerford ad968d95c4
docs(rfc-002): add phased implementation plan + divergence analysis
Synthesized from a six-agent code+upstream validation pass.

Added:
- V0 'Foundations' phase (crate + api-types extraction, version gate,
  layered-config fixture harness + keychain seam, test relocation).
- Phase detail (sizing/gates/exit, file touchpoints) for V0-V6, a
  critical-path + parallelization graph, and a validation-findings list.
- '## Divergence & single source of truth': states what the design
  prevents structurally (config<->CLI via the typed locator; config<->HTTP
  capability surface) vs only reduces (CLI<->HTTP route paths), and records
  the shared-route-table/generated-client move as the residual structural fix.

Inline corrections from the audit:
- storage.profile is env-only in Lance + omnigraph -> scoped out of v1;
  region/endpoint feasible now (Lance per-dataset storage_options).
- single-mode GET /graphs is 405->403-by-default (not ->200) without a
  serve.policy; recorded the wire vs Cedar graph_id reconciliation decision.
- omnigraph-config extraction alone does not shed Axum (CLI imports api::*)
  -> note the omnigraph-api-types companion crate.
2026-06-02 15:55:40 +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 Rename repo terminology to graph (#118) 2026-05-24 16:46:00 +01:00
ci.md Add Windows release binaries (#127) 2026-05-30 14:23:40 +02:00
codeowners.md chore(codeowners): remove aaltshuler as owner 2026-05-28 11:41:38 +02: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 docs(rfc-002): rewrite config & CLI architecture + readiness review 2026-06-02 13:12:06 +02:00
invariants.md fix(branch): make branch delete correct under partial failure (#137) 2026-06-01 13:28:38 +02:00
lance.md fix(branch): make branch delete correct under partial failure (#137) 2026-06-01 13:28:38 +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 docs(rfc-002): add phased implementation plan + divergence analysis 2026-06-02 15:55:40 +02:00
rfc-003-mcp-server-surface.md Stored-query registry foundation + config/CLI RFC-002 (#128) 2026-06-01 22:50:31 +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: rename runs.md/runs.rs → writes and repoint all references (#131) 2026-05-30 23:20:56 +02:00
writes.md docs: rename runs.md/runs.rs → writes and repoint all references (#131) 2026-05-30 23:20:56 +02:00