@vertaaux/cli 0.4.0 → 0.5.1

package/dist/commands/release-notes.js

@@ -12,28 +12,28 @@
  *   vertaa release-notes --file diff.json
  *   vertaa release-notes --job-a abc --job-b def
  */
-import chalk from "chalk";
+import { bold, dim, boldColor, brand, renderError, createRenderer, runSteps } from "@vertaaux/tui";
 import { ExitCode } from "../utils/exit-codes.js";
 import { resolveApiBase, getApiKey, apiRequest } from "../utils/client.js";
 import { resolveConfig } from "../config/loader.js";
-import { writeJsonOutput, writeOutput } from "../output/envelope.js";
+import { writeDataOutput, writeJsonOutput } from "../output/envelope.js";
 import { resolveCommandFormat } from "../output/formats.js";
-import { createSpinner, succeedSpinner } from "../ui/spinner.js";
 import { readJsonInput } from "../utils/stdin.js";
-import { handleAiCommandError, AI_TIMEOUT_MS } from "../utils/ai-error.js";
+import { AI_TIMEOUT_MS } from "../utils/ai-error.js";
+import { strings } from "../ui/strings.js";
 // ---------------------------------------------------------------------------
 // Formatters
 // ---------------------------------------------------------------------------
 function formatReleaseNotesHuman(data) {
     const lines = [];
-    lines.push(chalk.bold(data.headline));
+    lines.push(bold(data.headline));
     lines.push("");
-    lines.push(chalk.bold.blue("Developer Notes"));
-    lines.push(chalk.dim("─".repeat(40)));
+    lines.push(boldColor("Developer Notes", brand.teal));
+    lines.push(dim("─".repeat(40)));
     lines.push(data.developer_notes);
     lines.push("");
-    lines.push(chalk.bold.green("PM / User-Facing Notes"));
-    lines.push(chalk.dim("─".repeat(40)));
+    lines.push(boldColor("PM / User-Facing Notes", brand.lime));
+    lines.push(dim("─".repeat(40)));
     lines.push(data.pm_notes);
     return lines.join("\n");
 }
@@ -50,6 +50,111 @@ function formatReleaseNotesMarkdown(data) {
     lines.push(data.pm_notes);
     return lines.join("\n");
 }
