@oss-scout/core 0.2.0 → 0.3.0

package/dist/cli.js

@@ -2,41 +2,41 @@
 /**
  * oss-scout CLI — Find open source issues personalized to your contribution history.
  */
-import { Command } from 'commander';
-import { enableDebug } from './core/logger.js';
-import { getCLIVersion } from './core/utils.js';
-import { formatJsonSuccess, formatJsonError } from './formatters/json.js';
-import { errorMessage, resolveErrorCode } from './core/errors.js';
-import { hasLocalState, loadLocalState, saveLocalState } from './core/local-state.js';
-import { CONCRETE_STRATEGIES, SearchStrategySchema } from './core/schemas.js';
+import { Command } from "commander";
+import { enableDebug } from "./core/logger.js";
+import { getCLIVersion } from "./core/utils.js";
+import { formatJsonSuccess, formatJsonError } from "./formatters/json.js";
+import { errorMessage, resolveErrorCode } from "./core/errors.js";
+import { hasLocalState, loadLocalState, saveLocalState, } from "./core/local-state.js";
+import { CONCRETE_STRATEGIES, SearchStrategySchema } from "./core/schemas.js";
 function handleCommandError(err, options) {
     if (options.json) {
         console.log(formatJsonError(errorMessage(err), resolveErrorCode(err)));
     }
     else {
-        console.error('Error:', errorMessage(err));
+        console.error("Error:", errorMessage(err));
     }
     process.exit(1);
 }
 const program = new Command();
 program
-    .name('oss-scout')
-    .description('Find open source issues personalized to your contribution history')
+    .name("oss-scout")
+    .description("Find open source issues personalized to your contribution history")
     .version(getCLIVersion())
-    .option('--debug', 'Enable debug output');
+    .option("--debug", "Enable debug output");
 // Parse --debug early so it's available in preAction hooks
