@vertaaux/cli 0.2.0

package/dist/templates/github-actions.js

@@ -0,0 +1,393 @@
+/**
+ * GitHub Actions workflow template generator.
+ *
+ * Generates production-ready GitHub Actions workflows for VertaaUX integration
+ * with SARIF upload for Code Scanning, artifact storage, and PR comments.
+ *
+ * @see https://docs.github.com/en/actions
+ * @see https://docs.github.com/en/code-security/code-scanning/integrating-with-code-scanning/sarif-support-for-code-scanning
+ */
+/**
+ * Default workflow options.
+ */
+const DEFAULT_OPTIONS = {
+    auditUrl: "",
+    failOn: "error",
+    threshold: 0,
+    uploadSarif: true,
+    uploadArtifacts: true,
+    postComment: true,
+    nodeVersion: "20",
+    enableCaching: true,
+    monorepo: false,
+};
+/**
+ * Generate a production-ready GitHub Actions workflow for VertaaUX.
+ *
+ * Features:
+ * - Triggers on pull_request and push to main/master
+ * - SARIF upload for inline Code Scanning annotations
+ * - HTML report and artifact upload
+ * - PR comment with results summary using sticky comments
+ * - Proper exit code handling for CI gating
+ *
+ * @param options - Workflow generation options
+ * @returns YAML workflow content
+ *
+ * @example
+ * ```typescript
+ * const workflow = generateGitHubActionsWorkflow({
+ *   auditUrl: 'https://example.com',
+ *   failOn: 'warning',
+ *   uploadSarif: true,
+ *   postComment: true,
+ * });
+ * ```
+ */
+export function generateGitHubActionsWorkflow(options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    // Build audit command with options
+    const auditParts = ["vertaa audit"];
+    if (opts.auditUrl) {
+        auditParts.push(`"${opts.auditUrl}"`);
+    }
+    if (opts.failOn && opts.failOn !== "none") {
+        auditParts.push(`--fail-on ${opts.failOn}`);
+    }
+    if (opts.threshold > 0) {
+        auditParts.push(`--threshold ${opts.threshold}`);
+    }
+    const auditCommand = auditParts.join(" ");
+    // Build the YAML workflow
+    // Note: Using \${{ }} to escape GitHub Actions expressions
+    const yaml = `# VertaaUX Accessibility & UX Audit
+# https://vertaaux.ai
+#
+# This workflow runs VertaaUX audits on pull requests and pushes,
+# uploading results to GitHub Code Scanning and posting PR comments.
+
+name: VertaaUX Audit
+
+on:
+  pull_request:
+    branches: [main, master]
+  push:
+    branches: [main, master]
+
+permissions:
+  contents: read
+  pull-requests: write
+  security-events: write
+
+jobs:
+  audit:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '${opts.nodeVersion}'
+          cache: 'npm'
+${opts.enableCaching
+        ? `
+      # Cache node_modules for faster installs
+      - name: Cache node_modules
+        uses: actions/cache@v4
+        with:
+          path: node_modules
+          key: npm-\${{ runner.os }}-\${{ hashFiles('package-lock.json', 'yarn.lock', 'pnpm-lock.yaml') }}
+          restore-keys: |
+            npm-\${{ runner.os }}-
+
+      # Cache Playwright browsers (if used)
+      - name: Get Playwright version
+        id: playwright-version
+        run: echo "version=$(npm show playwright version 2>/dev/null || echo 'none')" >> $GITHUB_OUTPUT
+
+      - name: Cache Playwright browsers
+        if: steps.playwright-version.outputs.version != 'none'
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-\${{ runner.os }}-\${{ steps.playwright-version.outputs.version }}
+
+      # Cache VertaaUX route results for incremental audits
+      - name: Cache VertaaUX results
+        uses: actions/cache@v4
+        with:
+          path: .vertaaux/route-cache.json
+          key: vertaaux-routes-\${{ github.sha }}
+          restore-keys: |
+            vertaaux-routes-
+`
+        : ""}
+      - name: Install VertaaUX CLI
+        run: npm install -g @vertaaux/cli
+
+      - name: Run Audit
+        id: audit
+        continue-on-error: true
+        env:
+          VERTAAUX_API_KEY: \${{ secrets.VERTAAUX_API_KEY }}
+        run: |
+          # Run audit with SARIF output
+          ${auditCommand} --format sarif --output results.sarif
+          AUDIT_EXIT_CODE=$?
+          echo "exit_code=$AUDIT_EXIT_CODE" >> $GITHUB_OUTPUT
+
+          # Generate HTML report
+          ${auditCommand} --format html --output vertaaux-report.html
+
+          # Generate JSON for comment generation
+          ${auditCommand} --format json --output results.json
+
+          exit 0  # Don't fail yet, we want to upload artifacts first
+${opts.uploadSarif
+        ? `
+      - name: Upload SARIF to GitHub Code Scanning
+        uses: github/codeql-action/upload-sarif@v3
+        if: always()
+        with:
+          sarif_file: results.sarif
+          category: vertaaux
+`
+        : ""}${opts.uploadArtifacts
+        ? `
+      - name: Upload Audit Artifacts
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: vertaaux-report
+          path: |
+            results.sarif
+            results.json
+            vertaaux-report.html
+          retention-days: 30
+`
+        : ""}${opts.postComment
+        ? `
+      - name: Generate PR Comment
+        if: github.event_name == 'pull_request'
+        env:
+          VERTAAUX_API_KEY: \${{ secrets.VERTAAUX_API_KEY }}
+        run: |
+          vertaa comment --input results.json --format markdown > comment.md
+
+      - name: Post PR Comment
+        uses: marocchino/sticky-pull-request-comment@v2
+        if: github.event_name == 'pull_request'
+        with:
+          header: vertaaux-audit
+          path: comment.md
+`
+        : ""}
+      - name: Check Audit Result
+        if: always()
+        run: |
+          if [ "\${{ steps.audit.outputs.exit_code }}" != "0" ]; then
+            echo "Audit found issues that exceed the configured threshold"
+            exit \${{ steps.audit.outputs.exit_code }}
+          fi
+`;
+    return yaml;
+}
+/**
+ * Generate a minimal GitHub Actions workflow (basic SARIF upload only).
+ *
+ * @returns YAML workflow content
+ */
+export function generateMinimalWorkflow() {
+    return generateGitHubActionsWorkflow({
+        uploadSarif: true,
+        uploadArtifacts: false,
+        postComment: false,
+    });
+}
+/**
+ * Generate a monorepo-aware GitHub Actions workflow.
+ *
+ * This workflow first detects all auditable apps in the monorepo,
+ * then runs audits in parallel using a matrix strategy.
+ *
+ * @param options - Workflow generation options
+ * @returns YAML workflow content
+ *
+ * @example
+ * ```typescript
+ * const workflow = generateMonorepoWorkflow({
+ *   failOn: 'warning',
+ *   uploadSarif: true,
+ * });
+ * ```
+ */
+export function generateMonorepoWorkflow(options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options, monorepo: true };
+    return `# VertaaUX Monorepo Audit
+# https://vertaaux.ai
+#
+# This workflow detects all apps in your monorepo and audits them in parallel.
+
+name: VertaaUX Monorepo Audit
+
+on:
+  pull_request:
+    branches: [main, master]
+  push:
+    branches: [main, master]
+
+permissions:
+  contents: read
+  pull-requests: write
+  security-events: write
+
+jobs:
+  detect-apps:
+    name: Detect Auditable Apps
+    runs-on: ubuntu-latest
+    outputs:
+      matrix: \${{ steps.detect.outputs.matrix }}
+      has_apps: \${{ steps.detect.outputs.has_apps }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '${opts.nodeVersion}'
+
+      - name: Install VertaaUX CLI
+        run: npm install -g @vertaaux/cli
+
+      - name: Detect monorepo apps
+        id: detect
+        run: |
+          MATRIX=$(vertaa audit --detect-matrix --json)
+          echo "matrix=$MATRIX" >> $GITHUB_OUTPUT
+          # Check if matrix has any apps
+          APP_COUNT=$(echo "$MATRIX" | jq '.include | length')
+          if [ "$APP_COUNT" -gt 0 ]; then
+            echo "has_apps=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_apps=false" >> $GITHUB_OUTPUT
+          fi
+          echo "Detected $APP_COUNT auditable apps"
+
+  audit:
+    name: Audit \${{ matrix.name }}
+    needs: detect-apps
+    if: needs.detect-apps.outputs.has_apps == 'true'
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix: \${{ fromJson(needs.detect-apps.outputs.matrix) }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '${opts.nodeVersion}'
+          cache: 'npm'
+${opts.enableCaching
+        ? `
+      - name: Cache node_modules
+        uses: actions/cache@v4
+        with:
+          path: node_modules
+          key: npm-\${{ runner.os }}-\${{ hashFiles('package-lock.json') }}
+          restore-keys: |
+            npm-\${{ runner.os }}-
+
+      - name: Cache VertaaUX results
+        uses: actions/cache@v4
+        with:
+          path: .vertaaux/route-cache.json
+          key: vertaaux-\${{ matrix.name }}-\${{ github.sha }}
+          restore-keys: |
+            vertaaux-\${{ matrix.name }}-
+`
+        : ""}
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install VertaaUX CLI
+        run: npm install -g @vertaaux/cli
+
+      - name: Run Audit for \${{ matrix.name }}
+        id: audit
+        continue-on-error: true
+        env:
+          VERTAAUX_API_KEY: \${{ secrets.VERTAAUX_API_KEY }}
+        run: |
+          vertaa audit --workspace \${{ matrix.name }} ${opts.failOn !== "none" ? `--fail-on ${opts.failOn}` : ""} \\
+            --format sarif --output results-\${{ matrix.name }}.sarif
+          AUDIT_EXIT_CODE=$?
+          echo "exit_code=$AUDIT_EXIT_CODE" >> $GITHUB_OUTPUT
+
+          # Generate JSON for aggregation
+          vertaa audit --workspace \${{ matrix.name }} --format json --output results-\${{ matrix.name }}.json
+
+          exit 0
+${opts.uploadSarif
+        ? `
+      - name: Upload SARIF
+        uses: github/codeql-action/upload-sarif@v3
+        if: always()
+        with:
+          sarif_file: results-\${{ matrix.name }}.sarif
+          category: vertaaux-\${{ matrix.name }}
+`
+        : ""}${opts.uploadArtifacts
+        ? `
+      - name: Upload Artifacts
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: vertaaux-\${{ matrix.name }}
+          path: |
+            results-\${{ matrix.name }}.sarif
+            results-\${{ matrix.name }}.json
+          retention-days: 30
+`
+        : ""}
+      - name: Check Audit Result
+        if: always()
+        run: |
+          if [ "\${{ steps.audit.outputs.exit_code }}" != "0" ]; then
+            echo "Audit for \${{ matrix.name }} found issues"
+            exit \${{ steps.audit.outputs.exit_code }}
+          fi
+
+  summary:
+    name: Aggregate Results
+    needs: [detect-apps, audit]
+    if: always() && needs.detect-apps.outputs.has_apps == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: vertaaux-*
+          merge-multiple: true
+
+      - name: Summarize results
+        run: |
+          echo "## VertaaUX Audit Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          for file in results-*.json; do
+            if [ -f "$file" ]; then
+              APP=$(echo "$file" | sed 's/results-//' | sed 's/.json//')
+              ISSUES=$(jq '.issues | length // 0' "$file" 2>/dev/null || echo "0")
+              echo "- **$APP**: $ISSUES issues" >> $GITHUB_STEP_SUMMARY
+            fi
+          done
+`;
+}

