@sun-asterisk/sungen 1.0.24 → 2.0.0

package/README.md

@@ -1,19 +1,20 @@
-# Sungen - AI-Native E2E Test Generator
+# Sungen v2 — Deterministic E2E Test Compiler
 
-**Version**: 1.0.20
-**Deterministic-first E2E test generation**: Gherkin → Playwright tests
+**Version**: 2.0.0
+**Gherkin + Selector YAML + Test Data → Playwright .spec.ts**
 
 ---
 
 ## What is Sungen?
 
-Sungen generates Playwright tests from Gherkin features using **priority-based selector mapping**:
+Sungen is a deterministic compiler that converts Gherkin features into Playwright tests.
 
-1. **Direct ID** (`data-testid`) - instant, free, deterministic
-2. **Accessibility** (`role` + `aria-label`) - semantic fallback
-3. **AI Fallback** (Claude) - last resort only
+**v2 architecture**: AI generates the input files (Gherkin + selectors), sungen compiles to tests. No AI inside sungen itself.
 
-Goal: **90%+ Direct ID match** with minimal AI dependency.
+```
+AI (Copilot/Claude + MCP Playwright) → visits URL → generates files
+sungen generate → compiles .feature + selectors.yaml + data.yaml → .spec.ts
+```
 
 ---
 
@@ -23,12 +24,16 @@ Goal: **90%+ Direct ID match** with minimal AI dependency.
 # Install
 npm install -g @sun-asterisk/sungen@latest
 
-# Initialize project
+# Initialize project (creates AI rules + directory structure)
 sungen init
 
-# Create a screen, map selectors, generate tests
+# Create a screen
 sungen add --screen login --path /auth/login
-sungen map --screen login
+
+# Use AI to generate Gherkin + selectors from the live page
+# (GitHub Copilot / Claude Code reads the AI rules and generates files)
+
+# Compile to Playwright tests
 sungen generate --screen login
 
 # Run tests
@@ -37,11 +42,69 @@ npx playwright test
 
 ---
 
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `sungen init` | Scaffold project + generate AI rules |
+| `sungen add --screen <name> --path <path>` | Create screen with empty templates |
+| `sungen add --screen <name> --feature <name>` | Add feature file to existing screen |
+| `sungen generate --screen <name>` | Compile Gherkin → Playwright .spec.ts |
+| `sungen generate --all` | Compile all screens |
+| `sungen makeauth <role>` | Capture browser auth state (SSO support) |
+
+---
+
+## Workflow
+
+### 1. Add a screen
+
+```bash
+sungen add --screen awards --path /awards
+```
+
+Creates:
+```
+qa/screens/awards/
+├── features/awards.feature      # Gherkin template
+├── selectors/awards.yaml        # Selector YAML (page entry pre-filled)
+└── test-data/awards.yaml        # Test data (empty)
+```
+
+### 2. AI generates Gherkin + selectors
+
+Use your AI assistant (GitHub Copilot or Claude Code) with MCP Playwright to:
+1. Navigate to the page URL
+2. Take an accessibility snapshot
+3. Generate `.feature` + `selectors.yaml` + `test-data.yaml`
+
+The AI rules in `.github/copilot-instructions.md` and `CLAUDE.md` (created by `sungen init`) teach the AI the correct syntax.
+
+### 3. Compile + run
+
+```bash
+sungen generate --screen awards
+npx playwright test
+```
+
+### 4. Fix failures (AI verify loop)
+
+When tests fail → AI reads error → fixes `selectors.yaml` → recompile → re-run.
+
+| Error | Fix in selectors.yaml |
+|---|---|
+| strict mode: resolved to N elements | Add `exact: true` or `scope` or `nth` |
+| element(s) not found | Fix `name`, `type`, or `value` |
+| getByText matched too many | Add `match: 'exact'` or `nth` |
+
+---
+
 ## Gherkin Syntax
 
-**Pattern**: `User + action + [element] type + with {{data}}`
+**Pattern**: `User <action> [<Target>] <type> with {{<Value>}}`
 
