manifest.json

{
  "schema_version": 1,
  "conformance_version": "1.10.0",
  "sections": {
    "cases": {
      "scope": "core"
    },
    "idempotency": {
      "scope": "core"
    },
    "sqs": {
      "scope": "sqs"
    },
    "asb": {
      "scope": "asb"
    },
    "pulsar": {
      "scope": "pulsar"
    },
    "kafka": {
      "scope": "kafka"
    },
    "artemis": {
      "scope": "artemis"
    },
    "redis": {
      "scope": "redis"
    },
    "rabbitmq": {
      "scope": "amqp"
    },
    "payload_schema": {
      "scope": "core"
    },
    "roundtrip": {
      "scope": "core"
    },
    "data_shape": {
      "scope": "core"
    },
    "forbidden_keys": {
      "scope": "core"
    },
    "extension_write": {
      "scope": "core"
    },
    "encode_reject": {
      "scope": "core"
    },
    "payload_schema_unicode": {
      "scope": "core"
    },
    "payload_schema_keywords": {
      "scope": "core"
    },
    "trim": {
      "scope": "core"
    },
    "job_type": {
      "scope": "core"
    },
    "traceparent": {
      "scope": "otel"
    },
    "delay": {
      "scope": "sqs"
    },
    "backoff": {
      "scope": "kafka"
    },
    "retry_backoff": {
      "scope": "core"
    },
    "redis_layout": {
      "scope": "redis"
    },
    "redis_delay": {
      "scope": "redis"
    },
    "kafka_poison": {
      "scope": "kafka"
    },
    "poison_dlq": {
      "scope": "core"
    },
    "identity_verdict": {
      "scope": "core"
    },
    "pulsar_exhaustion": {
      "scope": "pulsar"
    },
    "version_gate_pulsar": {
      "scope": "pulsar"
    },
    "version_gate_artemis": {
      "scope": "artemis"
    },
    "version_gate_sqs": {
      "scope": "sqs"
    },
    "version_gate_asb": {
      "scope": "asb"
    },
    "span-shape": {
      "scope": "otel"
    },
    "trace-id": {
      "scope": "otel"
    },
    "metrics": {
      "scope": "otel"
    }
  },
  "exceptions": [
    {
      "family": "php",
      "binding": "asb",
      "adr": "ADR-0021"
    }
  ],
  "description": "Cross-SDK conformance cases. Every BabelQueue SDK core must satisfy these against the canonical wire envelope. Per-message fields (meta.id, trace_id, meta.created_at) are intrinsically unique and are NOT asserted by value.",
  "cases": [
    {
      "name": "order-created",
      "file": "fixtures/order-created.json",
      "valid": true,
      "description": "A normal produced envelope.",
      "expect": {
        "urn": "urn:babel:orders:created",
        "data": { "order_id": 1042 },
        "attempts": 0,
        "lang": "php",
        "schema_version": 1
      }
    },
    {
      "name": "urn-alias",
      "file": "fixtures/urn-alias.json",
      "valid": true,
      "description": "Consumers MUST accept 'urn' as an inbound alias for 'job'.",
      "expect": {
        "urn": "urn:babel:orders:created",
        "data": { "order_id": 1042 },
        "attempts": 0,
        "lang": "go",
        "schema_version": 1
      }
    },
    {
      "name": "dead-lettered",
      "file": "fixtures/dead-lettered.json",
      "valid": true,
      "description": "A dead-lettered message: original preserved + additive dead_letter block.",
      "expect": {
        "urn": "urn:babel:orders:created",
        "data": { "order_id": 1042 },
        "attempts": 3,
        "lang": "php",
        "schema_version": 1,
        "dead_letter": { "reason": "failed", "original_queue": "orders" }
      }
    },
    {
      "name": "unicode-and-numbers",
      "file": "fixtures/unicode-and-numbers.json",
      "valid": true,
      "description": "UTF-8 strings, integers, an exact float, boolean and null round-trip identically.",
      "expect": {
        "urn": "urn:babel:catalog:item.indexed",
        "data": { "title": "Café — naïve ☕", "qty": 7, "price_cents": 1299, "ratio": 0.5, "active": true, "note": null },
        "attempts": 2,
        "lang": "python",
        "schema_version": 1
      }
    },
    {
      "name": "invalid-unknown-schema-version",
      "file": "fixtures/invalid-unknown-schema-version.json",
      "valid": false,
      "reason": "meta.schema_version is not a version this SDK supports"
    },
    {
      "name": "invalid-missing-urn",
      "file": "fixtures/invalid-missing-urn.json",
      "valid": false,
      "reason": "no 'job' or 'urn' — the message has no identity"
    },
    {
      "name": "invalid-wrong-case-job",
      "file": "fixtures/invalid-wrong-case-job.json",
      "valid": false,
      "reason": "envelope keys are case-sensitive: 'JOB' is an unknown key, so there is no 'job' or 'urn' and the message has no identity"
    },
    {
      "name": "duplicate-keys-last-wins",
      "file": "fixtures/duplicate-keys-last-wins.json",
      "valid": true,
      "description": "A repeated envelope key follows last-wins and is never merged: the second 'job' and the second 'data' object replace the first (RFC 8259 leaves duplicates undefined; every SDK resolves them the same way).",
      "expect": {
        "urn": "urn:babel:orders:created",
        "data": { "order_id": 1042 },
        "attempts": 0,
        "lang": "php",
        "schema_version": 1
      }
    }
  ],
  "idempotency": {
    "description": "Consumer idempotency conformance (ADR-0022). Broker-free: locks the seen-set dedupe contract every SDK's optional idempotency helper (Go idempotency.Wrap, PHP Idempotent::wrap, Python idempotency.wrap, Node Wrap, Java Idempotent.wrap) MUST honour over the frozen schema_version-1 envelope, independent of any transport. The helper does NOT touch the wire envelope — the cases above stay byte-identical; this block governs the consume-side decision (run the handler, or skip-and-ack) keyed on meta.id.",
    "dedup_key": {
      "description": "The dedupe key is meta.id verbatim — the canonical per-message identity (distinct from trace_id, which spans a causal chain). A consumer MUST key its seen-set on exactly fixtures/order-created.json's meta.id; two deliveries with the same meta.id are the SAME message (a redelivery), even byte-for-byte identical, and dedupe to one effect. trace_id is NOT the key: messages sharing a trace_id but with distinct meta.id are distinct effects.",
      "envelope_file": "fixtures/order-created.json",
      "key_field": "meta.id",
      "expected_key": "f1e2d3c4-b5a6-4789-90ab-cdef01234567"
    },
    "sequences": {
      "description": "Each sequence drives ONE handler wrapped by the SDK's idempotency helper, backed by ONE seen-set store, through an ordered list of deliveries. For each delivery the SDK MUST derive the effect: 'run' = the wrapped handler is invoked (the side-effect fires) and, on its outcome 'ok', the id is remembered; 'skip' = an already-remembered id is recognised, the handler is NOT invoked, and the delivery is acked (the runtime stops redelivering). 'outcome' is the handler's result for a 'run' delivery: 'ok' = returns/acks (remembered), 'throw' = raises/errors (the id is left UNMARKED so a later redelivery runs it again — retry/DLQ still apply). After replaying the whole sequence, total 'run'+'ok' invocations MUST equal expected_effects. This is at-least-once delivery collapsed to an exactly-once EFFECT by the consumer; it is seen-set post-success dedupe, NOT exactly-once delivery and NOT an in-flight concurrency lock.",
      "cases": [
        {
          "name": "duplicate-delivery-runs-once",
          "description": "The same meta.id delivered twice (a textbook at-least-once redelivery): first runs the effect, second is skipped. One effect.",
          "deliveries": [
            { "meta_id": "id-A", "expect_effect": "run",  "outcome": "ok" },
            { "meta_id": "id-A", "expect_effect": "skip" }
          ],
          "expected_effects": 1
        },
        {
          "name": "at-least-once-redelivery-is-noop",
          "description": "Three redeliveries of one id (a flaky broker / worker-crash-before-ack storm): the effect fires once; every subsequent redelivery is a no-op skip.",
          "deliveries": [
            { "meta_id": "id-A", "expect_effect": "run",  "outcome": "ok" },
            { "meta_id": "id-A", "expect_effect": "skip" },
            { "meta_id": "id-A", "expect_effect": "skip" },
            { "meta_id": "id-A", "expect_effect": "skip" }
          ],
          "expected_effects": 1
        },
        {
          "name": "distinct-ids-each-run",
          "description": "Different meta.ids are different messages — each runs once. Dedupe is per-id, never collapses unrelated messages.",
          "deliveries": [
            { "meta_id": "id-A", "expect_effect": "run", "outcome": "ok" },
            { "meta_id": "id-B", "expect_effect": "run", "outcome": "ok" },
            { "meta_id": "id-C", "expect_effect": "run", "outcome": "ok" }
          ],
          "expected_effects": 3
        },
        {
          "name": "throw-leaves-id-unmarked",
          "description": "A handler that throws does NOT remember the id, so the next redelivery runs it again (retry semantics survive the guard). The third delivery succeeds and is then deduped on a fourth.",
          "deliveries": [
            { "meta_id": "id-A", "expect_effect": "run",  "outcome": "throw" },
            { "meta_id": "id-A", "expect_effect": "run",  "outcome": "throw" },
            { "meta_id": "id-A", "expect_effect": "run",  "outcome": "ok" },
            { "meta_id": "id-A", "expect_effect": "skip" }
          ],
          "expected_effects": 3
        },
        {
          "name": "missing-id-fails-open",
          "description": "A message with no usable meta.id (empty/absent) CANNOT be deduped, so the helper fails open: every delivery runs the handler. The guard never silently drops work it cannot identify.",
          "deliveries": [
            { "meta_id": "", "expect_effect": "run", "outcome": "ok" },
            { "meta_id": "", "expect_effect": "run", "outcome": "ok" }
          ],
          "expected_effects": 2
        },
        {
          "name": "forget-allows-rerun",
          "description": "forget(id) evicts an id from the seen-set, so a later delivery of that id runs again (manual replay / TTL expiry). Locks the third Store method.",
          "deliveries": [
            { "meta_id": "id-A", "expect_effect": "run",  "outcome": "ok" },
            { "meta_id": "id-A", "expect_effect": "skip" },
            { "meta_id": "id-A", "forget_before": true, "expect_effect": "run", "outcome": "ok" }
          ],
          "expected_effects": 2
        }
      ]
    }
  },
  "sqs": {
    "description": "Amazon SQS binding conformance (broker-bindings.md §3). Every SDK that ships an SQS transport must satisfy these. The envelope body stays byte-identical (the 'cases' above); these lock the native projection + reconciliation the binding adds. Per-message values reuse fixtures/order-created.json so the expected attributes are deterministic.",
    "attribute_projection": {
      "description": "On produce, the transport MUST project these native MessageAttributes from the envelope (a redundant, routable view of the body; ids/strings are DataType String, counters are DataType Number). Applies to every SQS-producing SDK.",
      "envelope_file": "fixtures/order-created.json",
      "message_attributes": {
        "bq-job":            { "DataType": "String", "StringValue": "urn:babel:orders:created" },
        "bq-trace-id":       { "DataType": "String", "StringValue": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b" },
        "bq-message-id":     { "DataType": "String", "StringValue": "f1e2d3c4-b5a6-4789-90ab-cdef01234567" },
        "bq-schema-version": { "DataType": "Number", "StringValue": "1" },
        "bq-source-lang":    { "DataType": "String", "StringValue": "php" },
        "bq-created-at":     { "DataType": "Number", "StringValue": "1749132727000" }
      }
    },
    "attempts_reconciliation": {
      "description": "On consume, attempts = max(body.attempts, ApproximateReceiveCount - 1): a first delivery reads 0, an absent/garbage count is ignored, a runtime-incremented count is never lowered. Applies to SDKs that reconcile the envelope body on consume (the framework-less/runtime transports). A drop-in driver that surfaces the broker's native delivery count instead (e.g. Laravel's SqsJob.attempts() = ApproximateReceiveCount) is exempt — it documents that divergence.",
      "cases": [
        { "name": "first-delivery",        "body_attempts": 0, "approximate_receive_count": "1",            "expected_attempts": 0 },
        { "name": "third-delivery",        "body_attempts": 0, "approximate_receive_count": "3",            "expected_attempts": 2 },
        { "name": "native-exceeds-body",   "body_attempts": 2, "approximate_receive_count": "5",            "expected_attempts": 4 },
        { "name": "never-lower-runtime",   "body_attempts": 5, "approximate_receive_count": "1",            "expected_attempts": 5 },
        { "name": "garbage-count-ignored", "body_attempts": 4, "approximate_receive_count": "not-a-number", "expected_attempts": 4 },
        { "name": "absent-count",          "body_attempts": 3, "approximate_receive_count": null,           "expected_attempts": 3 }
      ]
    },
    "schema_version_gate": {
      "description": "Consumer-side schema-version gate (broker-bindings.md §3.7). The consumer MUST read the SQS message attribute `bq-schema-version` BEFORE decoding the body. Blank means the empty string or only ASCII whitespace (space, \\t, \\n, \\v, \\f, \\r) - the same set in every SDK (GR-5): an absent or blank value falls through to the normal decode path (the body meta.schema_version check still applies afterwards). Otherwise the value is compared as-is, never trimmed: exactly \"1\" decodes, and anything else is rejected WITHOUT decoding (poison/DLQ path) - including \"2\", \"01\", \"x\", values padded with whitespace (\" 1\", \"1 \"), and values made of non-ASCII whitespace (NBSP U+00A0, U+0085, U+3000) or a BOM (U+FEFF), which are NOT blank. A unicode-aware blank check or a trim() before comparing fails these cases. Each case supplies the property 'value' (or 'absent': true) and the 'expect'ed verdict; the message body is always the valid envelope in 'fixture', so a 'reject' verdict can only come from the property gate.",
      "property": "bq-schema-version",
      "fixture": "fixtures/order-created.json",
      "cases": [
        { "value": "1",             "expect": "decode" },
        { "value": "",              "expect": "decode" },
        { "value": " \t",          "expect": "decode" },
        { "value": " ",             "expect": "decode" },
        { "value": "\n\u000b\f\r", "expect": "decode" },
        { "absent": true,          "expect": "decode" },
        { "value": "2",             "expect": "reject" },
        { "value": "01",            "expect": "reject" },
        { "value": "x",             "expect": "reject" },
        { "value": " 1",            "expect": "reject" },
        { "value": "1 ",            "expect": "reject" },
        { "value": "\t1\n",        "expect": "reject" },
        { "value": "\u00a0",       "expect": "reject" },
        { "value": "\u0085",       "expect": "reject" },
        { "value": "\u3000",       "expect": "reject" },
        { "value": "\ufeff",       "expect": "reject" },
        { "value": "\u00a01",      "expect": "reject" },
        { "value": "1\u3000",      "expect": "reject" }
      ]
    }
  },
  "asb": {
    "description": "Azure Service Bus binding conformance (broker-bindings.md §4). Every SDK that ships an ASB transport must satisfy these. The envelope body stays byte-identical (the 'cases' above); these lock the native projection + reconciliation the binding adds. Per-message values reuse fixtures/order-created.json so the expected projection is deterministic.",
    "property_projection": {
      "description": "On produce, the transport MUST project these native Service Bus message fields from the envelope: Subject = job (the URN), CorrelationId = trace_id, MessageId = meta.id, ContentType = application/json, plus the bq- ApplicationProperties as native AMQP-typed values (numbers stay numbers, not strings). Applies to every ASB-producing SDK.",
      "envelope_file": "fixtures/order-created.json",
      "message": {
        "subject":        "urn:babel:orders:created",
        "correlation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id":     "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
        "content_type":   "application/json"
      },
      "application_properties": {
        "bq-schema-version": 1,
        "bq-source-lang":    "php",
        "bq-created-at":     1749132727000
      }
    },
    "attempts_reconciliation": {
      "description": "On consume, attempts = max(body.attempts, DeliveryCount - 1): a first delivery (DeliveryCount 1) reads 0, a runtime-incremented body count is never lowered, and DeliveryCount <= 1 leaves the body's own count untouched (the runtime retries by republishing with attempts+1). DeliveryCount is the native 1-based ASB redelivery counter; the rule is identical across the native-consumer SDKs (.NET/Java/Node) and the Transport+App SDKs (Python/Go).",
      "cases": [
        { "name": "first-delivery",            "body_attempts": 0, "delivery_count": 1, "expected_attempts": 0 },
        { "name": "third-delivery",            "body_attempts": 0, "delivery_count": 3, "expected_attempts": 2 },
        { "name": "native-exceeds-body",       "body_attempts": 2, "delivery_count": 5, "expected_attempts": 4 },
        { "name": "never-lower-runtime",       "body_attempts": 5, "delivery_count": 2, "expected_attempts": 5 },
        { "name": "first-delivery-keeps-body", "body_attempts": 4, "delivery_count": 1, "expected_attempts": 4 },
        { "name": "zero-count-keeps-body",     "body_attempts": 3, "delivery_count": 0, "expected_attempts": 3 }
      ]
    },
    "schema_version_gate": {
      "description": "Consumer-side schema-version gate (broker-bindings.md §4.7). The consumer MUST read the ASB ApplicationProperties entry `bq-schema-version` BEFORE decoding the body. Blank means the empty string or only ASCII whitespace (space, \\t, \\n, \\v, \\f, \\r) - the same set in every SDK (GR-5): an absent or blank value falls through to the normal decode path (the body meta.schema_version check still applies afterwards). Otherwise the value is compared as-is, never trimmed: exactly \"1\" decodes, and anything else is rejected WITHOUT decoding (poison/DLQ path) - including \"2\", \"01\", \"x\", values padded with whitespace (\" 1\", \"1 \"), and values made of non-ASCII whitespace (NBSP U+00A0, U+0085, U+3000) or a BOM (U+FEFF), which are NOT blank. A unicode-aware blank check or a trim() before comparing fails these cases. Each case supplies the property 'value' (or 'absent': true) and the 'expect'ed verdict; the message body is always the valid envelope in 'fixture', so a 'reject' verdict can only come from the property gate. ASB application properties are AMQP-typed, so the JSON-number cases (a number, not a string) stand for a native AMQP number: any AMQP integral type (byte/short/int/long, signed or unsigned) with value 1 decodes; any other numeric value (2, 0, non-integral 1.5) and any other type rejects. JSON numbers carry no width, so a runner MUST exercise integral 1 and 2 at both int32 and int64 width. A floating-point 1.0 is a native AMQP float/double, NOT integral 1, and rejects: because JSON parsers in several languages (Go, Node) cannot tell 1.0 from 1, that case carries an explicit 'value_type': 'float' marker and a runner MUST hand the SDK a real floating-point value (float32 and float64 where the language has both), never an integer. A language with a single number type (JavaScript: AMQP float 1.0 arrives as the number 1) cannot represent the case and its runner skips it explicitly. A case without 'value_type' keeps the plain meaning above. A JSON null 'value' stands for a present-but-null application property: it is treated exactly like an absent one (the property is simply not set) and decodes, so the runner MUST put the property key into the message with a null value rather than omit it.",
      "property": "bq-schema-version",
      "fixture": "fixtures/order-created.json",
      "cases": [
        { "value": "1",             "expect": "decode" },
        { "value": "",              "expect": "decode" },
        { "value": " \t",          "expect": "decode" },
        { "value": " ",             "expect": "decode" },
        { "value": "\n\u000b\f\r", "expect": "decode" },
        { "absent": true,          "expect": "decode" },
        { "value": "2",             "expect": "reject" },
        { "value": "01",            "expect": "reject" },
        { "value": "x",             "expect": "reject" },
        { "value": " 1",            "expect": "reject" },
        { "value": "1 ",            "expect": "reject" },
        { "value": "\t1\n",        "expect": "reject" },
        { "value": "\u00a0",       "expect": "reject" },
        { "value": "\u0085",       "expect": "reject" },
        { "value": "\u3000",       "expect": "reject" },
        { "value": "\ufeff",       "expect": "reject" },
        { "value": "\u00a01",      "expect": "reject" },
        { "value": "1\u3000",      "expect": "reject" },
        { "value": 1,               "expect": "decode" },
        { "value": 2,               "expect": "reject" },
        { "value": 0,               "expect": "reject" },
        { "value": 1.5,             "expect": "reject" },
        { "value": 1.0, "value_type": "float", "expect": "reject" },
        { "value": null,            "expect": "decode" }
      ]
    }
  },
  "pulsar": {
    "description": "Apache Pulsar binding conformance (broker-bindings.md §5). Every SDK that ships a Pulsar transport must satisfy these. The envelope body stays byte-identical (the 'cases' above); these lock the native projection + reconciliation the binding adds. Per-message values reuse fixtures/order-created.json so the expected projection is deterministic.",
    "property_projection": {
      "description": "On produce, the transport MUST project these native Pulsar message properties from the envelope, all string->string (Pulsar properties are string-typed, so numbers are stringified): bq-job = job (the URN), bq-trace-id = trace_id, bq-message-id = meta.id, bq-schema-version = str(meta.schema_version), bq-source-lang = meta.lang, bq-attempts = str(attempts). The payload is the byte-identical envelope; the native publishTime mirrors meta.created_at (broker-set, body authoritative). Applies to every Pulsar-producing SDK.",
      "envelope_file": "fixtures/order-created.json",
      "properties": {
        "bq-job":            "urn:babel:orders:created",
        "bq-trace-id":       "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "bq-message-id":     "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
        "bq-schema-version": "1",
        "bq-source-lang":    "php",
        "bq-attempts":       "0"
      }
    },
    "attempts_reconciliation": {
      "description": "On consume, attempts = max(body.attempts, RedeliveryCount): Pulsar's RedeliveryCount is 0-based (0 on first delivery) so it maps directly with NO -1, a runtime-incremented body count is never lowered, and RedeliveryCount 0 leaves the body's own count untouched (the runtime retries by republishing with attempts+1, which resets the broker's redelivery count to 0). The rule is identical across the native-consumer SDKs (.NET/Java/Node) and the Transport+App SDKs (Python/Go).",
      "cases": [
        { "name": "first-delivery",            "body_attempts": 0, "redelivery_count": 0, "expected_attempts": 0 },
        { "name": "third-delivery",            "body_attempts": 0, "redelivery_count": 2, "expected_attempts": 2 },
        { "name": "native-exceeds-body",       "body_attempts": 2, "redelivery_count": 5, "expected_attempts": 5 },
        { "name": "never-lower-runtime",       "body_attempts": 5, "redelivery_count": 1, "expected_attempts": 5 },
        { "name": "first-delivery-keeps-body", "body_attempts": 4, "redelivery_count": 0, "expected_attempts": 4 },
        { "name": "native-equals-body",        "body_attempts": 3, "redelivery_count": 3, "expected_attempts": 3 }
      ]
    },
    "schema_version_gate": {
      "description": "Consumer-side schema-version gate (broker-bindings.md §5.7). The consumer MUST read the Pulsar message property `bq-schema-version` BEFORE decoding the body. Blank means the empty string or only ASCII whitespace (space, \\t, \\n, \\v, \\f, \\r) - the same set in every SDK (GR-5): an absent or blank value falls through to the normal decode path (the body meta.schema_version check still applies afterwards). Otherwise the value is compared as-is, never trimmed: exactly \"1\" decodes, and anything else is rejected WITHOUT decoding (poison/DLQ path) - including \"2\", \"01\", \"x\", values padded with whitespace (\" 1\", \"1 \"), and values made of non-ASCII whitespace (NBSP U+00A0, U+0085, U+3000) or a BOM (U+FEFF), which are NOT blank. A unicode-aware blank check or a trim() before comparing fails these cases. Each case supplies the property 'value' (or 'absent': true) and the 'expect'ed verdict; the message body is always the valid envelope in 'fixture', so a 'reject' verdict can only come from the property gate.",
      "property": "bq-schema-version",
      "fixture": "fixtures/order-created.json",
      "cases": [
        { "value": "1",             "expect": "decode" },
        { "value": "",              "expect": "decode" },
        { "value": " \t",          "expect": "decode" },
        { "value": " ",             "expect": "decode" },
        { "value": "\n\u000b\f\r", "expect": "decode" },
        { "absent": true,          "expect": "decode" },
        { "value": "2",             "expect": "reject" },
        { "value": "01",            "expect": "reject" },
        { "value": "x",             "expect": "reject" },
        { "value": " 1",            "expect": "reject" },
        { "value": "1 ",            "expect": "reject" },
        { "value": "\t1\n",        "expect": "reject" },
        { "value": "\u00a0",       "expect": "reject" },
        { "value": "\u0085",       "expect": "reject" },
        { "value": "\u3000",       "expect": "reject" },
        { "value": "\ufeff",       "expect": "reject" },
        { "value": "\u00a01",      "expect": "reject" },
        { "value": "1\u3000",      "expect": "reject" }
      ]
    }
  },
  "kafka": {
    "description": "Apache Kafka binding conformance (broker-bindings.md §6). Every SDK that ships a Kafka transport must satisfy these. The record value is the byte-identical envelope (the 'cases' above); these lock the bq- header projection + the bq-attempts-authoritative reconciliation the binding adds. Per-message values reuse fixtures/order-created.json so the expected projection is deterministic.",
    "property_projection": {
      "description": "On produce, the transport MUST project these native Kafka record headers from the envelope, all UTF-8 byte strings (Kafka headers are bytes, so integers are stringified): bq-job = job (the URN), bq-trace-id = trace_id, bq-message-id = meta.id, bq-schema-version = str(meta.schema_version), bq-source-lang = meta.lang, bq-attempts = str(attempts). The record value is the byte-identical envelope and the record timestamp mirrors meta.created_at (Unix ms). Applies to every Kafka-producing SDK.",
      "envelope_file": "fixtures/order-created.json",
      "headers": {
        "bq-job":            "urn:babel:orders:created",
        "bq-trace-id":       "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "bq-message-id":     "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
        "bq-schema-version": "1",
        "bq-source-lang":    "php",
        "bq-attempts":       "0"
      }
    },
    "attempts_reconciliation": {
      "description": "On consume, attempts = the bq-attempts header when present (AUTHORITATIVE — Kafka has no native delivery count), else the body's own attempts (the fallback for a non-BabelQueue producer). This is NOT a max: the header overrides the body even when lower. A null header_attempts means the header is absent. The rule is identical across all five Kafka SDKs.",
      "cases": [
        { "name": "header-matches-body",            "body_attempts": 0, "header_attempts": 0,    "expected_attempts": 0 },
        { "name": "header-present",                 "body_attempts": 0, "header_attempts": 2,    "expected_attempts": 2 },
        { "name": "header-absent-falls-back",       "body_attempts": 3, "header_attempts": null, "expected_attempts": 3 },
        { "name": "header-authoritative-overrides", "body_attempts": 5, "header_attempts": 1,    "expected_attempts": 1 },
        { "name": "header-higher-than-body",        "body_attempts": 1, "header_attempts": 4,    "expected_attempts": 4 }
      ]
    },
    "schema_version_gate": {
      "description": "Consumer-side schema-version gate (broker-bindings.md §6.7). The consumer MUST read the Kafka record header `bq-schema-version` BEFORE decoding the body. Blank means the empty string or only ASCII whitespace (space, \\t, \\n, \\v, \\f, \\r) - the same set in every SDK (GR-5): an absent or blank value falls through to the normal decode path (the body meta.schema_version check still applies afterwards). Otherwise the value is compared as-is, never trimmed: exactly \"1\" decodes, and anything else is rejected WITHOUT decoding (poison/DLQ path) - including \"2\", \"01\", \"x\", values padded with whitespace (\" 1\", \"1 \"), and values made of non-ASCII whitespace (NBSP U+00A0, U+0085, U+3000) or a BOM (U+FEFF), which are NOT blank. A unicode-aware blank check or a trim() before comparing fails these cases. Each case supplies the property 'value' (or 'absent': true) and the 'expect'ed verdict; the message body is always the valid envelope in 'fixture', so a 'reject' verdict can only come from the property gate. A JSON null 'value' stands for a present-but-null Kafka record header (Kafka allows a null header value): it is treated exactly like an absent one (the header carries no version) and decodes, so the runner MUST put the header key into the record with a null value rather than omit it, and an SDK MUST NOT stringify the null (a header whose value became the text \"null\" would be rejected).",
      "property": "bq-schema-version",
      "fixture": "fixtures/order-created.json",
      "cases": [
        { "value": "1",             "expect": "decode" },
        { "value": "",              "expect": "decode" },
        { "value": " \t",          "expect": "decode" },
        { "value": " ",             "expect": "decode" },
        { "value": "\n\u000b\f\r", "expect": "decode" },
        { "absent": true,          "expect": "decode" },
        { "value": "2",             "expect": "reject" },
        { "value": "01",            "expect": "reject" },
        { "value": "x",             "expect": "reject" },
        { "value": " 1",            "expect": "reject" },
        { "value": "1 ",            "expect": "reject" },
        { "value": "\t1\n",        "expect": "reject" },
        { "value": "\u00a0",       "expect": "reject" },
        { "value": "\u0085",       "expect": "reject" },
        { "value": "\u3000",       "expect": "reject" },
        { "value": "\ufeff",       "expect": "reject" },
        { "value": "\u00a01",      "expect": "reject" },
        { "value": "1\u3000",      "expect": "reject" },
        { "value": null,            "expect": "decode" }
      ]
    }
  },
  "artemis": {
    "description": "Apache ActiveMQ Artemis binding conformance (broker-bindings.md §7). Every SDK that ships an Artemis transport must satisfy these. The message body stays byte-identical (the 'cases' above); these lock the AMQP-1.0 projection + reconciliation the binding adds. Per-message values reuse fixtures/order-created.json so the expected projection is deterministic.",
    "property_projection": {
      "description": "On produce, the transport MUST project the envelope onto the AMQP a JMS peer reads: the x-opt-jms-type message annotation = job (the URN, the AMQP-JMS mapping of JMSType), correlation-id = trace_id (JMSCorrelationID), creation-time = meta.created_at (JMSTimestamp, Unix ms), plus the bq_ application properties, all string-valued. The names use UNDERSCORES (bq_schema_version, not bq-schema-version): JMS property names must be valid Java identifiers (no hyphens), and the Java binding consumes/produces over JMS, so every Artemis SDK uses the JMS-legal underscore form for cross-protocol parity. bq_schema_version = str(meta.schema_version), bq_source_lang = meta.lang, bq_attempts = str(attempts), bq_app_id = 'babelqueue'. The body is the byte-identical envelope. Unlike Kafka/Pulsar, the URN / trace_id / message-id are NOT bq_ properties — they ride the JMS-native slots. Applies to every Artemis-producing SDK.",
      "envelope_file": "fixtures/order-created.json",
      "jms_type_annotation": "x-opt-jms-type",
      "jms_type": "urn:babel:orders:created",
      "correlation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
      "properties": {
        "bq_schema_version": "1",
        "bq_source_lang":    "php",
        "bq_attempts":       "0",
        "bq_app_id":         "babelqueue"
      }
    },
    "attempts_reconciliation": {
      "description": "On consume, attempts = max(body.attempts, delivery-count): the AMQP delivery-count header is 0-based (0 on first delivery) so it maps directly with NO -1, a runtime-incremented body count is never lowered, and delivery-count 0 leaves the body's own count untouched (the runtime/App retries by republishing with attempts+1, which resets the broker's delivery-count to 0). The Java JMS binding reads the 1-based JMSXDeliveryCount and subtracts 1, arriving at the same 0-based attempts. The rule is identical across the native-consumer SDKs (.NET/Java/Node) and the Transport+App SDKs (Python/Go).",
      "cases": [
        { "name": "first-delivery",           "body_attempts": 0, "delivery_count": 0, "expected_attempts": 0 },
        { "name": "third-delivery",            "body_attempts": 0, "delivery_count": 2, "expected_attempts": 2 },
        { "name": "native-exceeds-body",       "body_attempts": 2, "delivery_count": 5, "expected_attempts": 5 },
        { "name": "never-lower-runtime",       "body_attempts": 5, "delivery_count": 1, "expected_attempts": 5 },
        { "name": "first-delivery-keeps-body", "body_attempts": 4, "delivery_count": 0, "expected_attempts": 4 },
        { "name": "native-equals-body",        "body_attempts": 3, "delivery_count": 3, "expected_attempts": 3 }
      ]
    },
    "schema_version_gate": {
      "description": "Consumer-side schema-version gate (broker-bindings.md §7.7). The consumer MUST read the Artemis application property `bq_schema_version` (underscores, ADR-0017) BEFORE decoding the body. Blank means the empty string or only ASCII whitespace (space, \\t, \\n, \\v, \\f, \\r) - the same set in every SDK (GR-5): an absent or blank value falls through to the normal decode path (the body meta.schema_version check still applies afterwards). Otherwise the value is compared as-is, never trimmed: exactly \"1\" decodes, and anything else is rejected WITHOUT decoding (poison/DLQ path) - including \"2\", \"01\", \"x\", values padded with whitespace (\" 1\", \"1 \"), and values made of non-ASCII whitespace (NBSP U+00A0, U+0085, U+3000) or a BOM (U+FEFF), which are NOT blank. A unicode-aware blank check or a trim() before comparing fails these cases. Each case supplies the property 'value' (or 'absent': true) and the 'expect'ed verdict; the message body is always the valid envelope in 'fixture', so a 'reject' verdict can only come from the property gate. A JSON null 'value' stands for a present-but-null application property: it is treated exactly like an absent one (the property carries no version) and decodes, so the runner MUST put the property key into the message with a null value rather than omit it. A reader whose message API cannot carry a null application property MUST skip this case explicitly (and assert that it skips) rather than silently drop it.",
      "property": "bq_schema_version",
      "fixture": "fixtures/order-created.json",
      "cases": [
        { "value": "1",             "expect": "decode" },
        { "value": "",              "expect": "decode" },
        { "value": " \t",          "expect": "decode" },
        { "value": " ",             "expect": "decode" },
        { "value": "\n\u000b\f\r", "expect": "decode" },
        { "absent": true,          "expect": "decode" },
        { "value": "2",             "expect": "reject" },
        { "value": "01",            "expect": "reject" },
        { "value": "x",             "expect": "reject" },
        { "value": " 1",            "expect": "reject" },
        { "value": "1 ",            "expect": "reject" },
        { "value": "\t1\n",        "expect": "reject" },
        { "value": "\u00a0",       "expect": "reject" },
        { "value": "\u0085",       "expect": "reject" },
        { "value": "\u3000",       "expect": "reject" },
        { "value": "\ufeff",       "expect": "reject" },
        { "value": "\u00a01",      "expect": "reject" },
        { "value": "1\u3000",      "expect": "reject" },
        { "value": null,            "expect": "decode" }
      ]
    }
  },
  "redis": {
    "description": "Redis binding conformance (broker-bindings.md §1 — the reliable-queue list pattern). Redis lists carry no native metadata, so there is NO property projection: the queue element IS the canonical envelope JSON, byte-for-byte, with NO wrapping (unlike BullMQ's job structure) and NO added fields. The reserve/ack reliability (Laravel's reserved-sorted-set vs the App runtimes' processing-list) and attempts handling are SDK-runtime-specific and proven by the live interop round-trip, not a static fixture. The one cross-SDK invariant locked here is payload identity.",
    "payload_identity": {
      "description": "On produce, the transport MUST store the envelope JSON byte-for-byte as the queue element (RPUSH / equivalent); on reserve it MUST return that element unchanged — no wrapping, no envelope mutation, no added metadata. A §1 SDK round-trips fixtures/order-created.json through produce→reserve and gets back the identical bytes. Applies to every Redis-producing SDK.",
      "envelope_file": "fixtures/order-created.json"
    }
  },
  "rabbitmq": {
    "description": "RabbitMQ binding conformance (broker-bindings.md §2 — AMQP 0-9-1). The envelope body stays byte-identical (the 'cases' above); this locks the native AMQP-0-9-1 property projection every producer emits. NOTE: consume-side attempts handling is NOT in scope here because it is runtime-specific — the Laravel driver reads the authoritative x-attempts header (§2.5), while the App-runtime SDKs (Go/Python) keep attempts in the body and republish with attempts+1 (the x-attempts header is then a redundant produce-side mirror). Both stay consistent because Laravel increments the body's attempts too. Per-message values reuse fixtures/order-created.json.",
    "property_projection": {
      "description": "On produce, the transport MUST project these native AMQP 0-9-1 properties + headers from the envelope. Header values are NATIVE-typed (AMQP 0-9-1 field-tables carry typed values — integers stay integers, NOT stringified like Kafka/Pulsar): type = job (the URN, route on it without reading the body), correlation_id = trace_id, message_id = meta.id, app_id = 'babelqueue', content_type = 'application/json', header x-schema-version = meta.schema_version (number), x-source-lang = meta.lang, x-attempts = attempts (number). The body is the byte-identical envelope. Applies to every RabbitMQ-producing SDK.",
      "envelope_file": "fixtures/order-created.json",
      "properties": {
        "type":           "urn:babel:orders:created",
        "correlation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id":     "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
        "app_id":         "babelqueue",
        "content_type":   "application/json"
      },
      "headers": {
        "x-schema-version": 1,
        "x-source-lang":    "php",
        "x-attempts":       0
      }
    }
  },
  "payload_schema": {
    "description": "Per-URN data schema validation (ADR-0024). Each case validates `data` against `schema`; every SDK's optional payload validator (Go schema, PHP BabelQueue\\Schema, Python babelqueue.schema) MUST agree on `valid`. The wire envelope stays frozen — this governs the data block only, and is opt-in (consumers/producers without a registered schema skip it).",
    "schema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "type": "object",
      "required": ["order_id"],
      "properties": {
        "order_id": { "type": "integer", "minimum": 1 },
        "amount": { "type": "number", "minimum": 0 },
        "currency": { "enum": ["USD", "EUR", "TRY"] }
      },
      "additionalProperties": false
    },
    "cases": [
      { "name": "valid-minimal", "valid": true, "data": { "order_id": 1042 } },
      { "name": "valid-full", "valid": true, "data": { "order_id": 1042, "amount": 99.9, "currency": "USD" } },
      { "name": "invalid-missing-required", "valid": false, "data": { "amount": 10 } },
      { "name": "invalid-wrong-type", "valid": false, "data": { "order_id": "x" } },
      { "name": "invalid-additional-property", "valid": false, "data": { "order_id": 1, "extra": true } },
      { "name": "invalid-enum", "valid": false, "data": { "order_id": 1, "currency": "GBP" } },
      { "name": "invalid-below-minimum", "valid": false, "data": { "order_id": 0 } }
    ]
  },
  "roundtrip": {
    "description": "Forward-compatible re-emit (message-envelope.md §4/§8: consumers MUST ignore unknown keys; GR-5). Each case is a decode -> attempts+1 -> encode chain, i.e. what every SDK does on retry/redrive/relay. Decode `file` with the SDK core (it MUST be accepted), increment `attempts` by one, re-encode, then parse the output JSON and assert: `attempts` == `expect_attempts`, and for every entry of `expect_preserved` the value at that RFC 6901 JSON pointer is deep-equal to the given value (same JSON type — an object is never an array). Unknown keys MUST NOT be dropped, renamed or retyped. Key order and whitespace are NOT asserted. `producer_schema_valid: false` marks a consumer-tolerance fixture that intentionally does not pass the producer JSON Schema (like urn-alias); the SDK MUST still accept and re-emit it. Optional `expect_absent_after_reencode` (conformance 1.4.0, ADR-0031): a list of RFC 6901 pointers, none of which may exist in the re-encoded output (evaluated on the same re-encoded document as `expect_preserved`); a case without the field behaves as before, and a runner that does not know the field ignores it. Optional `apply_dead_letter` (conformance 1.4.0): `{ \"reason\", \"original_queue\" }`. When present, after the attempts+1 step the runner moves the message to the dead-letter queue with the SDK's own DLQ helper (the one the worker uses on retry exhaustion; message-envelope.md section 10b, error-handling.md section 6), `reason` being one of `failed`, `unknown_urn`, `poison`, then parses the dead-letter copy instead of the plain re-encode; every assertion of the case (`expect_attempts`, `expect_preserved`, `expect_absent_after_reencode`) is evaluated on that copy. Fields the helper needs beyond these two (error message, exception type, timestamp) are runner-chosen and not asserted. Optional `expect_dead_letter` (a map of `dead_letter` sub-field to expected value) is evaluated only when `apply_dead_letter` was applied, on that copy: the `dead_letter` object MUST exist and each listed sub-field MUST deep-equal the value. A runner that does not know these fields ignores them and runs the case as a plain roundtrip. Every roundtrip case expects decode to emit no warning (no fixture here carries a forbidden key, and `urn` is the source of the identity, not a dropped key, when `job` is missing or blank).",
    "cases": [
      {
        "name": "unknown-meta-roundtrip",
        "file": "fixtures/unknown-meta-roundtrip.json",
        "description": "Unknown meta keys (a scalar and a nested object) survive decode -> attempts+1 -> encode with the same values.",
        "expect_attempts": 1,
        "expect_preserved": {
          "/meta/vendor_flag": true,
          "/meta/vendor_ctx": {
            "region": "eu-west-1",
            "hops": [
              1,
              2
            ]
          },
          "/meta/lang": "php"
        }
      },
      {
        "name": "unknown-toplevel-roundtrip",
        "file": "fixtures/unknown-toplevel-roundtrip.json",
        "description": "An unknown top-level key survives decode -> attempts+1 -> encode with the same value.",
        "expect_attempts": 2,
        "expect_preserved": {
          "/extra_top": 1
        }
      },
      {
        "name": "unknown-lang",
        "file": "fixtures/unknown-lang.json",
        "description": "A meta.lang outside the known language list (a future/community SDK) is decoded without error and re-emitted unchanged — a consumer MUST NOT reject or rewrite it.",
        "producer_schema_valid": false,
        "expect_attempts": 1,
        "expect_preserved": {
          "/meta/lang": "cobol"
        }
      },
      {
        "name": "empty-data-roundtrip",
        "file": "fixtures/empty-data-roundtrip.json",
        "description": "An empty-object data survives the round-trip as an object ({}), never as an array ([]).",
        "expect_attempts": 1,
        "expect_preserved": {
          "/data": {}
        }
      },
      {
        "name": "wrong-case-keys-roundtrip",
        "file": "fixtures/wrong-case-keys-roundtrip.json",
        "description": "Envelope keys are matched case-sensitively, so a wrongly cased key ('JOB', 'Data', 'meta.Queue') is an unknown key: it never overrides the canonical field and survives decode -> attempts+1 -> encode with the same value.",
        "expect_attempts": 1,
        "expect_preserved": {
          "/job": "urn:babel:orders:created",
          "/data": { "order_id": 1042 },
          "/meta/queue": "orders",
          "/JOB": "urn:babel:orders:shadow",
          "/Data": { "order_id": 7 },
          "/meta/Queue": "shadow"
        }
      },
      {
        "name": "meta-ext-vendor-roundtrip",
        "file": "fixtures/meta-ext-vendor-roundtrip.json",
        "description": "A vendor extension block under meta.ext.<vendor> (ADR-0031 (d)) with nested objects and arrays, for two vendors, survives decode -> attempts+1 -> encode unchanged, key for key.",
        "expect_attempts": 1,
        "expect_preserved": {
          "/job": "urn:acme:a",
          "/meta/ext/acme": { "tier": "gold", "flags": [1, 2], "limits": { "burst": 10 } },
          "/meta/ext/globex": { "region": "eu-west-1" },
          "/meta/lang": "php"
        }
      },
      {
        "name": "dead-letter-roundtrip",
        "file": "fixtures/dead-letter-roundtrip.json",
        "description": "ADR-0031 / message-envelope.md section 8 rule 7: a DLQ move is a re-emit, so unknown keys survive it. The runner decodes `file`, increments `attempts` (the failed delivery), then moves the message to the dead-letter queue with the SDK's own DLQ helper using `apply_dead_letter` and parses the dead-letter copy. Unknown `meta.*` keys (`vendor_flag`, `ext.acme`), the top-level `extra_top` and the identity keys come back unchanged, and the `dead_letter` block carries the requested `reason` and `original_queue`. Other `dead_letter` fields (`error`, `exception`, `failed_at`, `attempts`, `lang`) are chosen by the SDK and not asserted. A runner that does not know `apply_dead_letter` runs this as a plain decode -> attempts+1 -> encode chain, which also passes.",
        "apply_dead_letter": { "reason": "failed", "original_queue": "orders" },
        "expect_attempts": 3,
        "expect_preserved": {
          "/job": "urn:acme:a",
          "/trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
          "/meta/id": "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
          "/meta/queue": "orders",
          "/meta/lang": "php",
          "/meta/created_at": 1749132727000,
          "/meta/schema_version": 1,
          "/meta/vendor_flag": true,
          "/meta/ext/acme": { "tier": "gold", "flags": [1, 2] },
          "/extra_top": 1,
          "/data": { "order_id": 1042 }
        },
        "expect_dead_letter": { "reason": "failed", "original_queue": "orders" }
      },
      {
        "name": "urn-only-roundtrip",
        "file": "fixtures/urn-only-roundtrip.json",
        "description": "ADR-0031 (c): an envelope with `urn` and no `job` is accepted, the URN is read from `urn`, and the re-emit carries it as `job` with no `urn` key. No warning is expected (`urn` is the source of the identity). producer_schema_valid is false because the producer schema requires `job`.",
        "producer_schema_valid": false,
        "expect_attempts": 1,
        "expect_preserved": {
          "/job": "urn:acme:b"
        },
        "expect_absent_after_reencode": [
          "/urn"
        ]
      },
      {
        "name": "blank-ascii-job-urn-fallback",
        "file": "fixtures/blank-ascii-job-urn-fallback.json",
        "description": "ADR-0031 (c), user decision 2026-10-17: a `job` that is empty or only ASCII whitespace (space, \\t, \\n, \\v, \\f, \\r) counts as absent, so the URN falls back to `urn` and the re-emit writes it as `job` with no `urn` key. Fixture `job` is two spaces. No warning is expected. SDKs that do not yet implement ADR-0031 (c) fail this case until their SDK phase lands.",
        "expect_attempts": 1,
        "expect_preserved": {
          "/job": "urn:acme:b"
        },
        "expect_absent_after_reencode": [
          "/urn"
        ]
      }
    ]
  },
  "data_shape": {
    "description": "The `data` block is always a JSON object (message-envelope.md §3, GR-3). `mode: encode` cases build a new envelope with the SDK's producer API from `urn` + `queue` + `data`, then assert the raw JSON text of the emitted `data` value, with insignificant whitespace removed, equals `expect_encoded_data_json` (an empty map MUST encode as {} — never []). `mode: decode` cases decode `file` and assert the SDK's verdict equals `valid` (`valid: false` = the core rejects it: accepts()/decode fails).",
    "cases": [
      {
        "name": "empty-data",
        "mode": "encode",
        "urn": "urn:babel:orders:created",
        "queue": "orders",
        "data": {},
        "expect_encoded_data_json": "{}"
      },
      {
        "name": "data-array-rejected",
        "mode": "decode",
        "file": "fixtures/data-array-rejected.json",
        "valid": false,
        "reason": "data is a JSON array, not an object"
      }
    ]
  },
  "forbidden_keys": {
    "description": "Non-canonical keys (message-envelope.md §10). Policy K-15 for R0: decode WARNS, it does not reject (old producers keep working); encode NEVER emits them. For each case: decode `file` — it MUST succeed (`expect: warn`) AND the SDK MUST surface at least one warning (via its logger / warning hook) naming `forbidden_key`. The forbidden key MUST NOT be captured into the unknown-key extras, so re-encoding the decoded message (no other change) MUST NOT contain any pointer in `expect_absent_after_reencode`. All other fields round-trip as usual. Policy update (ADR-0031 (c), conformance 1.4.0): the decode warning is a MUST, and encode of a forbidden key is rejected (see `encode_reject`); decode stays lenient. Optional `expect_preserved` (1.4.0): an object {\"<RFC 6901 pointer>\": <value>}; every pointer MUST hold the given value (same JSON type) in the re-encoded document, evaluated at the same moment as `expect_absent_after_reencode`. A case without the field behaves as before, and a runner that does not know the field ignores it. The two `urn` cases below fix the `job`+`urn` rules: `job` wins and `urn` is dropped with a warning naming the `/urn` pointer in the same form the SDK's existing forbidden-key warnings use; `job` is blank only for the closed ASCII whitespace set, so a `job` of U+2003 is NOT blank and does NOT fall back to `urn`. These two fixtures are not `accepts()`-negative: `accepts()` does not check URN syntax, so it stays true (Go's runner does not assert it). SDKs that do not yet implement ADR-0031 (c) fail these cases until their SDK phase lands; the cases are never skipped.",
    "cases": [
      {
        "name": "forbidden-key-timestamp",
        "file": "fixtures/forbidden-key-timestamp.json",
        "forbidden_key": "/timestamp",
        "expect": "warn",
        "expect_absent_after_reencode": [
          "/timestamp"
        ]
      },
      {
        "name": "forbidden-key-meta-max-retries",
        "file": "fixtures/forbidden-key-meta-max-retries.json",
        "forbidden_key": "/meta/max_retries",
        "expect": "warn",
        "expect_absent_after_reencode": [
          "/meta/max_retries"
        ]
      },
      {
        "name": "forbidden-key-meta-attempts",
        "file": "fixtures/forbidden-key-meta-attempts.json",
        "forbidden_key": "/meta/attempts",
        "expect": "warn",
        "expect_absent_after_reencode": [
          "/meta/attempts"
        ]
      },
      {
        "name": "forbidden-key-meta-source",
        "file": "fixtures/forbidden-key-meta-source.json",
        "forbidden_key": "/meta/source",
        "expect": "warn",
        "expect_absent_after_reencode": [
          "/meta/source"
        ]
      },
      {
        "name": "forbidden-key-meta-ts",
        "file": "fixtures/forbidden-key-meta-ts.json",
        "forbidden_key": "/meta/ts",
        "expect": "warn",
        "expect_absent_after_reencode": [
          "/meta/ts"
        ]
      },
      {
        "name": "forbidden-key-job-and-urn",
        "file": "fixtures/forbidden-key-job-and-urn.json",
        "description": "ADR-0031 (c): `job` and `urn` both present. `job` wins, `urn` is dropped from the decoded message with a warning naming /urn, and the re-emit has /job unchanged and no /urn.",
        "forbidden_key": "/urn",
        "expect": "warn",
        "expect_absent_after_reencode": [
          "/urn"
        ],
        "expect_preserved": {
          "/job": "urn:acme:a"
        }
      },
      {
        "name": "forbidden-key-job-nonascii-space-and-urn",
        "file": "fixtures/forbidden-key-job-nonascii-space-and-urn.json",
        "description": "ADR-0031 (c), negative: `job` is only U+2003 (EM SPACE), which is outside the closed ASCII blank set, so `job` is not blank: it wins, `urn` is dropped with a warning naming /urn, and there is NO fallback to `urn`. Re-emit keeps /job as U+2003 and has no /urn.",
        "forbidden_key": "/urn",
        "expect": "warn",
        "expect_absent_after_reencode": [
          "/urn"
        ],
        "expect_preserved": {
          "/job": "\u2003"
        }
      }
    ]
  },
  "extension_write": {
    "description": "Producer `meta` write API (ADR-0031 (b); Go WithMeta, Python make(meta=), Node MakeOptions.meta, PHP make(meta:), Java make(urn, data, queue, traceId, Map meta), .NET Make(meta:)). For each case call the SDK's producer API with `urn`, `queue`, `data` and the `meta` entries (one flat meta key per entry; a vendor block is supplied as the whole `ext` value), then run two checks. (1) Encode the message, parse the output JSON and assert every `expect_envelope` pointer (RFC 6901) equals the given value, with JSON type distinction ({} != [], true != 1); the entries sit next to the core meta keys, which stay as the SDK generated them. (2) Re-emit chain: decode that output, increment `attempts` by one, re-encode, parse, and assert every `expect_envelope` pointer again (so extension keys survive a retry/redrive hop) and that /attempts == 1. Per-message fields (meta.id, trace_id, meta.created_at) are not asserted by value. Key order and whitespace are not asserted. A runner that does not know this block skips it.",
    "cases": [
      {
        "name": "flat-scalar-key",
        "description": "A single flat extension key with a boolean value lands in meta next to the core keys.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "vendor_flag": true },
        "expect_envelope": {
          "/job": "urn:acme:orders:created",
          "/data": { "order_id": 1042 },
          "/meta/queue": "orders",
          "/meta/schema_version": 1,
          "/meta/vendor_flag": true
        }
      },
      {
        "name": "vendor-block-under-ext",
        "description": "The recommended shape (ADR-0031 (d)): a vendor block under meta.ext.<vendor>, with nested objects and arrays, supplied as the whole `ext` value.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "ext": { "acme": { "tier": "gold", "flags": [1, 2], "limits": { "burst": 10 } } } },
        "expect_envelope": {
          "/meta/ext/acme": { "tier": "gold", "flags": [1, 2], "limits": { "burst": 10 } },
          "/meta/queue": "orders"
        }
      },
      {
        "name": "two-vendors-in-one-ext",
        "description": "Two vendor blocks supplied together in one `ext` value both survive; neither overwrites the other.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "ext": { "acme": { "tier": "gold" }, "globex": { "region": "eu-west-1" } } },
        "expect_envelope": {
          "/meta/ext/acme": { "tier": "gold" },
          "/meta/ext/globex": { "region": "eu-west-1" }
        }
      },
      {
        "name": "several-flat-keys-mixed-types",
        "description": "Several flat keys of different JSON types (string, integer, array, empty object) keep name, value and type.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "vendor_region": "eu-west-1", "vendor_count": 3, "vendor_tags": ["a", "b"], "vendor_ctx": {} },
        "expect_envelope": {
          "/meta/vendor_region": "eu-west-1",
          "/meta/vendor_count": 3,
          "/meta/vendor_tags": ["a", "b"],
          "/meta/vendor_ctx": {}
        }
      },
      {
        "name": "non-ascii-value",
        "description": "A non-ASCII string value in an extension key is value-equal after parse (UTF-8; a runner compares the parsed value, so `\\uXXXX` escaping of the output is accepted).",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "ext": { "acme": { "note": "ğüşiöç \u00e9 \ud83d\ude00" } } },
        "expect_envelope": {
          "/meta/ext/acme/note": "ğüşiöç \u00e9 \ud83d\ude00"
        }
      }
    ]
  },
  "encode_reject": {
    "description": "Encode MUST reject (ADR-0031 (b), (c)): an `error` in Go, an exception in every other language; never a silent drop and never a mere warning. Every case has `expect: \"reject\"`. Build the message from `urn`, `queue`, `data` and the optional input fields below, then call the producer/encode path; the call MUST fail, and no envelope JSON may be produced. Input fields: `meta` = entries passed through the producer `meta` write API (object, keys unique); `meta_entries` = the same entries as an ordered list of [key, value] pairs, for a REPEATED key, which a JSON object cannot express (SDKs whose write API takes one map per call, i.e. every SDK except Go, cannot express a repeat and skip those cases); `extras_top` and `extras_meta` = entries the runner places directly into the message's preserved unknown-key container at top level or under meta, by whatever test access the SDK has (in-package access, a constructor taking extras, reflection), standing for extras carried over from an inbound message; this is how top-level `timestamp`/`urn` are exercised, since the write API offers no top-level keys. `offending_key` names the key (RFC 6901 pointer) and is informational: a runner MAY assert that the error message mentions it, it is not required. Core meta keys (id, queue, lang, schema_version, created_at) and the forbidden keys of message-envelope.md §10 are the rejected sets. A runner that does not know this block skips it.",
    "cases": [
      {
        "name": "reject-top-level-timestamp",
        "description": "Forbidden top-level `timestamp` arriving through preserved top-level extras.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "extras_top": { "timestamp": 1749132727 },
        "offending_key": "/timestamp",
        "expect": "reject"
      },
      {
        "name": "reject-top-level-urn",
        "description": "Forbidden top-level `urn` arriving through preserved top-level extras; the message carries `job` already, so `urn` can only be a leftover alias.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "extras_top": { "urn": "urn:acme:orders:created" },
        "offending_key": "/urn",
        "expect": "reject"
      },
      {
        "name": "reject-meta-max-retries",
        "description": "Forbidden meta.max_retries passed to the meta write API.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "max_retries": 3 },
        "offending_key": "/meta/max_retries",
        "expect": "reject"
      },
      {
        "name": "reject-meta-attempts",
        "description": "Forbidden meta.attempts (a draft shadow of top-level `attempts`) passed to the meta write API.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "attempts": 1 },
        "offending_key": "/meta/attempts",
        "expect": "reject"
      },
      {
        "name": "reject-meta-source",
        "description": "Forbidden meta.source passed to the meta write API.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "source": "billing" },
        "offending_key": "/meta/source",
        "expect": "reject"
      },
      {
        "name": "reject-meta-ts",
        "description": "Forbidden meta.ts passed to the meta write API.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "ts": 1749132727 },
        "offending_key": "/meta/ts",
        "expect": "reject"
      },
      {
        "name": "reject-forbidden-meta-key-in-extras",
        "description": "A forbidden meta key arriving through preserved meta extras (not the write API) is rejected too: encode applies to the message being encoded, whatever its origin.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "extras_meta": { "max_retries": 3 },
        "offending_key": "/meta/max_retries",
        "expect": "reject"
      },
      {
        "name": "reject-core-meta-id",
        "description": "Collision with core meta key `id`: the core never silently overwrites a core key.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "id": "00000000-0000-4000-8000-000000000000" },
        "offending_key": "/meta/id",
        "expect": "reject"
      },
      {
        "name": "reject-core-meta-queue",
        "description": "Collision with core meta key `queue`.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "queue": "shadow" },
        "offending_key": "/meta/queue",
        "expect": "reject"
      },
      {
        "name": "reject-core-meta-lang",
        "description": "Collision with core meta key `lang`.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "lang": "cobol" },
        "offending_key": "/meta/lang",
        "expect": "reject"
      },
      {
        "name": "reject-core-meta-schema-version",
        "description": "Collision with core meta key `schema_version`.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "schema_version": 2 },
        "offending_key": "/meta/schema_version",
        "expect": "reject"
      },
      {
        "name": "reject-core-meta-created-at",
        "description": "Collision with core meta key `created_at`.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta": { "created_at": 0 },
        "offending_key": "/meta/created_at",
        "expect": "reject"
      },
      {
        "name": "reject-repeated-key",
        "description": "The same extension key supplied twice is rejected, not merged and not last-write-wins, so independent libraries that both write the key fail loudly. Expressible only where the write API takes entries one at a time (Go WithMeta); other SDKs skip this case.",
        "urn": "urn:acme:orders:created",
        "queue": "orders",
        "data": { "order_id": 1042 },
        "meta_entries": [["ext", { "acme": { "tier": "gold" } }], ["ext", { "globex": { "region": "eu-west-1" } }]],
        "offending_key": "/meta/ext",
        "expect": "reject"
      }
    ]
  },
  "payload_schema_unicode": {
    "description": "Unicode string length for minLength (ADR-0024, GR-5). Same shape as payload_schema: validate each case's `data` against `schema`; every SDK's payload validator MUST agree on `valid`. Length is the number of Unicode CODE POINTS — not UTF-8 bytes, not UTF-16 code units, not grapheme clusters. maxLength is intentionally absent: no SDK supports it yet (arrives with K-17 in R1).",
    "schema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "type": "object",
      "properties": {
        "min3": {
          "type": "string",
          "minLength": 3
        },
        "min2": {
          "type": "string",
          "minLength": 2
        }
      },
      "additionalProperties": false
    },
    "cases": [
      {
        "name": "ascii-3cp-min3",
        "valid": true,
        "data": {
          "min3": "abc"
        }
      },
      {
        "name": "turkish-2cp-min3",
        "valid": false,
        "data": {
          "min3": "ğü"
        }
      },
      {
        "name": "turkish-3cp-min3-boundary",
        "valid": true,
        "data": {
          "min3": "ğüş"
        }
      },
      {
        "name": "emoji-1cp-min2",
        "valid": false,
        "data": {
          "min2": "😀"
        }
      },
      {
        "name": "emoji-plus-ascii-2cp-min3",
        "valid": false,
        "data": {
          "min3": "😀a"
        }
      },
      {
        "name": "combining-2cp-min2",
        "valid": true,
        "data": {
          "min2": "e\u0301"
        }
      }
    ]
  },
  "payload_schema_keywords": {
    "description": "Draft-07 subset keyword semantics (ADR-0024, K-17). The subset is exactly `type`, `required`, `properties`, `additionalProperties`, `items`, `enum`, `const`, `minLength`, `maxLength`, `minimum`; every SDK's optional payload validator MUST agree on both the verdict and the registration warnings below (GR-5). The wire envelope stays frozen: this governs the opt-in `data` validation only. Shape: `cases` is a list of `{ name, schema, data, valid, warnings? }`; unlike `payload_schema` each case carries its own `schema`. A runner registers `schema`, collects the warnings the registration produces, then validates `data` and compares `valid`. Three rules are pinned. (1) UNION TYPES: `type` may be an array of type names (`[\"string\", \"null\"]`); a value is valid when it matches ANY listed type. `integer` accepts every number whose mathematical value is integral, so `1.0` and `1e0` and `1e2` are integers and `1.5` is not (Draft-07). `number` accepts any number, `boolean` accepts only `true`/`false` (never `0`/`1`), `null` accepts only `null`. (2) NUMERIC EQUALITY in `const` and `enum`: numbers compare by mathematical value, so `1`, `1.0` and `1e0` are equal and `2.5` equals `2.50`; the rule applies recursively inside arrays and objects (objects compare by key set and values, key order is irrelevant; arrays compare element by element in order). `true` is not `1`, `false` is not `0`, `\"1\"` is not `1`, and `null` equals only `null`. Write the JSON number literal as the case does (`1.0`, `1e0`, `2.50`): a runner MUST NOT reject or normalise it before comparing. (3) UNSUPPORTED KEYWORDS: a keyword outside the subset does NOT change the verdict (the schema is evaluated as if the keyword were absent) but registering the schema produces exactly one warning per unsupported keyword occurrence, `{ pointer, keyword }`. `pointer` is the RFC 6901 JSON Pointer, within the schema document, of the schema object that carries the keyword: the root is the empty string `\"\"`, then `/properties/<name>`, `/items`, `/additionalProperties` (property names are escaped `~` -> `~0`, `/` -> `~1`). The walk descends only into the values of `properties`, into `items` and into `additionalProperties` when each is a JSON object; it never descends into the value of an unsupported keyword (`allOf`, `definitions`, ...), so keywords inside such a value produce no warning, and the names inside `properties` are property names, never keywords. Annotation keywords are not unsupported and never warn: `$schema`, `$id`, `title`, `description`, `examples`, `default`, `$comment`, and every keyword whose name starts with `x-` (for example the ADR-0030 `x-gdpr-sensitive`). The expected warnings of a case are the `warnings` field compared as a SET of `{ pointer, keyword }` pairs (order is irrelevant, the message text is the SDK's own and is never compared); an absent `warnings` means the expected set is empty. Because rule 3 evaluates an unsupported keyword as absent, a case whose schema uses a keyword that a full Draft-07 validator enforces (`allOf`, `$ref`, `maximum`, `pattern`, ...) has the subset's verdict, not Draft-07's; for that reason the reference Draft-07 cross-check of `ci.yml` does not cover this section.",
    "cases": [
      { "name": "union-string-null-accepts-string", "schema": { "type": "object", "properties": { "v": { "type": ["string", "null"] } } }, "data": { "v": "abc" }, "valid": true },
      { "name": "union-string-null-accepts-null", "schema": { "type": "object", "properties": { "v": { "type": ["string", "null"] } } }, "data": { "v": null }, "valid": true },
      { "name": "union-string-null-rejects-number", "schema": { "type": "object", "properties": { "v": { "type": ["string", "null"] } } }, "data": { "v": 5 }, "valid": false },
      { "name": "union-string-null-rejects-boolean", "schema": { "type": "object", "properties": { "v": { "type": ["string", "null"] } } }, "data": { "v": false }, "valid": false },
      { "name": "union-integer-null-accepts-1.0", "schema": { "type": "object", "properties": { "v": { "type": ["integer", "null"] } } }, "data": { "v": 1.0 }, "valid": true },
      { "name": "union-integer-null-accepts-1e2", "schema": { "type": "object", "properties": { "v": { "type": ["integer", "null"] } } }, "data": { "v": 1e2 }, "valid": true },
      { "name": "union-integer-null-rejects-1.5", "schema": { "type": "object", "properties": { "v": { "type": ["integer", "null"] } } }, "data": { "v": 1.5 }, "valid": false },
      { "name": "union-integer-null-accepts-null", "schema": { "type": "object", "properties": { "v": { "type": ["integer", "null"] } } }, "data": { "v": null }, "valid": true },
      { "name": "union-integer-boolean-rejects-numeric-string", "schema": { "type": "object", "properties": { "v": { "type": ["integer", "boolean"] } } }, "data": { "v": "1" }, "valid": false },
      { "name": "type-integer-accepts-1.0", "schema": { "type": "object", "properties": { "v": { "type": "integer" } } }, "data": { "v": 1.0 }, "valid": true },
      { "name": "type-integer-rejects-1.5", "schema": { "type": "object", "properties": { "v": { "type": "integer" } } }, "data": { "v": 1.5 }, "valid": false },
      { "name": "union-nested-properties-accepts-null", "schema": { "type": "object", "properties": { "user": { "type": "object", "properties": { "email": { "type": ["string", "null"] }, "age": { "type": ["integer", "null"], "minimum": 0 } } } } }, "data": { "user": { "email": null, "age": 30.0 } }, "valid": true },
      { "name": "union-nested-properties-rejects-wrong-type", "schema": { "type": "object", "properties": { "user": { "type": "object", "properties": { "email": { "type": ["string", "null"] } } } } }, "data": { "user": { "email": 7 } }, "valid": false },
      { "name": "union-nested-minimum-still-applies", "schema": { "type": "object", "properties": { "user": { "type": "object", "properties": { "age": { "type": ["integer", "null"], "minimum": 0 } } } } }, "data": { "user": { "age": -1 } }, "valid": false },
      { "name": "union-items-accepts-member-types", "schema": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": ["string", "number"] } } } }, "data": { "list": ["a", 2, 3.5] }, "valid": true },
      { "name": "union-items-rejects-boolean-member", "schema": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": ["string", "number"] } } } }, "data": { "list": ["a", true] }, "valid": false },
      { "name": "const-number-accepts-1", "schema": { "type": "object", "properties": { "v": { "const": 1 } } }, "data": { "v": 1 }, "valid": true },
      { "name": "const-number-accepts-1.0", "schema": { "type": "object", "properties": { "v": { "const": 1 } } }, "data": { "v": 1.0 }, "valid": true },
      { "name": "const-number-accepts-1e0", "schema": { "type": "object", "properties": { "v": { "const": 1 } } }, "data": { "v": 1e0 }, "valid": true },
      { "name": "const-number-rejects-true", "schema": { "type": "object", "properties": { "v": { "const": 1 } } }, "data": { "v": true }, "valid": false },
      { "name": "const-number-rejects-string-1", "schema": { "type": "object", "properties": { "v": { "const": 1 } } }, "data": { "v": "1" }, "valid": false },
      { "name": "const-number-rejects-1.5", "schema": { "type": "object", "properties": { "v": { "const": 1 } } }, "data": { "v": 1.5 }, "valid": false },
      { "name": "const-number-rejects-null", "schema": { "type": "object", "properties": { "v": { "const": 1 } } }, "data": { "v": null }, "valid": false },
      { "name": "const-1.0-accepts-integer-1", "schema": { "type": "object", "properties": { "v": { "const": 1.0 } } }, "data": { "v": 1 }, "valid": true },
      { "name": "const-true-rejects-1", "schema": { "type": "object", "properties": { "v": { "const": true } } }, "data": { "v": 1 }, "valid": false },
      { "name": "const-false-rejects-0", "schema": { "type": "object", "properties": { "v": { "const": false } } }, "data": { "v": 0 }, "valid": false },
      { "name": "const-null-accepts-null", "schema": { "type": "object", "properties": { "v": { "const": null } } }, "data": { "v": null }, "valid": true },
      { "name": "const-null-rejects-zero", "schema": { "type": "object", "properties": { "v": { "const": null } } }, "data": { "v": 0 }, "valid": false },
      { "name": "const-null-rejects-empty-string", "schema": { "type": "object", "properties": { "v": { "const": null } } }, "data": { "v": "" }, "valid": false },
      { "name": "enum-numbers-accepts-2.50", "schema": { "type": "object", "properties": { "v": { "enum": [1, 2.5] } } }, "data": { "v": 2.50 }, "valid": true },
      { "name": "enum-numbers-accepts-1.0", "schema": { "type": "object", "properties": { "v": { "enum": [1, 2.5] } } }, "data": { "v": 1.0 }, "valid": true },
      { "name": "enum-numbers-accepts-exponent-form", "schema": { "type": "object", "properties": { "v": { "enum": [10, 2.5] } } }, "data": { "v": 1e1 }, "valid": true },
      { "name": "enum-numbers-rejects-3", "schema": { "type": "object", "properties": { "v": { "enum": [1, 2.5] } } }, "data": { "v": 3 }, "valid": false },
      { "name": "enum-numbers-rejects-string-1", "schema": { "type": "object", "properties": { "v": { "enum": [1, 2.5] } } }, "data": { "v": "1" }, "valid": false },
      { "name": "enum-numbers-rejects-true", "schema": { "type": "object", "properties": { "v": { "enum": [1, 2.5] } } }, "data": { "v": true }, "valid": false },
      { "name": "enum-mixed-keeps-booleans-apart", "schema": { "type": "object", "properties": { "v": { "enum": [true, null, 0] } } }, "data": { "v": 1 }, "valid": false },
      { "name": "enum-mixed-accepts-0.0-for-listed-0", "schema": { "type": "object", "properties": { "v": { "enum": [true, null, 0] } } }, "data": { "v": 0.0 }, "valid": true },
      { "name": "const-object-accepts-1.0-in-nested-array", "schema": { "const": { "a": [1] } }, "data": { "a": [1.0] }, "valid": true },
      { "name": "const-object-rejects-true-in-nested-array", "schema": { "const": { "a": [1] } }, "data": { "a": [true] }, "valid": false },
      { "name": "const-object-rejects-longer-array", "schema": { "const": { "a": [1] } }, "data": { "a": [1, 2] }, "valid": false },
      { "name": "const-object-rejects-extra-key", "schema": { "const": { "a": [1] } }, "data": { "a": [1], "b": 1 }, "valid": false },
      { "name": "const-object-ignores-key-order", "schema": { "const": { "a": 1, "b": [2, { "c": 3 }] } }, "data": { "b": [2.0, { "c": 3e0 }], "a": 1.0 }, "valid": true },
      { "name": "const-object-keeps-array-order", "schema": { "const": { "a": [1, 2] } }, "data": { "a": [2, 1] }, "valid": false },
      { "name": "enum-object-accepts-1.0-inside-object", "schema": { "type": "object", "properties": { "v": { "enum": [{ "n": 1 }, { "n": 2 }] } } }, "data": { "v": { "n": 1.0 } }, "valid": true },
      { "name": "enum-object-rejects-string-inside-object", "schema": { "type": "object", "properties": { "v": { "enum": [{ "n": 1 }, { "n": 2 }] } } }, "data": { "v": { "n": "1" } }, "valid": false },
      {
        "name": "unsupported-pattern-format-maxitems-valid-unchanged",
        "schema": { "type": "object", "properties": { "email": { "type": "string", "pattern": "^.+@.+$", "format": "email" }, "tags": { "type": "array", "items": { "type": "string" }, "maxItems": 1 } } },
        "data": { "email": "not-an-email", "tags": ["a", "b"] },
        "valid": true,
        "warnings": [
          { "pointer": "/properties/email", "keyword": "pattern" },
          { "pointer": "/properties/email", "keyword": "format" },
          { "pointer": "/properties/tags", "keyword": "maxItems" }
        ]
      },
      {
        "name": "unsupported-keywords-supported-ones-still-enforced",
        "schema": { "type": "object", "properties": { "email": { "type": "string", "pattern": "^.+@.+$", "format": "email" } } },
        "data": { "email": 12 },
        "valid": false,
        "warnings": [
          { "pointer": "/properties/email", "keyword": "pattern" },
          { "pointer": "/properties/email", "keyword": "format" }
        ]
      },
      {
        "name": "unsupported-root-keyword",
        "schema": { "type": "object", "minProperties": 2 },
        "data": { "a": 1 },
        "valid": true,
        "warnings": [{ "pointer": "", "keyword": "minProperties" }]
      },
      {
        "name": "unsupported-maximum-is-not-enforced",
        "schema": { "type": "object", "properties": { "n": { "type": "integer", "minimum": 1, "maximum": 5 } } },
        "data": { "n": 10 },
        "valid": true,
        "warnings": [{ "pointer": "/properties/n", "keyword": "maximum" }]
      },
      {
        "name": "unsupported-in-items-schema",
        "schema": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "integer", "multipleOf": 2 } } } },
        "data": { "list": [1, 2, 3] },
        "valid": true,
        "warnings": [{ "pointer": "/properties/list/items", "keyword": "multipleOf" }]
      },
      {
        "name": "unsupported-in-additional-properties-schema",
        "schema": { "type": "object", "additionalProperties": { "type": "string", "pattern": "^x" } },
        "data": { "a": "y" },
        "valid": true,
        "warnings": [{ "pointer": "/additionalProperties", "keyword": "pattern" }]
      },
      {
        "name": "unsupported-deeply-nested",
        "schema": { "type": "object", "properties": { "a": { "type": "object", "properties": { "b": { "type": "array", "items": { "type": "object", "properties": { "c": { "type": "string", "pattern": "^z" } } } } } } } },
        "data": { "a": { "b": [{ "c": "q" }] } },
        "valid": true,
        "warnings": [{ "pointer": "/properties/a/properties/b/items/properties/c", "keyword": "pattern" }]
      },
      {
        "name": "unsupported-pointer-escapes-property-names",
        "schema": { "type": "object", "properties": { "a/b": { "type": "string", "pattern": "x" }, "m~n": { "type": "string", "format": "x" } } },
        "data": { "a/b": "q", "m~n": "q" },
        "valid": true,
        "warnings": [
          { "pointer": "/properties/a~1b", "keyword": "pattern" },
          { "pointer": "/properties/m~0n", "keyword": "format" }
        ]
      },
      {
        "name": "unsupported-container-is-one-warning-and-not-descended",
        "schema": { "type": "object", "properties": { "a": { "type": "string" } }, "allOf": [{ "type": "integer", "pattern": "x" }], "definitions": { "s": { "type": "string", "format": "x" } } },
        "data": { "a": "s" },
        "valid": true,
        "warnings": [
          { "pointer": "", "keyword": "allOf" },
          { "pointer": "", "keyword": "definitions" }
        ]
      },
      {
        "name": "unsupported-ref-is-ignored",
        "schema": { "type": "object", "properties": { "a": { "$ref": "#/definitions/s" } }, "definitions": { "s": { "type": "string" } } },
        "data": { "a": 5 },
        "valid": true,
        "warnings": [
          { "pointer": "", "keyword": "definitions" },
          { "pointer": "/properties/a", "keyword": "$ref" }
        ]
      },
      {
        "name": "unsupported-same-keyword-at-two-places-warns-twice",
        "schema": { "type": "object", "pattern": "x", "properties": { "a": { "type": "string", "pattern": "x" } } },
        "data": { "a": "s" },
        "valid": true,
        "warnings": [
          { "pointer": "", "keyword": "pattern" },
          { "pointer": "/properties/a", "keyword": "pattern" }
        ]
      },
      {
        "name": "annotations-never-warn",
        "schema": {
          "$schema": "http://json-schema.org/draft-07/schema#",
          "$id": "urn:example:order",
          "title": "Order",
          "description": "An order.",
          "$comment": "annotation only",
          "examples": [{ "order_id": 1 }],
          "default": {},
          "type": "object",
          "properties": {
            "order_id": { "type": "integer", "title": "Order id", "description": "The id.", "$comment": "c", "default": 0, "examples": [1] }
          }
        },
        "data": { "order_id": 7 },
        "valid": true
      },
      {
        "name": "x-prefixed-keywords-never-warn",
        "schema": {
          "type": "object",
          "x-owner": "billing",
          "properties": {
            "email": { "type": "string", "x-gdpr-sensitive": true },
            "tags": { "type": "array", "items": { "type": "string", "x-gdpr-sensitive": { "category": "pii" } } }
          },
          "additionalProperties": { "type": "string", "x-custom": 1 }
        },
        "data": { "email": "a@b.c", "tags": ["x"], "extra": "s" },
        "valid": true
      },
      {
        "name": "annotation-and-unsupported-mixed-warns-only-for-unsupported",
        "schema": { "type": "object", "title": "T", "x-gdpr-sensitive": true, "properties": { "email": { "type": "string", "description": "d", "x-gdpr-sensitive": true, "format": "email" } } },
        "data": { "email": "q" },
        "valid": true,
        "warnings": [{ "pointer": "/properties/email", "keyword": "format" }]
      },
      {
        "name": "property-names-are-not-keywords",
        "schema": { "type": "object", "properties": { "title": { "type": "string" }, "pattern": { "type": "string" }, "format": { "type": "string" }, "x-gdpr-sensitive": { "type": "string" } } },
        "data": { "title": "t", "pattern": "p", "format": "f", "x-gdpr-sensitive": "s" },
        "valid": true
      },
      {
        "name": "all-supported-keywords-produce-no-warnings",
        "schema": {
          "type": "object",
          "required": ["name", "score", "kind"],
          "properties": {
            "name": { "type": "string", "minLength": 2, "maxLength": 5 },
            "score": { "type": ["number", "null"], "minimum": 0 },
            "kind": { "enum": ["a", "b"] },
            "version": { "const": 1 },
            "tags": { "type": "array", "items": { "type": "string" } }
          },
          "additionalProperties": false
        },
        "data": { "name": "abc", "score": 0, "kind": "a", "version": 1.0, "tags": ["x"] },
        "valid": true
      },
      {
        "name": "max-length-ascii-boundary-valid",
        "schema": { "type": "object", "properties": { "v": { "type": "string", "maxLength": 3 } } },
        "data": { "v": "abc" },
        "valid": true
      },
      {
        "name": "max-length-turkish-3cp-6-bytes-boundary-valid",
        "schema": { "type": "object", "properties": { "v": { "type": "string", "maxLength": 3 } } },
        "data": { "v": "ğüş" },
        "valid": true
      },
      {
        "name": "max-length-emoji-3cp-6-utf16-units-boundary-valid",
        "schema": { "type": "object", "properties": { "v": { "type": "string", "maxLength": 3 } } },
        "data": { "v": "😀😀😀" },
        "valid": true
      },
      {
        "name": "max-length-emoji-4cp-max3-invalid",
        "schema": { "type": "object", "properties": { "v": { "type": "string", "maxLength": 3 } } },
        "data": { "v": "😀😀😀😀" },
        "valid": false
      },
      {
        "name": "max-length-combining-2cp-1-grapheme-max1-invalid",
        "schema": { "type": "object", "properties": { "v": { "type": "string", "maxLength": 1 } } },
        "data": { "v": "e\u0301" },
        "valid": false
      }
    ]
  },
  "trim": {
    "description": "ADR-0032 \u00a75 (normative): the ASCII whitespace set is space, \\t, \\n, \\r, \\f, \\v; U+00A0, U+2003 and U+3000 are NOT whitespace and are part of the value. Scope: `core`. Every case has a `mode`. `make`: call the producer's `make` with `urn` (and `trace_id` when given); the URN and the trace_id are trimmed with the ASCII set, so `expect` is the resulting `job` / `trace_id`, or `\"reject\"` when the URN is empty after trimming. `decode`: decode `file`; `valid: true` means it succeeds with `expect.urn` as the resolved identity and a warning iff `expect_warning` (a blank string `job` falls back to `urn` silently, ADR-0032 \u00a76); `valid: false` means decode raises. `accepts`: `accepts(file)` MUST equal `expect_accepts` (a blank `trace_id` makes it false) while decode itself still succeeds when `expect_decode_ok` is true (an older producer's message without a usable trace_id is tolerated). `reemit`: decode, increment `attempts`, re-encode (retry/DLQ/redrive/relay) and assert `expect_preserved` (JSON Pointer -> value) byte for byte: re-emit never trims. Note on tension with urn-naming section 2: the `make` cases that use a Unicode-space or space-padded URN pin only the ASCII-trim blank rule (what `make` does with such an input); they do not endorse such strings as well-formed URNs, which urn-naming section 2 constrains separately.",
    "cases": [
      {
        "name": "make-trims-ascii-space",
        "mode": "make",
        "urn": " urn:acme:a ",
        "expect": {
          "job": "urn:acme:a"
        }
      },
      {
        "name": "make-trims-ascii-tab",
        "mode": "make",
        "urn": "\turn:acme:a\t",
        "expect": {
          "job": "urn:acme:a"
        }
      },
      {
        "name": "make-trims-ascii-lf",
        "mode": "make",
        "urn": "\nurn:acme:a\n",
        "expect": {
          "job": "urn:acme:a"
        }
      },
      {
        "name": "make-trims-ascii-cr",
        "mode": "make",
        "urn": "\rurn:acme:a\r",
        "expect": {
          "job": "urn:acme:a"
        }
      },
      {
        "name": "make-trims-ascii-ff",
        "mode": "make",
        "urn": "\furn:acme:a\f",
        "expect": {
          "job": "urn:acme:a"
        }
      },
      {
        "name": "make-trims-ascii-vt",
        "mode": "make",
        "urn": "\u000burn:acme:a\u000b",
        "expect": {
          "job": "urn:acme:a"
        }
      },
      {
        "name": "make-trims-mixed-ascii-set",
        "mode": "make",
        "urn": " \t\n\r\f\u000burn:acme:a \u000b\f\r\n\t",
        "expect": {
          "job": "urn:acme:a"
        }
      },
      {
        "name": "make-trims-trace-id",
        "mode": "make",
        "urn": "urn:acme:a",
        "trace_id": "\t 7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\n",
        "expect": {
          "job": "urn:acme:a",
          "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b"
        }
      },
      {
        "name": "make-keeps-unicode-nbsp-padding",
        "mode": "make",
        "urn": "\u00a0urn:acme:a\u00a0",
        "expect": {
          "job": "\u00a0urn:acme:a\u00a0"
        }
      },
      {
        "name": "make-keeps-unicode-emsp-padding",
        "mode": "make",
        "urn": "\u2003urn:acme:a\u2003",
        "expect": {
          "job": "\u2003urn:acme:a\u2003"
        }
      },
      {
        "name": "make-keeps-unicode-ideographic-padding",
        "mode": "make",
        "urn": "\u3000urn:acme:a\u3000",
        "expect": {
          "job": "\u3000urn:acme:a\u3000"
        }
      },
      {
        "name": "make-ascii-trim-stops-at-unicode-space",
        "mode": "make",
        "urn": " \u00a0urn:acme:a\u3000 ",
        "expect": {
          "job": "\u00a0urn:acme:a\u3000"
        }
      },
      {
        "name": "make-unicode-space-only-urn-is-not-blank",
        "mode": "make",
        "urn": "\u2003",
        "expect": {
          "job": "\u2003"
        }
      },
      {
        "name": "make-rejects-urn-blank-after-trim",
        "mode": "make",
        "urn": " \t\n\r\f\u000b",
        "expect": "reject"
      },
      {
        "name": "decode-blank-job-space-falls-back-to-urn",
        "mode": "decode",
        "file": "fixtures/trim-blank-job-space.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": false
      },
      {
        "name": "decode-blank-job-tab-falls-back-to-urn",
        "mode": "decode",
        "file": "fixtures/trim-blank-job-tab.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": false
      },
      {
        "name": "decode-blank-job-lf-falls-back-to-urn",
        "mode": "decode",
        "file": "fixtures/trim-blank-job-lf.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": false
      },
      {
        "name": "decode-blank-job-cr-falls-back-to-urn",
        "mode": "decode",
        "file": "fixtures/trim-blank-job-cr.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": false
      },
      {
        "name": "decode-blank-job-ff-falls-back-to-urn",
        "mode": "decode",
        "file": "fixtures/trim-blank-job-ff.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": false
      },
      {
        "name": "decode-blank-job-vt-falls-back-to-urn",
        "mode": "decode",
        "file": "fixtures/trim-blank-job-vt.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": false
      },
      {
        "name": "decode-unicode-nbsp-job-is-not-blank",
        "mode": "decode",
        "file": "fixtures/trim-unicode-job-nbsp.json",
        "valid": true,
        "expect": {
          "urn": "\u00a0"
        },
        "expect_warning": false
      },
      {
        "name": "decode-unicode-emsp-job-is-not-blank",
        "mode": "decode",
        "file": "fixtures/trim-unicode-job-emsp.json",
        "valid": true,
        "expect": {
          "urn": "\u2003"
        },
        "expect_warning": false
      },
      {
        "name": "decode-unicode-ideographic-job-is-not-blank",
        "mode": "decode",
        "file": "fixtures/trim-unicode-job-ideographic.json",
        "valid": true,
        "expect": {
          "urn": "\u3000"
        },
        "expect_warning": false
      },
      {
        "name": "decode-unicode-space-urn-is-valid",
        "mode": "decode",
        "file": "fixtures/trim-urn-only-unicode-space.json",
        "valid": true,
        "expect": {
          "urn": "\u2003"
        },
        "expect_warning": false
      },
      {
        "name": "decode-ascii-blank-urn-is-invalid",
        "mode": "decode",
        "file": "fixtures/trim-urn-only-ascii-blank.json",
        "valid": false,
        "reason": "no job and the urn alias is blank under the ASCII set, so there is no valid identity"
      },
      {
        "name": "decode-blank-job-and-blank-urn-is-invalid",
        "mode": "decode",
        "file": "fixtures/trim-job-and-urn-both-blank.json",
        "valid": false,
        "reason": "job and urn are both blank under the ASCII set, so there is no valid identity"
      },
      {
        "name": "accepts-blank-trace-id-space-is-false",
        "mode": "accepts",
        "file": "fixtures/trim-blank-trace-id-space.json",
        "expect_accepts": false,
        "expect_decode_ok": true
      },
      {
        "name": "accepts-blank-trace-id-tab-is-false",
        "mode": "accepts",
        "file": "fixtures/trim-blank-trace-id-tab.json",
        "expect_accepts": false,
        "expect_decode_ok": true
      },
      {
        "name": "accepts-blank-trace-id-lf-is-false",
        "mode": "accepts",
        "file": "fixtures/trim-blank-trace-id-lf.json",
        "expect_accepts": false,
        "expect_decode_ok": true
      },
      {
        "name": "accepts-blank-trace-id-cr-is-false",
        "mode": "accepts",
        "file": "fixtures/trim-blank-trace-id-cr.json",
        "expect_accepts": false,
        "expect_decode_ok": true
      },
      {
        "name": "accepts-blank-trace-id-ff-is-false",
        "mode": "accepts",
        "file": "fixtures/trim-blank-trace-id-ff.json",
        "expect_accepts": false,
        "expect_decode_ok": true
      },
      {
        "name": "accepts-blank-trace-id-vt-is-false",
        "mode": "accepts",
        "file": "fixtures/trim-blank-trace-id-vt.json",
        "expect_accepts": false,
        "expect_decode_ok": true
      },
      {
        "name": "reemit-keeps-ascii-padded-job",
        "mode": "reemit",
        "file": "fixtures/trim-reemit-job-ascii-padded.json",
        "expect_attempts": 1,
        "expect_preserved": {
          "/job": " urn:acme:a\t"
        }
      },
      {
        "name": "reemit-keeps-unicode-padded-job",
        "mode": "reemit",
        "file": "fixtures/trim-reemit-job-unicode-padded.json",
        "expect_attempts": 1,
        "expect_preserved": {
          "/job": "\u00a0urn:acme:a\u3000"
        }
      },
      {
        "name": "reemit-keeps-ascii-padded-trace-id",
        "mode": "reemit",
        "file": "fixtures/trim-reemit-trace-id-padded.json",
        "expect_attempts": 1,
        "expect_preserved": {
          "/trace_id": " 7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\t"
        }
      }
    ]
  },
  "job_type": {
    "description": "ADR-0032 \u00a76 (normative): on decode a `job` that is not a string (null, number, boolean, object, array) is ignored and the decoder MUST emit a warning; a blank-string `job` keeps the ADR-0031 rule and falls back to `urn` WITHOUT a warning; a `urn` alias that is not a string is ignored; a valid `urn` is a non-blank string under the ASCII set; with neither a valid `job` nor a valid `urn` decode raises. Scope: `core`. For each case decode `file`: `valid: true` means it succeeds with `expect.urn` as the resolved identity and a warning iff `expect_warning`; `valid: false` means decode raises (whether a warning is also emitted before the error is not asserted).",
    "cases": [
      {
        "name": "null-job-ignored-falls-back-to-urn",
        "file": "fixtures/job-type-null-urn-fallback.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": true
      },
      {
        "name": "number-job-ignored-falls-back-to-urn",
        "file": "fixtures/job-type-number-urn-fallback.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": true
      },
      {
        "name": "bool-job-ignored-falls-back-to-urn",
        "file": "fixtures/job-type-bool-urn-fallback.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": true
      },
      {
        "name": "object-job-ignored-falls-back-to-urn",
        "file": "fixtures/job-type-object-urn-fallback.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": true
      },
      {
        "name": "array-job-ignored-falls-back-to-urn",
        "file": "fixtures/job-type-array-urn-fallback.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": true
      },
      {
        "name": "empty-string-job-falls-back-without-warning",
        "file": "fixtures/job-type-empty-string-urn-fallback.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": false
      },
      {
        "name": "blank-ascii-string-job-falls-back-without-warning",
        "file": "fixtures/blank-ascii-job-urn-fallback.json",
        "valid": true,
        "expect": {
          "urn": "urn:acme:b"
        },
        "expect_warning": false
      },
      {
        "name": "null-job-without-urn-is-invalid",
        "file": "fixtures/job-type-null-no-urn.json",
        "valid": false,
        "reason": "job is not a string and there is no urn alias, so there is no valid identity"
      },
      {
        "name": "number-job-with-blank-urn-is-invalid",
        "file": "fixtures/job-type-number-blank-urn.json",
        "valid": false,
        "reason": "job is not a string and the urn alias is blank, so there is no valid identity"
      },
      {
        "name": "number-job-with-number-urn-is-invalid",
        "file": "fixtures/job-type-number-nonstring-urn.json",
        "valid": false,
        "reason": "neither job nor urn is a string, so there is no valid identity"
      },
      {
        "name": "array-urn-is-ignored",
        "file": "fixtures/job-type-missing-job-array-urn.json",
        "valid": false,
        "reason": "a urn alias that is not a string is ignored, and there is no job"
      }
    ]
  },
  "delay": {
    "description": "Amazon SQS delays (broker-bindings.md \u00a73.4). Scope: `sqs`. For each case, ask the SQS transport to publish with `delay_seconds` on a `queue_type` queue. `expect.delay_seconds_attribute` is the `DelaySeconds` the SendMessage call carries; `expect: \"reject\"` means the publish MUST raise BabelQueueException (the SDK's native error type) and never silently drop or truncate the delay. A delay of 0 or a negative delay is not pinned by the contract and is not tested. The `release_visibility` block pins the `ChangeMessageVisibility` timeout of a release (\u00a73.5): `0` redelivers now, `N` backs off N seconds. Only the SQS contract is encoded here; the Redis (\u00a71.6) and Kafka (\u00a76.4) delay mechanics are different mechanisms and are not pinned by this section (Kafka tiers are the `backoff` section; the Redis available-at formula is the separate `redis_delay` section, scope `redis`, added in 1.6.0).",
    "cases": [
      {
        "name": "standard-1s",
        "queue_type": "standard",
        "delay_seconds": 1,
        "expect": {
          "delay_seconds_attribute": 1
        }
      },
      {
        "name": "standard-60s",
        "queue_type": "standard",
        "delay_seconds": 60,
        "expect": {
          "delay_seconds_attribute": 60
        }
      },
      {
        "name": "standard-900s-is-the-cap",
        "queue_type": "standard",
        "delay_seconds": 900,
        "expect": {
          "delay_seconds_attribute": 900
        }
      },
      {
        "name": "standard-901s-rejected",
        "queue_type": "standard",
        "delay_seconds": 901,
        "expect": "reject"
      },
      {
        "name": "standard-3600s-rejected",
        "queue_type": "standard",
        "delay_seconds": 3600,
        "expect": "reject"
      },
      {
        "name": "fifo-per-message-delay-rejected",
        "queue_type": "fifo",
        "delay_seconds": 30,
        "expect": "reject"
      }
    ],
    "release_visibility": {
      "description": "SQS release (broker-bindings.md \u00a73.5): ChangeMessageVisibility(ReceiptHandle, VisibilityTimeout). `delay_seconds` is the requested release delay; `expect.visibility_timeout` is the VisibilityTimeout sent. 43200 s (12 h) is the SQS maximum; behaviour above it is not pinned.",
      "cases": [
        {
          "name": "release-now",
          "delay_seconds": 0,
          "expect": {
            "visibility_timeout": 0
          }
        },
        {
          "name": "release-30s",
          "delay_seconds": 30,
          "expect": {
            "visibility_timeout": 30
          }
        },
        {
          "name": "release-12h",
          "delay_seconds": 43200,
          "expect": {
            "visibility_timeout": 43200
          }
        }
      ]
    }
  },
  "backoff": {
    "description": "Kafka retry-topic tiers (broker-bindings.md \u00a76.4/\u00a76.5). Scope: `kafka`. `retry_tiers_ms` are the configured `<topic>.retry.<n>` delay tiers in ascending order (the contract's example is 5s, 30s, 5m, 30m); `<n>` is the 1-based tier index (`<topic>.retry.1` is the first configured tier; \u00a76.4), never a delay value, so in the cases below the expected tier is given by its delay (`tier_ms`) and the `topic_names` / `retry_attempt_tier` blocks pin the topic names. Two separate rules, which MUST NOT be merged (\u00a76.4 vs \u00a76.5). (1) The REQUESTED-DELAY rule (\u00a76.4), pinned by `cases`: for each case request `delay_ms` for a message on `work_topic`; the SDK MUST publish to the smallest tier >= the requested delay and set the listed headers, `bq-delay` being the REQUESTED delay (values are UTF-8 decimal strings per \u00a76.3; any header not listed is unspecified); a delay above the largest tier, or any delay with no tiers configured, MUST raise BabelQueueException (`expect: \"reject\"`). (2) The RETRY/RELEASE rule (\u00a76.5), pinned by `retry_republish` and `retry_attempt_tier`: a record that already has `attempts` (`attempts_before`) attempts goes to tier `n = min(attempts_before, N-1) + 1` of the `N` configured tiers and stays on the last tier once they run out; the republished record carries `bq-attempts = attempts_before + 1`, `bq-delay = tier_ms` (the tier's own delay, not a worker-computed one), `bq-original-topic = work_topic`, and the body `attempts` kept in sync (`body_attempts`); with no tiers configured the retry MUST raise BabelQueueException. Kafka does not apply the `retry_backoff` parameters on this path (ADR-0034 \u00a79; their formula is the separate `retry_backoff` section, scope `core`). Conformance 1.6.0 adds the blocks `topic_names`, `retry_attempt_tier` and `default_tiers`, each with its own `cases` array (ADR-0034), and rewrites `retry_republish` to the \u00a76.5 attempt-to-tier rule. `topic_names`: the retry topic of tier `n` MUST be `<work_topic>.retry.<n>` (`expect_topic`). `retry_attempt_tier`: the \u00a76.5 retry rule, also pinning the consumed record's `key` byte for byte when the case lists one. `default_tiers`: the named constant `DEFAULT_RETRY_TIERS_MS` (or the language's equivalent) MUST equal `expect` (RECOMMENDED list, \u00a76.4).",
    "cases": [
      {
        "name": "below-first-tier",
        "work_topic": "orders",
        "retry_tiers_ms": [
          5000,
          30000,
          300000,
          1800000
        ],
        "delay_ms": 1000,
        "expect": {
          "tier_ms": 5000,
          "headers": {
            "bq-delay": "1000",
            "bq-original-topic": "orders"
          }
        }
      },
      {
        "name": "exactly-first-tier",
        "work_topic": "orders",
        "retry_tiers_ms": [
          5000,
          30000,
          300000,
          1800000
        ],
        "delay_ms": 5000,
        "expect": {
          "tier_ms": 5000,
          "headers": {
            "bq-delay": "5000",
            "bq-original-topic": "orders"
          }
        }
      },
      {
        "name": "just-above-first-tier",
        "work_topic": "orders",
        "retry_tiers_ms": [
          5000,
          30000,
          300000,
          1800000
        ],
        "delay_ms": 5001,
        "expect": {
          "tier_ms": 30000,
          "headers": {
            "bq-delay": "5001",
            "bq-original-topic": "orders"
          }
        }
      },
      {
        "name": "exactly-third-tier",
        "work_topic": "orders",
        "retry_tiers_ms": [
          5000,
          30000,
          300000,
          1800000
        ],
        "delay_ms": 300000,
        "expect": {
          "tier_ms": 300000,
          "headers": {
            "bq-delay": "300000",
            "bq-original-topic": "orders"
          }
        }
      },
      {
        "name": "exactly-largest-tier",
        "work_topic": "orders",
        "retry_tiers_ms": [
          5000,
          30000,
          300000,
          1800000
        ],
        "delay_ms": 1800000,
        "expect": {
          "tier_ms": 1800000,
          "headers": {
            "bq-delay": "1800000",
            "bq-original-topic": "orders"
          }
        }
      },
      {
        "name": "above-largest-tier-rejected",
        "work_topic": "orders",
        "retry_tiers_ms": [
          5000,
          30000,
          300000,
          1800000
        ],
        "delay_ms": 1800001,
        "expect": "reject"
      },
      {
        "name": "no-tiers-configured-rejected",
        "work_topic": "orders",
        "retry_tiers_ms": [],
        "delay_ms": 1000,
        "expect": "reject"
      }
    ],
    "retry_republish": {
      "description": "Kafka release/retry republish (broker-bindings.md \u00a76.5). Start from a message at `attempts` on `work_topic` with `retry_tiers_ms` configured and release/retry it. The target is NOT chosen from a requested delay: it is tier `n = min(attempts, N-1) + 1` (the same rule as `retry_attempt_tier`; this block exercises the release/retry entry point of the SDK, that block the republish helper). `expect` pins `n`, `topic` (`<work_topic>.retry.<n>`), `tier_ms`, `body_attempts` (= `attempts + 1`) and `headers` (`bq-attempts = attempts + 1`, `bq-delay = tier_ms`, `bq-original-topic = work_topic`; UTF-8 decimal strings, \u00a76.3). With no retry tiers configured the call MUST raise BabelQueueException (`expect: \"reject\"`).",
      "cases": [
        {
          "name": "first-retry",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts": 0,
          "expect": {
            "n": 1,
            "topic": "orders.retry.1",
            "tier_ms": 5000,
            "body_attempts": 1,
            "headers": {
              "bq-attempts": "1",
              "bq-delay": "5000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "second-retry-second-tier",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts": 1,
          "expect": {
            "n": 2,
            "topic": "orders.retry.2",
            "tier_ms": 30000,
            "body_attempts": 2,
            "headers": {
              "bq-attempts": "2",
              "bq-delay": "30000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "third-retry-third-tier",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts": 2,
          "expect": {
            "n": 3,
            "topic": "orders.retry.3",
            "tier_ms": 300000,
            "body_attempts": 3,
            "headers": {
              "bq-attempts": "3",
              "bq-delay": "300000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "fifth-retry-stays-on-last-tier",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts": 4,
          "expect": {
            "n": 4,
            "topic": "orders.retry.4",
            "tier_ms": 1800000,
            "body_attempts": 5,
            "headers": {
              "bq-attempts": "5",
              "bq-delay": "1800000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "no-tiers-configured-rejected",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers); no tiers: BabelQueueException",
          "work_topic": "orders",
          "retry_tiers_ms": [],
          "attempts": 0,
          "expect": "reject"
        }
      ]
    },
    "topic_names": {
      "description": "Retry topic naming (broker-bindings.md \u00a76.4): the retry topic of tier `n` (1-based) of `work_topic` MUST be `expect_topic` = `<work_topic>.retry.<n>`.",
      "cases": [
        {
          "name": "first-tier",
          "source": "broker-bindings.md \u00a76.4 (retry topics `<topic>.retry.<n>`, n is the tier index from 1)",
          "work_topic": "orders",
          "n": 1,
          "expect_topic": "orders.retry.1"
        },
        {
          "name": "second-tier",
          "source": "broker-bindings.md \u00a76.4 (retry topics `<topic>.retry.<n>`, n is the tier index from 1)",
          "work_topic": "orders",
          "n": 2,
          "expect_topic": "orders.retry.2"
        },
        {
          "name": "fourth-tier",
          "source": "broker-bindings.md \u00a76.4 (retry topics `<topic>.retry.<n>`, n is the tier index from 1)",
          "work_topic": "orders",
          "n": 4,
          "expect_topic": "orders.retry.4"
        },
        {
          "name": "dotted-topic",
          "source": "broker-bindings.md \u00a76.4 (retry topics `<topic>.retry.<n>`, n is the tier index from 1)",
          "work_topic": "orders.v2",
          "n": 2,
          "expect_topic": "orders.v2.retry.2"
        },
        {
          "name": "tier-index-is-not-a-delay",
          "source": "broker-bindings.md \u00a76.4 (retry topics `<topic>.retry.<n>`, n is the tier index from 1)",
          "work_topic": "orders",
          "n": 3,
          "expect_topic": "orders.retry.3"
        }
      ]
    },
    "retry_attempt_tier": {
      "description": "Retry attempt-to-tier mapping and republish headers (broker-bindings.md \u00a76.5). Retrying a record that already has `attempts_before` attempts MUST go to tier `n = min(attempts_before, N-1) + 1` of the `N` configured `retry_tiers_ms` and stay on the last tier once they run out; `expect` pins `topic`, `tier_ms`, the headers (`bq-attempts = attempts_before + 1`, `bq-delay = tier_ms`, `bq-original-topic = work_topic`; UTF-8 decimal strings), the body `attempts` (`body_attempts`) and, when the case lists a `key`, the record key byte for byte.",
      "cases": [
        {
          "name": "attempts-0-first-tier",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts_before": 0,
          "expect": {
            "n": 1,
            "topic": "orders.retry.1",
            "tier_ms": 5000,
            "body_attempts": 1,
            "headers": {
              "bq-attempts": "1",
              "bq-delay": "5000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "attempts-1-second-tier",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts_before": 1,
          "expect": {
            "n": 2,
            "topic": "orders.retry.2",
            "tier_ms": 30000,
            "body_attempts": 2,
            "headers": {
              "bq-attempts": "2",
              "bq-delay": "30000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "attempts-2-third-tier",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts_before": 2,
          "expect": {
            "n": 3,
            "topic": "orders.retry.3",
            "tier_ms": 300000,
            "body_attempts": 3,
            "headers": {
              "bq-attempts": "3",
              "bq-delay": "300000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "attempts-3-last-tier",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts_before": 3,
          "expect": {
            "n": 4,
            "topic": "orders.retry.4",
            "tier_ms": 1800000,
            "body_attempts": 4,
            "headers": {
              "bq-attempts": "4",
              "bq-delay": "1800000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "attempts-4-stays-on-last-tier",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts_before": 4,
          "expect": {
            "n": 4,
            "topic": "orders.retry.4",
            "tier_ms": 1800000,
            "body_attempts": 5,
            "headers": {
              "bq-attempts": "5",
              "bq-delay": "1800000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "attempts-10-stays-on-last-tier",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts_before": 10,
          "expect": {
            "n": 4,
            "topic": "orders.retry.4",
            "tier_ms": 1800000,
            "body_attempts": 11,
            "headers": {
              "bq-attempts": "11",
              "bq-delay": "1800000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "single-tier-always-first",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            10000
          ],
          "attempts_before": 0,
          "expect": {
            "n": 1,
            "topic": "orders.retry.1",
            "tier_ms": 10000,
            "body_attempts": 1,
            "headers": {
              "bq-attempts": "1",
              "bq-delay": "10000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "single-tier-stays",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            10000
          ],
          "attempts_before": 5,
          "expect": {
            "n": 1,
            "topic": "orders.retry.1",
            "tier_ms": 10000,
            "body_attempts": 6,
            "headers": {
              "bq-attempts": "6",
              "bq-delay": "10000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "two-tiers-custom",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            1000,
            60000
          ],
          "attempts_before": 1,
          "expect": {
            "n": 2,
            "topic": "orders.retry.2",
            "tier_ms": 60000,
            "body_attempts": 2,
            "headers": {
              "bq-attempts": "2",
              "bq-delay": "60000",
              "bq-original-topic": "orders"
            }
          }
        },
        {
          "name": "dotted-work-topic",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders.v2",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts_before": 2,
          "expect": {
            "n": 3,
            "topic": "orders.v2.retry.3",
            "tier_ms": 300000,
            "body_attempts": 3,
            "headers": {
              "bq-attempts": "3",
              "bq-delay": "300000",
              "bq-original-topic": "orders.v2"
            }
          }
        },
        {
          "name": "key-forwarded-byte-for-byte",
          "source": "broker-bindings.md \u00a76.5 (retry tier rule: n = min(attempts_before, N-1) + 1; retry republish headers)",
          "work_topic": "orders",
          "retry_tiers_ms": [
            5000,
            30000,
            300000,
            1800000
          ],
          "attempts_before": 1,
          "key": "customer-0042",
          "expect": {
            "n": 2,
            "topic": "orders.retry.2",
            "tier_ms": 30000,
            "body_attempts": 2,
            "headers": {
              "bq-attempts": "2",
              "bq-delay": "30000",
              "bq-original-topic": "orders"
            },
            "key": "customer-0042"
          }
        }
      ]
    },
    "default_tiers": {
      "description": "The RECOMMENDED default retry tier list (broker-bindings.md \u00a76.4), exposed as the constant `DEFAULT_RETRY_TIERS_MS` (or the language's idiomatic equivalent); its value MUST equal `expect`.",
      "cases": [
        {
          "name": "recommended-tier-list",
          "source": "broker-bindings.md \u00a76.4 (RECOMMENDED tier list, exposed as DEFAULT_RETRY_TIERS_MS)",
          "constant": "DEFAULT_RETRY_TIERS_MS",
          "expect": [
            5000,
            30000,
            300000,
            1800000
          ]
        }
      ]
    }
  },
  "retry_backoff": {
    "description": "Worker-side retry backoff formula (ADR-0034 \u00a79; broker-bindings.md \u00a76.5 states Kafka itself does not apply it). Scope: `core`: tested on the SDK's backoff helper without a broker, whatever the transport (SQS, Redis, AMQP or Kafka worker path). `d(n) = min(retry_backoff_max, retry_backoff * retry_backoff_multiplier^(n-1))` seconds, `n = attempts + 1` (1-based), `retry_backoff_max = 0` meaning no cap. With `retry_jitter: none` the delay MUST equal `expect_delay_seconds` exactly (the defaults are `retry_backoff 0`, `multiplier 1`, `max 0`, so an unconfigured helper yields 0); with `retry_jitter: full` the delay is `uniform(0, d(n))`, so a runner only asserts `expect_delay_range_seconds.min <= delay <= .max` (the deterministic `d(n)`), over a few draws.",
    "cases": [
      {
        "name": "defaults-are-zero",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 0,
        "retry_backoff_multiplier": 1,
        "retry_backoff_max": 0,
        "retry_jitter": "none",
        "n": 1,
        "expect_delay_seconds": 0
      },
      {
        "name": "defaults-are-zero-at-attempt-5",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 0,
        "retry_backoff_multiplier": 1,
        "retry_backoff_max": 0,
        "retry_jitter": "none",
        "n": 5,
        "expect_delay_seconds": 0
      },
      {
        "name": "constant-base-multiplier-1",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 5,
        "retry_backoff_multiplier": 1,
        "retry_backoff_max": 0,
        "retry_jitter": "none",
        "n": 1,
        "expect_delay_seconds": 5
      },
      {
        "name": "constant-base-multiplier-1-attempt-4",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 5,
        "retry_backoff_multiplier": 1,
        "retry_backoff_max": 0,
        "retry_jitter": "none",
        "n": 4,
        "expect_delay_seconds": 5
      },
      {
        "name": "exponential-attempt-1",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 1,
        "retry_backoff_multiplier": 2,
        "retry_backoff_max": 0,
        "retry_jitter": "none",
        "n": 1,
        "expect_delay_seconds": 1
      },
      {
        "name": "exponential-attempt-2",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 1,
        "retry_backoff_multiplier": 2,
        "retry_backoff_max": 0,
        "retry_jitter": "none",
        "n": 2,
        "expect_delay_seconds": 2
      },
      {
        "name": "exponential-attempt-3",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 1,
        "retry_backoff_multiplier": 2,
        "retry_backoff_max": 0,
        "retry_jitter": "none",
        "n": 3,
        "expect_delay_seconds": 4
      },
      {
        "name": "exponential-attempt-6",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 1,
        "retry_backoff_multiplier": 2,
        "retry_backoff_max": 0,
        "retry_jitter": "none",
        "n": 6,
        "expect_delay_seconds": 32
      },
      {
        "name": "cap-not-reached",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 1,
        "retry_backoff_multiplier": 2,
        "retry_backoff_max": 10,
        "retry_jitter": "none",
        "n": 4,
        "expect_delay_seconds": 8
      },
      {
        "name": "cap-reached",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 1,
        "retry_backoff_multiplier": 2,
        "retry_backoff_max": 10,
        "retry_jitter": "none",
        "n": 5,
        "expect_delay_seconds": 10
      },
      {
        "name": "cap-far-exceeded",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 1,
        "retry_backoff_multiplier": 2,
        "retry_backoff_max": 10,
        "retry_jitter": "none",
        "n": 20,
        "expect_delay_seconds": 10
      },
      {
        "name": "fractional-base-and-multiplier",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 0.5,
        "retry_backoff_multiplier": 3,
        "retry_backoff_max": 0,
        "retry_jitter": "none",
        "n": 3,
        "expect_delay_seconds": 4.5
      },
      {
        "name": "large-growth-no-cap",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 2,
        "retry_backoff_multiplier": 10,
        "retry_backoff_max": 0,
        "retry_jitter": "none",
        "n": 4,
        "expect_delay_seconds": 2000
      },
      {
        "name": "zero-base-stays-zero",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 0,
        "retry_backoff_multiplier": 2,
        "retry_backoff_max": 0,
        "retry_jitter": "none",
        "n": 5,
        "expect_delay_seconds": 0
      },
      {
        "name": "full-jitter-attempt-1-bound",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 1,
        "retry_backoff_multiplier": 2,
        "retry_backoff_max": 0,
        "retry_jitter": "full",
        "n": 1,
        "expect_delay_range_seconds": {
          "min": 0,
          "max": 1
        }
      },
      {
        "name": "full-jitter-attempt-3-bound",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 1,
        "retry_backoff_multiplier": 2,
        "retry_backoff_max": 0,
        "retry_jitter": "full",
        "n": 3,
        "expect_delay_range_seconds": {
          "min": 0,
          "max": 4
        }
      },
      {
        "name": "full-jitter-capped-bound",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 1,
        "retry_backoff_multiplier": 2,
        "retry_backoff_max": 10,
        "retry_jitter": "full",
        "n": 6,
        "expect_delay_range_seconds": {
          "min": 0,
          "max": 10
        }
      },
      {
        "name": "full-jitter-zero-bound",
        "source": "ADR-0034 \u00a79 (retry backoff formula d(n)); broker-bindings.md \u00a76.5 states Kafka itself does not apply it",
        "retry_backoff": 0,
        "retry_backoff_multiplier": 1,
        "retry_backoff_max": 0,
        "retry_jitter": "full",
        "n": 3,
        "expect_delay_range_seconds": {
          "min": 0,
          "max": 0
        }
      }
    ]
  },
  "traceparent": {
    "description": "W3C `traceparent` out-of-band propagation (ADR-0028, ADR-0025). Scope: `otel` (ADR-0032 section 2): `otel` is not a broker but the optional W3C `traceparent` extract/inject code of ADR-0028 (in the core of Node and .NET; a separate module for Go, Python, Java and PHP), so only a package that carries it lists `otel` in `bindings` and runs this section. `mode: extract` cases give the delivered header value (`traceparent`, or null when the transport delivered none) and the envelope's `trace_id`; the consumer-side extraction MUST yield `expect`: `source: traceparent` with the header's 32-hex `trace_id_hex`, 16-hex `parent_span_id` and 2-hex `flags`, or `source: trace_id` (the v0.1 fallback, ADR-0025) with `trace_id_hex` = the envelope `trace_id` without hyphens. A malformed header is ignored (it never raises) and behaves exactly like no header. The structure `00-<32hex>-<16hex>-<2hex>` is pinned, and so are the finer W3C validity rules: a header is ignored (and behaves like no header) when its version is `ff`, when its trace-id or parent-id is all zero, or when any hex field is upper case (hex is lower case only). Only version `00` is pinned: the treatment of future versions (`01` to `fe`) and of reserved flag bits (for example `0a`, which some propagators reject for version `00`) is not pinned by this section. Pinning the producer side (that the header rides in the transport's own metadata channel beside the envelope, never inside it) needs a real transport and is covered by each SDK's own transport tests (R1 OTel plan, transport phases), not by this section.",
    "cases": [
      {
        "name": "valid-sampled",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "traceparent",
          "trace_id_hex": "4bf92f3577b34da6a3ce929d0e0e4736",
          "parent_span_id": "00f067aa0ba902b7",
          "flags": "01"
        }
      },
      {
        "name": "valid-not-sampled",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "traceparent",
          "trace_id_hex": "4bf92f3577b34da6a3ce929d0e0e4736",
          "parent_span_id": "00f067aa0ba902b7",
          "flags": "00"
        }
      },
      {
        "name": "header-wins-over-envelope-trace-id",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "traceparent",
          "trace_id_hex": "4bf92f3577b34da6a3ce929d0e0e4736",
          "parent_span_id": "00f067aa0ba902b7",
          "flags": "01"
        },
        "description": "The header's trace id is used even though the envelope trace_id differs; the envelope trace_id itself is untouched (GR-4)."
      },
      {
        "name": "no-header-falls-back-to-trace-id",
        "mode": "extract",
        "traceparent": null,
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        }
      },
      {
        "name": "empty-header-ignored",
        "mode": "extract",
        "traceparent": "",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        }
      },
      {
        "name": "garbage-ignored",
        "mode": "extract",
        "traceparent": "not-a-traceparent",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        }
      },
      {
        "name": "too-few-fields-ignored",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        }
      },
      {
        "name": "too-many-fields-ignored",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01-extra",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        }
      },
      {
        "name": "short-trace-id-ignored",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e47-00f067aa0ba902b7-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        }
      },
      {
        "name": "long-trace-id-ignored",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736ab-00f067aa0ba902b7-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        }
      },
      {
        "name": "short-parent-id-ignored",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        }
      },
      {
        "name": "non-hex-trace-id-ignored",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e473g-00f067aa0ba902b7-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        }
      },
      {
        "name": "non-hex-parent-id-ignored",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902bz-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        }
      },
      {
        "name": "short-flags-ignored",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-1",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        }
      },
      {
        "name": "version-ff-ignored",
        "mode": "extract",
        "traceparent": "ff-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        },
        "description": "Version `ff` is invalid per W3C Trace Context: the header is ignored and behaves like no header."
      },
      {
        "name": "zero-trace-id-ignored",
        "mode": "extract",
        "traceparent": "00-00000000000000000000000000000000-00f067aa0ba902b7-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        },
        "description": "An all-zero trace-id is invalid per W3C Trace Context: the header is ignored."
      },
      {
        "name": "zero-parent-id-ignored",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-0000000000000000-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        },
        "description": "An all-zero parent-id is invalid per W3C Trace Context: the header is ignored."
      },
      {
        "name": "uppercase-trace-id-ignored",
        "mode": "extract",
        "traceparent": "00-4BF92F3577B34DA6A3CE929D0E0E4736-00f067aa0ba902b7-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        },
        "description": "W3C Trace Context allows lower-case hex only: an upper-case trace-id makes the header invalid."
      },
      {
        "name": "uppercase-parent-id-ignored",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00F067AA0BA902B7-01",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        },
        "description": "An upper-case parent-id makes the header invalid."
      },
      {
        "name": "uppercase-flags-ignored",
        "mode": "extract",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-0A",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "source": "trace_id",
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b"
        },
        "description": "Upper-case flags make the header invalid."
      }
    ]
  },
  "redis_layout": {
    "description": "Redis key names in the Laravel-compatible layout (broker-bindings.md \u00a71.1). Scope: `redis`. For each case, with the transport in its Laravel-compatible layout and `key_prefix` the Laravel default, the keys used for the logical `queue` MUST equal `expect`: `ready` (list), `delayed` (sorted set, scored by available-at), `reserved` (sorted set, scored by the retry-after deadline), `notify` (blocking-pop wake-up). The names in `cases` are pinned without a broker (no Redis needed). Conformance 1.6.0 adds the behavioural blocks below (ADR-0033, ADR-0034; broker-bindings.md \u00a71.1, \u00a71.6, \u00a71.7); a deviation from the section 1.1 layout (for example a transport that ships only a `<queue>:processing` reliable-queue layout) is an SDK bug to be fixed in that SDK's phase, not a reason to skip: no ADR authorises a skip here. Behavioural blocks (live Redis): `delayed_score`, `migrate`, `reserve`, `pcall_poison`, `release` (zset layout, \u00a71.1/\u00a71.6/\u00a71.7) and `processing_sweep`, `processing_token`, `late_ack`, `identical_copies`, `retry_after_null`, `lrem_count`, `malformed_member`, `orphan`, `legacy_release_gate`, `legacy_dlq_gate` (legacy `:processing` layout, \u00a71.7). RUNNER CONTRACT: the cases in `cases` need no Redis; every behavioural block needs a live Redis (the CI service container is `redis:7`). When the environment variable `BQ_REQUIRE_REDIS` is set, a runner that cannot reach Redis MUST FAIL (not skip); when it is unset the runner skips the behavioural blocks and logs that it did. Each SDK's Redis transport CI sets `BQ_REQUIRE_REDIS` together with a `redis:7` service container. CASE DSL: a behavioural case has `layout` (`zset` or `legacy`), `queue`, `retry_after` (seconds; JSON null = disabled), optional `migration_batch_size`, an initial `state`, and ordered `steps`. Each step is `{op, now, ..., as?, expect?}`, `now` being the clock the SDK must use (fractional epoch seconds; the runner pins the clock or passes it in). Ops: `push_delayed` (`delay`, `body`: the SDK's delayed push), `migrate` (the \u00a71.6 migrate, as run before a reserve), `reserve` (stores the reservation under `as`), `release` (`reservation`, `delay`), `ack` (`reservation`), `sweep` (the legacy \u00a71.7 sweep alone), `dead_letter` (`reservation`; the SDK's legacy-layout DLQ write, behind the same gate as release; `release` in the legacy layout is used with `delay: 0`). A `reservation` is an `as` name or an explicit `{token, raw}`. A reserve step may expect `outcome` (`delivered`, `empty` or `poison`), `handler_body` (the raw member exactly as the handler receives it) and `reported_attempts`. `state` and `expect` describe keys: zset layout `ready` (list of members, oldest first), `delayed` / `reserved` (lists of `{member, score}`, or `{member_json, score}` / `{body_json, score}` compared as parsed JSON because the reserve Lua re-encodes with cjson and the release body is SDK-encoded), `notify` (token count); `ready_generate` / `delayed_generate` `{count, member: \"item-%03d\", score}` expand to that many members; legacy layout `ready`, `processing` (list), `deadlines` (entries `{token, raw, score}` meaning member `<token>:<raw>`, or `{member, score}` for a verbatim member). A `token` of `\"<any>\"` matches any 32 lowercase hex characters (a new reservation's member is token + \":\" + raw; `tokens_distinct: true` also requires pairwise distinct tokens). A score of the string `\"+inf\"` is positive infinity. `expect` may also hold the counts `ready_count` (LLEN of the ready list `<queue>`) and `dlq_count` (LLEN of `<queue>.dlq`), used where the SDK-built body is not pinned (`legacy_release_gate`, `legacy_dlq_gate`). A key absent from `expect` is not asserted, and the DLQ key's content and the notify handling after a poison pop are deliberately not pinned. Members are compared byte for byte unless suffixed `_json`. Delayed-score formula: the same function as the `redis_delay` section (that section pins it over more inputs). Notes: the release body `attempts` is the raw body's `attempts` + 1 (equal to the count in the `:reserved` member), unknown keys and types and the `{}` / `[]` distinction are preserved (ADR-0031), the cjson-re-encoded `:reserved` member is exempt from byte-identity; the chunk size 100 of the migrate is observable only as completeness (the 250-item case), the SDK-visible `migration_batch_size` knob is tested with a small value.",
    "cases": [
      {
        "name": "simple-queue",
        "queue": "orders",
        "key_prefix": "queues:",
        "expect": {
          "ready": "queues:orders",
          "delayed": "queues:orders:delayed",
          "reserved": "queues:orders:reserved",
          "notify": "queues:orders:notify"
        }
      },
      {
        "name": "dotted-queue",
        "queue": "emails.high",
        "key_prefix": "queues:",
        "expect": {
          "ready": "queues:emails.high",
          "delayed": "queues:emails.high:delayed",
          "reserved": "queues:emails.high:reserved",
          "notify": "queues:emails.high:notify"
        }
      },
      {
        "name": "mixed-case-queue",
        "queue": "Billing_Retry-1",
        "key_prefix": "queues:",
        "expect": {
          "ready": "queues:Billing_Retry-1",
          "delayed": "queues:Billing_Retry-1:delayed",
          "reserved": "queues:Billing_Retry-1:reserved",
          "notify": "queues:Billing_Retry-1:notify"
        }
      }
    ],
    "delayed_score": {
      "description": "Delayed score (broker-bindings.md \u00a71.6): score = `floor(now) + ceil(delay)`, integer epoch seconds, fractional `now` and `delay` allowed (the example `now = 1000.7`, `delay = 1.5` gives `1002`). The same formula is pinned over more inputs by the `redis_delay` section (that one needs no Redis; this block checks it against a live server).",
      "cases": [
        {
          "name": "fractional-now-fractional-delay",
          "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
          "layout": "zset",
          "queue": "orders",
          "state": {
            "notify": 0
          },
          "steps": [
            {
              "op": "push_delayed",
              "now": 1000.7,
              "delay": 1.5,
              "body": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}",
              "expect": {
                "delayed": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}",
                    "score": 1002
                  }
                ],
                "notify": 0,
                "ready": []
              }
            }
          ]
        },
        {
          "name": "integer-now-integer-delay",
          "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
          "layout": "zset",
          "queue": "orders",
          "state": {
            "notify": 0
          },
          "steps": [
            {
              "op": "push_delayed",
              "now": 1000.0,
              "delay": 5,
              "body": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}",
              "expect": {
                "delayed": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}",
                    "score": 1005
                  }
                ],
                "notify": 0,
                "ready": []
              }
            }
          ]
        },
        {
          "name": "sub-second-delay-rounds-up",
          "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
          "layout": "zset",
          "queue": "orders",
          "state": {
            "notify": 0
          },
          "steps": [
            {
              "op": "push_delayed",
              "now": 1000.2,
              "delay": 0.1,
              "body": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}",
              "expect": {
                "delayed": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}",
                    "score": 1001
                  }
                ],
                "notify": 0,
                "ready": []
              }
            }
          ]
        },
        {
          "name": "fractional-now-integer-delay-floors-now",
          "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
          "layout": "zset",
          "queue": "orders",
          "state": {
            "notify": 0
          },
          "steps": [
            {
              "op": "push_delayed",
              "now": 1000.9,
              "delay": 2,
              "body": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}",
              "expect": {
                "delayed": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}",
                    "score": 1002
                  }
                ],
                "notify": 0,
                "ready": []
              }
            }
          ]
        }
      ]
    },
    "migrate": {
      "description": "Migrate (\u00a71.6, \u00a71.7): due `:delayed` items (`score <= floor(now)`) then expired `:reserved` items move to `<q>` byte for byte, one notify token per moved item; unexpired items stay; `retry_after: null` skips the `:reserved` recovery; reserve migrates before it pops.",
      "cases": [
        {
          "name": "due-delayed-moves-rest-stays",
          "source": "broker-bindings.md \u00a71.6 (Migrate: :delayed then :reserved, chunks of 100, one notify token per item)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"x\"}"
            ],
            "delayed": [
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
                "score": 1000
              },
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"b\"}",
                "score": 1001
              },
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"c\"}",
                "score": 1002
              }
            ],
            "notify": 0
          },
          "steps": [
            {
              "op": "migrate",
              "now": 1001.9,
              "expect": {
                "ready": [
                  "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"x\"}",
                  "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
                  "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"b\"}"
                ],
                "delayed": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"c\"}",
                    "score": 1002
                  }
                ],
                "notify": 2
              }
            }
          ]
        },
        {
          "name": "score-equal-to-floor-now-is-due",
          "source": "broker-bindings.md \u00a71.6 (Migrate: :delayed then :reserved, chunks of 100, one notify token per item)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "delayed": [
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
                "score": 1000
              }
            ],
            "notify": 0
          },
          "steps": [
            {
              "op": "migrate",
              "now": 1000.999,
              "expect": {
                "ready": [
                  "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}"
                ],
                "delayed": [],
                "notify": 1
              }
            }
          ]
        },
        {
          "name": "not-yet-due-stays",
          "source": "broker-bindings.md \u00a71.6 (Migrate: :delayed then :reserved, chunks of 100, one notify token per item)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "delayed": [
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
                "score": 1001
              }
            ],
            "notify": 0
          },
          "steps": [
            {
              "op": "migrate",
              "now": 1000.99,
              "expect": {
                "ready": [],
                "delayed": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
                    "score": 1001
                  }
                ],
                "notify": 0
              }
            }
          ]
        },
        {
          "name": "delayed-first-then-reserved",
          "source": "broker-bindings.md \u00a71.6 (Migrate: :delayed then :reserved, chunks of 100, one notify token per item)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "delayed": [
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
                "score": 1000
              }
            ],
            "reserved": [
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"z\":1,\"a\":[ ]}}",
                "score": 1000
              }
            ],
            "notify": 0
          },
          "steps": [
            {
              "op": "migrate",
              "now": 1000,
              "expect": {
                "ready": [
                  "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
                  "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"z\":1,\"a\":[ ]}}"
                ],
                "delayed": [],
                "reserved": [],
                "notify": 2
              }
            }
          ]
        },
        {
          "name": "recovered-reserved-member-moves-byte-for-byte",
          "source": "broker-bindings.md \u00a71.7 (retry_after, zset-layout recovery)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "reserved": [
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"z\":1,\"a\":[ ]}}",
                "score": 900
              }
            ],
            "notify": 0
          },
          "steps": [
            {
              "op": "migrate",
              "now": 1000,
              "expect": {
                "ready": [
                  "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"z\":1,\"a\":[ ]}}"
                ],
                "reserved": [],
                "notify": 1
              }
            }
          ]
        },
        {
          "name": "unexpired-reserved-stays",
          "source": "broker-bindings.md \u00a71.7 (retry_after, zset-layout recovery)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "reserved": [
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"z\":1,\"a\":[ ]}}",
                "score": 1090
              }
            ],
            "notify": 0
          },
          "steps": [
            {
              "op": "migrate",
              "now": 1000,
              "expect": {
                "ready": [],
                "reserved": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"z\":1,\"a\":[ ]}}",
                    "score": 1090
                  }
                ],
                "notify": 0
              }
            }
          ]
        },
        {
          "name": "bulk-250-moves-all-with-one-notify-each",
          "source": "broker-bindings.md \u00a71.6 (Migrate: :delayed then :reserved, chunks of 100, one notify token per item)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "delayed_generate": {
              "count": 250,
              "member": "item-%03d",
              "score": 1000
            },
            "notify": 0
          },
          "steps": [
            {
              "op": "migrate",
              "now": 1000,
              "expect": {
                "ready_generate": {
                  "count": 250,
                  "member": "item-%03d"
                },
                "delayed": [],
                "notify": 250
              }
            }
          ]
        },
        {
          "name": "migration-batch-size-limits-one-migrate",
          "source": "broker-bindings.md \u00a71.6 (Migrate: :delayed then :reserved, chunks of 100, one notify token per item)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "migration_batch_size": 2,
          "state": {
            "delayed": [
              {
                "member": "m1",
                "score": 1000
              },
              {
                "member": "m2",
                "score": 1000
              },
              {
                "member": "m3",
                "score": 1000
              },
              {
                "member": "m4",
                "score": 1000
              },
              {
                "member": "m5",
                "score": 1000
              }
            ],
            "notify": 0
          },
          "steps": [
            {
              "op": "migrate",
              "now": 1000,
              "expect": {
                "ready": [
                  "m1",
                  "m2"
                ],
                "delayed": [
                  {
                    "member": "m3",
                    "score": 1000
                  },
                  {
                    "member": "m4",
                    "score": 1000
                  },
                  {
                    "member": "m5",
                    "score": 1000
                  }
                ],
                "notify": 2
              }
            }
          ]
        },
        {
          "name": "retry-after-null-skips-reserved-migrate",
          "source": "broker-bindings.md \u00a71.7 (retry_after, zset-layout recovery)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": null,
          "state": {
            "delayed": [
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
                "score": 1000
              }
            ],
            "reserved": [
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"z\":1,\"a\":[ ]}}",
                "score": 1000
              }
            ],
            "notify": 0
          },
          "steps": [
            {
              "op": "migrate",
              "now": 1000,
              "expect": {
                "ready": [
                  "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}"
                ],
                "delayed": [],
                "reserved": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"z\":1,\"a\":[ ]}}",
                    "score": 1000
                  }
                ],
                "notify": 1
              }
            }
          ]
        },
        {
          "name": "reserve-migrates-delayed-before-popping",
          "source": "broker-bindings.md \u00a71.6 (Migrate: :delayed then :reserved, chunks of 100, one notify token per item)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "delayed": [
              {
                "member": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
                "score": 1000
              }
            ],
            "notify": 0
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000.5,
              "expect": {
                "outcome": "delivered",
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
                "ready": [],
                "delayed": [],
                "notify": 0
              }
            }
          ]
        }
      ]
    },
    "reserve": {
      "description": "Reserve (\u00a71.1 reserve Lua): the raw member reaches the handler byte for byte, the `:reserved` member carries `attempts + 1`, deadline = `floor(now) + retry_after`, one `:notify` token is consumed.",
      "cases": [
        {
          "name": "attempts-0-to-1-raw-to-handler",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua: deadline is whole epoch seconds, floor(now) + retry_after, matching Laravel's availableAt()); ADR-0033 \u00a72",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000.4,
              "expect": {
                "outcome": "delivered",
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}",
                "reported_attempts": 1,
                "reserved": [
                  {
                    "member_json": {
                      "job": "urn:bq:orders:created",
                      "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
                      "data": {
                        "order_id": 1042
                      },
                      "meta": {
                        "id": "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
                        "queue": "orders",
                        "lang": "php",
                        "schema_version": 1,
                        "created_at": 1749132727000
                      },
                      "attempts": 1
                    },
                    "score": 1090
                  }
                ],
                "ready": [],
                "notify": 0
              }
            }
          ]
        },
        {
          "name": "attempts-2-to-3-unknown-keys-in-reserved-member",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua, ack, release - zset layout)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":2,\"x_ext\":{\"k\":[1,2]},\"x_flag\":true}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "delivered",
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":2,\"x_ext\":{\"k\":[1,2]},\"x_flag\":true}",
                "reported_attempts": 3,
                "reserved": [
                  {
                    "member_json": {
                      "job": "urn:bq:orders:created",
                      "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
                      "data": {
                        "order_id": 1042
                      },
                      "meta": {
                        "id": "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
                        "queue": "orders",
                        "lang": "php",
                        "schema_version": 1,
                        "created_at": 1749132727000
                      },
                      "attempts": 3,
                      "x_ext": {
                        "k": [
                          1,
                          2
                        ]
                      },
                      "x_flag": true
                    },
                    "score": 1090
                  }
                ],
                "ready": [],
                "notify": 0
              }
            }
          ]
        },
        {
          "name": "deadline-is-floor-now-plus-retry-after",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua: deadline is whole epoch seconds, floor(now) + retry_after, matching Laravel's availableAt()); ADR-0033 \u00a72",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 30,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000.9,
              "expect": {
                "reserved": [
                  {
                    "member_json": {
                      "job": "urn:bq:orders:created",
                      "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
                      "data": {
                        "order_id": 1042
                      },
                      "meta": {
                        "id": "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
                        "queue": "orders",
                        "lang": "php",
                        "schema_version": 1,
                        "created_at": 1749132727000
                      },
                      "attempts": 1
                    },
                    "score": 1030
                  }
                ]
              }
            }
          ]
        },
        {
          "name": "fifo-one-message-one-token",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua, ack, release - zset layout)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"b\"}"
            ],
            "notify": 2
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"a\"}",
                "ready": [
                  "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"b\"}"
                ],
                "notify": 1
              }
            }
          ]
        },
        {
          "name": "empty-queue-changes-nothing",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua, ack, release - zset layout)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "notify": 0
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "empty",
                "ready": [],
                "reserved": [],
                "notify": 0
              }
            }
          ]
        }
      ]
    },
    "pcall_poison": {
      "description": "A1 (\u00a71.1): a body the reserve Lua cannot decode (or whose `attempts` is not a number) MUST be written raw to `:reserved` and returned as `{job, job}`, i.e. delivered to the SDK as poison; the SDK then handles it as a poison message (DLQ record shape: ADR-0035, section `poison_dlq`). The `encode-fails-*` cases cover the SECOND `pcall`, around `cjson.encode` (ADR-0033 A1: nothing may fail after the `LPOP`): their body decodes (`attempts` is a number) so the decode `pcall` succeeds and the attempts increment runs, and only the re-encode fails. The input is a non-finite number literal inside `data`: Redis' bundled `cjson.decode` accepts `1e400` / `-1e400` (overflow to +/-inf), `NaN` and `Infinity`, while `cjson.encode` refuses to serialise a non-finite number, and this is the one generic way to make a decodable, well-formed envelope fail to re-encode. Without the `pcall` around the encode the script would abort after the `LPOP` and the message would be lost (Redis Lua has no rollback).",
      "cases": [
        {
          "name": "not-json",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "not-json"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "not-json",
                "reserved": [
                  {
                    "member": "not-json",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "empty-string",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              ""
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "",
                "reserved": [
                  {
                    "member": "",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "truncated-json",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"attempts\":"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":",
                "reserved": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "attempts-string",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"attempts\":\"3\"}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":\"3\"}",
                "reserved": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":\"3\"}",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "attempts-null",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"attempts\":null}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":null}",
                "reserved": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":null}",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "attempts-missing",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"data\":{}}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"data\":{}}",
                "reserved": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"data\":{}}",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "top-level-number",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "42"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "42",
                "reserved": [
                  {
                    "member": "42",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "top-level-string",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "\"text\""
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "\"text\"",
                "reserved": [
                  {
                    "member": "\"text\"",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "top-level-array",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "[]"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "[]",
                "reserved": [
                  {
                    "member": "[]",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "top-level-null",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "null"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "null",
                "reserved": [
                  {
                    "member": "null",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "encode-fails-positive-overflow",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1; the re-encode is also inside pcall)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":1e400}}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":1e400}}",
                "reserved": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":1e400}}",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "encode-fails-negative-overflow",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1; the re-encode is also inside pcall)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":-1e400}}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":-1e400}}",
                "reserved": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":-1e400}}",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "encode-fails-nan",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1; the re-encode is also inside pcall)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":NaN}}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":NaN}}",
                "reserved": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":NaN}}",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "encode-fails-infinity",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua MUST decode with pcall, A1; the re-encode is also inside pcall)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":Infinity}}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "expect": {
                "outcome": "poison",
                "handler_body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":Infinity}}",
                "reserved": [
                  {
                    "member": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":Infinity}}",
                    "score": 1090
                  }
                ],
                "ready": []
              }
            }
          ]
        }
      ]
    },
    "release": {
      "description": "Release (A2, \u00a71.1; ADR-0031): the item leaves `:reserved` and the SDK-encoded body (attempts + 1) goes to `:delayed` with score `floor(now) + ceil(delay)`; only `attempts` changes, unknown keys, their types and `{}` / `[]` are preserved.",
      "cases": [
        {
          "name": "attempts-0-to-1",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua, ack, release - zset layout)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000.3,
              "as": "r"
            },
            {
              "op": "release",
              "reservation": "r",
              "delay": 5,
              "now": 1000.3,
              "expect": {
                "reserved": [],
                "ready": [],
                "delayed": [
                  {
                    "body_json": {
                      "job": "urn:bq:orders:created",
                      "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
                      "data": {
                        "order_id": 1042
                      },
                      "meta": {
                        "id": "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
                        "queue": "orders",
                        "lang": "php",
                        "schema_version": 1,
                        "created_at": 1749132727000
                      },
                      "attempts": 1
                    },
                    "score": 1005
                  }
                ]
              }
            }
          ]
        },
        {
          "name": "attempts-2-to-3",
          "source": "broker-bindings.md \u00a71.1 (reserve Lua, ack, release - zset layout)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":2}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "as": "r"
            },
            {
              "op": "release",
              "reservation": "r",
              "delay": 30,
              "now": 1000,
              "expect": {
                "reserved": [],
                "ready": [],
                "delayed": [
                  {
                    "body_json": {
                      "job": "urn:bq:orders:created",
                      "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
                      "data": {
                        "order_id": 1042
                      },
                      "meta": {
                        "id": "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
                        "queue": "orders",
                        "lang": "php",
                        "schema_version": 1,
                        "created_at": 1749132727000
                      },
                      "attempts": 3
                    },
                    "score": 1030
                  }
                ]
              }
            }
          ]
        },
        {
          "name": "fractional-delay-rounds-up",
          "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000.7,
              "as": "r"
            },
            {
              "op": "release",
              "reservation": "r",
              "delay": 1.5,
              "now": 1000.7,
              "expect": {
                "reserved": [],
                "ready": [],
                "delayed": [
                  {
                    "body_json": {
                      "job": "urn:bq:orders:created",
                      "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
                      "data": {
                        "order_id": 1042
                      },
                      "meta": {
                        "id": "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
                        "queue": "orders",
                        "lang": "php",
                        "schema_version": 1,
                        "created_at": 1749132727000
                      },
                      "attempts": 1
                    },
                    "score": 1002
                  }
                ]
              }
            }
          ]
        },
        {
          "name": "unknown-keys-types-and-empty-containers-preserved",
          "source": "ADR-0031 via broker-bindings.md \u00a71.1 (release body is SDK-encoded)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":1,\"x_flag\":true,\"x_nested\":{\"k\":[1,2.5,null],\"e\":{},\"l\":[]},\"x_empty_obj\":{},\"x_empty_arr\":[],\"x_text\":\"caf\u00e9 a/b \u2603\"}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "as": "r"
            },
            {
              "op": "release",
              "reservation": "r",
              "delay": 5,
              "now": 1000,
              "expect": {
                "reserved": [],
                "ready": [],
                "delayed": [
                  {
                    "body_json": {
                      "job": "urn:bq:orders:created",
                      "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
                      "data": {},
                      "meta": {
                        "id": "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
                        "queue": "orders",
                        "lang": "php",
                        "schema_version": 1,
                        "created_at": 1749132727000
                      },
                      "attempts": 2,
                      "x_flag": true,
                      "x_nested": {
                        "k": [
                          1,
                          2.5,
                          null
                        ],
                        "e": {},
                        "l": []
                      },
                      "x_empty_obj": {},
                      "x_empty_arr": [],
                      "x_text": "caf\u00e9 a/b \u2603"
                    },
                    "score": 1005
                  }
                ]
              }
            }
          ]
        },
        {
          "name": "15-digit-integer-not-exponent-encoded",
          "source": "ADR-0031 via broker-bindings.md \u00a71.1 (the cjson exception covers only the :reserved member, not the SDK-encoded release body)",
          "layout": "zset",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"x_big\":123456789012345}"
            ],
            "notify": 1
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "as": "r"
            },
            {
              "op": "release",
              "reservation": "r",
              "delay": 5,
              "now": 1000,
              "expect": {
                "reserved": [],
                "ready": [],
                "delayed": [
                  {
                    "body_json": {
                      "job": "urn:bq:orders:created",
                      "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
                      "data": {
                        "order_id": 1042
                      },
                      "meta": {
                        "id": "f1e2d3c4-b5a6-4789-90ab-cdef01234567",
                        "queue": "orders",
                        "lang": "php",
                        "schema_version": 1,
                        "created_at": 1749132727000
                      },
                      "attempts": 1,
                      "x_big": 123456789012345
                    },
                    "score": 1005
                  }
                ]
              }
            }
          ]
        }
      ]
    },
    "processing_sweep": {
      "description": "Legacy `:processing` sweep (S1 / C1-c, \u00a71.7): only members whose deadline is expired move, to the END of `<q>`, byte for byte with `attempts` unchanged; unexpired and deadline-less items stay.",
      "cases": [
        {
          "name": "expired-moves-unexpired-and-deadlineless-stay",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"ready0\"}"
            ],
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
              "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"id\":2}}",
              "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"id\":3}}"
            ],
            "deadlines": [
              {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 1000
              },
              {
                "token": "fedcba9876543210fedcba9876543210",
                "raw": "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"id\":2}}",
                "score": 1001
              }
            ]
          },
          "steps": [
            {
              "op": "sweep",
              "now": 1000.6,
              "expect": {
                "ready": [
                  "{\"job\":\"urn:bq:orders:created\",\"trace_id\":\"7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\",\"data\":{\"order_id\":1042},\"meta\":{\"id\":\"f1e2d3c4-b5a6-4789-90ab-cdef01234567\",\"queue\":\"orders\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1749132727000},\"attempts\":0,\"n\":\"ready0\"}",
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "processing": [
                  "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"id\":2}}",
                  "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"id\":3}}"
                ],
                "deadlines": [
                  {
                    "token": "fedcba9876543210fedcba9876543210",
                    "raw": "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"id\":2}}",
                    "score": 1001
                  }
                ]
              }
            }
          ]
        },
        {
          "name": "recovery-keeps-attempts-and-bytes",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ],
            "deadlines": [
              {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 900
              }
            ]
          },
          "steps": [
            {
              "op": "sweep",
              "now": 1000,
              "expect": {
                "ready": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "processing": [],
                "deadlines": []
              }
            }
          ]
        },
        {
          "name": "batch-size-limits-one-sweep",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "migration_batch_size": 1,
          "state": {
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
              "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"id\":2}}"
            ],
            "deadlines": [
              {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 900
              },
              {
                "token": "fedcba9876543210fedcba9876543210",
                "raw": "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"id\":2}}",
                "score": 901
              }
            ]
          },
          "steps": [
            {
              "op": "sweep",
              "now": 1000,
              "expect": {
                "ready": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "processing": [
                  "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"id\":2}}"
                ],
                "deadlines": [
                  {
                    "token": "fedcba9876543210fedcba9876543210",
                    "raw": "{\"job\":\"urn:bq:orders:created\",\"attempts\":1,\"data\":{\"id\":2}}",
                    "score": 901
                  }
                ]
              }
            }
          ]
        },
        {
          "name": "sweep-runs-before-every-reserve",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ],
            "deadlines": [
              {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 900
              }
            ]
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "as": "r",
              "expect": {
                "outcome": "delivered",
                "handler_body": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "ready": [],
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "<any>",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": 1090
                  }
                ]
              }
            }
          ]
        }
      ]
    },
    "processing_token": {
      "description": "K1 member format (\u00a71.7): every reservation's deadline member is `<32 lowercase hex token>:<raw>`.",
      "cases": [
        {
          "name": "member-is-token-colon-raw",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ]
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "as": "r",
              "expect": {
                "handler_body": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "ready": [],
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "<any>",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": 1090
                  }
                ]
              }
            }
          ]
        }
      ]
    },
    "late_ack": {
      "description": "K1 late ack (\u00a71.7): acking with the token of a reservation that was already swept touches neither `:processing` nor the deadlines of the newer reservation.",
      "cases": [
        {
          "name": "ack-with-swept-token-touches-nothing",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 10,
          "state": {
            "ready": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ]
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "as": "first"
            },
            {
              "op": "sweep",
              "now": 1011,
              "expect": {
                "ready": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "processing": [],
                "deadlines": []
              }
            },
            {
              "op": "reserve",
              "now": 1011,
              "as": "second",
              "expect": {
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "<any>",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": 1021
                  }
                ]
              }
            },
            {
              "op": "ack",
              "reservation": "first",
              "now": 1012,
              "expect": {
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "<any>",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": 1021
                  }
                ]
              }
            },
            {
              "op": "ack",
              "reservation": "second",
              "now": 1013,
              "expect": {
                "processing": [],
                "deadlines": [],
                "ready": []
              }
            }
          ]
        }
      ]
    },
    "identical_copies": {
      "description": "K1 identical copies (\u00a71.7): two byte-identical messages get two distinct members; acking one never touches the other's member.",
      "cases": [
        {
          "name": "two-identical-copies-two-members",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "ready": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ]
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "as": "a"
            },
            {
              "op": "reserve",
              "now": 1000,
              "as": "b",
              "expect": {
                "ready": [],
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "<any>",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": 1090
                  },
                  {
                    "token": "<any>",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": 1090
                  }
                ],
                "tokens_distinct": true
              }
            },
            {
              "op": "ack",
              "reservation": "a",
              "now": 1001,
              "expect": {
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "<any>",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": 1090
                  }
                ]
              }
            },
            {
              "op": "ack",
              "reservation": "b",
              "now": 1002,
              "expect": {
                "processing": [],
                "deadlines": []
              }
            }
          ]
        }
      ]
    },
    "retry_after_null": {
      "description": "K1 `retry_after: null` (\u00a71.7): the deadline member is written with score `+inf`, the sweep never moves it, and ack leaves `:processing` and the deadlines empty.",
      "cases": [
        {
          "name": "member-score-plus-inf-never-swept",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": null,
          "state": {
            "ready": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ]
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000,
              "as": "r",
              "expect": {
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "<any>",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": "+inf"
                  }
                ]
              }
            },
            {
              "op": "sweep",
              "now": 9999999999,
              "expect": {
                "ready": [],
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "<any>",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": "+inf"
                  }
                ]
              }
            },
            {
              "op": "ack",
              "reservation": "r",
              "now": 9999999999,
              "expect": {
                "processing": [],
                "deadlines": [],
                "ready": []
              }
            }
          ]
        },
        {
          "name": "null-consumer-still-sweeps-foreign-expired-member",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count); \"null is not a kill switch\"",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": null,
          "state": {
            "ready": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 0, \"data\": {\"id\": 1}}"
            ],
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ],
            "deadlines": [
              {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 1000
              }
            ]
          },
          "steps": [
            {
              "op": "reserve",
              "now": 1000.6,
              "as": "r",
              "expect": {
                "handler_body": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 0, \"data\": {\"id\": 1}}",
                "ready": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 0, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "<any>",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 0, \"data\": {\"id\": 1}}",
                    "score": "+inf"
                  }
                ]
              }
            }
          ]
        }
      ]
    },
    "lrem_count": {
      "description": "K1 `LREM` count = 1 (\u00a71.7): with two byte-identical copies in `:processing`, an ack or a sweep removes exactly one copy.",
      "cases": [
        {
          "name": "ack-removes-exactly-one-of-two-identical-copies",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ],
            "deadlines": [
              {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 2000
              },
              {
                "token": "fedcba9876543210fedcba9876543210",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 2000
              }
            ]
          },
          "steps": [
            {
              "op": "ack",
              "reservation": {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
              },
              "now": 1000,
              "expect": {
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "fedcba9876543210fedcba9876543210",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": 2000
                  }
                ]
              }
            }
          ]
        },
        {
          "name": "sweep-removes-exactly-one-copy-per-expired-member",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ],
            "deadlines": [
              {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 900
              },
              {
                "token": "fedcba9876543210fedcba9876543210",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 2000
              }
            ]
          },
          "steps": [
            {
              "op": "sweep",
              "now": 1000,
              "expect": {
                "ready": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "fedcba9876543210fedcba9876543210",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": 2000
                  }
                ]
              }
            }
          ]
        }
      ]
    },
    "malformed_member": {
      "description": "K1 malformed member (\u00a71.7): a deadline member that does not match `<32-hex>:<raw>` is only `ZREM`ed; nothing is pushed back.",
      "cases": [
        {
          "name": "member-shorter-than-34-bytes-only-zrem",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ],
            "deadlines": [
              {
                "member": "short",
                "score": 900
              }
            ]
          },
          "steps": [
            {
              "op": "sweep",
              "now": 1000,
              "expect": {
                "ready": [],
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": []
              }
            }
          ]
        },
        {
          "name": "byte-33-not-colon-only-zrem",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ],
            "deadlines": [
              {
                "member": "0123456789abcdef0123456789abcdefx{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 900
              }
            ]
          },
          "steps": [
            {
              "op": "sweep",
              "now": 1000,
              "expect": {
                "ready": [],
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": []
              }
            }
          ]
        }
      ]
    },
    "orphan": {
      "description": "K1 orphan cleanup (\u00a71.7): an expired deadline whose `LREM` removes nothing is only `ZREM`ed; the message is not resurrected.",
      "cases": [
        {
          "name": "lrem-zero-only-zrem-no-resurrection",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count)",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "processing": [],
            "deadlines": [
              {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 900
              }
            ]
          },
          "steps": [
            {
              "op": "sweep",
              "now": 1000,
              "expect": {
                "ready": [],
                "processing": [],
                "deadlines": []
              }
            }
          ]
        }
      ]
    },
    "legacy_release_gate": {
      "description": "Legacy-layout release gate (broker-bindings.md \u00a71.7). A release carrying a reservation whose `<token>:<raw>` member is no longer in `:processing:deadlines` (swept or acked: a stale token) MUST touch nothing and log \"reservation expired\"; with the current token the member leaves `:processing` and `:processing:deadlines` and the body returns to the ready list in the same script. The pushed body, its position and its `attempts` are NOT pinned by the contract, hence the `ready_count` expectation (LLEN of the ready list).",
      "cases": [
        {
          "name": "stale-token-touches-nothing",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count); the gate: ZREM of <token>:<raw> first, 0 => touch nothing",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ],
            "deadlines": [
              {
                "token": "fedcba9876543210fedcba9876543210",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 2000
              }
            ]
          },
          "steps": [
            {
              "op": "release",
              "reservation": {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
              },
              "now": 1000,
              "expect": {
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "fedcba9876543210fedcba9876543210",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": 2000
                  }
                ],
                "ready_count": 0
              },
              "delay": 0
            }
          ]
        },
        {
          "name": "valid-token-moves-out-of-processing",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count); the gate: ZREM of <token>:<raw> first, 1 => LREM and the rest in the same script",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ],
            "deadlines": [
              {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 2000
              }
            ]
          },
          "steps": [
            {
              "op": "release",
              "reservation": {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
              },
              "now": 1000,
              "expect": {
                "processing": [],
                "deadlines": [],
                "ready_count": 1
              },
              "delay": 0
            }
          ]
        }
      ]
    },
    "legacy_dlq_gate": {
      "description": "Legacy-layout dead-letter gate (broker-bindings.md \u00a71.7). The same ZREM gate guards the DLQ write: with a stale token nothing is touched (neither `:processing` nor `<queue>.dlq` change); with the current token the member leaves `:processing` / `:processing:deadlines` and one entry is pushed to `<queue>.dlq` in the same script. The DLQ entry's content is not pinned by the contract, hence the `dlq_count` expectation (LLEN of `<queue>.dlq`).",
      "cases": [
        {
          "name": "stale-token-touches-nothing",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count); the gate: ZREM of <token>:<raw> first, 0 => touch nothing",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ],
            "deadlines": [
              {
                "token": "fedcba9876543210fedcba9876543210",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 2000
              }
            ]
          },
          "steps": [
            {
              "op": "dead_letter",
              "reservation": {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
              },
              "now": 1000,
              "expect": {
                "processing": [
                  "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
                ],
                "deadlines": [
                  {
                    "token": "fedcba9876543210fedcba9876543210",
                    "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                    "score": 2000
                  }
                ],
                "ready_count": 0,
                "dlq_count": 0
              }
            }
          ]
        },
        {
          "name": "valid-token-moves-out-of-processing",
          "source": "broker-bindings.md \u00a71.7 (Legacy layout - the :processing sweep: deadline member, gate, sweep Lua, orphans, count); the gate: ZREM of <token>:<raw> first, 1 => LREM and the rest in the same script",
          "layout": "legacy",
          "queue": "orders",
          "retry_after": 90,
          "state": {
            "processing": [
              "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
            ],
            "deadlines": [
              {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}",
                "score": 2000
              }
            ]
          },
          "steps": [
            {
              "op": "dead_letter",
              "reservation": {
                "token": "0123456789abcdef0123456789abcdef",
                "raw": "{\"job\": \"urn:bq:orders:created\",  \"attempts\": 2, \"data\": {\"id\": 1}}"
              },
              "now": 1000,
              "expect": {
                "processing": [],
                "deadlines": [],
                "ready_count": 0,
                "dlq_count": 1
              }
            }
          ]
        }
      ]
    }
  },
  "redis_delay": {
    "description": "Redis delayed-score formula (broker-bindings.md \u00a71.6; ADR-0033). Scope: `redis`. Pure and clock-pinned, no Redis needed: for each case the SDK's score function called with the given `now` (fractional epoch seconds) and `delay` (seconds, may be fractional) MUST return `expect_score` = `floor(now) + ceil(delay)` (integer epoch seconds). The 1.0-3.5 s wall-clock window of a live delayed publish is a measurement, not a fixture: it is checked by the SDK's own live test, not here. The SQS `DelaySeconds` cases stay in `delay`. The behavioural block `redis_layout.delayed_score` checks the same formula against a live Redis.",
    "cases": [
      {
        "name": "fractional-now-fractional-delay",
        "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
        "now": 1000.7,
        "delay": 1.5,
        "expect_score": 1002
      },
      {
        "name": "integer-now-integer-delay",
        "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
        "now": 1000.0,
        "delay": 5,
        "expect_score": 1005
      },
      {
        "name": "sub-second-delay-rounds-up",
        "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
        "now": 1000.2,
        "delay": 0.1,
        "expect_score": 1001
      },
      {
        "name": "fractional-now-integer-delay-floors-now",
        "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
        "now": 1000.9,
        "delay": 2,
        "expect_score": 1002
      },
      {
        "name": "just-below-next-second",
        "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
        "now": 1750000000.999,
        "delay": 0.001,
        "expect_score": 1750000001
      },
      {
        "name": "exact-integer-delay-not-rounded-up",
        "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
        "now": 1000.5,
        "delay": 3.0,
        "expect_score": 1003
      },
      {
        "name": "long-delay",
        "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
        "now": 1000.0,
        "delay": 3600,
        "expect_score": 4600
      },
      {
        "name": "fraction-just-over-integer-rounds-up",
        "source": "broker-bindings.md \u00a71.6 (Delay score = floor(now) + ceil(delay))",
        "now": 1000.0,
        "delay": 2.001,
        "expect_score": 1003
      }
    ]
  },
  "kafka_poison": {
    "description": "Kafka consumer-side body classification (ADR-0034 \u00a710, ADR-0032 \u00a76; broker-bindings.md \u00a76.5 terminal failure -> DLQ). Scope: `kafka`. Replaces the five vendored `poison-trigger-set.json` copies. For each case, feed `body` (a JSON string; it is the raw record value, so a case may hold invalid JSON, a BOM or duplicate keys) to the SDK core decoder and assert the verdict `expect`: `ok` - the body parses into the envelope and carries a valid identity; `no_identity` - the body parses (top-level JSON object or the literal `null`, every known member of the right type) but neither `job` nor `urn` is a valid identity; `poison` - the body cannot be decoded into the envelope (empty or invalid JSON, trailing data, a BOM, a non-finite or out-of-range number, a top-level value that is not an object, or a known member of the wrong type, including nested `meta.*`, `dead_letter.*`, integer-typed members that are fractional, exponent-form or overflowing). Identity rule (ADR-0032 \u00a76): a `job` that is not a string is ignored; a blank (empty or whitespace-only) string `job` falls back to `urn`; a `urn` that is not a non-blank string is ignored; when neither is valid the body has no identity. Duplicate top-level keys: the LAST value wins, then the identity rule applies (so `{\"job\":5,\"job\":\"urn:x\"}` is `ok` and `{\"job\":\"urn:x\",\"job\":5}` is `no_identity`). Member names are case-sensitive (`JOB` and `Meta` are unknown members). Unknown members and the forbidden envelope keys (message-envelope.md \u00a710) are not decode errors. On Kafka `no_identity` and `poison` have the same fate: the record goes to `<topic>.dlq` with `reason: poison` without calling the handler, so a runner tells the two apart with the core decoder and checks the fate through the transport. The old table's rows are kept (same names and bodies) but their expectations follow ADR-0032 \u00a76: old rows `{\"job\":5}` and `{\"job\":\"urn:x\",\"job\":5}` were `poison` and are now `no_identity` (a non-string `job` is ignored, it is not a type error), and the old row `duplicate job number then string` (`{\"job\":5,\"job\":\"urn:x\"}`) was `poison` and is now `ok` (the last duplicate wins, and it is a valid identity). Three old rows change in total. The first 78 cases keep the old table's order, names and bodies; the 14 cases after them are new in 1.6.0 (they pin the `job`/`urn` type rule and null optional members, which the old table did not cover).",
    "cases": [
      {
        "name": "empty",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "",
        "expect": "poison"
      },
      {
        "name": "whitespace only",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "   ",
        "expect": "poison"
      },
      {
        "name": "not json",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "not-json",
        "expect": "poison"
      },
      {
        "name": "truncated",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"job\":\"urn:a\"",
        "expect": "poison"
      },
      {
        "name": "empty array",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "[]",
        "expect": "poison"
      },
      {
        "name": "array",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "[1]",
        "expect": "poison"
      },
      {
        "name": "string",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "\"str\"",
        "expect": "poison"
      },
      {
        "name": "number",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "123",
        "expect": "poison"
      },
      {
        "name": "boolean",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "true",
        "expect": "poison"
      },
      {
        "name": "null literal",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "null",
        "expect": "no_identity"
      },
      {
        "name": "empty object",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{}",
        "expect": "no_identity"
      },
      {
        "name": "full valid",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"job\":\"urn:babel:orders:created\",\"trace_id\":\"t\",\"data\":{},\"meta\":{\"id\":\"i\",\"queue\":\"q\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1700000000000},\"attempts\":0}",
        "expect": "ok"
      },
      {
        "name": "job number",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"job\":5}",
        "expect": "no_identity"
      },
      {
        "name": "job null",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"job\":null}",
        "expect": "no_identity"
      },
      {
        "name": "urn alias number",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"urn\":5}",
        "expect": "no_identity"
      },
      {
        "name": "urn alias string",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"urn\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "urn alias padded",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"urn\":\"  urn:x  \"}",
        "expect": "ok"
      },
      {
        "name": "trace_id number",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"trace_id\":7}",
        "expect": "poison"
      },
      {
        "name": "data array",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"data\":[]}",
        "expect": "poison"
      },
      {
        "name": "data string",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"data\":\"x\"}",
        "expect": "poison"
      },
      {
        "name": "data null",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"data\":null}",
        "expect": "no_identity"
      },
      {
        "name": "meta string",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":\"x\"}",
        "expect": "poison"
      },
      {
        "name": "meta array",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":[]}",
        "expect": "poison"
      },
      {
        "name": "meta null",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"meta\":null}",
        "expect": "no_identity"
      },
      {
        "name": "meta.id number",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":{\"id\":5}}",
        "expect": "poison"
      },
      {
        "name": "meta.queue number",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":{\"queue\":5}}",
        "expect": "poison"
      },
      {
        "name": "meta.lang boolean",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":{\"lang\":true}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at string",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":{\"created_at\":\"2026\"}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at fractional",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":{\"created_at\":1.5}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at integer",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"meta\":{\"created_at\":1700000000000}}",
        "expect": "no_identity"
      },
      {
        "name": "meta.created_at exponent",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":{\"created_at\":1e3}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at decimal zero",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":{\"created_at\":1.0}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at int64 overflow",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":{\"created_at\":9223372036854775808}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at int64 max",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"meta\":{\"created_at\":9223372036854775807}}",
        "expect": "no_identity"
      },
      {
        "name": "meta.created_at negative",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"meta\":{\"created_at\":-1}}",
        "expect": "no_identity"
      },
      {
        "name": "meta.created_at negative zero",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"meta\":{\"created_at\":-0}}",
        "expect": "no_identity"
      },
      {
        "name": "meta.schema_version string",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":{\"schema_version\":\"1\"}}",
        "expect": "poison"
      },
      {
        "name": "meta.schema_version two",
        "source": "ADR-0032 \u00a76 (no valid job/urn); the meta.schema_version value gate is a separate check, see broker-bindings.md \u00a76.7",
        "body": "{\"meta\":{\"schema_version\":2}}",
        "expect": "no_identity"
      },
      {
        "name": "meta.schema_version decimal zero",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":{\"schema_version\":1.0}}",
        "expect": "poison"
      },
      {
        "name": "meta.schema_version null",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"meta\":{\"schema_version\":null}}",
        "expect": "no_identity"
      },
      {
        "name": "meta.schema_version boolean",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"meta\":{\"schema_version\":true}}",
        "expect": "poison"
      },
      {
        "name": "attempts fractional",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"attempts\":1.5}",
        "expect": "poison"
      },
      {
        "name": "attempts string",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"attempts\":\"3\"}",
        "expect": "poison"
      },
      {
        "name": "attempts integer",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"attempts\":2}",
        "expect": "no_identity"
      },
      {
        "name": "attempts exponent",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"attempts\":1e0}",
        "expect": "poison"
      },
      {
        "name": "attempts upper exponent",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"attempts\":1E2}",
        "expect": "poison"
      },
      {
        "name": "attempts negative zero",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"attempts\":-0}",
        "expect": "no_identity"
      },
      {
        "name": "attempts overflow",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"attempts\":9223372036854775808}",
        "expect": "poison"
      },
      {
        "name": "attempts null",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"attempts\":null}",
        "expect": "no_identity"
      },
      {
        "name": "dead_letter string",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"dead_letter\":\"x\"}",
        "expect": "poison"
      },
      {
        "name": "dead_letter null",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"dead_letter\":null}",
        "expect": "no_identity"
      },
      {
        "name": "dead_letter empty object",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"dead_letter\":{}}",
        "expect": "no_identity"
      },
      {
        "name": "dead_letter.attempts string",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"dead_letter\":{\"attempts\":\"3\"}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.reason number",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"dead_letter\":{\"reason\":5}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.error number",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"dead_letter\":{\"error\":5}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter nullable strings",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"dead_letter\":{\"error\":null,\"exception\":null}}",
        "expect": "no_identity"
      },
      {
        "name": "dead_letter.failed_at string",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"dead_letter\":{\"failed_at\":\"x\"}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.failed_at fractional",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"dead_letter\":{\"failed_at\":1.5}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.original_queue array",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"dead_letter\":{\"original_queue\":[]}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.lang object",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"dead_letter\":{\"lang\":{}}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter full",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"dead_letter\":{\"error\":\"e\",\"exception\":\"x\",\"failed_at\":1,\"original_queue\":\"q\",\"attempts\":1,\"lang\":\"go\",\"reason\":\"r\"}}",
        "expect": "no_identity"
      },
      {
        "name": "upper-case job key with number is an unknown member (names are case-sensitive)",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"JOB\":5}",
        "expect": "no_identity"
      },
      {
        "name": "mixed-case meta.id key with number is an unknown member (names are case-sensitive)",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"Meta\":{\"ID\":5}}",
        "expect": "no_identity"
      },
      {
        "name": "upper-case job key with string",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"JOB\":\"urn:x\"}",
        "expect": "no_identity"
      },
      {
        "name": "trailing garbage",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"job\":\"x\"} trailing",
        "expect": "poison"
      },
      {
        "name": "two objects",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"job\":\"x\"}{\"job\":\"y\"}",
        "expect": "poison"
      },
      {
        "name": "unknown keys",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"x\":1}",
        "expect": "no_identity"
      },
      {
        "name": "forbidden keys with odd types",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"timestamp\":\"x\",\"meta\":{\"max_retries\":\"x\",\"attempts\":\"y\",\"source\":5,\"ts\":\"z\"}}",
        "expect": "no_identity"
      },
      {
        "name": "nested lookalikes in data",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"data\":{\"a\":[1,2,{\"b\":null}],\"meta\":5,\"job\":5},\"extra\":{\"meta\":5}}",
        "expect": "no_identity"
      },
      {
        "name": "duplicate job string then number",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"job\":\"urn:x\",\"job\":5}",
        "expect": "no_identity"
      },
      {
        "name": "duplicate job number then string",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"job\":5,\"job\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "byte order mark",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "\ufeff{\"job\":\"x\"}",
        "expect": "poison"
      },
      {
        "name": "leading zero number",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"attempts\":01}",
        "expect": "poison"
      },
      {
        "name": "NaN literal",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"attempts\":NaN}",
        "expect": "poison"
      },
      {
        "name": "single quotes",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{'a':1}",
        "expect": "poison"
      },
      {
        "name": "meta duplicate-case key",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"meta\":{\"id\":\"a\",\"queue\":\"b\",\"lang\":\"c\",\"schema_version\":1,\"created_at\":1,\"ID\":\"dup\"}}",
        "expect": "no_identity"
      },
      {
        "name": "attempts huge exponent",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"attempts\":1e400}",
        "expect": "poison"
      },
      {
        "name": "data with huge number",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"data\":{\"n\":1e400}}",
        "expect": "poison"
      },
      {
        "name": "job number with valid urn alias",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"job\":5,\"urn\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "job blank with valid urn alias",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"job\":\"  \",\"urn\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "job valid with urn number",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"job\":\"urn:x\",\"urn\":5}",
        "expect": "ok"
      },
      {
        "name": "job blank without urn",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"job\":\"  \"}",
        "expect": "no_identity"
      },
      {
        "name": "job and urn both empty strings",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"job\":\"\",\"urn\":\"\"}",
        "expect": "no_identity"
      },
      {
        "name": "job and urn both arrays",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"job\":[],\"urn\":[]}",
        "expect": "no_identity"
      },
      {
        "name": "job object without urn",
        "source": "ADR-0032 \u00a76 via broker-bindings.md \u00a76.5 (no valid job/urn identity -> DLQ with reason poison on Kafka)",
        "body": "{\"job\":{}}",
        "expect": "no_identity"
      },
      {
        "name": "identity with null data",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"job\":\"urn:x\",\"data\":null}",
        "expect": "ok"
      },
      {
        "name": "identity with null meta",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"job\":\"urn:x\",\"meta\":null}",
        "expect": "ok"
      },
      {
        "name": "identity with null attempts",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"job\":\"urn:x\",\"attempts\":null}",
        "expect": "ok"
      },
      {
        "name": "identity with null dead_letter",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"job\":\"urn:x\",\"dead_letter\":null}",
        "expect": "ok"
      },
      {
        "name": "identity with integer attempts",
        "source": "ADR-0032 \u00a76 (valid job or urn identity) via broker-bindings.md \u00a76.5",
        "body": "{\"job\":\"urn:x\",\"attempts\":2}",
        "expect": "ok"
      },
      {
        "name": "identity with wrong typed attempts",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"job\":\"urn:x\",\"attempts\":\"3\"}",
        "expect": "poison"
      },
      {
        "name": "identity with wrong typed data",
        "source": "broker-bindings.md \u00a76.5 (terminal failure -> DLQ with reason poison); body is not a decodable envelope",
        "body": "{\"job\":\"urn:x\",\"data\":[]}",
        "expect": "poison"
      }
    ]
  },
  "poison_dlq": {
    "description": "Poison DLQ record shape (ADR-0035; error-handling.md section 6 \"Poison record shape\"; Scope: `core`, because the shape is the same for every binding). For each case, take the raw record body (`body`, a JSON string holding the text, or `body_base64`, the standard base64 of the exact bytes where the body is not valid UTF-8, since a JSON string cannot carry such bytes), dead-letter it as poison with `original_queue` `orders`, and parse the DLQ record the SDK would write. Assert: (1) the record is a JSON object with a top-level `dead_letter` object whose `reason` is `poison` and `original_queue` is `orders` (the other `dead_letter` members are SDK-specific and not compared); (2) REMOVING `dead_letter`, the rest of the record equals `expect.record` as parsed JSON (never as bytes) - an exact equality, so `raw_encoding` MUST be absent when `expect.record` has no such key; for a `splice_or_wrapper` case the record is EITHER the wrapper `expect.record` OR a byte-level splice that passes three structural checks: (a) the record text contains each `expect.splice_literals` entry verbatim, (b) the record has no top-level `raw` or `raw_encoding` member, and (c) its distinct top-level member names, other than the single `dead_letter`, compared as a set, equal the set `expect.splice_keys` (the body's own distinct top-level member names: order and repeats do not matter, so a body that repeats a top-level name lists it once and a scanner that reports it twice still matches; a runner whose parser cannot represent a value reads them with a tolerant scanner). The rest of the parsed form is not compared, because a conforming splice holds a value the runner's own parser may not represent, or a repeated member that a parser collapses. `expect.shape`: `splice` - the body is valid UTF-8, a single strict RFC 8259 JSON object (no `NaN` / `Infinity` / `-Infinity` literal, no unpaired surrogate escape) and has no top-level `dead_letter` key, so the record is that object plus `dead_letter` (`{}` gives only `dead_letter`); `splice_or_wrapper` - the body is such an object but carries a value a re-encoding writer cannot carry losslessly in its own number type or parser limits (`1e400`, `-1e400`, `1e-400`, an integer or decimal beyond double precision, nesting beyond a parser's depth limit, a member name repeated at any depth): a writer MAY splice it ONLY at byte level, so the record text MUST contain every `expect.splice_literals` entry verbatim (a re-encoding writer that turns `1e400` into `null` or `Infinity`, or that keeps only the last of two `\"job\"` members, fails here) and must pass the structural checks of (2), and otherwise it MUST write the wrapper `expect.record` (ADR-0035 section 1); `wrapper` - anything else (empty body, not JSON, JSON that is not an object, trailing data, a leading BOM, `NaN` / `Infinity` / `-Infinity` literals, an unpaired surrogate escape such as `\\ud800` anywhere in the body, an object that already carries a top-level `dead_letter` key, invalid UTF-8): `raw` is the body as a plain string when it is valid UTF-8 (and `raw_encoding` is omitted, never written as `utf8`), otherwise the standard base64 (RFC 4648 section 4, padded) of the exact bytes with `raw_encoding` `base64`; U+FFFD substitution is forbidden. A body that is not valid UTF-8 is never an object (RFC 8259 section 8.1), so it is always wrapped, even if it looks like one. The padding cases cover one, two and three trailing input bytes.",
    "original_queue": "orders",
    "cases": [
      {
        "name": "object-empty",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{}",
        "expect": {
          "shape": "splice",
          "record": {}
        }
      },
      {
        "name": "object-minimal-envelope",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"job\":\"urn:x\",\"data\":{}}",
        "expect": {
          "shape": "splice",
          "record": {
            "job": "urn:x",
            "data": {}
          }
        }
      },
      {
        "name": "object-wrong-typed-job",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"job\":5}",
        "expect": {
          "shape": "splice",
          "record": {
            "job": 5
          }
        }
      },
      {
        "name": "object-surrounding-whitespace",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": " \n{\"a\":1}\n ",
        "expect": {
          "shape": "splice",
          "record": {
            "a": 1
          }
        }
      },
      {
        "name": "object-non-ascii-member",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"city\":\"Istanbul \u2615\",\"q\":\"caf\u00e9\"}",
        "expect": {
          "shape": "splice",
          "record": {
            "city": "Istanbul \u2615",
            "q": "caf\u00e9"
          }
        }
      },
      {
        "name": "empty-body",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": ""
          }
        }
      },
      {
        "name": "plain-text",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "not json",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "not json"
          }
        }
      },
      {
        "name": "unicode-text",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "caf\u00e9 \u2615 \u2014 \u00fcn\u00ef",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "caf\u00e9 \u2615 \u2014 \u00fcn\u00ef"
          }
        }
      },
      {
        "name": "text-with-control-and-quote-characters",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "line1\nline2\ttab \"quoted\" \\ back",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "line1\nline2\ttab \"quoted\" \\ back"
          }
        }
      },
      {
        "name": "json-null",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "null",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "null"
          }
        }
      },
      {
        "name": "json-number",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "42",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "42"
          }
        }
      },
      {
        "name": "json-string",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "\"text\"",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "\"text\""
          }
        }
      },
      {
        "name": "json-true",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "true",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "true"
          }
        }
      },
      {
        "name": "json-empty-array",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "[]",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "[]"
          }
        }
      },
      {
        "name": "json-array-of-objects",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "[{\"job\":\"urn:x\"}]",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "[{\"job\":\"urn:x\"}]"
          }
        }
      },
      {
        "name": "truncated-object",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"job\":\"urn:x\"",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "{\"job\":\"urn:x\""
          }
        }
      },
      {
        "name": "two-objects-trailing-data",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"a\":1} {\"b\":2}",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "{\"a\":1} {\"b\":2}"
          }
        }
      },
      {
        "name": "object-with-leading-bom",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "\ufeff{\"job\":\"urn:x\"}",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "\ufeff{\"job\":\"urn:x\"}"
          }
        }
      },
      {
        "name": "object-already-has-dead-letter",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"job\":\"urn:x\",\"dead_letter\":{\"reason\":\"failed\"}}",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "{\"job\":\"urn:x\",\"dead_letter\":{\"reason\":\"failed\"}}"
          }
        }
      },
      {
        "name": "invalid-utf8-one-byte-two-pad",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body_base64": "/w==",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "/w==",
            "raw_encoding": "base64"
          }
        }
      },
      {
        "name": "invalid-utf8-truncated-sequence-one-pad",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body_base64": "4oI=",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "4oI=",
            "raw_encoding": "base64"
          }
        }
      },
      {
        "name": "invalid-utf8-three-bytes-no-pad",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body_base64": "//79",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "//79",
            "raw_encoding": "base64"
          }
        }
      },
      {
        "name": "invalid-utf8-surrogate-encoded",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body_base64": "7aCA",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "7aCA",
            "raw_encoding": "base64"
          }
        }
      },
      {
        "name": "invalid-utf8-overlong",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body_base64": "wK8=",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "wK8=",
            "raw_encoding": "base64"
          }
        }
      },
      {
        "name": "invalid-utf8-above-u10ffff",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body_base64": "9JCAgA==",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "9JCAgA==",
            "raw_encoding": "base64"
          }
        }
      },
      {
        "name": "invalid-utf8-after-valid-text",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body_base64": "dmFsaWQgdGV4dCD/IHRoZW4gbW9yZQ==",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "dmFsaWQgdGV4dCD/IHRoZW4gbW9yZQ==",
            "raw_encoding": "base64"
          }
        }
      },
      {
        "name": "invalid-utf8-inside-object-text",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body_base64": "eyJqb2IiOiJ1cm46eCIsImRhdGEiOiL/In0=",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "eyJqb2IiOiJ1cm46eCIsImRhdGEiOiL/In0=",
            "raw_encoding": "base64"
          }
        }
      },
      {
        "name": "object-surrogate-pair-escape",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"a\":\"\\ud83d\\ude00\"}",
        "expect": {
          "shape": "splice",
          "record": {
            "a": "\ud83d\ude00"
          }
        }
      },
      {
        "name": "object-number-overflow-positive",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":1e400}}",
        "expect": {
          "shape": "splice_or_wrapper",
          "record": {
            "raw": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":1e400}}"
          },
          "splice_literals": [
            "1e400"
          ],
          "splice_keys": [
            "job",
            "attempts",
            "data"
          ]
        }
      },
      {
        "name": "object-number-overflow-negative",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":-1e400}}",
        "expect": {
          "shape": "splice_or_wrapper",
          "record": {
            "raw": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":-1e400}}"
          },
          "splice_literals": [
            "-1e400"
          ],
          "splice_keys": [
            "job",
            "attempts",
            "data"
          ]
        }
      },
      {
        "name": "object-integer-beyond-int64",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"n\":12345678901234567890}",
        "expect": {
          "shape": "splice_or_wrapper",
          "record": {
            "raw": "{\"n\":12345678901234567890}"
          },
          "splice_literals": [
            "12345678901234567890"
          ],
          "splice_keys": [
            "n"
          ]
        }
      },
      {
        "name": "object-number-underflow",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"n\":1e-400}",
        "expect": {
          "shape": "splice_or_wrapper",
          "record": {
            "raw": "{\"n\":1e-400}"
          },
          "splice_literals": [
            "1e-400"
          ],
          "splice_keys": [
            "n"
          ]
        }
      },
      {
        "name": "object-decimal-beyond-double-precision",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"n\":0.1234567890123456789012345}",
        "expect": {
          "shape": "splice_or_wrapper",
          "record": {
            "raw": "{\"n\":0.1234567890123456789012345}"
          },
          "splice_literals": [
            "0.1234567890123456789012345"
          ],
          "splice_keys": [
            "n"
          ]
        }
      },
      {
        "name": "object-nesting-depth-600",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"a\":[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]}",
        "expect": {
          "shape": "splice_or_wrapper",
          "record": {
            "raw": "{\"a\":[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]}"
          },
          "splice_literals": [
            "[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]"
          ],
          "splice_keys": [
            "a"
          ]
        }
      },
      {
        "name": "object-duplicate-member-top-level",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"job\":\"urn:bq:orders:created\",\"job\":5}",
        "expect": {
          "shape": "splice_or_wrapper",
          "record": {
            "raw": "{\"job\":\"urn:bq:orders:created\",\"job\":5}"
          },
          "splice_literals": [
            "\"job\":\"urn:bq:orders:created\"",
            "\"job\":5"
          ],
          "splice_keys": [
            "job"
          ]
        }
      },
      {
        "name": "object-duplicate-member-nested",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"k\":1,\"k\":2}}",
        "expect": {
          "shape": "splice_or_wrapper",
          "record": {
            "raw": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"k\":1,\"k\":2}}"
          },
          "splice_literals": [
            "\"k\":1",
            "\"k\":2"
          ],
          "splice_keys": [
            "job",
            "attempts",
            "data"
          ]
        }
      },
      {
        "name": "object-nan-literal",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":NaN}}",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":NaN}}"
          }
        }
      },
      {
        "name": "object-infinity-literal",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":Infinity}}",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "{\"job\":\"urn:bq:orders:created\",\"attempts\":0,\"data\":{\"n\":Infinity}}"
          }
        }
      },
      {
        "name": "object-negative-infinity-literal",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"n\":-Infinity}",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "{\"n\":-Infinity}"
          }
        }
      },
      {
        "name": "object-lone-high-surrogate-escape",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"a\":\"\\ud800\"}",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "{\"a\":\"\\ud800\"}"
          }
        }
      },
      {
        "name": "object-lone-low-surrogate-escape",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"a\":\"\\udc00\"}",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "{\"a\":\"\\udc00\"}"
          }
        }
      },
      {
        "name": "object-high-surrogate-then-non-low-escape",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"a\":\"\\ud800\\u0041\"}",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "{\"a\":\"\\ud800\\u0041\"}"
          }
        }
      },
      {
        "name": "object-lone-surrogate-escape-in-key",
        "source": "ADR-0035 (poison DLQ record shape); error-handling.md section 6",
        "body": "{\"\\ud800\":1}",
        "expect": {
          "shape": "wrapper",
          "record": {
            "raw": "{\"\\ud800\":1}"
          }
        }
      }
    ]
  },
  "identity_verdict": {
    "description": "Body classification outside Kafka (ADR-0036 decision 4; ADR-0032 section 6; error-handling.md section 3). Scope: `core`, because the decoder verdict is the same for every binding. For each case, feed `body` (a JSON string; it is the raw message body, so a case may hold invalid JSON, a BOM or duplicate keys) to the SDK core decoder and assert the verdict `expect`: `ok` - the body decodes into an envelope with a valid identity; `poison` - it does not (a decode error, or no valid identity). On a transport other than Kafka a `poison` body is never handed to a handler: it takes the poison route (broker-bindings.md section 5.5 and error-handling.md section 7; ADR-0035 record with `reason: poison`), not the unknown-URN strategies of error-handling.md section 3, which remain for a valid envelope whose URN has no handler. The case set starts with EVERY `kafka_poison` case (same names, bodies and order, the first 92 cases), with `no_identity` mapped to `poison` and `ok` / `poison` unchanged, so the two sections stay in step; the 5 cases after them are extra rows that pin the ADR-0036 decision 4 bodies `kafka_poison` does not hold (a blank or non-string `job` next to a valid `urn`, and a tab-only `job`) (a body with a valid identity but a wrongly typed known member is `poison` in both); a CI oracle derives the first 92 cases from `kafka_poison`, fails on any difference, and checks the extra rows with its own identity rule. The duplicate-key rule (the LAST value of a repeated top-level key wins) and the identity rule are those of `kafka_poison`: a `job` that is not a string is ignored; a blank (empty or whitespace-only) string `job` falls back to `urn`; a `urn` that is not a non-blank string is ignored; when neither is valid the body has no identity. Rows that pin the ADR-0036 decision 4 table (a `job` of `\"\"`, `\" \\t\"`, `null` or `{}` next to a valid `urn` is `ok`; see also the extra rows): a valid envelope (`full valid`) and a body whose only valid identity is `urn` (`urn alias string`), a blank `job` with a valid `urn` (`job blank with valid urn alias`), a non-string `job` with a valid `urn` (`job number with valid urn alias`) are `ok`; `{}` (`empty object`), a non-string `job` without `urn` (`job number`, `job null`), a non-string `urn` without `job` (`urn alias number`), non-object top-level values (`null literal`, `empty array`, `string`, `number`) and a non-JSON or empty body (`not json`, `empty`) are `poison`. The edge that a transport routes on an out-of-band identity property (Pulsar / Kafka `bq-job`) is outside this section.",
    "cases": [
      {
        "name": "empty",
        "body": "",
        "expect": "poison"
      },
      {
        "name": "whitespace only",
        "body": "   ",
        "expect": "poison"
      },
      {
        "name": "not json",
        "body": "not-json",
        "expect": "poison"
      },
      {
        "name": "truncated",
        "body": "{\"job\":\"urn:a\"",
        "expect": "poison"
      },
      {
        "name": "empty array",
        "body": "[]",
        "expect": "poison"
      },
      {
        "name": "array",
        "body": "[1]",
        "expect": "poison"
      },
      {
        "name": "string",
        "body": "\"str\"",
        "expect": "poison"
      },
      {
        "name": "number",
        "body": "123",
        "expect": "poison"
      },
      {
        "name": "boolean",
        "body": "true",
        "expect": "poison"
      },
      {
        "name": "null literal",
        "body": "null",
        "expect": "poison"
      },
      {
        "name": "empty object",
        "body": "{}",
        "expect": "poison"
      },
      {
        "name": "full valid",
        "body": "{\"job\":\"urn:babel:orders:created\",\"trace_id\":\"t\",\"data\":{},\"meta\":{\"id\":\"i\",\"queue\":\"q\",\"lang\":\"php\",\"schema_version\":1,\"created_at\":1700000000000},\"attempts\":0}",
        "expect": "ok"
      },
      {
        "name": "job number",
        "body": "{\"job\":5}",
        "expect": "poison"
      },
      {
        "name": "job null",
        "body": "{\"job\":null}",
        "expect": "poison"
      },
      {
        "name": "urn alias number",
        "body": "{\"urn\":5}",
        "expect": "poison"
      },
      {
        "name": "urn alias string",
        "body": "{\"urn\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "urn alias padded",
        "body": "{\"urn\":\"  urn:x  \"}",
        "expect": "ok"
      },
      {
        "name": "trace_id number",
        "body": "{\"trace_id\":7}",
        "expect": "poison"
      },
      {
        "name": "data array",
        "body": "{\"data\":[]}",
        "expect": "poison"
      },
      {
        "name": "data string",
        "body": "{\"data\":\"x\"}",
        "expect": "poison"
      },
      {
        "name": "data null",
        "body": "{\"data\":null}",
        "expect": "poison"
      },
      {
        "name": "meta string",
        "body": "{\"meta\":\"x\"}",
        "expect": "poison"
      },
      {
        "name": "meta array",
        "body": "{\"meta\":[]}",
        "expect": "poison"
      },
      {
        "name": "meta null",
        "body": "{\"meta\":null}",
        "expect": "poison"
      },
      {
        "name": "meta.id number",
        "body": "{\"meta\":{\"id\":5}}",
        "expect": "poison"
      },
      {
        "name": "meta.queue number",
        "body": "{\"meta\":{\"queue\":5}}",
        "expect": "poison"
      },
      {
        "name": "meta.lang boolean",
        "body": "{\"meta\":{\"lang\":true}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at string",
        "body": "{\"meta\":{\"created_at\":\"2026\"}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at fractional",
        "body": "{\"meta\":{\"created_at\":1.5}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at integer",
        "body": "{\"meta\":{\"created_at\":1700000000000}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at exponent",
        "body": "{\"meta\":{\"created_at\":1e3}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at decimal zero",
        "body": "{\"meta\":{\"created_at\":1.0}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at int64 overflow",
        "body": "{\"meta\":{\"created_at\":9223372036854775808}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at int64 max",
        "body": "{\"meta\":{\"created_at\":9223372036854775807}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at negative",
        "body": "{\"meta\":{\"created_at\":-1}}",
        "expect": "poison"
      },
      {
        "name": "meta.created_at negative zero",
        "body": "{\"meta\":{\"created_at\":-0}}",
        "expect": "poison"
      },
      {
        "name": "meta.schema_version string",
        "body": "{\"meta\":{\"schema_version\":\"1\"}}",
        "expect": "poison"
      },
      {
        "name": "meta.schema_version two",
        "body": "{\"meta\":{\"schema_version\":2}}",
        "expect": "poison"
      },
      {
        "name": "meta.schema_version decimal zero",
        "body": "{\"meta\":{\"schema_version\":1.0}}",
        "expect": "poison"
      },
      {
        "name": "meta.schema_version null",
        "body": "{\"meta\":{\"schema_version\":null}}",
        "expect": "poison"
      },
      {
        "name": "meta.schema_version boolean",
        "body": "{\"meta\":{\"schema_version\":true}}",
        "expect": "poison"
      },
      {
        "name": "attempts fractional",
        "body": "{\"attempts\":1.5}",
        "expect": "poison"
      },
      {
        "name": "attempts string",
        "body": "{\"attempts\":\"3\"}",
        "expect": "poison"
      },
      {
        "name": "attempts integer",
        "body": "{\"attempts\":2}",
        "expect": "poison"
      },
      {
        "name": "attempts exponent",
        "body": "{\"attempts\":1e0}",
        "expect": "poison"
      },
      {
        "name": "attempts upper exponent",
        "body": "{\"attempts\":1E2}",
        "expect": "poison"
      },
      {
        "name": "attempts negative zero",
        "body": "{\"attempts\":-0}",
        "expect": "poison"
      },
      {
        "name": "attempts overflow",
        "body": "{\"attempts\":9223372036854775808}",
        "expect": "poison"
      },
      {
        "name": "attempts null",
        "body": "{\"attempts\":null}",
        "expect": "poison"
      },
      {
        "name": "dead_letter string",
        "body": "{\"dead_letter\":\"x\"}",
        "expect": "poison"
      },
      {
        "name": "dead_letter null",
        "body": "{\"dead_letter\":null}",
        "expect": "poison"
      },
      {
        "name": "dead_letter empty object",
        "body": "{\"dead_letter\":{}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.attempts string",
        "body": "{\"dead_letter\":{\"attempts\":\"3\"}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.reason number",
        "body": "{\"dead_letter\":{\"reason\":5}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.error number",
        "body": "{\"dead_letter\":{\"error\":5}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter nullable strings",
        "body": "{\"dead_letter\":{\"error\":null,\"exception\":null}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.failed_at string",
        "body": "{\"dead_letter\":{\"failed_at\":\"x\"}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.failed_at fractional",
        "body": "{\"dead_letter\":{\"failed_at\":1.5}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.original_queue array",
        "body": "{\"dead_letter\":{\"original_queue\":[]}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter.lang object",
        "body": "{\"dead_letter\":{\"lang\":{}}}",
        "expect": "poison"
      },
      {
        "name": "dead_letter full",
        "body": "{\"dead_letter\":{\"error\":\"e\",\"exception\":\"x\",\"failed_at\":1,\"original_queue\":\"q\",\"attempts\":1,\"lang\":\"go\",\"reason\":\"r\"}}",
        "expect": "poison"
      },
      {
        "name": "upper-case job key with number is an unknown member (names are case-sensitive)",
        "body": "{\"JOB\":5}",
        "expect": "poison"
      },
      {
        "name": "mixed-case meta.id key with number is an unknown member (names are case-sensitive)",
        "body": "{\"Meta\":{\"ID\":5}}",
        "expect": "poison"
      },
      {
        "name": "upper-case job key with string",
        "body": "{\"JOB\":\"urn:x\"}",
        "expect": "poison"
      },
      {
        "name": "trailing garbage",
        "body": "{\"job\":\"x\"} trailing",
        "expect": "poison"
      },
      {
        "name": "two objects",
        "body": "{\"job\":\"x\"}{\"job\":\"y\"}",
        "expect": "poison"
      },
      {
        "name": "unknown keys",
        "body": "{\"x\":1}",
        "expect": "poison"
      },
      {
        "name": "forbidden keys with odd types",
        "body": "{\"timestamp\":\"x\",\"meta\":{\"max_retries\":\"x\",\"attempts\":\"y\",\"source\":5,\"ts\":\"z\"}}",
        "expect": "poison"
      },
      {
        "name": "nested lookalikes in data",
        "body": "{\"data\":{\"a\":[1,2,{\"b\":null}],\"meta\":5,\"job\":5},\"extra\":{\"meta\":5}}",
        "expect": "poison"
      },
      {
        "name": "duplicate job string then number",
        "body": "{\"job\":\"urn:x\",\"job\":5}",
        "expect": "poison"
      },
      {
        "name": "duplicate job number then string",
        "body": "{\"job\":5,\"job\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "byte order mark",
        "body": "\ufeff{\"job\":\"x\"}",
        "expect": "poison"
      },
      {
        "name": "leading zero number",
        "body": "{\"attempts\":01}",
        "expect": "poison"
      },
      {
        "name": "NaN literal",
        "body": "{\"attempts\":NaN}",
        "expect": "poison"
      },
      {
        "name": "single quotes",
        "body": "{'a':1}",
        "expect": "poison"
      },
      {
        "name": "meta duplicate-case key",
        "body": "{\"meta\":{\"id\":\"a\",\"queue\":\"b\",\"lang\":\"c\",\"schema_version\":1,\"created_at\":1,\"ID\":\"dup\"}}",
        "expect": "poison"
      },
      {
        "name": "attempts huge exponent",
        "body": "{\"attempts\":1e400}",
        "expect": "poison"
      },
      {
        "name": "data with huge number",
        "body": "{\"data\":{\"n\":1e400}}",
        "expect": "poison"
      },
      {
        "name": "job number with valid urn alias",
        "body": "{\"job\":5,\"urn\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "job blank with valid urn alias",
        "body": "{\"job\":\"  \",\"urn\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "job valid with urn number",
        "body": "{\"job\":\"urn:x\",\"urn\":5}",
        "expect": "ok"
      },
      {
        "name": "job blank without urn",
        "body": "{\"job\":\"  \"}",
        "expect": "poison"
      },
      {
        "name": "job and urn both empty strings",
        "body": "{\"job\":\"\",\"urn\":\"\"}",
        "expect": "poison"
      },
      {
        "name": "job and urn both arrays",
        "body": "{\"job\":[],\"urn\":[]}",
        "expect": "poison"
      },
      {
        "name": "job object without urn",
        "body": "{\"job\":{}}",
        "expect": "poison"
      },
      {
        "name": "identity with null data",
        "body": "{\"job\":\"urn:x\",\"data\":null}",
        "expect": "ok"
      },
      {
        "name": "identity with null meta",
        "body": "{\"job\":\"urn:x\",\"meta\":null}",
        "expect": "ok"
      },
      {
        "name": "identity with null attempts",
        "body": "{\"job\":\"urn:x\",\"attempts\":null}",
        "expect": "ok"
      },
      {
        "name": "identity with null dead_letter",
        "body": "{\"job\":\"urn:x\",\"dead_letter\":null}",
        "expect": "ok"
      },
      {
        "name": "identity with integer attempts",
        "body": "{\"job\":\"urn:x\",\"attempts\":2}",
        "expect": "ok"
      },
      {
        "name": "identity with wrong typed attempts",
        "body": "{\"job\":\"urn:x\",\"attempts\":\"3\"}",
        "expect": "poison"
      },
      {
        "name": "identity with wrong typed data",
        "body": "{\"job\":\"urn:x\",\"data\":[]}",
        "expect": "poison"
      },
      {
        "name": "job empty string with valid urn",
        "body": "{\"job\":\"\",\"urn\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "job space and tab with valid urn",
        "body": "{\"job\":\" \\t\",\"urn\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "job null with valid urn",
        "body": "{\"job\":null,\"urn\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "job object with valid urn",
        "body": "{\"job\":{},\"urn\":\"urn:x\"}",
        "expect": "ok"
      },
      {
        "name": "job space and tab without urn",
        "body": "{\"job\":\" \\t\"}",
        "expect": "poison"
      }
    ]
  },
  "pulsar_exhaustion": {
    "description": "Pulsar max-attempts settle decision (ADR-0036 decisions 1 and 2, amends ADR-0014; broker-bindings.md section 5.5 \"Max attempts and poison\"). Scope: `pulsar`. A pure function, no broker: for each case compute the outcome the consumer takes for a delivery and assert `expect`. Case `{name, kind, body_attempts?, bq_attempts?, redelivery_count, max_attempts?, dead_letter, on_unknown_urn?, expect}`. `kind`: `failed` (the handler throws), `unknown_urn` (an unmapped URN with no hook; strategy `fail`), `poison` (the body does not decode into an envelope, including an object with no valid identity, see `identity_verdict`). Inputs: `body_attempts` is the envelope's top-level `attempts` (absent for `poison`, which has no decodable body: its input is `bq_attempts` and `redelivery_count` only); `bq_attempts` is the `bq-attempts` message property, a string (absent = not set); `redelivery_count` is the native Pulsar RedeliveryCount (0-based); `max_attempts` absent = the default 3 (the total number of deliveries, the first included; a value below 1 is a SHOULD-level configuration error and is not a case); `dead_letter` is a boolean (dead-lettering on or off) and `off` has two meanings: in the Go and Python runtimes it is the dead-letter SETTING only, the DLQ target stays writable and the `dead_letter` strategy still writes a record; in the PHP `Consume\\Dispatcher` \"on\" means a `DeadLetterPublisher` is configured, so `off` means NO publisher and nothing can be written; `on_unknown_urn` absent = `fail`. Derivation: `reconciled` = `bq_attempts` when present and valid, else `body_attempts`, then `max(reconciled, redelivery_count)` (pulsar.attempts_reconciliation); `counted = reconciled + 1`. Decision. `failed` and `unknown_urn` (strategy `fail`): `counted < max_attempts` is `retry`; otherwise dead-lettering on is `dlq` (`reason` `failed` or `unknown_urn`, `dead_letter_attempts = counted`) and off is `drop` (acknowledge and log). `poison`: `on_unknown_urn: delete` is `drop`; `on_unknown_urn: dead_letter` is `dlq` with `reason: poison` whatever `dead_letter` says (the strategy writes the record where a DLQ writer exists; see `outcome_no_writer` below); dead-lettering on (strategy `fail` or `release`) is `dlq` with `reason: poison` and NO retry (the ADR-0035 record, `dead_letter_attempts` is not compared); dead-lettering off takes the bounded `fail` path (`release` is replaced by it) - `counted < max_attempts` is `retry`, otherwise `drop`. `unknown_urn` with `on_unknown_urn: delete` is `drop`; with `dead_letter` it is a direct `dlq` with `reason: unknown_urn` whatever `dead_letter` says (`dead_letter_attempts` is not compared; see `outcome_no_writer` below). `expect.outcome_no_writer` (optional, `drop`): present only on a row whose result differs for an SDK without a DLQ writer (the PHP `Dispatcher` without a publisher: `on_unknown_urn: dead_letter` is acknowledged, dropped and logged; owner decision 2026-10-25, ADR-0036 decision 3). A runner for such an SDK asserts `expect.outcome_no_writer` instead of `expect.outcome`; every other runner asserts `expect.outcome` and ignores the field; when the field is absent both kinds of SDK assert `expect.outcome`. On Kafka the PHP `Dispatcher` rethrows instead of dropping (outside this Pulsar-scoped section). Rows with any `on_unknown_urn` value (they are the rows with that key) apply only to an SDK that has the strategy option (the Go and Python runtimes and the PHP `Consume\\Dispatcher`, ADR-0036 decision 3); a runner for the Java, .NET or Node consumer, which have no such option, skips them and reports them as `skip`, not `pass`. `unknown_urn` with `release` is not a case: on Pulsar the Go and Python runtimes release it immediately without counting (the `unknown_urn_release_delay` known gap of broker-bindings.md section 5.5). Not covered here (no broker-less test): the DLQ write itself, the acknowledgement after a successful write, the negative acknowledgement after a failed one, and the PHP queue name of ADR-0036 decision 3; each SDK covers them in its own tests.",
    "cases": [
      {
        "name": "failed-reconciled-0-dlq-on-retries",
        "kind": "failed",
        "body_attempts": 0,
        "redelivery_count": 0,
        "dead_letter": true,
        "expect": {
          "outcome": "retry"
        }
      },
      {
        "name": "failed-reconciled-1-dlq-on-retries",
        "kind": "failed",
        "body_attempts": 1,
        "redelivery_count": 0,
        "dead_letter": true,
        "expect": {
          "outcome": "retry"
        }
      },
      {
        "name": "failed-reconciled-2-dlq-on-dead-letters",
        "kind": "failed",
        "body_attempts": 2,
        "redelivery_count": 0,
        "dead_letter": true,
        "expect": {
          "outcome": "dlq",
          "reason": "failed",
          "dead_letter_attempts": 3
        }
      },
      {
        "name": "failed-reconciled-2-dlq-off-drops",
        "kind": "failed",
        "body_attempts": 2,
        "redelivery_count": 0,
        "dead_letter": false,
        "expect": {
          "outcome": "drop"
        }
      },
      {
        "name": "failed-reconciled-7-dlq-on-counts-past-the-cap",
        "kind": "failed",
        "body_attempts": 7,
        "redelivery_count": 0,
        "dead_letter": true,
        "expect": {
          "outcome": "dlq",
          "reason": "failed",
          "dead_letter_attempts": 8
        }
      },
      {
        "name": "failed-max-1-dlq-on-first-delivery-dead-letters",
        "kind": "failed",
        "body_attempts": 0,
        "redelivery_count": 0,
        "max_attempts": 1,
        "dead_letter": true,
        "expect": {
          "outcome": "dlq",
          "reason": "failed",
          "dead_letter_attempts": 1
        }
      },
      {
        "name": "failed-max-1-dlq-off-first-delivery-drops",
        "kind": "failed",
        "body_attempts": 0,
        "redelivery_count": 0,
        "max_attempts": 1,
        "dead_letter": false,
        "expect": {
          "outcome": "drop"
        }
      },
      {
        "name": "failed-max-5-reconciled-3-dlq-off-retries",
        "kind": "failed",
        "body_attempts": 3,
        "redelivery_count": 0,
        "max_attempts": 5,
        "dead_letter": false,
        "expect": {
          "outcome": "retry"
        }
      },
      {
        "name": "failed-max-5-reconciled-4-dlq-off-drops",
        "kind": "failed",
        "body_attempts": 4,
        "redelivery_count": 0,
        "max_attempts": 5,
        "dead_letter": false,
        "expect": {
          "outcome": "drop"
        }
      },
      {
        "name": "unknown-urn-reconciled-1-dlq-on-retries",
        "kind": "unknown_urn",
        "body_attempts": 1,
        "redelivery_count": 0,
        "dead_letter": true,
        "expect": {
          "outcome": "retry"
        }
      },
      {
        "name": "unknown-urn-reconciled-2-dlq-on-dead-letters",
        "kind": "unknown_urn",
        "body_attempts": 2,
        "redelivery_count": 0,
        "dead_letter": true,
        "expect": {
          "outcome": "dlq",
          "reason": "unknown_urn",
          "dead_letter_attempts": 3
        }
      },
      {
        "name": "unknown-urn-reconciled-2-dlq-off-drops",
        "kind": "unknown_urn",
        "body_attempts": 2,
        "redelivery_count": 0,
        "dead_letter": false,
        "expect": {
          "outcome": "drop"
        }
      },
      {
        "name": "poison-reconciled-0-dlq-on-dead-letters-without-retry",
        "kind": "poison",
        "redelivery_count": 0,
        "dead_letter": true,
        "expect": {
          "outcome": "dlq",
          "reason": "poison"
        }
      },
      {
        "name": "poison-reconciled-0-dlq-off-retries",
        "kind": "poison",
        "redelivery_count": 0,
        "dead_letter": false,
        "expect": {
          "outcome": "retry"
        }
      },
      {
        "name": "poison-reconciled-2-dlq-off-drops",
        "kind": "poison",
        "redelivery_count": 2,
        "dead_letter": false,
        "expect": {
          "outcome": "drop"
        }
      },
      {
        "name": "poison-delete-dlq-on-drops",
        "kind": "poison",
        "redelivery_count": 0,
        "dead_letter": true,
        "on_unknown_urn": "delete",
        "expect": {
          "outcome": "drop"
        }
      },
      {
        "name": "poison-delete-dlq-off-drops",
        "kind": "poison",
        "redelivery_count": 0,
        "dead_letter": false,
        "on_unknown_urn": "delete",
        "expect": {
          "outcome": "drop"
        }
      },
      {
        "name": "poison-release-dlq-on-dead-letters-without-retry",
        "kind": "poison",
        "redelivery_count": 0,
        "dead_letter": true,
        "on_unknown_urn": "release",
        "expect": {
          "outcome": "dlq",
          "reason": "poison"
        }
      },
      {
        "name": "poison-release-dlq-off-reconciled-0-takes-the-bounded-fail-path",
        "kind": "poison",
        "redelivery_count": 0,
        "dead_letter": false,
        "on_unknown_urn": "release",
        "expect": {
          "outcome": "retry"
        }
      },
      {
        "name": "poison-release-dlq-off-reconciled-2-drops-not-released-forever",
        "kind": "poison",
        "redelivery_count": 2,
        "dead_letter": false,
        "on_unknown_urn": "release",
        "expect": {
          "outcome": "drop"
        }
      },
      {
        "name": "poison-dead-letter-strategy-dlq-off-dead-letters",
        "kind": "poison",
        "redelivery_count": 0,
        "dead_letter": false,
        "on_unknown_urn": "dead_letter",
        "expect": {
          "outcome": "dlq",
          "reason": "poison",
          "outcome_no_writer": "drop"
        }
      },
      {
        "name": "unknown-urn-delete-dlq-on-drops",
        "kind": "unknown_urn",
        "body_attempts": 0,
        "redelivery_count": 0,
        "dead_letter": true,
        "on_unknown_urn": "delete",
        "expect": {
          "outcome": "drop"
        }
      },
      {
        "name": "unknown-urn-dead-letter-strategy-dlq-off-dead-letters-directly",
        "kind": "unknown_urn",
        "body_attempts": 0,
        "redelivery_count": 0,
        "dead_letter": false,
        "on_unknown_urn": "dead_letter",
        "expect": {
          "outcome": "dlq",
          "reason": "unknown_urn",
          "outcome_no_writer": "drop"
        }
      },
      {
        "name": "poison-dead-letter-strategy-dlq-on-dead-letters",
        "kind": "poison",
        "redelivery_count": 0,
        "dead_letter": true,
        "on_unknown_urn": "dead_letter",
        "expect": {
          "outcome": "dlq",
          "reason": "poison"
        }
      },
      {
        "name": "unknown-urn-dead-letter-strategy-dlq-on-dead-letters-directly",
        "kind": "unknown_urn",
        "body_attempts": 0,
        "redelivery_count": 0,
        "dead_letter": true,
        "on_unknown_urn": "dead_letter",
        "expect": {
          "outcome": "dlq",
          "reason": "unknown_urn"
        }
      },
      {
        "name": "reconciliation-bq-attempts-string-over-body",
        "kind": "failed",
        "body_attempts": 0,
        "bq_attempts": "2",
        "redelivery_count": 0,
        "dead_letter": true,
        "expect": {
          "outcome": "dlq",
          "reason": "failed",
          "dead_letter_attempts": 3
        }
      },
      {
        "name": "reconciliation-redelivery-count-floors-body",
        "kind": "failed",
        "body_attempts": 1,
        "redelivery_count": 2,
        "dead_letter": true,
        "expect": {
          "outcome": "dlq",
          "reason": "failed",
          "dead_letter_attempts": 3
        }
      },
      {
        "name": "reconciliation-bq-attempts-below-cap-retries",
        "kind": "unknown_urn",
        "body_attempts": 0,
        "bq_attempts": "1",
        "redelivery_count": 0,
        "dead_letter": true,
        "expect": {
          "outcome": "retry"
        }
      },
      {
        "name": "reconciliation-poison-bq-attempts-dlq-off-drops",
        "kind": "poison",
        "bq_attempts": "2",
        "redelivery_count": 0,
        "dead_letter": false,
        "expect": {
          "outcome": "drop"
        }
      }
    ]
  },
  "version_gate_pulsar": {
    "description": "Version-gate settle rule for Apache Pulsar (broker-bindings.md section 5.7, property `bq-schema-version`) (ADR-0037 decision 1; broker-bindings.md section 5.7 \"Version-gate settle rule\"). Scope: `pulsar`. A pure function, no broker: for each case compute how the consumer settles a delivery whose schema-version property is present, not null, not blank and not the supported version, and assert `expect`. Which property values are version-gated is NOT decided here: the `schema_version_gate` block of this binding already locks the trigger. A runner feeds the delivery a property value that gates (any of that block's rejected values, for example `2`). Case `{name, on_unknown_urn?, dead_letter, dlq_write?, bq_attempts?, expect}`. `on_unknown_urn`: `fail` | `delete` | `release` | `dead_letter`; absent = `fail`. A row with any value other than `fail` applies only to an SDK whose consumer has the strategy option; the Java, .NET and Node Pulsar consumers have none (they behave as `fail`), so a runner for one of them reports those rows as `skip` citing ADR-0037, not as `pass`. `release` behaves as `fail` for a version-gated delivery (it is never released). The version gate reads only the explicitly configured `on_unknown_urn` strategy; with none configured it is `fail`. An `onUnknownUrn` hook, any strategy a hook implies (a hook-only Java or Node SQS consumer would otherwise be `delete`) and a hook's precedence over the strategy (the .NET SQS consumer) do not affect it: the hook is for an unknown URN only, so a hook-only consumer settles these rows as `fail`. `dead_letter`: `on` | `off` (dead-lettering on or off, each SDK's existing meaning; for the `dead_letter` strategy with `off` see `expect.outcome_no_writer`). `dlq_write`: `ok` | `fails`, whether the write of the raw record to `<queue>.dlq` succeeds; absent = `ok` (ADR-0037). It is read only on rows whose `expect.outcome` writes a record (`dlq_raw` or `unsettled`); it is present on those rows, and also on the `dead_letter` strategy rows with `dead_letter: off`, where an SDK with a writable DLQ target writes and an SDK without a writer asserts `outcome_no_writer` instead. `bq_attempts`: optional, the `bq-attempts` property as a string; present only to show that the outcome does not depend on it (the rule applies on the first delivery, with no retry, whatever the attempts, the native redelivery count or the max-attempts setting say). `expect.outcome`: `ack` | `dlq_raw` (the raw record is written to `<queue>.dlq`, then the delivery is acknowledged) | `unsettled` (the write failed: the delivery is neither acknowledged nor retried by the SDK and the failure is reported; negative acknowledgement). With dead-lettering off and a strategy other than `dead_letter` the outcome is `ack` (acknowledged and dropped, logged). `expect.record` (only on `dlq_raw` rows): `incoming_body`, the record written to `<queue>.dlq` has a body equal to the incoming body byte for byte and carries no `dead_letter` block (no re-encoding, no ADR-0035 wrapping). A runner checks it against every body of `incoming_bodies`, which are deliberately not in canonical form, so a writer that decodes and re-encodes fails. `expect.outcome_no_writer`: optional; a runner for an SDK in which `dead_letter: off` means NO DLQ writer exists (no publisher, sender or queue URL) asserts it instead of `expect.outcome`. It is present exactly on the rows with strategy `dead_letter` and `dead_letter: off`, where the two kinds differ (here: `ack`). Absent = both kinds assert `expect.outcome`. In every case the delivery is never decoded, no handler and no `onUnknownUrn` hook is called, and nothing is retried. The Laravel driver for this binding (if any) falls under the ADR-0037 decision 4 exception and reports every case of this section as `skip` with reason `ADR-0037 decision 4`; a package with no consumer for this binding (produce-only) follows the rule of the existing `sqs` / `artemis` binding sections (see README, \"Added in 1.8.0\"). Out of scope: Kafka (a version-gated record takes the section 6.5 poison path) and RabbitMQ.",
    "incoming_bodies": [
      {
        "name": "pretty-printed-escaped",
        "body": "{\n  \"job\": \"urn:babelqueue:order.created\",\n  \"data\": { \"name\": \"caf\\u00e9\", \"path\": \"a\\/b\" },\n  \"meta\": { \"schema_version\": 2 }\n}\n"
      },
      {
        "name": "key-order-and-number-forms",
        "body": "{\"meta\": {\"schema_version\": 2}, \"data\": {\"z\": 1, \"a\": 2, \"ratio\": 1.50, \"exp\": 1E2, \"big\": 12345678901234567890}, \"job\": \"urn:babelqueue:order.created\"}"
      },
      {
        "name": "not-json",
        "body": "plain text, not JSON  \t "
      }
    ],
    "cases": [
      {
        "name": "default-dlq-on-write-ok",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "default-dlq-on-write-fails",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "fail-dlq-on-write-ok",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "fail-dlq-on-write-fails",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "fail-dlq-on-write-ok-bq-attempts-7",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "ok",
        "bq_attempts": "7",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "release-dlq-on-write-ok",
        "on_unknown_urn": "release",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "release-dlq-on-write-fails",
        "on_unknown_urn": "release",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "delete-dlq-on-acks",
        "on_unknown_urn": "delete",
        "dead_letter": "on",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "delete-dlq-off-acks",
        "on_unknown_urn": "delete",
        "dead_letter": "off",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "dead-letter-dlq-on-write-ok",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "dead-letter-dlq-on-write-fails",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "default-dlq-off-ack",
        "dead_letter": "off",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "fail-dlq-off-ack",
        "on_unknown_urn": "fail",
        "dead_letter": "off",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "fail-dlq-off-ack-bq-attempts-7",
        "on_unknown_urn": "fail",
        "dead_letter": "off",
        "bq_attempts": "7",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "release-dlq-off-ack",
        "on_unknown_urn": "release",
        "dead_letter": "off",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "dead-letter-dlq-off-write-ok",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "off",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body",
          "outcome_no_writer": "ack"
        }
      },
      {
        "name": "dead-letter-dlq-off-write-fails",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "off",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled",
          "outcome_no_writer": "ack"
        }
      }
    ]
  },
  "version_gate_artemis": {
    "description": "Version-gate settle rule for Apache ActiveMQ Artemis (broker-bindings.md section 7.7, property `bq_schema_version`) (ADR-0037 decision 1; broker-bindings.md section 5.7 \"Version-gate settle rule\"). Scope: `artemis`. A pure function, no broker: for each case compute how the consumer settles a delivery whose schema-version property is present, not null, not blank and not the supported version, and assert `expect`. Which property values are version-gated is NOT decided here: the `schema_version_gate` block of this binding already locks the trigger. A runner feeds the delivery a property value that gates (any of that block's rejected values, for example `2`). Case `{name, on_unknown_urn?, dead_letter, dlq_write?, bq_attempts?, expect}`. `on_unknown_urn`: `fail` | `delete` | `release` | `dead_letter`; absent = `fail`. Every row is asserted: the Java, .NET, Node, Go and Python consumers of this binding have the strategy option, so none of its rows may be skipped for lack of it. `release` behaves as `fail` for a version-gated delivery (it is never released). The version gate reads only the explicitly configured `on_unknown_urn` strategy; with none configured it is `fail`. An `onUnknownUrn` hook, any strategy a hook implies (a hook-only Java or Node SQS consumer would otherwise be `delete`) and a hook's precedence over the strategy (the .NET SQS consumer) do not affect it: the hook is for an unknown URN only, so a hook-only consumer settles these rows as `fail`. `dead_letter`: `on` | `off` (dead-lettering on or off, each SDK's existing meaning; for the `dead_letter` strategy with `off` see `expect.outcome_no_writer`). `dlq_write`: `ok` | `fails`, whether the write of the raw record to `<queue>.dlq` succeeds; absent = `ok` (ADR-0037). It is read only on rows whose `expect.outcome` writes a record (`dlq_raw` or `unsettled`); it is present on those rows, and also on the `dead_letter` strategy rows with `dead_letter: off`, where an SDK with a writable DLQ target writes and an SDK without a writer asserts `outcome_no_writer` instead. `bq_attempts`: optional, the `bq-attempts` property as a string; present only to show that the outcome does not depend on it (the rule applies on the first delivery, with no retry, whatever the attempts, the native redelivery count or the max-attempts setting say). `expect.outcome`: `ack` | `dlq_raw` (the raw record is written to `<queue>.dlq`, then the delivery is acknowledged) | `unsettled` (the write failed: the delivery is neither acknowledged nor retried by the SDK and the failure is reported; JMS `session.recover()` / AMQP `released`). With dead-lettering off and a strategy other than `dead_letter` the outcome is `ack` (acknowledged and dropped, logged). `expect.record` (only on `dlq_raw` rows): `incoming_body`, the record written to `<queue>.dlq` has a body equal to the incoming body byte for byte and carries no `dead_letter` block (no re-encoding, no ADR-0035 wrapping). A runner checks it against every body of `incoming_bodies`, which are deliberately not in canonical form, so a writer that decodes and re-encodes fails. `expect.outcome_no_writer`: optional; a runner for an SDK in which `dead_letter: off` means NO DLQ writer exists (no publisher, sender or queue URL) asserts it instead of `expect.outcome`. It is present exactly on the rows with strategy `dead_letter` and `dead_letter: off`, where the two kinds differ (here: `ack`). Absent = both kinds assert `expect.outcome`. In every case the delivery is never decoded, no handler and no `onUnknownUrn` hook is called, and nothing is retried. The Laravel driver for this binding (if any) falls under the ADR-0037 decision 4 exception and reports every case of this section as `skip` with reason `ADR-0037 decision 4`; a package with no consumer for this binding (produce-only) follows the rule of the existing `sqs` / `artemis` binding sections (see README, \"Added in 1.8.0\"). Out of scope: Kafka (a version-gated record takes the section 6.5 poison path) and RabbitMQ.",
    "incoming_bodies": [
      {
        "name": "pretty-printed-escaped",
        "body": "{\n  \"job\": \"urn:babelqueue:order.created\",\n  \"data\": { \"name\": \"caf\\u00e9\", \"path\": \"a\\/b\" },\n  \"meta\": { \"schema_version\": 2 }\n}\n"
      },
      {
        "name": "key-order-and-number-forms",
        "body": "{\"meta\": {\"schema_version\": 2}, \"data\": {\"z\": 1, \"a\": 2, \"ratio\": 1.50, \"exp\": 1E2, \"big\": 12345678901234567890}, \"job\": \"urn:babelqueue:order.created\"}"
      },
      {
        "name": "not-json",
        "body": "plain text, not JSON  \t "
      }
    ],
    "cases": [
      {
        "name": "default-dlq-on-write-ok",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "default-dlq-on-write-fails",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "fail-dlq-on-write-ok",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "fail-dlq-on-write-fails",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "fail-dlq-on-write-ok-bq-attempts-7",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "ok",
        "bq_attempts": "7",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "release-dlq-on-write-ok",
        "on_unknown_urn": "release",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "release-dlq-on-write-fails",
        "on_unknown_urn": "release",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "delete-dlq-on-acks",
        "on_unknown_urn": "delete",
        "dead_letter": "on",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "delete-dlq-off-acks",
        "on_unknown_urn": "delete",
        "dead_letter": "off",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "dead-letter-dlq-on-write-ok",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "dead-letter-dlq-on-write-fails",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "default-dlq-off-ack",
        "dead_letter": "off",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "fail-dlq-off-ack",
        "on_unknown_urn": "fail",
        "dead_letter": "off",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "fail-dlq-off-ack-bq-attempts-7",
        "on_unknown_urn": "fail",
        "dead_letter": "off",
        "bq_attempts": "7",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "release-dlq-off-ack",
        "on_unknown_urn": "release",
        "dead_letter": "off",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "dead-letter-dlq-off-write-ok",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "off",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body",
          "outcome_no_writer": "ack"
        }
      },
      {
        "name": "dead-letter-dlq-off-write-fails",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "off",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled",
          "outcome_no_writer": "ack"
        }
      }
    ]
  },
  "version_gate_sqs": {
    "description": "Version-gate settle rule for Amazon SQS (broker-bindings.md section 3.7, message attribute `bq-schema-version`) (ADR-0037 decision 1; broker-bindings.md section 5.7 \"Version-gate settle rule\"). Scope: `sqs`. A pure function, no broker: for each case compute how the consumer settles a delivery whose schema-version property is present, not null, not blank and not the supported version, and assert `expect`. Which property values are version-gated is NOT decided here: the `schema_version_gate` block of this binding already locks the trigger. A runner feeds the delivery a property value that gates (any of that block's rejected values, for example `2`). Case `{name, on_unknown_urn?, dead_letter, dlq_write?, bq_attempts?, expect}`. `on_unknown_urn`: `fail` | `delete` | `release` | `dead_letter`; absent = `fail`. Every row is asserted: the Java, .NET, Node, Go and Python consumers of this binding have the strategy option, so none of its rows may be skipped for lack of it. `release` behaves as `fail` for a version-gated delivery (it is never released). The version gate reads only the explicitly configured `on_unknown_urn` strategy; with none configured it is `fail`. An `onUnknownUrn` hook, any strategy a hook implies (a hook-only Java or Node SQS consumer would otherwise be `delete`) and a hook's precedence over the strategy (the .NET SQS consumer) do not affect it: the hook is for an unknown URN only, so a hook-only consumer settles these rows as `fail`. `dead_letter`: `on` | `off` (dead-lettering on or off, each SDK's existing meaning; for the `dead_letter` strategy with `off` see `expect.outcome_no_writer`). `dlq_write`: `ok` | `fails`, whether the write of the raw record to `<queue>.dlq` succeeds; absent = `ok` (ADR-0037). It is read only on rows whose `expect.outcome` writes a record (`dlq_raw` or `unsettled`); it is present on those rows, and also on the `dead_letter` strategy rows with `dead_letter: off`, where an SDK with a writable DLQ target writes and an SDK without a writer asserts `outcome_no_writer` instead. `bq_attempts`: optional, the `bq-attempts` property as a string; present only to show that the outcome does not depend on it (the rule applies on the first delivery, with no retry, whatever the attempts, the native redelivery count or the max-attempts setting say). `expect.outcome`: `ack` | `dlq_raw` (the raw record is written to `<queue>.dlq`, then the delivery is acknowledged) | `unsettled` (the write failed: the delivery is neither acknowledged nor retried by the SDK and the failure is reported; no `DeleteMessage`). With dead-lettering off and a strategy other than `dead_letter` the outcome is `native` (the SDK does not settle it and leaves it to the broker's native mechanism: SQS no `DeleteMessage`, so visibility expiry redelivers it and the queue's `RedrivePolicy` / retention applies; it is reported, not retried by the SDK). `expect.record` (only on `dlq_raw` rows): `incoming_body`, the record written to `<queue>.dlq` has a body equal to the incoming body byte for byte and carries no `dead_letter` block (no re-encoding, no ADR-0035 wrapping). A runner checks it against every body of `incoming_bodies`, which are deliberately not in canonical form, so a writer that decodes and re-encodes fails. `expect.outcome_no_writer`: optional; a runner for an SDK in which `dead_letter: off` means NO DLQ writer exists (no publisher, sender or queue URL) asserts it instead of `expect.outcome`. It is present exactly on the rows with strategy `dead_letter` and `dead_letter: off`, where the two kinds differ (here: `native`). Absent = both kinds assert `expect.outcome`. In every case the delivery is never decoded, no handler and no `onUnknownUrn` hook is called, and nothing is retried. The Laravel driver for this binding (if any) falls under the ADR-0037 decision 4 exception and reports every case of this section as `skip` with reason `ADR-0037 decision 4`; a package with no consumer for this binding (produce-only) follows the rule of the existing `sqs` / `artemis` binding sections (see README, \"Added in 1.8.0\"). Out of scope: Kafka (a version-gated record takes the section 6.5 poison path) and RabbitMQ.",
    "incoming_bodies": [
      {
        "name": "pretty-printed-escaped",
        "body": "{\n  \"job\": \"urn:babelqueue:order.created\",\n  \"data\": { \"name\": \"caf\\u00e9\", \"path\": \"a\\/b\" },\n  \"meta\": { \"schema_version\": 2 }\n}\n"
      },
      {
        "name": "key-order-and-number-forms",
        "body": "{\"meta\": {\"schema_version\": 2}, \"data\": {\"z\": 1, \"a\": 2, \"ratio\": 1.50, \"exp\": 1E2, \"big\": 12345678901234567890}, \"job\": \"urn:babelqueue:order.created\"}"
      },
      {
        "name": "not-json",
        "body": "plain text, not JSON  \t "
      }
    ],
    "cases": [
      {
        "name": "default-dlq-on-write-ok",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "default-dlq-on-write-fails",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "fail-dlq-on-write-ok",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "fail-dlq-on-write-fails",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "fail-dlq-on-write-ok-bq-attempts-7",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "ok",
        "bq_attempts": "7",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "release-dlq-on-write-ok",
        "on_unknown_urn": "release",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "release-dlq-on-write-fails",
        "on_unknown_urn": "release",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "delete-dlq-on-acks",
        "on_unknown_urn": "delete",
        "dead_letter": "on",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "delete-dlq-off-acks",
        "on_unknown_urn": "delete",
        "dead_letter": "off",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "dead-letter-dlq-on-write-ok",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "dead-letter-dlq-on-write-fails",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "default-dlq-off-native",
        "dead_letter": "off",
        "expect": {
          "outcome": "native"
        }
      },
      {
        "name": "fail-dlq-off-native",
        "on_unknown_urn": "fail",
        "dead_letter": "off",
        "expect": {
          "outcome": "native"
        }
      },
      {
        "name": "fail-dlq-off-native-bq-attempts-7",
        "on_unknown_urn": "fail",
        "dead_letter": "off",
        "bq_attempts": "7",
        "expect": {
          "outcome": "native"
        }
      },
      {
        "name": "release-dlq-off-native",
        "on_unknown_urn": "release",
        "dead_letter": "off",
        "expect": {
          "outcome": "native"
        }
      },
      {
        "name": "dead-letter-dlq-off-write-ok",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "off",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body",
          "outcome_no_writer": "native"
        }
      },
      {
        "name": "dead-letter-dlq-off-write-fails",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "off",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled",
          "outcome_no_writer": "native"
        }
      }
    ]
  },
  "version_gate_asb": {
    "description": "Version-gate settle rule for Azure Service Bus (broker-bindings.md section 4.7, application property `bq-schema-version`) (ADR-0037 decision 1; broker-bindings.md section 5.7 \"Version-gate settle rule\"). Scope: `asb`. A pure function, no broker: for each case compute how the consumer settles a delivery whose schema-version property is present, not null, not blank and not the supported version, and assert `expect`. Which property values are version-gated is NOT decided here: the `schema_version_gate` block of this binding already locks the trigger. A runner feeds the delivery a property value that gates (any of that block's rejected values, for example `2`). Case `{name, on_unknown_urn?, dead_letter, dlq_write?, bq_attempts?, expect}`. `on_unknown_urn`: `fail` | `delete` | `release` | `dead_letter`; absent = `fail`. A row with any value other than `fail` applies only to an SDK whose consumer has the strategy option; the Java, .NET and Node Azure Service Bus consumers have only an `onUnknownUrn` callback and no strategy option (they behave as `fail`), so a runner for one of them reports those rows as `skip` citing ADR-0037, not as `pass`; the Go and Python consumers have the option and assert every row. `release` behaves as `fail` for a version-gated delivery (it is never released). The version gate reads only the explicitly configured `on_unknown_urn` strategy; with none configured it is `fail`. An `onUnknownUrn` hook, any strategy a hook implies (a hook-only Java or Node SQS consumer would otherwise be `delete`) and a hook's precedence over the strategy (the .NET SQS consumer) do not affect it: the hook is for an unknown URN only, so a hook-only consumer settles these rows as `fail`. `dead_letter`: `on` | `off` (dead-lettering on or off, each SDK's existing meaning; for the `dead_letter` strategy with `off` see `expect.outcome_no_writer`). `dlq_write`: `ok` | `fails`, whether the write of the raw record to `<queue>.dlq` succeeds; absent = `ok` (ADR-0037). It is read only on rows whose `expect.outcome` writes a record (`dlq_raw` or `unsettled`); it is present on those rows, and also on the `dead_letter` strategy rows with `dead_letter: off`, where an SDK with a writable DLQ target writes and an SDK without a writer asserts `outcome_no_writer` instead. `bq_attempts`: optional, the `bq-attempts` property as a string; present only to show that the outcome does not depend on it (the rule applies on the first delivery, with no retry, whatever the attempts, the native redelivery count or the max-attempts setting say). `expect.outcome`: `ack` | `dlq_raw` (the raw record is written to `<queue>.dlq`, then the delivery is acknowledged) | `unsettled` (the write failed: the delivery is neither acknowledged nor retried by the SDK and the failure is reported; `Abandon`). With dead-lettering off and a strategy other than `dead_letter` the outcome is `native` (the SDK does not settle it and leaves it to the broker's native mechanism: an explicit native `DeadLetter(...)` into `$DeadLetterQueue` or `Abandon` until `MaxDeliveryCount`; it is reported, not retried by the SDK). `expect.record` (only on `dlq_raw` rows): `incoming_body`, the record written to `<queue>.dlq` has a body equal to the incoming body byte for byte and carries no `dead_letter` block (no re-encoding, no ADR-0035 wrapping). A runner checks it against every body of `incoming_bodies`, which are deliberately not in canonical form, so a writer that decodes and re-encodes fails. `expect.outcome_no_writer`: optional; a runner for an SDK in which `dead_letter: off` means NO DLQ writer exists (no publisher, sender or queue URL) asserts it instead of `expect.outcome`. It is present exactly on the rows with strategy `dead_letter` and `dead_letter: off`, where the two kinds differ (here: `native`). Absent = both kinds assert `expect.outcome`. In every case the delivery is never decoded, no handler and no `onUnknownUrn` hook is called, and nothing is retried. The Laravel driver for this binding (if any) falls under the ADR-0037 decision 4 exception and reports every case of this section as `skip` with reason `ADR-0037 decision 4`; a package with no consumer for this binding (produce-only) follows the rule of the existing `sqs` / `artemis` binding sections (see README, \"Added in 1.8.0\"). Out of scope: Kafka (a version-gated record takes the section 6.5 poison path) and RabbitMQ.",
    "incoming_bodies": [
      {
        "name": "pretty-printed-escaped",
        "body": "{\n  \"job\": \"urn:babelqueue:order.created\",\n  \"data\": { \"name\": \"caf\\u00e9\", \"path\": \"a\\/b\" },\n  \"meta\": { \"schema_version\": 2 }\n}\n"
      },
      {
        "name": "key-order-and-number-forms",
        "body": "{\"meta\": {\"schema_version\": 2}, \"data\": {\"z\": 1, \"a\": 2, \"ratio\": 1.50, \"exp\": 1E2, \"big\": 12345678901234567890}, \"job\": \"urn:babelqueue:order.created\"}"
      },
      {
        "name": "not-json",
        "body": "plain text, not JSON  \t "
      }
    ],
    "cases": [
      {
        "name": "default-dlq-on-write-ok",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "default-dlq-on-write-fails",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "fail-dlq-on-write-ok",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "fail-dlq-on-write-fails",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "fail-dlq-on-write-ok-bq-attempts-7",
        "on_unknown_urn": "fail",
        "dead_letter": "on",
        "dlq_write": "ok",
        "bq_attempts": "7",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "release-dlq-on-write-ok",
        "on_unknown_urn": "release",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "release-dlq-on-write-fails",
        "on_unknown_urn": "release",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "delete-dlq-on-acks",
        "on_unknown_urn": "delete",
        "dead_letter": "on",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "delete-dlq-off-acks",
        "on_unknown_urn": "delete",
        "dead_letter": "off",
        "expect": {
          "outcome": "ack"
        }
      },
      {
        "name": "dead-letter-dlq-on-write-ok",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "on",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body"
        }
      },
      {
        "name": "dead-letter-dlq-on-write-fails",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "on",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled"
        }
      },
      {
        "name": "default-dlq-off-native",
        "dead_letter": "off",
        "expect": {
          "outcome": "native"
        }
      },
      {
        "name": "fail-dlq-off-native",
        "on_unknown_urn": "fail",
        "dead_letter": "off",
        "expect": {
          "outcome": "native"
        }
      },
      {
        "name": "fail-dlq-off-native-bq-attempts-7",
        "on_unknown_urn": "fail",
        "dead_letter": "off",
        "bq_attempts": "7",
        "expect": {
          "outcome": "native"
        }
      },
      {
        "name": "release-dlq-off-native",
        "on_unknown_urn": "release",
        "dead_letter": "off",
        "expect": {
          "outcome": "native"
        }
      },
      {
        "name": "dead-letter-dlq-off-write-ok",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "off",
        "dlq_write": "ok",
        "expect": {
          "outcome": "dlq_raw",
          "record": "incoming_body",
          "outcome_no_writer": "native"
        }
      },
      {
        "name": "dead-letter-dlq-off-write-fails",
        "on_unknown_urn": "dead_letter",
        "dead_letter": "off",
        "dlq_write": "fails",
        "expect": {
          "outcome": "unsettled",
          "outcome_no_writer": "native"
        }
      }
    ]
  },
  "span-shape": {
    "description": "OpenTelemetry span shape (ADR-0038, semantic conventions v1.44.0). Scope: `otel` (ADR-0032 section 2). Every case has `mode: span` and describes one producer span (`operation: send`) or one consumer span (`operation: process`) for one message. Inputs: `operation`; `system` (the `system` option; absent or empty means `babelqueue`); `queue` (send: the queue/topic given to `make`, which becomes `meta.queue` of the produced envelope, and when it is absent `make` writes `default`; process: `meta.queue` of the delivered envelope; empty or blank under the ASCII whitespace set means no destination, and so does an absent `meta.queue` on a delivered envelope); `urn` (the `job`); `consumer_group` (the option, process only); for `process` cases `trace_id`, `message_id` (`meta.id`), `attempts` and `schema_version` (the delivered envelope's `trace_id`, `meta.id`, top-level `attempts` and `meta.schema_version`); `outcome` (`ok`, or `error` for a failing publish or handler); `envelope_built: false` (send only: no envelope is ever handed to the transport, because the build or the encode failed; an envelope counts as built only once it has been handed to the transport). A runner builds the span through the SDK's `otel` wrapper (with an in-memory exporter) and compares. PRODUCER VALUES: a producer does not control `meta.id` (each SDK generates it) and stamps the active trace's id into `trace_id` (ADR-0028, ADR-0038 section 4), so `send` cases carry no `message_id` or `trace_id` input. Their expectations use the placeholders `$produced.meta.id` and `$produced.trace_id` for `messaging.message.id` and `messaging.message.conversation_id`, and, where the case gives no usable queue (absent, empty or blank), `$produced.meta.queue` for `messaging.destination.name` and the span name suffix (when the produced `meta.queue` is empty or blank the attribute is absent and the name is the bare `send`): the runner reads the produced envelope (the envelope handed to the transport, also when that publish fails), substitutes the placeholders and compares the rest literally. The `meta.id` and `trace_id` values MUST be present and equal the produced envelope's. Where a `process` case fixes the delivered envelope, the runner builds the delivered envelope itself and may bypass the decoder for the cases that omit fields the envelope schema requires (an absent or empty `meta.queue`, an absent `meta.id`). `expect.span_name` and `expect.span_kind` are exact; `expect.span_name_one_of` replaces `span_name` where the case does not pin the name. ATTRIBUTES: every key of `expect.attributes` MUST be present with exactly the given value (strings; integers for `babelqueue.schema_version`, `babelqueue.attempts` and `messaging.babelqueue.attempts`). The ADR-0038 section 4 table keys are `messaging.system`, `messaging.operation.type`, `messaging.operation.name`, `messaging.destination.name`, `messaging.message.id`, `messaging.message.conversation_id`, `messaging.consumer.group.name`, `babelqueue.urn`, `babelqueue.schema_version`, `babelqueue.attempts`, `error.type`, and the deprecated transition keys `messaging.operation` and `messaging.babelqueue.attempts`. A table key that `expect.attributes` does not list MUST NOT be on the span, except those in `expect.optional_attributes`, which may be present or absent; when an optional attribute is present it MUST equal the value the case input implies (for `messaging.destination.name` the queue given to the producer) and the span name MUST agree with it. Any `babelqueue.*` key outside the table MUST NOT be on the span. A semconv-defined attribute outside the table (for example `messaging.destination.partition.id`) MAY be present: the suite asserts only the tables (ADR-0038 section 4, last note). The attributes include the deprecated transition keys, which ADR-0038 section 5 dual-emits for one MINOR; the conformance version that follows their removal drops them from every case. `expect.status` is `unset` or `error`. On `error` cases `expect.error_type` is `present`: the span MUST carry a non-empty string `error.type` (its value is a language-specific type name and is not asserted) and `attributes` omits `error.type`; on `ok` cases the span MUST NOT carry `error.type`. The URN is never in the span name. `messaging.system` values outside the ADR-0038 section 3 set are written as given.",
    "cases": [
      {
        "name": "send-default-system",
        "mode": "span",
        "operation": "send",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send orders",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "orders",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        },
        "description": "No `system` option: `messaging.system` is `babelqueue` (the deprecated default, ADR-0038 section 5). Span name is `send <queue>`, never the URN."
      },
      {
        "name": "send-system-redis",
        "mode": "span",
        "operation": "send",
        "system": "redis",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send orders",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "redis",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "orders",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        }
      },
      {
        "name": "send-system-rabbitmq",
        "mode": "span",
        "operation": "send",
        "system": "rabbitmq",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send orders",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "rabbitmq",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "orders",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        }
      },
      {
        "name": "send-system-aws_sqs",
        "mode": "span",
        "operation": "send",
        "system": "aws_sqs",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send orders",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "aws_sqs",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "orders",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        }
      },
      {
        "name": "send-system-servicebus",
        "mode": "span",
        "operation": "send",
        "system": "servicebus",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send orders",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "servicebus",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "orders",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        }
      },
      {
        "name": "send-system-pulsar",
        "mode": "span",
        "operation": "send",
        "system": "pulsar",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send orders",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "pulsar",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "orders",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        }
      },
      {
        "name": "send-system-kafka",
        "mode": "span",
        "operation": "send",
        "system": "kafka",
        "queue": "orders.events",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send orders.events",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "kafka",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "orders.events",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        }
      },
      {
        "name": "send-system-activemq",
        "mode": "span",
        "operation": "send",
        "system": "activemq",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send orders",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "activemq",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "orders",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        }
      },
      {
        "name": "send-system-custom-not-validated",
        "mode": "span",
        "operation": "send",
        "system": "my-broker",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send orders",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "my-broker",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "orders",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        },
        "description": "A `system` outside the ADR-0038 section 3 set is written as given: no error, no warning, no normalisation."
      },
      {
        "name": "send-empty-system-counts-as-absent",
        "mode": "span",
        "operation": "send",
        "system": "",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send orders",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "orders",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        },
        "description": "An empty `system` counts as absent (ADR-0038 section 3): `messaging.system` is `babelqueue`."
      },
      {
        "name": "send-empty-queue-follows-produced-meta-queue",
        "mode": "span",
        "operation": "send",
        "queue": "",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send $produced.meta.queue",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "$produced.meta.queue",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        },
        "description": "An empty queue is given to the producer. What the produced envelope then carries is the SDK's business (Python and Go fall back to the app's default queue, others may keep the empty string), and ADR-0038 section 4 makes the destination `meta.queue` of the produced envelope. So the expectation uses the placeholder `$produced.meta.queue`: if the produced `meta.queue` is empty or blank, `messaging.destination.name` is not written and the span name is the bare `send`; otherwise the attribute equals it and the span name is `send <meta.queue>`. `babelqueue.urn` is always written."
      },
      {
        "name": "send-absent-queue-follows-produced-meta-queue",
        "mode": "span",
        "operation": "send",
        "urn": "urn:acme:order.created",
        "outcome": "ok",
        "expect": {
          "span_name": "send $produced.meta.queue",
          "span_kind": "PRODUCER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "$produced.meta.queue",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        },
        "description": "No queue given to the producer: the envelope carries the SDK's default (`default` from `make`, or the app's configured default queue), and the producer destination equals `meta.queue` of the produced envelope (ADR-0038 section 4). The expectation uses the placeholder `$produced.meta.queue` with the same rule as the empty-queue case."
      },
      {
        "name": "send-failure-after-envelope-built",
        "mode": "span",
        "operation": "send",
        "system": "rabbitmq",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "outcome": "error",
        "expect": {
          "span_name": "send orders",
          "span_kind": "PRODUCER",
          "status": "error",
          "error_type": "present",
          "attributes": {
            "messaging.system": "rabbitmq",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "messaging.destination.name": "orders",
            "messaging.message.id": "$produced.meta.id",
            "messaging.message.conversation_id": "$produced.trace_id",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          }
        },
        "description": "The publish fails after the envelope was handed to the transport (so it exists and the runner can read it): status Error, `error.type` present and non-empty (its value is language-specific and not asserted, ADR-0038 section 6). `error.type` is therefore not in `attributes`; every other attribute is unchanged."
      },
      {
        "name": "send-failure-before-envelope-built",
        "mode": "span",
        "operation": "send",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "envelope_built": false,
        "outcome": "error",
        "expect": {
          "span_name_one_of": [
            "send",
            "send orders"
          ],
          "span_kind": "PRODUCER",
          "status": "error",
          "error_type": "present",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "send",
            "messaging.operation.name": "send",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "messaging.operation": "publish"
          },
          "optional_attributes": [
            "messaging.destination.name"
          ]
        },
        "description": "The build or the encode fails (for example a `data` payload the encoder rejects, which in Go and Python is an encode failure after a successful `make`), so no envelope is handed to the transport and none exists for the span: `messaging.message.id` and `messaging.message.conversation_id` are not written (ADR-0038 section 4: once the envelope exists; an envelope that was built but never handed to the transport does not count). The producer SHOULD resolve the queue before it starts the span but MAY learn it only after the build (ADR-0038 section 4), so the case does not pin the destination: `messaging.destination.name` is optional (`expect.optional_attributes`; when present it MUST equal the queue given to the producer, here `orders`, and then the span name is `send orders`, otherwise the bare `send`) and the span name is either of `expect.span_name_one_of`. The runner makes the envelope build fail by an SDK-specific means (for example a `data` payload the encoder rejects)."
      },
      {
        "name": "process-default-system",
        "mode": "span",
        "operation": "process",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "No `system` option: `messaging.system` is `babelqueue`. Span name is `process <queue>`, never the URN; the URN is `babelqueue.urn`."
      },
      {
        "name": "process-system-redis",
        "mode": "span",
        "operation": "process",
        "system": "redis",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "redis",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        }
      },
      {
        "name": "process-system-rabbitmq",
        "mode": "span",
        "operation": "process",
        "system": "rabbitmq",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "rabbitmq",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        }
      },
      {
        "name": "process-system-aws_sqs",
        "mode": "span",
        "operation": "process",
        "system": "aws_sqs",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "aws_sqs",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        }
      },
      {
        "name": "process-system-servicebus",
        "mode": "span",
        "operation": "process",
        "system": "servicebus",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "servicebus",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        }
      },
      {
        "name": "process-system-pulsar",
        "mode": "span",
        "operation": "process",
        "system": "pulsar",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "pulsar",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        }
      },
      {
        "name": "process-system-kafka",
        "mode": "span",
        "operation": "process",
        "system": "kafka",
        "queue": "orders.events",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders.events",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "kafka",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders.events",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        }
      },
      {
        "name": "process-system-activemq",
        "mode": "span",
        "operation": "process",
        "system": "activemq",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "activemq",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        }
      },
      {
        "name": "process-system-custom-not-validated",
        "mode": "span",
        "operation": "process",
        "system": "my-broker",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "my-broker",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "A `system` outside the ADR-0038 section 3 set is written as given."
      },
      {
        "name": "process-empty-system-counts-as-absent",
        "mode": "span",
        "operation": "process",
        "system": "",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "An empty `system` counts as absent (ADR-0038 section 3)."
      },
      {
        "name": "process-kafka-consumer-group",
        "mode": "span",
        "operation": "process",
        "system": "kafka",
        "queue": "orders.events",
        "urn": "urn:acme:order.created",
        "consumer_group": "billing-workers",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders.events",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "kafka",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders.events",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "messaging.consumer.group.name": "billing-workers",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "Kafka with the `consumer_group` option: `messaging.consumer.group.name` is written."
      },
      {
        "name": "process-consumer-group-on-non-kafka-system",
        "mode": "span",
        "operation": "process",
        "system": "rabbitmq",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "consumer_group": "billing-workers",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "rabbitmq",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "messaging.consumer.group.name": "billing-workers",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "`consumer_group` is intended for Kafka but is written whenever given (ADR-0038 section 2)."
      },
      {
        "name": "process-no-consumer-group-option",
        "mode": "span",
        "operation": "process",
        "system": "kafka",
        "queue": "orders.events",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders.events",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "kafka",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders.events",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "Kafka without the `consumer_group` option: `messaging.consumer.group.name` is not written."
      },
      {
        "name": "process-empty-queue",
        "mode": "span",
        "operation": "process",
        "queue": "",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "`meta.queue` is empty: span name is the bare `process`, `messaging.destination.name` is not written, `babelqueue.urn` is."
      },
      {
        "name": "process-absent-queue",
        "mode": "span",
        "operation": "process",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "`meta.queue` is absent: same as an empty queue."
      },
      {
        "name": "process-blank-queue",
        "mode": "span",
        "operation": "process",
        "queue": "   ",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "`meta.queue` is blank under the ASCII whitespace set (ADR-0038 section 4: absent or blank): treated as no destination."
      },
      {
        "name": "process-absent-message-id",
        "mode": "span",
        "operation": "process",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "`meta.id` is absent: `messaging.message.id` is not written (ADR-0038 section 4: when present)."
      },
      {
        "name": "process-attempts-zero",
        "mode": "span",
        "operation": "process",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "`attempts` 0: `babelqueue.attempts` and the deprecated `messaging.babelqueue.attempts` are both written, with 0."
      },
      {
        "name": "process-attempts-positive",
        "mode": "span",
        "operation": "process",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 3,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 3,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 3
          }
        },
        "description": "`attempts` 3: both `babelqueue.attempts` and the deprecated `messaging.babelqueue.attempts` are 3."
      },
      {
        "name": "process-non-uuid-trace-id",
        "mode": "span",
        "operation": "process",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "abc",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "abc",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "A non-UUID `trace_id` is written to `messaging.message.conversation_id` byte for byte (ADR-0038 section 4 and 7)."
      },
      {
        "name": "process-trace-id-with-inner-spaces",
        "mode": "span",
        "operation": "process",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": "order 42 / trace",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "order 42 / trace",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "A non-UUID `trace_id` with inner spaces is written byte for byte."
      },
      {
        "name": "process-padded-trace-id",
        "mode": "span",
        "operation": "process",
        "queue": "orders",
        "urn": "urn:acme:order.created",
        "trace_id": " 7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\t",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 0,
        "schema_version": 1,
        "outcome": "ok",
        "expect": {
          "span_name": "process orders",
          "span_kind": "CONSUMER",
          "status": "unset",
          "attributes": {
            "messaging.system": "babelqueue",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": " 7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\t",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 0,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 0
          }
        },
        "description": "A `trace_id` with surrounding ASCII whitespace is written byte for byte: no trim on consume (ADR-0032, message-envelope.md section 5.1)."
      },
      {
        "name": "process-handler-failure",
        "mode": "span",
        "operation": "process",
        "system": "kafka",
        "queue": "orders.events",
        "urn": "urn:acme:order.created",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "message_id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
        "attempts": 2,
        "schema_version": 1,
        "outcome": "error",
        "expect": {
          "span_name": "process orders.events",
          "span_kind": "CONSUMER",
          "status": "error",
          "error_type": "present",
          "attributes": {
            "messaging.system": "kafka",
            "messaging.operation.type": "process",
            "messaging.operation.name": "process",
            "messaging.destination.name": "orders.events",
            "messaging.message.id": "0b6f3e1c-5d2a-4c7e-9a41-8f3d2b6c1e90",
            "messaging.message.conversation_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
            "babelqueue.urn": "urn:acme:order.created",
            "babelqueue.schema_version": 1,
            "babelqueue.attempts": 2,
            "messaging.operation": "process",
            "messaging.babelqueue.attempts": 2
          }
        },
        "description": "The handler fails: status Error, `error.type` present and non-empty (value not asserted, ADR-0038 section 6), error recorded, error returned to the caller unchanged. Every other attribute is as on success."
      }
    ]
  },
  "trace-id": {
    "description": "Non-UUID `trace_id` rule and the OpenTelemetry TraceID mapping (ADR-0038 section 7, message-envelope.md sections 5.1 and 7 rule 2, ADR-0025, ADR-0032 section 5). Scope: `otel` (ADR-0032 section 2). Every case has a `mode`. `map`: the OTel mapping of `trace_id` MUST give `expect.trace_id_hex` (32 lower-case hex digits) through `expect.mapping`: `decode` (the value is 32 hex digits once the hyphens are removed and is not all zero: the bytes of the UUID, no hashing) or `hash` (SHA-256 of the value's UTF-8 bytes, first 16 bytes). The edge cases are pinned to the Go reference `otel.TraceIDOf`: hyphens are optional, hex is case-insensitive, the all-zero value is hashed because it is not a valid TraceID, and there is no trim, so a value with a leading or trailing ASCII space is hashed over its raw bytes. `decode`: decoding an envelope that carries `trace_id` succeeds and the decoded `trace_id` equals `expect.trace_id` byte for byte (no rejection, no regeneration). `reemit`: decode, increment `attempts`, re-encode: the written `trace_id` equals `expect.trace_id` byte for byte; re-emit never trims. `downstream`: a consumer handling an envelope produces a downstream message with `make(urn, trace_id)` given the inbound value: the produced `trace_id` equals `expect.trace_id` and `make` does not raise (no value here has ASCII padding, so the ADR-0032 trim is a no-op). `make`: the producer's `make` with a caller-supplied `trace_id` (and `urn`) produces an envelope whose `trace_id` equals `expect.trace_id`, the ADR-0032 trimmed value, never rejected and never regenerated; `expect.trace_id_hex` is the OTel mapping of that stored value. The warning the mapping SHOULD log when it hashes a value (message-envelope.md section 5.1) is not asserted.",
    "cases": [
      {
        "name": "uuid-lowercase-hyphenated",
        "mode": "map",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b",
          "mapping": "decode"
        },
        "description": "A UUID decodes to its 16 bytes: `trace_id_hex` is the value without hyphens."
      },
      {
        "name": "uuid-lowercase-hyphenated-other",
        "mode": "map",
        "trace_id": "4bf92f35-77b3-4da6-a3ce-929d0e0e4736",
        "expect": {
          "trace_id_hex": "4bf92f3577b34da6a3ce929d0e0e4736",
          "mapping": "decode"
        }
      },
      {
        "name": "uuid-without-hyphens",
        "mode": "map",
        "trace_id": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b",
        "expect": {
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b",
          "mapping": "decode"
        },
        "description": "32 hex digits without hyphens decode as a UUID and are not hashed (Go reference `TraceIDOf`)."
      },
      {
        "name": "uuid-uppercase-hyphenated",
        "mode": "map",
        "trace_id": "7B3F9C2A-E41D-4F88-9B2A-1C0D5E6F7A8B",
        "expect": {
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b",
          "mapping": "decode"
        },
        "description": "Upper-case hex decodes (not hashed); `trace_id_hex` is the lower-case form of the bytes."
      },
      {
        "name": "uuid-uppercase-without-hyphens",
        "mode": "map",
        "trace_id": "7B3F9C2AE41D4F889B2A1C0D5E6F7A8B",
        "expect": {
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b",
          "mapping": "decode"
        }
      },
      {
        "name": "uuid-mixed-case",
        "mode": "map",
        "trace_id": "7b3F9c2A-e41D-4f88-9B2a-1c0D5e6F7a8B",
        "expect": {
          "trace_id_hex": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b",
          "mapping": "decode"
        }
      },
      {
        "name": "all-zero-uuid-is-hashed",
        "mode": "map",
        "trace_id": "00000000-0000-0000-0000-000000000000",
        "expect": {
          "trace_id_hex": "12b9377cbe7e5c94e8a70d9d23929523",
          "mapping": "hash"
        },
        "description": "The all-zero UUID is not a valid TraceID, so it is hashed (SHA-256 of the UTF-8 bytes, first 16 bytes)."
      },
      {
        "name": "all-zero-without-hyphens-is-hashed",
        "mode": "map",
        "trace_id": "00000000000000000000000000000000",
        "expect": {
          "trace_id_hex": "84e0c0eafaa95a34c293f278ac52e45c",
          "mapping": "hash"
        }
      },
      {
        "name": "non-uuid-short",
        "mode": "map",
        "trace_id": "abc",
        "expect": {
          "trace_id_hex": "ba7816bf8f01cfea414140de5dae2223",
          "mapping": "hash"
        },
        "description": "A value that is not a UUID is hashed: SHA-256 of the UTF-8 bytes, first 16 bytes (ADR-0025, ADR-0038 section 7)."
      },
      {
        "name": "non-uuid-dashed-word",
        "mode": "map",
        "trace_id": "not-a-uuid",
        "expect": {
          "trace_id_hex": "2184a32a3bae6ad756d745ec8678ad6a",
          "mapping": "hash"
        }
      },
      {
        "name": "non-uuid-inner-spaces",
        "mode": "map",
        "trace_id": "order 42 trace",
        "expect": {
          "trace_id_hex": "d31787beda85c54d582034d147738486",
          "mapping": "hash"
        }
      },
      {
        "name": "non-uuid-with-slash-and-colon",
        "mode": "map",
        "trace_id": "req/2026-10-31:abc",
        "expect": {
          "trace_id_hex": "23ca4f77c10633c877479239a3510ccf",
          "mapping": "hash"
        }
      },
      {
        "name": "non-uuid-non-ascii",
        "mode": "map",
        "trace_id": "izleme-\u65e5\u672c\u8a9e-\u00df",
        "expect": {
          "trace_id_hex": "a9ff8aedaf39e2ed7fbe36ddeee77627",
          "mapping": "hash"
        },
        "description": "Hashed over the UTF-8 bytes of the value."
      },
      {
        "name": "non-uuid-32-chars-not-hex",
        "mode": "map",
        "trace_id": "zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz",
        "expect": {
          "trace_id_hex": "a9ca111109de4c6a0d65d6b25588f771",
          "mapping": "hash"
        }
      },
      {
        "name": "non-uuid-31-hex-digits",
        "mode": "map",
        "trace_id": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8",
        "expect": {
          "trace_id_hex": "fe89ad340d456da74a71a468e51bdda6",
          "mapping": "hash"
        }
      },
      {
        "name": "non-uuid-33-hex-digits",
        "mode": "map",
        "trace_id": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b0",
        "expect": {
          "trace_id_hex": "4e80c1ce29e48dbb79ba44854128afc9",
          "mapping": "hash"
        }
      },
      {
        "name": "non-uuid-urn-uuid-prefix",
        "mode": "map",
        "trace_id": "urn:uuid:7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "trace_id_hex": "71553c8bc2cb2685b813e18d0bd074fa",
          "mapping": "hash"
        }
      },
      {
        "name": "uuid-with-leading-space-is-hashed",
        "mode": "map",
        "trace_id": " 7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b",
        "expect": {
          "trace_id_hex": "a0c7cfbf156086cc3ca3aee6a2fc5e51",
          "mapping": "hash"
        },
        "description": "No trim before the mapping: a leading ASCII space makes the value non-UUID, so the raw value (space included) is hashed."
      },
      {
        "name": "uuid-with-trailing-space-is-hashed",
        "mode": "map",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b ",
        "expect": {
          "trace_id_hex": "d93dfd3c387a0dbccaee2e95d0639b6d",
          "mapping": "hash"
        },
        "description": "No trim before the mapping: a trailing ASCII space makes the value non-UUID, so the raw value is hashed."
      },
      {
        "name": "uuid-with-tab-and-newline-is-hashed",
        "mode": "map",
        "trace_id": "\t7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\n",
        "expect": {
          "trace_id_hex": "d9cf62d0e40c6639ee7131da53b3a920",
          "mapping": "hash"
        }
      },
      {
        "name": "uuid-with-trailing-newline-is-hashed",
        "mode": "map",
        "trace_id": "7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\n",
        "expect": {
          "trace_id_hex": "4e72d2e2f40df8529256d33c375dfe8c",
          "mapping": "hash"
        },
        "description": "A trailing newline alone makes the value non-UUID: it is hashed over the raw bytes, newline included. An implementation whose end-anchor matches before a final newline (PCRE `$`, Python `re.match` with `$`) would wrongly decode it."
      },
      {
        "name": "uuid-without-hyphens-with-trailing-newline-is-hashed",
        "mode": "map",
        "trace_id": "7b3f9c2ae41d4f889b2a1c0d5e6f7a8b\n",
        "expect": {
          "trace_id_hex": "2092f9b3cbf4e482796b67febc62c85e",
          "mapping": "hash"
        }
      },
      {
        "name": "decode-preserves-1",
        "mode": "decode",
        "trace_id": "abc",
        "expect": {
          "decoded": true,
          "trace_id": "abc"
        },
        "description": "Decoding an envelope whose `trace_id` is not a UUID succeeds and leaves the value byte for byte; it is neither rejected nor regenerated (message-envelope.md section 5.1)."
      },
      {
        "name": "decode-preserves-2",
        "mode": "decode",
        "trace_id": "order 42 trace",
        "expect": {
          "decoded": true,
          "trace_id": "order 42 trace"
        },
        "description": "Same rule."
      },
      {
        "name": "decode-preserves-3",
        "mode": "decode",
        "trace_id": "req/2026-10-31:abc",
        "expect": {
          "decoded": true,
          "trace_id": "req/2026-10-31:abc"
        },
        "description": "Same rule."
      },
      {
        "name": "decode-preserves-4",
        "mode": "decode",
        "trace_id": "izleme-\u65e5\u672c\u8a9e-\u00df",
        "expect": {
          "decoded": true,
          "trace_id": "izleme-\u65e5\u672c\u8a9e-\u00df"
        },
        "description": "Same rule."
      },
      {
        "name": "decode-preserves-5",
        "mode": "decode",
        "trace_id": " abc\t",
        "expect": {
          "decoded": true,
          "trace_id": " abc\t"
        },
        "description": "Re-emit never trims: surrounding ASCII whitespace is kept byte for byte (ADR-0032 section 5)."
      },
      {
        "name": "decode-preserves-6",
        "mode": "decode",
        "trace_id": " 7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\t",
        "expect": {
          "decoded": true,
          "trace_id": " 7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\t"
        },
        "description": "Same rule."
      },
      {
        "name": "reemit-preserves-1",
        "mode": "reemit",
        "trace_id": "abc",
        "expect": {
          "trace_id": "abc"
        },
        "description": "Re-emit of the decoded envelope (retry, DLQ, redrive, relay) writes the same `trace_id`, byte for byte."
      },
      {
        "name": "reemit-preserves-2",
        "mode": "reemit",
        "trace_id": "order 42 trace",
        "expect": {
          "trace_id": "order 42 trace"
        },
        "description": "Same rule."
      },
      {
        "name": "reemit-preserves-3",
        "mode": "reemit",
        "trace_id": "req/2026-10-31:abc",
        "expect": {
          "trace_id": "req/2026-10-31:abc"
        },
        "description": "Same rule."
      },
      {
        "name": "reemit-preserves-4",
        "mode": "reemit",
        "trace_id": "izleme-\u65e5\u672c\u8a9e-\u00df",
        "expect": {
          "trace_id": "izleme-\u65e5\u672c\u8a9e-\u00df"
        },
        "description": "Same rule."
      },
      {
        "name": "reemit-preserves-5",
        "mode": "reemit",
        "trace_id": " abc\t",
        "expect": {
          "trace_id": " abc\t"
        },
        "description": "Re-emit never trims: surrounding ASCII whitespace is kept byte for byte (ADR-0032 section 5)."
      },
      {
        "name": "reemit-preserves-6",
        "mode": "reemit",
        "trace_id": " 7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\t",
        "expect": {
          "trace_id": " 7b3f9c2a-e41d-4f88-9b2a-1c0d5e6f7a8b\t"
        },
        "description": "Same rule."
      },
      {
        "name": "downstream-copies-1",
        "mode": "downstream",
        "trace_id": "abc",
        "expect": {
          "trace_id": "abc"
        },
        "description": "A handler produces a downstream message with the inbound `trace_id` (`make` given that value): the produced envelope carries it unchanged and `make` does not reject it (message-envelope.md section 5.1). Only values with no ASCII padding are used, so the ADR-0032 trim is a no-op here."
      },
      {
        "name": "downstream-copies-2",
        "mode": "downstream",
        "trace_id": "order 42 trace",
        "expect": {
          "trace_id": "order 42 trace"
        },
        "description": "Same rule."
      },
      {
        "name": "downstream-copies-3",
        "mode": "downstream",
        "trace_id": "req/2026-10-31:abc",
        "expect": {
          "trace_id": "req/2026-10-31:abc"
        },
        "description": "Same rule."
      },
      {
        "name": "downstream-copies-4",
        "mode": "downstream",
        "trace_id": "izleme-\u65e5\u672c\u8a9e-\u00df",
        "expect": {
          "trace_id": "izleme-\u65e5\u672c\u8a9e-\u00df"
        },
        "description": "Same rule."
      },
      {
        "name": "make-keeps-non-uuid-trace-id",
        "mode": "make",
        "urn": "urn:acme:a",
        "trace_id": "abc",
        "expect": {
          "trace_id": "abc",
          "trace_id_hex": "ba7816bf8f01cfea414140de5dae2223"
        },
        "description": "`make` with a caller-supplied non-UUID `trace_id`: the envelope carries it (only the ADR-0032 ASCII trim applies); no rejection, no regenerated UUID."
      },
      {
        "name": "make-keeps-non-uuid-with-inner-spaces",
        "mode": "make",
        "urn": "urn:acme:a",
        "trace_id": "order  42  trace",
        "expect": {
          "trace_id": "order  42  trace",
          "trace_id_hex": "62e4e86cf9f3cd31fa7beabd74380fae"
        },
        "description": "Inner whitespace is part of the value; only the ends are trimmed."
      },
      {
        "name": "make-trims-ascii-padding-of-non-uuid",
        "mode": "make",
        "urn": "urn:acme:a",
        "trace_id": " \torder 42 trace\n",
        "expect": {
          "trace_id": "order 42 trace",
          "trace_id_hex": "d31787beda85c54d582034d147738486"
        },
        "description": "ASCII padding is trimmed by `make` (ADR-0032 section 5) and nothing else changes; the stored value is the trimmed one."
      },
      {
        "name": "make-keeps-unicode-space-padding-of-non-uuid",
        "mode": "make",
        "urn": "urn:acme:a",
        "trace_id": "\u00a0abc\u00a0",
        "expect": {
          "trace_id": "\u00a0abc\u00a0",
          "trace_id_hex": "fb3da941d20933c9f0bc0dece6a173d5"
        },
        "description": "U+00A0 is not ASCII whitespace (ADR-0032 section 5): it stays in the value."
      },
      {
        "name": "make-keeps-all-zero-uuid",
        "mode": "make",
        "urn": "urn:acme:a",
        "trace_id": "00000000-0000-0000-0000-000000000000",
        "expect": {
          "trace_id": "00000000-0000-0000-0000-000000000000",
          "trace_id_hex": "12b9377cbe7e5c94e8a70d9d23929523"
        },
        "description": "The all-zero UUID is a non-UUID for the OTel mapping, but `make` still carries it as given: only the mapping hashes it."
      }
    ]
  },
  "metrics": {
    "description": "Standard metric set and the dead-letter observer (ADR-0039, semantic conventions v1.44.0). Scope: `otel` (ADR-0032 section 2). Every case has a `mode`. `instrument`: the metric `expect.metric` MUST exist with `expect.instrument` (`histogram` | `counter`), `expect.unit` and exactly this attribute key set: `attributes.always`, `attributes.when_destination_known` (written only when the destination is known: present and not blank) and `attributes.on_failure` (written only when the operation failed); `operation_name` is the value of `messaging.operation.name`; none of `forbidden_attributes` may appear (cardinality limit, ADR-0039 section 2). `advisory_bucket_boundaries` (the histogram's advice) is a SHOULD, applied where the platform API supports advice, and is not asserted otherwise. `publish`, `consume` and `dead_letter`: the scenario drives the SDK's producer wrapper, consumer wrapper or dead-letter observer (in the `otel` module) with a meter backed by an in-memory reader, then the metric data points recorded MUST equal `expect.records` as a multiset and nothing else may be recorded. A `records` entry has `metric`, `kind` (`add`: a counter increment of `value`; `record`: one histogram observation, `value` `non_negative_seconds` meaning a finite value >= 0 that is not otherwise asserted), the exact `attributes` map (string values), and `error_type: present` when the data point MUST also carry a non-empty string `error.type` (its value is language-specific and not asserted; `attributes` omits it). Inputs: `system` (the `system` option; absent or empty means `babelqueue`), `queue` (consume: `meta.queue`, where absent, empty or blank means no destination; publish: the queue given to the producer, where an absent, empty or blank queue is resolved by the SDK and the destination is `$produced.meta.queue`, the produced envelope's `meta.queue`, written only when it is not empty or blank), `attempts` (consume: top-level `attempts`), `outcome` (`ok` | `error`; for `publish` an error is a failure of the transport after the envelope was handed to it, for `consume` an error returned or raised by the wrapped handler), `meter: false` (no meter supplied, nothing is recorded). The `dead_letter` cases are defined at the level of the observer event `{queue, dead_letter_queue, reason}` so a runner needs no broker: `trigger` says what the SDK did, `observer_called` says whether the core invokes the dead-letter observer with `event` (true) or not at all (false, `records` empty). The rule (ADR-0039 section 5.1, owner decision 2026-10-31): a successful write to the BabelQueue DLQ counts (+1), and so does a successful SDK-initiated native dead-letter (+1, same attribute set, no native/BabelQueue distinction, `dead_letter_queue` empty); a failed write, a failed native call, a native no-op (SQS), a broker-autonomous dead-letter and a disabled DLQ count 0. The SDKs' own tests (ADR-0039 sections 5.2-5.3) drive their transports to the trigger; conformance pins the observer-level contract. A case with `observer_called: false` also has `sdk_test_required: true`: it states a rule a runner cannot test at observer level (no event is delivered, so nothing is recorded, whatever the SDK does), so the runner reports it `pass` trivially and the rule is only enforced by the SDK's own transport or core test, which MUST assert that the observer is not called for that trigger.",
    "cases": [
      {
        "name": "instrument-messaging-process-duration",
        "mode": "instrument",
        "when": "once per handler invocation: the handler's wall time in seconds, success or failure",
        "expect": {
          "metric": "messaging.process.duration",
          "instrument": "histogram",
          "unit": "s",
          "recorded_by": "consumer wrapper",
          "operation_name": "process",
          "attributes": {
            "always": [
              "messaging.system",
              "messaging.operation.name"
            ],
            "when_destination_known": [
              "messaging.destination.name"
            ],
            "on_failure": [
              "error.type"
            ]
          },
          "forbidden_attributes": [
            "babelqueue.urn",
            "messaging.message.id",
            "messaging.message.conversation_id",
            "babelqueue.attempts",
            "babelqueue.schema_version",
            "messaging.consumer.group.name",
            "dead_letter.reason",
            "trace_id"
          ],
          "advisory_bucket_boundaries": [
            0.005,
            0.01,
            0.025,
            0.05,
            0.075,
            0.1,
            0.25,
            0.5,
            0.75,
            1,
            2.5,
            5,
            7.5,
            10
          ]
        }
      },
      {
        "name": "instrument-messaging-client-sent-messages",
        "mode": "instrument",
        "when": "+1 per publish attempt, success or failure",
        "expect": {
          "metric": "messaging.client.sent.messages",
          "instrument": "counter",
          "unit": "{message}",
          "recorded_by": "producer wrapper",
          "operation_name": "send",
          "attributes": {
            "always": [
              "messaging.system",
              "messaging.operation.name"
            ],
            "when_destination_known": [
              "messaging.destination.name"
            ],
            "on_failure": [
              "error.type"
            ]
          },
          "forbidden_attributes": [
            "babelqueue.urn",
            "messaging.message.id",
            "messaging.message.conversation_id",
            "babelqueue.attempts",
            "babelqueue.schema_version",
            "messaging.consumer.group.name",
            "dead_letter.reason",
            "trace_id"
          ]
        }
      },
      {
        "name": "instrument-messaging-client-consumed-messages",
        "mode": "instrument",
        "when": "+1 per delivery that enters the wrapper (no `error.type`: the delivery was received)",
        "expect": {
          "metric": "messaging.client.consumed.messages",
          "instrument": "counter",
          "unit": "{message}",
          "recorded_by": "consumer wrapper",
          "operation_name": "process",
          "attributes": {
            "always": [
              "messaging.system",
              "messaging.operation.name"
            ],
            "when_destination_known": [
              "messaging.destination.name"
            ]
          },
          "forbidden_attributes": [
            "babelqueue.urn",
            "messaging.message.id",
            "messaging.message.conversation_id",
            "babelqueue.attempts",
            "babelqueue.schema_version",
            "messaging.consumer.group.name",
            "dead_letter.reason",
            "trace_id"
          ]
        }
      },
      {
        "name": "instrument-babelqueue-retries",
        "mode": "instrument",
        "when": "+1 per delivery that enters the wrapper with top-level `attempts` > 0",
        "expect": {
          "metric": "babelqueue.retries",
          "instrument": "counter",
          "unit": "{message}",
          "recorded_by": "consumer wrapper",
          "operation_name": "process",
          "attributes": {
            "always": [
              "messaging.system",
              "messaging.operation.name"
            ],
            "when_destination_known": [
              "messaging.destination.name"
            ]
          },
          "forbidden_attributes": [
            "babelqueue.urn",
            "messaging.message.id",
            "messaging.message.conversation_id",
            "babelqueue.attempts",
            "babelqueue.schema_version",
            "messaging.consumer.group.name",
            "dead_letter.reason",
            "trace_id"
          ]
        }
      },
      {
        "name": "instrument-babelqueue-dlq-messages",
        "mode": "instrument",
        "when": "+1 per dead-letter the SDK itself completed (ADR-0039 section 5.1); `messaging.destination.name` is the source queue",
        "expect": {
          "metric": "babelqueue.dlq.messages",
          "instrument": "counter",
          "unit": "{message}",
          "recorded_by": "dead-letter observer",
          "operation_name": "process",
          "attributes": {
            "always": [
              "messaging.system",
              "messaging.operation.name"
            ],
            "when_destination_known": [
              "messaging.destination.name"
            ]
          },
          "forbidden_attributes": [
            "babelqueue.urn",
            "messaging.message.id",
            "messaging.message.conversation_id",
            "babelqueue.attempts",
            "babelqueue.schema_version",
            "messaging.consumer.group.name",
            "dead_letter.reason",
            "trace_id"
          ]
        }
      },
      {
        "name": "consume-one-success",
        "mode": "consume",
        "system": "kafka",
        "queue": "orders.events",
        "attempts": 0,
        "outcome": "ok",
        "expect": {
          "records": [
            {
              "metric": "messaging.client.consumed.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "kafka",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders.events"
              }
            },
            {
              "metric": "messaging.process.duration",
              "kind": "record",
              "value": "non_negative_seconds",
              "attributes": {
                "messaging.system": "kafka",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders.events"
              }
            }
          ]
        },
        "description": "One successful consume (attempts 0): `consumed.messages` +1 and one `process.duration` record without `error.type`; no `retries` record. The attribute maps are exact: no URN, id, trace id, attempts, schema version or reason."
      },
      {
        "name": "consume-failure-with-attempts-2",
        "mode": "consume",
        "system": "kafka",
        "queue": "orders.events",
        "attempts": 2,
        "outcome": "error",
        "expect": {
          "records": [
            {
              "metric": "messaging.client.consumed.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "kafka",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders.events"
              }
            },
            {
              "metric": "babelqueue.retries",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "kafka",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders.events"
              }
            },
            {
              "metric": "messaging.process.duration",
              "kind": "record",
              "value": "non_negative_seconds",
              "attributes": {
                "messaging.system": "kafka",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders.events"
              },
              "error_type": "present"
            }
          ]
        },
        "description": "One consume whose handler fails (the wrapped handler returns or raises an error; the same definition as the `span-shape` case `process-handler-failure`) with `attempts` 2: `consumed.messages` +1 (no `error.type`: the delivery was received), `retries` +1, and one `process.duration` record carrying `error.type` (present, non-empty; value not asserted). The wrapper's result is unchanged."
      },
      {
        "name": "consume-attempts-1-counts-as-retry",
        "mode": "consume",
        "queue": "orders",
        "attempts": 1,
        "outcome": "ok",
        "expect": {
          "records": [
            {
              "metric": "messaging.client.consumed.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders"
              }
            },
            {
              "metric": "babelqueue.retries",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders"
              }
            },
            {
              "metric": "messaging.process.duration",
              "kind": "record",
              "value": "non_negative_seconds",
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders"
              }
            }
          ]
        },
        "description": "The `retries` threshold is `attempts` > 0: attempts 1 counts."
      },
      {
        "name": "consume-default-system",
        "mode": "consume",
        "queue": "orders",
        "attempts": 0,
        "outcome": "ok",
        "expect": {
          "records": [
            {
              "metric": "messaging.client.consumed.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders"
              }
            },
            {
              "metric": "messaging.process.duration",
              "kind": "record",
              "value": "non_negative_seconds",
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders"
              }
            }
          ]
        },
        "description": "No `system` option: `messaging.system` is `babelqueue` on every metric."
      },
      {
        "name": "consume-no-destination-empty-queue",
        "mode": "consume",
        "queue": "",
        "attempts": 0,
        "outcome": "ok",
        "expect": {
          "records": [
            {
              "metric": "messaging.client.consumed.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "process"
              }
            },
            {
              "metric": "messaging.process.duration",
              "kind": "record",
              "value": "non_negative_seconds",
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "process"
              }
            }
          ]
        },
        "description": "`meta.queue` empty: `messaging.destination.name` is not a metric attribute."
      },
      {
        "name": "consume-no-destination-absent-queue",
        "mode": "consume",
        "attempts": 0,
        "outcome": "ok",
        "expect": {
          "records": [
            {
              "metric": "messaging.client.consumed.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "process"
              }
            },
            {
              "metric": "messaging.process.duration",
              "kind": "record",
              "value": "non_negative_seconds",
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "process"
              }
            }
          ]
        },
        "description": "`meta.queue` absent: same."
      },
      {
        "name": "consume-without-meter-records-nothing",
        "mode": "consume",
        "system": "kafka",
        "queue": "orders.events",
        "attempts": 0,
        "outcome": "ok",
        "meter": false,
        "expect": {
          "records": []
        },
        "description": "No meter supplied (ADR-0039 section 3): the wrapper records nothing. On .NET the instruments exist but no listener is subscribed, so nothing is collected."
      },
      {
        "name": "publish-one-success",
        "mode": "publish",
        "system": "kafka",
        "queue": "orders.events",
        "outcome": "ok",
        "expect": {
          "records": [
            {
              "metric": "messaging.client.sent.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "kafka",
                "messaging.operation.name": "send",
                "messaging.destination.name": "orders.events"
              }
            }
          ]
        },
        "description": "One successful publish: `sent.messages` +1 with `messaging.operation.name = send`, no `error.type`."
      },
      {
        "name": "publish-failure",
        "mode": "publish",
        "system": "rabbitmq",
        "queue": "orders",
        "outcome": "error",
        "expect": {
          "records": [
            {
              "metric": "messaging.client.sent.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "rabbitmq",
                "messaging.operation.name": "send",
                "messaging.destination.name": "orders"
              },
              "error_type": "present"
            }
          ]
        },
        "description": "The publish fails after the envelope was handed to the transport (the transport rejects or fails the publish; the same definition as the `span-shape` case `send-failure-after-envelope-built`): `sent.messages` +1 (an attempt) carrying `error.type` (present, non-empty). The publish result is unchanged. A failure before the envelope reaches the transport (build or encode) is not pinned by this section."
      },
      {
        "name": "publish-default-system",
        "mode": "publish",
        "queue": "orders",
        "outcome": "ok",
        "expect": {
          "records": [
            {
              "metric": "messaging.client.sent.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "send",
                "messaging.destination.name": "orders"
              }
            }
          ]
        },
        "description": "No `system` option: `messaging.system` is `babelqueue`."
      },
      {
        "name": "publish-empty-queue-follows-produced-meta-queue",
        "mode": "publish",
        "queue": "",
        "outcome": "ok",
        "expect": {
          "records": [
            {
              "metric": "messaging.client.sent.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "send",
                "messaging.destination.name": "$produced.meta.queue"
              }
            }
          ]
        },
        "description": "An empty queue is given to the producer. The destination is `meta.queue` of the produced envelope, which the SDK decides (Python and Go fall back to the app's default queue): the expectation uses the placeholder `$produced.meta.queue`; when the produced `meta.queue` is empty or blank `messaging.destination.name` is not written."
      },
      {
        "name": "publish-without-meter-records-nothing",
        "mode": "publish",
        "system": "kafka",
        "queue": "orders.events",
        "outcome": "ok",
        "meter": false,
        "expect": {
          "records": []
        }
      },
      {
        "name": "dlq-write-ok-retries-exhausted",
        "mode": "dead_letter",
        "trigger": "bq_dlq_write_ok",
        "system": "redis",
        "observer_called": true,
        "event": {
          "queue": "orders",
          "dead_letter_queue": "orders.dlq",
          "reason": "failed"
        },
        "expect": {
          "observer_called": true,
          "records": [
            {
              "metric": "babelqueue.dlq.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "redis",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders"
              }
            }
          ]
        },
        "description": "A successful write to the BabelQueue DLQ after the retries are exhausted: the observer is called once and `babelqueue.dlq.messages` +1 with `messaging.operation.name = process` and the source queue. The reason is not a metric attribute."
      },
      {
        "name": "dlq-write-ok-unknown-urn",
        "mode": "dead_letter",
        "trigger": "bq_dlq_write_ok",
        "system": "redis",
        "observer_called": true,
        "event": {
          "queue": "orders",
          "dead_letter_queue": "orders.dlq",
          "reason": "unknown_urn"
        },
        "expect": {
          "observer_called": true,
          "records": [
            {
              "metric": "babelqueue.dlq.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "redis",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders"
              }
            }
          ]
        }
      },
      {
        "name": "dlq-write-ok-poison",
        "mode": "dead_letter",
        "trigger": "bq_dlq_write_ok",
        "system": "kafka",
        "observer_called": true,
        "event": {
          "queue": "orders.events",
          "dead_letter_queue": "orders.events.dlq",
          "reason": "poison"
        },
        "expect": {
          "observer_called": true,
          "records": [
            {
              "metric": "babelqueue.dlq.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "kafka",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders.events"
              }
            }
          ]
        }
      },
      {
        "name": "dlq-write-ok-version-gate-raw-body",
        "mode": "dead_letter",
        "trigger": "bq_dlq_write_ok",
        "system": "aws_sqs",
        "observer_called": true,
        "event": {
          "queue": "orders",
          "dead_letter_queue": "orders-dlq",
          "reason": ""
        },
        "expect": {
          "observer_called": true,
          "records": [
            {
              "metric": "babelqueue.dlq.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "aws_sqs",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders"
              }
            }
          ]
        },
        "description": "A raw version-gated body written to the DLQ (ADR-0037 decision 1) has no `dead_letter` block, so the event's `reason` is empty. Counted."
      },
      {
        "name": "dlq-native-dead-letter-ok",
        "mode": "dead_letter",
        "trigger": "native_dead_letter_ok",
        "system": "servicebus",
        "observer_called": true,
        "event": {
          "queue": "orders",
          "dead_letter_queue": "",
          "reason": ""
        },
        "expect": {
          "observer_called": true,
          "records": [
            {
              "metric": "babelqueue.dlq.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "servicebus",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders"
              }
            }
          ]
        },
        "description": "An SDK-initiated native dead-letter that the broker confirmed (Azure Service Bus `DeadLetterMessage`): the observer is called with an empty `dead_letter_queue` and `babelqueue.dlq.messages` +1. The attribute set is the same as for a BabelQueue DLQ write: there is no native/BabelQueue split (ADR-0039 section 5.1, owner decision 2026-10-31)."
      },
      {
        "name": "dlq-default-system",
        "mode": "dead_letter",
        "trigger": "bq_dlq_write_ok",
        "observer_called": true,
        "event": {
          "queue": "orders",
          "dead_letter_queue": "orders.dlq",
          "reason": "failed"
        },
        "expect": {
          "observer_called": true,
          "records": [
            {
              "metric": "babelqueue.dlq.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "babelqueue",
                "messaging.operation.name": "process",
                "messaging.destination.name": "orders"
              }
            }
          ]
        },
        "description": "No `system` option on the observer: `messaging.system` is `babelqueue`."
      },
      {
        "name": "dlq-no-source-queue",
        "mode": "dead_letter",
        "trigger": "bq_dlq_write_ok",
        "system": "redis",
        "observer_called": true,
        "event": {
          "queue": "",
          "dead_letter_queue": "orders.dlq",
          "reason": "failed"
        },
        "expect": {
          "observer_called": true,
          "records": [
            {
              "metric": "babelqueue.dlq.messages",
              "kind": "add",
              "value": 1,
              "attributes": {
                "messaging.system": "redis",
                "messaging.operation.name": "process"
              }
            }
          ]
        },
        "description": "No source queue known: `messaging.destination.name` is not written."
      },
      {
        "name": "dlq-write-failed",
        "mode": "dead_letter",
        "trigger": "bq_dlq_write_failed",
        "system": "redis",
        "observer_called": false,
        "sdk_test_required": true,
        "expect": {
          "observer_called": false,
          "records": []
        },
        "description": "The DLQ write failed: the message stays unsettled and the observer is NOT called; the counter stays unchanged."
      },
      {
        "name": "dlq-native-call-failed",
        "mode": "dead_letter",
        "trigger": "native_dead_letter_failed",
        "system": "servicebus",
        "observer_called": false,
        "sdk_test_required": true,
        "expect": {
          "observer_called": false,
          "records": []
        },
        "description": "The native dead-letter call failed (or the receiver lacks the call and the SDK fell back to abandon): the observer is NOT called."
      },
      {
        "name": "dlq-native-noop-sqs",
        "mode": "dead_letter",
        "trigger": "native_noop",
        "system": "aws_sqs",
        "observer_called": false,
        "sdk_test_required": true,
        "expect": {
          "observer_called": false,
          "records": []
        },
        "description": "The SQS native settle is a no-op that leaves the message to `RedrivePolicy`; it is not a dead-letter by the SDK, so the observer is NOT called."
      },
      {
        "name": "dlq-broker-own-dead-letter",
        "mode": "dead_letter",
        "trigger": "broker_autonomous",
        "system": "servicebus",
        "observer_called": false,
        "sdk_test_required": true,
        "expect": {
          "observer_called": false,
          "records": []
        },
        "description": "The broker dead-letters on its own (SQS `RedrivePolicy` after `maxReceiveCount`, Azure Service Bus `MaxDeliveryCount`, Pulsar or Artemis broker-side policy): the SDK did nothing, so the observer is NOT called."
      },
      {
        "name": "dlq-writing-disabled-message-dropped",
        "mode": "dead_letter",
        "trigger": "dlq_disabled_dropped",
        "system": "redis",
        "observer_called": false,
        "sdk_test_required": true,
        "expect": {
          "observer_called": false,
          "records": []
        },
        "description": "DLQ writing is disabled and the message is dropped or acknowledged instead: the observer is NOT called."
      }
    ]
  }
}