@oss-scout/mcp 0.6.0 → 0.8.0

package/dist/mcp-server.bundle.cjs

@@ -37542,6 +37542,32 @@ async function searchWithChunkedLabels(octokit, labels, reservedOps, buildQuery,
   }
   return allItems;
 }
+function buildLanguageVariants(languages, isAnyLanguage, hasLabels) {
+  if (isAnyLanguage || languages.length === 0)
+    return [""];
+  if (languages.length === 1)
+    return [`language:${languages[0]}`];
+  if (!hasLabels)
+    return [languages.map((l) => `language:${l}`).join(" ")];
+  return languages.map((l) => `language:${l}`);
+}
+async function searchAcrossLanguagesAndLabels(octokit, languages, isAnyLanguage, labels, buildBaseQuery, perPage) {
+  const langVariants = buildLanguageVariants(languages, isAnyLanguage, labels.length > 0);
+  const seenUrls = /* @__PURE__ */ new Set();
+  const allItems = [];
+  for (let i = 0; i < langVariants.length; i++) {
+    if (i > 0)
+      await sleep(INTER_QUERY_DELAY_MS);
+    const items = await searchWithChunkedLabels(octokit, labels, 0, (labelQ) => `${buildBaseQuery(langVariants[i])} ${labelQ}`.replace(/  +/g, " ").trim(), perPage);
+    for (const item of items) {
+      if (!seenUrls.has(item.html_url)) {
+        seenUrls.add(item.html_url);
+        allItems.push(item);
+      }
+    }
+  }
+  return allItems;
+}
 async function filterVetAndScore(vetter, items, filterIssues, excludedRepoSets, remainingNeeded, minStars, phaseLabel) {
   const spamRepos = detectLabelFarmingRepos(items);
   if (spamRepos.size > 0) {
@@ -37574,6 +37600,72 @@ async function filterVetAndScore(vetter, items, filterIssues, excludedRepoSets,
   return { candidates: starFiltered, allVetFailed, rateLimitHit };
 }
 
+// ../core/dist/core/personalization.js
+var REPO_BOOST = 20;
+var LANGUAGE_BOOST = 10;
+function annotateBoost(candidates, preferLanguages, preferRepos) {
+  const langSet = new Set((preferLanguages ?? []).map((l) => l.trim().toLowerCase()).filter(Boolean));
+  const repoSet = new Set((preferRepos ?? []).map((r) => r.trim()).filter(Boolean));
+  if (langSet.size === 0 && repoSet.size === 0)
+    return;
+  for (const c of candidates) {
+    let score = 0;
+    const reasons = [];
+    if (repoSet.size > 0 && repoSet.has(c.issue.repo)) {
+      score += REPO_BOOST;
+      reasons.push(`repo affinity: ${c.issue.repo}`);
+    }
+    const lang = c.projectHealth.language;
+    if (langSet.size > 0 && lang && langSet.has(lang.toLowerCase())) {
+      score += LANGUAGE_BOOST;
+      reasons.push(`language match: ${lang}`);
+    }
+    if (score > 0) {
+      c.boostScore = score;
+      c.boostReasons = reasons;
+    }
+  }
+}
+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";
 var LOW_BUDGET_THRESHOLD = 20;
@@ -37629,7 +37721,7 @@ async function runPhase1(octokit, vetter, repos, labels, maxResults, filterIssue
     rateLimitHit
   };
 }
-async function runPhase2(octokit, vetter, scopes, labels, configLabels, baseQualifiers, maxResults, minStars, phase0RepoSet, starredRepoSet, existingCandidates, filterIssues) {
+async function runPhase2(octokit, vetter, scopes, labels, configLabels, languages, isAnyLanguage, maxResults, minStars, phase0RepoSet, starredRepoSet, existingCandidates, filterIssues) {
   info(MODULE10, "Phase 2: General issue search...");
   const seenRepos = new Set(existingCandidates.map((c) => c.issue.repo));
   const tierLabelGroups = [];
@@ -37656,7 +37748,7 @@ async function runPhase2(octokit, vetter, scopes, labels, configLabels, baseQual
   let rateLimitHit = false;
   for (const { tier, tierLabels } of tierLabelGroups) {
     try {
-      const allItems = await searchWithChunkedLabels(octokit, tierLabels, 0, (labelQ) => `${baseQualifiers} ${labelQ}`.replace(/  +/g, " ").trim(), budgetPerTier * 3);
+      const allItems = await searchAcrossLanguagesAndLabels(octokit, languages, isAnyLanguage, tierLabels, (langQ) => `is:issue is:open ${langQ} no:assignee`.replace(/  +/g, " ").trim(), budgetPerTier * 3);
       info(MODULE10, `Phase 2 [${tier}]: processing ${allItems.length} items...`);
       const { candidates: tierCandidates, allVetFailed, rateLimitHit: vetRateLimitHit } = await filterVetAndScore(vetter, allItems, filterIssues, [phase0RepoSet, starredRepoSet, seenRepos], budgetPerTier, minStars, `Phase 2 [${tier}]`);
       tierResults.push(tierCandidates);
@@ -37850,7 +37942,6 @@ var IssueDiscovery = class {
     const lowScoringRepos = new Set(this.deriveLowScoringRepos(config2.minRepoScoreThreshold));
     const isAnyLanguage = languages.some((l) => l.toLowerCase() === "any");
     const langQuery = isAnyLanguage ? "" : languages.map((l) => `language:${l}`).join(" ");
-    const baseQualifiers = `is:issue is:open ${langQuery} no:assignee`.replace(/  +/g, " ").trim();
     const aiBlocklisted = new Set(config2.aiPolicyBlocklist);
     if (aiBlocklisted.size > 0) {
       debug(MODULE10, `[AI_POLICY_FILTER] Filtering issues from ${aiBlocklisted.size} blocklisted repo(s): ${[...aiBlocklisted].join(", ")}`);
@@ -37922,7 +38013,7 @@ var IssueDiscovery = class {
           info(MODULE10, `Skipping broad phase delay: no results from previous phases, proceeding immediately`);
         }
         const remaining = maxResults - allCandidates.length;
-        const result = await runPhase2(this.octokit, this.vetter, scopes, labels, config2.labels, baseQualifiers, remaining, minStars, phase0RepoSet, starredRepoSet, allCandidates, filterIssues);
+        const result = await runPhase2(this.octokit, this.vetter, scopes, labels, config2.labels, languages, isAnyLanguage, remaining, minStars, phase0RepoSet, starredRepoSet, allCandidates, filterIssues);
         allCandidates.push(...result.candidates);
         phaseErrors["2"] = result.error;
         if (result.rateLimitHit)
@@ -37967,6 +38058,7 @@ var IssueDiscovery = class {
     if (rateLimitHitDuringSearch || phasesSkippedForBudget) {
       this.rateLimitWarning = `Search results may be incomplete: GitHub API rate limits were hit during search.${budgetNote} Found ${allCandidates.length} candidate${allCandidates.length === 1 ? "" : "s"} but some search phases were limited. Try again after the rate limit resets for complete results.`;
     }
+    annotateBoost(allCandidates, options.preferLanguages, options.preferRepos);
     allCandidates.sort((a, b) => {
       const priorityOrder = {
         merged_pr: 0,
@@ -37980,11 +38072,15 @@ var IssueDiscovery = class {
       const recDiff = recommendationOrder[a.recommendation] - recommendationOrder[b.recommendation];
       if (recDiff !== 0)
         return recDiff;
+      const boostDiff = (b.boostScore ?? 0) - (a.boostScore ?? 0);
+      if (boostDiff !== 0)
+        return boostDiff;
       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.
@@ -38812,7 +38908,10 @@ var OssScout = class {
     const { candidates, strategiesUsed } = await discovery.searchIssues({
       maxResults: options?.maxResults,
       strategies: options?.strategies,
-      skippedUrls
+      skippedUrls,
+      preferLanguages: options?.preferLanguages,
+      preferRepos: options?.preferRepos,
+      diversityRatio: options?.diversityRatio
     });
     this.state.lastSearchAt = (/* @__PURE__ */ new Date()).toISOString();
     this.dirty = true;
@@ -39271,15 +39370,33 @@ function registerTools(server, scout) {
       maxResults: external_exports3.number().optional().describe("Maximum number of results to return (default 10)"),
       strategies: external_exports3.string().optional().describe(
         "Comma-separated search strategies: merged, starred, broad, maintained, all"
+      ),
+      preferLanguages: external_exports3.array(external_exports3.string()).optional().describe(
+        "Soft-boost ranking for candidates whose repo language matches one of these (case-insensitive). Personalization tier between recommendation and viabilityScore (#1244). Not a filter; only reorders."
+      ),
+      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 }) => {
+    async ({
+      maxResults,
+      strategies,
+      preferLanguages,
+      preferRepos,
+      diversityRatio
+    }) => {
       try {
         const parsedStrategies = strategies ? strategies.split(",").map((s) => SearchStrategySchema.parse(s.trim())) : void 0;
         const result = await withTimeout(
           scout.search({
             maxResults: maxResults ?? 10,
-            strategies: parsedStrategies
+            strategies: parsedStrategies,
+            preferLanguages,
+            preferRepos,
+            diversityRatio
           })
         );
         scout.saveResults(result.candidates);

package/dist/tools.js

@@ -18,7 +18,21 @@ export function registerTools(server, scout) {
             .string()
             .optional()
             .describe("Comma-separated search strategies: merged, starred, broad, maintained, all"),
-    }, async ({ maxResults, strategies }) => {
+        preferLanguages: z
+            .array(z.string())
+            .optional()
+            .describe("Soft-boost ranking for candidates whose repo language matches one of these (case-insensitive). Personalization tier between recommendation and viabilityScore (#1244). Not a filter; only reorders."),
+        preferRepos: z
+            .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."),
+        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
@@ -28,6 +42,9 @@ export function registerTools(server, scout) {
             const result = await withTimeout(scout.search({
                 maxResults: maxResults ?? 10,
                 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.6.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.9.0"
+    "@oss-scout/core": "^0.11.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",