@oss-scout/core 0.2.0 → 0.3.0

package/dist/commands/config.js

@@ -1,41 +1,36 @@
 /**
  * Config command — view and update oss-scout preferences.
  */
-import { loadLocalState, saveLocalState } from '../core/local-state.js';
-import { ScoutPreferencesSchema, IssueScopeSchema, ProjectCategorySchema, PersistenceModeSchema } from '../core/schemas.js';
-import { ValidationError } from '../core/errors.js';
-/** All known preference keys and their types. */
-const ARRAY_FIELDS = new Set([
-    'languages',
-    'labels',
-    'preferredOrgs',
-    'projectCategories',
-    'excludeRepos',
-    'excludeOrgs',
-    'aiPolicyBlocklist',
-]);
-const NUMBER_FIELDS = new Set(['minStars', 'maxIssueAgeDays', 'minRepoScoreThreshold']);
-const BOOLEAN_FIELDS = new Set(['includeDocIssues']);
-const STRING_FIELDS = new Set(['githubUsername']);
-const SCOPE_FIELD = 'scope';
-const ENUM_FIELDS = {
-    persistence: PersistenceModeSchema.options,
+import { loadLocalState, saveLocalState } from "../core/local-state.js";
+import { ScoutPreferencesSchema, IssueScopeSchema, ProjectCategorySchema, PersistenceModeSchema, SearchStrategySchema, } from "../core/schemas.js";
+import { ValidationError } from "../core/errors.js";
+const FIELD_CONFIGS = {
+    languages: { type: "array" },
+    labels: { type: "array" },
+    excludeRepos: { type: "array" },
+    excludeOrgs: { type: "array" },
+    aiPolicyBlocklist: { type: "array" },
+    minStars: { type: "number" },
+    maxIssueAgeDays: { type: "number" },
+    minRepoScoreThreshold: { type: "number" },
+    includeDocIssues: { type: "boolean" },
+    scope: { type: "enum-array", validValues: IssueScopeSchema.options },
+    projectCategories: {
+        type: "enum-array",
+        validValues: ProjectCategorySchema.options,
+    },
+    persistence: { type: "enum", validValues: PersistenceModeSchema.options },
+    defaultStrategy: {
+        type: "enum-array",
+        validValues: SearchStrategySchema.options,
+    },
+    githubUsername: { type: "string" },
 };
-const ALL_FIELDS = new Set([
-    ...ARRAY_FIELDS,
-    ...NUMBER_FIELDS,
-    ...BOOLEAN_FIELDS,
-    ...STRING_FIELDS,
-    ...Object.keys(ENUM_FIELDS),
-    SCOPE_FIELD,
-]);
-const VALID_SCOPES = IssueScopeSchema.options;
-const VALID_CATEGORIES = ProjectCategorySchema.options;
 function parseBoolean(value) {
     const lower = value.toLowerCase();
-    if (lower === 'true' || lower === 'yes')
+    if (lower === "true" || lower === "yes")
         return true;
-    if (lower === 'false' || lower === 'no')
+    if (lower === "false" || lower === "no")
         return false;
     throw new ValidationError(`Invalid boolean value: "${value}". Use true/false or yes/no.`);
 }
@@ -48,7 +43,7 @@ function parseNumber(value, key) {
 }
 function parseArrayValue(value) {
     return value
-        .split(',')
+        .split(",")
         .map((s) => s.trim())
         .filter((s) => s.length > 0);
 }
@@ -56,7 +51,7 @@ function parseArrayValue(value) {
  * Apply an array update: plain set, +append, or -remove.
  */
 function updateArray(current, value) {
-    if (value.startsWith('+')) {
+    if (value.startsWith("+")) {
         const toAdd = parseArrayValue(value.slice(1));
         const merged = [...current];
         for (const item of toAdd) {
@@ -65,39 +60,35 @@ function updateArray(current, value) {
         }
         return merged;
     }
-    if (value.startsWith('-')) {
+    if (value.startsWith("-")) {
         const toRemove = new Set(parseArrayValue(value.slice(1)));
         return current.filter((item) => !toRemove.has(item));
     }
     return parseArrayValue(value);
 }
 function formatArray(arr) {
-    return arr.length > 0 ? arr.join(', ') : '(none)';
+    return arr.length > 0 ? arr.join(", ") : "(none)";
 }
 /**
  * Display current preferences in human-readable format.
  */
-export function runConfigShow(options) {
+export function runConfigShow() {
     const state = loadLocalState();
     const prefs = state.preferences;
-    if (options.json) {
-        // JSON output handled by caller
-        return;
-    }
-    console.log('\n⚙️  oss-scout preferences\n');
-    console.log(`  githubUsername:        ${prefs.githubUsername || '(not set)'}`);
+    console.log("\n⚙️  oss-scout preferences\n");
+    console.log(`  githubUsername:        ${prefs.githubUsername || "(not set)"}`);
     console.log(`  languages:            ${formatArray(prefs.languages)}`);
     console.log(`  labels:               ${formatArray(prefs.labels)}`);
-    console.log(`  scope:                ${prefs.scope ? formatArray(prefs.scope) : '(all)'}`);
+    console.log(`  scope:                ${prefs.scope ? formatArray(prefs.scope) : "(all)"}`);
     console.log(`  minStars:             ${prefs.minStars}`);
     console.log(`  maxIssueAgeDays:      ${prefs.maxIssueAgeDays}`);
     console.log(`  minRepoScoreThreshold: ${prefs.minRepoScoreThreshold}`);
     console.log(`  includeDocIssues:     ${prefs.includeDocIssues}`);
-    console.log(`  preferredOrgs:        ${formatArray(prefs.preferredOrgs)}`);
     console.log(`  projectCategories:    ${formatArray(prefs.projectCategories)}`);
     console.log(`  excludeRepos:         ${formatArray(prefs.excludeRepos)}`);
     console.log(`  excludeOrgs:          ${formatArray(prefs.excludeOrgs)}`);
     console.log(`  aiPolicyBlocklist:    ${formatArray(prefs.aiPolicyBlocklist)}`);
+    console.log(`  defaultStrategy:      ${prefs.defaultStrategy ? formatArray(prefs.defaultStrategy) : "(all)"}`);
     console.log(`  persistence:          ${prefs.persistence}`);
     console.log();
 }
@@ -112,46 +103,53 @@ export function getConfigData() {
  * Update a single preference by key.
  */
 export function runConfigSet(key, value) {
-    if (!ALL_FIELDS.has(key)) {
-        throw new ValidationError(`Unknown config key: "${key}". Valid keys: ${[...ALL_FIELDS].sort().join(', ')}`);
+    const field = FIELD_CONFIGS[key];
+    if (!field) {
+        throw new ValidationError(`Unknown config key: "${key}". Valid keys: ${Object.keys(FIELD_CONFIGS).sort().join(", ")}`);
     }
     const state = loadLocalState();
     const prefs = { ...state.preferences };
-    if (STRING_FIELDS.has(key)) {
-        prefs[key] = value;
-    }
-    else if (BOOLEAN_FIELDS.has(key)) {
-        prefs[key] = parseBoolean(value);
-    }
-    else if (NUMBER_FIELDS.has(key)) {
-        prefs[key] = parseNumber(value, key);
-    }
-    else if (key === SCOPE_FIELD) {
-        const updated = updateArray(prefs.scope ?? [], value);
-        const invalid = updated.filter((s) => !VALID_SCOPES.includes(s));
-        if (invalid.length > 0) {
-            throw new ValidationError(`Invalid scope value(s): ${invalid.join(', ')}. Valid: ${VALID_SCOPES.join(', ')}`);
+    switch (field.type) {
+        case "string":
+            prefs[key] = value;
+            break;
+        case "boolean":
+            prefs[key] = parseBoolean(value);
+            break;
+        case "number":
+            prefs[key] = parseNumber(value, key);
+            break;
+        case "array": {
+            const current = prefs[key] ?? [];
+            prefs[key] = updateArray(current, value);
+            break;
         }
-        prefs.scope = updated.length > 0 ? updated : undefined;
-    }
-    else if (key === 'projectCategories') {
-        const updated = updateArray(prefs.projectCategories, value);
-        const invalid = updated.filter((s) => !VALID_CATEGORIES.includes(s));
-        if (invalid.length > 0) {
-            throw new ValidationError(`Invalid category value(s): ${invalid.join(', ')}. Valid: ${VALID_CATEGORIES.join(', ')}`);
+        case "enum": {
+            const validValues = field.validValues;
+            if (!validValues.includes(value)) {
+                throw new ValidationError(`Invalid value for "${key}": "${value}". Valid: ${validValues.join(", ")}`);
+            }
+            prefs[key] = value;
+            break;
         }
-        prefs.projectCategories = updated;
-    }
-    else if (key in ENUM_FIELDS) {
-        const validValues = ENUM_FIELDS[key];
-        if (!validValues.includes(value)) {
-            throw new ValidationError(`Invalid value for "${key}": "${value}". Valid: ${validValues.join(', ')}`);
+        case "enum-array": {
+            const current = prefs[key] ?? [];
+            const updated = updateArray(current, value);
+            const validValues = field.validValues;
+            const invalid = updated.filter((s) => !validValues.includes(s));
+            if (invalid.length > 0) {
+                throw new ValidationError(`Invalid value(s) for "${key}": ${invalid.join(", ")}. Valid: ${validValues.join(", ")}`);
+            }
+            // For 'scope', empty array means undefined (all scopes)
+            if (key === "scope") {
+                prefs[key] =
+                    updated.length > 0 ? updated : undefined;
+            }
+            else {
+                prefs[key] = updated;
+            }
+            break;
         }
-        prefs[key] = value;
-    }
-    else if (ARRAY_FIELDS.has(key)) {
-        const current = prefs[key] ?? [];
-        prefs[key] = updateArray(current, value);
     }
     // Validate the full preferences object
     const validated = ScoutPreferencesSchema.parse(prefs);

package/dist/commands/results.d.ts

@@ -1,7 +1,7 @@
 /**
  * Results command — display and manage saved search results.
  */
-import type { SavedCandidate } from '../core/schemas.js';
+import type { SavedCandidate } from "../core/schemas.js";
 export declare function runResults(_options: {
     json?: boolean;
 }): Promise<SavedCandidate[]>;

package/dist/commands/results.js

@@ -1,7 +1,7 @@
 /**
  * Results command — display and manage saved search results.
  */
-import { loadLocalState, saveLocalState } from '../core/local-state.js';
+import { loadLocalState, saveLocalState } from "../core/local-state.js";
 export async function runResults(_options) {
     const state = loadLocalState();
     return state.savedResults ?? [];

package/dist/commands/search.d.ts

@@ -1,7 +1,7 @@
 /**
  * Search command — finds contributable issues using multi-strategy search.
  */
-import type { ScoutState, SearchStrategy } from '../core/schemas.js';
+import type { ScoutState, SearchStrategy } from "../core/schemas.js";
 export interface SearchOutput {
     candidates: Array<{
         issue: {
@@ -12,7 +12,7 @@ export interface SearchOutput {
             url: string;
             labels: string[];
         };
-        recommendation: 'approve' | 'skip' | 'needs_review';
+        recommendation: "approve" | "skip" | "needs_review";
         reasonsToApprove: string[];
         reasonsToSkip: string[];
         searchPriority: string;

package/dist/commands/search.js

@@ -1,19 +1,29 @@
 /**
  * Search command — finds contributable issues using multi-strategy search.
  */
-import { createScout } from '../scout.js';
-import { requireGitHubToken } from '../core/utils.js';
-import { saveLocalState } from '../core/local-state.js';
+import { createScout } from "../scout.js";
+import { requireGitHubToken } from "../core/utils.js";
+import { saveLocalState } from "../core/local-state.js";
 export async function runSearch(options) {
     const token = requireGitHubToken();
     const scout = options.state
-        ? await createScout({ githubToken: token, persistence: 'provided', initialState: options.state })
+        ? await createScout({
+            githubToken: token,
+            persistence: "provided",
+            initialState: options.state,
+        })
         : await createScout({ githubToken: token });
-    const result = await scout.search({ maxResults: options.maxResults, strategies: options.strategies });
+    const result = await scout.search({
+        maxResults: options.maxResults,
+        strategies: options.strategies,
+    });
     // Persist results to local state and gist
     scout.saveResults(result.candidates);
     saveLocalState(scout.getState());
-    await scout.checkpoint();
+    const persisted = await scout.checkpoint();
+    if (!persisted) {
+        console.error("Warning: changes saved locally but gist sync failed.");
+    }
     return {
         candidates: result.candidates.map((c) => {
             const repoScoreRecord = scout.getRepoScoreRecord(c.issue.repo);

package/dist/commands/setup.d.ts

@@ -1,7 +1,7 @@
 /**
  * Setup command — interactive first-run configuration for oss-scout.
  */
-import type { ScoutPreferences } from '../core/schemas.js';
+import type { ScoutPreferences } from "../core/schemas.js";
 interface ReadlineInterface {
     question(query: string, callback: (answer: string) => void): void;
     close(): void;

package/dist/commands/setup.js

@@ -1,9 +1,9 @@
 /**
  * Setup command — interactive first-run configuration for oss-scout.
  */
-import * as readline from 'readline';
-import { execFile } from 'child_process';
-import { ScoutPreferencesSchema, ProjectCategorySchema, IssueScopeSchema } from '../core/schemas.js';
+import * as readline from "readline";
+import { execFile } from "child_process";
+import { ScoutPreferencesSchema, ProjectCategorySchema, IssueScopeSchema, } from "../core/schemas.js";
 const ALL_CATEGORIES = ProjectCategorySchema.options;
 const ALL_SCOPES = IssueScopeSchema.options;
 function createReadlineInterface() {
@@ -19,9 +19,9 @@ function ask(rl, query) {
 }
 function detectGitHubUsername() {
     return new Promise((resolve) => {
-        execFile('gh', ['api', 'user', '--jq', '.login'], { timeout: 5000 }, (err, stdout) => {
+        execFile("gh", ["api", "user", "--jq", ".login"], { timeout: 5000 }, (err, stdout) => {
             if (err || !stdout.trim()) {
-                resolve('');
+                resolve("");
             }
             else {
                 resolve(stdout.trim());
@@ -31,7 +31,7 @@ function detectGitHubUsername() {
 }
 function parseCSV(input) {
     return input
-        .split(',')
+        .split(",")
         .map((s) => s.trim())
         .filter((s) => s.length > 0);
 }
@@ -48,40 +48,41 @@ export async function runSetup(options) {
     const rl = options?.rl ?? createReadlineInterface();
     const detect = options?.detectUsername ?? detectGitHubUsername;
     try {
-        console.log('\n🔧 oss-scout setup\n');
+        console.log("\n🔧 oss-scout setup\n");
         // Detect GitHub username
-        console.log('Detecting GitHub username...');
+        console.log("Detecting GitHub username...");
         const detectedUsername = await detect();
-        const usernameDefault = detectedUsername || '';
+        const usernameDefault = detectedUsername || "";
         const usernamePrompt = detectedUsername
             ? `GitHub username [${detectedUsername}]: `
-            : 'GitHub username: ';
+            : "GitHub username: ";
         const usernameInput = await ask(rl, usernamePrompt);
         const githubUsername = usernameInput || usernameDefault;
         // Languages
-        const defaultLangs = 'typescript, javascript';
-        const langsInput = await ask(rl, `Preferred languages [${defaultLangs}]: `);
-        const languages = langsInput ? parseCSV(langsInput) : ['typescript', 'javascript'];
+        const defaultLangs = "any (all languages)";
+        const langsInput = await ask(rl, `Preferred languages (comma-separated, or "any" for all) [${defaultLangs}]: `);
+        const languages = langsInput ? parseCSV(langsInput) : ["any"];
         // Issue labels
-        const defaultLabels = 'good first issue, help wanted';
+        const defaultLabels = "good first issue, help wanted";
         const labelsInput = await ask(rl, `Issue labels to search for [${defaultLabels}]: `);
-        const labels = labelsInput ? parseCSV(labelsInput) : ['good first issue', 'help wanted'];
+        const labels = labelsInput
+            ? parseCSV(labelsInput)
+            : ["good first issue", "help wanted"];
         // Difficulty scope
-        const scopeOptions = ALL_SCOPES.join(', ');
+        const scopeOptions = ALL_SCOPES.join(", ");
         const scopeInput = await ask(rl, `Difficulty scope (${scopeOptions}) [all]: `);
-        const scope = scopeInput ? parseMultiSelect(scopeInput, ALL_SCOPES) : [...ALL_SCOPES];
+        const scope = scopeInput
+            ? parseMultiSelect(scopeInput, ALL_SCOPES)
+            : [...ALL_SCOPES];
         // Minimum stars
-        const minStarsInput = await ask(rl, 'Minimum repo stars [50]: ');
+        const minStarsInput = await ask(rl, "Minimum repo stars [50]: ");
         const minStars = minStarsInput ? parseInt(minStarsInput, 10) : 50;
-        // Preferred organizations
-        const orgsInput = await ask(rl, 'Preferred organizations (comma-separated, optional): ');
-        const preferredOrgs = parseCSV(orgsInput);
         // Project categories
-        const categoryOptions = ALL_CATEGORIES.join(', ');
+        const categoryOptions = ALL_CATEGORIES.join(", ");
         const categoriesInput = await ask(rl, `Project categories (${categoryOptions}) [none]: `);
         const projectCategories = parseMultiSelect(categoriesInput, ALL_CATEGORIES);
         // Repos to exclude
-        const excludeInput = await ask(rl, 'Repos to exclude (owner/repo, comma-separated, optional): ');
+        const excludeInput = await ask(rl, "Repos to exclude (owner/repo, comma-separated, optional): ");
         const excludeRepos = parseCSV(excludeInput);
         const prefs = ScoutPreferencesSchema.parse({
             githubUsername,
@@ -89,11 +90,10 @@ export async function runSetup(options) {
             labels,
             scope: scope.length > 0 ? scope : undefined,
             excludeRepos,
-            preferredOrgs,
             projectCategories,
             minStars: isNaN(minStars) ? 50 : minStars,
         });
-        console.log('\n✅ Setup complete! Preferences saved.\n');
+        console.log("\n✅ Setup complete! Preferences saved.\n");
         return prefs;
     }
     finally {

package/dist/commands/skip.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Skip command — manage the skip list for excluding issues from future searches.
+ */
+import type { SkippedIssue, ScoutState } from "../core/schemas.js";
+/**
+ * Skip an issue by URL — adds it to the skip list and removes it from saved results.
+ * Tries to enrich metadata from saved results if available.
+ */
+export declare function runSkip(options: {
+    issueUrl: string;
+    state?: ScoutState;
+}): Promise<{
+    skipped: boolean;
+    alreadySkipped: boolean;
+}>;
+/**
+ * List all skipped issues.
+ */
+export declare function runSkipList(options?: {
+    state?: ScoutState;
+}): SkippedIssue[];
+/**
+ * Clear all skipped issues.
+ */
+export declare function runSkipClear(): Promise<void>;
+/**
+ * Remove a specific issue from the skip list (unskip).
+ */
+export declare function runSkipRemove(options: {
+    issueUrl: string;
+}): Promise<{
+    removed: boolean;
+}>;

package/dist/commands/skip.js

@@ -0,0 +1,89 @@
+/**
+ * Skip command — manage the skip list for excluding issues from future searches.
+ */
+import { loadLocalState, saveLocalState } from "../core/local-state.js";
+import { createScout } from "../scout.js";
+import { getGitHubToken } from "../core/utils.js";
+/**
+ * Create an OssScout instance for skip operations.
+ * Uses gist persistence when a token is available, otherwise provided-state mode.
+ */
+async function createSkipScout(state) {
+    const token = getGitHubToken() ?? "";
+    if (token) {
+        return createScout({
+            githubToken: token,
+            persistence: "provided",
+            initialState: state,
+        });
+    }
+    return createScout({
+        githubToken: "",
+        persistence: "provided",
+        initialState: state,
+    });
+}
+/**
+ * Skip an issue by URL — adds it to the skip list and removes it from saved results.
+ * Tries to enrich metadata from saved results if available.
+ */
+export async function runSkip(options) {
+    const state = options.state ?? loadLocalState();
+    const scout = await createSkipScout(state);
+    const alreadySkipped = scout
+        .getSkippedIssues()
+        .some((s) => s.url === options.issueUrl);
+    if (alreadySkipped) {
+        return { skipped: false, alreadySkipped: true };
+    }
+    // Try to enrich metadata from saved results
+    const saved = scout
+        .getSavedResults()
+        .find((r) => r.issueUrl === options.issueUrl);
+    const metadata = saved
+        ? { repo: saved.repo, number: saved.number, title: saved.title }
+        : parseIssueUrl(options.issueUrl);
+    scout.skipIssue(options.issueUrl, metadata);
+    saveLocalState(scout.getState());
+    await scout.checkpoint();
+    return { skipped: true, alreadySkipped: false };
+}
+/**
+ * List all skipped issues.
+ */
+export function runSkipList(options) {
+    const state = options?.state ?? loadLocalState();
+    return state.skippedIssues ?? [];
+}
+/**
+ * Clear all skipped issues.
+ */
+export async function runSkipClear() {
+    const state = loadLocalState();
+    const scout = await createSkipScout(state);
+    scout.clearSkippedIssues();
+    saveLocalState(scout.getState());
+    await scout.checkpoint();
+}
+/**
+ * Remove a specific issue from the skip list (unskip).
+ */
+export async function runSkipRemove(options) {
+    const state = loadLocalState();
+    const scout = await createSkipScout(state);
+    const before = scout.getSkippedIssues().length;
+    scout.unskipIssue(options.issueUrl);
+    const removed = before !== scout.getSkippedIssues().length;
+    saveLocalState(scout.getState());
+    await scout.checkpoint();
+    return { removed };
+}
+/**
+ * Parse a GitHub issue URL to extract repo and number.
+ */
+function parseIssueUrl(url) {
+    const match = url.match(/github\.com\/([^/]+\/[^/]+)\/issues\/(\d+)/);
+    if (!match)
+        return undefined;
+    return { repo: match[1], number: parseInt(match[2], 10), title: "" };
+}

package/dist/commands/validation.d.ts

@@ -2,5 +2,5 @@
  * Shared validation patterns and helpers for CLI commands.
  */
 export declare const ISSUE_URL_PATTERN: RegExp;
-export declare function validateGitHubUrl(url: string, pattern: RegExp, entityType: 'issue'): void;
+export declare function validateGitHubUrl(url: string, pattern: RegExp, entityType: "issue"): void;
 export declare function validateUrl(url: string): string;

package/dist/commands/validation.js

@@ -1,7 +1,7 @@
 /**
  * Shared validation patterns and helpers for CLI commands.
  */
-import { ValidationError } from '../core/errors.js';
+import { ValidationError } from "../core/errors.js";
 export const ISSUE_URL_PATTERN = /^https:\/\/github\.com\/[^/]+\/[^/]+\/issues\/\d+$/;
 const MAX_URL_LENGTH = 2048;
 export function validateGitHubUrl(url, pattern, entityType) {

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

@@ -1,5 +1,5 @@
-import type { ScoutState } from '../core/schemas.js';
-import type { VetListResult } from '../core/types.js';
+import type { ScoutState } from "../core/schemas.js";
+import type { VetListResult } from "../core/types.js";
 interface VetListCommandOptions {
     concurrency?: number;
     prune?: boolean;

package/dist/commands/vet-list.js

@@ -1,16 +1,23 @@
-import { createScout } from '../scout.js';
-import { requireGitHubToken } from '../core/utils.js';
-import { saveLocalState } from '../core/local-state.js';
+import { createScout } from "../scout.js";
+import { requireGitHubToken } from "../core/utils.js";
+import { saveLocalState } from "../core/local-state.js";
 export async function runVetList(options) {
     const token = requireGitHubToken();
     const scout = options.state
-        ? await createScout({ githubToken: token, persistence: 'provided', initialState: options.state })
+        ? await createScout({
+            githubToken: token,
+            persistence: "provided",
+            initialState: options.state,
+        })
         : await createScout({ githubToken: token });
     const result = await scout.vetList({
         concurrency: options.concurrency,
         prune: options.prune,
     });
     saveLocalState(scout.getState());
-    await scout.checkpoint();
+    const persisted = await scout.checkpoint();
+    if (!persisted) {
+        console.error("Warning: changes saved locally but gist sync failed.");
+    }
     return result;
 }

package/dist/commands/vet.d.ts

@@ -1,8 +1,8 @@
 /**
  * Vet command — vets a specific issue for claimability.
  */
-import type { ProjectHealth } from '../core/types.js';
-import type { IssueVettingResult, ScoutState } from '../core/schemas.js';
+import type { ProjectHealth } from "../core/types.js";
+import type { IssueVettingResult, ScoutState } from "../core/schemas.js";
 export interface VetOutput {
     issue: {
         repo: string;
@@ -11,7 +11,7 @@ export interface VetOutput {
         url: string;
         labels: string[];
     };
-    recommendation: 'approve' | 'skip' | 'needs_review';
+    recommendation: "approve" | "skip" | "needs_review";
     reasonsToApprove: string[];
     reasonsToSkip: string[];
     projectHealth: ProjectHealth;

package/dist/commands/vet.js

@@ -1,15 +1,19 @@
 /**
  * Vet command — vets a specific issue for claimability.
  */
-import { createScout } from '../scout.js';
-import { requireGitHubToken } from '../core/utils.js';
-import { ISSUE_URL_PATTERN, validateGitHubUrl, validateUrl } from './validation.js';
+import { createScout } from "../scout.js";
+import { requireGitHubToken } from "../core/utils.js";
+import { ISSUE_URL_PATTERN, validateGitHubUrl, validateUrl, } from "./validation.js";
 export async function runVet(options) {
     validateUrl(options.issueUrl);
-    validateGitHubUrl(options.issueUrl, ISSUE_URL_PATTERN, 'issue');
+    validateGitHubUrl(options.issueUrl, ISSUE_URL_PATTERN, "issue");
     const token = requireGitHubToken();
     const scout = options.state
-        ? await createScout({ githubToken: token, persistence: 'provided', initialState: options.state })
+        ? await createScout({
+            githubToken: token,
+            persistence: "provided",
+            initialState: options.state,
+        })
         : await createScout({ githubToken: token });
     const candidate = await scout.vetIssue(options.issueUrl);
     return {

package/dist/core/bootstrap.d.ts

@@ -2,7 +2,7 @@
  * First-run bootstrap — fetches starred repos and PR history from GitHub
  * to seed the scout's state with the user's contribution context.
  */
-import type { OssScout } from '../scout.js';
+import type { OssScout } from "../scout.js";
 export interface BootstrapResult {
     starredRepoCount: number;
     mergedPRCount: number;