mcp-researchpowerpack-http 3.10.0

package/dist/src/clients/github.js

@@ -0,0 +1,370 @@
+import { GITHUB, parseEnv } from "../config/index.js";
+import {
+  classifyError,
+  fetchWithTimeout,
+  sleep,
+  ErrorCode
+} from "../utils/errors.js";
+import { calculateBackoff } from "../utils/retry.js";
+import { pMapSettled } from "../utils/concurrency.js";
+import { mcpLog } from "../utils/logger.js";
+const REPO_DETAILS_QUERY = `
+query RepoDetails($owner: String!, $name: String!) {
+  repository(owner: $owner, name: $name) {
+    stargazerCount
+    forkCount
+    watchers { totalCount }
+    openIssues: issues(states: OPEN) { totalCount }
+    closedIssues: issues(states: CLOSED) { totalCount }
+    pullRequests { totalCount }
+    releases { totalCount }
+    defaultBranchRef {
+      target {
+        ... on Commit {
+          history { totalCount }
+        }
+      }
+    }
+    licenseInfo { spdxId }
+    primaryLanguage { name }
+    repositoryTopics(first: 5) {
+      nodes { topic { name } }
+    }
+    isArchived
+    pushedAt
+    createdAt
+    diskUsage
+    description
+    homepageUrl
+    codeOfConduct { name }
+    ciCheck: object(expression: "HEAD:.github/workflows") {
+      ... on Tree { entries { name } }
+    }
+    contributingGuide: object(expression: "HEAD:CONTRIBUTING.md") {
+      ... on Blob { byteSize }
+    }
+    issueTemplate: object(expression: "HEAD:.github/ISSUE_TEMPLATE") {
+      ... on Tree { entries { name } }
+    }
+    prTemplate: object(expression: "HEAD:.github/PULL_REQUEST_TEMPLATE.md") {
+      ... on Blob { byteSize }
+    }
+  }
+}
+`;
+const RETRYABLE_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+function getGhCliToken() {
+  try {
+    const { execSync } = require("node:child_process");
+    const token = execSync("gh auth token", {
+      timeout: 3e3,
+      stdio: ["ignore", "pipe", "ignore"],
+      encoding: "utf-8"
+    }).trim();
+    if (token.length > 0) {
+      mcpLog("info", "Using GitHub token from `gh auth token`", "github");
+    }
+    return token;
+  } catch {
+    return "";
+  }
+}
+class GitHubClient {
+  token;
+  apiCallCount = 0;
+  constructor(token) {
+    const env = parseEnv();
+    this.token = token || env.GITHUB_TOKEN || getGhCliToken();
+    if (!this.token) {
+      throw new Error(
+        "GitHub capability is not configured. Set GITHUB_TOKEN or log in with `gh auth login`."
+      );
+    }
+  }
+  get apiCalls() {
+    return this.apiCallCount;
+  }
+  // --------------------------------------------------------------------------
+  // Search
+  // --------------------------------------------------------------------------
+  async searchRepos(query, sort = "stars", perPage = 20) {
+    const url = `${GITHUB.REST_BASE_URL}/search/repositories?q=${encodeURIComponent(query)}&sort=${sort}&order=desc&per_page=${perPage}`;
+    try {
+      const response = await this.restGet(url);
+      if ("error" in response) {
+        return { items: [], totalCount: 0, error: response.error };
+      }
+      const data = response.data;
+      const items = (data.items ?? []).map((item) => ({
+        fullName: String(item.full_name ?? ""),
+        owner: item.owner?.login ? String(item.owner.login) : "",
+        name: String(item.name ?? ""),
+        description: item.description ? String(item.description) : null,
+        stars: Number(item.stargazers_count ?? 0),
+        forks: Number(item.forks_count ?? 0),
+        language: item.language ? String(item.language) : null,
+        pushedAt: String(item.pushed_at ?? ""),
+        url: String(item.html_url ?? "")
+      }));
+      return { items, totalCount: Number(data.total_count ?? 0) };
+    } catch (error) {
+      return { items: [], totalCount: 0, error: classifyError(error) };
+    }
+  }
+  // --------------------------------------------------------------------------
+  // Fetch Full Repo Details (GraphQL + 2 REST)
+  // --------------------------------------------------------------------------
+  async fetchRepoDetails(owner, name) {
+    const graphqlResult = await this.graphqlQuery(REPO_DETAILS_QUERY, { owner, name });
+    if (graphqlResult.error || !graphqlResult.data) {
+      return { error: graphqlResult.error ?? { code: ErrorCode.UNKNOWN_ERROR, message: "GraphQL returned no data", retryable: false } };
+    }
+    const repo = graphqlResult.data?.repository;
+    if (!repo) {
+      return { error: { code: ErrorCode.NOT_FOUND, message: `Repository ${owner}/${name} not found`, retryable: false } };
+    }
+    const graphql = parseGraphQLResponse(repo);
+    const participation = await this.fetchParticipation(owner, name);
+    const contributors = await this.fetchContributors(owner, name);
+    return {
+      data: {
+        graphql,
+        participation,
+        contributors
+      }
+    };
+  }
+  // --------------------------------------------------------------------------
+  // Batch fetch with concurrency
+  // --------------------------------------------------------------------------
+  async fetchMultipleRepoDetails(repos) {
+    const results = await pMapSettled(
+      repos,
+      async (repo) => {
+        const result = await this.fetchRepoDetails(repo.owner, repo.name);
+        return { ...repo, ...result };
+      },
+      GITHUB.MAX_CONCURRENT_REPOS
+    );
+    return results.map((settled, i) => {
+      const repo = repos[i];
+      if (settled.status === "fulfilled") {
+        return settled.value;
+      }
+      return {
+        owner: repo.owner,
+        name: repo.name,
+        error: classifyError(settled.reason)
+      };
+    });
+  }
+  // --------------------------------------------------------------------------
+  // GraphQL
+  // --------------------------------------------------------------------------
+  async graphqlQuery(query, variables) {
+    this.apiCallCount++;
+    for (let attempt = 0; attempt <= GITHUB.RETRY_COUNT; attempt++) {
+      try {
+        if (attempt > 0) {
+          mcpLog("warning", `GraphQL retry ${attempt}/${GITHUB.RETRY_COUNT}`, "github");
+        }
+        const response = await fetchWithTimeout(GITHUB.GRAPHQL_URL, {
+          method: "POST",
+          headers: {
+            Authorization: `Bearer ${this.token}`,
+            "Content-Type": "application/json",
+            "User-Agent": "mcp-researchpowerpack"
+          },
+          body: JSON.stringify({ query, variables }),
+          timeoutMs: GITHUB.TIMEOUT_MS
+        });
+        if (!response.ok) {
+          if (RETRYABLE_CODES.has(response.status) && attempt < GITHUB.RETRY_COUNT) {
+            const delay = calculateBackoff(attempt);
+            await sleep(delay);
+            continue;
+          }
+          const text = await response.text().catch(() => "");
+          return { error: classifyError({ status: response.status, message: text }) };
+        }
+        const json = await response.json();
+        if (json.errors && json.errors.length > 0) {
+          const msg = json.errors.map((e) => e.message).join("; ");
+          if (json.data) {
+            mcpLog("warning", `GraphQL partial error: ${msg}`, "github");
+            return { data: json.data };
+          }
+          return { error: { code: ErrorCode.INTERNAL_ERROR, message: msg, retryable: false } };
+        }
+        return { data: json.data };
+      } catch (error) {
+        const structured = classifyError(error);
+        if (structured.retryable && attempt < GITHUB.RETRY_COUNT) {
+          const delay = calculateBackoff(attempt);
+          await sleep(delay);
+          continue;
+        }
+        return { error: structured };
+      }
+    }
+    return { error: { code: ErrorCode.UNKNOWN_ERROR, message: "GraphQL failed after retries", retryable: false } };
+  }
+  // --------------------------------------------------------------------------
+  // REST: Participation (handles 202 lazy computation)
+  // --------------------------------------------------------------------------
+  async fetchParticipation(owner, name) {
+    const url = `${GITHUB.REST_BASE_URL}/repos/${owner}/${name}/stats/participation`;
+    const emptyResult = { all: [], owner: [] };
+    for (let attempt = 0; attempt < GITHUB.PARTICIPATION_MAX_RETRIES; attempt++) {
+      try {
+        this.apiCallCount++;
+        const response = await fetchWithTimeout(url, {
+          headers: {
+            Authorization: `Bearer ${this.token}`,
+            "User-Agent": "mcp-researchpowerpack"
+          },
+          timeoutMs: GITHUB.TIMEOUT_MS
+        });
+        if (response.status === 202) {
+          mcpLog("info", `Participation stats computing for ${owner}/${name}, retry ${attempt + 1}`, "github");
+          await sleep(GITHUB.PARTICIPATION_RETRY_DELAY_MS);
+          continue;
+        }
+        if (!response.ok) {
+          mcpLog("warning", `Participation fetch failed ${response.status} for ${owner}/${name}`, "github");
+          return emptyResult;
+        }
+        const data = await response.json();
+        if (!Array.isArray(data.all)) return emptyResult;
+        return {
+          all: data.all ?? [],
+          owner: data.owner ?? []
+        };
+      } catch (error) {
+        mcpLog("warning", `Participation error for ${owner}/${name}: ${classifyError(error).message}`, "github");
+        return emptyResult;
+      }
+    }
+    mcpLog("warning", `Participation still 202 after retries for ${owner}/${name}`, "github");
+    return emptyResult;
+  }
+  // --------------------------------------------------------------------------
+  // REST: Contributors
+  // --------------------------------------------------------------------------
+  async fetchContributors(owner, name) {
+    const url = `${GITHUB.REST_BASE_URL}/repos/${owner}/${name}/contributors?per_page=100&anon=true`;
+    try {
+      this.apiCallCount++;
+      const response = await fetchWithTimeout(url, {
+        headers: {
+          Authorization: `Bearer ${this.token}`,
+          "User-Agent": "mcp-researchpowerpack"
+        },
+        timeoutMs: GITHUB.TIMEOUT_MS
+      });
+      if (response.status === 202) {
+        return [];
+      }
+      if (!response.ok) {
+        mcpLog("warning", `Contributors fetch failed ${response.status} for ${owner}/${name}`, "github");
+        return [];
+      }
+      const data = await response.json();
+      if (!Array.isArray(data)) return [];
+      return data.map((c) => ({
+        login: String(c.login ?? "anonymous"),
+        contributions: Number(c.contributions ?? 0)
+      }));
+    } catch (error) {
+      mcpLog("warning", `Contributors error for ${owner}/${name}: ${classifyError(error).message}`, "github");
+      return [];
+    }
+  }
+  // --------------------------------------------------------------------------
+  // REST helper
+  // --------------------------------------------------------------------------
+  async restGet(url) {
+    this.apiCallCount++;
+    for (let attempt = 0; attempt <= GITHUB.RETRY_COUNT; attempt++) {
+      try {
+        const response = await fetchWithTimeout(url, {
+          headers: {
+            Authorization: `Bearer ${this.token}`,
+            Accept: "application/vnd.github+json",
+            "User-Agent": "mcp-researchpowerpack"
+          },
+          timeoutMs: GITHUB.TIMEOUT_MS
+        });
+        if (!response.ok) {
+          if (RETRYABLE_CODES.has(response.status) && attempt < GITHUB.RETRY_COUNT) {
+            const delay = calculateBackoff(attempt);
+            await sleep(delay);
+            continue;
+          }
+          const text = await response.text().catch(() => "");
+          return { error: classifyError({ status: response.status, message: text }) };
+        }
+        return { data: await response.json() };
+      } catch (error) {
+        const structured = classifyError(error);
+        if (structured.retryable && attempt < GITHUB.RETRY_COUNT) {
+          const delay = calculateBackoff(attempt);
+          await sleep(delay);
+          continue;
+        }
+        return { error: structured };
+      }
+    }
+    return { error: { code: ErrorCode.UNKNOWN_ERROR, message: "REST request failed after retries", retryable: false } };
+  }
+}
+function parseGraphQLResponse(repo) {
+  const defaultBranch = repo.defaultBranchRef;
+  const target = defaultBranch?.target;
+  const history = target?.history;
+  const watchers = repo.watchers;
+  const openIssues = repo.openIssues;
+  const closedIssues = repo.closedIssues;
+  const pullRequests = repo.pullRequests;
+  const releases = repo.releases;
+  const licenseInfo = repo.licenseInfo;
+  const primaryLanguage = repo.primaryLanguage;
+  const topics = repo.repositoryTopics;
+  const codeOfConduct = repo.codeOfConduct;
+  const ciCheck = repo.ciCheck;
+  const hasCI = Array.isArray(ciCheck?.entries) && ciCheck.entries.length > 0;
+  const contributingGuide = repo.contributingGuide;
+  const hasContributing = (contributingGuide?.byteSize ?? 0) > 0;
+  const issueTemplate = repo.issueTemplate;
+  const hasIssueTemplate = Array.isArray(issueTemplate?.entries) && issueTemplate.entries.length > 0;
+  const prTemplate = repo.prTemplate;
+  const hasPrTemplate = (prTemplate?.byteSize ?? 0) > 0;
+  return {
+    stars: Number(repo.stargazerCount ?? 0),
+    forks: Number(repo.forkCount ?? 0),
+    watchers: watchers?.totalCount ?? 0,
+    openIssues: openIssues?.totalCount ?? 0,
+    closedIssues: closedIssues?.totalCount ?? 0,
+    totalCommits: history?.totalCount ?? 0,
+    totalReleases: releases?.totalCount ?? 0,
+    totalPRs: pullRequests?.totalCount ?? 0,
+    sizeKb: Number(repo.diskUsage ?? 0),
+    language: primaryLanguage?.name ?? null,
+    license: licenseInfo?.spdxId ?? null,
+    archived: Boolean(repo.isArchived),
+    createdAt: String(repo.createdAt ?? ""),
+    pushedAt: String(repo.pushedAt ?? ""),
+    description: repo.description ? String(repo.description) : null,
+    homepage: repo.homepageUrl ? String(repo.homepageUrl) : null,
+    hasCI,
+    hasContributing,
+    hasIssueTemplate,
+    hasPrTemplate,
+    hasCodeOfConduct: (codeOfConduct?.name ?? "").length > 0,
+    hasTopics: (topics?.nodes?.length ?? 0) > 0
+  };
+}
+export {
+  GitHubClient
+};
+//# sourceMappingURL=github.js.map