package/dist/templates/gitlab-ci.d.ts

@@ -0,0 +1,26 @@
+/**
+ * GitLab CI template generator for VertaaUX.
+ *
+ * Generates .gitlab-ci.yml configuration with native GitLab integrations:
+ * - JUnit reports for test results integration
+ * - Code Quality reports for merge request widget
+ * - HTML report as artifact
+ *
+ * @see https://docs.gitlab.com/ci/yaml/artifacts_reports/
+ */
+export interface GitLabOptions {
+    /** URL to audit (optional, can be set in config) */
+    auditUrl?: string;
+    /** Severity threshold for CI failure */
+    failOn?: "error" | "warning" | "info" | "none";
+    /** Minimum score threshold (0 = disabled) */
+    threshold?: number;
+}
+/**
+ * Generate GitLab CI template for VertaaUX integration.
+ *
+ * @param options - Configuration options
+ * @returns YAML template content
+ */
+export declare function generateGitLabCITemplate(options?: GitLabOptions): string;
+//# sourceMappingURL=gitlab-ci.d.ts.map

package/dist/templates/gitlab-ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-ci.d.ts","sourceRoot":"","sources":["../../src/templates/gitlab-ci.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/C,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAwD5E"}

package/dist/templates/gitlab-ci.js

@@ -0,0 +1,70 @@
+/**
+ * GitLab CI template generator for VertaaUX.
+ *
+ * Generates .gitlab-ci.yml configuration with native GitLab integrations:
+ * - JUnit reports for test results integration
+ * - Code Quality reports for merge request widget
+ * - HTML report as artifact
+ *
+ * @see https://docs.gitlab.com/ci/yaml/artifacts_reports/
+ */
+/**
+ * Generate GitLab CI template for VertaaUX integration.
+ *
+ * @param options - Configuration options
+ * @returns YAML template content
+ */
+export function generateGitLabCITemplate(options = {}) {
+    const { auditUrl, failOn = "error", threshold } = options;
+    // Build audit command with options
+    const auditArgs = [];
+    if (auditUrl) {
+        auditArgs.push(`--url "${auditUrl}"`);
+    }
+    if (failOn !== "none") {
+        auditArgs.push(`--fail-on ${failOn}`);
+    }
+    if (threshold && threshold > 0) {
+        auditArgs.push(`--threshold ${threshold}`);
+    }
+    const auditSuffix = auditArgs.length > 0 ? ` ${auditArgs.join(" ")}` : "";
+    return `# VertaaUX Accessibility & UX Audit
+# https://vertaaux.ai
+#
+# Add this to your .gitlab-ci.yml or merge into existing configuration.
+# Requires VERTAAUX_API_KEY variable set in CI/CD settings.
+
+vertaaux-audit:
+  image: node:20
+  stage: test
+  variables:
+    # Ensure npm installs globally without permission issues
+    npm_config_prefix: "\${CI_PROJECT_DIR}/.npm-global"
+    PATH: "\${CI_PROJECT_DIR}/.npm-global/bin:\${PATH}"
+  before_script:
+    - npm install -g @vertaaux/cli
+  script:
+    # Generate JUnit report for test results integration
+    - vertaa audit --format junit --output gl-junit.xml${auditSuffix}
+    # Generate Code Quality report for merge request widget
+    - vertaa audit --format codequality --output gl-code-quality.json${auditSuffix}
+    # Generate HTML report for human review
+    - vertaa audit --format html --output vertaaux-report.html${auditSuffix}
+  artifacts:
+    reports:
+      # JUnit integration - shows test results in pipeline
+      junit: gl-junit.xml
+      # Code Quality integration - shows issues in merge request widget
+      codequality: gl-code-quality.json
+    paths:
+      # HTML report for download
+      - vertaaux-report.html
+    when: always
+    expire_in: 1 week
+  # Only run on merge requests to avoid duplicate runs
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+  allow_failure: true
+`;
+}

