@cisco_open/linting-orchestrator 1.0.0-rc.4

package/build/cli/commands/reproduce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reproduce.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/reproduce.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB9F"}

package/build/cli/commands/reproduce.js

@@ -0,0 +1,31 @@
+/**
+ * Reproduce command - Generate Spectral CLI reproduction instructions for a lint job
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { SpectifyAPIClient, ConnectionError } from '../api-client.js';
+export async function reproduceCommand(jobId, options) {
+    const client = new SpectifyAPIClient(options.apiUrl);
+    const spinner = ora('Generating reproduction instructions...').start();
+    try {
+        const markdown = await client.getReproductionInstructions(jobId);
+        spinner.succeed('Reproduction instructions generated');
+        if (options.output) {
+            const fs = await import('fs/promises');
+            await fs.writeFile(options.output, markdown, 'utf-8');
+            console.log(chalk.green(`\n✓ Reproduction instructions saved to ${options.output}`));
+        }
+        else {
+            console.log('');
+            console.log(markdown);
+        }
+    }
+    catch (error) {
+        if (error instanceof ConnectionError)
+            throw error;
+        spinner.fail('Failed to generate reproduction instructions');
+        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=reproduce.js.map

package/build/cli/commands/reproduce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reproduce.js","sourceRoot":"","sources":["../../../src/cli/commands/reproduce.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAOtE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAAyB;IAC7E,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAErD,MAAM,OAAO,GAAG,GAAG,CAAC,yCAAyC,CAAC,CAAC,KAAK,EAAE,CAAC;IACvE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC;QACjE,OAAO,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;QAEvD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACvC,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,0CAA0C,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,eAAe;YAAE,MAAM,KAAK,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/build/cli/commands/reset.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Reset command - Reset terminal colors and formatting
+ */
+export declare function resetCommand(): Promise<void>;
+//# sourceMappingURL=reset.d.ts.map

package/build/cli/commands/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/reset.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CASlD"}

package/build/cli/commands/reset.js

@@ -0,0 +1,13 @@
+/**
+ * Reset command - Reset terminal colors and formatting
+ */
+export async function resetCommand() {
+    // Output ANSI reset sequence to clear all formatting
+    process.stdout.write('\x1b[0m\n');
+    console.log('Terminal colors reset.');
+    console.log('\nAlternatively, you can use these standard commands:');
+    console.log('  reset          - Full terminal reset');
+    console.log('  tput reset     - Reset terminal using terminfo');
+    console.log('  stty sane      - Reset terminal settings');
+}
+//# sourceMappingURL=reset.js.map

package/build/cli/commands/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.js","sourceRoot":"","sources":["../../../src/cli/commands/reset.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,qDAAqD;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAElC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;AAC5D,CAAC"}

package/build/cli/commands/results.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Results command - View detailed lint results
+ */
+export interface ResultsOptions {
+    apiUrl?: string;
+    rule?: string;
+    severity?: string;
+    format?: 'text' | 'json' | 'sarif';
+    output?: string;
+    json?: boolean;
+}
+export declare function resultsCommand(jobId: string, options: ResultsOptions): Promise<void>;
+//# sourceMappingURL=results.d.ts.map

package/build/cli/commands/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/results.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2H1F"}

package/build/cli/commands/results.js

