projectpulse-mcp 1.6.14 → 1.8.0

package/README.md

@@ -11,6 +11,7 @@
   <a href="https://github.com/alexbypa/github-projectpulse-mcp/stargazers"><img src="https://img.shields.io/github/stars/alexbypa/github-projectpulse-mcp" alt="stars" /></a>
   <a href="https://www.npmjs.com/package/projectpulse-mcp"><img src="https://img.shields.io/npm/dt/projectpulse-mcp" alt="downloads" /></a>
   <a href="https://scorecard.dev/viewer/?uri=github.com/alexbypa/github-projectpulse-mcp"><img src="https://img.shields.io/ossf-scorecard/github.com/alexbypa/github-projectpulse-mcp?label=openssf+scorecard" alt="OpenSSF Scorecard" /></a>
+  <a href="https://m8ven.ai/badge/mcp/alexbypa/github-projectpulse-mcp"><img src="https://m8ven.ai/badge/mcp/alexbypa/github-projectpulse-mcp" alt="M8ven MCP" /></a>
 </p>
 
 ---
@@ -26,6 +27,7 @@ This [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server giv
 - 📦 **Dependency Analysis** — Dependabot alerts with severity filtering
 - ⚙️ **CI/CD Status** — recent GitHub Actions workflow runs and conclusions
 - 📋 **Repository Info** — stars, forks, language, license, and general metadata
+- 📝 **Best Practices** — 12-point checklist for open-source repo quality (README, LICENSE, SECURITY.md, templates, branch protection, etc.) with A-F grade
 
 ## 📸 Examples
 
@@ -67,6 +69,12 @@ This [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server giv
 ![analyze_dependencies](https://raw.githubusercontent.com/alexbypa/github-projectpulse-mcp/main/docs/images/analyze_dependencies_Use_Case.png)
 </details>
 
+<details>
+<summary><strong>check_best_practices</strong> — Open-source repo quality checklist with A-F grade</summary>
+
+![check_best_practices](https://raw.githubusercontent.com/alexbypa/github-projectpulse-mcp/main/docs/images/check_best_practices_Use_Case.png)
+</details>
+
 ## 💡 Use Cases
 
 > Copy-paste these prompts into Claude, Cursor, Windsurf, or any MCP-compatible assistant.
@@ -214,6 +222,12 @@ Lists **CodeQL and other code scanning alerts**: rule ID, severity, vulnerabilit
 **Inputs:** `owner`, `repo`, `trigger_scan` (optional, default `false`), `poll_timeout_seconds` (optional, default 300), `poll_interval_seconds` (optional, default 15)
 **Try asking:** *"Are there any code scanning vulnerabilities in my-org/my-api?"*
 
+### `check_best_practices`
+Evaluates whether a repository follows **open-source community best practices**. Runs 12 weighted checks: README, LICENSE, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT, issue/PR templates, branch protection, Dependabot config, CI/CD workflows, description, and topics. Returns a 0-100 weighted score with A-F grade, per-check pass/fail/unknown status, and actionable suggestions for every missing item. Branch protection check requires admin token access — returns "unknown" (not penalized) if unavailable.
+
+**Inputs:** `owner`, `repo`
+**Try asking:** *"Does my-org/my-repo follow open-source best practices?"*
+
 ### `ping`
 Simple connectivity check. Returns "pong" with your message. Use to verify the MCP server is running.
 
@@ -221,6 +235,37 @@ Simple connectivity check. Returns "pong" with your message. Use to verify the M
 
 ## 🆕 What's New
 
+### HTTP Transport (v1.7.0)
+
+ProjectPulse now supports **Streamable HTTP transport** in addition to stdio. This enables running as a standalone HTTP server — ideal for Docker containers, remote deployments, and cross-runtime integrations (e.g., .NET clients consuming Node.js MCP tools over the network).
+
+**Default behavior is unchanged** — `npx projectpulse-mcp` still uses stdio. To activate HTTP mode:
+
+```bash
+MCP_TRANSPORT=http MCP_PORT=3000 node dist/index.js
+```
+
+| Env Variable | Default | Description |
+| --- | --- | --- |
+| `MCP_TRANSPORT` | `stdio` | Transport mode: `stdio` or `http` |
+| `MCP_PORT` | `3000` | HTTP server port (only used when `MCP_TRANSPORT=http`) |
+
+**Docker example:**
+
+```yaml
+projectpulse:
+  image: node:22-slim
+  command: >-
+    sh -c "npm install -g projectpulse-mcp &&
+           node /usr/local/lib/node_modules/projectpulse-mcp/dist/index.js"
+  environment:
+    - MCP_TRANSPORT=http
+    - MCP_PORT=3000
+    - GITHUB_TOKEN=${GITHUB_TOKEN}
+```
+
+Health check endpoint available at `GET /` (returns JSON with server name and version). MCP protocol endpoint at `POST /mcp`.
+
 ### OpenSSF Scorecard Integration
 
 Security score now blends **Dependabot alerts** (60%) with **OpenSSF Scorecard** checks (40%) for a more complete picture. 12 security-relevant checks are evaluated — repos without a scorecard gracefully fall back to Dependabot-only scoring.

package/dist/analytics/best-practices.d.ts

@@ -0,0 +1,34 @@
+import type { BestPracticesReport } from '../types/best-practices.js';
+type BestPracticesInput = {
+    owner: string;
+    repo: string;
+    repoData: {
+        description: string | null;
+        license: {
+            spdx_id: string;
+        } | null;
+        topics: string[];
+        default_branch: string;
+    };
+    communityProfile: {
+        files: {
+            code_of_conduct: unknown | null;
+            contributing: unknown | null;
+            security: unknown | null;
+            pull_request_template: unknown | null;
+            issue_template: unknown | null;
+        };
+    };
+    readme: {
+        found: boolean;
+        size: number;
+    };
+    dependabotConfigured: boolean;
+    hasWorkflows: boolean;
+    branchProtection: {
+        protected: boolean | null;
+    };
+};
+export declare function analyzeBestPractices(input: BestPracticesInput): BestPracticesReport;
+export type { BestPracticesInput };
+//# sourceMappingURL=best-practices.d.ts.map

package/dist/analytics/best-practices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-practices.d.ts","sourceRoot":"","sources":["../../src/analytics/best-practices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,mBAAmB,EAAe,MAAM,4BAA4B,CAAC;AAItG,KAAK,kBAAkB,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,OAAO,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QACpC,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,gBAAgB,EAAE;QAChB,KAAK,EAAE;YACL,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;YAChC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;YAC7B,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;YACzB,qBAAqB,EAAE,OAAO,GAAG,IAAI,CAAC;YACtC,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;SAChC,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE;QAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;CACjD,CAAC;AAMF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CAuEnF;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/analytics/best-practices.js

@@ -0,0 +1,49 @@
+import { scoreToGrade } from '../scoring/health-score.js';
+function check(name, status, weight, detail) {
+    return { name, status, weight, detail };
+}
+export function analyzeBestPractices(input) {
+    const { repoData, communityProfile, readme, dependabotConfigured, hasWorkflows, branchProtection } = input;
+    const files = communityProfile.files;
+    const checks = [
+        // Alto (weight 3)
+        check('README', readme.found && readme.size > 0 ? 'pass' : 'fail', 3, readme.found ? (readme.size > 0 ? 'README present and not empty' : 'README exists but is empty') : 'No README found'),
+        check('LICENSE', repoData.license != null ? 'pass' : 'fail', 3, repoData.license ? `License: ${repoData.license.spdx_id}` : 'No license — code is not legally reusable'),
+        check('Security Policy', files.security != null ? 'pass' : 'fail', 3, files.security ? 'SECURITY.md or security policy present' : 'No security policy — vulnerability reporters have no contact channel'),
+        check('Branch Protection', branchProtection.protected == null ? 'unknown' : (branchProtection.protected ? 'pass' : 'fail'), 3, branchProtection.protected == null ? 'Cannot verify — requires admin access'
+            : (branchProtection.protected ? 'Default branch is protected' : 'Default branch has no protection — anyone can push directly')),
+        check('Dependabot', dependabotConfigured ? 'pass' : 'fail', 3, dependabotConfigured ? '.github/dependabot.yml configured' : 'No Dependabot config — dependency vulnerabilities not auto-detected'),
+        check('CI/CD', hasWorkflows ? 'pass' : 'fail', 3, hasWorkflows ? 'GitHub Actions workflows configured' : 'No CI/CD workflows found'),
+        // Medio (weight 2)
+        check('CONTRIBUTING', files.contributing != null ? 'pass' : 'fail', 2, files.contributing ? 'CONTRIBUTING.md present' : 'No contributing guide — new contributors lack onboarding'),
+        check('Issue Templates', files.issue_template != null ? 'pass' : 'fail', 2, files.issue_template ? 'Issue templates configured' : 'No issue templates — bug reports will lack structure'),
+        check('PR Template', files.pull_request_template != null ? 'pass' : 'fail', 2, files.pull_request_template ? 'Pull request template configured' : 'No PR template'),
+        check('Description', (repoData.description ?? '').length > 0 ? 'pass' : 'fail', 2, repoData.description ? 'Repository description set' : 'No description — repo is invisible in search'),
+        // Basso (weight 1)
+        check('Code of Conduct', files.code_of_conduct != null ? 'pass' : 'fail', 1, files.code_of_conduct ? 'Code of conduct present' : 'No code of conduct'),
+        check('Topics', repoData.topics.length > 0 ? 'pass' : 'fail', 1, repoData.topics.length > 0 ? `${repoData.topics.length} topics configured` : 'No topics — reduces discoverability'),
+    ];
+    // Score pesato: solo pass e fail contano, unknown esclusi
+    const scorable = checks.filter(c => c.status !== 'unknown');
+    const totalWeight = scorable.reduce((sum, c) => sum + c.weight, 0);
+    const passedWeight = scorable.filter(c => c.status === 'pass').reduce((sum, c) => sum + c.weight, 0);
+    const score = totalWeight > 0 ? Math.round((passedWeight / totalWeight) * 100) : 0;
+    // Suggestions per i fail, ordinati per weight decrescente
+    const suggestions = checks
+        .filter(c => c.status === 'fail')
+        .sort((a, b) => b.weight - a.weight)
+        .map(c => `${c.name}: ${c.detail}`);
+    return {
+        repo: `${input.owner}/${input.repo}`,
+        score,
+        grade: scoreToGrade(score),
+        totalChecks: checks.length,
+        passed: checks.filter(c => c.status === 'pass').length,
+        failed: checks.filter(c => c.status === 'fail').length,
+        unknown: checks.filter(c => c.status === 'unknown').length,
+        checks,
+        suggestions,
+        checkedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=best-practices.js.map

package/dist/analytics/best-practices.js.map

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

package/dist/github/client.d.ts

@@ -4,4 +4,28 @@ export declare function getOctokit(): Octokit;
 export declare function listReleases(owner: string, repo: string, since: Date): Promise<Release[]>;
 export declare function listMergedPulls(owner: string, repo: string, since: Date): Promise<PullRequest[]>;
 export declare function listWorkflowRuns(owner: string, repo: string, since: Date): Promise<WorkflowRun[]>;
+export declare function getCommunityProfile(owner: string, repo: string): Promise<{
+    health_percentage: number;
+    description: string | null;
+    documentation: string | null;
+    files: {
+        code_of_conduct: import("@octokit/openapi-types").components["schemas"]["nullable-code-of-conduct-simple"];
+        code_of_conduct_file: import("@octokit/openapi-types").components["schemas"]["nullable-community-health-file"];
+        license: import("@octokit/openapi-types").components["schemas"]["nullable-license-simple"];
+        contributing: import("@octokit/openapi-types").components["schemas"]["nullable-community-health-file"];
+        readme: import("@octokit/openapi-types").components["schemas"]["nullable-community-health-file"];
+        issue_template: import("@octokit/openapi-types").components["schemas"]["nullable-community-health-file"];
+        pull_request_template: import("@octokit/openapi-types").components["schemas"]["nullable-community-health-file"];
+    };
+    updated_at: string | null;
+    content_reports_enabled?: boolean;
+}>;
+export declare function getReadme(owner: string, repo: string): Promise<{
+    found: boolean;
+    size: number;
+}>;
+export declare function getFileExists(owner: string, repo: string, path: string): Promise<boolean>;
+export declare function getBranchProtection(owner: string, repo: string, branch: string): Promise<{
+    protected: boolean | null;
+}>;
 //# sourceMappingURL=client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAI/E,wBAAgB,UAAU,IAAI,OAAO,CAMpC;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAc/F;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAiBtG;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAgBvG"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAI/E,wBAAgB,UAAU,IAAI,OAAO,CAMpC;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAc/F;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAiBtG;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAgBvG;AAID,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;;yBAwCk6pnC,sDAAsB;8BAAkE,sDAAsB;iBAAoD,sDAAsB;sBAAkD,sDAAsB;gBAAmD,sDAAsB;wBAA2D,sDAAsB;+BAAkE,sDAAsB;;;;GAjCx9qnC;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAQtG;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ/F;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,CAAC,CAW7H"}

package/dist/github/client.js

@@ -57,4 +57,47 @@ export async function listWorkflowRuns(owner, repo, since) {
         created_at: r.created_at,
     }));
 }
+// --- Best Practices ---
+export async function getCommunityProfile(owner, repo) {
+    const octokit = getOctokit();
+    const { data } = await octokit.request('GET /repos/{owner}/{repo}/community/profile', {
+        owner,
+        repo,
+    });
+    return data;
+}
+export async function getReadme(owner, repo) {
+    const octokit = getOctokit();
+    try {
+        const { data } = await octokit.repos.getReadme({ owner, repo });
+        return { found: true, size: data.size };
+    }
+    catch {
+        return { found: false, size: 0 };
+    }
+}
+export async function getFileExists(owner, repo, path) {
+    const octokit = getOctokit();
+    try {
+        await octokit.repos.getContent({ owner, repo, path });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function getBranchProtection(owner, repo, branch) {
+    const octokit = getOctokit();
+    try {
+        await octokit.repos.getBranchProtection({ owner, repo, branch });
+        return { protected: true };
+    }
+    catch (err) {
+        const status = err.status;
+        if (status === 404)
+            return { protected: false };
+        // 403 = no admin access, can't check
+        return { protected: null };
+    }
+}
 //# sourceMappingURL=client.js.map

package/dist/github/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,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;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa,EAAE,IAAY,EAAE,KAAW;IACvE,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;QAC9C,KAAK;QACL,IAAI;QACJ,QAAQ,EAAE,GAAG;KAChB,CAAC,CAAC;IACH,OAAO,IAAI;SACN,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;SACzE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACb,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,YAAY,EAAE,CAAC,CAAC,YAAa;KAChC,CAAC,CAAC,CAAC;AACR,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAa,EAAE,IAAY,EAAE,KAAW;IAC1E,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QACtC,KAAK;QACL,IAAI;QACJ,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,GAAG;KAChB,CAAC,CAAC;IACH,OAAO,IAAI;SACN,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC;SACnE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACb,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,SAAS,EAAE,CAAC,CAAC,SAAS;KACzB,CAAC,CAAC,CAAC;AACR,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa,EAAE,IAAY,EAAE,KAAW;IAC3E,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC;QAC3D,KAAK;QACL,IAAI;QACJ,QAAQ,EAAE,GAAG;KAChB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,aAAa;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;SAC5C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACb,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS;QACzB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,SAAS;QACvC,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,UAAU,EAAE,CAAC,CAAC,UAAU;KAC3B,CAAC,CAAC,CAAC;AACR,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,5 +1,9 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { createServer } from "node:http";
+import { randomUUID } from "node:crypto";
 import { registerCheckCiStatus } from "./tools/check-ci-status.js";
 import { registerGetRepoHealth } from "./tools/get-repo-health.js";
 import { registerAnalyzeDependencies } from "./tools/analyze-dependencies.js";
@@ -7,19 +11,109 @@ import { registerAnalyzeCodeScanning } from "./tools/analyze-code-scanning.js";
 import { registerGetHealthScore } from "./tools/get-health-score.js";
 import { registerGetDoraMetrics } from "./tools/get-dora-metrics.js";
 import { registerCompareRepos } from "./tools/compare-repos.js";
+import { registerCheckBestPractices } from "./tools/check-best-practices.js";
 import { readFileSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8"));
-const server = new McpServer({ name: "projectpulse-mcp", version: pkg.version });
-registerCheckCiStatus(server);
-registerGetRepoHealth(server);
-registerAnalyzeDependencies(server);
-registerAnalyzeCodeScanning(server);
-registerGetHealthScore(server);
-registerGetDoraMetrics(server);
-registerCompareRepos(server);
-const transport = new StdioServerTransport();
-await server.connect(transport);
+function createMcpServer() {
+    const server = new McpServer({ name: "projectpulse-mcp", version: pkg.version });
+    registerCheckCiStatus(server);
+    registerGetRepoHealth(server);
+    registerAnalyzeDependencies(server);
+    registerAnalyzeCodeScanning(server);
+    registerGetHealthScore(server);
+    registerGetDoraMetrics(server);
+    registerCompareRepos(server);
+    registerCheckBestPractices(server);
+    return server;
+}
+// --- Transport selection ---
+// Default: stdio (backward compatible, per uso locale e npx)
+// MCP_TRANSPORT=http: Streamable HTTP server (per Docker e remote clients)
+const transportMode = (process.env.MCP_TRANSPORT ?? "stdio").toLowerCase();
+if (transportMode === "http") {
+    const port = parseInt(process.env.MCP_PORT ?? "3000", 10);
+    const transports = new Map();
+    const httpServer = createServer(async (req, res) => {
+        const url = new URL(req.url ?? "/", `http://localhost:${port}`);
+        // Only handle /mcp path — MCP protocol endpoint
+        if (url.pathname !== "/mcp") {
+            // Health check on root
+            if (url.pathname === "/" && req.method === "GET") {
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ status: "ok", server: "projectpulse-mcp", version: pkg.version }));
+                return;
+            }
+            res.writeHead(404);
+            res.end("Not Found");
+            return;
+        }
+        // Parse JSON body for POST requests
+        if (req.method === "POST") {
+            const chunks = [];
+            for await (const chunk of req)
+                chunks.push(chunk);
+            const body = JSON.parse(Buffer.concat(chunks).toString());
+            req.body = body;
+            const sessionId = req.headers["mcp-session-id"];
+            if (sessionId && transports.has(sessionId)) {
+                // Existing session — reuse transport
+                await transports.get(sessionId).handleRequest(req, res, body);
+            }
+            else if (!sessionId && isInitializeRequest(body)) {
+                // New session — create transport + server
+                const transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: () => randomUUID(),
+                    onsessioninitialized: (sid) => {
+                        transports.set(sid, transport);
+                    },
+                });
+                transport.onclose = () => {
+                    const sid = transport.sessionId;
+                    if (sid)
+                        transports.delete(sid);
+                };
+                const server = createMcpServer();
+                await server.connect(transport);
+                await transport.handleRequest(req, res, body);
+            }
+            else {
+                res.writeHead(400, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ jsonrpc: "2.0", error: { code: -32000, message: "Bad Request: No valid session ID" }, id: null }));
+            }
+        }
+        else if (req.method === "GET" || req.method === "DELETE") {
+            const sessionId = req.headers["mcp-session-id"];
+            if (!sessionId || !transports.has(sessionId)) {
+                res.writeHead(400);
+                res.end("Invalid or missing session ID");
+                return;
+            }
+            await transports.get(sessionId).handleRequest(req, res);
+        }
+        else {
+            res.writeHead(405);
+            res.end("Method Not Allowed");
+        }
+    });
+    httpServer.listen(port, "0.0.0.0", () => {
+        console.log(`ProjectPulse MCP server (HTTP) listening on http://0.0.0.0:${port}/mcp`);
+    });
+    process.on("SIGINT", async () => {
+        for (const [, transport] of transports) {
+            await transport.close();
+        }
+        transports.clear();
+        httpServer.close();
+        process.exit(0);
+    });
+}
+else {
+    // Default: stdio transport (backward compatible)
+    const server = createMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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;AAEhF,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;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAElF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;AAEjF,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;AAC/B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAE7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;AAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/check-best-practices.d.ts

@@ -0,0 +1,19 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function executeCheckBestPractices({ owner, repo }: {
+    owner: string;
+    repo: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: import("../types/best-practices.js").BestPracticesReport;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent?: undefined;
+}>;
+export declare function registerCheckBestPractices(server: McpServer): void;
+//# sourceMappingURL=check-best-practices.d.ts.map

package/dist/tools/check-best-practices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-best-practices.d.ts","sourceRoot":"","sources":["../../src/tools/check-best-practices.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2BpE,wBAAsB,yBAAyB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GA+D/F;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsBlE"}

package/dist/tools/check-best-practices.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { getOctokit, getCommunityProfile, getReadme, getFileExists, getBranchProtection } from "../github/client.js";
+import { analyzeBestPractices } from "../analytics/best-practices.js";
+const inputSchema = z.object({
+    owner: z.string().describe("GitHub repository owner (e.g., 'facebook')"),
+    repo: z.string().describe("GitHub repository name (e.g., 'react')")
+});
+const outputSchema = z.object({
+    repo: z.string(),
+    score: z.number(),
+    grade: z.string(),
+    totalChecks: z.number(),
+    passed: z.number(),
+    failed: z.number(),
+    unknown: z.number(),
+    checks: z.array(z.object({
+        name: z.string(),
+        status: z.enum(['pass', 'fail', 'unknown']),
+        weight: z.number(),
+        detail: z.string()
+    })),
+    suggestions: z.array(z.string()),
+    checkedAt: z.string()
+});
+export async function executeCheckBestPractices({ owner, repo }) {
+    try {
+        const octokit = getOctokit();
+        // Fetch tutto in parallelo — 5 call, ~1 secondo totale
+        const [repoResponse, communityProfile, readme, dependabotConfigured, workflowsResponse] = await Promise.all([
+            octokit.repos.get({ owner, repo }),
+            getCommunityProfile(owner, repo),
+            getReadme(owner, repo),
+            getFileExists(owner, repo, '.github/dependabot.yml'),
+            octokit.actions.listWorkflowRunsForRepo({ owner, repo, per_page: 1 })
+        ]);
+        const repoData = repoResponse.data;
+        // Branch protection separata — può fallire con 403
+        const branchProtection = await getBranchProtection(owner, repo, repoData.default_branch);
+        const result = analyzeBestPractices({
+            owner,
+            repo,
+            repoData: {
+                description: repoData.description,
+                license: repoData.license ? { spdx_id: repoData.license.spdx_id ?? 'Unknown' } : null,
+                topics: repoData.topics ?? [],
+                default_branch: repoData.default_branch,
+            },
+            communityProfile: {
+                files: {
+                    code_of_conduct: communityProfile.files.code_of_conduct,
+                    contributing: communityProfile.files.contributing,
+                    security: communityProfile.files.security ?? communityProfile.files.security_advisories,
+                    pull_request_template: communityProfile.files.pull_request_template,
+                    issue_template: communityProfile.files.issue_template,
+                }
+            },
+            readme,
+            dependabotConfigured,
+            hasWorkflows: workflowsResponse.data.total_count > 0,
+            branchProtection,
+        });
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                }],
+            structuredContent: result
+        };
+    }
+    catch (error) {
+        if (error.status === 404) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "Repository not found",
+                            details: error.message
+                        }, null, 2),
+                    }]
+            };
+        }
+        throw error;
+    }
+}
+export function registerCheckBestPractices(server) {
+    server.registerTool("check_best_practices", {
+        description: `Checks whether a GitHub repository follows open-source community best practices.
+- Evaluates 12 checks: README, LICENSE, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT, issue/PR templates, branch protection, Dependabot, CI/CD, description, and topics.
+- Returns a weighted 0-100 score with A-F grade, per-check pass/fail/unknown status, and actionable suggestions for missing items.
+- Side effects: None. Read-only operation.
+- Rate limits: ~6 GitHub API calls per invocation.
+- Branch protection check requires admin access — returns "unknown" (not penalized) if token lacks permission.
+- Use this tool to audit repo quality and discoverability. For a computed health grade based on CI/security/activity, use 'get_health_score' instead.`,
+        inputSchema,
+        outputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, executeCheckBestPractices);
+}
+//# sourceMappingURL=check-best-practices.js.map

package/dist/tools/check-best-practices.js.map

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

package/dist/types/best-practices.d.ts

@@ -0,0 +1,21 @@
+type CheckStatus = 'pass' | 'fail' | 'unknown';
+type BestPracticeCheck = {
+    name: string;
+    status: CheckStatus;
+    weight: number;
+    detail: string;
+};
+type BestPracticesReport = {
+    repo: string;
+    score: number;
+    grade: string;
+    totalChecks: number;
+    passed: number;
+    failed: number;
+    unknown: number;
+    checks: BestPracticeCheck[];
+    suggestions: string[];
+    checkedAt: string;
+};
+export type { CheckStatus, BestPracticeCheck, BestPracticesReport };
+//# sourceMappingURL=best-practices.d.ts.map

package/dist/types/best-practices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-practices.d.ts","sourceRoot":"","sources":["../../src/types/best-practices.ts"],"names":[],"mappings":"AACA,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAG/C,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAA;AAGD,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAA;AAED,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/types/best-practices.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=best-practices.js.map

package/dist/types/best-practices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-practices.js","sourceRoot":"","sources":["../../src/types/best-practices.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "projectpulse-mcp",
   "description": "MCP Server for GitHub repository health monitoring",
-  "version": "1.6.14",
+  "version": "1.8.0",
   "mcpName": "io.github.alexbypa/github-projectpulse-mcp",
   "main": "dist/index.js",
   "scripts": {