@oss-scout/core 0.2.1 → 0.3.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,7 +10,6 @@ const FIELD_CONFIGS = {
     excludeRepos: { type: "array" },
     excludeOrgs: { type: "array" },
     aiPolicyBlocklist: { type: "array" },
-    preferredOrgs: { type: "array" },
     minStars: { type: "number" },
     maxIssueAgeDays: { type: "number" },
     minRepoScoreThreshold: { type: "number" },
@@ -73,13 +72,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)}`);
@@ -89,7 +84,6 @@ export function runConfigShow(options) {
     console.log(`  maxIssueAgeDays:      ${prefs.maxIssueAgeDays}`);
     console.log(`  minRepoScoreThreshold: ${prefs.minRepoScoreThreshold}`);
     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)}`);

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[];

package/dist/core/issue-discovery.js

@@ -47,6 +47,8 @@ function buildIssueFilter(config) {
                 return false;
             if (config.lowScoringRepos.has(repoFullName))
                 return false;
+            if (config.skippedUrls.has(item.html_url))
+                return false;
             const updatedAt = new Date(item.updated_at);
             const ageDays = daysBetween(updatedAt, config.now);
             if (ageDays > config.maxAgeDays)
@@ -68,42 +70,6 @@ async function runPhase0(octokit, vetter, repos, baseQualifiers, maxResults, fil
         rateLimitHit,
     };
 }