package/dist/templates/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * CI/CD template module barrel export.
+ *
+ * Provides unified template generation for all supported CI platforms:
+ * - GitHub Actions (.github/workflows/vertaa.yml)
+ * - GitLab CI (.gitlab-ci-vertaa.yml)
+ * - CircleCI (.circleci/config-vertaa.yml)
+ * - Azure DevOps (azure-pipelines-vertaa.yml)
+ * - Jenkins (Jenkinsfile-vertaa)
+ */
+/**
+ * Supported CI providers.
+ */
+export type CIProvider = "github" | "gitlab" | "circleci" | "azure" | "jenkins" | "none";
+/**
+ * Common template generation options.
+ */
+export interface TemplateOptions {
+    /** URL to audit (optional, can be set in config) */
+    auditUrl?: string;
+    /** Severity threshold for CI failure */
+    failOn?: "error" | "warning" | "info" | "none";
+    /** Minimum score threshold (0 = disabled) */
+    threshold?: number;
+    /** Upload SARIF results (GitHub only) */
+    uploadSarif?: boolean;
+    /** Upload HTML report and artifacts */
+    uploadArtifacts?: boolean;
+    /** Post PR comment with results summary (GitHub only) */
+    postComment?: boolean;
+}
+/**
+ * Generated template result.
+ */
+export interface GeneratedTemplate {
+    /** File path relative to project root */
+    path: string;
+    /** Template content */
+    content: string;
+    /** Instructions for user (e.g., "merge into existing file") */
+    instructions?: string;
+}
+/**
+ * Generate CI/CD template for the specified provider.
+ *
+ * @param provider - CI provider to generate template for
+ * @param options - Template generation options
+ * @returns Generated template or null for 'none' provider
+ *
+ * @example
+ * ```typescript
+ * const template = generateTemplate('github', { failOn: 'warning' });
+ * if (template) {
+ *   fs.writeFileSync(template.path, template.content);
+ *   if (template.instructions) {
+ *     console.log(template.instructions);
+ *   }
+ * }
+ * ```
+ */
+export declare function generateTemplate(provider: CIProvider, options?: TemplateOptions): GeneratedTemplate | null;
+export { generateGitHubActionsWorkflow } from "./github-actions.js";
+export { generateGitLabCITemplate } from "./gitlab-ci.js";
+export { generateCircleCITemplate } from "./circleci.js";
+export { generateAzureDevOpsTemplate } from "./azure-devops.js";
+export { generateJenkinsTemplate } from "./jenkins.js";
+export type { WorkflowOptions } from "./github-actions.js";
+export type { GitLabOptions } from "./gitlab-ci.js";
+export type { CircleCIOptions } from "./circleci.js";
+export type { AzureDevOpsOptions } from "./azure-devops.js";
+export type { JenkinsOptions } from "./jenkins.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/C,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,UAAU,EACpB,OAAO,GAAE,eAAoB,GAC5B,iBAAiB,GAAG,IAAI,CA8E1B;AAGD,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGvD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/templates/index.js

