@oss-autopilot/core 0.41.0 → 0.42.1

package/dist/cli.js

@@ -10,21 +10,30 @@
  * async token fetch to avoid blocking the event loop on `gh auth token`.
  */
 import { Command } from 'commander';
-import { getGitHubTokenAsync, enableDebug, debug } from './core/index.js';
-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';
-    }
-})();
+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) {
+    const entries = Object.entries(repos).sort(([a], [b]) => a.localeCompare(b));
+    for (const [remote, info] of entries) {
+        const branch = info.currentBranch ? ` (${info.currentBranch})` : '';
+        console.log(`  ${remote}${branch}`);
+        console.log(`    ${info.path}`);
+    }
+}
+/** Shared error handler for CLI action catch blocks. */
+function handleCommandError(err, json) {
+    const msg = errorMessage(err);
+    if (json) {
+        outputJsonError(msg);
+    }
+    else {
+        console.error(`Error: ${msg}`);
+    }
+    process.exit(1);
+}
+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 = [
@@ -37,6 +46,7 @@ const LOCAL_ONLY_COMMANDS = [
     'setup',
     'checkSetup',
     'dashboard',
+    'serve',
     'parse-issue-list',
     'check-integration',
     'local-repos',
@@ -60,8 +70,21 @@ program
     .description('Run daily check on all tracked PRs')
     .option('--json', 'Output as JSON')
     .action(async (options) => {
-    const { runDaily } = await import('./commands/daily.js');
-    await runDaily({ json: options.json });
+    try {
+        if (options.json) {
+            const { runDaily } = await import('./commands/daily.js');
+            const data = await runDaily();
+            outputJson(data);
+        }
+        else {
+            const { runDailyForDisplay, printDigest } = await import('./commands/daily.js');
+            const result = await runDailyForDisplay();
+            printDigest(result.digest, result.capacity, result.commentedIssues);
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Status command
 program
@@ -70,8 +93,31 @@ program
     .option('--json', 'Output as JSON')
     .option('--offline', 'Use cached data only (no GitHub API calls)')
     .action(async (options) => {
-    const { runStatus } = await import('./commands/status.js');
-    await runStatus({ json: options.json, offline: options.offline });
+    try {
+        const { runStatus } = await import('./commands/status.js');
+        const data = await runStatus({ offline: options.offline });
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            console.log('\n\ud83d\udcca OSS Status\n');
+            console.log(`Merged PRs: ${data.stats.mergedPRs}`);
+            console.log(`Closed PRs: ${data.stats.closedPRs}`);
+            console.log(`Merge Rate: ${data.stats.mergeRate}`);
+            console.log(`Needs Response: ${data.stats.needsResponse}`);
+            if (data.offline) {
+                console.log(`\nLast Updated: ${data.lastUpdated || 'Never'}`);
+                console.log('(Offline mode: showing cached data)');
+            }
+            else {
+                console.log(`\nLast Run: ${data.lastRunAt || 'Never'}`);
+            }
+            console.log('\nRun with --json for structured output');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Search command
 program
@@ -79,8 +125,46 @@ program
     .description('Search for new issues to work on')
     .option('--json', 'Output as JSON')
     .action(async (count, options) => {
-    const { runSearch } = await import('./commands/search.js');
-    await runSearch({ maxResults: parseInt(count) || 5, json: options.json });
+    try {
+        const { runSearch } = await import('./commands/search.js');
+        if (!options.json) {
+            console.log(`\nSearching for issues (max ${parseInt(count) || 5})...\n`);
+        }
+        const data = await runSearch({ maxResults: parseInt(count) || 5 });
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            if (data.candidates.length === 0) {
+                if (data.rateLimitWarning) {
+                    console.warn(`\n${data.rateLimitWarning}\n`);
+                }
+                else {
+                    console.log('No matching issues found.');
+                }
+                return;
+            }
+            if (data.rateLimitWarning) {
+                console.warn(`\n${data.rateLimitWarning}\n`);
+            }
+            console.log(`Found ${data.candidates.length} candidates:\n`);
+            for (const candidate of data.candidates) {
+                // Simple text format for candidates
+                const { issue, recommendation, reasonsToApprove, reasonsToSkip, viabilityScore } = candidate;
+                console.log(`[${recommendation.toUpperCase()}] ${issue.repo}#${issue.number}: ${issue.title}`);
+                console.log(`  URL: ${issue.url}`);
+                console.log(`  Viability: ${viabilityScore}/100`);
+                if (reasonsToApprove.length > 0)
+                    console.log(`  Approve: ${reasonsToApprove.join(', ')}`);
+                if (reasonsToSkip.length > 0)
+                    console.log(`  Skip: ${reasonsToSkip.join(', ')}`);
+                console.log('---');
+            }
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Vet command
 program
@@ -88,8 +172,26 @@ program
     .description('Vet a specific issue before working on it')
     .option('--json', 'Output as JSON')
     .action(async (issueUrl, options) => {
-    const { runVet } = await import('./commands/vet.js');
-    await runVet({ issueUrl, json: options.json });
+    try {
+        const { runVet } = await import('./commands/vet.js');
+        const data = await runVet({ issueUrl });
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            const { issue, recommendation, reasonsToApprove, reasonsToSkip } = data;
+            console.log(`\nVetting issue: ${issueUrl}\n`);
+            console.log(`[${recommendation.toUpperCase()}] ${issue.repo}#${issue.number}: ${issue.title}`);
+            console.log(`  URL: ${issue.url}`);
+            if (reasonsToApprove.length > 0)
+                console.log(`  Approve: ${reasonsToApprove.join(', ')}`);
+            if (reasonsToSkip.length > 0)
+                console.log(`  Skip: ${reasonsToSkip.join(', ')}`);
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Track command
 program
@@ -97,8 +199,20 @@ program
     .description('Add a PR to track')
     .option('--json', 'Output as JSON')
     .action(async (prUrl, options) => {
-    const { runTrack } = await import('./commands/track.js');
-    await runTrack({ prUrl, json: options.json });
+    try {
+        const { runTrack } = await import('./commands/track.js');
+        const data = await runTrack({ prUrl });
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            console.log(`\nPR: ${data.pr.repo}#${data.pr.number} - ${data.pr.title}`);
+            console.log('Note: In v2, PRs are tracked automatically via the daily run.');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Untrack command
 program
@@ -106,8 +220,20 @@ program
     .description('Stop tracking a PR')
     .option('--json', 'Output as JSON')
     .action(async (prUrl, options) => {
-    const { runUntrack } = await import('./commands/track.js');
-    await runUntrack({ prUrl, json: options.json });
+    try {
+        const { runUntrack } = await import('./commands/track.js');
+        const data = await runUntrack({ prUrl });
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            console.log('Note: In v2, PRs are fetched fresh on each daily run \u2014 there is no local tracking list to remove from.');
+            console.log('Use `shelve` to temporarily hide a PR from the daily summary.');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Read command (mark as read)
 program
@@ -116,8 +242,19 @@ program
     .option('--all', 'Mark all PRs as read')
     .option('--json', 'Output as JSON')
     .action(async (prUrl, options) => {
-    const { runRead } = await import('./commands/read.js');
-    await runRead({ prUrl, all: options.all, json: options.json });
+    try {
+        const { runRead } = await import('./commands/read.js');
+        const data = await runRead({ prUrl, all: options.all });
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            console.log('Note: In v2, PR read state is not tracked locally. PRs are fetched fresh on each daily run.');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Comments command
 program
@@ -126,8 +263,61 @@ program
     .option('--bots', 'Include bot comments')
     .option('--json', 'Output as JSON')
     .action(async (prUrl, options) => {
-    const { runComments } = await import('./commands/comments.js');
-    await runComments({ prUrl, showBots: options.bots, json: options.json });
+    try {
+        const { runComments } = await import('./commands/comments.js');
+        const data = await runComments({ prUrl, showBots: options.bots });
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            // Text output
+            console.log(`\nFetching comments for: ${prUrl}\n`);
+            console.log(`## ${data.pr.title}\n`);
+            console.log(`**Status:** ${data.pr.state} | **Mergeable:** ${data.pr.mergeable ?? 'checking...'}`);
+            console.log(`**Branch:** ${data.pr.head} -> ${data.pr.base}`);
+            console.log(`**URL:** ${data.pr.url}\n`);
+            const REVIEW_STATE_LABELS = {
+                APPROVED: '[Approved]',
+                CHANGES_REQUESTED: '[Changes]',
+            };
+            if (data.reviews.length > 0) {
+                console.log('### Reviews (newest first)\n');
+                for (const review of data.reviews) {
+                    const state = REVIEW_STATE_LABELS[review.state] ?? '[Comment]';
+                    const time = review.submittedAt ? formatRelativeTime(review.submittedAt) : '';
+                    console.log(`${state} **@${review.user}** (${review.state}) - ${time}`);
+                    if (review.body) {
+                        console.log(`> ${review.body.split('\n').join('\n> ')}\n`);
+                    }
+                }
+            }
+            if (data.reviewComments.length > 0) {
+                console.log('### Inline Comments (newest first)\n');
+                for (const comment of data.reviewComments) {
+                    const time = formatRelativeTime(comment.createdAt);
+                    console.log(`**@${comment.user}** on \`${comment.path}\` - ${time}`);
+                    console.log(`> ${comment.body.split('\n').join('\n> ')}`);
+                    console.log('');
+                }
+            }
+            if (data.issueComments.length > 0) {
+                console.log('### Discussion (newest first)\n');
+                for (const comment of data.issueComments) {
+                    const time = formatRelativeTime(comment.createdAt);
+                    console.log(`**@${comment.user}** - ${time}`);
+                    console.log(`> ${comment.body?.split('\n').join('\n> ')}\n`);
+                }
+            }
+            if (data.reviewComments.length === 0 && data.issueComments.length === 0 && data.reviews.length === 0) {
+                console.log('No comments from other users.\n');
+            }
+            console.log('---');
+            console.log(`**Summary:** ${data.summary.reviewCount} reviews, ${data.summary.inlineCommentCount} inline comments, ${data.summary.discussionCommentCount} discussion comments`);
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Post command
 program
@@ -136,9 +326,30 @@ program
     .option('--stdin', 'Read message from stdin')
     .option('--json', 'Output as JSON')
     .action(async (url, messageParts, options) => {
-    const { runPost } = await import('./commands/comments.js');
-    const message = options.stdin ? undefined : messageParts.join(' ');
-    await runPost({ url, message, stdin: options.stdin, json: options.json });
+    try {
+        let message;
+        if (options.stdin) {
+            const chunks = [];
+            for await (const chunk of process.stdin) {
+                chunks.push(chunk);
+            }
+            message = Buffer.concat(chunks).toString('utf-8').trim();
+        }
+        else {
+            message = messageParts.join(' ');
+        }
+        const { runPost } = await import('./commands/comments.js');
+        const data = await runPost({ url, message });
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            console.log(`Comment posted: ${data.commentUrl}`);
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Claim command
 program
@@ -146,9 +357,20 @@ program
     .description('Claim an issue by posting a comment')
     .option('--json', 'Output as JSON')
     .action(async (issueUrl, messageParts, options) => {
-    const { runClaim } = await import('./commands/comments.js');
-    const message = messageParts.length > 0 ? messageParts.join(' ') : undefined;
-    await runClaim({ issueUrl, message, json: options.json });
+    try {
+        const { runClaim } = await import('./commands/comments.js');
+        const message = messageParts.length > 0 ? messageParts.join(' ') : undefined;
+        const data = await runClaim({ issueUrl, message });
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            console.log(`Issue claimed: ${data.commentUrl}`);
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Config command
 program
@@ -156,8 +378,23 @@ program
     .description('Show or update configuration')
     .option('--json', 'Output as JSON')
     .action(async (key, value, options) => {
-    const { runConfig } = await import('./commands/config.js');
-    await runConfig({ key, value, json: options.json });
+    try {
+        const { runConfig } = await import('./commands/config.js');
+        const data = await runConfig({ key, value });
+        if (options.json) {
+            outputJson(data);
+        }
+        else if ('config' in data) {
+            console.log('\n\u2699\ufe0f Current Configuration:\n');
+            console.log(JSON.stringify(data.config, null, 2));
+        }
+        else {
+            console.log(`Set ${data.key} to: ${data.value}`);
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Init command
 program
@@ -165,8 +402,20 @@ program
     .description('Initialize with your GitHub username and import open PRs')
     .option('--json', 'Output as JSON')
     .action(async (username, options) => {
-    const { runInit } = await import('./commands/init.js');
-    await runInit({ username, json: options.json });
+    try {
+        const { runInit } = await import('./commands/init.js');
+        const data = await runInit({ username });
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            console.log(`\nUsername set to @${data.username}.`);
+            console.log('Run `oss-autopilot daily` to fetch your open PRs from GitHub.');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Setup command
 program
@@ -176,8 +425,64 @@ program
     .option('--set <settings...>', 'Set specific values (key=value)')
     .option('--json', 'Output as JSON')
     .action(async (options) => {
-    const { runSetup } = await import('./commands/setup.js');
-    await runSetup({ reset: options.reset, set: options.set, json: options.json });
+    try {
+        const { runSetup } = await import('./commands/setup.js');
+        const data = await runSetup({ reset: options.reset, set: options.set });
+        if (options.json) {
+            outputJson(data);
+        }
+        else if ('success' in data) {
+            // --set mode
+            for (const [key, value] of Object.entries(data.settings)) {
+                console.log(`\u2713 ${key}: ${value}`);
+            }
+            if (data.warnings) {
+                for (const w of data.warnings) {
+                    console.warn(w);
+                }
+            }
+        }
+        else if ('setupComplete' in data && data.setupComplete) {
+            // Already complete
+            console.log('\n\u2699\ufe0f  OSS Autopilot Setup\n');
+            console.log('\u2713 Setup already complete!\n');
+            console.log('Current settings:');
+            console.log(`  GitHub username:    ${data.config.githubUsername || '(not set)'}`);
+            console.log(`  Max active PRs:     ${data.config.maxActivePRs}`);
+            console.log(`  Dormant threshold:  ${data.config.dormantThresholdDays} days`);
+            console.log(`  Approaching dormant: ${data.config.approachingDormantDays} days`);
+            console.log(`  Languages:          ${data.config.languages.join(', ')}`);
+            console.log(`  Labels:             ${data.config.labels.join(', ')}`);
+            console.log(`\nRun 'setup --reset' to reconfigure.`);
+        }
+        else if ('setupRequired' in data) {
+            // Needs setup
+            console.log('\n\u2699\ufe0f  OSS Autopilot Setup\n');
+            console.log('SETUP_REQUIRED');
+            console.log('---');
+            console.log('Please configure the following settings:\n');
+            for (const prompt of data.prompts) {
+                console.log(`SETTING: ${prompt.setting}`);
+                console.log(`PROMPT: ${prompt.prompt}`);
+                const currentVal = Array.isArray(prompt.current) ? prompt.current.join(', ') : prompt.current;
+                console.log(`CURRENT: ${currentVal ?? '(not set)'}`);
+                if (prompt.required)
+                    console.log('REQUIRED: true');
+                if (prompt.default !== undefined) {
+                    const defaultVal = Array.isArray(prompt.default) ? prompt.default.join(', ') : prompt.default;
+                    console.log(`DEFAULT: ${defaultVal}`);
+                }
+                if (prompt.type)
+                    console.log(`TYPE: ${prompt.type}`);
+                console.log('');
+            }
+            console.log('---');
+            console.log('END_SETUP_PROMPTS');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Check setup command
 program
@@ -185,13 +490,42 @@ program
     .description('Check if setup is complete')
     .option('--json', 'Output as JSON')
     .action(async (options) => {
-    const { runCheckSetup } = await import('./commands/setup.js');
-    await runCheckSetup({ json: options.json });
+    try {
+        const { runCheckSetup } = await import('./commands/setup.js');
+        const data = await runCheckSetup();
+        if (options.json) {
+            outputJson(data);
+        }
+        else if (data.setupComplete) {
+            console.log('SETUP_COMPLETE');
+            console.log(`username=${data.username}`);
+        }
+        else {
+            console.log('SETUP_INCOMPLETE');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
+});
+// Dashboard commands
+const dashboardCmd = program.command('dashboard').description('Dashboard commands');
+dashboardCmd
+    .command('serve')
+    .description('Start interactive dashboard server')
+    .option('--port <port>', 'Port to listen on', '3000')
+    .option('--no-open', 'Do not open browser automatically')
+    .action(async (options) => {
+    const port = parseInt(options.port, 10);
+    if (isNaN(port) || port < 1 || port > 65535) {
+        console.error(`Invalid port number: "${options.port}". Must be an integer between 1 and 65535.`);
+        process.exit(1);
+    }
+    const { serveDashboard } = await import('./commands/dashboard.js');
+    await serveDashboard({ port, open: options.open });
 });
-// Dashboard command
-program
-    .command('dashboard')
-    .description('Generate HTML stats dashboard')
+// 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)')
@@ -205,8 +539,34 @@ program
     .description('Parse a markdown issue list into structured JSON')
     .option('--json', 'Output as JSON')
     .action(async (filePath, options) => {
-    const { runParseList } = await import('./commands/parse-list.js');
-    await runParseList({ filePath, json: options.json });
+    try {
+        const { runParseList } = await import('./commands/parse-list.js');
+        const data = await runParseList({ filePath });
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            const path = await import('path');
+            const resolvedPath = path.resolve(filePath);
+            console.log(`\n\ud83d\udccb Issue List: ${resolvedPath}\n`);
+            console.log(`Available: ${data.availableCount} | Completed: ${data.completedCount}\n`);
+            if (data.available.length > 0) {
+                console.log('--- Available ---');
+                for (const item of data.available) {
+                    console.log(`  [${item.tier}] ${item.repo}#${item.number}: ${item.title}`);
+                }
+            }
+            if (data.completed.length > 0) {
+                console.log('\n--- Completed ---');
+                for (const item of data.completed) {
+                    console.log(`  [${item.tier}] ${item.repo}#${item.number}: ${item.title}`);
+                }
+            }
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Check integration command (#83)
 program
@@ -215,8 +575,36 @@ program
     .option('--base <branch>', 'Base branch to compare against', 'main')
     .option('--json', 'Output as JSON')
     .action(async (options) => {
-    const { runCheckIntegration } = await import('./commands/check-integration.js');
-    await runCheckIntegration({ base: options.base, json: options.json });
+    try {
+        const { runCheckIntegration } = await import('./commands/check-integration.js');
+        const data = await runCheckIntegration({ base: options.base });
+        if (options.json) {
+            outputJson(data);
+        }
+        else if (data.newFiles.length === 0) {
+            console.log('\nNo new code files to check.');
+        }
+        else {
+            console.log(`\n\ud83d\udd0d Integration Check (base: ${options.base})\n`);
+            console.log(`New files: ${data.newFiles.length} | Unreferenced: ${data.unreferencedCount}\n`);
+            for (const file of data.newFiles) {
+                const status = file.isIntegrated ? '\u2705' : '\u26a0\ufe0f';
+                console.log(`${status} ${file.path}`);
+                if (file.isIntegrated) {
+                    console.log(`   Referenced by: ${file.referencedBy.join(', ')}`);
+                }
+                else {
+                    console.log('   Not referenced by any file');
+                    if (file.suggestedEntryPoints && file.suggestedEntryPoints.length > 0) {
+                        console.log(`   Suggested entry points: ${file.suggestedEntryPoints.join(', ')}`);
+                    }
+                }
+            }
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Local repos command (#84)
 program
@@ -226,8 +614,24 @@ program
     .option('--paths <dirs...>', 'Directories to scan')
     .option('--json', 'Output as JSON')
     .action(async (options) => {
-    const { runLocalRepos } = await import('./commands/local-repos.js');
-    await runLocalRepos({ scan: options.scan, paths: options.paths, json: options.json });
+    try {
+        const { runLocalRepos } = await import('./commands/local-repos.js');
+        const data = await runLocalRepos({ scan: options.scan, paths: options.paths });
+        if (options.json) {
+            outputJson(data);
+        }
+        else if (data.fromCache) {
+            console.log(`\n\ud83d\udcc1 Local Repos (cached ${data.cachedAt})\n`);
+            printRepos(data.repos);
+        }
+        else {
+            console.log(`Found ${Object.keys(data.repos).length} repos:\n`);
+            printRepos(data.repos);
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Startup command (combines auth, setup, daily, dashboard, issue list)
 program
@@ -235,8 +639,30 @@ program
     .description('Run all pre-flight checks and daily fetch in one call')
     .option('--json', 'Output as JSON')
     .action(async (options) => {
-    const { runStartup } = await import('./commands/startup.js');
-    await runStartup({ json: options.json });
+    try {
+        const { runStartup } = await import('./commands/startup.js');
+        const data = await runStartup();
+        if (options.json) {
+            outputJson(data);
+        }
+        else {
+            if (!data.setupComplete) {
+                console.log('Setup incomplete. Run /setup-oss first.');
+            }
+            else if (data.authError) {
+                console.error(`Error: ${data.authError}`);
+            }
+            else {
+                console.log(`OSS Autopilot v${data.version}`);
+                console.log(data.daily?.briefSummary ?? '');
+                if (data.dashboardPath)
+                    console.log(`Dashboard: ${data.dashboardPath}`);
+            }
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Shelve command
 program
@@ -244,8 +670,24 @@ program
     .description('Shelve a PR (exclude from capacity and actionable issues)')
     .option('--json', 'Output as JSON')
     .action(async (prUrl, options) => {
-    const { runShelve } = await import('./commands/shelve.js');
-    await runShelve({ prUrl, json: options.json });
+    try {
+        const { runShelve } = await import('./commands/shelve.js');
+        const data = await runShelve({ prUrl });
+        if (options.json) {
+            outputJson(data);
+        }
+        else if (data.shelved) {
+            console.log(`Shelved: ${prUrl}`);
+            console.log('This PR is now excluded from capacity and actionable issues.');
+            console.log('It will auto-unshelve if a maintainer engages.');
+        }
+        else {
+            console.log('PR is already shelved.');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Unshelve command
 program
@@ -253,8 +695,23 @@ program
     .description('Unshelve a PR (include in capacity and actionable issues again)')
     .option('--json', 'Output as JSON')
     .action(async (prUrl, options) => {
-    const { runUnshelve } = await import('./commands/shelve.js');
-    await runUnshelve({ prUrl, json: options.json });
+    try {
+        const { runUnshelve } = await import('./commands/shelve.js');
+        const data = await runUnshelve({ prUrl });
+        if (options.json) {
+            outputJson(data);
+        }
+        else if (data.unshelved) {
+            console.log(`Unshelved: ${prUrl}`);
+            console.log('This PR is now active again.');
+        }
+        else {
+            console.log('PR was not shelved.');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Dismiss command
 program
@@ -262,8 +719,24 @@ program
     .description('Dismiss issue reply notifications (resurfaces on new activity)')
     .option('--json', 'Output as JSON')
     .action(async (issueUrl, options) => {
-    const { runDismiss } = await import('./commands/dismiss.js');
-    await runDismiss({ issueUrl, json: options.json });
+    try {
+        const { runDismiss } = await import('./commands/dismiss.js');
+        const data = await runDismiss({ issueUrl });
+        if (options.json) {
+            outputJson(data);
+        }
+        else if (data.dismissed) {
+            console.log(`Dismissed: ${issueUrl}`);
+            console.log('Issue reply notifications are now muted.');
+            console.log('New responses after this point will resurface automatically.');
+        }
+        else {
+            console.log('Issue is already dismissed.');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Undismiss command
 program
@@ -271,8 +744,23 @@ program
     .description('Undismiss an issue (re-enable reply notifications)')
     .option('--json', 'Output as JSON')
     .action(async (issueUrl, options) => {
-    const { runUndismiss } = await import('./commands/dismiss.js');
-    await runUndismiss({ issueUrl, json: options.json });
+    try {
+        const { runUndismiss } = await import('./commands/dismiss.js');
+        const data = await runUndismiss({ issueUrl });
+        if (options.json) {
+            outputJson(data);
+        }
+        else if (data.undismissed) {
+            console.log(`Undismissed: ${issueUrl}`);
+            console.log('Issue reply notifications are active again.');
+        }
+        else {
+            console.log('Issue was not dismissed.');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Snooze command
 program
@@ -282,8 +770,29 @@ program
     .option('--days <days>', 'Number of days to snooze (default: 7)', '7')
     .option('--json', 'Output as JSON')
     .action(async (prUrl, options) => {
-    const { runSnooze } = await import('./commands/snooze.js');
-    await runSnooze({ prUrl, reason: options.reason, days: parseInt(options.days, 10), json: options.json });
+    try {
+        const { runSnooze } = await import('./commands/snooze.js');
+        const data = await runSnooze({ prUrl, reason: options.reason, days: parseInt(options.days, 10) });
+        if (options.json) {
+            outputJson(data);
+        }
+        else if (data.snoozed) {
+            console.log(`Snoozed: ${prUrl}`);
+            console.log(`Reason: ${data.reason}`);
+            console.log(`Duration: ${data.days} day${data.days === 1 ? '' : 's'}`);
+            console.log(`Expires: ${data.expiresAt ? new Date(data.expiresAt).toLocaleString() : 'unknown'}`);
+            console.log('CI failure notifications are now muted for this PR.');
+        }
+        else {
+            console.log('PR is already snoozed.');
+            if (data.expiresAt) {
+                console.log(`Expires: ${new Date(data.expiresAt).toLocaleString()}`);
+            }
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Unsnooze command
 program
@@ -291,8 +800,23 @@ program
     .description('Unsnooze a PR (re-enable CI failure notifications)')
     .option('--json', 'Output as JSON')
     .action(async (prUrl, options) => {
-    const { runUnsnooze } = await import('./commands/snooze.js');
-    await runUnsnooze({ prUrl, json: options.json });
+    try {
+        const { runUnsnooze } = await import('./commands/snooze.js');
+        const data = await runUnsnooze({ prUrl });
+        if (options.json) {
+            outputJson(data);
+        }
+        else if (data.unsnoozed) {
+            console.log(`Unsnoozed: ${prUrl}`);
+            console.log('CI failure notifications are active again for this PR.');
+        }
+        else {
+            console.log('PR was not snoozed.');
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options.json);
+    }
 });
 // Validate GitHub token before running commands that need it
 program.hook('preAction', async (thisCommand, actionCommand) => {