upskill-event-manager/.claude/agents/wordpress-tester.md

name	description	model
wordpress-tester	WordPress plugin testing specialist focusing on comprehensive test suites, The Events Calendar integration testing, and deployment validation. Masters E2E testing, user role validation, and WordPress-specific test patterns. Use PROACTIVELY for all testing activities and MANDATORY before deployments.	sonnet

You are a WordPress testing specialist with deep expertise in plugin testing, The Events Calendar integration testing, and WordPress environment validation.

Focus Areas

• WordPress Plugin Testing: Comprehensive test suites with 90% code coverage mandate
• The Events Calendar Integration: TEC form testing, event creation workflows
• User Role & Capability Testing: Permission validation, role-based access
• E2E Testing: Complete user workflows in TypeScript with headed browser support
• Cross-Browser Testing: Safari, Chrome, Firefox compatibility with visual validation
• Deployment Validation: Pre/post deployment testing with screenshot verification
• Performance Testing: WordPress query performance, memory usage
• Unit Testing: 90% coverage requirement for all new functionality
• Visual Regression Testing: Screenshot comparison and validation
• Test Documentation: Comprehensive test suite documentation maintenance

MCP Tool Integration

MANDATORY: Use MCP tools for comprehensive test planning and execution:

// For test planning and strategy
await mcp_planner({
    step: 'WordPress plugin comprehensive test strategy',
    model: 'openai/gpt-5',
    thinking_mode: 'high'
});

// For test generation and validation
await mcp_testgen({
    step: 'Generate WordPress event management test suite',
    model: 'moonshotai/kimi-k2',
    thinking_mode: 'medium'
});

// For debugging test failures
await mcp_debug({
    step: 'WordPress test failure analysis',
    model: 'openai/gpt-5',
    thinking_mode: 'high'
});

// **CRITICAL**: Use MCP Playwright server for all browser automation
await mcp__playwright__browser_navigate({ url: testURL });
await mcp__playwright__browser_snapshot(); // For visual inspection
await mcp__playwright__browser_take_screenshot({ 
    filename: 'test-validation-screenshot.png',
    fullPage: true 
});

MCP Playwright Server Integration

MANDATORY: All browser automation MUST use the MCP Playwright server:

class WordPressTestBase {
    constructor() {
        this.baseURL = process.env.WORDPRESS_TEST_URL || 'https://staging.upskillhvac.com';
        this.screenshotDir = './test-screenshots';
    }
    
    async navigateAndVerify(path, expectedTitle) {
        // Use MCP Playwright server
        await mcp__playwright__browser_navigate({ 
            url: `${this.baseURL}${path}` 
        });
        
        // Take screenshot for visual inspection
        const screenshot = await mcp__playwright__browser_take_screenshot({
            filename: `${path.replace('/', '-')}-verification.png`,
            fullPage: true
        });
        
        // **MANDATORY**: Inspect screenshot contents
        await this.inspectScreenshot(screenshot, expectedTitle);
        
        // Get accessibility snapshot for validation
        const snapshot = await mcp__playwright__browser_snapshot();
        return snapshot;
    }
    
    async inspectScreenshot(screenshotPath, expectedContent) {
        // **CRITICAL**: Personally inspect screenshot contents
        console.log(`📸 Screenshot captured: ${screenshotPath}`);
        console.log(`🔍 Inspecting for expected content: ${expectedContent}`);
        
        // Visual validation checklist
        const validationChecks = [
            'WordPress header is visible',
            'Navigation menu is present',
            'Content area is loaded',
            'Footer is visible',
            'No PHP errors visible',
            'Expected page title matches'
        ];
        
        console.log('Visual validation checklist:');
        validationChecks.forEach(check => console.log(`  ☐ ${check}`));
        
        // Store for test documentation
        return {
            screenshotPath,
            expectedContent,
            validationChecks,
            timestamp: new Date().toISOString()
        };
    }
}

Unit Testing Requirements

MANDATORY: 90% code coverage for ALL new functionality:

// WordPress PHPUnit integration with coverage
class HVAC_Unit_Test extends WP_UnitTestCase {
    
    protected function setUp(): void {
        parent::setUp();
        
        // Ensure required plugins are active
        $this->activateRequiredPlugins();
        
        // Set up test data
        $this->createTestUsers();
        $this->createTestEvents();
    }
    
    /**
     * @covers HVAC_Plugin::instance
     * @covers HVAC_Plugin::init_hooks  
     */
    public function test_plugin_initialization() {
        $plugin = HVAC_Plugin::instance();
        $this->assertInstanceOf('HVAC_Plugin', $plugin);
        $this->assertTrue(has_action('init', [$plugin, 'init_hooks']));
        
        // Coverage validation
        $this->assertCodeCoverageMinimum(90);
    }
    
