@hypequery/protocol-conformance 0.0.0-canary-20260722115402

package/fixtures/identifiers-v1/rejections.json

@@ -0,0 +1,58 @@
+[
+  {
+    "id": "non-string",
+    "mode": "simple",
+    "value": 42,
+    "error": "HQ_IDENTIFIER_TYPE"
+  },
+  {
+    "id": "empty",
+    "mode": "simple",
+    "value": "",
+    "error": "HQ_IDENTIFIER_EMPTY"
+  },
+  {
+    "id": "segment-bytes-129",
+    "mode": "simple",
+    "generator": {
+      "type": "repeat-string",
+      "value": "a",
+      "count": 129
+    },
+    "error": "HQ_IDENTIFIER_TOO_LONG"
+  },
+  {
+    "id": "leading-digit",
+    "mode": "simple",
+    "value": "1orders",
+    "error": "HQ_IDENTIFIER_INVALID_FORMAT"
+  },
+  {
+    "id": "unicode-letter",
+    "mode": "simple",
+    "value": "café",
+    "error": "HQ_IDENTIFIER_INVALID_FORMAT"
+  },
+  {
+    "id": "reserved-protocol-prefix",
+    "mode": "simple",
+    "value": "__HypequeryInternal",
+    "error": "HQ_IDENTIFIER_RESERVED"
+  },
+  {
+    "id": "qualified-empty-segment",
+    "mode": "qualified",
+    "value": "orders..country",
+    "error": "HQ_IDENTIFIER_INVALID_FORMAT"
+  },
+  {
+    "id": "qualified-segments-9",
+    "mode": "qualified",
+    "generator": {
+      "type": "qualified-segments",
+      "segment": "a",
+      "count": 9
+    },
+    "error": "HQ_IDENTIFIER_TOO_MANY_SEGMENTS"
+  }
+]

package/fixtures/identifiers-v1/success.json

@@ -0,0 +1,26 @@
+[
+  {
+    "id": "simple-lowercase",
+    "mode": "simple",
+    "value": "orders",
+    "segments": ["orders"]
+  },
+  {
+    "id": "simple-leading-underscore",
+    "mode": "simple",
+    "value": "_tenant_id",
+    "segments": ["_tenant_id"]
+  },
+  {
+    "id": "simple-case-preserved",
+    "mode": "simple",
+    "value": "RevenueByDay",
+    "segments": ["RevenueByDay"]
+  },
+  {
+    "id": "qualified-relationship-field",
+    "mode": "qualified",
+    "value": "orders.customer.country",
+    "segments": ["orders", "customer", "country"]
+  }
+]

package/fixtures/manifest.json

