@oss-scout/mcp 0.10.2 → 0.11.0

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export { registerResources } from "./resources.js";
 /** Server identity, kept in one place for the bin and any embedding host. */
 export declare const SERVER_INFO: {
     readonly name: "oss-scout-mcp";
-    readonly version: "0.10.2";
+    readonly version: "0.11.0";
 };
 /**
  * Build a fully-wired MCP server (tools + resources) around a scout.

package/dist/index.js

@@ -15,7 +15,7 @@ export { registerResources } from "./resources.js";
 /** Server identity, kept in one place for the bin and any embedding host. */
 export const SERVER_INFO = {
     name: "oss-scout-mcp",
-    version: "0.10.2", // x-release-please-version
+    version: "0.11.0", // x-release-please-version
 };
 /**
  * Build a fully-wired MCP server (tools + resources) around a scout.

package/dist/mcp-server.bundle.cjs

@@ -36075,6 +36075,7 @@ var IssueScopeSchema = external_exports3.enum([
 ]);
 var SearchStrategySchema = external_exports3.enum([
   "merged",
+  "orgs",
   "starred",
   "broad",
   "maintained",
@@ -36082,6 +36083,7 @@ var SearchStrategySchema = external_exports3.enum([
 ]);
 var CONCRETE_STRATEGIES = [
   "merged",
+  "orgs",
   "starred",
   "broad",
   "maintained"
@@ -36215,6 +36217,9 @@ var ScoutPreferencesSchema = external_exports3.looseObject({
   scope: external_exports3.array(IssueScopeSchema).optional(),
   excludeRepos: external_exports3.array(external_exports3.string()).default([]),
   excludeOrgs: external_exports3.array(external_exports3.string()).default([]),
+  // Orgs whose repos the "orgs" search phase targets with org: qualifiers.
+  // Empty (the default) disables the phase even when the strategy is enabled.
+  preferredOrgs: external_exports3.array(external_exports3.string()).default([]),
   aiPolicyBlocklist: external_exports3.array(external_exports3.string()).default(["matplotlib/matplotlib"]),
   projectCategories: external_exports3.array(ProjectCategorySchema).default([]),
   minStars: external_exports3.number().default(50),
@@ -38420,7 +38425,7 @@ function buildLanguageVariants(languages, isAnyLanguage, hasLabels) {
     return [languages.map((l) => `language:${l}`).join(" ")];
   return languages.map((l) => `language:${l}`);
 }
-async function searchAcrossLanguagesAndLabels(octokit, languages, isAnyLanguage, labels, buildBaseQuery, perPage, tracker = getSearchBudgetTracker(), startOffset = 0) {
+async function searchAcrossLanguagesAndLabels(octokit, languages, isAnyLanguage, labels, buildBaseQuery, perPage, tracker = getSearchBudgetTracker(), startOffset = 0, reservedOps = 0) {
   const variants = buildLanguageVariants(languages, isAnyLanguage, labels.length > 0);
   const k = variants.length > 0 ? startOffset % variants.length : 0;
   const langVariants = [...variants.slice(k), ...variants.slice(0, k)];
@@ -38429,7 +38434,7 @@ async function searchAcrossLanguagesAndLabels(octokit, languages, isAnyLanguage,
   for (let i = 0; i < langVariants.length; i++) {
     if (i > 0)
       await sleep(GRAPHQL_INTER_QUERY_DELAY_MS);
-    const items = await searchWithChunkedLabels(octokit, labels, 0, (labelQ) => `${buildBaseQuery(langVariants[i])} ${labelQ}`.replace(/  +/g, " ").trim(), perPage, tracker);
+    const items = await searchWithChunkedLabels(octokit, labels, reservedOps, (labelQ) => `${buildBaseQuery(langVariants[i])} ${labelQ}`.replace(/  +/g, " ").trim(), perPage, tracker);
     for (const item of items) {
       if (!seenUrls.has(item.html_url)) {
         seenUrls.add(item.html_url);
@@ -38607,6 +38612,35 @@ async function runPhase0(octokit, vetter, repos, maxResults, filterIssues) {
     rateLimitHit
   };
 }
+var MAX_QUERY_ORGS = 8;
+async function runPhaseOrgs(octokit, vetter, orgs, languages, isAnyLanguage, labels, maxResults, minStars, phase0RepoSet, starredRepoSet, filterIssues, tracker) {
+  info(MODULE12, `Orgs phase: searching ${orgs.length} preferred org(s)...`);
+  const queryOrgs = orgs.slice(0, MAX_QUERY_ORGS);
+  if (orgs.length > MAX_QUERY_ORGS) {
+    warn(MODULE12, `Orgs phase: capping query at ${MAX_QUERY_ORGS} org(s); dropping ${orgs.slice(MAX_QUERY_ORGS).join(", ")}`);
+  }
+  const orgQuery = queryOrgs.map((o) => `org:${o}`).join(" ");
+  try {
+    const allItems = await searchAcrossLanguagesAndLabels(octokit, languages, isAnyLanguage, labels, (langQ) => `is:issue is:open ${langQ} no:assignee ${orgQuery}`.replace(/  +/g, " ").trim(), maxResults * 3, tracker, 0, queryOrgs.length);
+    const { candidates, allVetFailed, rateLimitHit } = await filterVetAndScore(vetter, allItems, filterIssues, [phase0RepoSet, starredRepoSet], maxResults, minStars, "Orgs phase");
+    info(MODULE12, `Found ${candidates.length} candidates from preferred orgs`);
+    return {
+      candidates,
+      error: allVetFailed ? "all vetting failed" : null,
+      rateLimitHit
+    };
+  } catch (error48) {
+    if (getHttpStatusCode(error48) === 401)
+      throw error48;
+    const errMsg = errorMessage(error48);
+    warn(MODULE12, `Error in preferred-orgs search: ${errMsg}`);
+    return {
+      candidates: [],
+      error: errMsg,
+      rateLimitHit: isRateLimitError(error48)
+    };
+  }
+}
 async function runPhase1(octokit, vetter, repos, labels, maxResults, filterIssues) {
   info(MODULE12, `Phase 1: Searching issues in ${repos.length} starred repos...`);
   const phase1Labels = labels.slice(0, 3);
@@ -38896,7 +38930,9 @@ var IssueDiscovery = class {
         break;
     }
     const phase0RepoSet = new Set(phase0Repos);
-    const otherStrategiesCanRun = starredRepos.length > 0 && enabledStrategies.has("starred") || enabledStrategies.has("broad") || enabledStrategies.has("maintained");
+    const preferredOrgs = config2.preferredOrgs ?? [];
+    const orgsPhaseEnabled = preferredOrgs.length > 0 && enabledStrategies.has("orgs");
+    const otherStrategiesCanRun = orgsPhaseEnabled || starredRepos.length > 0 && enabledStrategies.has("starred") || enabledStrategies.has("broad") || enabledStrategies.has("maintained");
     if (phase0Repos.length > 0 && enabledStrategies.has("merged")) {
       const phase0Cap = otherStrategiesCanRun ? Math.max(1, Math.ceil(maxResults * PHASE0_MAX_SHARE)) : maxResults;
       const remaining = Math.min(maxResults - allCandidates.length, phase0Cap);
@@ -38906,6 +38942,13 @@ var IssueDiscovery = class {
       }
       strategiesUsed.push("merged");
     }
+    if (allCandidates.length < maxResults && orgsPhaseEnabled) {
+      await applyInterPhaseDelay();
+      const remaining = maxResults - allCandidates.length;
+      const result = await runPhaseOrgs(this.octokit, this.vetter, preferredOrgs, languages, isAnyLanguage, labels, remaining, minStars, phase0RepoSet, starredRepoSet, filterIssues, tracker);
+      recordPhaseResult("orgs", result);
+      strategiesUsed.push("orgs");
+    }
     if (allCandidates.length < maxResults && starredRepos.length > 0 && searchBudget >= CRITICAL_BUDGET_THRESHOLD && enabledStrategies.has("starred")) {
       await applyInterPhaseDelay();
       const reposToSearch = starredRepos.filter((r) => !phase0RepoSet.has(r));
@@ -38925,7 +38968,8 @@ var IssueDiscovery = class {
     if (viableBeforeBroad >= maxResults && enabledStrategies.has("broad")) {
       info(MODULE12, `Skipping broad search: ${viableBeforeBroad} viable candidate(s) already meet maxResults (${maxResults})`);
     } else if (enabledStrategies.has("broad")) {
-      const newRepoCandidateCount = allCandidates.filter((c) => c.recommendation !== "skip" && !phase0RepoSet.has(c.issue.repo) && !starredRepoSet.has(c.issue.repo)).length;
+      const preferredOrgSet = new Set(preferredOrgs.map((o) => o.toLowerCase()));
+      const newRepoCandidateCount = allCandidates.filter((c) => c.recommendation !== "skip" && !phase0RepoSet.has(c.issue.repo) && !starredRepoSet.has(c.issue.repo) && !preferredOrgSet.has(c.issue.repo.split("/")[0]?.toLowerCase() ?? "")).length;
       if (skipThreshold > 0 && newRepoCandidateCount >= skipThreshold) {
         info(MODULE12, `Skipping broad search: already found ${newRepoCandidateCount} viable candidate(s) from new repos (threshold: ${skipThreshold})`);
       } else {
@@ -38957,6 +39001,7 @@ var IssueDiscovery = class {
     if (allCandidates.length === 0) {
       const errorDetails = [
         phaseErrors["0"] ? `Phase 0 (merged-PR repos): ${phaseErrors["0"]}` : null,
+        phaseErrors["orgs"] ? `Orgs phase (preferred orgs): ${phaseErrors["orgs"]}` : null,
         phaseErrors["1"] ? `Phase 1 (starred repos): ${phaseErrors["1"]}` : null,
         phaseErrors["2"] ? `Phase 2 (general): ${phaseErrors["2"]}` : null,
         phaseErrors["3"] ? `Phase 3 (maintained repos): ${phaseErrors["3"]}` : null
@@ -40647,6 +40692,7 @@ var FIELD_CONFIGS = {
   scope: { type: "enum-array", validValues: IssueScopeSchema.options },
   excludeRepos: { type: "array" },
   excludeOrgs: { type: "array" },
+  preferredOrgs: { type: "array" },
   aiPolicyBlocklist: { type: "array" },
   projectCategories: {
     type: "enum-array",
@@ -40810,7 +40856,7 @@ function registerTools(server, scout) {
     {
       maxResults: external_exports3.number().int().min(1).max(100).optional().describe("Maximum number of results to return (1-100, default 10)"),
       strategies: external_exports3.string().optional().describe(
-        "Comma-separated search strategies: merged, starred, broad, maintained, all"
+        "Comma-separated search strategies: merged, orgs, 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."
@@ -41157,7 +41203,7 @@ function registerResources(server, scout) {
 // src/index.ts
 var SERVER_INFO = {
   name: "oss-scout-mcp",
-  version: "0.10.2"
+  version: "0.11.0"
   // x-release-please-version
 };
 function createServer(scout) {

package/dist/tools.js

@@ -44,7 +44,7 @@ export function registerTools(server, scout) {
         strategies: z
             .string()
             .optional()
-            .describe("Comma-separated search strategies: merged, starred, broad, maintained, all"),
+            .describe("Comma-separated search strategies: merged, orgs, starred, broad, maintained, all"),
         preferLanguages: z
             .array(z.string())
             .optional()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-scout/mcp",
-  "version": "0.10.2",
+  "version": "0.11.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": "^1.5.2"
+    "@oss-scout/core": "^1.6.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",