projectpulse-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alessandro Chiodo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# projectpulse-mcp
+
+GitHub repository health monitoring via MCP. 
+
+This Model Context Protocol (MCP) server allows AI assistants to analyze the health, security, and maintenance status of GitHub repositories directly from your conversations.
+
+## Features
+
+- **Repository Health Score**: Calculates a comprehensive 0-100 score based on CI status, freshness, security, and community metrics.
+- **Basic Repository Info**: Fetches general metadata like stars, forks, language, and license.
+- **Dependency Analysis**: Lists Dependabot alerts with severity filtering.
+- **CI/CD Status**: Checks recent GitHub Actions workflow runs and their conclusions.
+- **Code Scanning**: Retrieves CodeQL and other code scanning alerts.
+- **Ping**: Simple connectivity test tool.
+
+## Quick Start
+
+### Installation
+
+You can run `projectpulse-mcp` directly using `npx`:
+
+```bash
+npx projectpulse-mcp
+```
+
+### Claude Desktop Configuration
+
+To use this with Claude Desktop, add the following configuration to your `claude_desktop_config.json` file (usually located at `%APPDATA%\Claude\claude_desktop_config.json` on Windows or `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "projectpulse": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "projectpulse-mcp"
+      ],
+      "env": {
+        "GITHUB_TOKEN": "your-github-personal-access-token"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool Name | Description | Input Schema |
+| --- | --- | --- |
+| `get_health_score` | Calculate a 0-100 health score for a GitHub repository with grade (A-F), category breakdown, and improvement suggestions. | `owner` (string), `repo` (string) |
+| `get_repo_health` | Get health information for a GitHub repository (stars, issues, language, license, etc.). | `owner` (string), `repo` (string) |
+| `analyze_dependencies` | Get Dependabot alerts for a GitHub repository. | `owner` (string), `repo` (string), `severity` (optional enum: critical, high, medium, low) |
+| `check_ci_status` | Get recent CI/CD workflow runs for a GitHub repository. | `owner` (string), `repo` (string), `limit` (optional number, default: 10) |
+| `analyze_code_scanning` | Get Code Scanning alerts for a GitHub repository with CodeQL. | `owner` (string), `repo` (string) |
+| `ping` | Simple connectivity check that responds with a pong. | `message` (string) |
+
+## Configuration
+
+### GITHUB_TOKEN setup
+
+To use the GitHub API without severe rate limits and to access private repositories or security alerts, you must provide a GitHub Personal Access Token (PAT). 
+
+1. Go to your GitHub account settings: **Settings** > **Developer settings** > **Personal access tokens** > **Tokens (classic)**.
+2. Click **Generate new token (classic)**.
+3. Grant it at least the following scopes:
+   - `repo` (Full control of private repositories)
+   - `security_events` (Read and write security events)
+4. Copy the token and set it as an environment variable named `GITHUB_TOKEN` in your MCP client configuration (e.g., Claude Desktop config).
+
+## License
+
+MIT License. See the `LICENSE` file for details.

package/bin/projectpulse-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/github/client.d.ts

@@ -0,0 +1,3 @@
+import { Octokit } from "@octokit/rest";
+export declare function getOctokit(): Octokit;
+//# sourceMappingURL=client.d.ts.map

package/dist/github/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC,wBAAgB,UAAU,IAAI,OAAO,CAMpC"}

package/dist/github/client.js

@@ -0,0 +1,10 @@
+import { Octokit } from "@octokit/rest";
+let octokitInstance = null;
+export function getOctokit() {
+    if (!octokitInstance) {
+        const token = process.env.GITHUB_TOKEN;
+        octokitInstance = new Octokit({ auth: token });
+    }
+    return octokitInstance;
+}
+//# sourceMappingURL=client.js.map

package/dist/github/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,IAAI,eAAe,GAAmB,IAAI,CAAC;AAE3C,MAAM,UAAU,UAAU;IACtB,IAAI,CAAC,eAAe,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACvC,eAAe,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,eAAe,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,29 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { registerCheckCiStatus } from "./tools/check-ci-status.js";
+import { registerGetRepoHealth } from "./tools/get-repo-health.js";
+import { registerAnalyzeDependencies } from "./tools/analyze-dependencies.js";
+import { registerAnalyzeCodeScanning } from "./tools/analyze-code-scanning.js";
+import { registerGetHealthScore } from "./tools/get-health-score.js";
+const server = new McpServer({ name: "projectpulse-mcp", version: "0.1.0" });
+registerCheckCiStatus(server);
+registerGetRepoHealth(server);
+registerAnalyzeDependencies(server);
+registerAnalyzeCodeScanning(server);
+registerGetHealthScore(server);
+server.registerTool("ping", {
+    description: "This is a simple ping, response with pong",
+    inputSchema: z.object({
+        message: z
+            .string()
+            .describe("This is a simple ping, response with pong")
+    }),
+}, async ({ message }) => {
+    return {
+        content: [{ type: "text", text: `pong ${message}` }]
+    };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAE7E,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACpC,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACpC,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAE/B,MAAM,CAAC,YAAY,CACf,MAAM,EAAE;IACR,WAAW,EAAE,2CAA2C;IACxD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,OAAO,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,CAAC,2CAA2C,CAAC;KAC7D,CAAC;CACL,EACG,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;IAClB,OAAO;QACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,OAAO,EAAE,EAAE,CAAC;KACvD,CAAC;AACN,CAAC,CACJ,CAAA;AAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;AAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/scoring/health-score.d.ts

@@ -0,0 +1,16 @@
+import { Grade, CategoryScore, HealthReport } from "../types/health.js";
+export declare function scoreToGrade(score: number): Grade;
+export declare function calculateCiScore(runs: Array<{
+    conclusion: string | null;
+}>): CategoryScore;
+export declare function calculateFreshnessScore(pushedAt: string): CategoryScore;
+export declare function calculateSecurityScore(alertCounts: {
+    critical: number;
+    high: number;
+    medium: number;
+    low: number;
+}): CategoryScore;
+export declare function calculateCommunityScore(openIssues: number, forks: number): CategoryScore;
+export declare function calculateMaintenanceScore(hasLicense: boolean, hasDescription: boolean, archived: boolean): CategoryScore;
+export declare function calculateHealthScore(repo: string, categories: Record<string, CategoryScore>): HealthReport;
+//# sourceMappingURL=health-score.d.ts.map

package/dist/scoring/health-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-score.d.ts","sourceRoot":"","sources":["../../src/scoring/health-score.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAMjD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAAG,aAAa,CAK1F;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAQvE;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CASlI;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAQxF;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,aAAa,CAMxH;AAED,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAC1C,YAAY,CAQd"}

package/dist/scoring/health-score.js

@@ -0,0 +1,80 @@
+const WEIGHTS = {
+    ci: 0.25,
+    freshness: 0.20,
+    community: 0.15,
+    security: 0.25,
+    maintenance: 0.15,
+};
+export function scoreToGrade(score) {
+    if (score >= 80)
+        return 'A';
+    if (score >= 60)
+        return 'B';
+    if (score >= 40)
+        return 'C';
+    if (score >= 20)
+        return 'D';
+    return 'F';
+}
+export function calculateCiScore(runs) {
+    const passed = runs.filter(r => r.conclusion === "success").length;
+    const total = runs.length;
+    const score = total === 0 ? 0 : Math.round((passed / total) * 100);
+    return { score, weight: WEIGHTS.ci, detail: `${passed}/${total} runs passed` };
+}
+export function calculateFreshnessScore(pushedAt) {
+    const daysAgo = (Date.now() - new Date(pushedAt).getTime()) / (1000 * 60 * 60 * 24);
+    let score;
+    if (daysAgo < 7)
+        score = 100;
+    else if (daysAgo < 30)
+        score = 70;
+    else if (daysAgo < 90)
+        score = 40;
+    else
+        score = 10;
+    return { score, weight: WEIGHTS.freshness, detail: `Last push ${Math.round(daysAgo)} days ago` };
+}
+export function calculateSecurityScore(alertCounts) {
+    const { critical, high, medium, low } = alertCounts;
+    let score = 100;
+    score -= critical * 25;
+    score -= high * 15;
+    score -= medium * 5;
+    score -= low * 2;
+    score = Math.max(0, score);
+    return { score, weight: WEIGHTS.security, detail: `Alerts: ${critical} critical, ${high} high, ${medium} medium, ${low} low` };
+}
+export function calculateCommunityScore(openIssues, forks) {
+    let score = 50;
+    if (forks > 10)
+        score += 25;
+    else if (forks > 0)
+        score += 10;
+    if (openIssues > 50)
+        score -= 25;
+    else if (openIssues > 20)
+        score -= 10;
+    score = Math.max(0, Math.min(100, score));
+    return { score, weight: WEIGHTS.community, detail: `${openIssues} open issues, ${forks} forks` };
+}
+export function calculateMaintenanceScore(hasLicense, hasDescription, archived) {
+    let score = 0;
+    if (hasLicense)
+        score += 35;
+    if (hasDescription)
+        score += 35;
+    if (!archived)
+        score += 30;
+    return { score, weight: WEIGHTS.maintenance, detail: `License: ${hasLicense}, Description: ${hasDescription}, Active: ${!archived}` };
+}
+export function calculateHealthScore(repo, categories) {
+    const values = Object.values(categories);
+    const score = Math.round(values.reduce((sum, cat) => sum + cat.score * cat.weight, 0));
+    const grade = scoreToGrade(score);
+    const suggestions = values
+        .filter(cat => cat.score < 50)
+        .map(cat => `Improve ${cat.detail} (score: ${cat.score}/100)`);
+    return { repo, score, grade, breakdown: categories, suggestions, checkedAt: new Date().toISOString() };
+}
+//# sourceMappingURL=health-score.js.map

package/dist/scoring/health-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-score.js","sourceRoot":"","sources":["../../src/scoring/health-score.ts"],"names":[],"mappings":"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"}

package/dist/scoring/health-score.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=health-score.test.d.ts.map

package/dist/scoring/health-score.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-score.test.d.ts","sourceRoot":"","sources":["../../src/scoring/health-score.test.ts"],"names":[],"mappings":""}

package/dist/scoring/health-score.test.js

@@ -0,0 +1,209 @@
+import { describe, it, expect } from 'vitest';
+import { scoreToGrade, calculateCiScore, calculateSecurityScore, calculateFreshnessScore, calculateCommunityScore, calculateMaintenanceScore, calculateHealthScore } from './health-score.js';
+describe('scoreToGrade', () => {
+    // qui dentro scrivi i test case
+    // ogni it() testa un caso specifico
+    it('should return A for score 85', () => {
+        expect(scoreToGrade(85)).toBe('A');
+    });
+    it('should return B for score 65', () => {
+        expect(scoreToGrade(65)).toBe('B');
+    });
+    it('should return C for score 45', () => {
+        expect(scoreToGrade(45)).toBe('C');
+    });
+    it('should return D for score 25', () => {
+        expect(scoreToGrade(25)).toBe('D');
+    });
+});
+describe('calculateCiScore', () => {
+    it('should return 100 for all successful runs', () => {
+        expect(calculateCiScore([{
+                conclusion: 'success'
+            }])).toEqual({
+            score: 100,
+            weight: 0.25,
+            detail: '1/1 runs passed'
+        });
+    });
+    it('should return 50 for 1 failed run', () => {
+        expect(calculateCiScore([{
+                conclusion: 'failure',
+            }, {
+                conclusion: 'success'
+            }])).toEqual({
+            score: 50,
+            weight: 0.25,
+            detail: '1/2 runs passed'
+        });
+    });
+    it('should return 0 for no runs', () => {
+        expect(calculateCiScore([])).toEqual({
+            score: 0,
+            weight: 0.25,
+            detail: '0/0 runs passed'
+        });
+    });
+});
+describe('calculateSecurityScore', () => {
+    it('should return 100 with no alerts', () => {
+        expect(calculateSecurityScore({
+            critical: 0,
+            high: 0,
+            medium: 0,
+            low: 0
+        })).toEqual({
+            score: 100,
+            weight: 0.25,
+            detail: 'Alerts: 0 critical, 0 high, 0 medium, 0 low'
+        });
+    });
+    it('should return 50 for 2 critical alerts', () => {
+        expect(calculateSecurityScore({
+            critical: 2, // -50
+            high: 0,
+            medium: 0,
+            low: 0
+        })).toEqual({
+            score: 50,
+            weight: 0.25,
+            detail: 'Alerts: 2 critical, 0 high, 0 medium, 0 low'
+        });
+    });
+    it('should calculate 44 for a mix of severities', () => {
+        expect(calculateSecurityScore({
+            critical: 1, // -25
+            high: 1, // -15
+            medium: 2, // -10
+            low: 3 // -6
+        })).toEqual({
+            score: 44, // 100 - 25 - 15 - 10 - 6 = 44
+            weight: 0.25,
+            detail: 'Alerts: 1 critical, 1 high, 2 medium, 3 low'
+        });
+    });
+    it('should bound score to 0 (overflow)', () => {
+        expect(calculateSecurityScore({
+            critical: 5, // -125
+            high: 0,
+            medium: 0,
+            low: 0
+        })).toEqual({
+            score: 0,
+            weight: 0.25,
+            detail: 'Alerts: 5 critical, 0 high, 0 medium, 0 low'
+        });
+    });
+});
+describe('calculateFreshnessScore', () => {
+    it('should return 100 for push within 7 days', () => {
+        const date = new Date(Date.now() - 5 * 24 * 60 * 60 * 1000).toISOString();
+        expect(calculateFreshnessScore(date)).toEqual({
+            score: 100,
+            weight: 0.20,
+            detail: 'Last push 5 days ago'
+        });
+    });
+    it('should return 70 for push within 30 days', () => {
+        const date = new Date(Date.now() - 15 * 24 * 60 * 60 * 1000).toISOString();
+        expect(calculateFreshnessScore(date)).toEqual({
+            score: 70,
+            weight: 0.20,
+            detail: 'Last push 15 days ago'
+        });
+    });
+    it('should return 40 for push within 90 days', () => {
+        const date = new Date(Date.now() - 60 * 24 * 60 * 60 * 1000).toISOString();
+        expect(calculateFreshnessScore(date)).toEqual({
+            score: 40,
+            weight: 0.20,
+            detail: 'Last push 60 days ago'
+        });
+    });
+    it('should return 10 for push older than 90 days', () => {
+        const date = new Date(Date.now() - 100 * 24 * 60 * 60 * 1000).toISOString();
+        expect(calculateFreshnessScore(date)).toEqual({
+            score: 10,
+            weight: 0.20,
+            detail: 'Last push 100 days ago'
+        });
+    });
+});
+describe('calculateCommunityScore', () => {
+    it('should return 50 for no forks and no issues', () => {
+        expect(calculateCommunityScore(0, 0)).toEqual({
+            score: 50,
+            weight: 0.15,
+            detail: '0 open issues, 0 forks'
+        });
+    });
+    it('should increase score for forks', () => {
+        expect(calculateCommunityScore(0, 5)).toEqual({
+            score: 60, // 50 + 10
+            weight: 0.15,
+            detail: '0 open issues, 5 forks'
+        });
+        expect(calculateCommunityScore(0, 15)).toEqual({
+            score: 75, // 50 + 25
+            weight: 0.15,
+            detail: '0 open issues, 15 forks'
+        });
+    });
+    it('should decrease score for many open issues', () => {
+        expect(calculateCommunityScore(25, 0)).toEqual({
+            score: 40, // 50 - 10
+            weight: 0.15,
+            detail: '25 open issues, 0 forks'
+        });
+        expect(calculateCommunityScore(55, 0)).toEqual({
+            score: 25, // 50 - 25
+            weight: 0.15,
+            detail: '55 open issues, 0 forks'
+        });
+    });
+});
+describe('calculateMaintenanceScore', () => {
+    it('should return 100 for perfect maintenance', () => {
+        expect(calculateMaintenanceScore(true, true, false)).toEqual({
+            score: 100,
+            weight: 0.15,
+            detail: 'License: true, Description: true, Active: true'
+        });
+    });
+    it('should return 0 for poor maintenance', () => {
+        expect(calculateMaintenanceScore(false, false, true)).toEqual({
+            score: 0,
+            weight: 0.15,
+            detail: 'License: false, Description: false, Active: false'
+        });
+    });
+});
+describe('calculateHealthScore', () => {
+    it('should calculate final health report and grade', () => {
+        const report = calculateHealthScore('test/repo', {
+            ci: { score: 100, weight: 0.25, detail: '1/1 runs passed' },
+            freshness: { score: 70, weight: 0.20, detail: 'Last push 15 days ago' },
+            community: { score: 75, weight: 0.15, detail: '10 open issues, 15 forks' },
+            security: { score: 100, weight: 0.25, detail: 'Alerts: 0 critical' },
+            maintenance: { score: 100, weight: 0.15, detail: 'Active' },
+        });
+        expect(report).toEqual({
+            repo: 'test/repo',
+            score: 90,
+            grade: 'A',
+            breakdown: expect.any(Object),
+            suggestions: [],
+            checkedAt: expect.any(String)
+        });
+    });
+    it('should generate suggestions for categories with score < 50', () => {
+        const report = calculateHealthScore('test/repo', {
+            ci: { score: 0, weight: 0.25, detail: '0/1 runs passed' },
+            freshness: { score: 100, weight: 0.20, detail: 'Last push 1 days ago' },
+        });
+        expect(report.suggestions).toEqual([
+            'Improve 0/1 runs passed (score: 0/100)'
+        ]);
+    });
+});
+//# sourceMappingURL=health-score.test.js.map

package/dist/scoring/health-score.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-score.test.js","sourceRoot":"","sources":["../../src/scoring/health-score.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/analyze-code-scanning.d.ts

@@ -0,0 +1,12 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function executeAnalyzeCodeScanning({ owner, repo }: {
+    owner: string;
+    repo: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function registerAnalyzeCodeScanning(server: McpServer): void;
+//# sourceMappingURL=analyze-code-scanning.d.ts.map

package/dist/tools/analyze-code-scanning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-code-scanning.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-code-scanning.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAsB,0BAA0B,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;GA8BhG;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CASnE"}

package/dist/tools/analyze-code-scanning.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { getOctokit } from "../github/client.js";
+const inputSchema = z.object({
+    owner: z.string().describe("GitHub repository owner"),
+    repo: z.string().describe("GitHub repository name")
+});
+export async function executeAnalyzeCodeScanning({ owner, repo }) {
+    try {
+        const { data } = await getOctokit().codeScanning.listAlertsForRepo({ owner, repo });
+        const result = data.map((alert) => ({
+            rule_id: alert.rule.id,
+            severity: alert.rule.severity,
+            rule_description: alert.rule.description,
+            state: alert.state,
+            most_recent_instance_path: alert.most_recent_instance.location?.path,
+            most_recent_instance_start_line: alert.most_recent_instance.location?.start_line,
+            html_url: alert.html_url
+        }));
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    }
+    catch (error) {
+        if (error.status === 404) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "Code scanning not configured on this repo"
+                    }]
+            };
+        }
+        throw error;
+    }
+}
+export function registerAnalyzeCodeScanning(server) {
+    server.registerTool("analyze_code_scanning", {
+        description: "Get Code Scanning alerts for a GitHub repository with CodeQL",
+        inputSchema
+    }, executeAnalyzeCodeScanning);
+}
+//# sourceMappingURL=analyze-code-scanning.js.map

package/dist/tools/analyze-code-scanning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-code-scanning.js","sourceRoot":"","sources":["../../src/tools/analyze-code-scanning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CACtD,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,EAAE,KAAK,EAAE,IAAI,EAAmC;IAC7F,IAAI,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,UAAU,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAChC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;YACtB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;YAC7B,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW;YACxC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,yBAAyB,EAAE,KAAK,CAAC,oBAAoB,CAAC,QAAQ,EAAE,IAAI;YACpE,+BAA+B,EAAE,KAAK,CAAC,oBAAoB,CAAC,QAAQ,EAAE,UAAU;YAChF,QAAQ,EAAE,KAAK,CAAC,QAAQ;SAC3B,CAAC,CAAC,CAAC;QACJ,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxC,CAAC;SACL,CAAC;IAEN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA6B,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAChD,OAAO;gBACH,OAAO,EAAE,CAAC;wBACN,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,2CAA2C;qBACpD,CAAC;aACL,CAAC;QACN,CAAC;QACD,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACf,uBAAuB,EACvB;QACI,WAAW,EAAE,8DAA8D;QAC3E,WAAW;KACd,EACD,0BAA0B,CAC7B,CAAC;AACN,CAAC"}

package/dist/tools/analyze-code-scanning.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analyze-code-scanning.test.d.ts.map

package/dist/tools/analyze-code-scanning.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-code-scanning.test.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-code-scanning.test.ts"],"names":[],"mappings":""}

package/dist/tools/analyze-code-scanning.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { getOctokit } from '../github/client.js';
+import { executeAnalyzeCodeScanning } from './analyze-code-scanning.js';
+vi.mock('../github/client.js');
+describe('executeAnalyzeCodeScanning', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should return code scanning alerts', async () => {
+        const mockAlerts = [
+            {
+                rule: { id: 'js/sql-injection', severity: 'error', description: 'SQL Injection' },
+                state: 'open',
+                most_recent_instance: { location: { path: 'src/db.ts', start_line: 10 } },
+                html_url: 'https://github.com/test/repo/security/code-scanning/1'
+            }
+        ];
+        const mockListAlerts = vi.fn().mockResolvedValue({ data: mockAlerts });
+        vi.mocked(getOctokit).mockReturnValue({
+            codeScanning: { listAlertsForRepo: mockListAlerts }
+        });
+        const result = await executeAnalyzeCodeScanning({ owner: 'test', repo: 'repo' });
+        expect(mockListAlerts).toHaveBeenCalledWith({ owner: 'test', repo: 'repo' });
+        expect(result.content).toHaveLength(1);
+        expect(result.content[0].type).toBe('text');
+        const parsedText = JSON.parse(result.content[0].text);
+        expect(parsedText).toHaveLength(1);
+        expect(parsedText[0]).toEqual({
+            rule_id: 'js/sql-injection',
+            severity: 'error',
+            rule_description: 'SQL Injection',
+            state: 'open',
+            most_recent_instance_path: 'src/db.ts',
+            most_recent_instance_start_line: 10,
+            html_url: 'https://github.com/test/repo/security/code-scanning/1'
+        });
+    });
+    it('should handle 404 when code scanning is not configured', async () => {
+        const notFoundError = new Error('Not Found');
+        notFoundError.status = 404;
+        const mockListAlerts = vi.fn().mockRejectedValue(notFoundError);
+        vi.mocked(getOctokit).mockReturnValue({
+            codeScanning: { listAlertsForRepo: mockListAlerts }
+        });
+        const result = await executeAnalyzeCodeScanning({ owner: 'test', repo: 'repo' });
+        expect(result.content).toHaveLength(1);
+        expect(result.content[0].type).toBe('text');
+        expect(result.content[0].text).toBe("Code scanning not configured on this repo");
+    });
+    it('should throw error for non-404 API failures', async () => {
+        const serverError = new Error('Server Error');
+        serverError.status = 500;
+        const mockListAlerts = vi.fn().mockRejectedValue(serverError);
+        vi.mocked(getOctokit).mockReturnValue({
+            codeScanning: { listAlertsForRepo: mockListAlerts }
+        });
+        await expect(executeAnalyzeCodeScanning({ owner: 'test', repo: 'repo' }))
+            .rejects
+            .toThrow('Server Error');
+    });
+});
+//# sourceMappingURL=analyze-code-scanning.test.js.map