qa360 2.2.1 → 2.2.13

package/core/src/generation/crawler-pack-generator.ts

@@ -1,289 +0,0 @@
-/**
- * QA360 Crawler Pack Generator
- *
- * Crawls a website and generates a complete pack.yml with E2E tests
- */
-
-import { writeFileSync, mkdirSync, existsSync } from 'fs';
-import { resolve, dirname } from 'path';
-import type { CrawlOptions, CrawlResult, UserJourney, SiteMap, PageDefinition } from '../crawler/index.js';
-import { WebCrawler, crawlWebsite } from '../crawler/index.js';
-import type { PackConfigV1, UiTestDefinition, UiTestStep } from '../types/pack-v1.js';
-
-/**
- * Crawler Pack Generator Options
- */
-export interface CrawlerPackGeneratorOptions {
-  /** Base URL to crawl */
-  baseUrl: string;
-
-  /** Output pack file path */
-  output?: string;
-
-  /** Crawl options */
-  crawl?: Partial<CrawlOptions>;
-
-  /** Pack name */
-  packName?: string;
-
-  /** Include accessibility tests */
-  includeA11y?: boolean;
-
-  /** Include performance tests */
-  includePerf?: boolean;
-
-  /** Include security tests */
-  includeSecurity?: boolean;
-
-  /** Custom journey names */
-  journeyNames?: Record<string, string>;
-}
-
-/**
- * Generate pack.yml from crawled website
- */
-export async function generatePackFromCrawl(
-  options: CrawlerPackGeneratorOptions
-): Promise<{ success: boolean; packPath?: string; result?: CrawlResult; error?: string }> {
-  try {
-    console.log(`🕷️  Crawling ${options.baseUrl}...`);
-
-    // Crawl the website
-    const crawlResult = await crawlWebsite({
-      baseUrl: options.baseUrl,
-      maxDepth: options.crawl?.maxDepth || 2,
-      maxPages: options.crawl?.maxPages || 20,
-      headless: options.crawl?.headless ?? true,
-      screenshots: false,
-      timeout: 30000,
-      excludePatterns: options.crawl?.excludePatterns,
-    });
-
-    if (!crawlResult.success) {
-      return {
-        success: false,
-        result: crawlResult,
-        error: 'Crawling failed',
-      };
-    }
-
-    console.log(`  ✅ Discovered ${crawlResult.siteMap.metadata.pagesCrawled} pages`);
-    console.log(`  ✅ Found ${crawlResult.forms.length} forms`);
-    console.log(`  ✅ Generated ${crawlResult.userJourneys.length} user journeys`);
-
-    // Generate pack.yml
-    const pack = generatePackFromCrawlResult(crawlResult, options);
-
-    // Write pack file
-    const packPath = options.output || resolve(process.cwd(), 'pack.yml');
-    const packDir = dirname(packPath);
-
-    if (!existsSync(packDir)) {
-      mkdirSync(packDir, { recursive: true });
-    }
-
-    writeFileSync(packPath, pack, 'utf-8');
-
-    console.log(`\n📦 Generated pack: ${packPath}`);
-
-    return {
-      success: true,
-      packPath,
-      result: crawlResult,
-    };
-
-  } catch (error) {
-    return {
-      success: false,
-      error: error instanceof Error ? error.message : String(error),
-    };
-  }
-}
-
-/**
- * Generate pack.yml YAML from crawl result
- */
-function generatePackFromCrawlResult(
-  crawlResult: CrawlResult,
-  options: CrawlerPackGeneratorOptions
-): string {
-  const { siteMap, userJourneys, forms } = crawlResult;
-  const packName = options.packName || `${new URL(options.baseUrl).hostname.replace(/\./g, '-')}-tests`;
-
-  // Build gates array
-  const gates: string[] = ['ui'];
-  if (options.includeA11y) gates.push('a11y');
-
-  // Build UI tests from user journeys
-  const uiTests: UiTestDefinition[] = userJourneys.map((journey, index) => ({
-    name: options.journeyNames?.[journey.name] || journey.name,
-    description: journey.description,
-    path: new URL(journey.entryPoint).pathname,
-    steps: journey.steps.map((step, stepIndex) => journeyStepToUiTestStep(step, stepIndex)),
-  }));
-
-  // Also add form-based tests
-  for (const form of forms) {
-    if (form.purpose !== 'login' && form.purpose !== 'signup') {
-      uiTests.push({
-        name: `${form.purpose.charAt(0).toUpperCase() + form.purpose.slice(1)} Form Test`,
-        description: `Test the ${form.purpose} form`,
-        path: siteMap.pages.find(p => p.elements.forms.includes(form))?.path || '/',
-        steps: generateFormTestSteps(form),
-      });
-    }
-  }
-
-  // Generate YAML
-  let yaml = `# QA360 Pack - Generated by crawler
-# Source: ${options.baseUrl}
-# Generated: ${new Date().toISOString()}
-
-version: 1
-name: "${packName}"
-description: "Auto-generated E2E tests for ${new URL(options.baseUrl).hostname}"
-
-gates:
-${gates.map(g => `  - ${g}`).join('\n')}
-
-targets:
-  web:
-    baseUrl: "${options.baseUrl}"
-    headless: true
-    screenshot: "only-on-fail"
-    video: "retain-on-fail"
-
-    # Pages discovered by crawler
-    pages:
-${siteMap.pages.map(p => `      - "${p.path}"`).join('\n')}
-
-    # E2E UI tests generated from discovered user journeys
-    uiTests:
-${uiTests.map(test => generateUiTestYaml(test)).join('\n')}
-`;
-
-  if (siteMap.metadata.pagesCrawled > 0) {
-    yaml += `
-budgets:
-  a11y_min: 80
-  perf_p95_ms: ${Math.round(siteMap.metadata.avgLoadTime * 1.5)}
-`;
-  }
-
-  return yaml;
-}
-
-/**
- * Convert journey step to UI test step
- */
-function journeyStepToUiTestStep(step: any, index: number): UiTestStep {
-  const uiStep: UiTestStep = {
-    order: index + 1,
-    action: step.action,
-    description: step.description,
-    selector: step.selector,
-    value: step.value,
-    wait: 500,
-  };
-
-  if (step.expected) {
-    uiStep.expected = {};
-    if (step.expected.url) uiStep.expected.url = step.expected.url;
-    if (step.expected.visible) uiStep.expected.visible = step.expected.visible;
-  }
-
-  return uiStep;
-}
-
-/**
- * Generate test steps for a form
- */
-function generateFormTestSteps(form: any): UiTestStep[] {
-  const steps: UiTestStep[] = [];
-
-  // Navigate to form
-  steps.push({
-    order: 1,
-    action: 'navigate',
-    description: 'Navigate to form',
-    value: form.selector,
-  });
-
-  // Fill form fields
-  for (const field of form.fields) {
-    if (field.required) {
-      const step: UiTestStep = {
-        order: steps.length + 1,
-        action: field.inputType === 'select-one' ? 'select' : 'fill',
-        description: `Fill ${field.name || field.inputType}`,
-        selector: field.selector,
-      };
-
-      if (field.inputType === 'select-one' && field.options && field.options.length > 0) {
-        step.value = field.options[0];
-      } else if (field.inputType === 'email') {
-        step.value = 'test@example.com';
-      } else if (field.inputType === 'tel') {
-        step.value = '+1234567890';
-      } else if (field.inputType === 'checkbox') {
-        step.action = 'check';
-      } else {
-        step.value = 'Test value';
-      }
-
-      steps.push(step);
-    }
-  }
-
-  // Submit form
-  if (form.submitButton) {
-    steps.push({
-      order: steps.length + 1,
-      action: 'click',
-      description: 'Submit form',
-      selector: form.submitButton.selector,
-      wait: 1000,
-    });
-  }
-
-  return steps;
-}
-
-/**
- * Generate YAML for a UI test definition
- */
-function generateUiTestYaml(test: UiTestDefinition): string {
-  const steps = test.steps.map(step => {
-    let yaml = `      - action: ${step.action}`;
-    if (step.description) yaml += `\n        description: "${step.description}"`;
-    if (step.selector) yaml += `\n        selector: "${step.selector}"`;
-    if (step.value) yaml += `\n        value: "${step.value}"`;
-    if (step.expected) yaml += `\n        expected: ${JSON.stringify(step.expected)}`;
-    if (step.wait) yaml += `\n        wait: ${step.wait}`;
-    return yaml;
-  }).join('\n');
-
-  return `    - name: "${test.name}"
-      description: "${test.description || ''}"
-      path: "${test.path || '/'}"
-      steps:
-${steps}`;
-}
-
-/**
- * Quick crawl - generates pack without detailed analysis
- */
-export async function quickCrawl(
-  baseUrl: string,
-  outputPath?: string
-): Promise<{ success: boolean; packPath?: string; error?: string }> {
-  return generatePackFromCrawl({
-    baseUrl,
-    output: outputPath,
-    crawl: {
-      maxDepth: 1,
-      maxPages: 10,
-    },
-    includeA11y: true,
-  });
-}

