@sun-asterisk/sungen 1.0.19 → 1.0.21

package/dist/utils/feature-finder.js

@@ -0,0 +1,67 @@
+"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.findFeatureFiles = findFeatureFiles;
+exports.findAllFeatureFiles = findAllFeatureFiles;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const screen_paths_1 = require("./screen-paths");
+/**
+ * Find all .feature files for a specific screen.
+ */
+function findFeatureFiles(screensRoot, screenName) {
+    const featuresDir = (0, screen_paths_1.getFeaturesDir)(screensRoot, screenName);
+    if (!fs.existsSync(featuresDir)) {
+        return [];
+    }
+    return fs.readdirSync(featuresDir)
+        .filter(f => f.endsWith('.feature'))
+        .map(f => path.join(featuresDir, f));
+}
+/**
+ * Find all .feature files across all screens.
+ */
+function findAllFeatureFiles(screensRoot) {
+    if (!fs.existsSync(screensRoot)) {
+        return [];
+    }
+    const files = [];
+    const screens = fs.readdirSync(screensRoot).filter(d => fs.statSync(path.join(screensRoot, d)).isDirectory());
+    for (const screen of screens) {
+        files.push(...findFeatureFiles(screensRoot, screen));
+    }
+    return files;
+}
+//# sourceMappingURL=feature-finder.js.map

package/dist/utils/feature-finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-finder.js","sourceRoot":"","sources":["../../src/utils/feature-finder.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,4CAQC;AAKD,kDAYC;AAhCD,uCAAyB;AACzB,2CAA6B;AAC7B,iDAAgD;AAEhD;;GAEG;AACH,SAAgB,gBAAgB,CAAC,WAAmB,EAAE,UAAkB;IACtE,MAAM,WAAW,GAAG,IAAA,6BAAc,EAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC5D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,WAAmB;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACrD,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CACrD,CAAC;IACF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/screen-paths.d.ts

@@ -0,0 +1,10 @@
+export declare function getScreenDir(screensRoot: string, screenName: string): string;
+export declare function getFeaturesDir(screensRoot: string, screenName: string): string;
+export declare function getSelectorsDir(screensRoot: string, screenName: string): string;
+export declare function getTestDataDir(screensRoot: string, screenName: string): string;
+export declare function getSelectorBasePath(screensRoot: string, screenName: string, featureName: string): string;
+export declare function getSelectorOverridePath(screensRoot: string, screenName: string, featureName: string): string;
+export declare function getTestDataBasePath(screensRoot: string, screenName: string, featureName: string): string;
+export declare function getTestDataOverridePath(screensRoot: string, screenName: string, featureName: string): string;
+export declare function getLiveScanPath(screensRoot: string, screenName: string, featureName: string): string;
+//# sourceMappingURL=screen-paths.d.ts.map

package/dist/utils/screen-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-paths.d.ts","sourceRoot":"","sources":["../../src/utils/screen-paths.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAExG;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5G;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAExG;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5G;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpG"}

package/dist/utils/screen-paths.js

@@ -0,0 +1,73 @@
+"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.getScreenDir = getScreenDir;
+exports.getFeaturesDir = getFeaturesDir;
+exports.getSelectorsDir = getSelectorsDir;
+exports.getTestDataDir = getTestDataDir;
+exports.getSelectorBasePath = getSelectorBasePath;
+exports.getSelectorOverridePath = getSelectorOverridePath;
+exports.getTestDataBasePath = getTestDataBasePath;
+exports.getTestDataOverridePath = getTestDataOverridePath;
+exports.getLiveScanPath = getLiveScanPath;
+const path = __importStar(require("path"));
+function getScreenDir(screensRoot, screenName) {
+    return path.join(screensRoot, screenName);
+}
+function getFeaturesDir(screensRoot, screenName) {
+    return path.join(screensRoot, screenName, 'features');
+}
+function getSelectorsDir(screensRoot, screenName) {
+    return path.join(screensRoot, screenName, 'selectors');
+}
+function getTestDataDir(screensRoot, screenName) {
+    return path.join(screensRoot, screenName, 'test-data');
+}
+function getSelectorBasePath(screensRoot, screenName, featureName) {
+    return path.join(screensRoot, screenName, 'selectors', `${featureName}.yaml`);
+}
+function getSelectorOverridePath(screensRoot, screenName, featureName) {
+    return path.join(screensRoot, screenName, 'selectors', `${featureName}.override.yaml`);
+}
+function getTestDataBasePath(screensRoot, screenName, featureName) {
+    return path.join(screensRoot, screenName, 'test-data', `${featureName}.yaml`);
+}
+function getTestDataOverridePath(screensRoot, screenName, featureName) {
+    return path.join(screensRoot, screenName, 'test-data', `${featureName}.override.yaml`);
+}
+function getLiveScanPath(screensRoot, screenName, featureName) {
+    return path.join(screensRoot, screenName, 'selectors', `${featureName}.live-scan.yaml`);
+}
+//# sourceMappingURL=screen-paths.js.map

