{
  "project": {
    "project_id": "headroomlabs-ai/headroom",
    "repo": "headroomlabs-ai/headroom",
    "name": "headroom",
    "description": "Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.",
    "category": [
      "mcp_server"
    ],
    "language": "Python",
    "license": "Apache-2.0"
  },
  "project_id": "headroomlabs-ai/headroom",
  "score": 92,
  "git_top_score": 92,
  "quality_score": 84,
  "agent_score": 91,
  "git_top_score_breakdown": {
    "community": 100,
    "maintenance": 84,
    "documentation": 92,
    "stability": 90,
    "adoption": 100,
    "agent_readability": 90
  },
  "dimensions": [
    {
      "key": "community",
      "label": "Community",
      "score": 100,
      "weight": 16,
      "contribution": 16,
      "explanation": "Community reflects contributor activity and ecosystem attention. Current contributor signal is 100."
    },
    {
      "key": "maintenance",
      "label": "Maintenance",
      "score": 84,
      "weight": 20,
      "contribution": 16.8,
      "explanation": "Maintenance reflects repository activity, commits, releases, issue-response signals, and recent push freshness."
    },
    {
      "key": "documentation",
      "label": "Documentation",
      "score": 92,
      "weight": 16,
      "contribution": 14.7,
      "explanation": "Agent-readable documentation signals are strong enough for recommendation workflows."
    },
    {
      "key": "stability",
      "label": "Stability",
      "score": 90,
      "weight": 16,
      "contribution": 14.4,
      "explanation": "Stability reflects release cadence, issue load, recent activity, and maturity signals."
    },
    {
      "key": "adoption",
      "label": "Adoption",
      "score": 100,
      "weight": 16,
      "contribution": 16,
      "explanation": "Adoption is normalized from stars, forks, and ecosystem attention signals."
    },
    {
      "key": "agent_readability",
      "label": "Agent Readability",
      "score": 90,
      "weight": 16,
      "contribution": 14.4,
      "explanation": "Agent readability reflects summaries, use cases, tradeoffs, dependencies, alternatives, and deployment clarity."
    }
  ],
  "summary": "headroomlabs-ai/headroom scores 92/100. Community is strongest at 100/100; Maintenance is the lowest dimension at 84/100.",
  "adoption_guidance": "Promising candidate. Review risk flags, weakest score dimension, and alternatives before recommending it as the default choice.",
  "risk_flags": [
    "Recent star movement is estimated rather than fully observed.",
    "Known caveat: edge-only Cloudflare Workers deployment without adaptation"
  ],
  "score_confidence": {
    "level": "medium",
    "summary": "Score evidence is usable for comparison, but agents should cite the review notes before making a strong recommendation.",
    "reasons": [
      "Quality signal completeness: 0 quality signals are complete or snapshot-backed."
    ],
    "evidence_checklist": [
      {
        "signal": "Classification evidence",
        "status": "strong",
        "description": "3/4 classification signals are high-confidence."
      },
      {
        "signal": "Quality signal completeness",
        "status": "weak",
        "description": "0 quality signals are complete or snapshot-backed."
      },
      {
        "signal": "Deployment clarity",
        "status": "strong",
        "description": "5 deployment targets are indexed."
      },
      {
        "signal": "Agent-readable context",
        "status": "strong",
        "description": "3 use cases and 3 inferred dependencies are available."
      },
      {
        "signal": "Tradeoff disclosure",
        "status": "strong",
        "description": "2 caveats are indexed for adoption decisions."
      }
    ],
    "citation_guidance": "When citing this score, include metadata.source, weakest_dimension, risk_flags, and score_confidence.level."
  },
  "next_actions": [
    {
      "label": "Open project knowledge",
      "href": "/projects/headroomlabs-ai/headroom",
      "kind": "project"
    },
    {
      "label": "Inspect graph",
      "href": "/graph/headroomlabs-ai/headroom",
      "kind": "graph"
    },
    {
      "label": "Find alternatives",
      "href": "/alternatives/headroomlabs-ai/headroom",
      "kind": "alternatives"
    },
    {
      "label": "Compare shortlist",
      "href": "/api/compare?repos=headroomlabs-ai/headroom",
      "kind": "compare"
    },
    {
      "label": "Get category recommendations",
      "href": "/api/recommend?category=mcp_server&limit=5",
      "kind": "recommend"
    }
  ],
  "strongest_dimension": {
    "key": "community",
    "label": "Community",
    "score": 100,
    "weight": 16,
    "contribution": 16,
    "explanation": "Community reflects contributor activity and ecosystem attention. Current contributor signal is 100."
  },
  "weakest_dimension": {
    "key": "maintenance",
    "label": "Maintenance",
    "score": 84,
    "weight": 20,
    "contribution": 16.8,
    "explanation": "Maintenance reflects repository activity, commits, releases, issue-response signals, and recent push freshness."
  },
  "related_scores": {
    "quality_score": 84,
    "agent_score": 91,
    "agent_score_breakdown": {
      "documentation": 90,
      "maintenance": 76,
      "deployment": 100,
      "popularity": 96,
      "community": 100
    }
  },
  "evidence": {
    "deployments": [
      "docker",
      "vercel",
      "serverless",
      "library_only",
      "local"
    ],
    "dependencies": [
      "MCP",
      "Vector database",
      "LLM provider"
    ],
    "use_cases": [
      "connect agents to tools",
      "expose APIs through MCP",
      "bootstrap MCP integrations"
    ],
    "not_good_for": [
      "edge-only Cloudflare Workers deployment without adaptation",
      "users expecting a complete hosted product"
    ],
    "quality_signals": {
      "stars": 63445,
      "recent_commits": 100,
      "contributors": 100,
      "issue_response_time_hours": null,
      "release_frequency_180d": 100
    },
    "quality_signal_confidence": {
      "stars_30d_delta": "estimated",
      "commits_30d": "partial",
      "releases_180d": "partial",
      "contributors_90d": "partial"
    },
    "classification": {
      "category": {
        "confidence": "high",
        "evidence": [
          "Matched \"mcp server\" in metadata.",
          "Matched \"mcp\" in metadata."
        ]
      },
      "deployment": {
        "confidence": "high",
        "evidence": [
          "Found Docker configuration file.",
          "Matched \"vercel\" in repository content.",
          "Matched \"pip install\" in repository content.",
          "Matched \"npm install\" in repository content.",
          "Matched \"library\" in repository content.",
          "Local usage is assumed for open source repositories unless contradicted."
        ]
      },
      "difficulty": {
        "confidence": "medium",
        "evidence": [
          "Found multi-service or orchestration configuration files."
        ]
      },
      "cloudflare_ready": {
        "confidence": "high",
        "evidence": [
          "Runtime blocker: python, gpu.",
          "No Cloudflare deployment signal detected.",
          "No wrangler.toml found in inspected repository files."
        ]
      }
    },
    "source_fields": [
      "project.description",
      "project.topics",
      "project.language",
      "project.license",
      "agent_card.summary_for_agent",
      "agent_card.use_cases",
      "agent_card.deployment",
      "agent_card.classification",
      "metrics"
    ],
    "caveats": [
      "edge-only Cloudflare Workers deployment without adaptation",
      "users expecting a complete hosted product",
      "Partial or estimated quality signals: stars30dDelta, commits30d, releases180d, contributors90d."
    ],
    "confidence_reason": "Evidence is usable for comparison, but agents should cite caveats before making a strong recommendation.",
    "last_verified_at": "2026-07-31T04:00:12.280Z"
  },
  "caveats": [
    "edge-only Cloudflare Workers deployment without adaptation",
    "users expecting a complete hosted product",
    "Partial or estimated quality signals: stars30dDelta, commits30d, releases180d, contributors90d."
  ],
  "confidence_reason": "Score evidence is usable for comparison, but agents should cite the review notes before making a strong recommendation.",
  "source_fields": [
    "project.description",
    "project.topics",
    "project.language",
    "project.license",
    "agent_card.summary_for_agent",
    "agent_card.use_cases",
    "agent_card.deployment",
    "agent_card.classification",
    "metrics"
  ],
  "last_verified_at": "2026-07-31T04:00:12.280Z",
  "links": {
    "page": "/score/headroomlabs-ai/headroom",
    "project_api": "/api/project/headroomlabs-ai/headroom",
    "graph_api": "/api/graph/headroomlabs-ai/headroom",
    "alternatives_api": "/api/alternatives/headroomlabs-ai/headroom",
    "compare_api": "/api/compare?repos=headroomlabs-ai/headroom",
    "recommendations_api": "/api/recommend?category=mcp_server&limit=5"
  },
  "metadata": {
    "source": "d1",
    "reason": "d1_query",
    "project_count": 1010,
    "generated_at": "2026-07-31T12:15:24.626Z",
    "snapshot_id": "d1:1010:2026-07-31T12:00:16.153Z",
    "latest_synced_at": "2026-07-31T12:00:16.153Z",
    "schema_version": "git-top.knowledge.v1",
    "loaded_project_limit": 2000,
    "truncated": false
  }
}