package/core/src/generation/generator.ts

@@ -1,113 +0,0 @@
-/**
- * QA360 Test Generator - Convenience Functions
- *
- * High-level functions for test generation.
- * These are the main entry points for the generation module.
- */
-
-import { CodeGenerator, type CodeGeneratorOptions, type GenerationResult } from './code-generator.js';
-import { TestOptimizer, type OptimizationOptions } from './test-optimizer.js';
-import type { GenerationSource, GeneratedTest } from './types.js';
-
-/**
- * Generate tests from various sources with optimization
- */
-export async function generateTests(
-  source: GenerationSource,
-  options: CodeGeneratorOptions & { optimize?: boolean; optimizationOptions?: OptimizationOptions } = {}
-): Promise<GenerationResult> {
-  const { optimize = false, optimizationOptions, ...generatorOptions } = options;
-
-  // Generate tests
-  const generator = new CodeGenerator(generatorOptions);
-  let result = await generator.generateFromSource(source, {});
-
-  if (!result.success) {
-    return result;
-  }
-
-  // Optimize if requested
-  if (optimize) {
-    const optimizer = new TestOptimizer(optimizationOptions);
-    const optimization = optimizer.optimize(result.tests);
-
-    result.tests = optimization.optimized;
-    if (result.warnings) {
-      result.warnings.push(...optimization.improvements);
-    } else {
-      result.warnings = optimization.improvements;
-    }
-  }
-
-  return result;
-}
-
-/**
- * Generate API tests from OpenAPI spec
- */
-export async function generateApiTestsFromOpenAPI(
-  specPath: string,
-  options?: CodeGeneratorOptions
-): Promise<GenerationResult> {
-  const generator = new CodeGenerator(options);
-  return generator.generateFromOpenAPI(specPath, { framework: 'playwright' });
-}
-
-/**
- * Generate UI tests from URL
- */
-export async function generateUiTestsFromUrl(
-  url: string,
-  options?: CodeGeneratorOptions
-): Promise<GenerationResult> {
-  const generator = new CodeGenerator(options);
-  return generator.generateFromUrl(url, { framework: 'playwright' });
-}
-
-/**
- * Generate performance tests
- */
-export async function generatePerfTests(
-  specPath: string,
-  options?: CodeGeneratorOptions
-): Promise<GenerationResult> {
-  const generator = new CodeGenerator(options);
-  return generator.generateFromOpenAPI(specPath, { framework: 'k6' });
-}
-
-/**
- * Generate unit tests from code
- */
-export async function generateUnitTests(
-  code: string,
-  language: string,
-  options?: CodeGeneratorOptions
-): Promise<GenerationResult> {
-  const generator = new CodeGenerator(options);
-  return generator.generateFromCode(code, language, {
-    framework: language === 'typescript' ? 'vitest' : 'jest',
-  });
-}
-
-/**
- * Check if Ollama is available for generation
- */
-export async function checkGenerationAvailability(): Promise<{
-  available: boolean;
-  models: string[];
-  recommended: string;
-}> {
-  const generator = new CodeGenerator();
-
-  const available = await generator.isAvailable();
-  if (!available) {
-    return { available: false, models: [], recommended: 'deepseek-coder' };
-  }
-
-  const models = await generator.listModels();
-  const recommended = models.find(m =>
-    m.includes('deepseek') || m.includes('codellama') || m.includes('qwen')
-  ) || models[0] || 'deepseek-coder';
-
-  return { available, models, recommended };
-}

