@sun-asterisk/sungen 1.0.19 → 1.0.21

package/src/input/cli-adapter.ts

@@ -1,233 +0,0 @@
-/**
- * CLI Input Adapter
- * Parses command-line arguments into CLIOptions
- */
-
-import { Command } from 'commander';
-import { CLIOptions } from '../config/config-schema';
-import { InputAdapter, InputSource } from './input-adapter';
-
-export class CLIAdapter implements InputAdapter {
-  name = InputSource.CLI;
-
-  /**
-   * Parse CLI arguments into options
-   */
-  parse(argv?: string[]): CLIOptions {
-    // This will be called by commander when parsing CLI
-    // For now, return empty options (will be populated by commander)
-    return {};
-  }
-
-  /**
-   * Validate CLI arguments format
-   */
-  validate(): boolean {
-    // Commander handles validation
-    return true;
-  }
-
-  /**
-   * Create commander program with all commands
-   */
-  createProgram(): Command {
-    const program = new Command();
-
-    program
-      .name('sungen')
-      .description('AI-Native E2E Test Generator - Generate Playwright tests from Gherkin features')
-      .version('1.0.19');
-
-    // Global options
-    program
-      .option('-c, --config <path>', 'Path to custom config file')
-      .option('-v, --verbose', 'Enable verbose logging')
-      .option('-f, --force', 'Force regeneration, bypass cache');
-
-    return program;
-  }
-
-  /**
-   * Add discover command
-   */
-  addDiscoverCommand(program: Command): Command {
-    return program
-      .command('discover')
-      .description('Discover UI elements and generate UI model')
-      .requiredOption('-s, --screen <name>', 'Screen name to discover')
-      .option('-d, --depth <number>', 'Component scan depth (default: unlimited)', '999')
-      .option('-f, --force', 'Force rescan, bypass cache')
-      .option('--mode <type>', 'Mapping mode: hybrid, ai-only, heuristic-only')
-      .option('--ai-only', 'Force AI-only mapping (bypass heuristics)')
-      .option('--heuristic-only', 'Force heuristic-only mapping (no AI fallback)');
-  }
-
-  /**
-   * Add generate-tests command
-   */
-  addGenerateTestsCommand(program: Command): Command {
-    return program
-      .command('generate-tests')
-      .description('Generate E2E test scripts from Gherkin features')
-      .option('--ai-mapper', 'Enable AI fallback for unknown Gherkin patterns')
-      .option('--framework <name>', 'Test framework (playwright, appium, integration)', 'playwright');
-  }
-
-  /**
-   * Add map command (generate selector and test-data YAML from Gherkin)
-   */
-  addMapCommand(program: Command): Command {
-    return 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')
-      .option('--scan-live', 'Run live-scan before mapping to detect real selectors')
-      .option('--headed', 'Launch browser in headed mode (only with --scan-live)', false)
-      .option('--auth-dir <path>', 'Auth storage state directory (only with --scan-live)', 'specs/.auth')
-      .option('-v, --verbose', 'Detailed output');
-  }
-
-  /**
-   * Add generate command (test code generation)
-   */
-  addGenerateCommand(program: Command): Command {
-    return 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');
-  }
-
-  /**
-   * Add full command
-   */
-  addFullCommand(program: Command): Command {
-    return program
-      .command('full')
-      .description('Run full pipeline (discover + map + generate)')
-      .option('-s, --screen <name>', 'Process specific screen (optional)')
-      .option('-d, --depth <number>', 'Component scan depth (default: unlimited)', '999')
-      .option('-f, --force', 'Force regeneration, bypass cache')
-      .option('--mode <type>', 'Mapping mode: hybrid, ai-only, heuristic-only')
-      .option('--ai-only', 'Force AI-only mapping (bypass heuristics)')
-      .option('--heuristic-only', 'Force heuristic-only mapping (no AI fallback)');
-  }
-
-  /**
-   * Add init command
-   */
-  addInitCommand(program: Command): Command {
-    return program
-      .command('init [projectName]')
-      .description('Initialize Sungen project (optionally create and initialize in a new project folder)');
-  }
-
-  /**
-   * Add cache-clear command
-   */
-  addCacheCommand(program: Command): Command {
-    return program
-      .command('cache-clear')
-      .description('Clear all caches');
-  }
-
-  /**
-   * Add auto-tag command
-   */
-  addAutoTagCommand(program: Command): Command {
-    return program
-      .command('auto-tag')
-      .description('Auto-inject stable data-testid attributes into source code')
-      .option('-s, --screen <name>', 'Tag specific screen (optional, defaults to all)')
-      .option('--dry-run', 'Preview changes without modifying files')
-      .option('--force', 'Overwrite existing data-testid attributes')
-      .option('-v, --verbose', 'Show detailed output');
-  }
-
-  /**
-   * Add live-scan command
-   */
-  addLiveScanCommand(program: Command): Command {
-    return 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>', 'Base URL of the running site')
-      .option('--headed', 'Launch browser in headed (visible) mode')
-      .option('--auth-dir <path>', 'Directory containing auth storage state files (default: specs/.auth)');
-  }
-
-  /**
-   * Add add --screen command
-   */
-  addAddScreenCommand(program: Command): Command {
-    return 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');
-  }
-
-  /**
-   * Add validate command
-   */
-  addValidateCommand(program: Command): Command {
-    return 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');
-  }
-
-  /**
-   * Add makeauth command - Generate auth state for E2E tests
-   */
-  addMakeAuthCommand(program: Command): Command {
-    return program
-      .command('makeauth <name>')
-      .description('Generate auth state by opening browser for manual SSO login')
-      .option('-u, --url <url>', 'Base URL of the application')
-      .option('-p, --path <path>', 'Login page path (default: /login)')
-      .option('-o, --output <dir>', 'Output directory (default: specs/.auth)')
-      .option('-t, --timeout <ms>', 'Overall timeout in milliseconds (default: 180000)')
-      .option('--nav-timeout <ms>', 'Navigation timeout in milliseconds (default: 180000)')
-      .option('--stability-wait <ms>', 'URL stability wait in milliseconds (default: 5000)')
-      .option('--headless', 'Run browser in headless mode')
-      .option('--verify', 'Verify existing auth state instead of creating new')
-      .option('--list', 'List all existing auth states')
-      .option('--export', 'Export auth state as base64 for CI');
-  }
-
-  /**
-   * Extract options from commander Command
-   */
-  extractOptions(command: Command): CLIOptions {
-    const opts = command.opts();
-
-    // Determine mode from flags
-    let mode: 'hybrid' | 'ai-only' | 'heuristic-only' | undefined = opts.mode;
-    if (opts.aiOnly) mode = 'ai-only';
-    if (opts.heuristicOnly) mode = 'heuristic-only';
-
-    return {
-      screen: opts.screen,
-      depth: opts.depth ? parseInt(opts.depth, 10) : undefined,
-      force: opts.force,
-      aiMapper: opts.aiMapper,
-      framework: opts.framework,
-      mode,
-      aiOnly: opts.aiOnly,
-      heuristicOnly: opts.heuristicOnly,
-      verbose: opts.verbose,
-      config: opts.config
-    };
-  }
-}

