@hypequery/protocol-conformance 0.16.1 → 0.17.0

package/dist/client-contract-fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-contract-fixtures.d.ts","sourceRoot":"","sources":["../src/client-contract-fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqBjD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAwBpF"}
+{"version":3,"file":"client-contract-fixtures.d.ts","sourceRoot":"","sources":["../src/client-contract-fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqBjD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CA4BpF"}

package/dist/client-contract-fixtures.js

@@ -43,6 +43,11 @@ export function composeClientContractCases(cases) {
                 const dimensions = Object.fromEntries(Array.from({ length: 256 }, (_, i) => ['field' + i, null]));
                 value = { ...base(values, 'build'), endpoints: Array.from({ length: generator.count }, () => ({ dimensions })) };
             }
+            else if (generator.type === 'annotation-fields') {
+                const fields = Object.fromEntries(Array.from({ length: generator.count }, (_, i) => ['field' + i, { label: 'x' }]));
+                const build = base(values, 'build'), endpoints = build.endpoints;
+                value = { ...build, endpoints: [{ ...endpoints[0], annotations: { fields } }, ...endpoints.slice(1)] };
+            }
             else if (generator.type === 'members')
                 value = Array.from({ length: generator.count }, () => null);
             else if (generator.type === 'bytes')

package/fixtures/client-contract-v1/README.md

@@ -3,7 +3,8 @@
 Normative vectors for [RFC 0018](../../rfc/0018-semantic-client-contract.md).
 The family is required by the TypeScript/Python conformance gates.
 
-- success.json pins build, metric-only, empty and narrowed signed contracts.
+- success.json pins build, metric-only, empty, narrowed and annotated signed contracts.
+  annotated is build plus endpoint annotations: same schemaHashes, new contentHash.
 - identities.json pins canonical complete documents and both identity domains.
 - rejections.json pins malformed descriptors, identity failures, safe messages
   and JSON Pointer paths, plus exact size/depth/count boundaries and text decoding.
@@ -19,7 +20,8 @@ implementations receive complete inputs and need no fixture-file access. A set
 array adds/replaces fields in a deep-copied base using RFC 6901 JSON Pointers;
 - appends an array element. Parents must exist. It never recomputes identities:
 malformed shape validation must precede identity validation. The runner's boundary
-generators expand only synthetic byte, depth, endpoint, descriptor and array-member counts.
+generators expand only synthetic byte, depth, endpoint, descriptor, annotation-field
+and array-member counts.
 Identity cases reuse the matching success value, as other fixture families do.
 
 The query compiler preserves fixed MCP tool names; empty target sets have required
@@ -27,3 +29,8 @@ never-valued routing fields. JSON Schema pins structural types; call-time semant
 validation additionally enforces selected fields, uniqueness, portable timezones
 and combined predicate budgets. No artifact identity authenticates a principal or
 certifies an endpoint's execution implementation.
+
+RFC 0023 added the `null-checks` contract, whose filters advertise isNull and
+isNotNull on every logical type, with value-free accepted queries and rejections
+for a null check carrying a value (null included), one the filter does not
+advertise, and a value operator without a value.

package/fixtures/client-contract-v1/identities.json

@@ -32,5 +32,23 @@
       "ordersRevenue": "e282fb74777e65328d87cfe5caa0349104630cd88137b1842289e0c83676a98d"
     },
     "sha256": "c350b9b6e0351acbbac7509bf5d889afa343b9fb5048d826265d8e9f5ef895d8"