package/dist/utils/screen-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-paths.js","sourceRoot":"","sources":["../../src/utils/screen-paths.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,oCAEC;AAED,wCAEC;AAED,0CAEC;AAED,wCAEC;AAED,kDAEC;AAED,0DAEC;AAED,kDAEC;AAED,0DAEC;AAED,0CAEC;AApCD,2CAA6B;AAE7B,SAAgB,YAAY,CAAC,WAAmB,EAAE,UAAkB;IAClE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,SAAgB,cAAc,CAAC,WAAmB,EAAE,UAAkB;IACpE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AACxD,CAAC;AAED,SAAgB,eAAe,CAAC,WAAmB,EAAE,UAAkB;IACrE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AACzD,CAAC;AAED,SAAgB,cAAc,CAAC,WAAmB,EAAE,UAAkB;IACpE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AACzD,CAAC;AAED,SAAgB,mBAAmB,CAAC,WAAmB,EAAE,UAAkB,EAAE,WAAmB;IAC9F,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,WAAW,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,SAAgB,uBAAuB,CAAC,WAAmB,EAAE,UAAkB,EAAE,WAAmB;IAClG,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,WAAW,gBAAgB,CAAC,CAAC;AACzF,CAAC;AAED,SAAgB,mBAAmB,CAAC,WAAmB,EAAE,UAAkB,EAAE,WAAmB;IAC9F,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,WAAW,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,SAAgB,uBAAuB,CAAC,WAAmB,EAAE,UAAkB,EAAE,WAAmB;IAClG,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,WAAW,gBAAgB,CAAC,CAAC;AACzF,CAAC;AAED,SAAgB,eAAe,CAAC,WAAmB,EAAE,UAAkB,EAAE,WAAmB;IAC1F,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,WAAW,iBAAiB,CAAC,CAAC;AAC1F,CAAC"}

package/dist/utils/selector-loader.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Load selectors for a feature, merging base and override files.
+ * Returns empty object if no files found.
+ */
+export declare function loadSelectors<T = Record<string, any>>(screensRoot: string, screenName: string, featureName: string): T;
+//# sourceMappingURL=selector-loader.d.ts.map

package/dist/utils/selector-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-loader.d.ts","sourceRoot":"","sources":["../../src/utils/selector-loader.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnD,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,CAAC,CAWH"}

package/dist/utils/selector-loader.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSelectors = loadSelectors;
+const yaml_io_1 = require("./yaml-io");
+const screen_paths_1 = require("./screen-paths");
+/**
+ * Load selectors for a feature, merging base and override files.
+ * Returns empty object if no files found.
+ */
+function loadSelectors(screensRoot, screenName, featureName) {
+    const basePath = (0, screen_paths_1.getSelectorBasePath)(screensRoot, screenName, featureName);
+    const overridePath = (0, screen_paths_1.getSelectorOverridePath)(screensRoot, screenName, featureName);
+    const base = (0, yaml_io_1.readYamlIfExists)(basePath) || {};
+    const override = (0, yaml_io_1.readYamlIfExists)(overridePath);
+    if (override) {
+        return { ...base, ...override };
+    }
+    return base;
+}
+//# sourceMappingURL=selector-loader.js.map

package/dist/utils/selector-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-loader.js","sourceRoot":"","sources":["../../src/utils/selector-loader.ts"],"names":[],"mappings":";;AAOA,sCAeC;AAtBD,uCAA6C;AAC7C,iDAA8E;AAE9E;;;GAGG;AACH,SAAgB,aAAa,CAC3B,WAAmB,EACnB,UAAkB,EAClB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,IAAA,kCAAmB,EAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,IAAA,sCAAuB,EAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAEnF,MAAM,IAAI,GAAG,IAAA,0BAAgB,EAAI,QAAQ,CAAC,IAAI,EAAO,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAA,0BAAgB,EAAI,YAAY,CAAC,CAAC;IAEnD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/selector-types.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Valid selector types used across scaffold generator, selector resolver, and validator.
+ * Single source of truth — import this instead of hardcoding.
+ */
+export declare const VALID_SELECTOR_TYPES: readonly ["placeholder", "role", "testid", "label", "text", "page", "column", "locator", "id"];
+export type SelectorType = (typeof VALID_SELECTOR_TYPES)[number];
+//# sourceMappingURL=selector-types.d.ts.map