@@ -0,0 +1,117 @@
+{
+  "kind": "hypequery-conformance-manifest",
+  "version": 1,
+  "families": [
+    {
+      "name": "tagged-values-v1",
+      "rfc": "0001",
+      "codePrefixes": ["HQ_VALUE_"],
+      "files": [
+        { "path": "tagged-values-v1/success.json", "role": "success" },
+        { "path": "tagged-values-v1/rejections.json", "role": "rejection" }
+      ]
+    },
+    {
+      "name": "identifiers-v1",
+      "rfc": "0002",
+      "codePrefixes": ["HQ_IDENTIFIER_"],
+      "files": [
+        { "path": "identifiers-v1/success.json", "role": "success" },
+        { "path": "identifiers-v1/rejections.json", "role": "rejection" }
+      ]
+    },
+    {
+      "name": "expressions-v1",
+      "rfc": "0003",
+      "codePrefixes": ["HQ_EXPRESSION_"],
+      "files": [
+        {
+          "path": "expressions-v1/success.json",
+          "role": "success",
+          "sections": ["/expressions", "/queries"]
+        },
+        { "path": "expressions-v1/rejections.json", "role": "rejection" }
+      ]
+    },
+    {
+      "name": "query-schemas-v1",
+      "rfc": "0004",
+      "codePrefixes": ["HQ_SCHEMA_"],
+      "files": [
+        { "path": "query-schemas-v1/success.json", "role": "success" },
+        { "path": "query-schemas-v1/rejections.json", "role": "rejection" }
+      ]
+    },
+    {
+      "name": "query-implementations-v1",
+      "rfc": "0005",
+      "codePrefixes": ["HQ_QUERY_IMPLEMENTATION_"],
+      "files": [
+        { "path": "query-implementations-v1/success.json", "role": "success" },
+        { "path": "query-implementations-v1/rejections.json", "role": "rejection" }
+      ]
+    },
+    {
+      "name": "deployments-v1",
+      "rfc": "0006",
+      "codePrefixes": ["HQ_DEPLOYMENT_"],
+      "files": [
+        { "path": "deployments-v1/success.json", "role": "success" },
+        { "path": "deployments-v1/rejections.json", "role": "rejection" },
+        { "path": "deployments-v1/identity.json", "role": "identity" }
+      ]
+    },
+    {
+      "name": "deployment-bundles-v1",
+      "rfc": "0007",
+      "codePrefixes": ["HQ_BUNDLE_"],
+      "files": [
+        { "path": "deployment-bundles-v1/success.json", "role": "success" },
+        { "path": "deployment-bundles-v1/rejections.json", "role": "rejection" },
+        { "path": "deployment-bundles-v1/identity.json", "role": "identity" }
+      ]
+    },
+    {
+      "name": "deployment-releases-v1",
+      "rfc": "0008",
+      "codePrefixes": ["HQ_RELEASE_"],
+      "files": [
+        { "path": "deployment-releases-v1/success.json", "role": "success" },
+        { "path": "deployment-releases-v1/rejections.json", "role": "rejection" },
+        { "path": "deployment-releases-v1/identity.json", "role": "identity" }
+      ]
+    },
+    {
+      "name": "query-events-v1",
+      "rfc": "0011",
+      "codePrefixes": ["HQ_EVENT_"],
+      "files": [
+        { "path": "query-events-v1/success.json", "role": "success" },
+        { "path": "query-events-v1/rejections.json", "role": "rejection" }
+      ]
+    },
+    {
+      "name": "query-diagnostics-v1",
+      "rfc": "0011",
+      "codePrefixes": ["HQ_DIAGNOSTICS_"],
+      "files": [
+        { "path": "query-diagnostics-v1/success.json", "role": "success" },
+        { "path": "query-diagnostics-v1/rejections.json", "role": "rejection" }
+      ]
+    },
+    {
+      "name": "sql-portability-v1",
+      "rfc": "0003",
+      "codePrefixes": ["HQ_SQL_PORT_"],
+      "files": [
+        { "path": "sql-portability-v1/portable.json", "role": "portable" },
+        { "path": "sql-portability-v1/non-portable.json", "role": "non-portable" }
+      ]
+    }
+  ],
+  "fuzz": [
+    { "path": "fuzz-seeds-v1/value-sources.json", "family": "tagged-values-v1" },
+    { "path": "fuzz-seeds-v1/structured-values.json" },
+    { "path": "fuzz-seeds-v1/sql-expressions.json", "family": "sql-portability-v1" }
+  ]
+}

package/fixtures/query-diagnostics-v1/README.md