-program.hook('preAction', (_thisCommand, _actionCommand) => {
+program.hook("preAction", (_thisCommand, _actionCommand) => {
     const opts = program.opts();
     if (opts.debug)
         enableDebug();
 });
 program
-    .command('setup')
-    .description('Interactive first-run configuration')
-    .option('--json', 'Output as JSON')
+    .command("setup")
+    .description("Interactive first-run configuration")
+    .option("--json", "Output as JSON")
     .action(async (options) => {
     try {
-        const { runSetup } = await import('./commands/setup.js');
+        const { runSetup } = await import("./commands/setup.js");
         const prefs = await runSetup();
         const state = loadLocalState();
         state.preferences = prefs;
@@ -50,17 +50,21 @@ program
     }
 });
 program
-    .command('bootstrap')
-    .description('Import starred repos and PR history from GitHub')
-    .option('--json', 'Output as JSON')
+    .command("bootstrap")
+    .description("Import starred repos and PR history from GitHub")
+    .option("--json", "Output as JSON")
     .action(async (options) => {
     try {
-        const { bootstrapScout } = await import('./core/bootstrap.js');
-        const { createScout } = await import('./scout.js');
-        const { requireGitHubToken } = await import('./core/utils.js');
+        const { bootstrapScout } = await import("./core/bootstrap.js");
+        const { createScout } = await import("./scout.js");
+        const { requireGitHubToken } = await import("./core/utils.js");
         const token = requireGitHubToken();
         const state = loadLocalState();
-        const scout = await createScout({ githubToken: token, persistence: 'provided', initialState: state });
+        const scout = await createScout({
+            githubToken: token,
+            persistence: "provided",
+            initialState: state,
+        });
         const result = await bootstrapScout(scout, token);
         saveLocalState(scout.getState());
         if (options.json) {
@@ -68,7 +72,7 @@ program
         }
         else {
             if (result.skippedDueToRateLimit) {
-                console.log('Skipped: GitHub API rate limit too low. Try again later.');
+                console.log("Skipped: GitHub API rate limit too low. Try again later.");
             }
             else {
                 console.log(`Imported ${result.mergedPRCount} merged PRs, ${result.closedPRCount} closed PRs, ${result.starredRepoCount} starred repos`);
@@ -81,35 +85,41 @@ program
     }
 });
 program
-    .command('search [count]')
-    .description('Search for contributable issues using multi-strategy discovery')
-    .option('--json', 'Output as JSON')
-    .option('--strategy <strategies>', `Search strategies (${CONCRETE_STRATEGIES.join(',')},all)`, 'all')
+    .command("search [count]")
+    .description("Search for contributable issues using multi-strategy discovery")
+    .option("--json", "Output as JSON")
+    .option("--strategy <strategies>", `Search strategies (${CONCRETE_STRATEGIES.join(",")},all)`, "all")
     .action(async (count, options) => {
     try {
         if (!hasLocalState()) {
-            console.log('💡 Run `oss-scout setup` to configure your preferences for personalized search results.\n');
+            console.log("💡 Run `oss-scout setup` to configure your preferences for personalized search results.\n");
         }
-        const { runSearch } = await import('./commands/search.js');
+        const { runSearch } = await import("./commands/search.js");
         const maxResults = count ? parseInt(count, 10) : 10;
         if (isNaN(maxResults) || maxResults < 1) {
-            console.error('Error: count must be a positive integer');
+            console.error("Error: count must be a positive integer");
             process.exit(1);
         }
         const state = loadLocalState();
         if (state.mergedPRs.length === 0 &&
             state.starredRepos.length === 0 &&
             state.preferences.githubUsername) {
-            console.log('Run `oss-scout bootstrap` to import your starred repos and PR history for better results.\n');
+            console.log("Run `oss-scout bootstrap` to import your starred repos and PR history for better results.\n");
         }
         // Parse --strategy option
-        const strategyTokens = (options.strategy ?? 'all').split(',').map(s => s.trim()).filter(Boolean);
+        const strategyTokens = (options.strategy ?? "all")
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean);
         const strategies = [];
         for (const token of strategyTokens) {
             const parsed = SearchStrategySchema.safeParse(token);
             if (!parsed.success) {
-                const valid = [...CONCRETE_STRATEGIES, 'all'].join(', ');
-                console.error('Error: unknown strategy "' + token + '". Valid strategies: ' + valid);
+                const valid = [...CONCRETE_STRATEGIES, "all"].join(", ");
+                console.error('Error: unknown strategy "' +
+                    token +
+                    '". Valid strategies: ' +
+                    valid);
                 process.exit(1);
             }
             strategies.push(parsed.data);
@@ -122,7 +132,11 @@ program
             // Human-readable output
             console.log(`\nFound ${results.candidates.length} issue candidates:\n`);
             for (const c of results.candidates) {
-                const icon = c.recommendation === 'approve' ? '✅' : c.recommendation === 'skip' ? '❌' : '⚠️';
+                const icon = c.recommendation === "approve"
+                    ? "✅"
+                    : c.recommendation === "skip"
+                        ? "❌"
+                        : "⚠️";
                 console.log(`  ${icon} ${c.issue.repo}#${c.issue.number} [${c.viabilityScore}/100]`);
                 console.log(`     ${c.issue.title}`);
                 console.log(`     ${c.issue.url}`);
@@ -142,33 +156,33 @@ program
 });
 // ── results command ────────────────────────────────────────────────
 const resultsCmd = program
-    .command('results')
-    .description('Show saved search results');
+    .command("results")
+    .description("Show saved search results");
 resultsCmd
-    .command('show', { isDefault: true })
-    .description('Display saved search results')
-    .option('--json', 'Output as JSON')
+    .command("show", { isDefault: true })
+    .description("Display saved search results")
+    .option("--json", "Output as JSON")
     .action(async (options) => {
     try {
-        const { runResults } = await import('./commands/results.js');
+        const { runResults } = await import("./commands/results.js");
         const results = await runResults(options);
         if (options.json) {
             console.log(formatJsonSuccess(results));
         }
         else {
             if (results.length === 0) {
-                console.log('\nNo saved results. Run `oss-scout search` to find issues.\n');
+                console.log("\nNo saved results. Run `oss-scout search` to find issues.\n");
                 return;
             }
             console.log(`\nSaved results (${results.length}):\n`);
-            console.log('  Score  Repo                              Issue   Recommendation  Title');
-            console.log('  ─────  ────────────────────────────────  ──────  ──────────────  ─────');
+            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;
+                const title = r.title.length > 50 ? r.title.slice(0, 47) + "..." : r.title;
                 console.log(`  ${score}    ${repo}  ${issue}  ${rec}  ${title}`);
             }
             console.log();
@@ -179,18 +193,18 @@ resultsCmd
     }
 });
 resultsCmd
-    .command('clear')
-    .description('Clear all saved results')
-    .option('--json', 'Output as JSON')
+    .command("clear")
+    .description("Clear all saved results")
+    .option("--json", "Output as JSON")
     .action(async (options) => {
     try {
-        const { runResultsClear } = await import('./commands/results.js');
+        const { runResultsClear } = await import("./commands/results.js");
         await runResultsClear();
         if (options.json) {
             console.log(formatJsonSuccess({ cleared: true }));
         }
         else {
-            console.log('Saved results cleared.');
+            console.log("Saved results cleared.");
         }
     }
     catch (err) {
@@ -199,17 +213,17 @@ resultsCmd
 });
 // ── config command ──────────────────────────────────────────────────
 const configCmd = program
-    .command('config')
-    .description('View and update preferences')
-    .option('--json', 'Output as JSON')
+    .command("config")
+    .description("View and update preferences")
+    .option("--json", "Output as JSON")
     .action(async (options) => {
     try {
-        const { runConfigShow, getConfigData } = await import('./commands/config.js');
+        const { runConfigShow, getConfigData } = await import("./commands/config.js");
         if (options.json) {
             console.log(formatJsonSuccess(getConfigData()));
         }
         else {
-            runConfigShow(options);
+            runConfigShow();
         }
     }
     catch (err) {
@@ -217,12 +231,12 @@ const configCmd = program
     }
 });
 configCmd
-    .command('set <key> <value>')
-    .description('Update a single preference (e.g. config set minStars 100)')
-    .option('--json', 'Output as JSON')
+    .command("set <key> <value>")
+    .description("Update a single preference (e.g. config set minStars 100)")
+    .option("--json", "Output as JSON")
     .action(async (key, value, options) => {
     try {
-        const { runConfigSet } = await import('./commands/config.js');
+        const { runConfigSet } = await import("./commands/config.js");
         const updated = runConfigSet(key, value);
         if (options.json) {
             console.log(formatJsonSuccess(updated));
@@ -236,18 +250,18 @@ configCmd
     }
 });
 configCmd
-    .command('reset')
-    .description('Reset all preferences to defaults')
-    .option('--json', 'Output as JSON')
+    .command("reset")
+    .description("Reset all preferences to defaults")
+    .option("--json", "Output as JSON")
     .action(async (options) => {
     try {
-        const { runConfigReset } = await import('./commands/config.js');
+        const { runConfigReset } = await import("./commands/config.js");
         const defaults = runConfigReset();
         if (options.json) {
             console.log(formatJsonSuccess(defaults));
         }
         else {
-            console.log('✅ Preferences reset to defaults.');
+            console.log("✅ Preferences reset to defaults.");
         }
     }
     catch (err) {
@@ -255,18 +269,19 @@ configCmd
     }
 });
 program
-    .command('vet-list')
-    .description('Re-vet all saved search results and classify their current status')
-    .option('--prune', 'Remove unavailable issues from saved results')
-    .option('--concurrency <n>', 'Max concurrent API requests (default: 5)', parseInt)
-    .option('--json', 'Output as JSON')
+    .command("vet-list")
+    .description("Re-vet all saved search results and classify their current status")
+    .option("--prune", "Remove unavailable issues from saved results")
+    .option("--concurrency <n>", "Max concurrent API requests (default: 5)", parseInt)
+    .option("--json", "Output as JSON")
     .action(async (options) => {
     try {
-        if (options.concurrency !== undefined && (isNaN(options.concurrency) || options.concurrency < 1)) {
-            console.error('Error: --concurrency must be a positive integer');
+        if (options.concurrency !== undefined &&
+            (isNaN(options.concurrency) || options.concurrency < 1)) {
+            console.error("Error: --concurrency must be a positive integer");
             process.exit(1);
         }
-        const { runVetList } = await import('./commands/vet-list.js');
+        const { runVetList } = await import("./commands/vet-list.js");
         const state = loadLocalState();
         const result = await runVetList({
             state,
@@ -278,16 +293,21 @@ program
         }
         else {
             if (result.results.length === 0) {
-                console.log('\nNo saved results to vet. Run `oss-scout search` first.\n');
+                console.log("\nNo saved results to vet. Run `oss-scout search` first.\n");
                 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.viabilityScore != null ? ` [${r.viabilityScore}/100]` : '';
+                const icon = r.status === "still_available"
+                    ? "✅"
+                    : r.status === "claimed"
+                        ? "🔒"
+                        : r.status === "has_pr"
+                            ? "🔀"
+                            : r.status === "closed"
+                                ? "🚫"
+                                : "❌";
+                const score = r.viabilityScore != null ? ` [${r.viabilityScore}/100]` : "";
                 console.log(`  ${icon} ${r.repo}#${r.number} — ${r.status}${score}`);
                 console.log(`     ${r.title}`);
             }
@@ -302,34 +322,145 @@ program
         handleCommandError(err, options);
     }
 });
+// ── skip command ───────────────────────────────────────────────────
+const skipCmd = program
+    .command("skip")
+    .description("Manage the skip list — exclude issues from future searches");
+skipCmd
+    .command("add <issue-url>")
+    .description("Skip an issue by URL")
+    .option("--json", "Output as JSON")
+    .action(async (issueUrl, options) => {
+    try {
+        const { runSkip } = await import("./commands/skip.js");
+        const state = loadLocalState();
+        const result = await runSkip({ issueUrl, state });
+        if (options.json) {
+            console.log(formatJsonSuccess(result));
+        }
+        else {
+            if (result.alreadySkipped) {
+                console.log("Issue already in skip list.");
+            }
+            else {
+                console.log(`Skipped: ${issueUrl}`);
+            }
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options);
+    }
+});
+skipCmd
+    .command("list")
+    .description("Show all skipped issues")
+    .option("--json", "Output as JSON")
+    .action(async (options) => {
+    try {
+        const { runSkipList } = await import("./commands/skip.js");
+        const results = runSkipList();
+        if (options.json) {
+            console.log(formatJsonSuccess(results));
+        }
+        else {
+            if (results.length === 0) {
+                console.log("\nNo skipped issues.\n");
+                return;
+            }
+            console.log(`\nSkipped issues (${results.length}):\n`);
+            console.log("  Repo                              Issue   Skipped     Title");
+            console.log("  ────────────────────────────────  ──────  ──────────  ─────");
+            for (const s of results) {
+                const repo = (s.repo || "unknown").padEnd(32).slice(0, 32);
+                const issue = s.number ? `#${s.number}`.padEnd(6) : "—".padEnd(6);
+                const skippedDate = s.skippedAt.split("T")[0] ?? "";
+                const title = s.title.length > 50
+                    ? s.title.slice(0, 47) + "..."
+                    : s.title || s.url;
+                console.log(`  ${repo}  ${issue}  ${skippedDate}  ${title}`);
+            }
+            console.log();
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options);
+    }
+});
+skipCmd
+    .command("remove <issue-url>")
+    .description("Remove an issue from the skip list (unskip)")
+    .option("--json", "Output as JSON")
+    .action(async (issueUrl, options) => {
+    try {
+        const { runSkipRemove } = await import("./commands/skip.js");
+        const result = await runSkipRemove({ issueUrl });
+        if (options.json) {
+            console.log(formatJsonSuccess(result));
+        }
+        else {
+            if (result.removed) {
+                console.log(`Removed from skip list: ${issueUrl}`);
+            }
+            else {
+                console.log("Issue was not in the skip list.");
+            }
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options);
+    }
+});
+skipCmd
+    .command("clear")
+    .description("Clear all skipped issues")
+    .option("--json", "Output as JSON")
+    .action(async (options) => {
+    try {
+        const { runSkipClear } = await import("./commands/skip.js");
+        await runSkipClear();
+        if (options.json) {
+            console.log(formatJsonSuccess({ cleared: true }));
+        }
+        else {
+            console.log("Skip list cleared.");
+        }
+    }
+    catch (err) {
+        handleCommandError(err, options);
+    }
+});
 program
-    .command('vet <issue-url>')
-    .description('Vet a specific GitHub issue for claimability and project health')
-    .option('--json', 'Output as JSON')
+    .command("vet <issue-url>")
+    .description("Vet a specific GitHub issue for claimability and project health")
+    .option("--json", "Output as JSON")
     .action(async (issueUrl, options) => {
     try {
-        const { runVet } = await import('./commands/vet.js');
+        const { runVet } = await import("./commands/vet.js");
         const state = loadLocalState();
         const result = await runVet({ issueUrl, state });
         if (options.json) {
             console.log(formatJsonSuccess(result));
         }
         else {
-            const icon = result.recommendation === 'approve' ? '✅' : result.recommendation === 'skip' ? '❌' : '⚠️';
+            const icon = result.recommendation === "approve"
+                ? "✅"
+                : result.recommendation === "skip"
+                    ? "❌"
+                    : "⚠️";
             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:');
+                console.log("Reasons to approve:");
                 for (const r of result.reasonsToApprove)
                     console.log(`  + ${r}`);
             }
             if (result.reasonsToSkip.length > 0) {
-                console.log('Reasons to skip:');
+                console.log("Reasons to skip:");
                 for (const r of result.reasonsToSkip)
                     console.log(`  - ${r}`);
             }
-            console.log(`\nProject health: ${result.projectHealth.isActive ? 'Active' : 'Inactive'}`);
+            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}`);
         }

package/dist/commands/config.d.ts

@@ -1,13 +1,11 @@
 /**
  * Config command — view and update oss-scout preferences.
  */
-import type { ScoutPreferences } from '../core/schemas.js';
+import type { ScoutPreferences } from "../core/schemas.js";
 /**
  * Display current preferences in human-readable format.
  */
-export declare function runConfigShow(options: {
-    json?: boolean;
-}): void;
+export declare function runConfigShow(): void;
 /**
  * Get current preferences for JSON output.
  */