+export async function handleReleaseNotes(opts) {
+    const config = { apiKey: opts.apiKey };
+    const format = resolveCommandFormat("release-notes", opts.format, opts.machine || false);
+    const renderer = createRenderer("auto");
+    const baseState = {
+        phase: "release-notes",
+        phaseIndex: 1,
+        phaseTotal: 2,
+        url: "",
+        mode: "release-notes",
+        progress: {},
+        totals: {},
+        issueCount: 0,
+        scorePreview: null,
+        verbose: false,
+        elapsed: 0,
+    };
+    const startTime = Date.now();
+    let responseData = null;
+    const steps = [
+        {
+            id: "fetch",
+            actionText: strings.releaseNotes.generate.action,
+            summaryText: "History loaded",
+            run: async () => {
+                let diffPayload;
+                if (opts.jobA && opts.jobB) {
+                    const base = resolveApiBase(opts.base);
+                    const apiKey = getApiKey(config.apiKey);
+                    const diffResult = await apiRequest(base, `/diff?job_a=${encodeURIComponent(opts.jobA)}&job_b=${encodeURIComponent(opts.jobB)}`, { method: "GET" }, apiKey);
+                    diffPayload = diffResult.data;
+                }
+                else {
+                    const input = await readJsonInput(opts.file);
+                    if (!input) {
+                        throw new Error("No diff data provided.\nUsage:\n  vertaa diff --job-a abc --job-b def --json | vertaa release-notes\n  vertaa release-notes --file diff.json\n  vertaa release-notes --job-a abc --job-b def");
+                    }
+                    const data = input;
+                    const innerData = (data.data && typeof data.data === "object" ? data.data : data);
+                    if (!Array.isArray(innerData.new) || !Array.isArray(innerData.fixed)) {
+                        throw new Error("Invalid diff data. Expected { new: [...], fixed: [...], summary: {...} }\nPipe from: vertaa diff --job-a abc --job-b def --json | vertaa release-notes");
+                    }
+                    diffPayload = {
+                        new: innerData.new,
+                        fixed: innerData.fixed,
+                        present: innerData.present || null,
+                        summary: innerData.summary || {
+                            newCount: innerData.new.length,
+                            fixedCount: innerData.fixed.length,
+                            presentCount: Array.isArray(innerData.present) ? innerData.present.length : null,
+                        },
+                    };
+                }
+                const base = resolveApiBase(opts.base);
+                const apiKey = getApiKey(config.apiKey);
+                const response = await Promise.race([
+                    apiRequest(base, "/cli/ai/release-notes", { method: "POST", body: { diff: diffPayload } }, apiKey),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error("LLM request timed out")), AI_TIMEOUT_MS)),
+                ]);
+                responseData = response.data;
+            },
+        },
+        {
+            id: "generate",
+            actionText: "Generating release notes...",
+            summaryText: strings.releaseNotes.generate.done(),
+            run: async () => {
+                // Notes generated in fetch step via API call
+            },
+        },
+    ];
+    const { success, states } = await runSteps(steps, {
+        onStateChange: (stepStates) => {
+            renderer.update({ ...baseState, stepStates, elapsed: Date.now() - startTime });
+        },
+    });
+    renderer.finish({
+        url: "",
+        mode: "release-notes",
+        overallScore: success ? 100 : 0,
+        scores: {},
+        issueCount: 0,
+        passed: success,
+        elapsed: Date.now() - startTime,
+    });
+    if (!success) {
+        const failed = states.find(s => s.status === "failed");
+        process.stderr.write(renderError({
+            message: failed?.failReason || "Command failed",
+            suggestion: "vertaa doctor",
+        }) + "\n");
+        process.exitCode = ExitCode.ERROR;
+    }
+    if (success && responseData) {
+        if (format === "json") {
+            writeJsonOutput(responseData, "release-notes");
+        }
+        else if (format === "markdown") {
+            writeDataOutput(formatReleaseNotesMarkdown(responseData));
+        }
+        else {
+            writeDataOutput(formatReleaseNotesHuman(responseData));
+        }
+    }
+}
 // ---------------------------------------------------------------------------
 // Command Registration
 // ---------------------------------------------------------------------------
@@ -72,73 +177,22 @@ Examples:
             const globalOpts = command.optsWithGlobals();
             const config = await resolveConfig(globalOpts.config);
             const machineMode = globalOpts.machine || false;
