@vertaaux/cli 0.2.2 → 0.3.0

package/dist/index.js

@@ -10,6 +10,7 @@ import fs from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
 import { Command } from "commander";
+import { setColorEnabled, shouldUseColor } from "@vertaaux/tui";
 import { showBanner, getVersion } from "./ui/banner.js";
 import { registerAuditCommand } from "./commands/audit.js";
 import { registerBaselineCommand } from "./commands/baseline.js";
@@ -22,6 +23,13 @@ import { registerUploadCommand } from "./commands/upload.js";
 import { registerDownloadCommand } from "./commands/download.js";
 import { registerPolicyCommand } from "./commands/policy.js";
 import { registerDoctorCommand } from "./commands/doctor.js";
+import { registerSuggestCommand } from "./commands/suggest.js";
+import { registerTriageCommand } from "./commands/triage.js";
+import { registerFixPlanCommand } from "./commands/fix-plan.js";
+import { registerPatchReviewCommand } from "./commands/patch-review.js";
+import { registerCompareCommand } from "./commands/compare.js";
+import { registerReleaseNotesCommand } from "./commands/release-notes.js";
+import { registerDocCommand } from "./commands/doc.js";
 import { ExitCode } from "./utils/exit-codes.js";
 import { formatCommanderError } from "./ui/diagnostics.js";
 import { parseMode, parseTimeout, parseInterval, parseScore } from "./utils/validators.js";
@@ -625,7 +633,7 @@ async function runCompareCommand(base, urls, flags) {
     }
     printOutput(format, compare, formatCompareMarkdown(compare));
 }
