@sun-asterisk/sungen 3.2.5 → 3.2.7

package/src/orchestrator/templates/ai-src/skills/sungen-gherkin-syntax/SKILL.md

@@ -118,6 +118,27 @@ Scenario: ...
 
 Path access on a bound result: `{{q.count}}`/`{{q.length}}`, `{{q.first.col}}`, `{{q.last.col}}`, `{{q[2].col}}`, `{{q.col}}` (= first row's col). `expect A is B` also supports `is at least` / `is at most` / `is not`. Tier-2 declarative (trivial inline, no catalog): `User see [<table>] row where [<col>] is {{v}} [has [<col2>] = "x"]`, `… no row where …`, `… count is {{n}}`. Full grammar + catalog/datasource/secret rules → **Advanced → Database** doc. Only emit DB steps when the project has a `database/` catalog / `datasources.yaml`.
 
+### API response assertions (optional API Driver)
+
+An `@api:<name>` call binds the response to `{{name}}` = `{ status, ok, body, headers }` (+ `ok_count`/`status_counts` under `@concurrent`). Assert with the same `expect A is B` grammar + path access:
+
+```gherkin
+@api:create_user(email={{email}}) @query:user_by_email(email={{email}})
+Scenario: ...
+  Then expect {{create_user.status}} is 201                    # status
+  And  expect {{create_user.body.id}} is at least {{one}}      # server-derived body field
+  And  expect {{user_by_email.count}} is {{one}}               # proof of effect (DB oracle)
+```
+
+Path access: `{{name.status}}`, `{{name.body.<path>}}` (dot/`[i]` nav), `{{name.headers.x-request-id}}` (dot form — hyphens are fine, no quotes/brackets), `{{name.ok_count}}`.
+
+Full-shape contract check: `expect {{name.body}} matches schema [Ref]` validates the response body against the named JSON Schema in `qa/api/schemas.yaml` (populated by `sungen api import`). Use alongside a couple of concrete field asserts, not instead of them.
+
+**Depth rule** (see `sungen-tc-review` API rubric):
+- **Success (2xx)** → assert status **and** ≥1 body field; a **mutating** success must also prove the effect (`@query` read-back, follow-up GET, or `@concurrent` `ok_count`). Never status-only.
+- **Error (4xx/5xx)** → assert the status (via `@cases` `expect_status` or an explicit `is 4xx`); assert the error message field when the contract defines one.
+- **Anti-pattern** — re-asserting the value you just sent (`{{x.body.email}} is {{email}}` on the thing you created) proves little; assert a **server-derived** field (id, timestamp, computed status) or read it back.
+
 ### States
 
 `hidden` `visible` `disabled` `enabled` `checked` `unchecked` `focused` `empty` `loading` `selected` `sorted ascending` `sorted descending`

package/src/orchestrator/templates/ai-src/skills/sungen-selector-fix/SKILL.md

@@ -84,6 +84,7 @@ When running Phase 0 for a **flow** (`qa/flows/<name>/`), check existing screen
    - **Typical mismatch cases**: Gherkin uses English label (`[Submit]`) but app displays Vietnamese (`"Gửi"`); placeholder is descriptive (`"Nhập email của bạn"`) not a bare field name (`"Email"`); button text includes an icon glyph before/after the word.
 7. **Substring ambiguity check**: for each `role` + `name` selector, check if any other element in the snapshot has a name that **contains** this name as a substring (e.g., `"Đăng ký"` vs `"Đăng ký bằng Google"`). If yes → add `exact: true` to prevent strict mode violation at runtime.
 8. **Merge, don't overwrite**: preserve the page selector and any user-authored entries in `selectors.yaml`. Only add missing keys.
+   - **Type-collision check** (see `sungen-selector-keys` § Collision rule): before writing a base key, check whether it already exists with a *different* `type`. If so, give **both** entries a `--type` suffix instead of clobbering or sharing the base key — a base-key entry of the wrong type gets picked up by any step referencing that label. Watch `page` especially: a `[X] page` step reads `value` as a URL, so if `X` already holds a button (`value: 'button'`) the assertion compiles to `toHaveURL(/button/)`. Write `X--page` (URL from the live page / feature `Path:`) alongside `X--button`.
 9. **Show summary + confirm**: list the keys that will be added, ask the user to approve, then write the file.
 10. **Compile**: **Screen**: `sungen generate --screen <screen>`. **Flow**: `sungen generate --flow <flow>`. Then proceed to Phase 1.
 
@@ -97,6 +98,7 @@ When running Phase 0 for a **flow** (`qa/flows/<name>/`), check existing screen
 - Writing XPath or class-based CSS selectors → breaks on DOM/style refactoring. Use role/testid/text/label/placeholder from the accessibility tree.
 - Falling back to `locator: 'div.some-class > span'` when the element IS visible in the accessibility snapshot with a role + name → the snapshot gives you `getByRole` for free; use it.
 - Overwriting user-authored selectors → always merge.
+- Reusing a base key for two element types (e.g. a `[X] button` and a `[X] page`) → the wrong-type entry wins on lookup; disambiguate with `--type` suffixes (see step 8 type-collision check).
 
 ---
 

package/src/orchestrator/templates/ai-src/skills/sungen-selector-keys/SKILL.md

@@ -88,6 +88,39 @@ add campaign--text:
   value: 'Add Campaign'
 ```
 
+### Collision rule (MANDATORY)
+
+**Before writing a base key, check whether it already exists with a *different* `type`.**
+If it does, DO NOT overwrite it and DO NOT let the two share the base key — give **each** entry
+its own `--type` suffix. A key match alone does not carry type: the resolver walks
+`key--type` → `key` (see § Lookup Priority), so a base-key entry of the wrong type will be
+picked up by any step referencing that label, regardless of the type the step expects.
+
+The `page` type is the sharpest trap. A page step (`Then User see [X] page`) reads the entry's
+`value` as a **URL**. If key `X` already holds a `role`/button entry, the page step resolves that
+button and emits `toHaveURL(/button/)` — a literal button label treated as a URL path.
+
+```yaml
+# Gherkin: `When User click [読取結果一覧] button`  AND  `Then User see [読取結果一覧] page`
+# WRONG — one base key, page step inherits the button's value ('button') as a URL:
+読取結果一覧:
+  type: 'role'
+  value: 'button'
+  name: '読取結果一覧'
+
+# RIGHT — disambiguate by type; the page entry carries the real URL:
+読取結果一覧--button:
+  type: 'role'
+  value: 'button'
+  name: '読取結果一覧'
+
+読取結果一覧--page:
+  type: 'page'
+  value: '/reading-results'   # captured from the live page, or the feature Path:
+```
+
+If the label is used by only ONE type, the base key (no suffix) is fine — suffix only on collision.
+
 Type aliases (normalized automatically):
 | Gherkin type | Normalized suffix |
 |---|---|

package/src/orchestrator/templates/ai-src/skills/sungen-tc-review/SKILL.md

@@ -159,6 +159,12 @@ Build a mapping table: for each applicable group, does the feature have a matchi
 | **Syntax compliance** — steps match `sungen-gherkin-syntax` patterns, correct `[Ref] type with {{v}}`, no bare `is visible` | 4 |
 | Grouping — each case has 2–7 related assertions for the same action | 4 |
 
+**API scenarios (`@api`) — depth rubric:** a success case scores on Assertion Quality only if it proves the effect, not just the status. Apply per scenario:
+- **status-only mutating success = fail the "Specific" check** — `expect {{x.status}} is 201` alone proves nothing happened. Require a server-derived body field **and** a proof of effect (`@query` read-back / follow-up GET / `@concurrent` `ok_count`).
+- **read contract** — status + ≥1 body field (medium is acceptable for reads).
+- **error (4xx)** — the status IS the assertion; also check the error-message field when the contract defines one.
+- **anti-pattern (counts against "Avoids anti-patterns")** — re-asserting the input just sent instead of a server-derived value.
+
 ### Test Data (10)
 
 | Check | Pts |

package/src/orchestrator/templates/specs-api.ts

@@ -48,6 +48,37 @@ function loadConfig(): Record<string, ApiDataSource> {
 function substitute(text: string, params: Record<string, any>): string {
   return text.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (_m, p) => encodeURIComponent(String(params[p] ?? '')));
 }
+/** Bind `:param` tokens WITHOUT URL-encoding — for headers, body-file paths, and multipart file paths. */
+function substituteRaw(text: string, params: Record<string, any>): string {
+  return text.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (_m, p) => String(params[p] ?? ''));
+}
+/** Delete any case-insensitive variant of a header (HTTP header names are case-insensitive, but a
+ *  plain object keys on exact case — so a datasource `Content-Type` and our `content-type` would
+ *  both be sent). Call before setting, or to let Playwright own the header (multipart boundary). */
+function deleteHeader(headers: Record<string, string>, name: string): void {
+  const lower = name.toLowerCase();
+  for (const k of Object.keys(headers)) if (k.toLowerCase() === lower) delete headers[k];
+}
+
+/** A multipart file field embedded by the compiler (string = shorthand for { path }). */
+type FileSpec = string | { path: string; mimeType?: string; filename?: string; name?: string };
+
+const MIME: Record<string, string> = {
+  png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif', webp: 'image/webp',
+  svg: 'image/svg+xml', pdf: 'application/pdf', csv: 'text/csv', txt: 'text/plain',
+  json: 'application/json', xml: 'application/xml', zip: 'application/zip', mp4: 'video/mp4',
+};
+export function inferMime(name: string): string {
+  return MIME[(name.split('.').pop() || '').toLowerCase()] || 'application/octet-stream';
+}
+/** Resolve a fixture path: cwd-relative/absolute first, else qa/fixtures/<path>. */
+export function resolveFixture(p: string, label: string): string {
+  const direct = path.isAbsolute(p) ? p : path.join(process.cwd(), p);
+  if (fs.existsSync(direct)) return direct;
+  const inFixtures = path.join(process.cwd(), 'qa', 'fixtures', p);
+  if (fs.existsSync(inFixtures)) return inFixtures;
+  throw new Error(`API Driver: ${label} — fixture "${p}" not found (looked in ${direct} and qa/fixtures/${p}).`);
+}
 
 /**
  * Join a datasource base URL with a catalog path. Concatenate rather than rely on Playwright's
@@ -82,7 +113,7 @@ class ApiClient {
    */
   async call(
     label: string,
-    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; headers?: Record<string, string>; datasource?: string },
+    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; files?: Record<string, FileSpec>; bodyFile?: FileSpec; headers?: Record<string, string>; timeout?: number; datasource?: string },
     params: Record<string, any> = {},
     opts: { storageState?: string } = {},
   ): Promise<{ status: number; ok: boolean; body: any; headers: Record<string, string> }> {
@@ -94,7 +125,7 @@ class ApiClient {
     const headers: Record<string, string> = { ...(conf.headers || {}) };
     // catalog headers; :param tokens bind at runtime — raw (no URL-encoding, unlike the path)
     for (const [k, v] of Object.entries(req.headers || {}))
-      headers[k] = String(v).replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (_m, p) => String(params[p] ?? ''));
+      headers[k] = substituteRaw(String(v), params);
     // Body: substitute `:param` into the body template (object values), then encode per `encoding`.
     let body: any;
     if (req.body !== undefined && req.body !== null) {
@@ -102,8 +133,39 @@ class ApiClient {
     }
     // Map the wire format to the right Playwright option (#345): json → data (application/json,
     // default), form → form (application/x-www-form-urlencoded), multipart → multipart (form-data).
+    // A `files` block is a real upload: read each fixture into a { name, mimeType, buffer } part and
+    // send multipart, with any `body` values riding along as text fields.
     const bodyOpt: Record<string, unknown> = {};
-    if (body !== undefined) {
+    if (req.bodyFile) {
+      // Raw-binary body: the whole request body is the fixture's bytes. Content-Type comes from the
+      // spec's mimeType (default application/octet-stream) — this is what octet-stream upload
+      // endpoints expect (a multipart body would be rejected 415).
+      const spec = typeof req.bodyFile === 'string' ? { path: req.bodyFile } : req.bodyFile;
+      const fpath = substituteRaw(String(spec.path), params);
+      if (fpath) {
+        const resolved = resolveFixture(fpath, label);
+        bodyOpt.data = fs.readFileSync(resolved);
+        // Own the Content-Type: drop any datasource default (case-insensitive) so we don't send both.
+        deleteHeader(headers, 'content-type');
+        headers['content-type'] = spec.mimeType ?? 'application/octet-stream';
+      }
+    } else if (req.files && Object.keys(req.files).length) {
+      const mp: Record<string, any> = {};
+      if (body && typeof body === 'object')
+        for (const [k, v] of Object.entries(body as Record<string, unknown>)) mp[k] = typeof v === 'string' ? v : JSON.stringify(v);
+      for (const [field, raw] of Object.entries(req.files)) {
+        const spec = typeof raw === 'string' ? { path: raw } : raw;
+        const fpath = substituteRaw(String(spec.path), params);
+        if (!fpath) continue; // empty param → omit the part (a missing-file / wrong-type error row)
+        const resolved = resolveFixture(fpath, label);
+        const filename = spec.filename ?? path.basename(resolved);
+        mp[spec.name ?? field] = { name: filename, mimeType: spec.mimeType ?? inferMime(filename), buffer: fs.readFileSync(resolved) };
+      }
+      // Playwright generates the multipart/form-data Content-Type (with boundary); drop any datasource
+      // default Content-Type so it doesn't conflict with / duplicate the generated one.
+      deleteHeader(headers, 'content-type');
+      bodyOpt.multipart = mp;
+    } else if (body !== undefined) {
       const enc = req.encoding ?? 'json';
       if (enc === 'form') bodyOpt.form = body;
       else if (enc === 'multipart') bodyOpt.multipart = body;
@@ -115,7 +177,7 @@ class ApiClient {
     // authenticated cookies. Disposed per call so no request context lingers and hangs the process.
     const ctx: APIRequestContext = await request.newContext({
       extraHTTPHeaders: headers,
-      timeout: conf.timeout_ms ?? 15000,
+      timeout: req.timeout ?? conf.timeout_ms ?? 15000, // per-endpoint override → datasource → 15s
       ...(opts.storageState ? { storageState: opts.storageState } : {}),
     });
     try {
@@ -139,7 +201,7 @@ class ApiClient {
    */
   async callN(
     label: string,
-    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; headers?: Record<string, string>; datasource?: string },
+    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; files?: Record<string, FileSpec>; bodyFile?: FileSpec; headers?: Record<string, string>; timeout?: number; datasource?: string },
     params: Record<string, any> = {},
     n = 1,
     opts: { storageState?: string } = {},
@@ -160,6 +222,57 @@ class ApiClient {
       statuses: responses.map((r) => r.status),
     };
   }
+
+  /**
+   * Validate a response body against a named JSON Schema from `qa/api/schemas.yaml` (populated by
+   * `sungen api import` from the OpenAPI `components.schemas`). Backs `expect {{name.body}} matches
+   * schema [Ref]` — a full-contract check beyond individual field asserts. Returns `{ ok, errors }`;
+   * the generated assertion feeds `errors` into the failure message. Uses Ajv (a QA-project dep).
+   */
+  assertSchema(value: unknown, schemaName: string): { ok: boolean; errors: string } {
+    return assertSchemaImpl(value, schemaName);
+  }
+}
+
+// ── Response-schema validation (Ajv) ─────────────────────────────────────────────────────────────
+// Schemas live in qa/api/schemas.yaml (name → JSON Schema, incl. #/components/schemas/* $refs).
+// Loaded + compiled lazily so a project that never asserts a schema needs no Ajv resolution.
+let _apiSchemas: Record<string, any> | null | undefined;
+function loadApiSchemas(): Record<string, any> {
+  if (_apiSchemas !== undefined) return _apiSchemas || {};
+  const file = [path.join(process.cwd(), 'qa', 'api', 'schemas.yaml'), path.join(process.cwd(), 'schemas.yaml')].find((f) => fs.existsSync(f));
+  if (!file) { _apiSchemas = null; return {}; }
+  const { parse } = require('yaml');
+  _apiSchemas = (parse(fs.readFileSync(file, 'utf8')) as Record<string, any>) || {};
+  return _apiSchemas || {};
+}
+
+let _ajv: any;
+function getAjv(): any {
+  if (_ajv) return _ajv;
+  const Ajv = require('ajv');
+  _ajv = new Ajv({ allErrors: true, strict: false });
+  try { require('ajv-formats')(_ajv); } catch { /* formats optional */ }
+  // Register every named schema under its component ref so inter-schema $refs resolve.
+  for (const [name, schema] of Object.entries(loadApiSchemas())) {
+    try { _ajv.addSchema(schema, `#/components/schemas/${name}`); } catch { /* dup/invalid → skip */ }
+  }
+  return _ajv;
+}
+
+function assertSchemaImpl(value: unknown, schemaName: string): { ok: boolean; errors: string } {
+  const schema = loadApiSchemas()[schemaName];
+  if (!schema) return { ok: false, errors: `schema "${schemaName}" not found in qa/api/schemas.yaml` };
+  let validate: any;
+  try {
+    const ajv = getAjv();
+    validate = ajv.getSchema(`#/components/schemas/${schemaName}`) || ajv.compile(schema);
+  } catch (e: any) {
+    return { ok: false, errors: `schema "${schemaName}" failed to compile: ${e?.message || e}` };
+  }
+  const ok = validate(value) === true;
+  const errors = ok ? '' : (validate.errors || []).map((e: any) => `${e.instancePath || '(root)'} ${e.message}`).join('; ') || 'did not match schema';
+  return { ok, errors };
 }
 
 export const api = new ApiClient();

