@oss-scout/core 0.4.0 → 0.5.0

package/dist/core/bootstrap.d.ts

@@ -7,6 +7,7 @@ export interface BootstrapResult {
     starredRepoCount: number;
     mergedPRCount: number;
     closedPRCount: number;
+    openPRCount: number;
     reposScoredCount: number;
     skippedDueToRateLimit: boolean;
     errors: string[];

package/dist/core/bootstrap.js

@@ -4,7 +4,7 @@
  */
 import { getOctokit, checkRateLimit } from "./github.js";
 import { debug, warn } from "./logger.js";
-import { ConfigurationError, errorMessage } from "./errors.js";
+import { ConfigurationError, errorMessage, getHttpStatusCode, isRateLimitError, } from "./errors.js";
 import { extractRepoFromUrl } from "./utils.js";
 const MODULE = "bootstrap";
 const STARRED_MAX_PAGES = 5;
@@ -23,6 +23,7 @@ export async function bootstrapScout(scout, token) {
             starredRepoCount: 0,
             mergedPRCount: 0,
             closedPRCount: 0,
+            openPRCount: 0,
             reposScoredCount: 0,
             skippedDueToRateLimit: true,
             errors: [],
@@ -80,6 +81,8 @@ export async function bootstrapScout(scout, token) {
         debug(MODULE, `Imported ${mergedPRCount} merged PRs`);
     }
     catch (err) {
+        if (getHttpStatusCode(err) === 401 || isRateLimitError(err))
+            throw err;
         warn(MODULE, `Failed to fetch merged PRs: ${errorMessage(err)}`);
         errors.push("merged PR fetch failed");
     }
@@ -110,15 +113,50 @@ export async function bootstrapScout(scout, token) {
         debug(MODULE, `Imported ${closedPRCount} closed PRs`);
     }
     catch (err) {
+        if (getHttpStatusCode(err) === 401 || isRateLimitError(err))
+            throw err;
         warn(MODULE, `Failed to fetch closed PRs: ${errorMessage(err)}`);
         errors.push("closed PR fetch failed");
     }
+    // 4. Fetch currently-open PRs via Search API
+    let openPRCount = 0;
+    try {
+        for (let page = 1; page <= SEARCH_MAX_PAGES; page++) {
+            const { data } = await octokit.search.issuesAndPullRequests({
+                q: `is:pr is:open author:${username}`,
+                per_page: PER_PAGE,
+                page,
+            });
+            for (const item of data.items) {
+                const repo = extractRepoFromUrl(item.html_url);
+                if (!repo)
+                    continue;
+                scout.recordOpenPR({
+                    url: item.html_url,
+                    title: item.title,
+                    openedAt: item.created_at ?? new Date().toISOString(),
+                    repo,
+                });
+                openPRCount++;
+            }
+            if (data.items.length < PER_PAGE)
+                break;
+        }
+        debug(MODULE, `Imported ${openPRCount} open PRs`);
+    }
+    catch (err) {
+        if (getHttpStatusCode(err) === 401 || isRateLimitError(err))
+            throw err;
+        warn(MODULE, `Failed to fetch open PRs: ${errorMessage(err)}`);
+        errors.push("open PR fetch failed");
+    }
     const state = scout.getState();
     const reposScoredCount = Object.keys(state.repoScores).length;
     return {
         starredRepoCount: starredRepos.length,
         mergedPRCount,
         closedPRCount,
+        openPRCount,
         reposScoredCount,
         skippedDueToRateLimit: false,
         errors,

package/dist/core/gist-state-store.d.ts

@@ -88,7 +88,7 @@ export declare class GistStateStore {
 /**
  * Merge two ScoutState objects with conflict resolution:
  * - repoScores: per-repo, keep the one with more total PR activity
- * - mergedPRs/closedPRs: union by URL
+ * - mergedPRs/closedPRs/openPRs: union by URL
  * - preferences: remote wins
  * - starredRepos: keep the list with the fresher timestamp
  * - savedResults: union by issueUrl, keep newer lastSeenAt

package/dist/core/gist-state-store.js

@@ -238,7 +238,7 @@ export class GistStateStore {
 /**
  * Merge two ScoutState objects with conflict resolution:
  * - repoScores: per-repo, keep the one with more total PR activity
- * - mergedPRs/closedPRs: union by URL
+ * - mergedPRs/closedPRs/openPRs: union by URL
  * - preferences: remote wins
  * - starredRepos: keep the list with the fresher timestamp
  * - savedResults: union by issueUrl, keep newer lastSeenAt
@@ -252,6 +252,7 @@ export function mergeStates(local, remote) {
         starredReposLastFetched: pickFresherTimestamp(local.starredReposLastFetched, remote.starredReposLastFetched),
         mergedPRs: unionByUrl(local.mergedPRs, remote.mergedPRs),
         closedPRs: unionByUrl(local.closedPRs, remote.closedPRs),
+        openPRs: unionByUrl(local.openPRs ?? [], remote.openPRs ?? []),
         savedResults: mergeSavedResults(local.savedResults ?? [], remote.savedResults ?? []),
         skippedIssues: mergeSkippedIssues(local.skippedIssues ?? [], remote.skippedIssues ?? []),
         lastSearchAt: pickFresherTimestamp(local.lastSearchAt, remote.lastSearchAt),

package/dist/core/issue-discovery.js

@@ -326,6 +326,7 @@ export class IssueDiscovery {
         }
         // Derive search context
         const mergedPRRepos = this.stateReader.getReposWithMergedPRs();
+        const openPRRepos = this.stateReader.getReposWithOpenPRs();
         const starredRepos = this.getStarredRepos();
         const starredRepoSet = new Set(starredRepos);
         const lowScoringRepos = new Set(this.deriveLowScoringRepos(config.minRepoScoreThreshold));
@@ -352,8 +353,19 @@ export class IssueDiscovery {
             now: new Date(),
             includeDocIssues: config.includeDocIssues ?? true,
         });
-        // Phase 0: Merged-PR repos
-        const phase0Repos = mergedPRRepos.slice(0, 10);
+        // Phase 0: Repos the user has engaged with — merged PRs first (strongest
+        // signal), then open PRs (active engagement even without a merge yet).
+        // Deduped and capped so REST cost stays bounded.
+        const seenPhase0 = new Set();
+        const phase0Repos = [];
+        for (const repo of [...mergedPRRepos, ...openPRRepos]) {
+            if (seenPhase0.has(repo))
+                continue;
+            seenPhase0.add(repo);
+            phase0Repos.push(repo);
+            if (phase0Repos.length >= 10)
+                break;
+        }
         const phase0RepoSet = new Set(phase0Repos);
         if (phase0Repos.length > 0 && enabledStrategies.has("merged")) {
             const remaining = maxResults - allCandidates.length;

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

@@ -15,6 +15,8 @@ import { type SearchPriority, type IssueCandidate, type ProjectCategory } from "
 export interface ScoutStateReader {
     /** Repos where the user has at least one merged PR. */
     getReposWithMergedPRs(): string[];
+    /** Repos where the user has at least one open PR. */
+    getReposWithOpenPRs(): string[];
     /** User's starred repos (from GitHub). */
     getStarredRepos(): string[];
     /** Preferred project categories from user preferences. */

package/dist/core/schemas.d.ts

@@ -64,6 +64,11 @@ export declare const StoredClosedPRSchema: z.ZodObject<{
     title: z.ZodString;
     closedAt: z.ZodString;
 }, z.core.$strip>;
+export declare const StoredOpenPRSchema: z.ZodObject<{
+    url: z.ZodString;
+    title: z.ZodString;
+    openedAt: z.ZodString;
+}, z.core.$strip>;
 export declare const ContributionGuidelinesSchema: z.ZodObject<{
     branchNamingConvention: z.ZodOptional<z.ZodString>;
     commitMessageFormat: z.ZodOptional<z.ZodString>;
@@ -287,6 +292,11 @@ export declare const ScoutStateSchema: z.ZodObject<{
         title: z.ZodString;
         closedAt: z.ZodString;
     }, z.core.$strip>>>;
+    openPRs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        title: z.ZodString;
+        openedAt: z.ZodString;
+    }, z.core.$strip>>>;
     savedResults: z.ZodDefault<z.ZodArray<z.ZodObject<{
         issueUrl: z.ZodString;
         repo: z.ZodString;
@@ -322,6 +332,7 @@ export type RepoSignals = z.infer<typeof RepoSignalsSchema>;
 export type RepoScore = z.infer<typeof RepoScoreSchema>;
 export type StoredMergedPR = z.infer<typeof StoredMergedPRSchema>;
 export type StoredClosedPR = z.infer<typeof StoredClosedPRSchema>;
+export type StoredOpenPR = z.infer<typeof StoredOpenPRSchema>;
 export type ContributionGuidelines = z.infer<typeof ContributionGuidelinesSchema>;
 export type IssueVettingResult = z.infer<typeof IssueVettingResultSchema>;
 export type TrackedIssue = z.infer<typeof TrackedIssueSchema>;

package/dist/core/schemas.js

@@ -67,6 +67,11 @@ export const StoredClosedPRSchema = z.object({
     title: z.string(),
     closedAt: z.string(),
 });
+export const StoredOpenPRSchema = z.object({
+    url: z.string(),
+    title: z.string(),
+    openedAt: z.string(),
+});
 // ── Contribution schemas ────────────────────────────────────────────
 export const ContributionGuidelinesSchema = z.object({
     branchNamingConvention: z.string().optional(),
@@ -161,6 +166,7 @@ export const ScoutStateSchema = z.object({
     starredReposLastFetched: z.string().optional(),
     mergedPRs: z.array(StoredMergedPRSchema).default([]),
     closedPRs: z.array(StoredClosedPRSchema).default([]),
+    openPRs: z.array(StoredOpenPRSchema).default([]),
     savedResults: z.array(SavedCandidateSchema).default([]),
     skippedIssues: z.array(SkippedIssueSchema).default([]),
     lastSearchAt: z.string().optional(),

package/dist/core/types.d.ts

@@ -122,3 +122,10 @@ export interface ClosedPRRecord {
     closedAt: string;
     repo: string;
 }
+/** Record of an open PR for state contribution. */
+export interface OpenPRRecord {
+    url: string;
+    title: string;
+    openedAt: string;
+    repo: string;
+}

package/dist/index.d.ts

@@ -15,8 +15,8 @@
  * @packageDocumentation
  */
 export { createScout, OssScout } from "./scout.js";
-export type { ScoutConfig, SearchOptions, SearchResult, IssueCandidate, MergedPRRecord, ClosedPRRecord, RepoScoreUpdate, ProjectHealth, SearchPriority, CheckResult, VetListOptions, VetListResult, VetListEntry, VetListSummary, } from "./core/types.js";
-export type { ScoutState, ScoutPreferences, RepoScore, RepoSignals, IssueVettingResult, ContributionGuidelines, TrackedIssue, IssueScope, ProjectCategory, StoredMergedPR, StoredClosedPR, SearchStrategy, SkippedIssue, } from "./core/schemas.js";
+export type { ScoutConfig, SearchOptions, SearchResult, IssueCandidate, MergedPRRecord, ClosedPRRecord, OpenPRRecord, RepoScoreUpdate, ProjectHealth, SearchPriority, CheckResult, VetListOptions, VetListResult, VetListEntry, VetListSummary, } from "./core/types.js";
+export type { ScoutState, ScoutPreferences, RepoScore, RepoSignals, IssueVettingResult, ContributionGuidelines, TrackedIssue, IssueScope, ProjectCategory, StoredMergedPR, StoredClosedPR, StoredOpenPR, SearchStrategy, SkippedIssue, } from "./core/schemas.js";
 export { ScoutStateSchema, ScoutPreferencesSchema, RepoScoreSchema, IssueScopeSchema, ProjectCategorySchema, SearchStrategySchema, SkippedIssueSchema, } from "./core/schemas.js";
 export { requireGitHubToken, getGitHubToken } from "./core/utils.js";
 export { IssueDiscovery } from "./core/issue-discovery.js";

package/dist/scout.d.ts

@@ -6,7 +6,7 @@
  */
 import type { ScoutStateReader } from "./core/issue-vetting.js";
 import type { ScoutState, ScoutPreferences, RepoScore, SavedCandidate, SkippedIssue } from "./core/schemas.js";
-import type { ScoutConfig, SearchOptions, SearchResult, IssueCandidate, MergedPRRecord, ClosedPRRecord, RepoScoreUpdate, ProjectCategory, VetListOptions, VetListResult } from "./core/types.js";
+import type { ScoutConfig, SearchOptions, SearchResult, IssueCandidate, MergedPRRecord, ClosedPRRecord, OpenPRRecord, RepoScoreUpdate, ProjectCategory, VetListOptions, VetListResult } from "./core/types.js";
 import { GistStateStore } from "./core/gist-state-store.js";
 /**
  * Create an OssScout instance.
@@ -59,6 +59,7 @@ export declare class OssScout implements ScoutStateReader {
     vetList(options?: VetListOptions): Promise<VetListResult>;
     private classifyVetResult;
     getReposWithMergedPRs(): string[];
+    getReposWithOpenPRs(): string[];
     getStarredRepos(): string[];
     getProjectCategories(): ProjectCategory[];
     getRepoScore(repo: string): number | null;
@@ -75,6 +76,11 @@ export declare class OssScout implements ScoutStateReader {
      * Record that a PR was closed without merge.
      */
     recordClosedPR(pr: ClosedPRRecord): void;
+    /**
+     * Record that a PR is currently open in this repo.
+     * Open PRs signal active engagement even when nothing is merged yet.
+     */
+    recordOpenPR(pr: OpenPRRecord): void;
     /**
      * Update repo score with observed signals.
      */

package/dist/scout.js

@@ -236,6 +236,18 @@ export class OssScout {
             .sort((a, b) => b[1] - a[1])
             .map(([repo]) => repo);
     }
+    getReposWithOpenPRs() {
+        const repoCounts = new Map();
+        for (const pr of this.state.openPRs ?? []) {
+            const repo = extractRepoFromUrl(pr.url);
+            if (repo) {
+                repoCounts.set(repo, (repoCounts.get(repo) ?? 0) + 1);
+            }
+        }
+        return [...repoCounts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .map(([repo]) => repo);
+    }
     getStarredRepos() {
         return this.state.starredRepos;
     }
@@ -285,6 +297,20 @@ export class OssScout {
         this.updateRepoScoreFromPRs(pr.repo);
         this.dirty = true;
     }
+    /**
+     * Record that a PR is currently open in this repo.
+     * Open PRs signal active engagement even when nothing is merged yet.
+     */
+    recordOpenPR(pr) {
+        const existing = this.state.openPRs ?? [];
+        if (existing.some((p) => p.url === pr.url))
+            return;
+        this.state.openPRs = [
+            ...existing,
+            { url: pr.url, title: pr.title, openedAt: pr.openedAt },
+        ];
+        this.dirty = true;
+    }
     /**
      * Update repo score with observed signals.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-scout/core",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Personalized GitHub issue finder with multi-strategy search, deep vetting, and viability scoring — CLI, library, MCP server, and Claude Code plugin",
   "type": "module",
   "bin": {
@@ -55,11 +55,12 @@
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
-    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/coverage-v8": "^4.1.4",
     "esbuild": "^0.27.4",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "vite": "^8.0.5",
+    "vitest": "^4.1.4"
   },
   "scripts": {
     "build": "tsc",