@vertaaux/cli 0.4.0 → 0.5.1

package/dist/ui/strings.js

@@ -0,0 +1,499 @@
+/**
+ * Tone-of-voice catalogue for VertaaUX CLI.
+ *
+ * Centralizes all user-facing strings for consistent messaging:
+ * - Gerund during action, past tense on completion (COPY-02)
+ * - Specific error messages with em-dash separator (COPY-03)
+ * - Recovery commands in every error (COPY-03)
+ * - Success messages include counts when applicable (COPY-04)
+ *
+ * Usage:
+ *   import { strings } from "../ui/strings.js";
+ *   createSpinner(strings.audit.run.action)
+ *   succeedSpinner(strings.audit.run.done(issueCount, url))
+ *   process.stderr.write(strings.common.notAuthenticated + "\n")
+ */
+// ---------------------------------------------------------------------------
+// Catalogue
+// ---------------------------------------------------------------------------
+export const strings = {
+    // ── Common ───────────────────────────────────────────────────────────────
+    common: {
+        /** Not authenticated error shown before any API command */
+        notAuthenticated: "Not authenticated — your credentials are missing or expired.\nRun vertaa login to authenticate.",
+        /** Invalid or expired token */
+        invalidToken: "Token invalid or expired — the stored credentials cannot be used.\nRun vertaa login to refresh your credentials.",
+        /** Network unreachable error */
+        networkError: "Network unreachable — the VertaaUX API could not be reached.\nRun vertaa doctor to diagnose connectivity.",
+        /** Config invalid error */
+        configInvalid: "Configuration invalid — .vertaaux.yml contains errors.\nRun vertaa doctor to validate your configuration.",
+        /** Generic API error fallback */
+        apiError: (code) => `API request failed — the server returned error ${code}.\nRun vertaa doctor to check connectivity and credentials.`,
+        /** Rate limit exceeded */
+        rateLimitExceeded: "Rate limit exceeded — you have reached the maximum request rate.\nRun vertaa status to check your quota and wait before retrying.",
+        /** Permission denied */
+        permissionDenied: "Permission denied — your account does not have access to this resource.\nRun vertaa doctor to verify your credentials and plan.",
+    },
+    // ── Audit ─────────────────────────────────────────────────────────────────
+    audit: {
+        /** Running the audit */
+        run: {
+            action: "Running audit...",
+            done: (issueCount, url) => `Audited ${url} — found ${issueCount} issue${issueCount === 1 ? "" : "s"}`,
+        },
+        /** Waiting for audit to complete */
+        wait: {
+            action: "Waiting for audit to complete...",
+            done: (issueCount) => `Audit complete — ${issueCount} issue${issueCount === 1 ? "" : "s"} found`,
+        },
+        /** Local URL capture */
+        localCapture: "Local URL detected — capturing page locally...",
+        /** Incremental mode */
+        incremental: (routeCount) => `Incremental mode — auditing ${routeCount} changed route${routeCount === 1 ? "" : "s"}`,
+        /** No route changes */
+        noRouteChanges: "No relevant route changes detected — skipping audit.",
+        /** Local page fetch in progress */
+        localFetch: {
+            action: "Fetching local page...",
+            done: () => "Local page fetched",
+        },
+        /** Analyzing captured local page */
+        localAnalyze: {
+            action: "Analyzing captured page...",
+            done: () => "Page analysis complete",
+        },
+        /** Progress update with URL */
+        progress: (url) => `Auditing ${url}`,
+        errors: {
+            /** All workspaces flag not yet implemented */
+            allWorkspacesNotImplemented: "--all-workspaces is not yet implemented — this feature is coming soon.\nRun vertaa audit <url> to audit individual workspace URLs.",
+            /** Audit job failed */
+            jobFailed: (jobId) => `Audit job failed — job ${jobId} did not complete successfully.\nRun vertaa doctor to check API connectivity.`,
+        },
+    },
+    // ── Upload ────────────────────────────────────────────────────────────────
+    upload: {
+        /** Uploading artifacts */
+        run: {
+            action: "Uploading audit results...",
+            done: (count) => `Uploaded ${count} artifact${count === 1 ? "" : "s"} to VertaaUX cloud`,
+        },
+        noJobId: "No job ID provided and no local results found.\nRun vertaa audit --save-trace to save local results first.",
+        shareUrl: "Share this URL with your team to view the results.",
+        errors: {
+            notAuthenticated: "Not authenticated — upload requires valid credentials.\nRun vertaa login to authenticate.",
+            uploadFailed: (reason) => `Upload failed — ${reason}.\nRun vertaa doctor to diagnose the issue.`,
+        },
+        success: (url) => `Uploaded results for: ${url}`,
+    },
+    // ── Login / Auth ──────────────────────────────────────────────────────────
+    login: {
+        /** Device flow in progress */
+        deviceFlow: {
+            action: "Starting device authentication flow...",
+            done: () => "Authentication successful",
+        },
+        /** Token validation */
+        validating: {
+            action: "Validating token...",
+            done: () => "Token validated",
+        },
+        success: "Authentication successful",
+        successWithName: (displayName) => `Authenticated as ${displayName}`,
+        logoutSuccess: "Logged out successfully.",
+        ssoNotImplemented: "SSO login is not yet implemented.\nUse --token for CI/API token authentication or omit flags for device code flow.",
+        validatingToken: "Validating token...",
+        tokenSaved: "Token saved to ~/.vertaaux/credentials.json",
+        envTokenFound: "Found token in environment, validating...",
+        envTokenSaved: "Token from environment saved to ~/.vertaaux/credentials.json",
+        startingAuth: "Starting authentication...",
+        noStoredCredentials: "No stored credentials found.",
+        credentialsRemoved: "Credentials removed from ~/.vertaaux/credentials.json",
+        runLoginHint: "\nRun vertaa login to authenticate.",
+        runLoginRefreshHint: "\nRun vertaa login to re-authenticate.",
+        errors: {
+            invalidToken: "Token invalid — the provided token could not be verified.\nRun vertaa login to authenticate with a valid token.",
+            envTokenInvalid: "Environment token invalid — VERTAAUX_API_KEY could not be verified.\nSet VERTAAUX_API_KEY to a valid API key to proceed.",
+            requiresTerminal: "Interactive login requires a terminal — no TTY detected.\nSet VERTAAUX_API_KEY environment variable for non-interactive authentication.",
+            loginFailed: (message) => `Login failed — ${message}.\nRun vertaa login to try again.`,
+        },
+        notAuthenticated: "Not authenticated.",
+        tokenExpired: "Token expired.",
+        tokenInvalidOrExpired: "Token invalid or expired.",
+    },
+    // ── Doctor ────────────────────────────────────────────────────────────────
+    doctor: {
+        /** Running all checks */
+        run: {
+            action: "Running diagnostics...",
+            done: (passCount, failCount) => `Diagnostics complete — ${passCount} passed, ${failCount} failed`,
+        },
+        title: (version) => `VertaaUX Doctor v${version}`,
+        results: {
+            allPassed: (count) => `All ${count} checks passed.`,
+            withWarnings: (count) => `All checks passed (${count} warning${count === 1 ? "" : "s"}).`,
+            withFailures: (failCount, total) => `${failCount} of ${total} check${failCount === 1 ? "" : "s"} failed.`,
+        },
+        checks: {
+            fix: "Fix:",
+            detail: "Detail:",
+        },
+    },
+    // ── Init ──────────────────────────────────────────────────────────────────
+    init: {
+        /** Writing config file */
+        run: {
+            action: "Initializing project...",
+            done: () => "Project initialized",
+        },
+        configExists: (path) => `Configuration file ${path} already exists — use --force to overwrite.`,
+        configCreated: (path) => `Created ${path}`,
+        templateCreated: (path) => `Created ${path}`,
+        templateNote: (instructions) => `Note: ${instructions}`,
+        success: "VertaaUX initialized successfully!",
+        cancelled: "Initialization cancelled.",
+        nextStepsHeader: "Next steps:",
+        nextSteps: {
+            runAudit: "Run your first audit with: vertaa audit <url>",
+            addGithubSecret: "Add VERTAAUX_API_KEY to GitHub Secrets",
+            addCISecret: "Add VERTAAUX_API_KEY to your CI environment",
+            createBaseline: "Create baseline for existing issues: vertaa baseline create",
+        },
+        errors: {
+            writeConfigFailed: (path, reason) => `Config write failed — could not create ${path}: ${reason}.\nCheck write permissions and try again.`,
+        },
+    },
+    // ── Baseline ─────────────────────────────────────────────────────────────
+    baseline: {
+        /** Creating baseline */
+        create: {
+            action: "Creating baseline...",
+            done: (issueCount) => `Created baseline with ${issueCount} issue${issueCount === 1 ? "" : "s"}`,
+        },
+        /** Listing baseline */
+        list: {
+            action: "Loading baseline...",
+            done: (issueCount) => `Baseline contains ${issueCount} issue${issueCount === 1 ? "" : "s"}`,
+        },
+        errors: {
+            loadFailed: (path) => `Baseline load failed — could not read ${path}.\nRun vertaa baseline create to initialize a baseline.`,
+            saveFailed: (reason) => `Baseline save failed — ${reason}.\nCheck write permissions and try again.`,
+            auditNotFound: (jobId) => `Audit not found — job ${jobId} does not exist or is still in progress.\nRun vertaa status ${jobId} to check audit status.`,
+        },
+    },
+    // ── Comment ───────────────────────────────────────────────────────────────
+    comment: {
+        /** Generating comment */
+        generate: {
+            action: "Generating PR comment...",
+            done: (issueCount) => `Generated comment with ${issueCount} issue${issueCount === 1 ? "" : "s"}`,
+        },
+        /** Posting comment */
+        post: {
+            action: "Posting comment...",
+            done: () => "Comment posted successfully",
+        },
+        errors: {
+            noInput: "No audit input provided — pipe JSON or specify --input.\nRun vertaa audit <url> --json | vertaa comment to generate a comment.",
+            postFailed: (reason) => `Comment post failed — ${reason}.\nRun vertaa comment --help to see posting options.`,
+        },
+    },
+    // ── Compare ───────────────────────────────────────────────────────────────
+    compare: {
+        /** Running comparison */
+        run: {
+            action: "Comparing audits...",
+            done: (deltaCount) => `Compared — ${Math.abs(deltaCount)} issue${Math.abs(deltaCount) === 1 ? "" : "s"} ${deltaCount >= 0 ? "improved" : "regressed"}`,
+        },
+        /** LLM analysis */
+        analyze: {
+            action: "Analyzing changes...",
+            done: () => "Analysis complete",
+        },
+        /** Running audit A */
+        auditA: {
+            action: "Running audit A...",
+            done: () => "Audit A complete",
+        },
+        /** Running audit B */
+        auditB: {
+            action: "Running audit B...",
+            done: () => "Audit B complete",
+        },
+        headings: {
+            comparison: "Audit Comparison",
+            overallScores: "Overall Scores",
+            categoryScores: "Category Scores",
+            issueCounts: "Issue Counts",
+            analysis: "Analysis",
+            improvements: (count) => `Improvements (${count})`,
+            regressions: (count) => `Regressions (${count})`,
+            unchanged: (count) => `Unchanged: ${count}`,
+        },
+        errors: {
+            bothUrlsRequired: "Both URLs required — provide two URLs to compare.\nRun vertaa compare <url-a> <url-b> to compare two pages.",
+            inputRequired: "No input provided — pipe diff JSON or specify --before/--after.\nRun vertaa diff --job-a <id> --job-b <id> --json | vertaa compare to compare audits.",
+            missingJobIds: "Missing job IDs — comparison requires two audit job IDs.\nRun vertaa compare --help to see usage.",
+            urlsOrFilesRequired: "Both URLs or both files required — provide two URLs or use --before/--after.\nUsage:\n  vertaa compare https://a.com https://b.com --wait\n  vertaa compare --before baseline.json --after current.json\nRun vertaa compare --help to see all options.",
+            beforeAfterRequired: "Both files required — --before and --after are required for file-based comparison.\nRun vertaa compare --before <file> --after <file>.",
+            readFailed: "Could not read audit files — check that the paths are correct.\nRun vertaa compare --help to see file input options.",
+        },
+    },
+    // ── Diff ──────────────────────────────────────────────────────────────────
+    diff: {
+        /** Computing diff */
+        run: {
+            action: "Computing diff...",
+            done: (newCount, fixedCount) => `Diff complete — ${newCount} new, ${fixedCount} fixed`,
+        },
+        errors: {
+            noBaseline: "No baseline found — create a baseline before diffing.\nRun vertaa baseline create to create a baseline.",
+            auditNotFound: (jobId) => `Audit not found — job ${jobId} does not exist.\nRun vertaa audit <url> --wait to run a new audit.`,
+        },
+    },
+    // ── Doc ───────────────────────────────────────────────────────────────────
+    doc: {
+        /** Generating playbook */
+        generate: {
+            action: "Generating team playbook...",
+            done: (sectionCount) => `Generated playbook with ${sectionCount} section${sectionCount === 1 ? "" : "s"}`,
+        },
+        errors: {
+            noInput: "No audit input provided — pipe JSON or specify --file or --job.\nRun vertaa audit <url> --json | vertaa doc to generate a playbook.",
+            generationFailed: (reason) => `Playbook generation failed — ${reason}.\nRun vertaa doctor to check API connectivity.`,
+        },
+    },
+    // ── Download ──────────────────────────────────────────────────────────────
+    download: {
+        /** Downloading artifacts */
+        run: {
+            action: "Downloading audit results...",
+            done: (count) => `Downloaded ${count} artifact${count === 1 ? "" : "s"}`,
+        },
+        /** Listing available audits */
+        list: {
+            action: "Fetching audit list...",
+            done: (count) => `Found ${count} audit${count === 1 ? "" : "s"}`,
+        },
+        /** Saving files */
+        saving: {
+            action: "Saving files...",
+            done: (count) => `Saved ${count} file${count === 1 ? "" : "s"}`,
+        },
+        /** Overwrite confirmation */
+        confirmOverwrite: (path) => `File ${path} already exists. Overwrite?`,
+        skipAuditResults: "Skipping audit results (file exists).",
+        skipAuditResultsWarn: (path) => `Skipping ${path} (already exists, use --force to overwrite)`,
+        skipBaseline: "Skipping baseline (file exists).",
+        skipBaselineWarn: "Skipping baseline (already exists, use --force to overwrite)",
+        pathTraversal: (filename) => `Security: Rejected artifact "${filename}" — path traversal outside output directory.`,
+        errors: {
+            notAuthenticated: "Not authenticated — download requires valid credentials.\nRun vertaa login to authenticate.",
+            downloadFailed: (reason) => `Download failed — ${reason}.\nRun vertaa doctor to diagnose the issue.`,
+        },
+    },
+    // ── Explain ───────────────────────────────────────────────────────────────
+    explain: {
+        /** Loading explanation */
+        run: {
+            action: "Generating explanation...",
+            done: (issueCount) => `Explained ${issueCount} issue${issueCount === 1 ? "" : "s"}`,
+        },
+        headings: {
+            aiExplanation: "AI Explanation",
+            summary: "Summary",
+            issues: "Issues",
+            issue: (ruleId, severity) => `ISSUE: ${ruleId} (${severity})`,
+            description: "DESCRIPTION",
+            selector: "SELECTOR",
+            wcag: "WCAG REFERENCE",
+            recommendation: "RECOMMENDATION",
+            evidence: "EVIDENCE",
+            fix: "Fix:",
+        },
+        errors: {
+            noInput: "No audit input provided — pipe JSON or specify --file or --job.\nRun vertaa audit <url> --json | vertaa explain to explain issues.",
+            issueNotFound: (id) => `Issue not found — finding ${id} does not exist in the audit results.\nRun vertaa audit <url> --json to get current issue IDs.`,
+            explanationFailed: (reason) => `Explanation failed — ${reason}.\nRun vertaa doctor to check API connectivity.`,
+            fileNotFound: (path) => `File not found — ${path} does not exist.\nCheck the path and try again.`,
+            noRecentAudits: "No recent audits found — provide --job or --file option.\nRun vertaa audit <url> --json | vertaa explain to explain issues.",
+            findingNotFound: (id, source) => `Finding "${id}" not found${source ? ` in ${source}` : ""}.\nRun vertaa audit <url> --json to get current issue IDs.`,
+            noAuditData: "No audit data provided — pipe JSON or specify --file or --job.\nRun vertaa audit https://example.com --json | vertaa explain to get started.",
+            noIssuesFound: "No issues found — the audit data contains no reported issues.\nRun vertaa audit <url> to generate a fresh audit.",
+        },
+        aiUnavailable: (reason) => `AI explanation unavailable — ${reason}.`,
+    },
+    // ── Fix Plan ──────────────────────────────────────────────────────────────
+    fixPlan: {
+        /** Generating fix plan */
+        generate: {
+            action: "Generating remediation plan...",
+            done: (itemCount) => `Generated plan with ${itemCount} fix item${itemCount === 1 ? "" : "s"}`,
+        },
+        summary: (itemCount, totalEffort) => `Remediation Plan (${itemCount} item${itemCount === 1 ? "" : "s"}) — estimated effort: ${totalEffort}`,
+        errors: {
+            noInput: "No audit input provided — pipe JSON or specify --file or --job.\nRun vertaa audit <url> --json | vertaa fix-plan to generate a plan.",
+            planFailed: (reason) => `Fix plan generation failed — ${reason}.\nRun vertaa doctor to check API connectivity.`,
+        },
+        labels: {
+            effort: "Effort:",
+            type: "Type:",
+            hint: "Hint:",
+        },
+    },
+    // ── Fix ───────────────────────────────────────────────────────────────────
+    fix: {
+        /** Generating patch */
+        generate: {
+            action: "Generating patch...",
+            done: () => "Patch generated",
+        },
+        dryRun: "Showing patch preview — no changes applied.",
+        errors: {
+            missingArgs: "Missing required arguments — fix requires --file-content.\nRun vertaa fix --help to see all required options.",
+            patchFailed: (reason) => `Patch generation failed — ${reason}.\nRun vertaa doctor to check API connectivity.`,
+        },
+    },
+    // ── Fix All ───────────────────────────────────────────────────────────────
+    fixAll: {
+        /** Fetching audit for batch fix */
+        fetchAudit: {
+            action: "Fetching audit...",
+            done: (issueCount) => `Fetched audit — ${issueCount} issue${issueCount === 1 ? "" : "s"} to process`,
+        },
+        /** Generating patches */
+        generate: {
+            action: "Generating patches...",
+            done: (patchCount) => `Generated ${patchCount} patch${patchCount === 1 ? "" : "es"}`,
+        },
+        auditIncomplete: (jobId, status) => `Audit ${jobId} is not complete — current status: ${status}`,
+        errors: {
+            missingArgs: "Missing required arguments — fix-all requires --file-content.\nRun vertaa fix-all --help to see all required options.",
+            patchFailed: (reason) => `Batch patch generation failed — ${reason}.\nRun vertaa doctor to check API connectivity.`,
+        },
+    },
+    // ── Patch Review ─────────────────────────────────────────────────────────
+    patchReview: {
+        /** Analyzing patch */
+        analyze: {
+            action: "Analyzing patch...",
+            done: (verdict) => `Analysis complete — verdict: ${verdict}`,
+        },
+        dryRun: "Would analyze diff against findings",
+        headings: {
+            concerns: "Concerns:",
+            findingsAddressed: (count) => `Findings addressed (${count}):`,
+            findingsRemaining: (count) => `Findings remaining (${count}):`,
+        },
+        errors: {
+            noInput: "No diff input provided — pipe a diff via stdin.\nRun vertaa patch-review --help to see input options.",
+            reviewFailed: (reason) => `Patch review failed — ${reason}.\nRun vertaa doctor to check API connectivity.`,
+        },
+    },
+    // ── Policy ────────────────────────────────────────────────────────────────
+    policy: {
+        /** Validating policy */
+        validate: {
+            action: "Validating policy...",
+            done: () => "Policy validated",
+        },
+        fileExists: (path) => `Policy file already exists — ${path}. Use --force to overwrite.`,
+        unknownTemplate: (template, available) => `Unknown template — '${template}' is not a valid policy template.\nAvailable templates: ${available}`,
+        created: (path, template) => `Created policy file: ${path} (template: ${template})`,
+        noPolicy: "No policy file found — using defaults.",
+        noPolicyHint: "Create a policy file with: vertaa policy init",
+        valid: (path) => `Policy file valid: ${path}`,
+        usingPolicy: (path, branchInfo) => `Policy: ${path}${branchInfo}`,
+        usingDefault: (branchInfo) => `Using default policy${branchInfo}`,
+        errors: {
+            validationFailed: "Policy validation failed — the policy file contains errors.\nRun vertaa policy validate to see detailed validation results.",
+            loadFailed: (message) => `Policy load failed — ${message}.\nRun vertaa policy validate to diagnose policy issues.`,
+        },
+    },
+    // ── Release Notes ─────────────────────────────────────────────────────────
+    releaseNotes: {
+        /** Generating release notes */
+        generate: {
+            action: "Generating release notes...",
+            done: () => "Release notes generated",
+        },
+        errors: {
+            noInput: "No diff input provided — pipe diff JSON or specify --file.\nRun vertaa diff --json | vertaa release-notes to generate notes.",
+            generationFailed: (reason) => `Release notes generation failed — ${reason}.\nRun vertaa doctor to check API connectivity.`,
+        },
+    },
+    // ── Scan ──────────────────────────────────────────────────────────────────
+    scan: {
+        /** Running scan (alias for audit) */
+        run: {
+            action: "Scanning...",
+            done: (issueCount, url) => `Scanned ${url} — ${issueCount} issue${issueCount === 1 ? "" : "s"} found`,
+        },
+        errors: {
+            scanFailed: (reason) => `Scan failed — ${reason}.\nRun vertaa doctor to diagnose the issue.`,
+        },
+    },
+    // ── Status ────────────────────────────────────────────────────────────────
+    status: {
+        /** Fetching job status */
+        fetch: {
+            action: "Fetching audit status...",
+            done: (status) => `Status: ${status}`,
+        },
+        errors: {
+            jobNotFound: (jobId) => `Job not found — ${jobId} does not exist.\nRun vertaa audit <url> to start a new audit.`,
+            fetchFailed: (reason) => `Status fetch failed — ${reason}.\nRun vertaa doctor to check API connectivity.`,
+        },
+    },
+    // ── Suggest ───────────────────────────────────────────────────────────────
+    suggest: {
+        /** Finding command suggestions */
+        search: {
+            action: "Finding matching commands...",
+            done: (count) => `Found ${count} matching command${count === 1 ? "" : "s"}`,
+        },
+        noMatches: "No matching commands found.",
+        noMatchesHint: "Run vertaa --help to see all commands.",
+        errors: {
+            noQuery: "No query provided — describe what you want to do.\nRun vertaa suggest \"check color contrast\" to get command suggestions.",
+            searchFailed: (reason) => `Command search failed — ${reason}.\nRun vertaa --help to browse available commands.`,
+            apiUnavailable: "API unavailable — using local catalog.\nRun vertaa doctor to check API connectivity.",
+        },
+    },
+    // ── Triage ────────────────────────────────────────────────────────────────
+    triage: {
+        /** Triaging issues */
+        run: {
+            action: "Triaging issues...",
+            done: (p0Count, p1Count, p2Count) => `Triage complete — ${p0Count} critical, ${p1Count} high, ${p2Count} medium`,
+        },
+        errors: {
+            noInput: "No audit input provided — pipe JSON or specify --file or --job.\nRun vertaa audit <url> --json | vertaa triage to triage issues.",
+            triageFailed: (reason) => `Triage failed — ${reason}.\nRun vertaa doctor to check API connectivity.`,
+        },
+    },
+    // ── Verify ────────────────────────────────────────────────────────────────
+    verify: {
+        /** Running verification */
+        run: {
+            action: "Verifying fix...",
+            done: (passed) => passed ? "Verification passed — fix is effective" : "Verification failed — issue still present",
+        },
+        dryRun: "Showing verification preview — no changes applied.",
+        errors: {
+            missingArgs: "Missing required arguments — verify requires --search, --replace, --issue, --url, and --selector.\nRun vertaa verify --help to see all required options.",
+            verifyFailed: (reason) => `Verification failed — ${reason}.\nRun vertaa doctor to check API connectivity.`,
+        },
+    },
+    // ── A11y ──────────────────────────────────────────────────────────────────
+    a11y: {
+        /** Running accessibility audit */
+        run: {
+            action: "Running accessibility audit...",
+            done: (issueCount, url) => `Audited ${url} — ${issueCount} accessibility issue${issueCount === 1 ? "" : "s"} found`,
+        },
+        errors: {
+            auditFailed: (reason) => `Accessibility audit failed — ${reason}.\nRun vertaa doctor to check API connectivity.`,
+        },
+    },
+};

