mcp-server-langgraph: Command for Claude Code

Coverage Gaps Dashboard

You are tasked with generating a visual coverage gaps dashboard for the mcp-server-langgraph project. This command provides an at-a-glance view of coverage health with ASCII heatmaps and prioritization.

Project Coverage Context

Current Coverage: 60-65% combined (unit + integration) Target Coverage: 80% Test Suite: 437+ tests Strategy: Prioritize by risk and criticality

Your Task

Step 1: Run Coverage Analysis

1. Run pytest with coverage:

   uv run --frozen pytest tests/ --cov=src/mcp_server_langgraph --cov-report=term --cov-report=html --quiet
   

2. Parse coverage output to extract:

   • Overall coverage percentage
   • Per-module coverage
   • Per-file coverage
   • Line counts (total, covered, missed)

Step 2: Generate Visual Coverage Heatmap

Create an ASCII heatmap showing coverage by module:

Heatmap Legend:

• 🟢 Green (80-100%): Good coverage
• 🟡 Yellow (60-79%): Needs improvement
• 🟠 Orange (40-59%): Poor coverage
• 🔴 Red (0-39%): Critical gap

Example Heatmap Output:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  COVERAGE HEATMAP - mcp-server-langgraph
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Module                     Coverage  Status  Lines    Missing
  ──────────────────────────────────────────────────────────────
  📦 core/
    ├─ agent.py              ████████  82%   🟢  456     82
    ├─ config.py             ██████░░  73%   🟡  234     63
    └─ feature_flags.py      ████████  91%   🟢  127     11

  🔐 auth/
    ├─ middleware.py         ███████░  78%   🟡  312     69
    ├─ jwt.py                ████████  88%   🟢  198     24
    ├─ rbac.py               ██░░░░░░  25%   🔴  267    200  ⚠️
    └─ keycloak.py           ███░░░░░  35%   🔴  189    123  ⚠️

  💾 session/
    ├─ store.py              ███████░  76%   🟡  345     83
    ├─ distributed.py        ███░░░░░  38%   🔴  402    249  ⚠️
    └─ checkpointing.py      ████████  84%   🟢  278     44

  🔧 tools/
    ├─ calculator_tools.py   ████████  95%   🟢  156     8
    ├─ filesystem.py         ██████░░  62%   🟡  289    110
    └─ search_tools.py       ███████░  72%   🟡  201     56

  🌐 mcp/
    ├─ stdio_server.py       ███████░  77%   🟡  423    97
    ├─ protocol.py           █████░░░  58%   🟠  378    159  ⚠️
    └─ handlers.py           ████████  81%   🟢  234     44

  📊 observability/
    ├─ telemetry.py          ████████  86%   🟢  412     58
    ├─ logging.py            ███████░  79%   🟡  267     56
    └─ metrics.py            ████████  89%   🟢  334     37

  ──────────────────────────────────────────────────────────────
  TOTAL                      ██████░░  65%   🟡  6,302  1,573
  ──────────────────────────────────────────────────────────────

  Legend: ████ = covered | ░░░░ = missing | ⚠️ = critical gap