feat(querier): yaml-embeddable queries + structured-surface JSON schema (RFC0002.10/.11)

crates/ourios-querier/Cargo.toml

@@ -66,6 +66,14 @@ tempfile = "3"
 parquet = { version = "55", default-features = false, features = ["arrow"] }
 arrow-array = { version = "55", default-features = false }
 arrow-schema = { version = "55", default-features = false }
+# RFC0002.10 — proves the canonical β serialisation survives a YAML
+# scalar round-trip (the Perses-embedding guarantee). Test-only.
+serde_yaml = { version = "0.9.34", default-features = false }
+# RFC0002.11 — validates the structured surface against its published JSON
+# Schema in the acceptance test. `default-features = false` drops the
+# reqwest/TLS remote-`$ref` resolver: the schema is self-contained
+# (local `$ref`s only), so no network resolver is needed.
+jsonschema = { version = "0.46.5", default-features = false }
 
 [lints]
 workspace = true

crates/ourios-querier/src/dsl/mod.rs

@@ -25,6 +25,16 @@ pub use ir::Query;
 pub use parse::parse;
 pub use structured::parse_structured;
 
+/// The published JSON Schema (draft 2020-12) for the structured query surface
+/// (RFC 0002 §6.4). Versioned alongside the parser and snapshot-tested so any
+/// drift between the surface the parser accepts and its advertised contract is
+/// PR-visible (RFC0002.11 / §6.6). Agents fetch this to constrain or validate
+/// requests before sending them; the planner re-validates on receipt.
+#[must_use]
+pub fn structured_query_schema() -> &'static str {
+    include_str!("structured_query.schema.json")
+}
+
 pub(crate) use parse::{
     parse_severity_name_pub, parse_time_pub, require_string_operand, validate_sort_key,
 };