package/dist/ui/table.d.ts

@@ -14,8 +14,6 @@ export interface Issue {
     wcag_reference?: string;
 }
 export interface FormatTableOptions {
-    /** Maximum width for description column */
-    maxDescriptionWidth?: number;
     /** Maximum width for selector column */
     maxSelectorWidth?: number;
     /** Whether to show the selector column */

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

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/ui/table.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,WAAW,KAAK;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAaD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CASrE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CASrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAuCR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,CA2BlF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CA4B1D"}
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/ui/table.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,WAAW,KAAK;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAaD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CASrE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CASrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAqCR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,CA2BlF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CA4B1D"}

package/dist/ui/table.js

@@ -51,12 +51,12 @@ export function formatIssuesTable(issues, options = {}) {
             ? text.success("No issues found.")
             : "No issues found.";
     }
-    const { maxDescriptionWidth = 50, maxSelectorWidth = 30, showSelector = true, showCategory = false, } = options;
+    const { maxSelectorWidth = 30, showSelector = false, showCategory = false, } = options;
     const sorted = sortBySeverity(issues);
+    // Description gets remaining width — no fixed truncation
     const columns = [
         { key: "severity", label: "Severity", width: 10, color: (val) => text.severityBadge(val) },
-        { key: "id", label: "ID", width: 20 },
-        { key: "description", label: "Description", width: maxDescriptionWidth },
+        { key: "description", label: "Description" },
     ];
     if (showCategory) {
         columns.push({ key: "category", label: "Category", width: 15 });
@@ -66,7 +66,6 @@ export function formatIssuesTable(issues, options = {}) {
     }
     const rows = sorted.map((issue) => ({
         severity: issue.severity?.toLowerCase() || "info",
-        id: issue.id || "-",
         description: issue.description || issue.title || "-",
         category: issue.category || "-",
         selector: issue.selector || "-",

package/dist/utils/api-client.d.ts

@@ -0,0 +1,46 @@
+/**
+ * API client utilities for the VertaaUX CLI legacy commands.
+ * Provides argument parsing helpers, API request function, and polling utilities.
+ *
+ * NOTE: resolveApiBase, getApiKey, sleep, apiRequest, and waitForAudit are
+ * now imported from ./client to avoid duplication. The legacy DEFAULT_API_BASE
+ * (which had a wrong path) is replaced by the corrected value in client.ts.
+ */
+import type { Flags } from "../types.js";
+import type { Audit } from "@vertaaux/sdk";
+import { sleep, createClient } from "./client.js";
+export type { Audit as AuditResponse };
+export { sleep, createClient };
+/**
+ * Legacy 3-arg apiRequest wrapper for legacy commands that don't pass apiKey
+ * explicitly (they rely on VERTAAUX_API_KEY from environment).
+ * Delegates to client.ts apiRequest with the key resolved internally.
+ */
+export declare function apiRequest<T>(base: string, reqPath: string, options: {
+    method: string;
+    body?: unknown;
+}): Promise<T>;
+/**
+ * Legacy waitForAudit wrapper that accepts base/jobId/timeout/interval (no apiKey param).
+ * Delegates to client.ts waitForAudit with key resolved internally.
+ */
+export declare function waitForAudit(base: string, jobId: string, timeoutMs: number, intervalMs: number): Promise<Audit>;
+export declare function parseArgs(args: string[]): {
+    positional: string[];
+    flags: Flags;
+};
+export declare function getString(flags: Flags, key: string): string | undefined;
+export declare function getBool(flags: Flags, key: string): boolean;
+export declare function getNumber(flags: Flags, key: string): number | undefined;
+export declare function resolveFormat(flags: Flags): "json" | "md";
+/**
+ * Resolve API base URL for legacy commands that pass Flags objects.
+ * Delegates to client.ts resolveApiBase with the corrected default base URL.
+ */
+export declare function resolveApiBase(flags: Flags): string;
+/**
+ * Get API key for legacy commands.
+ * Delegates to client.ts getApiKey.
+ */
+export declare function getApiKey(): string;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/utils/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/utils/api-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAGL,KAAK,EAGL,YAAY,EAEb,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,KAAK,IAAI,aAAa,EAAE,CAAC;AAGvC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAE/B;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1C,OAAO,CAAC,CAAC,CAAC,CAGZ;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,KAAK,CAAC,CAGhB;AAMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE;;;EA8EvC;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUvE;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAM1D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQvE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAMzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAGnD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC"}