@cisco_open/linting-orchestrator 1.0.0-rc.4

package/build/cli/index.js

@@ -0,0 +1,335 @@
+#!/usr/bin/env node
+/**
+ * Orchestrator CLI - Command-line interface for linting documents, managing rulesets, and controlling the orchestrator server
+ *
+ * Usage:
+ *   spectify start [--mode standalone|mcp] [options]
+ *   spectify lint <file> [options]
+ *   spectify status <jobId> [options]
+ *   spectify results <jobId> [options]
+ *   spectify history [options]
+ *   spectify rulesets [options]
+ *   spectify health [options]
+ *   spectify config [show|set|reset]
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { CLI_VERSION } from '../utils/version.js';
+import { getConfigManager } from './config-manager.js';
+import { lintCommand } from './commands/lint.js';
+import { statusCommand } from './commands/status.js';
+import { resultsCommand } from './commands/results.js';
+import { reproduceCommand } from './commands/reproduce.js';
+import { historyCommand } from './commands/history.js';
+import { jobsCommand } from './commands/jobs.js';
+import { viewRulesetsCommand, checkRulesetsCommand } from './commands/rulesets/index.js';
+import { healthCommand } from './commands/health.js';
+import { configCommand } from './commands/config.js';
+import { completionCommand } from './commands/completion.js';
+import { agentsCommand } from './commands/agents.js';
+import { resetCommand } from './commands/reset.js';
+import { helpCommand } from './commands/help.js';
+import { handleCommandError } from './utils/connection-error.js';
+// Configure chalk to disable colors when piping to prevent terminal corruption
+// This fixes issues when piping to 'more', 'less', etc. and interrupting
+if (!process.stdout.isTTY) {
+    chalk.level = 0;
+}
+const program = new Command();
+program
+    .name('spectify')
+    .description('Linting Orchestrator — Quality Assurance for API specifications')
+    .helpOption('-h, --help', 'display help for command')
+    .option('-a, --agents', 'Show LLM-friendly documentation (for AI agents)')
+    .option('-V, --version', 'output the version number')
+    .usage('[options] [command]')
+    .enablePositionalOptions();
+// Custom version display showing CLI version only
+// Use 'spectify health' to see the running server version
+program.on('option:version', () => {
+    console.log(`spectify CLI v${CLI_VERSION}`);
+    console.log(chalk.dim('Use "spectify health" to see server version'));
+    process.exit(0);
+});
+// Configure help
+program.configureHelp({
+    sortSubcommands: false,
+    showGlobalOptions: false,
+});
+// Check if showing root help before parsing
+const showingRootHelp = (process.argv.length === 2) ||
+    (process.argv.length === 3 && (process.argv[2] === '--help' || process.argv[2] === '-h'));
+if (showingRootHelp) {
+    // Show custom grouped help for root command
+    console.log(`Usage: spectify [options] [command]`);
+    console.log('');
+    console.log('Linting Orchestrator — Quality Assurance for API specifications');
+    console.log('');
+    console.log('Options:');
+    console.log('  -V, --version                  output the version number');
+    console.log('  -a, --agents                   Show LLM-friendly documentation (for AI agents)');
+    console.log('  -h, --help                     display help for command');
+    console.log('');
+    console.log(chalk.cyan('Linting Commands:'));
+    console.log('    lint           Lint a document');
+    console.log('    status         Check the status of a lint job');
+    console.log('    results        View detailed lint results');
+    console.log('    reproduce      Generate Spectral CLI reproduction instructions');
+    console.log('    jobs           List recent lint jobs');
+    console.log('    history        View lint history');
+    console.log('    rulesets       List, view, or check rulesets (view | check)');
+    console.log('');
+    console.log(chalk.cyan('Configuration Commands:'));
+    console.log('    config         Manage CLI configuration (show, set, reset)');
+    console.log('    completion     Generate shell completion script');
+    console.log('    health         Check orchestrator service health');
+    console.log('');
+    console.log(chalk.dim('Default mode: embedded (server auto-starts with lint commands)'));
+    console.log(chalk.dim('For production server: spectifyd --help'));
+    console.log('');
+    process.exit(0);
+}
+// ============================================================================
+// LINTING COMMANDS
+// ============================================================================
+// Lint command
+program
+    .command('lint <file>')
+    .description('Lint a document using one or multiple rulesets')
+    .option('-r, --ruleset <name>', 'Ruleset(s) to use (comma-separated). Defaults to all available rulesets.')
+    .option('-v, --version <version>', 'Ruleset version (applies to all rulesets if multiple specified)')
+    .option('--override <override>', 'Override rule severities. Repeatable. E.g. --override rule1=off --override rule2=warn or --override rule1=off,rule2=warn', (val, prev) => prev.concat(val), [])
+    .option('--no-cache', 'Disable cache lookup')
+    .option('--show-all', 'Show all issues (no limit)')
+    .option('--poll-interval <seconds>', 'Progress display interval in seconds for multi-ruleset runs (default: 5)', parseFloat)
+    .action(async (file, options) => {
+    try {
+        // Don't pre-fill apiUrl - let lintCommand handle embedded mode detection
+        await lintCommand(file, options);
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+// Status command
+program
+    .command('status <jobId>')
+    .description('Check the status of a lint job')
+    .option('-w, --watch', 'Watch job status until completion')
+    .action(async (jobId, options) => {
+    try {
+        const { requireServerMode } = await import('./utils/mode-validator.js');
+        await requireServerMode('status');
+        const configManager = getConfigManager();
+        const apiUrl = await configManager.getApiUrl();
+        await statusCommand(jobId, {
+            ...options,
+            apiUrl,
+        });
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+// Results command
+program
+    .command('results <jobId>')
+    .description('View detailed lint results')
+    .option('--rule <ruleId>', 'Filter by rule ID')
+    .option('--severity <level>', 'Filter by severity (error, warning, info, hint)')
+    .option('--format <format>', 'Output format (table, json, sarif)', 'table')
+    .option('--output <path>', 'Save report to file (SARIF format)')
+    .option('--json', 'Output raw JSON response')
+    .action(async (jobId, options) => {
+    try {
+        const { requireServerMode } = await import('./utils/mode-validator.js');
+        await requireServerMode('results');
+        const configManager = getConfigManager();
+        const apiUrl = await configManager.getApiUrl();
+        await resultsCommand(jobId, {
+            ...options,
+            apiUrl,
+        });
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+// Reproduce command
+program
+    .command('reproduce <jobId>')
+    .description('Generate Spectral CLI reproduction instructions for a lint job')
+    .option('-o, --output <path>', 'Save instructions to file')
+    .action(async (jobId, options) => {
+    try {
+        const { requireServerMode } = await import('./utils/mode-validator.js');
+        await requireServerMode('reproduce');
+        const configManager = getConfigManager();
+        const apiUrl = await configManager.getApiUrl();
+        await reproduceCommand(jobId, {
+            ...options,
+            apiUrl,
+        });
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+// History command
+program
+    .command('history')
+    .description('View lint history')
+    .option('-l, --limit <number>', 'Number of entries to show', '10')
+    .option('-f, --file <path>', 'Filter by file path')
+    .option('--ruleset <name>', 'Filter by ruleset name')
+    .option('--clear', 'Clear history')
+    .action(async (options) => {
+    try {
+        await historyCommand({
+            ...options,
+            limit: parseInt(options.limit),
+        });
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+// Jobs command
+program
+    .command('jobs')
+    .description('List recent lint jobs (requires standalone or companion mode)')
+    .option('--status <status>', 'Filter by job status (completed, failed, running, timeout)')
+    .option('--ruleset <name>', 'Filter by ruleset name')
+    .option('-l, --limit <number>', 'Number of jobs to show (default: 20)')
+    .option('--detailed', 'Show with document metadata (slower)')
+    .option('--json', 'Output raw JSON response')
+    .action(async (options) => {
+    try {
+        await jobsCommand({
+            ...options,
+            limit: options.limit ? parseInt(options.limit) : undefined,
+        });
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+// Rulesets command — parent with two subcommands:
+//   spectify rulesets view  [--name N] [--version V] [--format table|json]
+//   spectify rulesets check [--name N] [--version V] [--format text|json]
+//                           [--rulesets-directory PATH]
+// Bare `spectify rulesets` is an alias for `view` for backward compatibility.
+const rulesetsCmd = program
+    .command('rulesets')
+    .description('List, view, or check rulesets');
+rulesetsCmd
+    .command('view', { isDefault: true })
+    .description('List rulesets or show details of one (default subcommand)')
+    .option('--name <name>', 'Ruleset name to view')
+    .option('--version <version>', 'Ruleset version to view (requires --name)')
+    .option('--format <format>', 'Output format (table, json)', 'table')
+    .action(async (options) => {
+    try {
+        // Don't pre-fill apiUrl - let viewRulesetsCommand handle embedded mode detection
+        await viewRulesetsCommand(options);
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+rulesetsCmd
+    .command('check')
+    .description('Verify every configured ruleset version actually loads (in-process, no server)')
+    .option('--name <name>', 'Restrict the check to a single ruleset')
+    .option('--version <version>', 'Restrict the check to a single version (requires --name)')
+    .option('-r, --rulesets-directory <path>', 'Catalogue directory (overrides SPECTIFYD_RULESETS_DIR)')
+    .option('--format <format>', 'Output format (text, json)', 'text')
+    .action(async (options) => {
+    try {
+        await checkRulesetsCommand(options);
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+// Health command
+program
+    .command('health')
+    .description('Check orchestrator service health')
+    .option('--format <format>', 'Output format (text, json)', 'text')
+    .action(async (options) => {
+    try {
+        const configManager = getConfigManager();
+        const config = await configManager.get();
+        // Don't pre-fill apiUrl - let healthCommand handle embedded mode detection
+        await healthCommand({
+            ...options,
+            mode: config.defaultMode,
+        });
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+// ============================================================================
+// CONFIGURATION COMMANDS
+// ============================================================================
+// Config command
+program
+    .command('config [action] [key] [value]')
+    .description('Manage CLI configuration (show, set, reset)')
+    .action(async (action, key, value) => {
+    try {
+        await configCommand({ action, key, value });
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+// Completion command
+program
+    .command('completion')
+    .description('Generate bash completion script')
+    .allowUnknownOption() // Accept --shell for backward compatibility without documenting it
+    .action(async (options) => {
+    try {
+        await completionCommand(options);
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+// ============================================================================
+// UTILITY COMMANDS
+// ============================================================================
+// Help command (alternative: spectify help <command>)
+program
+    .command('help [command]')
+    .description('Display help for a command')
+    .action((commandName) => {
+    helpCommand(program, commandName);
+});
+// Reset command (hidden from help)
+program
+    .command('reset', { hidden: true })
+    .description('Reset terminal colors and formatting')
+    .action(async () => {
+    try {
+        await resetCommand();
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+});
+// Check for --agents or -a flag BEFORE parsing (direct argv check)
+if (process.argv.includes('--agents') || process.argv.includes('-a')) {
+    agentsCommand();
+    process.exit(0);
+}
+// Parse arguments
+program.parse(process.argv);
+// Show help if no command specified
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+//# sourceMappingURL=index.js.map

package/build/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,+EAA+E;AAC/E,yEAAyE;AACzE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1B,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,iEAAiE,CAAC;KAC9E,UAAU,CAAC,YAAY,EAAE,0BAA0B,CAAC;KACpD,MAAM,CAAC,cAAc,EAAE,iDAAiD,CAAC;KACzE,MAAM,CAAC,eAAe,EAAE,2BAA2B,CAAC;KACpD,KAAK,CAAC,qBAAqB,CAAC;KAC5B,uBAAuB,EAAE,CAAC;AAE7B,kDAAkD;AAClD,0DAA0D;AAC1D,OAAO,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAChC,OAAO,CAAC,GAAG,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,iBAAiB;AACjB,OAAO,CAAC,aAAa,CAAC;IACpB,eAAe,EAAE,KAAK;IACtB,iBAAiB,EAAE,KAAK;CACzB,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;IACjD,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;AAE5F,IAAI,eAAe,EAAE,CAAC;IACpB,4CAA4C;IAC5C,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,kFAAkF,CAAC,CAAC;IAChG,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;IAC9E,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC,CAAC;IACzF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,eAAe;AACf,OAAO;KACJ,OAAO,CAAC,aAAa,CAAC;KACtB,WAAW,CAAC,gDAAgD,CAAC;KAC7D,MAAM,CAAC,sBAAsB,EAAE,0EAA0E,CAAC;KAC1G,MAAM,CAAC,yBAAyB,EAAE,iEAAiE,CAAC;KACpG,MAAM,CAAC,uBAAuB,EAAE,0HAA0H,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAc,CAAC;KAC9N,MAAM,CAAC,YAAY,EAAE,sBAAsB,CAAC;KAC5C,MAAM,CAAC,YAAY,EAAE,4BAA4B,CAAC;KAClD,MAAM,CAAC,2BAA2B,EAAE,0EAA0E,EAAE,UAAU,CAAC;KAC3H,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;IAC9B,IAAI,CAAC;QACH,yEAAyE;QACzE,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,iBAAiB;AACjB,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,aAAa,EAAE,mCAAmC,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAC/B,IAAI,CAAC;QACH,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAAC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;QAE/C,MAAM,aAAa,CAAC,KAAK,EAAE;YACzB,GAAG,OAAO;YACV,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,kBAAkB;AAClB,OAAO;KACJ,OAAO,CAAC,iBAAiB,CAAC;KAC1B,WAAW,CAAC,4BAA4B,CAAC;KACzC,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;KAC9C,MAAM,CAAC,oBAAoB,EAAE,iDAAiD,CAAC;KAC/E,MAAM,CAAC,mBAAmB,EAAE,oCAAoC,EAAE,OAAO,CAAC;KAC1E,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;KAC/D,MAAM,CAAC,QAAQ,EAAE,0BAA0B,CAAC;KAC5C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAC/B,IAAI,CAAC;QACH,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;QAE/C,MAAM,cAAc,CAAC,KAAK,EAAE;YAC1B,GAAG,OAAO;YACV,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,oBAAoB;AACpB,OAAO;KACJ,OAAO,CAAC,mBAAmB,CAAC;KAC5B,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAC/B,IAAI,CAAC;QACH,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACrC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;QAE/C,MAAM,gBAAgB,CAAC,KAAK,EAAE;YAC5B,GAAG,OAAO;YACV,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,kBAAkB;AAClB,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,mBAAmB,CAAC;KAChC,MAAM,CAAC,sBAAsB,EAAE,2BAA2B,EAAE,IAAI,CAAC;KACjE,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;KAClD,MAAM,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;KACpD,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC;KAClC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,cAAc,CAAC;YACnB,GAAG,OAAO;YACV,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,eAAe;AACf,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,+DAA+D,CAAC;KAC5E,MAAM,CAAC,mBAAmB,EAAE,4DAA4D,CAAC;KACzF,MAAM,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;KACpD,MAAM,CAAC,sBAAsB,EAAE,sCAAsC,CAAC;KACtE,MAAM,CAAC,YAAY,EAAE,sCAAsC,CAAC;KAC5D,MAAM,CAAC,QAAQ,EAAE,0BAA0B,CAAC;KAC5C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,WAAW,CAAC;YAChB,GAAG,OAAO;YACV,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;SAC3D,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,kDAAkD;AAClD,2EAA2E;AAC3E,0EAA0E;AAC1E,wDAAwD;AACxD,8EAA8E;AAC9E,MAAM,WAAW,GAAG,OAAO;KACxB,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,+BAA+B,CAAC,CAAC;AAEhD,WAAW;KACR,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACpC,WAAW,CAAC,2DAA2D,CAAC;KACxE,MAAM,CAAC,eAAe,EAAE,sBAAsB,CAAC;KAC/C,MAAM,CAAC,qBAAqB,EAAE,2CAA2C,CAAC;KAC1E,MAAM,CAAC,mBAAmB,EAAE,6BAA6B,EAAE,OAAO,CAAC;KACnE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,iFAAiF;QACjF,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,WAAW;KACR,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,gFAAgF,CAAC;KAC7F,MAAM,CAAC,eAAe,EAAE,wCAAwC,CAAC;KACjE,MAAM,CAAC,qBAAqB,EAAE,0DAA0D,CAAC;KACzF,MAAM,CAAC,iCAAiC,EAAE,wDAAwD,CAAC;KACnG,MAAM,CAAC,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,CAAC;KACjE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,iBAAiB;AACjB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,mCAAmC,CAAC;KAChD,MAAM,CAAC,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,CAAC;KACjE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC;QAEzC,2EAA2E;QAC3E,MAAM,aAAa,CAAC;YAClB,GAAG,OAAO;YACV,IAAI,EAAE,MAAM,CAAC,WAAW;SACzB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,iBAAiB;AACjB,OAAO;KACJ,OAAO,CAAC,+BAA+B,CAAC;KACxC,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;IACnC,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,qBAAqB;AACrB,OAAO;KACJ,OAAO,CAAC,YAAY,CAAC;KACrB,WAAW,CAAC,iCAAiC,CAAC;KAC9C,kBAAkB,EAAE,CAAC,mEAAmE;KACxF,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,sDAAsD;AACtD,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,4BAA4B,CAAC;KACzC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE;IACtB,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEL,mCAAmC;AACnC,OAAO;KACJ,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAClC,WAAW,CAAC,sCAAsC,CAAC;KACnD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,mEAAmE;AACnE,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACrE,aAAa,EAAE,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,kBAAkB;AAClB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,oCAAoC;AACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC"}

package/build/cli/list-rulesets.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * CLI Tool: list-rulesets
+ *
+ * Lists all available rulesets with details including versions,
+ * rules count, and metadata.
+ *
+ * Usage:
+ *   npm run list-rulesets
+ *   npm run list-rulesets -- --verbose
+ *   npm run list-rulesets -- --name pubhub
+ *   npm run list-rulesets -- --format json
+ */
+export {};
+//# sourceMappingURL=list-rulesets.d.ts.map

