@oss-autopilot/core 3.5.0 → 3.7.0

package/dist/cli-registry.js

@@ -284,6 +284,97 @@ export const commands = [
             });
         },
     },
+    // ── Features ───────────────────────────────────────────────────────────
+    // scout 0.9.0 (#97/#98/#99): feature-scoped opportunities in repos with
+    // 3+ merged PRs, split into quick-wins / bigger-bets buckets.
+    {
+        name: 'features',
+        register(program) {
+            program
+                .command('features [count]')
+                .description('Find feature-scoped opportunities in repos with 3+ merged PRs')
+                .option('--json', 'Output as JSON')
+                .option('--anchor-threshold <n>', 'Override featuresAnchorThreshold (1-50)')
+                .option('--split-ratio <r>', 'Override featuresSplitRatio (0-1)')
+                .action(async (count, options) => {
+                const { FeaturesOutputSchema } = await import('./formatters/json.js');
+                await executeAction(options, async () => {
+                    const { runFeatures, MAX_FEATURES_RESULTS } = await import('./commands/features.js');
+                    let maxResults = 10;
+                    if (count !== undefined) {
+                        const parsed = Number(count);
+                        if (!Number.isFinite(parsed) || parsed < 1 || !Number.isInteger(parsed)) {
+                            throw new Error(`Invalid count "${count}". Must be a positive integer.`);
+                        }
+                        maxResults = parsed;
+                    }
+                    if (maxResults > MAX_FEATURES_RESULTS) {
+                        console.warn(`Capping features to ${MAX_FEATURES_RESULTS} results (requested: ${maxResults})`);
+                        maxResults = MAX_FEATURES_RESULTS;
+                    }
+                    let anchorThreshold;
+                    if (options.anchorThreshold !== undefined) {
+                        const parsed = Number(options.anchorThreshold);
+                        if (!Number.isFinite(parsed) || !Number.isInteger(parsed) || parsed < 1 || parsed > 50) {
+                            throw new Error(`Invalid --anchor-threshold "${options.anchorThreshold}". Must be an integer in [1, 50].`);
+                        }
+                        anchorThreshold = parsed;
+                    }
+                    let splitRatio;
+                    if (options.splitRatio !== undefined) {
+                        const parsed = Number(options.splitRatio);
+                        if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
+                            throw new Error(`Invalid --split-ratio "${options.splitRatio}". Must be a number in [0, 1].`);
+                        }
+                        splitRatio = parsed;
+                    }
+                    if (!options.json) {
+                        console.log(`\nSearching for feature opportunities (max ${maxResults})...\n`);
+                    }
+                    return runFeatures({ maxResults, anchorThreshold, splitRatio });
+                }, (data) => {
+                    if (data.anchorRepos.length > 0) {
+                        console.log(`Anchor repos (${data.anchorRepos.length}): ${data.anchorRepos.join(', ')}`);
+                        console.log('');
+                    }
+                    if (data.quickWins.length === 0 && data.biggerBets.length === 0) {
+                        if (data.rateLimitWarning) {
+                            console.warn(`\n${data.rateLimitWarning}\n`);
+                        }
+                        else if (data.message) {
+                            console.log(data.message);
+                        }
+                        else {
+                            console.log('No feature opportunities found.');
+                        }
+                        return;
+                    }
+                    if (data.rateLimitWarning) {
+                        console.warn(`\n${data.rateLimitWarning}\n`);
+                    }
+                    const printBucket = (heading, candidates) => {
+                        if (candidates.length === 0)
+                            return;
+                        console.log(`${heading} (${candidates.length}):\n`);
+                        for (const candidate of candidates) {
+                            const { issue, recommendation, reasonsToApprove, reasonsToSkip, viabilityScore } = candidate;
+                            console.log(`[${recommendation.toUpperCase()}] ${issue.repo}#${issue.number}: ${issue.title}`);
+                            console.log(`  URL: ${issue.url}`);
+                            console.log(`  Viability: ${viabilityScore}/100`);
+                            if (reasonsToApprove.length > 0)
+                                console.log(`  Approve: ${reasonsToApprove.join(', ')}`);
+                            if (reasonsToSkip.length > 0)
+                                console.log(`  Skip: ${reasonsToSkip.join(', ')}`);
+                            console.log('---');
+                        }
+                        console.log('');
+                    };
+                    printBucket('Quick wins', data.quickWins);
+                    printBucket('Bigger bets', data.biggerBets);
+                }, FeaturesOutputSchema);
+            });
+        },
+    },
     // ── Vet ────────────────────────────────────────────────────────────────
     {
         name: 'vet',
@@ -329,6 +420,7 @@ export const commands = [
                 console.log(`  Claimed:         ${data.summary.claimed}`);
                 console.log(`  Closed:          ${data.summary.closed}`);
                 console.log(`  Has PR:          ${data.summary.hasPR}`);
+                console.log(`  Stalled PR:      ${data.summary.hasStalledPR}`);
                 console.log(`  Errors:          ${data.summary.errors}`);
                 console.log('');
                 for (const result of data.results) {
@@ -337,7 +429,8 @@ export const commands = [
                         : result.listStatus === 'error'
                             ? '\u274c'
                             : '\u26a0\ufe0f';
-                    console.log(`${status} [${result.listStatus}] ${result.issue.repo}#${result.issue.number}: ${result.issue.title}`);
+                    const annotation = result.listStatus === 'has_stalled_pr' ? ' (stalled PR, revive opportunity)' : '';
+                    console.log(`${status} [${result.listStatus}] ${result.issue.repo}#${result.issue.number}: ${result.issue.title}${annotation}`);
                     if (result.errorMessage) {
                         console.log(`   Error: ${result.errorMessage}`);
                     }
@@ -411,6 +504,55 @@ export const commands = [
             });
         },
     },
+    // ── List Mark Done ─────────────────────────────────────────────────────
+    {
+        name: 'list-mark-done',
+        localOnly: true,
+        register(program) {
+            program
+                .command('list-mark-done <issue-url>')
+                .description('Mark an issue line in a curated list as done with strikethrough + Done sub-bullet (#1299)')
+                .requiredOption('--pr-url <url>', 'PR URL to record on the Done sub-bullet')
+                .requiredOption('--pr-status <text>', 'Trailing status, e.g. "merged" or "CI passing"')
+                .requiredOption('--list-path <file>', 'Path to the markdown issue list')
+                .option('--json', 'Output as JSON')
+                .action(async (issueUrl, options) => {
+                const { ListMarkDoneOutputSchema } = await import('./formatters/json.js');
+                await executeAction(options, async () => {
+                    const result = await (await import('./commands/list-mark-done.js')).runMarkIssueListItemDone({
+                        issueUrl,
+                        prUrl: options.prUrl,
+                        prStatus: options.prStatus,
+                        listPath: options.listPath,
+                    });
+                    // Convert "URL not in list" into a real CLI error so the JSON
+                    // envelope reports `success: false` and the process exits non-zero.
+                    // The pure transform's success-shaped not-found return is fine for
+                    // library consumers, but as a CLI command "I asked you to mark X
+                    // and you couldn't find X" is a failure the caller must see.
+                    // The "already marked done" case stays as a success-shape return
+                    // (it's idempotent — the caller's intent was achieved).
+                    if (!result.marked && result.reason === 'issue URL not found in the list') {
+                        throw new Error(`Issue URL not found in ${result.filePath}: ${result.url}. ` +
+                            `Verify --list-path and the issue URL.`);
+                    }
+                    return result;
+                }, (data) => {
+                    if (data.marked) {
+                        const headingNote = data.repoHeadingStruck ? ' (repo heading also struck)' : '';
+                        console.log(`Marked ${data.url} done${headingNote}`);
+                        console.log(`  File: ${data.filePath}`);
+                        console.log(`  Remaining under repo: ${data.remainingUnderRepo}`);
+                    }
+                    else {
+                        // Reach here only on the idempotent "already marked done" path.
+                        console.log(`No mark: ${data.url} — ${data.reason ?? 'unchanged'}`);
+                        console.log(`  File: ${data.filePath}`);
+                    }
+                }, ListMarkDoneOutputSchema);
+            });
+        },
+    },
     // ── Track ──────────────────────────────────────────────────────────────
     {
         name: 'track',