@oss-autopilot/core 0.41.0 → 0.42.1

package/dist/commands/setup.d.ts

@@ -5,11 +5,40 @@
 interface SetupOptions {
     reset?: boolean;
     set?: string[];
-    json?: boolean;
 }
-interface CheckSetupOptions {
-    json?: boolean;
+export interface SetupSetOutput {
+    success: true;
+    settings: Record<string, string>;
+    warnings?: string[];
 }
-export declare function runSetup(options: SetupOptions): Promise<void>;
-export declare function runCheckSetup(options: CheckSetupOptions): Promise<void>;
+export interface SetupCompleteOutput {
+    setupComplete: true;
+    config: {
+        githubUsername: string;
+        maxActivePRs: number;
+        dormantThresholdDays: number;
+        approachingDormantDays: number;
+        languages: string[];
+        labels: string[];
+    };
+}
+export interface SetupPrompt {
+    setting: string;
+    prompt: string;
+    current: string | number | string[] | null;
+    required?: boolean;
+    default?: string | number | string[];
+    type?: string;
+}
+export interface SetupRequiredOutput {
+    setupRequired: true;
+    prompts: SetupPrompt[];
+}
+export type SetupOutput = SetupSetOutput | SetupCompleteOutput | SetupRequiredOutput;
+export interface CheckSetupOutput {
+    setupComplete: boolean;
+    username: string;
+}
+export declare function runSetup(options: SetupOptions): Promise<SetupOutput>;
+export declare function runCheckSetup(): Promise<CheckSetupOutput>;
 export {};

package/dist/commands/setup.js

@@ -3,7 +3,6 @@
  * Interactive setup / configuration
  */
 import { getStateManager, DEFAULT_CONFIG } from '../core/index.js';
-import { outputJson } from '../formatters/json.js';
 import { validateGitHubUsername } from './validation.js';
 export async function runSetup(options) {
     const stateManager = getStateManager();
@@ -11,6 +10,7 @@ export async function runSetup(options) {
     // Handle --set mode: apply settings directly
     if (options.set && options.set.length > 0) {
         const results = {};
+        const warnings = [];
         for (const setting of options.set) {
             const [key, ...valueParts] = setting.split('=');
             const value = valueParts.join('=');
@@ -81,15 +81,11 @@ export async function runSetup(options) {
                         }
                     }
                     if (invalid.length > 0) {
-                        if (!options.json) {
-                            console.warn(`Warning: Skipping invalid entries (expected "owner/repo" format): ${invalid.join(', ')}`);
-                        }
+                        warnings.push(`Warning: Skipping invalid entries (expected "owner/repo" format): ${invalid.join(', ')}`);
                         results['aiPolicyBlocklist_invalidEntries'] = invalid.join(', ');
                     }
                     if (valid.length === 0 && entries.length > 0) {
-                        if (!options.json) {
-                            console.warn('Warning: All entries were invalid. Blocklist not updated.');
-                        }
+                        warnings.push('Warning: All entries were invalid. Blocklist not updated.');
                         results[key] = '(all entries invalid)';
                         break;
                     }
@@ -104,173 +100,86 @@ export async function runSetup(options) {
                     }
                     break;
                 default:
-                    if (!options.json) {
-                        console.warn(`Unknown setting: ${key}`);
-                    }
+                    warnings.push(`Unknown setting: ${key}`);
             }
         }
         stateManager.save();
-        if (options.json) {
-            outputJson({ success: true, settings: results });
-        }
-        else {
-            for (const [key, value] of Object.entries(results)) {
-                console.log(`✓ ${key}: ${value}`);
-            }
-        }
-        return;
+        return { success: true, settings: results, warnings: warnings.length > 0 ? warnings : undefined };
     }
     // Show setup status
     if (config.setupComplete && !options.reset) {
-        if (options.json) {
-            outputJson({
-                setupComplete: true,
-                config: {
-                    githubUsername: config.githubUsername,
-                    maxActivePRs: config.maxActivePRs,
-                    dormantThresholdDays: config.dormantThresholdDays,
-                    approachingDormantDays: config.approachingDormantDays,
-                    languages: config.languages,
-                    labels: config.labels,
-                },
-            });
-        }
-        else {
-            console.log('\n⚙️  OSS Autopilot Setup\n');
-            console.log('✓ Setup already complete!\n');
-            console.log('Current settings:');
-            console.log(`  GitHub username:    ${config.githubUsername || '(not set)'}`);
-            console.log(`  Max active PRs:     ${config.maxActivePRs}`);
-            console.log(`  Dormant threshold:  ${config.dormantThresholdDays} days`);
-            console.log(`  Approaching dormant: ${config.approachingDormantDays} days`);
-            console.log(`  Languages:          ${config.languages.join(', ')}`);
-            console.log(`  Labels:             ${config.labels.join(', ')}`);
-            console.log(`\nRun 'setup --reset' to reconfigure.`);
-        }
-        return;
+        return {
+            setupComplete: true,
+            config: {
+                githubUsername: config.githubUsername,
+                maxActivePRs: config.maxActivePRs,
+                dormantThresholdDays: config.dormantThresholdDays,
+                approachingDormantDays: config.approachingDormantDays,
+                languages: config.languages,
+                labels: config.labels,
+            },
+        };
     }
     // Output setup prompts
-    if (options.json) {
-        outputJson({
-            setupRequired: true,
-            prompts: [
-                {
-                    setting: 'username',
-                    prompt: 'What is your GitHub username?',
-                    current: config.githubUsername || null,
-                    required: true,
-                    type: 'string',
-                },
-                {
-                    setting: 'maxActivePRs',
-                    prompt: 'How many PRs do you want to work on at once?',
-                    current: config.maxActivePRs,
-                    default: 10,
-                    type: 'number',
-                },
-                {
-                    setting: 'dormantDays',
-                    prompt: 'After how many days of inactivity should a PR be considered dormant?',
-                    current: config.dormantThresholdDays,
-                    default: 30,
-                    type: 'number',
-                },
-                {
-                    setting: 'approachingDays',
-                    prompt: 'At how many days should we warn about approaching dormancy?',
-                    current: config.approachingDormantDays,
-                    default: 25,
-                    type: 'number',
-                },
-                {
-                    setting: 'languages',
-                    prompt: 'What programming languages do you want to contribute to?',
-                    current: config.languages,
-                    default: ['typescript', 'javascript'],
-                    type: 'list',
-                },
-                {
-                    setting: 'labels',
-                    prompt: 'What issue labels should we search for?',
-                    current: config.labels,
-                    default: ['good first issue', 'help wanted'],
-                    type: 'list',
-                },
-                {
-                    setting: 'aiPolicyBlocklist',
-                    prompt: 'Repos with anti-AI contribution policies to block (owner/repo, comma-separated)?',
-                    current: config.aiPolicyBlocklist ?? DEFAULT_CONFIG.aiPolicyBlocklist,
-                    default: ['matplotlib/matplotlib'],
-                    type: 'list',
-                },
-            ],
-        });
-    }
-    else {
-        console.log('\n⚙️  OSS Autopilot Setup\n');
-        console.log('SETUP_REQUIRED');
-        console.log('---');
-        console.log('Please configure the following settings:\n');
-        console.log('SETTING: username');
-        console.log('PROMPT: What is your GitHub username?');
-        console.log(`CURRENT: ${config.githubUsername || '(not set)'}`);
-        console.log('REQUIRED: true');
-        console.log('');
-        console.log('SETTING: maxActivePRs');
-        console.log('PROMPT: How many PRs do you want to work on at once?');
-        console.log(`CURRENT: ${config.maxActivePRs}`);
-        console.log('DEFAULT: 10');
-        console.log('TYPE: number');
-        console.log('');
-        console.log('SETTING: dormantDays');
-        console.log('PROMPT: After how many days of inactivity should a PR be considered dormant?');
-        console.log(`CURRENT: ${config.dormantThresholdDays}`);
-        console.log('DEFAULT: 30');
-        console.log('TYPE: number');
-        console.log('');
-        console.log('SETTING: approachingDays');
-        console.log('PROMPT: At how many days should we warn about approaching dormancy?');
-        console.log(`CURRENT: ${config.approachingDormantDays}`);
-        console.log('DEFAULT: 25');
-        console.log('TYPE: number');
-        console.log('');
-        console.log('SETTING: languages');
-        console.log('PROMPT: What programming languages do you want to contribute to? (comma-separated)');
-        console.log(`CURRENT: ${config.languages.join(', ')}`);
-        console.log('DEFAULT: typescript, javascript');
-        console.log('TYPE: list');
-        console.log('');
-        console.log('SETTING: labels');
-        console.log('PROMPT: What issue labels should we search for? (comma-separated)');
-        console.log(`CURRENT: ${config.labels.join(', ')}`);
-        console.log('DEFAULT: good first issue, help wanted');
-        console.log('TYPE: list');
-        console.log('');
-        console.log('SETTING: aiPolicyBlocklist');
-        console.log('PROMPT: Repos with anti-AI contribution policies to block? (owner/repo, comma-separated)');
-        console.log(`CURRENT: ${(config.aiPolicyBlocklist ?? DEFAULT_CONFIG.aiPolicyBlocklist ?? []).join(', ')}`);
-        console.log('DEFAULT: matplotlib/matplotlib');
-        console.log('TYPE: list');
-        console.log('');
-        console.log('---');
-        console.log('END_SETUP_PROMPTS');
-    }
+    return {
+        setupRequired: true,
+        prompts: [
+            {
+                setting: 'username',
+                prompt: 'What is your GitHub username?',
+                current: config.githubUsername || null,
+                required: true,
+                type: 'string',
+            },
+            {
+                setting: 'maxActivePRs',
+                prompt: 'How many PRs do you want to work on at once?',
+                current: config.maxActivePRs,
+                default: 10,
+                type: 'number',
+            },
+            {
+                setting: 'dormantDays',
+                prompt: 'After how many days of inactivity should a PR be considered dormant?',
+                current: config.dormantThresholdDays,
+                default: 30,
+                type: 'number',
+            },
+            {
+                setting: 'approachingDays',
+                prompt: 'At how many days should we warn about approaching dormancy?',
+                current: config.approachingDormantDays,
+                default: 25,
+                type: 'number',
+            },
+            {
+                setting: 'languages',
+                prompt: 'What programming languages do you want to contribute to?',
+                current: config.languages,
+                default: ['typescript', 'javascript'],
+                type: 'list',
+            },
+            {
+                setting: 'labels',
+                prompt: 'What issue labels should we search for?',
+                current: config.labels,
+                default: ['good first issue', 'help wanted'],
+                type: 'list',
+            },
+            {
+                setting: 'aiPolicyBlocklist',
+                prompt: 'Repos with anti-AI contribution policies to block (owner/repo, comma-separated)?',
+                current: config.aiPolicyBlocklist ?? DEFAULT_CONFIG.aiPolicyBlocklist ?? null,
+                default: ['matplotlib/matplotlib'],
+                type: 'list',
+            },
+        ],
+    };
 }
