@torus-engineering/tas-kit 1.13.0 → 2.1.0

package/.tas/commands/tas-e2e-mobile.md

@@ -1,155 +1,146 @@
-# /tas-e2e-mobile $ARGUMENTS
-
-Role: SE / QA
-Generate Detox E2E test scripts from an E2E Scenario markdown file.
-
-## IMPORTANT - Layer 3: Mobile E2E Scripts
-- Create Detox test scripts from E2E-Scenario (markdown)
-- Scripts located in `apps/mobile/e2e/flows/`
-- REUSE helpers from Layer 2 functional tests (features/)
-- Chain functional test steps into end-to-end flows
-
-## Actions
-
-### Step 1: Identify Scenario
-1. $ARGUMENTS is path to E2E-Scenario-*.md file
-2. If not provided: scan `docs/epics/**/E2E-Scenario-*.md` and `docs/e2e-scenarios/E2E-Scenario-*.md`
-3. List scenarios and ask user to choose
-
-### Step 2: Check Prerequisites
-1. Check `apps/mobile/` exists. If not → graceful error
-2. Read scenario file to get:
-   - Scenario steps and flow
-   - FT ID references ("Builds on FT IDs" column)
-   - FT Reuse Map (section at end)
-   - Test data per environment
-   - Scenario type (single-epic / cross-epic)
-
-### Step 3: Find Functional Test Helpers
-From FT Reuse Map in scenario:
-1. Find each source file in `apps/mobile/e2e/features/`
-2. Verify helper functions exist
-3. If helper doesn't exist → create stub and note "TODO: implement helper"
-4. Import map: FT ID → file path → function name
-
-### Step 4: Generate E2E Script
-
-**File output**: `apps/mobile/e2e/flows/{scenario-slug}.e2e.ts`
-
-**Structure**:
-```typescript
-/**
- * E2E Flow: {Scenario Name}
- * Scenario: {Scenario_ID}
- * Epic(s): {Epic_ID(s)}
- * Type: {single-epic | cross-epic}
- * 
- * Generated by /tas-e2e-mobile
- * Spec: {path to E2E-Scenario-*.md}
- */
-
-import { device, element, expect, by, waitFor } from 'detox';
-import { TEST_IDS } from '../test-ids';
-import { loadTestData, getCredentials } from '../helpers/data-loader';
-import { login, logout, navigateToTab } from '../helpers/test-utils';
-
-// Layer 2 helpers (reuse from functional tests)
-import { fillLoginForm, verifyLoginSuccess } from '../features/{epic}/{feature}/helpers';
-import { viewAllergenList } from '../features/{epic2}/{feature2}/helpers';
-
-const testData = loadTestData();
-
-describe('E2E Flow: {Scenario Name}', () => {
-  beforeAll(async () => {
-    await device.launchApp({ newInstance: true });
-  });
-
-  // Main Flow
-  describe('{PROJECT}_E{EPIC}_E2E_001_H: {Flow Title}', () => {
-    it('Step 1: {Action}', async () => {
-      // Reuses: AL_E002_F002_S001_FT_001_H
-      const creds = getCredentials();
-      await fillLoginForm(creds.email, creds.password);
-      await verifyLoginSuccess();
-    });
-
-    it('Step 2: {Action}', async () => {
-      // Reuses: AL_E003_F001_S001_FT_001_H
-      await viewAllergenList();
-    });
-
-    it('Step 3: {New logic - no FT reference}', async () => {
-      // New step: no functional test helper exists
-      await element(by.id(TEST_IDS.SCAN.SCREEN.CAMERA)).tap();
-      // ...
-    });
-  });
-
-  // Alternate Flow (if defined in scenario)
-  describe('{PROJECT}_E{EPIC}_E2E_002_N: {Alternate Flow}', () => {
-    it('should handle {error condition}', async () => {
-      // ...
-    });
-  });
-});
-```
-
-### Step 5: Update package.json Script
-Add or update script in `apps/mobile/package.json`:
-```json
-"e2e:flow:{scenario-slug}": "detox test --configuration ios.sim.debug --testPathPattern='e2e/flows/{scenario-slug}'"
-```
-
-### Step 6: Generate Execution Report (Optional)
-After running tests, generate report from `.tas/templates/E2E-Execution-Report.md`:
-- Summary metrics (passed/failed/skipped)
-- Results by test ID
-- Failed test details
-- Performance metrics
-- AC coverage analysis
-
-## File Structure Output
-```
-apps/mobile/e2e/flows/
-├── {scenario-1-slug}.e2e.ts
-├── {scenario-2-slug}.e2e.ts
-└── ...
-```
-
-## Reuse Strategy
-```
-Layer 2 (features/)          Layer 3 (flows/)
-┌───────────────────┐       ┌──────────────────────┐
-│ helpers.ts        │──────>│ {scenario}.e2e.ts     │
-│  - fillLoginForm()│       │  import { fillLogin } │
-│  - verifyLogin()  │       │  import { viewList }  │
-└───────────────────┘       │                      │
-┌───────────────────┐       │  Step 1: fillLogin() │
-│ helpers.ts        │──────>│  Step 2: viewList()  │
-│  - viewList()     │       │  Step 3: new logic   │
-└───────────────────┘       └──────────────────────┘
-```
-
-## Run Tests
-```bash
-# Run specific E2E flow
-yarn e2e:flow:{scenario-slug}
-
-# Run all E2E flows
-npx detox test --configuration ios.sim.debug --testPathPattern='e2e/flows/'
-
-# Run with Android
-npx detox test --configuration android.emu.debug --testPathPattern='e2e/flows/{scenario}'
-
-# Run and generate report
-npx detox test --configuration ios.sim.debug --testPathPattern='e2e/flows/{scenario}' --reporters=jest-junit
-```
-
-## Principles
-- MUST reuse helpers from Layer 2 when possible, DO NOT rewrite existing logic
-- Each step in E2E flow should correspond to 1 functional test helper
-- Steps without FT reference → write new logic in flow file
-- Scripts MUST be runnable from CLI, WITHOUT Claude window
-- If apps/mobile/ doesn't exist → graceful error
-- describe block uses full E2E ID for grep-ability
-- import paths: relative from flows/ up to features/
+---
+model: sonnet
+---
+
+# /tas-e2e-mobile $ARGUMENTS
+
+Role: SE / QA
+Generate Detox E2E test scripts from an E2E Scenario markdown file.
+
+## IMPORTANT — Layer 3: Mobile E2E Scripts
+- Create Detox test scripts from E2E-Scenario (markdown)
+- Scripts located in `apps/mobile/e2e/flows/`
+- REUSE helpers from Layer 2 functional tests (`features/`)
+- Chain functional test steps into end-to-end flows
+
+## Actions
+
+### Step 1: Identify Scenario
+1. `$ARGUMENTS` is path to `E2E-Scenario-*.md`
+2. If not provided: scan `docs/e2e-scenarios/E2E-Scenario-*.md`
+3. List scenarios and ask user to pick
+
+### Step 2: Check Prerequisites
+1. Check `apps/mobile/` exists. If not → graceful error.
+2. Read scenario file to get:
+   - Scenario steps and flow
+   - FT ID references ("Builds on FT IDs" column)
+   - FT Reuse Map (section at end)
+   - Test data per environment
+   - Scenario type (single-stack / cross-stack)
+
+### Step 3: Find Functional Test Helpers
+From FT Reuse Map:
+1. Find each source file in `apps/mobile/e2e/features/`
+2. Verify helper functions exist
+3. If helper missing → create stub with `// TODO: implement helper`
+4. Build import map: FT ID → file path → function name
+
+### Step 4: Generate E2E Script
+
+**File output**: `apps/mobile/e2e/flows/{scenario-slug}.e2e.ts`
+
+**Structure**:
+```typescript
+/**
+ * E2E Flow: {Scenario Name}
+ * Scenario: {Scenario_ID}
+ * Features: {Feature_IDs comma-separated}
+ * Type: {single-stack | cross-stack}
+ *
+ * Generated by /tas-e2e-mobile
+ * Spec: {path to E2E-Scenario-*.md}
+ */
+
+import { device, element, expect, by, waitFor } from 'detox';
+import { TEST_IDS } from '../test-ids';
+import { loadTestData, getCredentials } from '../helpers/data-loader';
+import { login, logout, navigateToTab } from '../helpers/test-utils';
+
+// Layer 2 helpers (reuse from functional tests)
+import { fillLoginForm, verifyLoginSuccess } from '../features/{feature-slug}/helpers';
+import { viewList } from '../features/{feature-slug-2}/helpers';
+
+const testData = loadTestData();
+
+describe('E2E Flow: {Scenario Name}', () => {
+  beforeAll(async () => {
+    await device.launchApp({ newInstance: true });
+  });
+
+  // Main Flow
+  describe('{PROJECT}_E2E_001_H: {Flow Title}', () => {
+    it('Step 1: {Action}', async () => {
+      // Reuses: AL_F002_AC1_FT_001_H
+      const creds = getCredentials();
+      await fillLoginForm(creds.email, creds.password);
+      await verifyLoginSuccess();
+    });
+
+    it('Step 2: {Action}', async () => {
+      // Reuses: AL_F003_AC1_FT_001_H
+      await viewList();
+    });
+
+    it('Step 3: {New logic - no FT reference}', async () => {
+      await element(by.id(TEST_IDS.SCAN.SCREEN.CAMERA)).tap();
+    });
+  });
+
+  // Alternate Flow
+  describe('{PROJECT}_E2E_002_N: {Alternate Flow}', () => {
+    it('should handle {error condition}', async () => {});
+  });
+});
+```
+
+### Step 5: Update package.json Script
+```json
+"e2e:flow:{scenario-slug}": "detox test --configuration ios.sim.debug --testPathPattern='e2e/flows/{scenario-slug}'"
+```
+
+### Step 6: Generate Execution Report (Optional)
+After running, generate from `.tas/templates/E2E-Execution-Report.md`:
+- Summary metrics
+- Results by test ID
+- Failed test details
+- Performance metrics
+- AC coverage analysis
+
+## File Structure Output
+```
+apps/mobile/e2e/flows/
+├── {scenario-1-slug}.e2e.ts
+├── {scenario-2-slug}.e2e.ts
+└── ...
+```
+
+## Reuse Strategy
+```
+Layer 2 (features/)          Layer 3 (flows/)
+┌───────────────────┐       ┌──────────────────────┐
+│ helpers.ts        │──────>│ {scenario}.e2e.ts    │
+│  - fillLoginForm()│       │  import { fillLogin }│
+│  - verifyLogin()  │       │  import { viewList } │
+└───────────────────┘       │                      │
+┌───────────────────┐       │  Step 1: fillLogin() │
+│ helpers.ts        │──────>│  Step 2: viewList()  │
+│  - viewList()     │       │  Step 3: new logic   │
+└───────────────────┘       └──────────────────────┘
+```
+
+## Run Tests
+```bash
+yarn e2e:flow:{scenario-slug}
+npx detox test --configuration ios.sim.debug --testPathPattern='e2e/flows/'
+npx detox test --configuration android.emu.debug --testPathPattern='e2e/flows/{scenario}'
+```
+
+## Principles
+- MUST reuse helpers from Layer 2 when possible
+- Each step in E2E flow should correspond to 1 functional test helper
+- Steps without FT reference → write new logic in flow file
+- Scripts MUST be runnable from CLI
+- If `apps/mobile/` doesn't exist → graceful error
+- describe block uses full E2E ID for grep-ability
+- Import paths: relative from `flows/` up to `features/`

