@oss-autopilot/core 0.44.17 → 0.45.0

package/dist/commands/dashboard-scripts.js

@@ -132,21 +132,14 @@ export function generateDashboardScripts(stats, monthlyMerged, monthlyClosed, mo
     });`;
     // === Repository Breakdown ===
     const repoChart = (() => {
-        // Filter helper: exclude repos matching excludeRepos/excludeOrgs or below minStars (#216)
-        const { excludeRepos: exRepos = [], excludeOrgs: exOrgs, minStars } = state.config;
+        // Filter helper: exclude repos below minStars (#216)
+        const { minStars } = state.config;
         const starThreshold = minStars ?? 50;
         const shouldExcludeRepo = (repo) => {
-            const repoLower = repo.toLowerCase();
-            if (exRepos.some((r) => r.toLowerCase() === repoLower))
-                return true;
-            if (exOrgs?.some((o) => o.toLowerCase() === repoLower.split('/')[0]))
-                return true;
             const score = (state.repoScores || {})[repo];
             // Fail-closed: repos without cached star data are excluded from charts.
             // Star data is populated by the daily check; repos appear once stars are fetched.
-            if (isBelowMinStars(score?.stargazersCount, starThreshold))
-                return true;
-            return false;
+            return isBelowMinStars(score?.stargazersCount, starThreshold);
         };
         // Sort repos by total PRs (merged + active + closed) and build "Other" bucket
         const allRepoEntries = Object.entries(

package/dist/commands/pr-template.d.ts

@@ -0,0 +1,9 @@
+/**
+ * pr-template command — Fetch a repository's PR description template.
+ *
+ * Usage: oss-autopilot pr-template owner/repo --json
+ */
+import { type PRTemplateResult } from '../core/pr-template.js';
+export declare function runPRTemplate(opts: {
+    repo: string;
+}): Promise<PRTemplateResult>;

package/dist/commands/pr-template.js

@@ -0,0 +1,14 @@
+/**
+ * pr-template command — Fetch a repository's PR description template.
+ *
+ * Usage: oss-autopilot pr-template owner/repo --json
+ */
+import { getOctokit } from '../core/github.js';
+import { requireGitHubToken, splitRepo } from '../core/utils.js';
+import { fetchPRTemplate } from '../core/pr-template.js';
+export async function runPRTemplate(opts) {
+    const { owner, repo } = splitRepo(opts.repo);
+    const token = requireGitHubToken();
+    const octokit = getOctokit(token);
+    return fetchPRTemplate(octokit, owner, repo);
+}

package/dist/commands/startup.js

@@ -8,7 +8,7 @@
  */
 import * as fs from 'fs';
 import { execFile } from 'child_process';
-import { getStateManager, getGitHubToken, getCLIVersion } from '../core/index.js';
+import { getStateManager, getGitHubToken, getCLIVersion, detectGitHubUsername } from '../core/index.js';
 import { errorMessage } from '../core/errors.js';
 import { executeDailyCheck } from './daily.js';
 import { launchDashboardServer } from './dashboard-lifecycle.js';
@@ -128,9 +128,23 @@ export function openInBrowser(url) {
 export async function runStartup() {
     const version = getCLIVersion();
     const stateManager = getStateManager();
-    // 1. Check setup
+    // 1. Check setup — auto-detect if incomplete
+    let autoDetected = false;
     if (!stateManager.isSetupComplete()) {
-        return { version, setupComplete: false };
+        const detectedUsername = await detectGitHubUsername();
+        if (detectedUsername) {
+            try {
+                stateManager.initializeWithDefaults(detectedUsername);
+                autoDetected = true;
+            }
+            catch (err) {
+                console.error(`[STARTUP] Auto-detected username "${detectedUsername}" but failed to save config:`, errorMessage(err));
+                return { version, setupComplete: false };
+            }
+        }
+        else {
+            return { version, setupComplete: false };
+        }
     }
     // 2. Check auth
     const token = getGitHubToken();
@@ -186,6 +200,7 @@ export async function runStartup() {
     return {
         version,
         setupComplete: true,
+        autoDetected,
         daily,
         dashboardUrl,
         dashboardPath,

package/dist/commands/stats.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Stats command
+ * Compute and display contribution statistics.
+ */
+import type { StatsOutput } from '../formatters/json.js';
+export declare function runStats(): Promise<StatsOutput>;
+export declare function formatStatsMarkdown(stats: StatsOutput): string;
+interface BadgeData {
+    schemaVersion: number;
+    label: string;
+    message: string;
+    color: string;
+}
+export declare function formatStatsBadge(stats: StatsOutput): BadgeData;
+export {};

package/dist/commands/stats.js

@@ -0,0 +1,57 @@
+/**
+ * Stats command
+ * Compute and display contribution statistics.
+ */
+import { getStateManager } from '../core/index.js';
+import { computeContributionStats } from '../core/stats.js';
+export async function runStats() {
+    const stateManager = getStateManager();
+    const state = stateManager.getState();
+    const activePRCount = state.lastDigest?.summary?.totalActivePRs ?? 0;
+    const stats = computeContributionStats({
+        repoScores: state.repoScores ?? {},
+        activePRCount,
+    });
+    return {
+        ...stats,
+        mergeRateFormatted: `${(stats.mergeRate * 100).toFixed(1)}%`,
+        username: state.config.githubUsername,
+    };
+}
+export function formatStatsMarkdown(stats) {
+    const lines = [
+        `# OSS Contribution Stats for @${stats.username}`,
+        '',
+        '| Metric | Value |',
+        '|--------|-------|',
+        `| Merged PRs | ${stats.totalMerged} |`,
+        `| Merge Rate | ${stats.mergeRateFormatted} |`,
+        `| Active PRs | ${stats.activePRs} |`,
+        `| Repos Contributed | ${stats.reposContributed} |`,
+        '',
+    ];
+    if (stats.topRepos.length > 0) {
+        lines.push('## Top Repos', '', '| Repo | Merged PRs |', '|------|-----------|');
+        for (const repo of stats.topRepos) {
+            lines.push(`| ${repo.repo} | ${repo.mergedCount} |`);
+        }
+        lines.push('');
+    }
+    lines.push('---', '*Generated by [OSS Autopilot](https://github.com/costajohnt/oss-autopilot)*');
+    return lines.join('\n');
+}
+function pickBadgeColor(stats) {
+    if (stats.totalMerged === 0)
+        return 'blue';
+    if (stats.mergeRate >= 0.8)
+        return 'brightgreen';
+    if (stats.mergeRate >= 0.6)
+        return 'green';
+    if (stats.mergeRate >= 0.4)
+        return 'yellow';
+    return 'orange';
+}
+export function formatStatsBadge(stats) {
+    const message = stats.totalMerged > 0 ? `${stats.mergeRateFormatted} merge rate | ${stats.totalMerged} merged` : 'Getting Started';
+    return { schemaVersion: 1, label: 'OSS Contributions', message, color: pickBadgeColor(stats) };
+}

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