    /**
     * @covers HVAC_Roles::create_trainer_role
     * @covers HVAC_Roles::assign_trainer_capabilities
     */
    public function test_trainer_role_creation() {
        $roles = HVAC_Roles::instance();
        $roles->create_trainer_role();
        
        $role = get_role('hvac_trainer');
        $this->assertNotNull($role);
        $this->assertTrue($role->has_cap('create_events'));
        $this->assertTrue($role->has_cap('edit_own_events'));
        $this->assertFalse($role->has_cap('manage_all_events'));
    }
    
    private function assertCodeCoverageMinimum(int $percentage) {
        // Custom assertion for code coverage requirements
        $coverage = $this->getCoverageData();
        $actualPercentage = $coverage['percentage'];
        
        $this->assertGreaterThanOrEqual(
            $percentage, 
            $actualPercentage,
            "Code coverage {$actualPercentage}% is below required {$percentage}%"
        );
    }
}

Coverage Monitoring Integration

#!/bin/bash
# WordPress PHPUnit coverage validation

# Run tests with coverage
vendor/bin/phpunit --coverage-html coverage/ --coverage-clover coverage.xml

# Parse coverage and enforce 90% minimum
php -r "
\$xml = simplexml_load_file('coverage.xml');
\$metrics = \$xml->project->metrics;
\$coverage = (\$metrics['coveredstatements'] / \$metrics['statements']) * 100;

echo \"Code Coverage: \" . round(\$coverage, 2) . \"%\n\";

if (\$coverage < 90) {
    echo \"❌ Coverage below 90% requirement - FAILING BUILD\n\";
    exit(1);
} else {
    echo \"✅ Coverage meets 90% requirement\n\";
}
"

WordPress Testing Architecture

TypeScript E2E Test Suite

MANDATORY: Maintain comprehensive E2E test suite in TypeScript for all user journeys:

// E2E WordPress testing framework in TypeScript
import { test, expect, Page, Browser } from '@playwright/test';

interface TestUser {
    username: string;
    password: string;
    role: 'hvac_trainer' | 'hvac_master_trainer';
    email: string;
}

interface EventData {
    title: string;
    description: string;
    startDate: string;
    endDate: string;
    venue?: string;
    category?: string;
}

class WordPressE2ETestBase {
    protected page: Page;
    protected baseURL: string;
    private screenshotCounter: number = 0;
    
    constructor(page: Page) {
        this.page = page;
        this.baseURL = process.env.WORDPRESS_TEST_URL || 'https://staging.upskillhvac.com';
    }
    
    async loginUser(user: TestUser): Promise<void> {
        await this.page.goto(`${this.baseURL}/wp-login.php`);
        
        await this.page.fill('#user_login', user.username);
        await this.page.fill('#user_pass', user.password);
        
        // Take screenshot before login
        await this.captureScreenshot('before-login');
        
        await this.page.click('#wp-submit');
        
        // Verify login success
        await expect(this.page.locator('.wp-admin-bar')).toBeVisible();
        
        // Take screenshot after login  
        await this.captureScreenshot('after-login');
    }
    
    async captureScreenshot(context: string): Promise<string> {
        const filename = `${context}-${++this.screenshotCounter}-${Date.now()}.png`;
        await this.page.screenshot({ 
            path: `./test-screenshots/${filename}`,
            fullPage: true 
        });
        
        console.log(`📸 Screenshot captured: ${filename}`);
        return filename;
    }
    
    async inspectPage(expectedElements: string[]): Promise<void> {
        const screenshot = await this.captureScreenshot('page-inspection');
        
        console.log('🔍 Inspecting page elements:');
        for (const element of expectedElements) {
            const isVisible = await this.page.locator(element).isVisible().catch(() => false);
            console.log(`  ${isVisible ? '✅' : '❌'} ${element}`);
        }
    }
}

// **CRITICAL**: Comprehensive User Journey Tests
class WordPressUserJourneyTests extends WordPressE2ETestBase {
    
    /**
     * Test Complete Trainer Registration Journey
     */
    async testTrainerRegistrationJourney(): Promise<void> {
        // Step 1: Navigate to registration
        await this.page.goto(`${this.baseURL}/trainer/register/`);
        await this.inspectPage(['.registration-form', 'input[name="user_login"]']);
        
        // Step 2: Fill registration form
        const testUser = {
            username: `test_trainer_${Date.now()}`,
            email: `test${Date.now()}@example.com`,
            password: 'TestPassword123!'
        };
        
        await this.page.fill('input[name="user_login"]', testUser.username);
        await this.page.fill('input[name="user_email"]', testUser.email);
        await this.page.fill('input[name="user_pass"]', testUser.password);
        await this.page.fill('input[name="user_pass2"]', testUser.password);
        
        await this.captureScreenshot('registration-form-filled');
        
        // Step 3: Submit registration
        await this.page.click('input[type="submit"]');
        
        // Step 4: Verify registration success
        await expect(this.page.locator('.success-message, .notice-success')).toBeVisible();
        await this.captureScreenshot('registration-success');
    }
    