-export async function runCheckSetup(options) {
+export async function runCheckSetup() {
     const stateManager = getStateManager();
-    if (options.json) {
-        outputJson({
-            setupComplete: stateManager.isSetupComplete(),
-            username: stateManager.getState().config.githubUsername,
-        });
-    }
-    else {
-        if (stateManager.isSetupComplete()) {
-            console.log('SETUP_COMPLETE');
-            console.log(`username=${stateManager.getState().config.githubUsername}`);
-        }
-        else {
-            console.log('SETUP_INCOMPLETE');
-        }
-    }
+    return {
+        setupComplete: stateManager.isSetupComplete(),
+        username: stateManager.getState().config.githubUsername,
+    };
 }

package/dist/commands/shelve.d.ts

@@ -4,10 +4,18 @@
  * Shelved PRs are auto-unshelved when a maintainer engages.
  */
 import { PR_URL_PATTERN } from './validation.js';
-interface ShelveCommandOptions {
-    prUrl: string;
-    json?: boolean;
+export interface ShelveOutput {
+    shelved: boolean;
+    url: string;
+}
+export interface UnshelveOutput {
+    unshelved: boolean;
+    url: string;
 }
 export { PR_URL_PATTERN };
-export declare function runShelve(options: ShelveCommandOptions): Promise<void>;
-export declare function runUnshelve(options: ShelveCommandOptions): Promise<void>;
+export declare function runShelve(options: {
+    prUrl: string;
+}): Promise<ShelveOutput>;
+export declare function runUnshelve(options: {
+    prUrl: string;
+}): Promise<UnshelveOutput>;

package/dist/commands/shelve.js

@@ -4,46 +4,26 @@
  * Shelved PRs are auto-unshelved when a maintainer engages.
  */
 import { getStateManager } from '../core/index.js';
-import { outputJson } from '../formatters/json.js';
 import { PR_URL_PATTERN, validateGitHubUrl, validateUrl } from './validation.js';
 // Re-export for backward compatibility with tests
 export { PR_URL_PATTERN };
 export async function runShelve(options) {
     validateUrl(options.prUrl);
-    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR', options.json);
+    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR');
     const stateManager = getStateManager();
     const added = stateManager.shelvePR(options.prUrl);
     if (added) {
         stateManager.save();
     }
-    if (options.json) {
-        outputJson({ shelved: added, url: options.prUrl });
-    }
-    else if (added) {
-        console.log(`Shelved: ${options.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.');
-    }
+    return { shelved: added, url: options.prUrl };
 }
 export async function runUnshelve(options) {
     validateUrl(options.prUrl);
-    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR', options.json);
+    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR');
     const stateManager = getStateManager();
     const removed = stateManager.unshelvePR(options.prUrl);
     if (removed) {
         stateManager.save();
     }
-    if (options.json) {
-        outputJson({ unshelved: removed, url: options.prUrl });
-    }
-    else if (removed) {
-        console.log(`Unshelved: ${options.prUrl}`);
-        console.log('This PR is now active again.');
-    }
-    else {
-        console.log('PR was not shelved.');
-    }
+    return { unshelved: removed, url: options.prUrl };
 }

package/dist/commands/snooze.d.ts

@@ -3,16 +3,22 @@
  * Manages snoozing CI failure notifications for PRs with known upstream/infrastructure issues.
  * Snoozed PRs are excluded from the actionable CI failure list until the snooze expires.
  */
-interface SnoozeCommandOptions {
+export interface SnoozeOutput {
+    snoozed: boolean;
+    url: string;
+    days: number;
+    reason: string;
+    expiresAt: string | undefined;
+}
+export interface UnsnoozeOutput {
+    unsnoozed: boolean;
+    url: string;
+}
+export declare function runSnooze(options: {
     prUrl: string;
     reason: string;
     days?: number;
-    json?: boolean;
-}
-interface UnsnoozeCommandOptions {
+}): Promise<SnoozeOutput>;
+export declare function runUnsnooze(options: {
     prUrl: string;
-    json?: boolean;
-}
-export declare function runSnooze(options: SnoozeCommandOptions): Promise<void>;
-export declare function runUnsnooze(options: UnsnoozeCommandOptions): Promise<void>;
-export {};
+}): Promise<UnsnoozeOutput>;

package/dist/commands/snooze.js

@@ -4,80 +4,37 @@
  * Snoozed PRs are excluded from the actionable CI failure list until the snooze expires.
  */
 import { getStateManager } from '../core/index.js';
-import { outputJson, outputJsonError } from '../formatters/json.js';
 import { PR_URL_PATTERN, validateGitHubUrl, validateUrl, validateMessage } from './validation.js';
 const DEFAULT_SNOOZE_DAYS = 7;
 export async function runSnooze(options) {
     validateUrl(options.prUrl);
-    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR', options.json);
+    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR');
     validateMessage(options.reason);
     const days = options.days ?? DEFAULT_SNOOZE_DAYS;
     if (!Number.isFinite(days) || days <= 0) {
-        if (options.json) {
-            outputJsonError('Snooze duration must be a positive number of days.');
-        }
-        else {
-            console.error('Error: Snooze duration must be a positive number of days.');
-        }
-        process.exit(1);
+        throw new Error('Snooze duration must be a positive number of days.');
     }
-    try {
-        const stateManager = getStateManager();
-        const added = stateManager.snoozePR(options.prUrl, options.reason, days);
-        if (added) {
-            stateManager.save();
-        }
-        const snoozeInfo = stateManager.getSnoozeInfo(options.prUrl);
-        if (options.json) {
-            outputJson({
-                snoozed: added,
-                url: options.prUrl,
-                days,
-                reason: options.reason,
-                expiresAt: snoozeInfo?.expiresAt,
-            });
-        }
-        else if (added) {
-            console.log(`Snoozed: ${options.prUrl}`);
-            console.log(`Reason: ${options.reason}`);
-            console.log(`Duration: ${days} day${days === 1 ? '' : 's'}`);
-            console.log(`Expires: ${snoozeInfo?.expiresAt ? new Date(snoozeInfo.expiresAt).toLocaleString() : 'unknown'}`);
-            console.log('CI failure notifications are now muted for this PR.');
-        }
-        else {
-            console.log('PR is already snoozed.');
-            if (snoozeInfo) {
-                console.log(`Expires: ${new Date(snoozeInfo.expiresAt).toLocaleString()}`);
-            }
-        }
-    }
-    catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        if (options.json) {
-            outputJsonError(`Snooze failed: ${msg}`);
-        }
-        else {
-            console.error(`Error: Snooze failed: ${msg}`);
-        }
-        process.exit(1);
+    const stateManager = getStateManager();
+    const added = stateManager.snoozePR(options.prUrl, options.reason, days);
+    if (added) {
+        stateManager.save();
     }
+    const snoozeInfo = stateManager.getSnoozeInfo(options.prUrl);
+    return {
+        snoozed: added,
+        url: options.prUrl,
+        days,
+        reason: options.reason,
+        expiresAt: snoozeInfo?.expiresAt,
+    };
 }
 export async function runUnsnooze(options) {
     validateUrl(options.prUrl);
-    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR', options.json);
+    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR');
     const stateManager = getStateManager();
     const removed = stateManager.unsnoozePR(options.prUrl);
     if (removed) {
         stateManager.save();
     }
-    if (options.json) {
-        outputJson({ unsnoozed: removed, url: options.prUrl });
-    }
-    else if (removed) {
-        console.log(`Unsnoozed: ${options.prUrl}`);
-        console.log('CI failure notifications are active again for this PR.');
-    }
-    else {
-        console.log('PR was not snoozed.');
-    }
+    return { unsnoozed: removed, url: options.prUrl };
 }

package/dist/commands/startup.d.ts

@@ -6,10 +6,7 @@
  * 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 { type IssueListInfo } from '../formatters/json.js';
-interface StartupOptions {
-    json?: boolean;
-}
+import { type StartupOutput, type IssueListInfo } from '../formatters/json.js';
 /**
  * Parse issueListPath from a config file's YAML frontmatter.
  * Returns the path string or undefined if not found.
@@ -29,5 +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 runStartup(options: StartupOptions): Promise<void>;
-export {};
+/**
+ * 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?, issueList? }
+ *
+ * Errors from the daily check propagate to the caller.
+ */
+export declare function runStartup(): Promise<StartupOutput>;