package/.tas/commands/tas-e2e-web.md

@@ -1,163 +1,150 @@
-# /tas-e2e-web $ARGUMENTS
-
-Role: SE / QA
-Generate Playwright E2E test scripts from an E2E Scenario markdown file.
-
-## IMPORTANT - Layer 3: Web E2E Scripts
-- Create Playwright test scripts from E2E-Scenario (markdown)
-- Scripts located in `apps/web/e2e/flows/`
-- REUSE helpers from Layer 2 functional tests (features/)
-- Cross-browser testing (Chromium, Firefox, WebKit)
-- Chain functional test steps into end-to-end flows
-
-## Actions
-
-### Step 1: Identify Scenario
-1. $ARGUMENTS is path to E2E-Scenario-*.md file
-2. If not provided: scan `docs/epics/**/E2E-Scenario-*.md` and `docs/e2e-scenarios/E2E-Scenario-*.md`
-3. List scenarios and ask user to choose
-
-### Step 2: Check Prerequisites
-1. Check `apps/web/` exists. If not → report:
-   > "Web app doesn't exist in this project. If project only has mobile, use /tas-e2e-mobile."
-   > STOP, DO NOT create file.
-2. Read scenario file to get:
-   - Scenario steps and flow
-   - FT ID references
-   - FT Reuse Map
-   - Test data per environment
-3. Read `apps/web/playwright.config.ts` (if exists)
-
-### Step 3: Find Functional Test Helpers
-From FT Reuse Map in scenario:
-1. Find source files in `apps/web/e2e/features/`
-2. Verify helper functions and page objects exist
-3. If helper doesn't exist → create stub and note "TODO: implement helper"
-4. Import map: FT ID → file path → function name
-
-### Step 4: Generate E2E Script
-
-**File output**: `apps/web/e2e/flows/{scenario-slug}.spec.ts`
-
-**Structure**:
-```typescript
-/**
- * E2E Flow: {Scenario Name}
- * Scenario: {Scenario_ID}
- * Epic(s): {Epic_ID(s)}
- * Type: {single-epic | cross-epic}
- * 
- * Generated by /tas-e2e-web
- * Spec: {path to E2E-Scenario-*.md}
- */
-
-import { test, expect, Page } from '@playwright/test';
-import { loadTestData, getCredentials } from '../helpers/data-loader';
-
-// Layer 2 helpers (reuse from functional tests)
-import { fillLoginForm, verifyLoginSuccess } from '../features/{epic}/{feature}/helpers';
-import { viewAllergenList } from '../features/{epic2}/{feature2}/helpers';
-
-const testData = loadTestData();
-
-test.describe('E2E Flow: {Scenario Name}', () => {
-  test.beforeEach(async ({ page }) => {
-    await page.goto(testData.baseUrl);
-  });
-
-  // Main Flow
-  test.describe('{PROJECT}_E{EPIC}_E2E_001_H: {Flow Title}', () => {
-    test('Complete flow', async ({ page }) => {
-      // Step 1: Login (reuses AL_E002_F002_S001_FT_001_H)
-      const creds = getCredentials();
-      await fillLoginForm(page, creds.email, creds.password);
-      await verifyLoginSuccess(page);
-
-      // Step 2: View allergen list (reuses AL_E003_F001_S001_FT_001_H)
-      await viewAllergenList(page);
-
-      // Step 3: New logic (no FT reference)
-      await page.getByTestId('scan-button').click();
-      await expect(page.getByTestId('scan-result')).toBeVisible();
-    });
-  });
-
-  // Cross-browser validation
-  test.describe('{PROJECT}_E{EPIC}_E2E_001_H - Cross-browser', () => {
-    test('should complete flow on all browsers', async ({ page, browserName }) => {
-      test.info().annotations.push({ type: 'browser', description: browserName });
-      // Same flow, validated across browsers via Playwright projects config
-    });
-  });
-
-  // Alternate/Error flows
-  test.describe('{PROJECT}_E{EPIC}_E2E_002_N: {Error Flow}', () => {
-    test('should handle {error condition}', async ({ page }) => {
-      // ...
-    });
-  });
-});
-```
-
-### Step 5: Update package.json Script
-Add or update script in `apps/web/package.json`:
-```json
-"e2e:flow:{scenario-slug}": "npx playwright test e2e/flows/{scenario-slug}"
-```
-
-### Step 6: Generate Execution Report (Optional)
-From `.tas/templates/E2E-Execution-Report.md`:
-- Include browser-specific results
-- Viewport testing results
-- Performance metrics (LCP, INP, CLS)
-
-## File Structure Output
-```
-apps/web/e2e/flows/
-├── {scenario-1-slug}.spec.ts
-├── {scenario-2-slug}.spec.ts
-└── ...
-```
-
-## Reuse Strategy
-```
-Layer 2 (features/)          Layer 3 (flows/)
-┌───────────────────┐       ┌──────────────────────────┐
-│ helpers.ts        │──────>│ {scenario}.spec.ts        │
-│  - fillLogin(page)│       │  import { fillLogin }     │
-│  - verify(page)   │       │  import { viewList }      │
-└───────────────────┘       │                          │
-┌───────────────────┐       │  Step 1: fillLogin(page) │
-│ helpers.ts        │──────>│  Step 2: viewList(page)  │
-│  - viewList(page) │       │  Step 3: new logic       │
-└───────────────────┘       └──────────────────────────┘
-```
-
-Note: Web helpers receive `page: Page` parameter (unlike mobile using global Detox API).
-
-## Run Tests
-```bash
-# Run specific E2E flow
-yarn e2e:flow:{scenario-slug}
-
-# Run all E2E flows
-npx playwright test e2e/flows/
-
-# Run only on Firefox
-npx playwright test --project=firefox e2e/flows/{scenario}
-
-# Run with debug UI
-npx playwright test --ui e2e/flows/{scenario}
-
-# Run and generate HTML report
-npx playwright test e2e/flows/{scenario} --reporter=html
-```
-
-## Principles
-- MUST reuse helpers from Layer 2 when possible
-- Web helpers MUST receive `page: Page` parameter (dependency injection)
-- Scripts MUST be runnable from CLI
-- If apps/web/ doesn't exist → graceful error, DO NOT create
-- Cross-browser: Chromium, Firefox, WebKit (from playwright.config.ts)
-- describe block uses full E2E ID
-- import paths: relative from flows/ up to features/
+---
+model: sonnet
+---
+
+# /tas-e2e-web $ARGUMENTS
+
+Role: SE / QA
+Generate Playwright E2E test scripts from an E2E Scenario markdown file.
+
+## IMPORTANT — Layer 3: Web E2E Scripts
+- Create Playwright test scripts from E2E-Scenario (markdown)
+- Scripts located in `apps/web/e2e/flows/`
+- REUSE helpers from Layer 2 functional tests (`features/`)
+- Cross-browser testing (Chromium, Firefox, WebKit)
+- Chain functional test steps into end-to-end flows
+
+## Actions
+
+### Step 1: Identify Scenario
+1. `$ARGUMENTS` is path to `E2E-Scenario-*.md`
+2. If not provided: scan `docs/e2e-scenarios/E2E-Scenario-*.md`
+3. List scenarios and ask user to pick
+
+### Step 2: Check Prerequisites
+1. Check `apps/web/` exists. If not → report:
+   > "Web app doesn't exist. If project only has mobile, use `/tas-e2e-mobile`."
+   > STOP, DO NOT create file.
+2. Read scenario file to get steps, FT references, FT Reuse Map, test data, scenario type.
+3. Read `apps/web/playwright.config.ts` (if exists)
+
+### Step 3: Find Functional Test Helpers
+From FT Reuse Map:
+1. Find source files in `apps/web/e2e/features/`
+2. Verify helper functions and page objects exist
+3. If helper missing → create stub with `// TODO: implement helper`
+4. Build import map: FT ID → file path → function name
+
+### Step 4: Generate E2E Script
+
+**File output**: `apps/web/e2e/flows/{scenario-slug}.spec.ts`
+
+**Structure**:
+```typescript
+/**
+ * E2E Flow: {Scenario Name}
+ * Scenario: {Scenario_ID}
+ * Features: {Feature_IDs comma-separated}
+ * Type: {single-stack | cross-stack}
+ *
+ * Generated by /tas-e2e-web
+ * Spec: {path to E2E-Scenario-*.md}
+ */
+
+import { test, expect, Page } from '@playwright/test';
+import { loadTestData, getCredentials } from '../helpers/data-loader';
+
+// Layer 2 helpers (reuse from functional tests)
+import { fillLoginForm, verifyLoginSuccess } from '../features/{feature-slug}/helpers';
+import { viewList } from '../features/{feature-slug-2}/helpers';
+
+const testData = loadTestData();
+
+test.describe('E2E Flow: {Scenario Name}', () => {
+  test.beforeEach(async ({ page }) => {
+    await page.goto(testData.baseUrl);
+  });
+
+  // Main Flow
+  test.describe('{PROJECT}_E2E_001_H: {Flow Title}', () => {
+    test('Complete flow', async ({ page }) => {
+      // Step 1: Login (reuses AL_F002_AC1_FT_001_H)
+      const creds = getCredentials();
+      await fillLoginForm(page, creds.email, creds.password);
+      await verifyLoginSuccess(page);
+
+      // Step 2: View list (reuses AL_F003_AC1_FT_001_H)
+      await viewList(page);
+
+      // Step 3: New logic (no FT reference)
+      await page.getByTestId('scan-button').click();
+      await expect(page.getByTestId('scan-result')).toBeVisible();
+    });
+  });
+
+  // Cross-browser validation
+  test.describe('{PROJECT}_E2E_001_H - Cross-browser', () => {
+    test('should complete flow on all browsers', async ({ page, browserName }) => {
+      test.info().annotations.push({ type: 'browser', description: browserName });
+    });
+  });
+
+  // Alternate / Error flows
+  test.describe('{PROJECT}_E2E_002_N: {Error Flow}', () => {
+    test('should handle {error condition}', async ({ page }) => {});
+  });
+});
+```
+
+### Step 5: Update package.json Script
+```json
+"e2e:flow:{scenario-slug}": "npx playwright test e2e/flows/{scenario-slug}"
+```
+
+### Step 6: Generate Execution Report (Optional)
+From `.tas/templates/E2E-Execution-Report.md`:
+- Browser-specific results
+- Viewport testing results
+- Performance metrics (LCP, INP, CLS)
+
+## File Structure Output
+```
+apps/web/e2e/flows/
+├── {scenario-1-slug}.spec.ts
+├── {scenario-2-slug}.spec.ts
+└── ...
+```
+
+## Reuse Strategy
+```
+Layer 2 (features/)          Layer 3 (flows/)
+┌───────────────────┐       ┌──────────────────────────┐
+│ helpers.ts        │──────>│ {scenario}.spec.ts        │
+│  - fillLogin(page)│       │  import { fillLogin }     │
+│  - verify(page)   │       │  import { viewList }      │
+└───────────────────┘       │                          │
+┌───────────────────┐       │  Step 1: fillLogin(page) │
+│ helpers.ts        │──────>│  Step 2: viewList(page)  │
+│  - viewList(page) │       │  Step 3: new logic       │
+└───────────────────┘       └──────────────────────────┘
+```
+
+Note: Web helpers receive `page: Page` parameter (unlike mobile using global Detox API).
+
+## Run Tests
+```bash
+yarn e2e:flow:{scenario-slug}
+npx playwright test e2e/flows/
+npx playwright test --project=firefox e2e/flows/{scenario}
+npx playwright test --ui e2e/flows/{scenario}
+npx playwright test e2e/flows/{scenario} --reporter=html
+```
+
+## Principles
+- MUST reuse helpers from Layer 2 when possible
+- Web helpers MUST receive `page: Page` parameter (dependency injection)
+- Scripts MUST be runnable from CLI
+- If `apps/web/` doesn't exist → graceful error
+- Cross-browser: Chromium, Firefox, WebKit
+- describe block uses full E2E ID
+- Import paths: relative from `flows/` up to `features/`