+  },
+  {
+    "id": "annotated",
+    "canonical": "{\"contentHash\":\"1cc64833994d5da761e9dae3b62992f66b6a270f01228ab97d91ebb74e54ae85\",\"endpoints\":[{\"annotations\":{\"description\":\"Reference list of supported countries.\",\"label\":\"Countries\"},\"dataset\":\"countries\",\"defaultMeasures\":[],\"dimensions\":{\"country\":{\"groupable\":true,\"nullable\":false,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"}},\"filters\":{},\"id\":\"countries\",\"kind\":\"dataset\",\"limits\":{\"defaultLimit\":100,\"maxDimensions\":50,\"maxFilterValues\":1000,\"maxLimit\":1000,\"maxMeasures\":0,\"maxOffset\":10000,\"maxOrderBy\":50,\"maxPredicates\":0},\"measures\":{},\"metadata\":false,\"path\":\"/api/v1/datasets/countries/query\",\"schemaHash\":\"9a5f50cd7564f283d2f0ee8f3f1cdc27731683c939e176bd25919a83d28d94ca\",\"time\":null},{\"annotations\":{\"description\":\"One row per customer order.\",\"fields\":{\"country\":{\"label\":\"Country\"},\"customer.tier\":{\"description\":\"Tier of the ordering customer.\"},\"revenue\":{\"description\":\"Gross order value in €, before refunds.\",\"label\":\"Revenue\"}},\"label\":\"Orders\"},\"dataset\":\"orders\",\"defaultMeasures\":[\"revenue\",\"orderCount\",\"latestLabel\"],\"dimensions\":{\"amount\":{\"groupable\":true,\"nullable\":\"unknown\",\"orderable\":true,\"type\":\"number\",\"wireType\":\"number-or-string\"},\"country\":{\"groupable\":true,\"nullable\":false,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"},\"customer.active\":{\"groupable\":false,\"nullable\":true,\"orderable\":false,\"type\":\"boolean\",\"wireType\":\"boolean\"},\"customer.tier\":{\"groupable\":true,\"nullable\":true,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"}},\"filters\":{\"amount\":{\"operators\":[\"between\",\"eq\",\"gt\",\"gte\",\"in\",\"lt\",\"lte\",\"neq\",\"notIn\"],\"type\":\"number\"},\"country\":{\"operators\":[\"eq\",\"in\",\"like\",\"neq\",\"notIn\"],\"type\":\"string\"},\"customer.active\":{\"operators\":[\"eq\",\"neq\"],\"type\":\"boolean\"},\"customer.tier\":{\"operators\":[\"eq\",\"in\"],\"type\":\"string\"},\"paidStatus\":{\"operators\":[\"eq\"],\"type\":\"string\"}},\"id\":\"orders\",\"kind\":\"dataset\",\"limits\":{\"defaultLimit\":100,\"maxDimensions\":50,\"maxFilterValues\":1000,\"maxLimit\":1000,\"maxMeasures\":50,\"maxOffset\":10000,\"maxOrderBy\":50,\"maxPredicates\":100},\"measures\":{\"averageRevenue\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"},\"customer.unique\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"},\"latestLabel\":{\"having\":false,\"nullable\":true,\"wireType\":\"string\"},\"orderCount\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"},\"revenue\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"}},\"metadata\":true,\"path\":\"/api/v1/datasets/orders/query\",\"schemaHash\":\"88802c0d4798fd0758b7e7697f582b034afada967bfe0fdcb1cafd957144b1f3\",\"time\":{\"defaultTimezone\":\"UTC\",\"grains\":[\"day\",\"hour\",\"month\",\"week\"],\"periodFormat\":\"calendar-date-or-local-datetime-v1\",\"timezone\":true}},{\"annotations\":{\"description\":\"One row per customer order.\",\"fields\":{\"revenue\":{\"description\":\"Gross order value in €, before refunds.\",\"label\":\"Revenue\"}},\"label\":\"Orders\"},\"dataset\":\"orders\",\"dimensions\":{\"country\":{\"groupable\":true,\"nullable\":false,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"},\"customer.active\":{\"groupable\":false,\"nullable\":true,\"orderable\":false,\"type\":\"boolean\",\"wireType\":\"boolean\"},\"customer.tier\":{\"groupable\":true,\"nullable\":true,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"}},\"filters\":{\"amount\":{\"operators\":[\"between\",\"eq\",\"gt\",\"gte\",\"in\",\"lt\",\"lte\",\"neq\",\"notIn\"],\"type\":\"number\"},\"country\":{\"operators\":[\"eq\",\"in\",\"like\",\"neq\",\"notIn\"],\"type\":\"string\"},\"customer.active\":{\"operators\":[\"eq\",\"neq\"],\"type\":\"boolean\"},\"customer.tier\":{\"operators\":[\"eq\",\"in\"],\"type\":\"string\"},\"paidStatus\":{\"operators\":[\"eq\"],\"type\":\"string\"}},\"id\":\"ordersRevenue\",\"kind\":\"metric\",\"limits\":{\"defaultLimit\":20,\"maxDimensions\":50,\"maxFilterValues\":1000,\"maxLimit\":20,\"maxMeasures\":1,\"maxOffset\":10000,\"maxOrderBy\":50,\"maxPredicates\":100},\"measures\":{\"revenue\":{\"having\":false,\"nullable\":true,\"wireType\":\"string\"}},\"metadata\":true,\"path\":\"/api/v1/metrics/revenue\",\"schemaHash\":\"e282fb74777e65328d87cfe5caa0349104630cd88137b1842289e0c83676a98d\",\"time\":{\"defaultTimezone\":\"UTC\",\"grains\":[\"day\",\"hour\",\"month\",\"week\"],\"periodFormat\":\"calendar-date-or-local-datetime-v1\",\"timezone\":true}}],\"kind\":\"hypequery-client-contract\",\"version\":1,\"view\":\"build\"}",
+    "endpointHashes": {
+      "countries": "9a5f50cd7564f283d2f0ee8f3f1cdc27731683c939e176bd25919a83d28d94ca",
+      "orders": "88802c0d4798fd0758b7e7697f582b034afada967bfe0fdcb1cafd957144b1f3",
+      "ordersRevenue": "e282fb74777e65328d87cfe5caa0349104630cd88137b1842289e0c83676a98d"
+    },
+    "sha256": "1cc64833994d5da761e9dae3b62992f66b6a270f01228ab97d91ebb74e54ae85"
+  },
+  {
+    "id": "null-checks",
+    "canonical": "{\"contentHash\":\"08e3b75129b0f8c528d7dc25ba19ecf7472b5ef2a152655d3181c21e41f2e5c1\",\"endpoints\":[{\"dataset\":\"customers\",\"defaultMeasures\":[\"customerCount\"],\"dimensions\":{\"plan\":{\"groupable\":true,\"nullable\":true,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"}},\"filters\":{\"churnedAt\":{\"operators\":[\"gte\",\"isNotNull\",\"isNull\"],\"type\":\"timestamp\"},\"plan\":{\"operators\":[\"eq\",\"isNull\"],\"type\":\"string\"},\"seats\":{\"operators\":[\"isNotNull\"],\"type\":\"number\"},\"trial\":{\"operators\":[\"eq\",\"isNotNull\",\"isNull\"],\"type\":\"boolean\"}},\"id\":\"customers\",\"kind\":\"dataset\",\"limits\":{\"defaultLimit\":100,\"maxDimensions\":50,\"maxFilterValues\":1000,\"maxLimit\":1000,\"maxMeasures\":50,\"maxOffset\":10000,\"maxOrderBy\":50,\"maxPredicates\":100},\"measures\":{\"customerCount\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"}},\"metadata\":false,\"path\":\"/api/v1/datasets/customers/query\",\"schemaHash\":\"67821b626e7688afa43c6598893a736854b658924e4564361b1db8bcd1f3192d\",\"time\":null}],\"kind\":\"hypequery-client-contract\",\"version\":1,\"view\":\"build\"}",
+    "endpointHashes": {
+      "customers": "67821b626e7688afa43c6598893a736854b658924e4564361b1db8bcd1f3192d"
+    },
+    "sha256": "08e3b75129b0f8c528d7dc25ba19ecf7472b5ef2a152655d3181c21e41f2e5c1"
   }
 ]

