@oss-autopilot/core 1.8.0 → 1.9.0

package/dist/commands/index.d.ts

@@ -63,6 +63,7 @@ export { runCheckIntegration } from './check-integration.js';
 export { runDetectFormatters } from './detect-formatters.js';
 /** Scan for locally cloned repos. */
 export { runLocalRepos } from './local-repos.js';
+export type { ErrorCode } from '../formatters/json.js';
 export type { DailyOutput, SearchOutput, StartupOutput, StatusOutput, TrackOutput } from '../formatters/json.js';
 export type { VetOutput, CommentsOutput, PostOutput, ClaimOutput } from '../formatters/json.js';
 export type { ConfigOutput, DetectFormattersOutput, ParseIssueListOutput, ParsedIssueItem, CheckIntegrationOutput, LocalReposOutput, } from '../formatters/json.js';

package/dist/commands/startup.js

@@ -7,6 +7,7 @@
  * `node cli.bundle.cjs startup --json` call, reducing UI noise in Claude Code.
  */
 import * as fs from 'fs';
+import * as path from 'path';
 import { execFile } from 'child_process';
 import { getStateManager, getGitHubToken, getCLIVersion, detectGitHubUsername } from '../core/index.js';
 import { errorMessage } from '../core/errors.js';
@@ -102,15 +103,36 @@ export function detectIssueList() {
     if (!issueListPath)
         return undefined;
     // 4. Count available/completed items
+    let availableCount = 0;
+    let completedCount = 0;
     try {
         const content = fs.readFileSync(issueListPath, 'utf-8');
-        const { availableCount, completedCount } = countIssueListItems(content);
-        return { path: issueListPath, source, availableCount, completedCount };
+        ({ availableCount, completedCount } = countIssueListItems(content));
     }
     catch (error) {
         console.error(`[STARTUP] Failed to read issue list at ${issueListPath}:`, errorMessage(error));
-        return { path: issueListPath, source, availableCount: 0, completedCount: 0 };
     }
+    // 5. Detect skipped issues file
+    let skippedIssuesPath;
+    // Check config first
+    try {
+        const stateManager = getStateManager();
+        const configuredSkipPath = stateManager.getState().config.skippedIssuesPath;
+        if (configuredSkipPath && fs.existsSync(configuredSkipPath)) {
+            skippedIssuesPath = configuredSkipPath;
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    // Probe default path: same directory as issue list, named skipped-issues.md
+    if (!skippedIssuesPath && issueListPath) {
+        const defaultSkipPath = path.join(path.dirname(issueListPath), 'skipped-issues.md');
+        if (fs.existsSync(defaultSkipPath)) {
+            skippedIssuesPath = defaultSkipPath;
+        }
+    }
+    return { path: issueListPath, source, availableCount, completedCount, skippedIssuesPath };
 }
 /**
  * Open a URL in the default system browser.

package/dist/core/errors.d.ts

@@ -39,3 +39,9 @@ export declare function getHttpStatusCode(error: unknown): number | undefined;
 export declare function isRateLimitError(error: unknown): boolean;
 /** Return true for errors that should propagate (not degrade gracefully): rate limits, auth failures, abuse detection. */
 export declare function isRateLimitOrAuthError(err: unknown): boolean;
+/**
+ * Map an unknown error to a structured ErrorCode for JSON output.
+ * Checks custom error classes, HTTP status codes (Octokit errors),
+ * and error message patterns in priority order.
+ */
+export declare function resolveErrorCode(err: unknown): import('../formatters/json.js').ErrorCode;

package/dist/core/errors.js

@@ -75,3 +75,40 @@ export function isRateLimitOrAuthError(err) {
     }
     return false;
 }
+/**
+ * Map an unknown error to a structured ErrorCode for JSON output.
+ * Checks custom error classes, HTTP status codes (Octokit errors),
+ * and error message patterns in priority order.
+ */
+export function resolveErrorCode(err) {
+    // Check our custom error classes first
+    if (err instanceof ConfigurationError)
+        return 'CONFIGURATION';
+    if (err instanceof ValidationError)
+        return 'VALIDATION';
+    // Check HTTP status codes (Octokit errors)
+    const status = getHttpStatusCode(err);
+    if (status === 401)
+        return 'AUTH_REQUIRED';
+    if (status === 403) {
+        const msg = errorMessage(err).toLowerCase();
+        if (msg.includes('rate limit') || msg.includes('abuse detection'))
+            return 'RATE_LIMITED';
+        return 'AUTH_REQUIRED';
+    }
+    if (status === 404)
+        return 'NOT_FOUND';
+    if (status === 429)
+        return 'RATE_LIMITED';
+    // Check error message patterns
+    const msg = errorMessage(err).toLowerCase();
+    if (msg.includes('enotfound') ||
+        msg.includes('econnrefused') ||
+        msg.includes('econnreset') ||
+        msg.includes('etimedout') ||
+        msg.includes('fetch failed'))
+        return 'NETWORK';
+    if (msg.includes('state') && (msg.includes('corrupt') || msg.includes('invalid')))
+        return 'STATE_CORRUPTED';
+    return 'UNKNOWN';
+}

package/dist/core/index.d.ts

@@ -10,7 +10,7 @@ export { IssueConversationMonitor } from './issue-conversation.js';
 export { isBotAuthor, isAcknowledgmentComment } from './comment-utils.js';
 export { getOctokit, checkRateLimit, type RateLimitInfo } from './github.js';
 export { parseGitHubUrl, daysBetween, splitRepo, isOwnRepo, getCLIVersion, getDataDir, getStatePath, getBackupDir, getCacheDir, formatRelativeTime, byDateDescending, getGitHubToken, getGitHubTokenAsync, requireGitHubToken, resetGitHubTokenCache, detectGitHubUsername, stateFileExists, DEFAULT_CONCURRENCY, } from './utils.js';
-export { OssAutopilotError, ConfigurationError, ValidationError, errorMessage, getHttpStatusCode, isRateLimitError, isRateLimitOrAuthError, } from './errors.js';
+export { OssAutopilotError, ConfigurationError, ValidationError, errorMessage, getHttpStatusCode, isRateLimitError, isRateLimitOrAuthError, resolveErrorCode, } from './errors.js';
 export { enableDebug, isDebugEnabled, debug, info, warn, timed } from './logger.js';
 export { HttpCache, getHttpCache, cachedRequest, type CacheEntry } from './http-cache.js';
 export { CRITICAL_STATUSES, applyStatusOverrides, computeRepoSignals, groupPRsByRepo, assessCapacity, collectActionableIssues, computeActionMenu, toShelvedPRRef, formatActionHint, formatBriefSummary, formatSummary, printDigest, } from './daily-logic.js';

package/dist/core/index.js

@@ -10,7 +10,7 @@ export { IssueConversationMonitor } from './issue-conversation.js';
 export { isBotAuthor, isAcknowledgmentComment } from './comment-utils.js';
 export { getOctokit, checkRateLimit } from './github.js';
 export { parseGitHubUrl, daysBetween, splitRepo, isOwnRepo, getCLIVersion, getDataDir, getStatePath, getBackupDir, getCacheDir, formatRelativeTime, byDateDescending, getGitHubToken, getGitHubTokenAsync, requireGitHubToken, resetGitHubTokenCache, detectGitHubUsername, stateFileExists, DEFAULT_CONCURRENCY, } from './utils.js';
-export { OssAutopilotError, ConfigurationError, ValidationError, errorMessage, getHttpStatusCode, isRateLimitError, isRateLimitOrAuthError, } from './errors.js';
+export { OssAutopilotError, ConfigurationError, ValidationError, errorMessage, getHttpStatusCode, isRateLimitError, isRateLimitOrAuthError, resolveErrorCode, } from './errors.js';
 export { enableDebug, isDebugEnabled, debug, info, warn, timed } from './logger.js';
 export { HttpCache, getHttpCache, cachedRequest } from './http-cache.js';
 export { CRITICAL_STATUSES, applyStatusOverrides, computeRepoSignals, groupPRsByRepo, assessCapacity, collectActionableIssues, computeActionMenu, toShelvedPRRef, formatActionHint, formatBriefSummary, formatSummary, printDigest, } from './daily-logic.js';

package/dist/core/state-schema.d.ts

@@ -229,6 +229,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
         lastActivityAt: z.ZodString;
     }, z.core.$strip>>>;
     issueListPath: z.ZodOptional<z.ZodString>;
