@qanalyzer/forge-commons 1.1.1

package/dist/ci/generate-ci-template.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listCiTemplateVariants = listCiTemplateVariants;
+exports.generateCiTemplate = generateCiTemplate;
+const context_1 = require("./context");
+const azure_devops_1 = require("./templates/azure-devops");
+const bitbucket_1 = require("./templates/bitbucket");
+const github_1 = require("./templates/github");
+const gitlab_1 = require("./templates/gitlab");
+const jenkins_1 = require("./templates/jenkins");
+const types_1 = require("./types");
+const PLATFORMS = [
+    'github',
+    'gitlab',
+    'azure-devops',
+    'jenkins',
+    'bitbucket',
+];
+const UPLOAD_FRAMEWORKS = ['vitest', 'jest', 'playwright'];
+const REPORTER_FRAMEWORKS = [
+    'vitest',
+    'jest',
+    'mocha',
+    'cucumberjs',
+    'cypress',
+    'playwright',
+    'wdio',
+];
+/**
+ * Upload path: Vitest, Jest, Playwright (JSON + @qanalyzer/forge-api-client).
+ * Reporter path: Vitest, Jest, Mocha, CucumberJS, Cypress, Playwright, WebdriverIO.
+ * Mocha / CucumberJS / Cypress / WDIO have no upload JSON dual-path — use mode=file via reporter instead.
+ */
+const SUPPORTED_VARIANTS = [
+    ...PLATFORMS.flatMap((platform) => UPLOAD_FRAMEWORKS.map((framework) => ({
+        platform,
+        framework,
+        ingestPath: 'upload',
+    }))),
+    ...PLATFORMS.flatMap((platform) => REPORTER_FRAMEWORKS.map((framework) => ({
+        platform,
+        framework,
+        ingestPath: 'reporter',
+    }))),
+];
+function isSupported(ctx) {
+    return SUPPORTED_VARIANTS.some((v) => v.platform === ctx.platform &&
+        v.framework === ctx.framework &&
+        v.ingestPath === ctx.ingestPath);
+}
+function listCiTemplateVariants() {
+    return [...SUPPORTED_VARIANTS];
+}
+/**
+ * Generate a CI YAML (or equivalent) snippet for the given context.
+ * Accepts a partial context — fills platform defaults via buildCiTemplateContext.
+ */
+function generateCiTemplate(input) {
+    const ctx = (0, context_1.buildCiTemplateContext)(input);
+    if (!isSupported(ctx)) {
+        throw new types_1.UnsupportedVariantError(ctx.platform, ctx.framework, ctx.ingestPath);
+    }
+    switch (ctx.platform) {
+        case 'github':
+            return (0, github_1.renderGithubUpload)(ctx);
+        case 'gitlab':
+            return (0, gitlab_1.renderGitlabUpload)(ctx);
+        case 'azure-devops':
+            return (0, azure_devops_1.renderAzureDevOpsUpload)(ctx);
+        case 'jenkins':
+            return (0, jenkins_1.renderJenkinsUpload)(ctx);
+        case 'bitbucket':
+            return (0, bitbucket_1.renderBitbucketUpload)(ctx);
+        default: {
+            const _exhaustive = ctx.platform;
+            throw new types_1.UnsupportedVariantError(_exhaustive, ctx.framework, ctx.ingestPath);
+        }
+    }
+}

package/dist/ci/index.d.ts

@@ -0,0 +1,7 @@
+export { buildCiTemplateContext, } from './context';
+export { generateCiTemplate, listCiTemplateVariants, } from './generate-ci-template';
+export { jestJsonRun, } from './frameworks/jest';
+export { vitestJsonRun, vitestReporterEnv, } from './frameworks/vitest';
+export { vitestReporterRun, jestReporterRun, cypressReporterRun, playwrightReporterRun, wdioReporterRun, mochaReporterRun, cucumberjsReporterRun, frameworkReporterRun, reporterPackageName, reporterFrameworkLabel, reporterConfigHint, reporterIngestEnvLines, planCiVariableHints, versionTagCiVariableHints, assertReporterFramework, } from './frameworks/reporter';
+export { frameworkLabel, frameworkTestCommand, indentUploadCli, uploadCliCommand, } from './frameworks/upload';
+export { UnsupportedVariantError, type CiFramework, type CiIngestPath, type CiPlatform, type CiSecretHint, type CiTemplateContext, type CiTemplatePartial, type CiTemplateResult, type CiTemplateVariant, type CiVariableHint, } from './types';