package/fixtures/client-contract-v1/queries.json

@@ -28,6 +28,35 @@
       "effectiveLimit": 100
     }
   },
+  {
+    "id": "annotated-contract-query",
+    "contract": "annotated",
+    "endpoint": "orders",
+    "input": {},
+    "mode": "query",
+    "expected": {
+      "body": {
+        "dimensions": [],
+        "filters": [],
+        "orderBy": [],
+        "limit": 100,
+        "offset": 0,
+        "includeMeta": false,
+        "measures": [
+          "revenue",
+          "orderCount",
+          "latestLabel"
+        ],
+        "having": []
+      },
+      "selectedMeasures": [
+        "revenue",
+        "orderCount",
+        "latestLabel"
+      ],
+      "effectiveLimit": 100
+    }
+  },
   {
     "id": "explicit-derived-and-related",
     "contract": "build",
@@ -480,5 +509,113 @@
       ],
       "effectiveLimit": 1000
     }
+  },
+  {
+    "id": "null-check-filters-without-value",
+    "contract": "null-checks",
+    "endpoint": "customers",
+    "input": {
+      "filters": [
+        {
+          "field": "churnedAt",
+          "operator": "isNotNull"
+        },
+        {
+          "field": "plan",
+          "operator": "isNull"
+        },
+        {
+          "field": "seats",
+          "operator": "isNotNull"
+        },
+        {
+          "field": "trial",
+          "operator": "isNull"
+        }
+      ]
+    },
+    "mode": "query",
+    "expected": {
+      "body": {
+        "dimensions": [],
+        "filters": [
+          {
+            "field": "churnedAt",
+            "operator": "isNotNull"
+          },
+          {
+            "field": "plan",
+            "operator": "isNull"
+          },
+          {
+            "field": "seats",
+            "operator": "isNotNull"
+          },
+          {
+            "field": "trial",
+            "operator": "isNull"
+          }
+        ],
+        "orderBy": [],
+        "limit": 100,
+        "offset": 0,
+        "includeMeta": false,
+        "measures": [
+          "customerCount"
+        ],
+        "having": []
+      },
+      "selectedMeasures": [
+        "customerCount"
+      ],
+      "effectiveLimit": 100
+    }
+  },
+  {
+    "id": "null-check-beside-value-filter",
+    "contract": "null-checks",
+    "endpoint": "customers",
+    "input": {
+      "filters": [
+        {
+          "field": "churnedAt",
+          "operator": "isNotNull"
+        },
+        {
+          "field": "churnedAt",
+          "operator": "gte",
+          "value": "2026-01-01"
+        }
+      ]
+    },
+    "mode": "query",
+    "expected": {
+      "body": {
+        "dimensions": [],
+        "filters": [
+          {
+            "field": "churnedAt",
+            "operator": "isNotNull"
+          },
+          {
+            "field": "churnedAt",
+            "operator": "gte",
+            "value": "2026-01-01"
+          }
+        ],
+        "orderBy": [],
+        "limit": 100,
+        "offset": 0,
+        "includeMeta": false,
+        "measures": [
+          "customerCount"
+        ],
+        "having": []
+      },
+      "selectedMeasures": [
+        "customerCount"
+      ],
+      "effectiveLimit": 100
+    }
   }
 ]

