@oss-autopilot/core 0.41.0 → 0.42.0

package/dist/commands/status.js

@@ -3,7 +3,6 @@
  * Shows current status and stats
  */
 import { getStateManager } from '../core/index.js';
-import { outputJson } from '../formatters/json.js';
 export async function runStatus(options) {
     const stateManager = getStateManager();
     const stats = stateManager.getStats();
@@ -11,33 +10,15 @@ export async function runStatus(options) {
     // Status always reads from local state (no API calls), so offline mode
     // simply adds metadata about cache freshness.
     const lastUpdated = state.lastDigestAt || state.lastRunAt;
-    if (options.json) {
-        // Extract only the stats we want to output (exclude totalTracked)
-        const { totalTracked: _totalTracked, ...outputStats } = stats;
-        const output = {
-            stats: outputStats,
-            lastRunAt: state.lastRunAt,
-        };
-        if (options.offline) {
-            output.offline = true;
-            output.lastUpdated = lastUpdated;
-        }
-        outputJson(output);
-    }
-    else {
-        // Simple console output
-        console.log('\n📊 OSS Status\n');
-        console.log(`Merged PRs: ${stats.mergedPRs}`);
-        console.log(`Closed PRs: ${stats.closedPRs}`);
-        console.log(`Merge Rate: ${stats.mergeRate}`);
-        console.log(`Needs Response: ${stats.needsResponse}`);
-        if (options.offline) {
-            console.log(`\nLast Updated: ${lastUpdated || 'Never'}`);
-            console.log('(Offline mode: showing cached data)');
-        }
-        else {
-            console.log(`\nLast Run: ${state.lastRunAt || 'Never'}`);
-        }
-        console.log('\nRun with --json for structured output');
+    // Extract only the stats we want to output (exclude totalTracked)
+    const { totalTracked: _totalTracked, ...outputStats } = stats;
+    const output = {
+        stats: outputStats,
+        lastRunAt: state.lastRunAt,
+    };
+    if (options.offline) {
+        output.offline = true;
+        output.lastUpdated = lastUpdated;
     }
+    return output;
 }

package/dist/commands/track.d.ts

@@ -3,14 +3,15 @@
  * In v2, PRs are fetched fresh from GitHub on each `daily` run.
  * These commands are preserved for backward compatibility.
  */
-interface TrackOptions {
-    prUrl: string;
-    json?: boolean;
+import type { TrackOutput } from '../formatters/json.js';
+export interface UntrackOutput {
+    removed: boolean;
+    url: string;
+    message: string;
 }
-interface UntrackOptions {
+export declare function runTrack(options: {
     prUrl: string;
-    json?: boolean;
-}
-export declare function runTrack(options: TrackOptions): Promise<void>;
-export declare function runUntrack(options: UntrackOptions): Promise<void>;
-export {};
+}): Promise<TrackOutput>;
+export declare function runUntrack(options: {
+    prUrl: string;
+}): Promise<UntrackOutput>;

package/dist/commands/track.js

@@ -3,57 +3,35 @@
  * In v2, PRs are fetched fresh from GitHub on each `daily` run.
  * These commands are preserved for backward compatibility.
  */
-import { getOctokit, getGitHubToken } from '../core/index.js';
-import { outputJson, outputJsonError } from '../formatters/json.js';
+import { getOctokit, requireGitHubToken } from '../core/index.js';
 import { validateUrl, PR_URL_PATTERN, validateGitHubUrl } from './validation.js';
 import { parseGitHubUrl } from '../core/utils.js';
 export async function runTrack(options) {
     validateUrl(options.prUrl);
-    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR', options.json);
-    // Token is guaranteed by the preAction hook in cli.ts for non-LOCAL_ONLY_COMMANDS.
-    const token = getGitHubToken();
+    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR');
+    const token = requireGitHubToken();
     const octokit = getOctokit(token);
     const parsed = parseGitHubUrl(options.prUrl);
     if (!parsed || parsed.type !== 'pull') {
-        if (options.json) {
-            outputJsonError(`Invalid PR URL: ${options.prUrl}`);
-        }
-        else {
-            console.error(`Error: Invalid PR URL: ${options.prUrl}`);
-        }
-        process.exit(1);
+        throw new Error(`Invalid PR URL: ${options.prUrl}`);
     }
     const { owner, repo, number } = parsed;
-    if (!options.json) {
-        console.log(`\n📌 Fetching PR: ${options.prUrl}\n`);
-    }
     const { data: ghPR } = await octokit.pulls.get({ owner, repo, pull_number: number });
-    const pr = {
-        repo: `${owner}/${repo}`,
-        number,
-        title: ghPR.title,
-        url: options.prUrl,
+    return {
+        pr: {
+            repo: `${owner}/${repo}`,
+            number,
+            title: ghPR.title,
+            url: options.prUrl,
+        },
     };
-    if (options.json) {
-        outputJson({ pr });
-    }
-    else {
-        console.log(`PR: ${pr.repo}#${pr.number} - ${pr.title}`);
-        console.log('Note: In v2, PRs are tracked automatically via the daily run.');
-    }
 }
 export async function runUntrack(options) {
     validateUrl(options.prUrl);
-    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR', options.json);
-    if (options.json) {
-        outputJson({
-            removed: false,
-            url: options.prUrl,
-            message: 'In v2, PRs are fetched fresh on each daily run — there is no local tracking list to remove from.',
-        });
-    }
-    else {
-        console.log('Note: In v2, PRs are fetched fresh on each daily run — there is no local tracking list to remove from.');
-        console.log('Use `shelve` to temporarily hide a PR from the daily summary.');
-    }
+    validateGitHubUrl(options.prUrl, PR_URL_PATTERN, 'PR');
+    return {
+        removed: false,
+        url: options.prUrl,
+        message: 'In v2, PRs are fetched fresh on each daily run — there is no local tracking list to remove from.',
+    };
 }

package/dist/commands/validation.d.ts

@@ -6,9 +6,9 @@ export declare const PR_URL_PATTERN: RegExp;
 /** Matches GitHub issue URLs: https://github.com/owner/repo/issues/123 */
 export declare const ISSUE_URL_PATTERN: RegExp;
 /**
- * Validate a GitHub URL against a pattern. Exits with error if invalid.
+ * Validate a GitHub URL against a pattern. Throws if invalid.
  */
-export declare function validateGitHubUrl(url: string, pattern: RegExp, entityType: 'PR' | 'issue', json?: boolean): void;
+export declare function validateGitHubUrl(url: string, pattern: RegExp, entityType: 'PR' | 'issue'): void;
 /**
  * Validate that a URL does not exceed the maximum allowed length.
  * Returns the URL if valid, throws if too long.

package/dist/commands/validation.js

@@ -2,7 +2,6 @@
  * Shared validation patterns and helpers for CLI commands.
  */
 import { ValidationError } from '../core/errors.js';
-import { outputJsonError } from '../formatters/json.js';
 /** Matches GitHub PR URLs: https://github.com/owner/repo/pull/123 */
 export const PR_URL_PATTERN = /^https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/\d+$/;
 /** Matches GitHub issue URLs: https://github.com/owner/repo/issues/123 */
@@ -16,20 +15,13 @@ const MAX_MESSAGE_LENGTH = 1000;
 /** Pattern for valid GitHub repository identifiers */
 const REPO_PATTERN = /^[a-zA-Z0-9._-]+\/[a-zA-Z0-9._-]+$/;
 /**
- * Validate a GitHub URL against a pattern. Exits with error if invalid.
+ * Validate a GitHub URL against a pattern. Throws if invalid.
  */
-export function validateGitHubUrl(url, pattern, entityType, json) {
+export function validateGitHubUrl(url, pattern, entityType) {
     if (pattern.test(url))
         return;
     const example = entityType === 'PR' ? 'https://github.com/owner/repo/pull/123' : 'https://github.com/owner/repo/issues/123';
-    const msg = `Invalid ${entityType} URL: ${url}. Expected format: ${example}`;
-    if (json) {
-        outputJsonError(msg);
-    }
-    else {
-        console.error(`Error: ${msg}`);
-    }
-    process.exit(1);
+    throw new Error(`Invalid ${entityType} URL: ${url}. Expected format: ${example}`);
 }
 /**
  * Validate that a URL does not exceed the maximum allowed length.

package/dist/commands/vet.d.ts

@@ -2,9 +2,9 @@
  * Vet command
  * Vets a specific issue before working on it
  */
+import { type VetOutput } from '../formatters/json.js';
+export { type VetOutput } from '../formatters/json.js';
 interface VetOptions {
     issueUrl: string;
-    json?: boolean;
 }
-export declare function runVet(options: VetOptions): Promise<void>;
-export {};
+export declare function runVet(options: VetOptions): Promise<VetOutput>;

package/dist/commands/vet.js

@@ -2,35 +2,25 @@
  * Vet command
  * Vets a specific issue before working on it
  */
-import { IssueDiscovery, getGitHubToken } from '../core/index.js';
-import { outputJson } from '../formatters/json.js';
+import { IssueDiscovery, requireGitHubToken } from '../core/index.js';
 import { validateUrl } from './validation.js';
 export async function runVet(options) {
     validateUrl(options.issueUrl);
-    // Token is guaranteed by the preAction hook in cli.ts for non-LOCAL_ONLY_COMMANDS.
-    const token = getGitHubToken();
+    const token = requireGitHubToken();
     const discovery = new IssueDiscovery(token);
-    if (!options.json) {
-        console.log(`\n🔍 Vetting issue: ${options.issueUrl}\n`);
-    }
     const candidate = await discovery.vetIssue(options.issueUrl);
-    if (options.json) {
-        outputJson({
-            issue: {
-                repo: candidate.issue.repo,
-                number: candidate.issue.number,
-                title: candidate.issue.title,
-                url: candidate.issue.url,
-                labels: candidate.issue.labels,
-            },
-            recommendation: candidate.recommendation,
-            reasonsToApprove: candidate.reasonsToApprove,
-            reasonsToSkip: candidate.reasonsToSkip,
-            projectHealth: candidate.projectHealth,
-            vettingResult: candidate.vettingResult,
-        });
-    }
-    else {
-        console.log(discovery.formatCandidate(candidate));
-    }
+    return {
+        issue: {
+            repo: candidate.issue.repo,
+            number: candidate.issue.number,
+            title: candidate.issue.title,
+            url: candidate.issue.url,
+            labels: candidate.issue.labels,
+        },
+        recommendation: candidate.recommendation,
+        reasonsToApprove: candidate.reasonsToApprove,
+        reasonsToSkip: candidate.reasonsToSkip,
+        projectHealth: candidate.projectHealth,
+        vettingResult: candidate.vettingResult,
+    };
 }

package/dist/formatters/json.d.ts

@@ -238,6 +238,64 @@ export interface CheckIntegrationOutput {
     newFiles: NewFileInfo[];
     unreferencedCount: number;
 }
+/** Output of the vet command */
+export interface VetOutput {
+    issue: {
+        repo: string;
+        number: number;
+        title: string;
+        url: string;
+        labels: string[];
+    };
+    recommendation: 'approve' | 'skip' | 'needs_review';
+    reasonsToApprove: string[];
+    reasonsToSkip: string[];
+    projectHealth: unknown;
+    vettingResult: unknown;
+}
+/** Output of the comments command */
+export interface CommentsOutput {
+    pr: {
+        title: string;
+        state: string;
+        mergeable: boolean | null;
+        head: string;
+        base: string;
+        url: string;
+    };
+    reviews: Array<{
+        user: string | undefined;
+        state: string;
+        body: string | null;
+        submittedAt: string | null;
+    }>;
+    reviewComments: Array<{
+        user: string | undefined;
+        body: string;
+        path: string;
+        createdAt: string;
+    }>;
+    issueComments: Array<{
+        user: string | undefined;
+        body: string | undefined;
+        createdAt: string;
+    }>;
+    summary: {
+        reviewCount: number;
+        inlineCommentCount: number;
+        discussionCommentCount: number;
+    };
+}
+/** Output of the post command */
+export interface PostOutput {
+    commentUrl: string;
+    url: string;
+}
+/** Output of the claim command */
+export interface ClaimOutput {
+    commentUrl: string;
+    issueUrl: string;
+}
 /** Info about a local git clone (#84) */
 export interface LocalRepoInfo {
     path: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-autopilot/core",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "description": "CLI and core library for managing open source contributions",
   "type": "module",
   "bin": {
@@ -14,6 +14,10 @@
     "./types": {
       "import": "./dist/core/types.js",
       "types": "./dist/core/types.d.ts"
+    },
+    "./commands": {
+      "import": "./dist/commands/index.js",
+      "types": "./dist/commands/index.d.ts"
     }
   },
   "files": [