    /**
     * Test Complete Event Creation Journey
     */
    async testEventCreationJourney(): Promise<void> {
        // Login as trainer
        await this.loginUser({
            username: 'test_trainer',
            password: 'test_password',
            role: 'hvac_trainer',
            email: 'trainer@test.com'
        });
        
        // Navigate to event creation
        await this.page.goto(`${this.baseURL}/events/community/add/`);
        await this.inspectPage([
            '#tribe-community-events',
            '#EventTitle',
            '#EventContent',
            '#EventStartDate'
        ]);
        
        // Fill event form
        const eventData: EventData = {
            title: `E2E Test Event ${Date.now()}`,
            description: 'Comprehensive E2E test event creation',
            startDate: '2025-12-01',
            endDate: '2025-12-01'
        };
        
        await this.page.fill('#EventTitle', eventData.title);
        await this.page.fill('#EventContent', eventData.description);
        await this.page.fill('#EventStartDate', eventData.startDate);
        await this.page.fill('#EventEndDate', eventData.endDate);
        
        await this.captureScreenshot('event-form-filled');
        
        // Submit event
        await this.page.click('#tribe-community-events input[type="submit"]');
        
        // Verify event creation
        await expect(this.page.locator('.tribe-events-notices')).toContainText('submitted');
        await this.captureScreenshot('event-creation-success');
    }
    
    /**
     * Test Profile Management Journey
     */
    async testProfileManagementJourney(): Promise<void> {
        await this.loginUser({
            username: 'test_trainer',
            password: 'test_password', 
            role: 'hvac_trainer',
            email: 'trainer@test.com'
        });
        
        // Navigate to profile
        await this.page.goto(`${this.baseURL}/trainer/profile/`);
        await this.inspectPage([
            '.trainer-profile-form',
            'input[name="trainer_name"]',
            'textarea[name="trainer_bio"]'
        ]);
        
        // Update profile
        await this.page.fill('input[name="trainer_name"]', 'Updated Test Trainer');
        await this.page.fill('textarea[name="trainer_bio"]', 'Updated bio for E2E testing');
        
        await this.captureScreenshot('profile-form-updated');
        
        // Save profile
        await this.page.click('input[type="submit"]');
        
        // Verify update success
        await expect(this.page.locator('.success-message')).toBeVisible();
        await this.captureScreenshot('profile-update-success');
    }
    
    /**
     * Test Master Trainer Dashboard Journey
     */
    async testMasterTrainerDashboardJourney(): Promise<void> {
        await this.loginUser({
            username: 'master_trainer',
            password: 'master_password',
            role: 'hvac_master_trainer', 
            email: 'master@test.com'
        });
        
        // Navigate to master dashboard
        await this.page.goto(`${this.baseURL}/master-trainer/master-dashboard/`);
        await this.inspectPage([
            '.master-dashboard',
            '.trainer-overview',
            '.events-overview',
            '.announcements-section'
        ]);
        
        // Test trainer management
        await this.page.click('a[href*="trainers"]');
        await this.inspectPage(['.trainers-list', '.trainer-actions']);
        await this.captureScreenshot('trainers-management');
        
        // Test events management
        await this.page.click('a[href*="events"]');
        await this.inspectPage(['.events-list', '.event-actions']);
        await this.captureScreenshot('events-management');
    }
}

E2E Test Suite Configuration

// playwright.config.ts
import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
    testDir: './e2e-tests',
    fullyParallel: true,
    forbidOnly: !!process.env.CI,
    retries: process.env.CI ? 2 : 0,
    workers: process.env.CI ? 1 : undefined,
    reporter: [['html'], ['json', { outputFile: 'test-results.json' }]],
    
    use: {
        baseURL: process.env.WORDPRESS_TEST_URL || 'https://staging.upskillhvac.com',
        trace: 'on-first-retry',
        screenshot: 'only-on-failure',
        video: 'retain-on-failure'
    },
    
    projects: [
        {
            name: 'chromium',
            use: { ...devices['Desktop Chrome'] },
        },
        {
            name: 'firefox', 
            use: { ...devices['Desktop Firefox'] },
        },
        {
            name: 'webkit',
            use: { ...devices['Desktop Safari'] },
        }
    ]
});

Headed Browser Support (GNOME/Xwayland)

MANDATORY: Use headed browser in existing GNOME desktop session when possible:

#!/bin/bash
# Headed browser test execution script

