games-development-ai/contracts/play-loop/match3-roll-interaction-audit.schema.json
lili cbfd4d871b
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
docs-gate / docs-gate (push) Has been cancelled
feat(acceptance): 闭合 playtest v3 与 A+ 可信消费链
固化 Match-3 生产者、视觉、音频与双 Judge 证据闭包。

将《山海行纪》r1.1 绑定新的不可变 release,并以生产预检现场核验 bundle、Registry/2 和 25 项 Writer 快照。

同步地图1平衡锁值、跨游戏回归修复、验收契约与 SoT 证据。
2026-07-28 20:16:13 -07:00

105 lines
5.5 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://wanxiang.ai/contracts/play-loop/match3-roll-interaction-audit.schema.json",
"title": "Match3RollInteractionAuditV1",
"description": "单掷 Match-3 actionGroup/一次 reset 的完整审计入口;最多两组、一次恢复。",
"type": "object",
"required": [
"schemaVersion", "rollId", "gameId", "artifactHash", "taskBindingHash",
"acceptanceRequestHash", "seed", "interactionProfileId", "interactionRegistryVersion",
"interactionBindingHash", "interactionBindingRef", "interactionBindingFileHash",
"producerPreflightRef", "producerPreflightHash",
"initialRemainingBudget", "groups", "reset", "finalState", "auditHash"
],
"properties": {
"schemaVersion": { "const": "Match3RollInteractionAudit/1" },
"rollId": { "type": "string", "pattern": "^roll-[12]$" },
"gameId": { "type": "string", "minLength": 1 },
"artifactHash": { "$ref": "#/$defs/sha256" },
"taskBindingHash": { "$ref": "#/$defs/sha256" },
"acceptanceRequestHash": { "$ref": "#/$defs/sha256" },
"seed": { "type": "integer", "minimum": 0 },
"interactionProfileId": { "const": "match3.orthogonal-swap-v1" },
"interactionRegistryVersion": { "const": "2026-07-15.v2" },
"interactionBindingHash": { "$ref": "#/$defs/sha256" },
"interactionBindingRef": { "type": "string", "minLength": 1 },
"interactionBindingFileHash": { "$ref": "#/$defs/sha256" },
"producerPreflightRef": { "type": "string", "minLength": 1 },
"producerPreflightHash": { "$ref": "#/$defs/sha256" },
"initialRemainingBudget": { "type": "integer", "minimum": 2 },
"groups": { "type": "array", "minItems": 1, "maxItems": 2, "items": { "$ref": "#/$defs/groupRef" } },
"reset": { "anyOf": [{ "type": "null" }, { "$ref": "#/$defs/resetAudit" }] },
"finalState": { "enum": ["completed", "inconclusive_board_identity_unresolved"] },
"auditHash": { "$ref": "#/$defs/sha256" }
},
"additionalProperties": false,
"$defs": {
"sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
"groupRef": {
"type": "object",
"required": [
"ref", "hash", "selectionAttemptRef", "selectionAttemptHash", "pairResolutionRef", "pairResolutionHash",
"firstGroupedActionRef", "firstGroupedActionHash", "secondGroupedActionRef",
"secondGroupedActionHash", "boardIdentityCheckRef", "boardIdentityCheckHash",
"actionGroupId", "candidateSetHash", "candidateId", "state"
],
"properties": {
"ref": { "type": "string", "minLength": 1 },
"hash": { "$ref": "#/$defs/sha256" },
"selectionAttemptRef": { "type": "string", "minLength": 1 },
"selectionAttemptHash": { "$ref": "#/$defs/sha256" },
"pairResolutionRef": { "type": "string", "minLength": 1 },
"pairResolutionHash": { "$ref": "#/$defs/sha256" },
"firstGroupedActionRef": { "type": "string", "minLength": 1 },
"firstGroupedActionHash": { "$ref": "#/$defs/sha256" },
"secondGroupedActionRef": { "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }] },
"secondGroupedActionHash": { "anyOf": [{ "$ref": "#/$defs/sha256" }, { "type": "null" }] },
"boardIdentityCheckRef": { "type": "string", "minLength": 1 },
"boardIdentityCheckHash": { "$ref": "#/$defs/sha256" },
"actionGroupId": { "type": "string", "pattern": "^action-group-[1-9][0-9]*$" },
"candidateSetHash": { "$ref": "#/$defs/sha256" },
"candidateId": { "type": "string", "pattern": "^ms[0-9]{2,3}$" },
"state": { "enum": ["completed", "aborted"] }
},
"additionalProperties": false
},
"resetAudit": {
"type": "object",
"required": [
"betweenActionGroupIds", "groupedActionRef", "groupedActionHash",
"nativeActionRef", "nativeActionHash", "eventSliceRef", "eventSliceHash",
"resetTargetSetRef", "resetTargetSetHash",
"postResetFrameFileRef", "postResetFrameHash",
"postResetTargetSetRef", "postResetTargetSetHash", "postResetProjectionRef",
"postResetProjectionHash", "postResetSwapSetRef", "postResetSwapSetHash",
"budgetMs", "resultingCandidateSetHash"
],
"properties": {
"betweenActionGroupIds": {
"type": "array", "minItems": 2, "maxItems": 2,
"items": { "type": "string", "pattern": "^action-group-[1-9][0-9]*$" }
},
"groupedActionRef": { "type": "string", "minLength": 1 },
"groupedActionHash": { "$ref": "#/$defs/sha256" },
"nativeActionRef": { "type": "string", "minLength": 1 },
"nativeActionHash": { "$ref": "#/$defs/sha256" },
"eventSliceRef": { "type": "string", "minLength": 1 },
"eventSliceHash": { "$ref": "#/$defs/sha256" },
"resetTargetSetRef": { "type": "string", "minLength": 1 },
"resetTargetSetHash": { "$ref": "#/$defs/sha256" },
"postResetFrameFileRef": { "type": "string", "minLength": 1 },
"postResetFrameHash": { "$ref": "#/$defs/sha256" },
"postResetTargetSetRef": { "type": "string", "minLength": 1 },
"postResetTargetSetHash": { "$ref": "#/$defs/sha256" },
"postResetProjectionRef": { "type": "string", "minLength": 1 },
"postResetProjectionHash": { "$ref": "#/$defs/sha256" },
"postResetSwapSetRef": { "type": "string", "minLength": 1 },
"postResetSwapSetHash": { "$ref": "#/$defs/sha256" },
"budgetMs": { "const": 600 },
"resultingCandidateSetHash": { "$ref": "#/$defs/sha256" }
},
"additionalProperties": false
}
}
}