@oss-autopilot/core 0.43.1 → 0.44.0

package/dist/commands/startup.js

@@ -1,19 +1,18 @@
 /**
  * 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.
  */
 import * as fs from 'fs';
 import { execFile } from 'child_process';
-import { getStateManager, getGitHubToken, getCLIVersion, getStatePath, getDashboardPath } from '../core/index.js';
+import { getStateManager, getGitHubToken, getCLIVersion } from '../core/index.js';
 import { errorMessage } from '../core/errors.js';
-import { warn } from '../core/logger.js';
 import { executeDailyCheck } from './daily.js';
-import { writeDashboardFromState } from './dashboard.js';
 import { launchDashboardServer } from './dashboard-lifecycle.js';
+import { writeDashboardFromState } from './dashboard.js';
 /**
  * Parse issueListPath from a config file's YAML frontmatter.
  * Returns the path string or undefined if not found.
@@ -94,21 +93,21 @@ export function detectIssueList() {
         return { path: issueListPath, source, availableCount: 0, completedCount: 0 };
     }
 }
-function openInBrowser(filePath) {
+export function openInBrowser(url) {
     let openCmd;
     let args;
     switch (process.platform) {
         case 'darwin':
             openCmd = 'open';
-            args = [filePath];
+            args = [url];
             break;
         case 'win32':
             openCmd = 'cmd';
-            args = ['/c', 'start', '', filePath];
+            args = ['/c', 'start', '', url];
             break;
         default:
             openCmd = 'xdg-open';
-            args = [filePath];
+            args = [url];
             break;
     }
     execFile(openCmd, args, (error) => {
@@ -117,31 +116,12 @@ function openInBrowser(filePath) {
         }
     });
 }
-/**
- * Check whether the dashboard HTML file is at least as recent as state.json.
- * Returns true when the dashboard exists and its mtime >= state mtime,
- * meaning there is no need to regenerate it.
- */
-function isDashboardFresh() {
-    try {
-        const dashPath = getDashboardPath();
-        if (!fs.existsSync(dashPath))
-            return false;
-        const dashMtime = fs.statSync(dashPath).mtimeMs;
-        const stateMtime = fs.statSync(getStatePath()).mtimeMs;
-        return dashMtime >= stateMtime;
-    }
-    catch (error) {
-        warn('startup', `Failed to check dashboard freshness, will regenerate: ${errorMessage(error)}`);
-        return false;
-    }
-}
 /**
  * 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.
  */
@@ -163,56 +143,52 @@ export async function runStartup() {
     }
     // 3. Run daily check
     const daily = await executeDailyCheck(token);
-    // 4. Generate static HTML dashboard (serves as fallback + snapshot).
-    //    Skip regeneration if the dashboard HTML is already newer than state.json.
+    // 4. Launch interactive SPA dashboard (with static HTML fallback)
+    // Skip opening on first run (0 PRs) — the welcome flow handles onboarding
+    let dashboardUrl;
     let dashboardPath;
