@oss-autopilot/core 1.15.1 → 1.15.2

package/dist/commands/daily.d.ts

@@ -33,6 +33,15 @@ export interface DailyCheckResult {
     repoGroups: RepoGroup[];
     failures: PRCheckFailure[];
 }
+/**
+ * Convert a full DailyCheckResult to the compact DailyOutput for JSON serialization (#287).
+ * Deduplicates PR objects: category arrays become PR URL references,
+ * full objects live only in digest.openPRs. Reduces JSON payload size ~60-70%.
+ *
+ * Exported for the `daily --json` contract test (#986), which pins this
+ * shape transformation without spinning up the full fetch pipeline.
+ */
+export declare function toDailyOutput(result: DailyCheckResult): DailyOutput;
 /**
  * Core daily check logic, extracted for reuse by the startup command.
  * Fetches all open PRs, updates state, and returns structured output.

package/dist/commands/daily.js

@@ -370,8 +370,11 @@ function generateDigestOutput(digest, activePRs, shelvedPRs, commentedIssues, fa
  * Convert a full DailyCheckResult to the compact DailyOutput for JSON serialization (#287).
  * Deduplicates PR objects: category arrays become PR URL references,
  * full objects live only in digest.openPRs. Reduces JSON payload size ~60-70%.
+ *
+ * Exported for the `daily --json` contract test (#986), which pins this
+ * shape transformation without spinning up the full fetch pipeline.
  */
