GitHub Repo Health Check (Tech Stack, Activity, Bus Factor, Maintenance Score)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "GitHub repo URL (e.g. https://github.com/owner/repo)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "repo": {
      "type": "string",
      "description": "owner/name form, e.g. 'facebook/react'."
    },
    "forks": {
      "type": "number"
    },
    "stars": {
      "type": "number"
    },
    "license": {
      "type": "string",
      "description": "e.g. 'MIT'."
    },
    "purpose": {
      "type": "string",
      "description": "One-sentence, AI-written summary of what the repo does."
    },
    "summary": {
      "type": "string",
      "description": "A short paragraph summarizing overall repo health."
    },
    "concerns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "AI-written caveats, e.g. contributor-count/backlog observations. Both real calls surfaced a 'future-dated commits' anomaly note -- treat this field as genuine analysis text, not a fixed set of categories."
    },
    "languages": {
      "type": "object",
      "description": "Bytes of code per language, keyed by language name -- the set of keys varies by repo (observed 7 keys for facebook/react, 3 for jashkenas/backbone) and is not a fixed list.",
      "additionalProperties": {
        "type": "number"
      }
    },
    "strengths": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "tech_stack": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Named languages/frameworks/tools detected, e.g. 'JavaScript', 'Rollup'."
    },
    "open_issues": {
      "type": "number"
    },
    "activity_level": {
      "type": "string",
      "description": "Observed as 'very-active' (facebook/react, frequent recent commits) and 'active' (jashkenas/backbone, maintained but slower-moving) -- the full enum, including a value for a genuinely stale/abandoned repo, is unconfirmed."
    },
    "dependency_count": {
      "type": "number"
    },
    "primary_language": {
      "type": "string"
    },
    "top_contributors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "login": {
            "type": "string",
            "description": "The contributor's public GitHub username."
          },
          "contributions": {
            "type": "number"
          }
        },
        "additionalProperties": true
      },
      "description": "Observed as exactly 10 entries on both real calls; likely capped at 10."
    },
    "bus_factor_estimate": {
      "type": "number",
      "description": "An estimated number of people the project could lose without stalling."
    },
    "documentation_quality": {
      "type": "string",
      "description": "Only 'excellent' was observed on both real calls -- the full set of possible values (e.g. a lower rating for a poorly-documented repo) is unconfirmed."
    },
    "maintenance_health_score": {
      "type": "number",
      "description": "Observed 82-92 on the two real calls; likely a 0-100 scale."
    }
  },
  "description": "The repo-analysis record, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}