@vertaaux/cli 0.3.0 → 0.3.2

package/dist/commands/audit.d.ts

@@ -16,6 +16,7 @@ export interface AuditCommandOptions {
     timeout?: number;
     interval?: number;
     format?: string;
+    json?: boolean;
     output?: string;
     groupBy?: "severity" | "category" | "route";
     severity?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyFpC,MAAM,WAAW,mBAAmB;IAElC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IAG5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAGhB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAGvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAu4BD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkT3D"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyFpC,MAAM,WAAW,mBAAmB;IAElC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IAG5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAGhB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAGvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAw5BD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmT3D"}

package/dist/commands/audit.js

@@ -380,8 +380,9 @@ async function executeAudit(targetUrl, options, config) {
     const base = resolveApiBase(options.base);
     const apiKey = getApiKey(config.apiKey);
     // Resolve output format using per-command registry
+    // --json flag is a shorthand for --format json (convenient for piping)
     const machineMode = options.machine || false;
-    const explicitFormat = options.format || config.output?.format;
+    const explicitFormat = options.json ? "json" : (options.format || config.output?.format);
     const validatedFormat = resolveCommandFormat("audit", explicitFormat, machineMode);
     const format = validatedFormat;
     const formatter = createOutput(format);
@@ -412,7 +413,7 @@ async function executeAudit(targetUrl, options, config) {
     try {
         // Start spinner (dashboard renders on first update)
         spinner?.start();
-        // Create audit job
+        // Create audit job (server runs audit synchronously and returns results)
         const created = await apiRequest(base, "/audit", {
             method: "POST",
             body: { url: targetUrl, mode },
@@ -447,34 +448,48 @@ async function executeAudit(targetUrl, options, config) {
             }
             return;
         }
-        // Wait for completion with progress updates
-        if (!created.job_id) {
-            throw new Error("Audit response missing job_id");
-        }
-        const result = await waitForAudit(base, created.job_id, timeout, interval, apiKey, (progress, status) => {
-            if (aborted)
-                return;
-            if (renderer) {
-                const phase = mapStatusToPhase(status);
-                const state = {
-                    phase,
-                    phaseIndex: phaseIndex(phase),
-                    phaseTotal: phaseTotal(),
-                    url: targetUrl,
-                    mode,
-                    progress: { audit: progress },
-                    totals: { audit: 100 },
-                    issueCount: 0,
-                    scorePreview: null,
-                    verbose: false,
-                    elapsed: Date.now() - auditStartTime,
-                };
-                renderer.update(state);
-            }
-            if (spinner) {
-                updateSpinner(spinner, `Auditing ${targetUrl}`, progress, 100);
+        // Determine if the server returned results synchronously (status 200)
+        // or queued the job for background processing (status 202, legacy servers)
+        const isSyncResponse = created.status === "completed" && created.scores;
+        let result;
+        if (created.status === "failed") {
+            // Server ran the audit synchronously but it failed
+            throw new Error(created.error || "Audit failed on server");
+        }
+        if (isSyncResponse) {
+            // Server already ran the audit — use the response directly
+            result = created;
+        }
+        else {
+            // Legacy/async path: poll for completion
+            if (!created.job_id) {
+                throw new Error("Audit response missing job_id");
             }
-        });
+            result = await waitForAudit(base, created.job_id, timeout, interval, apiKey, (progress, status) => {
+                if (aborted)
+                    return;
+                if (renderer) {
+                    const phase = mapStatusToPhase(status);
+                    const state = {
+                        phase,
+                        phaseIndex: phaseIndex(phase),
+                        phaseTotal: phaseTotal(),
+                        url: targetUrl,
+                        mode,
+                        progress: { audit: progress },
+                        totals: { audit: 100 },
+                        issueCount: 0,
+                        scorePreview: null,
+                        verbose: false,
+                        elapsed: Date.now() - auditStartTime,
+                    };
+                    renderer.update(state);
+                }
+                if (spinner) {
+                    updateSpinner(spinner, `Auditing ${targetUrl}`, progress, 100);
+                }
+            });
+        }
         // Finish dashboard or spinner
         if (renderer) {
             const overallScore = getOverallScoreFromResult(result);
@@ -774,6 +789,7 @@ export function registerAuditCommand(program) {
         .option("--auth-profile <profile>", "Authentication profile for protected pages")
         .option("--mode <mode>", "Audit depth: basic|standard|deep", parseMode, "basic")
         .option("--format <format>", "Output format: json|sarif|junit|html|human (default: human in terminal, auto-detected in CI)")
+        .option("--json", "Shorthand for --format json (convenient for piping)")
         .option("-o, --output <path>", "Output file path")
         .option("--group-by <field>", "Group issues by: severity|category|route", parseGroupBy)
         .option("--wait", "Wait for audit completion (default)")
@@ -925,7 +941,7 @@ export function registerAuditCommand(program) {
                         // Aggregate and output results
                         const aggregated = aggregateResults(results);
                         aggregated.totalDuration = Date.now() - startTime;
-                        if (cmdOptions.format === "json") {
+                        if (cmdOptions.json || cmdOptions.format === "json") {
                             writeJsonOutput(aggregated, "audit");
                         }
                         else {