package/src/orchestrator/templates/specs-test-data.ts

@@ -48,7 +48,26 @@ export class TestDataLoader {
     if (value === undefined || value === null) {
       throw new Error(`Test data key not found: ${key}`);
     }
-    return String(value);
+    return this.interpolate(String(value));
+  }
+
+  /**
+   * Substitute embedded `{{ref}}` cross-references inside a resolved string value.
+   * Each ref is looked up via resolve() (flat key, @cases row column, or dotted path),
+   * so `expected_operator_id_label: 'ID : {{operator.id}}'` yields the real value at
+   * runtime — matching the delivery report's substituteTestDataVars. `$`-prefixed
+   * dynamic vars ({{$timestamp}} …) are already substituted at load time and never
+   * match `[\w.]+`, so they are left untouched. Resolution recurses (a referenced value
+   * may itself hold refs) up to a depth cap that guards against reference cycles; an
+   * unknown or empty ref is left as the literal `{{ref}}` — never blanked.
+   */
+  private interpolate(value: string, depth: number = 0): string {
+    if (depth > 10 || value.indexOf('{{') === -1) return value;
+    return value.replace(/\{\{\s*([\w.]+)\s*\}\}/g, (match, ref: string) => {
+      const resolved = this.resolve(ref);
+      if (resolved === undefined || resolved === null || resolved === '') return match;
+      return this.interpolate(String(resolved), depth + 1);
+    });
   }
 
   /**

package/dist/cli/types.d.ts

@@ -1,9 +0,0 @@
-/**
- * CLI Types
- * Future adapter interface for programmatic command execution (e.g., VSCode extension)
- */
-export interface CommandAdapter {
-    name: string;
-    execute(command: string, options: Record<string, any>): Promise<void>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE"}

package/dist/cli/types.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * CLI Types
- * Future adapter interface for programmatic command execution (e.g., VSCode extension)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/generators/gherkin-parser/selector-extractor.d.ts

@@ -1,37 +0,0 @@
-/**
- * Gherkin Selector Extractor
- * Scans Gherkin feature files and extracts all [screen.element] references
- */
-export interface ExtractedSelector {
-    screenId: string;
-    elementId: string;
-    fullRef: string;
-    occurrences: number;
-}
-export interface SelectorsByScreen {
-    [screenId: string]: {
-        [elementId: string]: {
-            fullRef: string;
-            occurrences: number;
-        };
-    };
-}
-export declare class GherkinSelectorExtractor {
-    /**
-     * Extract all selector references from Gherkin feature files
-     */
-    extractSelectors(featuresDir: string): SelectorsByScreen;
-    /**
-     * Extract selectors from feature file content
-     */
-    private extractSelectorsFromContent;
-    /**
-     * Generate base skeleton YAML structure
-     */
-    generateSkeletonYaml(screenId: string, selectors: SelectorsByScreen): string;
-    /**
-     * Write skeleton files for all screens
-     */
-    writeSkeletonFiles(selectors: SelectorsByScreen, outputDir: string): void;
-}
-//# sourceMappingURL=selector-extractor.d.ts.map

package/dist/generators/gherkin-parser/selector-extractor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"selector-extractor.d.ts","sourceRoot":"","sources":["../../../src/generators/gherkin-parser/selector-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,QAAQ,EAAE,MAAM,GAAG;QAClB,CAAC,SAAS,EAAE,MAAM,GAAG;YACnB,OAAO,EAAE,MAAM,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;CACH;AAED,qBAAa,wBAAwB;IACnC;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB;IAgCxD;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA0BnC;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,MAAM;IA+B5E;;OAEG;IACH,kBAAkB,CAChB,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,MAAM,GAChB,IAAI;CAWR"}

package/dist/generators/gherkin-parser/selector-extractor.js

@@ -1,108 +0,0 @@
-"use strict";
-/**
- * Gherkin Selector Extractor
- * Scans Gherkin feature files and extracts all [screen.element] references
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GherkinSelectorExtractor = void 0;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const glob_1 = require("glob");
-class GherkinSelectorExtractor {
-    /**
-     * Extract all selector references from Gherkin feature files
-     */
-    extractSelectors(featuresDir) {
-        const featureFiles = glob_1.glob.sync('**/*.feature', {
-            cwd: featuresDir,
-            absolute: true,
-        });
-        const selectorsByScreen = {};
-        for (const filePath of featureFiles) {
-            const content = fs_1.default.readFileSync(filePath, 'utf-8');
-            const selectors = this.extractSelectorsFromContent(content);
-            // Merge into selectorsByScreen
-            for (const selector of selectors) {
-                if (!selectorsByScreen[selector.screenId]) {
-                    selectorsByScreen[selector.screenId] = {};
-                }
-                if (!selectorsByScreen[selector.screenId][selector.elementId]) {
-                    selectorsByScreen[selector.screenId][selector.elementId] = {
-                        fullRef: selector.fullRef,
-                        occurrences: 0,
-                    };
-                }
-                selectorsByScreen[selector.screenId][selector.elementId].occurrences++;
-            }
-        }
-        return selectorsByScreen;
-    }
-    /**
-     * Extract selectors from feature file content
-     */
-    extractSelectorsFromContent(content) {
-        const selectors = [];
-        // Regex to match [screen.element] or [screen]
-        const selectorRegex = /\[([a-zA-Z0-9_-]+)(?:\.([a-zA-Z0-9_-]+))?\]/g;
-        let match;
-        while ((match = selectorRegex.exec(content)) !== null) {
-            const fullRef = match[0]; // e.g., "[auth-login.email]"
-            const screenId = match[1]; // e.g., "auth-login"
-            const elementId = match[2]; // e.g., "email" (undefined for route-only refs)
-            // Only include selectors with both screen and element (skip route-only refs)
-            if (elementId) {
-                selectors.push({
-                    screenId,
-                    elementId,
-                    fullRef,
-                    occurrences: 1,
-                });
-            }
-        }
-        return selectors;
-    }
-    /**
-     * Generate base skeleton YAML structure
-     */
-    generateSkeletonYaml(screenId, selectors) {
-        const screenSelectors = selectors[screenId];
-        if (!screenSelectors) {
-            return `# No selectors found for screen: ${screenId}\n`;
-        }
-        const lines = [
-            `# Selector skeleton for screen: ${screenId}`,
-            `# AI will fill in the selector values based on UI model`,
-            `# This file is generated by scanning Gherkin feature files`,
-            '',
-        ];
-        // Sort by element ID for consistency
-        const sortedElementIds = Object.keys(screenSelectors).sort();
-        for (const elementId of sortedElementIds) {
-            const { fullRef, occurrences } = screenSelectors[elementId];
-            lines.push(`"${fullRef}":`);
-            lines.push(`  selector: ""`);
-            lines.push(`  type: ""`);
-            lines.push(`  description: ""`);
-            lines.push(`  # Referenced ${occurrences} time(s) in Gherkin`);
-            lines.push('');
-        }
-        return lines.join('\n');
-    }
-    /**
-     * Write skeleton files for all screens
-     */
-    writeSkeletonFiles(selectors, outputDir) {
-        // Ensure output directory exists
-        fs_1.default.mkdirSync(outputDir, { recursive: true });
-        for (const screenId of Object.keys(selectors)) {
-            const skeletonContent = this.generateSkeletonYaml(screenId, selectors);
-            const outputPath = path_1.default.join(outputDir, `${screenId}.skeleton.yaml`);
-            fs_1.default.writeFileSync(outputPath, skeletonContent, 'utf-8');
-        }
-    }
-}
-exports.GherkinSelectorExtractor = GherkinSelectorExtractor;
-//# sourceMappingURL=selector-extractor.js.map

