@sun-asterisk/sungen 1.0.24 → 2.0.0

package/src/cli/commands/live-scan.ts

@@ -1,82 +0,0 @@
-import { Command } from 'commander';
-
-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,
-          screenName: options.screen,
-          screensDir: 'qa/screens',
-          headed: options.headed,
-          authDir: options.authDir,
-          force: options.force,
-        });
-
-        const results = await scanner.scan();
-
-        // Print final summary
-        console.log('\n📊 SCAN SUMMARY\n');
-
-        let totalElements = 0;
-        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) as any[]) {
-            for (const element of Object.values(scenario.elements) as any[]) {
-              totalElements++;
-              if ((element as any).skipped) {
-                totalSkipped++;
-                totalResolved++;
-              } else if (element.matchMethod === 'unresolved') {
-                totalUnresolved++;
-              } else {
-                totalResolved++;
-                if (element.warning) totalWarnings++;
-              }
-            }
-          }
-        }
-
-        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}`);
-
-        if (totalUnresolved > 0) {
-          console.log(`\n⚠️  ${totalUnresolved} element(s) could not be found on the live site`);
-        }
-
-        if (totalResolved > 0) {
-          console.log(`\n✅ Live scan complete. Run 'sungen map --screen ${options.screen}' to generate selectors.`);
-        }
-
-        console.log('');
-      } catch (error: any) {
-        console.error('\n❌ Live scan failed:', error.message);
-        process.exit(1);
-      }
-    });
-}

package/src/cli/commands/map.ts

@@ -1,97 +0,0 @@
-import { Command } from 'commander';
-import { ConfigLoader } from '../../config/config-loader';
-
-export function registerMapCommand(program: Command): void {
-  program
-    .command('map')
-    .description('Generate selector and test-data YAML from Gherkin feature files')
-    .option('-s, --screen <name>', 'Screen name (reads from qa/screens/<name>/features/)')
-    .option('--file <path>', 'Single feature file path (generates selectors next to features folder)')
-    .option('-o, --output <dir>', 'Output directory for generated files')
-    .option('-f, --force', 'Force overwrite existing YAML files and rescan all elements')
-    .option('--skip-live-scan', 'Skip live-scan before mapping (live-scan runs by default)')
-    .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('-v, --verbose', 'Detailed output')
-    .action(async (options) => {
-      try {
-        const path = require('path');
-        const cliOptions = {
-          ...program.opts(),
-          ...options,
-        };
-        const config = new ConfigLoader().load(cliOptions);
-        const { ScaffoldGenerator } = require('../../generators/scaffold-generator');
-
-        const generator = new ScaffoldGenerator();
-
-        if (options.screen) {
-          const screensDir = options.output || 'qa/screens';
-          const forceOverwrite = cliOptions.force || false;
-
-          // Run live-scan by default before mapping (skip with --skip-live-scan)
-          if (!options.skipLiveScan) {
-            const { LiveScanner } = require('../../core/live-scanner');
-            console.log('🔍 Running live-scan before mapping...\n');
-
-            const scanner = new LiveScanner({
-              screenName: options.screen,
-              screensDir,
-              headed: options.headed,
-              authDir: options.authDir,
-            });
-
-            await scanner.scan();
-            console.log('');
-          }
-
-          if (forceOverwrite) {
-            console.log(`Mapping screen: ${options.screen} (force: selectors will be overwritten)\n`);
-          } else {
-            console.log(`Mapping screen: ${options.screen}\n`);
-          }
-
-          const results = generator.processScreen(options.screen, screensDir, forceOverwrite);
-
-          for (const result of results) {
-            console.log(`✓ Mapped ${result.featureFile}.feature`);
-
-            if (result.selectorsSkipped) {
-              console.log(`   ⊘ ${path.basename(result.selectorsPath)} (skipped - already exists)`);
-            } else {
-              console.log(`   → ${path.basename(result.selectorsPath)} (${result.elementCount} elements)`);
-            }
-
-            if (result.testDataMerged) {
-              console.log(`   ↻ ${path.basename(result.testDataPath)} (smart-merged — ${result.dataRefCount} variables)\n`);
-            } else {
-              console.log(`   → ${path.basename(result.testDataPath)} (${result.dataRefCount} variables)\n`);
-            }
-          }
-
-          console.log(`Next step: sungen generate --screen ${options.screen}`);
-          console.log('     This will create the test specs based on the mapped selectors and test data.');
-        } else if (options.file) {
-          const deriveOutputDir = (featureFilePath: string): string => {
-            const featureDir = path.dirname(featureFilePath);
-            if (featureDir.includes('features')) {
-              return featureDir.replace(/features\/?$/, 'selectors/screens');
-            }
-            return path.join(featureDir, '..', 'selectors', 'screens');
-          };
-
-          const outputDir = options.output || deriveOutputDir(options.file);
-          const forceOverwrite = cliOptions.force || false;
-          console.log(`Mapping from file: ${options.file}\n`);
-          const result = generator.processFeatureFile(options.file, outputDir, forceOverwrite);
-          console.log(`✓ Generated: ${result.outputPath} (${result.elementCount} elements)`);
-        } else {
-          console.error('❌ Error: Please specify --screen <name> or --file <path>');
-          process.exit(1);
-        }
-      } catch (error) {
-        console.error('❌ Mapping failed:', error);
-        process.exit(1);
-      }
-    });
-}

package/src/cli/commands/validate.ts

@@ -1,43 +0,0 @@
-import { Command } from 'commander';
-import { ValidationResult } from '../../core/validator';
-import { printValidationResult } from '../utils';
-
-export function registerValidateCommand(program: Command): void {
-  program
-    .command('validate')
-    .description('Validate Gherkin features and selector/test-data mappings')
-    .option('-s, --screen <name>', 'Validate specific screen (optional, defaults to all)')
-    .option('--json', 'Output results as JSON')
-    .option('-v, --verbose', 'Show all checks, not just failures')
-    .action(async (options) => {
-      try {
-        const { ScreenValidator } = require('../../core/validator');
-
-        const validator = new ScreenValidator({
-          verbose: options.verbose,
-        });
-
-        let result: ValidationResult;
-        if (options.screen) {
-          console.log(`Validating screen: ${options.screen}\n`);
-          result = validator.validateScreen(options.screen);
-        } else {
-          console.log('Validating all screens...\n');
-          result = validator.validateAll();
-        }
-
-        if (options.json) {
-          console.log(JSON.stringify(result, null, 2));
-        } else {
-          printValidationResult(result, options.verbose);
-        }
-
-        if (!result.valid) {
-          process.exit(1);
-        }
-      } catch (error) {
-        console.error('❌ Validation failed:', error);
-        process.exit(1);
-      }
-    });
-}

package/src/cli/utils.ts

@@ -1,106 +0,0 @@
-import { ValidationResult } from '../core/validator';
-
-/**
- * Get human-readable description for error code
- */
-function getErrorDescription(code: string): string {
-  switch (code) {
-    case 'GHERKIN_SYNTAX_ERROR': return 'Gherkin syntax errors';
-    case 'MISSING_PATH_METADATA': return 'missing Path: metadata';
-    case 'MISSING_SELECTOR_FILE': return 'missing selector files';
-    case 'MISSING_SELECTOR': return 'missing selector definitions';
-    case 'MISSING_DATA_FILE': return 'missing test-data files';
-    case 'MISSING_DATA_REF': return 'missing data references';
-    case 'INVALID_YAML_SYNTAX': return 'invalid YAML syntax';
-    case 'INVALID_SELECTOR_TYPE': return 'invalid selector types';
-    case 'INVALID_DATA_VALUE': return 'invalid data values';
-    case 'EMPTY_FEATURE': return 'empty feature files';
-    default: return 'errors';
-  }
-}
-
-/**
- * Print validation result to console
- */
-export function printValidationResult(result: ValidationResult, verbose: boolean = false): void {
-  for (const fileResult of result.results) {
-    if (fileResult.valid) {
-      if (verbose) {
-        console.log(`✓ ${fileResult.file}`);
-        console.log(`  ✓ Gherkin syntax valid`);
-        if (fileResult.warnings.length === 0) {
-          console.log(`  ✓ All checks passed`);
-        }
-      } else {
-        console.log(`✓ ${fileResult.file}`);
-      }
-    } else {
-      console.log(`✗ ${fileResult.file}`);
-    }
-
-    for (const warning of fileResult.warnings) {
-      const lineInfo = warning.line ? `:${warning.line}` : '';
-      console.log(`  ⊘ ${warning.message}${lineInfo}`);
-    }
-
-    for (const error of fileResult.errors) {
-      const lineInfo = error.line ? `:${error.line}` : '';
-      console.log(`  ✗ ${error.message}${lineInfo}`);
-    }
-
-    if (!fileResult.valid || (verbose && fileResult.warnings.length > 0)) {
-      console.log('');
-    }
-  }
-
-  console.log('\nSummary:');
-  console.log(`  Files: ${result.summary.totalFiles} total, ${result.summary.passedFiles} passed, ${result.summary.failedFiles} failed`);
-  console.log(`  Errors: ${result.summary.totalErrors}`);
-  console.log(`  Warnings: ${result.summary.totalWarnings}`);
-
-  if (result.summary.totalErrors > 0) {
-    const errorsByType = new Map<string, number>();
-    const errorsByFile = new Map<string, string[]>();
-
-    for (const fileResult of result.results) {
-      for (const error of fileResult.errors) {
-        errorsByType.set(error.code, (errorsByType.get(error.code) || 0) + 1);
-
-        if (error.code === 'MISSING_SELECTOR' || error.code === 'MISSING_DATA_REF') {
-          if (!errorsByFile.has(fileResult.file)) {
-            errorsByFile.set(fileResult.file, []);
-          }
-          if (error.element) {
-            errorsByFile.get(fileResult.file)!.push(error.element);
-          }
-        }
-      }
-    }
-
-    console.log('\nError Breakdown:');
-    for (const [code, count] of errorsByType.entries()) {
-      const description = getErrorDescription(code);
-      console.log(`  ${code}: ${count} ${description}`);
-    }
-
-    if (errorsByType.has('MISSING_SELECTOR_FILE') || errorsByType.has('MISSING_DATA_FILE')) {
-      console.log('\n💡 Suggested Fix:');
-      console.log('   Run: sungen map --screen <name>');
-      console.log('   This will generate missing selector and test-data files');
-    } else if (errorsByType.has('MISSING_SELECTOR') || errorsByType.has('MISSING_DATA_REF')) {
-      console.log('\n💡 Suggested Fix:');
-      if (errorsByType.has('MISSING_SELECTOR')) {
-        console.log('   Missing selectors - Add them to the selector YAML files');
-      }
-      if (errorsByType.has('MISSING_DATA_REF')) {
-        console.log('   Missing data refs - Add them to the test-data YAML files');
-      }
-    }
-  }
-
-  if (result.valid) {
-    console.log('\n✅ Validation passed');
-  } else {
-    console.log('\n❌ Validation failed');
-  }
-}

package/src/config/ai-providers.yaml

@@ -1,56 +0,0 @@
-# AI Provider Configuration
-
-providers:
-  # Claude - Best for DSL generation (cheap + fast)
-  claude:
-    generation:
-      model: "claude-3-haiku-20240307"
-      temperature: 0.2
-      maxTokens: 2048
-    vision:
-      model: "claude-3-sonnet-20240229"
-      temperature: 0.3
-      maxTokens: 4096
-
-  # OpenAI - Best for vision tasks
-  openai:
-    generation:
-      model: "gpt-4o-mini"
-      temperature: 0.2
-      maxTokens: 2048
-    vision:
-      model: "gpt-4o"
-      temperature: 0.3
-      maxTokens: 4096
-
-  # Gemini - Alternative provider
-  gemini:
-    generation:
-      model: "gemini-1.5-flash"
-      temperature: 0.2
-      maxTokens: 2048
-    vision:
-      model: "gemini-1.5-pro"
-      temperature: 0.3
-      maxTokens: 4096
-
-# Default provider for each task type
-defaults:
-  generation: "claude"
-  vision: "openai"
-  analysis: "claude"
-
-# Cost optimization (estimated cost per 1M tokens)
-costs:
-  claude-haiku:
-    input: 0.25
-    output: 1.25
-  gpt-4o-mini:
-    input: 0.15
-    output: 0.60
-  gpt-4o:
-    input: 2.50
-    output: 10.00
-  gemini-flash:
-    input: 0.075
-    output: 0.30

package/src/config/config-loader.ts

@@ -1,248 +0,0 @@
-/**
- * Configuration Loader
- * Loads and merges configuration from multiple sources with priority:
- * CLI Options > Custom Config File > Default Config File
- */
-
-import fs from 'fs';
-import path from 'path';
-import yaml from 'yaml';
-import { FrameworkConfig, CLIOptions, RuntimeConfig } from './config-schema';
-
-export class ConfigLoader {
-  private defaultConfigPath: string;
-
-  constructor() {
-    this.defaultConfigPath = path.join(__dirname, 'default.config.yaml');
-  }
-
-  /**
-   * Load runtime configuration with priority merging
-   * Priority: CLI > Custom File > Default File
-   */
-  load(cliOptions: CLIOptions = {}): RuntimeConfig {
-    // 1. Load default config
-    const defaultConfig = this.loadDefaultConfig();
-
-    // 2. Load custom config file if specified, or look for sungen.config.yaml in CWD
-    let fileConfig: Partial<FrameworkConfig> = {};
-    let configSource: 'default' | 'file' | 'cli' = 'default';
-
-    if (cliOptions.config) {
-      fileConfig = this.loadCustomConfig(cliOptions.config);
-      configSource = 'file';
-    } else {
-      // Try to load sungen.config.yaml from current working directory
-      const defaultConfigPath = path.join(process.cwd(), 'sungen.config.yaml');
-      if (fs.existsSync(defaultConfigPath)) {
-        fileConfig = this.loadCustomConfig(defaultConfigPath);
-        configSource = 'file';
-      }
-    }
-
-    // 3. Merge configs: default < file < CLI
-    const mergedConfig = this.mergeConfigs(defaultConfig, fileConfig, cliOptions);
-
-    // Override source if CLI has significant options
-    if (Object.keys(cliOptions).length > 0) {
-      configSource = 'cli';
-    }
-
-    return {
-      ...mergedConfig,
-      cliOptions,
-      configSource
-    };
-  }
-
-  /**
-   * Load default configuration from default.config.yaml
-   */
-  private loadDefaultConfig(): FrameworkConfig {
-    try {
-      const content = fs.readFileSync(this.defaultConfigPath, 'utf-8');
-      return yaml.parse(content) as FrameworkConfig;
-    } catch (error) {
-      throw new Error(`Failed to load default config: ${error}`);
-    }
-  }
-
-  /**
-   * Load custom configuration file
-   */
-  private loadCustomConfig(configPath: string): Partial<FrameworkConfig> {
-    try {
-      const fullPath = path.resolve(configPath);
-
-      if (!fs.existsSync(fullPath)) {
-        throw new Error(`Config file not found: ${fullPath}`);
-      }
-
-      const content = fs.readFileSync(fullPath, 'utf-8');
-      return yaml.parse(content) as Partial<FrameworkConfig>;
-    } catch (error) {
-      throw new Error(`Failed to load custom config: ${error}`);
-    }
-  }
-
-  /**
-   * Merge configurations with priority: CLI > File > Default
-   */
-  private mergeConfigs(
-    defaultConfig: FrameworkConfig,
-    fileConfig: Partial<FrameworkConfig>,
-    cliOptions: CLIOptions
-  ): FrameworkConfig {
-    // Deep merge default + file config
-    const merged = this.deepMerge(defaultConfig, fileConfig);
-
-    // Apply CLI overrides (highest priority)
-    if (cliOptions.verbose !== undefined) {
-      merged.verbose = cliOptions.verbose;
-    }
-
-    if (cliOptions.force !== undefined) {
-      merged.force = cliOptions.force;
-    }
-
-    if (cliOptions.depth !== undefined) {
-      merged.scanner.maxDepth = cliOptions.depth;
-    }
-
-    if (cliOptions.aiMapper !== undefined) {
-      merged.testGenerator.enableAIFallback = cliOptions.aiMapper;
-    }
-
-    if (cliOptions.framework !== undefined) {
-      merged.testGenerator.framework = cliOptions.framework;
-    }
-
-    // Selector mapping mode overrides
-    if (cliOptions.mode !== undefined) {
-      merged.selectorMapping.mode = cliOptions.mode;
-    }
-
-    return merged;
-  }
-
-  /**
-   * Deep merge two objects
-   */
-  private deepMerge<T>(target: T, source: Partial<T>): T {
-    const result = { ...target };
-
-    for (const key in source) {
-      const sourceValue = source[key];
-      const targetValue = result[key];
-
-      if (sourceValue === undefined) {
-        continue;
-      }
-
-      if (this.isObject(sourceValue) && this.isObject(targetValue)) {
-        result[key] = this.deepMerge(targetValue, sourceValue as any);
-      } else {
-        result[key] = sourceValue as any;
-      }
-    }
-
-    return result;
-  }
-
-  /**
-   * Check if value is a plain object
-   */
-  private isObject(value: any): value is Record<string, any> {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-  }
-
-  /**
-   * Validate configuration
-   */
-  validate(config: RuntimeConfig): void {
-    const errors: string[] = [];
-
-    // Validate required paths
-    if (!config.paths.sourceRoot) {
-      errors.push('paths.sourceRoot is required');
-    }
-
-    // Validate scanner
-    if (!['react', 'vue', 'angular'].includes(config.scanner.framework)) {
-      errors.push(`Invalid scanner.framework: ${config.scanner.framework}`);
-    }
-
-    if (config.scanner.maxDepth < 1) {
-      errors.push('scanner.maxDepth must be >= 1');
-    }
-
-    // Validate AI provider
-    if (!['anthropic', 'copilot', 'openai'].includes(config.selectorMapping.aiProvider)) {
-      errors.push(`Invalid selectorMapping.aiProvider: ${config.selectorMapping.aiProvider}`);
-    }
-
-    // Validate test framework
-    if (!['playwright', 'appium', 'integration'].includes(config.testGenerator.framework)) {
-      errors.push(`Invalid testGenerator.framework: ${config.testGenerator.framework}`);
-    }
-
-    if (errors.length > 0) {
-      throw new Error(`Configuration validation failed:\n${errors.join('\n')}`);
-    }
-  }
-
-  /**
-   * Get configuration value by path (dot notation)
-   * Example: get('scanner.maxDepth')
-   */
-  get(config: RuntimeConfig, path: string): any {
-    return path.split('.').reduce((obj, key) => obj?.[key], config as any);
-  }
-
-  /**
-   * Display current configuration (for debugging)
-   */
-  display(config: RuntimeConfig): string {
-    const displayed = {
-      version: config.version,
-      source: config.configSource,
-      verbose: config.verbose,
-      force: config.force,
-      scanner: {
-        framework: config.scanner.framework,
-        maxDepth: config.scanner.maxDepth
-      },
-      selectorMapping: {
-        aiProvider: config.selectorMapping.aiProvider,
-        model: config.selectorMapping.model
-      },
-      testGenerator: {
-        framework: config.testGenerator.framework,
-        aiProvider: config.testGenerator.aiProvider,
-        enableAIFallback: config.testGenerator.enableAIFallback
-      },
-      cache: {
-        enabled: config.cache.enabled
-      }
-    };
-
-    return yaml.stringify(displayed);
-  }
-}
-
-// Singleton instance
-let configLoader: ConfigLoader;
-
-export function getConfigLoader(): ConfigLoader {
-  if (!configLoader) {
-    configLoader = new ConfigLoader();
-  }
-  return configLoader;
-}
-
-export function loadConfig(cliOptions: CLIOptions = {}): RuntimeConfig {
-  const loader = getConfigLoader();
-  const config = loader.load(cliOptions);
-  loader.validate(config);
-  return config;
-}