@oss-scout/core 1.0.0 → 1.1.0

package/dist/cli.js

@@ -6,6 +6,7 @@ import { Command } from "commander";
 import { enableDebug } from "./core/logger.js";
 import { getCLIVersion } from "./core/utils.js";
 import { formatJsonSuccess, formatJsonError } from "./formatters/json.js";
+import { renderSearch, renderFeatures, renderResults, renderVetList, renderVet, RESULTS_EMPTY_MESSAGE, VET_LIST_EMPTY_MESSAGE, } from "./formatters/human.js";
 import { ValidationError, errorMessage, resolveErrorCode, } from "./core/errors.js";
 import { hasLocalState, loadLocalState, saveLocalState, } from "./core/local-state.js";
 import { CONCRETE_STRATEGIES, SearchStrategySchema } from "./core/schemas.js";
@@ -30,14 +31,6 @@ async function runAction(options, body) {
         handleCommandError(err, options);
     }
 }
-/** Emoji for a vetting recommendation, shared by the search and vet renderers. */
-function recommendationIcon(recommendation) {
-    if (recommendation === "approve")
-        return "✅";
-    if (recommendation === "skip")
-        return "❌";
-    return "⚠️";
-}
 const program = new Command();
 program
     .name("oss-scout")
@@ -116,6 +109,8 @@ program
     .option("--strategy <strategies>", `Search strategies (${CONCRETE_STRATEGIES.join(",")},all). Defaults to the defaultStrategy preference, or all.`)
     .option("--prefer-languages <list>", "Comma-separated languages to soft-boost in ranking (#1244). Candidates whose repo language matches sort above equally-recommended non-matches. Does not filter results.")
     .option("--prefer-repos <list>", "Comma-separated `owner/repo` slugs to soft-boost in ranking (#1244). Stronger weight than language match. Does not filter results.")
