@oss-scout/mcp 0.7.0 → 0.8.0

package/dist/mcp-server.bundle.cjs

@@ -37626,6 +37626,45 @@ function annotateBoost(candidates, preferLanguages, preferRepos) {
     }
   }
 }
+function applyDiversityRatio(candidates, maxResults, diversityRatio) {
+  if (maxResults <= 0)
+    return [];
+  const ratio = Math.max(0, Math.min(1, diversityRatio));
+  if (ratio === 0)
+    return candidates.slice(0, maxResults);
+  const diversityReserve = Math.min(Math.floor(maxResults * ratio), maxResults);
+  if (diversityReserve === 0)
+    return candidates.slice(0, maxResults);
+  const mainBudget = maxResults - diversityReserve;
+  const picks = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const c of candidates) {
+    if (picks.length >= mainBudget)
+      break;
+    picks.push(c);
+    seen.add(c.issue.url);
+  }
+  for (const c of candidates) {
+    if (picks.length >= maxResults)
+      break;
+    if (seen.has(c.issue.url))
+      continue;
+    if (c.boostScore && c.boostScore > 0)
+      continue;
+    c.diversitySlot = true;
+    picks.push(c);
+    seen.add(c.issue.url);
+  }
+  for (const c of candidates) {
+    if (picks.length >= maxResults)
+      break;
+    if (seen.has(c.issue.url))
+      continue;
+    picks.push(c);
+    seen.add(c.issue.url);
+  }
+  return picks;
+}
 
 // ../core/dist/core/issue-discovery.js
 var MODULE10 = "issue-discovery";
@@ -38039,8 +38078,9 @@ var IssueDiscovery = class {
       return b.viabilityScore - a.viabilityScore;
     });
     const capped = applyPerRepoCap(allCandidates, 2);
-    info(MODULE10, `Search complete: ${tracker.getTotalCalls()} Search API calls used, ${capped.length} candidates returned`);
-    return { candidates: capped.slice(0, maxResults), strategiesUsed };
+    const finalPicks = applyDiversityRatio(capped, maxResults, options.diversityRatio ?? 0);
+    info(MODULE10, `Search complete: ${tracker.getTotalCalls()} Search API calls used, ${finalPicks.length} candidates returned`);
+    return { candidates: finalPicks, strategiesUsed };
   }
   /**
    * Vet a specific issue for claimability and project health.
@@ -38870,7 +38910,8 @@ var OssScout = class {
       strategies: options?.strategies,
       skippedUrls,
       preferLanguages: options?.preferLanguages,
-      preferRepos: options?.preferRepos
+      preferRepos: options?.preferRepos,
+      diversityRatio: options?.diversityRatio
     });
     this.state.lastSearchAt = (/* @__PURE__ */ new Date()).toISOString();
     this.dirty = true;
@@ -39335,9 +39376,18 @@ function registerTools(server, scout) {
       ),
       preferRepos: external_exports3.array(external_exports3.string()).optional().describe(
         "Soft-boost ranking for candidates in one of these `owner/repo` slugs. Stronger weight than language match (#1244). Not a filter; only reorders."
+      ),
+      diversityRatio: external_exports3.number().min(0).max(1).optional().describe(
+        "Diversity counterweight (#1244): fraction of result slots reserved for candidates that matched NEITHER preference list. Counters echo-chamber bias when boosts accumulate over time. 0 disables, 1 reserves every slot for diversity. Default 0."
       )
     },
-    async ({ maxResults, strategies, preferLanguages, preferRepos }) => {
+    async ({
+      maxResults,
+      strategies,
+      preferLanguages,
+      preferRepos,
+      diversityRatio
+    }) => {
       try {
         const parsedStrategies = strategies ? strategies.split(",").map((s) => SearchStrategySchema.parse(s.trim())) : void 0;
         const result = await withTimeout(
@@ -39345,7 +39395,8 @@ function registerTools(server, scout) {
             maxResults: maxResults ?? 10,
             strategies: parsedStrategies,
             preferLanguages,
-            preferRepos
+            preferRepos,
+            diversityRatio
           })
         );
         scout.saveResults(result.candidates);

package/dist/tools.js

@@ -26,7 +26,13 @@ export function registerTools(server, scout) {
             .array(z.string())
             .optional()
             .describe("Soft-boost ranking for candidates in one of these `owner/repo` slugs. Stronger weight than language match (#1244). Not a filter; only reorders."),
-    }, async ({ maxResults, strategies, preferLanguages, preferRepos }) => {
+        diversityRatio: z
+            .number()
+            .min(0)
+            .max(1)
+            .optional()
+            .describe("Diversity counterweight (#1244): fraction of result slots reserved for candidates that matched NEITHER preference list. Counters echo-chamber bias when boosts accumulate over time. 0 disables, 1 reserves every slot for diversity. Default 0."),
+    }, async ({ maxResults, strategies, preferLanguages, preferRepos, diversityRatio, }) => {
         try {
             const parsedStrategies = strategies
                 ? strategies
@@ -38,6 +44,7 @@ export function registerTools(server, scout) {
                 strategies: parsedStrategies,
                 preferLanguages,
                 preferRepos,
+                diversityRatio,
             }));
             scout.saveResults(result.candidates);
             await scout.checkpoint();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-scout/mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "MCP server for oss-scout — exposes issue discovery and vetting as MCP tools",
   "type": "module",
   "bin": {
@@ -18,7 +18,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
     "zod": "^4.3.6",
-    "@oss-scout/core": "^0.10.0"
+    "@oss-scout/core": "^0.11.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",