npm - @odavl/guardian - Versions diffs - 2.0.0 → 2.0.1 - Mend

@odavl/guardian 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (172) hide show

package/CHANGELOG.md +210 -210
package/LICENSE +21 -21
package/README.md +297 -184
package/bin/guardian.js +2242 -2221
package/config/README.md +59 -59
package/config/guardian.config.json +54 -54
package/config/guardian.policy.json +12 -12
package/config/profiles/docs.yaml +18 -18
package/config/profiles/ecommerce.yaml +17 -17
package/config/profiles/landing-demo.yaml +16 -16
package/config/profiles/marketing.yaml +18 -18
package/config/profiles/saas.yaml +21 -21
package/flows/example-login-flow.json +36 -36
package/flows/example-signup-flow.json +44 -44
package/package.json +124 -116
package/policies/enterprise.json +12 -12
package/policies/landing-demo.json +22 -22
package/policies/saas.json +12 -12
package/policies/startup.json +12 -12
package/src/enterprise/audit-logger.js +166 -166
package/src/enterprise/pdf-exporter.js +267 -267
package/src/enterprise/rbac-gate.js +142 -142
package/src/enterprise/rbac.js +239 -239
package/src/enterprise/site-manager.js +180 -180
package/src/founder/feedback-system.js +156 -156
package/src/founder/founder-tracker.js +213 -213
package/src/founder/usage-signals.js +141 -141
package/src/guardian/action-hints.js +439 -439
package/src/guardian/alert-ledger.js +121 -121
package/src/guardian/artifact-sanitizer.js +56 -56
package/src/guardian/attempt-engine.js +1069 -1029
package/src/guardian/attempt-registry.js +267 -267
package/src/guardian/attempt-relevance.js +106 -106
package/src/guardian/attempt-reporter.js +513 -507
package/src/guardian/attempt.js +274 -273
package/src/guardian/attempts-filter.js +63 -63
package/src/guardian/auto-attempt-builder.js +283 -283
package/src/guardian/baseline-registry.js +177 -177
package/src/guardian/baseline-reporter.js +143 -143
package/src/guardian/baseline-storage.js +285 -285
package/src/guardian/baseline.js +535 -534
package/src/guardian/behavioral-signals.js +261 -261
package/src/guardian/breakage-intelligence.js +224 -224
package/src/guardian/browser-pool.js +131 -131
package/src/guardian/browser.js +119 -119
package/src/guardian/canonical-truth.js +308 -308
package/src/guardian/ci-cli.js +121 -121
package/src/guardian/ci-gate.js +96 -96
package/src/guardian/ci-mode.js +15 -15
package/src/guardian/ci-output.js +55 -38
package/src/guardian/cli-summary.js +102 -102
package/src/guardian/confidence-signals.js +251 -251
package/src/guardian/config-loader.js +161 -161
package/src/guardian/config-validator.js +285 -283
package/src/guardian/coverage-model.js +239 -239
package/src/guardian/coverage-packs.js +58 -58
package/src/guardian/crawler.js +142 -142
package/src/guardian/data-guardian-detector.js +189 -189
package/src/guardian/decision-authority.js +746 -725
package/src/guardian/detection-layers.js +271 -271
package/src/guardian/determinism.js +146 -146
package/src/guardian/discovery-engine.js +661 -661
package/src/guardian/drift-detector.js +100 -100
package/src/guardian/enhanced-html-reporter.js +522 -522
package/src/guardian/env-guard.js +128 -127
package/src/guardian/error-clarity.js +399 -399
package/src/guardian/export-contract.js +196 -196
package/src/guardian/fail-safe.js +212 -212
package/src/guardian/failure-intelligence.js +173 -173
package/src/guardian/failure-taxonomy.js +169 -169
package/src/guardian/final-outcome.js +206 -206
package/src/guardian/first-run-profile.js +89 -89
package/src/guardian/first-run.js +65 -67
package/src/guardian/flag-validator.js +111 -111
package/src/guardian/flow-executor.js +641 -639
package/src/guardian/flow-registry.js +67 -67
package/src/guardian/honesty.js +394 -394
package/src/guardian/html-reporter.js +416 -416
package/src/guardian/human-intent-resolver.js +296 -296
package/src/guardian/human-interaction-model.js +351 -351
package/src/guardian/human-journey-context.js +184 -184
package/src/guardian/human-navigator.js +544 -544
package/src/guardian/human-reporter.js +435 -431
package/src/guardian/index.js +226 -221
package/src/guardian/init-command.js +143 -143
package/src/guardian/intent-detector.js +148 -146
package/src/guardian/journey-definitions.js +132 -132
package/src/guardian/journey-scan-cli.js +142 -145
package/src/guardian/journey-scanner.js +583 -583
package/src/guardian/junit-reporter.js +281 -281
package/src/guardian/language-detection.js +99 -99
package/src/guardian/live-alert.js +56 -56
package/src/guardian/live-baseline-compare.js +146 -146
package/src/guardian/live-cli.js +95 -95
package/src/guardian/live-guardian.js +210 -210
package/src/guardian/live-scheduler-runner.js +137 -137
package/src/guardian/live-scheduler-state.js +167 -168
package/src/guardian/live-scheduler.js +146 -146
package/src/guardian/live-state.js +110 -110
package/src/guardian/market-criticality.js +335 -335
package/src/guardian/market-reporter.js +577 -577
package/src/guardian/network-trace.js +178 -178
package/src/guardian/obs-logger.js +110 -110
package/src/guardian/observed-capabilities.js +427 -427
package/src/guardian/output-contract.js +154 -0
package/src/guardian/output-readability.js +264 -264
package/src/guardian/parallel-executor.js +116 -116
package/src/guardian/path-safety.js +56 -56
package/src/guardian/pattern-analyzer.js +348 -348
package/src/guardian/policy.js +432 -434
package/src/guardian/prelaunch-gate.js +193 -193
package/src/guardian/prerequisite-checker.js +101 -101
package/src/guardian/preset-loader.js +152 -157
package/src/guardian/profile-loader.js +96 -96
package/src/guardian/reality.js +3025 -2826
package/src/guardian/realworld-scenarios.js +94 -94
package/src/guardian/reporter.js +167 -167
package/src/guardian/retry-policy.js +123 -123
package/src/guardian/root-cause-analysis.js +171 -171
package/src/guardian/rules-engine.js +558 -558
package/src/guardian/run-artifacts.js +212 -212
package/src/guardian/run-cleanup.js +207 -207
package/src/guardian/run-export.js +522 -522
package/src/guardian/run-latest.js +90 -90
package/src/guardian/run-list.js +211 -211
package/src/guardian/run-summary.js +20 -20
package/src/guardian/runtime-root.js +246 -246
package/src/guardian/safety.js +248 -248
package/src/guardian/scan-presets.js +133 -149
package/src/guardian/screenshot.js +152 -152
package/src/guardian/secret-hygiene.js +44 -44
package/src/guardian/selector-fallbacks.js +394 -394
package/src/guardian/semantic-contact-detection.js +255 -255
package/src/guardian/semantic-contact-finder.js +201 -201
package/src/guardian/semantic-targets.js +234 -234
package/src/guardian/site-intelligence.js +588 -588
package/src/guardian/site-introspection.js +257 -257
package/src/guardian/sitemap.js +225 -225
package/src/guardian/smoke.js +283 -258
package/src/guardian/snapshot-schema.js +177 -290
package/src/guardian/snapshot.js +430 -397
package/src/guardian/stability-scorer.js +169 -169
package/src/guardian/success-evaluator.js +214 -214
package/src/guardian/template-command.js +184 -184
package/src/guardian/text-formatters.js +426 -426
package/src/guardian/timeout-profiles.js +57 -57
package/src/guardian/truth/attempt.contract.js +158 -0
package/src/guardian/truth/decision.contract.js +275 -0
package/src/guardian/truth/snapshot.contract.js +363 -0
package/src/guardian/validators.js +323 -323
package/src/guardian/verdict-card.js +474 -474
package/src/guardian/verdict-clarity.js +298 -298
package/src/guardian/verdict-policy.js +363 -363
package/src/guardian/verdict.js +333 -333
package/src/guardian/verdicts.js +79 -74
package/src/guardian/visual-diff.js +247 -247
package/src/guardian/wait-for-outcome.js +119 -119
package/src/guardian/watch-runner.js +181 -181
package/src/guardian/watchdog-diff.js +167 -167
package/src/guardian/webhook.js +206 -206
package/src/payments/stripe-checkout.js +169 -169
package/src/plans/plan-definitions.js +148 -148
package/src/plans/plan-manager.js +211 -211
package/src/plans/usage-tracker.js +210 -210
package/src/recipes/recipe-engine.js +188 -188
package/src/recipes/recipe-failure-analysis.js +159 -159
package/src/recipes/recipe-registry.js +134 -134
package/src/recipes/recipe-runtime.js +507 -507
package/src/recipes/recipe-store.js +410 -410
package/SECURITY.md +0 -77
package/VERSIONING.md +0 -100
package/guardian-contract-v1.md +0 -502

