@vertaaux/cli 0.4.0 → 0.5.1

package/dist/interactive/init-wizard.js

@@ -4,181 +4,250 @@
  * Guides users through project setup with sensible defaults.
  */
 import { select, confirm, input } from "@inquirer/prompts";
+import { writeOutput } from "../output/envelope.js";
 /**
  * Run the interactive init wizard.
  *
  * Guides user through configuration options and returns the chosen settings.
  *
+ * @param renderer - Optional renderer to suspend/resume during prompts
  * @returns Configuration object for writing to file
  */
-export async function runInitWizard() {
-    console.log("\n  Welcome to VertaaUX!\n");
-    console.log("  This wizard will help you configure VertaaUX for your project.\n");
+export async function runInitWizard(renderer) {
+    writeOutput("\n  Welcome to VertaaUX!\n\n");
+    writeOutput("  This wizard will help you configure VertaaUX for your project.\n\n");
     // Step 1: Default URL
-    const defaultUrl = await input({
-        message: "What URL would you like to audit? (optional)",
-        default: "",
-        validate: (value) => {
-            if (!value)
-                return true; // Optional
-            try {
-                new URL(value);
-                return true;
-            }
-            catch {
-                return "Please enter a valid URL (e.g., https://example.com)";
-            }
-        },
-    });
-    // Step 2: Audit mode
-    const mode = await select({
-        message: "Select audit mode:",
-        choices: [
-            {
-                name: "Basic - Quick scan for common issues",
-                value: "basic",
-                description: "Fastest, covers essential accessibility and UX checks",
-            },
-            {
-                name: "Standard - Comprehensive analysis",
-                value: "standard",
-                description: "Balanced depth and speed, recommended for most projects",
-            },
-            {
-                name: "Deep - Thorough multi-page audit",
-                value: "deep",
-                description: "Most thorough, includes page flow and cross-page issues",
+    renderer?.suspend();
+    let defaultUrl;
+    try {
+        defaultUrl = await input({
+            message: "What URL would you like to audit? (optional)",
+            default: "",
+            validate: (value) => {
+                if (!value)
+                    return true; // Optional
+                try {
+                    new URL(value);
+                    return true;
+                }
+                catch {
+                    return "Please enter a valid URL (e.g., https://example.com)";
+                }
             },
-        ],
-        default: "standard",
-    });
-    // Step 3: Configure baseline rules
-    const configureBaseline = await confirm({
-        message: "Configure baseline rules? (controls CI failure conditions)",
-        default: true,
-    });
-    let failOn = "error";
-    let threshold = 0;
-    let autoUpdateBaseline = false;
-    if (configureBaseline) {
-        // Step 3a: Fail-on severity
-        failOn = await select({
-            message: "Fail CI build when issues of this severity are found:",
+        }, { output: process.stderr });
+    }
+    finally {
+        renderer?.resume();
+    }
+    // Step 2: Audit mode
+    renderer?.suspend();
+    let mode;
+    try {
+        mode = await select({
+            message: "Select audit mode:",
             choices: [
                 {
-                    name: "Error - Only critical/error severity",
-                    value: "error",
-                    description: "Strictest, blocks on critical issues only",
-                },
-                {
-                    name: "Warning - Warnings and above",
-                    value: "warning",
-                    description: "Blocks on warning and error severity",
+                    name: "Basic - Quick scan for common issues",
+                    value: "basic",
+                    description: "Fastest, covers essential accessibility and UX checks",
                 },
                 {
-                    name: "Info - Any issues",
-                    value: "info",
-                    description: "Most strict, blocks on all issues",
+                    name: "Standard - Comprehensive analysis",
+                    value: "standard",
+                    description: "Balanced depth and speed, recommended for most projects",
                 },
                 {
-                    name: "None - Never fail on issues",
-                    value: "none",
-                    description: "Report only, never fail CI",
+                    name: "Deep - Thorough multi-page audit",
+                    value: "deep",
+                    description: "Most thorough, includes page flow and cross-page issues",
                 },
             ],
-            default: "error",
-        });
+            default: "standard",
+        }, { output: process.stderr });
+    }
+    finally {
+        renderer?.resume();
+    }
+    // Step 3: Configure baseline rules
+    renderer?.suspend();
+    let configureBaseline;
+    try {
+        configureBaseline = await confirm({
+            message: "Configure baseline rules? (controls CI failure conditions)",
+            default: true,
+        }, { output: process.stderr });
+    }
+    finally {
+        renderer?.resume();
+    }
+    let failOn = "error";
+    let threshold = 0;
+    let autoUpdateBaseline = false;
+    if (configureBaseline) {
+        // Step 3a: Fail-on severity
+        renderer?.suspend();
+        try {
+            failOn = await select({
+                message: "Fail CI build when issues of this severity are found:",
+                choices: [
+                    {
+                        name: "Error - Only critical/error severity",
+                        value: "error",
+                        description: "Strictest, blocks on critical issues only",
+                    },
+                    {
+                        name: "Warning - Warnings and above",
+                        value: "warning",
+                        description: "Blocks on warning and error severity",
+                    },
+                    {
+                        name: "Info - Any issues",
+                        value: "info",
+                        description: "Most strict, blocks on all issues",
+                    },
+                    {
+                        name: "None - Never fail on issues",
+                        value: "none",
+                        description: "Report only, never fail CI",
+                    },
+                ],
+                default: "error",
+            }, { output: process.stderr });
+        }
+        finally {
+            renderer?.resume();
+        }
         // Step 3b: Score threshold
-        const setThreshold = await confirm({
-            message: "Set a minimum score threshold?",
-            default: false,
-        });
+        renderer?.suspend();
+        let setThreshold;
+        try {
+            setThreshold = await confirm({
+                message: "Set a minimum score threshold?",
+                default: false,
+            }, { output: process.stderr });
+        }
+        finally {
+            renderer?.resume();
+        }
         if (setThreshold) {
-            const thresholdStr = await input({
-                message: "Minimum passing score (0-100):",
-                default: "70",
-                validate: (value) => {
-                    const num = parseInt(value, 10);
-                    if (isNaN(num) || num < 0 || num > 100) {
-                        return "Please enter a number between 0 and 100";
-                    }
-                    return true;
-                },
-            });
+            renderer?.suspend();
+            let thresholdStr;
+            try {
+                thresholdStr = await input({
+                    message: "Minimum passing score (0-100):",
+                    default: "70",
+                    validate: (value) => {
+                        const num = parseInt(value, 10);
+                        if (isNaN(num) || num < 0 || num > 100) {
+                            return "Please enter a number between 0 and 100";
+                        }
+                        return true;
+                    },
+                }, { output: process.stderr });
+            }
+            finally {
+                renderer?.resume();
+            }
             threshold = parseInt(thresholdStr, 10);
         }
         // Step 3c: Auto-update baseline
-        autoUpdateBaseline = await confirm({
-            message: "Auto-update baseline when issues are fixed on main branch?",
-            default: false,
-        });
+        renderer?.suspend();
+        try {
+            autoUpdateBaseline = await confirm({
+                message: "Auto-update baseline when issues are fixed on main branch?",
+                default: false,
+            }, { output: process.stderr });
+        }
+        finally {
+            renderer?.resume();
+        }
     }
     // Step 4: CI integration
-    const configureCI = await confirm({
-        message: "Configure CI integration?",
-        default: true,
-    });
+    renderer?.suspend();
+    let configureCI;
+    try {
+        configureCI = await confirm({
+            message: "Configure CI integration?",
+            default: true,
+        }, { output: process.stderr });
+    }
+    finally {
+        renderer?.resume();
+    }
     let ciProvider = "none";
     if (configureCI) {
-        ciProvider = await select({
-            message: "Which CI provider?",
-            choices: [
-                {
-                    name: "GitHub Actions",
-                    value: "github",
-                    description: "Creates .github/workflows/vertaa.yml with SARIF upload",
-                },
-                {
-                    name: "GitLab CI",
-                    value: "gitlab",
-                    description: "Creates .gitlab-ci-vertaa.yml with JUnit and Code Quality reports",
-                },
-                {
-                    name: "CircleCI",
-                    value: "circleci",
-                    description: "Creates .circleci/config-vertaa.yml with test results",
-                },
-                {
-                    name: "Azure DevOps",
-                    value: "azure",
-                    description: "Creates azure-pipelines-vertaa.yml with Advanced Security",
-                },
-                {
-                    name: "Jenkins",
-                    value: "jenkins",
-                    description: "Creates Jenkinsfile-vertaa with Warnings NG plugin",
-                },
-                {
-                    name: "None - Skip CI setup",
-                    value: "none",
-                },
-            ],
-            default: "github",
-        });
+        renderer?.suspend();
+        try {
+            ciProvider = await select({
+                message: "Which CI provider?",
+                choices: [
+                    {
+                        name: "GitHub Actions",
+                        value: "github",
+                        description: "Creates .github/workflows/vertaa.yml with SARIF upload",
+                    },
+                    {
+                        name: "GitLab CI",
+                        value: "gitlab",
+                        description: "Creates .gitlab-ci-vertaa.yml with JUnit and Code Quality reports",
+                    },
+                    {
+                        name: "CircleCI",
+                        value: "circleci",
+                        description: "Creates .circleci/config-vertaa.yml with test results",
+                    },
+                    {
+                        name: "Azure DevOps",
+                        value: "azure",
+                        description: "Creates azure-pipelines-vertaa.yml with Advanced Security",
+                    },
+                    {
+                        name: "Jenkins",
+                        value: "jenkins",
+                        description: "Creates Jenkinsfile-vertaa with Warnings NG plugin",
+                    },
+                    {
+                        name: "None - Skip CI setup",
+                        value: "none",
+                    },
+                ],
+                default: "github",
+            }, { output: process.stderr });
+        }
+        finally {
+            renderer?.resume();
+        }
     }
     // Step 5: Summary
-    console.log("\n  Configuration Summary:");
-    console.log("  ----------------------");
+    writeOutput("\n  Configuration Summary:\n");
+    writeOutput("  ----------------------\n");
     if (defaultUrl) {
-        console.log(`  URL:        ${defaultUrl}`);
+        writeOutput(`  URL:        ${defaultUrl}\n`);
     }
-    console.log(`  Mode:       ${mode}`);
-    console.log(`  Fail on:    ${failOn}`);
+    writeOutput(`  Mode:       ${mode}\n`);
+    writeOutput(`  Fail on:    ${failOn}\n`);
     if (threshold > 0) {
-        console.log(`  Threshold:  ${threshold}`);
+        writeOutput(`  Threshold:  ${threshold}\n`);
     }
     if (autoUpdateBaseline) {
-        console.log(`  Auto-update: enabled`);
+        writeOutput(`  Auto-update: enabled\n`);
     }
     if (ciProvider !== "none") {
-        console.log(`  CI:         ${ciProvider}`);
+        writeOutput(`  CI:         ${ciProvider}\n`);
     }
-    console.log("");
+    writeOutput("\n");
     // Step 6: Confirm
-    const create = await confirm({
-        message: "Create configuration?",
-        default: true,
-    });
+    renderer?.suspend();
+    let create;
+    try {
+        create = await confirm({
+            message: "Create configuration?",
+            default: true,
+        }, { output: process.stderr });
+    }
+    finally {
+        renderer?.resume();
+    }
     if (!create) {
         throw new Error("Configuration cancelled by user");
     }

package/dist/interactive/prompts.d.ts

@@ -7,6 +7,7 @@
  * - Enter to confirm
  * - Space to select (multi-select)
  */
+import type { Renderer } from "@vertaaux/tui";
 /**
  * Choice option for select prompts.
  */
@@ -27,26 +28,29 @@ export interface SelectChoice<T = string> {
  *
  * @param message - Prompt message
  * @param choices - List of options
+ * @param renderer - Optional renderer to suspend during prompt
  * @returns Selected value
  */
-export declare function selectAction<T = string>(message: string, choices: SelectChoice<T>[]): Promise<T>;
+export declare function selectAction<T = string>(message: string, choices: SelectChoice<T>[], renderer?: Renderer): Promise<T>;
 /**
  * Prompt user for yes/no confirmation.
  *
  * @param message - Question to confirm
  * @param defaultValue - Default value if user just presses Enter
+ * @param renderer - Optional renderer to suspend during prompt
  * @returns true for yes, false for no
  */
-export declare function confirmAction(message: string, defaultValue?: boolean): Promise<boolean>;
+export declare function confirmAction(message: string, defaultValue?: boolean, renderer?: Renderer): Promise<boolean>;
 /**
  * Prompt user for text input.
  *
  * @param message - Prompt message
  * @param defaultValue - Optional default value
  * @param required - Whether input is required (default: false)
+ * @param renderer - Optional renderer to suspend during prompt
  * @returns User input string
  */
-export declare function inputText(message: string, defaultValue?: string, required?: boolean): Promise<string>;
+export declare function inputText(message: string, defaultValue?: string, required?: boolean, renderer?: Renderer): Promise<string>;
 /**
  * Check if running in an interactive TTY environment.
  *

package/dist/interactive/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/interactive/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM;IACtC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,EAAE,CAAC,CAAC;IACT,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,MAAM,EAC3C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GACzB,OAAO,CAAC,CAAC,CAAC,CAUZ;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,OAAc,GAC3B,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAMzC"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/interactive/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM;IACtC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,EAAE,CAAC,CAAC;IACT,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,MAAM,EAC3C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,OAAc,EAC5B,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,GAAE,OAAe,EACzB,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAMzC"}

package/dist/interactive/prompts.js

@@ -15,31 +15,45 @@ import { select, confirm, input } from "@inquirer/prompts";
  *
  * @param message - Prompt message
  * @param choices - List of options
+ * @param renderer - Optional renderer to suspend during prompt
  * @returns Selected value
  */
-export async function selectAction(message, choices) {
-    return select({
-        message,
-        choices: choices.map((c) => ({
-            name: c.name,
-            value: c.value,
-            description: c.description,
-            disabled: c.disabled,
-        })),
-    });
+export async function selectAction(message, choices, renderer) {
+    renderer?.suspend();
+    try {
+        return await select({
+            message,
+            choices: choices.map((c) => ({
+                name: c.name,
+                value: c.value,
+                description: c.description,
+                disabled: c.disabled,
+            })),
+        }, { output: process.stderr });
+    }
+    finally {
+        renderer?.resume();
+    }
 }
 /**
  * Prompt user for yes/no confirmation.
  *
  * @param message - Question to confirm
  * @param defaultValue - Default value if user just presses Enter
+ * @param renderer - Optional renderer to suspend during prompt
  * @returns true for yes, false for no
  */
-export async function confirmAction(message, defaultValue = true) {
-    return confirm({
-        message,
-        default: defaultValue,
-    });
+export async function confirmAction(message, defaultValue = true, renderer) {
+    renderer?.suspend();
+    try {
+        return await confirm({
+            message,
+            default: defaultValue,
+        }, { output: process.stderr });
+    }
+    finally {
+        renderer?.resume();
+    }
 }
 /**
  * Prompt user for text input.
@@ -47,16 +61,23 @@ export async function confirmAction(message, defaultValue = true) {
  * @param message - Prompt message
  * @param defaultValue - Optional default value
  * @param required - Whether input is required (default: false)
+ * @param renderer - Optional renderer to suspend during prompt
  * @returns User input string
  */
-export async function inputText(message, defaultValue, required = false) {
-    return input({
-        message,
-        default: defaultValue,
-        validate: required
-            ? (value) => (value.trim() ? true : "This field is required")
-            : undefined,
-    });
+export async function inputText(message, defaultValue, required = false, renderer) {
+    renderer?.suspend();
+    try {
+        return await input({
+            message,
+            default: defaultValue,
+            validate: required
+                ? (value) => (value.trim() ? true : "This field is required")
+                : undefined,
+        }, { output: process.stderr });
+    }
+    finally {
+        renderer?.resume();
+    }
 }
 /**
  * Check if running in an interactive TTY environment.

package/dist/output/envelope.d.ts

@@ -17,5 +17,14 @@ export interface OutputEnvelope<T = unknown> {
 }
 export declare function createEnvelope<T>(data: T, command: string): OutputEnvelope<T>;
 export declare function writeJsonOutput<T>(data: T, command: string): void;
+/** Redirect output helpers to a buffer. Pass null to restore direct terminal writes. */
+export declare function setOutputBuffer(buffer: string[] | null): void;
+/**
+ * Write command payloads to stdout so they remain pipeable.
+ */
+export declare function writeDataOutput(content: string): void;
+/**
+ * Write diagnostics and notices to stderr.
+ */
 export declare function writeOutput(content: string): void;
 //# sourceMappingURL=envelope.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/output/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,CAAC,CAAC;CACT;AA0DD,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAU7E;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGjE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD"}
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/output/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,CAAC,CAAC;CACT;AA2DD,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAU7E;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQjE;AASD,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,CAE7D;AAUD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD"}

package/dist/output/envelope.js

@@ -45,7 +45,8 @@ function redactArgs(argv) {
             }
         }
         if (isSecretArg(arg)) {
-            continue; // drop entirely (env var leaks like VERTAAUX_API_KEY=...)
+            result.push("[REDACTED]");
+            continue;
         }
         result.push(arg);
     }
@@ -64,8 +65,41 @@ export function createEnvelope(data, command) {
 }
 export function writeJsonOutput(data, command) {
     const envelope = createEnvelope(data, command);
-    process.stdout.write(JSON.stringify(envelope, null, 2) + "\n");
+    const content = JSON.stringify(envelope, null, 2);
+    if (_outputBuffer) {
+        _outputBuffer.push(...content.split("\n"));
+    }
+    else {
+        process.stdout.write(content + "\n");
+    }
 }
+/**
+ * Output buffer for interactive mode. When set, output helpers append
+ * to this buffer instead of writing to the terminal (to avoid garbling
+ * the InteractiveApp's alt screen).
+ */
+let _outputBuffer = null;
+/** Redirect output helpers to a buffer. Pass null to restore direct terminal writes. */
+export function setOutputBuffer(buffer) {
+    _outputBuffer = buffer;
+}
+function writeBuffered(content, writer) {
+    if (_outputBuffer) {
+        _outputBuffer.push(...content.split("\n"));
+    }
+    else {
+        writer(content + "\n");
+    }
+}
+/**
+ * Write command payloads to stdout so they remain pipeable.
+ */
+export function writeDataOutput(content) {
+    writeBuffered(content, (payload) => process.stdout.write(payload));
+}
+/**
+ * Write diagnostics and notices to stderr.
+ */
 export function writeOutput(content) {
-    process.stdout.write(content + "\n");
+    writeBuffered(content, (payload) => process.stderr.write(payload));
 }

package/dist/output/factory.d.ts

@@ -10,6 +10,7 @@ import { type FormatHtmlOptions } from "./html.js";
 import { type SarifOptions } from "./sarif.js";
 import { type JunitOptions } from "./junit.js";
 import { type OutputFormat } from "../utils/detect-env.js";
+import type { AuditScores } from "@vertaaux/sdk";
 export interface AuditResult {
     job_id?: string;
     status?: string;
@@ -19,7 +20,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;
     analysis_type?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/output/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE/E,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;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,aAAa;IAC5B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,0BAA0B;IAC1B,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;CACpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,YAAY,GAAG,MAAe,GAAG,SAAS,CA4B9E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CAIR;AAGD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/output/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC/E,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;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,aAAa;IAC5B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,0BAA0B;IAC1B,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;CACpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,YAAY,GAAG,MAAe,GAAG,SAAS,CA4B9E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CAIR;AAGD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/output/html.d.ts

@@ -4,6 +4,7 @@
  * Generates standalone HTML reports with embedded CSS and JS.
  * Reports are print-friendly and don't require external dependencies.
  */
+import type { AuditScores } from "@vertaaux/sdk";
 export interface Issue {
     id?: string;
     severity?: string;
@@ -24,7 +25,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;
 }