package/fixtures/client-contract-v1/query-rejections.json

@@ -2110,5 +2110,110 @@
     "mode": "query",
     "path": "/limit",
     "message": "Invalid client query."
+  },
+  {
+    "id": "null-check-with-value-rejected",
+    "contract": "null-checks",
+    "endpoint": "customers",
+    "input": {
+      "filters": [
+        {
+          "field": "churnedAt",
+          "operator": "isNotNull",
+          "value": "2026-01-01"
+        }
+      ]
+    },
+    "error": "HQ_CLIENT_QUERY",
+    "mode": "query",
+    "path": "",
+    "message": "Invalid client query."
+  },
+  {
+    "id": "null-check-with-null-value-rejected",
+    "contract": "null-checks",
+    "endpoint": "customers",
+    "input": {
+      "filters": [
+        {
+          "field": "plan",
+          "operator": "isNull",
+          "value": null
+        }
+      ]
+    },
+    "error": "HQ_CLIENT_QUERY",
+    "mode": "query",
+    "path": "",
+    "message": "Invalid client query."
+  },
+  {
+    "id": "null-check-with-boolean-value-rejected",
+    "contract": "null-checks",
+    "endpoint": "customers",
+    "input": {
+      "filters": [
+        {
+          "field": "trial",
+          "operator": "isNull",
+          "value": true
+        }
+      ]
+    },
+    "error": "HQ_CLIENT_QUERY",
+    "mode": "query",
+    "path": "",
+    "message": "Invalid client query."
+  },
+  {
+    "id": "null-check-not-advertised",
+    "contract": "null-checks",
+    "endpoint": "customers",
+    "input": {
+      "filters": [
+        {
+          "field": "plan",
+          "operator": "isNotNull"
+        }
+      ]
+    },
+    "error": "HQ_CLIENT_QUERY",
+    "mode": "query",
+    "path": "",
+    "message": "Invalid client query."
+  },
+  {
+    "id": "null-check-not-advertised-by-build",
+    "contract": "build",
+    "endpoint": "orders",
+    "input": {
+      "filters": [
+        {
+          "field": "country",
+          "operator": "isNull"
+        }
+      ]
+    },
+    "error": "HQ_CLIENT_QUERY",
+    "mode": "query",
+    "path": "",
+    "message": "Invalid client query."
+  },
+  {
+    "id": "value-operator-without-value-rejected",
+    "contract": "null-checks",
+    "endpoint": "customers",
+    "input": {
+      "filters": [
+        {
+          "field": "churnedAt",
+          "operator": "gte"
+        }
+      ]
+    },
+    "error": "HQ_CLIENT_QUERY",
+    "mode": "query",
+    "path": "",
+    "message": "Invalid client query."
   }
 ]

package/fixtures/client-contract-v1/rejections.json

@@ -449,6 +449,265 @@
     "path": "/contentHash",
     "message": "Client contract identity does not match."
   },