@@ -0,0 +1,49 @@
+# Query diagnostics v1 fixtures
+
+- `success.json` contains complete diagnostics projections accepted by the v1
+  validator.
+- `rejections.json` maps generated invalid inputs to stable failure codes.
+
+These fixtures exercise RFC 0011. The diagnostics projection is privileged
+(RFC 0009): it may carry the non-executable RFC 0010 debug form
+(`debugQuery`), terminal reason, attempt count, runtime identity, and a safe
+message. Rejections prove result rows (`unknown-result-field`) and
+credentials (`unknown-credentials-field`) have no representable field, and
+that `newer-version` fails closed for older consumers. Note that
+`full-diagnostics.debugQuery` uses the deliberately non-executable
+placeholder syntax of RFC 0010 and carries no parameter values.
+
+## Generated rejection semantics
+
+Every rejection is a deterministic transform of this pinned base projection
+(RFC 0012):
+
+```json
+{
+  "kind": "hypequery-query-diagnostics",
+  "version": 1,
+  "eventId": "0000000000000000000000000000000000000000000000000000000000000000",
+  "queryId": "1111111111111111111111111111111111111111111111111111111111111111",
+  "terminalReason": "completed",
+  "attempts": 1
+}
+```
+
+Generator types expand as follows:
+
+- `wrong-root-type`: an empty array instead of an object;
+- `missing-required-field`: the base without `attempts`;
+- `unknown-result-field`: the base plus `"rows": [[1, 2]]`;
+- `unknown-credentials-field`: the base plus `"password": "hunter2"`;
+- `newer-version`: the base with `"version": 2`;
+- `malformed-query-id`: the base with `"queryId": "bad"`;
+- `unknown-terminal-reason`: the base with `"terminalReason": "exploded"`;
+- `zero-attempts`: the base with `"attempts": 0`;
+- `control-character-message`: the base plus a `safeMessage` of `bad`,
+  U+0007 (BEL), then `message`;
+- `oversized-debug-query`: the base plus a `debugQuery` of 4097 repetitions
+  of `x`;
+- `unsafe-accessor`: the base with `kind` served by an enumerable computed
+  accessor returning `"hypequery-query-diagnostics"` instead of a plain
+  data property. Host-model conditional (RFC 0012): implementations whose
+  input model cannot express computed accessors skip this case.

package/fixtures/query-diagnostics-v1/rejections.json

@@ -0,0 +1,13 @@
+[
+  { "id": "wrong-root-type", "generator": { "type": "wrong-root-type" }, "error": "HQ_DIAGNOSTICS_TYPE" },
+  { "id": "missing-required-field", "generator": { "type": "missing-required-field" }, "error": "HQ_DIAGNOSTICS_TYPE" },
+  { "id": "unknown-result-field", "generator": { "type": "unknown-result-field" }, "error": "HQ_DIAGNOSTICS_UNKNOWN_FIELD" },
+  { "id": "unknown-credentials-field", "generator": { "type": "unknown-credentials-field" }, "error": "HQ_DIAGNOSTICS_UNKNOWN_FIELD" },
+  { "id": "newer-version", "generator": { "type": "newer-version" }, "error": "HQ_DIAGNOSTICS_INVALID_VERSION" },
+  { "id": "malformed-query-id", "generator": { "type": "malformed-query-id" }, "error": "HQ_DIAGNOSTICS_INVALID_VALUE" },
+  { "id": "unknown-terminal-reason", "generator": { "type": "unknown-terminal-reason" }, "error": "HQ_DIAGNOSTICS_INVALID_VALUE" },
+  { "id": "zero-attempts", "generator": { "type": "zero-attempts" }, "error": "HQ_DIAGNOSTICS_INVALID_VALUE" },
+  { "id": "control-character-message", "generator": { "type": "control-character-message" }, "error": "HQ_DIAGNOSTICS_INVALID_VALUE" },
+  { "id": "oversized-debug-query", "generator": { "type": "oversized-debug-query" }, "error": "HQ_DIAGNOSTICS_TOO_LARGE" },
+  { "id": "unsafe-accessor", "generator": { "type": "unsafe-accessor" }, "error": "HQ_DIAGNOSTICS_UNSAFE_OBJECT" }
+]

package/fixtures/query-diagnostics-v1/success.json

@@ -0,0 +1,27 @@
+[
+  {
+    "id": "minimal-diagnostics",
+    "value": {
+      "kind": "hypequery-query-diagnostics",
+      "version": 1,
+      "eventId": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
+      "queryId": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "terminalReason": "completed",
+      "attempts": 1
+    }
+  },
+  {
+    "id": "full-diagnostics",
+    "value": {
+      "kind": "hypequery-query-diagnostics",
+      "version": 1,
+      "eventId": "fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210",
+      "queryId": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+      "terminalReason": "deadline-exceeded",
+      "attempts": 3,
+      "runtimeIdentity": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+      "debugQuery": "SELECT sum(revenue) FROM orders WHERE tenant_id = {tenant_fingerprint:String} AND day >= {start_date:Date}",
+      "safeMessage": "The query exceeded its execution deadline."
+    }
+  }
+]

