Visual Execution Engine Test Templates

This directory contains automated test templates for the Visual Execution Engine React application.

Available Templates

1. vee-quick-test.json - Quick Smoke Test

Purpose: Fast verification that the app starts and loads Time: ~15 seconds Use case: Daily development, CI/CD pipeline

# Run quick test
curl -s http://localhost:4101/templates/vee-quick-test/run \
  -H 'Content-Type: application/json' \
  -d '{}'

2. visual-execution-engine-test.json - Comprehensive Test

Purpose: Full automated testing with verification and screenshots Time: ~60 seconds Use case: Release validation, thorough testing

# Run full test suite
curl -s http://localhost:4101/templates/visual-execution-engine-test/run \
  -H 'Content-Type: application/json' \
  -d '{
    "take_screenshots": true,
    "open_browser": true
  }'

3. vee-gui-interaction-test.json - GUI Automation Test

Purpose: Full UI interaction testing with desktop driver Time: ~90 seconds Requirements: Desktop driver running at DESKTOP_DRIVER_URL Use case: End-to-end GUI validation

# Run GUI interaction test (requires desktop driver)
curl -s http://localhost:4101/templates/vee-gui-interaction-test/run \
  -H 'Content-Type: application/json' \
  -d '{
    "test_iso_path": "/path/to/tiny_core.iso"
  }'

Parameters

Common Parameters

• project_path: Path to framebuffer-engine directory (default: auto-detected)
• port: React dev server port (default: 3000)

Test-Specific Parameters

• take_screenshots: Enable/disable screenshot capture (default: true)
• open_browser: Auto-open browser (default: true)
• test_iso_path: Path to test ISO file for GUI tests

Output Files

Logs

• /tmp/vee-react.log - React dev server output
• /tmp/vee-test-report.txt - Test execution summary

Screenshots (when enabled)

• shots/vee-01-initial-load.png - Initial app state
• shots/vee-02-final-state.png - Final app state
• shots/vee-gui-*.png - GUI interaction screenshots

Usage Examples

Daily Development Workflow

# Quick check during development
curl -s http://localhost:4101/templates/vee-quick-test/run -d '{}'

Pre-Release Testing

# Full validation before release
curl -s http://localhost:4101/templates/visual-execution-engine-test/run \
  -d '{"take_screenshots": true}'

Custom Path Testing

# Test with custom project path
curl -s http://localhost:4101/templates/vee-quick-test/run \
  -d '{"project_path": "/custom/path/to/framebuffer-engine"}'

Expected Results

Success Indicators

• ✅ HTTP 200 response from React app
• ✅ "Digital Visual Computer" text found in page
• ✅ "Revolutionary Visual Execution Engine" text found
• ✅ No errors in React dev server logs
• ✅ Screenshots captured (if enabled)

Common Issues

• ❌ Port 3000 already in use → Kill existing React processes
• ❌ Node modules missing → Templates automatically run npm ci
• ❌ Permission errors → Check file system permissions
• ❌ Desktop driver not available → Skip GUI tests

Integration with CI/CD

Add to your CI pipeline:

- name: Test Visual Execution Engine
  run: |
    curl -f http://localhost:4101/templates/vee-quick-test/run \
      -H 'Content-Type: application/json' -d '{}'

Troubleshooting

View orchestrator logs

curl -s http://localhost:4101/logs

Check React app logs

tail -f /tmp/vee-react.log

Manual cleanup

pkill -f 'react-scripts start'
rm -f /tmp/vee-*.pid /tmp/vee-*.log