@oss-scout/mcp 0.9.0 → 0.10.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.9.0";
+    readonly version: "0.10.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.9.0", // x-release-please-version
+    version: "0.10.0", // x-release-please-version
 };
 /**
  * Build a fully-wired MCP server (tools + resources) around a scout.

package/dist/mcp-server.bundle.cjs

@@ -35867,6 +35867,9 @@ var CONCRETE_STRATEGIES = [
 ];
 var RepoSignalsSchema = external_exports3.looseObject({
   hasActiveMaintainers: external_exports3.boolean(),
+  // Retained for backward compatibility but no longer affects the repo score
+  // (#167): nothing computes it, and hasActiveMaintainers is the live activity
+  // proxy. Kept so old persisted state and the search JSON output still parse.
   isResponsive: external_exports3.boolean(),
   hasHostileComments: external_exports3.boolean()
 });
@@ -36009,6 +36012,12 @@ var ScoutPreferencesSchema = external_exports3.looseObject({
   preferLanguages: external_exports3.array(external_exports3.string()).default([]),
   preferRepos: external_exports3.array(external_exports3.string()).default([]),
   diversityRatio: external_exports3.number().min(0).max(1).default(0),
+  // Soft penalty (milder than the hard excludeRepos filter): candidates in
+  // these `owner/repo` slugs are pushed down the ranking but not removed (#168).
+  avoidRepos: external_exports3.array(external_exports3.string()).default([]),
+  // Soft boost for candidates whose issue labels match one of these types,
+  // case-insensitive (e.g. "bug", "good first issue") (#168).
+  boostIssueTypes: external_exports3.array(external_exports3.string()).default([]),
   broadPhaseDelayMs: external_exports3.number().min(0).max(3e5).default(9e4),
   /**
    * Skip the expensive broad phase once this many candidates were found by
@@ -36725,7 +36734,7 @@ async function checkNoExistingPR(octokit, owner, repo, issueNumber) {
   }
 }
 var MERGED_PR_CACHE_TTL_MS = 15 * 60 * 1e3;
-async function checkUserMergedPRsInRepo(octokit, owner, repo) {
+async function checkUserMergedPRsInRepo(octokit, owner, repo, tracker = getSearchBudgetTracker()) {
   const cache = getHttpCache();
   const cacheKey = versionedCacheKey(`merged-prs:${owner}/${repo}`);
   return withInflightDedup(cache, cacheKey, async () => {
@@ -36734,7 +36743,6 @@ async function checkUserMergedPRsInRepo(octokit, owner, repo) {
       return cached2;
     }
     try {
-      const tracker = getSearchBudgetTracker();
       await tracker.waitForBudget();
       try {
         const { data } = await octokit.search.issuesAndPullRequests({
@@ -36801,8 +36809,30 @@ function analyzeRequirements(body) {
   return indicators.filter(Boolean).length >= 2;
 }
 
+// ../core/dist/core/probe-repo-file.js
+var MODULE6 = "probe-repo-file";
+async function probeRepoFile(octokit, owner, repo, path5) {
+  try {
+    const { data } = await octokit.repos.getContent({ owner, repo, path: path5 });
+    if (data && typeof data === "object" && "content" in data && typeof data.content === "string") {
+      return {
+        text: Buffer.from(data.content, "base64").toString("utf-8"),
+        transient: false
+      };
+    }
+    return { text: null, transient: false };
+  } catch (error48) {
+    const status = getHttpStatusCode(error48);
+    if (status === 404)
+      return { text: null, transient: false };
+    rethrowIfFatal(error48);
+    warn(MODULE6, `Unexpected error fetching ${path5} from ${owner}/${repo}: ${errorMessage(error48)}`);
+    return { text: null, transient: true };
+  }
+}
+
 // ../core/dist/core/repo-health.js
-var MODULE6 = "repo-health";
+var MODULE7 = "repo-health";
 var guidelinesCache = /* @__PURE__ */ new Map();
 var CACHE_TTL_MS = 60 * 60 * 1e3;
 var HEALTH_CACHE_TTL_MS = 4 * 60 * 60 * 1e3;
@@ -36855,7 +36885,7 @@ async function checkProjectHealth(octokit, owner, repo) {
   } catch (error48) {
     rethrowIfFatal(error48);
     const errMsg = errorMessage(error48);
-    warn(MODULE6, `Error checking project health for ${owner}/${repo}: ${errMsg}`);
+    warn(MODULE7, `Error checking project health for ${owner}/${repo}: ${errMsg}`);
     return {
       repo: `${owner}/${repo}`,
       checkFailed: true,
@@ -36889,12 +36919,7 @@ async function fetchContributionGuidelinesUncached(octokit, owner, repo) {
     "docs/CONTRIBUTING.md",
     "contributing.md"
   ];
-  const results = await Promise.allSettled(filesToCheck.map((file2) => octokit.repos.getContent({ owner, repo, path: file2 }).then(({ data }) => {
-    if ("content" in data) {
-      return Buffer.from(data.content, "base64").toString("utf-8");
-    }
-    return null;
-  })));
+  const results = await Promise.allSettled(filesToCheck.map((file2) => probeRepoFile(octokit, owner, repo, file2)));
   for (const result of results) {
     if (result.status !== "rejected")
       continue;
@@ -36902,20 +36927,13 @@ async function fetchContributionGuidelinesUncached(octokit, owner, repo) {
       throw result.reason;
     }
   }
-  for (let i = 0; i < results.length; i++) {
-    const result = results[i];
-    if (result.status === "fulfilled" && result.value) {
-      const guidelines = parseContributionGuidelines(result.value);
+  for (const result of results) {
+    if (result.status === "fulfilled" && result.value.text) {
+      const guidelines = parseContributionGuidelines(result.value.text);
       guidelinesCache.set(cacheKey, { guidelines, fetchedAt: Date.now() });
       pruneCache();
       return guidelines;
     }
-    if (result.status === "rejected") {
-      const status = getHttpStatusCode(result.reason);
-      if (status !== 404) {
-        warn(MODULE6, `Unexpected error fetching ${filesToCheck[i]} from ${owner}/${repo}: ${errorMessage(result.reason)}`);
-      }
-    }
   }
   guidelinesCache.set(cacheKey, {
     guidelines: void 0,
@@ -36964,7 +36982,6 @@ function parseContributionGuidelines(content) {
 }
 
 // ../core/dist/core/anti-llm-policy.js
-var MODULE7 = "anti-llm-policy";
 var POLICY_SCAN_CACHE_TTL_MS = 60 * 60 * 1e3;
 var ANTI_LLM_KEYWORDS = [
   "no ai-generated",
@@ -37027,27 +37044,8 @@ var SOURCE_FILE_FAMILIES = [
     paths: ["README.md", "readme.md", "Readme.md"]
   }
 ];
-async function fetchFileText(octokit, owner, repo, path5) {
-  try {
-    const { data } = await octokit.repos.getContent({ owner, repo, path: path5 });
-    if ("content" in data && typeof data.content === "string") {
-      return {
-        text: Buffer.from(data.content, "base64").toString("utf-8"),
-        transient: false
-      };
-    }
-    return { text: null, transient: false };
-  } catch (error48) {
-    const status = getHttpStatusCode(error48);
-    if (status === 404)
-      return { text: null, transient: false };
-    rethrowIfFatal(error48);
-    warn(MODULE7, `Unexpected error fetching ${path5} from ${owner}/${repo}: ${errorMessage(error48)}`);
-    return { text: null, transient: true };
-  }
-}
 async function fetchFamilyText(octokit, owner, repo, paths) {
-  const results = await Promise.allSettled(paths.map((p) => fetchFileText(octokit, owner, repo, p)));
+  const results = await Promise.allSettled(paths.map((p) => probeRepoFile(octokit, owner, repo, p)));
   let hadTransientFailure = false;
   for (const result of results) {
     if (result.status === "fulfilled") {
@@ -37377,9 +37375,18 @@ function deriveRecommendation(input) {
 var IssueVetter = class {
   octokit;
   stateReader;
-  constructor(octokit, stateReader) {
+  budgetTracker;
+  /**
+   * @param octokit      - Authenticated Octokit instance
+   * @param stateReader  - Read-only scout state interface
+   * @param budgetTracker - Search budget tracker. Defaults to the shared
+   *   singleton so existing callers behave identically; inject a per-search
+   *   instance to isolate budget accounting in a long-lived concurrent host.
+   */
+  constructor(octokit, stateReader, budgetTracker = getSearchBudgetTracker()) {
     this.octokit = octokit;
     this.stateReader = stateReader;
+    this.budgetTracker = budgetTracker;
   }
   /**
    * Vet a specific issue — runs all checks and computes recommendation + viability score.
@@ -37413,7 +37420,7 @@ var IssueVetter = class {
       checkNotClaimed(this.octokit, owner, repo, number4, core.commentCount),
       checkProjectHealth(this.octokit, owner, repo),
       fetchContributionGuidelines(this.octokit, owner, repo),
-      hasMergedPRsInRepo ? Promise.resolve(0) : checkUserMergedPRsInRepo(this.octokit, owner, repo)
+      hasMergedPRsInRepo ? Promise.resolve(0) : checkUserMergedPRsInRepo(this.octokit, owner, repo, this.budgetTracker)
     ]);
     const antiLLMPolicy = await fetchAndScanAntiLLMPolicy(this.octokit, owner, repo, { contributingText: contributionGuidelines?.rawContent });
     const noExistingPR = existingPRCheck.passed;
@@ -37676,7 +37683,7 @@ function interleaveArrays(arrays) {
   return result;
 }
 var SEARCH_CACHE_TTL_MS = 15 * 60 * 1e3;
-async function cachedSearchIssues(octokit, params) {
+async function cachedSearchIssues(octokit, params, tracker = getSearchBudgetTracker()) {
   const cacheKey = versionedCacheKey(`search:${params.q}:${params.sort}:${params.order}:${params.per_page}`);
   const cache = getHttpCache();
   const cached2 = cache.getIfFresh(cacheKey, SEARCH_CACHE_TTL_MS);
@@ -37684,7 +37691,6 @@ async function cachedSearchIssues(octokit, params) {
     debug(MODULE10, `Search cache hit for query`);
     return cached2;
   }
-  const tracker = getSearchBudgetTracker();
   await tracker.waitForBudget();
   let data;
   try {
@@ -37819,7 +37825,7 @@ async function fetchIssuesFromKnownRepos(octokit, vetter, repos, labels, maxResu
   }
   return { candidates, allReposFailed, rateLimitHit };
 }
-async function searchWithChunkedLabels(octokit, labels, reservedOps, buildQuery, perPage) {
+async function searchWithChunkedLabels(octokit, labels, reservedOps, buildQuery, perPage, tracker = getSearchBudgetTracker()) {
   const labelChunks = chunkLabels(labels, reservedOps);
   const seenUrls = /* @__PURE__ */ new Set();
   const allItems = [];
@@ -37832,7 +37838,7 @@ async function searchWithChunkedLabels(octokit, labels, reservedOps, buildQuery,
       sort: "created",
       order: "desc",
       per_page: perPage
-    });
+    }, tracker);
     for (const item of data.items) {
       if (!seenUrls.has(item.html_url)) {
         seenUrls.add(item.html_url);
@@ -37851,14 +37857,14 @@ 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) {
+async function searchAcrossLanguagesAndLabels(octokit, languages, isAnyLanguage, labels, buildBaseQuery, perPage, tracker = getSearchBudgetTracker()) {
   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);
+    const items = await searchWithChunkedLabels(octokit, labels, 0, (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);
@@ -37903,18 +37909,27 @@ async function filterVetAndScore(vetter, items, filterIssues, excludedRepoSets,
 // ../core/dist/core/personalization.js
 var REPO_BOOST = 20;
 var LANGUAGE_BOOST = 10;
+var ISSUE_TYPE_BOOST = 10;
+var AVOID_PENALTY = 15;
 function boostScoreOf(candidate) {
   return candidate.personalization?.kind === "boosted" ? candidate.personalization.score : 0;
 }
-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().toLowerCase()).filter(Boolean));
-  if (langSet.size === 0 && repoSet.size === 0)
+function normalizeSet(values) {
+  return new Set((values ?? []).map((v) => v.trim().toLowerCase()).filter(Boolean));
+}
+function annotateBoost(candidates, bias = {}) {
+  const langSet = normalizeSet(bias.preferLanguages);
+  const repoSet = normalizeSet(bias.preferRepos);
+  const avoidSet = normalizeSet(bias.avoidRepos);
+  const typeSet = normalizeSet(bias.boostIssueTypes);
+  if (langSet.size === 0 && repoSet.size === 0 && avoidSet.size === 0 && typeSet.size === 0) {
     return candidates;
+  }
   return candidates.map((c) => {
     let score = 0;
     const reasons = [];
-    if (repoSet.size > 0 && repoSet.has(c.issue.repo.toLowerCase())) {
+    const repoLower = c.issue.repo.toLowerCase();
+    if (repoSet.size > 0 && repoSet.has(repoLower)) {
       score += REPO_BOOST;
       reasons.push(`repo affinity: ${c.issue.repo}`);
     }
@@ -37923,7 +37938,18 @@ function annotateBoost(candidates, preferLanguages, preferRepos) {
       score += LANGUAGE_BOOST;
       reasons.push(`language match: ${lang}`);
     }
-    if (score === 0)
+    if (typeSet.size > 0) {
+      const matched = c.issue.labels.find((l) => typeSet.has(l.toLowerCase()));
+      if (matched) {
+        score += ISSUE_TYPE_BOOST;
+        reasons.push(`issue type: ${matched}`);
+      }
+    }
+    if (avoidSet.size > 0 && avoidSet.has(repoLower)) {
+      score -= AVOID_PENALTY;
+      reasons.push(`avoided repo: ${c.issue.repo}`);
+    }
+    if (reasons.length === 0)
       return c;
     return { ...c, personalization: { kind: "boosted", score, reasons } };
   });
@@ -37951,7 +37977,7 @@ function applyDiversityRatio(candidates, maxResults, diversityRatio) {
       break;
     if (seen.has(c.issue.url))
       continue;
-    if (boostScoreOf(c) > 0)
+    if (boostScoreOf(c) !== 0)
       continue;
     picks.push({ ...c, personalization: { kind: "diversity" } });
     seen.add(c.issue.url);
@@ -38023,7 +38049,7 @@ async function runPhase1(octokit, vetter, repos, labels, maxResults, filterIssue
     rateLimitHit
   };
 }
-async function runPhase2(octokit, vetter, scopes, labels, configLabels, languages, isAnyLanguage, maxResults, minStars, phase0RepoSet, starredRepoSet, existingCandidates, filterIssues) {
+async function runPhase2(octokit, vetter, scopes, labels, configLabels, languages, isAnyLanguage, maxResults, minStars, phase0RepoSet, starredRepoSet, existingCandidates, filterIssues, tracker) {
   info(MODULE11, "Phase 2: General issue search...");
   const seenRepos = new Set(existingCandidates.map((c) => c.issue.repo));
   const tierLabelGroups = [];
@@ -38050,7 +38076,7 @@ async function runPhase2(octokit, vetter, scopes, labels, configLabels, language
   let rateLimitHit = false;
   for (const { tier, tierLabels } of tierLabelGroups) {
     try {
-      const allItems = await searchAcrossLanguagesAndLabels(octokit, languages, isAnyLanguage, tierLabels, (langQ) => `is:issue is:open ${langQ} no:assignee`.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, tracker);
       info(MODULE11, `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);
@@ -38085,7 +38111,7 @@ async function runPhase2(octokit, vetter, scopes, labels, configLabels, language
     rateLimitHit
   };
 }
-async function runPhase3(octokit, vetter, langQuery, minStars, projectCategories, maxResults, phase0RepoSet, starredRepoSet, starredRepos, existingCandidates, filterIssues) {
+async function runPhase3(octokit, vetter, langQuery, minStars, projectCategories, maxResults, phase0RepoSet, starredRepoSet, starredRepos, existingCandidates, filterIssues, tracker) {
   info(MODULE11, "Phase 3: Searching actively maintained repos...");
   const seenRepos = new Set(existingCandidates.map((c) => c.issue.repo));
   const eligibleStarred = starredRepos.filter((r) => !phase0RepoSet.has(r) && !seenRepos.has(r));
@@ -38123,7 +38149,7 @@ async function runPhase3(octokit, vetter, langQuery, minStars, projectCategories
       sort: "updated",
       order: "desc",
       per_page: maxResults * 3
-    });
+    }, tracker);
     info(MODULE11, `Found ${data.total_count} issues in maintained-repo search, processing top ${data.items.length}...`);
     const { candidates, allVetFailed, rateLimitHit: vetRateLimitHit } = await filterVetAndScore(vetter, data.items, filterIssues, [phase0RepoSet, starredRepoSet, seenRepos], maxResults, minStars, "Phase 3");
     info(MODULE11, `Found ${candidates.length} candidates from maintained-repo search`);
@@ -38150,19 +38176,26 @@ var IssueDiscovery = class {
   octokit;
   githubToken;
   vetter;
+  budgetTracker;
   /** Set after searchIssues() runs if rate limits affected the search (low pre-flight quota or mid-search rate limit hits). */
   rateLimitWarning = null;
   /**
    * @param githubToken  - GitHub personal access token or token from `gh auth token`
    * @param preferences  - User's search preferences (languages, labels, scopes, etc.)
    * @param stateReader  - Read-only interface for accessing scout state (merged PRs, starred repos, etc.)
+   * @param budgetTracker - Search budget tracker. Defaults to the shared
+   *   singleton so existing callers behave identically. A long-lived host
+   *   serving concurrent searches can inject a per-search instance so one
+   *   search's init() no longer resets the budget state of another (the
+   *   shared-singleton concurrency hazard, #156).
    */
-  constructor(githubToken, preferences, stateReader) {
+  constructor(githubToken, preferences, stateReader, budgetTracker = getSearchBudgetTracker()) {
     this.preferences = preferences;
     this.stateReader = stateReader;
     this.githubToken = githubToken;
     this.octokit = getOctokit(githubToken);
-    this.vetter = new IssueVetter(this.octokit, this.stateReader);
+    this.budgetTracker = budgetTracker;
+    this.vetter = new IssueVetter(this.octokit, this.stateReader, this.budgetTracker);
   }
   /**
    * Get starred repos from the state reader.
@@ -38211,8 +38244,20 @@ var IssueDiscovery = class {
     const allCandidates = [];
     const phaseErrors = {};
     let rateLimitHitDuringSearch = false;
+    const applyInterPhaseDelay = async () => {
+      if (interPhaseDelay > 0) {
+        info(MODULE11, `Waiting ${(interPhaseDelay / 1e3).toFixed(0)}s between phases for rate limit management...`);
+        await sleep(interPhaseDelay);
+      }
+    };
+    const recordPhaseResult = (key, result) => {
+      allCandidates.push(...result.candidates);
+      phaseErrors[key] = result.error;
+      if (result.rateLimitHit)
+        rateLimitHitDuringSearch = true;
+    };
     this.rateLimitWarning = null;
-    const tracker = getSearchBudgetTracker();
+    const tracker = this.budgetTracker;
     let searchBudget = LOW_BUDGET_THRESHOLD - 1;
     try {
       const rateLimit = await checkRateLimit(this.githubToken);
@@ -38274,27 +38319,18 @@ var IssueDiscovery = class {
       const remaining = maxResults - allCandidates.length;
       if (remaining > 0) {
         const result = await runPhase0(this.octokit, this.vetter, phase0Repos, remaining, filterIssues);
-        allCandidates.push(...result.candidates);
-        phaseErrors["0"] = result.error;
-        if (result.rateLimitHit)
-          rateLimitHitDuringSearch = true;
+        recordPhaseResult("0", result);
       }
       strategiesUsed.push("merged");
     }
     if (allCandidates.length < maxResults && starredRepos.length > 0 && searchBudget >= CRITICAL_BUDGET_THRESHOLD && enabledStrategies.has("starred")) {
-      if (interPhaseDelay > 0) {
-        info(MODULE11, `Waiting ${(interPhaseDelay / 1e3).toFixed(0)}s between phases for rate limit management...`);
-        await sleep(interPhaseDelay);
-      }
+      await applyInterPhaseDelay();
       const reposToSearch = starredRepos.filter((r) => !phase0RepoSet.has(r));
       if (reposToSearch.length > 0) {
         const remaining = maxResults - allCandidates.length;
         if (remaining > 0) {
           const result = await runPhase1(this.octokit, this.vetter, reposToSearch, labels, remaining, filterIssues);
-          allCandidates.push(...result.candidates);
-          phaseErrors["1"] = result.error;
-          if (result.rateLimitHit)
-            rateLimitHitDuringSearch = true;
+          recordPhaseResult("1", result);
           strategiesUsed.push("starred");
         }
       }
@@ -38306,10 +38342,7 @@ var IssueDiscovery = class {
       if (skipThreshold > 0 && allCandidates.length >= skipThreshold) {
         info(MODULE11, `Skipping broad search: already found ${allCandidates.length} candidates (threshold: ${skipThreshold})`);
       } else {
-        if (interPhaseDelay > 0) {
-          info(MODULE11, `Waiting ${(interPhaseDelay / 1e3).toFixed(0)}s between phases for rate limit management...`);
-          await sleep(interPhaseDelay);
-        }
+        await applyInterPhaseDelay();
         if (allCandidates.length > 0 && broadDelay > 0) {
           info(MODULE11, `Waiting ${(broadDelay / 1e3).toFixed(0)}s for rate limit cooldown before broad search...`);
           await sleep(broadDelay);
@@ -38317,25 +38350,16 @@ var IssueDiscovery = class {
           info(MODULE11, `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, languages, isAnyLanguage, remaining, minStars, phase0RepoSet, starredRepoSet, allCandidates, filterIssues);
-        allCandidates.push(...result.candidates);
-        phaseErrors["2"] = result.error;
-        if (result.rateLimitHit)
-          rateLimitHitDuringSearch = true;
+        const result = await runPhase2(this.octokit, this.vetter, scopes, labels, config2.labels, languages, isAnyLanguage, remaining, minStars, phase0RepoSet, starredRepoSet, allCandidates, filterIssues, tracker);
+        recordPhaseResult("2", result);
         strategiesUsed.push("broad");
       }
     }
     if (allCandidates.length < maxResults && searchBudget >= LOW_BUDGET_THRESHOLD && enabledStrategies.has("maintained")) {
-      if (interPhaseDelay > 0) {
-        info(MODULE11, `Waiting ${(interPhaseDelay / 1e3).toFixed(0)}s between phases for rate limit management...`);
-        await sleep(interPhaseDelay);
-      }
+      await applyInterPhaseDelay();
       const remaining = maxResults - allCandidates.length;
-      const result = await runPhase3(this.octokit, this.vetter, langQuery, minStars, config2.projectCategories ?? [], remaining, phase0RepoSet, starredRepoSet, starredRepos, allCandidates, filterIssues);
-      allCandidates.push(...result.candidates);
-      phaseErrors["3"] = result.error;
-      if (result.rateLimitHit)
-        rateLimitHitDuringSearch = true;
+      const result = await runPhase3(this.octokit, this.vetter, langQuery, minStars, config2.projectCategories ?? [], remaining, phase0RepoSet, starredRepoSet, starredRepos, allCandidates, filterIssues, tracker);
+      recordPhaseResult("3", result);
       strategiesUsed.push("maintained");
     }
     const phasesSkippedForBudget = searchBudget < LOW_BUDGET_THRESHOLD;
@@ -38362,7 +38386,12 @@ 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.`;
     }
-    const ranked = annotateBoost(allCandidates, options.preferLanguages, options.preferRepos);
+    const ranked = annotateBoost(allCandidates, {
+      preferLanguages: options.preferLanguages,
+      preferRepos: options.preferRepos,
+      avoidRepos: options.avoidRepos,
+      boostIssueTypes: options.boostIssueTypes
+    });
     ranked.sort((a, b) => {
       const priorityOrder = {
         merged_pr: 0,
@@ -38416,7 +38445,6 @@ var IssueDiscovery = class {
 };
 
 // ../core/dist/core/roadmap.js
-var MODULE12 = "roadmap";
 var CACHE_TTL_MS2 = 60 * 60 * 1e3;
 var ROADMAP_PATHS = [
   "ROADMAP.md",
@@ -38484,22 +38512,13 @@ async function fetchRoadmapIssueRefs(octokit, owner, repo) {
 var roadmapInflight = /* @__PURE__ */ new Map();
 async function fetchRoadmapIssueRefsUncached(octokit, owner, repo, cacheKey) {
   for (const path5 of ROADMAP_PATHS) {
-    try {
-      const { data } = await octokit.repos.getContent({ owner, repo, path: path5 });
-      if (!("content" in data))
-        continue;
-      const content = Buffer.from(data.content, "base64").toString("utf-8");
-      const refs = parseRoadmapIssueRefs(content, owner, repo);
-      roadmapCache.set(cacheKey, { refs, fetchedAt: Date.now() });
-      pruneCache2();
-      return refs;
-    } catch (err) {
-      rethrowIfFatal(err);
-      const status = getHttpStatusCode(err);
-      if (status === 404)
-        continue;
-      warn(MODULE12, `Unexpected error fetching ${path5} from ${owner}/${repo}: ${errorMessage(err)}`);
-    }
+    const { text } = await probeRepoFile(octokit, owner, repo, path5);
+    if (!text)
+      continue;
+    const refs = parseRoadmapIssueRefs(text, owner, repo);
+    roadmapCache.set(cacheKey, { refs, fetchedAt: Date.now() });
+    pruneCache2();
+    return refs;
   }
   const empty = /* @__PURE__ */ new Set();
   roadmapCache.set(cacheKey, { refs: empty, fetchedAt: Date.now() });
@@ -38508,7 +38527,7 @@ async function fetchRoadmapIssueRefsUncached(octokit, owner, repo, cacheKey) {
 }
 
 // ../core/dist/core/feature-discovery.js
-var MODULE13 = "feature-discovery";
+var MODULE12 = "feature-discovery";
 var INTER_REPO_DELAY_MS = 2e3;
 var MIN_VIABILITY_SCORE = 40;
 var ANCHOR_THRESHOLD = 3;
@@ -38621,7 +38640,7 @@ async function vetAndClassify(item, vetter, roadmapRefs) {
     });
   } catch (err) {
     rethrowIfFatal(err);
-    warn(MODULE13, `vet failed for ${item.html_url}: ${errorMessage(err)}`);
+    warn(MODULE12, `vet failed for ${item.html_url}: ${errorMessage(err)}`);
     return null;
   }
   const horizon = classifyHorizon({
@@ -38664,7 +38683,7 @@ async function discoverFeatures(opts) {
       roadmapRefs = refs;
     } catch (err) {
       rethrowIfFatal(err);
-      warn(MODULE13, `failed to list issues for ${anchorRepos[i]}: ${errorMessage(err)}`);
+      warn(MODULE12, `failed to list issues for ${anchorRepos[i]}: ${errorMessage(err)}`);
       continue;
     }
     const items = response.data.filter((it) => !it.pull_request && !it.assignee && isFeatureIssue(it));
@@ -38742,7 +38761,7 @@ async function discoverFeaturesBroad(opts) {
     items = merged.filter((it) => !it.pull_request && !it.assignee && isFeatureIssue(it)).slice(0, maxToVet);
   } catch (err) {
     rethrowIfFatal(err);
-    warn(MODULE13, `broad feature search failed: ${errorMessage(err)}`);
+    warn(MODULE12, `broad feature search failed: ${errorMessage(err)}`);
     return {
       quickWins: [],
       biggerBets: [],
@@ -38769,7 +38788,7 @@ async function discoverFeaturesBroad(opts) {
 // ../core/dist/core/gist-state-store.js
 var fs3 = __toESM(require("fs"), 1);
 var path3 = __toESM(require("path"), 1);
-var MODULE14 = "gist-state";
+var MODULE13 = "gist-state";
 var GIST_DESCRIPTION = "oss-scout-state";
 var GIST_FILENAME = "state.json";
 var GIST_ID_FILE = "gist-id";
@@ -38814,7 +38833,7 @@ var GistStateStore = class {
     } catch (err) {
       if (getHttpStatusCode(err) === 401)
         throw err;
-      warn(MODULE14, `API bootstrap failed: ${errorMessage(err)}`);
+      warn(MODULE13, `API bootstrap failed: ${errorMessage(err)}`);
       return this.bootstrapFromCache(classifyDegradedReason(err));
     }
   }
@@ -38823,7 +38842,7 @@ var GistStateStore = class {
    */
   async push(state) {
     if (!this.gistId) {
-      warn(MODULE14, "No gist ID \u2014 cannot push");
+      warn(MODULE13, "No gist ID \u2014 cannot push");
       this.writeCache(state);
       return false;
     }
@@ -38835,12 +38854,12 @@ var GistStateStore = class {
       }
     } catch (err) {
       rethrowIfFatal(err);
-      warn(MODULE14, `Could not fetch gist before push, writing local snapshot: ${errorMessage(err)}`);
+      warn(MODULE13, `Could not fetch gist before push, writing local snapshot: ${errorMessage(err)}`);
     }
     this.writeCache(toWrite);
     const json2 = JSON.stringify(toWrite, null, 2);
     if (json2.length > 9e5) {
-      warn(MODULE14, `State too large for gist (${Math.round(json2.length / 1024)}KB). Consider clearing old results with 'oss-scout results clear'.`);
+      warn(MODULE13, `State too large for gist (${Math.round(json2.length / 1024)}KB). Consider clearing old results with 'oss-scout results clear'.`);
       return false;
     }
     try {
@@ -38850,11 +38869,11 @@ var GistStateStore = class {
           [GIST_FILENAME]: { content: json2 }
         }
       });
-      debug(MODULE14, "State pushed to gist");
+      debug(MODULE13, "State pushed to gist");
       return true;
     } catch (err) {
       rethrowIfFatal(err);
-      warn(MODULE14, `Failed to push: ${errorMessage(err)}`);
+      warn(MODULE13, `Failed to push: ${errorMessage(err)}`);
       return false;
     }
   }
@@ -38866,7 +38885,7 @@ var GistStateStore = class {
   async bootstrapFromApi() {
     const cachedId = this.readCachedGistId();
     if (cachedId) {
-      debug(MODULE14, `Trying cached gist ID: ${cachedId}`);
+      debug(MODULE13, `Trying cached gist ID: ${cachedId}`);
       try {
         const fetched = await this.fetchGistState(cachedId);
         if (fetched) {
@@ -38878,13 +38897,13 @@ var GistStateStore = class {
       } catch (err) {
         if (getHttpStatusCode(err) !== 404)
           throw err;
-        debug(MODULE14, `Cached gist gone (404): ${errorMessage(err)}`);
+        debug(MODULE13, `Cached gist gone (404): ${errorMessage(err)}`);
       }
-      debug(MODULE14, "Cached gist ID invalid, searching...");
+      debug(MODULE13, "Cached gist ID invalid, searching...");
     }
     const search = await this.searchForGist();
     if (search.id) {
-      debug(MODULE14, `Found gist via search: ${search.id}`);
+      debug(MODULE13, `Found gist via search: ${search.id}`);
       this.saveGistId(search.id);
       this.gistId = search.id;
       const fetched = await this.fetchGistState(search.id);
@@ -38893,13 +38912,13 @@ var GistStateStore = class {
         this.writeCache(state);
         return { gistId: search.id, state, created: false };
       }
-      warn(MODULE14, `Found existing gist ${search.id} but content failed validation. Using local cache to avoid data loss.`);
+      warn(MODULE13, `Found existing gist ${search.id} but content failed validation. Using local cache to avoid data loss.`);
       return this.bootstrapFromCache("unknown");
     }
     if (!search.exhaustive) {
-      warn(MODULE14, `Scanned the first ${SEARCH_MAX_PAGES * 100} gists without finding an oss-scout state gist, but the account has more. Creating a new state gist; if one already exists, copy its id into the gist-id file in the oss-scout data directory to avoid a duplicate.`);
+      warn(MODULE13, `Scanned the first ${SEARCH_MAX_PAGES * 100} gists without finding an oss-scout state gist, but the account has more. Creating a new state gist; if one already exists, copy its id into the gist-id file in the oss-scout data directory to avoid a duplicate.`);
     }
-    debug(MODULE14, "No existing gist found, creating new one");
+    debug(MODULE13, "No existing gist found, creating new one");
     const freshState = ScoutStateSchema.parse({ version: 1 });
     const newId = await this.createGist(freshState);
     this.saveGistId(newId);
@@ -38910,7 +38929,7 @@ var GistStateStore = class {
   bootstrapFromCache(reason) {
     const cached2 = this.readCache();
     if (cached2) {
-      debug(MODULE14, "Bootstrapped from local cache (degraded mode)");
+      debug(MODULE13, "Bootstrapped from local cache (degraded mode)");
       const cachedId = this.readCachedGistId();
       if (cachedId)
         this.gistId = cachedId;
@@ -38922,7 +38941,7 @@ var GistStateStore = class {
         degradedReason: reason
       };
     }
-    debug(MODULE14, "No cache available, using fresh state (degraded mode)");
+    debug(MODULE13, "No cache available, using fresh state (degraded mode)");
     const fresh = ScoutStateSchema.parse({ version: 1 });
     return {
       gistId: "",
@@ -38942,7 +38961,7 @@ var GistStateStore = class {
       const parsed = JSON.parse(file2.content);
       return parseScoutState(parsed);
     } catch (err) {
-      warn(MODULE14, `Gist content failed validation: ${errorMessage(err)}`);
+      warn(MODULE13, `Gist content failed validation: ${errorMessage(err)}`);
       return null;
     }
   }
@@ -38985,7 +39004,7 @@ var GistStateStore = class {
     } catch (err) {
       const code = err?.code;
       if (code !== "ENOENT") {
-        warn(MODULE14, `Failed to read cached gist ID: ${errorMessage(err)}`);
+        warn(MODULE13, `Failed to read cached gist ID: ${errorMessage(err)}`);
       }
       return null;
     }
@@ -39011,7 +39030,7 @@ var GistStateStore = class {
     } catch (err) {
       const code = err?.code;
       if (code !== "ENOENT") {
-        warn(MODULE14, `Failed to read state cache: ${errorMessage(err)}`);
+        warn(MODULE13, `Failed to read state cache: ${errorMessage(err)}`);
       }
       return null;
     }
@@ -39022,7 +39041,7 @@ var GistStateStore = class {
         mode: 384
       });
     } catch (err) {
-      warn(MODULE14, `Failed to write cache: ${errorMessage(err)}`);
+      warn(MODULE13, `Failed to write cache: ${errorMessage(err)}`);
     }
   }
 };
@@ -39150,7 +39169,7 @@ function pickFresherTimestamp(a, b) {
 // ../core/dist/core/local-state.js
 var fs4 = __toESM(require("fs"), 1);
 var path4 = __toESM(require("path"), 1);
-var MODULE15 = "local-state";
+var MODULE14 = "local-state";
 function getStatePath() {
   return path4.join(getDataDir(), "state.json");
 }
@@ -39164,13 +39183,13 @@ function loadLocalState() {
     if (code === "ENOENT") {
       return ScoutStateSchema.parse({ version: 1 });
     }
-    warn(MODULE15, `Failed to load state from ${statePath}: ${errorMessage(err)}. Using defaults.`);
+    warn(MODULE14, `Failed to load state from ${statePath}: ${errorMessage(err)}. Using defaults.`);
     try {
       const backupPath = `${statePath}.corrupt.${Date.now()}`;
       fs4.copyFileSync(statePath, backupPath);
-      warn(MODULE15, `Corrupt state backed up to ${backupPath}`);
+      warn(MODULE14, `Corrupt state backed up to ${backupPath}`);
     } catch (backupErr) {
-      warn(MODULE15, `Failed to back up corrupt state: ${errorMessage(backupErr)}`);
+      warn(MODULE14, `Failed to back up corrupt state: ${errorMessage(backupErr)}`);
     }
     return ScoutStateSchema.parse({ version: 1 });
   }
@@ -39190,7 +39209,7 @@ function saveLocalState(state) {
     }
     throw err;
   }
-  debug(MODULE15, "State saved");
+  debug(MODULE14, "State saved");
 }
 
 // ../core/dist/scout.js
@@ -39309,6 +39328,10 @@ var OssScout = class {
     const prefRepos = prefs.preferRepos ?? [];
     const preferLanguages = options?.preferLanguages ?? (prefLangs.length > 0 ? prefLangs : void 0);
     const preferRepos = options?.preferRepos ?? (prefRepos.length > 0 ? prefRepos : void 0);
+    const prefAvoid = prefs.avoidRepos ?? [];
+    const prefBoostTypes = prefs.boostIssueTypes ?? [];
+    const avoidRepos = options?.avoidRepos ?? (prefAvoid.length > 0 ? prefAvoid : void 0);
+    const boostIssueTypes = options?.boostIssueTypes ?? (prefBoostTypes.length > 0 ? prefBoostTypes : void 0);
     const diversityRatio = options?.diversityRatio ?? prefs.diversityRatio ?? 0;
     const { candidates, strategiesUsed } = await discovery.searchIssues({
       maxResults: options?.maxResults,
@@ -39316,6 +39339,8 @@ var OssScout = class {
       skippedUrls,
       preferLanguages,
       preferRepos,
+      avoidRepos,
+      boostIssueTypes,
       diversityRatio,
       interPhaseDelayMs: options?.interPhaseDelayMs,
       broadPhaseDelayMs: options?.broadPhaseDelayMs
@@ -39339,14 +39364,13 @@ var OssScout = class {
    * calculateScore's +1 active-maintainers weight was inert; `isActive`
    * (recent commit activity) is a real, already-computed proxy.
    *
-   * `isResponsive` and `avgResponseDays` are deliberately NOT set here:
-   * `projectHealth.avgIssueResponseDays` is a hardcoded `0` placeholder
-   * (repo-health.ts), so deriving responsiveness from it would award +1 to
-   * every repo — a fake signal worse than the inert one. Real responsiveness
-   * needs an actual response-time measurement (extra API calls), deferred.
-   * `hasHostileComments` likewise stays a host-settable capability (it needs
-   * comment sentiment, out of scope). A failed health check is skipped so its
-   * neutral-default fields don't pollute the score.
+   * `isResponsive` and `avgResponseDays` are deliberately NOT set here, and
+   * `isResponsive` no longer carries a score weight at all (#167): real
+   * responsiveness needs an actual response-time measurement (extra API calls)
+   * that is out of scope, and `hasActiveMaintainers` already covers the
+   * activity proxy. `hasHostileComments` stays a host-settable capability (it
+   * needs comment sentiment, out of scope). A failed health check is skipped so
+   * its neutral-default fields don't pollute the score.
    */
   updateRepoSignalsFromHealth(health) {
     if (health.checkFailed)
@@ -39903,16 +39927,21 @@ var OssScout = class {
     });
   }
   /**
-   * Calculate repo score (1-10) from observed data.
+   * Calculate repo score from observed data.
    * base 5, +1 per merged PR (max +3), -1 per closed-without-merge (max -3),
-   * +1 responsive, +1 active maintainers, -2 hostile comments, clamped 1-10
+   * +1 active maintainers, -2 hostile comments, clamped to [1, 10].
+   *
+   * `isResponsive` is intentionally NOT scored (#167): nothing in oss-scout
+   * ever computes it, so awarding +1 for it was dead weight that the
+   * now-computed `hasActiveMaintainers` signal already covers as the activity
+   * proxy. The field is retained on RepoSignals for backward compatibility but
+   * no longer affects the score. With the current signals the reachable range
+   * is [1, 9]; the upper clamp stays as defensive hygiene.
    */
   calculateScore(repoScore) {
     let score = 5;
     score += Math.min(repoScore.mergedPRCount, 3);
     score -= Math.min(repoScore.closedWithoutMergeCount, 3);
-    if (repoScore.signals.isResponsive)
-      score += 1;
     if (repoScore.signals.hasActiveMaintainers)
       score += 1;
     if (repoScore.signals.hasHostileComments)
@@ -39949,6 +39978,8 @@ var FIELD_CONFIGS = {
   preferLanguages: { type: "array" },
   preferRepos: { type: "array" },
   diversityRatio: { type: "float" },
+  avoidRepos: { type: "array" },
+  boostIssueTypes: { type: "array" },
   slmTriageModel: { type: "string" },
   slmTriageHost: { type: "string" },
   featuresAnchorThreshold: { type: "number" },
@@ -40067,6 +40098,10 @@ function validateUrl(url2) {
 
 // src/tools.ts
 var TOOL_TIMEOUT_MS = 3e5;
+var PERSIST_WARNING = "Checkpoint failed: changes were applied in memory but could not be persisted. They may be lost when the server restarts.";
+function withPersistWarning(payload, persisted) {
+  return persisted ? payload : { ...payload, persistWarning: PERSIST_WARNING };
+}
 function withTimeout(promise2, ms = TOOL_TIMEOUT_MS) {
   let timeoutId;
   const timer = new Promise((_, reject) => {
@@ -40092,6 +40127,12 @@ 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."
       ),
+      avoidRepos: external_exports3.array(external_exports3.string()).optional().describe(
+        "Soft PENALTY (milder than excludeRepos) for candidates in one of these `owner/repo` slugs (#168). Pushes them down the ranking but does not remove them; a strong boost can still outweigh it."
+      ),
+      boostIssueTypes: external_exports3.array(external_exports3.string()).optional().describe(
+        'Soft-boost ranking for candidates whose issue labels match one of these types, case-insensitive (e.g. "bug", "good first issue") (#168). 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."
       )
@@ -40101,6 +40142,8 @@ function registerTools(server, scout) {
       strategies,
       preferLanguages,
       preferRepos,
+      avoidRepos,
+      boostIssueTypes,
       diversityRatio
     }) => {
       try {
@@ -40111,6 +40154,8 @@ function registerTools(server, scout) {
             strategies: parsedStrategies,
             preferLanguages,
             preferRepos,
+            avoidRepos,
+            boostIssueTypes,
             diversityRatio,
             // No fixed inter-phase sleeps in the request/response MCP context;
             // the budget tracker still paces the GitHub calls (#143)
@@ -40119,9 +40164,18 @@ function registerTools(server, scout) {
           })
         );
         scout.saveResults(result.candidates);
-        await scout.checkpoint();
+        const persisted = await scout.checkpoint();
         return {
-          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                withPersistWarning(result, persisted),
+                null,
+                2
+              )
+            }
+          ]
         };
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
@@ -40150,9 +40204,18 @@ function registerTools(server, scout) {
           })
         );
         scout.saveResults([...result.quickWins, ...result.biggerBets]);
-        await scout.checkpoint();
+        const persisted = await scout.checkpoint();
         return {
-          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                withPersistWarning(result, persisted),
+                null,
+                2
+              )
+            }
+          ]
         };
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
@@ -40324,10 +40387,19 @@ function registerTools(server, scout) {
       scout.updatePreferences({
         [key]: validated[key]
       });
-      await scout.checkpoint();
+      const persisted = await scout.checkpoint();
       const updated = scout.getPreferences();
       return {
-        content: [{ type: "text", text: JSON.stringify(updated, null, 2) }]
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              withPersistWarning(updated, persisted),
+              null,
+              2
+            )
+          }
+        ]
       };
     }
   );
@@ -40385,7 +40457,7 @@ function registerResources(server, scout) {
 // src/index.ts
 var SERVER_INFO = {
   name: "oss-scout-mcp",
-  version: "0.9.0"
+  version: "0.10.0"
   // x-release-please-version
 };
 function createServer(scout) {

package/dist/tools.js

@@ -3,6 +3,19 @@ import { SearchStrategySchema, ISSUE_URL_PATTERN, validateGitHubUrl, validateUrl
 // Generous ceiling: even with inter-phase delays zeroed, vetting many issues
 // under the budget tracker's sliding-window pacing can take minutes (#143).
 const TOOL_TIMEOUT_MS = 300000;
+// Surfaced on the JSON envelope when scout.checkpoint() returns false (#212).
+// The skip tool reports this inline because it returns a short status line;
+// the JSON tools (search, scout-features, config-set) carry it as a top-level
+// field so a persist failure isn't silently swallowed.
+const PERSIST_WARNING = "Checkpoint failed: changes were applied in memory but could not be persisted. They may be lost when the server restarts.";
+/**
+ * Serialize a tool result, attaching a top-level `persistWarning` field when
+ * the preceding checkpoint failed (#212). Spreads onto the existing object so
+ * the happy-path payload is byte-for-byte unchanged.
+ */
+function withPersistWarning(payload, persisted) {
+    return persisted ? payload : { ...payload, persistWarning: PERSIST_WARNING };
+}
 function withTimeout(promise, ms = TOOL_TIMEOUT_MS) {
     let timeoutId;
     const timer = new Promise((_, reject) => {
@@ -28,13 +41,21 @@ 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."),
+        avoidRepos: z
+            .array(z.string())
+            .optional()
+            .describe("Soft PENALTY (milder than excludeRepos) for candidates in one of these `owner/repo` slugs (#168). Pushes them down the ranking but does not remove them; a strong boost can still outweigh it."),
+        boostIssueTypes: z
+            .array(z.string())
+            .optional()
+            .describe('Soft-boost ranking for candidates whose issue labels match one of these types, case-insensitive (e.g. "bug", "good first issue") (#168). 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, }) => {
+    }, async ({ maxResults, strategies, preferLanguages, preferRepos, avoidRepos, boostIssueTypes, diversityRatio, }) => {
         try {
             const parsedStrategies = strategies
                 ? strategies
@@ -46,6 +67,8 @@ export function registerTools(server, scout) {
                 strategies: parsedStrategies,
                 preferLanguages,
                 preferRepos,
+                avoidRepos,
+                boostIssueTypes,
                 diversityRatio,
                 // No fixed inter-phase sleeps in the request/response MCP context;
                 // the budget tracker still paces the GitHub calls (#143)
@@ -53,9 +76,14 @@ export function registerTools(server, scout) {
                 broadPhaseDelayMs: 0,
             }));
             scout.saveResults(result.candidates);
-            await scout.checkpoint();
+            const persisted = await scout.checkpoint();
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(withPersistWarning(result, persisted), null, 2),
+                    },
+                ],
             };
         }
         catch (err) {
@@ -92,9 +120,14 @@ export function registerTools(server, scout) {
                 splitRatio,
             }));
             scout.saveResults([...result.quickWins, ...result.biggerBets]);
-            await scout.checkpoint();
+            const persisted = await scout.checkpoint();
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(withPersistWarning(result, persisted), null, 2),
+                    },
+                ],
             };
         }
         catch (err) {
@@ -279,10 +312,15 @@ export function registerTools(server, scout) {
         scout.updatePreferences({
             [key]: validated[key],
         });
-        await scout.checkpoint();
+        const persisted = await scout.checkpoint();
         const updated = scout.getPreferences();
         return {
-            content: [{ type: "text", text: JSON.stringify(updated, null, 2) }],
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(withPersistWarning(updated, persisted), null, 2),
+                },
+            ],
         };
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-scout/mcp",
-  "version": "0.9.0",
+  "version": "0.10.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.0.0"
+    "@oss-scout/core": "^1.1.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",