-    try {
-        if (isDashboardFresh()) {
-            dashboardPath = getDashboardPath();
-            console.error('[STARTUP] Dashboard HTML is fresh, skipping regeneration');
-        }
-        else {
+    let dashboardOpened = false;
+    function tryStaticHtmlFallback() {
+        try {
             dashboardPath = writeDashboardFromState();
+            openInBrowser(dashboardPath);
+            return true;
+        }
+        catch (htmlError) {
+            console.error('[STARTUP] Static HTML dashboard fallback also failed:', errorMessage(htmlError));
+            return false;
         }
     }
-    catch (error) {
-        console.error('[STARTUP] Dashboard generation failed:', errorMessage(error));
-    }
-    // 5. Launch interactive SPA dashboard (preferred) with static HTML fallback
-    // Skip opening on first run (0 PRs) — the welcome flow handles onboarding
-    let dashboardUrl;
-    let dashboardOpened = false;
     if (daily.digest.summary.totalActivePRs > 0) {
-        let spaResult = null;
         try {
-            spaResult = await launchDashboardServer();
+            const spaResult = await launchDashboardServer();
+            if (spaResult) {
+                dashboardUrl = spaResult.url;
+                openInBrowser(spaResult.url);
+                dashboardOpened = true;
+            }
+            else {
+                console.error('[STARTUP] Dashboard SPA assets not found, falling back to static HTML dashboard');
+                dashboardOpened = tryStaticHtmlFallback();
+            }
         }
         catch (error) {
             console.error('[STARTUP] SPA dashboard launch failed:', errorMessage(error));
-        }
-        if (spaResult) {
-            dashboardUrl = spaResult.url;
-            openInBrowser(spaResult.url);
-            dashboardOpened = true;
-        }
-        else if (dashboardPath) {
-            // SPA unavailable (assets not built) — fall back to static HTML
-            openInBrowser(dashboardPath);
-            dashboardOpened = true;
+            dashboardOpened = tryStaticHtmlFallback();
         }
     }
     // Append dashboard status to brief summary (only startup opens the browser, not daily)
     if (dashboardOpened) {
         daily.briefSummary += ' | Dashboard opened in browser';
     }
-    // 6. Detect issue list
+    // 5. Detect issue list
     const issueList = detectIssueList();
     return {
         version,
         setupComplete: true,
         daily,
-        dashboardPath,
         dashboardUrl,
+        dashboardPath,
         issueList,
     };
 }

package/dist/core/daily-logic.js

@@ -509,5 +509,5 @@ export function printDigest(digest, capacity, commentedIssues = []) {
         console.log('');
     }
     console.log('Run with --json for structured output');
-    console.log('Run "dashboard --open" for browser view');
+    console.log('Run "dashboard serve" for browser view');
 }

package/dist/core/utils.d.ts

@@ -5,7 +5,7 @@
  * Returns the oss-autopilot data directory path, creating it if it does not exist.
  *
  * The directory is located at `~/.oss-autopilot/` and serves as the root for
- * all persisted user data (state, backups, dashboard).
+ * all persisted user data (state, backups, cache).
  *
  * @returns Absolute path to the data directory (e.g., `/Users/you/.oss-autopilot`)
  *
@@ -53,11 +53,8 @@ export declare function getBackupDir(): string;
  */
 export declare function getCacheDir(): string;
 /**
- * Returns the path to the generated HTML dashboard file (`~/.oss-autopilot/dashboard.html`).
- *
- * Implicitly creates the data directory via {@link getDataDir} if it does not exist.
- *
- * @returns Absolute path to `dashboard.html`
+ * Returns the path to the static HTML dashboard file (~/.oss-autopilot/dashboard.html).
+ * Used as a fallback when the interactive SPA dashboard cannot be launched.
  *
  * @example
  * const dashPath = getDashboardPath();

package/dist/core/utils.js

@@ -15,7 +15,7 @@ let tokenFetchAttempted = false;
  * Returns the oss-autopilot data directory path, creating it if it does not exist.
  *
  * The directory is located at `~/.oss-autopilot/` and serves as the root for
- * all persisted user data (state, backups, dashboard).
+ * all persisted user data (state, backups, cache).
  *
  * @returns Absolute path to the data directory (e.g., `/Users/you/.oss-autopilot`)
  *
@@ -83,11 +83,8 @@ export function getCacheDir() {
     return dir;
 }
 /**
- * Returns the path to the generated HTML dashboard file (`~/.oss-autopilot/dashboard.html`).
- *
- * Implicitly creates the data directory via {@link getDataDir} if it does not exist.
- *
- * @returns Absolute path to `dashboard.html`
+ * Returns the path to the static HTML dashboard file (~/.oss-autopilot/dashboard.html).
+ * Used as a fallback when the interactive SPA dashboard cannot be launched.
  *
  * @example
  * const dashPath = getDashboardPath();

package/dist/formatters/json.d.ts

@@ -200,16 +200,17 @@ export interface IssueListInfo {
  * Three valid 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?, issueList? }
  */
 export interface StartupOutput {
     version: string;
     setupComplete: boolean;
     authError?: string;
     daily?: DailyOutput;
-    dashboardPath?: string;
     /** URL of the interactive SPA dashboard server, when running (e.g., "http://localhost:3000") */
     dashboardUrl?: string;
+    /** Path to the static HTML dashboard file (fallback when SPA cannot launch) */
+    dashboardPath?: string;
     issueList?: IssueListInfo;
 }
 /** A single parsed issue from a markdown list (#82) */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-autopilot/core",
-  "version": "0.43.1",
+  "version": "0.44.0",
   "description": "CLI and core library for managing open source contributions",
   "type": "module",
   "bin": {