-async function runFixCommand(base, jobId, issueId, flags) {
+async function runFixCommand(base, jobId, issueId, flags, globalFlags = {}) {
     const fileContent = getString(flags, "file-content");
     const format = resolveFormat(flags);
     if (!fileContent) {
@@ -649,8 +657,12 @@ async function runFixCommand(base, jobId, issueId, flags) {
     if (!result.success) {
         process.exitCode = 1;
     }
+    if (globalFlags.dryRun && isTTYOutput) {
+        process.stderr.write("[dry-run] Showing patch preview — no changes applied.\n\n");
+    }
     if (format === "json") {
-        console.log(JSON.stringify(result, null, 2));
+        const output = globalFlags.dryRun ? { ...result, dry_run: true } : result;
+        console.log(JSON.stringify(output, null, 2));
     }
     else {
         if (result.success && result.patch) {
@@ -708,7 +720,7 @@ async function runVerifyCommand(base, flags) {
     }
 }
 const BATCH_LIMIT = 10;
-async function runFixAllCommand(base, jobId, flags) {
+async function runFixAllCommand(base, jobId, flags, globalFlags = {}) {
     const fileContent = getString(flags, "file-content");
     const autoFixOnly = getBool(flags, "auto-fix-only");
     const format = resolveFormat(flags);
@@ -741,6 +753,21 @@ async function runFixAllCommand(base, jobId, flags) {
     if (isTTYOutput) {
         process.stderr.write("                    \r");
     }
+    // --dry-run: show what would be processed and exit
+    if (globalFlags.dryRun) {
+        process.stderr.write(`[dry-run] Would generate patches for ${issuesToProcess.length} issues:\n`);
+        for (const issue of issuesToProcess) {
+            process.stderr.write(`  - ${issue.id || "unknown"}: ${issue.title || issue.description || "(no title)"}\n`);
+        }
+        if (totalSkipped > 0) {
+            process.stderr.write(`  (${totalSkipped} additional issues skipped — batch limit ${BATCH_LIMIT})\n`);
+        }
+        process.stderr.write("\nNo patches generated. Remove --dry-run to execute.\n");
+        return;
+    }
+    // --yes is available for future interactive confirmation steps
+    // Currently fix-all runs non-interactively, but --yes suppresses any
+    // confirmation prompts that may be added (e.g., "Apply all N patches?")
     const results = {
         successes: [],
         failures: [],
@@ -845,6 +872,13 @@ program
     .option("-q, --quiet", "Suppress banner and non-essential output")
     .option("--no-banner", "Hide the V-mark banner")
     .option("--machine", "Strict machine-readable output (JSON stdout, diagnostics stderr)")
+    .option("--color", "Force color output")
+    .option("--no-color", "Disable color output")
+    .option("--dashboard", "Force live dashboard during audit --wait")
+    .option("--no-dashboard", "Disable live dashboard (use spinner instead)")
+    .option("--dry-run", "Show what would happen without executing")
+    .option("-y, --yes", "Auto-confirm all interactive prompts")
+    .option("--verbose", "Expand output with additional details")
     .configureOutput({
     outputError: (str, _write) => {
         const formatted = formatCommanderError(str);
@@ -864,9 +898,20 @@ program
     .hook("preAction", (thisCommand) => {
     const opts = thisCommand.optsWithGlobals();
     const machineMode = opts.machine || false;
+    // Apply color settings from flags or environment
+    if (opts.color === false || process.env.NO_COLOR !== undefined) {
+        setColorEnabled(false);
+    }
+    else if (opts.color === true || process.env.FORCE_COLOR !== undefined) {
+        setColorEnabled(true);
+    }
+    else {
+        setColorEnabled(shouldUseColor());
+    }
     if (machineMode) {
         opts.quiet = true;
         opts.banner = false;
+        setColorEnabled(false);
     }
     showBanner({
         version,
@@ -886,6 +931,13 @@ registerUploadCommand(program);
 registerDownloadCommand(program);
 registerPolicyCommand(program);
 registerDoctorCommand(program);
+registerSuggestCommand(program);
+registerTriageCommand(program);
+registerFixPlanCommand(program);
+registerPatchReviewCommand(program);
+registerCompareCommand(program);
+registerReleaseNotesCommand(program);
+registerDocCommand(program);
 // Legacy commands using old argument parsing
 // These will be migrated in subsequent plans
 program
@@ -924,24 +976,7 @@ program
         process.exit(ExitCode.ERROR);
     }
 });
-program
-    .command("compare <urlA> <urlB>")
-    .description("Compare audits of two URLs")
-    .option("--mode <mode>", "Audit depth: basic|standard|deep", parseMode, "basic")
-    .option("--wait", "Wait for audits to complete")
-    .option("--timeout <ms>", "Wait timeout in milliseconds (1-300000)", parseTimeout, 60000)
-    .option("--interval <ms>", "Poll interval in milliseconds (1-300000)", parseInterval, 5000)
-    .option("--fail-on-score <n>", "Exit non-zero if score below n (0-100)", parseScore)
-    .action(async (urlA, urlB, cmdOptions) => {
-    try {
-        const base = resolveApiBase(cmdOptions);
-        await runCompareCommand(base, [urlA, urlB], cmdOptions);
-    }
-    catch (error) {
-        process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}\n`);
-        process.exit(ExitCode.ERROR);
-    }
-});
+// compare is now registered via registerCompareCommand (Phase 60)
 program
     .command("status <jobId>")
     .description("Get status of an audit job")
@@ -973,13 +1008,14 @@ program
     .description("Generate a fix patch for an issue")
     .requiredOption("--issue <id>", "Issue ID to fix")
     .requiredOption("--file-content <code>", "Source code content")
-    .action(async (jobId, cmdOptions) => {
+    .action(async (jobId, cmdOptions, command) => {
     try {
+        const globalOpts = command.optsWithGlobals();
         const base = resolveApiBase(cmdOptions);
         const issueId = getString(cmdOptions, "issue");
         if (!issueId)
             throw new Error("--issue is required");
-        await runFixCommand(base, jobId, issueId, cmdOptions);
+        await runFixCommand(base, jobId, issueId, cmdOptions, { dryRun: !!globalOpts.dryRun });
     }
     catch (error) {
         process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}\n`);
@@ -991,10 +1027,11 @@ program
     .description("Generate fix patches for all issues in an audit")
     .requiredOption("--file-content <code>", "Source code content")
     .option("--auto-fix-only", "Only process auto-fixable issues")
-    .action(async (jobId, cmdOptions) => {
+    .action(async (jobId, cmdOptions, command) => {
     try {
+        const globalOpts = command.optsWithGlobals();
         const base = resolveApiBase(cmdOptions);
-        await runFixAllCommand(base, jobId, cmdOptions);
+        await runFixAllCommand(base, jobId, cmdOptions, { dryRun: !!globalOpts.dryRun, yes: !!globalOpts.yes });
     }
     catch (error) {
         process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}\n`);

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

@@ -1 +1 @@
-{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/output/formats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAM7D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMzD,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAclF;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,WAAW,EAAE,OAAO,GACnB,MAAM,CAMR"}
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/output/formats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAa7D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAazD,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAclF;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,WAAW,EAAE,OAAO,GACnB,MAAM,CASR"}

package/dist/output/formats.js

@@ -10,6 +10,13 @@ export const COMMAND_FORMATS = {
     explain: ["json", "human"],
     "policy-show": ["json", "yaml"],
     diff: ["json", "human"],
+    suggest: ["json", "human"],
+    triage: ["json", "human"],
+    "fix-plan": ["json", "human"],
+    "patch-review": ["json", "human"],
+    "release-notes": ["json", "human", "markdown"],
+    compare: ["json", "human"],
+    doc: ["json", "markdown"],
 };
 export const COMMAND_DEFAULT_FORMAT = {
     audit: "human",
@@ -17,6 +24,13 @@ export const COMMAND_DEFAULT_FORMAT = {
     explain: "human",
     "policy-show": "yaml",
     diff: "human",
+    suggest: "human",
+    triage: "human",
+    "fix-plan": "human",
+    "patch-review": "human",
+    "release-notes": "markdown",
+    compare: "human",
+    doc: "markdown",
 };
 export function validateFormat(command, format) {
     const allowed = COMMAND_FORMATS[command];
@@ -33,9 +47,11 @@ export function validateFormat(command, format) {
     return format;
 }
 export function resolveCommandFormat(command, explicitFormat, machineMode) {
+    // Treat "auto" as unset — let per-command defaults or machine mode decide
+    const format = explicitFormat === "auto" ? undefined : explicitFormat;
     // Machine mode defaults to JSON unless explicitly overridden
-    if (machineMode && !explicitFormat) {
+    if (machineMode && !format) {
         return "json";
     }
-    return validateFormat(command, explicitFormat);
+    return validateFormat(command, format);
 }

package/dist/output/human.d.ts

@@ -2,7 +2,7 @@
  * Human-readable output formatter for CLI.
  *
  * Outputs audit results as colorful, formatted text for terminal display.
- * Uses chalk for colors and cli-table3 for table formatting.
+ * Delegates to @vertaaux/tui for consistent rendering.
  */
 import { type FormatTableOptions } from "../ui/table.js";
 export interface AuditResult {
@@ -19,23 +19,14 @@ export interface AuditResult {
     error?: string;
 }
 export interface FormatHumanOptions {
-    /** How to group issues: severity (default), category, route */
     groupBy?: "severity" | "category" | "route";
-    /** Whether to show detailed scores table */
     showScores?: boolean;
-    /** Whether to show the summary at the end */
     showSummary?: boolean;
-    /** Maximum issues to display per group */
     maxIssuesPerGroup?: number;
-    /** Table formatting options */
     tableOptions?: FormatTableOptions;
 }
 /**
  * Format audit result as human-readable string.
- *
- * @param result - Audit result object
- * @param options - Formatting options
- * @returns Formatted string for terminal display
  */
 export declare function formatAuditHuman(result: AuditResult, options?: FormatHumanOptions): string;
 //# sourceMappingURL=human.d.ts.map

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;AAGH,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAGxB,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,+DAA+D;IAC/D,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IAC5C,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAmRD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAkDR"}
+{"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"}

package/dist/output/human.js

@@ -2,11 +2,10 @@
  * Human-readable output formatter for CLI.
  *
  * Outputs audit results as colorful, formatted text for terminal display.
- * Uses chalk for colors and cli-table3 for table formatting.
+ * Delegates to @vertaaux/tui for consistent rendering.
  */
-import chalk from "chalk";
+import { text, getTerminalWidth, scoreColor, boldColor, } from "@vertaaux/tui";
 import { formatIssuesTable, formatScoresTable, formatIssueSummary, groupBySeverity, groupByCategory, } from "../ui/table.js";
-import { shouldUseColor, getTerminalWidth } from "../utils/detect-env.js";
 /**
  * Normalize issues from various API response formats.
  */
@@ -34,41 +33,22 @@ function getOverallScore(scores) {
         return null;
     return Math.round(numeric.reduce((a, b) => a + b, 0) / numeric.length);
 }
-/**
- * Format a horizontal rule.
- */
-function hr() {
-    const width = Math.min(getTerminalWidth(), 80);
-    return shouldUseColor()
-        ? chalk.dim("-".repeat(width))
-        : "-".repeat(width);
-}
 /**
  * Format the header section.
  */
 function formatHeader(result) {
-    const useColor = shouldUseColor();
     const lines = [];
-    // Title
-    const title = useColor
-        ? chalk.bold.cyan("Audit Complete")
-        : "AUDIT COMPLETE";
-    lines.push(title);
-    // URL
+    lines.push(text.heading("Audit Complete"));
     if (result.url) {
-        const urlLine = useColor
-            ? chalk.dim("URL: ") + chalk.white(result.url)
-            : `URL: ${result.url}`;
-        lines.push(urlLine);
+        lines.push(`${text.dim("URL:")} ${text.link(result.url)}`);
     }
-    // Mode and Job ID
     const meta = [];
     if (result.mode)
         meta.push(`Mode: ${result.mode}`);
     if (result.job_id)
         meta.push(`Job: ${result.job_id}`);
     if (meta.length) {
-        lines.push(useColor ? chalk.dim(meta.join(" | ")) : meta.join(" | "));
+        lines.push(text.dim(meta.join(" | ")));
     }
     return lines.join("\n");
 }
@@ -76,34 +56,20 @@ function formatHeader(result) {
  * Format the scores section.
  */
 function formatScoresSection(scores) {
-    const useColor = shouldUseColor();
     const lines = [];
     lines.push("");
-    lines.push(useColor ? chalk.bold("Scores") : "SCORES");
-    lines.push(hr());
+    lines.push(text.bold("Scores"));
+    lines.push(text.hr(Math.min(getTerminalWidth(), 80)));
     if (!scores || Object.keys(scores).length === 0) {
-        lines.push(useColor ? chalk.dim("No scores available.") : "No scores available.");
+        lines.push(text.dim("No scores available."));
         return lines.join("\n");
     }
-    // Overall score with color coding
     const overall = getOverallScore(scores);
     if (overall !== null) {
-        let scoreDisplay = String(overall);
-        if (useColor) {
-            if (overall >= 90) {
-                scoreDisplay = chalk.green.bold(scoreDisplay);
-            }
-            else if (overall >= 70) {
-                scoreDisplay = chalk.yellow.bold(scoreDisplay);
-            }
-            else {
-                scoreDisplay = chalk.red.bold(scoreDisplay);
-            }
-        }
-        lines.push(`Overall: ${scoreDisplay}/100`);
+        const scoreStr = boldColor(String(overall), scoreColor(overall));
+        lines.push(`Overall: ${scoreStr}/100`);
         lines.push("");
     }
-    // Detailed scores table
     const numericScores = {};
     for (const [key, value] of Object.entries(scores)) {
         if (typeof value === "number" && key !== "overall") {
@@ -119,40 +85,29 @@ function formatScoresSection(scores) {
  * Format issues section grouped by severity.
  */
 function formatIssuesBySeverity(issues, maxPerGroup, tableOptions) {
-    const useColor = shouldUseColor();
     const lines = [];
     lines.push("");
-    lines.push(useColor ? chalk.bold("Issues") : "ISSUES");
-    lines.push(hr());
+    lines.push(text.bold("Issues"));
+    lines.push(text.hr(Math.min(getTerminalWidth(), 80)));
     if (issues.length === 0) {
-        lines.push(useColor ? chalk.green("No issues found!") : "No issues found!");
+        lines.push(text.success("No issues found!"));
         return lines.join("\n");
     }
-    // Group by severity
     const groups = groupBySeverity(issues);
-    const severityOrder = ["critical", "error", "serious", "warning", "minor", "moderate", "info"];
-    for (const severity of severityOrder) {
-        const groupIssues = groups.get(severity);
+    const order = ["critical", "error", "serious", "warning", "minor", "moderate", "info"];
+    for (const sev of order) {
+        const groupIssues = groups.get(sev);
         if (!groupIssues || groupIssues.length === 0)
             continue;
         const displayIssues = maxPerGroup
             ? groupIssues.slice(0, maxPerGroup)
             : groupIssues;
-        // Section header
-        const label = severity.toUpperCase();
-        const count = groupIssues.length;
-        const header = useColor
-            ? chalk.bold(`${label} (${count})`)
-            : `${label} (${count})`;
         lines.push("");
-        lines.push(header);
-        // Issues table for this severity
+        lines.push(text.bold(`${text.severityBadge(sev)} (${groupIssues.length})`));
         lines.push(formatIssuesTable(displayIssues, tableOptions));
-        // Show truncation message if needed
         if (maxPerGroup && groupIssues.length > maxPerGroup) {
             const remaining = groupIssues.length - maxPerGroup;
-            const msg = `...and ${remaining} more ${severity} issues`;
-            lines.push(useColor ? chalk.dim(msg) : msg);
+            lines.push(text.dim(`...and ${remaining} more ${sev} issues`));
         }
     }
     return lines.join("\n");
@@ -161,34 +116,25 @@ function formatIssuesBySeverity(issues, maxPerGroup, tableOptions) {
  * Format issues section grouped by category.
  */
 function formatIssuesByCategory(issues, maxPerGroup, tableOptions) {
-    const useColor = shouldUseColor();
     const lines = [];
     lines.push("");
-    lines.push(useColor ? chalk.bold("Issues by Category") : "ISSUES BY CATEGORY");
-    lines.push(hr());
+    lines.push(text.bold("Issues by Category"));
+    lines.push(text.hr(Math.min(getTerminalWidth(), 80)));
     if (issues.length === 0) {
-        lines.push(useColor ? chalk.green("No issues found!") : "No issues found!");
+        lines.push(text.success("No issues found!"));
         return lines.join("\n");
     }
-    // Group by category
     const groups = groupByCategory(issues);
     for (const [category, groupIssues] of groups) {
         const displayIssues = maxPerGroup
             ? groupIssues.slice(0, maxPerGroup)
             : groupIssues;
-        // Section header
-        const header = useColor
-            ? chalk.bold(`${category} (${groupIssues.length})`)
-            : `${category} (${groupIssues.length})`;
         lines.push("");
-        lines.push(header);
-        // Issues table for this category
+        lines.push(text.bold(`${category} (${groupIssues.length})`));
         lines.push(formatIssuesTable(displayIssues, tableOptions));
-        // Show truncation message if needed
         if (maxPerGroup && groupIssues.length > maxPerGroup) {
             const remaining = groupIssues.length - maxPerGroup;
-            const msg = `...and ${remaining} more issues`;
-            lines.push(useColor ? chalk.dim(msg) : msg);
+            lines.push(text.dim(`...and ${remaining} more issues`));
         }
     }
     return lines.join("\n");
@@ -197,14 +143,11 @@ function formatIssuesByCategory(issues, maxPerGroup, tableOptions) {
  * Format the summary section.
  */
 function formatSummary(issues, scores, threshold) {
-    const useColor = shouldUseColor();
     const lines = [];
     lines.push("");
-    lines.push(hr());
-    // Summary line
+    lines.push(text.hr(Math.min(getTerminalWidth(), 80)));
     const summary = formatIssueSummary(issues);
     lines.push(summary);
-    // Pass/fail status
     const overall = getOverallScore(scores);
     const hasErrors = issues.some((i) => i.severity?.toLowerCase() === "critical" || i.severity?.toLowerCase() === "error");
     let status;
@@ -223,50 +166,35 @@ function formatSummary(issues, scores, threshold) {
         passed = !hasErrors;
         status = passed ? "PASSED" : "FAILED";
     }
-    if (useColor) {
-        status = passed ? chalk.green.bold(status) : chalk.red.bold(status);
-    }
+    status = passed ? text.success(status) : text.error(status);
     lines.push(status);
     return lines.join("\n");
 }
 /**
  * Format audit result as human-readable string.
- *
- * @param result - Audit result object
- * @param options - Formatting options
- * @returns Formatted string for terminal display
  */
 export function formatAuditHuman(result, options = {}) {
     const { groupBy = "severity", showScores = true, showSummary = true, maxIssuesPerGroup = 10, tableOptions, } = options;
     const sections = [];
-    // Header
     sections.push(formatHeader(result));
-    // Handle non-completed audits
     if (result.status !== "completed") {
-        const useColor = shouldUseColor();
         sections.push("");
-        sections.push(useColor
-            ? chalk.yellow(`Status: ${result.status || "unknown"}`)
-            : `Status: ${result.status || "unknown"}`);
+        sections.push(text.warning(`Status: ${result.status || "unknown"}`));
         if (typeof result.progress === "number") {
             sections.push(`Progress: ${result.progress}%`);
         }
         return sections.join("\n");
     }
-    // Scores section
     if (showScores) {
         sections.push(formatScoresSection(result.scores));
     }
-    // Issues section
     const issues = normalizeIssues(result.issues);
     if (groupBy === "category") {
         sections.push(formatIssuesByCategory(issues, maxIssuesPerGroup, tableOptions));
     }
     else {
-        // Default: group by severity
         sections.push(formatIssuesBySeverity(issues, maxIssuesPerGroup, tableOptions));
     }
-    // Summary
     if (showSummary) {
         sections.push(formatSummary(issues, result.scores));
     }

package/dist/policy/sync.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Policy push/pull sync module for VertaaUX CLI.
+ *
+ * Provides bidirectional sync between local policy files and the server API.
+ * Uses the established CLI API patterns (resolveApiBase, getApiKey, apiRequest).
+ *
+ * Implements POL-10: Policy push/pull sync.
+ */
+import type { PolicyFile } from "@vertaaux/quality-control";
+import type { VertaauxConfig } from "../config/schema.js";
+export interface SyncConfig {
+    apiBase: string;
+    apiKey: string;
+}
+/**
+ * Build sync config from CLI config and environment.
+ * Uses the established CLI pattern: resolveApiBase + getApiKey.
+ */
+export declare function buildSyncConfig(cliConfig?: VertaauxConfig): SyncConfig;
+export interface PushResult {
+    success: boolean;
+    policyId: string;
+    version: number;
+    created: boolean;
+    error?: string;
+}
+export interface PullResult {
+    success: boolean;
+    policy?: PolicyFile;
+    policyId?: string;
+    version?: number;
+    name?: string;
+    error?: string;
+}
+/**
+ * Push a local policy file to the server.
+ *
+ * If a policy with the given name already exists, updates it (with optional
+ * optimistic locking via expectedVersion). Otherwise creates a new policy.
+ *
+ * @param policy - The policy content to push
+ * @param config - API connection config
+ * @param options - Push options (name, description, force, etc.)
+ * @returns Push result with success status, policy ID, and version
+ */
+export declare function pushPolicy(policy: PolicyFile, config: SyncConfig, options: {
+    name: string;
+    description?: string;
+    changeMessage?: string;
+    expectedVersion?: number;
+    force?: boolean;
+}): Promise<PushResult>;
+/**
+ * Pull a policy from the server.
+ *
+ * Finds the policy by ID, name, or defaults to the default/first policy.
+ * Returns the full policy content for writing to a local file.
+ *
+ * @param config - API connection config
+ * @param options - Pull options (policyId or policyName)
+ * @returns Pull result with policy content and metadata
+ */
+export declare function pullPolicy(config: SyncConfig, options: {
+    policyId?: string;
+    policyName?: string;
+}): Promise<PullResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/policy/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/policy/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,cAAc,GAAG,UAAU,CAKtE;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4BD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE;IACP,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,OAAO,CAAC,UAAU,CAAC,CA+ErB;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,UAAU,CAAC,CAuDrB"}