@oss-autopilot/core 0.42.0 → 0.42.2

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 = [
@@ -727,23 +715,23 @@ program
 });
 // Dismiss command
 program
-    .command('dismiss <issue-url>')
-    .description('Dismiss issue reply notifications (resurfaces on new activity)')
+    .command('dismiss <url>')
+    .description('Dismiss notifications for an issue or PR (resurfaces on new activity)')
     .option('--json', 'Output as JSON')
-    .action(async (issueUrl, options) => {
+    .action(async (url, options) => {
     try {
         const { runDismiss } = await import('./commands/dismiss.js');
-        const data = await runDismiss({ issueUrl });
+        const data = await runDismiss({ url });
         if (options.json) {
             outputJson(data);
         }
         else if (data.dismissed) {
-            console.log(`Dismissed: ${issueUrl}`);
-            console.log('Issue reply notifications are now muted.');
+            console.log(`Dismissed: ${url}`);
+            console.log('Notifications are now muted.');
             console.log('New responses after this point will resurface automatically.');
         }
         else {
-            console.log('Issue is already dismissed.');
+            console.log('Already dismissed.');
         }
     }
     catch (err) {
@@ -752,22 +740,22 @@ program
 });
 // Undismiss command
 program
-    .command('undismiss <issue-url>')
-    .description('Undismiss an issue (re-enable reply notifications)')
+    .command('undismiss <url>')
+    .description('Undismiss an issue or PR (re-enable notifications)')
     .option('--json', 'Output as JSON')
-    .action(async (issueUrl, options) => {
+    .action(async (url, options) => {
     try {
         const { runUndismiss } = await import('./commands/dismiss.js');
-        const data = await runUndismiss({ issueUrl });
+        const data = await runUndismiss({ url });
         if (options.json) {
             outputJson(data);
         }
         else if (data.undismissed) {
-            console.log(`Undismissed: ${issueUrl}`);
-            console.log('Issue reply notifications are active again.');
+            console.log(`Undismissed: ${url}`);
+            console.log('Notifications are active again.');
         }
         else {
-            console.log('Issue was not dismissed.');
+            console.log('Was not dismissed.');
         }
     }
     catch (err) {

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.d.ts

@@ -16,7 +16,6 @@ export { computeRepoSignals, groupPRsByRepo, assessCapacity, collectActionableIs
  */
 export interface DailyCheckResult {
     digest: DailyDigest;
-    updates: unknown[];
     capacity: CapacityAssessment;
     summary: string;
     briefSummary: string;

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 = [];
@@ -326,14 +327,16 @@ function generateDigestOutput(digest, activePRs, shelvedPRs, commentedIssues, fa
     const issueResponses = filteredCommentedIssues.filter((i) => i.status === 'new_response');
     const summary = formatSummary(digest, capacity, issueResponses);
     const snoozedUrls = new Set(Object.keys(stateManager.getState().config.snoozedPRs ?? {}).filter((url) => stateManager.isSnoozed(url)));
-    const actionableIssues = collectActionableIssues(activePRs, snoozedUrls);
+    // Filter dismissed PR URLs from actionable issues (#416)
+    const dismissedUrls = new Set(Object.keys(stateManager.getState().config.dismissedIssues ?? {}));
+    const nonDismissedPRs = activePRs.filter((pr) => !dismissedUrls.has(pr.url));
+    const actionableIssues = collectActionableIssues(nonDismissedPRs, snoozedUrls);
     digest.summary.totalNeedingAttention = actionableIssues.length;
     const briefSummary = formatBriefSummary(digest, actionableIssues.length, issueResponses.length);
     const actionMenu = computeActionMenu(actionableIssues, capacity, filteredCommentedIssues);
     const repoGroups = groupPRsByRepo(activePRs);
     return {
         digest,
-        updates: [],
         capacity,
         summary,
         briefSummary,
@@ -355,7 +358,6 @@ function generateDigestOutput(digest, activePRs, shelvedPRs, commentedIssues, fa
 function toDailyOutput(result) {
     return {
         digest: deduplicateDigest(result.digest),
-        updates: result.updates,
         capacity: result.capacity,
         summary: result.summary,
         briefSummary: result.briefSummary,

package/dist/commands/dashboard-components.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Reusable HTML component generators for the dashboard:
+ * SVG icons, truncateTitle, renderHealthItems, titleMeta.
+ */
+import type { FetchedPR } from '../core/types.js';
+/** SVG path constants for health item icons. */
+export declare const SVG_ICONS: {
+    comment: string;
+    edit: string;
+    xCircle: string;
+    conflict: string;
+    checklist: string;
+    file: string;
+    checkCircle: string;
+    clock: string;
+    lock: string;
+    infoCircle: string;
+    refresh: string;
+    box: string;
+    bell: string;
+    gitMerge: string;
+};
+export declare function truncateTitle(title: string, max?: number): string;
+/**
+ * Render health status items. labelFn output is automatically HTML-escaped.
+ * metaFn output is injected raw — callers must ensure metaFn returns safe HTML
+ * (use escapeHtml for any user-controlled content within metaFn).
+ *
+ * Accepts both full FetchedPR objects and lightweight ShelvedPRRef objects.
+ */
+export declare function renderHealthItems<T extends Pick<FetchedPR, 'repo' | 'title' | 'url' | 'number'>>(prs: T[], cssClass: string, svgPaths: string, labelFn: string | ((pr: T) => string), metaFn: (pr: T) => string): string;
+/** Default meta: truncated PR title (works for both FetchedPR and ShelvedPRRef). */
+export declare function titleMeta(pr: Pick<FetchedPR, 'title'>): string;

package/dist/commands/dashboard-components.js

@@ -0,0 +1,57 @@
+/**
+ * Reusable HTML component generators for the dashboard:
+ * SVG icons, truncateTitle, renderHealthItems, titleMeta.
+ */
+import { escapeHtml } from './dashboard-formatters.js';
+/** SVG path constants for health item icons. */
+export const SVG_ICONS = {
+    comment: '<path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/>',
+    edit: '<path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/>',
+    xCircle: '<circle cx="12" cy="12" r="10"/><line x1="15" y1="9" x2="9" y2="15"/><line x1="9" y1="9" x2="15" y2="15"/>',
+    conflict: '<path d="M8 3v3a2 2 0 0 1-2 2H3"/><path d="M21 8h-3a2 2 0 0 1-2-2V3"/><path d="M3 16h3a2 2 0 0 1 2 2v3"/><path d="M16 21v-3a2 2 0 0 1 2-2h3"/>',
+    checklist: '<path d="M9 11l3 3L22 4"/><path d="M21 12v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11"/>',
+    file: '<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="12" y1="18" x2="12" y2="12"/><line x1="9" y1="15" x2="15" y2="15"/>',
+    checkCircle: '<path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/>',
+    clock: '<circle cx="12" cy="12" r="10"/><polyline points="12 6 12 12 16 14"/>',
+    lock: '<rect x="3" y="11" width="18" height="11" rx="2" ry="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/>',
+    infoCircle: '<circle cx="12" cy="12" r="10"/><line x1="12" y1="8" x2="12" y2="12"/><line x1="12" y1="16" x2="12.01" y2="16"/>',
+    refresh: '<polyline points="1 4 1 10 7 10"/><path d="M3.51 15a9 9 0 1 0 2.13-9.36L1 10"/>',
+    box: '<path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/><polyline points="3.27 6.96 12 12.01 20.73 6.96"/><line x1="12" y1="22.08" x2="12" y2="12"/>',
+    bell: '<path d="M18 8A6 6 0 0 0 6 8c0 7-3 9-3 9h18s-3-2-3-9"/><path d="M13.73 21a2 2 0 0 1-3.46 0"/>',
+    gitMerge: '<circle cx="7" cy="18" r="3"/><circle cx="7" cy="6" r="3"/><circle cx="17" cy="12" r="3"/><line x1="7" y1="9" x2="7" y2="15"/><path d="M7 9c0 4 10 3 10 3"/>',
+};
+export function truncateTitle(title, max = 50) {
+    const truncated = title.length <= max ? title : title.slice(0, max) + '...';
+    return escapeHtml(truncated);
+}
+/**
+ * Render health status items. labelFn output is automatically HTML-escaped.
+ * metaFn output is injected raw — callers must ensure metaFn returns safe HTML
+ * (use escapeHtml for any user-controlled content within metaFn).
+ *
+ * Accepts both full FetchedPR objects and lightweight ShelvedPRRef objects.
+ */
+export function renderHealthItems(prs, cssClass, svgPaths, labelFn, metaFn) {
+    return prs
+        .map((pr) => {
+        const rawLabel = typeof labelFn === 'string' ? labelFn : labelFn(pr);
+        const label = escapeHtml(rawLabel);
+        return `
+        <div class="health-item ${cssClass}" data-status="${cssClass}" data-repo="${escapeHtml(pr.repo)}" data-title="${escapeHtml(pr.title.toLowerCase())}">
+          <div class="health-icon">
+            <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+              ${svgPaths}
+            </svg>
+          </div>
+          <div class="health-content">
+            <div class="health-title"><a href="${escapeHtml(pr.url)}" target="_blank">${escapeHtml(pr.repo)}#${pr.number}</a> - ${label}</div>
+            <div class="health-meta">${metaFn(pr)}</div>
+          </div>
+        </div>`;
+    })
+        .join('');
+}
+/** Default meta: truncated PR title (works for both FetchedPR and ShelvedPRRef). */
+export function titleMeta(pr) {
+    return truncateTitle(pr.title);
+}

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-formatters.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Dashboard data formatting helpers: escapeHtml, DashboardStats, and stats builder.
+ */
+import type { DailyDigest, AgentState } from '../core/types.js';
+export interface DashboardStats {
+    activePRs: number;
+    shelvedPRs: number;
+    mergedPRs: number;
+    closedPRs: number;
+    mergeRate: string;
+}
+/**
+ * Escape HTML special characters to prevent XSS when interpolating
+ * user-controlled content (e.g. PR titles, comment bodies, author names) into HTML.
+ * Note: This escapes HTML entity characters only. It does not sanitize URL schemes
+ * (e.g., javascript:) — callers placing values in href attributes should validate
+ * the URL scheme if the source is untrusted. GitHub API URLs are trusted.
+ */
+export declare function escapeHtml(text: string): string;
+export declare function buildDashboardStats(digest: DailyDigest, state: Readonly<AgentState>): DashboardStats;

package/dist/commands/dashboard-formatters.js

@@ -0,0 +1,33 @@
+/**
+ * Dashboard data formatting helpers: escapeHtml, DashboardStats, and stats builder.
+ */
+/**
+ * Escape HTML special characters to prevent XSS when interpolating
+ * user-controlled content (e.g. PR titles, comment bodies, author names) into HTML.
+ * Note: This escapes HTML entity characters only. It does not sanitize URL schemes
+ * (e.g., javascript:) — callers placing values in href attributes should validate
+ * the URL scheme if the source is untrusted. GitHub API URLs are trusted.
+ */
+export function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+export function buildDashboardStats(digest, state) {
+    const summary = digest.summary || {
+        totalActivePRs: 0,
+        totalMergedAllTime: 0,
+        mergeRate: 0,
+        totalNeedingAttention: 0,
+    };
+    return {
+        activePRs: summary.totalActivePRs,
+        shelvedPRs: (digest.shelvedPRs || []).length,
+        mergedPRs: summary.totalMergedAllTime,
+        closedPRs: Object.values(state.repoScores || {}).reduce((sum, s) => sum + (s.closedWithoutMergeCount || 0), 0),
+        mergeRate: `${(summary.mergeRate ?? 0).toFixed(1)}%`,
+    };
+}

package/dist/commands/dashboard-scripts.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Client-side JavaScript for the dashboard: theme toggle, filtering, Chart.js charts.
+ */
+import type { DailyDigest, AgentState } from '../core/types.js';
+import type { DashboardStats } from './dashboard-formatters.js';
+/** Generate the Chart.js JavaScript for the dashboard. */
+export declare function generateDashboardScripts(stats: DashboardStats, monthlyMerged: Record<string, number>, monthlyClosed: Record<string, number>, monthlyOpened: Record<string, number>, digest: DailyDigest, state: Readonly<AgentState>): string;