package/dist/utils/selector-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-types.d.ts","sourceRoot":"","sources":["../../src/utils/selector-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,gGAUvB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/utils/selector-types.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_SELECTOR_TYPES = void 0;
+/**
+ * Valid selector types used across scaffold generator, selector resolver, and validator.
+ * Single source of truth — import this instead of hardcoding.
+ */
+exports.VALID_SELECTOR_TYPES = [
+    'placeholder',
+    'role',
+    'testid',
+    'label',
+    'text',
+    'page',
+    'column',
+    'locator',
+    'id',
+];
+//# sourceMappingURL=selector-types.js.map

package/dist/utils/selector-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-types.js","sourceRoot":"","sources":["../../src/utils/selector-types.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,oBAAoB,GAAG;IAClC,aAAa;IACb,MAAM;IACN,QAAQ;IACR,OAAO;IACP,MAAM;IACN,MAAM;IACN,QAAQ;IACR,SAAS;IACT,IAAI;CACI,CAAC"}

package/dist/utils/test-data-loader.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Load test data for a feature, merging base and override files.
+ * Returns empty object if no files found.
+ */
+export declare function loadTestData<T = Record<string, any>>(screensRoot: string, screenName: string, featureName: string): T;
+//# sourceMappingURL=test-data-loader.d.ts.map

package/dist/utils/test-data-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-data-loader.d.ts","sourceRoot":"","sources":["../../src/utils/test-data-loader.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClD,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,CAAC,CAWH"}

package/dist/utils/test-data-loader.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTestData = loadTestData;
+const yaml_io_1 = require("./yaml-io");
+const screen_paths_1 = require("./screen-paths");
+/**
+ * Load test data for a feature, merging base and override files.
+ * Returns empty object if no files found.
+ */
+function loadTestData(screensRoot, screenName, featureName) {
+    const basePath = (0, screen_paths_1.getTestDataBasePath)(screensRoot, screenName, featureName);
+    const overridePath = (0, screen_paths_1.getTestDataOverridePath)(screensRoot, screenName, featureName);
+    const base = (0, yaml_io_1.readYamlIfExists)(basePath) || {};
+    const override = (0, yaml_io_1.readYamlIfExists)(overridePath);
+    if (override) {
+        return { ...base, ...override };
+    }
+    return base;
+}
+//# sourceMappingURL=test-data-loader.js.map

package/dist/utils/test-data-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-data-loader.js","sourceRoot":"","sources":["../../src/utils/test-data-loader.ts"],"names":[],"mappings":";;AAOA,oCAeC;AAtBD,uCAA6C;AAC7C,iDAA8E;AAE9E;;;GAGG;AACH,SAAgB,YAAY,CAC1B,WAAmB,EACnB,UAAkB,EAClB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,IAAA,kCAAmB,EAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,IAAA,sCAAuB,EAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAEnF,MAAM,IAAI,GAAG,IAAA,0BAAgB,EAAI,QAAQ,CAAC,IAAI,EAAO,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAA,0BAAgB,EAAI,YAAY,CAAC,CAAC;IAEnD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/yaml-io.d.ts

@@ -0,0 +1,14 @@
+import yaml from 'yaml';
+/**
+ * Read and parse a YAML file. Throws if file doesn't exist or YAML is invalid.
+ */
+export declare function readYaml<T = any>(filePath: string): T;
+/**
+ * Read and parse a YAML file, returning null if the file doesn't exist.
+ */
+export declare function readYamlIfExists<T = any>(filePath: string): T | null;
+/**
+ * Write data to a YAML file, creating parent directories if needed.
+ */
+export declare function writeYaml(filePath: string, data: any, options?: yaml.DocumentOptions): void;
+//# sourceMappingURL=yaml-io.d.ts.map

package/dist/utils/yaml-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-io.d.ts","sourceRoot":"","sources":["../../src/utils/yaml-io.ts"],"names":[],"mappings":"AAEA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAGrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMpE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,GAAG,IAAI,CAM3F"}

package/dist/utils/yaml-io.js

@@ -0,0 +1,72 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readYaml = readYaml;
+exports.readYamlIfExists = readYamlIfExists;
+exports.writeYaml = writeYaml;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml_1 = __importDefault(require("yaml"));
+/**
+ * Read and parse a YAML file. Throws if file doesn't exist or YAML is invalid.
+ */
+function readYaml(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return yaml_1.default.parse(content);
+}
+/**
+ * Read and parse a YAML file, returning null if the file doesn't exist.
+ */
+function readYamlIfExists(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return yaml_1.default.parse(content);
+}
+/**
+ * Write data to a YAML file, creating parent directories if needed.
+ */
+function writeYaml(filePath, data, options) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, yaml_1.default.stringify(data, options), 'utf-8');
+}
+//# sourceMappingURL=yaml-io.js.map