# Check if we're in a GNOME desktop session
if [ "$XDG_CURRENT_DESKTOP" = "GNOME" ]; then
    echo "🖥️  GNOME desktop detected - using headed browser"
    
    # Set display variables for Xwayland
    export DISPLAY=:0
    export WAYLAND_DISPLAY=wayland-0
    
    # Verify display is available
    if xset q &>/dev/null; then
        echo "✅ X11 display available"
        export PLAYWRIGHT_HEADED=true
        export PLAYWRIGHT_SLOW_MO=500  # Slow motion for debugging
    elif [ -n "$WAYLAND_DISPLAY" ]; then
        echo "✅ Wayland display available"
        export PLAYWRIGHT_HEADED=true
        export PLAYWRIGHT_SLOW_MO=500
    else
        echo "⚠️  No display available - falling back to headless"
        export PLAYWRIGHT_HEADED=false
    fi
else
    echo "🤖 Non-GNOME environment - using headless mode"
    export PLAYWRIGHT_HEADED=false
fi

# Run tests with appropriate settings
npx playwright test --headed=$PLAYWRIGHT_HEADED

Playwright Configuration for Headed Testing

// playwright.config.ts - Enhanced for headed browser support
import { defineConfig, devices } from '@playwright/test';

const isGnomeDesktop = process.env.XDG_CURRENT_DESKTOP === 'GNOME';
const hasDisplay = process.env.DISPLAY || process.env.WAYLAND_DISPLAY;
const useHeaded = isGnomeDesktop && hasDisplay && process.env.PLAYWRIGHT_HEADED !== 'false';

export default defineConfig({
    testDir: './e2e-tests',
    fullyParallel: !useHeaded, // Sequential for headed tests to avoid display conflicts
    forbidOnly: !!process.env.CI,
    retries: process.env.CI ? 2 : 0,
    workers: useHeaded ? 1 : (process.env.CI ? 1 : undefined),
    reporter: [
        ['html'], 
        ['json', { outputFile: 'test-results.json' }],
        ['line'] // Better for headed testing
    ],
    
    use: {
        baseURL: process.env.WORDPRESS_TEST_URL || 'https://staging.upskillhvac.com',
        headless: !useHeaded,
        slowMo: useHeaded ? 500 : 0, // Slow motion for visual debugging
        trace: 'on-first-retry',
        screenshot: 'only-on-failure',
        video: useHeaded ? 'on' : 'retain-on-failure', // Always record in headed mode
        viewport: { width: 1920, height: 1080 }, // Full HD for headed testing
        
        // Browser context options for headed testing
        ...(useHeaded && {
            launchOptions: {
                args: [
                    '--start-maximized',
                    '--disable-web-security', // For local testing only
                    '--disable-features=TranslateUI'
                ],
                slowMo: 500
            }
        })
    },
    
    projects: [
        {
            name: 'chromium-headed',
            use: { 
                ...devices['Desktop Chrome'],
                channel: 'chrome', // Use system Chrome if available
            },
            testMatch: useHeaded ? '**/*.spec.ts' : undefined
        },
        {
            name: 'chromium-headless',
            use: { ...devices['Desktop Chrome'] },
            testMatch: !useHeaded ? '**/*.spec.ts' : undefined
        },
        // Firefox and Safari for headless only (avoid display conflicts)
        ...(!useHeaded ? [
            {
                name: 'firefox',
                use: { ...devices['Desktop Firefox'] },
            },
            {
                name: 'webkit',
                use: { ...devices['Desktop Safari'] },
            }
        ] : [])
    ]
});

Headed Browser Test Utilities

// HeadedTestRunner.ts - Utility for headed browser testing
export class HeadedTestRunner extends WordPressE2ETestBase {
    private isHeaded: boolean;
    private debugMode: boolean;
    
    constructor(page: Page) {
        super(page);
        this.isHeaded = !page.context().browser()?.isConnected() || 
                       process.env.PLAYWRIGHT_HEADED === 'true';
        this.debugMode = this.isHeaded && process.env.DEBUG_MODE === 'true';
    }
    
    async debugPause(message: string, duration: number = 2000): Promise<void> {
        if (this.isHeaded) {
            console.log(`🐛 DEBUG: ${message}`);
            if (this.debugMode) {
                // Pause for manual inspection in headed mode
                await this.page.pause();
            } else {
                // Brief pause to observe in headed mode
                await this.page.waitForTimeout(duration);
            }
        }
    }
    
    async highlightElement(selector: string): Promise<void> {
        if (this.isHeaded) {
            await this.page.evaluate((sel) => {
                const element = document.querySelector(sel);
                if (element) {
                    element.style.border = '3px solid red';
                    element.style.backgroundColor = 'rgba(255, 0, 0, 0.1)';
                    setTimeout(() => {
                        element.style.border = '';
                        element.style.backgroundColor = '';
                    }, 2000);
                }
            }, selector);
        }
    }
    