package/dist/generators/gherkin-parser/selector-extractor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"selector-extractor.js","sourceRoot":"","sources":["../../../src/generators/gherkin-parser/selector-extractor.ts"],"names":[],"mappings":"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"}

package/dist/generators/test-generator/types.d.ts

@@ -1,25 +0,0 @@
-/**
- * Test Generator Types
- * Core type definitions for the test generation compiler
- */
-/**
- * Generated Test Result
- */
-export interface GeneratedTest {
-    featureName: string;
-    filePath: string;
-    code: string;
-    sourceFile?: string;
-    stepCount?: number;
-}
-/**
- * Generation Statistics
- */
-export interface GenerationStats {
-    totalScenarios: number;
-    totalSteps: number;
-    dictionaryMatched: number;
-    todoCount: number;
-    generationTime: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/generators/test-generator/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/generators/test-generator/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/generators/test-generator/types.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * Test Generator Types
- * Core type definitions for the test generation compiler
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/generators/test-generator/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/generators/test-generator/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/generators/types.d.ts

@@ -1,119 +0,0 @@
-/**
- * Core types for Selector DSL Framework
- * Framework-agnostic types for multi-platform support
- */
-export interface UIElement {
-    key: string;
-    tag: string;
-    role?: string;
-    name?: string;
-    id?: string;
-    placeholder?: string;
-    label?: string;
-    text?: string;
-    ariaLabel?: string;
-    testId?: string;
-    source: string;
-    framework?: string;
-    props?: Record<string, any>;
-}
-export interface UIModel {
-    screenId: string;
-    routeId: string;
-    framework: FrameworkType;
-    sourceFiles: string[];
-    elements: UIElement[];
-    metadata?: {
-        scannedAt: string;
-        version: string;
-        hash: string;
-    };
-}
-export type DiscoveryMethod = 'ai-static-analysis' | 'manual' | 'runtime';
-export type LocatorType = 'css' | 'xpath' | 'resource-id' | 'accessibility-id' | 'test-id' | 'key' | 'text' | 'role';
-export interface SelectorEntry {
-    selector: string;
-    type: string;
-    description: string;
-    discoveryMethod: DiscoveryMethod;
-    locatorType?: LocatorType;
-    confidence?: 'high' | 'medium' | 'low';
-    alternatives?: string[];
-    metadata?: {
-        lastValidated?: string;
-        validationStatus?: 'valid' | 'invalid' | 'unknown';
-    };
-}
-export interface SelectorDSL {
-    [elementId: string]: SelectorEntry;
-}
-export type FrameworkType = 'react' | 'react-nextjs' | 'vue' | 'angular' | 'html' | 'flutter' | 'jetpack-compose' | 'swiftui';
-export type TargetPlatform = 'web' | 'android' | 'ios' | 'desktop';
-export type ExecutorType = 'playwright' | 'puppeteer' | 'selenium' | 'appium-android' | 'appium-ios' | 'flutter-driver' | 'espresso' | 'xcuitest';
-export interface ExecutorConfig {
-    type: ExecutorType;
-    platform: TargetPlatform;
-    selectorPath: string;
-    overridePath?: string;
-}
-export interface CacheEntry {
-    screenId: string;
-    hash: string;
-    selectors: SelectorDSL;
-    metadata: {
-        createdAt: string;
-        aiModel?: string;
-        tokenCost?: number;
-        framework: FrameworkType;
-    };
-}
-export interface GeneratorConfig {
-    aiProvider: 'anthropic' | 'google' | 'openai';
-    aiModel?: string;
-    sourceRoot: string;
-    uiModelPath: string;
-    selectorPath: string;
-    cachePath: string;
-    framework: FrameworkType;
-    enableCache: boolean;
-    cacheExpiry?: number;
-    parallelScans?: number;
-    verbose?: boolean;
-}
-export interface DiscoverOptions {
-    screenId?: string;
-    all?: boolean;
-    force?: boolean;
-}
-export interface GenerateOptions {
-    screenId?: string;
-    all?: boolean;
-    force?: boolean;
-    skipCache?: boolean;
-    runtimeData?: boolean;
-}
-export interface ValidateOptions {
-    screenId?: string;
-    all?: boolean;
-    executor?: ExecutorType;
-}
-export interface GherkinElementReference {
-    elementId: string;
-    screenId: string;
-    elementName: string;
-}
-export declare function parseElementReference(ref: string): GherkinElementReference | null;
-export declare class SelectorNotFoundError extends Error {
-    elementId: string;
-    screenId: string;
-    constructor(elementId: string, screenId: string);
-}
-export declare class UIModelNotFoundError extends Error {
-    screenId: string;
-    constructor(screenId: string);
-}
-export declare class GeneratorError extends Error {
-    cause?: Error;
-    constructor(message: string, cause?: Error);
-}
-//# sourceMappingURL=types.d.ts.map