@vertaaux/cli 0.2.2 → 0.3.0

package/dist/policy/sync.js

@@ -0,0 +1,147 @@
+/**
+ * Policy push/pull sync module for VertaaUX CLI.
+ *
+ * Provides bidirectional sync between local policy files and the server API.
+ * Uses the established CLI API patterns (resolveApiBase, getApiKey, apiRequest).
+ *
+ * Implements POL-10: Policy push/pull sync.
+ */
+import { resolveApiBase, getApiKey, apiRequest } from "../utils/client.js";
+/**
+ * Build sync config from CLI config and environment.
+ * Uses the established CLI pattern: resolveApiBase + getApiKey.
+ */
+export function buildSyncConfig(cliConfig) {
+    return {
+        apiBase: resolveApiBase(undefined, undefined),
+        apiKey: getApiKey(cliConfig?.apiKey),
+    };
+}
+/**
+ * Push a local policy file to the server.
+ *
+ * If a policy with the given name already exists, updates it (with optional
+ * optimistic locking via expectedVersion). Otherwise creates a new policy.
+ *
+ * @param policy - The policy content to push
+ * @param config - API connection config
+ * @param options - Push options (name, description, force, etc.)
+ * @returns Push result with success status, policy ID, and version
+ */
+export async function pushPolicy(policy, config, options) {
+    try {
+        // First, try to find existing policy by name
+        const listData = await apiRequest(config.apiBase, "/policies", { method: "GET" }, config.apiKey);
+        const existing = listData.policies?.find((p) => p.name === options.name);
+        if (existing) {
+            // Update existing policy
+            const body = {
+                content: policy,
+                changeMessage: options.changeMessage || "Pushed from CLI",
+            };
+            if (options.expectedVersion && !options.force) {
+                body.expectedVersion = options.expectedVersion;
+            }
+            try {
+                const updated = await apiRequest(config.apiBase, `/policies/${existing.id}`, { method: "PUT", body }, config.apiKey);
+                return {
+                    success: true,
+                    policyId: existing.id,
+                    version: updated.latestVersion || 0,
+                    created: false,
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                if (message.includes("409")) {
+                    return {
+                        success: false,
+                        policyId: existing.id,
+                        version: existing.latestVersion || 0,
+                        created: false,
+                        error: "Policy has been modified on server. Pull latest first, or use --force.",
+                    };
+                }
+                throw err;
+            }
+        }
+        else {
+            // Create new policy
+            const created = await apiRequest(config.apiBase, "/policies", {
+                method: "POST",
+                body: {
+                    name: options.name,
+                    description: options.description,
+                    content: policy,
+                },
+            }, config.apiKey);
+            return {
+                success: true,
+                policyId: created.id || "",
+                version: 1,
+                created: true,
+            };
+        }
+    }
+    catch (err) {
+        return {
+            success: false,
+            policyId: "",
+            version: 0,
+            created: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Pull a policy from the server.
+ *
+ * Finds the policy by ID, name, or defaults to the default/first policy.
+ * Returns the full policy content for writing to a local file.
+ *
+ * @param config - API connection config
+ * @param options - Pull options (policyId or policyName)
+ * @returns Pull result with policy content and metadata
+ */
+export async function pullPolicy(config, options) {
+    try {
+        let policyId = options.policyId;
+        // If no ID, find by name or get default
+        if (!policyId) {
+            const listData = await apiRequest(config.apiBase, "/policies", { method: "GET" }, config.apiKey);
+            if (options.policyName) {
+                const found = listData.policies?.find((p) => p.name === options.policyName);
+                if (!found) {
+                    return {
+                        success: false,
+                        error: `Policy "${options.policyName}" not found on server`,
+                    };
+                }
+                policyId = found.id;
+            }
+            else {
+                const defaultPolicy = listData.policies?.find((p) => p.isDefault);
+                const target = defaultPolicy || listData.policies?.[0];
+                if (!target) {
+                    return { success: false, error: "No policies found on server" };
+                }
+                policyId = target.id;
+            }
+        }
+        // Fetch full policy with content
+        const data = await apiRequest(config.apiBase, `/policies/${policyId}`, { method: "GET" }, config.apiKey);
+        return {
+            success: true,
+            policy: data.content,
+            policyId: data.id || policyId,
+            version: data.latestVersion,
+            name: data.name,
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}

package/dist/prompts/command-catalog.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Command catalog for the `suggest` command.
+ *
+ * Maps natural-language intents to exact CLI commands.
+ * Used for local fuzzy matching before falling back to LLM API.
+ */
+export interface CatalogEntry {
+    /** Exact CLI command to run */
+    command: string;
+    /** Short explanation of what the command does */
+    description: string;
+    /** Keywords that trigger this entry */
+    keywords: string[];
+}
+/**
+ * Full command catalog for VertaaUX CLI.
+ *
+ * Each entry has keywords that are matched against user intent
+ * using simple substring/word-overlap scoring.
+ */
+export declare const COMMAND_CATALOG: CatalogEntry[];
+/**
+ * Score a catalog entry against user intent.
+ *
+ * Uses a combined scoring approach:
+ * - Each exact keyword match earns 1 point (multi-word keywords earn 2)
+ * - Partial word overlap earns fractional points
+ * - Final score = matchPoints / max(totalWeight, 3) to avoid penalizing
+ *   entries with many keywords when only a few match.
+ *
+ * Returns a number between 0 and 1 where higher = better match.
+ */
+export declare function scoreMatch(intent: string, entry: CatalogEntry): number;
+/**
+ * Find the best matching command(s) for a user intent.
+ *
+ * @param intent - Natural language intent from the user
+ * @param threshold - Minimum score to include (0-1)
+ * @param maxResults - Maximum number of results to return
+ * @returns Sorted matches with scores
+ */
+export declare function findMatches(intent: string, threshold?: number, maxResults?: number): Array<{
+    entry: CatalogEntry;
+    score: number;
+}>;
+//# sourceMappingURL=command-catalog.d.ts.map

package/dist/prompts/command-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../src/prompts/command-catalog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,YAAY,EAwIzC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAuBtE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,SAAS,SAAM,EACf,UAAU,SAAI,GACb,KAAK,CAAC;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAU/C"}

package/dist/prompts/command-catalog.js

@@ -0,0 +1,187 @@
+/**
+ * Command catalog for the `suggest` command.
+ *
+ * Maps natural-language intents to exact CLI commands.
+ * Used for local fuzzy matching before falling back to LLM API.
+ */
+/**
+ * Full command catalog for VertaaUX CLI.
+ *
+ * Each entry has keywords that are matched against user intent
+ * using simple substring/word-overlap scoring.
+ */
+export const COMMAND_CATALOG = [
+    // --- Audit Commands ---
+    {
+        command: "vertaa audit <url> --wait",
+        description: "Run a UX audit on a URL and wait for results",
+        keywords: ["audit", "scan", "check", "test", "run", "url", "website", "page", "site"],
+    },
+    {
+        command: "vertaa audit <url> --mode standard --wait",
+        description: "Run a standard-depth audit (more thorough than basic)",
+        keywords: ["standard", "thorough", "detailed", "full", "deep scan"],
+    },
+    {
+        command: "vertaa audit <url> --mode deep --wait",
+        description: "Run a deep audit with maximum coverage",
+        keywords: ["deep", "comprehensive", "maximum", "everything", "all checks"],
+    },
+    {
+        command: "vertaa audit <url> --wait --json",
+        description: "Run an audit and output JSON for piping to other commands",
+        keywords: ["json", "pipe", "machine", "ci", "scripting", "output json", "structured"],
+    },
+    {
+        command: "vertaa audit <url> --wait --fail-on-score 80",
+        description: "Run audit and fail CI if score is below 80",
+        keywords: ["ci", "gate", "fail", "threshold", "score", "pipeline", "quality gate"],
+    },
+    // --- Accessibility ---
+    {
+        command: "vertaa a11y <url> --wait",
+        description: "Run accessibility-focused audit",
+        keywords: ["accessibility", "a11y", "wcag", "aria", "screen reader", "accessible"],
+    },
+    {
+        command: "vertaa audit <url> --wait --json | vertaa explain",
+        description: "Audit a site and get an AI explanation of findings",
+        keywords: ["explain", "understand", "what", "why", "summary", "meaning"],
+    },
+    // --- Contrast & Color ---
+    {
+        command: "vertaa audit <url> --wait --json | vertaa triage",
+        description: "Audit and prioritize findings by severity",
+        keywords: ["contrast", "color", "triage", "prioritize", "priority", "important", "critical", "p0"],
+    },
+    // --- Compare ---
+    {
+        command: "vertaa compare <urlA> <urlB> --wait",
+        description: "Compare UX audits of two URLs",
+        keywords: ["compare", "diff", "versus", "vs", "difference", "before after", "regression"],
+    },
+    // --- Explain ---
+    {
+        command: "vertaa explain <finding-id> --job <job-id>",
+        description: "Show detailed evidence for a specific finding",
+        keywords: ["explain", "finding", "evidence", "detail", "issue", "specific"],
+    },
+    // --- Triage ---
+    {
+        command: "vertaa audit <url> --wait --json | vertaa triage",
+        description: "Prioritize audit findings into P0/P1/P2 buckets with effort estimates",
+        keywords: ["triage", "prioritize", "priority", "bucket", "effort", "plan", "what first"],
+    },
+    // --- Fix ---
+    {
+        command: "vertaa fix <jobId> --issue <id> --file-content \"...\"",
+        description: "Generate an auto-fix patch for a specific issue",
+        keywords: ["fix", "patch", "auto-fix", "repair", "resolve", "remediate"],
+    },
+    {
+        command: "vertaa fix-all <jobId> --file-content \"...\"",
+        description: "Generate fix patches for all issues in an audit",
+        keywords: ["fix all", "batch", "all issues", "bulk fix"],
+    },
+    // --- Diff ---
+    {
+        command: "vertaa diff --job-a <id> --job-b <id>",
+        description: "Compare two audit jobs to see what changed",
+        keywords: ["diff", "delta", "change", "compare jobs", "what changed"],
+    },
+    // --- Baseline ---
+    {
+        command: "vertaa baseline save",
+        description: "Save current audit results as a baseline for future comparison",
+        keywords: ["baseline", "save", "snapshot", "reference", "lock"],
+    },
+    // --- Policy ---
+    {
+        command: "vertaa policy show",
+        description: "Show the current audit policy configuration",
+        keywords: ["policy", "rules", "config", "configuration", "show policy"],
+    },
+    // --- Init & Setup ---
+    {
+        command: "vertaa init",
+        description: "Initialize a new VertaaUX project with configuration file",
+        keywords: ["init", "setup", "start", "new", "configure", "initialize", "create config"],
+    },
+    {
+        command: "vertaa login",
+        description: "Authenticate with VertaaUX API",
+        keywords: ["login", "auth", "authenticate", "sign in", "connect", "api key"],
+    },
+    {
+        command: "vertaa doctor",
+        description: "Run diagnostics on CLI configuration and connectivity",
+        keywords: ["doctor", "diagnostic", "health", "check", "debug", "troubleshoot", "problem"],
+    },
+    // --- Comment ---
+    {
+        command: "vertaa comment --job <id> --github-pr <number>",
+        description: "Post audit results as a GitHub PR comment",
+        keywords: ["comment", "pr", "pull request", "github", "gitlab", "post"],
+    },
+    // --- Upload/Download ---
+    {
+        command: "vertaa upload --file baseline.json",
+        description: "Upload a baseline file to the VertaaUX API",
+        keywords: ["upload", "push", "send"],
+    },
+    {
+        command: "vertaa download --job <id> --output results.json",
+        description: "Download audit results to a local file",
+        keywords: ["download", "pull", "fetch", "get", "save results"],
+    },
+];
+/**
+ * Score a catalog entry against user intent.
+ *
+ * Uses a combined scoring approach:
+ * - Each exact keyword match earns 1 point (multi-word keywords earn 2)
+ * - Partial word overlap earns fractional points
+ * - Final score = matchPoints / max(totalWeight, 3) to avoid penalizing
+ *   entries with many keywords when only a few match.
+ *
+ * Returns a number between 0 and 1 where higher = better match.
+ */
+export function scoreMatch(intent, entry) {
+    const lower = intent.toLowerCase();
+    const words = lower.split(/\s+/).filter(Boolean);
+    let matchPoints = 0;
+    for (const keyword of entry.keywords) {
+        const kw = keyword.toLowerCase();
+        const weight = kw.includes(" ") ? 2 : 1;
+        if (lower.includes(kw)) {
+            matchPoints += weight;
+        }
+        else {
+            // Partial word overlap
+            const kwWords = kw.split(/\s+/);
+            const overlap = kwWords.filter((w) => words.includes(w)).length / kwWords.length;
+            matchPoints += weight * overlap * 0.5;
+        }
+    }
+    // Normalize: divide by a minimum of 3 so that 1 exact match = 0.33 (above threshold)
+    const normalizer = Math.max(entry.keywords.length, 3);
+    return normalizer > 0 ? Math.min(matchPoints / normalizer, 1) : 0;
+}
+/**
+ * Find the best matching command(s) for a user intent.
+ *
+ * @param intent - Natural language intent from the user
+ * @param threshold - Minimum score to include (0-1)
+ * @param maxResults - Maximum number of results to return
+ * @returns Sorted matches with scores
+ */
+export function findMatches(intent, threshold = 0.1, maxResults = 3) {
+    const scored = COMMAND_CATALOG.map((entry) => ({
+        entry,
+        score: scoreMatch(intent, entry),
+    }));
+    return scored
+        .filter((m) => m.score >= threshold)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxResults);
+}

package/dist/ui/spinner.d.ts

@@ -1,61 +1,36 @@
 /**
  * Progress spinner wrapper for CLI.
  *
- * Provides a consistent interface for showing progress during long-running operations.
- * Uses ora for elegant terminal spinners with TTY detection.
+ * Delegates to @vertaaux/tui for consistent terminal rendering.
+ * Writes ONLY to stderr — never pollutes stdout.
  */
-import { type Ora } from "ora";
-export interface SpinnerOptions {
-    /** Initial text to display */
-    text: string;
-    /** Color for the spinner (default: brand lime) */
-    color?: string;
-}
+import { type SpinnerInstance } from "@vertaaux/tui";
+export type { SpinnerInstance };
 /**
  * Create a new spinner instance.
  *
  * Spinner only displays in TTY mode. In non-TTY environments,
  * returns a no-op spinner that still tracks state.
- *
- * @param text - Initial text to display next to spinner
- * @returns An ora spinner instance
  */
-export declare function createSpinner(text: string): Ora;
+export declare function createSpinner(text: string): SpinnerInstance;
 /**
  * Update spinner text with optional progress indicator.
- *
- * @param spinner - The spinner instance to update
- * @param text - New text to display
- * @param current - Current progress count (optional)
- * @param total - Total items count (optional)
  */
-export declare function updateSpinner(spinner: Ora, text: string, current?: number, total?: number): void;
+export declare function updateSpinner(spinner: SpinnerInstance, text: string, current?: number, total?: number): void;
 /**
  * Complete spinner with success state.
- *
- * @param spinner - The spinner instance
- * @param text - Success message to display
  */
-export declare function succeedSpinner(spinner: Ora, text: string): void;
+export declare function succeedSpinner(spinner: SpinnerInstance, text: string): void;
 /**
  * Complete spinner with failure state.
- *
- * @param spinner - The spinner instance
- * @param text - Failure message to display
  */
-export declare function failSpinner(spinner: Ora, text: string): void;
+export declare function failSpinner(spinner: SpinnerInstance, text: string): void;
 /**
  * Complete spinner with warning state.
- *
- * @param spinner - The spinner instance
- * @param text - Warning message to display
  */
-export declare function warnSpinner(spinner: Ora, text: string): void;
+export declare function warnSpinner(spinner: SpinnerInstance, text: string): void;
 /**
  * Complete spinner with info state.
- *
- * @param spinner - The spinner instance
- * @param text - Info message to display
  */
-export declare function infoSpinner(spinner: Ora, text: string): void;
+export declare function infoSpinner(spinner: SpinnerInstance, text: string): void;
 //# sourceMappingURL=spinner.d.ts.map

package/dist/ui/spinner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAapC,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAiB/C;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAcN;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5D"}
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAE3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE3E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAExE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAExE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAExE"}

package/dist/ui/spinner.js

@@ -1,101 +1,54 @@
 /**
  * Progress spinner wrapper for CLI.
  *
- * Provides a consistent interface for showing progress during long-running operations.
- * Uses ora for elegant terminal spinners with TTY detection.
+ * Delegates to @vertaaux/tui for consistent terminal rendering.
+ * Writes ONLY to stderr — never pollutes stdout.
  */
-import ora from "ora";
-import chalk from "chalk";
-import { isTTY, shouldUseColor } from "../utils/detect-env.js";
-// Spinner style - classic dots for clean look
-const SPINNER_STYLE = {
-    frames: ["\u2807", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"],
-    interval: 80,
-};
-// Brand color for spinner
-const BRAND_COLOR = "#78FFB4";
+import { createSpinner as tuiCreateSpinner, } from "@vertaaux/tui";
 /**
  * Create a new spinner instance.
  *
  * Spinner only displays in TTY mode. In non-TTY environments,
  * returns a no-op spinner that still tracks state.
- *
- * @param text - Initial text to display next to spinner
- * @returns An ora spinner instance
  */
 export function createSpinner(text) {
-    const useColor = shouldUseColor();
-    const spinner = ora({
-        text,
-        spinner: SPINNER_STYLE,
-        color: "cyan",
-        isEnabled: isTTY(),
-        stream: process.stderr, // Write to stderr to avoid mixing with command output
-    });
-    // Apply brand color if colors are enabled
-    if (useColor) {
-        spinner.color = "cyan";
-    }
-    return spinner;
+    return tuiCreateSpinner(text);
 }
 /**
  * Update spinner text with optional progress indicator.
- *
- * @param spinner - The spinner instance to update
- * @param text - New text to display
- * @param current - Current progress count (optional)
- * @param total - Total items count (optional)
  */
 export function updateSpinner(spinner, text, current, total) {
     if (current !== undefined && total !== undefined) {
-        const progress = shouldUseColor()
-            ? chalk.dim(`(${current}/${total})`)
-            : `(${current}/${total})`;
-        spinner.text = `${text} ${progress}`;
+        spinner.setText(`${text} (${current}/${total})`);
     }
     else if (current !== undefined) {
-        const progress = shouldUseColor()
-            ? chalk.dim(`(${current})`)
-            : `(${current})`;
-        spinner.text = `${text} ${progress}`;
+        spinner.setText(`${text} (${current})`);
     }
     else {
-        spinner.text = text;
+        spinner.setText(text);
     }
 }
 /**
  * Complete spinner with success state.
- *
- * @param spinner - The spinner instance
- * @param text - Success message to display
  */
 export function succeedSpinner(spinner, text) {
-    spinner.succeed(shouldUseColor() ? chalk.green(text) : text);
+    spinner.succeed(text);
 }
 /**
  * Complete spinner with failure state.
- *
- * @param spinner - The spinner instance
- * @param text - Failure message to display
  */
 export function failSpinner(spinner, text) {
-    spinner.fail(shouldUseColor() ? chalk.red(text) : text);
+    spinner.fail(text);
 }
 /**
  * Complete spinner with warning state.
- *
- * @param spinner - The spinner instance
- * @param text - Warning message to display
  */
 export function warnSpinner(spinner, text) {
-    spinner.warn(shouldUseColor() ? chalk.yellow(text) : text);
+    spinner.warn(text);
 }
 /**
  * Complete spinner with info state.
- *
- * @param spinner - The spinner instance
- * @param text - Info message to display
  */
 export function infoSpinner(spinner, text) {
-    spinner.info(shouldUseColor() ? chalk.cyan(text) : text);
+    spinner.info(text);
 }

package/dist/ui/table.d.ts

@@ -1,7 +1,7 @@
 /**
  * Table formatting utilities for CLI output.
  *
- * Uses cli-table3 for clean table rendering with severity-based coloring.
+ * Delegates to @vertaaux/tui for consistent rendering with severity-based coloring.
  * Respects terminal width and provides truncation for long content.
  */
 export interface Issue {
@@ -33,31 +33,14 @@ export declare function groupBySeverity(issues: Issue[]): Map<string, Issue[]>;
 export declare function groupByCategory(issues: Issue[]): Map<string, Issue[]>;
 /**
  * Format issues into a table string.
- *
- * Columns: Severity | ID | Description | Selector (optional)
- * Issues are sorted by severity (critical -> info).
- *
- * @param issues - Array of issues to format
- * @param options - Formatting options
- * @returns Formatted table string
  */
 export declare function formatIssuesTable(issues: Issue[], options?: FormatTableOptions): string;
-export interface Score {
-    category: string;
-    score: number;
-}
 /**
  * Format scores into a table string.
- *
- * @param scores - Object mapping category names to scores
- * @returns Formatted table string
  */
 export declare function formatScoresTable(scores: Record<string, number | unknown>): string;
 /**
  * Format a summary line showing issue counts by severity.
- *
- * @param issues - Array of issues
- * @returns Summary string like "3 critical, 5 serious, 12 minor issues"
  */
 export declare function formatIssueSummary(issues: Issue[]): string;
 //# sourceMappingURL=table.d.ts.map

package/dist/ui/table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/ui/table.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuCH,MAAM,WAAW,KAAK;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAqCD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAWrE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAWrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAoER;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,CAyClF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAkC1D"}
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/ui/table.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,WAAW,KAAK;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAaD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CASrE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CASrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAuCR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,CA2BlF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CA4B1D"}