@oss-autopilot/core 1.11.0 → 1.12.1

package/dist/commands/daily.js

@@ -10,6 +10,7 @@ import { getStateManager, PRMonitor, IssueConversationMonitor, requireGitHubToke
 import { errorMessage, isRateLimitOrAuthError } from '../core/errors.js';
 import { warn } from '../core/logger.js';
 import { emptyPRCountsResult } from '../core/github-stats.js';
+import { createAutopilotScout } from './scout-bridge.js';
 import { updateMonthlyAnalytics } from './dashboard-data.js';
 import { deduplicateDigest, compactActionableIssues, compactRepoGroups, } from '../formatters/json.js';
 const MODULE = 'daily';
@@ -444,6 +445,22 @@ async function executeDailyCheckInternal(token) {
     catch (error) {
         warn(MODULE, `Failed to persist monthly analytics: ${errorMessage(error)}`);
     }
+    // Phase 3.5: Feed merged/closed PRs to oss-scout for cross-tool state sync.
+    if (recentlyMergedPRs.length > 0 || recentlyClosedPRs.length > 0) {
+        try {
+            const scout = await createAutopilotScout();
+            for (const pr of recentlyMergedPRs) {
+                scout.recordMergedPR({ url: pr.url, title: pr.title, mergedAt: pr.mergedAt, repo: pr.repo });
+            }
+            for (const pr of recentlyClosedPRs) {
+                scout.recordClosedPR({ url: pr.url, title: pr.title, closedAt: pr.closedAt, repo: pr.repo });
+            }
+            await scout.checkpoint();
+        }
+        catch (error) {
+            warn(MODULE, `Failed to sync PR data to oss-scout: ${errorMessage(error)}`);
+        }
+    }
     // Capture lastDigestAt BEFORE Phase 4 overwrites it with the current run's timestamp.
     // Used by collectActionableIssues to determine which PRs are "new" (created since last digest).
     const previousLastDigestAt = getStateManager().getState().lastDigestAt;

package/dist/commands/index.d.ts

@@ -25,6 +25,8 @@ export { runStatus } from './status.js';
 export { runSearch } from './search.js';
 /** Vet a single GitHub issue for claimability (open, unassigned, no linked PRs, repo health). */
 export { runVet } from './vet.js';
+/** Re-vet all available issues in a curated issue list for freshness. */
+export { runVetList } from './vet-list.js';
 /** Add a PR to tracking state. */
 export { runTrack } from './track.js';
 /** Remove a PR from tracking state. */
@@ -71,7 +73,7 @@ export { runDetectFormatters } from './detect-formatters.js';
 export { runLocalRepos } from './local-repos.js';
 export type { ErrorCode } from '../formatters/json.js';
 export type { DailyOutput, SearchOutput, StartupOutput, StatusOutput, TrackOutput } from '../formatters/json.js';
-export type { VetOutput, CommentsOutput, PostOutput, ClaimOutput } from '../formatters/json.js';
+export type { VetOutput, CommentsOutput, PostOutput, ClaimOutput, VetListOutput, VetListItemStatus, } from '../formatters/json.js';
 export type { ConfigOutput, DetectFormattersOutput, ParseIssueListOutput, ParsedIssueItem, CheckIntegrationOutput, LocalReposOutput, } from '../formatters/json.js';
 export type { ReadOutput } from './read.js';
 export type { ShelveOutput, UnshelveOutput } from './shelve.js';

package/dist/commands/index.js

@@ -26,6 +26,8 @@ export { runStatus } from './status.js';
 export { runSearch } from './search.js';
 /** Vet a single GitHub issue for claimability (open, unassigned, no linked PRs, repo health). */
 export { runVet } from './vet.js';
+/** Re-vet all available issues in a curated issue list for freshness. */
+export { runVetList } from './vet-list.js';
 // ── PR Management ───────────────────────────────────────────────────────────
 /** Add a PR to tracking state. */
 export { runTrack } from './track.js';

package/dist/commands/scout-bridge.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Bridge between oss-autopilot's AgentState and oss-scout's OssScout API.
+ * Maps state fields and creates scout instances for search/vet commands.
+ */
+import { type OssScout, type ScoutState } from '@oss-scout/core';
+/**
+ * Build a ScoutState from the current AgentState.
+ * Maps oss-autopilot's config and state fields to oss-scout's state format.
+ */
+export declare function buildScoutState(): ScoutState;
+/**
+ * Create an OssScout instance backed by the current AgentState.
+ * Uses 'provided' persistence so scout reads from oss-autopilot's state.
+ */
+export declare function createAutopilotScout(): Promise<OssScout>;

package/dist/commands/scout-bridge.js

@@ -0,0 +1,63 @@
+/**
+ * Bridge between oss-autopilot's AgentState and oss-scout's OssScout API.
+ * Maps state fields and creates scout instances for search/vet commands.
+ */
+import { createScout } from '@oss-scout/core';
+import { getStateManager, requireGitHubToken } from '../core/index.js';
+/**
+ * Build a ScoutState from the current AgentState.
+ * Maps oss-autopilot's config and state fields to oss-scout's state format.
+ */
+export function buildScoutState() {
+    const state = getStateManager().getState();
+    const { config } = state;
+    return {
+        version: 1,
+        preferences: {
+            githubUsername: config.githubUsername,
+            languages: config.languages,
+            labels: config.labels,
+            scope: config.scope,
+            excludeRepos: config.excludeRepos,
+            excludeOrgs: config.excludeOrgs ?? [],
+            aiPolicyBlocklist: config.aiPolicyBlocklist,
+            projectCategories: config.projectCategories ?? [],
+            minStars: config.minStars,
+            maxIssueAgeDays: config.maxIssueAgeDays,
+            includeDocIssues: config.includeDocIssues,
+            minRepoScoreThreshold: config.minRepoScoreThreshold,
+            interPhaseDelayMs: 30000,
+            broadPhaseDelayMs: 90000,
+            skipBroadWhenSufficientResults: 15,
+            persistence: config.persistence,
+        },
+        repoScores: state.repoScores,
+        starredRepos: config.starredRepos,
+        starredReposLastFetched: config.starredReposLastFetched,
+        mergedPRs: (state.mergedPRs ?? []).map((pr) => ({
+            url: pr.url,
+            title: pr.title,
+            mergedAt: pr.mergedAt,
+        })),
+        closedPRs: (state.closedPRs ?? []).map((pr) => ({
+            url: pr.url,
+            title: pr.title,
+            closedAt: pr.closedAt,
+        })),
+        savedResults: [],
+        skippedIssues: [],
+        lastRunAt: state.lastRunAt,
+    };
+}
+/**
+ * Create an OssScout instance backed by the current AgentState.
+ * Uses 'provided' persistence so scout reads from oss-autopilot's state.
+ */
+export async function createAutopilotScout() {
+    const token = requireGitHubToken();
+    return createScout({
+        githubToken: token,
+        persistence: 'provided',
+        initialState: buildScoutState(),
+    });
+}

package/dist/commands/search.d.ts

@@ -1,6 +1,6 @@
 /**
  * Search command
- * Searches for new issues to work on
+ * Searches for new issues to work on via @oss-scout/core
  */
 import { type SearchOutput } from '../formatters/json.js';
 export { type SearchOutput } from '../formatters/json.js';

package/dist/commands/search.js

@@ -1,8 +1,9 @@
 /**
  * Search command
- * Searches for new issues to work on
+ * Searches for new issues to work on via @oss-scout/core
  */
-import { IssueDiscovery, requireGitHubToken, getStateManager, DEFAULT_CONFIG } from '../core/index.js';
+import { createAutopilotScout } from './scout-bridge.js';
+import { getStateManager } from '../core/index.js';
 /**
  * Search GitHub for contributable issues using multi-phase discovery.
  *
@@ -22,15 +23,11 @@ import { IssueDiscovery, requireGitHubToken, getStateManager, DEFAULT_CONFIG } f
  * ```
  */
 export async function runSearch(options) {
-    const token = requireGitHubToken();
-    const discovery = new IssueDiscovery(token);
-    const candidates = await discovery.searchIssues({ maxResults: options.maxResults });
+    const scout = await createAutopilotScout();
+    const result = await scout.search({ maxResults: options.maxResults });
     const stateManager = getStateManager();
-    const { config } = stateManager.getState();
-    const excludedRepos = config.excludeRepos || [];
-    const aiPolicyBlocklist = config.aiPolicyBlocklist ?? DEFAULT_CONFIG.aiPolicyBlocklist ?? [];
     const searchOutput = {
-        candidates: candidates.map((c) => {
+        candidates: result.candidates.map((c) => {
             const repoScoreRecord = stateManager.getRepoScore(c.issue.repo);
             return {
                 issue: {
@@ -57,11 +54,11 @@ export async function runSearch(options) {
                     : undefined,
             };
         }),
-        excludedRepos,
-        aiPolicyBlocklist,
+        excludedRepos: result.excludedRepos,
+        aiPolicyBlocklist: result.aiPolicyBlocklist,
     };
-    if (discovery.rateLimitWarning) {
-        searchOutput.rateLimitWarning = discovery.rateLimitWarning;
+    if (result.rateLimitWarning) {
+        searchOutput.rateLimitWarning = result.rateLimitWarning;
     }
     return searchOutput;
 }

package/dist/commands/vet-list.d.ts

@@ -1,6 +1,6 @@
 /**
  * Vet-list command (#764)
- * Re-vets all available issues in a curated issue list file.
+ * Re-vets all available issues in a curated issue list file via @oss-scout/core.
  */
 import { type VetListOutput, type VetOutput, type VetListItemStatus } from '../formatters/json.js';
 interface VetListOptions {

package/dist/commands/vet-list.js

@@ -1,9 +1,9 @@
 /**
  * Vet-list command (#764)
- * Re-vets all available issues in a curated issue list file.
+ * Re-vets all available issues in a curated issue list file via @oss-scout/core.
  */
 import * as fs from 'fs';
-import { IssueDiscovery, requireGitHubToken } from '../core/index.js';
+import { createAutopilotScout } from './scout-bridge.js';
 import { runParseList, pruneIssueList } from './parse-list.js';
 import { detectIssueList } from './startup.js';
 /**
@@ -34,7 +34,6 @@ export function classifyListStatus(vetResult) {
  * @returns Consolidated vetting results with list status for each issue
  */
 export async function runVetList(options = {}) {
-    const token = requireGitHubToken();
     const concurrency = options.concurrency ?? 5;
     // 1. Find and parse the issue list
     let issueListPath = options.issueListPath;
@@ -53,7 +52,7 @@ export async function runVetList(options = {}) {
         };
     }
     // 2. Vet each available issue in parallel with concurrency limit
-    const discovery = new IssueDiscovery(token);
+    const scout = await createAutopilotScout();
     const results = [];
     // Simple concurrency limiter
     const items = parsed.available;
@@ -62,7 +61,7 @@ export async function runVetList(options = {}) {
         while (index < items.length) {
             const item = items[index++];
             try {
-                const candidate = await discovery.vetIssue(item.url);
+                const candidate = await scout.vetIssue(item.url);
                 const vetResult = {
                     issue: {
                         repo: candidate.issue.repo,

package/dist/commands/vet.d.ts

@@ -1,6 +1,6 @@
 /**
  * Vet command
- * Vets a specific issue before working on it
+ * Vets a specific issue before working on it via @oss-scout/core
  */
 import { type VetOutput } from '../formatters/json.js';
 export { type VetOutput } from '../formatters/json.js';

package/dist/commands/vet.js

@@ -1,8 +1,8 @@
 /**
  * Vet command
- * Vets a specific issue before working on it
+ * Vets a specific issue before working on it via @oss-scout/core
  */
-import { IssueDiscovery, requireGitHubToken } from '../core/index.js';
+import { createAutopilotScout } from './scout-bridge.js';
 import { ISSUE_URL_PATTERN, validateGitHubUrl, validateUrl } from './validation.js';
 /**
  * Vet a specific GitHub issue for claimability and project health.
@@ -15,9 +15,8 @@ import { ISSUE_URL_PATTERN, validateGitHubUrl, validateUrl } from './validation.
 export async function runVet(options) {
     validateUrl(options.issueUrl);
     validateGitHubUrl(options.issueUrl, ISSUE_URL_PATTERN, 'issue');
-    const token = requireGitHubToken();
-    const discovery = new IssueDiscovery(token);
-    const candidate = await discovery.vetIssue(options.issueUrl);
+    const scout = await createAutopilotScout();
+    const candidate = await scout.vetIssue(options.issueUrl);
     return {
         issue: {
             repo: candidate.issue.repo,

package/dist/core/index.d.ts

@@ -5,8 +5,6 @@
 export { StateManager, getStateManager, getStateManagerAsync, resetStateManager, type Stats } from './state.js';
 export { GistStateStore } from './gist-state-store.js';
 export { PRMonitor, type PRCheckFailure, type FetchPRsResult, computeDisplayLabel, classifyCICheck, classifyFailingChecks, } from './pr-monitor.js';
-export { IssueDiscovery } from './issue-discovery.js';
-export { isDocOnlyIssue, applyPerRepoCap, DOC_ONLY_LABELS } from './issue-filtering.js';
 export { IssueConversationMonitor } from './issue-conversation.js';
 export { isBotAuthor, isAcknowledgmentComment } from './comment-utils.js';
 export { getOctokit, checkRateLimit, type RateLimitInfo } from './github.js';

package/dist/core/index.js

@@ -5,8 +5,7 @@
 export { StateManager, getStateManager, getStateManagerAsync, resetStateManager } from './state.js';
 export { GistStateStore } from './gist-state-store.js';
 export { PRMonitor, computeDisplayLabel, classifyCICheck, classifyFailingChecks, } from './pr-monitor.js';
-export { IssueDiscovery } from './issue-discovery.js';
-export { isDocOnlyIssue, applyPerRepoCap, DOC_ONLY_LABELS } from './issue-filtering.js';
+// Search/vetting now delegated to @oss-scout/core via commands/scout-bridge.ts
 export { IssueConversationMonitor } from './issue-conversation.js';
 export { isBotAuthor, isAcknowledgmentComment } from './comment-utils.js';
 export { getOctokit, checkRateLimit } from './github.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-autopilot/core",
-  "version": "1.11.0",
+  "version": "1.12.1",
   "description": "CLI and core library for managing open source contributions",
   "type": "module",
   "bin": {
@@ -50,6 +50,7 @@
   "dependencies": {
     "@octokit/plugin-throttling": "^11.0.3",
     "@octokit/rest": "^22.0.1",
+    "@oss-scout/core": "^0.4.0",
     "commander": "^14.0.3",
     "zod": "^4.3.6"
   },

package/dist/core/category-mapping.d.ts

@@ -1,19 +0,0 @@
-/**
- * Category Mapping — static mappings from project categories to GitHub topics and organizations.
- *
- * Used by issue discovery to prioritize repos matching user's category preferences.
- */
-import type { ProjectCategory } from './types.js';
-/** GitHub topics associated with each project category, used for `topic:` search queries. */
-export declare const CATEGORY_TOPICS: Record<ProjectCategory, string[]>;
-/** Well-known GitHub organizations associated with each project category. */
-export declare const CATEGORY_ORGS: Record<ProjectCategory, string[]>;
-/**
- * Check if a repo belongs to any of the given categories based on its owner matching a category org.
- * Comparison is case-insensitive.
- */
-export declare function repoBelongsToCategory(repoFullName: string, categories: ProjectCategory[]): boolean;
-/**
- * Get deduplicated GitHub topics for the given categories, for use in `topic:` search queries.
- */
-export declare function getTopicsForCategories(categories: ProjectCategory[]): string[];

package/dist/core/category-mapping.js

@@ -1,58 +0,0 @@
-/**
- * Category Mapping — static mappings from project categories to GitHub topics and organizations.
- *
- * Used by issue discovery to prioritize repos matching user's category preferences.
- */
-/** GitHub topics associated with each project category, used for `topic:` search queries. */
-export const CATEGORY_TOPICS = {
-    nonprofit: ['nonprofit', 'social-good', 'humanitarian', 'charity', 'social-impact', 'civic-tech'],
-    devtools: ['developer-tools', 'devtools', 'cli', 'sdk', 'linter', 'formatter', 'build-tool'],
-    infrastructure: ['infrastructure', 'cloud', 'kubernetes', 'docker', 'devops', 'monitoring', 'observability'],
-    'web-frameworks': ['web-framework', 'frontend', 'backend', 'fullstack', 'nextjs', 'react', 'vue'],
-    'data-ml': ['machine-learning', 'data-science', 'deep-learning', 'nlp', 'data-pipeline', 'analytics'],
-    education: ['education', 'learning', 'tutorial', 'courseware', 'edtech', 'teaching'],
-};
-/** Well-known GitHub organizations associated with each project category. */
-export const CATEGORY_ORGS = {
-    nonprofit: ['code-for-america', 'opengovfoundation', 'ushahidi', 'hotosm', 'openfn', 'democracyearth'],
-    devtools: ['eslint', 'prettier', 'vitejs', 'biomejs', 'oxc-project', 'ast-grep', 'turbot'],
-    infrastructure: ['kubernetes', 'hashicorp', 'grafana', 'prometheus', 'open-telemetry', 'envoyproxy', 'cncf'],
-    'web-frameworks': ['vercel', 'remix-run', 'sveltejs', 'nuxt', 'astro', 'redwoodjs', 'blitz-js'],
-    'data-ml': ['huggingface', 'mlflow', 'apache', 'dbt-labs', 'dagster-io', 'prefecthq', 'langchain-ai'],
-    education: ['freeCodeCamp', 'TheOdinProject', 'exercism', 'codecademy', 'oppia', 'Khan'],
-};
-/**
- * Check if a repo belongs to any of the given categories based on its owner matching a category org.
- * Comparison is case-insensitive.
- */
-export function repoBelongsToCategory(repoFullName, categories) {
-    if (categories.length === 0)
-        return false;
-    const owner = repoFullName.split('/')[0]?.toLowerCase();
-    if (!owner)
-        return false;
-    for (const category of categories) {
-        const orgs = CATEGORY_ORGS[category];
-        if (!orgs)
-            continue; // Guard against invalid categories from hand-edited state.json
-        if (orgs.some((org) => org.toLowerCase() === owner)) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Get deduplicated GitHub topics for the given categories, for use in `topic:` search queries.
- */
-export function getTopicsForCategories(categories) {
-    const topics = new Set();
-    for (const category of categories) {
-        const categoryTopics = CATEGORY_TOPICS[category];
-        if (!categoryTopics)
-            continue; // Guard against invalid categories from hand-edited state.json
-        for (const topic of categoryTopics) {
-            topics.add(topic);
-        }
-    }
-    return [...topics];
-}

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

@@ -1,94 +0,0 @@
-/**
- * Issue Discovery — orchestrates multi-phase issue search across GitHub.
- *
- * Delegates filtering, scoring, vetting, and search infrastructure to focused modules (#356, #621):
- * - issue-filtering.ts  — spam detection, doc-only filtering, per-repo caps
- * - issue-scoring.ts   — viability scores, repo quality bonuses
- * - issue-vetting.ts   — vetting orchestration, recommendation + viability scoring
- * - issue-eligibility.ts — PR existence, claim detection, requirements analysis
- * - repo-health.ts     — project health checks, contribution guidelines
- * - search-phases.ts   — search helpers, caching, batched repo search
- */
-import { type IssueCandidate } from './types.js';
-/**
- * Multi-phase issue discovery engine that searches GitHub for contributable issues.
- *
- * Search phases (in priority order):
- * 0. Repos where user has merged PRs (highest merge probability)
- * 0.5. Preferred organizations
- * 1. Starred repos
- * 2. General label-filtered search
- * 3. Actively maintained repos
- *
- * Each candidate is vetted for claimability and scored 0-100 for viability.
- */
-export declare class IssueDiscovery {
-    private octokit;
-    private stateManager;
-    private githubToken;
-    private vetter;
-    /** 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` */
-    constructor(githubToken: string);
-    /**
-     * Fetch the authenticated user's starred repositories from GitHub.
-     * Updates the state manager with the list and timestamp.
-     * @returns Array of starred repo names in "owner/repo" format
-     */
-    fetchStarredRepos(): Promise<string[]>;
-    /**
-     * Get starred repos, fetching from GitHub if cache is stale.
-     * @returns Array of starred repo names in "owner/repo" format
-     */
-    getStarredReposWithRefresh(): Promise<string[]>;
-    /**
-     * Search for issues matching our criteria.
-     * Searches in priority order: merged-PR repos first (no label filter), then preferred
-     * organizations, then starred repos, then general search, then actively maintained repos.
-     * Filters out issues from low-scoring and excluded repos.
-     *
-     * @param options - Search configuration
-     * @param options.languages - Programming languages to filter by
-     * @param options.labels - Issue labels to search for
-     * @param options.maxResults - Maximum candidates to return (default: 10)
-     * @returns Scored and sorted issue candidates
-     * @throws {ValidationError} If no candidates found and no rate limits prevented the search
-     *
-     * @example
-     * ```typescript
-     * import { IssueDiscovery, requireGitHubToken } from '@oss-autopilot/core';
-     *
-     * const discovery = new IssueDiscovery(requireGitHubToken());
-     * const candidates = await discovery.searchIssues({ maxResults: 5 });
-     * for (const c of candidates) {
-     *   console.log(`${c.issue.repo}#${c.issue.number}: ${c.viabilityScore}/100`);
-     * }
-     * ```
-     */
-    searchIssues(options?: {
-        languages?: string[];
-        labels?: string[];
-        maxResults?: number;
-    }): Promise<IssueCandidate[]>;
-    /**
-     * Vet a specific issue for claimability and project health.
-     * @param issueUrl - Full GitHub issue URL
-     * @returns The vetted issue candidate with recommendation and scores
-     * @throws {ValidationError} If the URL is invalid or the issue cannot be fetched
-     */
-    vetIssue(issueUrl: string): Promise<IssueCandidate>;
-    /**
-     * Save search results to ~/.oss-autopilot/found-issues.md.
-     * Results are sorted by viability score (highest first).
-     * @param candidates - Issue candidates to save
-     * @returns Absolute path to the written file
-     */
-    saveSearchResults(candidates: IssueCandidate[]): string;
-    /**
-     * Format issue candidate as a markdown display string.
-     * @param candidate - The issue candidate to format
-     * @returns Multi-line markdown string with vetting details
-     */
-    formatCandidate(candidate: IssueCandidate): string;
-}