@vertaaux/cli 0.3.3 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertaaux/cli",
-  "version": "0.3.3",
+  "version": "0.5.0",
   "description": "Run automated UX audits, accessibility checks, and performance analysis from the terminal or CI pipelines. Supports policy gating, SARIF output, and multi-page crawling. See https://github.com/PetriLahdelma/vertaa/tree/main/cli#readme for full docs.",
   "type": "module",
   "main": "dist/index.js",
@@ -10,7 +10,9 @@
   "files": [
     "dist",
     "schemas",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md",
+    "MIGRATION.md"
   ],
   "keywords": [
     "vertaaux",
@@ -24,7 +26,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/PetriLahdelma/vertaa",
+    "url": "git+https://github.com/PetriLahdelma/vertaa.git",
     "directory": "cli"
   },
   "homepage": "https://vertaaux.ai",
@@ -33,7 +35,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "bundleDependencies": [
     "@vertaaux/tui"
@@ -42,14 +44,18 @@
     "build": "tsc",
     "dev": "tsc -w",
     "start": "node dist/index.js",
+    "postinstall": "node scripts/fix-node-pty-permissions.mjs 2>/dev/null || true",
     "prepublishOnly": "npm run build && node scripts/verify-package.mjs",
     "test": "vitest run --config vitest.config.ts --exclude tests/e2e/**/*.test.ts",
     "test:e2e": "vitest run --config vitest.config.ts tests/e2e/cli-contract.test.ts",
     "test:e2e:package": "vitest run --config vitest.config.ts tests/e2e/package-install.test.ts",
-    "test:e2e:ui": "vitest --ui --config vitest.config.ts tests/e2e/cli-contract.test.ts"
+    "test:e2e:ui": "vitest --ui --config vitest.config.ts tests/e2e/cli-contract.test.ts",
+    "test:pty": "vitest run --config vitest.config.pty.ts",
+    "test:snapshot": "vitest run --config vitest.config.snapshot.ts"
   },
   "dependencies": {
     "@inquirer/prompts": "^8.2.0",
+    "@vertaaux/sdk": "1.0.0",
     "@vertaaux/tui": "file:../packages/tui",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
@@ -66,6 +72,8 @@
     "@types/node": "^20.11.25",
     "@types/semver": "^7.7.1",
     "@vitest/ui": "^4.0.18",
+    "node-pty": "^1.1.0",
+    "strip-ansi": "^7.2.0",
     "typescript": "^5.6.3",
     "vitest": "^4.0.15"
   }

package/dist/commands/client.d.ts

@@ -1,14 +0,0 @@
-/**
- * Client management commands for VertaaUX CLI.
- *
- * Provides agency client CRUD operations and batch auditing
- * across client URL portfolios with bounded concurrency.
- *
- * Implements 46-06: CLI client management and batch audit.
- */
-import { Command } from "commander";
-/**
- * Register the client command with the Commander program.
- */
-export declare function registerClientCommand(program: Command): void;
-//# sourceMappingURL=client.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/commands/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0HpC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwX5D"}

package/dist/commands/client.js