@@ -0,0 +1,129 @@
+/**
+ * Results command - View detailed lint results
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { SpectifyAPIClient, ConnectionError } from '../api-client.js';
+import { HistoryManager } from '../history-manager.js';
+import { formatSummary, formatIssuesTable, formatRuleSummaryTable, formatRuleDetailView } from '../formatters.js';
+export async function resultsCommand(jobId, options) {
+    try {
+        const client = new SpectifyAPIClient(options.apiUrl);
+        // Handle SARIF report generation
+        if (options.output || options.format === 'sarif') {
+            const spinner = ora('Generating SARIF report...').start();
+            try {
+                const sarif = await client.generateReport(jobId, 'sarif');
+                spinner.succeed('SARIF report generated');
+                if (options.output) {
+                    // Write to file
+                    const fs = await import('fs/promises');
+                    await fs.writeFile(options.output, JSON.stringify(sarif, null, 2), 'utf-8');
+                    console.log(chalk.green(`\n✓ SARIF report saved to ${options.output}`));
+                }
+                else {
+                    // Output to stdout
+                    console.log(JSON.stringify(sarif, null, 2));
+                }
+                return;
+            }
+            catch (error) {
+                if (error instanceof ConnectionError)
+                    throw error;
+                spinner.fail('Failed to generate report');
+                console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+                process.exit(1);
+            }
+        }
+        // Try history first for faster access
+        const historyManager = new HistoryManager();
+        const historyEntry = await historyManager.getById(jobId);
+        // Fetch results from API
+        const spinner = ora('Fetching results...').start();
+        let results;
+        try {
+            results = await client.getJobResults(jobId);
+            spinner.succeed('Results retrieved');
+            // --json: output raw API response and exit
+            if (options.json) {
+                console.log(JSON.stringify(results, null, 2));
+                return;
+            }
+        }
+        catch (error) {
+            if (error instanceof ConnectionError)
+                throw error;
+            spinner.fail('Failed to get results');
+            // If API fails, check if we have it in history
+            if (historyEntry) {
+                console.log(chalk.yellow('Using cached results from history'));
+                console.log(chalk.dim(`File: ${historyEntry.filePath}`));
+                console.log(chalk.dim(`Ruleset: ${historyEntry.rulesetName} v${historyEntry.rulesetVersion}`));
+                console.log(chalk.dim(`Timestamp: ${new Date(historyEntry.timestamp).toLocaleString()}\n`));
+                console.log(chalk.yellow('Summary from history:'));
+                console.log(`Total Issues: ${historyEntry.summary.totalIssues}`);
+                console.log(`  Errors: ${historyEntry.summary.errorCount}`);
+                console.log(`  Warnings: ${historyEntry.summary.warningCount}`);
+                console.log(`  Info: ${historyEntry.summary.infoCount}`);
+                console.log(`  Hints: ${historyEntry.summary.hintCount}\n`);
+                console.log(chalk.dim('Note: Detailed results not available. Run lint again to see full details.'));
+                process.exit(0);
+            }
+            console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+            process.exit(1);
+        }
+        // Filter results
+        let filteredIssues = results.results || [];
+        if (options.rule) {
+            filteredIssues = filteredIssues.filter(issue => issue.ruleId === options.rule || issue.code === options.rule);
+        }
+        if (options.severity) {
+            const severityMap = {
+                error: 0,
+                warning: 1,
+                info: 2,
+                hint: 3,
+            };
+            const severityLevel = severityMap[options.severity.toLowerCase()];
+            if (severityLevel !== undefined) {
+                filteredIssues = filteredIssues.filter(issue => issue.severity === severityLevel);
+            }
+        }
+        // Display results
+        if (options.format === 'json') {
+            console.log(JSON.stringify({
+                ...results,
+                results: filteredIssues,
+            }, null, 2));
+        }
+        else {
+            // Gray out summary when showing rule details
+            console.log(formatSummary(results, options.rule ? true : false));
+            if (filteredIssues.length > 0) {
+                if (options.rule) {
+                    // Rule detail view: show issues for specific rule without repetition
+                    console.log(chalk.bold(`Filtered results (${filteredIssues.length} of ${results.results.length}):\n`));
+                    console.log(formatRuleDetailView(filteredIssues));
+                }
+                else if (options.severity) {
+                    // Severity filter: show detailed issues table
+                    console.log(chalk.dim(`Filtered results (${filteredIssues.length} of ${results.results.length}):\n`));
+                    console.log(formatIssuesTable(filteredIssues));
+                }
+                else {
+                    // Summary view: show issues grouped by rule
+                    console.log(chalk.bold('\nIssues by Rule:\n'));
+                    console.log(formatRuleSummaryTable(filteredIssues));
+                    console.log(chalk.dim(`\nTo see detailed issues for a specific rule, use: ${chalk.cyan('spectify results <jobId> --rule <ruleName>')}\n`));
+                }
+            }
+            else if (options.rule || options.severity) {
+                console.log(chalk.yellow('No issues match the specified filters.\n'));
+            }
+        }
+    }
+    catch (error) {
+        throw error;
+    }
+}
+//# sourceMappingURL=results.js.map

package/build/cli/commands/results.js.map

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

package/build/cli/commands/rulesets/check.d.ts

@@ -0,0 +1,12 @@
+export interface CheckRulesetsOptions {
+    /** Restrict the check to a single ruleset by name. */
+    name?: string;
+    /** Restrict the check to a single version. Requires --name. */
+    version?: string;
+    /** Override the catalogue directory (otherwise: SPECTIFYD_RULESETS_DIR or config default). */
+    rulesetsDirectory?: string;
+    /** Output format. */
+    format?: 'text' | 'json';
+}
+export declare function checkRulesetsCommand(options: CheckRulesetsOptions): Promise<void>;
+//# sourceMappingURL=check.d.ts.map