-**[Complete Gherkin Standard (English)](docs/gherkin%20standards/gherkin-core-standard.md)** | **[Tiếng Việt](docs/gherkin%20standards/gherkin-core-standard.vi.md)**
+- `[Target]` → selector reference → lookup in `selectors/*.yaml`
+- `{{Value}}` → test data reference → lookup in `test-data/*.yaml`
 
 ### Example
 
@@ -49,51 +112,106 @@ npx playwright test
 Feature: Login Screen
   Path: /auth/login
 
+  @auth:admin
   Scenario: User logs in successfully
-    Given User is on [Login] page
+    Given User is on [login] page
     When User fill [Email] field with {{valid_email}}
     And User fill [Password] field with {{valid_password}}
     And User click [Login] button
-    Then User see [Welcome] text with {{success_message}}
+    Then User see [Welcome] heading with {{success_message}}
+    And User see [dashboard] page
 ```
 
-### Actions
+---
+
+## Pattern Shapes (17 categories)
 
-| Action | Example |
-|--------|---------|
-| Navigate | `Given User is on [Login] page` |
-| Open | `Given User open [Login] page` |
-| Fill | `When User fill [Email] field with {{email}}` |
-| Click | `When User click [Submit] button` |
-| Select | `When User select [Country] dropdown with {{country}}` |
-| See (visible) | `Then User see [Welcome] text` |
-| See (with value) | `Then User see [Welcome] text with {{message}}` |
-| See (hidden) | `Then User see [panel] dialog with {{title}} is hidden` |
-| Wait for hidden | `And User wait for dialog with {{title}} is hidden` |
+### Actions
 
-### Annotations
+| Pattern | Example |
+|---|---|
+| Simple click | `User click [Submit] button` |
+| Click with data | `User click [Teammate] button with {{name}}` |
+| Fill field | `User fill [Email] field with {{email}}` |
+| Check/Uncheck | `User check [Remember me] checkbox` |
+| Select dropdown | `User select [Country] dropdown with {{country}}` |
+| Upload file | `User upload [Avatar] file with {{path}}` |
+| Double click | `User double click [Cell] element` |
+| Hover | `User hover [Info] icon` |
+| Clear | `User clear [Search] field` |
+| Toggle | `User toggle [Dark mode] switch` |
+
+### Keyboard
+
+| Pattern | Example |
+|---|---|
+| Global key | `User press Escape key` |
+| Key on element | `User press Enter on [Search] field` |
+
+### Navigation
+
+| Pattern | Example |
+|---|---|
+| Open page | `User is on [login] page` |
+| See page (URL) | `User see [dashboard] page` |
+
+### Wait
+
+| Pattern | Example |
+|---|---|
+| Wait timeout | `User wait for 3 seconds` |
+| Wait element | `User wait for [Modal] dialog` |
+| Wait hidden | `User wait for [Loading] spinner is hidden` |
+| Wait with data | `User wait for [Dialog] dialog with {{title}}` |
+
+### Assertions
+
+| Pattern | Example |
+|---|---|
+| See element | `User see [Welcome] heading` |
+| See with value | `User see [Title] heading with {{title}}` |
+| State check | `User see [Submit] button is disabled` |
+| State + data | `User see [Panel] dialog with {{title}} is hidden` |
+| Text contains | `User see [Message] text contains {{partial}}` |
+
+**States**: `hidden`, `visible`, `disabled`, `enabled`, `checked`, `unchecked`, `focused`, `empty`
+
+### Table
+
+| Pattern | Example |
+|---|---|
+| Row exists | `User see [Users] table has row with {{name}}` |
+| No row | `User see [Users] table has no row with {{name}}` |
+| Row count | `User see [Users] table has {{count}} rows` |
+| Column exists | `User see [Users] table has [Email] column` |
+| Cell by filter | `User see [Users] table row with {{name}} has [Status] with {{status}}` |
+| Cell by index | `User see [Users] table row 1 [Name] cell with {{name}}` |
+| Action in row | `User click [Edit] in [Users] table row with {{name}}` |
+| Empty table | `User see [Users] table is empty` |
+
+### Scope
+
+| Pattern | Example |
+|---|---|
+| Scroll | `User scroll to [Footer] section` |
+| Frame enter | `User switch to [Payment] frame` |
+| Frame exit | `User switch to [main] frame` |
 
-| Syntax | Description |
-|--------|-------------|
-| `[Element]` | Selector reference (mapped via selectors YAML) |
-| `{{variable}}` | Test data reference (mapped via test-data YAML) |
-| `Path: /route` | Page route in feature description |
+---
 
-### Tags
+## Tags
 
 | Tag | Level | Description |
 |-----|-------|-------------|
 | `@auth:<role>` | Feature/Scenario | Use Playwright auth storage state |
-| `@no-auth` | Feature/Scenario | Disable inherited auth |
+| `@no-auth` | Scenario | Disable inherited auth |
 | `@steps:<name>` | Scenario | Mark as reusable step block |
 | `@extend:<name>` | Scenario | Prepend steps from a `@steps` block |
-| `@ignore` | Step (comment) | Skip step in generation |
-| `@ignore-testcase` | Step (comment) | Skip entire scenario |
+| `@manual` | Scenario | Skip in generation |
 
 **Auth precedence**: Scenario > Feature > None
-**@extend precedence**: Extending scenario `@auth` > Base scenario `@auth` > Feature `@auth`
 
-### Reusable Steps with @steps / @extend
+### Reusable Steps
 
 ```gherkin
 @auth:user @steps:open-dialog