+    .option("--avoid-repos <list>", "Comma-separated `owner/repo` slugs to soft-penalize in ranking (#168). Milder than excludeRepos: pushes them down but does not filter them out.")
+    .option("--boost-issue-types <list>", "Comma-separated issue label types to soft-boost in ranking (#168), case-insensitive (e.g. `bug,good first issue`). Does not filter results.")
     .option("--diversity-ratio <n>", "Fraction of result slots (0-1) reserved for candidates that matched NEITHER preference list (#1244). Counterweights echo-chamber bias as boosts accumulate. Default 0 (disabled).")
     .action(async (count, options) => runAction(options, async () => {
     if (!hasLocalState() && !options.json) {
@@ -175,6 +170,8 @@ program
         strategies,
         preferLanguages: splitCsv(options.preferLanguages),
         preferRepos: splitCsv(options.preferRepos),
+        avoidRepos: splitCsv(options.avoidRepos),
+        boostIssueTypes: splitCsv(options.boostIssueTypes),
         diversityRatio,
     });
     if (options.json) {
@@ -182,30 +179,10 @@ program
     }
     else {
         // Human-readable output
-        console.log(`\nFound ${results.candidates.length} issue candidates:\n`);
-        for (const c of results.candidates) {
-            const icon = recommendationIcon(c.recommendation);
-            const stalledTag = c.linkedPR?.isStalled
-                ? " (stalled PR, revive opportunity)"
-                : "";
-            // Personalization tag (#1244). A candidate is either boosted
-            // (matched a preference) or a diversity slot (matched none and
-            // filled a reserved slot); never both.
-            let personalizationTag = "";
-            if (c.boostScore && c.boostReasons && c.boostReasons.length > 0) {
-                personalizationTag = ` [boosted: ${c.boostReasons.join("; ")}]`;
-            }
-            else if (c.diversitySlot) {
-                personalizationTag = " [diversity slot]";
-            }
-            console.log(`  ${icon} ${c.issue.repo}#${c.issue.number} [${c.viabilityScore}/100]${personalizationTag}${stalledTag}`);
-            console.log(`     ${c.issue.title}`);
-            console.log(`     ${c.issue.url}`);
-            if (c.repoScore) {
-                console.log(`     Repo: ${c.repoScore.score}/10, ${c.repoScore.mergedPRCount} merged PRs`);
-            }
-            console.log();
-        }
+        console.log(renderSearch(results));
+        // Rate-limit warning stays on stderr (NOT folded into the stdout
+        // render), so --json stdout purity and the stdout/stderr split are
+        // both preserved.
         if (results.rateLimitWarning) {
             console.error(`\n⚠️  ${results.rateLimitWarning}`);
         }
@@ -252,41 +229,11 @@ program
         console.log(formatJsonSuccess(result));
     }
     else {
-        const total = result.quickWins.length + result.biggerBets.length;
-        if (result.message) {
-            console.log(`\n${result.message}\n`);
-        }
-        if (total === 0)
-            return;
-        const headerScope = options.broad
-            ? "across the ecosystem"
-            : "in your anchor repos";
-        console.log(`\n🎯 Feature opportunities ${headerScope} (${result.quickWins.length} quick wins + ${result.biggerBets.length} bigger bets)\n`);
-        if (!options.broad) {
-            console.log(`Anchor repos: ${result.anchorRepos.join(", ")}\n`);
-        }
-        if (result.quickWins.length) {
-            console.log("── Quick wins ─────────────────────────────────────────");
-            for (const c of result.quickWins) {
-                const stalledTag = c.linkedPR?.isStalled
-                    ? " (stalled PR, revive opportunity)"
-                    : "";
-                console.log(`  ${c.issue.repo}#${c.issue.number} [${c.viabilityScore}/100] ${c.issue.title}${stalledTag}`);
-                console.log(`     ${c.issue.url}`);
-            }
-            console.log("");
-        }
-        if (result.biggerBets.length) {
-            console.log("── Bigger bets ────────────────────────────────────────");
-            for (const c of result.biggerBets) {
-                const stalledTag = c.linkedPR?.isStalled
-                    ? " (stalled PR, revive opportunity)"
-                    : "";
-                console.log(`  ${c.issue.repo}#${c.issue.number} [${c.viabilityScore}/100] ${c.issue.title}${stalledTag}`);
-                console.log(`     ${c.issue.url}`);
-            }
-            console.log("");
-        }
+        // renderFeatures returns "" only when there is no message AND
+        // nothing to list; guard so the caller never logs a blank line.
+        const out = renderFeatures(result, { broad: options.broad });
+        if (out)
+            console.log(out);
     }
 }));
 // ── results command ────────────────────────────────────────────────
@@ -313,21 +260,10 @@ resultsCmd
         return;
     }
     if (results.length === 0) {
-        console.log("\nNo saved results. Run `oss-scout search` to find issues.\n");
+        console.log(RESULTS_EMPTY_MESSAGE);
         return;
     }
-    console.log(`\nSaved results (${results.length}):\n`);
-    console.log("  Score  Repo                              Issue   Recommendation  Title");
-    console.log("  ─────  ────────────────────────────────  ──────  ──────────────  ─────");
-    for (const r of results) {
-        const score = String(r.viabilityScore).padStart(3);
-        const repo = r.repo.padEnd(32).slice(0, 32);
-        const issue = `#${r.number}`.padEnd(6);
-        const rec = r.recommendation.padEnd(14);
-        const title = r.title.length > 50 ? r.title.slice(0, 47) + "..." : r.title;
-        console.log(`  ${score}    ${repo}  ${issue}  ${rec}  ${title}`);
-    }
-    console.log();
+    console.log(renderResults(results));
 }));
 resultsCmd
     .command("clear")
