mirror of
https://github.com/ModernRelay/omnigraph.git
synced 2026-06-12 01:45:14 +02:00
docs(server): clarify why run_query lacks AppState parameter
run_mutate takes state for workload admission; run_query doesn't because
reads aren't admission-gated today. Mark the asymmetry as intentional and
flag the two future events that would grow the signature: Phase 1's
`expect: { max_rows_scanned: N }` budget (MR-976) or per-actor admission
extending to stored-read invocations (MR-969). Prevents the natural
"make these symmetrical" follow-up.
This commit is contained in:
parent
1786c87772
commit
6eb5adf859
1 changed files with 6 additions and 0 deletions
|
|
@ -1845,6 +1845,12 @@ async fn run_mutate(
|
|||
/// can call here with registry-supplied fields. Rejects inline source that
|
||||
/// contains mutations (D2 rule); callers wanting writes go through
|
||||
/// [`run_mutate`] instead.
|
||||
///
|
||||
/// Intentionally does **not** take [`AppState`] (unlike [`run_mutate`]):
|
||||
/// reads are not admission-gated today, so there is no `state.workload`
|
||||
/// consumer. The signature grows the parameter when Phase 1 (MR-976) adds
|
||||
/// the request envelope's `expect: { max_rows_scanned: N }` budget, or
|
||||
/// MR-969 extends per-actor admission to stored-read invocations.
|
||||
async fn run_query(
|
||||
handle: Arc<GraphHandle>,
|
||||
actor: Option<Extension<ResolvedActor>>,
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue