mcp-researchpowerpack-http 3.10.0

package/dist/src/tools/github-score.js

@@ -0,0 +1,306 @@
+import { getCapabilities, getMissingEnvMessage } from "../config/index.js";
+import {
+  githubScoreOutputSchema,
+  githubScoreParamsSchema
+} from "../schemas/github-score.js";
+import { GitHubClient } from "../clients/github.js";
+import {
+  scoreRepo
+} from "../scoring/github-quality.js";
+import { classifyError } from "../utils/errors.js";
+import { mcpLog, formatError, formatDuration } from "./utils.js";
+import {
+  createToolReporter,
+  NOOP_REPORTER,
+  toolFailure,
+  toolSuccess,
+  toToolResponse
+} from "./mcp-helpers.js";
+function buildSearchQuery(params) {
+  let query;
+  if (params.search_mode === "OR") {
+    query = params.keywords.join(" OR ");
+  } else {
+    query = params.keywords.join(" ");
+  }
+  if (params.min_stars > 0) {
+    query += ` stars:>=${params.min_stars}`;
+  }
+  if (params.language) {
+    query += ` language:${params.language}`;
+  }
+  return query;
+}
+function buildRawRepoData(fullData) {
+  const g = fullData.graphql;
+  const disciplineFlags = {
+    hasLicense: g.license !== null,
+    hasContributing: g.hasContributing,
+    hasIssueTemplate: g.hasIssueTemplate,
+    hasPrTemplate: g.hasPrTemplate,
+    hasCodeOfConduct: g.hasCodeOfConduct,
+    hasCI: g.hasCI,
+    hasReleases: g.totalReleases > 0,
+    hasTopics: g.hasTopics,
+    hasDescription: (g.description ?? "").length > 0,
+    hasHomepage: (g.homepage ?? "").length > 0
+  };
+  return {
+    stars: g.stars,
+    forks: g.forks,
+    watchers: g.watchers,
+    sizeKb: g.sizeKb,
+    createdAt: new Date(g.createdAt),
+    archived: g.archived,
+    hasLicense: g.license !== null,
+    closedIssues: g.closedIssues,
+    totalIssues: g.openIssues + g.closedIssues,
+    totalCommits: g.totalCommits,
+    contributorCommits: fullData.contributors.map((c) => c.contributions),
+    allWeeklyCommits: fullData.participation.all,
+    ownerWeeklyCommits: fullData.participation.owner,
+    disciplineFlags
+  };
+}
+function formatRelativeDate(isoDate) {
+  const date = new Date(isoDate);
+  if (isNaN(date.getTime())) return "unknown";
+  const diffMs = Date.now() - date.getTime();
+  const days = Math.floor(diffMs / (1e3 * 60 * 60 * 24));
+  if (days < 1) return "today";
+  if (days === 1) return "1d ago";
+  if (days < 30) return `${days}d ago`;
+  if (days < 365) return `${Math.floor(days / 30)}mo ago`;
+  return `${(days / 365).toFixed(1)}y ago`;
+}
+function formatStarCount(stars) {
+  if (stars >= 1e3) {
+    return `${(stars / 1e3).toFixed(1)}k`;
+  }
+  return String(stars);
+}
+function scoreBand(score) {
+  if (score >= 70) return "Excellent";
+  if (score >= 50) return "Good";
+  if (score >= 30) return "Meh";
+  return "Low";
+}
+function formatScoreTable(repos) {
+  let md = `| # | Repo | Stars | Score | Maint | Community | Discipline | Substance | Last Commit | Contributors | Flags |
+`;
+  md += `|---|------|-------|-------|-------|-----------|------------|-----------|-------------|--------------|-------|
+`;
+  repos.forEach((repo, i) => {
+    const s = repo.score;
+    const flagStr = s.flags.length > 0 ? s.flags.join(", ") : "-";
+    md += `| ${i + 1} | [${repo.fullName}](${repo.url}) | ${formatStarCount(repo.stars)} | **${s.score}** | ${s.subScores.maintenance.toFixed(2)} | ${s.subScores.community.toFixed(2)} | ${s.subScores.discipline.toFixed(2)} | ${s.subScores.substance.toFixed(2)} | ${formatRelativeDate(repo.lastPush)} | ${repo.contributors} | ${flagStr} |
+`;
+  });
+  return md;
+}
+function sortRepos(repos, sortBy) {
+  const sorted = [...repos];
+  switch (sortBy) {
+    case "stars":
+      sorted.sort((a, b) => b.stars - a.stars);
+      break;
+    case "updated":
+      sorted.sort(
+        (a, b) => new Date(b.lastPush).getTime() - new Date(a.lastPush).getTime()
+      );
+      break;
+    case "score":
+    default:
+      sorted.sort((a, b) => b.score.score - a.score.score);
+      break;
+  }
+  return sorted;
+}
+async function handleGitHubScore(params, reporter = NOOP_REPORTER) {
+  const startTime = Date.now();
+  try {
+    const client = new GitHubClient();
+    const query = buildSearchQuery(params);
+    mcpLog("info", `Searching GitHub: "${query}"`, "github-score");
+    await reporter.log("info", `Searching GitHub for: ${query}`);
+    await reporter.progress(10, 100, "Searching GitHub repositories");
+    const searchResult = await client.searchRepos(query, "stars", params.max_results);
+    if (searchResult.error) {
+      return buildGitHubScoreError(searchResult.error, query, startTime, client.apiCalls);
+    }
+    if (searchResult.items.length === 0) {
+      const emptyMd = `# GitHub Score: No Results
+
+Query: \`${query}\`
+
+No repositories found. Try broader keywords or lower the min_stars filter.`;
+      return toolSuccess(emptyMd, {
+        content: emptyMd,
+        metadata: {
+          query,
+          total_found: 0,
+          total_scored: 0,
+          failed_scores: 0,
+          execution_time_ms: Date.now() - startTime,
+          api_calls_made: client.apiCalls
+        },
+        repos: []
+      });
+    }
+    mcpLog("info", `Found ${searchResult.totalCount} repos, scoring top ${searchResult.items.length}`, "github-score");
+    await reporter.progress(20, 100, `Found ${searchResult.items.length} repos, fetching details`);
+    const repoRequests = searchResult.items.map((item) => ({
+      owner: item.owner,
+      name: item.name
+    }));
+    const detailResults = await client.fetchMultipleRepoDetails(repoRequests);
+    const scoredRepos = [];
+    let failedCount = 0;
+    for (let i = 0; i < detailResults.length; i++) {
+      const detail = detailResults[i];
+      const searchItem = searchResult.items[i];
+      if (detail.error || !detail.data) {
+        failedCount++;
+        mcpLog("warning", `Failed to score ${searchItem.fullName}: ${detail.error?.message ?? "unknown"}`, "github-score");
+        continue;
+      }
+      try {
+        const rawData = buildRawRepoData(detail.data);
+        const score = scoreRepo(rawData);
+        scoredRepos.push({
+          fullName: searchItem.fullName,
+          url: searchItem.url,
+          stars: detail.data.graphql.stars,
+          forks: detail.data.graphql.forks,
+          openIssues: detail.data.graphql.openIssues,
+          language: detail.data.graphql.language,
+          lastPush: detail.data.graphql.pushedAt,
+          contributors: detail.data.contributors.length,
+          archived: detail.data.graphql.archived,
+          score
+        });
+      } catch {
+        failedCount++;
+        mcpLog("warning", `Scoring error for ${searchItem.fullName}`, "github-score");
+      }
+      const progress = 20 + Math.round((i + 1) / detailResults.length * 70);
+      await reporter.progress(progress, 100, `Scored ${i + 1}/${detailResults.length} repos`);
+    }
+    const sorted = sortRepos(scoredRepos, params.sort);
+    const executionTime = Date.now() - startTime;
+    const avgScore = sorted.length > 0 ? Math.round(sorted.reduce((s, r) => s + r.score.score, 0) / sorted.length) : 0;
+    let md = `# GitHub Score Report
+
+`;
+    md += `**Query:** \`${query}\` | **Sorted by:** ${params.sort} | **Scored:** ${sorted.length}/${searchResult.items.length}`;
+    if (failedCount > 0) md += ` | **Failed:** ${failedCount}`;
+    md += `
+
+`;
+    md += `**Average Score:** ${avgScore}/100 (${scoreBand(avgScore)})
+
+`;
+    md += formatScoreTable(sorted);
+    md += `
+---
+`;
+    md += `*${formatDuration(executionTime)} | ${client.apiCalls} API calls | Score legend: Maint=Maintenance Pulse, Community=Community Health, Discipline=Engineering Practices, Substance=Code Quality*
+`;
+    md += `
+**Score bands:** 70+ Excellent | 50-69 Good | 30-49 Meh | <30 Low
+`;
+    md += `
+**Flag legend:** consistent-commits (steady work), growing (accelerating), active-community (external contributors), well-organized (CI/license/templates), high-bus-factor (multiple key contributors), stale-6mo (owner inactive), single-maintainer, no-license, archived, ai-dump-signal (few commits + large codebase)`;
+    const structuredRepos = sorted.map((r) => ({
+      full_name: r.fullName,
+      url: r.url,
+      stars: r.stars,
+      forks: r.forks,
+      open_issues: r.openIssues,
+      language: r.language,
+      last_push: r.lastPush,
+      contributors: r.contributors,
+      archived: r.archived,
+      composite_score: r.score.score,
+      maintenance_score: r.score.subScores.maintenance,
+      community_score: r.score.subScores.community,
+      discipline_score: r.score.subScores.discipline,
+      substance_score: r.score.subScores.substance,
+      flags: r.score.flags
+    }));
+    return toolSuccess(md, {
+      content: md,
+      metadata: {
+        query,
+        total_found: searchResult.totalCount,
+        total_scored: sorted.length,
+        failed_scores: failedCount,
+        execution_time_ms: executionTime,
+        api_calls_made: client.apiCalls
+      },
+      repos: structuredRepos
+    });
+  } catch (error) {
+    return buildGitHubScoreError(classifyError(error), buildSearchQuery(params), startTime, 0);
+  }
+}
+function buildGitHubScoreError(error, query, startTime, apiCalls) {
+  const structuredError = typeof error === "object" && error !== null && "code" in error ? error : classifyError(error);
+  mcpLog("error", `github-score: ${structuredError.message}`, "github-score");
+  const errorContent = formatError({
+    code: structuredError.code,
+    message: structuredError.message,
+    retryable: structuredError.retryable,
+    toolName: "github-score",
+    howToFix: [
+      "Verify GITHUB_TOKEN is set correctly",
+      "Check that the token has not expired",
+      "Ensure you have not exceeded the GitHub API rate limit (5000 req/hr)"
+    ],
+    alternatives: [
+      'web-search(keywords=["topic github"]) \u2014 search the web for GitHub repos instead'
+    ]
+  });
+  return toolFailure(
+    `${errorContent}
+
+Query: ${query}
+Execution time: ${formatDuration(Date.now() - startTime)}
+API calls: ${apiCalls}`
+  );
+}
+function registerGitHubScoreTool(server) {
+  server.tool(
+    {
+      name: "github-score",
+      title: "GitHub Score",
+      description: 'Search GitHub repositories and score them with a composite "Gives a Damn" quality metric. Takes keywords with AND/OR logic, fetches repo metadata, commit patterns, contributor data, and CI/release/template presence to compute a 0-100 quality score across 4 dimensions: Maintenance (commit consistency, velocity, owner activity), Community (contributor diversity, bus factor), Discipline (CI, releases, license, templates), and Substance (code iteration density, growth). Returns a scored Markdown table and structured data. Requires GITHUB_TOKEN.',
+      schema: githubScoreParamsSchema,
+      outputSchema: githubScoreOutputSchema,
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        destructiveHint: false,
+        openWorldHint: true
+      }
+    },
+    async (args, ctx) => {
+      if (!getCapabilities().github) {
+        return toToolResponse(toolFailure(getMissingEnvMessage("github")));
+      }
+      const reporter = createToolReporter(ctx, "github-score");
+      const result = await handleGitHubScore(args, reporter);
+      await reporter.progress(
+        100,
+        100,
+        result.isError ? "GitHub scoring failed" : "GitHub scoring complete"
+      );
+      return toToolResponse(result);
+    }
+  );
+}
+export {
+  handleGitHubScore,
+  registerGitHubScoreTool
+};
+//# sourceMappingURL=github-score.js.map