@@ -408,35 +344,10 @@ program
     }
     else {
         if (result.results.length === 0) {
-            console.log("\nNo saved results to vet. Run `oss-scout search` first.\n");
+            console.log(VET_LIST_EMPTY_MESSAGE);
             return;
         }
-        console.log(`\nVet-list results (${result.summary.total}):\n`);
-        for (const r of result.results) {
-            const icon = r.status === "still_available"
-                ? "✅"
-                : r.status === "claimed"
-                    ? "🔒"
-                    : r.status === "has_pr"
-                        ? "🔀"
-                        : r.status === "closed"
-                            ? "🚫"
-                            : "❌";
-            const score = r.ok ? ` [${r.viabilityScore}/100]` : "";
-            console.log(`  ${icon} ${r.repo}#${r.number} — ${r.status}${score}`);
-            console.log(`     ${r.title}`);
-        }
-        if (result.transitions.length > 0) {
-            console.log(`\n🔔 Changes since last check (${result.transitions.length}):`);
-            for (const t of result.transitions) {
-                console.log(`  ${t.repo}#${t.number}: ${t.from} → ${t.to}`);
-            }
-        }
-        console.log(`\nSummary: ${result.summary.stillAvailable} available, ${result.summary.claimed} claimed, ${result.summary.hasPR} has PR, ${result.summary.closed} closed, ${result.summary.errors} errors`);
-        if (result.prunedCount != null) {
-            console.log(`Pruned ${result.prunedCount} unavailable issues from saved results.`);
-        }
-        console.log();
+        console.log(renderVetList(result));
     }
 }));
 // ── skip command ───────────────────────────────────────────────────
@@ -538,28 +449,7 @@ program
         console.log(formatJsonSuccess(result));
     }
     else {
-        const icon = recommendationIcon(result.recommendation);
-        console.log(`\n${icon} ${result.issue.repo}#${result.issue.number}: ${result.recommendation.toUpperCase()}`);
-        console.log(`   ${result.issue.title}`);
-        console.log(`   ${result.issue.url}\n`);
-        if (result.reasonsToApprove.length > 0) {
-            console.log("Reasons to approve:");
-            for (const r of result.reasonsToApprove)
-                console.log(`  + ${r}`);
-        }
-        if (result.reasonsToSkip.length > 0) {
-            console.log("Reasons to skip:");
-            for (const r of result.reasonsToSkip)
-                console.log(`  - ${r}`);
-        }
-        if (result.projectHealth.checkFailed) {
-            console.log(`\nProject health: unknown (check failed: ${result.projectHealth.failureReason})`);
-        }
-        else {
-            console.log(`\nProject health: ${result.projectHealth.isActive ? "Active" : "Inactive"}`);
-            console.log(`  Last commit: ${result.projectHealth.daysSinceLastCommit} days ago`);
-            console.log(`  CI status: ${result.projectHealth.ciStatus}`);
-        }
+        console.log(renderVet(result));
     }
 }));
 program.parse();

package/dist/commands/search.d.ts

@@ -64,6 +64,10 @@ interface SearchCommandOptions {
     preferLanguages?: string[];
     /** Soft sort boost for candidates in these `owner/repo` slugs (#1244). */
     preferRepos?: string[];
+    /** Soft sort penalty for candidates in these `owner/repo` slugs (#168). */
+    avoidRepos?: string[];
+    /** Soft sort boost for candidates whose labels match these types (#168). */
+    boostIssueTypes?: string[];
     /** Diversity counterweight: fraction of slots reserved for unboosted candidates (#1244). */
     diversityRatio?: number;
 }

package/dist/commands/search.js

@@ -10,6 +10,8 @@ export async function runSearch(options) {
             strategies: options.strategies,
             preferLanguages: options.preferLanguages,
             preferRepos: options.preferRepos,
+            avoidRepos: options.avoidRepos,
+            boostIssueTypes: options.boostIssueTypes,
             diversityRatio: options.diversityRatio,
         });
         scout.saveResults(result.candidates);

package/dist/core/anti-llm-policy.js

@@ -7,10 +7,9 @@
  * can rely on a structured `AntiLLMPolicyResult` rather than re-implementing
  * the scan in agent prose.
  */
