@oss-scout/core 0.2.1 → 0.4.0

package/dist/cli.js

@@ -223,7 +223,7 @@ const configCmd = program
             console.log(formatJsonSuccess(getConfigData()));
         }
         else {
-            runConfigShow(options);
+            runConfigShow();
         }
     }
     catch (err) {
@@ -322,6 +322,113 @@ program
         handleCommandError(err, options);
     }
 });
+// ── skip command ───────────────────────────────────────────────────
+const skipCmd = program
+    .command("skip")
+    .description("Manage the skip list — exclude issues from future searches");
+skipCmd
+    .command("add <issue-url>")
+    .description("Skip an issue by URL")
+    .option("--json", "Output as JSON")
+    .action(async (issueUrl, options) => {
+    try {
+        const { runSkip } = await import("./commands/skip.js");
+        const state = loadLocalState();
+        const result = await runSkip({ issueUrl, state });
+        if (options.json) {
+            console.log(formatJsonSuccess(result));
+        }
+        else {
+            if (result.alreadySkipped) {
+                console.log("Issue already in skip list.");
+            }
+            else {
+                console.log(`Skipped: ${issueUrl}`);
+            }
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options);
+    }
+});
+skipCmd
+    .command("list")
+    .description("Show all skipped issues")
+    .option("--json", "Output as JSON")
+    .action(async (options) => {
+    try {
+        const { runSkipList } = await import("./commands/skip.js");
+        const results = runSkipList();
+        if (options.json) {
+            console.log(formatJsonSuccess(results));
+        }
+        else {
+            if (results.length === 0) {
+                console.log("\nNo skipped issues.\n");
+                return;
+            }
+            console.log(`\nSkipped issues (${results.length}):\n`);
+            console.log("  Repo                              Issue   Skipped     Title");
+            console.log("  ────────────────────────────────  ──────  ──────────  ─────");
+            for (const s of results) {
+                const repo = (s.repo || "unknown").padEnd(32).slice(0, 32);
+                const issue = s.number ? `#${s.number}`.padEnd(6) : "—".padEnd(6);
+                const skippedDate = s.skippedAt.split("T")[0] ?? "";
+                const title = s.title.length > 50
+                    ? s.title.slice(0, 47) + "..."
+                    : s.title || s.url;
+                console.log(`  ${repo}  ${issue}  ${skippedDate}  ${title}`);
+            }
+            console.log();
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options);
+    }
+});
+skipCmd
+    .command("remove <issue-url>")
+    .description("Remove an issue from the skip list (unskip)")
+    .option("--json", "Output as JSON")
+    .action(async (issueUrl, options) => {
+    try {
+        const { runSkipRemove } = await import("./commands/skip.js");
+        const result = await runSkipRemove({ issueUrl });
+        if (options.json) {
+            console.log(formatJsonSuccess(result));
+        }
+        else {
+            if (result.removed) {
+                console.log(`Removed from skip list: ${issueUrl}`);
+            }
+            else {
+                console.log("Issue was not in the skip list.");
+            }
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options);
+    }
+});
+skipCmd
+    .command("clear")
+    .description("Clear all skipped issues")
+    .option("--json", "Output as JSON")
+    .action(async (options) => {
+    try {
+        const { runSkipClear } = await import("./commands/skip.js");
+        await runSkipClear();
+        if (options.json) {
+            console.log(formatJsonSuccess({ cleared: true }));
+        }
+        else {
+            console.log("Skip list cleared.");
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options);
+    }
+});
 program
     .command("vet <issue-url>")
     .description("Vet a specific GitHub issue for claimability and project health")

package/dist/commands/config.d.ts

@@ -5,9 +5,7 @@ import type { ScoutPreferences } from "../core/schemas.js";
 /**
  * Display current preferences in human-readable format.
  */
-export declare function runConfigShow(options: {
-    json?: boolean;
-}): void;
+export declare function runConfigShow(): void;
 /**
  * Get current preferences for JSON output.
  */

package/dist/commands/config.js

