omnigraph/docs/dev
Ragnor Comerford 44b1549fa4
docs: use single ~/.omnigraph dir (Helix-style), not XDG, in RFC-002
Reverse the earlier XDG-first call. The prior argument rested on a false
dichotomy (single-dir => mixed config/cache/state); in fact the peer
tools (aws, kube, helix) achieve separation via SUBDIRECTORIES inside
one ~/.tool/ dir (~/.aws/sso/cache/, ~/.kube/cache/), getting cache
hygiene AND one discoverable place. So everything goes under
~/.omnigraph/: config.yaml, credentials (dotenv, 0600), cache/, state/.
Lower cognitive load, matches what DB/cloud-CLI users expect, matches
Helix. OMNIGRAPH_HOME overrides; $XDG_CONFIG_HOME optionally honored but
~/.omnigraph/ is canonical. Updated all paths, the rationale paragraph,
the file-naming table (added a cache/state row), and env precedence.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-05-30 17:51:03 +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: use single ~/.omnigraph dir (Helix-style), not XDG, in RFC-002 2026-05-30 17:51:03 +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