@oss-autopilot/core 0.43.1 → 0.44.0

package/dist/cli.js

@@ -45,7 +45,6 @@ const LOCAL_ONLY_COMMANDS = [
     'version',
     'setup',
     'checkSetup',
-    'dashboard',
     'serve',
     'parse-issue-list',
     'check-integration',
@@ -537,20 +536,6 @@ dashboardCmd
         handleCommandError(err);
     }
 });
-// Keep bare `dashboard` (no subcommand) for backward compat — generates static HTML
-dashboardCmd
-    .option('--open', 'Open in browser')
-    .option('--json', 'Output as JSON')
-    .option('--offline', 'Use cached data only (no GitHub API calls)')
-    .action(async (options) => {
-    try {
-        const { runDashboard } = await import('./commands/dashboard.js');
-        await runDashboard({ open: options.open, json: options.json, offline: options.offline });
-    }
-    catch (err) {
-        handleCommandError(err, options.json);
-    }
-});
 // Parse issue list command (#82)
 program
     .command('parse-issue-list <path>')
@@ -673,8 +658,6 @@ program
             else {
                 console.log(`OSS Autopilot v${data.version}`);
                 console.log(data.daily?.briefSummary ?? '');
-                if (data.dashboardPath)
-                    console.log(`Dashboard: ${data.dashboardPath}`);
             }
         }
     }

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

@@ -1,22 +1,25 @@
 /**
  * Dashboard data fetching and aggregation.
  * Handles GitHub API calls, PR grouping, stats computation, and monthly chart data.
- * Separates data concerns from template generation and command orchestration.
+ * Consumed by the dashboard HTTP server (dashboard-server.ts) for the SPA API.
  */
 import type { DailyDigest, AgentState, CommentedIssue } from '../core/types.js';
+export interface DashboardStats {
+    activePRs: number;
+    shelvedPRs: number;
+    mergedPRs: number;
+    closedPRs: number;
+    mergeRate: string;
+}
+export declare function buildDashboardStats(digest: DailyDigest, state: Readonly<AgentState>): DashboardStats;
 export interface DashboardFetchResult {
     digest: DailyDigest;
     commentedIssues: CommentedIssue[];
 }