package/dist/src/clients/github.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/clients/github.ts"],
+  "sourcesContent": ["/**\n * GitHub API Client\n * GraphQL + REST client for fetching repository data for quality scoring.\n * Implements robust error handling that NEVER crashes.\n */\n\nimport { GITHUB, parseEnv } from '../config/index.js';\nimport {\n  classifyError,\n  fetchWithTimeout,\n  sleep,\n  ErrorCode,\n  type StructuredError,\n} from '../utils/errors.js';\nimport { calculateBackoff } from '../utils/retry.js';\nimport { pMapSettled } from '../utils/concurrency.js';\nimport { mcpLog } from '../utils/logger.js';\n\n// ============================================================================\n// Data Interfaces\n// ============================================================================\n\nexport interface GitHubSearchItem {\n  readonly fullName: string;\n  readonly owner: string;\n  readonly name: string;\n  readonly description: string | null;\n  readonly stars: number;\n  readonly forks: number;\n  readonly language: string | null;\n  readonly pushedAt: string;\n  readonly url: string;\n}\n\nexport interface ParticipationData {\n  readonly all: readonly number[];\n  readonly owner: readonly number[];\n}\n\nexport interface ContributorEntry {\n  readonly login: string;\n  readonly contributions: number;\n}\n\nexport interface RepoGraphQLData {\n  readonly stars: number;\n  readonly forks: number;\n  readonly watchers: number;\n  readonly openIssues: number;\n  readonly closedIssues: number;\n  readonly totalCommits: number;\n  readonly totalReleases: number;\n  readonly totalPRs: number;\n  readonly sizeKb: number;\n  readonly language: string | null;\n  readonly license: string | null;\n  readonly archived: boolean;\n  readonly createdAt: string;\n  readonly pushedAt: string;\n  readonly description: string | null;\n  readonly homepage: string | null;\n  readonly hasCI: boolean;\n  readonly hasContributing: boolean;\n  readonly hasIssueTemplate: boolean;\n  readonly hasPrTemplate: boolean;\n  readonly hasCodeOfConduct: boolean;\n  readonly hasTopics: boolean;\n}\n\nexport interface RepoFullData {\n  readonly graphql: RepoGraphQLData;\n  readonly participation: ParticipationData;\n  readonly contributors: readonly ContributorEntry[];\n}\n\n// ============================================================================\n// GraphQL Query\n// ============================================================================\n\nconst REPO_DETAILS_QUERY = `\nquery RepoDetails($owner: String!, $name: String!) {\n  repository(owner: $owner, name: $name) {\n    stargazerCount\n    forkCount\n    watchers { totalCount }\n    openIssues: issues(states: OPEN) { totalCount }\n    closedIssues: issues(states: CLOSED) { totalCount }\n    pullRequests { totalCount }\n    releases { totalCount }\n    defaultBranchRef {\n      target {\n        ... on Commit {\n          history { totalCount }\n        }\n      }\n    }\n    licenseInfo { spdxId }\n    primaryLanguage { name }\n    repositoryTopics(first: 5) {\n      nodes { topic { name } }\n    }\n    isArchived\n    pushedAt\n    createdAt\n    diskUsage\n    description\n    homepageUrl\n    codeOfConduct { name }\n    ciCheck: object(expression: \"HEAD:.github/workflows\") {\n      ... on Tree { entries { name } }\n    }\n    contributingGuide: object(expression: \"HEAD:CONTRIBUTING.md\") {\n      ... on Blob { byteSize }\n    }\n    issueTemplate: object(expression: \"HEAD:.github/ISSUE_TEMPLATE\") {\n      ... on Tree { entries { name } }\n    }\n    prTemplate: object(expression: \"HEAD:.github/PULL_REQUEST_TEMPLATE.md\") {\n      ... on Blob { byteSize }\n    }\n  }\n}\n`;\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst RETRYABLE_CODES = new Set([429, 500, 502, 503, 504]);\n\n/**\n * Try to get the GitHub token from `gh auth token` (GitHub CLI).\n * Returns empty string on failure \u2014 never throws.\n */\nfunction getGhCliToken(): string {\n  try {\n    const { execSync } = require('node:child_process') as typeof import('node:child_process');\n    const token = execSync('gh auth token', {\n      timeout: 3000,\n      stdio: ['ignore', 'pipe', 'ignore'],\n      encoding: 'utf-8',\n    }).trim();\n    if (token.length > 0) {\n      mcpLog('info', 'Using GitHub token from `gh auth token`', 'github');\n    }\n    return token;\n  } catch {\n    return '';\n  }\n}\n\n// ============================================================================\n// Client\n// ============================================================================\n\nexport class GitHubClient {\n  private token: string;\n  private apiCallCount = 0;\n\n  constructor(token?: string) {\n    const env = parseEnv();\n    this.token = token || env.GITHUB_TOKEN || getGhCliToken();\n\n    if (!this.token) {\n      throw new Error(\n        'GitHub capability is not configured. Set GITHUB_TOKEN or log in with `gh auth login`.',\n      );\n    }\n  }\n\n  get apiCalls(): number {\n    return this.apiCallCount;\n  }\n\n  // --------------------------------------------------------------------------\n  // Search\n  // --------------------------------------------------------------------------\n\n  async searchRepos(\n    query: string,\n    sort: string = 'stars',\n    perPage: number = 20,\n  ): Promise<{ items: GitHubSearchItem[]; totalCount: number; error?: StructuredError }> {\n    const url = `${GITHUB.REST_BASE_URL}/search/repositories?q=${encodeURIComponent(query)}&sort=${sort}&order=desc&per_page=${perPage}`;\n\n    try {\n      const response = await this.restGet(url);\n      if ('error' in response) {\n        return { items: [], totalCount: 0, error: response.error };\n      }\n\n      const data = response.data as {\n        total_count?: number;\n        items?: Array<Record<string, unknown>>;\n      };\n\n      const items: GitHubSearchItem[] = (data.items ?? []).map((item) => ({\n        fullName: String(item.full_name ?? ''),\n        owner: (item.owner as Record<string, unknown>)?.login\n          ? String((item.owner as Record<string, unknown>).login)\n          : '',\n        name: String(item.name ?? ''),\n        description: item.description ? String(item.description) : null,\n        stars: Number(item.stargazers_count ?? 0),\n        forks: Number(item.forks_count ?? 0),\n        language: item.language ? String(item.language) : null,\n        pushedAt: String(item.pushed_at ?? ''),\n        url: String(item.html_url ?? ''),\n      }));\n\n      return { items, totalCount: Number(data.total_count ?? 0) };\n    } catch (error) {\n      return { items: [], totalCount: 0, error: classifyError(error) };\n    }\n  }\n\n  // --------------------------------------------------------------------------\n  // Fetch Full Repo Details (GraphQL + 2 REST)\n  // --------------------------------------------------------------------------\n\n  async fetchRepoDetails(\n    owner: string,\n    name: string,\n  ): Promise<{ data?: RepoFullData; error?: StructuredError }> {\n    // 1. GraphQL for bulk metadata\n    const graphqlResult = await this.graphqlQuery(REPO_DETAILS_QUERY, { owner, name });\n    if (graphqlResult.error || !graphqlResult.data) {\n      return { error: graphqlResult.error ?? { code: ErrorCode.UNKNOWN_ERROR, message: 'GraphQL returned no data', retryable: false } };\n    }\n\n    const repo = (graphqlResult.data as { repository?: Record<string, unknown> })?.repository;\n    if (!repo) {\n      return { error: { code: ErrorCode.NOT_FOUND, message: `Repository ${owner}/${name} not found`, retryable: false } };\n    }\n\n    const graphql = parseGraphQLResponse(repo);\n\n    // 2. REST: stats/participation (handles 202 retry)\n    const participation = await this.fetchParticipation(owner, name);\n\n    // 3. REST: contributors\n    const contributors = await this.fetchContributors(owner, name);\n\n    return {\n      data: {\n        graphql,\n        participation,\n        contributors,\n      },\n    };\n  }\n\n  // --------------------------------------------------------------------------\n  // Batch fetch with concurrency\n  // --------------------------------------------------------------------------\n\n  async fetchMultipleRepoDetails(\n    repos: Array<{ owner: string; name: string }>,\n  ): Promise<Array<{ owner: string; name: string; data?: RepoFullData; error?: StructuredError }>> {\n    const results = await pMapSettled(\n      repos,\n      async (repo) => {\n        const result = await this.fetchRepoDetails(repo.owner, repo.name);\n        return { ...repo, ...result };\n      },\n      GITHUB.MAX_CONCURRENT_REPOS,\n    );\n\n    return results.map((settled, i) => {\n      const repo = repos[i]!;\n      if (settled.status === 'fulfilled') {\n        return settled.value;\n      }\n      return {\n        owner: repo.owner,\n        name: repo.name,\n        error: classifyError(settled.reason),\n      };\n    });\n  }\n\n  // --------------------------------------------------------------------------\n  // GraphQL\n  // --------------------------------------------------------------------------\n\n  private async graphqlQuery(\n    query: string,\n    variables: Record<string, unknown>,\n  ): Promise<{ data?: unknown; error?: StructuredError }> {\n    this.apiCallCount++;\n\n    for (let attempt = 0; attempt <= GITHUB.RETRY_COUNT; attempt++) {\n      try {\n        if (attempt > 0) {\n          mcpLog('warning', `GraphQL retry ${attempt}/${GITHUB.RETRY_COUNT}`, 'github');\n        }\n\n        const response = await fetchWithTimeout(GITHUB.GRAPHQL_URL, {\n          method: 'POST',\n          headers: {\n            Authorization: `Bearer ${this.token}`,\n            'Content-Type': 'application/json',\n            'User-Agent': 'mcp-researchpowerpack',\n          },\n          body: JSON.stringify({ query, variables }),\n          timeoutMs: GITHUB.TIMEOUT_MS,\n        });\n\n        if (!response.ok) {\n          if (RETRYABLE_CODES.has(response.status) && attempt < GITHUB.RETRY_COUNT) {\n            const delay = calculateBackoff(attempt);\n            await sleep(delay);\n            continue;\n          }\n          const text = await response.text().catch(() => '');\n          return { error: classifyError({ status: response.status, message: text }) };\n        }\n\n        const json = (await response.json()) as { data?: unknown; errors?: Array<{ message: string }> };\n\n        if (json.errors && json.errors.length > 0) {\n          const msg = json.errors.map((e) => e.message).join('; ');\n          // GraphQL can return partial data with errors \u2014 use data if available\n          if (json.data) {\n            mcpLog('warning', `GraphQL partial error: ${msg}`, 'github');\n            return { data: json.data };\n          }\n          return { error: { code: ErrorCode.INTERNAL_ERROR, message: msg, retryable: false } };\n        }\n\n        return { data: json.data };\n      } catch (error) {\n        const structured = classifyError(error);\n        if (structured.retryable && attempt < GITHUB.RETRY_COUNT) {\n          const delay = calculateBackoff(attempt);\n          await sleep(delay);\n          continue;\n        }\n        return { error: structured };\n      }\n    }\n\n    return { error: { code: ErrorCode.UNKNOWN_ERROR, message: 'GraphQL failed after retries', retryable: false } };\n  }\n\n  // --------------------------------------------------------------------------\n  // REST: Participation (handles 202 lazy computation)\n  // --------------------------------------------------------------------------\n\n  private async fetchParticipation(\n    owner: string,\n    name: string,\n  ): Promise<ParticipationData> {\n    const url = `${GITHUB.REST_BASE_URL}/repos/${owner}/${name}/stats/participation`;\n    const emptyResult: ParticipationData = { all: [], owner: [] };\n\n    for (let attempt = 0; attempt < GITHUB.PARTICIPATION_MAX_RETRIES; attempt++) {\n      try {\n        this.apiCallCount++;\n        const response = await fetchWithTimeout(url, {\n          headers: {\n            Authorization: `Bearer ${this.token}`,\n            'User-Agent': 'mcp-researchpowerpack',\n          },\n          timeoutMs: GITHUB.TIMEOUT_MS,\n        });\n\n        if (response.status === 202) {\n          // GitHub is computing stats \u2014 retry after delay\n          mcpLog('info', `Participation stats computing for ${owner}/${name}, retry ${attempt + 1}`, 'github');\n          await sleep(GITHUB.PARTICIPATION_RETRY_DELAY_MS);\n          continue;\n        }\n\n        if (!response.ok) {\n          mcpLog('warning', `Participation fetch failed ${response.status} for ${owner}/${name}`, 'github');\n          return emptyResult;\n        }\n\n        const data = (await response.json()) as { all?: number[]; owner?: number[] };\n        if (!Array.isArray(data.all)) return emptyResult;\n\n        return {\n          all: data.all ?? [],\n          owner: data.owner ?? [],\n        };\n      } catch (error) {\n        mcpLog('warning', `Participation error for ${owner}/${name}: ${classifyError(error).message}`, 'github');\n        return emptyResult;\n      }\n    }\n\n    mcpLog('warning', `Participation still 202 after retries for ${owner}/${name}`, 'github');\n    return emptyResult;\n  }\n\n  // --------------------------------------------------------------------------\n  // REST: Contributors\n  // --------------------------------------------------------------------------\n\n  private async fetchContributors(\n    owner: string,\n    name: string,\n  ): Promise<readonly ContributorEntry[]> {\n    const url = `${GITHUB.REST_BASE_URL}/repos/${owner}/${name}/contributors?per_page=100&anon=true`;\n\n    try {\n      this.apiCallCount++;\n      const response = await fetchWithTimeout(url, {\n        headers: {\n          Authorization: `Bearer ${this.token}`,\n          'User-Agent': 'mcp-researchpowerpack',\n        },\n        timeoutMs: GITHUB.TIMEOUT_MS,\n      });\n\n      if (response.status === 202) {\n        // Stats being computed \u2014 return empty, will degrade gracefully\n        return [];\n      }\n\n      if (!response.ok) {\n        mcpLog('warning', `Contributors fetch failed ${response.status} for ${owner}/${name}`, 'github');\n        return [];\n      }\n\n      const data = (await response.json()) as Array<{ login?: string; contributions?: number }>;\n      if (!Array.isArray(data)) return [];\n\n      return data.map((c) => ({\n        login: String(c.login ?? 'anonymous'),\n        contributions: Number(c.contributions ?? 0),\n      }));\n    } catch (error) {\n      mcpLog('warning', `Contributors error for ${owner}/${name}: ${classifyError(error).message}`, 'github');\n      return [];\n    }\n  }\n\n  // --------------------------------------------------------------------------\n  // REST helper\n  // --------------------------------------------------------------------------\n\n  private async restGet(\n    url: string,\n  ): Promise<{ data: unknown } | { error: StructuredError }> {\n    this.apiCallCount++;\n\n    for (let attempt = 0; attempt <= GITHUB.RETRY_COUNT; attempt++) {\n      try {\n        const response = await fetchWithTimeout(url, {\n          headers: {\n            Authorization: `Bearer ${this.token}`,\n            Accept: 'application/vnd.github+json',\n            'User-Agent': 'mcp-researchpowerpack',\n          },\n          timeoutMs: GITHUB.TIMEOUT_MS,\n        });\n\n        if (!response.ok) {\n          if (RETRYABLE_CODES.has(response.status) && attempt < GITHUB.RETRY_COUNT) {\n            const delay = calculateBackoff(attempt);\n            await sleep(delay);\n            continue;\n          }\n          const text = await response.text().catch(() => '');\n          return { error: classifyError({ status: response.status, message: text }) };\n        }\n\n        return { data: await response.json() };\n      } catch (error) {\n        const structured = classifyError(error);\n        if (structured.retryable && attempt < GITHUB.RETRY_COUNT) {\n          const delay = calculateBackoff(attempt);\n          await sleep(delay);\n          continue;\n        }\n        return { error: structured };\n      }\n    }\n\n    return { error: { code: ErrorCode.UNKNOWN_ERROR, message: 'REST request failed after retries', retryable: false } };\n  }\n}\n\n// ============================================================================\n// GraphQL Response Parser\n// ============================================================================\n\nfunction parseGraphQLResponse(repo: Record<string, unknown>): RepoGraphQLData {\n  const defaultBranch = repo.defaultBranchRef as Record<string, unknown> | null;\n  const target = defaultBranch?.target as Record<string, unknown> | null;\n  const history = target?.history as { totalCount?: number } | null;\n\n  const watchers = repo.watchers as { totalCount?: number } | null;\n  const openIssues = repo.openIssues as { totalCount?: number } | null;\n  const closedIssues = repo.closedIssues as { totalCount?: number } | null;\n  const pullRequests = repo.pullRequests as { totalCount?: number } | null;\n  const releases = repo.releases as { totalCount?: number } | null;\n  const licenseInfo = repo.licenseInfo as { spdxId?: string } | null;\n  const primaryLanguage = repo.primaryLanguage as { name?: string } | null;\n  const topics = repo.repositoryTopics as { nodes?: Array<unknown> } | null;\n  const codeOfConduct = repo.codeOfConduct as { name?: string } | null;\n\n  // CI detection: check if .github/workflows directory has entries\n  const ciCheck = repo.ciCheck as { entries?: Array<unknown> } | null;\n  const hasCI = Array.isArray(ciCheck?.entries) && ciCheck.entries.length > 0;\n\n  // Contributing guide\n  const contributingGuide = repo.contributingGuide as { byteSize?: number } | null;\n  const hasContributing = (contributingGuide?.byteSize ?? 0) > 0;\n\n  // Issue template\n  const issueTemplate = repo.issueTemplate as { entries?: Array<unknown> } | null;\n  const hasIssueTemplate = Array.isArray(issueTemplate?.entries) && issueTemplate.entries.length > 0;\n\n  // PR template\n  const prTemplate = repo.prTemplate as { byteSize?: number } | null;\n  const hasPrTemplate = (prTemplate?.byteSize ?? 0) > 0;\n\n  return {\n    stars: Number(repo.stargazerCount ?? 0),\n    forks: Number(repo.forkCount ?? 0),\n    watchers: watchers?.totalCount ?? 0,\n    openIssues: openIssues?.totalCount ?? 0,\n    closedIssues: closedIssues?.totalCount ?? 0,\n    totalCommits: history?.totalCount ?? 0,\n    totalReleases: releases?.totalCount ?? 0,\n    totalPRs: pullRequests?.totalCount ?? 0,\n    sizeKb: Number(repo.diskUsage ?? 0),\n    language: primaryLanguage?.name ?? null,\n    license: licenseInfo?.spdxId ?? null,\n    archived: Boolean(repo.isArchived),\n    createdAt: String(repo.createdAt ?? ''),\n    pushedAt: String(repo.pushedAt ?? ''),\n    description: repo.description ? String(repo.description) : null,\n    homepage: repo.homepageUrl ? String(repo.homepageUrl) : null,\n    hasCI,\n    hasContributing,\n    hasIssueTemplate,\n    hasPrTemplate,\n    hasCodeOfConduct: (codeOfConduct?.name ?? '').length > 0,\n    hasTopics: (topics?.nodes?.length ?? 0) > 0,\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,60 @@
+/**
+ * Reddit OAuth API Client
+ * Fetches posts and comments sorted by score (most upvoted first)
+ * Implements robust error handling that NEVER crashes
+ */
+interface Post {
+    readonly title: string;
+    readonly author: string;
+    readonly subreddit: string;
+    readonly body: string;
+    readonly score: number;
+    readonly commentCount: number;
+    readonly url: string;
+    readonly created: Date;
+    readonly flair?: string;
+    readonly isNsfw: boolean;
+    readonly isPinned: boolean;
+}
+export interface Comment {
+    readonly author: string;
+    readonly body: string;
+    readonly score: number;
+    readonly depth: number;
+    readonly isOP: boolean;
+}
+export interface PostResult {
+    readonly post: Post;
+    readonly comments: Comment[];
+    readonly actualComments: number;
+}
+interface BatchPostResult {
+    readonly results: Map<string, PostResult | Error>;
+    readonly batchesProcessed: number;
+    readonly totalPosts: number;
+    readonly rateLimitHits: number;
+}
+export declare class RedditClient {
+    private clientId;
+    private clientSecret;
+    private userAgent;
+    constructor(clientId: string, clientSecret: string);
+    /**
+     * Authenticate with Reddit API with retry logic
+     * Uses module-level token cache and promise deduplication to prevent
+     * concurrent auth calls from firing multiple token requests
+     * Returns null on failure instead of throwing
+     */
+    private auth;
+    private performAuth;
+    private parseUrl;
+    /**
+     * Get a single Reddit post with comments
+     * Returns PostResult or throws Error (for use with Promise.allSettled)
+     */
+    getPost(url: string): Promise<PostResult>;
+    getPosts(urls: string[]): Promise<Map<string, PostResult | Error>>;
+    batchGetPosts(urls: string[], fetchComments?: boolean, onBatchComplete?: (batchNum: number, totalBatches: number, processed: number) => void): Promise<BatchPostResult>;
+}
+export {};
+//# sourceMappingURL=reddit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reddit.d.ts","sourceRoot":"","sources":["../../../src/clients/reddit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH,UAAU,IAAI;IACZ,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;IAClD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAoND,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ;IAAU,OAAO,CAAC,YAAY;IAF1D,OAAO,CAAC,SAAS,CAA6D;gBAE1D,QAAQ,EAAE,MAAM,EAAU,YAAY,EAAE,MAAM;IAElE;;;;;OAKG;YACW,IAAI;YAmBJ,WAAW;IAmEzB,OAAO,CAAC,QAAQ;IAKhB;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAkDzC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;IAYlE,aAAa,CACjB,IAAI,EAAE,MAAM,EAAE,EACd,aAAa,UAAO,EACpB,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GACpF,OAAO,CAAC,eAAe,CAAC;CAkC5B"}