@oss-autopilot/core 0.41.0

package/dist/formatters/json.d.ts

@@ -0,0 +1,269 @@
+/**
+ * JSON output formatter for CLI --json mode
+ * Provides structured output that can be consumed by scripts and plugins
+ */
+import type { FetchedPR, DailyDigest, AgentState, RepoGroup, CommentedIssue, ShelvedPRRef } from '../core/types.js';
+import type { PRCheckFailure } from '../core/pr-monitor.js';
+import type { SearchPriority } from '../core/issue-discovery.js';
+export interface JsonOutput<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    timestamp: string;
+}
+export interface CapacityAssessment {
+    hasCapacity: boolean;
+    activePRCount: number;
+    maxActivePRs: number;
+    shelvedPRCount: number;
+    criticalIssueCount: number;
+    reason: string;
+}
+export type ActionableIssueType = 'ci_failing' | 'merge_conflict' | 'needs_response' | 'needs_changes' | 'incomplete_checklist';
+export interface ActionableIssue {
+    type: ActionableIssueType;
+    pr: FetchedPR;
+    label: string;
+}
+/**
+ * Compact version of ActionableIssue for JSON output.
+ * References the PR by URL instead of embedding the full object,
+ * since the full PR is already available in digest.openPRs.
+ * Uses URL (globally unique) instead of number to avoid cross-repo collisions.
+ */
+export interface CompactActionableIssue {
+    type: ActionableIssueType;
+    prUrl: string;
+    label: string;
+}
+/**
+ * A single action menu item pre-computed by the CLI.
+ * The orchestration layer can use these directly in AskUserQuestion prompts.
+ */
+export interface ActionMenuItem {
+    /** Stable identifier for routing (e.g., "address_all", "search", "done"). */
+    key: string;
+    /** Display text for the option (e.g., "Work through all 3 issues (Recommended)"). */
+    label: string;
+    /** Explanation shown below the label. */
+    description: string;
+}
+/**
+ * Pre-computed action menu for the orchestration layer.
+ * Contains the menu items the CLI can determine from PR data and capacity,
+ * plus context flags so the orchestration can insert issue-list options.
+ */
+export interface ActionMenu {
+    /** Ordered list of menu items. The orchestration may insert issue-list items after the CLI-generated items (address_all, issue_replies) or at the start when none exist. */
+    items: ActionMenuItem[];
+    /** Context flags for the orchestration layer to decide on issue-list options. */
+    context: {
+        hasActionableIssues: boolean;
+        actionableCount: number;
+        hasCapacity: boolean;
+        hasIssueResponses: boolean;
+        issueResponseCount: number;
+    };
+}
+/**
+ * Deduplicated daily digest for JSON output (#287).
+ *
+ * Full PR objects live only in `openPRs`. Category arrays contain PR URLs
+ * that reference into `openPRs`, reducing JSON payload size by ~60-70%.
+ * Uses URLs (globally unique) instead of numbers to avoid cross-repo collisions.
+ * Consumers look up full PR details via: openPRs.find(pr => pr.url === url)
+ */
+export interface DailyDigestCompact {
+    generatedAt: string;
+    /** All open PRs authored by the user — the single source of truth for full PR objects. */
+    openPRs: FetchedPR[];
+    prsNeedingResponse: string[];
+    ciFailingPRs: string[];
+    ciBlockedPRs: string[];
+    ciNotRunningPRs: string[];
+    mergeConflictPRs: string[];
+    needsRebasePRs: string[];
+    missingRequiredFilesPRs: string[];
+    incompleteChecklistPRs: string[];
+    needsChangesPRs: string[];
+    changesAddressedPRs: string[];
+    waitingOnMaintainerPRs: string[];
+    approachingDormant: string[];
+    dormantPRs: string[];
+    healthyPRs: string[];
+    recentlyClosedPRs: DailyDigest['recentlyClosedPRs'];
+    recentlyMergedPRs: DailyDigest['recentlyMergedPRs'];
+    shelvedPRs: ShelvedPRRef[];
+    autoUnshelvedPRs: ShelvedPRRef[];
+    summary: DailyDigest['summary'];
+}
+/**
+ * Compact repo group for JSON output (#287).
+ * Uses PR URLs instead of full objects; look up in digest.openPRs.
+ * Uses URLs (globally unique) instead of numbers to avoid cross-repo collisions.
+ */
+export interface CompactRepoGroup {
+    repo: string;
+    prUrls: string[];
+}
+export interface DailyOutput {
+    digest: DailyDigestCompact;
+    updates: unknown[];
+    capacity: CapacityAssessment;
+    summary: string;
+    briefSummary: string;
+    actionableIssues: CompactActionableIssue[];
+    actionMenu: ActionMenu;
+    commentedIssues: CommentedIssue[];
+    repoGroups: CompactRepoGroup[];
+    failures: PRCheckFailure[];
+}
+/**
+ * Convert a full DailyDigest to the compact format for JSON output (#287).
+ * Category arrays become PR URL arrays; full objects stay only in openPRs.
+ * Uses URLs (globally unique) instead of numbers to avoid cross-repo collisions.
+ */
+export declare function deduplicateDigest(digest: DailyDigest): DailyDigestCompact;
+/**
+ * Convert ActionableIssue[] to CompactActionableIssue[] for JSON output (#287).
+ * Replaces the full PR object with just the PR URL (globally unique).
+ */
+export declare function compactActionableIssues(issues: ActionableIssue[]): CompactActionableIssue[];
+/**
+ * Convert RepoGroup[] to CompactRepoGroup[] for JSON output (#287).
+ * Replaces full PR arrays with PR URL arrays.
+ */
+export declare function compactRepoGroups(groups: RepoGroup[]): CompactRepoGroup[];
+export interface StatusOutput {
+    stats: {
+        mergedPRs: number;
+        closedPRs: number;
+        activeIssues: number;
+        trustedProjects: number;
+        mergeRate: string;
+        needsResponse: number;
+    };
+    lastRunAt: string;
+    offline?: boolean;
+    lastUpdated?: string;
+}
+export interface SearchOutput {
+    candidates: Array<{
+        issue: {
+            repo: string;
+            number: number;
+            title: string;
+            url: string;
+            labels: string[];
+        };
+        recommendation: 'approve' | 'skip' | 'needs_review';
+        reasonsToApprove: string[];
+        reasonsToSkip: string[];
+        searchPriority: SearchPriority;
+        /** 0-100 scale composite viability score */
+        viabilityScore: number;
+        repoScore?: {
+            /** 1-10 scale repository quality score */
+            score: number;
+            mergedPRCount: number;
+            closedWithoutMergeCount: number;
+            isResponsive: boolean;
+            lastMergedAt?: string;
+        };
+    }>;
+    excludedRepos: string[];
+    /** Repos with known anti-AI contribution policies, filtered from search results (#108). */
+    aiPolicyBlocklist: string[];
+    /** Present when rate limits affected the search — either low pre-flight quota or mid-search rate limit hits (#100). */
+    rateLimitWarning?: string;
+}
+export interface TrackOutput {
+    pr: {
+        repo: string;
+        number: number;
+        title: string;
+        url: string;
+    };
+}
+export interface ConfigOutput {
+    config: AgentState['config'];
+}
+/** Info about a detected issue list file */
+export interface IssueListInfo {
+    path: string;
+    source: 'configured' | 'auto-detected';
+    availableCount: number;
+    completedCount: number;
+}
+/**
+ * Output of the startup command (combines auth, setup, daily, dashboard, issue list).
+ *
+ * Three valid shapes:
+ * 1. Setup incomplete: { version, setupComplete: false }
+ * 2. Auth failure: { version, setupComplete: true, authError: "..." }
+ * 3. Success: { version, setupComplete: true, daily, dashboardPath?, issueList? }
+ */
+export interface StartupOutput {
+    version: string;
+    setupComplete: boolean;
+    authError?: string;
+    daily?: DailyOutput;
+    dashboardPath?: string;
+    issueList?: IssueListInfo;
+}
+/** A single parsed issue from a markdown list (#82) */
+export interface ParsedIssueItem {
+    repo: string;
+    number: number;
+    title: string;
+    tier: string;
+    url: string;
+}
+/** Output of the parse-issue-list command (#82) */
+export interface ParseIssueListOutput {
+    available: ParsedIssueItem[];
+    completed: ParsedIssueItem[];
+    availableCount: number;
+    completedCount: number;
+}
+/** Info about a new file's integration status (#83) */
+export interface NewFileInfo {
+    path: string;
+    referencedBy: string[];
+    isIntegrated: boolean;
+    suggestedEntryPoints?: string[];
+}
+/** Output of the check-integration command (#83) */
+export interface CheckIntegrationOutput {
+    newFiles: NewFileInfo[];
+    unreferencedCount: number;
+}
+/** Info about a local git clone (#84) */
+export interface LocalRepoInfo {
+    path: string;
+    exists: boolean;
+    currentBranch: string | null;
+}
+/** Output of the local-repos command (#84) */
+export interface LocalReposOutput {
+    repos: Record<string, LocalRepoInfo>;
+    scanPaths: string[];
+    cachedAt: string;
+    fromCache: boolean;
+}
+/**
+ * Wrap data in a standard JSON output envelope
+ */
+export declare function jsonSuccess<T>(data: T): JsonOutput<T>;
+/**
+ * Create an error JSON output
+ */
+export declare function jsonError(message: string): JsonOutput<never>;
+/**
+ * Output JSON to stdout
+ */
+export declare function outputJson<T>(data: T): void;
+/**
+ * Output error JSON to stdout (sets success: false)
+ */
+export declare function outputJsonError(message: string): void;

