fix(server): reject remote graph entries at config load

omnigraph-server serves embedded graphs only (RFC-002 §3). Classify each served
graph with the typed `config.resolve_graph(...).is_remote()` — the same locator
classifier the CLI dispatches on — and `bail!` early with a clear "embedded
graphs only" error if a graph sets `server:` or a remote `http(s)://` `uri:`,
instead of accepting it and failing confusingly later at `Omnigraph::open`.

Both modes covered: Single (hoist `selected` above the URI resolution and check
before `cli_uri` is moved) and Multi (per entry, after the `GraphId` check). A new
`ensure_embedded` helper keeps the message in one place. No config-crate change
(reuses existing public `resolve_graph`/`is_remote`); embedded `storage:`/`uri:`
entries pass through unchanged (positive guard test added).

Updates the `server_settings_can_resolve_named_target` lib test, which asserted
the old behavior (server resolves a remote named target); it now uses an embedded
target — the remote case is rejected and covered by
`single_mode_rejects_named_remote_graph`. Turns the previous commit's four red
tests green.
This commit is contained in:
Ragnor Comerford 2026-06-03 17:37:16 +02:00
parent 4950f74fad
commit f3331edd51
No known key found for this signature in database
2 changed files with 71 additions and 12 deletions

View file

@ -890,6 +890,26 @@ fn format_registry_load_errors(label: &str, errors: &[queries::LoadError]) -> St
format!("graph '{label}': stored-query registry failed to load:\n {joined}")
}
/// omnigraph-server serves embedded graphs only (RFC-002 §3). Reject a graph
/// whose resolved locator is remote (`server:` set, or a remote `http(s)://`
/// `uri:`) before any open — a server must not proxy another server. Reuses the
/// same `resolve_graph` classifier the CLI dispatches on, so the two can't drift.
fn ensure_embedded(
config: &OmnigraphConfig,
explicit_uri: Option<&str>,
name: Option<&str>,
label: &str,
) -> Result<()> {
if config.resolve_graph(explicit_uri, name)?.is_remote() {
bail!(
"graph '{label}' is remote (it sets `server:` or a remote `http(s)://` URI), but \
omnigraph-server serves embedded graphs only and does not proxy another server. \
Serve an embedded `storage:` graph, or point a client at the remote server instead."
);
}
Ok(())
}
pub fn load_server_settings(
config_path: Option<&PathBuf>,
cli_uri: Option<String>,
@ -931,6 +951,23 @@ pub fn load_server_settings(
let mode = if has_cli_uri || has_cli_target || has_server_graph {
// Rules 1, 2, or 3 → Single mode.
// Config follows graph IDENTITY, not mode: a bare URI is anonymous
// (top-level config); a graph chosen by name uses its per-graph
// `graphs.<name>.{policy,queries}`. Resolved before the URI so the
// embedded-only check and `resolve_target_uri` share one selection.
let selected: Option<&str> = if has_cli_uri {
None
} else {
cli_target.as_deref().or_else(|| config.server_graph_name())
};
// omnigraph-server serves embedded graphs only — refuse a remote target
// (`server:`/remote `uri:`) before resolving or opening it.
ensure_embedded(
&config,
cli_uri.as_deref(),
selected,
selected.or(cli_uri.as_deref()).unwrap_or("<graph>"),
)?;
let raw_uri = config.resolve_target_uri(
cli_uri,
cli_target.as_deref(),
@ -939,15 +976,6 @@ pub fn load_server_settings(
let uri = normalize_root_uri(&raw_uri).wrap_err_with(|| {
format!("normalize single-graph URI '{raw_uri}' from server settings")
})?;
// Config follows graph IDENTITY, not mode: a bare URI is anonymous
// (top-level config); a graph chosen by name uses its per-graph
// `graphs.<name>.{policy,queries}`. `resolve_target_uri` already
// errored on an unknown name, so a `Some(name)` here is a known graph.
let selected: Option<&str> = if has_cli_uri {
None
} else {
cli_target.as_deref().or_else(|| config.server_graph_name())
};
// A named selection must not leave a populated top-level block
// silently unused — refuse boot and point at the per-graph block. The
// same rule the CLI selection gate enforces, shared via one helper so
@ -987,6 +1015,9 @@ pub fn load_server_settings(
GraphId::try_from(name.clone()).map_err(|err| {
color_eyre::eyre::eyre!("invalid graph id '{name}' in omnigraph.yaml: {err}")
})?;
// omnigraph-server serves embedded graphs only — a remote entry
// (`server:`/remote `uri:`) cannot be served, only proxied.
ensure_embedded(&config, None, Some(name.as_str()), name)?;
let raw_uri = config.resolve_uri_value(&target.uri);
let uri = normalize_root_uri(&raw_uri).wrap_err_with(|| {
format!("normalize URI '{raw_uri}' for graph '{name}' in omnigraph.yaml")
@ -3344,9 +3375,9 @@ server:
r#"
graphs:
local:
uri: ./demo.omni
uri: ./local.omni
dev:
uri: http://127.0.0.1:8080
uri: ./dev.omni
server:
graph: local
bind: 127.0.0.1:8080
@ -3354,12 +3385,15 @@ server:
)
.unwrap();
// `--target dev` overrides `server.graph: local`, resolving the named
// embedded graph. (A remote target is now rejected — see
// `single_mode_rejects_named_remote_graph` in tests/server.rs.)
let settings =
load_server_settings(Some(&config), None, Some("dev".to_string()), None, false)
.unwrap();
match &settings.mode {
ServerConfigMode::Single { uri, graph_id, .. } => {
assert_eq!(uri, "http://127.0.0.1:8080");
assert!(uri.ends_with("dev.omni"), "uri: {uri}");
assert_eq!(graph_id, "dev");
}
ServerConfigMode::Multi { .. } => panic!("expected Single mode, got Multi"),

View file

@ -5964,6 +5964,31 @@ graphs:
);
}
#[test]
fn multi_mode_accepts_storage_embedded_entry() {
// The rejection must NOT over-fire on an embedded `storage:` entry:
// `normalize_graphs` fills `.uri` and the server serves it normally.
let temp = tempfile::tempdir().unwrap();
let config_path = temp.path().join("omnigraph.yaml");
fs::write(
&config_path,
"version: 1\ngraphs:\n g:\n storage: ./g.omni\n",
)
.unwrap();
let settings = load_server_settings(Some(&config_path), None, None, None, true).unwrap();
match settings.mode {
ServerConfigMode::Multi { graphs, .. } => {
assert_eq!(graphs.len(), 1);
assert!(
graphs[0].uri.ends_with("g.omni"),
"storage entry must resolve to its embedded uri: {}",
graphs[0].uri
);
}
ServerConfigMode::Single { .. } => panic!("expected Multi for a graphs: map"),
}
}
/// `--config` + `<URI>` together: URI wins → Single (the CLI URI
/// takes precedence over the config's graphs map).
#[test]