@@ -1,362 +0,0 @@
-/**
- * Client management commands for VertaaUX CLI.
- *
- * Provides agency client CRUD operations and batch auditing
- * across client URL portfolios with bounded concurrency.
- *
- * Implements 46-06: CLI client management and batch audit.
- */
-import chalk from "chalk";
-import pLimit from "p-limit";
-import { resolveApiBase, getApiKey, apiRequest } from "../utils/client.js";
-/**
- * Auto-generate a URL-friendly slug from a name.
- */
-function generateSlug(name) {
-    return name
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-|-$/g, "");
-}
-/**
- * Determine if an identifier looks like a CUID (starts with 'c' followed by alphanumerics).
- */
-function looksLikeCuid(identifier) {
-    return /^c[a-z0-9]{20,}$/i.test(identifier);
-}
-/**
- * Resolve API connection settings.
- * Reads from environment variables (standard CLI pattern).
- */
-function resolveConnection() {
-    return {
-        base: resolveApiBase(),
-        apiKey: getApiKey(),
-    };
-}
-/**
- * Format a date string for display.
- */
-function formatDate(dateStr) {
-    try {
-        const d = new Date(dateStr);
-        return d.toISOString().split("T")[0];
-    }
-    catch {
-        return dateStr;
-    }
-}
-/**
- * Wait for an audit to complete by polling the status endpoint.
- */
-async function waitForAuditCompletion(base, apiKey, jobId, timeoutMs = 120000, intervalMs = 3000) {
-    const start = Date.now();
-    while (true) {
-        const status = await apiRequest(base, `/audit/${jobId}`, { method: "GET" }, apiKey);
-        if (status.status === "completed")
-            return status;
-        if (status.status === "failed") {
-            throw new Error(status.error || `Audit ${jobId} failed`);
-        }
-        if (Date.now() - start > timeoutMs) {
-            throw new Error(`Timed out waiting for audit ${jobId}`);
-        }
-        await new Promise((resolve) => setTimeout(resolve, intervalMs));
-    }
-}
-/**
- * Compute overall score as mean of category scores.
- */
-function computeOverallScore(scores) {
-    const values = Object.values(scores);
-    if (values.length === 0)
-        return null;
-    const sum = values.reduce((acc, v) => acc + v, 0);
-    return Math.round((sum / values.length) * 100) / 100;
-}
-/**
- * Register the client command with the Commander program.
- */
-export function registerClientCommand(program) {
-    const clientCmd = program
-        .command("client")
-        .description("Manage agency clients");
-    // vertaa client create <name>
-    clientCmd
-        .command("create <name>")
-        .description("Create a new client")
-        .option("--slug <slug>", "URL-friendly identifier (auto-generated from name if omitted)")
-        .option("--urls <urls...>", "URLs to associate with this client")
-        .option("--policy <id>", "Policy ID to assign")
-        .action(async (name, options) => {
-        try {
-            const { base, apiKey } = resolveConnection();
-            const slug = options.slug || generateSlug(name);
-            const body = { name, slug };
-            if (options.urls && options.urls.length > 0) {
-                body.urls = options.urls;
-            }
-            if (options.policy) {
-                body.policyId = options.policy;
-            }
-            const client = await apiRequest(base, "/clients", { method: "POST", body }, apiKey);
-            process.stderr.write(chalk.green(`Client created successfully\n\n`));
-            process.stderr.write(`  Name:  ${client.name}\n`);
-            process.stderr.write(`  Slug:  ${client.slug}\n`);
-            process.stderr.write(`  ID:    ${client.id}\n`);
-            if (client.urls.length > 0) {
-                process.stderr.write(`  URLs:  ${client.urls.join(", ")}\n`);
-            }
-            if (client.policy) {
-                process.stderr.write(`  Policy: ${client.policy.name}\n`);
-            }
-            process.stderr.write("\n");
-        }
-        catch (error) {
-            process.stderr.write(chalk.red(`Error: ${error instanceof Error ? error.message : String(error)}\n`));
-            process.exit(1);
-        }
-    });
-    // vertaa client list
-    clientCmd
-        .command("list")
-        .description("List all clients")
-        .option("--format <format>", "Output format: human|json", "human")
-        .action(async (options) => {
-        try {
-            const { base, apiKey } = resolveConnection();
-            const clients = await apiRequest(base, "/clients", { method: "GET" }, apiKey);
-            if (options.format === "json") {
-                process.stdout.write(JSON.stringify(clients, null, 2) + "\n");
-                return;
-            }
-            // Human format: table
-            if (clients.length === 0) {
-                process.stderr.write(chalk.dim("No clients found. Create one with: vertaa client create <name>\n"));
-                return;
-            }
-            // Table header
-            const nameWidth = 20;
-            const slugWidth = 20;
-            const urlsWidth = 8;
-            const policyWidth = 20;
-            const updatedWidth = 12;
-            const header = padRight("Name", nameWidth) +
-                padRight("Slug", slugWidth) +
-                padRight("URLs", urlsWidth) +
-                padRight("Policy", policyWidth) +
-                padRight("Updated", updatedWidth);
-            process.stderr.write("\n");
-            process.stderr.write(chalk.bold(header) + "\n");
-            process.stderr.write(chalk.dim("-".repeat(nameWidth + slugWidth + urlsWidth + policyWidth + updatedWidth)) + "\n");
-            for (const client of clients) {
-                const row = padRight(truncate(client.name, nameWidth - 2), nameWidth) +
-                    padRight(truncate(client.slug, slugWidth - 2), slugWidth) +
-                    padRight(String(client.urls.length), urlsWidth) +
-                    padRight(truncate(client.policy?.name || "-", policyWidth - 2), policyWidth) +
-                    padRight(formatDate(client.updatedAt), updatedWidth);
-                process.stderr.write(row + "\n");
-            }
-            process.stderr.write("\n");
-            process.stderr.write(chalk.dim(`${clients.length} client${clients.length !== 1 ? "s" : ""}\n`));
-        }
-        catch (error) {
-            process.stderr.write(chalk.red(`Error: ${error instanceof Error ? error.message : String(error)}\n`));
-            process.exit(1);
-        }
-    });
-    // vertaa client remove <identifier>
-    clientCmd
-        .command("remove <identifier>")
-        .description("Remove a client")
-        .option("--force", "Skip confirmation")
-        .action(async (identifier, options) => {
-        try {
-            const { base, apiKey } = resolveConnection();
-            // Resolve the client: try ID first, then slug lookup
-            let clientId;
-            let clientName;
-            let urlCount;
-            if (looksLikeCuid(identifier)) {
-                // Looks like an ID, use directly but verify it exists
-                const client = await apiRequest(base, `/clients/${identifier}`, { method: "GET" }, apiKey);
-                clientId = client.id;
-                clientName = client.name;
-                urlCount = client.urls.length;
-            }
-            else {
-                // Treat as slug -- look up in the list
-                const clients = await apiRequest(base, "/clients", { method: "GET" }, apiKey);
-                const match = clients.find((c) => c.slug === identifier || c.name === identifier);
-                if (!match) {
-                    process.stderr.write(chalk.red(`Error: Client "${identifier}" not found.\n`));
-                    process.exit(1);
-                    return;
-                }
-                clientId = match.id;
-                clientName = match.name;
-                urlCount = match.urls.length;
-            }
-            // Confirmation gate
-            if (!options.force) {
-                process.stderr.write(chalk.yellow(`About to delete client '${clientName}' with ${urlCount} URL${urlCount !== 1 ? "s" : ""}. This cannot be undone.\n`));
-                process.stderr.write(chalk.dim("Add --force to confirm deletion.\n"));
-                process.exit(1);
-                return;
-            }
-            await apiRequest(base, `/clients/${clientId}`, { method: "DELETE" }, apiKey);
-            process.stderr.write(chalk.green(`Client '${clientName}' removed.\n`));
-        }
-        catch (error) {
-            process.stderr.write(chalk.red(`Error: ${error instanceof Error ? error.message : String(error)}\n`));
-            process.exit(1);
-        }
-    });
-    // vertaa client audit
-    clientCmd
-        .command("audit")
-        .description("Run batch audit across client URLs")
-        .option("--client <names>", "Comma-separated client names/slugs (default: all)")
-        .option("--concurrency <n>", "Concurrent audits", "3")
-        .option("--format <format>", "Output format: human|json", "human")
-        .action(async (options) => {
-        try {
-            const { base, apiKey } = resolveConnection();
-            // Fetch all clients
-            const allClients = await apiRequest(base, "/clients", { method: "GET" }, apiKey);
-            if (allClients.length === 0) {
-                process.stderr.write(chalk.dim("No clients found. Create one with: vertaa client create <name>\n"));
-                return;
-            }
-            // Filter by --client if provided
-            let selectedClients;
-            if (options.client) {
-                const names = options.client.split(",").map((n) => n.trim().toLowerCase());
-                selectedClients = allClients.filter((c) => names.includes(c.slug.toLowerCase()) ||
-                    names.includes(c.name.toLowerCase()));
-                if (selectedClients.length === 0) {
-                    process.stderr.write(chalk.red(`Error: No matching clients found for: ${options.client}\n`));
-                    process.stderr.write(chalk.dim(`Available: ${allClients.map((c) => c.slug).join(", ")}\n`));
-                    process.exit(1);
-                    return;
-                }
-            }
-            else {
-                selectedClients = allClients;
-            }
-            // Flatten all URLs
-            const urlTasks = [];
-            for (const client of selectedClients) {
-                for (const url of client.urls) {
-                    urlTasks.push({ client, url });
-                }
-            }
-            if (urlTasks.length === 0) {
-                process.stderr.write(chalk.dim("No URLs to audit across selected clients.\n"));
-                return;
-            }
-            const concurrency = parseInt(options.concurrency, 10) || 3;
-            const limit = pLimit(concurrency);
-            process.stderr.write(chalk.dim(`Auditing ${urlTasks.length} URL${urlTasks.length !== 1 ? "s" : ""} across ${selectedClients.length} client${selectedClients.length !== 1 ? "s" : ""} (concurrency: ${concurrency})\n\n`));
-            // Run batch audits with bounded concurrency
-            const results = [];
-            let completed = 0;
-            const promises = urlTasks.map(({ client, url }) => limit(async () => {
-                completed++;
-                process.stderr.write(`[${completed}/${urlTasks.length}] Auditing ${url}...`);
-                try {
-                    // Start audit
-                    const job = await apiRequest(base, "/audit", { method: "POST", body: { url, mode: "basic" } }, apiKey);
-                    if (!job.job_id) {
-                        throw new Error("No job_id in audit response");
-                    }
-                    // Wait for completion
-                    const result = await waitForAuditCompletion(base, apiKey, job.job_id);
-                    const scores = (result.scores || {});
-                    const overall = computeOverallScore(scores);
-                    process.stderr.write(` ${chalk.green("done")} (score: ${overall !== null ? overall : "n/a"})\n`);
-                    results.push({
-                        client: client.name,
-                        url,
-                        score: overall,
-                        status: "success",
-                        jobId: job.job_id,
-                    });
-                }
-                catch (err) {
-                    process.stderr.write(` ${chalk.red("failed")}\n`);
-                    results.push({
-                        client: client.name,
-                        url,
-                        score: null,
-                        status: "error",
-                        error: err instanceof Error ? err.message : String(err),
-                    });
-                }
-            }));
-            await Promise.all(promises);
-            // Output results
-            process.stderr.write("\n");
-            if (options.format === "json") {
-                // Group by client for JSON output
-                const grouped = {};
-                for (const r of results) {
-                    if (!grouped[r.client])
-                        grouped[r.client] = [];
-                    grouped[r.client].push(r);
-                }
-                process.stdout.write(JSON.stringify(grouped, null, 2) + "\n");
-                return;
-            }
-            // Human format: per-client summary
-            const grouped = {};
-            for (const r of results) {
-                if (!grouped[r.client])
-                    grouped[r.client] = [];
-                grouped[r.client].push(r);
-            }
-            for (const [clientName, clientResults] of Object.entries(grouped)) {
-                process.stderr.write(chalk.bold(`${clientName}\n`));
-                for (const r of clientResults) {
-                    const scoreStr = r.status === "success"
-                        ? r.score !== null
-                            ? String(r.score)
-                            : "n/a"
-                        : chalk.red("error");
-                    process.stderr.write(`  ${r.url}  ${scoreStr}\n`);
-                }
-                // Client average
-                const successScores = clientResults
-                    .filter((r) => r.status === "success" && r.score !== null)
-                    .map((r) => r.score);
-                if (successScores.length > 0) {
-                    const avg = Math.round((successScores.reduce((a, b) => a + b, 0) / successScores.length) * 100) / 100;
-                    process.stderr.write(chalk.dim(`  Average: ${avg}\n`));
-                }
-                process.stderr.write("\n");
-            }
-            // Overall summary
-            const totalSuccess = results.filter((r) => r.status === "success").length;
-            const totalFailed = results.filter((r) => r.status === "error").length;
-            process.stderr.write(chalk.dim(`Summary: ${totalSuccess} succeeded, ${totalFailed} failed out of ${results.length} audits\n`));
-        }
-        catch (error) {
-            process.stderr.write(chalk.red(`Error: ${error instanceof Error ? error.message : String(error)}\n`));
-            process.exit(1);
-        }
-    });
-}
-/**
- * Pad a string to the right to a given width.
- */
-function padRight(str, width) {
-    return str.length >= width ? str : str + " ".repeat(width - str.length);
-}
-/**
- * Truncate a string to a maximum length with ellipsis.
- */
-function truncate(str, maxLen) {
-    if (str.length <= maxLen)
-        return str;
-    return str.slice(0, maxLen - 1) + "\u2026";
-}

package/dist/commands/drift.d.ts

@@ -1,15 +0,0 @@
-/**
- * Drift detection command for VertaaUX CLI.
- *
- * Compares current audit scores against a baseline and reports
- * per-category regressions with delta magnitudes. Used in local
- * workflows and CI pipelines to detect score regressions before merging.
- *
- * Implements DRIFT-01: CLI drift check command.
- */
-import { Command } from "commander";
-/**
- * Register the drift command with the Commander program.
- */
-export declare function registerDriftCommand(program: Command): void;
-//# sourceMappingURL=drift.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../src/commands/drift.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyNpC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsK3D"}