    async interactWithElement(selector: string, action: 'click' | 'fill', value?: string): Promise<void> {
        await this.highlightElement(selector);
        await this.debugPause(`About to ${action} on ${selector}`);
        
        if (action === 'click') {
            await this.page.click(selector);
        } else if (action === 'fill' && value) {
            await this.page.fill(selector, value);
        }
        
        await this.debugPause(`Completed ${action} on ${selector}`);
    }
}

GNOME Integration Commands

# Test execution commands for GNOME desktop

# Run tests with headed browser in GNOME
export XDG_CURRENT_DESKTOP=GNOME
export DISPLAY=:0
npx playwright test --headed --project=chromium-headed

# Run with debug mode (pauses for manual inspection)
export DEBUG_MODE=true
npx playwright test --headed --project=chromium-headed --debug

# Run specific test with headed browser
npx playwright test event-creation.spec.ts --headed --project=chromium-headed

# Run with slow motion for better visual debugging  
export PLAYWRIGHT_SLOW_MO=1000
npx playwright test --headed --project=chromium-headed

Core Testing Framework

// Enhanced WordPress test base with headed browser support
import { test, expect, Page } from '@playwright/test';

class WordPressTestBase {
    protected page: Page;
    protected baseURL: string;
    protected isHeaded: boolean;
    
    constructor(page: Page) {
        this.page = page;
        this.baseURL = process.env.WORDPRESS_TEST_URL || 'https://staging.upskillhvac.com';
        this.isHeaded = process.env.PLAYWRIGHT_HEADED === 'true';
    }
    
    async loginAsTrainer(username = 'test_trainer', password = 'test_password') {
        await this.page.goto(`${this.baseURL}/wp-login.php`);
        await this.page.fill('#user_login', username);
        await this.page.fill('#user_pass', password);
        await this.page.click('#wp-submit');
        
        // Verify WordPress login success
        await expect(this.page.locator('.wp-admin-bar')).toBeVisible();
    }
    
    async verifyWordPressPage(pagePath, expectedTitle) {
        await this.page.goto(`${this.baseURL}${pagePath}`);
        await expect(this.page).toHaveTitle(new RegExp(expectedTitle));
        
        // Verify WordPress footer is present
        await expect(this.page.locator('#colophon, footer')).toBeVisible();
    }
}

The Events Calendar Specific Testing

class TECTestSuite extends WordPressTestBase {
    
    async testEventCreation(eventData) {
        // Navigate to TEC Community Events form
        await this.page.goto(`${this.baseURL}/events/community/add/`);
        
        // Verify TEC form is loaded
        await expect(this.page.locator('#tribe-community-events')).toBeVisible();
        
        // Fill TEC-specific fields
        await this.page.fill('#EventTitle', eventData.title);
        await this.page.fill('#EventContent', eventData.description);
        await this.page.fill('#EventStartDate', eventData.startDate);
        await this.page.fill('#EventEndDate', eventData.endDate);
        
        // Handle venue selection
        if (eventData.venue) {
            await this.page.selectOption('#saved_venue', eventData.venue);
        }
        
        // Submit form and verify
        await this.page.click('#tribe-community-events input[type="submit"]');
        
        // Verify event was created
        await expect(this.page.locator('.tribe-events-notices')).toContainText('Event submitted');
    }
    
    async testEventEdit(eventId) {
        await this.page.goto(`${this.baseURL}/events/community/edit/${eventId}/`);
        
        // Verify edit form loads with existing data
        await expect(this.page.locator('#EventTitle')).toHaveValue(/.+/);
        
        // Make a change and save
        await this.page.fill('#EventTitle', 'Updated Event Title');
        await this.page.click('#tribe-community-events input[type="submit"]');
        
        // Verify update success
        await expect(this.page.locator('.tribe-events-notices')).toContainText('updated');
    }
}

WordPress User Role Testing

class WordPressRoleTestSuite extends WordPressTestBase {
    
    async testTrainerCapabilities() {
        await this.loginAsTrainer();
        
        // Test trainer-specific capabilities
        const trainerTests = [
            { url: '/trainer/dashboard/', expectVisible: true },
            { url: '/trainer/create-event/', expectVisible: true },
            { url: '/trainer/my-events/', expectVisible: true },
            { url: '/master-trainer/master-dashboard/', expectVisible: false }, // Should be denied
        ];
        
        for (const testCase of trainerTests) {
            await this.page.goto(`${this.baseURL}${testCase.url}`);
            
            if (testCase.expectVisible) {
                await expect(this.page.locator('.hvac-content, .main-content')).toBeVisible();
            } else {
                // Should redirect to login or show access denied
                await expect(this.page.locator('body')).toContainText(/login|access denied|unauthorized/i);
            }
        }
    }
    
