@sun-asterisk/sungen 2.5.2 → 2.6.1

package/dist/orchestrator/templates/ai-instructions/github-skill-sungen-tc-generation.md

@@ -174,6 +174,29 @@ Scenario: Reset filters to default
 
 For one-time setup/teardown. Most screens don't need these.
 
+### `@parallel` — when tests need independent browser state
+
+Add `@parallel` at feature level when:
+
+1. **Multiple auth groups** (required) — e.g., `@auth:user` + `@no-auth` scenarios. Serial mode uses one shared context and cannot mix auth roles. Compiler will error without this tag.
+2. **Validation-heavy features** (recommended) — each scenario fills forms with different invalid data and needs a clean form. Serial shared page keeps previous test's input.
+
+Serial (default) is best for: CRUD flows, sequential user journeys, UI checks on the same page.
+
+```gherkin
+@parallel @auth:user
+@cleanup:forms
+Feature: kudos Screen
+
+  @critical
+  Scenario: Send kudos
+    ...
+
+  @critical @no-auth
+  Scenario: Unauthenticated user is redirected
+    ...
+```
+
 ## Output Format
 
 **Feature file** — `qa/screens/<screen>/features/<screen>.feature`
@@ -251,3 +274,73 @@ valid_password: StagingPass456
 ```
 
 **Do NOT generate**: `selectors.yaml` (created during run-test), Playwright code (sungen compiles).
+
+---
+
+## Flow Test Generation
+
+When generating tests for a **flow** (`qa/flows/<name>/`), adapt the strategy:
+
+### Structure
+
+- **Background** — starting page only: `Given User is on [Login] page`
+- **Scenarios** — each phase of the E2E journey as a separate scenario
+- **Selector refs** — use `[Screen:Element]` namespace format (see `sungen-gherkin-syntax`)
+- **Test data** — namespace by phase: `login.email`, `submission.nominee`
+- **Feature tag** — `@flow` required at feature level
+
+### Flow vs Screen Differences
+
+| Aspect | Screen | Flow |
+|---|---|---|
+| Section focus | UI patterns per section | Journey phases across screens |
+| Viewpoints | VP-UI, VP-VAL, VP-LOGIC, VP-SEC per section | VP-LOGIC (flow transitions), VP-SEC (auth persistence), VP-VAL (cross-screen data) |
+| Tier 1 focus | Happy path + required validation per section | Happy path through entire flow + auth + key error recovery |
+| Background | Navigate to screen | Navigate to starting page |
+
+### Flow-specific scenarios to generate
+
+| Category | Examples |
+|---|---|
+| **Happy path** | Complete flow end-to-end with valid data |
+| **Auth persistence** | Auth state maintained across screen transitions |
+| **Error recovery** | Invalid input mid-flow → fix → continue |
+| **Incomplete flow** | User abandons at each phase → state cleanup |
+| **Cross-screen data** | Data entered on screen A visible on screen B |
+
+### Output Format (Flow)
+
+```gherkin
+@flow @auth:user
+Feature: Award Submission Flow
+
+  Background:
+    Given User is on [Login] page
+
+  @critical
+  Scenario: User login successfully
+    When User fill [Login:Email] field with {{login.email}}
+    And User fill [Login:Password] field with {{login.password}}
+    And User click [Login:Submit] button
+    Then User see [Dashboard] page
+
+  @critical
+  Scenario: User navigates to awards and submits
+    Given User is on [Awards] page
+    When User fill [Awards:Nominee] field with {{submission.nominee}}
+    And User fill [Awards:Reason] field with {{submission.reason}}
+    And User click [Awards:Submit] button
+    Then User see [Awards:Success Message] text with {{submission.success_message}}
+```
+
+```yaml
+# test-data — namespaced by phase
+login:
+  email: "user@example.com"
+  password: "Password123"
+
+submission:
+  nominee: "John Doe"
+  reason: "Outstanding contribution to the team"
+  success_message: "Award submitted successfully"
+```

package/dist/orchestrator/templates/ai-instructions/github-skill-sungen-tc-review.md

@@ -89,6 +89,36 @@ Do NOT mark `@manual` when data is visible in snapshot or documented in spec —
 
 ---
 
+## Flow Review Additions
+
+When reviewing a `@flow` feature (`qa/flows/<name>/`), apply standard scoring PLUS these flow-specific checks:
+
+### Syntax — additional checks
+- `[Screen:Element]` format used consistently (not mixing bare `[Element]` refs)
+- YAML keys quoted with colon: `"login:submit":` not `login:submit:`
+- `@flow` tag present at feature level
+
+### Coverage — additional dimensions
+| Dimension | Pts (from existing 40) | What to check |
+|---|---|---|
+| Screen transitions | (part of State transitions) | Each screen-to-screen navigation tested |
+| Auth persistence | (part of Happy paths) | Auth state maintained across transitions |
+| Error recovery mid-flow | (part of Negative cases) | Invalid input at each phase → fix → continue |
+| Cross-screen data | (part of Edge cases) | Data entered on screen A asserted on screen B |
+
+### Viewpoint — flow-specific classification
+- **VP-LOGIC** — screen transitions, navigation flow, auth persistence
+- **VP-VAL** — cross-screen data consistency, form data carried across pages
+- **VP-SEC** — auth state across redirects, permission changes mid-flow
+- VP-UI is typically minimal in flows (focus on functionality over layout)
+
+### Checklist — flow-specific items
+11. **Missing screen transitions** — flow visits 4 screens but only 2 transitions tested? Add missing
+12. **Orphan scenarios** — scenario doesn't connect to previous/next phase? Flag broken flow
+13. **Selector namespace consistency** — mixing `[Submit]` and `[Login:Submit]` in same flow? Standardize
+
+---
+
 ## Unverified Selectors metric
 
 **When to check**: if `qa/screens/<screen>/selectors/<screen>.yaml` exists, count lines matching the pattern `@needs-live-verify`.

package/dist/orchestrator/templates/playwright.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright.config.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/templates/playwright.config.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAKH;;GAEG;;AACH,wBAyEG"}
+{"version":3,"file":"playwright.config.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/templates/playwright.config.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAKH;;GAEG;;AACH,wBA4EG"}

package/dist/orchestrator/templates/playwright.config.js

@@ -22,7 +22,7 @@ exports.default = (0, test_1.defineConfig)({
     /* Opt out of parallel tests on CI. */
     workers: process.env.CI ? 1 : 2,
     /* Global timeout per test */
-    timeout: 10000,
+    timeout: 15000,
     /* Reporter to use. See https://playwright.dev/docs/test-reporters */
     /* JSON reporter is required by `sungen delivery` to populate test result columns in the exported CSV. */
     /* Output file path is controlled by PLAYWRIGHT_JSON_OUTPUT_NAME env var for per-screen isolation. */
@@ -34,6 +34,8 @@ exports.default = (0, test_1.defineConfig)({
     use: {
         /* Base URL to use in actions like `await page.goto('')`. */
         baseURL: 'https://example.com',
+        /* Per-action timeout (click, fill, etc.) */
+        actionTimeout: 10000,
         /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
         trace: 'on-first-retry',
     },

package/dist/orchestrator/templates/playwright.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"playwright.config.js","sourceRoot":"","sources":["../../../src/orchestrator/templates/playwright.config.ts"],"names":[],"mappings":";;AAAA,2CAAyD;AAEzD;;;GAGG;AACH,+BAA+B;AAC/B,2BAA2B;AAC3B,4DAA4D;AAE5D;;GAEG;AACH,kBAAe,IAAA,mBAAY,EAAC;IAC1B,OAAO,EAAE,mBAAmB;IAC5B,oCAAoC;IACpC,aAAa,EAAE,IAAI;IACnB,iFAAiF;IACjF,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;IAC5B,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,6BAA6B;IAC7B,OAAO,EAAE,KAAM;IACf,qEAAqE;IACrE,yGAAyG;IACzG,qGAAqG;IACrG,QAAQ,EAAE;QACR,CAAC,MAAM,CAAC;QACR,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,2BAA2B,EAAE,CAAC;KACjG;IACD,wGAAwG;IACxG,GAAG,EAAE;QACH,4DAA4D;QAC5D,OAAO,EAAE,qBAAqB;QAE9B,+FAA+F;QAC/F,KAAK,EAAE,gBAAgB;KACxB;IAED,2CAA2C;IAC3C,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,UAAU;YAChB,GAAG,EAAE,EAAE,GAAG,cAAO,CAAC,gBAAgB,CAAC,EAAE;SACtC;QAED;;;;;;;;;;;;;;;;;;;;;4CAqBoC;QACpC,IAAI;QACJ,4BAA4B;QAC5B,4DAA4D;QAC5D,KAAK;QACL,IAAI;QACJ,2BAA2B;QAC3B,8DAA8D;QAC9D,KAAK;KACN;IAED,yDAAyD;IACzD,eAAe;IACf,8BAA8B;IAC9B,kCAAkC;IAClC,0CAA0C;IAC1C,KAAK;CACN,CAAC,CAAC"}
+{"version":3,"file":"playwright.config.js","sourceRoot":"","sources":["../../../src/orchestrator/templates/playwright.config.ts"],"names":[],"mappings":";;AAAA,2CAAyD;AAEzD;;;GAGG;AACH,+BAA+B;AAC/B,2BAA2B;AAC3B,4DAA4D;AAE5D;;GAEG;AACH,kBAAe,IAAA,mBAAY,EAAC;IAC1B,OAAO,EAAE,mBAAmB;IAC5B,oCAAoC;IACpC,aAAa,EAAE,IAAI;IACnB,iFAAiF;IACjF,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;IAC5B,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,6BAA6B;IAC7B,OAAO,EAAE,KAAM;IACf,qEAAqE;IACrE,yGAAyG;IACzG,qGAAqG;IACrG,QAAQ,EAAE;QACR,CAAC,MAAM,CAAC;QACR,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,2BAA2B,EAAE,CAAC;KACjG;IACD,wGAAwG;IACxG,GAAG,EAAE;QACH,4DAA4D;QAC5D,OAAO,EAAE,qBAAqB;QAE9B,4CAA4C;QAC5C,aAAa,EAAE,KAAM;QAErB,+FAA+F;QAC/F,KAAK,EAAE,gBAAgB;KACxB;IAED,2CAA2C;IAC3C,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,UAAU;YAChB,GAAG,EAAE,EAAE,GAAG,cAAO,CAAC,gBAAgB,CAAC,EAAE;SACtC;QAED;;;;;;;;;;;;;;;;;;;;;4CAqBoC;QACpC,IAAI;QACJ,4BAA4B;QAC5B,4DAA4D;QAC5D,KAAK;QACL,IAAI;QACJ,2BAA2B;QAC3B,8DAA8D;QAC9D,KAAK;KACN;IAED,yDAAyD;IACzD,eAAe;IACf,8BAA8B;IAC9B,kCAAkC;IAClC,0CAA0C;IAC1C,KAAK;CACN,CAAC,CAAC"}

package/dist/orchestrator/templates/playwright.config.ts

@@ -22,7 +22,7 @@ export default defineConfig({
   /* Opt out of parallel tests on CI. */
   workers: process.env.CI ? 1 : 2,
   /* Global timeout per test */
-  timeout: 10_000,
+  timeout: 15_000,
   /* Reporter to use. See https://playwright.dev/docs/test-reporters */
   /* JSON reporter is required by `sungen delivery` to populate test result columns in the exported CSV. */
   /* Output file path is controlled by PLAYWRIGHT_JSON_OUTPUT_NAME env var for per-screen isolation. */
@@ -35,6 +35,9 @@ export default defineConfig({
     /* Base URL to use in actions like `await page.goto('')`. */
     baseURL: 'https://example.com',
 
+    /* Per-action timeout (click, fill, etc.) */
+    actionTimeout: 10_000,
+
     /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
     trace: 'on-first-retry',
   },

package/dist/orchestrator/templates/specs-base.d.ts

@@ -1,15 +1,14 @@
-import { expect } from '@playwright/test';
+import { expect, type Page } from '@playwright/test';
 type CleanupConfig = {
     overlay?: boolean;
     forms?: boolean;
     scroll?: boolean;
     storage?: boolean;
 };
+declare function cleanupPage(page: Page, config: CleanupConfig): Promise<void>;
 declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
-    autoCleanup: CleanupConfig;
     screenshotOnFailure: boolean;
-    _autoCleanup: void;
     _autoScreenshot: void;
 }, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
-export { test, expect };
+export { test, expect, cleanupPage };
 //# sourceMappingURL=specs-base.d.ts.map

package/dist/orchestrator/templates/specs-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"specs-base.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/templates/specs-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGxD,KAAK,aAAa,GAAG;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAOF,QAAA,MAAM,IAAI;iBACK,aAAa;yBACL,OAAO;kBACd,IAAI;qBACD,IAAI;wGA6GrB,CAAC;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"specs-base.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/templates/specs-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEnE,KAAK,aAAa,GAAG;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,iBAAe,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmD3E;AAED,QAAA,MAAM,IAAI;yBACa,OAAO;qBACX,IAAI;wGAwBrB,CAAC;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC"}

package/dist/orchestrator/templates/specs-base.js

@@ -1,103 +1,72 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.expect = exports.test = void 0;
+exports.cleanupPage = cleanupPage;
 const test_1 = require("@playwright/test");
 Object.defineProperty(exports, "expect", { enumerable: true, get: function () { return test_1.expect; } });
-// Share one context per storageState — avoids creating multiple sessions
-// that trigger server rate limiting or session invalidation
-const contextCache = new Map();
-const GOTO_PATCHED = Symbol('goto-patched');
+async function cleanupPage(page, config) {
+    if (config.overlay) {
+        await page.keyboard.press('Escape').catch(() => { });
+        await page.locator('body').click({ position: { x: 1, y: 1 }, force: true }).catch(() => { });
+        const hasOverlay = await page.evaluate(`(() => {
+      const el = document.elementFromPoint(window.innerWidth / 2, window.innerHeight / 2);
+      if (!el) return false;
+      let current = el;
+      while (current && current !== document.body) {
+        if (getComputedStyle(current).position === 'fixed') return true;
+        current = current.parentElement;
+      }
+      return false;
+    })()`).catch(() => false);
+        if (hasOverlay) {
+            await page.keyboard.press('Escape').catch(() => { });
+        }
+    }
+    if (config.forms) {
+        await page.evaluate(`(() => {
+      const inputSetter = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value')?.set;
+      const textareaSetter = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value')?.set;
+      document.querySelectorAll('input:not([type=hidden]):not([type=submit]):not([type=checkbox]):not([type=radio])').forEach(el => {
+        inputSetter?.call(el, '');
+        el.dispatchEvent(new Event('input', { bubbles: true }));
+        el.dispatchEvent(new Event('change', { bubbles: true }));
+      });
+      document.querySelectorAll('textarea').forEach(el => {
+        textareaSetter?.call(el, '');
+        el.dispatchEvent(new Event('input', { bubbles: true }));
+        el.dispatchEvent(new Event('change', { bubbles: true }));
+      });
+      document.querySelectorAll('select').forEach(el => {
+        el.selectedIndex = 0;
+        el.dispatchEvent(new Event('change', { bubbles: true }));
+      });
+      document.querySelectorAll('input[type=checkbox]').forEach(el => {
+        if (el.checked !== el.defaultChecked) {
+          el.checked = el.defaultChecked;
+          el.dispatchEvent(new Event('change', { bubbles: true }));
+        }
+      });
+      document.querySelectorAll('form').forEach(f => f.reset());
+    })()`).catch(() => { });
+    }
+    if (config.scroll) {
+        await page.evaluate('window.scrollTo(0, 0)').catch(() => { });
+    }
+    if (config.storage) {
+        await page.evaluate('sessionStorage.clear()').catch(() => { });
+    }
+}
 const test = test_1.test.extend({
-    autoCleanup: [{}, { option: true }],
     screenshotOnFailure: [false, { option: true }],
     page: async ({ browser, storageState }, use) => {
-        if (storageState) {
-            const cacheKey = typeof storageState === 'string' ? storageState : JSON.stringify(storageState);
-            let cached = contextCache.get(cacheKey);
-            if (!cached) {
-                const context = await browser.newContext({ storageState });
-                const page = await context.newPage();
-                cached = { context, page };
-                contextCache.set(cacheKey, cached);
-            }
-            const page = cached.page;
-            // Patch goto once: skip navigation if already on the target path
-            if (!page[GOTO_PATCHED]) {
-                const originalGoto = page.goto.bind(page);
-                page.goto = async function (url, options) {
-                    try {
-                        const currentPath = new URL(page.url()).pathname;
-                        if (currentPath === url || currentPath === url + '/') {
-                            const hasOverlay = await page.evaluate(`(() => {
-                const el = document.elementFromPoint(window.innerWidth / 2, window.innerHeight / 2);
-                if (!el) return false;
-                let current = el;
-                while (current && current !== document.body) {
-                  if (getComputedStyle(current).position === 'fixed') return true;
-                  current = current.parentElement;
-                }
-                return false;
-              })()`).catch(() => true);
-                            if (hasOverlay) {
-                                return originalGoto(url, options);
-                            }
-                            return null;
-                        }
-                    }
-                    catch {
-                        // page.url() might be about:blank on first run
-                    }
-                    return originalGoto(url, options);
-                };
-                page[GOTO_PATCHED] = true;
-            }
-            await use(page);
-        }
-        else {
-            // No storageState: fresh context (e.g., unauthenticated tests)
-            const context = await browser.newContext();
-            const page = await context.newPage();
-            await use(page);
-            await page.close();
-            await context.close();
-        }
+        const context = storageState
+            ? await browser.newContext({ storageState })
+            : await browser.newContext();
+        const page = await context.newPage();
+        await use(page);
+        await page.close();
+        await context.close();
     },
-    // Auto-cleanup fixture: runs teardown after each test based on @cleanup:* tags
-    _autoCleanup: [async ({ page, autoCleanup }, use) => {
-            await use();
-            if (autoCleanup.overlay) {
-                await page.keyboard.press('Escape').catch(() => { });
-                await page.locator('body').click({ position: { x: 1, y: 1 }, force: true }).catch(() => { });
-                // Dismiss persistent fixed overlays (modals, dialogs)
-                const hasOverlay = await page.evaluate(`(() => {
-        const el = document.elementFromPoint(window.innerWidth / 2, window.innerHeight / 2);
-        if (!el) return false;
-        let current = el;
-        while (current && current !== document.body) {
-          if (getComputedStyle(current).position === 'fixed') return true;
-          current = current.parentElement;
-        }
-        return false;
-      })()`).catch(() => false);
-                if (hasOverlay) {
-                    await page.keyboard.press('Escape').catch(() => { });
-                }
-            }
-            if (autoCleanup.forms) {
-                await page.evaluate(`(() => {
-        document.querySelectorAll('input:not([type=hidden]):not([type=submit])').forEach(el => { el.value = ''; });
-        document.querySelectorAll('textarea').forEach(el => { el.value = ''; });
-        document.querySelectorAll('select').forEach(el => { el.selectedIndex = 0; });
-      })()`).catch(() => { });
-            }
-            if (autoCleanup.scroll) {
-                await page.evaluate('window.scrollTo(0, 0)').catch(() => { });
-            }
-            if (autoCleanup.storage) {
-                await page.evaluate('sessionStorage.clear()').catch(() => { });
-            }
-        }, { auto: true }],
-    // Auto-screenshot fixture: captures screenshot on test failure
     _autoScreenshot: [async ({ page, screenshotOnFailure }, use, testInfo) => {
             await use();
             if (screenshotOnFailure && testInfo.status !== testInfo.expectedStatus) {

package/dist/orchestrator/templates/specs-base.js.map

@@ -1 +1 @@
-{"version":3,"file":"specs-base.js","sourceRoot":"","sources":["../../../src/orchestrator/templates/specs-base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"specs-base.js","sourceRoot":"","sources":["../../../src/orchestrator/templates/specs-base.ts"],"names":[],"mappings":";;;AA0FuB,kCAAW;AA1FlC,2CAAmE;AA0FpD,uFA1FQ,aAAM,OA0FR;AAjFrB,KAAK,UAAU,WAAW,CAAC,IAAU,EAAE,MAAqB;IAC1D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5F,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;;;;SASlC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;SAwBf,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAG,WAAI,CAAC,MAAM,CAGrB;IACD,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAE9C,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE;QAC7C,MAAM,OAAO,GAAG,YAAY;YAC1B,CAAC,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;YAC5C,CAAC,CAAC,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE;YACvE,MAAM,GAAG,EAAE,CAAC;YAEZ,IAAI,mBAAmB,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,cAAc,EAAE,CAAC;gBACvE,MAAM,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE;oBAClC,IAAI,EAAE,MAAM,IAAI,CAAC,UAAU,EAAE;oBAC7B,WAAW,EAAE,WAAW;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;CACnB,CAAC,CAAC;AAEM,oBAAI"}

package/dist/orchestrator/templates/specs-base.ts

@@ -1,5 +1,4 @@
-import { test as base, expect } from '@playwright/test';
-import type { BrowserContext, Page } from '@playwright/test';
+import { test as base, expect, type Page } from '@playwright/test';
 
 type CleanupConfig = {
   overlay?: boolean;
@@ -8,114 +7,75 @@ type CleanupConfig = {
   storage?: boolean;
 };
 
-// Share one context per storageState — avoids creating multiple sessions
-// that trigger server rate limiting or session invalidation
-const contextCache = new Map<string, { context: BrowserContext; page: Page }>();
-const GOTO_PATCHED = Symbol('goto-patched');
+async function cleanupPage(page: Page, config: CleanupConfig): Promise<void> {
+  if (config.overlay) {
+    await page.keyboard.press('Escape').catch(() => {});
+    await page.locator('body').click({ position: { x: 1, y: 1 }, force: true }).catch(() => {});
+    const hasOverlay = await page.evaluate(`(() => {
+      const el = document.elementFromPoint(window.innerWidth / 2, window.innerHeight / 2);
+      if (!el) return false;
+      let current = el;
+      while (current && current !== document.body) {
+        if (getComputedStyle(current).position === 'fixed') return true;
+        current = current.parentElement;
+      }
+      return false;
+    })()`).catch(() => false);
+    if (hasOverlay) {
+      await page.keyboard.press('Escape').catch(() => {});
+    }
+  }
+  if (config.forms) {
+    await page.evaluate(`(() => {
+      const inputSetter = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value')?.set;
+      const textareaSetter = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value')?.set;
+      document.querySelectorAll('input:not([type=hidden]):not([type=submit]):not([type=checkbox]):not([type=radio])').forEach(el => {
+        inputSetter?.call(el, '');
+        el.dispatchEvent(new Event('input', { bubbles: true }));
+        el.dispatchEvent(new Event('change', { bubbles: true }));
+      });
+      document.querySelectorAll('textarea').forEach(el => {
+        textareaSetter?.call(el, '');
+        el.dispatchEvent(new Event('input', { bubbles: true }));
+        el.dispatchEvent(new Event('change', { bubbles: true }));
+      });
+      document.querySelectorAll('select').forEach(el => {
+        el.selectedIndex = 0;
+        el.dispatchEvent(new Event('change', { bubbles: true }));
+      });
+      document.querySelectorAll('input[type=checkbox]').forEach(el => {
+        if (el.checked !== el.defaultChecked) {
+          el.checked = el.defaultChecked;
+          el.dispatchEvent(new Event('change', { bubbles: true }));
+        }
+      });
+      document.querySelectorAll('form').forEach(f => f.reset());
+    })()`).catch(() => {});
+  }
+  if (config.scroll) {
+    await page.evaluate('window.scrollTo(0, 0)').catch(() => {});
+  }
+  if (config.storage) {
+    await page.evaluate('sessionStorage.clear()').catch(() => {});
+  }
+}
 
 const test = base.extend<{
-  autoCleanup: CleanupConfig;
   screenshotOnFailure: boolean;
-  _autoCleanup: void;
   _autoScreenshot: void;
 }>({
-  autoCleanup: [{}, { option: true }],
   screenshotOnFailure: [false, { option: true }],
 
   page: async ({ browser, storageState }, use) => {
-    if (storageState) {
-      const cacheKey = typeof storageState === 'string' ? storageState : JSON.stringify(storageState);
-
-      let cached = contextCache.get(cacheKey);
-      if (!cached) {
-        const context = await browser.newContext({ storageState });
-        const page = await context.newPage();
-        cached = { context, page };
-        contextCache.set(cacheKey, cached);
-      }
-
-      const page = cached.page;
-
-      // Patch goto once: skip navigation if already on the target path
-      if (!(page as any)[GOTO_PATCHED]) {
-        const originalGoto = page.goto.bind(page);
-        page.goto = async function (url: string, options?: any) {
-          try {
-            const currentPath = new URL(page.url()).pathname;
-            if (currentPath === url || currentPath === url + '/') {
-              const hasOverlay = await page.evaluate(`(() => {
-                const el = document.elementFromPoint(window.innerWidth / 2, window.innerHeight / 2);
-                if (!el) return false;
-                let current = el;
-                while (current && current !== document.body) {
-                  if (getComputedStyle(current).position === 'fixed') return true;
-                  current = current.parentElement;
-                }
-                return false;
-              })()`).catch(() => true);
-
-              if (hasOverlay) {
-                return originalGoto(url, options);
-              }
-              return null as any;
-            }
-          } catch {
-            // page.url() might be about:blank on first run
-          }
-          return originalGoto(url, options);
-        };
-        (page as any)[GOTO_PATCHED] = true;
-      }
-
-      await use(page);
-    } else {
-      // No storageState: fresh context (e.g., unauthenticated tests)
-      const context = await browser.newContext();
-      const page = await context.newPage();
-      await use(page);
-      await page.close();
-      await context.close();
-    }
+    const context = storageState
+      ? await browser.newContext({ storageState })
+      : await browser.newContext();
+    const page = await context.newPage();
+    await use(page);
+    await page.close();
+    await context.close();
   },
 
-  // Auto-cleanup fixture: runs teardown after each test based on @cleanup:* tags
-  _autoCleanup: [async ({ page, autoCleanup }, use) => {
-    await use();
-
-    if (autoCleanup.overlay) {
-      await page.keyboard.press('Escape').catch(() => {});
-      await page.locator('body').click({ position: { x: 1, y: 1 }, force: true }).catch(() => {});
-      // Dismiss persistent fixed overlays (modals, dialogs)
-      const hasOverlay = await page.evaluate(`(() => {
-        const el = document.elementFromPoint(window.innerWidth / 2, window.innerHeight / 2);
-        if (!el) return false;
-        let current = el;
-        while (current && current !== document.body) {
-          if (getComputedStyle(current).position === 'fixed') return true;
-          current = current.parentElement;
-        }
-        return false;
-      })()`).catch(() => false);
-      if (hasOverlay) {
-        await page.keyboard.press('Escape').catch(() => {});
-      }
-    }
-    if (autoCleanup.forms) {
-      await page.evaluate(`(() => {
-        document.querySelectorAll('input:not([type=hidden]):not([type=submit])').forEach(el => { el.value = ''; });
-        document.querySelectorAll('textarea').forEach(el => { el.value = ''; });
-        document.querySelectorAll('select').forEach(el => { el.selectedIndex = 0; });
-      })()`).catch(() => {});
-    }
-    if (autoCleanup.scroll) {
-      await page.evaluate('window.scrollTo(0, 0)').catch(() => {});
-    }
-    if (autoCleanup.storage) {
-      await page.evaluate('sessionStorage.clear()').catch(() => {});
-    }
-  }, { auto: true }],
-
-  // Auto-screenshot fixture: captures screenshot on test failure
   _autoScreenshot: [async ({ page, screenshotOnFailure }, use, testInfo) => {
     await use();
 
@@ -128,4 +88,4 @@ const test = base.extend<{
   }, { auto: true }],
 });
 
-export { test, expect };
+export { test, expect, cleanupPage };

package/dist/orchestrator/templates/specs-test-data.d.ts

@@ -2,11 +2,13 @@ export declare class TestDataLoader {
     private data;
     private constructor();
     /**
-     * Load test data for a screen/feature combination.
+     * Load test data for a screen/feature or flow/feature combination.
      *
      * Priority (later wins):
      * 1. {feature}.yaml — base data
      * 2. {feature}.{SUNGEN_ENV}.yaml — environment-specific (if SUNGEN_ENV set)
+     *
+     * Paths: screenName starting with "flows/" loads from qa/flows/, otherwise qa/screens/
      */
     static load(screenName: string, featureName: string): TestDataLoader;
     get(key: string): string;

package/dist/orchestrator/templates/specs-test-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"specs-test-data.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/templates/specs-test-data.ts"],"names":[],"mappings":"AAIA,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAsB;IAElC,OAAO;IAIP;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc;IAcpE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAczB"}
+{"version":3,"file":"specs-test-data.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/templates/specs-test-data.ts"],"names":[],"mappings":"AAKA,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAsB;IAElC,OAAO;IAIP;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc;IAqBpE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAczB"}