-/**
- * Fetch fresh dashboard data from GitHub.
- * Returns the digest and commented issues, updating state as a side effect.
- * Throws if the fetch fails entirely (caller should fall back to cached data).
- */
 export declare function fetchDashboardData(token: string): Promise<DashboardFetchResult>;
 /**
  * Compute PRs grouped by repository from a digest and state.
- * Used for chart data in both JSON and HTML output.
+ * Used for chart data in the dashboard API.
  */
 export declare function computePRsByRepo(digest: DailyDigest, state: Readonly<AgentState>): Record<string, {
     active: number;

package/dist/commands/dashboard-data.js

@@ -1,17 +1,42 @@
 /**
  * Dashboard data fetching and aggregation.
  * Handles GitHub API calls, PR grouping, stats computation, and monthly chart data.
- * Separates data concerns from template generation and command orchestration.
+ * Consumed by the dashboard HTTP server (dashboard-server.ts) for the SPA API.
  */
 import { getStateManager, PRMonitor, IssueConversationMonitor } from '../core/index.js';
-import { errorMessage } from '../core/errors.js';
+import { errorMessage, getHttpStatusCode } from '../core/errors.js';
 import { emptyPRCountsResult } from '../core/github-stats.js';
 import { toShelvedPRRef } from './daily.js';
+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)}%`,
+    };
+}
 /**
  * Fetch fresh dashboard data from GitHub.
  * Returns the digest and commented issues, updating state as a side effect.
  * Throws if the fetch fails entirely (caller should fall back to cached data).
  */
+function isRateLimitOrAuthError(err) {
+    const status = getHttpStatusCode(err);
+    if (status === 401 || status === 429)
+        return true;
+    if (status === 403) {
+        const msg = errorMessage(err).toLowerCase();
+        return msg.includes('rate limit') || msg.includes('abuse detection');
+    }
+    return false;
+}
 export async function fetchDashboardData(token) {
     const stateManager = getStateManager();
     const prMonitor = new PRMonitor(token);
@@ -19,18 +44,26 @@ export async function fetchDashboardData(token) {
     const [{ prs, failures }, recentlyClosedPRs, recentlyMergedPRs, mergedResult, closedResult, fetchedIssues] = await Promise.all([
         prMonitor.fetchUserOpenPRs(),
         prMonitor.fetchRecentlyClosedPRs().catch((err) => {
+            if (isRateLimitOrAuthError(err))
+                throw err;
             console.error(`Warning: Failed to fetch recently closed PRs: ${errorMessage(err)}`);
             return [];
         }),
         prMonitor.fetchRecentlyMergedPRs().catch((err) => {
+            if (isRateLimitOrAuthError(err))
+                throw err;
             console.error(`Warning: Failed to fetch recently merged PRs: ${errorMessage(err)}`);
             return [];
         }),
         prMonitor.fetchUserMergedPRCounts().catch((err) => {
+            if (isRateLimitOrAuthError(err))
+                throw err;
             console.error(`Warning: Failed to fetch merged PR counts: ${errorMessage(err)}`);
             return emptyPRCountsResult();
         }),
         prMonitor.fetchUserClosedPRCounts().catch((err) => {
+            if (isRateLimitOrAuthError(err))
+                throw err;
             console.error(`Warning: Failed to fetch closed PR counts: ${errorMessage(err)}`);
             return emptyPRCountsResult();
         }),
@@ -113,7 +146,7 @@ export async function fetchDashboardData(token) {
 }
 /**
  * Compute PRs grouped by repository from a digest and state.
- * Used for chart data in both JSON and HTML output.
+ * Used for chart data in the dashboard API.
  */
 export function computePRsByRepo(digest, state) {
     const prsByRepo = {};

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

@@ -1,14 +1,7 @@
 /**
- * Dashboard data formatting helpers: escapeHtml, DashboardStats, and stats builder.
+ * Dashboard HTML formatting helpers.
+ * Used by dashboard-templates.ts and dashboard-components.ts for static HTML generation.
  */
-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.
@@ -17,4 +10,3 @@ export interface DashboardStats {
  * 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

@@ -1,5 +1,6 @@
 /**
- * Dashboard data formatting helpers: escapeHtml, DashboardStats, and stats builder.
+ * Dashboard HTML formatting helpers.
+ * Used by dashboard-templates.ts and dashboard-components.ts for static HTML generation.
  */
 /**
  * Escape HTML special characters to prevent XSS when interpolating
@@ -16,18 +17,3 @@ export function escapeHtml(text) {
         .replace(/"/g, '"')
         .replace(/'/g, ''');
 }
-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-lifecycle.d.ts

@@ -12,7 +12,7 @@ export interface LaunchResult {
  * Launch the interactive dashboard SPA server as a detached background process.
  *
  * Returns the server URL if launched successfully, or null if the SPA assets
- * are not available (caller should fall back to static HTML).
+ * are not available (dashboard is skipped).
  *
  * If a server is already running (detected via PID file + health probe),
  * returns its URL without launching a new one.

package/dist/commands/dashboard-lifecycle.js

@@ -16,7 +16,7 @@ function sleep(ms) {
  * Launch the interactive dashboard SPA server as a detached background process.
  *
  * Returns the server URL if launched successfully, or null if the SPA assets
- * are not available (caller should fall back to static HTML).
+ * are not available (dashboard is skipped).
  *
  * If a server is already running (detected via PID file + health probe),
  * returns its URL without launching a new one.

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

@@ -2,6 +2,6 @@
  * 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';
+import type { DashboardStats } from './dashboard-data.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;

package/dist/commands/dashboard-server.js

@@ -11,8 +11,8 @@ import * as path from 'path';
 import { getStateManager, getGitHubToken, getDataDir } from '../core/index.js';
 import { errorMessage, ValidationError } from '../core/errors.js';
 import { validateUrl, validateGitHubUrl, validateMessage, PR_URL_PATTERN } from './validation.js';
-import { fetchDashboardData, computePRsByRepo, computeTopRepos, getMonthlyData } from './dashboard-data.js';
-import { buildDashboardStats } from './dashboard-templates.js';
+import { fetchDashboardData, computePRsByRepo, computeTopRepos, getMonthlyData, buildDashboardStats, } from './dashboard-data.js';
+import { openInBrowser } from './startup.js';
 // ── Constants ────────────────────────────────────────────────────────────────
 const VALID_ACTIONS = new Set(['shelve', 'unshelve', 'snooze', 'unsnooze']);
 const MAX_BODY_BYTES = 10_240;
@@ -109,7 +109,6 @@ export async function findRunningDashboardServer() {
 // ── Helpers ────────────────────────────────────────────────────────────────────
 /**
  * Build the JSON payload that the SPA expects from GET /api/data.
- * Same shape as the existing `dashboard --json` output.
  */
 function buildDashboardJson(digest, state, commentedIssues) {
     const prsByRepo = computePRsByRepo(digest, state);
@@ -126,6 +125,9 @@ function buildDashboardJson(digest, state, commentedIssues) {
         monthlyClosed,
         activePRs: digest.openPRs || [],
         shelvedPRUrls: state.config.shelvedPRUrls || [],
+        recentlyMergedPRs: digest.recentlyMergedPRs || [],
+        recentlyClosedPRs: digest.recentlyClosedPRs || [],
+        autoUnshelvedPRs: digest.autoUnshelvedPRs || [],
         commentedIssues,
         issueResponses,
     };
@@ -183,25 +185,11 @@ export async function startDashboardServer(options) {
     const stateManager = getStateManager();
     const resolvedAssetsDir = path.resolve(assetsDir);
     // ── Cached data ──────────────────────────────────────────────────────────
-    let cachedDigest;
+    // Start immediately with state.json data (written by the daily check that
+    // precedes this server launch). A background GitHub fetch refreshes the
+    // cache after the port is bound, so the startup poller sees us in time.
+    let cachedDigest = stateManager.getState().lastDigest;
     let cachedCommentedIssues = [];
-    // Fetch initial data
-    if (token) {
-        try {
-            console.error('Fetching dashboard data from GitHub...');
-            const result = await fetchDashboardData(token);
-            cachedDigest = result.digest;
-            cachedCommentedIssues = result.commentedIssues;
-        }
-        catch (error) {
-            console.error('Failed to fetch data from GitHub:', error);
-            console.error('Falling back to cached data...');
-            cachedDigest = stateManager.getState().lastDigest;
-        }
-    }
-    else {
-        cachedDigest = stateManager.getState().lastDigest;
-    }
     if (!cachedDigest) {
         console.error('No dashboard data available. Run the daily check first:');
         console.error('  GITHUB_TOKEN=$(gh auth token) npm start -- daily');
@@ -330,9 +318,7 @@ export async function startDashboardServer(options) {
             return;
         }
         // Rebuild dashboard data from cached digest + updated state
-        if (cachedDigest) {
-            cachedJsonData = buildDashboardJson(cachedDigest, stateManager.getState(), cachedCommentedIssues);
-        }
+        cachedJsonData = buildDashboardJson(cachedDigest, stateManager.getState(), cachedCommentedIssues);
         sendJson(res, 200, cachedJsonData);
     }
     // ── POST /api/refresh handler ────────────────────────────────────────────
@@ -446,31 +432,24 @@ export async function startDashboardServer(options) {
     writeDashboardServerInfo({ pid: process.pid, port: actualPort, startedAt: new Date().toISOString() });
     const serverUrl = `http://localhost:${actualPort}`;
     console.error(`Dashboard server running at ${serverUrl}`);