package/dist/utils/yaml-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-io.js","sourceRoot":"","sources":["../../src/utils/yaml-io.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,4BAGC;AAKD,4CAMC;AAKD,8BAMC;AAhCD,uCAAyB;AACzB,2CAA6B;AAC7B,gDAAwB;AAExB;;GAEG;AACH,SAAgB,QAAQ,CAAU,QAAgB;IAChD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,cAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAU,QAAgB;IACxD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,cAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,QAAgB,EAAE,IAAS,EAAE,OAA8B;IACnF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,cAAI,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AACrE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sun-asterisk/sungen",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "AI-Native E2E Test Generator - Generate Playwright tests from Gherkin features using AI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/cli/commands/add.ts

@@ -0,0 +1,25 @@
+import { Command } from 'commander';
+
+export function registerAddCommand(program: Command): void {
+  program
+    .command('add')
+    .description('Add screen definition with scaffolded files')
+    .requiredOption('--screen <name>', 'Screen name')
+    .option('-p, --path <path>', 'Screen route path')
+    .option('-d, --description <text>', 'Screen description')
+    .action(async (options) => {
+      try {
+        const { ScreenManager } = require('../../orchestrator/screen-manager');
+        const manager = new ScreenManager();
+
+        await manager.addScreen({
+          name: options.screen,
+          path: options.path,
+          description: options.description,
+        });
+      } catch (error) {
+        console.error('❌ Add screen failed:', error);
+        process.exit(1);
+      }
+    });
+}

package/src/cli/commands/cache-clear.ts

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+import { ConfigLoader } from '../../config/config-loader';
+import { CacheManager } from '../../orchestrator/cache-manager';
+
+export function registerCacheClearCommand(program: Command): void {
+  program
+    .command('cache-clear')
+    .description('Clear all caches')
+    .action(async () => {
+      try {
+        const config = new ConfigLoader().load({});
+        const cacheManager = new CacheManager(config);
+
+        console.log('🗑️  Clearing cache...');
+        await cacheManager.clear();
+        console.log('✅ Cache cleared successfully');
+      } catch (error) {
+        console.error('❌ Cache clear failed:', error);
+        process.exit(1);
+      }
+    });
+}

package/src/cli/commands/full.ts

@@ -0,0 +1,35 @@
+import { Command } from 'commander';
+import { ConfigLoader } from '../../config/config-loader';
+import { Pipeline } from '../../orchestrator/pipeline';
+
+export function registerFullCommand(program: Command): void {
+  program
+    .command('full')
+    .description('Run full pipeline (live-scan + map + generate)')
+    .option('-s, --screen <name>', 'Process specific screen (optional)')
+    .option('-f, --force', 'Force rescan and overwrite')
+    .option('--headed', 'Launch browser in headed mode during live-scan', false)
+    .option('--auth-dir <path>', 'Auth storage state directory for live-scan', 'specs/.auth')
+    .option('--skip-live-scan', 'Skip live-scan phase')
+    .action(async (options) => {
+      try {
+        const cliOptions = {
+          ...program.opts(),
+          ...options,
+        };
+        const config = new ConfigLoader().load(cliOptions);
+        const pipeline = new Pipeline(config);
+
+        const screens = options.screen ? [options.screen] : undefined;
+        await pipeline.runFull(screens, {
+          headed: options.headed,
+          authDir: options.authDir,
+          skipLiveScan: options.skipLiveScan,
+          force: options.force,
+        });
+      } catch (error) {
+        console.error('❌ Full pipeline failed:', error);
+        process.exit(1);
+      }
+    });
+}

package/src/cli/commands/generate.ts

@@ -0,0 +1,55 @@
+import { Command } from 'commander';
+import { ConfigLoader } from '../../config/config-loader';
+import { Pipeline } from '../../orchestrator/pipeline';
+import { ValidationResult } from '../../core/validator';
+import { printValidationResult } from '../utils';
+
+export function registerGenerateCommand(program: Command): void {
+  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')
+    .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: ValidationResult;
+          if (options.screen) {
+            console.log(`🔍 Validating screen: ${options.screen}...\n`);
+            validationResult = validator.validateScreen(options.screen);
+          } else {
+            console.log('🔍 Validating all screens...\n');
+            validationResult = validator.validateAll();
+          }
+
+          if (!validationResult.valid) {
+            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(`✅ Validation passed (${validationResult.summary.totalFiles} files)\n`);
+        }
+
+        const cliOptions = {
+          ...program.opts(),
+          ...options,
+        };
+        const config = new ConfigLoader().load(cliOptions);
+        const pipeline = new Pipeline(config);
+
+        await pipeline.runTestGeneration(options.screen);
+      } catch (error) {
+        console.error('❌ Test generation failed:', error);
+        process.exit(1);
+      }
+    });
+}

