locale key usage audit derived

{
  "input": {
    "body": {
      "messages": {
        "app": {
          "title": "Dashboard",
          "greeting": "Hello, {name}"
        },
        "cart": {
          "item_one": "You have {count} item in your cart",
          "item_other": "You have {count} items in your cart"
        },
        "legal": {
          "terms": "By continuing you accept the <a href=\"/terms\">terms</a>"
        },
        "errors": {
          "retry": "Try again",
          "generic": "Something went wrong"
        },
        "shared": {
          "cancel": "Cancel",
          "dismiss": "Cancel"
        },
        "invoice": {
          "total": "Total: {amount, number, ::currency/USD}"
        }
      },
      "referenced_keys": [
        "app.title",
        "app.greeting",
        "cart.item_one",
        "cart.item_other",
        "legal.terms",
        "shared.cancel",
        "checkout.submit",
        "account.name"
      ],
      "dynamic_key_prefixes": [
        "errors"
      ]
    },
    "type": "http",
    "method": "POST",
    "bodyType": "json"
  },
  "output": {
    "type": "json",
    "example": {
      "limits": {
        "maxKeys": 50000,
        "maxLocales": 60,
        "maxFindings": 500,
        "maxFileBytes": 2097152,
        "maxValueLength": 32768
      },
      "passed": false,
      "complete": false,
      "findings": [
        {
          "key": "invoice.total",
          "code": "KEY_NOT_REFERENCED",
          "detail": "invoice.total is defined and nothing in the supplied reference list uses it. It is translated on every release and shown never."
        },
        {
          "key": "shared.dismiss",
          "code": "KEY_NOT_REFERENCED",
          "detail": "shared.dismiss is defined and nothing in the supplied reference list uses it. It is translated on every release and shown never."
        },
        {
          "key": "checkout.submit",
          "code": "REFERENCED_KEY_NOT_DEFINED",
          "detail": "checkout.submit is referenced and the file does not define it. What appears is the key itself, the base string, or nothing, depending on the loader."
        }
      ],
      "fully_used": false,
      "request_id": "example-request",
      "service_id": "locale_key_usage_audit",
      "assumptions": [
        "The reference list is the caller’s, because only they know how their code names keys. Nothing is scanned or guessed here.",
        "A key built at run time cannot be found by any scan, so the caller declares its prefix and those keys are excluded with the exclusion recorded. Guessing instead would report half a translation file as...",
        "A referenced key the file does not define is reported separately from an unused one, because the first shows a key in the interface and the second only costs translation effort."
      ],
      "limitations": [
        "The file against the reference list supplied. A list that is incomplete produces findings about keys that are in fact used, which is why the dynamic prefixes exist.",
        "fully_used is true only when every defined key was referenced, every reference resolved, and nothing was excluded."
      ],
      "observed_at": "2026-10-02T00:00:00.000Z",
      "not_examined": [
        "KEY_MATCHED_A_DYNAMIC_PREFIX: errors.generic matches a declared dynamic prefix, so whether anything references it was not determined.",
        "KEY_MATCHED_A_DYNAMIC_PREFIX: errors.retry matches a declared dynamic prefix, so whether anything references it was not determined."
      ],
      "finding_count": 4,
      "service_version": "1.0.0",
      "findings_by_code": {
        "KEY_NOT_REFERENCED": 2,
        "REFERENCED_KEY_NOT_DEFINED": 2
      },
      "unused_key_count": 2,
      "defined_key_count": 10,
      "dynamic_key_count": 2,
      "dynamic_key_prefixes": [
        "errors"
      ],
      "referenced_key_count": 8,
      "undefined_reference_count": 2
    }
  }
}