package/fixtures/query-events-v1/README.md

@@ -0,0 +1,60 @@
+# Query event v1 fixtures
+
+- `success.json` contains complete events accepted by the v1 validator.
+- `rejections.json` maps generated invalid inputs to stable failure codes.
+
+These fixtures exercise RFC 0011. Rejections include payloads attempting to
+carry SQL text (`unknown-sql-field`), parameter values
+(`unknown-parameters-field`), and a raw tenant identifier
+(`unknown-raw-tenant-field`): the default event has no field that can accept
+them, so each fails closed as an unknown field. `newer-version` proves an
+older consumer rejects an unknown version cleanly; consumers may skip such
+records without failing an event stream.
+
+## Generated rejection semantics
+
+Every rejection is a deterministic transform of this pinned base event
+(RFC 0012):
+
+```json
+{
+  "kind": "hypequery-query-event",
+  "version": 1,
+  "eventId": "0000000000000000000000000000000000000000000000000000000000000000",
+  "occurredAt": "2026-07-20T12:34:56.789Z",
+  "target": { "project": "project_1", "environment": "production" },
+  "queryName": "daily_revenue",
+  "operation": "query",
+  "outcome": "success",
+  "durationMs": 182
+}
+```
+
+Generator types expand as follows:
+
+- `wrong-root-type`: an empty array instead of an object;
+- `missing-required-field`: the base without `durationMs`;
+- `unknown-sql-field`: the base plus `"sql": "SELECT 1"`;
+- `unknown-parameters-field`: the base plus
+  `"parameters": { "start": "2026-01-01" }`;
+- `unknown-raw-tenant-field`: the base plus `"tenantId": "acme"`;
+- `newer-version`: the base with `"version": 2`;
+- `malformed-event-id`: the base with `"eventId": "bad"`;
+- `invalid-occurred-at`: the base with
+  `"occurredAt": "2026-13-40T99:99:99Z"`;
+- `failure-without-category`: the base with `"outcome": "failure"` and no
+  `errorCategory`;
+- `success-with-category`: the base plus `"errorCategory": "internal"`
+  while `outcome` stays `"success"`;
+- `unknown-error-category`: the base with `"outcome": "failure"` plus
+  `"errorCategory": "exploded"`;
+- `negative-duration`: the base with `"durationMs": -1`;
+- `invalid-target`: the base with
+  `"target": { "project": "has space", "environment": "production" }`;
+- `invalid-query-name`: the base with `"queryName": "not an identifier"`;
+- `oversized-correlation-id`: the base plus a `correlationId` of 2049
+  repetitions of `x`;
+- `unsafe-accessor`: the base with `kind` served by an enumerable computed
+  accessor returning `"hypequery-query-event"` instead of a plain data
+  property. Host-model conditional (RFC 0012): implementations whose input
+  model cannot express computed accessors skip this case.

package/fixtures/query-events-v1/rejections.json

