@vertaaux/cli 0.4.0 → 0.5.1

package/dist/commands/audit/explain.js

@@ -0,0 +1,45 @@
+/**
+ * AI inline explanation for the audit command.
+ */
+import { bold, dim, colorize, brand } from "@vertaaux/tui";
+import { writeOutput } from "../../output/envelope.js";
+import { resolveApiBase, getApiKey, apiRequest, } from "../../utils/client.js";
+import { createSpinner, succeedSpinner, } from "../../ui/spinner.js";
+import { strings } from "../../ui/strings.js";
+/**
+ * Run the inline AI explanation for audit issues.
+ */
+export async function runInlineExplanation(issues, result, targetUrl, options, config) {
+    try {
+        const explainBase = resolveApiBase(options.base);
+        const explainKey = getApiKey(config.apiKey);
+        const explainIssues = issues.map((i) => ({
+            id: i.id || null,
+            title: i.title || i.description || null,
+            description: i.description || null,
+            severity: i.severity || null,
+            category: i.category || null,
+            selector: i.selector || null,
+            wcag_reference: i.wcag_reference || null,
+            recommendation: i.recommendation || i.recommended_fix || null,
+        }));
+        const explainPayload = {
+            job_id: result.job_id || null,
+            url: targetUrl || null,
+            scores: result.scores || null,
+            issues: explainIssues,
+        };
+        const explainSpinner = createSpinner(strings.explain.run.action);
+        const explainResponse = await apiRequest(explainBase, "/cli/ai/explain", { method: "POST", body: { audit: explainPayload } }, explainKey);
+        succeedSpinner(explainSpinner, strings.explain.run.done(explainResponse.data.issues.length));
+        writeOutput("\n");
+        writeOutput(bold("AI Explanation") + "\n");
+        writeOutput(dim("\u2500".repeat(40)) + "\n");
+        for (const bullet of explainResponse.data.summary) {
+            writeOutput(`  ${colorize("*", brand.cyan)} ${bullet}\n`);
+        }
+    }
+    catch (explainErr) {
+        writeOutput(dim(`\n(${strings.explain.aiUnavailable(explainErr instanceof Error ? explainErr.message : String(explainErr))})\n`));
+    }
+}

package/dist/commands/audit/filters.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Issue filtering helpers for the audit command.
+ */
+import type { IssueLike } from "./types.js";
+/**
+ * Normalize issues from various API response formats.
+ */
+export declare function normalizeIssues(issues: unknown): IssueLike[];
+/**
+ * Filter issues by severity.
+ */
+export declare function filterBySeverity(issues: IssueLike[], severityFilter: string): IssueLike[];
+/**
+ * Filter issues by category.
+ */
+export declare function filterByCategory(issues: IssueLike[], categoryFilter: string): IssueLike[];
+//# sourceMappingURL=filters.d.ts.map

package/dist/commands/audit/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../src/commands/audit/filters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,CAS5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EAAE,EACnB,cAAc,EAAE,MAAM,GACrB,SAAS,EAAE,CAab;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EAAE,EACnB,cAAc,EAAE,MAAM,GACrB,SAAS,EAAE,CASb"}

package/dist/commands/audit/filters.js

@@ -0,0 +1,40 @@
+/**
+ * Issue filtering helpers for the audit command.
+ */
+/**
+ * Normalize issues from various API response formats.
+ */
+export function normalizeIssues(issues) {
+    if (Array.isArray(issues))
+        return issues;
+    if (issues && typeof issues === "object") {
+        const values = Object.values(issues);
+        return values.flatMap((value) => Array.isArray(value) ? value : []);
+    }
+    return [];
+}
+/**
+ * Filter issues by severity.
+ */
+export function filterBySeverity(issues, severityFilter) {
+    const allowed = new Set(severityFilter.split(",").map((s) => s.trim().toLowerCase()));
+    // Map common aliases
+    if (allowed.has("error"))
+        allowed.add("critical");
+    if (allowed.has("warning"))
+        allowed.add("serious");
+    return issues.filter((issue) => {
+        const sev = issue.severity?.toLowerCase() || "info";
+        return allowed.has(sev);
+    });
+}
+/**
+ * Filter issues by category.
+ */
+export function filterByCategory(issues, categoryFilter) {
+    const allowed = new Set(categoryFilter.split(",").map((c) => c.trim().toLowerCase()));
+    return issues.filter((issue) => {
+        const cat = issue.category?.toLowerCase() || "";
+        return allowed.has(cat) || Array.from(allowed).some((a) => cat.includes(a));
+    });
+}

package/dist/commands/audit/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Audit command for VertaaUX CLI.
+ *
+ * Runs UX and accessibility audits on web pages.
+ * Supports various targets, output formats, and CI integration.
+ */
+import { Command } from "commander";
+import type { VertaauxConfig } from "../../config/schema.js";
+import type { AuditCommandOptions } from "./types.js";
+/**
+ * Execute the audit command — exported as handleAudit for CommandRunnerView.
+ */
+export declare function handleAudit(rawUrl: string, options: AuditCommandOptions, config: VertaauxConfig): Promise<void>;
+/**
+ * Register the audit command with the Commander program.
+ */
+export declare function registerAuditCommand(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/audit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/audit/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA+D7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAwFtD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CA+Uf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0P3D"}