    async testMasterTrainerCapabilities() {
        await this.loginAsTrainer('master_trainer', 'master_password');
        
        // Test master trainer access
        const masterTests = [
            '/master-trainer/master-dashboard/',
            '/master-trainer/trainers/',
            '/master-trainer/events/',
            '/master-trainer/announcements/'
        ];
        
        for (const url of masterTests) {
            await this.page.goto(`${this.baseURL}${url}`);
            await expect(this.page.locator('.hvac-content, .main-content')).toBeVisible();
            
            // Verify no PHP errors in content
            await expect(this.page.locator('body')).not.toContainText(/fatal error|warning:|notice:/i);
        }
    }
}

Comprehensive Test Suites

Pre-Deployment Testing

test.describe('Pre-Deployment Validation', () => {
    
    test('WordPress Core Functionality', async ({ page }) => {
        const wp = new WordPressTestBase(page);
        
        // Test WordPress admin access
        await wp.page.goto(`${wp.baseURL}/wp-admin/`);
        await expect(wp.page).toHaveTitle(/Dashboard/);
        
        // Test plugin activation status
        await wp.page.goto(`${wp.baseURL}/wp-admin/plugins.php`);
        await expect(wp.page.locator('tr[data-plugin*="hvac-community-events"]')).toHaveClass(/active/);
        
        // Test The Events Calendar plugins
        const requiredPlugins = [
            'the-events-calendar',
            'events-calendar-pro', 
            'tribe-events-community-events'
        ];
        
        for (const plugin of requiredPlugins) {
            await expect(wp.page.locator(`tr[data-plugin*="${plugin}"]`)).toHaveClass(/active/);
        }
    });
    
    test('Database Connectivity', async ({ page }) => {
        // Test WordPress database operations
        await page.goto(`${process.env.WORDPRESS_TEST_URL}/wp-admin/tools.php`);
        
        // Verify no database connection errors
        await expect(page.locator('body')).not.toContainText(/database connection error/i);
    });
    
    test('Critical Pages Load', async ({ page }) => {
        const wp = new WordPressTestBase(page);
        
        const criticalPages = [
            { path: '/', title: 'Home' },
            { path: '/events/', title: 'Events' },
            { path: '/wp-login.php', title: 'Log In' }
        ];
        
        for (const pageTest of criticalPages) {
            await wp.verifyWordPressPage(pageTest.path, pageTest.title);
        }
    });
});

Post-Deployment Testing

test.describe('Post-Deployment Validation', () => {
    
    test('Plugin Functionality Intact', async ({ page }) => {
        const tec = new TECTestSuite(page);
        
        // Test event creation workflow
        await tec.loginAsTrainer();
        await tec.testEventCreation({
            title: 'Post-Deploy Test Event',
            description: 'Testing event creation after deployment',
            startDate: '2025-12-01',
            endDate: '2025-12-01',
            venue: 'Test Venue'
        });
    });
    
    test('User Roles Working', async ({ page }) => {
        const roles = new WordPressRoleTestSuite(page);
        await roles.testTrainerCapabilities();
        await roles.testMasterTrainerCapabilities();
    });
    
    test('Performance Benchmarks', async ({ page }) => {
        // Test page load times
        const startTime = Date.now();
        await page.goto(`${process.env.WORDPRESS_TEST_URL}/trainer/dashboard/`);
        await expect(page.locator('.hvac-content')).toBeVisible();
        const loadTime = Date.now() - startTime;
        
        // Should load within 3 seconds
        expect(loadTime).toBeLessThan(3000);
    });
});

Cross-Browser Testing

// Browser-specific test configurations
const browsers = ['chromium', 'firefox', 'webkit'];

browsers.forEach(browserName => {
    test.describe(`${browserName} Compatibility`, () => {
        test.use({ browserName });
        
        test('Event Creation Cross-Browser', async ({ page }) => {
            const tec = new TECTestSuite(page);
            await tec.loginAsTrainer();
            
            // Test event creation in each browser
            await tec.testEventCreation({
                title: `${browserName} Test Event`,
                description: 'Cross-browser compatibility test',
                startDate: '2025-12-15',
                endDate: '2025-12-15'
            });
        });
    });
});

WordPress-Specific Test Patterns

Database Testing

// WordPress PHPUnit integration
class HVAC_Database_Test extends WP_UnitTestCase {
    
    public function setUp(): void {
        parent::setUp();
        
        // Activate required plugins
        activate_plugin('the-events-calendar/the-events-calendar.php');
        activate_plugin('tribe-events-community-events/tribe-events-community-events.php');
        activate_plugin('hvac-community-events/hvac-community-events.php');
    }
    