package/build/cli/commands/rulesets/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/rulesets/check.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,oBAAoB;IACjC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAmED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6HvF"}

package/build/cli/commands/rulesets/check.js

@@ -0,0 +1,226 @@
+// Copyright 2026 Cisco Systems, Inc. and its affiliates
+//
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * `spectify rulesets check` — load-only validation of a ruleset catalogue.
+ *
+ * Runs entirely in-process: no embedded server is started, no worker threads
+ * are spawned. For each `{ruleset, version}` selected, the command:
+ *
+ *   1. Reads the catalogue's `config/rulesets.yaml` (same code path as
+ *      `spectifyd` startup).
+ *   2. Resolves the version's entrypoint (or built-in token for embedded
+ *      origins).
+ *   3. Hands the entrypoint to Spectral's ruleset bundler (the exact same
+ *      call the worker pool makes when it instantiates a worker).
+ *   4. Reports success (with the rule count) or failure (with the bundler
+ *      error and an optional hint).
+ *
+ * Selection rules:
+ *   - no flags         → every ruleset, every configured version
+ *   - --name N         → every configured version of N
+ *   - --name N --version V → just that one entry
+ *   - --version V without --name → error
+ *
+ * Exit codes:
+ *   0  every selected ruleset loaded successfully
+ *   1  at least one selected ruleset failed to load
+ *   2  the catalogue itself could not be read (bad path, malformed YAML)
+ */
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import chalk from 'chalk';
+import { loadConfig } from '../../../config.js';
+import { RulesetLoader } from '../../../ruleset-loader.js';
+/**
+ * Heuristics that turn known load-failure messages into actionable hints.
+ * The original error is always preserved; the hint is purely advisory.
+ */
+function inferHint(message) {
+    // .ts entrypoint without a build step
+    if (/\.ts:/.test(message) && /Unexpected token/.test(message)) {
+        return 'Entrypoint points to a .ts file. The source tree probably needs to be built. Run `bash scripts/install.sh` (which builds JS sources after `npm install`).';
+    }
+    // CommonJS exports in a file Spectral's bundler is trying to parse as ESM.
+    // Spectral's bundler expects rulesets to be authored as ESM (or YAML);
+    // CJS build outputs from Babel / `tsc --module commonjs` will hit this.
+    if (/exports is not defined/.test(message) || /module is not defined/.test(message)) {
+        return 'Entrypoint appears to be a CommonJS module. Either rebuild the source repo as ESM (`--module esnext` or similar) so its dist is ESM, OR add `loader: native` to this version in `config/rulesets.yaml` to load it via Node\'s built-in `await import()` (which handles CJS transparently).';
+    }
+    // Sibling module not found — typically a missing build output
+    if (/Could not resolve '\.\//.test(message)) {
+        return 'A sibling module could not be resolved. The source tree may not be built. Run `bash scripts/install.sh`.';
+    }
+    // Missing npm dep
+    if (/Cannot find module/.test(message)) {
+        return 'An npm dependency is missing. Run `bash scripts/install.sh` in this catalogue.';
+    }
+    // Entrypoint path does not exist on disk
+    if (/Ruleset file not found/.test(message)) {
+        return 'The configured entrypoint does not exist on disk. Check `entrypoint` / `sourceVersion` in `config/rulesets.yaml`, then re-run `bash scripts/vendor.sh`.';
+    }
+    return undefined;
+}
+/**
+ * Resolve the catalogue directory. Precedence:
+ *   1. --rulesets-directory CLI flag
+ *   2. SPECTIFYD_RULESETS_DIR env var (applied by loadConfig)
+ *   3. The orchestrator's bundled default
+ */
+async function resolveRulesetsDirectory(override) {
+    if (override) {
+        return path.resolve(override);
+    }
+    const config = await loadConfig();
+    return config.rulesets.directory;
+}
+export async function checkRulesetsCommand(options) {
+    if (options.version && !options.name) {
+        console.error(chalk.red('Error: --version requires --name (cannot select a version across all rulesets).'));
+        process.exit(2);
+    }
+    const rulesetsDir = await resolveRulesetsDirectory(options.rulesetsDirectory);
+    const configPath = path.join(rulesetsDir, 'config', 'rulesets.yaml');
+    // Confirm the catalogue exists before instantiating the loader so we can
+    // emit a clean error rather than a stack trace.
+    try {
+        await fs.access(configPath);
+    }
+    catch {
+        console.error(chalk.red(`Error: ruleset catalogue not found at ${configPath}`));
+        console.error(chalk.dim('Set --rulesets-directory or SPECTIFYD_RULESETS_DIR to a directory that contains config/rulesets.yaml.'));
+        process.exit(2);
+    }
+    const loader = new RulesetLoader({
+        configPath,
+        sourcesBasePath: path.join(rulesetsDir, 'sources'),
+        // Caching would silently mask repeated failures across versions, and
+        // it has no benefit for a one-shot check.
+        enableCache: false,
+    });
+    try {
+        await loader.initialize();
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: failed to read ruleset catalogue at ${configPath}`));
+        console.error(chalk.red(`  ${error instanceof Error ? error.message : String(error)}`));
+        process.exit(2);
+    }
+    // Build the (ruleset, version) work list.
+    const all = loader.listRulesets();
+    let targets = [];
+    if (options.name) {
+        const entry = all.find(r => r.name === options.name);
+        if (!entry) {
+            console.error(chalk.red(`Error: ruleset '${options.name}' is not configured in ${configPath}.`));
+            console.error(chalk.dim(`Available: ${all.map(r => r.name).join(', ')}`));
+            process.exit(2);
+        }
+        const versions = options.version ? [options.version] : entry.versions;
+        if (options.version && !entry.versions.includes(options.version)) {
+            console.error(chalk.red(`Error: ruleset '${options.name}' has no version '${options.version}'.`));
+            console.error(chalk.dim(`Available versions: ${entry.versions.join(', ')}`));
+            process.exit(2);
+        }
+        targets = versions.map(v => ({ name: entry.name, origin: entry.origin, version: v }));
+    }
+    else {
+        for (const r of all) {
+            for (const v of r.versions) {
+                targets.push({ name: r.name, origin: r.origin, version: v });
+            }
+        }
+    }
+    const format = options.format ?? 'text';
+    if (format === 'text') {
+        console.log('');
+        console.log(`Checking ${targets.length} ruleset version${targets.length === 1 ? '' : 's'} in ${configPath}`);
+        console.log('');
+    }
+    const results = [];
+    for (const target of targets) {
+        const startedAt = Date.now();
+        let result;
+        try {
+            const loaded = await loader.loadVersion(target.name, target.version);
+            result = {
+                name: target.name,
+                version: target.version,
+                origin: target.origin,
+                status: 'ok',
+                durationMs: Date.now() - startedAt,
+                ruleCount: loaded.rules.length,
+                error: null,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const hint = inferHint(message);
+            result = {
+                name: target.name,
+                version: target.version,
+                origin: target.origin,
+                status: 'failed',
+                durationMs: Date.now() - startedAt,
+                ruleCount: null,
+                error: { message, ...(hint ? { hint } : {}) },
+            };
+        }
+        if (format === 'text') {
+            printResultLine(result);
+        }
+        results.push(result);
+    }
+    const okCount = results.filter(r => r.status === 'ok').length;
+    const failedCount = results.length - okCount;
+    if (format === 'json') {
+        const report = {
+            configPath,
+            summary: { total: results.length, ok: okCount, failed: failedCount },
+            results,
+        };
+        console.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        console.log('');
+        if (failedCount === 0) {
+            console.log(chalk.green(`Summary: ${okCount} ok, ${failedCount} failed`));
+        }
+        else {
+            console.log(chalk.red(`Summary: ${okCount} ok, ${failedCount} failed`));
+        }
+        console.log('');
+    }
+    process.exit(failedCount === 0 ? 0 : 1);
+}
+/**
+ * One-line-per-ruleset text formatter. Failed entries get the error message
+ * (and hint) indented below.
+ */
+function printResultLine(r) {
+    // 36-char label so the status column lines up. Names are short
+    // (kebab-case identifiers); long ones wrap rather than corrupting layout.
+    const label = `${r.name}@${r.version}`.padEnd(36);
+    const origin = `(${r.origin})`.padEnd(11);
+    const duration = `${r.durationMs}ms`.padStart(6);
+    if (r.status === 'ok') {
+        const rules = r.ruleCount !== null ? `${String(r.ruleCount).padStart(4)} rules` : '          ';
+        console.log(`  ${chalk.green('✅')} ${label} ${chalk.dim(origin)}  ${rules}  ${chalk.dim(duration)}`);
+        return;
+    }
+    console.log(`  ${chalk.red('❌')} ${label} ${chalk.dim(origin)}  ${chalk.red('FAILED'.padStart(10))}  ${chalk.dim(duration)}`);
+    if (r.error) {
+        const indent = '       ';
+        for (const line of r.error.message.split('\n')) {
+            console.log(`${indent}${chalk.red(line)}`);
+        }
+        if (r.error.hint) {
+            const hintLines = r.error.hint.split('\n');
+            console.log(`     ${chalk.yellow('→ Hint:')} ${hintLines[0]}`);
+            for (const line of hintLines.slice(1)) {
+                console.log(`${indent}${chalk.yellow(line)}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=check.js.map

package/build/cli/commands/rulesets/check.js.map

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

package/build/cli/commands/rulesets/index.d.ts

@@ -0,0 +1,5 @@
+export { viewRulesetsCommand } from './view.js';
+export type { ViewRulesetsOptions } from './view.js';
+export { checkRulesetsCommand } from './check.js';
+export type { CheckRulesetsOptions } from './check.js';
+//# sourceMappingURL=index.d.ts.map

package/build/cli/commands/rulesets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/rulesets/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/build/cli/commands/rulesets/index.js

@@ -0,0 +1,6 @@
+// Copyright 2026 Cisco Systems, Inc. and its affiliates
+//
+// SPDX-License-Identifier: Apache-2.0
+export { viewRulesetsCommand } from './view.js';
+export { checkRulesetsCommand } from './check.js';
+//# sourceMappingURL=index.js.map

package/build/cli/commands/rulesets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/commands/rulesets/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,sCAAsC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/build/cli/commands/rulesets/view.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `spectify rulesets view` - List available rulesets or view details of one.
+ *
+ * This command goes through the HTTP API (auto-starting an embedded
+ * orchestrator when needed) so that what is displayed matches what a remote
+ * client would see. For an in-process load-only validation that does not
+ * spin up a server, see `check.ts`.
+ */
+export interface ViewRulesetsOptions {
+    apiUrl?: string;
+    format?: 'table' | 'json';
+    name?: string;
+    version?: string;
+}
+export declare function viewRulesetsCommand(options: ViewRulesetsOptions): Promise<void>;
+//# sourceMappingURL=view.d.ts.map

package/build/cli/commands/rulesets/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/rulesets/view.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFrF"}

package/build/cli/commands/rulesets/view.js

@@ -0,0 +1,100 @@
+/**
+ * `spectify rulesets view` - List available rulesets or view details of one.
+ *
+ * This command goes through the HTTP API (auto-starting an embedded
+ * orchestrator when needed) so that what is displayed matches what a remote
+ * client would see. For an in-process load-only validation that does not
+ * spin up a server, see `check.ts`.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import Table from 'cli-table3';
+import { SpectifyAPIClient } from '../../api-client.js';
+import { formatRulesetsTable, formatSeverity } from '../../formatters.js';
+import { maybeStartEmbeddedServer, getApiUrl } from '../../utils/embedded-server.js';
+import { handleCommandError } from '../../utils/connection-error.js';
+export async function viewRulesetsCommand(options) {
+    // Auto-start embedded server if needed
+    const shutdownServer = await maybeStartEmbeddedServer(options.apiUrl);
+    let spinner;
+    try {
+        const apiUrl = await getApiUrl(options.apiUrl);
+        const client = new SpectifyAPIClient(apiUrl);
+        // If name is provided, show details for that ruleset
+        if (options.name) {
+            spinner = ora(`Fetching details for ruleset '${options.name}'...`).start();
+            const details = await client.getRulesetDetails(options.name, options.version);
+            spinner.succeed(`Found ruleset '${options.name}'`);
+            spinner = undefined;
+            if (options.format === 'json') {
+                console.log(JSON.stringify(details, null, 2));
+            }
+            else {
+                // Format as human-readable text
+                console.log('');
+                console.log(chalk.bold.cyan(`${details.displayName} (${details.name})`));
+                console.log(chalk.dim('─'.repeat(60)));
+                console.log(`Version:     ${details.version}`);
+                console.log(`Category:    ${details.category}`);
+                console.log(`Rules:       ${details.ruleCount}`);
+                if (details.releaseDate) {
+                    console.log(`Released:    ${details.releaseDate}`);
+                }
+                if (details.tags && details.tags.length > 0) {
+                    console.log(`Tags:        ${details.tags.join(', ')}`);
+                }
+                console.log('');
+                console.log(chalk.bold('Description:'));
+                console.log(details.description);
+                console.log('');
+                // Display rules in a table
+                console.log(chalk.bold('Rules:'));
+                const table = new Table({
+                    head: [
+                        chalk.bold('#'),
+                        chalk.bold('Rule Name'),
+                        chalk.bold('Severity'),
+                        chalk.bold('Description'),
+                    ],
+                    colWidths: [5, 40, 12, 50],
+                    wordWrap: true,
+                });
+                details.rules.forEach((rule, index) => {
+                    table.push([
+                        String(index + 1),
+                        chalk.cyan(rule.name),
+                        formatSeverity(rule.severity),
+                        rule.description || rule.message || '-',
+                    ]);
+                });
+                console.log(table.toString());
+                console.log('');
+            }
+        }
+        else {
+            // List all rulesets
+            spinner = ora('Fetching rulesets...').start();
+            const rulesets = await client.getRulesets();
+            spinner.succeed(`Found ${rulesets.length} rulesets`);
+            spinner = undefined;
+            if (options.format === 'json') {
+                console.log(JSON.stringify(rulesets, null, 2));
+            }
+            else {
+                console.log(chalk.bold('\nAvailable Rulesets\n'));
+                console.log(formatRulesetsTable(rulesets));
+                console.log(chalk.dim('Use `spectify rulesets <name>` to view detailed rules\n'));
+            }
+        }
+    }
+    catch (error) {
+        await handleCommandError(error);
+    }
+    finally {
+        // Shutdown embedded server if we started it
+        if (shutdownServer) {
+            await shutdownServer();
+        }
+    }
+}
+//# sourceMappingURL=view.js.map

package/build/cli/commands/rulesets/view.js.map

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