package/src/cli/commands/init.ts

@@ -0,0 +1,17 @@
+import { Command } from 'commander';
+
+export function registerInitCommand(program: Command): void {
+  program
+    .command('init [projectName]')
+    .description('Initialize Sungen project (optionally create and initialize in a new project folder)')
+    .action(async (projectName?: string) => {
+      try {
+        const { ProjectInitializer } = require('../../orchestrator/project-initializer');
+        const initializer = new ProjectInitializer();
+        await initializer.initialize(projectName);
+      } catch (error) {
+        console.error('❌ Init failed:', error);
+        process.exit(1);
+      }
+    });
+}

package/src/cli/commands/{live-scan-command.ts → live-scan.ts}

@@ -1,34 +1,32 @@
-/**
- * Live Scan CLI Command
- * Launches a browser, replays Gherkin steps, and produces .live-scan.yaml matrix files.
- * Auto-detects baseURL from playwright.config.ts.
- */
-
 import { Command } from 'commander';
-import { RuntimeConfig } from '../../config/config-schema';
-import { LiveScanner } from '../../core/live-scanner';
-
-export function createLiveScanCommand(config: RuntimeConfig): Command {
-  const cmd = new Command('live-scan');
 
-  cmd
+export function registerLiveScanCommand(program: Command): void {
+  program
+    .command('live-scan')
     .description('Scan a live site to discover real selectors for Gherkin element references')
     .requiredOption('-s, --screen <name>', 'Screen name to scan')
     .option('--url <baseUrl>', 'Override base URL (default: read from playwright.config.ts)')
     .option('--headed', 'Launch browser in headed (visible) mode', false)
     .option('--auth-dir <path>', 'Directory containing auth storage state files', 'specs/.auth')
+    .option('-f, --force', 'Force rescan all elements, ignoring existing results', false)
     .action(async (options) => {
       try {
+        const { LiveScanner } = require('../../core/live-scanner');
+
         console.log('\n🔍 Sungen Live Scanner\n');
         console.log(`📍 Screen: ${options.screen}`);
         console.log(`🖥️  Mode: ${options.headed ? 'headed' : 'headless'}`);
+        if (options.force) {
+          console.log(`🔄 Force mode: rescanning all elements`);
+        }
 
         const scanner = new LiveScanner({
-          baseUrl: options.url,  // undefined = auto-detect from playwright.config.ts
+          baseUrl: options.url,
           screenName: options.screen,
           screensDir: 'qa/screens',
           headed: options.headed,
           authDir: options.authDir,
+          force: options.force,
         });
 
         const results = await scanner.scan();
@@ -40,12 +38,16 @@ export function createLiveScanCommand(config: RuntimeConfig): Command {
         let totalResolved = 0;
         let totalWarnings = 0;
         let totalUnresolved = 0;
+        let totalSkipped = 0;
 
         for (const result of results) {
-          for (const scenario of Object.values(result.scenarios)) {
-            for (const element of Object.values(scenario.elements)) {
+          for (const scenario of Object.values(result.scenarios) as any[]) {
+            for (const element of Object.values(scenario.elements) as any[]) {
               totalElements++;
-              if (element.matchMethod === 'unresolved') {
+              if ((element as any).skipped) {
+                totalSkipped++;
+                totalResolved++;
+              } else if (element.matchMethod === 'unresolved') {
                 totalUnresolved++;
               } else {
                 totalResolved++;
@@ -57,6 +59,9 @@ export function createLiveScanCommand(config: RuntimeConfig): Command {
 
         console.log(`Total Elements:  ${totalElements}`);
         console.log(`Resolved:        ${totalResolved}`);
+        if (totalSkipped > 0) {
+          console.log(`Skipped (cached): ${totalSkipped}`);
+        }
         console.log(`Warnings:        ${totalWarnings}`);
         console.log(`Unresolved:      ${totalUnresolved}`);
 
@@ -74,6 +79,4 @@ export function createLiveScanCommand(config: RuntimeConfig): Command {
         process.exit(1);
       }
     });
-
-  return cmd;
 }