@@ -10,10 +10,10 @@ const FIELD_CONFIGS = {
     excludeRepos: { type: "array" },
     excludeOrgs: { type: "array" },
     aiPolicyBlocklist: { type: "array" },
-    preferredOrgs: { type: "array" },
     minStars: { type: "number" },
     maxIssueAgeDays: { type: "number" },
     minRepoScoreThreshold: { type: "number" },
+    interPhaseDelayMs: { type: "number" },
     includeDocIssues: { type: "boolean" },
     scope: { type: "enum-array", validValues: IssueScopeSchema.options },
     projectCategories: {
@@ -26,6 +26,8 @@ const FIELD_CONFIGS = {
         validValues: SearchStrategySchema.options,
     },
     githubUsername: { type: "string" },
+    broadPhaseDelayMs: { type: "number" },
+    skipBroadWhenSufficientResults: { type: "number" },
 };
 function parseBoolean(value) {
     const lower = value.toLowerCase();
@@ -73,13 +75,9 @@ function formatArray(arr) {
 /**
  * Display current preferences in human-readable format.
  */
-export function runConfigShow(options) {
+export function runConfigShow() {
     const state = loadLocalState();
     const prefs = state.preferences;
-    if (options.json) {
-        // JSON output handled by caller
-        return;
-    }
     console.log("\n⚙️  oss-scout preferences\n");
     console.log(`  githubUsername:        ${prefs.githubUsername || "(not set)"}`);
     console.log(`  languages:            ${formatArray(prefs.languages)}`);
@@ -88,14 +86,16 @@ export function runConfigShow(options) {
     console.log(`  minStars:             ${prefs.minStars}`);
     console.log(`  maxIssueAgeDays:      ${prefs.maxIssueAgeDays}`);
     console.log(`  minRepoScoreThreshold: ${prefs.minRepoScoreThreshold}`);
+    console.log(`  interPhaseDelayMs:    ${prefs.interPhaseDelayMs}ms (${(prefs.interPhaseDelayMs / 1000).toFixed(0)}s)`);
     console.log(`  includeDocIssues:     ${prefs.includeDocIssues}`);
-    console.log(`  preferredOrgs:        ${formatArray(prefs.preferredOrgs)}`);
     console.log(`  projectCategories:    ${formatArray(prefs.projectCategories)}`);
     console.log(`  excludeRepos:         ${formatArray(prefs.excludeRepos)}`);
     console.log(`  excludeOrgs:          ${formatArray(prefs.excludeOrgs)}`);
     console.log(`  aiPolicyBlocklist:    ${formatArray(prefs.aiPolicyBlocklist)}`);
     console.log(`  defaultStrategy:      ${prefs.defaultStrategy ? formatArray(prefs.defaultStrategy) : "(all)"}`);
     console.log(`  persistence:          ${prefs.persistence}`);
+    console.log(`  broadPhaseDelayMs:    ${prefs.broadPhaseDelayMs}ms (${(prefs.broadPhaseDelayMs / 1000).toFixed(0)}s)`);
+    console.log(`  skipBroadWhenSufficientResults: ${prefs.skipBroadWhenSufficientResults}`);
     console.log();
 }
 /**

package/dist/commands/setup.js

@@ -59,11 +59,9 @@ export async function runSetup(options) {
         const usernameInput = await ask(rl, usernamePrompt);
         const githubUsername = usernameInput || usernameDefault;
         // Languages
-        const defaultLangs = "typescript, javascript";
-        const langsInput = await ask(rl, `Preferred languages [${defaultLangs}]: `);
-        const languages = langsInput
-            ? parseCSV(langsInput)
-            : ["typescript", "javascript"];
+        const defaultLangs = "any (all languages)";
+        const langsInput = await ask(rl, `Preferred languages (comma-separated, or "any" for all) [${defaultLangs}]: `);
+        const languages = langsInput ? parseCSV(langsInput) : ["any"];
         // Issue labels
         const defaultLabels = "good first issue, help wanted";
         const labelsInput = await ask(rl, `Issue labels to search for [${defaultLabels}]: `);
@@ -79,9 +77,6 @@ export async function runSetup(options) {
         // Minimum stars
         const minStarsInput = await ask(rl, "Minimum repo stars [50]: ");
         const minStars = minStarsInput ? parseInt(minStarsInput, 10) : 50;
-        // Preferred organizations
-        const orgsInput = await ask(rl, "Preferred organizations (comma-separated, optional): ");
-        const preferredOrgs = parseCSV(orgsInput);
         // Project categories
         const categoryOptions = ALL_CATEGORIES.join(", ");
         const categoriesInput = await ask(rl, `Project categories (${categoryOptions}) [none]: `);
@@ -95,7 +90,6 @@ export async function runSetup(options) {
             labels,
             scope: scope.length > 0 ? scope : undefined,
             excludeRepos,
-            preferredOrgs,
             projectCategories,
             minStars: isNaN(minStars) ? 50 : minStars,
         });

package/dist/commands/skip.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Skip command — manage the skip list for excluding issues from future searches.
+ */
+import type { SkippedIssue, ScoutState } from "../core/schemas.js";
+/**
+ * Skip an issue by URL — adds it to the skip list and removes it from saved results.
+ * Tries to enrich metadata from saved results if available.
+ */
+export declare function runSkip(options: {
+    issueUrl: string;
+    state?: ScoutState;
+}): Promise<{
+    skipped: boolean;
+    alreadySkipped: boolean;
+}>;
+/**
+ * List all skipped issues.
+ */
+export declare function runSkipList(options?: {
+    state?: ScoutState;
+}): SkippedIssue[];
+/**
+ * Clear all skipped issues.
+ */
+export declare function runSkipClear(): Promise<void>;
+/**
+ * Remove a specific issue from the skip list (unskip).
+ */
+export declare function runSkipRemove(options: {
+    issueUrl: string;
+}): Promise<{
+    removed: boolean;
+}>;

package/dist/commands/skip.js

@@ -0,0 +1,89 @@
+/**
+ * Skip command — manage the skip list for excluding issues from future searches.
+ */
+import { loadLocalState, saveLocalState } from "../core/local-state.js";
+import { createScout } from "../scout.js";
+import { getGitHubToken } from "../core/utils.js";
+/**
+ * Create an OssScout instance for skip operations.
+ * Uses gist persistence when a token is available, otherwise provided-state mode.
+ */
+async function createSkipScout(state) {
+    const token = getGitHubToken() ?? "";
+    if (token) {
+        return createScout({
+            githubToken: token,
+            persistence: "provided",
+            initialState: state,
+        });
+    }
+    return createScout({
+        githubToken: "",
+        persistence: "provided",
+        initialState: state,
+    });
+}
+/**
+ * Skip an issue by URL — adds it to the skip list and removes it from saved results.
+ * Tries to enrich metadata from saved results if available.
+ */
+export async function runSkip(options) {
+    const state = options.state ?? loadLocalState();
+    const scout = await createSkipScout(state);
+    const alreadySkipped = scout
+        .getSkippedIssues()
+        .some((s) => s.url === options.issueUrl);
+    if (alreadySkipped) {
+        return { skipped: false, alreadySkipped: true };
+    }
+    // Try to enrich metadata from saved results
+    const saved = scout
+        .getSavedResults()
+        .find((r) => r.issueUrl === options.issueUrl);
+    const metadata = saved
+        ? { repo: saved.repo, number: saved.number, title: saved.title }
+        : parseIssueUrl(options.issueUrl);
+    scout.skipIssue(options.issueUrl, metadata);
+    saveLocalState(scout.getState());
+    await scout.checkpoint();
+    return { skipped: true, alreadySkipped: false };
+}
+/**
+ * List all skipped issues.
+ */
+export function runSkipList(options) {
+    const state = options?.state ?? loadLocalState();
+    return state.skippedIssues ?? [];
+}
+/**
+ * Clear all skipped issues.
+ */
+export async function runSkipClear() {
+    const state = loadLocalState();
+    const scout = await createSkipScout(state);
+    scout.clearSkippedIssues();
+    saveLocalState(scout.getState());
+    await scout.checkpoint();
+}
+/**
+ * Remove a specific issue from the skip list (unskip).
+ */
+export async function runSkipRemove(options) {
+    const state = loadLocalState();
+    const scout = await createSkipScout(state);
+    const before = scout.getSkippedIssues().length;
+    scout.unskipIssue(options.issueUrl);
+    const removed = before !== scout.getSkippedIssues().length;
+    saveLocalState(scout.getState());
+    await scout.checkpoint();
+    return { removed };
+}
+/**
+ * Parse a GitHub issue URL to extract repo and number.
+ */
+function parseIssueUrl(url) {
+    const match = url.match(/github\.com\/([^/]+\/[^/]+)\/issues\/(\d+)/);
+    if (!match)
+        return undefined;
+    return { repo: match[1], number: parseInt(match[2], 10), title: "" };
+}

package/dist/core/bootstrap.js

@@ -4,7 +4,7 @@
  */
 import { getOctokit, checkRateLimit } from "./github.js";
 import { debug, warn } from "./logger.js";
-import { errorMessage } from "./errors.js";
+import { ConfigurationError, errorMessage } from "./errors.js";
 import { extractRepoFromUrl } from "./utils.js";
 const MODULE = "bootstrap";
 const STARRED_MAX_PAGES = 5;
@@ -13,7 +13,7 @@ const PER_PAGE = 100;
 export async function bootstrapScout(scout, token) {
     const username = scout.getPreferences().githubUsername;
     if (!username) {
-        throw new Error("GitHub username not configured. Run `oss-scout setup` first.");
+        throw new ConfigurationError("GitHub username not configured. Run `oss-scout setup` first.");
     }
     const rateLimit = await checkRateLimit(token);
     debug(MODULE, `Rate limit: ${rateLimit.remaining}/${rateLimit.limit}, resets at ${rateLimit.resetAt}`);

package/dist/core/gist-state-store.js

@@ -50,11 +50,16 @@ export class GistStateStore {
             warn(MODULE, "No gist ID — cannot push");
             return false;
         }
+        const json = JSON.stringify(state, null, 2);
+        if (json.length > 900000) {
+            warn(MODULE, `State too large for gist (${Math.round(json.length / 1024)}KB). Consider clearing old results with 'oss-scout results clear'.`);
+            return false;
+        }
         try {
             await this.octokit.gists.update({
                 gist_id: this.gistId,
                 files: {
-                    [GIST_FILENAME]: { content: JSON.stringify(state, null, 2) },
+                    [GIST_FILENAME]: { content: json },
                 },
             });
             debug(MODULE, "State pushed to gist");
@@ -248,6 +253,7 @@ export function mergeStates(local, remote) {
         mergedPRs: unionByUrl(local.mergedPRs, remote.mergedPRs),
         closedPRs: unionByUrl(local.closedPRs, remote.closedPRs),
         savedResults: mergeSavedResults(local.savedResults ?? [], remote.savedResults ?? []),
+        skippedIssues: mergeSkippedIssues(local.skippedIssues ?? [], remote.skippedIssues ?? []),
         lastSearchAt: pickFresherTimestamp(local.lastSearchAt, remote.lastSearchAt),
         lastRunAt: pickFresherTimestamp(local.lastRunAt, remote.lastRunAt) ??
             new Date().toISOString(),
@@ -302,6 +308,18 @@ function mergeSavedResults(local, remote) {
     }
     return [...merged.values()];
 }
+function mergeSkippedIssues(local, remote) {
+    const merged = new Map();
+    for (const item of local)
+        merged.set(item.url, item);
+    for (const item of remote) {
+        const existing = merged.get(item.url);
+        if (!existing || item.skippedAt > existing.skippedAt) {
+            merged.set(item.url, item);
+        }
+    }
+    return [...merged.values()];
+}
 function pickFresherTimestamp(a, b) {
     if (!a)
         return b;

package/dist/core/issue-discovery.d.ts

@@ -19,7 +19,6 @@ import { type ScoutStateReader } from "./issue-vetting.js";
  *
  * Search phases (in priority order):
  * 0. Repos where user has merged PRs (highest merge probability)
- * 0.5. Preferred organizations
  * 1. Starred repos
  * 2. General label-filtered search
  * 3. Actively maintained repos
@@ -47,8 +46,8 @@ export declare class IssueDiscovery {
     getStarredRepos(): string[];
     /**
      * Search for issues matching our criteria.
-     * Searches in priority order: merged-PR repos first (no label filter), then preferred
-     * organizations, then starred repos, then general search, then actively maintained repos.
+     * Searches in priority order: merged-PR repos first (no label filter), then starred
+     * repos, then general search, then actively maintained repos.
      * Filters out issues from low-scoring and excluded repos.
      *
      * @param options - Search configuration
@@ -74,6 +73,7 @@ export declare class IssueDiscovery {
         labels?: string[];
         maxResults?: number;
         strategies?: SearchStrategy[];
+        skippedUrls?: Set<string>;
     }): Promise<{
         candidates: IssueCandidate[];
         strategiesUsed: SearchStrategy[];