{
  "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": 94,
  "git_top_score": 94,
  "quality_score": 84,
  "agent_score": 92,
  "verification": {
    "schema_version": "git-top.verification.v1",
    "overall_status": "partial",
    "observed_at": "2026-09-13T10:00:52.414Z",
    "signals": {
      "activity": {
        "status": "observed",
        "source": "github_metadata",
        "evidence": [
          "project.pushed_at",
          "metrics.recent_push_days"
        ]
      },
      "license": {
        "status": "observed",
        "source": "github_metadata",
        "evidence": [
          "project.license"
        ]
      },
      "documentation": {
        "status": "observed",
        "source": "github_metadata",
        "evidence": [
          "project.description"
        ]
      },
      "runtime": {
        "status": "inferred",
        "source": "git_top_heuristic",
        "evidence": [
          "agent_card.deployment",
          "agent_card.cloudflare_ready"
        ]
      },
      "install": {
        "status": "not_run",
        "source": "git_top_runtime",
        "evidence": [
          "installation/build probe is not enabled"
        ]
      },
      "security": {
        "status": "not_run",
        "source": "git_top_runtime",
        "evidence": [
          "dependency/security scan is not enabled"
        ]
      },
      "mcp": {
        "status": "not_run",
        "source": "git_top_runtime",
        "evidence": [
          "MCP liveness and tool-call probe is not enabled"
        ]
      }
    },
    "coverage": {
      "observed": 3,
      "inferred": 1,
      "not_run": 3,
      "unknown": 0
    },
    "next_steps": [
      "Run an installation/build probe before production adoption.",
      "Run a dependency and security scan before treating the score as a trust claim.",
      "Run MCP initialize, tools/list, first-call, and error probes before relying on this server."
    ]
  },
  "git_top_score_breakdown": {
    "community": 100,
    "maintenance": 84,
    "documentation": 92,
    "stability": 90,
    "adoption": 100,
    "agent_readability": 100
  },
  "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": 100,
      "weight": 16,
      "contribution": 16,
      "explanation": "Agent readability reflects summaries, use cases, tradeoffs, dependencies, alternatives, and deployment clarity."
    }
  ],
  "summary": "headroomlabs-ai/headroom scores 94/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": [
    "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: 1 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": "1 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": 92,
    "agent_score_breakdown": {
      "documentation": 90,
      "maintenance": 76,
      "deployment": 100,
      "popularity": 97,
      "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": 71802,
      "recent_commits": 100,
      "contributors": 100,
      "issue_response_time_hours": null,
      "release_frequency_180d": 100
    },
    "quality_signal_confidence": {
      "stars_30d_delta": "snapshot",
      "stars30d_window_days": 30,
      "commits_30d": "partial",
      "releases_180d": "partial",
      "contributors_90d": "partial"
    },
    "verification": {
      "schema_version": "git-top.verification.v1",
      "overall_status": "partial",
      "observed_at": "2026-09-13T10:00:52.414Z",
      "signals": {
        "activity": {
          "status": "observed",
          "source": "github_metadata",
          "evidence": [
            "project.pushed_at",
            "metrics.recent_push_days"
          ]
        },
        "license": {
          "status": "observed",
          "source": "github_metadata",
          "evidence": [
            "project.license"
          ]
        },
        "documentation": {
          "status": "observed",
          "source": "github_metadata",
          "evidence": [
            "project.description"
          ]
        },
        "runtime": {
          "status": "inferred",
          "source": "git_top_heuristic",
          "evidence": [
            "agent_card.deployment",
            "agent_card.cloudflare_ready"
          ]
        },
        "install": {
          "status": "not_run",
          "source": "git_top_runtime",
          "evidence": [
            "installation/build probe is not enabled"
          ]
        },
        "security": {
          "status": "not_run",
          "source": "git_top_runtime",
          "evidence": [
            "dependency/security scan is not enabled"
          ]
        },
        "mcp": {
          "status": "not_run",
          "source": "git_top_runtime",
          "evidence": [
            "MCP liveness and tool-call probe is not enabled"
          ]
        }
      },
      "coverage": {
        "observed": 3,
        "inferred": 1,
        "not_run": 3,
        "unknown": 0
      },
      "next_steps": [
        "Run an installation/build probe before production adoption.",
        "Run a dependency and security scan before treating the score as a trust claim.",
        "Run MCP initialize, tools/list, first-call, and error probes before relying on this server."
      ]
    },
    "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.",
          "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",
      "verification.signals"
    ],
    "caveats": [
      "edge-only Cloudflare Workers deployment without adaptation",
      "users expecting a complete hosted product",
      "Partial or estimated quality signals: commits30d, releases180d, contributors90d.",
      "Independent installation, security, or runtime probes have not been run for this project."
    ],
    "confidence_reason": "Evidence is usable for comparison, but agents should cite caveats before making a strong recommendation.",
    "last_verified_at": "2026-09-13T10:00:52.414Z"
  },
  "caveats": [
    "edge-only Cloudflare Workers deployment without adaptation",
    "users expecting a complete hosted product",
    "Partial or estimated quality signals: commits30d, releases180d, contributors90d.",
    "Independent installation, security, or runtime probes have not been run for this project."
  ],
  "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",
    "verification.signals"
  ],
  "last_verified_at": "2026-09-13T10:00:52.414Z",
  "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": 1214,
    "generated_at": "2026-09-14T18:17:43.349Z",
    "snapshot_id": "d1:1214:2026-09-14T18:01:10.836Z",
    "latest_synced_at": "2026-09-14T18:01:10.836Z",
    "schema_version": "git-top.knowledge.v1",
    "loaded_project_limit": 2000,
    "truncated": false
  }
}