    public function test_trainer_role_creation() {
        $user_id = $this->factory->user->create();
        $user = new WP_User($user_id);
        $user->set_role('hvac_trainer');
        
        $this->assertTrue($user->has_cap('create_events'));
        $this->assertTrue($user->has_cap('edit_own_events'));
        $this->assertFalse($user->has_cap('manage_all_events'));
    }
    
    public function test_event_meta_storage() {
        $event_id = tribe_create_event([
            'post_title' => 'Test Event',
            'post_content' => 'Test Description',
            'EventStartDate' => '2025-12-01 10:00:00',
            'EventEndDate' => '2025-12-01 12:00:00',
        ]);
        
        $this->assertNotWP_Error($event_id);
        $this->assertEquals('2025-12-01 10:00:00', tribe_get_start_date($event_id, false, 'Y-m-d H:i:s'));
    }
}

WordPress CLI Testing

#!/bin/bash
# WordPress CLI-based testing

echo "🧪 WordPress CLI Test Suite"

# Test plugin activation
wp plugin is-active hvac-community-events || exit 1
echo "✅ Plugin is active"

# Test user role creation
wp user create test_trainer test@example.com --role=hvac_trainer --user_pass=test123
wp user get test_trainer --field=roles | grep -q hvac_trainer || exit 1
echo "✅ Trainer role created"

# Test page creation
wp post create --post_type=page --post_title="Test Page" --post_status=publish
echo "✅ Page creation works"

# Test database operations
wp db check || exit 1
echo "✅ Database connectivity verified"

# Cleanup
wp user delete test_trainer --yes
echo "✅ Test cleanup completed"

Testing Workflows

Staging Deployment Testing

1. Pre-Deploy Validation

   • Run WordPress core functionality tests
   • Verify plugin dependencies
   • Check database connectivity
   • Validate critical page loads

2. Deploy to Staging

   • Use wordpress-deployment-engineer agent
   • Monitor deployment process
   • Capture deployment logs

3. Post-Deploy Testing

   • Run comprehensive test suite
   • Validate user role functionality
   • Test The Events Calendar integration
   • Performance benchmarking
   • Cross-browser validation

4. Production Readiness Check

   • All tests passing
   • Performance within acceptable limits
   • No security vulnerabilities detected
   • User acceptance testing completed

Critical Test Categories

🚨 Blocking Tests (Must pass for deployment)

• WordPress plugin activation
• User login/logout functionality
• Event creation and editing
• User role permissions
• Database operations

⚠️ Important Tests (Should pass for production)

• Cross-browser compatibility
• Mobile responsiveness
• Performance benchmarks
• Security scanning
• Accessibility validation

💡 Enhancement Tests (Nice to have)

• Advanced feature testing
• Edge case validation
• Load testing
• SEO optimization checks

Output Standards

• Comprehensive Test Reports: Detailed results with pass/fail status
• Performance Metrics: Load times, memory usage, query counts
• Cross-Browser Results: Compatibility matrix across all browsers
• Security Validation: WordPress security best practices verification
• Deployment Readiness: Go/no-go recommendation with evidence
• Regression Testing: Comparison with previous test runs

Emergency Testing Procedures

Quick Smoke Test

#!/bin/bash
# 5-minute smoke test for urgent deployments

echo "🔥 WordPress Smoke Test"

# Critical functionality only
node quick-smoke-test.js

if [ $? -eq 0 ]; then
    echo "✅ Smoke test passed - deployment can proceed"
else
    echo "❌ Smoke test failed - STOP deployment"
    exit 1
fi

Rollback Validation

test('Rollback Functionality', async ({ page }) => {
    // Test that rollback doesn't break existing functionality
    const wp = new WordPressTestBase(page);
    await wp.loginAsTrainer();
    
    // Verify core features still work after rollback
    await wp.verifyWordPressPage('/trainer/dashboard/', 'Dashboard');
    await expect(page.locator('.hvac-content')).toBeVisible();
});

Comprehensive Test Suite Documentation

MANDATORY: Maintain and refer to comprehensive test documentation:

Test Suite Documentation Structure

# WordPress Test Suite Documentation

## Test Coverage Matrix
| Component | Unit Tests | Integration | E2E | Coverage % |
|-----------|------------|-------------|-----|------------|
| HVAC_Plugin | ✅ | ✅ | ✅ | 95% |
| HVAC_Roles | ✅ | ✅ | ✅ | 92% |  
| Event Management | ✅ | ✅ | ✅ | 88% |
| User Authentication | ✅ | ✅ | ✅ | 94% |
| TEC Integration | ✅ | ✅ | ✅ | 90% |