package/src/input/config-adapter.ts

@@ -1,71 +0,0 @@
-/**
- * Config File Input Adapter
- * Parses configuration from YAML/JSON files
- */
-
-import fs from 'fs';
-import path from 'path';
-import yaml from 'yaml';
-import { CLIOptions } from '../config/config-schema';
-import { InputAdapter, InputSource } from './input-adapter';
-
-export class ConfigAdapter implements InputAdapter {
-  name = InputSource.FILE;
-  private configPath: string;
-
-  constructor(configPath: string) {
-    this.configPath = path.resolve(configPath);
-  }
-
-  /**
-   * Parse config file into CLIOptions
-   * Note: Full config is loaded by ConfigLoader, this just validates the file
-   */
-  parse(): CLIOptions {
-    if (!this.validate()) {
-      throw new Error(`Invalid config file: ${this.configPath}`);
-    }
-
-    // Return empty options - actual config loading is done by ConfigLoader
-    // This adapter is mainly for validation
-    return {
-      config: this.configPath
-    };
-  }
-
-  /**
-   * Validate config file exists and is valid YAML/JSON
-   */
-  validate(): boolean {
-    try {
-      if (!fs.existsSync(this.configPath)) {
-        console.error(`Config file not found: ${this.configPath}`);
-        return false;
-      }
-
-      const content = fs.readFileSync(this.configPath, 'utf-8');
-      const ext = path.extname(this.configPath);
-
-      if (ext === '.yaml' || ext === '.yml') {
-        yaml.parse(content);
-      } else if (ext === '.json') {
-        JSON.parse(content);
-      } else {
-        console.error(`Unsupported config file format: ${ext}`);
-        return false;
-      }
-
-      return true;
-    } catch (error) {
-      console.error(`Config file validation failed: ${error}`);
-      return false;
-    }
-  }
-
-  /**
-   * Get config file path
-   */
-  getPath(): string {
-    return this.configPath;
-  }
-}