package/core/src/generation/index.ts

@@ -1,59 +0,0 @@
-/**
- * QA360 AI Test Generation Module
- *
- * Generates test code from various sources using LLM.
- * Phase 4 of AI Integration Roadmap.
- *
- * Components:
- * - PromptBuilder: Build effective prompts for LLM
- * - CodeGenerator: Generate test code from prompts
- * - CodeFormatter: Format and validate generated code
- * - TestOptimizer: Optimize generated tests
- * - PackGenerator: Convert specs to QA360 pack YAML
- * - SourceAnalyzer: Analyze source code for test requirements
- *
- * Supported Generators:
- * - Playwright API tests (TypeScript)
- * - Playwright UI tests (TypeScript)
- * - K6 performance tests (JavaScript)
- * - Vitest unit tests (TypeScript)
- */
-
-export { PromptBuilder, PromptBuilderOptions, type BuiltPrompt } from './prompt-builder.js';
-export { CodeGenerator, CodeGeneratorOptions, type GeneratedTestInternal, type GenerationResult } from './code-generator.js';
-export { CodeFormatter, FormatterConfig, type FormatResult } from './code-formatter.js';
-export { TestOptimizer, OptimizationOptions, type OptimizationResult } from './test-optimizer.js';
-export { PackGenerator, generatePackFromApiSpec, generatePackFromUiSpec, generatePackFromPerfSpec } from './pack-generator.js';
-export { SourceAnalyzer, analyzeSourceFile, analyzeSourceDirectory, generateTestSpec } from './source-analyzer.js';
-export type { PackGeneratorOptions, PackGenerationResult } from './pack-generator.js';
-export type { SourceAnalysis, SourceAnalyzerOptions, TestSuggestion } from './source-analyzer.js';
-
-// Types
-export type {
-  TestSpec,
-  ApiTestSpec,
-  UiTestSpec,
-  PerfTestSpec,
-  UnitTestSpec,
-  GenerationContext,
-  GeneratedTest,
-  GenerationSource,
-  GenerationOptions,
-} from './types.js';
-
-// Convenience functions
-export {
-  generateTests,
-  generateApiTestsFromOpenAPI,
-  generateUiTestsFromUrl,
-  generatePerfTests,
-  generateUnitTests,
-  checkGenerationAvailability,
-} from './generator.js';
-
-// Crawler Pack Generator (UI Testing 100%)
-export {
-  generatePackFromCrawl,
-  quickCrawl,
-} from './crawler-pack-generator.js';
-export type { CrawlerPackGeneratorOptions } from './crawler-pack-generator.js';