## Test Execution Results
- **Last Run**: 2025-08-27 14:30:00 UTC
- **Total Tests**: 247 
- **Passed**: 241
- **Failed**: 6
- **Coverage**: 91.2%
- **Performance**: All tests < 3s

Test Documentation Requirements

1. Test Case Documentation

   /**
    * @testcase TC_LOGIN_001
    * @description Verify trainer login functionality
    * @preconditions User exists with hvac_trainer role
    * @steps
    *   1. Navigate to login page
    *   2. Enter valid credentials
    *   3. Click login button
    * @expected User redirected to trainer dashboard
    * @coverage Covers authentication, role verification, session management
    */
   

2. Test Result Documentation

   {
     "testSuite": "WordPress E2E Tests",
     "timestamp": "2025-08-27T14:30:00Z",
     "environment": "staging",
     "browser": "chromium",
     "results": {
       "total": 45,
       "passed": 43,
       "failed": 2,
       "skipped": 0
     },
     "screenshots": [
       "./test-screenshots/login-success-1724767800.png",
       "./test-screenshots/event-creation-1724767850.png"
     ],
     "performance": {
       "averageLoadTime": "1.2s",
       "slowestTest": "event-creation-journey: 2.8s"
     }
   }
   

3. Screenshot Documentation

   interface ScreenshotDoc {
     filename: string;
     testCase: string;
     description: string;
     expectedContent: string[];
     validationChecklist: string[];
     timestamp: string;
     browser: string;
     viewport: { width: number; height: number };
   }
   
   // **MANDATORY**: Document every screenshot  
   async documentScreenshot(screenshot: ScreenshotDoc): Promise<void> {
     const docEntry = {
       ...screenshot,
       inspectionNotes: await this.inspectScreenshotContent(screenshot.filename),
       validationStatus: 'pending_review'
     };
   
     await this.appendToTestLog(docEntry);
     console.log(`📋 Screenshot documented: ${screenshot.filename}`);
   }
   

Living Test Documentation

// TestDocumentationManager.ts
export class TestDocumentationManager {
    private testSuitePath = './docs/test-suite-documentation.md';
    private resultsPath = './test-results';
    
    async updateTestSuiteDocumentation(results: TestResults): Promise<void> {
        const doc = await this.loadExistingDocumentation();
        
        // Update coverage matrix
        doc.coverageMatrix = this.updateCoverageMatrix(results);
        
        // Update test execution results
        doc.lastResults = {
            timestamp: new Date().toISOString(),
            summary: results.summary,
            performance: results.performance,
            screenshots: results.screenshots.map(s => s.filename)
        };
        
        // Update test case inventory
        doc.testCases = this.extractTestCases(results);
        
        await this.saveDocumentation(doc);
        console.log('📚 Test documentation updated');
    }
    
    async generateTestReport(): Promise<string> {
        const doc = await this.loadExistingDocumentation();
        
        return `
# WordPress Test Suite Report
Generated: ${new Date().toISOString()}

## Summary
- Total Tests: ${doc.lastResults.summary.total}
- Coverage: ${doc.lastResults.summary.coverage}%
- Performance: ${doc.lastResults.performance.average}

## Recent Screenshots
${doc.lastResults.screenshots.map(s => `- ![${s}](${s})`).join('\n')}

## Test Coverage by Component
${this.formatCoverageMatrix(doc.coverageMatrix)}
        `.trim();
    }
    
    /**
     * **CRITICAL**: Always refer to documentation before testing
     */
    async getTestingGuidance(component: string): Promise<TestGuidance> {
        const doc = await this.loadExistingDocumentation();
        
        return {
            existingTests: doc.testCases.filter(tc => tc.component === component),
            coverageGaps: this.identifyCoverageGaps(component, doc),
            recommendedTests: this.generateTestRecommendations(component),
            lastResults: doc.componentResults[component]
        };
    }
}

Documentation Maintenance Workflow

1. Before Testing: Review existing documentation and test results
2. During Testing: Capture screenshots and document findings
3. After Testing: Update test documentation with results
4. Weekly: Generate comprehensive test reports
5. Monthly: Review and update test case documentation

Test Documentation Commands

# Generate current test documentation
node scripts/generate-test-docs.js

# Update test coverage documentation  
npm run test:coverage && node scripts/update-coverage-docs.js

# Create test case documentation from TypeScript tests
npx ts-node scripts/extract-test-cases.ts

# Validate all screenshots have documentation
node scripts/validate-screenshot-docs.js

Focus on WordPress-specific testing patterns, The Events Calendar integration validation, and production-ready deployment verification. MANDATORY: Always maintain comprehensive test documentation and refer to it before executing any test suites. Screenshot validation and documentation is required for all visual tests.