+    skippedIssuesPath: z.ZodOptional<z.ZodString>;
     projectCategories: z.ZodDefault<z.ZodArray<z.ZodEnum<{
         nonprofit: "nonprofit";
         devtools: "devtools";
@@ -375,6 +376,7 @@ export declare const AgentStateSchema: z.ZodObject<{
             lastActivityAt: z.ZodString;
         }, z.core.$strip>>>;
         issueListPath: z.ZodOptional<z.ZodString>;
+        skippedIssuesPath: z.ZodOptional<z.ZodString>;
         projectCategories: z.ZodDefault<z.ZodArray<z.ZodEnum<{
             nonprofit: "nonprofit";
             devtools: "devtools";

package/dist/core/state-schema.js

@@ -148,6 +148,7 @@ export const AgentConfigSchema = z.object({
     dismissedIssues: z.record(z.string(), z.string()).default({}),
     statusOverrides: z.record(z.string(), StatusOverrideSchema).optional(),
     issueListPath: z.string().optional(),
+    skippedIssuesPath: z.string().optional(),
     projectCategories: z.array(ProjectCategorySchema).default([]),
     preferredOrgs: z.array(z.string()).default([]),
 });

package/dist/formatters/json.d.ts

@@ -7,10 +7,12 @@ import type { ContributionStats } from '../core/stats.js';
 import type { PRCheckFailure } from '../core/pr-monitor.js';
 import type { SearchPriority } from '../core/types.js';
 import type { CIFormatterDiagnosis, FormatterDetectionResult } from '../core/formatter-detection.js';
+export type ErrorCode = 'AUTH_REQUIRED' | 'RATE_LIMITED' | 'VALIDATION' | 'CONFIGURATION' | 'NETWORK' | 'NOT_FOUND' | 'STATE_CORRUPTED' | 'UNKNOWN';
 export interface JsonOutput<T = unknown> {
     success: boolean;
     data?: T;
     error?: string;
+    errorCode?: ErrorCode;
     timestamp: string;
 }
 export interface CapacityAssessment {
@@ -215,6 +217,7 @@ export interface IssueListInfo {
     source: 'configured' | 'auto-detected';
     availableCount: number;
     completedCount: number;
+    skippedIssuesPath?: string;
 }
 /**
  * Output of the startup command (combines auth, setup, daily, dashboard, issue list).
@@ -383,7 +386,7 @@ export declare function jsonSuccess<T>(data: T): JsonOutput<T>;
 /**
  * Create an error JSON output
  */
-export declare function jsonError(message: string): JsonOutput<never>;
+export declare function jsonError(message: string, errorCode?: ErrorCode): JsonOutput<never>;
 /**
  * Output JSON to stdout
  */
@@ -391,4 +394,4 @@ export declare function outputJson<T>(data: T): void;
 /**
  * Output error JSON to stdout (sets success: false)
  */
-export declare function outputJsonError(message: string): void;
+export declare function outputJsonError(message: string, errorCode?: ErrorCode): void;

package/dist/formatters/json.js

@@ -85,10 +85,11 @@ export function jsonSuccess(data) {
 /**
  * Create an error JSON output
  */
-export function jsonError(message) {
+export function jsonError(message, errorCode) {
     return {
         success: false,
         error: message,
+        errorCode,
         timestamp: new Date().toISOString(),
     };
 }
@@ -101,6 +102,6 @@ export function outputJson(data) {
 /**
  * Output error JSON to stdout (sets success: false)
  */
-export function outputJsonError(message) {
-    console.log(JSON.stringify(jsonError(message), null, 2));
+export function outputJsonError(message, errorCode) {
+    console.log(JSON.stringify(jsonError(message, errorCode), null, 2));
 }

package/package.json

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