skrypt-ai 0.8.0 → 0.8.1

package/dist/cli.js

@@ -1,32 +1,5 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import { generateCommand } from './commands/generate/index.js';
-import { initCommand } from './commands/init.js';
-import { watchCommand } from './commands/watch.js';
-import { autofixCommand } from './commands/autofix.js';
-import { reviewPRCommand } from './commands/review-pr.js';
-import { lintCommand } from './commands/lint.js';
-import { qaCommand } from './commands/qa.js';
-import { checkLinksCommand } from './commands/check-links.js';
-import { mcpCommand } from './commands/mcp.js';
-import { versionCommand } from './commands/version.js';
-import { i18nCommand } from './commands/i18n.js';
-import { monitorCommand } from './commands/monitor.js';
-import { sdkCommand } from './commands/sdk.js';
-import { ghActionCommand } from './commands/gh-action.js';
-import { llmsTxtCommand } from './commands/llms-txt.js';
-import { loginCommand, logoutCommand, whoamiCommand } from './commands/login.js';
-import { cronCommand } from './commands/cron.js';
-import { deployCommand } from './commands/deploy.js';
-import { testCommand } from './commands/test.js';
-import { securityCommand } from './commands/security.js';
-import { importCommand } from './commands/import.js';
-import { healCommand } from './commands/heal.js';
-import { auditCommand } from './commands/audit.js';
-import { refreshCommand } from './commands/refresh.js';
-import { reviewCommand } from './commands/review.js';
-import { configCommand } from './commands/config.js';
-import { handlePostAction } from './next-actions/index.js';
 import { createRequire } from 'module';
 process.on('uncaughtException', (err) => {
     console.error('\x1b[31mFatal error:\x1b[0m', err.message);
@@ -42,6 +15,24 @@ process.on('unhandledRejection', (reason) => {
 });
 const require = createRequire(import.meta.url);
 const { version: VERSION } = require('../package.json');
+/** Lazily initialize Sentry — called once on first real command invocation */
+let sentryInitialized = false;
+async function ensureSentry() {
+    if (sentryInitialized)
+        return;
+    sentryInitialized = true;
+    const { initSentry } = await import('./sentry.js');
+    initSentry();
+}
+/**
+ * Extract the action handler from a Commander Command instance.
+ * Commander stores it as `_actionHandler` (not in public types).
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function getAction(cmd) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return cmd._actionHandler;
+}
 function semverNewer(latest, current) {
     const parse = (v) => v.split('.').map(Number);
     const [lMaj, lMin, lPatch] = parse(latest);
@@ -76,35 +67,504 @@ program
     .description('AI-powered documentation generator with code examples')
     .version(VERSION)
     .hook('postAction', async (_thisCommand, actionCommand) => {
+    const { handlePostAction } = await import('./next-actions/index.js');
     await handlePostAction(actionCommand.name());
     await checkForUpdates();
 });
-program.addCommand(initCommand);
-program.addCommand(generateCommand);
-program.addCommand(watchCommand);
-program.addCommand(autofixCommand);
-program.addCommand(reviewPRCommand);
-program.addCommand(lintCommand);
-program.addCommand(qaCommand);
-program.addCommand(checkLinksCommand);
-program.addCommand(mcpCommand);
-program.addCommand(versionCommand);
-program.addCommand(i18nCommand);
-program.addCommand(monitorCommand);
-program.addCommand(sdkCommand);
-program.addCommand(ghActionCommand);
-program.addCommand(llmsTxtCommand);
-program.addCommand(loginCommand);
-program.addCommand(logoutCommand);
-program.addCommand(whoamiCommand);
-program.addCommand(cronCommand);
-program.addCommand(deployCommand);
-program.addCommand(testCommand);
-program.addCommand(securityCommand);
-program.addCommand(importCommand);
-program.addCommand(healCommand);
-program.addCommand(auditCommand);
-program.addCommand(refreshCommand);
-program.addCommand(reviewCommand);
-program.addCommand(configCommand);
-program.parse();
+// ── init ──────────────────────────────────────────────────────────────
+program
+    .command('init')
+    .description('Initialize a new documentation site')
+    .argument('[directory]', 'Target directory', '.')
+    .option('--name <name>', 'Project name', 'my-docs')
+    .option('--color <hex>', 'Primary brand color (hex, e.g. "#FF5733")')
+    .option('--logo <url-or-path>', 'Logo URL or local file path')
+    .option('--favicon <url-or-path>', 'Favicon URL or local file path')
+    .action(async (directory, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/init.js');
+    await getAction(mod.initCommand)(directory, options);
+});
+// ── generate ──────────────────────────────────────────────────────────
+program
+    .command('generate')
+    .description('Generate documentation with code examples')
+    .argument('[sources...]', 'Source directories to scan (use dir:Label for labels)')
+    .option('-o, --output <dir>', 'Output directory')
+    .option('-c, --config <file>', 'Config file path')
+    .option('--provider <name>', 'LLM provider (deepseek, openai, anthropic, google, ollama, openrouter)')
+    .option('--model <name>', 'LLM model name')
+    .option('--base-url <url>', 'Custom API base URL (for Ollama or proxies)')
+    .option('--dry-run', 'Scan only, do not generate docs')
+    .option('--multi-lang', 'Generate TypeScript + Python examples')
+    .option('--by-topic', 'Organize output by topic instead of file')
+    .option('--openapi <file>', 'Include OpenAPI spec file for API Playground')
+    .option('--public-only', 'Only document exported/public APIs')
+    .option('--exclude <patterns...>', 'Exclude patterns (files, names, or name:pattern)')
+    .option('--llms-txt', 'Generate llms.txt for Answer Engine Optimization (AEO)')
+    .option('--project-name <name>', 'Project name for llms.txt header')
+    .option('--org <name>', 'GitHub organization to discover repos from')
+    .option('--repos <list>', 'Comma-separated list of repos to include (with --org)')
+    .option('--exclude-repos <list>', 'Comma-separated list of repos to exclude (with --org)')
+    .option('--verify', 'Verify generated code examples by running them (Pro)')
+    .option('--env-file <file>', 'Load environment variables for code verification')
+    .option('--smart-structure', 'Organize docs by user journey instead of file structure (Pro)')
+    .option('--max-verify-iterations <n>', 'Max re-generation attempts for failing snippets', '2')
+    .option('--no-agents-md', 'Skip AGENTS.md / CLAUDE.md generation')
+    .action(async (sources, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/generate/index.js');
+    await getAction(mod.generateCommand)(sources, options);
+});
+// ── watch ─────────────────────────────────────────────────────────────
+program
+    .command('watch')
+    .description('Watch source files and regenerate docs on changes')
+    .argument('[sources...]', 'Source directories to watch')
+    .option('-o, --output <dir>', 'Output directory')
+    .option('-c, --config <file>', 'Config file path')
+    .option('--provider <name>', 'LLM provider')
+    .option('--model <name>', 'LLM model name')
+    .option('--debounce <ms>', 'Debounce time in milliseconds', '1000')
+    .action(async (sources, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/watch.js');
+    await getAction(mod.watchCommand)(sources, options);
+});
+// ── autofix ───────────────────────────────────────────────────────────
+program
+    .command('autofix')
+    .description('Auto-fix broken code examples in documentation')
+    .argument('<file>', 'Documentation file to fix (markdown/mdx)')
+    .option('-c, --config <file>', 'Config file path')
+    .option('--provider <name>', 'LLM provider')
+    .option('--model <name>', 'LLM model')
+    .option('--max-iterations <n>', 'Max fix attempts per example', '3')
+    .option('--dry-run', 'Show fixes without writing')
+    .option('--language <lang>', 'Force language for validation')
+    .action(async (file, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/autofix.js');
+    await getAction(mod.autofixCommand)(file, options);
+});
+// ── review-pr ─────────────────────────────────────────────────────────
+program
+    .command('review-pr')
+    .description('Review a GitHub PR for documentation issues')
+    .argument('<pr-url>', 'GitHub PR URL (e.g., https://github.com/owner/repo/pull/123)')
+    .option('--inline', 'Post inline comments instead of a single comment')
+    .option('--dry-run', 'Show issues without posting comments')
+    .option('--token <token>', 'GitHub token (or use GITHUB_TOKEN env var)')
+    .action(async (prUrl, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/review-pr.js');
+    await getAction(mod.reviewPRCommand)(prUrl, options);
+});
+// ── lint ──────────────────────────────────────────────────────────────
+program
+    .command('lint')
+    .description('Lint documentation files for common issues')
+    .argument('[path]', 'Directory or file to lint', '.')
+    .option('--fix', 'Attempt to fix issues automatically')
+    .option('-c, --config <file>', 'Config file with custom rules')
+    .action(async (path, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/lint.js');
+    await getAction(mod.lintCommand)(path, options);
+});
+// ── qa ────────────────────────────────────────────────────────────────
+program
+    .command('qa')
+    .description('Run quality assurance checks on documentation')
+    .argument('<dir>', 'Documentation directory to check')
+    .option('--strict', 'Fail on warnings (not just errors)')
+    .option('--fix', 'Auto-fix safe issues before reporting')
+    .action(async (dir, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/qa.js');
+    await getAction(mod.qaCommand)(dir, options);
+});
+// ── check-links ───────────────────────────────────────────────────────
+program
+    .command('check-links')
+    .description('Check for broken links in documentation')
+    .argument('[path]', 'Directory to check', '.')
+    .option('--external', 'Also check external links (slower)')
+    .option('--timeout <ms>', 'Timeout for external links', '5000')
+    .action(async (path, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/check-links.js');
+    await getAction(mod.checkLinksCommand)(path, options);
+});
+// ── mcp ───────────────────────────────────────────────────────────────
+program
+    .command('mcp')
+    .description('Start MCP server for AI tools or generate MCP manifest')
+    .argument('[path]', 'Documentation directory', '.')
+    .option('-p, --port <port>', 'Server port', '3100')
+    .option('-h, --host <host>', 'Server host', 'localhost')
+    .option('-o, --output <file>', 'Output manifest to file instead of starting server')
+    .option('-t, --token <token>', 'Bearer token for authenticating MCP requests')
+    .action(async (path, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/mcp.js');
+    await getAction(mod.mcpCommand)(path, options);
+});
+// ── version (subcommands) ─────────────────────────────────────────────
+{
+    const versionCmd = program
+        .command('version')
+        .description('Manage documentation versions');
+    versionCmd.hook('preAction', async () => {
+        await ensureSentry();
+    });
+    versionCmd.hook('preSubcommand', async () => {
+        await ensureSentry();
+    });
+    versionCmd
+        .command('list')
+        .description('List all versions')
+        .argument('[docs-path]', 'Documentation directory', './docs')
+        .action(async (docsPath) => {
+        const mod = await import('./commands/version.js');
+        const cmd = mod.versionCommand.commands.find(c => c.name() === 'list');
+        await getAction(cmd)(docsPath);
+    });
+    versionCmd
+        .command('create')
+        .description('Create a new version from current docs')
+        .argument('<version>', 'Version name (e.g., v1, v2.0)')
+        .argument('[docs-path]', 'Documentation directory', './docs')
+        .option('--from <version>', 'Copy from existing version instead of current')
+        .action(async (version, docsPath, options) => {
+        const mod = await import('./commands/version.js');
+        const cmd = mod.versionCommand.commands.find(c => c.name() === 'create');
+        await getAction(cmd)(version, docsPath, options);
+    });
+    versionCmd
+        .command('set-current')
+        .description('Set the current/default version')
+        .argument('<version>', 'Version to set as current')
+        .argument('[docs-path]', 'Documentation directory', './docs')
+        .action(async (version, docsPath) => {
+        const mod = await import('./commands/version.js');
+        const cmd = mod.versionCommand.commands.find(c => c.name() === 'set-current');
+        await getAction(cmd)(version, docsPath);
+    });
+    versionCmd
+        .command('delete')
+        .description('Delete a version')
+        .argument('<version>', 'Version to delete')
+        .argument('[docs-path]', 'Documentation directory', './docs')
+        .option('--force', 'Skip confirmation')
+        .action(async (version, docsPath, options) => {
+        const mod = await import('./commands/version.js');
+        const cmd = mod.versionCommand.commands.find(c => c.name() === 'delete');
+        await getAction(cmd)(version, docsPath, options);
+    });
+}
+// ── i18n (subcommands) ────────────────────────────────────────────────
+{
+    const i18nCmd = program
+        .command('i18n')
+        .description('Manage documentation translations');
+    i18nCmd.hook('preSubcommand', async () => {
+        await ensureSentry();
+    });
+    i18nCmd
+        .command('init')
+        .description('Initialize i18n for documentation')
+        .argument('[docs-path]', 'Documentation directory', './docs')
+        .option('--default <locale>', 'Default locale', 'en')
+        .action(async (docsPath, options) => {
+        const mod = await import('./commands/i18n.js');
+        const cmd = mod.i18nCommand.commands.find(c => c.name() === 'init');
+        await getAction(cmd)(docsPath, options);
+    });
+    i18nCmd
+        .command('add')
+        .description('Add a new locale')
+        .argument('<locale>', 'Locale code (e.g., ja, fr, de)')
+        .argument('[docs-path]', 'Documentation directory', './docs')
+        .action(async (locale, docsPath) => {
+        const mod = await import('./commands/i18n.js');
+        const cmd = mod.i18nCommand.commands.find(c => c.name() === 'add');
+        await getAction(cmd)(locale, docsPath);
+    });
+    i18nCmd
+        .command('status')
+        .description('Show translation status')
+        .argument('[docs-path]', 'Documentation directory', './docs')
+        .action(async (docsPath) => {
+        const mod = await import('./commands/i18n.js');
+        const cmd = mod.i18nCommand.commands.find(c => c.name() === 'status');
+        await getAction(cmd)(docsPath);
+    });
+    i18nCmd
+        .command('missing')
+        .description('List missing translations for a locale')
+        .argument('<locale>', 'Locale to check')
+        .argument('[docs-path]', 'Documentation directory', './docs')
+        .action(async (locale, docsPath) => {
+        const mod = await import('./commands/i18n.js');
+        const cmd = mod.i18nCommand.commands.find(c => c.name() === 'missing');
+        await getAction(cmd)(locale, docsPath);
+    });
+    i18nCmd
+        .command('extract')
+        .description('Extract strings for translation')
+        .argument('[docs-path]', 'Documentation directory', './docs')
+        .option('-o, --output <file>', 'Output file', 'strings.json')
+        .action(async (docsPath, options) => {
+        const mod = await import('./commands/i18n.js');
+        const cmd = mod.i18nCommand.commands.find(c => c.name() === 'extract');
+        await getAction(cmd)(docsPath, options);
+    });
+}
+// ── monitor ───────────────────────────────────────────────────────────
+program
+    .command('monitor')
+    .description('Monitor codebase for changes and suggest documentation updates')
+    .argument('[repo-path]', 'Repository path', '.')
+    .option('--since <ref>', 'Git ref to compare against', 'HEAD~10')
+    .option('-o, --output <file>', 'Output suggestions to JSON file')
+    .option('--provider <name>', 'LLM provider')
+    .option('--model <name>', 'LLM model')
+    .option('--auto-fix', 'Automatically generate documentation for suggestions')
+    .option('--create-pr', 'Create a GitHub PR with changes')
+    .option('--dry-run', 'Show what would be done without making changes')
+    .action(async (repoPath, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/monitor.js');
+    await getAction(mod.monitorCommand)(repoPath, options);
+});
+// ── sdk ───────────────────────────────────────────────────────────────
+program
+    .command('sdk')
+    .description('Generate SDK code samples from OpenAPI spec')
+    .argument('<spec>', 'Path to OpenAPI/Swagger spec file (JSON or YAML)')
+    .option('-o, --output <dir>', 'Output directory', './docs/sdk')
+    .option('-l, --languages <list>', 'Languages to generate (comma-separated)', 'typescript,python,curl')
+    .option('--provider <name>', 'LLM provider for enhanced samples')
+    .option('--model <name>', 'LLM model')
+    .option('--format <type>', 'Output format (markdown or json)', 'markdown')
+    .action(async (specPath, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/sdk.js');
+    await getAction(mod.sdkCommand)(specPath, options);
+});
+// ── gh-action ─────────────────────────────────────────────────────────
+program
+    .command('gh-action')
+    .description('Generate GitHub Action workflow for documentation CI/CD')
+    .argument('[repo-path]', 'Repository path', '.')
+    .option('-f, --force', 'Overwrite existing workflow')
+    .action(async (repoPath, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/gh-action.js');
+    await getAction(mod.ghActionCommand)(repoPath, options);
+});
+// ── llms-txt ──────────────────────────────────────────────────────────
+program
+    .command('llms-txt')
+    .description('Generate llms.txt and llms-full.txt for AI discoverability')
+    .argument('[docs-path]', 'Path to documentation directory', './docs')
+    .option('-o, --output <dir>', 'Output directory', './public')
+    .option('--base-url <url>', 'Base URL for documentation', 'https://docs.example.com')
+    .option('--title <title>', 'Documentation title', 'Documentation')
+    .option('--description <desc>', 'Documentation description', 'API and usage documentation')
+    .action(async (docsPath, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/llms-txt.js');
+    await getAction(mod.llmsTxtCommand)(docsPath, options);
+});
+// ── login ─────────────────────────────────────────────────────────────
+program
+    .command('login')
+    .description('Login to Skrypt Pro')
+    .option('--key <api-key>', 'API key (or set SKRYPT_API_KEY env var)')
+    .action(async (options) => {
+    await ensureSentry();
+    const mod = await import('./commands/login.js');
+    await getAction(mod.loginCommand)(options);
+});
+// ── logout ────────────────────────────────────────────────────────────
+program
+    .command('logout')
+    .description('Logout from Skrypt')
+    .action(async () => {
+    await ensureSentry();
+    const mod = await import('./commands/login.js');
+    await getAction(mod.logoutCommand)();
+});
+// ── whoami ────────────────────────────────────────────────────────────
+program
+    .command('whoami')
+    .description('Show current login status')
+    .action(async () => {
+    await ensureSentry();
+    const mod = await import('./commands/login.js');
+    await getAction(mod.whoamiCommand)();
+});
+// ── cron ──────────────────────────────────────────────────────────────
+program
+    .command('cron')
+    .description('Set up automated documentation updates with GitHub Actions')
+    .argument('[repo-path]', 'Repository path', '.')
+    .option('-s, --schedule <cron>', 'Cron schedule (default: daily at 2am UTC)', '0 2 * * *')
+    .option('-f, --force', 'Overwrite existing workflow')
+    .action(async (repoPath, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/cron.js');
+    await getAction(mod.cronCommand)(repoPath, options);
+});
+// ── deploy ────────────────────────────────────────────────────────────
+program
+    .command('deploy')
+    .description('Deploy documentation site to Skrypt hosting')
+    .argument('[directory]', 'Documentation site directory', '.')
+    .option('--project <slug>', 'Project slug (e.g., my-docs)')
+    .option('--token <key>', 'API token (or set SKRYPT_API_KEY env var)')
+    .action(async (directory, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/deploy.js');
+    await getAction(mod.deployCommand)(directory, options);
+});
+// ── test ──────────────────────────────────────────────────────────────
+program
+    .command('test')
+    .description('Test code examples in documentation files')
+    .argument('[path]', 'Directory or file to test', '.')
+    .option('-f, --file <file>', 'Test a specific file or directory')
+    .option('-l, --language <lang>', 'Filter by language (typescript, javascript, python)')
+    .option('--fix', 'Auto-fix failing examples using autofix command')
+    .option('-t, --timeout <ms>', 'Timeout per code block in milliseconds', '10000')
+    .option('-v, --verbose', 'Show detailed output')
+    .option('--verify-output', 'Compare stdout against // Output: comments')
+    .option('--env-file <file>', 'Load environment variables from file')
+    .option('--environments <list>', 'Comma-separated Docker environments (e.g. node-20,python-3.12)')
+    .action(async (path, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/test.js');
+    await getAction(mod.testCommand)(path, options);
+});
+// ── security ──────────────────────────────────────────────────────────
+program
+    .command('security')
+    .description('Show security and key storage details')
+    .action(async () => {
+    await ensureSentry();
+    const mod = await import('./commands/security.js');
+    await getAction(mod.securityCommand)();
+});
+// ── import ────────────────────────────────────────────────────────────
+program
+    .command('import')
+    .description('Import documentation from another platform')
+    .argument('<source>', 'Local directory or GitHub URL')
+    .option('--from <format>', 'Source format (mintlify, docusaurus, gitbook, readme, notion, confluence, markdown)')
+    .option('-o, --output <dir>', 'Output directory')
+    .option('--dry-run', 'Show what would be imported without writing files')
+    .option('--name <name>', 'Project name')
+    .action(async (source, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/import.js');
+    await getAction(mod.importCommand)(source, options);
+});
+// ── heal ──────────────────────────────────────────────────────────────
+program
+    .command('heal')
+    .description('Self-heal documentation: fix QA issues, broken code, and capture screenshots')
+    .argument('[docs-dir]', 'Documentation directory', '.')
+    .option('--base-url <url>', 'Base URL for screenshot capture', 'http://localhost:3000')
+    .option('--output <dir>', 'Screenshot output directory', 'public/screenshots')
+    .option('--viewport <size>', 'Viewport WxH', '1280x720')
+    .option('--dark', 'Also capture dark mode variants')
+    .option('--diff', 'Only re-capture changed screenshots')
+    .option('--screenshots', 'Run screenshot capture phase')
+    .option('--qa-only', 'Run only QA fix phase')
+    .option('--code-only', 'Run only code fix phase')
+    .option('--deep', 'Run all 3 phases')
+    .option('--dry-run', 'Show what would change without writing')
+    .option('--timeout <ms>', 'Page load timeout', '30000')
+    .option('--wait <ms>', 'Wait after page load', '1000')
+    .option('--device <name>', 'Emulate device (e.g. "iPhone 14")')
+    .option('--concurrency <n>', 'Parallel capture limit', '3')
+    .option('--provider <name>', 'LLM provider (for code fix phase)')
+    .option('--model <name>', 'LLM model (for code fix phase)')
+    .option('--max-iterations <n>', 'Max fix attempts per code example', '3')
+    .option('-c, --config <file>', 'Config file path')
+    .action(async (docsDir, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/heal.js');
+    await getAction(mod.healCommand)(docsDir, options);
+});
+// ── audit ─────────────────────────────────────────────────────────────
+program
+    .command('audit')
+    .description('Audit documentation coverage and staleness')
+    .argument('[source]', 'Source code directory to audit', '.')
+    .option('--docs <dir>', 'Documentation directory to compare against', './docs')
+    .option('--format <type>', 'Output format: text or json', 'text')
+    .option('--public-only', 'Only audit exported/public APIs')
+    .action(async (source, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/audit.js');
+    await getAction(mod.auditCommand)(source, options);
+});
+// ── refresh ───────────────────────────────────────────────────────────
+program
+    .command('refresh')
+    .description('Refresh stale documentation based on code changes')
+    .argument('[source]', 'Source code directory', '.')
+    .option('--docs <dir>', 'Documentation directory', './docs')
+    .option('--since <ref>', 'Git ref to compare against (e.g. HEAD~3, 2026-03-01)', 'HEAD~1')
+    .option('-c, --config <file>', 'Config file path')
+    .option('--provider <name>', 'LLM provider')
+    .option('--model <name>', 'LLM model name')
+    .action(async (source, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/refresh.js');
+    await getAction(mod.refreshCommand)(source, options);
+});
+// ── review ────────────────────────────────────────────────────────────
+program
+    .command('review')
+    .description('Incorporate feedback into documentation')
+    .argument('[docs]', 'Documentation directory', './docs')
+    .option('--feedback <file>', 'Feedback file (markdown format)')
+    .option('--inline', 'Process <!-- FIXME: --> and <!-- TODO: --> comments in docs')
+    .option('-c, --config <file>', 'Config file path')
+    .option('--provider <name>', 'LLM provider')
+    .option('--model <name>', 'LLM model name')
+    .action(async (docs, options) => {
+    await ensureSentry();
+    const mod = await import('./commands/review.js');
+    await getAction(mod.reviewCommand)(docs, options);
+});
+// ── config ────────────────────────────────────────────────────────────
+program
+    .command('config')
+    .description('Configure Skrypt preferences')
+    .option('--suggestions', 'Configure next-step suggestions')
+    .option('--suggestions-on', 'Enable next-step suggestions')
+    .option('--suggestions-off', 'Disable next-step suggestions')
+    .action(async (options) => {
+    await ensureSentry();
+    const mod = await import('./commands/config.js');
+    await getAction(mod.configCommand)(options);
+});
+try {
+    await program.parseAsync();
+}
+catch (err) {
+    try {
+        const { Sentry } = await import('./sentry.js');
+        Sentry.captureException(err);
+        await Sentry.flush(2000);
+    }
+    catch {
+        // Sentry may not be available
+    }
+    throw err;
+}

package/dist/commands/bind.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const bindCommand: Command;