package/src/input/input-adapter.ts

@@ -1,32 +0,0 @@
-/**
- * Input Adapter Interface
- * Defines how input sources provide configuration and commands
- */
-
-import { CLIOptions } from '../config/config-schema';
-
-export interface InputAdapter {
-  /**
-   * Adapter name (for logging/debugging)
-   */
-  name: string;
-
-  /**
-   * Parse input and return CLI options
-   */
-  parse(...args: any[]): CLIOptions;
-
-  /**
-   * Validate input format
-   */
-  validate(): boolean;
-}
-
-/**
- * Input source types
- */
-export enum InputSource {
-  CLI = 'cli',
-  FILE = 'file',
-  VSCODE = 'vscode'
-}

package/src/input/vscode-adapter.ts

@@ -1,90 +0,0 @@
-/**
- * VS Code Extension Input Adapter
- * Handles input from VS Code extension commands
- *
- * This is a placeholder for future VS Code extension integration
- * The extension will call framework methods directly via this adapter
- */
-
-import { CLIOptions } from '../config/config-schema';
-import { InputAdapter, InputSource } from './input-adapter';
-
-export class VSCodeAdapter implements InputAdapter {
-  name = InputSource.VSCODE;
-
-  /**
-   * Parse VS Code extension command into options
-   *
-   * @param command - VS Code command object
-   * @example
-   * // From VS Code extension:
-   * const options = vscodeAdapter.parse({
-   *   action: 'discover',
-   *   screen: 'chat',
-   *   depth: 999
-   * });
-   */
-  parse(command: VSCodeCommand): CLIOptions {
-    return {
-      screen: command.screen,
-      depth: command.depth,
-      force: command.force,
-      aiMapper: command.aiMapper,
-      framework: command.framework,
-      verbose: command.verbose,
-      config: command.config
-    };
-  }
-
-  /**
-   * Validate VS Code command format
-   */
-  validate(): boolean {
-    // VS Code extension will handle validation
-    return true;
-  }
-
-  /**
-   * Execute framework command from VS Code
-   * This will be the main entry point for VS Code extension
-   *
-   * @param command - VS Code command
-   * @returns Result object with success/error information
-   */
-  async execute(command: VSCodeCommand): Promise<VSCodeResult> {
-    // This will be implemented when VS Code extension is built
-    // It will call the orchestrator pipeline with parsed options
-
-    return {
-      success: false,
-      message: 'VS Code adapter not yet implemented',
-      data: null
-    };
-  }
-}
-
-/**
- * VS Code Command Interface
- * Defines the structure of commands sent from VS Code extension
- */
-export interface VSCodeCommand {
-  action: 'discover' | 'generate' | 'full' | 'cache-clear';
-  screen?: string;
-  depth?: number;
-  force?: boolean;
-  aiMapper?: boolean;
-  framework?: 'playwright' | 'appium' | 'integration';
-  verbose?: boolean;
-  config?: string;
-}
-
-/**
- * VS Code Result Interface
- * Defines the structure of results returned to VS Code extension
- */
-export interface VSCodeResult {
-  success: boolean;
-  message: string;
-  data: any;
-  errors?: string[];
-}