-/** Phase 0.5: Search preferred organizations. */
-async function runPhase05(octokit, vetter, orgsToSearch, baseQualifiers, labels, maxResults, phase0RepoSet, filterIssues) {
-    info(MODULE, `Phase 0.5: Searching issues in ${orgsToSearch.length} preferred org(s)...`);
-    const orgRepoFilter = orgsToSearch.map((org) => `org:${org}`).join(" OR ");
-    const orgOps = orgsToSearch.length - 1;
-    try {
-        const allItems = await searchWithChunkedLabels(octokit, labels, orgOps, (labelQ) => `${baseQualifiers} ${labelQ} (${orgRepoFilter})`
-            .replace(/  +/g, " ")
-            .trim(), maxResults * 3);
-        if (allItems.length === 0) {
-            return { candidates: [], error: null, rateLimitHit: false };
-        }
-        const filtered = filterIssues(allItems).filter((item) => {
-            const repoFullName = extractRepoFromUrl(item.repository_url);
-            if (!repoFullName)
-                return false;
-            return !phase0RepoSet.has(repoFullName);
-        });
-        const { candidates, allFailed: allVetFailed, rateLimitHit, } = await vetter.vetIssuesParallel(filtered.slice(0, maxResults * 2).map((i) => i.html_url), maxResults, "preferred_org");
-        info(MODULE, `Found ${candidates.length} candidates from preferred orgs`);
-        return {
-            candidates,
-            error: allVetFailed ? "All preferred org issue vetting failed" : null,
-            rateLimitHit,
-        };
-    }
-    catch (error) {
-        const errMsg = errorMessage(error);
-        warn(MODULE, `Error searching preferred orgs: ${errMsg}`);
-        return {
-            candidates: [],
-            error: errMsg,
-            rateLimitHit: isRateLimitError(error),
-        };
-    }
-}
 /** Phase 1: Search starred repos. */
 async function runPhase1(octokit, vetter, repos, baseQualifiers, labels, maxResults, filterIssues) {
     info(MODULE, `Phase 1: Searching issues in ${repos.length} starred repos...`);
@@ -228,7 +194,6 @@ async function runPhase3(octokit, vetter, langQuery, minStars, projectCategories
  *
  * 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
@@ -264,8 +229,8 @@ export class IssueDiscovery {
     }
     /**
      * 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
@@ -329,6 +294,11 @@ export class IssueDiscovery {
             tracker.init(CRITICAL_BUDGET_THRESHOLD, new Date(Date.now() + 60000).toISOString());
             warn(MODULE, "Could not check rate limit — using conservative budget, skipping heavy phases:", errorMessage(error));
         }
+        if (searchBudget <= 0) {
+            this.rateLimitWarning =
+                "GitHub search API quota exhausted. Try again after the rate limit resets.";
+            return { candidates: [], strategiesUsed: [] };
+        }
         // Derive search context
         const mergedPRRepos = this.stateReader.getReposWithMergedPRs();
         const starredRepos = this.getStarredRepos();
@@ -352,6 +322,7 @@ export class IssueDiscovery {
             excludeOrgs: new Set((config.excludeOrgs ?? []).map((o) => o.toLowerCase())),
             aiBlocklisted,
             lowScoringRepos,
+            skippedUrls: options.skippedUrls ?? new Set(),
             maxAgeDays: config.maxIssueAgeDays || 90,
             now: new Date(),
             includeDocIssues: config.includeDocIssues ?? true,
@@ -370,28 +341,6 @@ export class IssueDiscovery {
             }
             strategiesUsed.push("merged");
         }
-        // Phase 0.5: Preferred organizations
-        const preferredOrgs = config.preferredOrgs ?? [];
-        if (allCandidates.length < maxResults &&
-            preferredOrgs.length > 0 &&
-            searchBudget >= CRITICAL_BUDGET_THRESHOLD &&
-            enabledStrategies.has("orgs")) {
-            if (phase0Repos.length > 0)
-                await sleep(INTER_PHASE_DELAY_MS);
-            const phase0Orgs = new Set(phase0Repos.map((r) => r.split("/")[0]?.toLowerCase()));
-            const orgsToSearch = preferredOrgs
-                .filter((org) => !phase0Orgs.has(org.toLowerCase()))
-                .slice(0, 5);
-            if (orgsToSearch.length > 0) {
-                const remaining = maxResults - allCandidates.length;
-                const result = await runPhase05(this.octokit, this.vetter, orgsToSearch, baseQualifiers, labels, remaining, phase0RepoSet, filterIssues);
-                allCandidates.push(...result.candidates);
-                phaseErrors["0.5"] = result.error;
-                if (result.rateLimitHit)
-                    rateLimitHitDuringSearch = true;
-            }
-            strategiesUsed.push("orgs");
-        }
         // Phase 1: Starred repos
         if (allCandidates.length < maxResults &&
             starredRepos.length > 0 &&
@@ -451,9 +400,6 @@ export class IssueDiscovery {
                 phaseErrors["0"]
                     ? `Phase 0 (merged-PR repos): ${phaseErrors["0"]}`
                     : null,
-                phaseErrors["0.5"]
-                    ? `Phase 0.5 (preferred orgs): ${phaseErrors["0.5"]}`
-                    : null,
                 phaseErrors["1"]
                     ? `Phase 1 (starred repos): ${phaseErrors["1"]}`
                     : null,
@@ -482,9 +428,8 @@ export class IssueDiscovery {
         allCandidates.sort((a, b) => {
             const priorityOrder = {
                 merged_pr: 0,
-                preferred_org: 1,
-                starred: 2,
-                normal: 3,
+                starred: 1,
+                normal: 2,
             };
             const priorityDiff = priorityOrder[a.searchPriority] - priorityOrder[b.searchPriority];
             if (priorityDiff !== 0)

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

@@ -17,8 +17,6 @@ export interface ScoutStateReader {
     getReposWithMergedPRs(): string[];
     /** User's starred repos (from GitHub). */
     getStarredRepos(): string[];
-    /** Preferred GitHub orgs from user preferences. */
-    getPreferredOrgs(): string[];
     /** Preferred project categories from user preferences. */
     getProjectCategories(): ProjectCategory[];
     /** Numeric quality score for a repo, or null if not evaluated. */

package/dist/core/issue-vetting.js

@@ -205,14 +205,10 @@ export class IssueVetter {
             matchesPreferredCategory: matchesCategory,
         });
         const starredRepos = this.stateReader.getStarredRepos();
-        const preferredOrgs = this.stateReader.getPreferredOrgs();
         let searchPriority = "normal";
         if (effectiveMergedCount > 0) {
             searchPriority = "merged_pr";
         }
-        else if (preferredOrgs.some((o) => o.toLowerCase() === orgName?.toLowerCase())) {
-            searchPriority = "preferred_org";
-        }
         else if (starredRepos.includes(repoFullName)) {
             searchPriority = "starred";
         }

package/dist/core/local-state.js

@@ -39,8 +39,8 @@ export function loadLocalState() {
             fs.copyFileSync(statePath, backupPath);
             warn(MODULE, `Corrupt state backed up to ${backupPath}`);
         }
-        catch {
-            /* best effort backup */
+        catch (backupErr) {
+            warn(MODULE, `Failed to back up corrupt state: ${errorMessage(backupErr)}`);
         }
         return ScoutStateSchema.parse({ version: 1 });
     }

package/dist/core/schemas.d.ts

@@ -27,13 +27,12 @@ export declare const IssueScopeSchema: z.ZodEnum<{
 export declare const SearchStrategySchema: z.ZodEnum<{
     all: "all";
     merged: "merged";
-    orgs: "orgs";
     starred: "starred";
     broad: "broad";
     maintained: "maintained";
 }>;
 /** All concrete strategies (excludes 'all' meta-strategy). */
-export declare const CONCRETE_STRATEGIES: readonly ["merged", "orgs", "starred", "broad", "maintained"];
+export declare const CONCRETE_STRATEGIES: readonly ["merged", "starred", "broad", "maintained"];
 export declare const RepoSignalsSchema: z.ZodObject<{
     hasActiveMaintainers: z.ZodBoolean;
     isResponsive: z.ZodBoolean;
@@ -152,6 +151,13 @@ export declare const TrackedIssueSchema: z.ZodObject<{
         notes: z.ZodArray<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export declare const SkippedIssueSchema: z.ZodObject<{
+    url: z.ZodString;
+    repo: z.ZodString;
+    number: z.ZodNumber;
+    title: z.ZodString;
+    skippedAt: z.ZodString;
+}, z.core.$strip>;
 export declare const SavedCandidateSchema: z.ZodObject<{
     issueUrl: z.ZodString;
     repo: z.ZodString;
@@ -185,7 +191,6 @@ export declare const ScoutPreferencesSchema: z.ZodObject<{
     excludeRepos: z.ZodDefault<z.ZodArray<z.ZodString>>;
     excludeOrgs: z.ZodDefault<z.ZodArray<z.ZodString>>;
     aiPolicyBlocklist: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    preferredOrgs: z.ZodDefault<z.ZodArray<z.ZodString>>;
     projectCategories: z.ZodDefault<z.ZodArray<z.ZodEnum<{
         nonprofit: "nonprofit";
         devtools: "devtools";
@@ -205,7 +210,6 @@ export declare const ScoutPreferencesSchema: z.ZodObject<{
     defaultStrategy: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         all: "all";
         merged: "merged";
-        orgs: "orgs";
         starred: "starred";
         broad: "broad";
         maintained: "maintained";
@@ -225,7 +229,6 @@ export declare const ScoutStateSchema: z.ZodObject<{
         excludeRepos: z.ZodDefault<z.ZodArray<z.ZodString>>;
         excludeOrgs: z.ZodDefault<z.ZodArray<z.ZodString>>;
         aiPolicyBlocklist: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        preferredOrgs: z.ZodDefault<z.ZodArray<z.ZodString>>;
         projectCategories: z.ZodDefault<z.ZodArray<z.ZodEnum<{
             nonprofit: "nonprofit";
             devtools: "devtools";
@@ -245,7 +248,6 @@ export declare const ScoutStateSchema: z.ZodObject<{
         defaultStrategy: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             all: "all";
             merged: "merged";
-            orgs: "orgs";
             starred: "starred";
             broad: "broad";
             maintained: "maintained";
@@ -296,11 +298,17 @@ export declare const ScoutStateSchema: z.ZodObject<{
         lastSeenAt: z.ZodString;
         lastScore: z.ZodNumber;
     }, z.core.$strip>>>;
+    skippedIssues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        repo: z.ZodString;
+        number: z.ZodNumber;
+        title: z.ZodString;
+        skippedAt: z.ZodString;
+    }, z.core.$strip>>>;
     lastSearchAt: z.ZodOptional<z.ZodString>;
     lastRunAt: z.ZodDefault<z.ZodString>;
     gistId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type IssueStatus = z.infer<typeof IssueStatusSchema>;
 export type ProjectCategory = z.infer<typeof ProjectCategorySchema>;
 export type IssueScope = z.infer<typeof IssueScopeSchema>;
 export type SearchStrategy = z.infer<typeof SearchStrategySchema>;
@@ -311,7 +319,7 @@ export type StoredClosedPR = z.infer<typeof StoredClosedPRSchema>;
 export type ContributionGuidelines = z.infer<typeof ContributionGuidelinesSchema>;
 export type IssueVettingResult = z.infer<typeof IssueVettingResultSchema>;
 export type TrackedIssue = z.infer<typeof TrackedIssueSchema>;
-export type PersistenceMode = z.infer<typeof PersistenceModeSchema>;
 export type ScoutPreferences = z.infer<typeof ScoutPreferencesSchema>;
 export type SavedCandidate = z.infer<typeof SavedCandidateSchema>;
+export type SkippedIssue = z.infer<typeof SkippedIssueSchema>;
 export type ScoutState = z.infer<typeof ScoutStateSchema>;