@@ -107,14 +225,44 @@ Scenario: Open kudos dialog
 Scenario: User sends a thank you message
   Given User is on [panel] dialog with {{kudo_title}}
   When User fill [Search] field with {{teammate_name}}
-  And User click [teammate] row with {{teammate_name}}
-  And User fill [Message] textarea with {{message}}
   And User click [Send] button
-  And User wait for dialog with {{kudo_title}} is hidden
-  Then User see [panel] modal with {{kudo_title}} is hidden
+  Then User see [panel] dialog with {{kudo_title}} is hidden
 ```
 
-The `@extend:open-dialog` scenario automatically inherits all steps from `@steps:open-dialog` before its own steps.
+---
+
+## Selector YAML Schema
+
+```yaml
+# Page navigation
+login:
+  type: 'page'
+  value: '/auth/login'
+
+# Role-based (preferred)
+submit:
+  type: 'role'
+  value: 'button'
+  name: 'Submit'
+  exact: true                    # avoid substring collisions
+  scope: 'desktop navigation'   # scope to parent landmark
+
+# Text-based
+price:
+  type: 'text'
+  value: '5.000.000 VNĐ'
+  match: 'exact'                # exact text match
+  nth: 1                        # second occurrence
+
+# TestID (best)
+login.form:
+  type: 'testid'
+  value: 'login-form'
+```
+
+**Locator priority**: `data-testid` > `role+name` > `label` > `text` > `CSS`
+
+**Types**: `testid`, `role`, `text`, `label`, `placeholder`, `locator`, `page`, `upload`, `frame`
 
 ---
 
@@ -123,44 +271,20 @@ The `@extend:open-dialog` scenario automatically inherits all steps from `@steps
 ```
 qa/screens/<name>/
 ├── features/         # Gherkin .feature files
-├── selectors/        # Element mappings (.yaml + .override.yaml)
-└── test-data/        # Test variables (.yaml + .override.yaml)
+├── selectors/        # Element selector YAML mappings
+└── test-data/        # Test data YAML values
 
 specs/generated/<name>/
 └── <feature>.spec.ts # Generated Playwright tests
 ```
 
