@camunda/e2e-test-suite 0.0.633 → 0.0.635

package/dist/pages/8.7/ClusterSecretsPage.js

@@ -63,21 +63,37 @@ class ClusterSecretsPage {
             return; //No Connector Secrets found in the list
         }
         try {
-            let options = await this.optionsButton.all();
-            while (options.length > 0) {
-                const optionButton = options[0];
-                if (await optionButton.isVisible()) {
+            for (let sweep = 0; sweep < 20; sweep++) {
+                const options = await this.optionsButton.all();
+                if (options.length === 0) {
+                    break;
+                }
+                let deletedAny = false;
+                for (const optionButton of options) {
+                    if (!(await optionButton.isVisible().catch(() => false))) {
+                        continue;
+                    }
                     await optionButton.click({ timeout: 60000 });
+                    await (0, test_1.expect)(this.deleteConnectorSecretButton).toBeVisible({
+                        timeout: 15000,
+                    });
+                    if (await this.deleteConnectorSecretButton.isDisabled()) {
+                        await this.page.keyboard.press('Escape').catch(() => { });
+                        continue;
+                    }
                     await this.deleteConnectorSecretButton.click({ timeout: 60000 });
                     await (0, test_1.expect)(this.dialog).toBeVisible({ timeout: 40000 });
                     await this.deleteConnectorSecretSubButton.click();
                     await (0, test_1.expect)(this.page.getByText('Deleting...')).not.toBeVisible({
                         timeout: 60000,
                     });
+                    deletedAny = true;
+                    await (0, sleep_1.sleep)(3000);
+                    break;
+                }
+                if (!deletedAny) {
+                    break;
                 }
-                const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-                await sleep(3000);
-                options = await this.optionsButton.all();
             }
             await (0, test_1.expect)(this.optionsButton).not.toBeVisible({
                 timeout: 30000,

package/dist/pages/8.7/ConsoleOrganizationPage.js

@@ -194,7 +194,16 @@ class ConsoleOrganizationPage {
         }
     }
     async clickUsersTab() {
-        await (0, test_1.expect)(this.usersTab).toBeVisible({ timeout: 60000 });
+        // The Users tab can fail to render if the Org page is mid-load when we
+        // arrive. Try once with a shorter window, reload on failure, then give
+        // the second attempt the full timeout before surfacing the error.
+        try {
+            await (0, test_1.expect)(this.usersTab).toBeVisible({ timeout: 30000 });
+        }
+        catch {
+            await this.page.reload();
+            await (0, test_1.expect)(this.usersTab).toBeVisible({ timeout: 60000 });
+        }
         await this.usersTab.click({ timeout: 60000 });
         await (0, expectLocatorWithRetry_1.expectLocatorWithRetry)(this.page, this.filterTableSearchbox, {
             postAction: async () => {

package/dist/pages/8.7/HomePage.js

@@ -74,7 +74,13 @@ class HomePage {
             if (!(await next.isVisible({ timeout: visibleTimeout }))) {
                 return;
             }
-            await next.click({ timeout: 30000, force: true });
+            try {
+                await next.click({ timeout: 30000, force: true });
+            }
+            catch {
+                // Close buttons are occasionally replaced during modal animation;
+                // continue and retry with the latest visible control.
+            }
         }
     }
     organizationUuid() {
@@ -89,15 +95,13 @@ class HomePage {
         await this.openOrganizationButton.click({ timeout: 60000 });
     }
     async clickSkipCustomization() {
-        try {
-            await (0, test_1.expect)(this.buttonSkipCustomization).toBeVisible({ timeout: 30000 });
-            await this.buttonSkipCustomization.click({ timeout: 60000 });
-            await this.closeInformationDialog();
-            return;
-        }
-        catch (error) {
-            console.error(error);
+        const hasCustomizationModal = await this.buttonSkipCustomization
+            .isVisible({ timeout: 30000 })
+            .catch(() => false);
+        if (hasCustomizationModal) {
+            await this.buttonSkipCustomization.click({ timeout: 60000, force: true });
         }
+        await this.closeInformationDialog();
     }
 }
 exports.HomePage = HomePage;

package/dist/pages/8.7/LoginPage.js

@@ -19,8 +19,11 @@ class LoginPage {
         // resolves to the auth0 email input, regardless of redirect timing.
         this.usernameInput = page
             .getByLabel('Email address')
-            .and(page.locator(':not(#c4-invite-email)'));
-        this.passwordInput = page.getByLabel('Password *');
+            .and(page.locator(':not([id="c4-invite-email"])'));
+        this.passwordInput = page
+            .getByLabel(/^Password\s*\*?$/i)
+            .or(page.locator('input[type="password"]'))
+            .first();
         this.continueButton = page.getByRole('button', {
             name: 'Continue',
             exact: true,
@@ -62,6 +65,9 @@ class LoginPage {
         const { username = process.env.C8_USERNAME_TEST, password = process.env.C8_PASSWORD_TEST, } = credentials;
         // Navigate to app root to start the auth flow.
         await this.page.goto('/');
+        await this.page
+            .waitForURL((url) => !url.hostname.includes('console'), { timeout: 60000 })
+            .catch(() => { });
         // SSO re-auth may silently log us back in as the previous user after
         // logout/session-reset, keeping the page on Console instead of redirecting
         // to the Auth0 login form. Detect Console (settings button visible) and
@@ -81,9 +87,16 @@ class LoginPage {
                 await this.page.waitForLoadState('domcontentloaded', { timeout: 30000 });
             }
         }
-        await (0, test_1.expect)(this.usernameInput).toBeVisible({ timeout: 120000 });
-        await this.fillUsername(username);
-        await this.clickContinueButton();
+        const onPasswordStep = (await this.passwordHeading
+            .isVisible({ timeout: 5000 })
+            .catch(() => false)) ||
+            (await this.passwordInput.isVisible({ timeout: 5000 }).catch(() => false));
+        if (!onPasswordStep) {
+            await (0, test_1.expect)(this.usernameInput).toBeVisible({ timeout: 120000 });
+            await this.fillUsername(username);
+            await this.clickContinueButton();
+        }
+        await (0, test_1.expect)(this.passwordInput).toBeVisible({ timeout: 180000 });
         await this.fillPassword(password);
         await (0, test_1.expect)(this.loginButton).toBeVisible({ timeout: 120000 });
         await this.clickLoginButton();

package/dist/pages/8.7/PlayPage.d.ts

@@ -1,8 +1,12 @@
 import { Page, Locator } from '@playwright/test';
 declare class PlayPage {
     private page;
+    readonly diagram: Locator;
+    readonly playTab: Locator;
     readonly completeJobButton: Locator;
-    readonly startInstanceButton: Locator;
+    readonly configureTestPanel: Locator;
+    readonly configureTestPanelStartButton: Locator;
+    readonly startInstanceOverlayButton: Locator;
     constructor(page: Page);
     waitForCompleteJobButtonToBeAvailable(): Promise<void>;
     clickCompleteJobButton(): Promise<void>;

package/dist/pages/8.7/PlayPage.js

@@ -2,19 +2,35 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PlayPage = void 0;
 const test_1 = require("@playwright/test");
+const clickLocatorWithRetry_1 = require("../../utils/assertionHelpers/clickLocatorWithRetry");
 const maxWaitTimeSeconds = 180000;
 class PlayPage {
     page;
+    diagram;
+    playTab;
     completeJobButton;
-    startInstanceButton;
+    configureTestPanel;
+    configureTestPanelStartButton;
+    startInstanceOverlayButton;
     constructor(page) {
         this.page = page;
-        this.completeJobButton = page
-            .getByTestId('diagram')
-            .getByLabel('Complete job');
-        this.startInstanceButton = this.page
-            .getByTestId('diagram')
-            .getByLabel('Start instance', { exact: true });
+        this.diagram = page.getByTestId('diagram');
+        this.playTab = page.getByRole('tab', { name: 'Play' });
+        this.completeJobButton = this.diagram.getByLabel('Complete job');
+        // Newer Modeler Play UI: the "Configure Scenario" floating card hosts a
+        // primary "Start" Carbon button (variants: "Start", "Start with
+        // variables", "Start with a form"). Source:
+        // camunda-hub frontend/packages/modeler/play/src/Definition/
+        //   ConfigureTestPanel/index.tsx — renders <FloatingCard
+        //   data-testid="configure-test-panel"> with a <Button> whose visible
+        //   text starts with "Start".
+        this.configureTestPanel = page.getByTestId('configure-test-panel');
+        this.configureTestPanelStartButton = this.configureTestPanel.getByRole('button', { name: /^Start( with .*)?$/, exact: false });
+        // Legacy bpmn-js canvas overlay button (still emitted by older Modeler
+        // builds, also relabeled with cached/example-data suffixes). Kept as a
+        // fallback for environments that haven't shipped the ConfigureTestPanel
+        // yet.
+        this.startInstanceOverlayButton = this.diagram.getByLabel('Start instance', { exact: false });
     }
     async waitForCompleteJobButtonToBeAvailable() {
         await (0, test_1.expect)(this.completeJobButton).toBeVisible({
@@ -28,17 +44,62 @@ class PlayPage {
         await this.completeJobButton.click();
     }
     async clickStartInstanceButton() {
-        await (0, test_1.expect)(this.startInstanceButton).toBeVisible({
-            timeout: 30000,
-        });
-        await this.startInstanceButton.click();
+        // The Modeler Play UI has two surfaces that can hold the start trigger:
+        //   - new: a "Start" Carbon button inside the ConfigureTestPanel
+        //     floating card (`[data-testid="configure-test-panel"]`). This is
+        //     what newer Modeler builds render. Variants: "Start",
+        //     "Start with variables", "Start with a form".
+        //   - legacy: a bpmn-js canvas overlay labelled "Start instance"
+        //     (sometimes "Start instance with cached data" once a scenario
+        //     chip exists). Older Modeler builds emit this; newer builds do
+        //     not, so it cannot be the only locator.
+        //
+        // Try whichever appears first. On total failure, reload AND re-open
+        // the Play tab (the legacy code path called `page.reload()` alone,
+        // which dumped the user back on the Implement tab on stable/8.7).
+        const startTrigger = this.configureTestPanelStartButton
+            .or(this.startInstanceOverlayButton)
+            .first();
+        const tryClick = async () => {
+            await (0, test_1.expect)(this.diagram).toBeVisible({ timeout: 120000 });
+            await (0, clickLocatorWithRetry_1.clickLocatorWithRetry)(this.page, startTrigger, {
+                totalTimeout: 240000,
+                visibilityTimeout: 60000,
+                maxRetries: 8,
+                retryDelayMs: 5000,
+            });
+        };
+        try {
+            await tryClick();
+        }
+        catch (error) {
+            console.warn(`clickStartInstanceButton: first pass failed (${error}); reloading, re-opening Play tab, and retrying once`);
+            await this.page.reload();
+            // After reload, the Modeler defaults to the Implement tab. Move
+            // back to Play before trying again — otherwise the diagram
+            // visibility check times out against the Implement-tab DOM.
+            if (await this.playTab.isVisible({ timeout: 30000 }).catch(() => false)) {
+                await this.playTab.click();
+            }
+            await tryClick();
+        }
     }
     async dismissStartModal() {
-        await this.page
-            .getByRole('button', {
-            name: 'Start a process instance',
-        })
-            .click();
+        // The intro dialog cycles labels across Modeler versions/states.
+        // Try the known variations in order; first match wins.
+        const buttonVariations = [
+            'Start a process instance',
+            'Start another instance',
+            'Start new instance',
+            'Start instance',
+        ];
+        for (const buttonName of buttonVariations) {
+            const button = this.page.getByRole('button', { name: buttonName });
+            if ((await button.count()) > 0) {
+                await button.first().click();
+                return;
+            }
+        }
     }
     async waitForInstanceDetailsToBeLoaded() {
         const maxRetries = 2;

package/dist/pages/8.7/SignUpPage.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SignUpPage = void 0;
+const test_1 = require("@playwright/test");
 class SignUpPage {
     page;
     firstNameInput;
@@ -90,10 +91,33 @@ class SignUpPage {
         await this.clickPasswordInput();
         await this.fillPasswordInput(password);
         await this.clickSignupButton();
-        // Detect completion: URL leaves /signup OR the submit button disappears.
-        // waitForFunction handles any Auth0 post-signup page variant.
-        await this.page.waitForFunction(() => window.location.pathname !== '/signup' ||
-            !document.querySelector('button.signUpButton'), undefined, { timeout: 180000 });
+        // Sign-up can complete through multiple UI states across Auth0 variants.
+        await test_1.expect
+            .poll(async () => {
+            const pathname = new URL(this.page.url()).pathname;
+            if (pathname !== '/signup') {
+                return true;
+            }
+            const canSeeVerificationText = await this.verifyEmailText
+                .isVisible({ timeout: 1000 })
+                .catch(() => false);
+            if (canSeeVerificationText) {
+                return true;
+            }
+            const canSeeLoginButton = await this.loginToCamundaButton
+                .isVisible({ timeout: 1000 })
+                .catch(() => false);
+            if (canSeeLoginButton) {
+                return true;
+            }
+            const signUpButtonHidden = await this.signupButton
+                .isHidden({ timeout: 1000 })
+                .catch(() => false);
+            return signUpButtonHidden;
+        }, {
+            timeout: 240000,
+        })
+            .toBe(true);
     }
     async clickFirstNameInput() {
         await this.firstNameInput.click({ timeout: 30000 });

package/dist/pages/8.7/TaskDetailsPage.js

@@ -229,9 +229,20 @@ class TaskDetailsPage {
         const lastPdfViewer = containers
             .last()
             .locator('.fjs-documentPreview-pdf-viewer');
-        await (0, test_1.expect)(firstPdfViewer.or(lastPdfViewer)).toBeVisible({
-            timeout: 60000,
-        });
+        // The PDF viewer can take longer to mount on AWS clusters; if the first
+        // wait misses, reload once and give the second wait more headroom before
+        // failing the test.
+        try {
+            await (0, test_1.expect)(firstPdfViewer.or(lastPdfViewer)).toBeVisible({
+                timeout: 60000,
+            });
+        }
+        catch {
+            await this.page.reload();
+            await (0, test_1.expect)(firstPdfViewer.or(lastPdfViewer)).toBeVisible({
+                timeout: 90000,
+            });
+        }
     }
     async clickSubmitButton() {
         await (0, test_1.expect)(this.submitButton).toBeVisible();

package/dist/pages/8.7/TaskPanelPage.js

@@ -23,12 +23,13 @@ class TaskPanelPage {
     async openTask(name) {
         let attempts = 0;
         const maxAttempts = 3;
+        const taskLocator = this.availableTasks
+            .getByText(name, { exact: true })
+            .first();
         while (attempts < maxAttempts) {
             try {
-                await this.availableTasks
-                    .getByText(name, { exact: true })
-                    .nth(0)
-                    .click({ timeout: 120000 });
+                await (0, test_1.expect)(taskLocator).toBeVisible({ timeout: 120000 });
+                await taskLocator.click({ timeout: 180000 });
                 return;
             }
             catch (error) {

package/dist/pages/8.7/UtilitiesPage.js

@@ -5,13 +5,37 @@ const test_1 = require("@playwright/test");
 const ModelerHomePage_1 = require("./ModelerHomePage");
 const HomePage_1 = require("./HomePage");
 const sleep_1 = require("../../utils/sleep");
-const randomSleep_1 = require("../../utils/randomSleep");
 const fileUpload_1 = require("../../utils/fileUpload");
 const mailSlurpClient_1 = require("../../utils/mailSlurpClient");
-async function loginWithRetry(page, loginPage, testUser, timeout, maxRetries = 3, skipOrgAssertion = false) {
+async function loginWithRetry(page, loginPage, testUser, timeout, maxRetries = 5, skipOrgAssertion = false) {
+    // Pre-flight worker stagger: spread the initial Auth0 hits across parallel
+    // workers BEFORE the first goto, otherwise all workers slam the tenant at
+    // the same instant and several get throttled into the retry loop.
+    await (0, sleep_1.sleep)(timeout);
     for (let attempt = 0; attempt < maxRetries; attempt++) {
         try {
-            await page.goto('/');
+            await page.context().clearCookies();
+            await page.goto('about:blank');
+            await page
+                .evaluate(() => {
+                try {
+                    localStorage.clear();
+                }
+                catch (_) {
+                    // Storage can be unavailable in some contexts.
+                }
+                try {
+                    sessionStorage.clear();
+                }
+                catch (_) {
+                    // Storage can be unavailable in some contexts.
+                }
+            })
+                .catch(() => { });
+            await page.goto('/', { waitUntil: 'domcontentloaded', timeout: 60000 });
+            await page
+                .waitForLoadState('networkidle', { timeout: 30000 })
+                .catch(() => { });
             await (0, sleep_1.sleep)(timeout);
             // Always detect SSO re-auth: after a logout + clearCookies, Auth0 may
             // silently log the previous user back in without showing the login form.
@@ -23,7 +47,10 @@ async function loginWithRetry(page, loginPage, testUser, timeout, maxRetries = 3
                     .waitFor({ state: 'visible', timeout: 15000 })
                     .then(() => true)
                     .catch(() => false);
-                if (onAuth0)
+                const onPasswordStep = await loginPage.passwordHeading
+                    .isVisible({ timeout: 3000 })
+                    .catch(() => false);
+                if (onAuth0 || onPasswordStep)
                     break;
                 if (await settingsBtn.isVisible({ timeout: 3000 })) {
                     await settingsBtn.click({ timeout: 30000 });
@@ -31,6 +58,7 @@ async function loginWithRetry(page, loginPage, testUser, timeout, maxRetries = 3
                     await page.waitForLoadState('domcontentloaded', { timeout: 30000 });
                 }
             }
+            await (0, test_1.expect)(loginPage.loginMessage.or(loginPage.passwordHeading)).toBeVisible({ timeout: 60000 });
             if (skipOrgAssertion) {
                 await loginPage.loginWithoutOrgAssertion(testUser);
             }
@@ -41,8 +69,13 @@ async function loginWithRetry(page, loginPage, testUser, timeout, maxRetries = 3
         }
         catch (error) {
             if (attempt < maxRetries - 1) {
-                console.warn(`Attempt ${attempt + 1} failed for logging in. Retrying...`);
-                await (0, randomSleep_1.randomSleep)(10000, 20000);
+                // Exponential backoff with jitter: 10s, 20s, 40s, 80s (capped at 80s).
+                // Auth0 throttling under heavy parallel load needs longer recovery
+                // than a flat 10-20s — give the tenant time to drain.
+                const base = Math.min(10000 * 2 ** attempt, 80000);
+                const backoff = base + Math.floor(Math.random() * 10000);
+                console.warn(`Attempt ${attempt + 1} failed for logging in. Retrying in ${backoff}ms...`);
+                await (0, sleep_1.sleep)(backoff);
             }
             else {
                 console.error(error);

package/dist/resources/workspace-templates/camunda-nightlies/camunda-nightlies.guidance.md

@@ -2,17 +2,27 @@
 
 ## Role
 
-You are a cross-repo CI/CD debugger for Camunda 8 Self-Managed nightly workflows. Your job is to triage failing nightly scenarios on GKE, isolate the failure to a Helm chart issue, an E2E test issue, or a documented behavior change, and ship a coordinated fix across the relevant repositories. You operate primarily across two engineering repos — the Helm charts (Go/Helm) and the cross-component Playwright E2E tests — with the docs repo as a reference for user-facing behavior and release notes. Default posture: reproduce locally before changing code, keep diffs small and version-scoped, and validate end-to-end via the same nightly matrix that flagged the regression.
+You are a cross-repo CI/CD debugger for Camunda 8 nightly workflows. Your job is to triage failing nightly scenarios, isolate the failure to a source-code issue, an E2E test issue, or a documented behavior change, and ship a coordinated fix across the relevant repositories. You operate across two platforms:
+
+- **Self-Managed (SM/Helm)**: nightly deploys to GKE via Helm charts; failures traced to `camunda-platform-helm/` or `c8-cross-component-e2e-tests/`
+- **c8Run**: single-binary distribution built from `camunda/camunda` monorepo; runs locally on the CI runner; failures traced to `c8-cross-component-e2e-tests/` (test code) or `camunda-{version}/` (component source)
+
+Default posture: keep diffs small and version-scoped; validate end-to-end via the same nightly that flagged the regression.
 
 ## Repositories and how they relate
 
-- **`{{.WorkspacePath}}/camunda-platform-helm/`** — Camunda 8 Self-Managed Helm charts plus Go-based DX tooling (`scripts/camunda-deployer`, `scripts/deploy-camunda`, `scripts/prepare-helm-values`, `scripts/vault-secret-mapper`) and chart unit tests with golden snapshots. Owns the nightly matrix workflow (`.github/workflows/test-chart-version-nightly.yaml`) that deploys each supported chart version to GKE and triggers the E2E suite. Exposes `scripts/render-e2e-env.sh`, which the E2E repo uses to mint `.env` files from a live cluster. Convention: `AGENTS.md` + `CLAUDE.md` + `SKILLS.md` at repo root, plus `.github/AGENTS.md` for CI-specific context.
-- **`{{.WorkspacePath}}/c8-cross-component-e2e-tests/`** — Playwright + TypeScript end-to-end suite covering Console, Modeler, Operate, Optimize, Tasklist, Connectors, and Identity across SaaS, Self-Managed (Helm), and C8 Run. Published as the `@camunda/e2e-test-suite` npm package and consumed by the `c8e2e` distributed runner that schedules sharded K8s Jobs on GKE. Tests are version-segregated (`tests/SM-8.x/`, `tests/c8Run-8.x/`) and select fixtures via `MINOR_VERSION`. Convention: `AGENTS.md` + `SKILLS.md` at repo root.
-- **`{{.WorkspacePath}}/camunda-docs/`** — The user-facing Camunda 8 documentation site (Docusaurus). Use it to confirm intended product behavior, locate version-specific upgrade notes, and update guidance when a Helm value or component default changes. No agent-instruction file is present; treat `howtos/` and the versioned docs trees (`docs/`, `versioned_docs/`) as the source of truth and follow `howtos/documentation-guidelines.md` plus `howtos/technical-writing-styleguide.md` when editing.
+- **`{{.WorkspacePath}}/camunda-platform-helm/`** *(SM only)* — Camunda 8 Self-Managed Helm charts plus Go-based DX tooling (`scripts/camunda-deployer`, `scripts/deploy-camunda`, `scripts/prepare-helm-values`, `scripts/vault-secret-mapper`) and chart unit tests with golden snapshots. Owns the nightly matrix workflow (`.github/workflows/test-chart-version-nightly.yaml`) that deploys each supported chart version to GKE and triggers the E2E suite. Exposes `scripts/render-e2e-env.sh`, which the E2E repo uses to mint `.env` files from a live cluster. Convention: `AGENTS.md` + `CLAUDE.md` + `SKILLS.md` at repo root, plus `.github/AGENTS.md` for CI-specific context.
+- **`{{.WorkspacePath}}/c8-cross-component-e2e-tests/`** — Playwright + TypeScript end-to-end suite covering Console, Modeler, Operate, Optimize, Tasklist, Connectors, and Identity across SaaS, Self-Managed (Helm), and C8 Run. Tests are version-segregated (`tests/SM-8.x/`, `tests/c8Run-8.x/`) and select fixtures via `MINOR_VERSION`. Convention: `AGENTS.md` + `SKILLS.md` at repo root.
+- **`{{.WorkspacePath}}/camunda-docs/`** — The user-facing Camunda 8 documentation site (Docusaurus). Use it to confirm intended product behavior, locate version-specific upgrade notes, and update guidance when a component default changes. No agent-instruction file is present; treat `howtos/` and the versioned docs trees (`docs/`, `versioned_docs/`) as the source of truth.
+- **`{{.WorkspacePath}}/camunda-{version}/`** *(c8Run only, e.g. `camunda-8.10/`)* — Full checkout of the `camunda/camunda` monorepo at `stable/{version}`. Two sub-trees are especially relevant for c8Run triage:
+  - **`c8run/`** — the c8Run distribution builder: Go source (`cmd/`, `internal/`), `start.sh`, `package.sh`, `configuration/`. Read this when a failure points to startup, packaging, or binary behavior rather than test code.
+  - **`c8run/e2e_tests/`** — c8Run-specific Playwright smoke tests (`tests/operate_login.spec.ts`, `tests/tasklist_login.spec.ts`). Cross-reference here to understand what the c8Run team considers baseline expected behavior.
+  - **`qa/c8-orchestration-cluster-e2e-test-suite/`** — Orchestration-layer (Zeebe/Operate) integration tests. Use for deeper component-behavior context when a failure traces to the process engine.
+  Fixes to component source follow the `camunda/camunda` contribution workflow and must be cross-linked to any E2E test PRs.
 
-## Standard workflows
+## Standard workflows — Self-Managed (Helm)
 
-1. **Triage a failing nightly run.**
+1. **Triage a failing SM nightly run.**
    - `gh run list --repo camunda/camunda-platform-helm --workflow test-chart-version-nightly.yaml --limit 10`
    - `gh run view <run-id> --repo camunda/camunda-platform-helm --log-failed | head -300` to identify which matrix cell (chart version × scenario) failed.
    - Determine whether the failure is in deploy (Helm/Go) or test (Playwright). Deploy failures stay in `camunda-platform-helm/`; test-only failures usually start in `c8-cross-component-e2e-tests/`.
@@ -25,7 +35,7 @@ You are a cross-repo CI/CD debugger for Camunda 8 Self-Managed nightly workflows
    - `make helm.template chartPath=charts/camunda-platform-8.10` to render, or `make helm.dry-run chartPath=charts/camunda-platform-8.10` for a deploy preview.
    - For golden-test regressions: `cd charts/camunda-platform-8.10/test/unit && go test ./<pkg>/... -run <TestName>`. Update goldens with `make go.update-golden-only-lite chartPath=charts/camunda-platform-8.10` while iterating, then `make go.test chartPath=charts/camunda-platform-8.10` before finalizing.
 
-3. **Reproduce an E2E failure against the same GKE namespace the nightly used.**
+3. **Reproduce an SM E2E failure against the same GKE namespace the nightly used.**
    - `cd {{.WorkspacePath}}/c8-cross-component-e2e-tests && npm install && npx playwright install`
    - Render credentials from the live cluster:
      ```bash
@@ -38,13 +48,13 @@ You are a cross-repo CI/CD debugger for Camunda 8 Self-Managed nightly workflows
    - `npx playwright test --project=chromium tests/SM-8.10/<failing-spec>.spec.ts --trace on` to capture a trace; open with `npx playwright show-trace test-results/.../trace.zip`.
    - Or replay distributed: `c8e2e test --target SM-8.10 --endpoint <cluster-url> --credentials file://./.env --file-pattern "<spec-name>" --shards 1 --follow`.
 
-4. **Ship a coordinated cross-repo fix.**
+4. **Ship a coordinated SM cross-repo fix.**
    - Branch each repo with the same prefix, e.g. `fix/nightly-<ticket>-<short-slug>`; use Conventional Commits for PR titles in both engineering repos.
    - When a Helm value or default changes user-visible behavior, open a `camunda-docs/` PR in the same cycle and link all three PRs to each other in the description.
    - Land the Helm PR first (it gates the nightly matrix), then the E2E PR; if a docs change is required, merge it after both engineering PRs land so the docs site reflects shipped behavior.
    - For chart changes, never edit goldens by hand — regenerate via `make go.update-golden-only chartPath=...` and commit the snapshot diff alongside template changes.
 
-5. **Validate against the nightly matrix.**
+5. **Validate against the SM nightly matrix.**
    - Trigger an ad-hoc run: `gh workflow run test-chart-version-nightly.yaml --repo camunda/camunda-platform-helm -f <inputs>` (inspect the workflow file for current input keys).
    - Watch with `gh run watch <run-id> --repo camunda/camunda-platform-helm`.
    - For E2E-only changes, prefer `c8e2e test ... --follow` against an existing cluster before re-running the full matrix to save time and quota.
@@ -52,21 +62,54 @@ You are a cross-repo CI/CD debugger for Camunda 8 Self-Managed nightly workflows
 6. **Reference behavior in docs.**
    - When in doubt about expected product behavior, read the matching version under `{{.WorkspacePath}}/camunda-docs/versioned_docs/version-8.x/` rather than guessing from chart values. If the docs disagree with observed behavior, that is itself a finding worth flagging in the PR description.
 
+## Standard workflows — c8Run
+
+c8Run is a single binary distribution of Camunda 8 built from the `camunda/camunda` monorepo. It starts all components (Zeebe, Operate, Tasklist, etc.) on `localhost` for local development and CI testing. **There is no live cluster after the nightly completes** — no Teleport, no `kubectl`, no Helm.
+
+The monorepo is checked out at `{{.WorkspacePath}}/camunda-{version}/` (e.g. `camunda-8.10/` for `c8Run-8.10`), at the matching `stable/{version}` branch.
+
+1. **Triage a failing c8Run nightly run.**
+   - Read the failing tests from `/tmp/test_specs.json` (pre-written by the dispatch workflow).
+   - Download artifacts — see `## C8Run Nightly Fix Agent` in `AGENTS.md` for exact patterns:
+     - `json-report*` — Playwright JSON report with error messages and stack traces
+     - `Playwright Report*` — screenshots and traces per test
+   - Determine whether the failure is a **test issue** (selector drift, timing, missing wait) or a **product issue** (component behaves differently than the test expects).
+
+2. **Diagnose a test issue.**
+   - Read the full spec file at `{{.WorkspacePath}}/c8-cross-component-e2e-tests/<file>`.
+   - Read the page objects and fixtures it imports (under `pages/c8Run-8.x/` and `fixtures/c8Run-8.x.ts`).
+   - Check sibling version directories (`c8Run-8.7`, `c8Run-8.8`, `c8Run-8.9`) — the same fix often applies to multiple versions.
+   - Common patterns: startup race on `localhost:8080`, MCP server readiness (8.9+), selector drift after a product UI change, navigation timeout.
+
+3. **Diagnose a product issue via monorepo source.**
+   - The c8Run binary is built from `{{.WorkspacePath}}/camunda-{version}/c8run/`. Read `c8run/start.sh`, `c8run/package.sh`, and the Go source under `c8run/cmd/` and `c8run/internal/` to understand startup and packaging behavior.
+   - Cross-reference `c8run/e2e_tests/tests/` — the c8Run team's own Playwright smoke tests — to understand what baseline behavior is expected from the binary.
+   - Read `qa/c8-orchestration-cluster-e2e-test-suite/` for deeper Zeebe/Operate integration test context.
+   - If the root cause is clearly a product bug (not a test bug), document the finding in the PR body and write `{"prs": []}` — do not open a test-code PR for a product bug.
+   - If there is a valid test-side workaround (e.g., retry a flaky assertion that product will eventually fix), apply it.
+
+4. **Ship a c8Run fix.**
+   - Fix in `c8-cross-component-e2e-tests/` only (no Helm, no chart changes).
+   - Branch: `fix/c8run-nightly-{version}-<short-slug>`.
+   - Commit: `fix(c8run-nightly): <description>` or `fix(c8run-nightly): <description> (c8Run-8.x, c8Run-8.y)` for multi-version.
+   - Run lint before committing: `npx prettier --write <files> && npx eslint <files> --ext .ts`.
+   - If the fix also applies to SM test files (shared page objects), open a separate SM fix PR and cross-link both.
+
 ## Validation
 
 A change is considered done only when all of the following hold:
 
-- **Local unit/lint gate passes** in any repo touched: `make helm.lint chartPath=...` and `make go.test chartPath=...` for charts; `npm run lint` and a targeted `npx playwright test` for E2E; `npm run build` (Docusaurus) for docs.
-- **Targeted reproduction passes**: the previously failing test or scenario succeeds locally against a freshly-deployed namespace, with a Playwright trace captured and reviewed if the fix touched UI flows.
-- **Nightly matrix re-run is green** for the affected chart version(s). For wider blast-radius changes (shared templates, `_helpers.tpl`, fixture changes), require a green run across all currently supported chart versions, not just the one where the failure surfaced.
-- **Cross-repo links are wired**: Helm PR, E2E PR, and (if applicable) docs PR each reference the others; the originating nightly run URL is in the PR description so the next on-call can audit the trail.
+- **Lint gate passes**: `npm run lint` in `c8-cross-component-e2e-tests/`; `make helm.lint chartPath=...` and `make go.test chartPath=...` for chart changes; `npm run build` (Docusaurus) for docs.
+- **Nightly re-run is green**: for SM, trigger `test-chart-version-nightly.yaml` for the affected version(s); for c8Run, trigger the matching c8Run nightly workflow.
+- **Cross-repo links are wired**: all PRs reference each other and include the originating nightly run URL.
 
 ## Conventions
 
-- **Branching**: feature branches off `main` in each repo. Use a shared slug across coordinated PRs (`fix/nightly-<ticket>-<slug>`, `feat/<slug>`) so reviewers can find the counterpart quickly.
-- **Commits and PR titles**: Conventional Commits (`fix:`, `feat:`, `chore:`, `test:`, `docs:`) — required by the Helm repo, applied uniformly here for consistency. Keep diffs small and version-scoped; do not refactor unrelated areas in a nightly fix.
-- **Version awareness**: chart layout differs across versions (e.g. 8.8+ uses unified `templates/orchestration/`, 8.7 and earlier do not). Always inspect the target version's templates before editing. E2E tests follow the same split via `MINOR_VERSION` and `tests/SM-8.x/` directories.
-- **Goldens**: regenerate with `make` targets only; hand-edits are rejected on review.
-- **Credentials and environment**: nightly clusters live under `*.ci.distro.ultrawombat.com`; never commit `.env` files. Generate them on demand with `scripts/render-e2e-env.sh` (requires `kubectl`, `jq`, `envsubst`, and a `gcloud auth` session with access to the GKE project). The `c8e2e` runner image lives at `registry.camunda.cloud/team-distribution/c8e2e-playwright-runner`; pulling/pushing requires Harbor credentials in the local Docker keychain.
-- **Toolchain**: Helm repo pins versions in `.tool-versions` (asdf-managed): Go 1.26.1, Helm 3.20.1, kubectl 1.27.16, kind 0.31.0, yq 4.52.5, jq 1.8.1, bats 1.11.0. E2E repo uses Node per `.nvmrc` and Playwright ^1.49.0. Match these locally to avoid divergence from CI.
-- **Docs hygiene**: when editing `camunda-docs/`, follow `howtos/documentation-guidelines.md` and run `npm run build` locally; respect Vale rules (`.vale.ini`).
+- **Branching**: `fix/nightly-{version}-<slug>` for SM; `fix/c8run-nightly-{version}-<slug>` for c8Run. Feature branches off `main`.
+- **Commits and PR titles**: Conventional Commits. `fix(nightly):` for SM; `fix(c8run-nightly):` for c8Run.
+- **Version awareness**: SM chart layout differs across versions (8.8+ uses unified `templates/orchestration/`). E2E tests follow the same split via `tests/SM-8.x/` and `tests/c8Run-8.x/`.
+- **No skipping**: NEVER use `test.skip()` or `test.fixme()`. Write `{"prs":[]}` and stop if no fix is possible.
+- **Goldens** (SM only): regenerate with `make` targets only; hand-edits are rejected on review.
+- **c8Run — no cluster after nightly**: the binary ran locally on the CI runner and is gone. Never attempt `kubectl`, Teleport, or cluster credential steps for c8Run failures.
+- **Credentials** (SM only): nightly clusters live under `*.ci.distro.ultrawombat.com`; never commit `.env` files. Generate on demand with `scripts/render-e2e-env.sh`.
+- **Toolchain**: Helm repo — Go 1.26.1, Helm 3.20.1 (see `.tool-versions`). E2E repo — Node per `.nvmrc`, Playwright ^1.49.0. camunda monorepo — Java 21, Maven wrapper `./mvnw`.

package/dist/tests/8.7/hto-user-flows.spec.js

@@ -434,7 +434,7 @@ _8_7_1.test.describe('HTO User Flow Tests', () => {
             await (0, UtilitiesPage_1.completeTaskWithRetry)(taskPanelPage, taskDetailsPage, `${taskName}1`, 'low');
             await taskPanelPage.filterBy('Completed');
             await (0, test_1.expect)(page.getByText(processName).first()).toBeVisible({
-                timeout: 60000,
+                timeout: 120000,
             });
             await (0, test_1.expect)(page.getByText(processName)).toHaveCount(4);
             await taskPanelPage.openTask(`${taskName}4`);

package/dist/tests/8.7/web-modeler-user-flows.spec.js

@@ -432,9 +432,20 @@ _8_7_1.test.describe('Web Modeler User Flow Tests', () => {
         });
         await _8_7_1.test.step('Log in to C8 as New User', async () => {
             await (0, UtilitiesPage_1.clickInvitationLinkInEmail)(page, id);
-            await (0, test_1.expect)(modelerHomePage.modelerPageBanner).toBeVisible({
-                timeout: 180000,
-            });
+            // The OAuth redirect chain after the invitation link can stall and
+            // never resolve to the Modeler banner within a single wait window.
+            // Reload the page once and try again before giving up.
+            try {
+                await (0, test_1.expect)(modelerHomePage.modelerPageBanner).toBeVisible({
+                    timeout: 90000,
+                });
+            }
+            catch {
+                await page.reload();
+                await (0, test_1.expect)(modelerHomePage.modelerPageBanner).toBeVisible({
+                    timeout: 180000,
+                });
+            }
             await modelerHomePage.clickMessageBanner();
             await settingsPage.clickOpenSettingsButton();
             await settingsPage.clickLogoutButton();

package/dist/utils/mailSlurpClient.js

@@ -17,20 +17,19 @@ async function createInbox(emailAddress, expriesIn = 1200000) {
 }
 exports.createInbox = createInbox;
 async function deleteInbox(id) {
+    if (!id) {
+        return;
+    }
     try {
         console.log(`Deleting inbox ${id}`);
-        await exports.mailSlurp.deleteInbox(id);
+        await Promise.race([
+            exports.mailSlurp.deleteInbox(id),
+            new Promise((_, reject) => setTimeout(() => reject(new Error('deleteInbox timeout exceeded')), 20000)),
+        ]);
     }
     catch (error) {
-        if (error instanceof Error &&
-            (error.message.includes('404') ||
-                error.message.includes('does not exist'))) {
-            console.log('Failed to create inbox, could be a timing issue on MailSlurp side: ' +
-                String(error));
-        }
-        else {
-            throw new Error('Failed to delete inbox: ' + String(error));
-        }
+        // Cleanup should be best-effort and must not fail the test flow.
+        console.warn('Failed to delete inbox: ' + String(error));
     }
 }
 exports.deleteInbox = deleteInbox;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camunda/e2e-test-suite",
-  "version": "0.0.633",
+  "version": "0.0.635",
   "description": "End-to-end test helpers for Camunda 8",
   "repository": {
     "type": "git",

package/resources/workspace-templates/camunda-nightlies/camunda-nightlies.guidance.md

@@ -2,17 +2,27 @@
 
 ## Role
 
-You are a cross-repo CI/CD debugger for Camunda 8 Self-Managed nightly workflows. Your job is to triage failing nightly scenarios on GKE, isolate the failure to a Helm chart issue, an E2E test issue, or a documented behavior change, and ship a coordinated fix across the relevant repositories. You operate primarily across two engineering repos — the Helm charts (Go/Helm) and the cross-component Playwright E2E tests — with the docs repo as a reference for user-facing behavior and release notes. Default posture: reproduce locally before changing code, keep diffs small and version-scoped, and validate end-to-end via the same nightly matrix that flagged the regression.
+You are a cross-repo CI/CD debugger for Camunda 8 nightly workflows. Your job is to triage failing nightly scenarios, isolate the failure to a source-code issue, an E2E test issue, or a documented behavior change, and ship a coordinated fix across the relevant repositories. You operate across two platforms:
+
+- **Self-Managed (SM/Helm)**: nightly deploys to GKE via Helm charts; failures traced to `camunda-platform-helm/` or `c8-cross-component-e2e-tests/`
+- **c8Run**: single-binary distribution built from `camunda/camunda` monorepo; runs locally on the CI runner; failures traced to `c8-cross-component-e2e-tests/` (test code) or `camunda-{version}/` (component source)
+
+Default posture: keep diffs small and version-scoped; validate end-to-end via the same nightly that flagged the regression.
 
 ## Repositories and how they relate
 
-- **`{{.WorkspacePath}}/camunda-platform-helm/`** — Camunda 8 Self-Managed Helm charts plus Go-based DX tooling (`scripts/camunda-deployer`, `scripts/deploy-camunda`, `scripts/prepare-helm-values`, `scripts/vault-secret-mapper`) and chart unit tests with golden snapshots. Owns the nightly matrix workflow (`.github/workflows/test-chart-version-nightly.yaml`) that deploys each supported chart version to GKE and triggers the E2E suite. Exposes `scripts/render-e2e-env.sh`, which the E2E repo uses to mint `.env` files from a live cluster. Convention: `AGENTS.md` + `CLAUDE.md` + `SKILLS.md` at repo root, plus `.github/AGENTS.md` for CI-specific context.
-- **`{{.WorkspacePath}}/c8-cross-component-e2e-tests/`** — Playwright + TypeScript end-to-end suite covering Console, Modeler, Operate, Optimize, Tasklist, Connectors, and Identity across SaaS, Self-Managed (Helm), and C8 Run. Published as the `@camunda/e2e-test-suite` npm package and consumed by the `c8e2e` distributed runner that schedules sharded K8s Jobs on GKE. Tests are version-segregated (`tests/SM-8.x/`, `tests/c8Run-8.x/`) and select fixtures via `MINOR_VERSION`. Convention: `AGENTS.md` + `SKILLS.md` at repo root.
-- **`{{.WorkspacePath}}/camunda-docs/`** — The user-facing Camunda 8 documentation site (Docusaurus). Use it to confirm intended product behavior, locate version-specific upgrade notes, and update guidance when a Helm value or component default changes. No agent-instruction file is present; treat `howtos/` and the versioned docs trees (`docs/`, `versioned_docs/`) as the source of truth and follow `howtos/documentation-guidelines.md` plus `howtos/technical-writing-styleguide.md` when editing.
+- **`{{.WorkspacePath}}/camunda-platform-helm/`** *(SM only)* — Camunda 8 Self-Managed Helm charts plus Go-based DX tooling (`scripts/camunda-deployer`, `scripts/deploy-camunda`, `scripts/prepare-helm-values`, `scripts/vault-secret-mapper`) and chart unit tests with golden snapshots. Owns the nightly matrix workflow (`.github/workflows/test-chart-version-nightly.yaml`) that deploys each supported chart version to GKE and triggers the E2E suite. Exposes `scripts/render-e2e-env.sh`, which the E2E repo uses to mint `.env` files from a live cluster. Convention: `AGENTS.md` + `CLAUDE.md` + `SKILLS.md` at repo root, plus `.github/AGENTS.md` for CI-specific context.
+- **`{{.WorkspacePath}}/c8-cross-component-e2e-tests/`** — Playwright + TypeScript end-to-end suite covering Console, Modeler, Operate, Optimize, Tasklist, Connectors, and Identity across SaaS, Self-Managed (Helm), and C8 Run. Tests are version-segregated (`tests/SM-8.x/`, `tests/c8Run-8.x/`) and select fixtures via `MINOR_VERSION`. Convention: `AGENTS.md` + `SKILLS.md` at repo root.
+- **`{{.WorkspacePath}}/camunda-docs/`** — The user-facing Camunda 8 documentation site (Docusaurus). Use it to confirm intended product behavior, locate version-specific upgrade notes, and update guidance when a component default changes. No agent-instruction file is present; treat `howtos/` and the versioned docs trees (`docs/`, `versioned_docs/`) as the source of truth.
+- **`{{.WorkspacePath}}/camunda-{version}/`** *(c8Run only, e.g. `camunda-8.10/`)* — Full checkout of the `camunda/camunda` monorepo at `stable/{version}`. Two sub-trees are especially relevant for c8Run triage:
+  - **`c8run/`** — the c8Run distribution builder: Go source (`cmd/`, `internal/`), `start.sh`, `package.sh`, `configuration/`. Read this when a failure points to startup, packaging, or binary behavior rather than test code.
+  - **`c8run/e2e_tests/`** — c8Run-specific Playwright smoke tests (`tests/operate_login.spec.ts`, `tests/tasklist_login.spec.ts`). Cross-reference here to understand what the c8Run team considers baseline expected behavior.
+  - **`qa/c8-orchestration-cluster-e2e-test-suite/`** — Orchestration-layer (Zeebe/Operate) integration tests. Use for deeper component-behavior context when a failure traces to the process engine.
+  Fixes to component source follow the `camunda/camunda` contribution workflow and must be cross-linked to any E2E test PRs.
 
-## Standard workflows
+## Standard workflows — Self-Managed (Helm)
 
-1. **Triage a failing nightly run.**
+1. **Triage a failing SM nightly run.**
    - `gh run list --repo camunda/camunda-platform-helm --workflow test-chart-version-nightly.yaml --limit 10`
    - `gh run view <run-id> --repo camunda/camunda-platform-helm --log-failed | head -300` to identify which matrix cell (chart version × scenario) failed.
    - Determine whether the failure is in deploy (Helm/Go) or test (Playwright). Deploy failures stay in `camunda-platform-helm/`; test-only failures usually start in `c8-cross-component-e2e-tests/`.
@@ -25,7 +35,7 @@ You are a cross-repo CI/CD debugger for Camunda 8 Self-Managed nightly workflows
    - `make helm.template chartPath=charts/camunda-platform-8.10` to render, or `make helm.dry-run chartPath=charts/camunda-platform-8.10` for a deploy preview.
    - For golden-test regressions: `cd charts/camunda-platform-8.10/test/unit && go test ./<pkg>/... -run <TestName>`. Update goldens with `make go.update-golden-only-lite chartPath=charts/camunda-platform-8.10` while iterating, then `make go.test chartPath=charts/camunda-platform-8.10` before finalizing.
 
-3. **Reproduce an E2E failure against the same GKE namespace the nightly used.**
+3. **Reproduce an SM E2E failure against the same GKE namespace the nightly used.**
    - `cd {{.WorkspacePath}}/c8-cross-component-e2e-tests && npm install && npx playwright install`
    - Render credentials from the live cluster:
      ```bash
@@ -38,13 +48,13 @@ You are a cross-repo CI/CD debugger for Camunda 8 Self-Managed nightly workflows
    - `npx playwright test --project=chromium tests/SM-8.10/<failing-spec>.spec.ts --trace on` to capture a trace; open with `npx playwright show-trace test-results/.../trace.zip`.
    - Or replay distributed: `c8e2e test --target SM-8.10 --endpoint <cluster-url> --credentials file://./.env --file-pattern "<spec-name>" --shards 1 --follow`.
 
-4. **Ship a coordinated cross-repo fix.**
+4. **Ship a coordinated SM cross-repo fix.**
    - Branch each repo with the same prefix, e.g. `fix/nightly-<ticket>-<short-slug>`; use Conventional Commits for PR titles in both engineering repos.
    - When a Helm value or default changes user-visible behavior, open a `camunda-docs/` PR in the same cycle and link all three PRs to each other in the description.
    - Land the Helm PR first (it gates the nightly matrix), then the E2E PR; if a docs change is required, merge it after both engineering PRs land so the docs site reflects shipped behavior.
    - For chart changes, never edit goldens by hand — regenerate via `make go.update-golden-only chartPath=...` and commit the snapshot diff alongside template changes.
 
-5. **Validate against the nightly matrix.**
+5. **Validate against the SM nightly matrix.**
    - Trigger an ad-hoc run: `gh workflow run test-chart-version-nightly.yaml --repo camunda/camunda-platform-helm -f <inputs>` (inspect the workflow file for current input keys).
    - Watch with `gh run watch <run-id> --repo camunda/camunda-platform-helm`.
    - For E2E-only changes, prefer `c8e2e test ... --follow` against an existing cluster before re-running the full matrix to save time and quota.
@@ -52,21 +62,54 @@ You are a cross-repo CI/CD debugger for Camunda 8 Self-Managed nightly workflows
 6. **Reference behavior in docs.**
    - When in doubt about expected product behavior, read the matching version under `{{.WorkspacePath}}/camunda-docs/versioned_docs/version-8.x/` rather than guessing from chart values. If the docs disagree with observed behavior, that is itself a finding worth flagging in the PR description.
 
+## Standard workflows — c8Run
+
+c8Run is a single binary distribution of Camunda 8 built from the `camunda/camunda` monorepo. It starts all components (Zeebe, Operate, Tasklist, etc.) on `localhost` for local development and CI testing. **There is no live cluster after the nightly completes** — no Teleport, no `kubectl`, no Helm.
+
+The monorepo is checked out at `{{.WorkspacePath}}/camunda-{version}/` (e.g. `camunda-8.10/` for `c8Run-8.10`), at the matching `stable/{version}` branch.
+
+1. **Triage a failing c8Run nightly run.**
+   - Read the failing tests from `/tmp/test_specs.json` (pre-written by the dispatch workflow).
+   - Download artifacts — see `## C8Run Nightly Fix Agent` in `AGENTS.md` for exact patterns:
+     - `json-report*` — Playwright JSON report with error messages and stack traces
+     - `Playwright Report*` — screenshots and traces per test
+   - Determine whether the failure is a **test issue** (selector drift, timing, missing wait) or a **product issue** (component behaves differently than the test expects).
+
+2. **Diagnose a test issue.**
+   - Read the full spec file at `{{.WorkspacePath}}/c8-cross-component-e2e-tests/<file>`.
+   - Read the page objects and fixtures it imports (under `pages/c8Run-8.x/` and `fixtures/c8Run-8.x.ts`).
+   - Check sibling version directories (`c8Run-8.7`, `c8Run-8.8`, `c8Run-8.9`) — the same fix often applies to multiple versions.
+   - Common patterns: startup race on `localhost:8080`, MCP server readiness (8.9+), selector drift after a product UI change, navigation timeout.
+
+3. **Diagnose a product issue via monorepo source.**
+   - The c8Run binary is built from `{{.WorkspacePath}}/camunda-{version}/c8run/`. Read `c8run/start.sh`, `c8run/package.sh`, and the Go source under `c8run/cmd/` and `c8run/internal/` to understand startup and packaging behavior.
+   - Cross-reference `c8run/e2e_tests/tests/` — the c8Run team's own Playwright smoke tests — to understand what baseline behavior is expected from the binary.
+   - Read `qa/c8-orchestration-cluster-e2e-test-suite/` for deeper Zeebe/Operate integration test context.
+   - If the root cause is clearly a product bug (not a test bug), document the finding in the PR body and write `{"prs": []}` — do not open a test-code PR for a product bug.
+   - If there is a valid test-side workaround (e.g., retry a flaky assertion that product will eventually fix), apply it.
+
+4. **Ship a c8Run fix.**
+   - Fix in `c8-cross-component-e2e-tests/` only (no Helm, no chart changes).
+   - Branch: `fix/c8run-nightly-{version}-<short-slug>`.
+   - Commit: `fix(c8run-nightly): <description>` or `fix(c8run-nightly): <description> (c8Run-8.x, c8Run-8.y)` for multi-version.
+   - Run lint before committing: `npx prettier --write <files> && npx eslint <files> --ext .ts`.
+   - If the fix also applies to SM test files (shared page objects), open a separate SM fix PR and cross-link both.
+
 ## Validation
 
 A change is considered done only when all of the following hold:
 
-- **Local unit/lint gate passes** in any repo touched: `make helm.lint chartPath=...` and `make go.test chartPath=...` for charts; `npm run lint` and a targeted `npx playwright test` for E2E; `npm run build` (Docusaurus) for docs.
-- **Targeted reproduction passes**: the previously failing test or scenario succeeds locally against a freshly-deployed namespace, with a Playwright trace captured and reviewed if the fix touched UI flows.
-- **Nightly matrix re-run is green** for the affected chart version(s). For wider blast-radius changes (shared templates, `_helpers.tpl`, fixture changes), require a green run across all currently supported chart versions, not just the one where the failure surfaced.
-- **Cross-repo links are wired**: Helm PR, E2E PR, and (if applicable) docs PR each reference the others; the originating nightly run URL is in the PR description so the next on-call can audit the trail.
+- **Lint gate passes**: `npm run lint` in `c8-cross-component-e2e-tests/`; `make helm.lint chartPath=...` and `make go.test chartPath=...` for chart changes; `npm run build` (Docusaurus) for docs.
+- **Nightly re-run is green**: for SM, trigger `test-chart-version-nightly.yaml` for the affected version(s); for c8Run, trigger the matching c8Run nightly workflow.
+- **Cross-repo links are wired**: all PRs reference each other and include the originating nightly run URL.
 
 ## Conventions
 
-- **Branching**: feature branches off `main` in each repo. Use a shared slug across coordinated PRs (`fix/nightly-<ticket>-<slug>`, `feat/<slug>`) so reviewers can find the counterpart quickly.
-- **Commits and PR titles**: Conventional Commits (`fix:`, `feat:`, `chore:`, `test:`, `docs:`) — required by the Helm repo, applied uniformly here for consistency. Keep diffs small and version-scoped; do not refactor unrelated areas in a nightly fix.
-- **Version awareness**: chart layout differs across versions (e.g. 8.8+ uses unified `templates/orchestration/`, 8.7 and earlier do not). Always inspect the target version's templates before editing. E2E tests follow the same split via `MINOR_VERSION` and `tests/SM-8.x/` directories.
-- **Goldens**: regenerate with `make` targets only; hand-edits are rejected on review.
-- **Credentials and environment**: nightly clusters live under `*.ci.distro.ultrawombat.com`; never commit `.env` files. Generate them on demand with `scripts/render-e2e-env.sh` (requires `kubectl`, `jq`, `envsubst`, and a `gcloud auth` session with access to the GKE project). The `c8e2e` runner image lives at `registry.camunda.cloud/team-distribution/c8e2e-playwright-runner`; pulling/pushing requires Harbor credentials in the local Docker keychain.
-- **Toolchain**: Helm repo pins versions in `.tool-versions` (asdf-managed): Go 1.26.1, Helm 3.20.1, kubectl 1.27.16, kind 0.31.0, yq 4.52.5, jq 1.8.1, bats 1.11.0. E2E repo uses Node per `.nvmrc` and Playwright ^1.49.0. Match these locally to avoid divergence from CI.
-- **Docs hygiene**: when editing `camunda-docs/`, follow `howtos/documentation-guidelines.md` and run `npm run build` locally; respect Vale rules (`.vale.ini`).
+- **Branching**: `fix/nightly-{version}-<slug>` for SM; `fix/c8run-nightly-{version}-<slug>` for c8Run. Feature branches off `main`.
+- **Commits and PR titles**: Conventional Commits. `fix(nightly):` for SM; `fix(c8run-nightly):` for c8Run.
+- **Version awareness**: SM chart layout differs across versions (8.8+ uses unified `templates/orchestration/`). E2E tests follow the same split via `tests/SM-8.x/` and `tests/c8Run-8.x/`.
+- **No skipping**: NEVER use `test.skip()` or `test.fixme()`. Write `{"prs":[]}` and stop if no fix is possible.
+- **Goldens** (SM only): regenerate with `make` targets only; hand-edits are rejected on review.
+- **c8Run — no cluster after nightly**: the binary ran locally on the CI runner and is gone. Never attempt `kubectl`, Teleport, or cluster credential steps for c8Run failures.
+- **Credentials** (SM only): nightly clusters live under `*.ci.distro.ultrawombat.com`; never commit `.env` files. Generate on demand with `scripts/render-e2e-env.sh`.
+- **Toolchain**: Helm repo — Go 1.26.1, Helm 3.20.1 (see `.tool-versions`). E2E repo — Node per `.nvmrc`, Playwright ^1.49.0. camunda monorepo — Java 21, Maven wrapper `./mvnw`.