playwright-ai-insights 1.2.14 → 1.3.1

package/README.md

@@ -70,11 +70,14 @@ import { test, expect } from '@playwright/test';
 import { test, expect } from './fixtures/aiHooks.js';
 ```
 
-### 3. Analyze Test Failures
+### 3. Analyze Test Failures & Generate Reports
 
 ```bash
-# After tests run
-npm run test:ai-analyze
+# After tests run, generate an AI-powered HTML report
+npx playwright-ai report
+
+# Report will be created at: reports/ai-insights-report.html
+# Open it in your browser to see AI insights and suggestions
 ```
 
 ### API Usage Examples
@@ -139,6 +142,12 @@ npx playwright-ai setup
 # Reconfigure or re-run setup
 npx playwright-ai setup --force
 
+# Generate AI-Powered Test Failure Report (HTML)
+npx playwright-ai report
+
+# Generate report with custom paths
+npx playwright-ai report --results=./custom-results.json --output=./custom-report.html
+
 # Add AI section to README
 npx playwright-ai add-docs
 
@@ -155,6 +164,30 @@ npx playwright-ai analyze --results=./test-results.json
 npx playwright-ai version
 ```
 
+### Generating AI-Powered Test Reports
+
+After your tests run and generate a results JSON file, generate an intelligent HTML report:
+
+```bash
+# Generate report with default paths
+# Expects: reports/test-results.json
+# Creates: reports/ai-insights-report.html
+npx playwright-ai report
+
+# Generate report with custom input/output paths
+npx playwright-ai report --results=path/to/results.json --output=path/to/report.html
+```
+
+**Report Features:**
+- 📊 Test failure statistics and trends
+- 🤖 AI-powered root cause analysis
+- 💡 Intelligent locator suggestions with confidence scores
+- 📈 Test run history with pass/fail status
+- 🎯 Failure type classification (Assertion, Timeout, etc.)
+- 🔴 Recent run status with hover tooltips
+
+**Report Output:** `reports/ai-insights-report.html` (open in browser)
+
 ### Environment Variables
 
 ```bash
@@ -174,6 +207,56 @@ ENABLE_FLAKY_DETECTION=true
 ENABLE_SCREENSHOTS=true
 ```
 
+### HTML Reports - AI-Powered Test Failure Analysis
+
+Generate beautiful HTML reports with AI-powered insights for all test failures:
+
+**Basic Usage (Recommended):**
+```bash
+# Prerequisites: 
+# - Your test results in reports/test-results.json
+# - OPENAI_API_KEY environment variable set
+
+npx playwright-ai report
+# Output: reports/ai-insights-report.html
+```
+
+**Advanced Usage:**
+```bash
+# Custom input and output paths
+npx playwright-ai report \
+  --results=path/to/your/results.json \
+  --output=path/to/your/report.html
+```
+
+**What's in the Report:**
+- 📊 **Summary Statistics** - Total failed tests, flaky test count, report date
+- 🤖 **AI Root Cause Analysis** - Why each test failed (Assertion, Timeout, etc.)
+- 💡 **Smart Suggestions** - AI-recommended fixes with confidence scores
+- 📈 **Test History** - Pass/fail trends with recent run status
+- 🎯 **Confidence Scores** - AI's confidence in each suggestion (0-100%)
+- 🔴 **Status Indicators** - Visual markers for each test failure type
+
+**Example Report Output:**
+```
+AI-Powered Test Failure Report
+Intelligent Test Failure Diagnostics
+
+1 Failed Tests | 1 Potentially Flaky | Report Date: 11-Mar-2026
+
+Test Failure Analysis
+┌─────────────────────────────────────────────────────────┐
+│ #  │ Test Name            │ Type       │ AI Suggestion │ ⭐  │
+├─────────────────────────────────────────────────────────┤
+│ 1  │ Login Test           │ ⏱ Timeout  │ Use waitFor() │ 85% │
+│ 2  │ Submit Form          │ 🟠 Assert  │ Update CSS    │ 92% │
+└─────────────────────────────────────────────────────────┘
+```
+
+**Default Paths:**
+- **Input:** `reports/test-results.json` (standard Playwright test results)
+- **Output:** `reports/ai-insights-report.html` (open in browser)
+
 ### Using AI Fixtures in Tests
 
 ```javascript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright-ai-insights",
-  "version": "1.2.14",
+  "version": "1.3.1",
   "description": "AI-powered Playwright test failure analysis and self-healing with locator suggestions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",