@@ -0,0 +1,18 @@
+[
+  { "id": "wrong-root-type", "generator": { "type": "wrong-root-type" }, "error": "HQ_EVENT_TYPE" },
+  { "id": "missing-required-field", "generator": { "type": "missing-required-field" }, "error": "HQ_EVENT_TYPE" },
+  { "id": "unknown-sql-field", "generator": { "type": "unknown-sql-field" }, "error": "HQ_EVENT_UNKNOWN_FIELD" },
+  { "id": "unknown-parameters-field", "generator": { "type": "unknown-parameters-field" }, "error": "HQ_EVENT_UNKNOWN_FIELD" },
+  { "id": "unknown-raw-tenant-field", "generator": { "type": "unknown-raw-tenant-field" }, "error": "HQ_EVENT_UNKNOWN_FIELD" },
+  { "id": "newer-version", "generator": { "type": "newer-version" }, "error": "HQ_EVENT_INVALID_VERSION" },
+  { "id": "malformed-event-id", "generator": { "type": "malformed-event-id" }, "error": "HQ_EVENT_INVALID_VALUE" },
+  { "id": "invalid-occurred-at", "generator": { "type": "invalid-occurred-at" }, "error": "HQ_EVENT_INVALID_VALUE" },
+  { "id": "failure-without-category", "generator": { "type": "failure-without-category" }, "error": "HQ_EVENT_INVALID_VALUE" },
+  { "id": "success-with-category", "generator": { "type": "success-with-category" }, "error": "HQ_EVENT_INVALID_VALUE" },
+  { "id": "unknown-error-category", "generator": { "type": "unknown-error-category" }, "error": "HQ_EVENT_INVALID_VALUE" },
+  { "id": "negative-duration", "generator": { "type": "negative-duration" }, "error": "HQ_EVENT_INVALID_VALUE" },
+  { "id": "invalid-target", "generator": { "type": "invalid-target" }, "error": "HQ_EVENT_INVALID_VALUE" },
+  { "id": "invalid-query-name", "generator": { "type": "invalid-query-name" }, "error": "HQ_EVENT_INVALID_VALUE" },
+  { "id": "oversized-correlation-id", "generator": { "type": "oversized-correlation-id" }, "error": "HQ_EVENT_TOO_LARGE" },
+  { "id": "unsafe-accessor", "generator": { "type": "unsafe-accessor" }, "error": "HQ_EVENT_UNSAFE_OBJECT" }
+]

package/fixtures/query-events-v1/success.json

@@ -0,0 +1,40 @@
+[
+  {
+    "id": "minimal-success-event",
+    "value": {
+      "kind": "hypequery-query-event",
+      "version": 1,
+      "eventId": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
+      "occurredAt": "2026-07-20T12:34:56.789Z",
+      "target": {
+        "project": "prj_acme-analytics",
+        "environment": "production"
+      },
+      "queryName": "daily_revenue",
+      "operation": "query",
+      "outcome": "success",
+      "durationMs": 182
+    }
+  },
+  {
+    "id": "full-failure-event",
+    "value": {
+      "kind": "hypequery-query-event",
+      "version": 1,
+      "eventId": "fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210",
+      "occurredAt": "2026-07-20T23:59:59Z",
+      "target": {
+        "project": "prj_acme-analytics",
+        "environment": "staging"
+      },
+      "queryName": "analytics.weekly_active_users",
+      "operation": "insert",
+      "outcome": "failure",
+      "errorCategory": "deadline-exceeded",
+      "durationMs": 30000,
+      "rowCount": 4200,
+      "tenantFingerprint": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "correlationId": "checkout-deploy-2026-07-20T21:00Z"
+    }
+  }
+]

package/fixtures/query-implementations-v1/README.md

@@ -0,0 +1,33 @@
+# Query implementation extension 1 fixtures
+
+`success.json` contains trusted SQL expressions and all three closed named-query
+implementation kinds. `rejections.json` maps invalid artifacts to stable RFC
+0005 failure codes. Generator entries create values that JSON cannot represent
+concisely or safely.
+
+These fixtures validate artifact structure only. They do not assert that SQL is
+valid ClickHouse SQL or authorize it for execution; the trusted ClickHouse
+adapter performs those checks.
+
+## Generated rejection semantics
+
+Rejection entries carry a `surface` (`sql-expression` or `implementation`)
+selecting the validated artifact kind, exactly one of `value` or
+`generator`, and the required stable `error` code. Generator types expand as
+follows (RFC 0012):
+
+- `parameters`: a compiled SQL implementation
+  `{ "kind": "compiled-sql", "dialect": "clickhouse", "operation":
+  "select", "statement": "SELECT 1", "parameters": [...], "readSources":
+  [], "tenant": { "kind": "not-required" } }` whose parameters are `count`
+  entries `{ "name": "param<i>", "source": { "kind": "input", "path":
+  "param<i>" }, "clickHouseType": "String" }` for `i` from 0 to
+  `count - 1`;
+- `sql-expression`: `{ "kind": "sql-expression", "dialect": "clickhouse",
+  "sql": ..., "output": { "kind": "string" }, "dependencies": [] }` with a
+  `sql` of `bytes` repetitions of `a`;
+- `unsafe-accessor`: an object with `kind` served by an enumerable computed
+  accessor returning `"semantic-plan"` instead of a plain data property,
+  and no other properties. Host-model conditional (RFC 0012):
+  implementations whose input model cannot express computed accessors skip
+  this case.