-            const format = resolveCommandFormat("release-notes", options.format, machineMode);
-            // Resolve diff data
-            let diffPayload;
-            if (options.jobA && options.jobB) {
-                // Fetch diff from two jobs via the diff API
-                const base = resolveApiBase(globalOpts.base);
-                const apiKey = getApiKey(config.apiKey);
-                const diffResult = await apiRequest(base, `/diff?job_a=${encodeURIComponent(options.jobA)}&job_b=${encodeURIComponent(options.jobB)}`, { method: "GET" }, apiKey);
-                diffPayload = diffResult.data;
-            }
-            else {
-                // Read from stdin or --file
-                const input = await readJsonInput(options.file);
-                if (!input) {
-                    console.error("Error: No diff data provided.");
-                    console.error("Usage:");
-                    console.error("  vertaa diff --job-a abc --job-b def --json | vertaa release-notes");
-                    console.error("  vertaa release-notes --file diff.json");
-                    console.error("  vertaa release-notes --job-a abc --job-b def");
-                    process.exit(ExitCode.ERROR);
-                }
-                const data = input;
-                const innerData = (data.data && typeof data.data === "object" ? data.data : data);
-                // Validate shape
-                if (!Array.isArray(innerData.new) || !Array.isArray(innerData.fixed)) {
-                    console.error("Error: Invalid diff data. Expected { new: [...], fixed: [...], summary: {...} }");
-                    console.error("Pipe from: vertaa diff --job-a abc --job-b def --json | vertaa release-notes");
-                    process.exit(ExitCode.ERROR);
-                }
-                diffPayload = {
-                    new: innerData.new,
-                    fixed: innerData.fixed,
-                    present: innerData.present || null,
-                    summary: innerData.summary || {
-                        newCount: innerData.new.length,
-                        fixedCount: innerData.fixed.length,
-                        presentCount: Array.isArray(innerData.present) ? innerData.present.length : null,
-                    },
-                };
-            }
-            // Auth check
-            const base = resolveApiBase(globalOpts.base);
-            const apiKey = getApiKey(config.apiKey);
-            // Call LLM release-notes API
-            const spinner = createSpinner("Generating release notes...");
-            try {
-                const response = await Promise.race([
-                    apiRequest(base, "/cli/ai/release-notes", { method: "POST", body: { diff: diffPayload } }, apiKey),
-                    new Promise((_, reject) => setTimeout(() => reject(new Error("LLM request timed out")), AI_TIMEOUT_MS)),
-                ]);
-                succeedSpinner(spinner, "Notes ready");
-                if (format === "json") {
-                    writeJsonOutput(response.data, "release-notes");
-                }
-                else if (format === "markdown") {
-                    writeOutput(formatReleaseNotesMarkdown(response.data));
-                }
-                else {
-                    writeOutput(formatReleaseNotesHuman(response.data));
-                }
-            }
-            catch (error) {
-                handleAiCommandError(error, "release-notes", spinner);
-            }
+            await handleReleaseNotes({
+                file: options.file,
+                jobA: options.jobA,
+                jobB: options.jobB,
+                format: options.format,
+                base: globalOpts.base,
+                machine: machineMode,
+                apiKey: config.apiKey,
+            });
         }
         catch (error) {
-            console.error("Error:", error instanceof Error ? error.message : String(error));
+            process.stderr.write(renderError({
+                message: error instanceof Error ? error.message : String(error),
+                suggestion: "vertaa audit <url>",
+                exitCode: ExitCode.ERROR,
+            }) + "\n");
             process.exit(ExitCode.ERROR);
         }
     });

package/dist/commands/scan.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Legacy scan command handler + shared runAuditCommand implementation.
+ * Provides the `scan` alias for audit and the shared audit runner for a11y/scan commands.
+ */
+import type { Command } from "commander";
+import type { Flags } from "../types.js";
+/**
+ * Shared audit runner used by a11y, scan, and related legacy commands.
+ */
+export declare function runAuditCommand(base: string, url: string, flags: Flags, label: "audit" | "scan" | "a11y"): Promise<void>;
+export declare function handleScan(rawUrl: string, cmdOptions: Flags): Promise<void>;
+export declare function registerScanCommand(program: Command): void;
+//# sourceMappingURL=scan.d.ts.map

package/dist/commands/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,iBA8DjC;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDjF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuB1D"}

package/dist/commands/scan.js

