{
  "title": "Memrail diagnostic codes",
  "description": "EMU validation codes, declared decision-trace suppressions, and core invoke/event HTTP error codes. Other endpoints and uncoded HTTP errors may return additional diagnostics.",
  "severity": "Use the response finding's severity field. A WARN- prefix does not guarantee a non-blocking severity.",
  "reference": "https://docs.memrail.com/troubleshooting/#diagnostic-codes",
  "validation": [
    {
      "code": "ERROR-DSL-PARSE",
      "suggested_response": "Correct the trigger syntax using the DSL reference."
    },
    {
      "code": "ERROR-INVALID-DURATION",
      "suggested_response": "Use a valid positive ISO 8601 event window."
    },
    {
      "code": "WARN-ACTION-ARGS-MISSING",
      "suggested_response": "Supply every argument required by the registered tool schema."
    },
    {
      "code": "WARN-ACTION-ARGS-TYPE-MISMATCH",
      "suggested_response": "Align action argument values with the registered schema."
    },
    {
      "code": "WARN-ACTION-PLACEHOLDER-NEVER-SEEN",
      "suggested_response": "Supply the interpolated atom and guard required values with EXISTS."
    },
    {
      "code": "WARN-ACTION-TOOL-NOT-FOUND",
      "suggested_response": "Check the intended project's tool schema and runtime handler."
    },
    {
      "code": "WARN-EXPECTED-UTILITY-SANITY",
      "suggested_response": "Review expected utility against observed reachability."
    },
    {
      "code": "WARN-LOW-REACH",
      "suggested_response": "Investigate stale or infrequent atom observations."
    },
    {
      "code": "WARN-MISSING-BINDING-CONTEXT",
      "suggested_response": "Supply the anchor state needed by the trigger's bind() expression."
    },
    {
      "code": "WARN-NEVER-SEEN",
      "suggested_response": "Verify the atom producer, scope, and invocation coverage before changing policy."
    },
    {
      "code": "WARN-POLICY-GAP",
      "suggested_response": "Review structured cooldown and action idempotency controls for side effects."
    },
    {
      "code": "WARN-SCHEMA-MISMATCH",
      "suggested_response": "Align observed atom types with the trigger operators."
    },
    {
      "code": "WARN-SEMANTIC-EQUIVALENT",
      "suggested_response": "Check the actual event producer and use its canonical event name."
    },
    {
      "code": "WARN-WINDOW-OUT-OF-RETENTION",
      "suggested_response": "Check the organization's retention against the required history."
    }
  ],
  "suppression": [
    {
      "code": "consent_missing",
      "suggested_response": "Obtain authenticated operation-specific approval before supplying consent."
    },
    {
      "code": "cooldown_active",
      "suggested_response": "Inspect the existing cooldown; do not bypass it by changing policy identity."
    },
    {
      "code": "correlation_id_missing",
      "suggested_response": "Supply the correlation atom required by policy."
    },
    {
      "code": "exclusion_group_conflict",
      "suggested_response": "Inspect the winning policy in the shared exclusion group."
    },
    {
      "code": "idempotency_lock_active",
      "suggested_response": "Reconcile the operation's existing activation or execution."
    },
    {
      "code": "lifecycle_state",
      "suggested_response": "Check whether this EMU's lifecycle permits selection."
    },
    {
      "code": "policy_auto_ml_blocked",
      "suggested_response": "Check model-derived input provenance and automatic execution policy."
    },
    {
      "code": "quota_throttle",
      "suggested_response": "Check quota and throttling limits."
    },
    {
      "code": "ranked_out",
      "suggested_response": "Compare score, priority, and the selected candidate."
    },
    {
      "code": "shadow_request",
      "suggested_response": "Inspect evaluation diagnostics without executing the result."
    },
    {
      "code": "shadow_state",
      "suggested_response": "Inspect the shadow candidate's trace before a reviewed lifecycle transition."
    },
    {
      "code": "topk_advisory_only",
      "suggested_response": "Review the top-k advisory selection constraint."
    },
    {
      "code": "topk_requires_groups",
      "suggested_response": "Review multi-selection and exclusion-group configuration."
    },
    {
      "code": "trigger_failed",
      "suggested_response": "Compare supplied context and event history with the trigger."
    },
    {
      "code": "validation_error",
      "suggested_response": "Inspect the accompanying validation details."
    }
  ],
  "http": [
    {
      "code": "DATABASE_ERROR",
      "suggested_response": "Treat as a service failure and apply the decision point's safe fallback."
    },
    {
      "code": "DSL_EVALUATION_ERROR",
      "suggested_response": "Inspect the trigger and supplied context identified in the error details."
    },
    {
      "code": "IDEMPOTENCY_KEY_REUSED",
      "suggested_response": "Reuse a key only for an identical logical request; do not bypass duplicate protection."
    },
    {
      "code": "RATE_LIMIT_EXCEEDED",
      "suggested_response": "Honor Retry-After and use bounded retry with backoff."
    },
    {
      "code": "TOPK_ADVISORY_ONLY",
      "suggested_response": "Use top_k=1 for execution-oriented selection; inspect API details."
    },
    {
      "code": "VALIDATION_ERROR",
      "suggested_response": "Correct the fields identified in the response details before retrying."
    }
  ]
}