package/fixtures/query-implementations-v1/rejections.json

@@ -0,0 +1,80 @@
+[
+  {
+    "id": "implementation-not-object",
+    "surface": "query-implementation",
+    "value": null,
+    "error": "HQ_QUERY_IMPLEMENTATION_TYPE"
+  },
+  {
+    "id": "implementation-extra-field",
+    "surface": "query-implementation",
+    "value": {
+      "kind": "runtime-reference",
+      "runtime": "node",
+      "artifactSha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
+      "entrypoint": "queries.run",
+      "path": "./queries.js"
+    },
+    "error": "HQ_QUERY_IMPLEMENTATION_UNKNOWN_FIELD"
+  },
+  {
+    "id": "implementation-unknown-kind",
+    "surface": "query-implementation",
+    "value": { "kind": "raw-sql" },
+    "error": "HQ_QUERY_IMPLEMENTATION_UNKNOWN_KIND"
+  },
+  {
+    "id": "runtime-invalid-entrypoint",
+    "surface": "query-implementation",
+    "value": {
+      "kind": "runtime-reference",
+      "runtime": "node",
+      "artifactSha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
+      "entrypoint": "queries/customerRevenue"
+    },
+    "error": "HQ_QUERY_IMPLEMENTATION_INVALID_IDENTIFIER"
+  },
+  {
+    "id": "runtime-uppercase-digest",
+    "surface": "query-implementation",
+    "value": {
+      "kind": "runtime-reference",
+      "runtime": "node",
+      "artifactSha256": "0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF",
+      "entrypoint": "queries.run"
+    },
+    "error": "HQ_QUERY_IMPLEMENTATION_INVALID_VALUE"
+  },
+  {
+    "id": "compiled-sql-missing-tenant-parameter",
+    "surface": "query-implementation",
+    "value": {
+      "kind": "compiled-sql",
+      "dialect": "clickhouse",
+      "operation": "select",
+      "statement": "SELECT * FROM trips WHERE tenant_id = {tenantId:UUID}",
+      "parameters": [],
+      "readSources": ["trips"],
+      "tenant": { "kind": "required", "parameter": "tenantId" }
+    },
+    "error": "HQ_QUERY_IMPLEMENTATION_INVALID_REFERENCE"
+  },
+  {
+    "id": "compiled-sql-too-many-parameters",
+    "surface": "query-implementation",
+    "generator": { "type": "parameters", "count": 101 },
+    "error": "HQ_QUERY_IMPLEMENTATION_TOO_MANY_ITEMS"
+  },
+  {
+    "id": "sql-expression-too-large",
+    "surface": "sql-expression",
+    "generator": { "type": "sql-expression", "bytes": 65537 },
+    "error": "HQ_QUERY_IMPLEMENTATION_TOO_LARGE"
+  },
+  {
+    "id": "implementation-accessor",
+    "surface": "query-implementation",
+    "generator": { "type": "unsafe-accessor" },
+    "error": "HQ_QUERY_IMPLEMENTATION_UNSAFE_OBJECT"
+  }
+]

package/fixtures/query-implementations-v1/success.json

