{
  "tool": "mba-strategy.hhi_concentration",
  "name": "Market concentration and merger screening (CDU-BUS-MBAS-910)",
  "answers": "How concentrated is this market, and would merging two of its firms move it into a higher scrutiny band?",
  "degree": {
    "id": "competency:mba-strategy",
    "code": "CDU-BUS-MBAS-910",
    "name": "MBA — Strategy",
    "version": "1.0.0"
  },
  "reference": "Herfindahl–Hirschman Index; US DOJ/FTC Horizontal Merger Guidelines (2010) §5.3 bands; shares are normalised to sum to 100",
  "endpoint": "/faculty/mba-strategy/hhi_concentration",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "shares"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "shares": {
        "type": "array",
        "description": "Each firm's share (percent, or any weights — normalised to 100)",
        "items": {
          "type": "number"
        }
      },
      "mergingA": {
        "type": "number",
        "description": "Position (1-based) of the first merging firm, 0 for none",
        "minimum": 0,
        "maximum": 50,
        "default": 0
      },
      "mergingB": {
        "type": "number",
        "description": "Position (1-based) of the second merging firm, 0 for none",
        "minimum": 0,
        "maximum": 50,
        "default": 0
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "hhi",
      "band",
      "delta",
      "postMergerHhi",
      "postMergerBand"
    ],
    "properties": {
      "hhi": {
        "type": "number",
        "description": "HHI before any merger, 0–10,000"
      },
      "band": {
        "type": "string",
        "description": "unconcentrated · moderately concentrated · highly concentrated"
      },
      "delta": {
        "type": "number",
        "description": "ΔHHI from the merger, 0 when none is named"
      },
      "postMergerHhi": {
        "type": "number",
        "description": "HHI after the merger"
      },
      "postMergerBand": {
        "type": "string",
        "description": "the band after the merger"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "shares": [
      30,
      25,
      20,
      15,
      10
    ],
    "mergingA": 2,
    "mergingB": 3
  }
}