+    // ── Background refresh ─────────────────────────────────────────────────
+    // Port is bound and PID file written — now fetch fresh data from GitHub
+    // so subsequent /api/data requests get live data instead of cached state.
+    if (token) {
+        fetchDashboardData(token)
+            .then((result) => {
+            cachedDigest = result.digest;
+            cachedCommentedIssues = result.commentedIssues;
+            cachedJsonData = buildDashboardJson(cachedDigest, stateManager.getState(), cachedCommentedIssues);
+            console.error('Background data refresh complete');
+        })
+            .catch((error) => {
+            console.error('Background data refresh failed (serving cached data):', errorMessage(error));
+        });
+    }
     // ── Open browser ─────────────────────────────────────────────────────────
     if (open) {
-        const { execFile } = await import('child_process');
-        let openCmd;
-        let args;
-        switch (process.platform) {
-            case 'darwin':
-                openCmd = 'open';
-                args = [serverUrl];
-                break;
-            case 'win32':
-                openCmd = 'cmd';
-                args = ['/c', 'start', '', serverUrl];
-                break;
-            default:
-                openCmd = 'xdg-open';
-                args = [serverUrl];
-                break;
-        }
-        execFile(openCmd, args, (error) => {
-            if (error) {
-                console.error('Failed to open browser:', error.message);
-                console.error(`Open manually: ${serverUrl}`);
-            }
-        });
+        openInBrowser(serverUrl);
     }
     // ── Clean shutdown ───────────────────────────────────────────────────────
     const shutdown = () => {

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

@@ -6,6 +6,7 @@
  * Pure functions with no side effects — all data is passed in as arguments.
  */
 import type { DailyDigest, AgentState, CommentedIssueWithResponse } from '../core/types.js';
-import { type DashboardStats } from './dashboard-formatters.js';
-export { escapeHtml, buildDashboardStats, type DashboardStats } from './dashboard-formatters.js';
+import type { DashboardStats } from './dashboard-data.js';
+export { escapeHtml } from './dashboard-formatters.js';
+export { buildDashboardStats, type DashboardStats } from './dashboard-data.js';
 export declare function generateDashboardHtml(stats: DashboardStats, monthlyMerged: Record<string, number>, monthlyClosed: Record<string, number>, monthlyOpened: Record<string, number>, digest: DailyDigest, state: Readonly<AgentState>, issueResponses?: CommentedIssueWithResponse[]): string;

package/dist/commands/dashboard-templates.js

@@ -9,8 +9,9 @@ import { escapeHtml } from './dashboard-formatters.js';
 import { DASHBOARD_CSS } from './dashboard-styles.js';
 import { SVG_ICONS, truncateTitle, renderHealthItems, titleMeta } from './dashboard-components.js';
 import { generateDashboardScripts } from './dashboard-scripts.js';
-// Re-export public API so existing consumers don't break
-export { escapeHtml, buildDashboardStats } from './dashboard-formatters.js';
+// Re-export public API so consumers can import from this module
+export { escapeHtml } from './dashboard-formatters.js';
+export { buildDashboardStats } from './dashboard-data.js';
 export function generateDashboardHtml(stats, monthlyMerged, monthlyClosed, monthlyOpened, digest, state, issueResponses = []) {
     const approachingDormantDays = state.config?.approachingDormantDays ?? 25;
     const shelvedPRs = digest.shelvedPRs || [];

package/dist/commands/dashboard.d.ts

@@ -1,18 +1,14 @@
 /**
- * Dashboard command — thin orchestrator.
- * Coordinates data fetching, template generation, and file output.
- * v2: Fetches fresh data from GitHub if token available, otherwise uses cached lastDigest.
+ * Dashboard command — serves the interactive Preact SPA dashboard.
+ * Also provides writeDashboardFromState() for generating a static HTML fallback
+ * when the SPA cannot be launched (e.g., assets not built).
  */
-interface DashboardOptions {
-    open?: boolean;
-    json?: boolean;
-    offline?: boolean;
-}
-export declare function runDashboard(options: DashboardOptions): Promise<void>;
 /**
  * Generate dashboard HTML from state (no GitHub fetch).
  * Call after executeDailyCheck() which saves fresh data to state.
  * Returns the path to the generated dashboard HTML file.
+ *
+ * Used as a safety net when the interactive SPA dashboard cannot be launched.
  */
 export declare function writeDashboardFromState(): string;
 interface ServeOptions {

package/dist/commands/dashboard.js

@@ -1,124 +1,20 @@
 /**
- * Dashboard command — thin orchestrator.
- * Coordinates data fetching, template generation, and file output.
- * v2: Fetches fresh data from GitHub if token available, otherwise uses cached lastDigest.
+ * Dashboard command — serves the interactive Preact SPA dashboard.
+ * Also provides writeDashboardFromState() for generating a static HTML fallback
+ * when the SPA cannot be launched (e.g., assets not built).
  */
 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 { getMonthlyData } from './dashboard-data.js';
 import { buildDashboardStats, generateDashboardHtml } from './dashboard-templates.js';
-export async function runDashboard(options) {
-    const stateManager = getStateManager();
-    const token = options.offline ? null : getGitHubToken();
-    let digest;
-    let commentedIssues = [];
-    // In offline mode, skip all GitHub API calls
-    if (options.offline) {
-        const state = stateManager.getState();
-        digest = state.lastDigest;
-        if (!digest) {
-            if (options.json) {
-                outputJson({ error: 'No cached data found. Run without --offline first.', offline: true });
-            }
-            else {
-                console.error('No cached data found. Run without --offline first.');
-            }
-            return;
-        }
-        const lastUpdated = digest.generatedAt || state.lastDigestAt || state.lastRunAt;
-        console.error(`Offline mode: using cached data from ${lastUpdated}`);
-    }
-    else if (token) {
-        console.error('Fetching fresh data from GitHub...');
-        try {
-            const result = await fetchDashboardData(token);
-            digest = result.digest;
-            commentedIssues = result.commentedIssues;
-        }
-        catch (error) {
-            console.error('Failed to fetch fresh data:', errorMessage(error));
-            console.error('Falling back to cached data (issue conversations unavailable)...');
-            digest = stateManager.getState().lastDigest;
-        }
-    }
-    else {
-        // No token and not offline — fall back to cached digest with warning
-        console.error('Warning: No GitHub token found. Using cached data (may be stale).');
-        console.error('Set GITHUB_TOKEN or run `gh auth login` for fresh data.');
-        digest = stateManager.getState().lastDigest;
-    }
-    // Check if we have a digest to display
-    if (!digest) {
-        if (options.json) {
-            outputJson({ error: 'No data available. Run daily check first with GITHUB_TOKEN.' });
-        }
-        else {
-            console.error('No dashboard data available. Run the daily check first:');
-            console.error('  GITHUB_TOKEN=$(gh auth token) npm start -- daily');
-        }
-        return;
-    }
-    const state = stateManager.getState();
-    // Gather data for charts from digest
-    const prsByRepo = computePRsByRepo(digest, state);
-    const topRepos = computeTopRepos(prsByRepo);
-    const { monthlyMerged, monthlyClosed, monthlyOpened } = getMonthlyData(state);
-    const stats = buildDashboardStats(digest, state);
-    if (options.json) {
-        const issueResponses = commentedIssues.filter((i) => i.status === 'new_response');
-        const jsonData = {
-            stats,
-            prsByRepo,
-            topRepos: topRepos.map(([repo, data]) => ({ repo, ...data })),
-            monthlyMerged,
-            activePRs: digest.openPRs || [],
-            commentedIssues,
-            issueResponses,
-        };
-        if (options.offline) {
-            jsonData.offline = true;
-            jsonData.lastUpdated = digest.generatedAt || state.lastDigestAt || state.lastRunAt;
-        }
-        outputJson(jsonData);
-        return;
-    }
-    const issueResponses = commentedIssues.filter((i) => i.status === 'new_response');
-    const html = generateDashboardHtml(stats, monthlyMerged, monthlyClosed, monthlyOpened, digest, state, issueResponses);
-    // Write to file in ~/.oss-autopilot/
-    const dashboardPath = getDashboardPath();
-    fs.writeFileSync(dashboardPath, html, { mode: 0o644 });
-    if (options.offline) {
-        const lastUpdated = digest.generatedAt || state.lastDigestAt || state.lastRunAt;
-        console.log(`\n📊 Dashboard generated (offline, cached data from ${lastUpdated}): ${dashboardPath}`);
-    }
-    else {
-        console.log(`\n📊 Dashboard generated: ${dashboardPath}`);
-    }
-    if (options.open) {
-        // Use platform-specific open command - path is hardcoded, not user input
-        const isWindows = process.platform === 'win32';
-        const openCmd = process.platform === 'darwin' ? 'open' : isWindows ? 'cmd' : 'xdg-open';
-        const args = isWindows ? ['/c', 'start', '', dashboardPath] : [dashboardPath];
-        console.log(`Dashboard: ${dashboardPath}`);
-        execFile(openCmd, args, (error) => {
-            if (error) {
-                console.error('Failed to open browser:', error.message);
-                console.error(`Open manually: ${dashboardPath}`);
-            }
-        });
-    }
-    else {
-        console.log('Run with --open to open in browser');
-    }
-}
+// ── Static HTML fallback ────────────────────────────────────────────────────
 /**
  * Generate dashboard HTML from state (no GitHub fetch).
  * Call after executeDailyCheck() which saves fresh data to state.
  * Returns the path to the generated dashboard HTML file.
+ *
+ * Used as a safety net when the interactive SPA dashboard cannot be launched.
  */
 export function writeDashboardFromState() {
     const stateManager = getStateManager();

package/dist/commands/startup.d.ts

@@ -1,7 +1,7 @@
 /**
  * Startup command
  * Combines all pre-flight checks into a single CLI invocation:
- * auth check, setup check, daily fetch, dashboard generation, version detection, issue list detection.
+ * auth check, setup check, daily fetch, dashboard launch, version detection, issue list detection.
  *
  * Replaces the ~100-line inline bash script in commands/oss.md with a single
  * `node cli.bundle.cjs startup --json` call, reducing UI noise in Claude Code.
@@ -26,12 +26,13 @@ export declare function countIssueListItems(content: string): {
  * Returns IssueListInfo or undefined if no list found.
  */
 export declare function detectIssueList(): IssueListInfo | undefined;
+export declare function openInBrowser(url: string): void;
 /**
  * Run startup checks and return structured output.
  * Returns StartupOutput with one of three shapes:
  * 1. Setup incomplete: { version, setupComplete: false }
  * 2. Auth failure: { version, setupComplete: true, authError: "..." }
- * 3. Success: { version, setupComplete: true, daily, dashboardPath?, dashboardUrl?, issueList? }
+ * 3. Success: { version, setupComplete: true, daily, dashboardUrl?, dashboardPath?, issueList? }
  *
  * Errors from the daily check propagate to the caller.
  */