f47060d5c2
New contracts/cultnet/cultnet.raw-document-header.schema.json for
CultNetRawDocumentHeader - it has no payload/payloadEncoding members at all,
so headers must not $ref the record schema (which required both). The
response page's own schema now lists every property CultNetSnapshotResponseRawV1Message
declares as `required` (present on the wire, nil included) rather than only
the four that happened to be non-nullable - MessagePack-CSharp's map-mode
formatter writes every declared key regardless of null, so `headers`/`documents`
are always both present, one an array and the other an explicit null by
projection. The old `oneOf: [{required:[headers]},{required:[documents]}]`
matched both branches on every real page (both keys present) and so never
validated anything; it is now `oneOf` over each key's type (array vs null),
which is mutually exclusive. cultnet.raw-document-record.schema.json gained
schemaName/schemaVersion/schemaContentHash (present on every real record, not
previously in the schema at all - any real page would have failed
additionalProperties:false on them). fieldPredicate's two oneOf branches each
gained `not: {required: [the other]}`, so `values` and `number` cannot both
be present (previously only `required` was checked, which does not exclude
the sibling key).
Added MiniJsonSchemaValidator, a deliberately small draft-2020-12 subset
validator (type/required/additionalProperties/properties/items/const/enum/
pattern/minLength/minItems/oneOf/$ref, same-document and cross-document) -
no schema-validation dependency existed in this repo, and this only needs to
cover what contracts/cultnet/*.schema.json actually use. CultNetSchemaContractTests
decodes real wire bytes from a live CultNetDatabaseServer (header projection,
document projection, and a hop with edges) through MessagePackSerializer.ConvertToJson
and checks them against the committed schema files, plus three
fieldPredicate-shape tests pinning the values/number exclusivity.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
43 lines
1.6 KiB
JSON
43 lines
1.6 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://github.com/GameCult/CultLib/contracts/cultnet/cultnet.raw-document-record.schema.json",
|
|
"title": "CultNet Raw Document Record",
|
|
"description": "R-S (docs/cultnet-selection-cut.md, fix batch 3): matches MessagePack-CSharp's map-mode output for CultNetRawDocumentRecord - every declared key is written, nil included, so every property here is `required` (present on the wire) even where its value may be null.",
|
|
"type": "object",
|
|
"required": [
|
|
"schemaId",
|
|
"schemaName",
|
|
"schemaVersion",
|
|
"schemaContentHash",
|
|
"recordKey",
|
|
"storedAt",
|
|
"payloadEncoding",
|
|
"payload",
|
|
"sourceRuntimeId",
|
|
"sourceAgentId",
|
|
"sourceRole",
|
|
"tags"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"schemaId": { "type": "string", "minLength": 1 },
|
|
"schemaName": { "type": ["string", "null"], "minLength": 1 },
|
|
"schemaVersion": { "type": ["string", "null"], "minLength": 1 },
|
|
"schemaContentHash": { "type": ["string", "null"], "minLength": 1 },
|
|
"recordKey": { "type": "string", "minLength": 1 },
|
|
"storedAt": { "type": "string", "minLength": 1 },
|
|
"payloadEncoding": { "const": "messagepack" },
|
|
"payload": {
|
|
"type": "string",
|
|
"contentEncoding": "base64",
|
|
"x-cult-runtime-type": "bytes"
|
|
},
|
|
"sourceRuntimeId": { "type": ["string", "null"], "minLength": 1 },
|
|
"sourceAgentId": { "type": ["string", "null"], "minLength": 1 },
|
|
"sourceRole": { "type": ["string", "null"], "minLength": 1 },
|
|
"tags": {
|
|
"type": ["array", "null"],
|
|
"items": { "type": "string", "minLength": 1 }
|
|
}
|
|
}
|
|
}
|