@oss-scout/core 1.2.0 → 1.2.2

package/dist/core/issue-discovery.js

@@ -42,6 +42,15 @@ const PHASE0_PER_PAGE = 30;
  * screens staleness, existing PRs, and claims downstream.
  */
 const CONTRIBUTED_REPO_MAX_AGE_DAYS = 365;
+/**
+ * Cap on Phase 0's share of `maxResults`. Phase 0 (contributed repos) fetches
+ * deeply (`PHASE0_PER_PAGE`) and can otherwise fill the entire result budget,
+ * which makes the `allCandidates.length < maxResults` gate false for every
+ * later phase so starred (Phase 1) and broad (Phases 2/3) never run. Reserving
+ * half the budget for the other strategies keeps each search round varied
+ * instead of returning only contributed-repo results.
+ */
+const PHASE0_MAX_SHARE = 0.5;
 /** Build a reusable filter function from config. */
 function buildIssueFilter(config) {
     return (items) => {
@@ -421,8 +430,19 @@ export class IssueDiscovery {
                 break;
         }
         const phase0RepoSet = new Set(phase0Repos);
+        // Only cap Phase 0 when a later phase can actually consume the reserved
+        // budget — otherwise (no starred repos, broad/maintained disabled) the
+        // reservation would just shrink the result set with nothing to fill it.
+        const otherStrategiesCanRun = (starredRepos.length > 0 && enabledStrategies.has("starred")) ||
+            enabledStrategies.has("broad") ||
+            enabledStrategies.has("maintained");
         if (phase0Repos.length > 0 && enabledStrategies.has("merged")) {
-            const remaining = maxResults - allCandidates.length;
+            // Cap Phase 0's share so it can't consume the whole budget and starve
+            // the starred/broad phases (which gate on allCandidates < maxResults).
+            const phase0Cap = otherStrategiesCanRun
+                ? Math.max(1, Math.ceil(maxResults * PHASE0_MAX_SHARE))
+                : maxResults;
+            const remaining = Math.min(maxResults - allCandidates.length, phase0Cap);
             if (remaining > 0) {
                 const result = await runPhase0(this.octokit, this.vetter, phase0Repos, remaining, filterIssuesPhase0);
                 recordPhaseResult("0", result);

package/dist/core/types.d.ts

@@ -281,6 +281,21 @@ export interface SearchOptions {
      * `interPhaseDelayMs` for the rationale (#143).
      */
     broadPhaseDelayMs?: number;
+    /**
+     * Exclude issues already surfaced by a recent search so consecutive
+     * searches rotate to fresh candidates instead of returning the same set
+     * (#249). A result counts as "recently surfaced" when its `lastSeenAt`
+     * (recorded by `saveResults`) is within `recentlySurfacedTtlDays`.
+     * Defaults to `true`. Pass `false` to force-resurface (e.g. an explicit
+     * "search the same pool again" request).
+     */
+    excludeRecentlySurfaced?: boolean;
+    /**
+     * TTL in days for the `excludeRecentlySurfaced` rotation window (#249).
+     * Results last surfaced more than this many days ago are eligible to
+     * resurface. Defaults to 7.
+     */
+    recentlySurfacedTtlDays?: number;
 }
 /** Result of a search operation. */
 export interface SearchResult {

package/dist/scout.js

@@ -170,6 +170,18 @@ export class OssScout {
         // Auto-cull expired skips before searching
         this.cullExpiredSkips();
         const skippedUrls = new Set((this.state.skippedIssues ?? []).map((s) => s.url));
+        // Rotation (#249): also exclude issues surfaced by a recent search so
+        // consecutive searches return fresh candidates instead of the same set.
+        // Folded into the same exclusion set the issue filter already honors.
+        if (options?.excludeRecentlySurfaced ?? true) {
+            const ttlDays = options?.recentlySurfacedTtlDays ?? 7;
+            const cutoff = Date.now() - ttlDays * 24 * 60 * 60 * 1000;
+            for (const r of this.state.savedResults ?? []) {
+                const seen = Date.parse(r.lastSeenAt);
+                if (!Number.isNaN(seen) && seen >= cutoff)
+                    skippedUrls.add(r.issueUrl);
+            }
+        }
         const discovery = new IssueDiscovery(this.githubToken, this.state.preferences, this);
         // Per-call flags override the persisted personalization defaults (#168).
         // An empty preference array reads as "no boost" just like an absent flag.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-scout/core",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "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": {