@@ -0,0 +1,112 @@
+/**
+ * CI/CD template module barrel export.
+ *
+ * Provides unified template generation for all supported CI platforms:
+ * - GitHub Actions (.github/workflows/vertaa.yml)
+ * - GitLab CI (.gitlab-ci-vertaa.yml)
+ * - CircleCI (.circleci/config-vertaa.yml)
+ * - Azure DevOps (azure-pipelines-vertaa.yml)
+ * - Jenkins (Jenkinsfile-vertaa)
+ */
+import { generateGitHubActionsWorkflow } from "./github-actions.js";
+import { generateGitLabCITemplate } from "./gitlab-ci.js";
+import { generateCircleCITemplate } from "./circleci.js";
+import { generateAzureDevOpsTemplate } from "./azure-devops.js";
+import { generateJenkinsTemplate } from "./jenkins.js";
+/**
+ * Generate CI/CD template for the specified provider.
+ *
+ * @param provider - CI provider to generate template for
+ * @param options - Template generation options
+ * @returns Generated template or null for 'none' provider
+ *
+ * @example
+ * ```typescript
+ * const template = generateTemplate('github', { failOn: 'warning' });
+ * if (template) {
+ *   fs.writeFileSync(template.path, template.content);
+ *   if (template.instructions) {
+ *     console.log(template.instructions);
+ *   }
+ * }
+ * ```
+ */
+export function generateTemplate(provider, options = {}) {
+    switch (provider) {
+        case "github": {
+            const workflowOptions = {
+                auditUrl: options.auditUrl,
+                failOn: options.failOn,
+                threshold: options.threshold,
+                uploadSarif: options.uploadSarif ?? true,
+                uploadArtifacts: options.uploadArtifacts ?? true,
+                postComment: options.postComment ?? true,
+            };
+            return {
+                path: ".github/workflows/vertaa.yml",
+                content: generateGitHubActionsWorkflow(workflowOptions),
+            };
+        }
+        case "gitlab": {
+            const gitlabOptions = {
+                auditUrl: options.auditUrl,
+                failOn: options.failOn,
+                threshold: options.threshold,
+            };
+            return {
+                path: ".gitlab-ci-vertaa.yml",
+                content: generateGitLabCITemplate(gitlabOptions),
+                instructions: "Merge the contents of .gitlab-ci-vertaa.yml into your .gitlab-ci.yml",
+            };
+        }
+        case "circleci": {
+            const circleOptions = {
+                auditUrl: options.auditUrl,
+                failOn: options.failOn,
+                threshold: options.threshold,
+            };
+            return {
+                path: ".circleci/config-vertaa.yml",
+                content: generateCircleCITemplate(circleOptions),
+                instructions: "Merge the contents of .circleci/config-vertaa.yml into your .circleci/config.yml",
+            };
+        }
+        case "azure": {
+            const azureOptions = {
+                auditUrl: options.auditUrl,
+                failOn: options.failOn,
+                threshold: options.threshold,
+            };
+            return {
+                path: "azure-pipelines-vertaa.yml",
+                content: generateAzureDevOpsTemplate(azureOptions),
+                instructions: "Merge into azure-pipelines.yml or use as standalone pipeline",
+            };
+        }
+        case "jenkins": {
+            const jenkinsOptions = {
+                auditUrl: options.auditUrl,
+                failOn: options.failOn,
+                threshold: options.threshold,
+            };
+            return {
+                path: "Jenkinsfile-vertaa",
+                content: generateJenkinsTemplate(jenkinsOptions),
+                instructions: "Merge into Jenkinsfile or rename to Jenkinsfile for standalone use",
+            };
+        }
+        case "none":
+            return null;
+        default: {
+            // Type exhaustiveness check
+            const _exhaustive = provider;
+            return _exhaustive;
+        }
+    }
+}
+// Re-export individual generators for direct use
+export { generateGitHubActionsWorkflow } from "./github-actions.js";
+export { generateGitLabCITemplate } from "./gitlab-ci.js";
+export { generateCircleCITemplate } from "./circleci.js";
+export { generateAzureDevOpsTemplate } from "./azure-devops.js";
+export { generateJenkinsTemplate } from "./jenkins.js";