@@ -34,8 +34,6 @@ export declare function fetchUserClosedPRCounts(octokit: Octokit, githubUsername
  */
 export declare function fetchRecentlyClosedPRs(octokit: Octokit, config: {
     githubUsername: string;
-    excludeRepos: string[];
-    excludeOrgs?: string[];
 }, days?: number): Promise<ClosedPR[]>;
 /**
  * Fetch PRs merged in the last N days.
@@ -43,6 +41,4 @@ export declare function fetchRecentlyClosedPRs(octokit: Octokit, config: {
  */
 export declare function fetchRecentlyMergedPRs(octokit: Octokit, config: {
     githubUsername: string;
-    excludeRepos: string[];
-    excludeOrgs?: string[];
 }, days?: number): Promise<MergedPR[]>;

package/dist/core/github-stats.js

@@ -86,8 +86,6 @@ async function fetchUserPRCounts(octokit, githubUsername, query, label, accumula
             // Skip own repos (PRs to your own repos aren't OSS contributions)
             if (isOwnRepo(owner, githubUsername))
                 continue;
-            // Note: excludeRepos/excludeOrgs are intentionally NOT filtered here.
-            // Those filters control issue discovery/search, not historical statistics.
             // Skip repos below the minimum star threshold (#576).
             // Repos with unknown star counts (not yet fetched) are also excluded (fail-closed).
             if (starFilter && isBelowMinStars(starFilter.knownStarCounts.get(repo), starFilter.minStars)) {
@@ -172,8 +170,7 @@ export function fetchUserClosedPRCounts(octokit, githubUsername, starFilter) {
     }, starFilter);
 }
 /**
- * Shared helper: search for recent PRs and filter out own repos, excluded repos/orgs.
- * Returns parsed search results that pass all filters.
+ * Shared helper: search for recent PRs and filter out own repos.
  */
 async function fetchRecentPRs(octokit, config, query, label, days, mapItem) {
     if (!config.githubUsername) {
@@ -201,11 +198,6 @@ async function fetchRecentPRs(octokit, config, query, label, days, mapItem) {
         // Skip own repos
         if (isOwnRepo(parsed.owner, config.githubUsername))
             continue;
-        // Skip excluded repos and orgs
-        if (config.excludeRepos.includes(repo))
-            continue;
-        if (config.excludeOrgs?.some((org) => parsed.owner.toLowerCase() === org.toLowerCase()))
-            continue;
         results.push(mapItem(item, { owner: parsed.owner, repo, number: parsed.number }));
     }
     debug(MODULE, `Found ${results.length} recently ${label} PRs`);

package/dist/core/index.d.ts

@@ -8,9 +8,11 @@ export { IssueDiscovery, type IssueCandidate, type SearchPriority, isDocOnlyIssu
 export { IssueConversationMonitor } from './issue-conversation.js';
 export { isBotAuthor, isAcknowledgmentComment } from './comment-utils.js';
 export { getOctokit, checkRateLimit, type RateLimitInfo } from './github.js';
-export { parseGitHubUrl, daysBetween, splitRepo, isOwnRepo, getCLIVersion, getDataDir, getStatePath, getBackupDir, getCacheDir, getDashboardPath, formatRelativeTime, byDateDescending, getGitHubToken, getGitHubTokenAsync, requireGitHubToken, resetGitHubTokenCache, DEFAULT_CONCURRENCY, } from './utils.js';
+export { parseGitHubUrl, daysBetween, splitRepo, isOwnRepo, getCLIVersion, getDataDir, getStatePath, getBackupDir, getCacheDir, getDashboardPath, formatRelativeTime, byDateDescending, getGitHubToken, getGitHubTokenAsync, requireGitHubToken, resetGitHubTokenCache, detectGitHubUsername, DEFAULT_CONCURRENCY, } from './utils.js';
 export { OssAutopilotError, ConfigurationError, ValidationError, errorMessage, getHttpStatusCode, isRateLimitError, isRateLimitOrAuthError, } from './errors.js';
 export { enableDebug, isDebugEnabled, debug, info, warn, timed } from './logger.js';
 export { HttpCache, getHttpCache, cachedRequest, type CacheEntry } from './http-cache.js';
 export { CRITICAL_STATUSES, computeRepoSignals, groupPRsByRepo, assessCapacity, collectActionableIssues, computeActionMenu, toShelvedPRRef, formatActionHint, formatBriefSummary, formatSummary, printDigest, } from './daily-logic.js';
+export { computeContributionStats, type ContributionStats, type ComputeStatsInput } from './stats.js';
+export { fetchPRTemplate, type PRTemplateResult } from './pr-template.js';
 export * from './types.js';

package/dist/core/index.js

@@ -8,9 +8,11 @@ export { IssueDiscovery, isDocOnlyIssue, applyPerRepoCap, DOC_ONLY_LABELS, } fro
 export { IssueConversationMonitor } from './issue-conversation.js';
 export { isBotAuthor, isAcknowledgmentComment } from './comment-utils.js';
 export { getOctokit, checkRateLimit } from './github.js';
-export { parseGitHubUrl, daysBetween, splitRepo, isOwnRepo, getCLIVersion, getDataDir, getStatePath, getBackupDir, getCacheDir, getDashboardPath, formatRelativeTime, byDateDescending, getGitHubToken, getGitHubTokenAsync, requireGitHubToken, resetGitHubTokenCache, DEFAULT_CONCURRENCY, } from './utils.js';
+export { parseGitHubUrl, daysBetween, splitRepo, isOwnRepo, getCLIVersion, getDataDir, getStatePath, getBackupDir, getCacheDir, getDashboardPath, formatRelativeTime, byDateDescending, getGitHubToken, getGitHubTokenAsync, requireGitHubToken, resetGitHubTokenCache, detectGitHubUsername, DEFAULT_CONCURRENCY, } from './utils.js';
 export { OssAutopilotError, ConfigurationError, ValidationError, errorMessage, getHttpStatusCode, isRateLimitError, isRateLimitOrAuthError, } from './errors.js';
 export { enableDebug, isDebugEnabled, debug, info, warn, timed } from './logger.js';
 export { HttpCache, getHttpCache, cachedRequest } from './http-cache.js';
 export { CRITICAL_STATUSES, computeRepoSignals, groupPRsByRepo, assessCapacity, collectActionableIssues, computeActionMenu, toShelvedPRRef, formatActionHint, formatBriefSummary, formatSummary, printDigest, } from './daily-logic.js';
+export { computeContributionStats } from './stats.js';
+export { fetchPRTemplate } from './pr-template.js';
 export * from './types.js';

package/dist/core/pr-monitor.js

@@ -13,7 +13,7 @@
  */
 import { getOctokit } from './github.js';
 import { getStateManager } from './state.js';
-import { daysBetween, parseGitHubUrl, extractOwnerRepo, DEFAULT_CONCURRENCY } from './utils.js';
+import { daysBetween, parseGitHubUrl, extractOwnerRepo, isOwnRepo, DEFAULT_CONCURRENCY } from './utils.js';
 import { runWorkerPool } from './concurrency.js';
 import { ConfigurationError, ValidationError, errorMessage, getHttpStatusCode } from './errors.js';
 import { paginateAll } from './pagination.js';
@@ -79,7 +79,6 @@ export class PRMonitor {
         // Filter items to only PRs worth fetching
         const prs = [];
         const failures = [];
-        const shelvedUrls = new Set(config.shelvedPRUrls || []);
         const filteredItems = allItems.filter((item) => {
             if (!item.pull_request)
                 return false;
@@ -89,20 +88,11 @@ export class PRMonitor {
                 warn('pr-monitor', `Skipping PR with unparseable URL: ${item.html_url}`);
                 return false;
             }
-            const ownerLower = parsed.owner.toLowerCase();
-            if (ownerLower === config.githubUsername.toLowerCase())
-                return false;
-            const repoFullName = `${parsed.owner}/${parsed.repo}`;
-            // Keep shelved PRs even from excluded repos/orgs — excludeRepos is meant
-            // to stop finding *new* issues there, not hide open PRs already being tracked (#175)
-            const isShelved = shelvedUrls.has(item.html_url);
-            if (config.excludeRepos.includes(repoFullName) && !isShelved)
-                return false;
-            if (config.excludeOrgs?.some((org) => ownerLower === org.toLowerCase()) && !isShelved)
+            if (isOwnRepo(parsed.owner, config.githubUsername))
                 return false;
             return true;
         });
-        debug('pr-monitor', `Filtered to ${filteredItems.length} PRs after excluding own repos, shelved, and excluded orgs/repos`);
+        debug('pr-monitor', `Filtered to ${filteredItems.length} PRs after excluding own repos`);
         // Fetch detailed info using a worker pool for bounded concurrency.
         await timed('pr-monitor', `Fetch details for ${filteredItems.length} PRs`, async () => {
             await runWorkerPool(filteredItems, async (item) => {

package/dist/core/pr-template.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Fetch a repository's PR description template from GitHub.
+ *
+ * Checks the standard template locations in GitHub's priority order:
+ * 1. .github/PULL_REQUEST_TEMPLATE.md
+ * 2. .github/pull_request_template.md
+ * 3. docs/pull_request_template.md
+ * 4. pull_request_template.md (root)
+ *
+ * Returns the decoded template content and the path where it was found,
+ * or null if no template exists.
+ */
+import type { Octokit } from '@octokit/rest';
+export interface PRTemplateResult {
+    /** The decoded template content, or null if no template was found. */
+    template: string | null;
+    /** The path where the template was found (e.g., ".github/PULL_REQUEST_TEMPLATE.md"). */
+    source: string | null;
+    /** If non-null, an error prevented a complete check of all template paths. */
+    error?: string;
+}
+/**
+ * Fetch a repository's PR template by trying each standard location.
+ * Returns on the first successful match. Rate limit and auth errors
+ * propagate to the caller (consistent with project error strategy).
+ */
+export declare function fetchPRTemplate(octokit: Octokit, owner: string, repo: string): Promise<PRTemplateResult>;

package/dist/core/pr-template.js

@@ -0,0 +1,65 @@
+/**
+ * Fetch a repository's PR description template from GitHub.
+ *
+ * Checks the standard template locations in GitHub's priority order:
+ * 1. .github/PULL_REQUEST_TEMPLATE.md
+ * 2. .github/pull_request_template.md
+ * 3. docs/pull_request_template.md
+ * 4. pull_request_template.md (root)
+ *
+ * Returns the decoded template content and the path where it was found,
+ * or null if no template exists.
+ */
+import { debug, warn } from './logger.js';
+import { errorMessage, getHttpStatusCode, isRateLimitOrAuthError } from './errors.js';
+const MODULE = 'pr-template';
+/** Standard paths GitHub checks for PR templates, in priority order. */
+const TEMPLATE_PATHS = [
+    '.github/PULL_REQUEST_TEMPLATE.md',
+    '.github/pull_request_template.md',
+    'docs/pull_request_template.md',
+    'pull_request_template.md',
+];
+/**
+ * Fetch a repository's PR template by trying each standard location.
+ * Returns on the first successful match. Rate limit and auth errors
+ * propagate to the caller (consistent with project error strategy).
+ */
+export async function fetchPRTemplate(octokit, owner, repo) {
+    for (const path of TEMPLATE_PATHS) {
+        try {
+            debug(MODULE, `Checking ${owner}/${repo} for template at ${path}`);
+            const { data } = await octokit.repos.getContent({ owner, repo, path });
+            // getContent returns an array for directories (e.g., multiple templates); we only want files
+            if (Array.isArray(data)) {
+                debug(MODULE, `${path} is a directory (multiple templates?), skipping`);
+                continue;
+            }
+            if (data.type !== 'file') {
+                debug(MODULE, `${path} is type "${data.type}", skipping`);
+                continue;
+            }
+            if (!data.content) {
+                debug(MODULE, `${path} has no content, skipping`);
+                continue;
+            }
+            const template = Buffer.from(data.content, 'base64').toString('utf-8');
+            debug(MODULE, `Found PR template at ${path} (${template.length} chars)`);
+            return { template, source: path };
+        }
+        catch (err) {
+            // 404 = template doesn't exist at this path, try next
+            if (getHttpStatusCode(err) === 404)
+                continue;
+            // Rate limit and auth errors must propagate (project error strategy)
+            if (isRateLimitOrAuthError(err))
+                throw err;
+            // Other errors (500, network) — warn and return with error context
+            const msg = errorMessage(err);
+            warn(MODULE, `Error checking ${owner}/${repo}/${path}: ${msg}`);
+            return { template: null, source: null, error: msg };
+        }
+    }
+    debug(MODULE, `No PR template found for ${owner}/${repo}`);
+    return { template: null, source: null };
+}

package/dist/core/state.d.ts

@@ -51,6 +51,13 @@ export declare class StateManager {
      * Mark setup as complete and record the completion timestamp.
      */
     markSetupComplete(): void;
+    /**
+     * Initialize state with sensible defaults for zero-config onboarding.
+     * Sets the GitHub username, marks setup as complete, and persists.
+     * No-op if setup is already complete (prevents overwriting existing config).
+     * @param username - The GitHub username to configure.
+     */
+    initializeWithDefaults(username: string): void;
     /**
      * Migrate state from legacy ./data/ location to ~/.oss-autopilot/
      * Returns true if migration was performed
@@ -157,16 +164,11 @@ export declare class StateManager {
      */
     private static matchesExclusion;
     /**
-     * Check whether a repository matches any exclusion rule from the current config.
-     * A repo is excluded if it matches an entry in `excludeRepos` (case-insensitive)
-     * or if its owner segment matches an entry in `excludeOrgs` (case-insensitive).
-     * @param repo - Repository in "owner/repo" format.
-     */
-    private isExcluded;
-    /**
-     * Remove repositories matching the given exclusion lists from `trustedProjects`
-     * and `repoScores`. Called when a repo or org is newly excluded to keep stored
-     * data consistent with current filters.
+     * Remove repositories matching the given exclusion lists from `trustedProjects`.
+     * Called when a repo or org is newly excluded.
+     *
+     * Note: `repoScores` are intentionally preserved so historical stats (merge rate,
+     * total merged) remain accurate. Exclusion only affects issue discovery (#591).
      * @param repos - Full "owner/repo" strings to exclude (case-insensitive match).
      * @param orgs  - Org names to exclude (case-insensitive match against owner segment).
      */
@@ -351,9 +353,10 @@ export declare class StateManager {
     getLowScoringRepos(maxScore?: number): string[];
     /**
      * Compute aggregate statistics from the current state. `mergedPRs` and `closedPRs` counts
-     * are summed from repo score records, excluding repos that match `excludeRepos` or `excludeOrgs`
-     * in the config (#211). `totalTracked` reflects the number of non-excluded repositories with
-     * score records.
+     * are summed from repo score records. `totalTracked` reflects the number of repositories with
+     * score records above the minStars threshold.
+     *
+     * Note: `excludeRepos`/`excludeOrgs` only affect issue discovery, not stats (#591).
      * @returns A Stats snapshot computed from the current state.
      */
     getStats(): Stats;
@@ -362,17 +365,17 @@ export declare class StateManager {
  * Aggregate statistics returned by {@link StateManager.getStats}.
  */
 export interface Stats {
-    /** Total merged PRs across scored repositories (excludes repos/orgs in exclusion config). */
+    /** Total merged PRs across scored repositories (above minStars threshold). */
     mergedPRs: number;
-    /** Total PRs closed without merge across scored repositories (excludes repos/orgs in exclusion config). */
+    /** Total PRs closed without merge across scored repositories (above minStars threshold). */
     closedPRs: number;
     /** Number of active issues. Always 0 in v2 (sourced from fresh fetch instead). */
     activeIssues: number;
-    /** Number of trusted projects (excludes repos/orgs in exclusion config). */
+    /** Number of trusted projects. */
     trustedProjects: number;
     /** Merge success rate as a percentage string (e.g. "75.0%"). */
     mergeRate: string;
-    /** Number of scored repositories (excludes repos/orgs in exclusion config). */
+    /** Number of scored repositories (above minStars threshold). */
     totalTracked: number;
     /** Number of PRs needing a response. Always 0 in v2 (sourced from fresh fetch instead). */
     needsResponse: number;

package/dist/core/state.js

@@ -216,6 +216,22 @@ export class StateManager {
         this.state.config.setupComplete = true;
         this.state.config.setupCompletedAt = new Date().toISOString();
     }
+    /**
+     * Initialize state with sensible defaults for zero-config onboarding.
+     * Sets the GitHub username, marks setup as complete, and persists.
+     * No-op if setup is already complete (prevents overwriting existing config).
+     * @param username - The GitHub username to configure.
+     */
+    initializeWithDefaults(username) {
+        if (this.state.config.setupComplete) {
+            debug(MODULE, `Setup already complete, skipping initializeWithDefaults for "${username}"`);
+            return;
+        }
+        this.state.config.githubUsername = username;
+        this.markSetupComplete();
+        debug(MODULE, `Initialized with defaults for user "${username}"`);
+        this.save();
+    }
     /**
      * Migrate state from legacy ./data/ location to ~/.oss-autopilot/
      * Returns true if migration was performed
@@ -617,19 +633,11 @@ export class StateManager {
         return false;
     }
     /**
-     * Check whether a repository matches any exclusion rule from the current config.
-     * A repo is excluded if it matches an entry in `excludeRepos` (case-insensitive)
-     * or if its owner segment matches an entry in `excludeOrgs` (case-insensitive).
-     * @param repo - Repository in "owner/repo" format.
-     */
-    isExcluded(repo) {
-        const { excludeRepos, excludeOrgs } = this.state.config;
-        return StateManager.matchesExclusion(repo, excludeRepos, excludeOrgs);
-    }
-    /**
-     * Remove repositories matching the given exclusion lists from `trustedProjects`
-     * and `repoScores`. Called when a repo or org is newly excluded to keep stored
-     * data consistent with current filters.
+     * Remove repositories matching the given exclusion lists from `trustedProjects`.
+     * Called when a repo or org is newly excluded.
+     *
+     * Note: `repoScores` are intentionally preserved so historical stats (merge rate,
+     * total merged) remain accurate. Exclusion only affects issue discovery (#591).
      * @param repos - Full "owner/repo" strings to exclude (case-insensitive match).
      * @param orgs  - Org names to exclude (case-insensitive match against owner segment).
      */
@@ -638,15 +646,8 @@ export class StateManager {
         const beforeTrusted = this.state.config.trustedProjects.length;
         this.state.config.trustedProjects = this.state.config.trustedProjects.filter((p) => !matches(p));
         const removedTrusted = beforeTrusted - this.state.config.trustedProjects.length;
-        let removedScoreCount = 0;
-        for (const key of Object.keys(this.state.repoScores)) {
-            if (matches(key)) {
-                delete this.state.repoScores[key];
-                removedScoreCount++;
-            }
-        }
-        if (removedTrusted > 0 || removedScoreCount > 0) {
-            debug(MODULE, `Removed ${removedTrusted} trusted project(s) and ${removedScoreCount} repo score(s) for excluded repos/orgs`);
+        if (removedTrusted > 0) {
+            debug(MODULE, `Removed ${removedTrusted} trusted project(s) for excluded repos/orgs`);
         }
     }
     // === Starred Repos Management ===
@@ -1094,19 +1095,17 @@ export class StateManager {
     // === Statistics ===
     /**
      * Compute aggregate statistics from the current state. `mergedPRs` and `closedPRs` counts
-     * are summed from repo score records, excluding repos that match `excludeRepos` or `excludeOrgs`
-     * in the config (#211). `totalTracked` reflects the number of non-excluded repositories with
-     * score records.
+     * are summed from repo score records. `totalTracked` reflects the number of repositories with
+     * score records above the minStars threshold.
+     *
+     * Note: `excludeRepos`/`excludeOrgs` only affect issue discovery, not stats (#591).
      * @returns A Stats snapshot computed from the current state.
      */
     getStats() {
-        // v2: Calculate from repoScores, filtering out excluded repos/orgs (#211)
         let totalMerged = 0;
         let totalClosed = 0;
         let totalTracked = 0;
-        for (const [repoKey, score] of Object.entries(this.state.repoScores)) {
-            if (this.isExcluded(repoKey))
-                continue;
+        for (const score of Object.values(this.state.repoScores)) {
             if (isBelowMinStars(score.stargazersCount, this.state.config.minStars ?? 50))
                 continue;
             totalTracked++;
@@ -1119,7 +1118,7 @@ export class StateManager {
             mergedPRs: totalMerged,
             closedPRs: totalClosed,
             activeIssues: 0,
-            trustedProjects: this.state.config.trustedProjects.filter((p) => !this.isExcluded(p)).length,
+            trustedProjects: this.state.config.trustedProjects.length,
             mergeRate: mergeRate.toFixed(1) + '%',
             totalTracked,
             needsResponse: 0,

package/dist/core/stats.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Contribution statistics computation.
+ * Computes metrics from repo scores and PR data for shareable stats and badges.
+ */
+import type { RepoScore } from './types.js';
+export interface ContributionStats {
+    totalMerged: number;
+    totalClosed: number;
+    mergeRate: number;
+    activePRs: number;
+    reposContributed: number;
+    topRepos: Array<{
+        repo: string;
+        mergedCount: number;
+    }>;
+}
+export interface ComputeStatsInput {
+    repoScores: Record<string, Pick<RepoScore, 'mergedPRCount' | 'closedWithoutMergeCount' | 'repo'>>;
+    activePRCount: number;
+}
+/**
+ * Compute contribution statistics from repo score data.
+ * Pure function — no side effects, no API calls.
+ */
+export declare function computeContributionStats(input: ComputeStatsInput): ContributionStats;

package/dist/core/stats.js

@@ -0,0 +1,33 @@
+/**
+ * Contribution statistics computation.
+ * Computes metrics from repo scores and PR data for shareable stats and badges.
+ */
+const MAX_TOP_REPOS = 10;
+/**
+ * Compute contribution statistics from repo score data.
+ * Pure function — no side effects, no API calls.
+ */
+export function computeContributionStats(input) {
+    const { repoScores, activePRCount } = input;
+    let totalMerged = 0;
+    let totalClosed = 0;
+    const repoEntries = [];
+    for (const score of Object.values(repoScores)) {
+        totalMerged += score.mergedPRCount;
+        totalClosed += score.closedWithoutMergeCount;
+        if (score.mergedPRCount > 0) {
+            repoEntries.push({ repo: score.repo, mergedCount: score.mergedPRCount });
+        }
+    }
+    const total = totalMerged + totalClosed;
+    const mergeRate = total > 0 ? totalMerged / total : 0;
+    repoEntries.sort((a, b) => b.mergedCount - a.mergedCount);
+    return {
+        totalMerged,
+        totalClosed,
+        mergeRate,
+        activePRs: activePRCount,
+        reposContributed: repoEntries.length,
+        topRepos: repoEntries.slice(0, MAX_TOP_REPOS),
+    };
+}

package/dist/core/types.d.ts

@@ -437,9 +437,9 @@ export interface AgentConfig {
     languages: string[];
     /** GitHub labels to filter issues by (e.g., `["good first issue", "help wanted"]`). */
     labels: string[];
-    /** Repos to exclude from search and stats, in `"owner/repo"` format. */
+    /** Repos to exclude from issue discovery/search, in `"owner/repo"` format. */
     excludeRepos: string[];
-    /** Organizations to exclude from search and stats (case-insensitive match on owner segment). */
+    /** Organizations to exclude from issue discovery/search (case-insensitive match on owner segment). */
     excludeOrgs?: string[];
     /** Repos where the contributor has had PRs merged. Used for prioritization. */
     trustedProjects: string[];

package/dist/core/utils.d.ts

@@ -255,4 +255,20 @@ export declare function resetGitHubTokenCache(): void;
  * }
  */
 export declare function getGitHubTokenAsync(): Promise<string | null>;
+/**
+ * Detect the authenticated GitHub username via the `gh` CLI.
+ *
+ * Runs `gh api user --jq '.login'` asynchronously and validates the result
+ * against GitHub's username rules. Never throws — returns `null` on any failure
+ * (gh not installed, not authenticated, invalid output, etc.).
+ *
+ * @returns The GitHub username string, or `null` if detection fails
+ *
+ * @example
+ * const username = await detectGitHubUsername();
+ * if (username) {
+ *   console.log(`Logged in as ${username}`);
+ * }
+ */
+export declare function detectGitHubUsername(): Promise<string | null>;
 export {};