@oss-autopilot/core 3.1.0 → 3.3.0

package/dist/cli-registry.js

@@ -69,6 +69,36 @@ function printRepos(repos) {
     }
 }
 export const commands = [
+    // ── Manifest (#1190) ───────────────────────────────────────────────────
+    // Lets the plugin's session-start hook verify CLI/plugin contract drift —
+    // it diffs the registered commands against `.claude-plugin/expected-cli-contract.json`
+    // and warns when the markdown layer references commands the CLI no longer
+    // exposes. Local-only: no GitHub access needed.
+    {
+        name: 'manifest',
+        localOnly: true,
+        register(program) {
+            program
+                .command('manifest')
+                .description('Print the CLI contract (registered commands + version) for plugin/MCP introspection (#1190)')
+                .option('--json', 'Output as JSON')
+                .action(async (options) => {
+                const { ManifestOutputSchema } = await import('./formatters/json.js');
+                await executeAction(options, async () => {
+                    const { getCLIVersion } = await import('./core/index.js');
+                    return {
+                        schemaVersion: 1,
+                        cliVersion: getCLIVersion(),
+                        commands: commands
+                            .map((c) => ({ name: c.name, localOnly: !!c.localOnly }))
+                            .sort((a, b) => a.name.localeCompare(b.name)),
+                    };
+                }, (data) => {
+                    console.log(`oss-autopilot v${data.cliVersion} (${data.commands.length} commands)`);
+                }, ManifestOutputSchema);
+            });
+        },
+    },
     // ── Daily ──────────────────────────────────────────────────────────────
     {
         name: 'daily',
@@ -473,7 +503,7 @@ export const commands = [
                         for await (const chunk of process.stdin) {
                             chunks.push(chunk);
                         }
-                        message = Buffer.concat(chunks).toString('utf-8').trim();
+                        message = Buffer.concat(chunks).toString('utf8').trim();
                     }
                     else {
                         message = messageParts.join(' ');
@@ -663,7 +693,7 @@ export const commands = [
                 .action(async (options) => {
                 try {
                     const port = parseInt(options.port, 10);
-                    if (isNaN(port) || port < 1 || port > 65535) {
+                    if (isNaN(port) || port < 1 || port > 65_535) {
                         console.error(`Invalid port number: "${options.port}". Must be an integer between 1 and 65535.`);
                         process.exit(1);
                     }
@@ -688,7 +718,7 @@ export const commands = [
                 .action(async (filePath, options) => {
                 const { ParseIssueListOutputSchema } = await import('./formatters/json.js');
                 await executeAction(options, async () => (await import('./commands/parse-list.js')).runParseList({ filePath }), async (data) => {
-                    const path = await import('path');
+                    const path = await import('node:path');
                     const resolvedPath = path.resolve(filePath);
                     console.log(`\n\ud83d\udccb Issue List: ${resolvedPath}\n`);
                     console.log(`Available: ${data.availableCount} | Completed: ${data.completedCount}\n`);
@@ -1090,4 +1120,84 @@ export const commands = [
             });
         },
     },
+    // ── Guidelines (#867) ──────────────────────────────────────────────────
+    {
+        name: 'guidelines',
+        register(program) {
+            const group = program
+                .command('guidelines')
+                .description('Manage per-repo learning guidelines extracted from PR feedback (#867)');
+            group
+                .command('view')
+                .description('Read the per-repo guidelines file (returns null when none exists or in local mode)')
+                .requiredOption('--repo <owner/repo>', 'Repository identifier')
+                .option('--json', 'Output as JSON')
+                .action(async (options) => {
+                await executeAction(options, async () => (await import('./commands/guidelines.js')).runGuidelinesView({ repo: options.repo }), (data) => {
+                    if (data.content === null) {
+                        console.log(`No guidelines stored for ${data.repo} (storage: ${data.storageMode}).`);
+                    }
+                    else {
+                        console.log(`# Guidelines for ${data.repo} (${data.byteSize} bytes)\n`);
+                        console.log(data.content);
+                    }
+                });
+            });
+            group
+                .command('store')
+                .description('Persist per-repo guidelines (overwrites). Reads markdown content from --content or stdin.')
+                .requiredOption('--repo <owner/repo>', 'Repository identifier')
+                .option('--content <markdown>', 'Markdown content. If omitted, reads from stdin.')
+                .option('--json', 'Output as JSON')
+                .action(async (options) => {
+                await executeAction(options, async () => {
+                    const content = options.content ?? (await readStdin());
+                    return (await import('./commands/guidelines.js')).runGuidelinesStore({ repo: options.repo, content });
+                }, (data) => {
+                    console.log(`Stored ${data.byteSize} bytes of guidelines for ${data.repo}.`);
+                });
+            });
+            group
+                .command('reset')
+                .description('Tombstone the guidelines file for a repo (subsequent reads return null)')
+                .requiredOption('--repo <owner/repo>', 'Repository identifier')
+                .option('--json', 'Output as JSON')
+                .action(async (options) => {
+                await executeAction(options, async () => (await import('./commands/guidelines.js')).runGuidelinesReset({ repo: options.repo }), (data) => {
+                    console.log(data.deleted
+                        ? `Reset guidelines for ${data.repo}.`
+                        : `No guidelines existed for ${data.repo}; nothing to reset.`);
+                });
+            });
+            group
+                .command('fetch-corpus')
+                .description('Fetch raw PR comment bundles for the host extract-learnings prompt to consume')
+                .requiredOption('--repo <owner/repo>', 'Repository identifier')
+                .option('--limit <n>', 'Max PRs to process (1-10, default 5)', (v) => parseInt(v, 10))
+                .option('--force', 'Re-fetch even when commentsFetchedAt is already set')
+                .option('--json', 'Output as JSON')
+                .action(async (options) => {
+                await executeAction(options, async () => (await import('./commands/guidelines.js')).runFetchCorpus({
+                    repo: options.repo,
+                    limit: options.limit,
+                    forceRefetch: options.force,
+                }), (data) => {
+                    console.log(`Fetched ${data.prCount} PR comment bundle(s) for ${data.repo}.`);
+                    if (data.skipped > 0) {
+                        console.log(`  Skipped ${data.skipped} PR(s) already processed (use --force to re-fetch).`);
+                    }
+                });
+            });
+        },
+    },
 ];
+/** Read full stdin content. Used when `guidelines store` content isn't passed inline. */
+async function readStdin() {
+    if (process.stdin.isTTY) {
+        throw new Error('No --content provided and stdin is a TTY. Pipe content or pass --content "...".');
+    }
+    let data = '';
+    for await (const chunk of process.stdin)
+        data += chunk;
+    return data;
+}