qa360 2.0.11 → 2.0.13

package/dist/core/generation/crawler-pack-generator.js

@@ -0,0 +1,231 @@
+/**
+ * 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 { crawlWebsite } from '../crawler/index.js';
+/**
+ * Generate pack.yml from crawled website
+ */
+export async function generatePackFromCrawl(options) {
+    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, options) {
+    const { siteMap, userJourneys, forms } = crawlResult;
+    const packName = options.packName || `${new URL(options.baseUrl).hostname.replace(/\./g, '-')}-tests`;
+    // Build gates array
+    const gates = ['ui'];
+    if (options.includeA11y)
+        gates.push('a11y');
+    // Build UI tests from user journeys
+    const uiTests = 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, index) {
+    const uiStep = {
+        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) {
+    const steps = [];
+    // 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 = {
+                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) {
+    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, outputPath) {
+    return generatePackFromCrawl({
+        baseUrl,
+        output: outputPath,
+        crawl: {
+            maxDepth: 1,
+            maxPages: 10,
+        },
+        includeA11y: true,
+    });
+}

package/dist/core/generation/index.d.ts

@@ -28,3 +28,5 @@ export type { PackGeneratorOptions, PackGenerationResult } from './pack-generato
 export type { SourceAnalysis, SourceAnalyzerOptions, TestSuggestion } from './source-analyzer.js';
 export type { TestSpec, ApiTestSpec, UiTestSpec, PerfTestSpec, UnitTestSpec, GenerationContext, GeneratedTest, GenerationSource, GenerationOptions, } from './types.js';
 export { generateTests, generateApiTestsFromOpenAPI, generateUiTestsFromUrl, generatePerfTests, generateUnitTests, checkGenerationAvailability, } from './generator.js';
+export { generatePackFromCrawl, quickCrawl, } from './crawler-pack-generator.js';
+export type { CrawlerPackGeneratorOptions } from './crawler-pack-generator.js';

package/dist/core/generation/index.js

@@ -26,3 +26,5 @@ export { PackGenerator, generatePackFromApiSpec, generatePackFromUiSpec, generat
 export { SourceAnalyzer, analyzeSourceFile, analyzeSourceDirectory, generateTestSpec } from './source-analyzer.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';

package/dist/core/index.d.ts

@@ -93,3 +93,6 @@ export * from './self-healing/index.js';
 export * from './coverage/index.js';
 export * from './slo/index.js';
 export * from './regression/index.js';
+export * from './crawler/index.js';
+export { AssertionsEngine, createAssertionsEngine, AssertionResult, AssertionGroupResult, AssertionRunOptions, AssertionError, SoftAssertionError, Assertion, AssertionOperator, AssertionSuite, } from './assertions/index.js';
+export type { AssertionType as UiAssertionType } from './assertions/types.js';

package/dist/core/index.js

@@ -76,3 +76,7 @@ export * from './coverage/index.js';
 export * from './slo/index.js';
 // Regression Detection Module (Vision 2.0 - Phase 2 - F12)
 export * from './regression/index.js';
+// Crawler Module (Vision 2.0 - UI Testing 100%)
+export * from './crawler/index.js';
+// Assertions Engine (Vision 2.0 - UI Testing 100%)
+export { AssertionsEngine, createAssertionsEngine, AssertionError, SoftAssertionError, } from './assertions/index.js';

package/dist/core/types/pack-v1.d.ts

@@ -13,6 +13,96 @@ export interface ApiTarget {
 export interface WebTarget {
     baseUrl: string;
     pages?: string[];
+    /** Browser mode: true for headed (visible), false for headless (default) */
+    headless?: boolean;
+    /** Slow motion delay in ms between actions (for debugging) */
+    slowMo?: number;
+    /** Viewport size */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Screenshot mode: 'always', 'never', 'only-on-fail' (default) */
+    screenshot?: 'always' | 'never' | 'only-on-fail';
+    /** Video recording mode: 'always', 'never' (default), 'retain-on-fail' */
+    video?: 'always' | 'never' | 'retain-on-fail';
+    /** Trace mode: 'always', 'never' (default), 'retain-on-fail' */
+    trace?: 'always' | 'never' | 'retain-on-fail';
+    /** Device emulation */
+    device?: 'desktop' | 'mobile' | 'tablet';
+    /** Browser to use: 'chromium' (default), 'firefox', 'webkit' */
+    browser?: 'chromium' | 'firefox' | 'webkit';
+    /** UI test definitions */
+    uiTests?: UiTestDefinition[];
+}
+/** UI Test Step Action */
+export type UiAction = 'navigate' | 'click' | 'dblClick' | 'rightClick' | 'hover' | 'focus' | 'fill' | 'type' | 'clear' | 'select' | 'check' | 'uncheck' | 'upload' | 'press' | 'waitFor' | 'waitForSelector' | 'waitForNavigation' | 'waitForTimeout' | 'scroll' | 'dragAndDrop' | 'tap';
+/** UI Test Step */
+export interface UiTestStep {
+    /** Step order */
+    order?: number;
+    /** Action to perform */
+    action: UiAction;
+    /** CSS selector for element */
+    selector?: string;
+    /** Value to input */
+    value?: string;
+    /** Options for the action */
+    options?: Record<string, any>;
+    /** Expected outcome after this step */
+    expected?: {
+        /** Expected URL */
+        url?: string;
+        /** URL contains string */
+        urlContains?: string;
+        /** Expected visible element */
+        visible?: string;
+        /** Expected hidden element */
+        hidden?: string;
+        /** Expected text content */
+        text?: string;
+        /** Expected element text content */
+        elementText?: {
+            selector: string;
+            text: string;
+        };
+    };
+    /** Wait time in ms after action */
+    wait?: number;
+    /** Description of what this step does */
+    description?: string;
+}
+/** UI Test Definition */
+export interface UiTestDefinition {
+    /** Test name */
+    name: string;
+    /** Starting path (relative to baseUrl) */
+    path?: string;
+    /** Full URL (overrides baseUrl + path) */
+    url?: string;
+    /** Test steps */
+    steps: UiTestStep[];
+    /** Description */
+    description?: string;
+    /** Whether this test is enabled */
+    enabled?: boolean;
+    /** Test timeout in ms */
+    timeout?: number;
+    /** Tags for organizing tests */
+    tags?: string[];
+}
+/** Assertion for UI tests */
+export interface UiAssertion {
+    /** Assertion type */
+    type: 'visible' | 'hidden' | 'text' | 'contains' | 'value' | 'attribute' | 'class' | 'count' | 'url' | 'title' | 'enabled' | 'disabled' | 'checked' | 'focused';
+    /** CSS selector */
+    selector?: string;
+    /** Expected value */
+    expected?: any;
+    /** Whether to negate */
+    not?: boolean;
+    /** Timeout in ms */
+    timeout?: number;
 }
 export interface PackTargets {
     api?: ApiTarget;

package/dist/index.js

@@ -32,9 +32,10 @@ import { coverageCommand } from './commands/coverage.js';
 import { sloCommand } from './commands/slo.js';
 import { regressionCommand } from './commands/regression.js';
 import { createRetryCommands } from './commands/retry.js';
+import { createCrawlCommand } from './commands/crawl.js';
 // import { createMonitorCommands } from './commands/monitor.js'; // TODO: Re-enable monitor imports
 // import { createOllamaCommands } from './commands/ollama.js'; // TODO: Re-enable when Ollama exports from core are fixed
-// import { createGenerateCommands } from './commands/generate.js'; // TODO: fix generation imports
+import { createGenerateCommands } from './commands/generate.js';
 // import { createRepairCommand } from './commands/repair.js'; // TODO: fix repair imports
 const program = new Command();
 program
@@ -99,6 +100,7 @@ program
     .option('--retries <number>', 'Number of retries for failed tests', '2')
     .option('--timeout <ms>', 'Global timeout for tests in milliseconds', '30000')
     .option('--docker', 'Use Docker fallback for missing tools')
+    .option('--headed', 'Run UI tests in headed mode (visible browser)')
     .action(async (pack, options) => {
     await runCommand(pack, options);
 });
@@ -212,7 +214,7 @@ program.addCommand(createFlakinessCommands());
 program.addCommand(createAICommands());
 // program.addCommand(createOllamaCommands()); // TODO: Re-enable when Ollama exports from core are fixed
 // Generate AI commands (Phase 4)
-// program.addCommand(createGenerateCommands()); // TODO: Re-enable after fixing imports
+program.addCommand(createGenerateCommands());
 // Repair Commands (Phase 7 - Auto-Repair)
 // program.addCommand(createRepairCommand()); // TODO: Re-enable after fixing imports
 // Monitor Commands (Phase 8 - TUI & Dashboard)
@@ -226,6 +228,8 @@ program.addCommand(sloCommand);
 program.addCommand(regressionCommand);
 // Retry Commands (Vision 2.0 - Phase 2 - F8 Smart Retry)
 program.addCommand(createRetryCommands());
+// Crawl Command (UI Testing 100% - Auto-generate packs from websites)
+program.addCommand(createCrawlCommand());
 // Show banner
 console.log(chalk.bold.blue('QA360 Core v' + version));
 console.log(chalk.gray('Transform software testing into verifiable, signed, and traceable proofs\n'));

package/examples/accessibility.yml

@@ -1,25 +1,48 @@
 # QA360 Example: Accessibility Tests
 # WCAG compliance and accessibility testing
 
-version: 1
+version: 2
 name: accessibility-tests
+description: WCAG compliance and accessibility testing
 
 gates:
-  - ui
-  - a11y
+  ui-smoke:
+    adapter: playwright-ui
+    enabled: true
+    config:
+      baseUrl: "https://example.com"
+      pages:
+        - url: "/"
+          expectedElements: ["body", "main"]
+        - url: "/about"
+          expectedElements: ["body"]
+        - url: "/contact"
+          expectedElements: ["body", "form"]
 
-targets:
-  web:
-    baseUrl: "https://example.com"
-    pages:
-      - "https://example.com"
-      - "https://example.com/about"
-      - "https://example.com/contact"
-
-# Accessibility budget
-budgets:
-  a11y_min: 90  # Minimum accessibility score (0-100)
+  a11y:
+    adapter: playwright-ui
+    enabled: true
+    config:
+      baseUrl: "https://example.com"
+      pages:
+        - url: "/"
+          a11yRules:
+            - wcag2a
+            - wcag2aa
+        - url: "/about"
+          a11yRules:
+            - wcag2a
+            - wcag2aa
+        - url: "/contact"
+          a11yRules:
+            - wcag2a
+            - wcag2aa
+    budgets:
+      violations: 5
+      a11y_score: 90
 
 execution:
-  timeout: 60000
-  max_retries: 1
+  default_timeout: 60000
+  default_retries: 1
+  on_failure: continue
+  parallel: true

package/examples/api-basic.yml

@@ -1,22 +1,27 @@
 # QA360 Example: API Basic
 # Simple API smoke tests for REST/GraphQL endpoints
 
-version: 1
+version: 2
 name: api-health-check
+description: Basic API health check with smoke tests
 
 gates:
-  - api_smoke
+  api-health:
+    adapter: playwright-api
+    enabled: true
+    config:
+      baseUrl: "https://httpbin.org"
+      smoke:
+        - "GET /status/200 -> 200"
+        - "GET /json -> 200"
+        - "GET /uuid -> 200"
+        - "POST /post -> 200"
+    options:
+      timeout: 30000
+      retries: 2
 
-targets:
-  api:
-    baseUrl: "https://httpbin.org"
-    smoke:
-      - "GET /status/200 -> 200"
-      - "GET /json -> 200"
-      - "GET /uuid -> 200"
-      - "POST /post -> 200"
-
-# Optional: Execution settings
 execution:
-  timeout: 30000        # 30 seconds
-  max_retries: 2
+  default_timeout: 30000
+  default_retries: 2
+  on_failure: continue
+  parallel: false