amduat/tests/fixtures/conformance/manifest.schema.md

Conformance Fixture Manifests

This directory contains small, canonical fixture sets used by conformance tests. Each fixture set publishes a JSON manifest with deterministic ordering.

Common rules

• JSON must be UTF-8, no comments.
• Arrays are ordered and MUST be in canonical order as specified by the schema.
• Artifact references use the canonical ReferenceBytes hex encoding when present (lowercase hex, no 0x prefix).
• sha256 fields are lowercase hex of the raw bytes.

Schema: amduat.conformance.fixtures.v0

Used by simple ASL/1-STORE byte fixtures (e.g. asl_put_get).

{
  "schema": "amduat.conformance.fixtures.v0",
  "fixtures": [
    {
      "id": "string",
      "artifact": "relative/path.bin",
      "size": "0",
      "sha256": "hex",
      "notes": "optional string"
    }
  ]
}

Rules:

• fixtures MUST be sorted by ascending id.
• artifact is a path relative to the manifest file.
• size is the byte length of the artifact file encoded as a decimal string.
• sha256 is the digest of the artifact file contents.

Schema: amduat.conformance.tgk_edges.v0

Used by TGK edge fixture sets.

{
  "schema": "amduat.conformance.tgk_edges.v0",
  "edges": [
    {
      "id": "string",
      "type": 0,
      "from": ["refhex"],
      "to": ["refhex"],
      "payload": "hex",
      "notes": "optional string"
    }
  ]
}

Rules:

• edges MUST be sorted by ascending id.
• from/to are lists of ReferenceBytes hex (lowercase).
• payload is hex-encoded edge payload bytes (lowercase).

Schema: amduat.conformance.fps.v0

Used by FPS/1 primitive conformance vectors.

{
  "schema": "amduat.conformance.fps.v0",
  "cases": [
    {
      "id": "string",
      "op": "slice|concat|reverse|splice",
      "input": "hex",
      "inputs": ["hex"],
      "insert": "hex",
      "offset": 0,
      "length": 0,
      "level": "bit|byte|word|long",
      "output": "hex",
      "cid_sha256": "hex"
    }
  ]
}

Rules:

• cases MUST be sorted by ascending id.
• input is used for unary operations.
• inputs is used for concat.
• insert is used for splice.
• offset and length are required for slice and splice.
• level is required for reverse.
• output is the expected output payload bytes.
• cid_sha256 is SHA-256("CAS:OBJ\\0" || output) in lowercase hex.