-import { errorMessage, getHttpStatusCode, isRateLimitError, rethrowIfFatal, } from "./errors.js";
-import { warn } from "./logger.js";
+import { getHttpStatusCode, isRateLimitError } from "./errors.js";
 import { getHttpCache, versionedCacheKey } from "./http-cache.js";
-const MODULE = "anti-llm-policy";
+import { probeRepoFile } from "./probe-repo-file.js";
 /** TTL for cached anti-LLM policy scan results (1 hour). Policy docs change rarely. */
 const POLICY_SCAN_CACHE_TTL_MS = 60 * 60 * 1000;
 /**
@@ -85,39 +84,13 @@ const SOURCE_FILE_FAMILIES = [
         paths: ["README.md", "readme.md", "Readme.md"],
     },
 ];
-/**
- * Fetch one path's raw text content. The `transient` flag distinguishes a
- * clean miss (404 — file absent) from a degraded miss (5xx, network) so the
- * caller can decide whether to cache "no policy" or retry. Throws on
- * 401/auth and rate-limit per documented project error strategy.
- */
-async function fetchFileText(octokit, owner, repo, path) {
-    try {
-        const { data } = await octokit.repos.getContent({ owner, repo, path });
-        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 (error) {
-        const status = getHttpStatusCode(error);
-        if (status === 404)
-            return { text: null, transient: false };
-        rethrowIfFatal(error);
-        warn(MODULE, `Unexpected error fetching ${path} from ${owner}/${repo}: ${errorMessage(error)}`);
-        return { text: null, transient: true };
-    }
-}
 /**
  * Fetch the first available file from a family. Probes are issued in parallel,
  * but auth/rate-limit rejections re-throw so the IssueVetter's existing
  * rate-limit handling kicks in instead of silently caching a wrong answer.
  */
 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") {

package/dist/core/issue-discovery.d.ts

@@ -11,6 +11,7 @@
  *
  * All state is injected via constructor parameters (ScoutStateReader + ScoutPreferences).
  */
+import { type SearchBudgetTracker } from "./search-budget.js";
 import { type IssueCandidate } from "./types.js";
 import type { ScoutPreferences, SearchStrategy } from "./schemas.js";
 import { type ScoutStateReader } from "./issue-vetting.js";
@@ -31,14 +32,20 @@ export declare class IssueDiscovery {
     private octokit;
     private githubToken;
     private vetter;
+    private budgetTracker;
     /** Set after searchIssues() runs if rate limits affected the search (low pre-flight quota or mid-search rate limit hits). */
     rateLimitWarning: string | 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: string, preferences: ScoutPreferences, stateReader: ScoutStateReader);
+    constructor(githubToken: string, preferences: ScoutPreferences, stateReader: ScoutStateReader, budgetTracker?: SearchBudgetTracker);
     /**
      * Get starred repos from the state reader.
      * @returns Array of starred repo names in "owner/repo" format
@@ -76,6 +83,8 @@ export declare class IssueDiscovery {
         skippedUrls?: Set<string>;
         preferLanguages?: string[];
         preferRepos?: string[];
+        avoidRepos?: string[];
+        boostIssueTypes?: string[];
         diversityRatio?: number;
         interPhaseDelayMs?: number;
         broadPhaseDelayMs?: number;

package/dist/core/issue-discovery.js

@@ -12,7 +12,7 @@
  * All state is injected via constructor parameters (ScoutStateReader + ScoutPreferences).
  */
 import { getOctokit, checkRateLimit } from "./github.js";
-import { getSearchBudgetTracker } from "./search-budget.js";
+import { getSearchBudgetTracker, } from "./search-budget.js";
 import { daysBetween, extractRepoFromUrl, sleep } from "./utils.js";
 import { SCOPE_LABELS, } from "./types.js";
 import { CONCRETE_STRATEGIES } from "./schemas.js";
@@ -87,7 +87,7 @@ async function runPhase1(octokit, vetter, repos, labels, maxResults, filterIssue
     };
 }
 /** Phase 2: General label-filtered search with multi-tier interleaving. */