@@ -0,0 +1,133 @@
+/**
+ * Legacy scan command handler + shared runAuditCommand implementation.
+ * Provides the `scan` alias for audit and the shared audit runner for a11y/scan commands.
+ */
+import { renderError, runSteps, createRenderer } from "@vertaaux/tui";
+import { ExitCode } from "../utils/exit-codes.js";
+import { parseMode, parseTimeout, parseInterval, parseScore } from "../utils/validators.js";
+import { resolveApiBase, getString, getBool, getNumber, resolveFormat, createClient, } from "../utils/api-client.js";
+import { waitForAudit } from "../utils/client.js";
+import { normalizeIssues, getCategoryScore, getOverallScore, formatA11yMarkdown, formatAuditMarkdown, printOutput, } from "../utils/formatters.js";
+/**
+ * Shared audit runner used by a11y, scan, and related legacy commands.
+ */
+export async function runAuditCommand(base, url, flags, label) {
+    const mode = getString(flags, "mode") || "basic";
+    const timeout = getNumber(flags, "timeout");
+    const userAgent = getString(flags, "user-agent");
+    const engineVersion = getString(flags, "engine-version");
+    const failOnScore = getNumber(flags, "fail-on-score");
+    // Use SDK typed client for audit creation
+    const sdkClient = createClient({ base: getString(flags, "base") });
+    const created = await sdkClient.audits.create({
+        url,
+        mode: mode,
+        timeout,
+        user_agent: userAgent,
+        engine_version: engineVersion,
+        fail_on_score: failOnScore,
+    });
+    const format = resolveFormat(flags);
+    if (!getBool(flags, "wait")) {
+        const markdown = `## Audit queued\n- Job ID: ${created.job_id}\n- URL: ${created.url}\n- Mode: ${created.mode}`;
+        printOutput(format, created, markdown);
+        return;
+    }
+    if (!created.job_id) {
+        throw new Error("Audit response missing job_id");
+    }
+    const waitTimeout = getNumber(flags, "timeout") || 60000;
+    const interval = getNumber(flags, "interval") || 5000;
+    const result = await waitForAudit(sdkClient, created.job_id, waitTimeout, interval);
+    if (label === "a11y") {
+        const a11yScore = getCategoryScore(result.scores, "accessibility");
+        if (failOnScore !== undefined && a11yScore !== null && a11yScore < failOnScore) {
+            process.exitCode = 1;
+        }
+        const issues = normalizeIssues(result.issues).filter((issue) => {
+            const category = (issue.category || "").toLowerCase();
+            return (category.includes("accessibility") ||
+                category.includes("a11y") ||
+                category.includes("wcag"));
+        });
+        const payload = {
+            ...result,
+            accessibility_score: a11yScore,
+            accessibility_issues: issues,
+        };
+        printOutput(format, payload, formatA11yMarkdown(result));
+        return;
+    }
+    const overall = getOverallScore(result.scores);
+    if (failOnScore !== undefined && overall !== null && overall < failOnScore) {
+        process.exitCode = 1;
+    }
+    printOutput(format, result, formatAuditMarkdown(result));
+}
+export async function handleScan(rawUrl, cmdOptions) {
+    const url = /^https?:\/\//i.test(rawUrl) ? rawUrl : `https://${rawUrl}`;
+    const renderer = createRenderer("auto");
+    const baseState = {
+        phase: "scan",
+        phaseIndex: 1,
+        phaseTotal: 1,
+        url,
+        mode: "scan",
+        progress: {},
+        totals: {},
+        issueCount: 0,
+        scorePreview: null,
+        verbose: false,
+        elapsed: 0,
+    };
+    const startTime = Date.now();
+    const steps = [
+        {
+            id: "scan",
+            actionText: "Running UX scan...",
+            summaryText: "Scan complete",
+            run: async () => {
+                const base = resolveApiBase(cmdOptions);
+                await runAuditCommand(base, url, { ...cmdOptions, wait: cmdOptions.wait ?? true }, "scan");
+            },
+        },
+    ];
+    const { success, states } = await runSteps(steps, {
+        failFast: true,
+        onStateChange: (stepStates) => {
+            renderer.update({ ...baseState, stepStates, elapsed: Date.now() - startTime });
+        },
+    });
+    renderer.finish({ url, mode: "scan", overallScore: 0, scores: {}, issueCount: 0, passed: success, elapsed: Date.now() - startTime });
+    if (!success) {
+        const failed = states.find(s => s.status === "failed");
+        process.stderr.write(renderError({
+            message: failed?.failReason || "Command failed",
+            suggestion: "vertaa doctor",
+        }) + "\n");
+        process.exitCode = ExitCode.ERROR;
+    }
+}
+export function registerScanCommand(program) {
+    program
+        .command("scan <url>")
+        .description("Run UX scan (alias for audit)")
+        .option("--mode <mode>", "Audit depth: basic|standard|deep", parseMode, "basic")
+        .option("--wait", "Wait for audit completion")
+        .option("--timeout <ms>", "Wait timeout in milliseconds (1-300000)", parseTimeout, 60000)
+        .option("--interval <ms>", "Poll interval in milliseconds (1-300000)", parseInterval, 5000)
+        .option("--fail-on-score <n>", "Exit non-zero if score below n (0-100)", parseScore)
+        .action(async (url, cmdOptions) => {
+        try {
+            await handleScan(url, cmdOptions);
+        }
+        catch (error) {
+            process.stderr.write(renderError({
+                message: error instanceof Error ? error.message : String(error),
+                suggestion: "vertaa audit <url>",
+                exitCode: ExitCode.ERROR,
+            }) + "\n");
+            process.exit(ExitCode.ERROR);
+        }
+    });
+}

