@oss-scout/core 1.2.1 → 1.2.2

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.1",
+  "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": {