@oss-autopilot/core 0.42.0 → 0.42.1

package/dist/cli.js

@@ -10,7 +10,8 @@
  * async token fetch to avoid blocking the event loop on `gh auth token`.
  */
 import { Command } from 'commander';
-import { getGitHubTokenAsync, enableDebug, debug, formatRelativeTime } from './core/index.js';
+import { getGitHubTokenAsync, enableDebug, debug, formatRelativeTime, getCLIVersion } from './core/index.js';
+import { errorMessage } from './core/errors.js';
 import { outputJson, outputJsonError } from './formatters/json.js';
 /** Print local repos in human-readable format */
 function printRepos(repos) {
@@ -23,7 +24,7 @@ function printRepos(repos) {
 }
 /** Shared error handler for CLI action catch blocks. */
 function handleCommandError(err, json) {
-    const msg = err instanceof Error ? err.message : String(err);
+    const msg = errorMessage(err);
     if (json) {
         outputJsonError(msg);
     }
@@ -32,20 +33,7 @@ function handleCommandError(err, json) {
     }
     process.exit(1);
 }
-const VERSION = (() => {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const fs = require('fs');
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const path = require('path');
-        const pkgPath = path.join(path.dirname(process.argv[1]), '..', 'package.json');
-        return JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version;
-    }
-    catch (_err) {
-        // package.json may not be readable in all bundle/install configurations — fall back to safe default
-        return '0.0.0';
-    }
-})();
+const VERSION = getCLIVersion();
 // Commands that skip the preAction GitHub token check.
 // startup handles auth internally (returns authError in JSON instead of process.exit).
 const LOCAL_ONLY_COMMANDS = [

package/dist/commands/check-integration.js

@@ -5,6 +5,7 @@
 import * as path from 'path';
 import { execFileSync } from 'child_process';
 import { debug } from '../core/index.js';
+import { errorMessage } from '../core/errors.js';
 /** File extensions we consider "code" that should be imported/referenced */
 const CODE_EXTENSIONS = new Set([
     '.ts',
@@ -76,7 +77,7 @@ export async function runCheckIntegration(options) {
         newFiles = output ? output.split('\n').filter(Boolean) : [];
     }
     catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = errorMessage(error);
         throw new Error(`Failed to run git diff: ${msg}`, { cause: error });
     }
     // Filter to code files, excluding tests, configs, etc.
@@ -133,9 +134,9 @@ export async function runCheckIntegration(options) {
             }
             catch (error) {
                 // git grep exit code 1 = no matches (expected), exit code 2+ = real error
-                const exitCode = error && typeof error === 'object' && 'status' in error ? error.status : null;
-                if (exitCode !== null && exitCode !== 1) {
-                    const msg = error instanceof Error ? error.message : String(error);
+                const exitCode = error && typeof error === 'object' && 'status' in error ? error.status : undefined;
+                if (exitCode !== undefined && exitCode !== 1) {
+                    const msg = errorMessage(error);
                     debug('check-integration', `git grep failed for "${pattern}": ${msg}`);
                 }
             }

package/dist/commands/comments.js

@@ -18,30 +18,30 @@ export async function runComments(options) {
     const { owner, repo, number: pull_number } = parsed;
     // Get PR details
     const { data: pr } = await octokit.pulls.get({ owner, repo, pull_number });
-    // Get review comments (inline code comments)
-    const reviewComments = await paginateAll((page) => octokit.pulls.listReviewComments({
-        owner,
-        repo,
-        pull_number,
-        per_page: 100,
-        page,
-    }));
-    // Get issue comments (general PR discussion)
-    const issueComments = await paginateAll((page) => octokit.issues.listComments({
-        owner,
-        repo,
-        issue_number: pull_number,
-        per_page: 100,
-        page,
-    }));
-    // Get reviews
-    const reviews = await paginateAll((page) => octokit.pulls.listReviews({
-        owner,
-        repo,
-        pull_number,
-        per_page: 100,
-        page,
-    }));
+    // Fetch review comments, issue comments, and reviews in parallel
+    const [reviewComments, issueComments, reviews] = await Promise.all([
+        paginateAll((page) => octokit.pulls.listReviewComments({
+            owner,
+            repo,
+            pull_number,
+            per_page: 100,
+            page,
+        })),
+        paginateAll((page) => octokit.issues.listComments({
+            owner,
+            repo,
+            issue_number: pull_number,
+            per_page: 100,
+            page,
+        })),
+        paginateAll((page) => octokit.pulls.listReviews({
+            owner,
+            repo,
+            pull_number,
+            per_page: 100,
+            page,
+        })),
+    ]);
     // Filter out own comments, optionally show bots
     const username = stateManager.getState().config.githubUsername;
     const filterComment = (c) => {

package/dist/commands/daily.js

@@ -7,6 +7,7 @@
  * orchestration layer that wires up the phases and handles I/O.
  */
 import { getStateManager, PRMonitor, IssueConversationMonitor, requireGitHubToken, CRITICAL_STATUSES, computeRepoSignals, groupPRsByRepo, assessCapacity, collectActionableIssues, computeActionMenu, toShelvedPRRef, formatBriefSummary, formatSummary, } from '../core/index.js';
+import { errorMessage } from '../core/errors.js';
 import { deduplicateDigest, compactActionableIssues, compactRepoGroups, } from '../formatters/json.js';
 // Re-export domain functions so existing consumers (tests, dashboard, startup)
 // can continue importing from './daily.js' without changes.
@@ -33,15 +34,15 @@ async function fetchPRData(prMonitor, token) {
         prMonitor.fetchUserMergedPRCounts(),
         prMonitor.fetchUserClosedPRCounts(),
         prMonitor.fetchRecentlyClosedPRs().catch((err) => {
-            console.error(`Warning: Failed to fetch recently closed PRs: ${err instanceof Error ? err.message : err}`);
+            console.error(`Warning: Failed to fetch recently closed PRs: ${errorMessage(err)}`);
             return [];
         }),
         prMonitor.fetchRecentlyMergedPRs().catch((err) => {
-            console.error(`Warning: Failed to fetch recently merged PRs: ${err instanceof Error ? err.message : err}`);
+            console.error(`Warning: Failed to fetch recently merged PRs: ${errorMessage(err)}`);
             return [];
         }),
         issueMonitor.fetchCommentedIssues().catch((error) => {
-            const msg = error instanceof Error ? error.message : String(error);
+            const msg = errorMessage(error);
             if (msg.includes('No GitHub username configured')) {
                 console.error(`[DAILY] Issue conversation tracking requires setup: ${msg}`);
             }
@@ -103,7 +104,7 @@ async function updateRepoScores(prMonitor, prs, mergedCounts, closedCounts) {
         }
         catch (error) {
             mergedCountFailures++;
-            console.error(`[DAILY] Failed to update merged count for ${repo}:`, error instanceof Error ? error.message : error);
+            console.error(`[DAILY] Failed to update merged count for ${repo}:`, errorMessage(error));
         }
     }
     if (mergedCountFailures === mergedCounts.size && mergedCounts.size > 0) {
@@ -123,7 +124,7 @@ async function updateRepoScores(prMonitor, prs, mergedCounts, closedCounts) {
         }
         catch (error) {
             closedCountFailures++;
-            console.error(`[DAILY] Failed to update closed count for ${repo}:`, error instanceof Error ? error.message : error);
+            console.error(`[DAILY] Failed to update closed count for ${repo}:`, errorMessage(error));
         }
     }
     if (closedCountFailures === closedCounts.size && closedCounts.size > 0) {
@@ -142,7 +143,7 @@ async function updateRepoScores(prMonitor, prs, mergedCounts, closedCounts) {
         }
         catch (error) {
             signalUpdateFailures++;
-            console.error(`[DAILY] Failed to update signals for ${repo}:`, error instanceof Error ? error.message : error);
+            console.error(`[DAILY] Failed to update signals for ${repo}:`, errorMessage(error));
         }
     }
     if (signalUpdateFailures === repoSignals.size && repoSignals.size > 0) {
@@ -155,7 +156,7 @@ async function updateRepoScores(prMonitor, prs, mergedCounts, closedCounts) {
         starCounts = await prMonitor.fetchRepoStarCounts(allRepos);
     }
     catch (error) {
-        console.error('[DAILY] Failed to fetch repo star counts:', error instanceof Error ? error.message : error);
+        console.error('[DAILY] Failed to fetch repo star counts:', errorMessage(error));
         console.error('[DAILY] Dashboard minStars filter will use cached star counts (or be skipped for repos without cached data).');
         starCounts = new Map();
     }
@@ -166,7 +167,7 @@ async function updateRepoScores(prMonitor, prs, mergedCounts, closedCounts) {
         }
         catch (error) {
             starUpdateFailures++;
-            console.error(`[DAILY] Failed to update star count for ${repo}:`, error instanceof Error ? error.message : error);
+            console.error(`[DAILY] Failed to update star count for ${repo}:`, errorMessage(error));
         }
     }
     if (starUpdateFailures === starCounts.size && starCounts.size > 0) {
@@ -180,7 +181,7 @@ async function updateRepoScores(prMonitor, prs, mergedCounts, closedCounts) {
         }
         catch (error) {
             trustSyncFailures++;
-            console.error(`[DAILY] Failed to sync trusted project ${repo}:`, error instanceof Error ? error.message : error);
+            console.error(`[DAILY] Failed to sync trusted project ${repo}:`, errorMessage(error));
         }
     }
     if (trustSyncFailures === mergedCounts.size && mergedCounts.size > 0) {
@@ -199,13 +200,13 @@ function updateAnalytics(prs, monthlyCounts, monthlyClosedCounts, openedFromMerg
         stateManager.setMonthlyMergedCounts(monthlyCounts);
     }
     catch (error) {
-        console.error('[DAILY] Failed to store monthly merged counts:', error instanceof Error ? error.message : error);
+        console.error('[DAILY] Failed to store monthly merged counts:', errorMessage(error));
     }
     try {
         stateManager.setMonthlyClosedCounts(monthlyClosedCounts);
     }
     catch (error) {
-        console.error('[DAILY] Failed to store monthly closed counts:', error instanceof Error ? error.message : error);
+        console.error('[DAILY] Failed to store monthly closed counts:', errorMessage(error));
     }
     try {
         // Build combined monthly opened counts from merged + closed + currently-open PRs
@@ -223,7 +224,7 @@ function updateAnalytics(prs, monthlyCounts, monthlyClosedCounts, openedFromMerg
         stateManager.setMonthlyOpenedCounts(combinedOpenedCounts);
     }
     catch (error) {
-        console.error('[DAILY] Failed to compute/store monthly opened counts:', error instanceof Error ? error.message : error);
+        console.error('[DAILY] Failed to compute/store monthly opened counts:', errorMessage(error));
     }
 }
 /**
@@ -246,7 +247,7 @@ function partitionPRs(prMonitor, prs, recentlyClosedPRs, recentlyMergedPRs) {
         }
     }
     catch (error) {
-        console.error('[DAILY] Failed to expire/persist snoozes:', error instanceof Error ? error.message : error);
+        console.error('[DAILY] Failed to expire/persist snoozes:', errorMessage(error));
     }
     // Partition PRs into active vs shelved, auto-unshelving when maintainers engage
     const shelvedPRs = [];

package/dist/commands/dashboard-data.js

@@ -4,6 +4,7 @@
  * Separates data concerns from template generation and command orchestration.
  */
 import { getStateManager, PRMonitor, IssueConversationMonitor } from '../core/index.js';
+import { errorMessage } from '../core/errors.js';
 import { toShelvedPRRef } from './daily.js';
 /**
  * Fetch fresh dashboard data from GitHub.
@@ -17,17 +18,17 @@ export async function fetchDashboardData(token) {
     const [{ prs, failures }, recentlyClosedPRs, recentlyMergedPRs, mergedResult, closedResult, fetchedIssues] = await Promise.all([
         prMonitor.fetchUserOpenPRs(),
         prMonitor.fetchRecentlyClosedPRs().catch((err) => {
-            console.error(`Warning: Failed to fetch recently closed PRs: ${err instanceof Error ? err.message : err}`);
+            console.error(`Warning: Failed to fetch recently closed PRs: ${errorMessage(err)}`);
             return [];
         }),
         prMonitor.fetchRecentlyMergedPRs().catch((err) => {
-            console.error(`Warning: Failed to fetch recently merged PRs: ${err instanceof Error ? err.message : err}`);
+            console.error(`Warning: Failed to fetch recently merged PRs: ${errorMessage(err)}`);
             return [];
         }),
         prMonitor.fetchUserMergedPRCounts(),
         prMonitor.fetchUserClosedPRCounts(),
         issueMonitor.fetchCommentedIssues().catch((error) => {
-            const msg = error instanceof Error ? error.message : String(error);
+            const msg = errorMessage(error);
             if (msg.includes('No GitHub username configured')) {
                 console.error(`[DASHBOARD] Issue conversation tracking requires setup: ${msg}`);
             }
@@ -54,13 +55,13 @@ export async function fetchDashboardData(token) {
         stateManager.setMonthlyMergedCounts(monthlyCounts);
     }
     catch (error) {
-        console.error('[DASHBOARD] Failed to store monthly merged counts:', error instanceof Error ? error.message : error);
+        console.error('[DASHBOARD] Failed to store monthly merged counts:', errorMessage(error));
     }
     try {
         stateManager.setMonthlyClosedCounts(monthlyClosedCounts);
     }
     catch (error) {
-        console.error('[DASHBOARD] Failed to store monthly closed counts:', error instanceof Error ? error.message : error);
+        console.error('[DASHBOARD] Failed to store monthly closed counts:', errorMessage(error));
     }
     try {
         const combinedOpenedCounts = { ...openedFromMerged };
@@ -76,7 +77,7 @@ export async function fetchDashboardData(token) {
         stateManager.setMonthlyOpenedCounts(combinedOpenedCounts);
     }
     catch (error) {
-        console.error('[DASHBOARD] Failed to store monthly opened counts:', error instanceof Error ? error.message : error);
+        console.error('[DASHBOARD] Failed to store monthly opened counts:', errorMessage(error));
     }
     const digest = prMonitor.generateDigest(prs, recentlyClosedPRs, recentlyMergedPRs);
     // Apply shelve partitioning for display (auto-unshelve only runs in daily check)

package/dist/commands/dashboard-server.js

@@ -9,6 +9,7 @@ import * as http from 'http';
 import * as fs from 'fs';
 import * as path from 'path';
 import { getStateManager, getGitHubToken } from '../core/index.js';
+import { errorMessage } from '../core/errors.js';
 import { fetchDashboardData, computePRsByRepo, computeTopRepos, getMonthlyData } from './dashboard-data.js';
 import { buildDashboardStats } from './dashboard-templates.js';
 // ── Constants ────────────────────────────────────────────────────────────────
@@ -203,7 +204,7 @@ export async function startDashboardServer(options) {
         }
         catch (error) {
             console.error('Action failed:', body.action, body.url, error);
-            sendError(res, 500, `Action failed: ${error instanceof Error ? error.message : String(error)}`);
+            sendError(res, 500, `Action failed: ${errorMessage(error)}`);
             return;
         }
         // Rebuild dashboard data from cached digest + updated state
@@ -229,7 +230,7 @@ export async function startDashboardServer(options) {
         }
         catch (error) {
             console.error('Dashboard refresh failed:', error);
-            sendError(res, 500, `Refresh failed: ${error instanceof Error ? error.message : String(error)}`);
+            sendError(res, 500, `Refresh failed: ${errorMessage(error)}`);
         }
     }
     // ── Static file serving ──────────────────────────────────────────────────

package/dist/commands/dashboard.js

@@ -7,6 +7,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { execFile } from 'child_process';
 import { getStateManager, getDashboardPath, getGitHubToken } from '../core/index.js';
+import { errorMessage } from '../core/errors.js';
 import { outputJson } from '../formatters/json.js';
 import { fetchDashboardData, computePRsByRepo, computeTopRepos, getMonthlyData } from './dashboard-data.js';
 import { buildDashboardStats, generateDashboardHtml } from './dashboard-templates.js';
@@ -39,7 +40,7 @@ export async function runDashboard(options) {
             commentedIssues = result.commentedIssues;
         }
         catch (error) {
-            console.error('Failed to fetch fresh data:', error instanceof Error ? error.message : error);
+            console.error('Failed to fetch fresh data:', errorMessage(error));
             console.error('Falling back to cached data (issue conversations unavailable)...');
             digest = stateManager.getState().lastDigest;
         }

package/dist/commands/local-repos.js

@@ -7,6 +7,7 @@ import * as path from 'path';
 import * as os from 'os';
 import { execFileSync } from 'child_process';
 import { getStateManager, debug } from '../core/index.js';
+import { errorMessage } from '../core/errors.js';
 /** Default directories to scan for local clones */
 const DEFAULT_SCAN_PATHS = [
     path.join(os.homedir(), 'Documents', 'oss'),
@@ -115,7 +116,7 @@ export async function runLocalRepos(options) {
         stateManager.save();
     }
     catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = errorMessage(error);
         debug('local-repos', `Failed to cache scan results: ${msg}`);
     }
     return {

package/dist/commands/parse-list.js

@@ -4,6 +4,7 @@
  */
 import * as fs from 'fs';
 import * as path from 'path';
+import { errorMessage } from '../core/errors.js';
 /** Extract GitHub issue/PR URLs from a markdown line */
 function extractGitHubUrl(line) {
     const match = line.match(/https:\/\/github\.com\/([^/]+\/[^/]+)\/issues\/(\d+)/);
@@ -100,7 +101,7 @@ export async function runParseList(options) {
         content = fs.readFileSync(filePath, 'utf-8');
     }
     catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = errorMessage(error);
         throw new Error(`Failed to read file: ${msg}`, { cause: error });
     }
     return parseIssueList(content);

package/dist/commands/startup.js

@@ -7,21 +7,11 @@
  * `node cli.bundle.cjs startup --json` call, reducing UI noise in Claude Code.
  */
 import * as fs from 'fs';
-import * as path from 'path';
 import { execFile } from 'child_process';
-import { getStateManager, getGitHubToken } from '../core/index.js';
+import { getStateManager, getGitHubToken, getCLIVersion } from '../core/index.js';
+import { errorMessage } from '../core/errors.js';
 import { executeDailyCheck } from './daily.js';
 import { writeDashboardFromState } from './dashboard.js';
-function getVersion() {
-    try {
-        const pkgPath = path.join(path.dirname(process.argv[1]), '..', 'package.json');
-        return JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version;
-    }
-    catch (error) {
-        console.error('[STARTUP] Failed to detect CLI version:', error instanceof Error ? error.message : error);
-        return '0.0.0';
-    }
-}
 /**
  * Parse issueListPath from a config file's YAML frontmatter.
  * Returns the path string or undefined if not found.
@@ -75,7 +65,7 @@ export function detectIssueList() {
             }
         }
         catch (error) {
-            console.error('[STARTUP] Failed to read config:', error instanceof Error ? error.message : error);
+            console.error('[STARTUP] Failed to read config:', errorMessage(error));
         }
     }
     // 2. Probe known paths
@@ -98,7 +88,7 @@ export function detectIssueList() {
         return { path: issueListPath, source, availableCount, completedCount };
     }
     catch (error) {
-        console.error(`[STARTUP] Failed to read issue list at ${issueListPath}:`, error instanceof Error ? error.message : error);
+        console.error(`[STARTUP] Failed to read issue list at ${issueListPath}:`, errorMessage(error));
         return { path: issueListPath, source, availableCount: 0, completedCount: 0 };
     }
 }
@@ -122,7 +112,7 @@ function openInBrowser(filePath) {
  * Errors from the daily check propagate to the caller.
  */
 export async function runStartup() {
-    const version = getVersion();
+    const version = getCLIVersion();
     const stateManager = getStateManager();
     // 1. Check setup
     if (!stateManager.isSetupComplete()) {
@@ -151,7 +141,7 @@ export async function runStartup() {
         }
     }
     catch (error) {
-        console.error('[STARTUP] Dashboard generation failed:', error instanceof Error ? error.message : error);
+        console.error('[STARTUP] Dashboard generation failed:', errorMessage(error));
     }
     // Append dashboard status to brief summary (only startup opens the browser, not daily)
     if (dashboardOpened) {

package/dist/commands/validation.js

@@ -21,7 +21,7 @@ export function validateGitHubUrl(url, pattern, entityType) {
     if (pattern.test(url))
         return;
     const example = entityType === 'PR' ? 'https://github.com/owner/repo/pull/123' : 'https://github.com/owner/repo/issues/123';
-    throw new Error(`Invalid ${entityType} URL: ${url}. Expected format: ${example}`);
+    throw new ValidationError(`Invalid ${entityType} URL: ${url}. Expected format: ${example}`);
 }
 /**
  * Validate that a URL does not exceed the maximum allowed length.
@@ -29,7 +29,7 @@ export function validateGitHubUrl(url, pattern, entityType) {
  */
 export function validateUrl(url) {
     if (url.length > MAX_URL_LENGTH) {
-        throw new Error(`URL exceeds maximum length of ${MAX_URL_LENGTH} characters`);
+        throw new ValidationError(`URL exceeds maximum length of ${MAX_URL_LENGTH} characters`);
     }
     return url;
 }
@@ -39,7 +39,7 @@ export function validateUrl(url) {
  */
 export function validatePRNumber(num) {
     if (!Number.isInteger(num) || num < 1 || num > MAX_PR_NUMBER) {
-        throw new Error(`PR number must be a positive integer up to ${MAX_PR_NUMBER}`);
+        throw new ValidationError(`PR number must be a positive integer up to ${MAX_PR_NUMBER}`);
     }
     return num;
 }
@@ -49,7 +49,7 @@ export function validatePRNumber(num) {
  */
 export function validateMessage(message) {
     if (message.length > MAX_MESSAGE_LENGTH) {
-        throw new Error(`Message exceeds maximum length of ${MAX_MESSAGE_LENGTH} characters`);
+        throw new ValidationError(`Message exceeds maximum length of ${MAX_MESSAGE_LENGTH} characters`);
     }
     return message;
 }
@@ -59,7 +59,7 @@ export function validateMessage(message) {
  */
 export function validateRepoIdentifier(repo) {
     if (!REPO_PATTERN.test(repo)) {
-        throw new Error(`Invalid repository format: "${repo}". Expected "owner/repo".`);
+        throw new ValidationError(`Invalid repository format: "${repo}". Expected "owner/repo".`);
     }
     return repo;
 }

package/dist/core/errors.d.ts

@@ -22,3 +22,12 @@ export declare class ConfigurationError extends OssAutopilotError {
 export declare class ValidationError extends OssAutopilotError {
     constructor(message: string);
 }
+/**
+ * Extract a human-readable message from an unknown error value.
+ */
+export declare function errorMessage(e: unknown): string;
+/**
+ * Safely extract an HTTP status code from an unknown error (e.g. Octokit errors).
+ * Returns undefined if the error doesn't have a numeric `status` property.
+ */
+export declare function getHttpStatusCode(error: unknown): number | undefined;

package/dist/core/errors.js

@@ -32,3 +32,20 @@ export class ValidationError extends OssAutopilotError {
         this.name = 'ValidationError';
     }
 }
+/**
+ * Extract a human-readable message from an unknown error value.
+ */
+export function errorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+/**
+ * Safely extract an HTTP status code from an unknown error (e.g. Octokit errors).
+ * Returns undefined if the error doesn't have a numeric `status` property.
+ */
+export function getHttpStatusCode(error) {
+    if (error && typeof error === 'object' && 'status' in error) {
+        const status = error.status;
+        return typeof status === 'number' && Number.isFinite(status) ? status : undefined;
+    }
+    return undefined;
+}

package/dist/core/github-stats.d.ts

@@ -4,35 +4,28 @@
  */
 import { Octokit } from '@octokit/rest';
 import { ClosedPR, MergedPR } from './types.js';
+/** TTL for cached PR count results (1 hour). */
+export declare const PR_COUNTS_CACHE_TTL_MS: number;
+/** Return type shared by both merged and closed PR count functions. */
+export interface PRCountsResult<R> {
+    repos: Map<string, R>;
+    monthlyCounts: Record<string, number>;
+    monthlyOpenedCounts: Record<string, number>;
+    dailyActivityCounts: Record<string, number>;
+}
 /**
  * Fetch merged PR counts and latest merge dates per repository for the configured user.
  * Also builds a monthly histogram of all merges for the contribution timeline.
  */
-export declare function fetchUserMergedPRCounts(octokit: Octokit, githubUsername: string): Promise<{
-    repos: Map<string, {
-        count: number;
-        lastMergedAt: string;
-    }>;
-    monthlyCounts: Record<string, number>;
-    monthlyOpenedCounts: Record<string, number>;
-    dailyActivityCounts: Record<string, number>;
-}>;
+export declare function fetchUserMergedPRCounts(octokit: Octokit, githubUsername: string): Promise<PRCountsResult<{
+    count: number;
+    lastMergedAt: string;
+}>>;
 /**
  * Fetch closed-without-merge PR counts per repository for the configured user.
  * Used to populate closedWithoutMergeCount in repo scores for accurate merge rate.
  */
-export declare function fetchUserClosedPRCounts(octokit: Octokit, githubUsername: string): Promise<{
-    repos: Map<string, number>;
-    monthlyCounts: Record<string, number>;
-    monthlyOpenedCounts: Record<string, number>;
-    dailyActivityCounts: Record<string, number>;
-}>;
-/**
- * Fetch GitHub star counts for a list of repositories.
- * Used to populate stargazersCount in repo scores for dashboard filtering by minStars.
- * Fetches concurrently with per-repo error isolation (missing/private repos are skipped).
- */
-export declare function fetchRepoStarCounts(octokit: Octokit, repos: string[]): Promise<Map<string, number>>;
+export declare function fetchUserClosedPRCounts(octokit: Octokit, githubUsername: string): Promise<PRCountsResult<number>>;
 /**
  * Shared helper: search for recent PRs and filter out own repos, excluded repos/orgs.
  * Returns parsed search results that pass all filters.