@oss-scout/core 0.2.1 → 0.3.0

package/dist/core/schemas.js

@@ -27,7 +27,6 @@ export const IssueScopeSchema = z.enum([
 ]);
 export const SearchStrategySchema = z.enum([
     "merged",
-    "orgs",
     "starred",
     "broad",
     "maintained",
@@ -36,7 +35,6 @@ export const SearchStrategySchema = z.enum([
 /** All concrete strategies (excludes 'all' meta-strategy). */
 export const CONCRETE_STRATEGIES = [
     "merged",
-    "orgs",
     "starred",
     "broad",
     "maintained",
@@ -111,6 +109,14 @@ export const TrackedIssueSchema = z.object({
     vetted: z.boolean(),
     vettingResult: IssueVettingResultSchema.optional(),
 });
+// ── Skipped issue schema ──────────────────────────────────────────
+export const SkippedIssueSchema = z.object({
+    url: z.string(),
+    repo: z.string(),
+    number: z.number(),
+    title: z.string(),
+    skippedAt: z.string(),
+});
 // ── Saved candidate schema ─────────────────────────────────────────
 export const SavedCandidateSchema = z.object({
     issueUrl: z.string(),
@@ -129,13 +135,12 @@ export const SavedCandidateSchema = z.object({
 export const PersistenceModeSchema = z.enum(["local", "gist"]);
 export const ScoutPreferencesSchema = z.object({
     githubUsername: z.string().default(""),
-    languages: z.array(z.string()).default(["typescript", "javascript"]),
+    languages: z.array(z.string()).default(["any"]),
     labels: z.array(z.string()).default(["good first issue", "help wanted"]),
     scope: z.array(IssueScopeSchema).optional(),
     excludeRepos: z.array(z.string()).default([]),
     excludeOrgs: z.array(z.string()).default([]),
     aiPolicyBlocklist: z.array(z.string()).default(["matplotlib/matplotlib"]),
-    preferredOrgs: z.array(z.string()).default([]),
     projectCategories: z.array(ProjectCategorySchema).default([]),
     minStars: z.number().default(50),
     maxIssueAgeDays: z.number().default(90),
@@ -154,6 +159,7 @@ export const ScoutStateSchema = z.object({
     mergedPRs: z.array(StoredMergedPRSchema).default([]),
     closedPRs: z.array(StoredClosedPRSchema).default([]),
     savedResults: z.array(SavedCandidateSchema).default([]),
+    skippedIssues: z.array(SkippedIssueSchema).default([]),
     lastSearchAt: z.string().optional(),
     lastRunAt: z.string().default(() => new Date().toISOString()),
     gistId: z.string().optional(),

package/dist/core/types.d.ts

@@ -19,7 +19,7 @@ export interface ProjectHealth {
     failureReason?: string;
 }
 /** Priority tier for issue search results. */
-export type SearchPriority = "merged_pr" | "preferred_org" | "starred" | "normal";
+export type SearchPriority = "merged_pr" | "starred" | "normal";
 /** A fully vetted issue candidate with scoring. */
 export interface IssueCandidate {
     issue: TrackedIssue;

package/dist/index.d.ts

@@ -16,8 +16,8 @@
  */
 export { createScout, OssScout } from "./scout.js";
 export type { ScoutConfig, SearchOptions, SearchResult, IssueCandidate, MergedPRRecord, ClosedPRRecord, RepoScoreUpdate, ProjectHealth, SearchPriority, CheckResult, VetListOptions, VetListResult, VetListEntry, VetListSummary, } from "./core/types.js";
-export type { ScoutState, ScoutPreferences, RepoScore, RepoSignals, IssueVettingResult, ContributionGuidelines, TrackedIssue, IssueScope, ProjectCategory, StoredMergedPR, StoredClosedPR, SearchStrategy, } from "./core/schemas.js";
-export { ScoutStateSchema, ScoutPreferencesSchema, RepoScoreSchema, IssueScopeSchema, ProjectCategorySchema, SearchStrategySchema, } from "./core/schemas.js";
+export type { ScoutState, ScoutPreferences, RepoScore, RepoSignals, IssueVettingResult, ContributionGuidelines, TrackedIssue, IssueScope, ProjectCategory, StoredMergedPR, StoredClosedPR, SearchStrategy, SkippedIssue, } from "./core/schemas.js";
+export { ScoutStateSchema, ScoutPreferencesSchema, RepoScoreSchema, IssueScopeSchema, ProjectCategorySchema, SearchStrategySchema, SkippedIssueSchema, } from "./core/schemas.js";
 export { requireGitHubToken, getGitHubToken } from "./core/utils.js";
 export { IssueDiscovery } from "./core/issue-discovery.js";
 export { IssueVetter, type ScoutStateReader } from "./core/issue-vetting.js";

package/dist/index.js

@@ -17,7 +17,7 @@
 // Main API
 export { createScout, OssScout } from "./scout.js";
 // Schemas (for consumers who need runtime validation)
-export { ScoutStateSchema, ScoutPreferencesSchema, RepoScoreSchema, IssueScopeSchema, ProjectCategorySchema, SearchStrategySchema, } from "./core/schemas.js";
+export { ScoutStateSchema, ScoutPreferencesSchema, RepoScoreSchema, IssueScopeSchema, ProjectCategorySchema, SearchStrategySchema, SkippedIssueSchema, } from "./core/schemas.js";
 // Utilities
 export { requireGitHubToken, getGitHubToken } from "./core/utils.js";
 // Internal classes (for advanced use)

package/dist/scout.d.ts

@@ -5,7 +5,7 @@
  * Implements ScoutStateReader to bridge state with the search engine.
  */
 import type { ScoutStateReader } from "./core/issue-vetting.js";
-import type { ScoutState, ScoutPreferences, RepoScore, SavedCandidate } from "./core/schemas.js";
+import type { ScoutState, ScoutPreferences, RepoScore, SavedCandidate, SkippedIssue } from "./core/schemas.js";
 import type { ScoutConfig, SearchOptions, SearchResult, IssueCandidate, MergedPRRecord, ClosedPRRecord, RepoScoreUpdate, ProjectCategory, VetListOptions, VetListResult } from "./core/types.js";
 import { GistStateStore } from "./core/gist-state-store.js";
 /**
@@ -44,6 +44,7 @@ export declare class OssScout implements ScoutStateReader {
     constructor(githubToken: string, initialState: ScoutState, gistStore?: GistStateStore | null);
     /**
      * Multi-strategy issue search. Returns scored, sorted candidates.
+     * Automatically culls expired skip entries and filters skipped issues.
      */
     search(options?: SearchOptions): Promise<SearchResult>;
     /**
@@ -59,7 +60,6 @@ export declare class OssScout implements ScoutStateReader {
     private classifyVetResult;
     getReposWithMergedPRs(): string[];
     getStarredRepos(): string[];
-    getPreferredOrgs(): string[];
     getProjectCategories(): ProjectCategory[];
     getRepoScore(repo: string): number | null;
     /** Get current preferences (read-only). */
@@ -101,6 +101,31 @@ export declare class OssScout implements ScoutStateReader {
      * Clear all saved results.
      */
     clearResults(): void;
+    /**
+     * Skip an issue — excludes it from future searches. Auto-culled after 90 days.
+     */
+    skipIssue(url: string, metadata?: {
+        repo?: string;
+        number?: number;
+        title?: string;
+    }): void;
+    /**
+     * Get all skipped issues.
+     */
+    getSkippedIssues(): SkippedIssue[];
+    /**
+     * Remove a specific issue from the skip list.
+     */
+    unskipIssue(url: string): void;
+    /**
+     * Clear all skipped issues.
+     */
+    clearSkippedIssues(): void;
+    /**
+     * Remove skipped issues older than maxDays (default 90). Called automatically during search.
+     * @returns The number of expired entries that were removed.
+     */
+    cullExpiredSkips(maxDays?: number): number;
     /**
      * Check if state has uncommitted changes.
      */

package/dist/scout.js

@@ -119,12 +119,17 @@ export class OssScout {
     // ── Search ──────────────────────────────────────────────────────────
     /**
      * Multi-strategy issue search. Returns scored, sorted candidates.
+     * Automatically culls expired skip entries and filters skipped issues.
      */
     async search(options) {
+        // Auto-cull expired skips before searching
+        this.cullExpiredSkips();
+        const skippedUrls = new Set((this.state.skippedIssues ?? []).map((s) => s.url));
         const discovery = new IssueDiscovery(this.githubToken, this.state.preferences, this);
         const { candidates, strategiesUsed } = await discovery.searchIssues({
             maxResults: options?.maxResults,
             strategies: options?.strategies,
+            skippedUrls,
         });
         this.state.lastSearchAt = new Date().toISOString();
         this.dirty = true;
@@ -234,9 +239,6 @@ export class OssScout {
     getStarredRepos() {
         return this.state.starredRepos;
     }
-    getPreferredOrgs() {
-        return this.state.preferences.preferredOrgs;
-    }
     getProjectCategories() {
         return this.state.preferences.projectCategories;
     }
@@ -369,6 +371,70 @@ export class OssScout {
         this.state.savedResults = [];
         this.dirty = true;
     }
+    // ── Skip List ───────────────────────────────────────────────────────
+    /**
+     * Skip an issue — excludes it from future searches. Auto-culled after 90 days.
+     */
+    skipIssue(url, metadata) {
+        const existing = this.state.skippedIssues ?? [];
+        if (existing.some((s) => s.url === url))
+            return; // already skipped
+        this.state.skippedIssues = [
+            ...existing,
+            {
+                url,
+                repo: metadata?.repo ?? "",
+                number: metadata?.number ?? 0,
+                title: metadata?.title ?? "",
+                skippedAt: new Date().toISOString(),
+            },
+        ];
+        // Also remove from saved results if present
+        if (this.state.savedResults) {
+            this.state.savedResults = this.state.savedResults.filter((r) => r.issueUrl !== url);
+        }
+        this.dirty = true;
+    }
+    /**
+     * Get all skipped issues.
+     */
+    getSkippedIssues() {
+        return this.state.skippedIssues ?? [];
+    }
+    /**
+     * Remove a specific issue from the skip list.
+     */
+    unskipIssue(url) {
+        this.state.skippedIssues = (this.state.skippedIssues ?? []).filter((s) => s.url !== url);
+        this.dirty = true;
+    }
+    /**
+     * Clear all skipped issues.
+     */
+    clearSkippedIssues() {
+        this.state.skippedIssues = [];
+        this.dirty = true;
+    }
+    /**
+     * Remove skipped issues older than maxDays (default 90). Called automatically during search.
+     * @returns The number of expired entries that were removed.
+     */
+    cullExpiredSkips(maxDays = 90) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - maxDays);
+        const before = (this.state.skippedIssues ?? []).length;
+        this.state.skippedIssues = (this.state.skippedIssues ?? []).filter((s) => {
+            const d = new Date(s.skippedAt);
+            if (isNaN(d.getTime())) {
+                return true; // keep entries with invalid dates rather than silently dropping
+            }
+            return d >= cutoff;
+        });
+        const culled = before - this.state.skippedIssues.length;
+        if (culled > 0)
+            this.dirty = true;
+        return culled;
+    }
     // ── Persistence ─────────────────────────────────────────────────────
     /**
      * Check if state has uncommitted changes.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oss-scout/core",
-  "version": "0.2.1",
-  "description": "Find open source issues personalized to your contribution history",
+  "version": "0.3.0",
+  "description": "Personalized GitHub issue finder with multi-strategy search, deep vetting, and viability scoring — CLI, library, MCP server, and Claude Code plugin",
   "type": "module",
   "bin": {
     "oss-scout": "./dist/cli.bundle.cjs"
@@ -37,7 +37,11 @@
     "issue-discovery",
     "cli",
     "vetting",
-    "contributions"
+    "contributions",
+    "claude",
+    "mcp-server",
+    "contribution-finder",
+    "personalized"
   ],
   "author": "John Costa",
   "license": "MIT",