@@ -0,0 +1,96 @@
+[
+  {
+    "id": "sql-dimension-expression",
+    "surface": "sql-expression",
+    "value": {
+      "kind": "sql-expression",
+      "dialect": "clickhouse",
+      "sql": "toDate(pickup_datetime)",
+      "output": { "kind": "string" },
+      "dependencies": ["pickup_datetime"]
+    }
+  },
+  {
+    "id": "sql-measure-expression",
+    "surface": "sql-expression",
+    "value": {
+      "kind": "sql-expression",
+      "dialect": "clickhouse",
+      "sql": "quantileExact(0.95)(trip_distance)",
+      "output": { "kind": "number" },
+      "dependencies": ["trip_distance"]
+    }
+  },
+  {
+    "id": "fixed-semantic-plan",
+    "surface": "query-implementation",
+    "value": {
+      "kind": "semantic-plan",
+      "query": {
+        "kind": "dataset",
+        "dataset": "trips",
+        "dimensions": ["pickup_date"],
+        "measures": ["count", "total_revenue"],
+        "limit": 100
+      }
+    }
+  },
+  {
+    "id": "compiled-sql-input-parameters",
+    "surface": "query-implementation",
+    "value": {
+      "kind": "compiled-sql",
+      "dialect": "clickhouse",
+      "operation": "select",
+      "statement": "SELECT pickup_date, count() AS count FROM trips WHERE pickup_date >= {from:Date} GROUP BY pickup_date",
+      "parameters": [
+        {
+          "name": "from",
+          "source": { "kind": "input", "path": "range.from" },
+          "clickHouseType": "Date"
+        }
+      ],
+      "readSources": ["analytics.trips"],
+      "tenant": { "kind": "not-required" }
+    }
+  },
+  {
+    "id": "compiled-sql-required-tenant",
+    "surface": "query-implementation",
+    "value": {
+      "kind": "compiled-sql",
+      "dialect": "clickhouse",
+      "operation": "select",
+      "statement": "SELECT sum(total_amount) AS revenue FROM trips WHERE tenant_id = {tenantId:UUID}",
+      "parameters": [
+        {
+          "name": "tenantId",
+          "source": { "kind": "tenant" },
+          "clickHouseType": "UUID"
+        }
+      ],
+      "readSources": ["trips"],
+      "tenant": { "kind": "required", "parameter": "tenantId" }
+    }
+  },
+  {
+    "id": "node-runtime-reference",
+    "surface": "query-implementation",
+    "value": {
+      "kind": "runtime-reference",
+      "runtime": "node",
+      "artifactSha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
+      "entrypoint": "queries.customerRevenue"
+    }
+  },
+  {
+    "id": "python-runtime-reference",
+    "surface": "query-implementation",
+    "value": {
+      "kind": "runtime-reference",
+      "runtime": "python",
+      "artifactSha256": "abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789",
+      "entrypoint": "queries.customer_revenue"
+    }
+  }
+]

package/fixtures/query-schemas-v1/README.md

@@ -0,0 +1,25 @@
+# Portable query schema fixtures, version 1
+
+These fixtures accompany RFC 0004. Success fixtures cover every schema kind
+and every currently portable Serve/Zod feature. Rejection fixtures cover every
+stable failure code; generators describe oversized or unsafe inputs that
+cannot be represented directly in JSON.
+
+## Generated rejection semantics
+
+Rejection entries carry exactly one of `value` or `generator` and the
+required stable `error` code. Generator types expand as follows (RFC 0012):
+
+- `nested-array`: wraps `{ "kind": "any" }` in
+  `{ "kind": "array", "items": ... }` `depth` times;
+- `union-tree`: one `{ "kind": "union", "variants": [...] }` node whose
+  variants are 10 union nodes, each with 100 `{ "kind": "any" }` variants
+  (1011 nodes total);
+- `enum-values`: `{ "kind": "enum", "values": [...] }` with `count` values
+  `v0` through `v<count - 1>`;
+- `description`: `{ "kind": "string", "description": ... }` with a
+  description of `bytes` repetitions of `a`;
+- `unsafe-accessor`: an object with `kind` served by an enumerable computed
+  accessor returning `"string"` instead of a plain data property, and no
+  other properties. Host-model conditional (RFC 0012): implementations
+  whose input model cannot express computed accessors skip this case.