package/dist/commands/status.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Legacy status command handler.
+ * Gets the status of an audit job.
+ */
+import type { Command } from "commander";
+import type { Flags } from "../types.js";
+export declare function handleStatus(jobId: string, cmdOptions: Flags): Promise<void>;
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDlF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmB5D"}

package/dist/commands/status.js

@@ -0,0 +1,81 @@
+/**
+ * Legacy status command handler.
+ * Gets the status of an audit job.
+ */
+import { renderError, runSteps, createRenderer } from "@vertaaux/tui";
+import { ExitCode } from "../utils/exit-codes.js";
+import { parseScore } from "../utils/validators.js";
+import { resolveApiBase, resolveFormat, getNumber, createClient, } from "../utils/api-client.js";
+import { getOverallScore, formatAuditMarkdown, printOutput, } from "../utils/formatters.js";
+export async function handleStatus(jobId, cmdOptions) {
+    const renderer = createRenderer("auto");
+    const baseState = {
+        phase: "status",
+        phaseIndex: 1,
+        phaseTotal: 1,
+        url: "",
+        mode: "status",
+        progress: {},
+        totals: {},
+        issueCount: 0,
+        scorePreview: null,
+        verbose: false,
+        elapsed: 0,
+    };
+    const startTime = Date.now();
+    const steps = [
+        {
+            id: "fetch",
+            actionText: "Fetching audit status...",
+            summaryText: "Audit status retrieved",
+            run: async () => {
+                const base = resolveApiBase(cmdOptions);
+                const client = createClient({ base: base });
+                const result = await client.audits.retrieve(jobId);
+                const format = resolveFormat(cmdOptions);
+                const overall = getOverallScore(result.scores);
+                const payload = { ...result, overall_score: overall };
+                const markdown = formatAuditMarkdown(result);
+                const failOnScore = getNumber(cmdOptions, "fail-on-score");
+                if (failOnScore !== undefined && overall !== null && overall < failOnScore) {
+                    process.exitCode = 1;
+                }
+                printOutput(format, payload, markdown);
+            },
+        },
+    ];
+    const { success, states } = await runSteps(steps, {
+        failFast: true,
+        onStateChange: (stepStates) => {
+            renderer.update({ ...baseState, stepStates, elapsed: Date.now() - startTime });
+        },
+    });
+    renderer.finish({ url: "", mode: "status", overallScore: 0, scores: {}, issueCount: 0, passed: success, elapsed: Date.now() - startTime });
+    if (!success) {
+        const failed = states.find(s => s.status === "failed");
+        process.stderr.write(renderError({
+            message: failed?.failReason || "Command failed",
+            suggestion: "vertaa doctor",
+        }) + "\n");
+        process.exitCode = ExitCode.ERROR;
+    }
+}
+export function registerStatusCommand(program) {
+    program
+        .command("status <jobId>")
+        .description("Get status of an audit job")
+        .option("--fail-on-score <n>", "Exit non-zero if score below n (0-100)", parseScore)
+        .action(async (jobId, cmdOptions) => {
+        try {
+            await handleStatus(jobId, cmdOptions);
+        }
+        catch (error) {
+            process.stderr.write(renderError({
+                message: error instanceof Error ? error.message : String(error),
+                suggestion: "vertaa doctor",
+                exitCode: ExitCode.ERROR,
+            }) + "\n");
+            process.exit(ExitCode.ERROR);
+        }
+    });
+}

package/dist/commands/suggest.d.ts

@@ -11,6 +11,16 @@
  *   vertaa suggest "set up CI quality gate"
  */
 import { Command } from "commander";
+export interface SuggestCommandOptions {
+    intent: string;
+    format?: string;
+    strict?: boolean;
+    continueOnError?: boolean;
+    machine?: boolean;
+    base?: string;
+    apiKey?: string;
+}
+export declare function handleSuggest(opts: SuggestCommandOptions): Promise<void>;
 /**
  * Register the suggest command with the Commander program.
  */

package/dist/commands/suggest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/commands/suggest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoDpC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqH7D"}
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/commands/suggest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6FpC,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiJ9E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2C7D"}