package/dist/ci/index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnsupportedVariantError = exports.uploadCliCommand = exports.indentUploadCli = exports.frameworkTestCommand = exports.frameworkLabel = exports.assertReporterFramework = exports.versionTagCiVariableHints = exports.planCiVariableHints = exports.reporterIngestEnvLines = exports.reporterConfigHint = exports.reporterFrameworkLabel = exports.reporterPackageName = exports.frameworkReporterRun = exports.cucumberjsReporterRun = exports.mochaReporterRun = exports.wdioReporterRun = exports.playwrightReporterRun = exports.cypressReporterRun = exports.jestReporterRun = exports.vitestReporterRun = exports.vitestReporterEnv = exports.vitestJsonRun = exports.jestJsonRun = exports.listCiTemplateVariants = exports.generateCiTemplate = exports.buildCiTemplateContext = void 0;
+var context_1 = require("./context");
+Object.defineProperty(exports, "buildCiTemplateContext", { enumerable: true, get: function () { return context_1.buildCiTemplateContext; } });
+var generate_ci_template_1 = require("./generate-ci-template");
+Object.defineProperty(exports, "generateCiTemplate", { enumerable: true, get: function () { return generate_ci_template_1.generateCiTemplate; } });
+Object.defineProperty(exports, "listCiTemplateVariants", { enumerable: true, get: function () { return generate_ci_template_1.listCiTemplateVariants; } });
+var jest_1 = require("./frameworks/jest");
+Object.defineProperty(exports, "jestJsonRun", { enumerable: true, get: function () { return jest_1.jestJsonRun; } });
+var vitest_1 = require("./frameworks/vitest");
+Object.defineProperty(exports, "vitestJsonRun", { enumerable: true, get: function () { return vitest_1.vitestJsonRun; } });
+Object.defineProperty(exports, "vitestReporterEnv", { enumerable: true, get: function () { return vitest_1.vitestReporterEnv; } });
+var reporter_1 = require("./frameworks/reporter");
+Object.defineProperty(exports, "vitestReporterRun", { enumerable: true, get: function () { return reporter_1.vitestReporterRun; } });
+Object.defineProperty(exports, "jestReporterRun", { enumerable: true, get: function () { return reporter_1.jestReporterRun; } });
+Object.defineProperty(exports, "cypressReporterRun", { enumerable: true, get: function () { return reporter_1.cypressReporterRun; } });
+Object.defineProperty(exports, "playwrightReporterRun", { enumerable: true, get: function () { return reporter_1.playwrightReporterRun; } });
+Object.defineProperty(exports, "wdioReporterRun", { enumerable: true, get: function () { return reporter_1.wdioReporterRun; } });
+Object.defineProperty(exports, "mochaReporterRun", { enumerable: true, get: function () { return reporter_1.mochaReporterRun; } });
+Object.defineProperty(exports, "cucumberjsReporterRun", { enumerable: true, get: function () { return reporter_1.cucumberjsReporterRun; } });
+Object.defineProperty(exports, "frameworkReporterRun", { enumerable: true, get: function () { return reporter_1.frameworkReporterRun; } });
+Object.defineProperty(exports, "reporterPackageName", { enumerable: true, get: function () { return reporter_1.reporterPackageName; } });
+Object.defineProperty(exports, "reporterFrameworkLabel", { enumerable: true, get: function () { return reporter_1.reporterFrameworkLabel; } });
+Object.defineProperty(exports, "reporterConfigHint", { enumerable: true, get: function () { return reporter_1.reporterConfigHint; } });
+Object.defineProperty(exports, "reporterIngestEnvLines", { enumerable: true, get: function () { return reporter_1.reporterIngestEnvLines; } });
+Object.defineProperty(exports, "planCiVariableHints", { enumerable: true, get: function () { return reporter_1.planCiVariableHints; } });
+Object.defineProperty(exports, "versionTagCiVariableHints", { enumerable: true, get: function () { return reporter_1.versionTagCiVariableHints; } });
+Object.defineProperty(exports, "assertReporterFramework", { enumerable: true, get: function () { return reporter_1.assertReporterFramework; } });
+var upload_1 = require("./frameworks/upload");
+Object.defineProperty(exports, "frameworkLabel", { enumerable: true, get: function () { return upload_1.frameworkLabel; } });
+Object.defineProperty(exports, "frameworkTestCommand", { enumerable: true, get: function () { return upload_1.frameworkTestCommand; } });
+Object.defineProperty(exports, "indentUploadCli", { enumerable: true, get: function () { return upload_1.indentUploadCli; } });
+Object.defineProperty(exports, "uploadCliCommand", { enumerable: true, get: function () { return upload_1.uploadCliCommand; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "UnsupportedVariantError", { enumerable: true, get: function () { return types_1.UnsupportedVariantError; } });

package/dist/ci/templates/azure-devops.d.ts

@@ -0,0 +1,5 @@
+import type { CiTemplateContext, CiTemplateResult } from '../types';
+/**
+ * Azure DevOps — upload path or @qanalyzer/forge-vitest / @qanalyzer/forge-jest reporter path.
+ */
+export declare function renderAzureDevOpsUpload(ctx: CiTemplateContext): CiTemplateResult;

package/dist/ci/templates/azure-devops.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAzureDevOpsUpload = renderAzureDevOpsUpload;
+const upload_1 = require("../frameworks/upload");
+const reporter_1 = require("../frameworks/reporter");
+const types_1 = require("../types");
+function azurePreRunScripts(ctx) {
+    return (0, reporter_1.reporterPreRunScripts)(ctx)
+        .map((cmd) => `  - script: ${cmd}
+    displayName: Install Playwright browsers
+`)
+        .join('');
+}
+function azureSecrets() {
+    return [
+        {
+            name: 'QANALYZER_INGEST_URL',
+            description: 'Forge web trigger URL (launch ingest + binary attach / screenshots / qa.attach)',
+            platformHint: 'Pipelines → Library → Variable group `qanalyzer-secrets` (mark as secret)',
+        },
+        {
+            name: 'QANALYZER_INGEST_TOKEN',
+            description: 'Bearer token from QAnalyzer configure page (shown once)',
+            platformHint: 'Pipelines → Library → Variable group `qanalyzer-secrets` (mark as secret)',
+        },
+    ];
+}
+function azureVariables() {
+    return [
+        {
+            name: 'JiraProjectKey',
+            description: 'Jira project key allowlisted in QAnalyzer (e.g. AUTH)',
+            platformHint: 'Pipeline variable or entry in variable group `qanalyzer-secrets`',
+        },
+    ];
+}
+function renderAzureReporter(ctx) {
+    (0, reporter_1.assertReporterFramework)(ctx);
+    const nodeVersion = ctx.nodeVersion ?? '22';
+    const urlExpr = ctx.ingestUrlExpr ?? `$(${ctx.ingestUrlSecret})`;
+    const tokenExpr = ctx.ingestTokenExpr ?? `$(${ctx.ingestTokenSecret})`;
+    const label = (0, reporter_1.reporterFrameworkLabel)(ctx);
+    const pkg = (0, reporter_1.reporterPackageName)(ctx);
+    const configHint = (0, reporter_1.reporterConfigHint)(ctx);
+    const content = `# QAnalyzer fragment — ${label} ${pkg} reporter path
+# Requires ${pkg} in package.json and ${configHint}
+trigger:
+  - main
+
+pool:
+  vmImage: ubuntu-latest
+
+variables:
+  - group: qanalyzer-secrets
+  - name: JiraProjectKey
+    value: ${ctx.projectKey}
+
+steps:
+  - task: NodeTool@0
+    inputs:
+      versionSpec: '${nodeVersion}.x'
+    displayName: Use Node.js ${nodeVersion}
+
+  - script: npm ci
+    displayName: Install dependencies
+
+${azurePreRunScripts(ctx)}  - script: ${(0, reporter_1.frameworkReporterRun)(ctx)}
+    displayName: Run ${label} with QAnalyzer reporter
+    env:
+      QANALYZER_MODE: ingest
+      QANALYZER_INGEST_URL: ${urlExpr}
+      QANALYZER_INGEST_TOKEN: ${tokenExpr}
+      QANALYZER_PROJECT_KEY: $(JiraProjectKey)
+`;
+    return {
+        platform: 'azure-devops',
+        framework: ctx.framework,
+        ingestPath: 'reporter',
+        filename: 'azure-pipelines.yml',
+        content,
+        secretsSetup: azureSecrets(),
+        variablesSetup: [...azureVariables(), ...(0, reporter_1.planCiVariableHints)(), ...(0, reporter_1.versionTagCiVariableHints)()],
+    };
+}
+/**
+ * Azure DevOps — upload path or @qanalyzer/forge-vitest / @qanalyzer/forge-jest reporter path.
+ */
+function renderAzureDevOpsUpload(ctx) {
+    if (ctx.ingestPath === 'reporter') {
+        return renderAzureReporter(ctx);
+    }
+    if (ctx.ingestPath !== 'upload') {
+        throw new types_1.UnsupportedVariantError(ctx.platform, ctx.framework, ctx.ingestPath);
+    }
+    const nodeVersion = ctx.nodeVersion ?? '22';
+    const testCmd = (0, upload_1.frameworkTestCommand)(ctx);
+    const label = (0, upload_1.frameworkLabel)(ctx);
+    const uploadBlock = (0, upload_1.indentUploadCli)(ctx, 6);
+    const urlExpr = ctx.ingestUrlExpr ?? `$(${ctx.ingestUrlSecret})`;
+    const tokenExpr = ctx.ingestTokenExpr ?? `$(${ctx.ingestTokenSecret})`;
+    const content = `# QAnalyzer fragment — ${label} upload path
+trigger:
+  - main
+
+pool:
+  vmImage: ubuntu-latest
+
+variables:
+  - group: qanalyzer-secrets   # QANALYZER_INGEST_URL, QANALYZER_INGEST_TOKEN
+  - name: JiraProjectKey
+    value: ${ctx.projectKey}
+
+steps:
+  - task: NodeTool@0
+    inputs:
+      versionSpec: '${nodeVersion}.x'
+    displayName: Use Node.js ${nodeVersion}
+
+  - script: npm ci
+    displayName: Install dependencies
+
+${azurePreRunScripts(ctx)}  - script: ${testCmd}
+    displayName: Run ${label}
+
+  - script: |
+${uploadBlock}
+    displayName: Upload to QAnalyzer
+    condition: always()
+    env:
+      QANALYZER_INGEST_URL: ${urlExpr}
+      QANALYZER_INGEST_TOKEN: ${tokenExpr}
+`;
+    return {
+        platform: 'azure-devops',
+        framework: ctx.framework,
+        ingestPath: 'upload',
+        filename: 'azure-pipelines.yml',
+        content,
+        secretsSetup: azureSecrets(),
+        variablesSetup: [...azureVariables(), ...(0, reporter_1.planCiVariableHints)(), ...(0, reporter_1.versionTagCiVariableHints)()],
+    };
+}

package/dist/ci/templates/bitbucket.d.ts

@@ -0,0 +1,5 @@
+import type { CiTemplateContext, CiTemplateResult } from '../types';
+/**
+ * Bitbucket Pipelines — upload path or @qanalyzer/forge-vitest / @qanalyzer/forge-jest reporter path.
+ */
+export declare function renderBitbucketUpload(ctx: CiTemplateContext): CiTemplateResult;

package/dist/ci/templates/bitbucket.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderBitbucketUpload = renderBitbucketUpload;
+const upload_1 = require("../frameworks/upload");
+const reporter_1 = require("../frameworks/reporter");
+const types_1 = require("../types");
+function bitbucketScriptLines(ctx, ...cmds) {
+    return [...(0, reporter_1.reporterPreRunScripts)(ctx), ...cmds]
+        .map((c) => `          - ${c}`)
+        .join('\n');
+}
+function bitbucketSecrets() {
+    return [
+        {
+            name: 'QANALYZER_INGEST_URL',
+            description: 'Forge web trigger URL (launch ingest + binary attach / screenshots / qa.attach)',
+            platformHint: 'Repository settings → Pipelines → Repository variables (Secured)',
+        },
+        {
+            name: 'QANALYZER_INGEST_TOKEN',
+            description: 'Bearer token from QAnalyzer configure page (shown once)',
+            platformHint: 'Repository settings → Pipelines → Repository variables (Secured)',
+        },
+    ];
+}
+function bitbucketVariables() {
+    return [
+        {
+            name: 'JIRA_PROJECT_KEY',
+            description: 'Jira project key allowlisted in QAnalyzer (e.g. AUTH)',
+            platformHint: 'Repository settings → Pipelines → Repository variables',
+        },
+    ];
+}
+function renderBitbucketReporter(ctx) {
+    (0, reporter_1.assertReporterFramework)(ctx);
+    const nodeVersion = ctx.nodeVersion ?? '22';
+    const label = (0, reporter_1.reporterFrameworkLabel)(ctx);
+    const pkg = (0, reporter_1.reporterPackageName)(ctx);
+    const configHint = (0, reporter_1.reporterConfigHint)(ctx);
+    const content = `# QAnalyzer fragment — ${label} ${pkg} reporter path
+# Requires ${pkg} in package.json and ${configHint}
+# Set secured vars QANALYZER_INGEST_URL / QANALYZER_INGEST_TOKEN
+image: node:${nodeVersion}
+
+pipelines:
+  default:
+    - step:
+        name: Test with QAnalyzer
+        caches:
+          - node
+        script:
+          - export QANALYZER_MODE=ingest
+          - export QANALYZER_PROJECT_KEY=$JIRA_PROJECT_KEY
+          - npm ci
+${bitbucketScriptLines(ctx, (0, reporter_1.frameworkReporterRun)(ctx))}
+`;
+    return {
+        platform: 'bitbucket',
+        framework: ctx.framework,
+        ingestPath: 'reporter',
+        filename: 'bitbucket-pipelines.yml',
+        content,
+        secretsSetup: bitbucketSecrets(),
+        variablesSetup: [...bitbucketVariables(), ...(0, reporter_1.planCiVariableHints)(), ...(0, reporter_1.versionTagCiVariableHints)()],
+    };
+}
+/**
+ * Bitbucket Pipelines — upload path or @qanalyzer/forge-vitest / @qanalyzer/forge-jest reporter path.
+ */
+function renderBitbucketUpload(ctx) {
+    if (ctx.ingestPath === 'reporter') {
+        return renderBitbucketReporter(ctx);
+    }
+    if (ctx.ingestPath !== 'upload') {
+        throw new types_1.UnsupportedVariantError(ctx.platform, ctx.framework, ctx.ingestPath);
+    }
+    const nodeVersion = ctx.nodeVersion ?? '22';
+    const reportFile = ctx.reportFile ?? 'qanalyzer-results.json';
+    const testCmd = (0, upload_1.frameworkTestCommand)(ctx);
+    const label = (0, upload_1.frameworkLabel)(ctx);
+    const uploadBlock = (0, upload_1.indentUploadCli)(ctx, 12);
+    const content = `# QAnalyzer fragment — merge into your bitbucket-pipelines.yml
+# ${label} upload path — set secured vars QANALYZER_INGEST_URL / QANALYZER_INGEST_TOKEN
+image: node:${nodeVersion}
+
+pipelines:
+  default:
+    - step:
+        name: Test
+        caches:
+          - node
+        script:
+          - npm ci
+${bitbucketScriptLines(ctx, testCmd)}
+        artifacts:
+          - ${reportFile}
+    - step:
+        name: Upload QAnalyzer
+        script:
+          - |
+${uploadBlock}
+`;
+    return {
+        platform: 'bitbucket',
+        framework: ctx.framework,
+        ingestPath: 'upload',
+        filename: 'bitbucket-pipelines.yml',
+        content,
+        secretsSetup: bitbucketSecrets(),
+        variablesSetup: [...bitbucketVariables(), ...(0, reporter_1.planCiVariableHints)(), ...(0, reporter_1.versionTagCiVariableHints)()],
+    };
+}

package/dist/ci/templates/github.d.ts

@@ -0,0 +1,6 @@
+import type { CiTemplateContext, CiTemplateResult } from '../types';
+/**
+ * GitHub Actions — upload (Vitest/Jest/Playwright) or reporter
+ * (@qanalyzer/forge-vitest / @qanalyzer/forge-jest / @qanalyzer/forge-mocha / @qanalyzer/forge-cucumberjs / @qanalyzer/forge-cypress / @qanalyzer/forge-playwright / @qanalyzer/forge-wdio).
+ */
+export declare function renderGithubUpload(ctx: CiTemplateContext): CiTemplateResult;

package/dist/ci/templates/github.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderGithubUpload = renderGithubUpload;
+const upload_1 = require("../frameworks/upload");
+const reporter_1 = require("../frameworks/reporter");
+const types_1 = require("../types");
+function githubPreRunSteps(ctx) {
+    return (0, reporter_1.reporterPreRunScripts)(ctx)
+        .map((cmd) => `      - run: ${cmd}`)
+        .join('\n');
+}
+function githubSecrets() {
+    return [
+        {
+            name: 'QANALYZER_INGEST_URL',
+            description: 'Forge web trigger URL (launch ingest + binary attach / screenshots / qa.attach)',
+            platformHint: 'Repository → Settings → Secrets and variables → Actions → New repository secret',
+        },
+        {
+            name: 'QANALYZER_INGEST_TOKEN',
+            description: 'Bearer token from QAnalyzer configure page (shown once)',
+            platformHint: 'Repository → Settings → Secrets and variables → Actions → New repository secret',
+        },
+    ];
+}
+function githubVariables() {
+    return [
+        {
+            name: 'JIRA_PROJECT_KEY',
+            description: 'Jira project key allowlisted in QAnalyzer (e.g. AUTH)',
+            platformHint: 'Repository → Settings → Secrets and variables → Actions → Variables',
+        },
+    ];
+}
+function githubFilename(framework, ingestPath) {
+    const suffix = ingestPath === 'reporter' ? '-reporter' : '';
+    return `.github/workflows/qanalyzer-${framework}${suffix}.yml`;
+}
+function renderGithubReporter(ctx) {
+    (0, reporter_1.assertReporterFramework)(ctx);
+    const nodeVersion = ctx.nodeVersion ?? '22';
+    const env = (0, reporter_1.reporterIngestEnvLines)(ctx);
+    const urlExpr = ctx.ingestUrlExpr ?? `\${{ secrets.${ctx.ingestUrlSecret} }}`;
+    const tokenExpr = ctx.ingestTokenExpr ?? `\${{ secrets.${ctx.ingestTokenSecret} }}`;
+    const projectExpr = ctx.projectKeyExpr ?? `\${{ vars.JIRA_PROJECT_KEY }}`;
+    const label = (0, reporter_1.reporterFrameworkLabel)(ctx);
+    const pkg = (0, reporter_1.reporterPackageName)(ctx);
+    const configHint = (0, reporter_1.reporterConfigHint)(ctx);
+    const preRun = githubPreRunSteps(ctx);
+    const content = `name: QAnalyzer ${label} (${pkg})
+
+# Requires ${pkg} in package.json and ${configHint}
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "${nodeVersion}"
+          cache: npm
+      - run: npm ci
+${preRun ? `${preRun}\n` : ''}      - name: Run ${label} with QAnalyzer reporter
+        env:
+          QANALYZER_MODE: ${env.mode}
+          QANALYZER_INGEST_URL: ${urlExpr}
+          QANALYZER_INGEST_TOKEN: ${tokenExpr}
+          QANALYZER_PROJECT_KEY: ${projectExpr}
+          QANALYZER_LAUNCH_NAME: \${{ github.workflow }} #\${{ github.run_number }}
+          # Optional Test Plan (FR158): QANALYZER_PLAN_NAME / QANALYZER_PLAN_ID / QANALYZER_PLAN_KEY
+          # QANALYZER_PLAN_NAME: Smoke
+          # Optional tags (FR21): QANALYZER_FIX_VERSION / QANALYZER_SPRINT
+          # QANALYZER_FIX_VERSION: 2.4.0
+          # QANALYZER_SPRINT: Sprint 42
+        run: ${(0, reporter_1.frameworkReporterRun)(ctx)}
+`;
+    return {
+        platform: 'github',
+        framework: ctx.framework,
+        ingestPath: 'reporter',
+        filename: githubFilename(ctx.framework, 'reporter'),
+        content,
+        secretsSetup: githubSecrets(),
+        variablesSetup: [...githubVariables(), ...(0, reporter_1.planCiVariableHints)(), ...(0, reporter_1.versionTagCiVariableHints)()],
+    };
+}
+/**
+ * GitHub Actions — upload (Vitest/Jest/Playwright) or reporter
+ * (@qanalyzer/forge-vitest / @qanalyzer/forge-jest / @qanalyzer/forge-mocha / @qanalyzer/forge-cucumberjs / @qanalyzer/forge-cypress / @qanalyzer/forge-playwright / @qanalyzer/forge-wdio).
+ */
+function renderGithubUpload(ctx) {
+    if (ctx.ingestPath === 'reporter') {
+        return renderGithubReporter(ctx);
+    }
+    if (ctx.ingestPath !== 'upload') {
+        throw new types_1.UnsupportedVariantError(ctx.platform, ctx.framework, ctx.ingestPath);
+    }
+    if (ctx.framework === 'mocha' ||
+        ctx.framework === 'cucumberjs' ||
+        ctx.framework === 'cypress' ||
+        ctx.framework === 'wdio') {
+        throw new types_1.UnsupportedVariantError(ctx.platform, ctx.framework, ctx.ingestPath);
+    }
+    const nodeVersion = ctx.nodeVersion ?? '22';
+    const testCmd = (0, upload_1.frameworkTestCommand)(ctx);
+    const uploadCmd = (0, upload_1.uploadCliCommand)(ctx);
+    const urlExpr = ctx.ingestUrlExpr ?? `\${{ secrets.${ctx.ingestUrlSecret} }}`;
+    const tokenExpr = ctx.ingestTokenExpr ?? `\${{ secrets.${ctx.ingestTokenSecret} }}`;
+    const label = (0, upload_1.frameworkLabel)(ctx);
+    const preRun = githubPreRunSteps(ctx);
+    const testStep = ctx.includeTestStep === false
+        ? ''
+        : `      - run: ${testCmd}\n`;
+    const uploadStep = ctx.includeUploadStep === false
+        ? ''
+        : `      - name: Upload to QAnalyzer
+        if: always()
+        env:
+          QANALYZER_INGEST_URL: ${urlExpr}
+          QANALYZER_INGEST_TOKEN: ${tokenExpr}
+        run: |
+          ${uploadCmd.split('\n').join('\n          ')}
+`;
+    const content = `name: QAnalyzer ${label}
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "${nodeVersion}"
+          cache: npm
+      - run: npm ci
+${preRun ? `${preRun}\n` : ''}${testStep}${uploadStep}`;
+    return {
+        platform: 'github',
+        framework: ctx.framework,
+        ingestPath: 'upload',
+        filename: githubFilename(ctx.framework, 'upload'),
+        content,
+        secretsSetup: githubSecrets(),
+        variablesSetup: [...githubVariables(), ...(0, reporter_1.planCiVariableHints)(), ...(0, reporter_1.versionTagCiVariableHints)()],
+    };
+}

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

@@ -0,0 +1,5 @@
+import type { CiTemplateContext, CiTemplateResult } from '../types';
+/**
+ * GitLab CI — upload path or @qanalyzer/forge-vitest / @qanalyzer/forge-jest reporter path.
+ */
+export declare function renderGitlabUpload(ctx: CiTemplateContext): CiTemplateResult;