package/dist/src/tools/github-score.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tools/github-score.ts"],
+  "sourcesContent": ["/**\n * GitHub Score Tool Handler\n * Searches GitHub repos by keywords, fetches detailed data, calculates quality metrics,\n * and returns a scored Markdown table.\n * NEVER throws \u2014 always returns structured response for graceful degradation.\n */\n\nimport type { MCPServer } from 'mcp-use/server';\n\nimport { getCapabilities, getMissingEnvMessage } from '../config/index.js';\nimport {\n  githubScoreOutputSchema,\n  githubScoreParamsSchema,\n  type GitHubScoreParams,\n  type GitHubScoreOutput,\n} from '../schemas/github-score.js';\nimport { GitHubClient, type RepoFullData } from '../clients/github.js';\nimport {\n  scoreRepo,\n  type DisciplineFlags,\n  type RawRepoData,\n  type CompositeResult,\n} from '../scoring/github-quality.js';\nimport { classifyError } from '../utils/errors.js';\nimport { mcpLog, formatError, formatDuration } from './utils.js';\nimport {\n  createToolReporter,\n  NOOP_REPORTER,\n  toolFailure,\n  toolSuccess,\n  toToolResponse,\n  type ToolExecutionResult,\n  type ToolReporter,\n} from './mcp-helpers.js';\n\n// ============================================================================\n// Internal Types\n// ============================================================================\n\ninterface ScoredRepo {\n  readonly fullName: string;\n  readonly url: string;\n  readonly stars: number;\n  readonly forks: number;\n  readonly openIssues: number;\n  readonly language: string | null;\n  readonly lastPush: string;\n  readonly contributors: number;\n  readonly archived: boolean;\n  readonly score: CompositeResult;\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction buildSearchQuery(params: GitHubScoreParams): string {\n  let query: string;\n\n  if (params.search_mode === 'OR') {\n    query = params.keywords.join(' OR ');\n  } else {\n    // AND: space-separated terms\n    query = params.keywords.join(' ');\n  }\n\n  if (params.min_stars > 0) {\n    query += ` stars:>=${params.min_stars}`;\n  }\n\n  if (params.language) {\n    query += ` language:${params.language}`;\n  }\n\n  return query;\n}\n\nfunction buildRawRepoData(\n  fullData: RepoFullData,\n): RawRepoData {\n  const g = fullData.graphql;\n\n  const disciplineFlags: DisciplineFlags = {\n    hasLicense: g.license !== null,\n    hasContributing: g.hasContributing,\n    hasIssueTemplate: g.hasIssueTemplate,\n    hasPrTemplate: g.hasPrTemplate,\n    hasCodeOfConduct: g.hasCodeOfConduct,\n    hasCI: g.hasCI,\n    hasReleases: g.totalReleases > 0,\n    hasTopics: g.hasTopics,\n    hasDescription: (g.description ?? '').length > 0,\n    hasHomepage: (g.homepage ?? '').length > 0,\n  };\n\n  return {\n    stars: g.stars,\n    forks: g.forks,\n    watchers: g.watchers,\n    sizeKb: g.sizeKb,\n    createdAt: new Date(g.createdAt),\n    archived: g.archived,\n    hasLicense: g.license !== null,\n    closedIssues: g.closedIssues,\n    totalIssues: g.openIssues + g.closedIssues,\n    totalCommits: g.totalCommits,\n    contributorCommits: fullData.contributors.map((c) => c.contributions),\n    allWeeklyCommits: fullData.participation.all,\n    ownerWeeklyCommits: fullData.participation.owner,\n    disciplineFlags,\n  };\n}\n\nfunction formatRelativeDate(isoDate: string): string {\n  const date = new Date(isoDate);\n  if (isNaN(date.getTime())) return 'unknown';\n\n  const diffMs = Date.now() - date.getTime();\n  const days = Math.floor(diffMs / (1000 * 60 * 60 * 24));\n\n  if (days < 1) return 'today';\n  if (days === 1) return '1d ago';\n  if (days < 30) return `${days}d ago`;\n  if (days < 365) return `${Math.floor(days / 30)}mo ago`;\n  return `${(days / 365).toFixed(1)}y ago`;\n}\n\nfunction formatStarCount(stars: number): string {\n  if (stars >= 1000) {\n    return `${(stars / 1000).toFixed(1)}k`;\n  }\n  return String(stars);\n}\n\nfunction scoreBand(score: number): string {\n  if (score >= 70) return 'Excellent';\n  if (score >= 50) return 'Good';\n  if (score >= 30) return 'Meh';\n  return 'Low';\n}\n\nfunction formatScoreTable(repos: ScoredRepo[]): string {\n  let md = `| # | Repo | Stars | Score | Maint | Community | Discipline | Substance | Last Commit | Contributors | Flags |\\n`;\n  md += `|---|------|-------|-------|-------|-----------|------------|-----------|-------------|--------------|-------|\\n`;\n\n  repos.forEach((repo, i) => {\n    const s = repo.score;\n    const flagStr = s.flags.length > 0 ? s.flags.join(', ') : '-';\n    md += `| ${i + 1} | [${repo.fullName}](${repo.url}) | ${formatStarCount(repo.stars)} | **${s.score}** | ${s.subScores.maintenance.toFixed(2)} | ${s.subScores.community.toFixed(2)} | ${s.subScores.discipline.toFixed(2)} | ${s.subScores.substance.toFixed(2)} | ${formatRelativeDate(repo.lastPush)} | ${repo.contributors} | ${flagStr} |\\n`;\n  });\n\n  return md;\n}\n\nfunction sortRepos(repos: ScoredRepo[], sortBy: string): ScoredRepo[] {\n  const sorted = [...repos];\n  switch (sortBy) {\n    case 'stars':\n      sorted.sort((a, b) => b.stars - a.stars);\n      break;\n    case 'updated':\n      sorted.sort(\n        (a, b) =>\n          new Date(b.lastPush).getTime() - new Date(a.lastPush).getTime(),\n      );\n      break;\n    case 'score':\n    default:\n      sorted.sort((a, b) => b.score.score - a.score.score);\n      break;\n  }\n  return sorted;\n}\n\n// ============================================================================\n// Main Handler\n// ============================================================================\n\nexport async function handleGitHubScore(\n  params: GitHubScoreParams,\n  reporter: ToolReporter = NOOP_REPORTER,\n): Promise<ToolExecutionResult<GitHubScoreOutput>> {\n  const startTime = Date.now();\n\n  try {\n    const client = new GitHubClient();\n    const query = buildSearchQuery(params);\n\n    mcpLog('info', `Searching GitHub: \"${query}\"`, 'github-score');\n    await reporter.log('info', `Searching GitHub for: ${query}`);\n    await reporter.progress(10, 100, 'Searching GitHub repositories');\n\n    // 1. Search\n    const searchResult = await client.searchRepos(query, 'stars', params.max_results);\n    if (searchResult.error) {\n      return buildGitHubScoreError(searchResult.error, query, startTime, client.apiCalls);\n    }\n\n    if (searchResult.items.length === 0) {\n      const emptyMd = `# GitHub Score: No Results\\n\\nQuery: \\`${query}\\`\\n\\nNo repositories found. Try broader keywords or lower the min_stars filter.`;\n      return toolSuccess(emptyMd, {\n        content: emptyMd,\n        metadata: {\n          query,\n          total_found: 0,\n          total_scored: 0,\n          failed_scores: 0,\n          execution_time_ms: Date.now() - startTime,\n          api_calls_made: client.apiCalls,\n        },\n        repos: [],\n      });\n    }\n\n    mcpLog('info', `Found ${searchResult.totalCount} repos, scoring top ${searchResult.items.length}`, 'github-score');\n    await reporter.progress(20, 100, `Found ${searchResult.items.length} repos, fetching details`);\n\n    // 2. Fetch detailed data + score\n    const repoRequests = searchResult.items.map((item) => ({\n      owner: item.owner,\n      name: item.name,\n    }));\n\n    const detailResults = await client.fetchMultipleRepoDetails(repoRequests);\n\n    const scoredRepos: ScoredRepo[] = [];\n    let failedCount = 0;\n\n    for (let i = 0; i < detailResults.length; i++) {\n      const detail = detailResults[i]!;\n      const searchItem = searchResult.items[i]!;\n\n      if (detail.error || !detail.data) {\n        failedCount++;\n        mcpLog('warning', `Failed to score ${searchItem.fullName}: ${detail.error?.message ?? 'unknown'}`, 'github-score');\n        continue;\n      }\n\n      try {\n        const rawData = buildRawRepoData(detail.data);\n        const score = scoreRepo(rawData);\n\n        scoredRepos.push({\n          fullName: searchItem.fullName,\n          url: searchItem.url,\n          stars: detail.data.graphql.stars,\n          forks: detail.data.graphql.forks,\n          openIssues: detail.data.graphql.openIssues,\n          language: detail.data.graphql.language,\n          lastPush: detail.data.graphql.pushedAt,\n          contributors: detail.data.contributors.length,\n          archived: detail.data.graphql.archived,\n          score,\n        });\n      } catch {\n        failedCount++;\n        mcpLog('warning', `Scoring error for ${searchItem.fullName}`, 'github-score');\n      }\n\n      // Progress: 20-90% range during scoring\n      const progress = 20 + Math.round(((i + 1) / detailResults.length) * 70);\n      await reporter.progress(progress, 100, `Scored ${i + 1}/${detailResults.length} repos`);\n    }\n\n    // 3. Sort\n    const sorted = sortRepos(scoredRepos, params.sort);\n\n    // 4. Build output\n    const executionTime = Date.now() - startTime;\n    const avgScore =\n      sorted.length > 0\n        ? Math.round(sorted.reduce((s, r) => s + r.score.score, 0) / sorted.length)\n        : 0;\n\n    let md = `# GitHub Score Report\\n\\n`;\n    md += `**Query:** \\`${query}\\` | **Sorted by:** ${params.sort} | **Scored:** ${sorted.length}/${searchResult.items.length}`;\n    if (failedCount > 0) md += ` | **Failed:** ${failedCount}`;\n    md += `\\n\\n`;\n    md += `**Average Score:** ${avgScore}/100 (${scoreBand(avgScore)})\\n\\n`;\n    md += formatScoreTable(sorted);\n    md += `\\n---\\n`;\n    md += `*${formatDuration(executionTime)} | ${client.apiCalls} API calls | Score legend: Maint=Maintenance Pulse, Community=Community Health, Discipline=Engineering Practices, Substance=Code Quality*\\n`;\n    md += `\\n**Score bands:** 70+ Excellent | 50-69 Good | 30-49 Meh | <30 Low\\n`;\n    md += `\\n**Flag legend:** consistent-commits (steady work), growing (accelerating), active-community (external contributors), well-organized (CI/license/templates), high-bus-factor (multiple key contributors), stale-6mo (owner inactive), single-maintainer, no-license, archived, ai-dump-signal (few commits + large codebase)`;\n\n    const structuredRepos = sorted.map((r) => ({\n      full_name: r.fullName,\n      url: r.url,\n      stars: r.stars,\n      forks: r.forks,\n      open_issues: r.openIssues,\n      language: r.language,\n      last_push: r.lastPush,\n      contributors: r.contributors,\n      archived: r.archived,\n      composite_score: r.score.score,\n      maintenance_score: r.score.subScores.maintenance,\n      community_score: r.score.subScores.community,\n      discipline_score: r.score.subScores.discipline,\n      substance_score: r.score.subScores.substance,\n      flags: r.score.flags,\n    }));\n\n    return toolSuccess(md, {\n      content: md,\n      metadata: {\n        query,\n        total_found: searchResult.totalCount,\n        total_scored: sorted.length,\n        failed_scores: failedCount,\n        execution_time_ms: executionTime,\n        api_calls_made: client.apiCalls,\n      },\n      repos: structuredRepos,\n    });\n  } catch (error) {\n    return buildGitHubScoreError(classifyError(error), buildSearchQuery(params), startTime, 0);\n  }\n}\n\n// ============================================================================\n// Error Formatting\n// ============================================================================\n\nfunction buildGitHubScoreError(\n  error: unknown,\n  query: string,\n  startTime: number,\n  apiCalls: number,\n): ToolExecutionResult<GitHubScoreOutput> {\n  const structuredError = typeof error === 'object' && error !== null && 'code' in error\n    ? error as { code: string; message: string; retryable: boolean }\n    : classifyError(error);\n\n  mcpLog('error', `github-score: ${structuredError.message}`, 'github-score');\n\n  const errorContent = formatError({\n    code: structuredError.code,\n    message: structuredError.message,\n    retryable: structuredError.retryable,\n    toolName: 'github-score',\n    howToFix: [\n      'Verify GITHUB_TOKEN is set correctly',\n      'Check that the token has not expired',\n      'Ensure you have not exceeded the GitHub API rate limit (5000 req/hr)',\n    ],\n    alternatives: [\n      'web-search(keywords=[\"topic github\"]) \u2014 search the web for GitHub repos instead',\n    ],\n  });\n\n  return toolFailure(\n    `${errorContent}\\n\\nQuery: ${query}\\nExecution time: ${formatDuration(Date.now() - startTime)}\\nAPI calls: ${apiCalls}`,\n  );\n}\n\n// ============================================================================\n// Tool Registration\n// ============================================================================\n\nexport function registerGitHubScoreTool(server: MCPServer): void {\n  server.tool(\n    {\n      name: 'github-score',\n      title: 'GitHub Score',\n      description:\n        'Search GitHub repositories and score them with a composite \"Gives a Damn\" quality metric. ' +\n        'Takes keywords with AND/OR logic, fetches repo metadata, commit patterns, contributor data, ' +\n        'and CI/release/template presence to compute a 0-100 quality score across 4 dimensions: ' +\n        'Maintenance (commit consistency, velocity, owner activity), Community (contributor diversity, bus factor), ' +\n        'Discipline (CI, releases, license, templates), and Substance (code iteration density, growth). ' +\n        'Returns a scored Markdown table and structured data. Requires GITHUB_TOKEN.',\n      schema: githubScoreParamsSchema,\n      outputSchema: githubScoreOutputSchema,\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        destructiveHint: false,\n        openWorldHint: true,\n      },\n    },\n    async (args, ctx) => {\n      if (!getCapabilities().github) {\n        return toToolResponse(toolFailure(getMissingEnvMessage('github')));\n      }\n\n      const reporter = createToolReporter(ctx, 'github-score');\n      const result = await handleGitHubScore(args, reporter);\n\n      await reporter.progress(\n        100,\n        100,\n        result.isError ? 'GitHub scoring failed' : 'GitHub scoring complete',\n      );\n      return toToolResponse(result);\n    },\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/mcp-helpers.d.ts

@@ -0,0 +1,27 @@
+import { type TypedCallToolResult } from 'mcp-use/server';
+type ClientLogLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical' | 'alert' | 'emergency';
+interface ReporterContext {
+    log(level: ClientLogLevel, message: string, loggerName?: string): Promise<void>;
+    reportProgress?: (loaded: number, total?: number, message?: string) => Promise<void>;
+}
+export interface ToolExecutionSuccess<T extends Record<string, unknown>> {
+    readonly isError: false;
+    readonly content: string;
+    readonly structuredContent: T;
+}
+export interface ToolExecutionFailure {
+    readonly isError: true;
+    readonly content: string;
+}
+export type ToolExecutionResult<T extends Record<string, unknown>> = ToolExecutionSuccess<T> | ToolExecutionFailure;
+export interface ToolReporter {
+    log(level: ClientLogLevel, message: string): Promise<void>;
+    progress(loaded: number, total?: number, message?: string): Promise<void>;
+}
+export declare const NOOP_REPORTER: ToolReporter;
+export declare function toolSuccess<T extends Record<string, unknown>>(content: string, structuredContent: T): ToolExecutionSuccess<T>;
+export declare function toolFailure(content: string): ToolExecutionFailure;
+export declare function createToolReporter(ctx: ReporterContext, loggerName: string): ToolReporter;
+export declare function toToolResponse<T extends Record<string, unknown>>(result: ToolExecutionResult<T>): TypedCallToolResult<T> | TypedCallToolResult<never>;
+export {};
+//# sourceMappingURL=mcp-helpers.d.ts.map

package/dist/src/tools/mcp-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/mcp-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,KAAK,cAAc,GACf,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,OAAO,GACP,WAAW,CAAC;AAEhB,UAAU,eAAe;IACvB,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAC7D,oBAAoB,CAAC,CAAC,CAAC,GACvB,oBAAoB,CAAC;AAEzB,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAED,eAAO,MAAM,aAAa,EAAE,YAG3B,CAAC;AAEF,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,CAAC,GACnB,oBAAoB,CAAC,CAAC,CAAC,CAMzB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAKjE;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,eAAe,EACpB,UAAU,EAAE,MAAM,GACjB,YAAY,CASd;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC7B,mBAAmB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,CASrD"}

package/dist/src/tools/mcp-helpers.js

@@ -0,0 +1,47 @@
+import { error, markdown } from "mcp-use/server";
+const NOOP_REPORTER = {
+  async log() {
+  },
+  async progress() {
+  }
+};
+function toolSuccess(content, structuredContent) {
+  return {
+    isError: false,
+    content,
+    structuredContent
+  };
+}
+function toolFailure(content) {
+  return {
+    isError: true,
+    content
+  };
+}
+function createToolReporter(ctx, loggerName) {
+  return {
+    log(level, message) {
+      return ctx.log(level, message, loggerName);
+    },
+    progress(loaded, total, message) {
+      return ctx.reportProgress?.(loaded, total, message) ?? Promise.resolve();
+    }
+  };
+}
+function toToolResponse(result) {
+  if (result.isError) {
+    return error(result.content);
+  }
+  return {
+    ...markdown(result.content),
+    structuredContent: result.structuredContent
+  };
+}
+export {
+  NOOP_REPORTER,
+  createToolReporter,
+  toToolResponse,
+  toolFailure,
+  toolSuccess
+};
+//# sourceMappingURL=mcp-helpers.js.map

package/dist/src/tools/mcp-helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tools/mcp-helpers.ts"],
+  "sourcesContent": ["import { error, markdown, type TypedCallToolResult } from 'mcp-use/server';\n\ntype ClientLogLevel =\n  | 'debug'\n  | 'info'\n  | 'notice'\n  | 'warning'\n  | 'error'\n  | 'critical'\n  | 'alert'\n  | 'emergency';\n\ninterface ReporterContext {\n  log(level: ClientLogLevel, message: string, loggerName?: string): Promise<void>;\n  reportProgress?: (loaded: number, total?: number, message?: string) => Promise<void>;\n}\n\nexport interface ToolExecutionSuccess<T extends Record<string, unknown>> {\n  readonly isError: false;\n  readonly content: string;\n  readonly structuredContent: T;\n}\n\nexport interface ToolExecutionFailure {\n  readonly isError: true;\n  readonly content: string;\n}\n\nexport type ToolExecutionResult<T extends Record<string, unknown>> =\n  | ToolExecutionSuccess<T>\n  | ToolExecutionFailure;\n\nexport interface ToolReporter {\n  log(level: ClientLogLevel, message: string): Promise<void>;\n  progress(loaded: number, total?: number, message?: string): Promise<void>;\n}\n\nexport const NOOP_REPORTER: ToolReporter = {\n  async log() {},\n  async progress() {},\n};\n\nexport function toolSuccess<T extends Record<string, unknown>>(\n  content: string,\n  structuredContent: T,\n): ToolExecutionSuccess<T> {\n  return {\n    isError: false,\n    content,\n    structuredContent,\n  };\n}\n\nexport function toolFailure(content: string): ToolExecutionFailure {\n  return {\n    isError: true,\n    content,\n  };\n}\n\nexport function createToolReporter(\n  ctx: ReporterContext,\n  loggerName: string,\n): ToolReporter {\n  return {\n    log(level, message) {\n      return ctx.log(level, message, loggerName);\n    },\n    progress(loaded, total, message) {\n      return ctx.reportProgress?.(loaded, total, message) ?? Promise.resolve();\n    },\n  };\n}\n\nexport function toToolResponse<T extends Record<string, unknown>>(\n  result: ToolExecutionResult<T>,\n): TypedCallToolResult<T> | TypedCallToolResult<never> {\n  if (result.isError) {\n    return error(result.content);\n  }\n\n  return {\n    ...markdown(result.content),\n    structuredContent: result.structuredContent,\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,gBAA0C;AAqCnD,MAAM,gBAA8B;AAAA,EACzC,MAAM,MAAM;AAAA,EAAC;AAAA,EACb,MAAM,WAAW;AAAA,EAAC;AACpB;AAEO,SAAS,YACd,SACA,mBACyB;AACzB,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,YAAY,SAAuC;AACjE,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,EACF;AACF;AAEO,SAAS,mBACd,KACA,YACc;AACd,SAAO;AAAA,IACL,IAAI,OAAO,SAAS;AAClB,aAAO,IAAI,IAAI,OAAO,SAAS,UAAU;AAAA,IAC3C;AAAA,IACA,SAAS,QAAQ,OAAO,SAAS;AAC/B,aAAO,IAAI,iBAAiB,QAAQ,OAAO,OAAO,KAAK,QAAQ,QAAQ;AAAA,IACzE;AAAA,EACF;AACF;AAEO,SAAS,eACd,QACqD;AACrD,MAAI,OAAO,SAAS;AAClB,WAAO,MAAM,OAAO,OAAO;AAAA,EAC7B;AAEA,SAAO;AAAA,IACL,GAAG,SAAS,OAAO,OAAO;AAAA,IAC1B,mBAAmB,OAAO;AAAA,EAC5B;AACF;",
+  "names": []
+}

package/dist/src/tools/reddit.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Reddit Tools - Search and Fetch
+ * NEVER throws - always returns structured response for graceful degradation
+ */
+import type { MCPServer } from 'mcp-use/server';
+import { z } from 'zod';
+import { type ToolExecutionResult, type ToolReporter } from './mcp-helpers.js';
+export declare const searchRedditParamsSchema: z.ZodObject<{
+    queries: z.ZodArray<z.ZodString>;
+    date_after: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const getRedditPostParamsSchema: z.ZodObject<{
+    urls: z.ZodArray<z.ZodString>;
+    fetch_comments: z.ZodDefault<z.ZodBoolean>;
+    use_llm: z.ZodDefault<z.ZodBoolean>;
+    what_to_extract: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const searchRedditOutputSchema: z.ZodObject<{
+    content: z.ZodString;
+    metadata: z.ZodObject<{
+        query_count: z.ZodNumber;
+        total_results: z.ZodNumber;
+        date_after: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type SearchRedditOutput = z.infer<typeof searchRedditOutputSchema>;
+export declare const getRedditPostOutputSchema: z.ZodObject<{
+    content: z.ZodString;
+    metadata: z.ZodObject<{
+        total_urls: z.ZodNumber;
+        successful: z.ZodNumber;
+        failed: z.ZodNumber;
+        fetch_comments: z.ZodBoolean;
+        max_words_per_post: z.ZodNumber;
+        total_words_used: z.ZodNumber;
+        llm_requested: z.ZodBoolean;
+        llm_available: z.ZodBoolean;
+        llm_failures: z.ZodNumber;
+        total_batches: z.ZodNumber;
+        rate_limit_hits: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type GetRedditPostOutput = z.infer<typeof getRedditPostOutputSchema>;
+export declare function handleSearchReddit(queries: string[], apiKey: string, dateAfter?: string, reporter?: ToolReporter): Promise<ToolExecutionResult<SearchRedditOutput>>;
+interface GetRedditPostsOptions {
+    fetchComments?: boolean;
+    use_llm?: boolean;
+    what_to_extract?: string;
+}
+export declare function handleGetRedditPosts(urls: string[], clientId: string, clientSecret: string, options?: GetRedditPostsOptions, reporter?: ToolReporter): Promise<ToolExecutionResult<GetRedditPostOutput>>;
+export declare function registerSearchRedditTool(server: MCPServer): void;
+export declare function registerGetRedditPostTool(server: MCPServer): void;
+export {};
+//# sourceMappingURL=reddit.d.ts.map

package/dist/src/tools/reddit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reddit.d.ts","sourceRoot":"","sources":["../../../src/tools/reddit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,OAAO,EAML,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAM1B,eAAO,MAAM,wBAAwB;;;kBAiB1B,CAAC;AAEZ,eAAO,MAAM,yBAAyB;;;;;kBAwB3B,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;kBAoB1B,CAAC;AAEZ,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;kBAuD3B,CAAC;AAEZ,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAgIrE,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,GAAE,YAA4B,GACrC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,CA8BlD;AAMD,UAAU,qBAAqB;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiND,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,qBAA0B,EACnC,QAAQ,GAAE,YAA4B,GACrC,OAAO,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,CAAC,CA6DnD;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6BhE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuCjE"}