codes.json

{
  "format_version": 1,
  "entries": [
    {
      "code": "allowance_exhausted",
      "classification": "refusal",
      "definition": "The caller has spent its daily allowance for this kind of write, shares, cards or pins, so the write is refused until the allowance resets, which the response's Retry-After header names. The problem document says retryable false, so a client raises at once and waits for no reset.",
      "owning_contract": "platform",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 429
        },
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 429
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 429
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 429
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "alternates_unevaluated",
      "classification": "warning",
      "definition": "An alternate reading of the question that passed admission was not evaluated because the presence read its default scope needs did not complete (no worker free, an upstream failure, or a timeout). The elected answer is served, a near-neighbour tie with that reading stays stated, the message states the cause in plain words, and the response is not cached.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "artifact_expired",
      "classification": "refusal",
      "definition": "Every listable artifact of this version aged out of the working tier unpinned, so none remains servable.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.snapshot",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.observations",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 410
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "artifact_not_found",
      "classification": "refusal",
      "definition": "The named artifact_digest is not among this version's artifacts.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 404
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "artifact_pair_stale",
      "classification": "warning",
      "definition": "The origin catalogue build and the series coverage build serving the request come from different graph ingestions, so the answer may lack observations ingested after the older build. Each serves its newest build until the next one publishes.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "availability_probe_failed",
      "classification": "warning",
      "definition": "The sibling-availability probe that checks whether a denominator candidate has data at the resolved place failed to complete, so every candidate's place availability was reset to unknown rather than pruned on a stale or partial result.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "base_identity_mismatch",
      "classification": "refusal",
      "definition": "The supplied base_identity does not canonicalise and hash to the named base_spec_id.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "base_not_found",
      "classification": "refusal",
      "definition": "A spec-resubmit names a base_spec_id absent from the registry and supplies no base_identity to reconstruct it from.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "binding_folded",
      "classification": "warning",
      "definition": "Several parts of a query resolved to the same shape, so the engine merged them onto one spec and folded every binding but the first into that spec's slot options; the part carrying this warning is answered by the merged spec.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "binding_invalid",
      "classification": "refusal",
      "definition": "The intent's select names a dimension the referenced frame does not offer, or a value the frame does not observe for that dimension.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.frames",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.component_data",
          "channel": "problem_details",
          "http_status": 400
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "binding_mismatch",
      "classification": "refusal",
      "definition": "The variable resolved and graph-confirmed StatVars exist, but none satisfies the requested slot bindings: a resolved value on a bound property mismatched, or the StatVar's value on a bound property is present but could not be read (an unresolvable dcid).",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "candidates_collapsed_definite",
      "classification": "warning",
      "definition": "A replayed candidate set collapsed to exactly one survivor, so the part is reported as a definite answer to the replayed selection rather than as the candidate set the caller posted.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "candidates_collapsed_no_data",
      "classification": "warning",
      "definition": "A replayed candidate set collapsed to no survivor at all, so the part is reported as no_data rather than as the candidate set the caller posted.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "capability_unavailable",
      "classification": "refusal",
      "definition": "A well-formed request asks for a format, reshape, or conversion class this deployment does not enable.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 501
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 501
        },
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 501
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 501
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 501
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 501
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 501
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 501
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "catalogue_index_drift",
      "classification": "warning",
      "definition": "The origin catalogue's schema for a variable the answer used disagrees with the packaged code index on five-tuple, constraint properties, or roles. The answer uses the catalogue's reading, and the code index needs re-exporting.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "child_places_clamped",
      "classification": "warning",
      "definition": "The set of child places expanded from a named region exceeded the per-region cap and was truncated.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "children_anchor_ambiguous",
      "classification": "refusal",
      "definition": "The options request's children scope binds more than one distinct anchor entity, but children scope descends from exactly one place and has no order-invariant way to choose among several.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 400
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "children_anchor_required",
      "classification": "refusal",
      "definition": "The options request asks for children scope but binds no entity to descend from; children scope, unlike peers scope, has no identity-derivable default to fall back to.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 400
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "code_ambiguous",
      "classification": "refusal",
      "definition": "One or more supplied source codes each match more than one source or StatVar.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "code_not_found",
      "classification": "refusal",
      "definition": "This registry has no entry for the requested code.",
      "owning_contract": "platform",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "platform.codes",
          "channel": "problem_details",
          "http_status": 404
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "collection_probe_ceiling",
      "classification": "refusal",
      "definition": "The facet probe for a request group would exceed the cap on StatVar and entity pairs it may ask the graph for, so no probe is issued.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "column_not_droppable",
      "classification": "refusal",
      "definition": "The requested column selection drops a grain, unit, or provenance column.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "column_unknown",
      "classification": "refusal",
      "definition": "The requested columns, pivot, or enrichment options reference a column the frame does not hold at this reshape point.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "compare_no_key_matched",
      "classification": "refusal",
      "definition": "No member of a compare step's data side pairs with a member of its other side through the step's on mapping, so there is nothing to compare.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "comparison_periods_disjoint",
      "classification": "refusal",
      "definition": "The two sides of a compare, quotient or sum_of step have no period in common.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "composed_unit_sum_unsupported",
      "classification": "refusal",
      "definition": "An analysis step adds values whose unit is a quotient, and quotients added together are not a quotient in that unit.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "conflicting_requested_options",
      "classification": "refusal",
      "definition": "The scope_entries posted for a part cannot all apply: two entries name different options on one axis, an option conflicts with an entry on another axis, or the entries rule out every option of an axis.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "conjunction_cross_shape",
      "classification": "warning",
      "definition": "The parts of a conjunction query grounded to different shapes, so the returned specs measure structurally distinct things.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "conjunction_part_ambiguous",
      "classification": "warning",
      "definition": "One part of a conjunction query could not resolve to a single confident interpretation.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "conjunction_part_no_data",
      "classification": "warning",
      "definition": "One part of a conjunction query resolved but returned no data.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "constraint_filter_fell_back",
      "classification": "warning",
      "definition": "A constraint filter could not apply as requested and fell back to a looser matching rule.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "constraint_violation",
      "classification": "refusal",
      "definition": "The resolved component would violate one of the catalogue's named cross-field constraints: comparable units across series, positive values under a log scale, a visible range that contains the plotted data, or a stat_card change computed only from observed periods.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 400
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "coverage_below_scope",
      "classification": "warning",
      "definition": "The served coverage falls short of the requested scope.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "coverage_insufficient",
      "classification": "refusal",
      "definition": "The grid an aggregate step groups over is too sparse: the share of expected cells with a value is below the floor the step requires.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "cross_frame_facet_mismatch",
      "classification": "refusal",
      "definition": "The two sides of an analysis step hold one StatVar read under different values of a facet, whose values do not combine.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "cross_frame_unit_mismatch",
      "classification": "refusal",
      "definition": "The two sides of an analysis step resolve to different units, and combining their values would be wrong.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "cross_frame_unit_unbound",
      "classification": "refusal",
      "definition": "One side of an analysis step declares no unit while the other declares one, so the sides cannot be combined.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "currency_unmapped_omitted",
      "classification": "warning",
      "definition": "A conversion into each entity's own currency left out the rows of the entities that no single currency names through nationalCurrencyOf, and the warning names those entities. It applies when at least one row of the request converts; a request with no convertible row refuses instead.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "date_coverage_partial",
      "classification": "warning",
      "definition": "The returned series' observations do not fully cover the requested window.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "default_facet_undefined",
      "classification": "refusal",
      "definition": "An unbound facet axis has no probed candidate to draw a default from.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "default_not_declared",
      "classification": "warning",
      "definition": "A unit request member was completed at binding time from the engine's deterministic fallback because no declared default policy exists for it.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "definition_not_held",
      "classification": "refusal",
      "definition": "No definition is registered under the id a request names, and the service that holds definitions is up. A new search finds an id that is registered.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "definition_not_reproducible",
      "classification": "refusal",
      "definition": "A registered definition does not reproduce its own id against the graph's current account of its StatVar.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "deflator_missing_omitted",
      "classification": "warning",
      "definition": "A constant-price conversion left out the rows of each entity in the years the deflator table holds no value for it on the recipe's deflator role, and every row of an entity it holds no value for in the base year, and the warning names those entities and years. It applies when at least one row of the request converts; a request with no convertible row refuses with rate_coverage_gap and cause deflator_missing instead.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "deflator_projected",
      "classification": "warning",
      "definition": "A converted observation's exchange rate or price deflator at the observation year or the base year came from a projection facet rather than an actual.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "degenerate_binding_detected",
      "classification": "warning",
      "definition": "A drafted slot binding names an axis but asserts no value, which is schema-valid but would silently answer a broader question than the one the query asked, so the query is refused rather than resolved as though the axis were unbound.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "denominator_not_available",
      "classification": "refusal",
      "definition": "The request asks for a normalised form and no denominator-bearing variable exists for it.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "denominator_unverified",
      "classification": "warning",
      "definition": "The question names a denominator and the answer's series declares no denominator arc, so its ratio base is read from the series name only. The message names the denominator asked.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "derived_input_ordinal",
      "classification": "refusal",
      "definition": "An analysis step reads a derived result whose values are rank positions, and a ratio or growth rate over a rank position has no meaning.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "derived_input_unrecoverable",
      "classification": "refusal",
      "definition": "An input frame has period labels that do not state the years they cover, so no verb can read its periods. Only running the analysis again from the source data gives a usable frame.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "derived_input_unusable",
      "classification": "refusal",
      "definition": "An analysis step reads a derived result whose rows hold spans of periods, which a growth step cannot window over.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "direction_discarded",
      "classification": "warning",
      "definition": "A named place's flow direction could not be carried by the elected shape, so the direction was dropped and the place answered as the shape's own subject. The warning is minted only by the text pipeline's place-binding phase, which dataset_resubmit's identity and candidates entries do not run; those entries refuse with role_incompatible instead of discarding a direction.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "directional_children_unsupported",
      "classification": "refusal",
      "definition": "A flow role's options were requested with a children scope, but a flow axis has no containment hierarchy to expand and serves its members from one availability read.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "door_not_implemented",
      "classification": "refusal",
      "definition": "The request names an input door the contract defines but this deployment does not yet serve.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 501
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "edit_conflict",
      "classification": "refusal",
      "definition": "The component's current revision is not the one the request reads or targets: a revise_component request names a revision that is no longer current, or the component has no current revision.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "presentation.component_read",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "presentation.component_data",
          "channel": "problem_details",
          "http_status": 409
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "edit_incomplete",
      "classification": "refusal",
      "definition": "A spec-resubmit edit leaves a facet axis or entity role that the base definition bound neither re-sent nor named in removed, or names a part in removed that the base does not bind.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "elected_shape_no_data",
      "classification": "warning",
      "definition": "The interpretation's own elected shape returned no data, and only a non-elected alternate shape survived with data.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "empty_result",
      "classification": "warning",
      "definition": "The materialised frame holds zero observations.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "enrichment_unavailable",
      "classification": "warning",
      "definition": "A default name column, a decoded code column, or a requested enrichment column has no value for some rows: the graph names nothing, the name read failed, or two codes share a label. An empty measurementMethod_label never raises it.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "entities_unbound",
      "classification": "refusal",
      "definition": "The request binds no entity dcid to probe for a facet candidate set.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "entity_ambiguous",
      "classification": "refusal",
      "definition": "A named entity in the request matched two or more graph nodes with equal standing, and the request did not say which one it meant. The detail lists the candidates.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "entity_label_unresolved",
      "classification": "warning",
      "definition": "A resolved entity's dcid was graph-confirmed but no display label could be found for it, so the entity is presented with a dcid-echo label rather than being dropped.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "entity_not_found",
      "classification": "refusal",
      "definition": "A name in a request's scope gives no entity to fetch data for: it matches nothing, the graph holds no node for it, or it names a group with no member countries.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "entity_not_resolved",
      "classification": "refusal",
      "definition": "A named entity in the request could not be resolved to a graph node.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "entity_role_disabled",
      "classification": "warning",
      "definition": "A directional preposition was detected in the request, but the place-as-constraint seam is off, so role assignment is disabled and the collapse to plain subjects silently changed the request's interpretation.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "entity_role_not_admitted",
      "classification": "refusal",
      "definition": "A named entity resolved to a graph node whose type no shape of the requested variable can admit in any of its declared roles; for example an organisation named against a variable observed only about places.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "entity_set_too_large",
      "classification": "refusal",
      "definition": "A named entity in the request resolved to a set of member entities larger than the engine binds in one request. The entity itself was graph-confirmed; its membership count, not its resolution, is what exceeds the bound.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "exact_binding_unsupported",
      "classification": "refusal",
      "definition": "A slot binding declares state 'exact', the deliberate parent-only ask on a hierarchical code, and this deployment does not accept it.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 501
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 501
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "excel_illegal_character",
      "classification": "refusal",
      "definition": "A cell contains a character that is illegal in Excel's XML file format.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "excel_limit",
      "classification": "refusal",
      "definition": "The table exceeds one of Excel's row, column, or cell-character limits.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "excluded_by_registry",
      "classification": "refusal",
      "definition": "The requested variable has data at the requested places only under provenances the origin registry does not admit; the refusal names those provenances.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "facet_binding_unsupported",
      "classification": "refusal",
      "definition": "The requested facet axis is recognised, but this deployment cannot honour it.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 501
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 501
        },
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "unsupported_code"
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "facet_default_selected",
      "classification": "warning",
      "definition": "An unbound facet axis had more than one candidate value, DFO precedence did not decide between them, and this deployment's default policy chose one. The policy ranks candidates holding a point in the requested window first, then DFO precedence, then the places or role tuples covered, then the requested years covered, then observation count, the latest date, and a deterministic tie-break.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "facet_heterogeneous",
      "classification": "refusal",
      "definition": "An analysis step reads an input that carries more than one value of a facet, such as the measurement method, and the response lists the candidates.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "facet_not_available",
      "classification": "refusal",
      "definition": "The requested facet binding is valid, but no observations match it under the definition's other bindings.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "no_data_reason"
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "facet_probe_ceiling",
      "classification": "refusal",
      "definition": "The bound facet combinations the request asks for would exceed the cap on facet probes the deployment may issue, so no probe is issued.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "family_total_absent",
      "classification": "warning",
      "definition": "The StatVar a part names is not its family's total: the total has no data at the place, or the family holds no total. The message names the member shown, and the total and the place when the family holds one.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "filter_predicate_type_mismatch",
      "classification": "refusal",
      "definition": "A filter step names a predicate of a kind, or with a value of a type, that does not fit the column it applies to.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "filter_unit_conversion_unsupported",
      "classification": "refusal",
      "definition": "A filter step puts a unit predicate on an input whose units are converted, which the step cannot match.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "frame_expired",
      "classification": "refusal",
      "definition": "The frame a reference names was held and has aged out, and the server can still tell that it was.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "frame_integrity_failed",
      "classification": "refusal",
      "definition": "A stored frame failed an integrity check, so it does not match what was recorded when it was written. The same reference reaches the same frame, so only a fresh result under a new reference clears it.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "frame_not_held",
      "classification": "refusal",
      "definition": "The frame a reference names is not held: it was never stored, it is no longer held and nothing records that it was, or no such version exists. The same code answers a reference whose identity and version do not belong together.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "frame_not_refreshable",
      "classification": "refusal",
      "definition": "The named frame is a derived frame, published by an analysis service from its own computation. No dataset definition stands behind it, so it cannot be rebuilt here on current data; the service that computed it replays it.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "frame_ref_incomplete",
      "classification": "refusal",
      "definition": "A frame reference carries a derived-frame id without its content version, or an id that is not a dataset id, so the server cannot fetch the frame by itself.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "frame_too_large",
      "classification": "refusal",
      "definition": "The result of an analysis step is too large to store, so the step is refused and nothing is stored.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "frame_unavailable",
      "classification": "refusal",
      "definition": "The frame a request names is not held in a state Presentation can load: it was never stored or published, it has expired or been revoked, its spec is quarantined, or its stored artifact is missing, fails its digest check, does not decode, or holds more rows than Presentation loads. A pin of a derived frame with no recipe yet is refused with cause code recipe_pending and is retryable, because a recipe write lets a retry pin. A store that fails to answer is service_unavailable.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "presentation.frames",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "presentation.component_data",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "growth_gap_year",
      "classification": "refusal",
      "definition": "No entity has a value in both endpoint years of a growth step, so the step has no growth to compute.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "identity_collision",
      "classification": "refusal",
      "definition": "A registry write found byte-different content already held at this id.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.register",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 500
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "identity_quarantined",
      "classification": "refusal",
      "definition": "This id already has byte-different content collision-quarantined under it, so registration is refused until the quarantine is resolved.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.register",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.description",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.observations",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.export_link",
          "channel": "problem_details",
          "http_status": 500
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "internal_error",
      "classification": "refusal",
      "definition": "An unclassified, non-retryable failure occurred while handling the request. This includes a pin of a derived frame whose recipe cannot be read, since recipes are write-once and a retry cannot clear it.",
      "owning_contract": "platform",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "platform.any",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.description",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.observations",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.publish",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.recipe",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "presentation.frames",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "presentation.component_read",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "presentation.component_data",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.export_link",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "invalid_role_ref",
      "classification": "refusal",
      "definition": "A structured role reference names an entity that does not exist in the graph.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "join_no_common_key_columns",
      "classification": "refusal",
      "definition": "A join step names no key columns and the two sides share no role column to join on.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "join_output_collision",
      "classification": "refusal",
      "definition": "The two sides of a join step have the same StatVar, unit and facets, so the rows a matched key emits cannot be told apart.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "licence_not_redistributable",
      "classification": "refusal",
      "definition": "The licence of a source behind the requested frame forbids redistribution, so no export file is served.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 403
        },
        {
          "endpoint": "datasets.export_link",
          "channel": "problem_details",
          "http_status": 403
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "member_not_resolvable",
      "classification": "refusal",
      "definition": "A StatVar did not resolve to exactly one registered shape.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "members_absent_from_graph",
      "classification": "warning",
      "definition": "A resubmitted definition's elected members include StatVars the knowledge graph holds no node for, so the answer leaves them out. The code index lists members the graph no longer serves, or the graph dropped one between the election and its read. The message names the members left out.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "members_deduplicated",
      "classification": "warning",
      "definition": "Two or more collection members resolve to the same specification after applying scope.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "members_not_held",
      "classification": "refusal",
      "definition": "One or more StatVars a definition names have no node in the knowledge graph, so its frame cannot be retrieved. The refusal lists the ones in the rejected fetch, and others the definition names may also be absent. The status is 500 because the fault is operator-side data drift, which must count in error rates.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 500
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 500
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "membership_unverified",
      "classification": "warning",
      "definition": "A role-bearing answer reads the series Search recalled, because the member walk the Datasets mint runs did not settle them: no walk ran, or it ran past its bound, a graph read failed, or it left candidates unread. The mint may resolve other series for the same identity, so the response cache does not store the answer.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "method_not_allowed",
      "classification": "refusal",
      "definition": "The request's HTTP method is not supported for this path; the response's Allow header lists the methods that are.",
      "owning_contract": "platform",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "platform.any",
          "channel": "problem_details",
          "http_status": 405
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "mixed_peers_anchor_types",
      "classification": "refusal",
      "definition": "The options request's peers scope binds several anchor entities whose resolved types are not all the same, so no single shared type can be chosen for the peers universe.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 400
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "mixed_time_grain",
      "classification": "refusal",
      "definition": "An input frame holds periods of more than one grain, or a mix of points and spans, so no analysis step can read it, and reading it again gives the same periods.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "multi_recipient_truncated",
      "classification": "warning",
      "definition": "The number of resolved entities for a multi-value role exceeded the cap and was truncated.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "near_neighbor_ambiguous",
      "classification": "warning",
      "definition": "A semantically distinct alternate interpretation scored close enough to the chosen one that the two are treated as ambiguous.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "near_neighbor_pool_widened",
      "classification": "warning",
      "definition": "A near-tied alternate interpretation had no data, so the search widened past its initial margin to find a distinct alternative that does have data.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "no_matching_slice",
      "classification": "refusal",
      "definition": "The variable matched, but the requested combination of bindings was never published as a series.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "no_member_asserts_bound_properties",
      "classification": "refusal",
      "definition": "No place entity was named in the request, and no member of the matched variable's family asserts every bound constraint property, so the nearest real match is surfaced as a flagged alternative instead of a confident answer.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "flagged_match_gate"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "no_member_has_data_at_place",
      "classification": "refusal",
      "definition": "No member of the matched variable's family has observations at the resolved place, so the nearest real match is surfaced as a flagged alternative instead of a confident answer.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "flagged_match_gate"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "no_observations",
      "classification": "refusal",
      "definition": "The matching series exists but holds no observations at the resolved entity and window.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "node_not_held",
      "classification": "refusal",
      "definition": "This deployment's graph does not hold the requested node.",
      "owning_contract": "graph",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "graph.node",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "graph.members",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "graph.documentation",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "non_finite_result",
      "classification": "refusal",
      "definition": "An analysis step overflows to a value that is not finite, so repeating the step with the same input reaches the same result.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "not_found",
      "classification": "refusal",
      "definition": "No route matches the request path, or the referenced resource is not visible to this caller.",
      "owning_contract": "platform",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "platform.any",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "presentation.component_read",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "presentation.component_data",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.export_link",
          "channel": "problem_details",
          "http_status": 404
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observation_attributes_in_notes",
      "classification": "warning",
      "definition": "Per-observation qualifications a source flags on published rows ride the bundle README and descriptor metadata instead of frame columns.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_bulk_fetch_failed",
      "classification": "warning",
      "definition": "The bulk fetch that populates observation series across a defaulted place scope failed, so coverage stands unchanged and no series were populated.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_clients_unavailable",
      "classification": "refusal",
      "definition": "No graph or SDMX client was available to fetch an observations preview through, so no fetch was attempted. Names an absent capability rather than an upstream condition; a live deployment always supplies both.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "observations_omission_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_converted_scope_unsupported",
      "classification": "warning",
      "definition": "The request binds a unit request, and the resolved scope is served by a bulk read that merges facets across stat_vars and cannot convert them, so no observation preview was fetched.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "observations_omission_reason"
        },
        {
          "endpoint": "datasets.observations",
          "channel": "observations_omission_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_no_dispatchable_facet",
      "classification": "warning",
      "definition": "The merged bulk scope resolved no facet that could be dispatched, so no observation preview was fetched. Fires before any upstream call.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_no_matching_source",
      "classification": "warning",
      "definition": "A resubmit named a source-axis constraint, but none of the fetched facets matched the requested source across any resolved series.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        },
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "done_event_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_no_points",
      "classification": "refusal",
      "definition": "Every pair or candidate the observations preview actually dispatched or read came back with no points and no active facet filter to explain the gap, even though the same selection's coverage reports a nonzero count. Lets a client render that observations are recorded but none returned in the preview, rather than asserting the slice itself is empty.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "observations_omission_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_nothing_to_probe",
      "classification": "refusal",
      "definition": "There was nothing to probe for an observations preview: no confirmed statistical variable, no entity to observe, or a role-bearing query's role tuple could not be completed because a declared role carried no bound entity. Fires before any pair is built, let alone dispatched.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "observations_omission_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_omitted",
      "classification": "warning",
      "definition": "Observations were requested on a part the engine has not committed to, a candidates part, so no values were fetched; promoting the candidate through a resubmit with observations included returns them.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_preview_too_large",
      "classification": "warning",
      "definition": "The number of (statistical variable, role) pairs an observations preview would need to fetch, or under an elected combination the number of dispatch items, exceeded the preview's configured ceiling before a single pair was fetched. The request's own shape crossed the bound, not an upstream failure; the omission carries the pair count and the ceiling it crossed.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "done_event_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "observations_omission_reason"
        },
        {
          "endpoint": "datasets.observations",
          "channel": "observations_omission_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_probe_failed",
      "classification": "warning",
      "definition": "The trailing fetch that previews observations for a returned spec failed.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "done_event_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_scope_partial",
      "classification": "warning",
      "definition": "Some places in the resolved scope carry no data on the selected observation facet, so they are absent from the delivered series.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_series_truncated",
      "classification": "warning",
      "definition": "The preview ships fewer series than the answer confirms, and the message names how many are shown against the total. The order is \"ranked\" (latest year, then latest value) when the answer's kept observations are within the server's role_bulk_rank_max_rows gate, and \"fixed\" (a round-robin across StatVars, newest year with data first) above it or under a conversion into each entity's own currency. Covers both role-bearing answers and standard groups.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_timed_out",
      "classification": "warning",
      "definition": "The trailing fetch that previews observations for a returned spec did not complete before the request deadline.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "done_event_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_unavailable",
      "classification": "refusal",
      "definition": "The observations read cannot build from this version: it holds no stored frame, a converted series lacks its per-series conversion record, the version does not store its default place scope, or it is a collapsed version.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.observations",
          "channel": "problem_details",
          "http_status": 404
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "observations_windowed_scope_unsupported",
      "classification": "warning",
      "definition": "A scope-defaulted standard query carried a window. The bulk branch serves a single latest point per place and cannot honour a window at any scope size, so no preview was fetched -- independent of how many (stat_var, entity) pairs the scope resolves to. Fires before any upstream call; drop the date range or query a specific place to see observations.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "observations_omission_reason"
        },
        {
          "endpoint": "datasets.observations",
          "channel": "observations_omission_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "only_alternate_has_data",
      "classification": "refusal",
      "definition": "The interpretation's own elected shape has no data at the resolved place, and only a non-elected alternate shape does, so the alternate is surfaced as a flagged match instead of a confident answer.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "flagged_match_gate"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "op_spec_invalid",
      "classification": "refusal",
      "definition": "The recipe holds an analysis step whose op-spec is not valid, such as an unknown field, a missing argument or a value out of range.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "open_role_unavailable",
      "classification": "refusal",
      "definition": "A resubmitted identity names an open role, and the StatVars the definition elects declare no role on that axis, so the definition cannot give one series per member.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "operation_failed",
      "classification": "refusal",
      "definition": "The operation ran and did not complete successfully; the poll response carries this code as the RFC 9457 body in place of a manifest.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.operations",
          "channel": "problem_details",
          "http_status": 500
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "operation_not_found",
      "classification": "refusal",
      "definition": "No operation exists with this id, or the operation envelope is dormant on this deployment.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.operations",
          "channel": "problem_details",
          "http_status": 404
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "operation_still_processing",
      "classification": "refusal",
      "definition": "A long-running build did not give its result before the call's wait ended. The build continues, and repeating the call later collects it.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "operation_uncovered",
      "classification": "refusal",
      "definition": "An aggregate step names an aggregation the analysis does not support.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "option_coverage_probe_failed",
      "classification": "warning",
      "definition": "The trailing probe that enriches option items with observation counts failed.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "done_event_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "option_coverage_timed_out",
      "classification": "warning",
      "definition": "The trailing probe that enriches option items with observation counts did not complete before the request deadline.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "done_event_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "option_target_invalid",
      "classification": "refusal",
      "definition": "The options request's for target names a role that none of the resolved StatVars declare.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "origin_catalogue_stale",
      "classification": "warning",
      "definition": "The loaded origin catalogue is more than 14 days old.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "over_ceiling",
      "classification": "refusal",
      "definition": "This request exceeds the sync materialisation size ceiling.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.publish",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.observations",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "parquet_size_bound",
      "classification": "refusal",
      "definition": "The written Parquet artifact would exceed its configured size bound.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "part_restated",
      "classification": "warning",
      "definition": "This part was restated from a no_data or unsupported outcome the client posted back, not re-resolved: the engine rebuilt a stub from the posted status and reason so the surrounding parts could be composed and folded across the whole result, and made no graph or model call for it.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "payload_too_large",
      "classification": "refusal",
      "definition": "A share's request body is larger than the share routes accept.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 413
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "pin_not_permitted",
      "classification": "refusal",
      "definition": "The authenticated caller lacks the pin permission, or programmatic pinning is not live on this deployment.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 403
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "pivot_not_homogeneous",
      "classification": "refusal",
      "definition": "The requested pivot would merge rows that differ on a grain, unit, or provenance column it drops.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "pivot_not_unique",
      "classification": "refusal",
      "definition": "The requested pivot produces duplicate cells under its index and column keys.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "pivot_over_cell_cap",
      "classification": "refusal",
      "definition": "The requested pivot's dense output would exceed this deployment's output-cell cap.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "pivot_over_column_cap",
      "classification": "refusal",
      "definition": "The requested pivot's output width exceeds the target format's column cap.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "place_constraint_seam_off",
      "classification": "warning",
      "definition": "The place-as-constraint seam is off for this request, so every resolved entity is treated as a plain subject regardless of any directional evidence in the query.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "place_levels_mixed",
      "classification": "refusal",
      "definition": "A sum step pools parties whose totals contain one another, such as a region and its countries, which would count members twice.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "place_scope_defaulted",
      "classification": "warning",
      "definition": "No place was named in the request, so the answer was resolved across a default place scope rather than a single named place.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "place_type_not_covered",
      "classification": "refusal",
      "definition": "A named place matched a real graph node, but its place type is not one the engine covers for expansion (e.g. a continental union such as the European Union). Retired: admission is read from the graph's declared role ranges, and a sub-national place is admitted wherever the graph declares it, so this trigger no longer exists.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "population_empty",
      "classification": "refusal",
      "definition": "The identity's own shape resolves to no StatVar population at all, from either the packaged code index or a graph enumeration.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "processing_level_undeclared",
      "classification": "warning",
      "definition": "A source StatVar lacks a processing-level declaration, so the citation names the source alone.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "provenance_unavailable",
      "classification": "refusal",
      "definition": "The sources of the requested frame and their licences cannot be named, so no export file is served.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "provider_ambiguous",
      "classification": "refusal",
      "definition": "The options request's dev-finance provider role binds more than one distinct entity, but at most one provider is supported.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 400
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "publish_conflict",
      "classification": "refusal",
      "definition": "A publish call names an identity pair that is already held, and what is held differs from what the call carries, either in the frame's bytes or in the derivation recorded for it. The publish is refused rather than overwriting either one.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.publish",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "datasets.recipe",
          "channel": "problem_details",
          "http_status": 409
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "publish_not_configured",
      "classification": "refusal",
      "definition": "This deployment has no identity to publish a frame under, so it cannot publish a frame to the platform.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "publish_not_permitted",
      "classification": "refusal",
      "definition": "The authenticated caller is not the principal permitted to publish, or programmatic publishing is not live on this deployment.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.publish",
          "channel": "problem_details",
          "http_status": 403
        },
        {
          "endpoint": "datasets.recipe",
          "channel": "problem_details",
          "http_status": 403
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "qualifier_not_bound",
      "classification": "refusal",
      "definition": "The variable resolved to a series family, but a narrowing term the variable phrase named bound no constraint slot: no code system in the packaged index carries it, or its registered rows landed in no binding.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "query_qualifier_dropped",
      "classification": "warning",
      "definition": "The resolver recognised a query qualifier it could not apply, such as a raw-text phrase the v1 identity cannot represent or a source exclusion that removed nothing, and answered the remaining request without it.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "query_too_long",
      "classification": "refusal",
      "definition": "A raw-text query exceeds the maximum allowed length.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "quotient_of_no_key_matched",
      "classification": "refusal",
      "definition": "No key of a quotient step's numerator matches a key of its denominator, so no quotient can be computed.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "quotient_of_side_unit_unsupported",
      "classification": "refusal",
      "definition": "A side of a quotient step cannot be a part of the result's unit: it is a share or growth rate, already a composed unit, or a sum_of result with no unit.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "quotient_of_zero_denominator",
      "classification": "refusal",
      "definition": "The denominator of a quotient step sums to zero in every matched cell, so the step has no quotient to return.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "rate_coverage_gap",
      "classification": "refusal",
      "definition": "The declared conversion recipe is missing rate or deflator inputs for part of this slice.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "no_data_reason"
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "rate_limited",
      "classification": "refusal",
      "definition": "A limit on the calls a service accepts has been reached, so it refused this one. The identical call is accepted after the wait the refusal names.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "recipe_not_declared",
      "classification": "refusal",
      "definition": "No declared conversion recipe satisfies the requested unit natively.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "unsupported_code"
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "recipe_not_found",
      "classification": "refusal",
      "definition": "No recipe is recorded for the named frame, or no frame is stored under the named replay key.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.recipe",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 404
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "redundant_binding_dropped",
      "classification": "warning",
      "definition": "A drafted slot binding was dropped as a redundant, never-mentioned spelling of an axis the family can already answer under its other spelling, so the query is not refused for an axis it never actually named.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "refresh_not_permitted",
      "classification": "refusal",
      "definition": "The authenticated caller is not the principal permitted to refresh live components, or live refresh is not configured on this deployment.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 403
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 403
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "release_mismatch",
      "classification": "refusal",
      "definition": "The request names a catalogue or grammar release this deployment does not serve, or reads a stored payload whose shape this release does not recognise.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "presentation.component_read",
          "channel": "problem_details",
          "http_status": 503
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "render_target_mismatch",
      "classification": "refusal",
      "definition": "A render names a target frame that is not a later state of the frame the stored revision draws from: a dataset frame with another definition or rendering, or a derived frame whose recorded computation differs or is not recorded.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 409
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "rendering_not_recorded",
      "classification": "refusal",
      "definition": "The named frame is a grouped rendering of a dataset version, and no record states the grouping that produced it. The same rendering cannot be rebuilt on current data, so the frame can never be refreshed.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "request_invalid",
      "classification": "refusal",
      "definition": "The request body is malformed: it uses an unknown input kind, an unknown or extra field, fails schema validation such as a missing shape-declared slot key or a window whose start exceeds its end, omits base_spec_id while carrying removed, or names a part in removed that the posted definition still binds.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.register",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.publish",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "graph.node",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "graph.resolve",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "skills.fetch",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "skills.resource",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.recipe",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "graph.nodes",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "graph.members",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "graph.documentation",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.description",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.frames",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.component_read",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.component_data",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "requested_option_unavailable",
      "classification": "refusal",
      "definition": "A scope_entries entry names an axis the part does not offer, an option the axis does not list, or an option that is unavailable for this part.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "resolution_ambiguous",
      "classification": "refusal",
      "definition": "More than one tuple family satisfies the definition and no declared discriminator distinguishes them.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "resource_exhausted",
      "classification": "refusal",
      "definition": "The requested component exceeds this deployment's bounds on selected values, series, or points.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 400
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "retrieval_score_weak",
      "classification": "warning",
      "definition": "The winning interpretation's retrieval score is low enough that confidence in the match is reduced.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "revision_unavailable",
      "classification": "warning",
      "definition": "Graph and source revision data are unavailable.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "role_ambiguous",
      "classification": "refusal",
      "definition": "A column an analysis step names, to group, rank, join or filter on, is not one its input has a grain for.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "role_declaration_unverified",
      "classification": "warning",
      "definition": "The graph read that would confirm which roles a candidate's members declare did not complete, so the candidate was kept on the roles already read rather than dropped on an unproven one.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "role_incompatible",
      "classification": "refusal",
      "definition": "The role is a real property, but the resolved StatVar does not declare it.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "no_data_reason"
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "role_not_resolved",
      "classification": "refusal",
      "definition": "The request names a role the engine could not resolve.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "role_scope_defaulted",
      "classification": "warning",
      "definition": "No entity was named on the open role axis of a flow query, so the answer was resolved across every entity with data on that axis, discovered from the data cube under the request's bindings and window.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "role_signature_incompatible",
      "classification": "refusal",
      "definition": "The resolved StatVars carry incompatible role signatures.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "no_data_reason"
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "role_text_not_recognised",
      "classification": "warning",
      "definition": "An entity's role text in a parsed-door request did not match any recognised role lexicon entry, so the entity is treated as undirected instead of being refused.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "rolling_anchor_unresolved",
      "classification": "refusal",
      "definition": "The latest period a rolling step counts from is not established, so the step cannot resolve its periods.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "rolling_grain_unsupported",
      "classification": "refusal",
      "definition": "A rolling step counts the latest period over data whose periods are not calendar years, which it does not support.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "rolling_populations_differ",
      "classification": "refusal",
      "definition": "The rolling steps of one analysis recipe count the latest period over different populations of series, so the recipe is refused before it runs, whether or not the periods they would settle on agree.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "rolling_reanchor_unavailable",
      "classification": "refusal",
      "definition": "A rolling computation reads every input under one latest period, and no recipe is stored for a derived input, so that input cannot be computed again under that period.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "rollup_not_summable",
      "classification": "refusal",
      "definition": "The requested groupby roll-up fails summability or one of its preconditions.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "schema_invalid",
      "classification": "refusal",
      "definition": "The intent fails the presentation intent grammar's structural validation before any semantic judgment is applied.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 400
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 400
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "scope_too_broad",
      "classification": "refusal",
      "definition": "The discovered role scope could not be established within the deployment's limits on members, response bytes, or window length; the detail names the limit reached and the remedy is to bind an entity on the open axis, narrow the window, or bind a facet.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "unsupported_code"
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "service_unavailable",
      "classification": "refusal",
      "definition": "The service cannot handle the request right now, typically because a dedicated capacity or connection pool has no room left or a store it reads fails to answer; a retry is expected to succeed.",
      "owning_contract": "platform",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.register",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.description",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.observations",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.publish",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "search.resolve",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "graph.node",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "graph.resolve",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "skills.list",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "skills.fetch",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "skills.resource",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.recipe",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.operations",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "graph.nodes",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "graph.members",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "graph.roots",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "graph.documentation",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "presentation.frames",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "presentation.component_read",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "presentation.component_data",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.export_link",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "several_members",
      "classification": "refusal",
      "definition": "An analysis step takes one reading for each input, and an input names a dataset that holds several.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "shape_mismatch",
      "classification": "refusal",
      "definition": "A spec-resubmit's definition names a different shape_id than its base. A shape change is a new construction and must be posted without a base.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "share_id_taken",
      "classification": "refusal",
      "definition": "An import names a share id that holds another share, or the same share stored with a different write-token digest.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 409
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "share_import_not_permitted",
      "classification": "refusal",
      "definition": "The caller of a share import did not send the import principal, or no import principal is set on this deployment.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 403
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "share_not_replaceable",
      "classification": "refusal",
      "definition": "A replace names a snapshot share, whose cards are fixed for good. Only a live share takes new cards.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 409
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "share_of_grain_mismatch",
      "classification": "refusal",
      "definition": "No key of a share step has a period its numerator and denominator both report, so there is no period to divide.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "share_of_key_unknown",
      "classification": "refusal",
      "definition": "The denominator mapping of a share step covers only some of the numerator's key columns, which leaves the pairing of the others undefined.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "share_of_key_unmatched",
      "classification": "refusal",
      "definition": "No key of a share step's numerator has a denominator group, so no share can be computed.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "share_of_zero_denominator",
      "classification": "refusal",
      "definition": "The denominator of a share step sums to zero in a period, so the share is undefined.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_attachment_kind_unconfirmed",
      "classification": "warning",
      "definition": "The read that classifies one of the skill's declared attachment points stopped at its bound before settling what kind it is, so the attachment contributes nothing to what the skill matches on this build and the skill's reach understates what it covers.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        },
        {
          "endpoint": "skills.fetch",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_attachment_rejected",
      "classification": "warning",
      "definition": "One of the skill's declared attachment points is not a kind the platform accepts, so it contributes nothing to what the skill matches.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        },
        {
          "endpoint": "skills.fetch",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_breadth_high",
      "classification": "warning",
      "definition": "The skill's reach covers more served statistical variables than the breadth bound, so the skill matches very broadly and may be attached higher in the hierarchy than intended.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        },
        {
          "endpoint": "skills.fetch",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_build_unconfirmed",
      "classification": "warning",
      "definition": "A read this skill's build depends on did not complete, whether it failed outright or ran out of its own budget. When the read is of the skill's own node, the skill is left out of the catalogue on this build and the warning, keyed by its dcid, joins the corpus warnings. Otherwise the skill stays served and is excluded from matching on this build. Nothing is known to be wrong with the skill, and a later build may include it.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        },
        {
          "endpoint": "skills.fetch",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_content_absent",
      "classification": "warning",
      "definition": "The skill's node carries no body, so the skill is left out of the catalogue.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_content_too_large",
      "classification": "warning",
      "definition": "The skill's decoded body exceeds the size ceiling this deployment publishes, so the skill is left out of the catalogue.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_content_undecodable",
      "classification": "warning",
      "definition": "The skill's stored body is not a valid escaped Markdown value, so the skill is left out of the catalogue.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_frontmatter_invalid",
      "classification": "warning",
      "definition": "The skill's body has front matter that is missing, cannot be parsed, lacks a string name or description, uses a YAML anchor or alias, or carries a name that differs from the skill's id, so the skill is left out of the catalogue.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_not_found",
      "classification": "refusal",
      "definition": "The requested skill is not published on this deployment.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.fetch",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "skills.resource",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_reach_read_truncated",
      "classification": "warning",
      "definition": "A read inside the skill's reach stopped at its result bound, so the reach understates what the skill covers.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        },
        {
          "endpoint": "skills.fetch",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_reach_too_deep",
      "classification": "warning",
      "definition": "The skill's reach extends past the depth bound, so the skill is excluded from matching until its attachment points are narrowed.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        },
        {
          "endpoint": "skills.fetch",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_reach_too_large",
      "classification": "warning",
      "definition": "The skill's reach holds more nodes than the bound allows, so the skill is excluded from matching until its attachment points are narrowed.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        },
        {
          "endpoint": "skills.fetch",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_resource_not_found",
      "classification": "refusal",
      "definition": "The named skill publishes no resource at the requested bundle-relative path.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.resource",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skill_resource_rejected",
      "classification": "warning",
      "definition": "A resource the skill declares is not published: its identifier does not sit under the skill's own, its path breaches the addressing rules, it carries no content, it breaches the size ceiling this deployment publishes, or it does not declare the resource type the platform requires.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        },
        {
          "endpoint": "skills.fetch",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skills_corpus_budget_exhausted",
      "classification": "warning",
      "definition": "The index build reached the corpus-wide budget for retained skill content before this skill's turn, so the skill is left out of the catalogue. Nothing is known to be wrong with the skill, and a later build may include it once the corpus fits within the budget.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skills_index_incomplete",
      "classification": "warning",
      "definition": "Skills were requested and matches were returned, but the index generation those matches were read from may omit skills the platform publishes, because its roster read stopped at a bound or one of its build steps failed, so the matches are not a complete account of which skills apply.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skills_index_unavailable",
      "classification": "warning",
      "definition": "Skills were requested but the skills index had not finished a build, so the response carries no skill matches and that absence says nothing about which skills exist or what they apply to.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skills_not_matchable",
      "classification": "warning",
      "definition": "Skills were requested on a part that resolved to no spec, so the part binds no graph nodes and there was nothing to match a skill against.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skills_roster_entry_unaddressable",
      "classification": "warning",
      "definition": "A published skill's dcid is unaddressable: it carries a character the Skills API's addressing grammar cannot express, it runs past the length that grammar admits, or it collides with a reserved platform meta name, so the index names it and leaves it out of the catalogue rather than publishing an identifier that answers nothing.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "skills_roster_truncated",
      "classification": "warning",
      "definition": "The read that enumerates published skills stopped at its result bound, so the catalogue may omit skills this deployment publishes.",
      "owning_contract": "skills",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "skills.list",
          "channel": "skills_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "slot_default_not_applied",
      "classification": "warning",
      "definition": "A shape slot default, declared per measure class in the packaged code index, is skipped because no member holding the default value has data at the place while another member does, so the part answers on the slot's other members. The message names the slot and the default value.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "slot_defaulted",
      "classification": "warning",
      "definition": "The query named a constraint slot by its plain name, such as flow, without naming a value for it, and a declared default in the packaged code index fixed that slot to one value, so the answer covers that value alone. The message names the slot and the default value.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "snapshot_not_found",
      "classification": "refusal",
      "definition": "This id is known, but no version was ever materialised at the given content_version.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.snapshot",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.observations",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.recipe",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.description",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 404
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "snapshot_revoked",
      "classification": "refusal",
      "definition": "This snapshot was taken down and stays revoked.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.snapshot",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.observations",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.publish",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.description",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 410
        },
        {
          "endpoint": "datasets.export_link",
          "channel": "problem_details",
          "http_status": 410
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "source_ambiguous",
      "classification": "refusal",
      "definition": "A source mention in the request matched two or more unrelated sources, and the request did not say which one it meant. The detail lists the candidates.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "source_code_ambiguous",
      "classification": "refusal",
      "definition": "The part's source_code is held by more than one source and the part names none. The detail names each source; name one in sources.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "source_code_not_held",
      "classification": "refusal",
      "definition": "No series that a source Search serves holds under the part's source_code can answer the part: no served source holds the code, the part's sources exclude every source that does, or the code's series cannot answer the part as asked. The detail names the cause and the sources whose codes Search holds.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "source_code_shares_variable",
      "classification": "refusal",
      "definition": "The part's source_code shares its StatVar with other codes of the same source, and the graph does not record what separates them, so Search cannot serve the code alone. The detail names the codes that share the variable; ask in words for the part the code names.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "source_not_resolved",
      "classification": "refusal",
      "definition": "A source mention in the request matched no admitted source, dataset or provenance.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "spec_id_mismatch",
      "classification": "refusal",
      "definition": "The supplied definition does not hash to the id beside it.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.register",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "spec_not_exportable",
      "classification": "refusal",
      "definition": "This spec resolves to a breadth-only coverage region with no enumerable member series.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 409
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "spec_not_found",
      "classification": "refusal",
      "definition": "No definition is registered at this id, and none was supplied beside it.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.observations",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.files",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.description",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 404
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 404
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "standard_probe_places_clamped",
      "classification": "warning",
      "definition": "The flattened set of place probes a multi-place query expands into exceeded the overall cap, independent of any per-region child-place clamp.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "starved_axis_binding_restored",
      "classification": "warning",
      "definition": "A constraint axis the availability floor had starved to an empty value set, because every place-available member is silent on it, is restored because the query names one of the axis's own unscoped values. The floor had hidden the axis from the binder.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "retired"
    },
    {
      "code": "stat_var_unresolved",
      "classification": "refusal",
      "definition": "An analysis step needs one StatVar and its input holds several, or none the step can use. A composite input read with one series per StatVar is the common case.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "stat_vars_summed",
      "classification": "warning",
      "definition": "The series sums observations from more than one StatVar in the requested family, and carries the family's reference as its stat_var.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "sum_of_no_key_matched",
      "classification": "refusal",
      "definition": "No member of a sum_of step's data side pairs with a member of its other side through the step's on mapping, so there is nothing to add.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "time_text_not_parsed",
      "classification": "warning",
      "definition": "A free-form time phrase in a parsed-door request did not match any recognised date grammar, so it is treated as dateless instead of being refused.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "time_window_defaulted",
      "classification": "warning",
      "definition": "No time window was named on the request, so the answer was resolved across the series' whole published history. Distinct from time_text_not_parsed, which reports a window that was named but not understood.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "timed_out",
      "classification": "refusal",
      "definition": "Search stopped at the request's time limit before it resolved this part; the same question, or a narrower one, may answer when sent again.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "timeout",
      "classification": "refusal",
      "definition": "The request did not complete before its deadline.",
      "owning_contract": "platform",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "platform.any",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "search.resolve",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "presentation.frames",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "presentation.component_read",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "presentation.component_data",
          "channel": "problem_details",
          "http_status": 504
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 504
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "tool_not_found",
      "classification": "refusal",
      "definition": "The request names a tool the server does not offer, either because the name is unknown or because the tool was removed from the public list in favour of another.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "transient_unavailable",
      "classification": "refusal",
      "definition": "A service behind the one called could not be reached or failed, or a lost frame cannot be computed again yet, so the call has no answer now. The identical call is expected to succeed after a delay.",
      "owning_contract": "mcp",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "un_system_unavailable",
      "classification": "warning",
      "definition": "The UN System Data Commons did not answer for part of the request: either the resolve, so the answer holds no UN candidates, or reads for named places, so the answer holds no UN data for the places the warning names.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "unit_conversion_unavailable",
      "classification": "warning",
      "definition": "The API could not load its conversion catalogue, so this answer states no unit_conversion offer even though its data may convert. The absent offer says nothing about which conversions the data supports.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "unit_heterogeneous",
      "classification": "refusal",
      "definition": "An analysis step reads an input that carries more than one unit, or a pinned unit the input does not declare, and the response lists the candidates to pin.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "unit_not_resolved",
      "classification": "refusal",
      "definition": "The unit phrase cannot be parsed by the binder's grammar, carries tokens its lexicons do not consume, or names an ambiguous currency with no declared alias.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "unit_request_unsupported",
      "classification": "refusal",
      "definition": "The unit phrase parses but names something the request grammar cannot express, such as PPP terms, a non-currency unit, or a per-capita form.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "unsupported_code"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "unsupported_children_anchor_type",
      "classification": "refusal",
      "definition": "The options request's children scope binds an anchor entity whose type has no children-scope mapping in this deployment.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 400
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "unsupported_peers_anchor_type",
      "classification": "refusal",
      "definition": "The options request's peers scope binds an anchor entity whose type has no peers-scope mapping in this deployment.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 400
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "unsupported_schema_version",
      "classification": "refusal",
      "definition": "The request names a schema_version other than the one supported, an identity_version the server does not mint, or a definition binding an axis key that belongs to a higher schema_version than the request declares.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.register",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "datasets.pin",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "graph.resolve",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "presentation.render",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 422
        },
        {
          "endpoint": "graph.nodes",
          "channel": "problem_details",
          "http_status": 422
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "upstream_error",
      "classification": "refusal",
      "definition": "A call to an upstream data source failed or returned an error.",
      "owning_contract": "platform",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "datasets.members",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "search.resolve",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "search.options",
          "doors": [
            "options"
          ],
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "graph.node",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "graph.resolve",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "graph.nodes",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "graph.documentation",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "graph.members",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 502
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "upstream_version_changed",
      "classification": "refusal",
      "definition": "The upstream source refreshed mid-materialisation and the retry did not converge.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.definition",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.options",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.refresh",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.analysis",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "datasets.exports",
          "channel": "problem_details",
          "http_status": 503
        },
        {
          "endpoint": "mcp.tools",
          "channel": "mcp_refusal"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "variable_not_resolved",
      "classification": "refusal",
      "definition": "No StatVar matched the requested variable text.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "no_data_reason"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "variable_text_entity_like",
      "classification": "warning",
      "definition": "A parsed-door part carried no structured entities array and its variable_text contains a capitalised token that looks like a place or organisation name, which degrades recall scoring. Advisory: the name is not extracted from the text.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "variables_clamped",
      "classification": "warning",
      "definition": "The number of variables extracted from the query exceeded the cap and was truncated to the first allowed variables.",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "whole_total_available",
      "classification": "warning",
      "definition": "The answer lists each member of a flow side whose dataset publishes the total of that side's whole population for the answer's years, so a sum of the listed members can differ from the published figure. The params name the total (total, total_label) and the party classes it covers (whole_of: official, private or residual, comma-joined).",
      "owning_contract": "search",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "search.resolve",
          "doors": [
            "raw_text",
            "parsed",
            "dataset_resubmit"
          ],
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "withheld_by_registry",
      "classification": "warning",
      "definition": "A series came back empty because every facet for it sits under a provenance the origin registry does not admit; the warning names those provenances.",
      "owning_contract": "datasets",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "datasets.mint",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.definition",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.options",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "datasets.snapshot",
          "channel": "manifest_warning"
        },
        {
          "endpoint": "search.resolve",
          "channel": "diagnostics_warning"
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "write_refused",
      "classification": "refusal",
      "definition": "A revise of a component, or an append into an existing composition, carries no write token or one that does not match the draft's. Drafts created before write tokens hold none and refuse every revise.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.write",
          "channel": "problem_details",
          "http_status": 403
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "write_token_invalid",
      "classification": "refusal",
      "definition": "A replace or delete of a share carries a write token other than the share's, or names a share created without one, which no token can change.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 403
        }
      ],
      "lifecycle": "active"
    },
    {
      "code": "write_token_required",
      "classification": "refusal",
      "definition": "A replace or delete of a share carries no write token.",
      "owning_contract": "presentation",
      "owner": "platform",
      "introduced_in": "v1",
      "mappings": [
        {
          "endpoint": "presentation.shares",
          "channel": "problem_details",
          "http_status": 403
        }
      ],
      "lifecycle": "active"
    }
  ]
}