Company Name Fuzzy Match & Normalization

{
  "type": "object",
  "required": [
    "name_b",
    "name_a"
  ],
  "properties": {
    "name_a": {
      "type": "string",
      "description": "First company name"
    },
    "name_b": {
      "type": "string",
      "description": "Second company name to compare"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "match": {
      "type": "boolean",
      "description": "Whether the two names are judged to refer to the same company."
    },
    "name_a": {
      "type": "string",
      "description": "The first company name exactly as submitted, echoed back."
    },
    "name_b": {
      "type": "string",
      "description": "The second company name exactly as submitted, echoed back."
    },
    "confidence": {
      "type": "number",
      "description": "Match confidence, 0 to 1. Observed 1 on an exact match after normalization ('Apple' vs 'Apple Inc.') and 0.2 on two genuinely unrelated companies -- treat as a graded score, not a pass/fail flag."
    },
    "normalized_a": {
      "type": "string",
      "description": "`name_a` lowercased with corporate suffixes and punctuation stripped."
    },
    "normalized_b": {
      "type": "string",
      "description": "`name_b` lowercased with corporate suffixes and punctuation stripped."
    },
    "suffixes_removed": {
      "type": "object",
      "properties": {
        "a": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "b": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "description": "The corporate suffix tokens (e.g. 'inc', 'ltd') stripped from each name while normalizing, lowercased. Observed empty on a name with no suffix to strip.",
      "additionalProperties": true
    },
    "similarity_scores": {
      "type": "object",
      "properties": {
        "levenshtein": {
          "type": "number"
        },
        "jaro_winkler": {
          "type": "number"
        },
        "token_overlap": {
          "type": "number"
        }
      },
      "description": "The individual algorithm scores `confidence` is derived from, each roughly 0 to 1.",
      "additionalProperties": true
    }
  },
  "description": "The company-name comparison result, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}