+  {
+    "id": "annotation-not-object",
+    "base": "build",
+    "set": [
+      {
+        "path": "/endpoints/0/annotations",
+        "value": "Countries"
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/0/annotations",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-empty-object",
+    "base": "build",
+    "set": [
+      {
+        "path": "/endpoints/0/annotations",
+        "value": {}
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/0/annotations",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-unknown-field",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/owner",
+        "value": "analytics"
+      }
+    ],
+    "error": "HQ_CLIENT_UNKNOWN_FIELD",
+    "path": "/endpoints/1/annotations",
+    "message": "Unknown client contract field."
+  },
+  {
+    "id": "annotation-empty-fields",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/0/annotations/fields",
+        "value": {}
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/0/annotations/fields",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-empty-field-entry",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/fields/country",
+        "value": {}
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/1/annotations/fields/country",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-unknown-field-entry-member",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/fields/country/unit",
+        "value": "USD"
+      }
+    ],
+    "error": "HQ_CLIENT_UNKNOWN_FIELD",
+    "path": "/endpoints/1/annotations/fields/country",
+    "message": "Unknown client contract field."
+  },
+  {
+    "id": "annotation-non-string-label",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/label",
+        "value": 7
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/1/annotations/label",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-blank-description",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/description",
+        "value": " \u3000 "
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/1/annotations/description",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-byte-order-mark-only",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/label",
+        "value": "\ufeff"
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/1/annotations/label",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-line-break",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/description",
+        "value": "One row per\norder."
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/1/annotations/description",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-tab",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/fields/revenue/label",
+        "value": "Gross\trevenue"
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/1/annotations/fields/revenue/label",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-c1-control",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/label",
+        "value": "Orders\u0085"
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/1/annotations/label",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-text-4096-bytes",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/description",
+        "value": "éééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééé"
+      }
+    ],
+    "error": "HQ_CLIENT_IDENTITY",
+    "path": "/contentHash",
+    "message": "Client contract identity does not match."
+  },
+  {
+    "id": "annotation-text-4097-bytes",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/description",
+        "value": "ééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééééa"
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/1/annotations/description",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-invalid-field-name",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/fields/customer.next.tier",
+        "value": {
+          "label": "Tier"
+        }
+      }
+    ],
+    "error": "HQ_CLIENT_IDENTIFIER",
+    "path": "/endpoints/1/annotations/fields",
+    "message": "Invalid client contract identifier."
+  },
+  {
+    "id": "annotation-unknown-field-reference",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/fields/missing",
+        "value": {
+          "label": "Missing"
+        }
+      }
+    ],
+    "error": "HQ_CLIENT_REFERENCE",
+    "path": "/endpoints/1",
+    "message": "Inconsistent client contract reference."
+  },
+  {
+    "id": "annotation-filter-alias-reference",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/fields/paidStatus",
+        "value": {
+          "label": "Paid status"
+        }
+      }
+    ],
+    "error": "HQ_CLIENT_REFERENCE",
+    "path": "/endpoints/1",
+    "message": "Inconsistent client contract reference."
+  },
+  {
+    "id": "annotation-shape-precedes-reference",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/defaultMeasures",
+        "value": [
+          "missing"
+        ]
+      },
+      {
+        "path": "/endpoints/1/annotations/description",
+        "value": ""
+      }
+    ],
+    "error": "HQ_CLIENT_SHAPE",
+    "path": "/endpoints/1/annotations/description",
+    "message": "Invalid client contract shape."
+  },
+  {
+    "id": "annotation-does-not-sign-schema",
+    "base": "annotated",
+    "set": [
+      {
+        "path": "/endpoints/1/annotations/description",
+        "value": "Reworded without a new schemaHash."
+      }
+    ],
+    "error": "HQ_CLIENT_IDENTITY",
+    "path": "/contentHash",
+    "message": "Client contract identity does not match."
+  },
   {
     "id": "endpoints-256",
     "mode": "boundary",
@@ -590,5 +849,27 @@
     "error": "HQ_CLIENT_LIMIT",
     "path": "",
     "message": "Client contract exceeds validation limits."
+  },
+  {
+    "id": "annotation-fields-512",
+    "mode": "boundary",
+    "generator": {
+      "type": "annotation-fields",
+      "count": 512
+    },
+    "error": "HQ_CLIENT_REFERENCE",
+    "path": "/endpoints/0",
+    "message": "Inconsistent client contract reference."
+  },
+  {
+    "id": "annotation-fields-513",
+    "mode": "boundary",
+    "generator": {
+      "type": "annotation-fields",
+      "count": 513
+    },
+    "error": "HQ_CLIENT_LIMIT",
+    "path": "/endpoints/0/annotations/fields",
+    "message": "Client contract exceeds validation limits."
   }
 ]