-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(MODULE, "Phase 2: General issue search...");
     const seenRepos = new Set(existingCandidates.map((c) => c.issue.repo));
     // Build per-tier label groups. Multi-tier when 2+ scopes; single-tier otherwise.
@@ -116,7 +116,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(MODULE, `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);
@@ -153,7 +153,7 @@ async function runPhase2(octokit, vetter, scopes, labels, configLabels, language
     };
 }
 /** Phase 3: Actively maintained repos (REST-first, Search API fallback). */
-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(MODULE, "Phase 3: Searching actively maintained repos...");
     const seenRepos = new Set(existingCandidates.map((c) => c.issue.repo));
     // Step 1: Try REST API with starred repos first (no Search API quota used)
@@ -196,7 +196,7 @@ async function runPhase3(octokit, vetter, langQuery, minStars, projectCategories
             sort: "updated",
             order: "desc",
             per_page: maxResults * 3,
-        });
+        }, tracker);
         info(MODULE, `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(MODULE, `Found ${candidates.length} candidates from maintained-repo search`);
@@ -236,19 +236,28 @@ export class IssueDiscovery {
     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;
+        // Thread the same tracker into the vetter so the merged-PR Search API
+        // call (checkUserMergedPRsInRepo) pays the same budget as the search phases.
+        this.vetter = new IssueVetter(this.octokit, this.stateReader, this.budgetTracker);
     }
     /**
      * Get starred repos from the state reader.
@@ -300,9 +309,27 @@ export class IssueDiscovery {
         const allCandidates = [];
         const phaseErrors = {};
         let rateLimitHitDuringSearch = false;
+        // The standard inter-phase pause for rate-limit management. Phases 1, 2,
+        // and 3 all apply this identical delay before querying (Phase 0 is first,
+        // so it never waits). The broad phase wraps this with an extra cooldown.
+        const applyInterPhaseDelay = async () => {
+            if (interPhaseDelay > 0) {
+                info(MODULE, `Waiting ${(interPhaseDelay / 1000).toFixed(0)}s between phases for rate limit management...`);
+                await sleep(interPhaseDelay);
+            }
+        };
+        // Fold a phase's result into the running totals. Every phase accumulates
+        // candidates, records its error under a stable key, and flips the
+        // rate-limit flag the same way; only the key and the result differ.
+        const recordPhaseResult = (key, result) => {
+            allCandidates.push(...result.candidates);
+            phaseErrors[key] = result.error;
+            if (result.rateLimitHit)
+                rateLimitHitDuringSearch = true;
+        };
         // Pre-flight rate limit check
         this.rateLimitWarning = null;
-        const tracker = getSearchBudgetTracker();
+        const tracker = this.budgetTracker;
         let searchBudget = LOW_BUDGET_THRESHOLD - 1;
         try {
             const rateLimit = await checkRateLimit(this.githubToken);
@@ -375,10 +402,7 @@ export class IssueDiscovery {
             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");
         }
@@ -387,19 +411,13 @@ export class IssueDiscovery {
             starredRepos.length > 0 &&
             searchBudget >= CRITICAL_BUDGET_THRESHOLD &&
             enabledStrategies.has("starred")) {
-            if (interPhaseDelay > 0) {
-                info(MODULE, `Waiting ${(interPhaseDelay / 1000).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);
                     // Recorded only when the phase actually queried (#130)
                     strategiesUsed.push("starred");
                 }
@@ -424,10 +442,7 @@ export class IssueDiscovery {
             }
             else {
                 // Always apply baseline inter-phase delay
-                if (interPhaseDelay > 0) {
-                    info(MODULE, `Waiting ${(interPhaseDelay / 1000).toFixed(0)}s between phases for rate limit management...`);
-                    await sleep(interPhaseDelay);
-                }
+                await applyInterPhaseDelay();
                 // Apply additional broad-phase cooldown, but skip if previous phases found nothing
                 if (allCandidates.length > 0 && broadDelay > 0) {
                     info(MODULE, `Waiting ${(broadDelay / 1000).toFixed(0)}s for rate limit cooldown before broad search...`);
@@ -437,11 +452,8 @@ export class IssueDiscovery {
                     info(MODULE, `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, config.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, config.labels, languages, isAnyLanguage, remaining, minStars, phase0RepoSet, starredRepoSet, allCandidates, filterIssues, tracker);
+                recordPhaseResult("2", result);
                 // Recorded only when the phase actually queried, not when the
                 // skip-threshold branch short-circuited it (#130)
                 strategiesUsed.push("broad");
@@ -451,16 +463,10 @@ export class IssueDiscovery {
         if (allCandidates.length < maxResults &&
             searchBudget >= LOW_BUDGET_THRESHOLD &&
             enabledStrategies.has("maintained")) {
-            if (interPhaseDelay > 0) {
-                info(MODULE, `Waiting ${(interPhaseDelay / 1000).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, config.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, config.projectCategories ?? [], remaining, phase0RepoSet, starredRepoSet, starredRepos, allCandidates, filterIssues, tracker);
+            recordPhaseResult("3", result);
             strategiesUsed.push("maintained");
         }
         // Build result / error summary
@@ -501,11 +507,17 @@ export class IssueDiscovery {
                     `Found ${allCandidates.length} candidate${allCandidates.length === 1 ? "" : "s"} but some search phases were limited. ` +
                     `Try again after the rate limit resets for complete results.`;
         }
-        // Personalization annotation (#1244): tag matched candidates with a
-        // `personalization` marker before sorting so the new sort tier has values
-        // to read. Returns a new array (no in-place candidate mutation, #158);
-        // a no-op when neither preference list is supplied.
-        const ranked = annotateBoost(allCandidates, options.preferLanguages, options.preferRepos);
+        // Personalization annotation (#1244, extended #168): tag candidates with a
+        // net `personalization` marker (preferRepos/preferLanguages/boostIssueTypes
+        // add, avoidRepos subtracts) before sorting so the sort tier has values to
+        // read. Returns a new array (no in-place candidate mutation, #158); a no-op
+        // when none of the bias lists are supplied.
+        const ranked = annotateBoost(allCandidates, {
+            preferLanguages: options.preferLanguages,
+            preferRepos: options.preferRepos,
+            avoidRepos: options.avoidRepos,
+            boostIssueTypes: options.boostIssueTypes,
+        });
         // Sort by priority, recommendation, boost (#1244), then viability score
         ranked.sort((a, b) => {
             const priorityOrder = {

package/dist/core/issue-eligibility.d.ts

@@ -6,6 +6,7 @@
  * Extracted from issue-vetting.ts to isolate eligibility logic.
  */
 import { Octokit } from "@octokit/rest";
+import { type SearchBudgetTracker } from "./search-budget.js";
 import type { CheckResult, LinkedPR } from "./types.js";
 /**
  * Result of the existing-PR check, including metadata for the first linked PR
@@ -29,7 +30,7 @@ export declare function checkNoExistingPR(octokit: Octokit, owner: string, repo:
  * Results are cached per-repo for 15 minutes to avoid redundant Search API
  * calls when multiple issues from the same repo are vetted.
  */
-export declare function checkUserMergedPRsInRepo(octokit: Octokit, owner: string, repo: string): Promise<number | null>;
+export declare function checkUserMergedPRsInRepo(octokit: Octokit, owner: string, repo: string, tracker?: SearchBudgetTracker): Promise<number | null>;
 /**
  * Check whether an issue has been claimed by another contributor
  * by scanning recent comments for claim phrases.

package/dist/core/issue-eligibility.js

@@ -9,7 +9,7 @@ import { paginateAll } from "./pagination.js";
 import { errorMessage, rethrowIfFatal } from "./errors.js";
 import { warn } from "./logger.js";
 import { getHttpCache, withInflightDedup, versionedCacheKey, } from "./http-cache.js";
-import { getSearchBudgetTracker } from "./search-budget.js";
+import { getSearchBudgetTracker, } from "./search-budget.js";
 function isLinkedPREvent(e) {
     return e.event === "cross-referenced" && !!e.source?.issue?.pull_request;
 }
@@ -161,7 +161,11 @@ const MERGED_PR_CACHE_TTL_MS = 15 * 60 * 1000;
  * Results are cached per-repo for 15 minutes to avoid redundant Search API
  * calls when multiple issues from the same repo are vetted.
  */
-export async function checkUserMergedPRsInRepo(octokit, owner, repo) {
+export async function checkUserMergedPRsInRepo(octokit, owner, repo, 
+// Optional injected budget tracker. Defaults to the shared singleton so
+// existing callers keep the same global budget accounting; a host wanting
+// per-search isolation threads its own tracker down from IssueVetter.
+tracker = getSearchBudgetTracker()) {
     const cache = getHttpCache();
     const cacheKey = versionedCacheKey(`merged-prs:${owner}/${repo}`);
     // In-flight dedup: parallel vetting frequently hits several issues from
@@ -177,7 +181,6 @@ export async function checkUserMergedPRsInRepo(octokit, owner, repo) {
             return cached;
         }
         try {
-            const tracker = getSearchBudgetTracker();
             await tracker.waitForBudget();
             try {
                 // Use @me to search as the authenticated user

package/dist/core/issue-vetting.d.ts

@@ -9,6 +9,7 @@
 import { Octokit } from "@octokit/rest";
 import { type SearchPriority, type IssueCandidate, type ProjectCategory, type ScoutPreferences, type ScoutState, type MergedPRRecord, type ClosedPRRecord, type OpenPRRecord } from "./types.js";
 import { type PrefetchedIssueCore } from "./issue-graphql.js";
+import { type SearchBudgetTracker } from "./search-budget.js";
 /**
  * Feature-mode signals supplied by the caller (orchestrator) — the vetter
  * does NOT extract these from the GitHub issue itself. When passed, they
@@ -142,7 +143,15 @@ export declare function deriveRecommendation(input: RecommendationInput): Recomm
 export declare class IssueVetter {
     private octokit;
     private stateReader;
-    constructor(octokit: Octokit, stateReader: ScoutStateReader);
+    private 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: Octokit, stateReader: ScoutStateReader, budgetTracker?: SearchBudgetTracker);
     /**
      * Vet a specific issue — runs all checks and computes recommendation + viability score.
      * Results are cached for 15 minutes to avoid redundant API calls on repeated searches.

package/dist/core/issue-vetting.js

@@ -16,6 +16,7 @@ import { checkProjectHealth, fetchContributionGuidelines, } from "./repo-health.
 import { fetchAndScanAntiLLMPolicy } from "./anti-llm-policy.js";
 import { prefetchIssueCores, issueCoreKey, } from "./issue-graphql.js";
 import { getHttpCache, versionedCacheKey } from "./http-cache.js";
+import { getSearchBudgetTracker, } from "./search-budget.js";
 import { triageWithSLM, buildTriageInput, } from "./slm-triage.js";
 const MODULE = "issue-vetting";
 /** Vetting concurrency: kept low to reduce burst pressure on GitHub's secondary rate limit. */
@@ -119,9 +120,18 @@ export function deriveRecommendation(input) {
 export class IssueVetter {
     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.
@@ -170,7 +180,7 @@ export class IssueVetter {
             fetchContributionGuidelines(this.octokit, owner, repo),
             hasMergedPRsInRepo
                 ? Promise.resolve(0)
-                : checkUserMergedPRsInRepo(this.octokit, owner, repo),
+                : checkUserMergedPRsInRepo(this.octokit, owner, repo, this.budgetTracker),
         ]);
         // Anti-LLM scan reuses the CONTRIBUTING text just fetched above —
         // dedup'd to avoid 4 redundant getContent calls on cold-cache repos.