-Override files (`.override.yaml`) are never overwritten by `sungen map` and take precedence at runtime.
-
----
-
-## CLI Commands
-
-| Command | Description |
-|---------|-------------|
-| `sungen init` | Initialize project structure |
-| `sungen add --screen <name> [--path <path>]` | Create screen definition |
-| `sungen live-scan --screen <name> [-f] [--headed]` | Scan live site to detect real Playwright selectors |
-| `sungen map --screen <name> [--force] [--skip-live-scan]` | Generate selector/test-data YAML from Gherkin |
-| `sungen generate --screen <name> [--force]` | Generate Playwright .spec.ts |
-| `sungen full --screen <name>` | Run all: discover → map → generate |
-| `sungen auto-tag --screen <name> [--dry-run]` | Inject `data-testid` into source code |
-| `sungen makeauth <role>` | Save browser auth state (supports SSO) |
-| `sungen validate --screen <name>` | Validate features and mappings |
-| `sungen cache-clear` | Clear cached data |
-
-Use `sungen <command> -h` for detailed options.
-
 ---
 
 ## Documentation
 
-- **[Gherkin Core Standard](docs/gherkin%20standards/gherkin-core-standard.md)** - Complete syntax rules ([Tiếng Việt](docs/gherkin%20standards/gherkin-core-standard.vi.md))
-- **[Pattern Reference](docs/pattern-reference.md)** - All 31 supported step patterns
-- **[Selector Override Guide](docs/selector-override.md)** - Fix AI mapping errors
-- **[Auth Setup Guide](docs/makeauth.md)** - Configure authentication states
-- **[Validation Guide](docs/validate.md)** - Validate Gherkin files
-- **[Windows Setup Guide](WINDOWS-SETUP-GUIDE.md)** - Step-by-step for Windows users
+- **[Gherkin Dictionary](docs/gherkin-dictionary.md)** — Full grammar, all 17 patterns, compiler rules, formal BNF
+- **[Gherkin Core Standard](docs/gherkin%20standards/gherkin-core-standard.md)** — Syntax rules ([Tiếng Việt](docs/gherkin%20standards/gherkin-core-standard.vi.md))
+- **[Auth Setup Guide](docs/makeauth.md)** — Configure authentication states
 
 ---
 
@@ -168,4 +292,4 @@ Use `sungen <command> -h` for detailed options.
 
 MIT License - see LICENSE file for details.
 
-**Made with ❤️ by Bach Ngoc Hoai**
+**Made with ❤️ by Sun Asterisk**

package/dist/cli/commands/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsBzD"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwBzD"}

package/dist/cli/commands/add.js