package/dist/formatters/json.js

@@ -0,0 +1,88 @@
+/**
+ * JSON output formatter for CLI --json mode
+ * Provides structured output that can be consumed by scripts and plugins
+ */
+/**
+ * Convert a full DailyDigest to the compact format for JSON output (#287).
+ * Category arrays become PR URL arrays; full objects stay only in openPRs.
+ * Uses URLs (globally unique) instead of numbers to avoid cross-repo collisions.
+ */
+export function deduplicateDigest(digest) {
+    const toUrls = (prs) => prs.map((pr) => pr.url);
+    return {
+        generatedAt: digest.generatedAt,
+        openPRs: digest.openPRs,
+        prsNeedingResponse: toUrls(digest.prsNeedingResponse),
+        ciFailingPRs: toUrls(digest.ciFailingPRs),
+        ciBlockedPRs: toUrls(digest.ciBlockedPRs),
+        ciNotRunningPRs: toUrls(digest.ciNotRunningPRs),
+        mergeConflictPRs: toUrls(digest.mergeConflictPRs),
+        needsRebasePRs: toUrls(digest.needsRebasePRs),
+        missingRequiredFilesPRs: toUrls(digest.missingRequiredFilesPRs),
+        incompleteChecklistPRs: toUrls(digest.incompleteChecklistPRs),
+        needsChangesPRs: toUrls(digest.needsChangesPRs),
+        changesAddressedPRs: toUrls(digest.changesAddressedPRs),
+        waitingOnMaintainerPRs: toUrls(digest.waitingOnMaintainerPRs),
+        approachingDormant: toUrls(digest.approachingDormant),
+        dormantPRs: toUrls(digest.dormantPRs),
+        healthyPRs: toUrls(digest.healthyPRs),
+        recentlyClosedPRs: digest.recentlyClosedPRs,
+        recentlyMergedPRs: digest.recentlyMergedPRs,
+        shelvedPRs: digest.shelvedPRs,
+        autoUnshelvedPRs: digest.autoUnshelvedPRs,
+        summary: digest.summary,
+    };
+}
+/**
+ * Convert ActionableIssue[] to CompactActionableIssue[] for JSON output (#287).
+ * Replaces the full PR object with just the PR URL (globally unique).
+ */
+export function compactActionableIssues(issues) {
+    return issues.map((issue) => ({
+        type: issue.type,
+        prUrl: issue.pr.url,
+        label: issue.label,
+    }));
+}
+/**
+ * Convert RepoGroup[] to CompactRepoGroup[] for JSON output (#287).
+ * Replaces full PR arrays with PR URL arrays.
+ */
+export function compactRepoGroups(groups) {
+    return groups.map((group) => ({
+        repo: group.repo,
+        prUrls: group.prs.map((pr) => pr.url),
+    }));
+}
+/**
+ * Wrap data in a standard JSON output envelope
+ */
+export function jsonSuccess(data) {
+    return {
+        success: true,
+        data,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Create an error JSON output
+ */
+export function jsonError(message) {
+    return {
+        success: false,
+        error: message,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Output JSON to stdout
+ */
+export function outputJson(data) {
+    console.log(JSON.stringify(jsonSuccess(data), null, 2));
+}
+/**
+ * Output error JSON to stdout (sets success: false)
+ */
+export function outputJsonError(message) {
+    console.log(JSON.stringify(jsonError(message), null, 2));
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@oss-autopilot/core",
+  "version": "0.41.0",
+  "description": "CLI and core library for managing open source contributions",
+  "type": "module",
+  "bin": {
+    "oss-autopilot": "./dist/cli.bundle.cjs"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/core/index.js",
+      "types": "./dist/core/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/core/types.js",
+      "types": "./dist/core/types.d.ts"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "keywords": [
+    "open-source",
+    "github",
+    "contributions",
+    "cli",
+    "pr-monitoring",
+    "issue-discovery"
+  ],
+  "author": "John Costa",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/costajohnt/oss-autopilot.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/costajohnt/oss-autopilot#readme",
+  "bugs": {
+    "url": "https://github.com/costajohnt/oss-autopilot/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@octokit/plugin-throttling": "^11.0.3",
+    "@octokit/rest": "^22.0.1",
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "esbuild": "^0.27.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  },
+  "scripts": {
+    "build": "tsc",
+    "bundle": "esbuild src/cli.ts --bundle --platform=node --target=node20 --format=cjs --outfile=dist/cli.bundle.cjs",
+    "start": "tsx src/cli.ts",
+    "dev": "tsx watch src/cli.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest"
+  }
+}