omnigraph/docs/user
Ragnor Comerford f4c38bb75a
Scope the stored-query 404-hiding claim to non-invoke_query callers
Review found the deny==404 catalog-hiding was overstated as a contract: it
holds only at the outer invoke_query gate. A caller that HOLDS invoke_query
but lacks read/change gets the inner gate's 403 for an existing query vs 404
for an unknown one — so existence is visible to grant-holders by design (the
intended double-gate). The handler docstring, OpenAPI 404 description, and
server.md all claimed the 404 was airtight against any denied actor.

Correct the wording in all three (no behavior change) and add the missing
symmetric test (invoke_query but no read -> 403 for an existing query, 404
for unknown) so the actual contract is pinned. Also document that in
default-deny mode (tokens, no policy) every invocation 404s until an
invoke_query rule is configured.

Nits: the from_specs collision comment said "first declared wins" but it is
lexicographically-first by name (BTreeMap); the effective_tool_name docstring
overclaimed the CLI display routes through it (it resolves the rule on its
own output DTO).
2026-05-30 23:33:27 +02:00
..
audit.md Rename repo terminology to graph (#118) 2026-05-24 16:46:00 +01:00
branches-commits.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03:00
changes.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03:00
cli-reference.md docs: document the queries registry, CLI, and invoke_query action 2026-05-30 22:07:48 +02:00
cli.md feat: inline query strings in CLI and HTTP server (#110) 2026-05-29 13:41:54 +02:00
constants.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03:00
deployment.md docs: align release artifact docs 2026-05-29 14:04:16 +02:00
embeddings.md Rename repo terminology to graph (#118) 2026-05-24 16:46:00 +01:00
errors.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03:00
index.md Rename repo terminology to graph (#118) 2026-05-24 16:46:00 +01:00
indexes.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03:00
install.md docs: align release artifact docs 2026-05-29 14:04:16 +02:00
maintenance.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03:00
policy.md docs: stored-query invocation endpoint; flip the not-yet-exposed caveat 2026-05-30 22:38:28 +02:00
query-language.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03:00
schema-language.md schema: HTTP allow_data_loss exposure + e2e drop coverage (MR-694 follow-up) (#107) 2026-05-19 01:56:46 +03:00
schema-lint.md docs: split user and developer docs (#93) 2026-05-15 03:45:22 +03:00
server.md Scope the stored-query 404-hiding claim to non-invoke_query callers 2026-05-30 23:33:27 +02:00
storage.md Rename repo terminology to graph (#118) 2026-05-24 16:46:00 +01:00
transactions.md Rename repo terminology to graph (#118) 2026-05-24 16:46:00 +01:00