@@ -4,9 +4,10 @@ exports.registerAddCommand = registerAddCommand;
 function registerAddCommand(program) {
     program
         .command('add')
-        .description('Add screen definition with scaffolded files')
+        .description('Add screen or feature definition with scaffolded files')
         .requiredOption('--screen <name>', 'Screen name')
-        .option('-p, --path <path>', 'Screen route path')
+        .option('-p, --path <path>', 'Screen route path (e.g. /awards)')
+        .option('-f, --feature <name>', 'Add additional feature file to existing screen')
         .option('-d, --description <text>', 'Screen description')
         .action(async (options) => {
         try {
@@ -15,11 +16,12 @@ function registerAddCommand(program) {
             await manager.addScreen({
                 name: options.screen,
                 path: options.path,
+                feature: options.feature,
                 description: options.description,
             });
         }
         catch (error) {
-            console.error('❌ Add screen failed:', error);
+            console.error('Error:', error instanceof Error ? error.message : error);
             process.exit(1);
         }
     });

package/dist/cli/commands/add.js.map

@@ -1 +1 @@
-{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":";;AAEA,gDAsBC;AAtBD,SAAgB,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,6CAA6C,CAAC;SAC1D,cAAc,CAAC,iBAAiB,EAAE,aAAa,CAAC;SAChD,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;SAChD,MAAM,CAAC,0BAA0B,EAAE,oBAAoB,CAAC;SACxD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;YAEpC,MAAM,OAAO,CAAC,SAAS,CAAC;gBACtB,IAAI,EAAE,OAAO,CAAC,MAAM;gBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":";;AAEA,gDAwBC;AAxBD,SAAgB,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,wDAAwD,CAAC;SACrE,cAAc,CAAC,iBAAiB,EAAE,aAAa,CAAC;SAChD,MAAM,CAAC,mBAAmB,EAAE,kCAAkC,CAAC;SAC/D,MAAM,CAAC,sBAAsB,EAAE,gDAAgD,CAAC;SAChF,MAAM,CAAC,0BAA0B,EAAE,oBAAoB,CAAC;SACxD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;YAEpC,MAAM,OAAO,CAAC,SAAS,CAAC;gBACtB,IAAI,EAAE,OAAO,CAAC,MAAM;gBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgD9D"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqDpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqD9D"}

package/dist/cli/commands/generate.js

@@ -1,51 +1,126 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerGenerateCommand = registerGenerateCommand;
-const config_loader_1 = require("../../config/config-loader");
-const pipeline_1 = require("../../orchestrator/pipeline");
-const utils_1 = require("../utils");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const code_generator_1 = require("../../generators/test-generator/code-generator");
+/**
+ * Find .feature files recursively in a directory
+ */
+function findFeatureFiles(dir) {
+    const files = [];
+    if (!fs.existsSync(dir))
+        return files;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...findFeatureFiles(fullPath));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.feature')) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+/**
+ * Find feature files for a specific screen
+ */
+function findFeatureFilesForScreen(screenName) {
+    const screenFeaturesDir = path.join(process.cwd(), 'qa', 'screens', screenName, 'features');
+    return findFeatureFiles(screenFeaturesDir);
+}
+/**
+ * Find all feature files across all screens
+ */
+function findAllFeatureFiles() {
+    const allFiles = [];
+    const screensDir = path.join(process.cwd(), 'qa', 'screens');
+    if (fs.existsSync(screensDir)) {
+        const screenDirs = fs.readdirSync(screensDir, { withFileTypes: true })
+            .filter(entry => entry.isDirectory())
+            .map(entry => entry.name);
+        for (const screenName of screenDirs) {
+            const screenFeaturesDir = path.join(screensDir, screenName, 'features');
+            allFiles.push(...findFeatureFiles(screenFeaturesDir));
+        }
+    }
+    return allFiles;
+}
 function registerGenerateCommand(program) {
     program
         .command('generate')
-        .description('Generate Playwright test code from features')
-        .option('--ai-mapper', 'Enable AI fallback for unknown Gherkin patterns')
-        .option('--framework <name>', 'Test framework (playwright, appium, integration)', 'playwright')
-        .option('-s, --screen <name>', 'Filter generation to specific screen')
-        .option('-f, --force', 'Force regeneration, bypass cache')
-        .option('--skip-validation', 'Skip validation before generation')
+        .description('Generate Playwright test code from Gherkin features')
+        .option('-s, --screen <name>', 'Generate tests for a specific screen')
+        .option('--all', 'Generate tests for all screens')
+        .option('--framework <name>', 'Test framework (default: playwright)', 'playwright')
         .action(async (options) => {
         try {
-            // Run validation first (unless --skip-validation is set)
-            if (!options.skipValidation) {
-                const { ScreenValidator } = require('../../core/validator');
-                const validator = new ScreenValidator();
-                let validationResult;
-                if (options.screen) {
-                    console.log(`🔍 Validating screen: ${options.screen}...\n`);
-                    validationResult = validator.validateScreen(options.screen);
+            const screenName = options.screen;
+            // Find feature files
+            let featureFiles;
+            if (screenName) {
+                featureFiles = findFeatureFilesForScreen(screenName);
+                if (featureFiles.length === 0) {
+                    throw new Error(`No feature files found for screen: ${screenName}\n` +
+                        `Looked in: qa/screens/${screenName}/features/`);
                 }
-                else {
-                    console.log('🔍 Validating all screens...\n');
-                    validationResult = validator.validateAll();
-                }
-                if (!validationResult.valid) {
-                    (0, utils_1.printValidationResult)(validationResult, false);
-                    console.error('\n❌ Validation failed. Fix errors before generating tests.');
-                    console.error('   Tip: Use --skip-validation to bypass validation (not recommended)');
-                    process.exit(1);
+                console.log(`\nGenerating tests: ${screenName}\n`);
+            }
+            else {
+                featureFiles = findAllFeatureFiles();
+                if (featureFiles.length === 0) {
+                    throw new Error('No feature files found in qa/screens/');
                 }
-                console.log(`✅ Validation passed (${validationResult.summary.totalFiles} files)\n`);
+                console.log(`\nGenerating tests for all screens\n`);
             }
-            const cliOptions = {
-                ...program.opts(),
-                ...options,
-            };
-            const config = new config_loader_1.ConfigLoader().load(cliOptions);
-            const pipeline = new pipeline_1.Pipeline(config);
-            await pipeline.runTestGeneration(options.screen);
+            // Output directory
+            const outputDir = path.join(process.cwd(), 'specs', 'generated');
+            // Create generator and compile
+            const generator = new code_generator_1.CodeGenerator({
+                framework: options.framework || 'playwright',
+                screenName,
+                verbose: program.opts().verbose,
+            });
+            const results = await generator.generateAllTests(path.join(process.cwd(), 'qa', 'screens'), outputDir, featureFiles);
+            console.log(`\n${results.length} test file(s) generated.`);
+            console.log(`Next step: npx playwright test --ui\n`);
         }
         catch (error) {
-            console.error('❌ Test generation failed:', error);
+            console.error('Error:', error instanceof Error ? error.message : error);
             process.exit(1);
         }
     });

package/dist/cli/commands/generate.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":";;AAMA,0DAgDC;AArDD,8DAA0D;AAC1D,0DAAuD;AAEvD,oCAAiD;AAEjD,SAAgB,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,aAAa,EAAE,iDAAiD,CAAC;SACxE,MAAM,CAAC,oBAAoB,EAAE,kDAAkD,EAAE,YAAY,CAAC;SAC9F,MAAM,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;SACrE,MAAM,CAAC,aAAa,EAAE,kCAAkC,CAAC;SACzD,MAAM,CAAC,mBAAmB,EAAE,mCAAmC,CAAC;SAChE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,yDAAyD;YACzD,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC5B,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;gBAC5D,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;gBAExC,IAAI,gBAAkC,CAAC;gBACvC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBACnB,OAAO,CAAC,GAAG,CAAC,yBAAyB,OAAO,CAAC,MAAM,OAAO,CAAC,CAAC;oBAC5D,gBAAgB,GAAG,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC9D,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;oBAC9C,gBAAgB,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;gBAC7C,CAAC;gBAED,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;oBAC5B,IAAA,6BAAqB,EAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;oBAC/C,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;oBAC5E,OAAO,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;oBACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBAED,OAAO,CAAC,GAAG,CAAC,wBAAwB,gBAAgB,CAAC,OAAO,CAAC,UAAU,WAAW,CAAC,CAAC;YACtF,CAAC;YAED,MAAM,UAAU,GAAG;gBACjB,GAAG,OAAO,CAAC,IAAI,EAAE;gBACjB,GAAG,OAAO;aACX,CAAC;YACF,MAAM,MAAM,GAAG,IAAI,4BAAY,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,IAAI,mBAAQ,CAAC,MAAM,CAAC,CAAC;YAEtC,MAAM,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,0DAqDC;AAzGD,2CAA6B;AAC7B,uCAAyB;AACzB,mFAA+E;AAE/E;;GAEG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7D,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,UAAkB;IACnD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAC5F,OAAO,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB;IAC1B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAE7D,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACnE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;aACpC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5B,KAAK,MAAM,UAAU,IAAI,UAAU,EAAE,CAAC;YACpC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;YACxE,QAAQ,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;SACrE,MAAM,CAAC,OAAO,EAAE,gCAAgC,CAAC;SACjD,MAAM,CAAC,oBAAoB,EAAE,sCAAsC,EAAE,YAAY,CAAC;SAClF,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;YAElC,qBAAqB;YACrB,IAAI,YAAsB,CAAC;YAC3B,IAAI,UAAU,EAAE,CAAC;gBACf,YAAY,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;gBACrD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CACb,sCAAsC,UAAU,IAAI;wBACpD,yBAAyB,UAAU,YAAY,CAChD,CAAC;gBACJ,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,uBAAuB,UAAU,IAAI,CAAC,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,YAAY,GAAG,mBAAmB,EAAE,CAAC;gBACrC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;gBAC3D,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YACtD,CAAC;YAED,mBAAmB;YACnB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;YAEjE,+BAA+B;YAC/B,MAAM,SAAS,GAAG,IAAI,8BAAa,CAAC;gBAClC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,YAAY;gBAC5C,UAAU;gBACV,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO;aAChC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAC9C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,EACzC,SAAS,EACT,YAAY,CACb,CAAC;YAEF,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,0BAA0B,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/index.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
- * Sungen CLI - AI-Native E2E Test Generator
- * Command-line interface for generating E2E tests from Gherkin features
+ * Sungen CLI v2 - Deterministic E2E Test Compiler
+ * Compiles Gherkin features + selector YAML + test data → Playwright tests
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/index.js

@@ -1,39 +1,28 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * Sungen CLI - AI-Native E2E Test Generator
- * Command-line interface for generating E2E tests from Gherkin features
+ * Sungen CLI v2 - Deterministic E2E Test Compiler
+ * Compiles Gherkin features + selector YAML + test data → Playwright tests
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const init_1 = require("./commands/init");
 const add_1 = require("./commands/add");
-const live_scan_1 = require("./commands/live-scan");
-const map_1 = require("./commands/map");
 const generate_1 = require("./commands/generate");
-const full_1 = require("./commands/full");
-const validate_1 = require("./commands/validate");
-const cache_clear_1 = require("./commands/cache-clear");
 const makeauth_1 = require("./commands/makeauth");
 async function main() {
     const program = new commander_1.Command();
     program
         .name('sungen')
-        .description('AI-Native E2E Test Generator - Generate Playwright tests from Gherkin features')
-        .version('1.0.24');
+        .description('Deterministic E2E Test Compiler — Gherkin + Selectors → Playwright')
+        .version('2.0.0');
     // Global options
     program
-        .option('-c, --config <path>', 'Path to custom config file')
         .option('-v, --verbose', 'Enable verbose logging');
-    // Register all commands
+    // Register commands (5 only)
     (0, init_1.registerInitCommand)(program);
     (0, add_1.registerAddCommand)(program);
-    (0, live_scan_1.registerLiveScanCommand)(program);
-    (0, map_1.registerMapCommand)(program);
     (0, generate_1.registerGenerateCommand)(program);
-    (0, full_1.registerFullCommand)(program);
-    (0, validate_1.registerValidateCommand)(program);
-    (0, cache_clear_1.registerCacheClearCommand)(program);
     (0, makeauth_1.registerMakeauthCommand)(program);
     await program.parseAsync(process.argv);
 }

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;AACA;;;GAGG;;AAEH,yCAAoC;AACpC,0CAAsD;AACtD,wCAAoD;AACpD,oDAA+D;AAC/D,wCAAoD;AACpD,kDAA8D;AAC9D,0CAAsD;AACtD,kDAA8D;AAC9D,wDAAmE;AACnE,kDAA8D;AAE9D,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,gFAAgF,CAAC;SAC7F,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErB,iBAAiB;IACjB,OAAO;SACJ,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;SAC3D,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;IAErD,wBAAwB;IACxB,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;IAC5B,IAAA,mCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;IAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,uCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IAEjC,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;AACA;;;GAGG;;AAEH,yCAAoC;AACpC,0CAAsD;AACtD,wCAAoD;AACpD,kDAA8D;AAC9D,kDAA8D;AAE9D,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,oEAAoE,CAAC;SACjF,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,iBAAiB;IACjB,OAAO;SACJ,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;IAErD,6BAA6B;IAC7B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;IAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IAEjC,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/frame-enter-action.hbs

@@ -0,0 +1 @@
+const frame = page.frameLocator('{{value}}');