locale nesting contract audit derived

{
  "input": {
    "body": {
      "contract": {
        "max_depth": 3,
        "separator": ".",
        "key_pattern": "[a-z][a-z0-9_]*",
        "require_flat": false
      },
      "messages": {
        "app": {
          "nav": {
            "primary": {
              "settings": {
                "label": "Settings"
              }
            }
          }
        },
        "CamelCase": {
          "Label": "Mixed case segments"
        },
        "has space": "Whitespace in a key",
        "shared.Cancel": "Cancel again",
        "shared.cancel": "Cancel",
        "errors.generic": "Generic error",
        "errors.generic.detail": "With more detail"
      }
    },
    "type": "http",
    "method": "POST",
    "bodyType": "json"
  },
  "output": {
    "type": "json",
    "example": {
      "limits": {
        "maxKeys": 50000,
        "maxLocales": 60,
        "maxFindings": 500,
        "maxFileBytes": 2097152,
        "maxValueLength": 32768
      },
      "passed": false,
      "checked": {
        "max_depth": 3,
        "key_pattern": "[a-z][a-z0-9_]*",
        "require_flat": false
      },
      "complete": true,
      "findings": [
        {
          "key": "app.nav.primary.settings.label",
          "code": "KEY_DEEPER_THAN_PERMITTED",
          "detail": "app.nav.primary.settings.label is 5 levels deep and the contract allows 3."
        },
        {
          "key": "shared.Cancel",
          "code": "KEY_SEGMENT_DOES_NOT_MATCH_PATTERN",
          "detail": "shared.Cancel has a segment the declared key pattern does not accept."
        },
        {
          "key": "has space",
          "code": "KEY_SEGMENT_DOES_NOT_MATCH_PATTERN",
          "detail": "has space has a segment the declared key pattern does not accept."
        }
      ],
      "key_count": 7,
      "separator": ".",
      "conformant": false,
      "request_id": "example-request",
      "service_id": "locale_nesting_contract_audit",
      "assumptions": [
        "A nested file is flattened to separated keys first, so the same contract applies whether the file is written flat or nested. Which separator is used is the caller’s to state.",
        "A key that is both a message and a group is reported while the file is read, because most loaders keep one and silently drop the other, so some of those messages do not exist at run time.",
        "A caller-supplied key pattern is restricted to character classes and simple quantifiers, so matching is cheap by construction rather than by a length bound."
      ],
      "deepest_key": 5,
      "limitations": [
        "Key structure in the file supplied. Which loader reads it, and what that loader does with a structure it did not expect, are outside this.",
        "conformant is true only when every key satisfied the contract and nothing was left unread."
      ],
      "observed_at": "2026-10-02T00:00:00.000Z",
      "not_examined": [],
      "finding_count": 7,
      "service_version": "1.0.0",
      "findings_by_code": {
        "KEY_CONTAINS_WHITESPACE": 1,
        "KEYS_DIFFER_ONLY_IN_CASE": 1,
        "KEY_DEEPER_THAN_PERMITTED": 1,
        "KEY_SEGMENT_DOES_NOT_MATCH_PATTERN": 3,
        "KEY_IS_ALSO_A_PREFIX_OF_ANOTHER_KEY": 1
      },
      "depth_distribution": {
        "1": 1,
        "2": 4,
        "3": 1,
        "5": 1
      }
    }
  }
}