games-development-ai/contracts/play-loop/acceptance-provenance-v3.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://wanxiang.ai/contracts/play-loop/acceptance-provenance-v3.schema.json",
  "title": "AcceptanceProvenanceV3",
  "description": "acceptance-provenance/3。逐字段镜像 acceptance-request/3（含 v3 新增的可选 designRef / referenceAssetRecordIds / consumerRef），并绑定完整 canonical request hash 与被测 artifact。新增可选消费溯源字段 consumedReferenceAssets：本次 acceptance 实际消费的参照资产对账快照，每条为 recordId + role + artifactHash 三元组——对应金标 SoT §7『消费者按 recordId 对账 role + consumerRef + artifactHash 后才能读取资产』的溯源留痕；快照冻结消费时刻的 role 与 hash，注册表后续改动不覆盖历史 provenance。所有 v3 新增字段均可选、不进 required，旧 provenance（v2 字段集）在本 schema 下仍然 valid；v2 的 required 集合与修回 if-then 约束不变。",
  "type": "object",
  "required": [
    "schemaVersion", "gameId", "briefHash", "genre", "templateRoute", "proofProfileId",
    "proofRegistryVersion", "taskBindingHash", "interactionBinding", "sourceArtifactHash",
    "parentAcceptanceRequestHash", "repairOrdinal", "acceptanceRequestHash", "artifactHash"
  ],
  "properties": {
    "schemaVersion": { "const": "acceptance-provenance/3" },
    "gameId": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
    "briefHash": { "$ref": "#/$defs/sha256" },
    "genre": { "enum": ["narrative", "trpg", "heritage", "puzzle", "sim-business"] },
    "templateRoute": { "type": "string", "pattern": "^_template-[a-z0-9-]+$" },
    "proofProfileId": { "type": "string", "pattern": "^[a-z][a-z0-9-]*\\.[a-z][a-z0-9-]*$" },
    "proofRegistryVersion": { "type": "string", "minLength": 1 },
    "taskBindingHash": { "$ref": "#/$defs/sha256" },
    "interactionBinding": {
      "anyOf": [
        { "$ref": "interaction-binding.schema.json" },
        { "type": "null" }
      ]
    },
    "sourceArtifactHash": { "anyOf": [{ "$ref": "#/$defs/sha256" }, { "type": "null" }] },
    "parentAcceptanceRequestHash": { "anyOf": [{ "$ref": "#/$defs/sha256" }, { "type": "null" }] },
    "repairOrdinal": { "enum": [0, 1] },
    "acceptanceRequestHash": { "$ref": "#/$defs/sha256" },
    "artifactHash": { "$ref": "#/$defs/sha256" },
    "designRef": {
      "description": "可选，镜像 acceptance-request/3.designRef。",
      "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }]
    },
    "referenceAssetRecordIds": {
      "description": "可选，镜像 acceptance-request/3.referenceAssetRecordIds（声明消费的 recordId 列表）。",
      "type": "array",
      "items": { "$ref": "#/$defs/recordId" }
    },
    "consumerRef": {
      "description": "可选，镜像 acceptance-request/3.consumerRef（消费者身份）。",
      "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }]
    },
    "consumedReferenceAssets": {
      "description": "可选。本次 acceptance 实际消费的参照资产对账快照列表。每条冻结消费时刻的 recordId + role + artifactHash 三元组，使历史 provenance 不随注册表后续改动漂移；与请求侧 referenceAssetRecordIds 的区别：前者是声明，本字段是实际消费后的核验留痕。",
      "type": "array",
      "items": { "$ref": "#/$defs/consumedReferenceAsset" }
    }
  },
  "additionalProperties": false,
  "allOf": [
    {
      "if": { "properties": { "repairOrdinal": { "const": 0 } }, "required": ["repairOrdinal"] },
      "then": {
        "properties": {
          "sourceArtifactHash": { "type": "null" },
          "parentAcceptanceRequestHash": { "type": "null" }
        }
      }
    },
    {
      "if": { "properties": { "repairOrdinal": { "const": 1 } }, "required": ["repairOrdinal"] },
      "then": {
        "properties": {
          "sourceArtifactHash": { "$ref": "#/$defs/sha256" },
          "parentAcceptanceRequestHash": { "$ref": "#/$defs/sha256" }
        }
      }
    }
  ],
  "$defs": {
    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
    "recordId": { "type": "string", "pattern": "^[A-Za-z0-9_][A-Za-z0-9._-]*$" },
    "consumedReferenceAsset": {
      "type": "object",
      "required": ["recordId", "role", "artifactHash"],
      "properties": {
        "recordId": { "$ref": "#/$defs/recordId" },
        "role": {
          "description": "消费时刻的角色快照，枚举与 ReferenceAssetRecord/1.role 一致。",
          "enum": ["harness_fixture", "prompt_eval_gold", "generation_exemplar", "game_content_gold"]
        },
        "artifactHash": {
          "description": "消费时刻核验的制品 hash 快照（play-loop 惯例 64 位小写十六进制）。",
          "$ref": "#/$defs/sha256"
        }
      },
      "additionalProperties": false
    }
  }
}