package/build/cli/list-rulesets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-rulesets.d.ts","sourceRoot":"","sources":["../../src/cli/list-rulesets.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/build/cli/list-rulesets.js

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+/**
+ * CLI Tool: list-rulesets
+ *
+ * Lists all available rulesets with details including versions,
+ * rules count, and metadata.
+ *
+ * Usage:
+ *   npm run list-rulesets
+ *   npm run list-rulesets -- --verbose
+ *   npm run list-rulesets -- --name pubhub
+ *   npm run list-rulesets -- --format json
+ */
+import { RulesetLoader } from '../ruleset-loader.js';
+import { loadConfig } from '../config.js';
+/**
+ * Parse command-line arguments
+ */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const options = {
+        verbose: false,
+        format: 'table',
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--verbose' || arg === '-v') {
+            options.verbose = true;
+        }
+        else if (arg === '--name' || arg === '-n') {
+            options.name = args[++i];
+        }
+        else if (arg === '--version') {
+            options.version = args[++i];
+        }
+        else if (arg === '--format' || arg === '-f') {
+            const format = args[++i];
+            if (format === 'json' || format === 'table') {
+                options.format = format;
+            }
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    return options;
+}
+/**
+ * Print help message
+ */
+function printHelp() {
+    console.log(`
+Usage: list-rulesets [options]
+
+List all available rulesets with details.
+
+Options:
+  -n, --name <name>       Show details for specific ruleset
+  --version <version>     Show specific version (requires --name)
+  -f, --format <format>   Output format: table (default) or json
+  -v, --verbose           Show detailed information
+  -h, --help             Show this help message
+
+Examples:
+  list-rulesets
+  list-rulesets --verbose
+  list-rulesets --name pubhub
+  list-rulesets --name pubhub --version 1.1.0
+  list-rulesets --format json
+`);
+}
+/**
+ * Format table output
+ */
+function printTable(rulesets) {
+    console.log('\n📋 Available Rulesets:\n');
+    console.log('┌─────────────────────────────────────────────────────────────────────────┐');
+    for (const ruleset of rulesets) {
+        console.log(`│ ${ruleset.displayName.padEnd(40)} │`);
+        console.log(`│   Name:     ${ruleset.name.padEnd(60)} │`);
+        console.log(`│   Category: ${ruleset.category.padEnd(60)} │`);
+        console.log(`│   Origin:   ${ruleset.origin.padEnd(60)} │`);
+        console.log(`│   Versions: ${ruleset.versions.join(', ').padEnd(60)} │`);
+        console.log(`│   Default:  ${ruleset.defaultVersion.padEnd(60)} │`);
+        console.log(`│   Rules:    ${String(ruleset.ruleCount).padEnd(60)} │`);
+        console.log(`│   Tags:     ${ruleset.tags.join(', ').padEnd(60)} │`);
+        console.log('├─────────────────────────────────────────────────────────────────────────┤');
+    }
+    console.log(`\nTotal: ${rulesets.length} ruleset(s)\n`);
+}
+/**
+ * Print detailed ruleset version information
+ */
+function printRulesetDetails(ruleset, verbose) {
+    console.log(`\n📦 Ruleset: ${ruleset.metadata.displayName}\n`);
+    console.log(`Name:         ${ruleset.metadata.name}`);
+    console.log(`Version:      ${ruleset.version}${ruleset.resolvedVersion ? ` (effective: ${ruleset.resolvedVersion}, from ${ruleset.package || 'npm'})` : ''}`);
+    console.log(`Category:     ${ruleset.metadata.category}`);
+    console.log(`Origin:       ${ruleset.metadata.origin}`);
+    console.log(`Description:  ${ruleset.metadata.description}`);
+    console.log(`Source Repo:  ${ruleset.sourceRepo}`);
+    console.log(`Entry Point:  ${ruleset.entrypoint}`);
+    if (ruleset.releaseDate) {
+        console.log(`Release Date: ${ruleset.releaseDate}`);
+    }
+    console.log(`Deprecated:   ${ruleset.deprecated ? 'Yes' : 'No'}`);
+    console.log(`Rules Count:  ${ruleset.rules.length}`);
+    if (ruleset.changelog) {
+        console.log(`\nChangelog:\n  ${ruleset.changelog}`);
+    }
+    console.log(`\nMetadata:`);
+    console.log(`  Team:         ${ruleset.metadata.metadata.team}`);
+    console.log(`  Repository:   ${ruleset.metadata.metadata.repository}`);
+    console.log(`  License:      ${ruleset.metadata.metadata.license}`);
+    if (ruleset.metadata.metadata.documentation) {
+        console.log(`  Docs:         ${ruleset.metadata.metadata.documentation}`);
+    }
+    if (ruleset.metadata.metadata.maintainer) {
+        console.log(`  Maintainer:   ${ruleset.metadata.metadata.maintainer}`);
+    }
+    if (ruleset.metadata.metadata.contact) {
+        console.log(`  Contact:      ${ruleset.metadata.metadata.contact}`);
+    }
+    if (verbose) {
+        console.log(`\n📜 Rules (${ruleset.rules.length}):\n`);
+        for (const rule of ruleset.rules) {
+            console.log(`  • ${rule.name}`);
+            console.log(`    Severity:    ${rule.severity}`);
+            console.log(`    Message:     ${rule.message}`);
+            if (rule.description) {
+                console.log(`    Description: ${rule.description}`);
+            }
+            console.log(`    Recommended: ${rule.recommended !== false ? 'Yes' : 'No'}`);
+            console.log();
+        }
+    }
+    else {
+        console.log(`\n📜 Rules: ${ruleset.rules.length} total (use --verbose to see details)\n`);
+    }
+}
+/**
+ * Main CLI function
+ */
+async function main() {
+    try {
+        const options = parseArgs();
+        // Load configuration
+        const config = await loadConfig();
+        // Initialize ruleset loader
+        const loader = new RulesetLoader({
+            configPath: `${config.rulesets.directory}/config/rulesets.yaml`,
+            sourcesBasePath: `${config.rulesets.directory}/sources`,
+            enableCache: config.rulesets.cacheEnabled,
+        });
+        await loader.initialize();
+        // Specific ruleset requested
+        if (options.name) {
+            const version = options.version || undefined;
+            const ruleset = await loader.loadVersion(options.name, version);
+            if (options.format === 'json') {
+                console.log(JSON.stringify(ruleset, null, 2));
+            }
+            else {
+                printRulesetDetails(ruleset, options.verbose);
+            }
+        }
+        else {
+            // List all rulesets
+            const rulesets = loader.listRulesets();
+            if (options.format === 'json') {
+                console.log(JSON.stringify(rulesets, null, 2));
+            }
+            else {
+                printTable(rulesets);
+                if (options.verbose) {
+                    console.log('\nCache Statistics:');
+                    const stats = loader.getCacheStats();
+                    console.log(`  Cached entries: ${stats.size}`);
+                    console.log(`  Cache keys:     ${stats.keys.join(', ')}`);
+                    console.log();
+                }
+            }
+        }
+    }
+    catch (error) {
+        console.error('❌ Error:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+// Run CLI
+main();
+//# sourceMappingURL=list-rulesets.js.map

package/build/cli/list-rulesets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-rulesets.js","sourceRoot":"","sources":["../../src/cli/list-rulesets.ts"],"names":[],"mappings":"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"}

package/build/cli/utils/connection-error.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared connection error handling for CLI commands
+ */
+/**
+ * Handle any CLI command error: prints the health-style message for connection
+ * errors, a plain error message for everything else, then exits with code 1.
+ */
+export declare function handleCommandError(error: unknown): Promise<never>;
+//# sourceMappingURL=connection-error.d.ts.map

package/build/cli/utils/connection-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-error.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/connection-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAkBvE"}

package/build/cli/utils/connection-error.js

@@ -0,0 +1,30 @@
+/**
+ * Shared connection error handling for CLI commands
+ */
+import chalk from 'chalk';
+import { ConnectionError } from '../api-client.js';
+import { getConfigManager } from '../config-manager.js';
+/**
+ * Handle any CLI command error: prints the health-style message for connection
+ * errors, a plain error message for everything else, then exits with code 1.
+ */
+export async function handleCommandError(error) {
+    if (error instanceof ConnectionError) {
+        const configManager = getConfigManager();
+        const config = await configManager.get();
+        const mode = config.defaultMode;
+        const port = config.ports[mode];
+        console.log(chalk.red('⚠️  Orchestrator service is not running\n'));
+        console.log(chalk.dim(`   Mode: ${mode}`));
+        console.log(chalk.dim(`   Port: ${port}`));
+        console.log(chalk.dim(`   URL: http://localhost:${port}\n`));
+        console.log(chalk.yellow('To start the orchestrator service:\n'));
+        console.log(chalk.bold(`   spectifyd\n`));
+    }
+    else {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.error(chalk.red('Error:'), msg);
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=connection-error.js.map

package/build/cli/utils/connection-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-error.js","sourceRoot":"","sources":["../../../src/cli/utils/connection-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAc;IACnD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACnC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,IAAI,IAAI,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sCAAsC,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACJ,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/build/cli/utils/embedded-server.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Embedded Server Lifecycle Management
+ *
+ * Handles auto-start/stop of embedded server for CLI commands
+ */
+/**
+ * Start embedded server if needed based on CLI config
+ * Returns shutdown function to be called in finally block
+ *
+ * @param apiUrl Optional API URL override (if provided, don't start embedded server)
+ * @returns Shutdown function or null if server not started
+ */
+export declare function maybeStartEmbeddedServer(apiUrl?: string): Promise<(() => Promise<void>) | null>;
+/**
+ * Get API URL based on current CLI configuration
+ *
+ * @param explicitUrl Optional explicit URL override
+ * @returns API URL to use
+ */
+export declare function getApiUrl(explicitUrl?: string): Promise<string>;
+//# sourceMappingURL=embedded-server.d.ts.map

package/build/cli/utils/embedded-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-server.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/embedded-server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAiCvC;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUrE"}