package/src/guardian/html-reporter.js CHANGED Viewed

@@ -1,416 +1,416 @@
-/**
- * Guardian HTML Report Generator
- * Creates beautiful, self-contained HTML reports
- */
-const fs = require('fs');
-const path = require('path');
-const { getFounderBadgeHTML } = require('../founder/founder-tracker');
-class GuardianHTMLReporter {
-  /**
-   * Generate HTML report from JSON report
-   * @param {object} jsonReport - JSON report object
-   * @param {string} artifactsDir - Directory containing artifacts
-   * @returns {string} HTML content
-   */
-  generate(jsonReport, artifactsDir) {
-    const html = `<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Guardian Report - ${jsonReport.baseUrl}</title>
-    <style>
-        * { margin: 0; padding: 0; box-sizing: border-box; }
-        body {
-            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
-            background: #f5f5f5;
-            color: #333;
-            line-height: 1.6;
-        }
-        .container {
-            max-width: 1200px;
-            margin: 0 auto;
-            padding: 20px;
-        }
-        .header {
-            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
-            color: white;
-            padding: 40px 20px;
-            border-radius: 10px;
-            margin-bottom: 30px;
-            box-shadow: 0 10px 40px rgba(0,0,0,0.1);
-        }
-        .header h1 {
-            font-size: 2.5em;
-            margin-bottom: 10px;
-        }
-        .header .subtitle {
-            font-size: 1.2em;
-            opacity: 0.9;
-        }
-        .verdict {
-            background: white;
-            padding: 30px;
-            border-radius: 10px;
-            margin-bottom: 30px;
-            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
-        }
-        .verdict.ready {
-            border-left: 5px solid #10b981;
-        }
-        .verdict.do-not-launch {
-            border-left: 5px solid #ef4444;
-        }
-        .verdict.insufficient {
-            border-left: 5px solid #f59e0b;
-        }
-        .verdict-badge {
-            display: inline-block;
-            padding: 10px 20px;
-            border-radius: 20px;
-            font-weight: bold;
-            font-size: 1.2em;
-            margin-bottom: 15px;
-        }
-        .verdict-badge.ready {
-            background: #d1fae5;
-            color: #065f46;
-        }
-        .verdict-badge.do-not-launch {
-            background: #fee2e2;
-            color: #991b1b;
-        }
-        .verdict-badge.insufficient {
-            background: #fef3c7;
-            color: #92400e;
-        }
-        .metrics {
-            display: grid;
-            grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
-            gap: 20px;
-            margin-bottom: 30px;
-        }
-        .metric-card {
-            background: white;
-            padding: 20px;
-            border-radius: 10px;
-            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
-        }
-        .metric-card .label {
-            font-size: 0.9em;
-            color: #666;
-            margin-bottom: 5px;
-        }
-        .metric-card .value {
-            font-size: 2em;
-            font-weight: bold;
-            color: #667eea;
-        }
-        .section {
-            background: white;
-            padding: 30px;
-            border-radius: 10px;
-            margin-bottom: 30px;
-            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
-        }
-        .section h2 {
-            margin-bottom: 20px;
-            color: #667eea;
-            border-bottom: 2px solid #f0f0f0;
-            padding-bottom: 10px;
-        }
-        .reason-list {
-            list-style: none;
-        }
-        .reason-list li {
-            padding: 10px;
-            margin-bottom: 10px;
-            background: #f9fafb;
-            border-left: 3px solid #667eea;
-            border-radius: 5px;
-        }
-        .screenshots {
-            display: grid;
-            grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
-            gap: 20px;
-        }
-        .screenshot-card {
-            border: 1px solid #e5e7eb;
-            border-radius: 10px;
-            overflow: hidden;
-            transition: transform 0.2s;
-        }
-        .screenshot-card:hover {
-            transform: translateY(-5px);
-            box-shadow: 0 10px 20px rgba(0,0,0,0.1);
-        }
-        .screenshot-card img {
-            width: 100%;
-            height: 200px;
-            object-fit: cover;
-        }
-        .screenshot-card .caption {
-            padding: 10px;
-            background: #f9fafb;
-            font-size: 0.9em;
-            color: #666;
-        }
-        .page-table {
-            width: 100%;
-            border-collapse: collapse;
-        }
-        .page-table th {
-            background: #f9fafb;
-            padding: 12px;
-            text-align: left;
-            font-weight: 600;
-            border-bottom: 2px solid #e5e7eb;
-        }
-        .page-table td {
-            padding: 12px;
-            border-bottom: 1px solid #e5e7eb;
-        }
-        .page-table tr:hover {
-            background: #f9fafb;
-        }
-        .status-badge {
-            display: inline-block;
-            padding: 4px 12px;
-            border-radius: 12px;
-            font-size: 0.85em;
-            font-weight: 600;
-        }
-        .status-success {
-            background: #d1fae5;
-            color: #065f46;
-        }
-        .status-error {
-            background: #fee2e2;
-            color: #991b1b;
-        }
-        .footer {
-            text-align: center;
-            padding: 20px;
-            color: #666;
-            font-size: 0.9em;
-        }
-        .confidence-high { color: #10b981; font-weight: bold; }
-        .confidence-medium { color: #f59e0b; font-weight: bold; }
-        .confidence-low { color: #ef4444; font-weight: bold; }
-    </style>
-</head>
-<body>
-    <div class="container">
-        <div class="header">
-            <h1>🛡️ ODAVL Guardian</h1>
-            <div class="subtitle">Market Reality Testing Report</div>
-        </div>
-        ${getFounderBadgeHTML()}
-        ${this.generateVerdictSection(jsonReport)}
-        ${this.generateMetricsSection(jsonReport)}
-        ${this.generateReasonsSection(jsonReport)}
-        ${this.generatePagesSection(jsonReport)}
-        ${this.generateScreenshotsSection(jsonReport, artifactsDir)}
-        <div class="footer">
-            Generated by ODAVL Guardian • ${new Date(jsonReport.timestamp).toLocaleString()}
-        </div>
-    </div>
-</body>
-</html>`;
-    return html;
-  }
-  /**
-   * Generate verdict section
-   */
-  generateVerdictSection(report) {
-    const decision = report.finalJudgment.decision;
-    const decisionClass = decision.toLowerCase().replace(/_/g, '-');
-    const decisionIcon = decision === 'READY' ? '🟢' : decision === 'DO_NOT_LAUNCH' ? '🔴' : '🟡';
-    const decisionText = decision === 'READY' ? 'Safe to Launch' : decision === 'DO_NOT_LAUNCH' ? 'DO NOT LAUNCH' : 'Insufficient Confidence';
-    return `
-        <div class="verdict ${decisionClass}">
-            <div class="verdict-badge ${decisionClass}">
-                ${decisionIcon} ${decisionText}
-            </div>
-            <p style="margin-top: 15px; font-size: 1.1em;">
-                <strong>Target:</strong> ${report.baseUrl}
-            </p>
-            <p style="margin-top: 10px;">
-                <strong>Confidence:</strong>
-                <span class="confidence-${report.confidence.level.toLowerCase()}">${report.confidence.level}</span>
-            </p>
-            <p style="margin-top: 5px; color: #666;">
-                ${report.confidence.reasoning}
-            </p>
-        </div>
-    `;
-  }
-  /**
-   * Generate metrics section
-   */
-  generateMetricsSection(report) {
-    return `
-        <div class="metrics">
-            <div class="metric-card">
-                <div class="label">Coverage</div>
-                <div class="value">${report.summary.coverage}%</div>
-            </div>
-            <div class="metric-card">
-                <div class="label">Pages Visited</div>
-                <div class="value">${report.summary.visitedPages}</div>
-            </div>
-            <div class="metric-card">
-                <div class="label">Pages Discovered</div>
-                <div class="value">${report.summary.discoveredPages}</div>
-            </div>
-            <div class="metric-card">
-                <div class="label">Failed Pages</div>
-                <div class="value" style="color: ${report.summary.failedPages > 0 ? '#ef4444' : '#10b981'}">
-                    ${report.summary.failedPages}
-                </div>
-            </div>
-        </div>
-    `;
-  }
-  /**
-   * Generate reasons section
-   */
-  generateReasonsSection(report) {
-    const reasons = report.finalJudgment.reasons || [];
-    if (reasons.length === 0) return '';
-    const reasonItems = reasons.map(r => `<li>${r}</li>`).join('');
-    return `
-        <div class="section">
-            <h2>📋 Decision Reasons</h2>
-            <ul class="reason-list">
-                ${reasonItems}
-            </ul>
-        </div>
-    `;
-  }
-  /**
-   * Generate pages section
-   */
-  generatePagesSection(report) {
-    const pages = report.pages || [];
-    if (pages.length === 0) return '';
-    const rows = pages.map(page => {
-      const statusClass = page.status >= 200 && page.status < 400 ? 'status-success' : 'status-error';
-      const statusText = page.status || 'N/A';
-      return `
-        <tr>
-            <td>${page.index}</td>
-            <td style="word-break: break-all;">${page.url}</td>
-            <td><span class="status-badge ${statusClass}">${statusText}</span></td>
-            <td>${page.links || 0}</td>
-        </tr>
-      `;
-    }).join('');
-    return `
-        <div class="section">
-            <h2>📄 Pages Visited</h2>
-            <table class="page-table">
-                <thead>
-                    <tr>
-                        <th>#</th>
-                        <th>URL</th>
-                        <th>Status</th>
-                        <th>Links</th>
-                    </tr>
-                </thead>
-                <tbody>
-                    ${rows}
-                </tbody>
-            </table>
-        </div>
-    `;
-  }
-  /**
-   * Generate screenshots section
-   */
-  generateScreenshotsSection(report, artifactsDir) {
-    const pagesDir = path.join(artifactsDir, 'pages');
-    // Check if pages directory exists
-    if (!fs.existsSync(pagesDir)) {
-      return '';
-    }
-    // Get all screenshot files
-    const files = fs.readdirSync(pagesDir).filter(f => f.endsWith('.jpeg') || f.endsWith('.jpg') || f.endsWith('.png'));
-    if (files.length === 0) {
-      return '';
-    }
-    const cards = files.map(file => {
-      const relativePath = `pages/${file}`;
-      return `
-        <div class="screenshot-card">
-            <img src="${relativePath}" alt="${file}" loading="lazy">
-            <div class="caption">${file}</div>
-        </div>
-      `;
-    }).join('');
-    return `
-        <div class="section">
-            <h2>📸 Screenshots</h2>
-            <div class="screenshots">
-                ${cards}
-            </div>
-        </div>
-    `;
-  }
-  /**
-   * Save HTML report to file
-   * @param {string} html - HTML content
-   * @param {string} outputPath - Where to save the HTML file
-   * @returns {boolean} Success status
-   */
-  save(html, outputPath) {
-    try {
-      fs.writeFileSync(outputPath, html, 'utf8');
-      return true;
-    } catch (error) {
-      console.error(`❌ Failed to save HTML report: ${error.message}`);
-      return false;
-    }
-  }
-  /**
-   * Generate and save HTML report
-   * @param {object} jsonReport - JSON report object
-   * @param {string} artifactsDir - Directory containing artifacts
-   * @returns {boolean} Success status
-   */
-  generateAndSave(jsonReport, artifactsDir) {
-    try {
-      const html = this.generate(jsonReport, artifactsDir);
-      const outputPath = path.join(artifactsDir, 'report.html');
-      return this.save(html, outputPath);
-    } catch (error) {
-      console.error(`❌ Failed to generate HTML report: ${error.message}`);
-      return false;
-    }
-  }
-}
-module.exports = GuardianHTMLReporter;
+/**
+ * Guardian HTML Report Generator
+ * Creates beautiful, self-contained HTML reports
+ */
+const fs = require('fs');
+const path = require('path');
+const { getFounderBadgeHTML } = require('../founder/founder-tracker');
+class GuardianHTMLReporter {
+  /**
+   * Generate HTML report from JSON report
+   * @param {object} jsonReport - JSON report object
+   * @param {string} artifactsDir - Directory containing artifacts
+   * @returns {string} HTML content
+   */
+  generate(jsonReport, artifactsDir) {
+    const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Guardian Report - ${jsonReport.baseUrl}</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+            background: #f5f5f5;
+            color: #333;
+            line-height: 1.6;
+        }
+        .container {
+            max-width: 1200px;
+            margin: 0 auto;
+            padding: 20px;
+        }
+        .header {
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+            padding: 40px 20px;
+            border-radius: 10px;
+            margin-bottom: 30px;
+            box-shadow: 0 10px 40px rgba(0,0,0,0.1);
+        }
+        .header h1 {
+            font-size: 2.5em;
+            margin-bottom: 10px;
+        }
+        .header .subtitle {
+            font-size: 1.2em;
+            opacity: 0.9;
+        }
+        .verdict {
+            background: white;
+            padding: 30px;
+            border-radius: 10px;
+            margin-bottom: 30px;
+            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
+        }
+        .verdict.ready {
+            border-left: 5px solid #10b981;
+        }
+        .verdict.do-not-launch {
+            border-left: 5px solid #ef4444;
+        }
+        .verdict.insufficient {
+            border-left: 5px solid #f59e0b;
+        }
+        .verdict-badge {
+            display: inline-block;
+            padding: 10px 20px;
+            border-radius: 20px;
+            font-weight: bold;
+            font-size: 1.2em;
+            margin-bottom: 15px;
+        }
+        .verdict-badge.ready {
+            background: #d1fae5;
+            color: #065f46;
+        }
+        .verdict-badge.do-not-launch {
+            background: #fee2e2;
+            color: #991b1b;
+        }
+        .verdict-badge.insufficient {
+            background: #fef3c7;
+            color: #92400e;
+        }
+        .metrics {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+            gap: 20px;
+            margin-bottom: 30px;
+        }
+        .metric-card {
+            background: white;
+            padding: 20px;
+            border-radius: 10px;
+            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
+        }
+        .metric-card .label {
+            font-size: 0.9em;
+            color: #666;
+            margin-bottom: 5px;
+        }
+        .metric-card .value {
+            font-size: 2em;
+            font-weight: bold;
+            color: #667eea;
+        }
+        .section {
+            background: white;
+            padding: 30px;
+            border-radius: 10px;
+            margin-bottom: 30px;
+            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
+        }
+        .section h2 {
+            margin-bottom: 20px;
+            color: #667eea;
+            border-bottom: 2px solid #f0f0f0;
+            padding-bottom: 10px;
+        }
+        .reason-list {
+            list-style: none;
+        }
+        .reason-list li {
+            padding: 10px;
+            margin-bottom: 10px;
+            background: #f9fafb;
+            border-left: 3px solid #667eea;
+            border-radius: 5px;
+        }
+        .screenshots {
+            display: grid;
+            grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
+            gap: 20px;
+        }
+        .screenshot-card {
+            border: 1px solid #e5e7eb;
+            border-radius: 10px;
+            overflow: hidden;
+            transition: transform 0.2s;
+        }
+        .screenshot-card:hover {
+            transform: translateY(-5px);
+            box-shadow: 0 10px 20px rgba(0,0,0,0.1);
+        }
+        .screenshot-card img {
+            width: 100%;
+            height: 200px;
+            object-fit: cover;
+        }
+        .screenshot-card .caption {
+            padding: 10px;
+            background: #f9fafb;
+            font-size: 0.9em;
+            color: #666;
+        }
+        .page-table {
+            width: 100%;
+            border-collapse: collapse;
+        }
+        .page-table th {
+            background: #f9fafb;
+            padding: 12px;
+            text-align: left;
+            font-weight: 600;
+            border-bottom: 2px solid #e5e7eb;
+        }
+        .page-table td {
+            padding: 12px;
+            border-bottom: 1px solid #e5e7eb;
+        }
+        .page-table tr:hover {
+            background: #f9fafb;
+        }
+        .status-badge {
+            display: inline-block;
+            padding: 4px 12px;
+            border-radius: 12px;
+            font-size: 0.85em;
+            font-weight: 600;
+        }
+        .status-success {
+            background: #d1fae5;
+            color: #065f46;
+        }
+        .status-error {
+            background: #fee2e2;
+            color: #991b1b;
+        }
+        .footer {
+            text-align: center;
+            padding: 20px;
+            color: #666;
+            font-size: 0.9em;
+        }
+        .confidence-high { color: #10b981; font-weight: bold; }
+        .confidence-medium { color: #f59e0b; font-weight: bold; }
+        .confidence-low { color: #ef4444; font-weight: bold; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="header">
+            <h1>🛡️ ODAVL Guardian</h1>
+            <div class="subtitle">Market Reality Testing Report</div>
+        </div>
+        ${getFounderBadgeHTML()}
+        ${this.generateVerdictSection(jsonReport)}
+        ${this.generateMetricsSection(jsonReport)}
+        ${this.generateReasonsSection(jsonReport)}
+        ${this.generatePagesSection(jsonReport)}
+        ${this.generateScreenshotsSection(jsonReport, artifactsDir)}
+        <div class="footer">
+            Generated by ODAVL Guardian • ${new Date(jsonReport.timestamp).toLocaleString()}
+        </div>
+    </div>
+</body>
+</html>`;
+    return html;
+  }
+  /**
+   * Generate verdict section
+   */
+  generateVerdictSection(report) {
+    const decision = report.finalJudgment.decision;
+    const decisionClass = decision.toLowerCase().replace(/_/g, '-');
+    const decisionIcon = decision === 'READY' ? '🟢' : decision === 'DO_NOT_LAUNCH' ? '🔴' : '🟡';
+    const decisionText = decision === 'READY' ? 'Safe to Launch' : decision === 'DO_NOT_LAUNCH' ? 'DO NOT LAUNCH' : 'Insufficient Confidence';
+    return `
+        <div class="verdict ${decisionClass}">
+            <div class="verdict-badge ${decisionClass}">
+                ${decisionIcon} ${decisionText}
+            </div>
+            <p style="margin-top: 15px; font-size: 1.1em;">
+                <strong>Target:</strong> ${report.baseUrl}
+            </p>
+            <p style="margin-top: 10px;">
+                <strong>Confidence:</strong>
+                <span class="confidence-${report.confidence.level.toLowerCase()}">${report.confidence.level}</span>
+            </p>
+            <p style="margin-top: 5px; color: #666;">
+                ${report.confidence.reasoning}
+            </p>
+        </div>
+    `;
+  }
+  /**
+   * Generate metrics section
+   */
+  generateMetricsSection(report) {
+    return `
+        <div class="metrics">
+            <div class="metric-card">
+                <div class="label">Coverage</div>
+                <div class="value">${report.summary.coverage}%</div>
+            </div>
+            <div class="metric-card">
+                <div class="label">Pages Visited</div>
+                <div class="value">${report.summary.visitedPages}</div>
+            </div>
+            <div class="metric-card">
+                <div class="label">Pages Discovered</div>
+                <div class="value">${report.summary.discoveredPages}</div>
+            </div>
+            <div class="metric-card">
+                <div class="label">Failed Pages</div>
+                <div class="value" style="color: ${report.summary.failedPages > 0 ? '#ef4444' : '#10b981'}">
+                    ${report.summary.failedPages}
+                </div>
+            </div>
+        </div>
+    `;
+  }
+  /**
+   * Generate reasons section
+   */
+  generateReasonsSection(report) {
+    const reasons = report.finalJudgment.reasons || [];
+    if (reasons.length === 0) return '';
+    const reasonItems = reasons.map(r => `<li>${r}</li>`).join('');
+    return `
+        <div class="section">
+            <h2>📋 Decision Reasons</h2>
+            <ul class="reason-list">
+                ${reasonItems}
+            </ul>
+        </div>
+    `;
+  }
+  /**
+   * Generate pages section
+   */
+  generatePagesSection(report) {
+    const pages = report.pages || [];
+    if (pages.length === 0) return '';
+    const rows = pages.map(page => {
+      const statusClass = page.status >= 200 && page.status < 400 ? 'status-success' : 'status-error';
+      const statusText = page.status || 'N/A';
+      return `
+        <tr>
+            <td>${page.index}</td>
+            <td style="word-break: break-all;">${page.url}</td>
+            <td><span class="status-badge ${statusClass}">${statusText}</span></td>
+            <td>${page.links || 0}</td>
+        </tr>
+      `;
+    }).join('');
+    return `
+        <div class="section">
+            <h2>📄 Pages Visited</h2>
+            <table class="page-table">
+                <thead>
+                    <tr>
+                        <th>#</th>
+                        <th>URL</th>
+                        <th>Status</th>
+                        <th>Links</th>
+                    </tr>
+                </thead>
+                <tbody>
+                    ${rows}
+                </tbody>
+            </table>
+        </div>
+    `;
+  }
+  /**
+   * Generate screenshots section
+   */
+  generateScreenshotsSection(report, artifactsDir) {
+    const pagesDir = path.join(artifactsDir, 'pages');
+    // Check if pages directory exists
+    if (!fs.existsSync(pagesDir)) {
+      return '';
+    }
+    // Get all screenshot files
+    const files = fs.readdirSync(pagesDir).filter(f => f.endsWith('.jpeg') || f.endsWith('.jpg') || f.endsWith('.png'));
+    if (files.length === 0) {
+      return '';
+    }
+    const cards = files.map(file => {
+      const relativePath = `pages/${file}`;
+      return `
+        <div class="screenshot-card">
+            <img src="${relativePath}" alt="${file}" loading="lazy">
+            <div class="caption">${file}</div>
+        </div>
+      `;
+    }).join('');
+    return `
+        <div class="section">
+            <h2>📸 Screenshots</h2>
+            <div class="screenshots">
+                ${cards}
+            </div>
+        </div>
+    `;
+  }
+  /**
+   * Save HTML report to file
+   * @param {string} html - HTML content
+   * @param {string} outputPath - Where to save the HTML file
+   * @returns {boolean} Success status
+   */
+  save(html, outputPath) {
+    try {
+      fs.writeFileSync(outputPath, html, 'utf8');
+      return true;
+    } catch (error) {
+      console.error(`❌ Failed to save HTML report: ${error.message}`);
+      return false;
+    }
+  }
+  /**
+   * Generate and save HTML report
+   * @param {object} jsonReport - JSON report object
+   * @param {string} artifactsDir - Directory containing artifacts
+   * @returns {boolean} Success status
+   */
+  generateAndSave(jsonReport, artifactsDir) {
+    try {
+      const html = this.generate(jsonReport, artifactsDir);
+      const outputPath = path.join(artifactsDir, 'report.html');
+      return this.save(html, outputPath);
+    } catch (error) {
+      console.error(`❌ Failed to generate HTML report: ${error.message}`);
+      return false;
+    }
+  }
+}
+module.exports = GuardianHTMLReporter;