@vertaaux/cli 0.3.3 → 0.5.0

package/dist/output/html.js

@@ -22,10 +22,11 @@ function normalizeIssues(issues) {
 function getOverallScore(scores) {
     if (!scores)
         return null;
-    const direct = scores.overall ?? scores.ux ?? scores.total;
+    const s = scores;
+    const direct = s.overall ?? s.ux ?? s.total;
     if (typeof direct === "number" && Number.isFinite(direct))
         return direct;
-    const numeric = Object.values(scores)
+    const numeric = Object.values(s)
         .filter((v) => typeof v === "number" && Number.isFinite(v));
     if (numeric.length === 0)
         return null;

package/dist/output/human.d.ts

@@ -4,6 +4,7 @@
  * Outputs audit results as colorful, formatted text for terminal display.
  * Delegates to @vertaaux/tui for consistent rendering.
  */
+import type { AuditScores } from "@vertaaux/sdk";
 import { type FormatTableOptions } from "../ui/table.js";
 export interface AuditResult {
     job_id?: string;
@@ -14,9 +15,16 @@ export interface AuditResult {
     created_at?: string;
     started_at?: string;
     completed_at?: string;
-    scores?: Record<string, unknown>;
+    scores?: AuditScores | Record<string, unknown>;
     issues?: unknown;
     error?: string;
+    analysis_type?: string;
+    metadata?: {
+        partial?: boolean;
+        source?: string;
+        unavailable_checks?: string[];
+        [key: string]: unknown;
+    };
 }
 export interface FormatHumanOptions {
     groupBy?: "severity" | "category" | "route";

package/dist/output/human.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"human.d.ts","sourceRoot":"","sources":["../../src/output/human.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAuND;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAuCR"}
+{"version":3,"file":"human.d.ts","sourceRoot":"","sources":["../../src/output/human.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAwND;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CA4DR"}

package/dist/output/human.js

@@ -24,10 +24,11 @@ function normalizeIssues(issues) {
 function getOverallScore(scores) {
     if (!scores)
         return null;
-    const direct = scores.overall ?? scores.ux ?? scores.total;
+    const s = scores;
+    const direct = s.overall ?? s.ux ?? s.total;
     if (typeof direct === "number" && Number.isFinite(direct))
         return direct;
-    const numeric = Object.values(scores)
+    const numeric = Object.values(s)
         .filter((v) => typeof v === "number" && Number.isFinite(v));
     if (numeric.length === 0)
         return null;
@@ -198,5 +199,19 @@ export function formatAuditHuman(result, options = {}) {
     if (showSummary) {
         sections.push(formatSummary(issues, result.scores));
     }
+    // Partial result annotation for local/static analysis audits
+    if (result.metadata?.partial || result.analysis_type === "static_html") {
+        const checks = result.metadata?.unavailable_checks ?? [];
+        const lines = [];
+        lines.push("");
+        lines.push(text.dim("─".repeat(Math.min(getTerminalWidth(), 80))));
+        lines.push(text.dim("This audit ran in static analysis mode (local URL)."));
+        if (checks.length > 0) {
+            lines.push(text.dim("Unavailable checks: " +
+                checks.map((c) => c.replace(/_/g, " ")).join(", ")));
+        }
+        lines.push(text.dim("Deploy to a public URL for a full browser-based audit."));
+        sections.push(lines.join("\n"));
+    }
     return sections.join("\n") + "\n";
 }

package/dist/output/json.d.ts

@@ -4,6 +4,7 @@
  * Outputs audit results as pretty-printed JSON.
  * Used for piped output and machine parsing.
  */
+import type { AuditScores } from "@vertaaux/sdk";
 export interface AuditResult {
     job_id?: string;
     status?: string;
@@ -13,7 +14,7 @@ export interface AuditResult {
     created_at?: string;
     started_at?: string;
     completed_at?: string;
-    scores?: Record<string, unknown>;
+    scores?: AuditScores | Record<string, unknown>;
     issues?: unknown;
     error?: string;
 }

package/dist/output/json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAeR;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAI,GAAG,MAAM,CAE5D"}
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAeR;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAI,GAAG,MAAM,CAE5D"}

package/dist/output/junit.d.ts

@@ -16,6 +16,7 @@ export interface JunitOptions {
     /** Custom test suite name prefix */
     suiteNamePrefix?: string;
 }
+import type { AuditScores } from "@vertaaux/sdk";
 /**
  * Audit result structure (matches factory.ts).
  */
@@ -28,7 +29,7 @@ export interface AuditResult {
     created_at?: string;
     started_at?: string;
     completed_at?: string;
-    scores?: Record<string, unknown>;
+    scores?: AuditScores | Record<string, unknown>;
     issues?: unknown;
     error?: string;
 }

package/dist/output/junit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"junit.d.ts","sourceRoot":"","sources":["../../src/output/junit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqFD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CA+D/E;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB"}
+{"version":3,"file":"junit.d.ts","sourceRoot":"","sources":["../../src/output/junit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqFD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CA+D/E;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB"}

package/dist/output/sarif.d.ts

@@ -118,6 +118,7 @@ export interface SarifOptions {
     /** Working directory for invocation */
     workingDirectory?: string;
 }
+import type { AuditScores } from "@vertaaux/sdk";
 /**
  * Audit result structure (matches factory.ts).
  */
@@ -130,7 +131,7 @@ export interface AuditResult {
     created_at?: string;
     started_at?: string;
     completed_at?: string;
-    scores?: Record<string, unknown>;
+    scores?: AuditScores | Record<string, unknown>;
     issues?: unknown;
     error?: string;
 }

package/dist/output/sarif.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../src/output/sarif.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../src/output/sarif.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE;QACJ,MAAM,EAAE,WAAW,CAAC;KACrB,CAAC;IACF,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,eAAe,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE;QACrB,KAAK,EAAE,UAAU,CAAC;KACnB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,mBAAmB,CAAC,EAAE;QACpB,uBAAuB,EAAE,MAAM,CAAC;KACjC,CAAC;IACF,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE;QAChB,gBAAgB,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAClC,MAAM,CAAC,EAAE;YACP,SAAS,EAAE,MAAM,CAAC;YAClB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oCAAoC;IACpC,oBAAoB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CA+C/E;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB"}

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Shared type definitions for the VertaaUX CLI.
+ * Used by legacy command handlers and utility functions.
+ */
+import type { Audit } from "@vertaaux/sdk";
+export type FlagValue = string | boolean;
+export type Flags = Record<string, FlagValue>;
+export type IssueLike = {
+    id?: string;
+    title?: string;
+    severity?: string;
+    category?: string;
+    description?: string;
+    recommendation?: string;
+    recommended_fix?: string;
+    wcag_reference?: string;
+    selector?: string;
+};
+export type AuditResponse = Audit;
+export type PatchResponse = {
+    success: boolean;
+    patch?: {
+        search: string;
+        replace: string;
+        confidence: {
+            label: string;
+            percentage: number;
+        };
+        classification: string;
+        explanation: string;
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+    timing_ms?: number;
+};
+export type BatchPatchResult = {
+    successes: Array<{
+        issueId: string;
+        patch: PatchResponse["patch"];
+    }>;
+    failures: Array<{
+        issueId: string;
+        reason: string;
+        details?: string;
+    }>;
+    totalRequested: number;
+    totalSkipped: number;
+};
+export type VerifyResponse = {
+    success: boolean;
+    verification?: {
+        issue_fixed: boolean;
+        regressions: Array<{
+            rule_id: string;
+            impact: string;
+            description: string;
+        }>;
+        score_delta: {
+            before: number;
+            after: number;
+            delta: number;
+        };
+        component_audited: string;
+        duration_ms: number;
+        error?: string;
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AACzC,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAIF,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC;AAElC,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;QAClD,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,KAAK,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;KAC/B,CAAC,CAAC;IACH,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE;QACb,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,EAAE,KAAK,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;QACH,WAAW,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9D,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C,CAAC"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared type definitions for the VertaaUX CLI.
+ * Used by legacy command handlers and utility functions.
+ */
+export {};

package/dist/ui/banner.d.ts

@@ -3,6 +3,13 @@
  *
  * Displays a compact arrow wedge in teal/mint gradient.
  * Can be suppressed via --quiet, --no-banner, or non-TTY environments.
+ *
+ * animateBanner() plays a 3-frame entrance animation in TTY+color mode:
+ *   Frame 1: dim ghost outline (75ms)
+ *   Frame 2: normal teal/mint colors (75ms)
+ *   Frame 3: full lime→cyan gradient (100ms hold)
+ * Falls back to static showBanner() when --no-color, NO_COLOR, TERM=dumb,
+ * or non-TTY.
  */
 export interface BannerOptions {
     /** CLI version to display */
@@ -12,6 +19,33 @@ export interface BannerOptions {
     /** Whether --no-banner was passed */
     noBanner?: boolean;
 }
+/**
+ * Frame 1: ghost/dim outline — all lines wrapped in dim().
+ * Structure: 5 content lines + "\n\n"
+ */
+export declare function buildFrame1(version: string, cwd: string): string;
+/**
+ * Frame 2: normal colors — identical to current showBanner() color branch.
+ * TEAL art, MINT bold VertaaUX, dim cwd.
+ * Structure: 5 content lines + "\n\n"
+ */
+export declare function buildFrame2(version: string, cwd: string): string;
+/**
+ * Frame 3: full gradient — ARROW_MARK + "VertaaUX" with applyGradient(), dim cwd.
+ * Structure: 5 content lines + "\n\n"
+ */
+export declare function buildFrame3(version: string, cwd: string): string;
+/**
+ * Show the arrow-mark banner with a 3-frame entrance animation.
+ *
+ * Animation plays only in TTY + color + unicode environments.
+ * Falls back to static showBanner() otherwise.
+ *
+ * All output goes to process.stderr (stdout reserved for --format json).
+ *
+ * @param options - Banner display options
+ */
+export declare function animateBanner(options: BannerOptions): Promise<void>;
 /**
  * Show the arrow-mark banner with version and working directory.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CA+BvD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAOnC"}
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoCH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAShE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAUhE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAUhE;AAID;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BzE;AAID;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CA+BvD;AAID;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAOnC"}

package/dist/ui/banner.js

@@ -3,10 +3,17 @@
  *
  * Displays a compact arrow wedge in teal/mint gradient.
  * Can be suppressed via --quiet, --no-banner, or non-TTY environments.
+ *
+ * animateBanner() plays a 3-frame entrance animation in TTY+color mode:
+ *   Frame 1: dim ghost outline (75ms)
+ *   Frame 2: normal teal/mint colors (75ms)
+ *   Frame 3: full lime→cyan gradient (100ms hold)
+ * Falls back to static showBanner() when --no-color, NO_COLOR, TERM=dumb,
+ * or non-TTY.
  */
-import chalk from "chalk";
+import { colorize, bold, dim, applyGradient, isColorEnabled, isTTY, supportsUnicode, cursor, screen, physicalRows, } from "@vertaaux/tui";
 import { createRequire } from "module";
-import { isTTY, shouldUseColor } from "../utils/detect-env.js";
+import { shouldUseColor } from "../utils/detect-env.js";
 // For JSON imports in ESM
 const require = createRequire(import.meta.url);
 // Arrow-mark ASCII art (compact 5-line wedge matching brand)
@@ -19,6 +26,90 @@ const ARROW_MARK = [
 ];
 const TEAL = "#5EE4C4";
 const MINT = "#90EECE";
+/** Simple sleep helper for animation timing */
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+// ── Frame builders (exported for testability) ────────────────────
+/**
+ * Frame 1: ghost/dim outline — all lines wrapped in dim().
+ * Structure: 5 content lines + "\n\n"
+ */
+export function buildFrame1(version, cwd) {
+    const lines = [
+        `${dim(ARROW_MARK[0])}  ${dim(`VertaaUX v${version}`)}`,
+        `${dim(ARROW_MARK[1])}  ${dim(cwd)}`,
+        `${dim(ARROW_MARK[2])}`,
+        `${dim(ARROW_MARK[3])}`,
+        `${dim(ARROW_MARK[4])}`,
+    ];
+    return lines.join("\n") + "\n\n";
+}
+/**
+ * Frame 2: normal colors — identical to current showBanner() color branch.
+ * TEAL art, MINT bold VertaaUX, dim cwd.
+ * Structure: 5 content lines + "\n\n"
+ */
+export function buildFrame2(version, cwd) {
+    const logo = ARROW_MARK.map((line) => colorize(line, TEAL));
+    const lines = [
+        `${logo[0]}  ${bold(colorize("VertaaUX", MINT))} v${version}`,
+        `${logo[1]}  ${dim(cwd)}`,
+        `${logo[2]}`,
+        `${logo[3]}`,
+        `${logo[4]}`,
+    ];
+    return lines.join("\n") + "\n\n";
+}
+/**
+ * Frame 3: full gradient — ARROW_MARK + "VertaaUX" with applyGradient(), dim cwd.
+ * Structure: 5 content lines + "\n\n"
+ */
+export function buildFrame3(version, cwd) {
+    const logo = ARROW_MARK.map((line) => applyGradient(line));
+    const lines = [
+        `${logo[0]}  ${bold(applyGradient("VertaaUX"))} v${version}`,
+        `${logo[1]}  ${dim(cwd)}`,
+        `${logo[2]}`,
+        `${logo[3]}`,
+        `${logo[4]}`,
+    ];
+    return lines.join("\n") + "\n\n";
+}
+// ── Animated banner ──────────────────────────────────────────────
+/**
+ * Show the arrow-mark banner with a 3-frame entrance animation.
+ *
+ * Animation plays only in TTY + color + unicode environments.
+ * Falls back to static showBanner() otherwise.
+ *
+ * All output goes to process.stderr (stdout reserved for --format json).
+ *
+ * @param options - Banner display options
+ */
+export async function animateBanner(options) {
+    const { version, quiet = false, noBanner = false } = options;
+    // Static fallback: suppressed modes, non-TTY, no-color, dumb terminal
+    if (quiet || noBanner || !isTTY() || !isColorEnabled() || !supportsUnicode()) {
+        showBanner(options);
+        return;
+    }
+    const cwd = process.cwd();
+    const termWidth = process.stderr.columns || 80;
+    // Frame 1: dim ghost
+    const f1 = buildFrame1(version, cwd);
+    process.stderr.write(f1);
+    await sleep(75);
+    // Frame 2: normal colors (overwrite in-place)
+    const rows1 = physicalRows(f1, termWidth);
+    const f2 = buildFrame2(version, cwd);
+    process.stderr.write(cursor.up(rows1) + screen.clearDown + f2);
+    await sleep(75);
+    // Frame 3: full gradient (overwrite in-place, hold 100ms)
+    const rows2 = physicalRows(f2, termWidth);
+    const f3 = buildFrame3(version, cwd);
+    process.stderr.write(cursor.up(rows2) + screen.clearDown + f3);
+    await sleep(100);
+}
+// ── Static banner ────────────────────────────────────────────────
 /**
  * Show the arrow-mark banner with version and working directory.
  *
@@ -38,10 +129,10 @@ export function showBanner(options) {
     const useColor = shouldUseColor();
     const cwd = process.cwd();
     if (useColor) {
-        const logo = ARROW_MARK.map((line) => chalk.hex(TEAL)(line));
+        const logo = ARROW_MARK.map((line) => colorize(line, TEAL));
         const lines = [
-            `${logo[0]}  ${chalk.hex(MINT).bold("VertaaUX")} v${version}`,
-            `${logo[1]}  ${chalk.dim(cwd)}`,
+            `${logo[0]}  ${bold(colorize("VertaaUX", MINT))} v${version}`,
+            `${logo[1]}  ${dim(cwd)}`,
             `${logo[2]}`,
             `${logo[3]}`,
             `${logo[4]}`,
@@ -59,6 +150,7 @@ export function showBanner(options) {
         process.stderr.write(lines.join("\n") + "\n\n");
     }
 }
+// ── Version helper ───────────────────────────────────────────────
 /**
  * Get version from package.json.
  * Falls back to "0.0.0" if unable to read.

package/dist/ui/diagnostics.d.ts

@@ -6,6 +6,9 @@
  *
  * Integrates with Commander's configureOutput({ outputError }) hook
  * to intercept and restyle all validation and argument errors.
+ *
+ * Delegates to renderError/renderWarning from @vertaaux/tui for
+ * consistent branded output across all error surfaces.
  */
 export interface ValidationErrorOptions {
     flag: string;
@@ -19,8 +22,10 @@ export interface ValidationErrorOptions {
 /**
  * Format a validation error with branded styling.
  *
- * Rich mode (TTY + color): Box-drawn frame with Unicode chars, brand colors.
- * Plain mode (non-TTY/NO_COLOR/CI): Structured indented text, no decorations.
+ * Delegates to renderError() from @vertaaux/tui for the box border,
+ * then appends flag/value details as context lines.
+ *
+ * Plain mode is evaluated at call time (isPlainMode() inside renderError).
  */
 export declare function formatValidationError(opts: ValidationErrorOptions): string;
 /**
@@ -28,12 +33,12 @@ export declare function formatValidationError(opts: ValidationErrorOptions): str
  *
  * Commander passes raw error strings to configureOutput({ outputError }).
  * This function parses them to extract flag/value information and applies
- * branded formatting.
+ * branded formatting via renderError().
  *
  * InvalidArgumentError pattern:
  *   "error: option '--flag <arg>' argument 'value' is invalid. Detail"
  *
- * Other Commander errors (missing required, etc.) get branded prefix.
+ * Other Commander errors (missing required, etc.) get renderError treatment.
  */
 export declare function formatCommanderError(rawMessage: string): string;
 //# sourceMappingURL=diagnostics.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/ui/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoCH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAK1E;AA8ED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA+C/D"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/ui/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA8BH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAgC1E;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAsC/D"}

package/dist/ui/diagnostics.js

@@ -6,96 +6,54 @@
  *
  * Integrates with Commander's configureOutput({ outputError }) hook
  * to intercept and restyle all validation and argument errors.
+ *
+ * Delegates to renderError/renderWarning from @vertaaux/tui for
+ * consistent branded output across all error surfaces.
  */
-import chalk from "chalk";
-import { shouldUseColor, isTTY, getTerminalWidth, } from "../utils/detect-env.js";
-// ---------------------------------------------------------------------------
-// Brand colors (matching banner.ts gradient)
-// ---------------------------------------------------------------------------
-const BRAND_ACCENT = "#78FFB4"; // Lime
-const ERROR_COLOR = "#FF6B6B"; // Red
-const HINT_COLOR = "#78FFB4"; // Brand lime for hints/suggestions
+import { dim, isPlainMode, renderError, } from "@vertaaux/tui";
 // ---------------------------------------------------------------------------
 // Terminal capability detection
 // ---------------------------------------------------------------------------
 /**
  * Determine if box-drawing characters and colors can be used.
- * Returns false for dumb terminals, NO_COLOR, non-TTY, and CI.
+ * Returns false in plain mode (ASCII-only output).
  */
 function canUseBoxDrawing() {
-    if (process.env.TERM === "dumb")
-        return false;
-    if (!shouldUseColor())
-        return false;
-    if (!isTTY())
-        return false;
-    return true;
+    return !isPlainMode();
 }
 /**
  * Format a validation error with branded styling.
  *
- * Rich mode (TTY + color): Box-drawn frame with Unicode chars, brand colors.
- * Plain mode (non-TTY/NO_COLOR/CI): Structured indented text, no decorations.
+ * Delegates to renderError() from @vertaaux/tui for the box border,
+ * then appends flag/value details as context lines.
+ *
+ * Plain mode is evaluated at call time (isPlainMode() inside renderError).
  */
 export function formatValidationError(opts) {
-    if (canUseBoxDrawing()) {
-        return boxDrawnError(opts);
-    }
-    return plainTextError(opts);
-}
-/**
- * Rich box-drawn error frame for TTY terminals with color support.
- */
-function boxDrawnError(opts) {
-    const width = Math.min(getTerminalWidth(), 72);
-    const prefix = chalk.hex(BRAND_ACCENT).bold("vertaa");
-    const border = chalk.dim("  " + "\u2500".repeat(width - 4));
-    const pipe = chalk.dim("  \u2502");
-    const lines = [
-        `${prefix} ${chalk.hex(ERROR_COLOR).bold("error")}: ${opts.message}`,
-        border,
-        `${pipe} ${chalk.dim("flag:")} --${opts.flag}`,
-        `${pipe} ${chalk.dim("value:")} ${chalk.yellow(opts.value)}`,
+    // Build a rich context string with flag + value details
+    const contextParts = [
+        `flag: --${opts.flag}`,
+        `value: ${opts.value}`,
     ];
     if (opts.suggestion) {
-        lines.push(pipe);
-        lines.push(`${pipe} ${chalk.hex(HINT_COLOR)("hint:")} Did you mean "${opts.suggestion}"?`);
+        contextParts.push(`hint: Did you mean "${opts.suggestion}"?`);
     }
     if (opts.validValues && opts.validValues.length > 0) {
-        lines.push(`${pipe} ${chalk.dim("valid:")} ${chalk.dim(opts.validValues.join(", "))}`);
+        contextParts.push(`valid: ${opts.validValues.join(", ")}`);
     }
     if (opts.hint) {
-        lines.push(pipe);
-        lines.push(`${pipe} ${chalk.dim(opts.hint)}`);
+        contextParts.push(opts.hint);
     }
-    lines.push(border);
+    const context = contextParts.join("\n");
+    const base = renderError({
+        message: opts.message,
+        context,
+        suggestion: "vertaa <command> --help for all options",
+    });
     if (opts.moreIssues && opts.moreIssues > 0) {
-        lines.push(chalk.dim(`  ...and ${opts.moreIssues} more issues`));
+        return base + "\n" + dim(`  ...and ${opts.moreIssues} more issues`);
     }
-    return lines.join("\n");
-}
-/**
- * Plain text error for non-TTY, NO_COLOR, CI, or TERM=dumb environments.
- */
-function plainTextError(opts) {
-    const lines = [
-        `error: ${opts.message}`,
-        `  flag: --${opts.flag}`,
-        `  value: ${opts.value}`,
-    ];
-    if (opts.suggestion) {
-        lines.push(`  hint: Did you mean "${opts.suggestion}"?`);
-    }
-    if (opts.validValues && opts.validValues.length > 0) {
-        lines.push(`  valid: ${opts.validValues.join(", ")}`);
-    }
-    if (opts.hint) {
-        lines.push(`  ${opts.hint}`);
-    }
-    if (opts.moreIssues && opts.moreIssues > 0) {
-        lines.push(`  ...and ${opts.moreIssues} more issues`);
-    }
-    return lines.join("\n");
+    return base;
 }
 // ---------------------------------------------------------------------------
 // Commander error formatting
@@ -105,12 +63,12 @@ function plainTextError(opts) {
  *
  * Commander passes raw error strings to configureOutput({ outputError }).
  * This function parses them to extract flag/value information and applies
- * branded formatting.
+ * branded formatting via renderError().
  *
  * InvalidArgumentError pattern:
  *   "error: option '--flag <arg>' argument 'value' is invalid. Detail"
  *
- * Other Commander errors (missing required, etc.) get branded prefix.
+ * Other Commander errors (missing required, etc.) get renderError treatment.
  */
 export function formatCommanderError(rawMessage) {
     // Strip leading "error: " prefix that Commander adds
@@ -137,17 +95,9 @@ export function formatCommanderError(rawMessage) {
             hint: "Run vertaa <command> --help for all options",
         });
     }
-    // For other Commander errors: branded prefix with help hint
-    if (canUseBoxDrawing()) {
-        const prefix = chalk.hex(BRAND_ACCENT).bold("vertaa");
-        const errorLabel = chalk.hex(ERROR_COLOR).bold("error");
-        return [
-            `${prefix} ${errorLabel}: ${msg}`,
-            chalk.dim("  Run vertaa <command> --help for all options"),
-        ].join("\n");
-    }
-    return [
-        `vertaa error: ${msg}`,
-        "  Run vertaa <command> --help for all options",
-    ].join("\n");
+    // For other Commander errors: use renderError with a help suggestion
+    return renderError({
+        message: msg,
+        suggestion: "vertaa <command> --help for all options",
+    });
 }