-function toDailyOutput(result) {
+export function toDailyOutput(result) {
     return {
         digest: deduplicateDigest(result.digest),
         capacity: result.capacity,

package/dist/commands/scout-bridge.js

@@ -4,6 +4,7 @@
  */
 import { createScout } from '@oss-scout/core';
 import { getStateManager, requireGitHubToken } from '../core/index.js';
+import { loadSkippedIssues } from './skip-file-parser.js';
 /**
  * Build a ScoutState from the current AgentState.
  * Maps oss-autopilot's config and state fields to oss-scout's state format.
@@ -52,7 +53,7 @@ export function buildScoutState() {
             openedAt: pr.createdAt,
         })),
         savedResults: [],
-        skippedIssues: [],
+        skippedIssues: loadSkippedIssues(config.skippedIssuesPath),
         lastRunAt: state.lastRunAt,
     };
 }

package/dist/commands/skip-add.d.ts

@@ -0,0 +1,25 @@
+export interface SkipAddOptions {
+    issueUrl: string;
+    /** Override the configured `skippedIssuesPath`. */
+    skipFilePath?: string;
+    /** Injected for deterministic tests. Defaults to `new Date()`. */
+    now?: Date;
+}
+export interface SkipAddOutput {
+    added: boolean;
+    alreadyPresent: boolean;
+    url: string;
+    path: string;
+    /** Populated only when an entry was appended. */
+    date?: string;
+}
+/**
+ * Append an issue URL to the skipped-issues file.
+ *
+ * Creates the file with the standard header if it doesn't exist. If the URL
+ * is already present (per the skip-file-parser's view of the file), this is
+ * a no-op and returns `alreadyPresent: true`.
+ *
+ * @throws when no path can be resolved or the URL isn't a GitHub issue/PR URL.
+ */
+export declare function runSkipAdd(options: SkipAddOptions): SkipAddOutput;

package/dist/commands/skip-add.js

@@ -0,0 +1,48 @@
+import * as fs from 'fs';
+import { loadSkippedIssues } from './skip-file-parser.js';
+import { getStateManager } from '../core/index.js';
+// Keep in sync with GITHUB_URL_RE in skip-file-parser.ts.
+const GITHUB_URL_RE = /^https:\/\/github\.com\/([^/]+\/[^/]+)\/(?:issues|pull)\/(\d+)(?:[/?#].*)?$/;
+const FILE_HEADER = '# Skipped Issues — auto-culled after 90 days\n# Format: YYYY-MM-DD URL\n\n';
+function formatUtcDate(d) {
+    return d.toISOString().slice(0, 10);
+}
+/**
+ * Append an issue URL to the skipped-issues file.
+ *
+ * Creates the file with the standard header if it doesn't exist. If the URL
+ * is already present (per the skip-file-parser's view of the file), this is
+ * a no-op and returns `alreadyPresent: true`.
+ *
+ * @throws when no path can be resolved or the URL isn't a GitHub issue/PR URL.
+ */
+export function runSkipAdd(options) {
+    const skipFilePath = options.skipFilePath ?? getStateManager().getState().config.skippedIssuesPath;
+    if (!skipFilePath) {
+        throw new Error('No skipped-issues path configured. Set one via `oss-autopilot config --set skippedIssuesPath=<path>` or pass --path.');
+    }
+    if (!GITHUB_URL_RE.test(options.issueUrl)) {
+        throw new Error(`Invalid GitHub issue or PR URL: ${options.issueUrl}`);
+    }
+    const existing = loadSkippedIssues(skipFilePath);
+    if (existing.some((entry) => entry.url === options.issueUrl)) {
+        return {
+            added: false,
+            alreadyPresent: true,
+            url: options.issueUrl,
+            path: skipFilePath,
+        };
+    }
+    if (!fs.existsSync(skipFilePath)) {
+        fs.writeFileSync(skipFilePath, FILE_HEADER);
+    }
+    const date = formatUtcDate(options.now ?? new Date());
+    fs.appendFileSync(skipFilePath, `${date} ${options.issueUrl}\n`);
+    return {
+        added: true,
+        alreadyPresent: false,
+        url: options.issueUrl,
+        path: skipFilePath,
+        date,
+    };
+}

package/dist/commands/skip-file-parser.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Parser for the skipped-issues markdown file (#989).
+ *
+ * The file format is one entry per line:
+ *   2026-04-15 https://github.com/owner/repo/issues/123
+ * Lines starting with `#` and blank lines are ignored.
+ *
+ * Produces SkippedIssue entries that plug directly into oss-scout's ScoutState
+ * so the search engine filters already-skipped URLs out of results.
+ */
+import type { SkippedIssue } from '@oss-scout/core';
+/**
+ * Parse the raw text of a skipped-issues file into SkippedIssue entries.
+ * Pure function — no I/O. Malformed lines are warned and skipped; the rest
+ * pass through unchanged.
+ */
+export declare function parseSkippedIssuesContent(content: string): SkippedIssue[];
+/**
+ * Read the skipped-issues file from disk and parse it.
+ * Returns `[]` when:
+ *   - `path` is undefined or empty,
+ *   - the file does not exist,
+ *   - the file cannot be read (a warning is logged).
+ */
+export declare function loadSkippedIssues(path: string | undefined): SkippedIssue[];

package/dist/commands/skip-file-parser.js

@@ -0,0 +1,92 @@
+/**
+ * Parser for the skipped-issues markdown file (#989).
+ *
+ * The file format is one entry per line:
+ *   2026-04-15 https://github.com/owner/repo/issues/123
+ * Lines starting with `#` and blank lines are ignored.
+ *
+ * Produces SkippedIssue entries that plug directly into oss-scout's ScoutState
+ * so the search engine filters already-skipped URLs out of results.
+ */
+import * as fs from 'fs';
+import { warn } from '../core/logger.js';
+import { errorMessage } from '../core/errors.js';
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const GITHUB_URL_RE = /^https:\/\/github\.com\/([^/]+\/[^/]+)\/(?:issues|pull)\/(\d+)(?:[/?#].*)?$/;
+/**
+ * Parse the raw text of a skipped-issues file into SkippedIssue entries.
+ * Pure function — no I/O. Malformed lines are warned and skipped; the rest
+ * pass through unchanged.
+ */
+export function parseSkippedIssuesContent(content) {
+    const results = [];
+    const lines = content.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+        const lineNumber = i + 1;
+        const line = lines[i].trim();
+        if (line === '' || line.startsWith('#'))
+            continue;
+        // Split on first whitespace run: "YYYY-MM-DD <url>"
+        const match = line.match(/^(\S+)\s+(\S+)\s*$/);
+        if (!match) {
+            warn('skip-file-parser', `Line ${lineNumber}: malformed (expected "<date> <url>"): ${line}`);
+            continue;
+        }
+        const [, dateStr, url] = match;
+        if (!DATE_RE.test(dateStr)) {
+            warn('skip-file-parser', `Line ${lineNumber}: invalid date format (expected YYYY-MM-DD): ${line}`);
+            continue;
+        }
+        const dateMs = Date.parse(`${dateStr}T00:00:00.000Z`);
+        if (Number.isNaN(dateMs)) {
+            warn('skip-file-parser', `Line ${lineNumber}: unparseable date: ${line}`);
+            continue;
+        }
+        // Guard against JS Date normalization — Date.parse silently shifts
+        // invalid calendar dates (e.g. 2026-02-30 → 2026-03-02). Without this
+        // round-trip check the entry would be stored under the wrong date and
+        // scout's 90-day cull would run against a shifted value.
+        const roundTrip = new Date(dateMs).toISOString().slice(0, 10);
+        if (roundTrip !== dateStr) {
+            warn('skip-file-parser', `Line ${lineNumber}: invalid calendar date ${dateStr} (would be normalized to ${roundTrip}): ${line}`);
+            continue;
+        }
+        const urlMatch = url.match(GITHUB_URL_RE);
+        if (!urlMatch) {
+            warn('skip-file-parser', `Line ${lineNumber}: non-GitHub-issue URL: ${line}`);
+            continue;
+        }
+        const [, repo, numberStr] = urlMatch;
+        const number = Number.parseInt(numberStr, 10);
+        results.push({
+            url,
+            repo,
+            number,
+            title: '',
+            skippedAt: new Date(dateMs).toISOString(),
+        });
+    }
+    return results;
+}
+/**
+ * Read the skipped-issues file from disk and parse it.
+ * Returns `[]` when:
+ *   - `path` is undefined or empty,
+ *   - the file does not exist,
+ *   - the file cannot be read (a warning is logged).
+ */
+export function loadSkippedIssues(path) {
+    if (!path)
+        return [];
+    if (!fs.existsSync(path))
+        return [];
+    let content;
+    try {
+        content = fs.readFileSync(path, 'utf-8');
+    }
+    catch (err) {
+        warn('skip-file-parser', `Failed to read skipped-issues file at ${path}: ${errorMessage(err)}`);
+        return [];
+    }
+    return parseSkippedIssuesContent(content);
+}

package/package.json

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