@odavl/guardian 0.1.0-rc1 → 1.0.0

package/src/guardian/market-reporter.js

@@ -46,14 +46,21 @@ class MarketReporter {
 
   generateHtmlReport(report) {
     const { summary, results, runId, baseUrl, attemptsRun, timestamp, manualResults = [], autoResults = [], flows = [], flowSummary = { total: 0, success: 0, failure: 0 }, intelligence = {} } = report;
-    const verdictColor = summary.overallVerdict === 'SUCCESS' ? '#10b981'
-      : summary.overallVerdict === 'FRICTION' ? '#f59e0b'
+    const { toCanonicalVerdict } = require('./verdicts');
+    const overallCanonical = toCanonicalVerdict(summary.overallVerdict);
+    const verdictColor = overallCanonical === 'READY' ? '#10b981'
+      : overallCanonical === 'FRICTION' ? '#f59e0b'
       : '#ef4444';
-    const verdictEmoji = summary.overallVerdict === 'SUCCESS' ? '🟢' : summary.overallVerdict === 'FRICTION' ? '🟡' : '🔴';
+    const verdictEmoji = overallCanonical === 'READY' ? '🟢' : overallCanonical === 'FRICTION' ? '🟡' : '🔴';
+
+    // Phase 5: Generate Executive Summary
+    const executiveSummary = this._generateExecutiveSummary(intelligence, results, flows);
 
     const attemptsRows = results.map((result, idx) => {
-      const color = result.outcome === 'SUCCESS' ? '#10b981' : result.outcome === 'FRICTION' ? '#f59e0b' : '#ef4444';
-      const badge = result.outcome === 'SUCCESS' ? '✅ SUCCESS' : result.outcome === 'FRICTION' ? '⚠️ FRICTION' : '❌ FAILURE';
+      const { toCanonicalVerdict } = require('./verdicts');
+      const canon = toCanonicalVerdict(result.outcome);
+      const color = canon === 'READY' ? '#10b981' : canon === 'FRICTION' ? '#f59e0b' : '#ef4444';
+      const badge = canon === 'READY' ? '✅ READY' : canon === 'FRICTION' ? '⚠️ FRICTION' : '❌ DO_NOT_LAUNCH';
       const frictionSignals = result.friction && result.friction.signals ? result.friction.signals : [];
       const sourceLabel = result.source === 'auto-generated' ? ' 🤖' : '';
       return `
@@ -119,8 +126,25 @@ class MarketReporter {
     }).join('');
 
     const flowRows = flows.map((flow, idx) => {
-      const color = flow.outcome === 'SUCCESS' ? '#10b981' : '#ef4444';
-      const badge = flow.outcome === 'SUCCESS' ? '✅ SUCCESS' : '❌ FAILURE';
+      const { toCanonicalVerdict } = require('./verdicts');
+      const canon = toCanonicalVerdict(flow.outcome);
+      const color = canon === 'READY' ? '#10b981' : canon === 'FRICTION' ? '#f59e0b' : '#ef4444';
+      const badge = canon === 'READY' ? '✅ READY' : canon === 'FRICTION' ? '⚠️ FRICTION' : '❌ DO_NOT_LAUNCH';
+      const evalSummary = flow.successEval ? (() => {
+        const reasons = (flow.successEval.reasons || []).slice(0, 3).map(r => `• ${r}`).join('<br/>');
+        const ev = flow.successEval.evidence || {};
+        const net = Array.isArray(ev.network) ? ev.network : [];
+        const primary = net.find(n => (n.method === 'POST' || n.method === 'PUT') && n.status != null) || net[0];
+        const reqLine = primary ? (() => { try { const p = new URL(primary.url); return `${primary.method} ${p.pathname} → ${primary.status}`; } catch { return `${primary.method} ${primary.url} → ${primary.status}`; } })() : null;
+        const navLine = ev.urlChanged ? 'navigation: changed' : null;
+        const formStates = [];
+        if (ev.formCleared) formStates.push('cleared');
+        if (ev.formDisabled) formStates.push('disabled');
+        if (ev.formDisappeared) formStates.push('disappeared');
+        const formLine = formStates.length ? `form: ${formStates.join(', ')}` : null;
+        const evidences = [reqLine, navLine, formLine].filter(Boolean).map(e => `• ${e}`).join('<br/>' );
+        return `<div><strong>Reasons:</strong><br/>${reasons || '—'}<br/><strong>Evidence:</strong><br/>${evidences || '—'}</div>`;
+      })() : '';
       return `
         <tr>
           <td>${idx + 1}</td>
@@ -128,7 +152,7 @@ class MarketReporter {
           <td>${flow.flowName || ''}</td>
           <td><span class="badge" style="background:${color}">${badge}</span></td>
           <td>${flow.stepsExecuted || 0}/${flow.stepsTotal || 0}</td>
-          <td>${flow.error || ''}</td>
+          <td>${flow.error || evalSummary || ''}</td>
         </tr>
       `;
     }).join('');
@@ -156,7 +180,8 @@ class MarketReporter {
     .attempt-detail { margin-top: 10px; }
     .friction-block { margin: 10px 0; }
     .signal-card { background: #fefce8; border: 1px solid #fde047; border-left: 4px solid #f59e0b; border-radius: 6px; padding: 10px; margin-bottom: 10px; }
-    .signal-card.severity-low { background: #f0f9ff; border-color: #7dd3fc; border-left-color: #0ea5e9; }
+    .signal-card.severity-low { background: #f0f9ff; border-color: #7dd3fc; border-left-color: #0ea5e9; display: none; }
+    .show-low-severity .signal-card.severity-low { display: block; }
     .signal-card.severity-medium { background: #fefce8; border-color: #fde047; border-left-color: #f59e0b; }
     .signal-card.severity-high { background: #fef2f2; border-color: #fca5a5; border-left-color: #ef4444; }
     .signal-header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 6px; }
@@ -170,13 +195,47 @@ class MarketReporter {
     .steps-block ol { padding-left: 20px; }
     .no-friction { color: #16a34a; font-weight: 600; }
     .meta { display: flex; gap: 18px; margin-top: 10px; color: #e5e7eb; font-size: 0.95em; }
+    /* Phase 5: Executive Summary Styles */
+    .executive-summary { background: linear-gradient(135deg, #ffffff, #f8fafc); border: 3px solid #3b82f6; border-radius: 12px; padding: 24px; margin-bottom: 24px; box-shadow: 0 4px 12px rgba(0,0,0,0.15); }
+    .executive-summary h2 { color: #1e40af; margin: 0 0 20px 0; font-size: 28px; border-bottom: 2px solid #3b82f6; padding-bottom: 12px; }
+    .exec-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 20px; margin-bottom: 20px; }
+    .exec-card { background: white; border-radius: 8px; padding: 18px; box-shadow: 0 2px 8px rgba(0,0,0,0.08); border-left: 4px solid #3b82f6; }
+    .exec-card h3 { color: #374151; margin: 0 0 12px 0; font-size: 16px; text-transform: uppercase; letter-spacing: 0.5px; }
+    .exec-verdict { font-size: 24px; font-weight: bold; margin: 8px 0; }
+    .exec-verdict.safe { color: #10b981; }
+    .exec-verdict.caution { color: #f59e0b; }
+    .exec-verdict.danger { color: #ef4444; }
+    .exec-score { font-size: 48px; font-weight: bold; color: #3b82f6; margin: 8px 0; }
+    .exec-score-label { color: #6b7280; font-size: 14px; }
+    .exec-risk-list { list-style: none; padding: 0; margin: 0; }
+    .exec-risk-item { background: #f9fafb; border-left: 3px solid #ef4444; padding: 10px 12px; margin-bottom: 10px; border-radius: 4px; }
+    .exec-risk-item .risk-title { font-weight: 600; color: #111827; margin-bottom: 4px; }
+    .exec-risk-item .risk-badge { display: inline-block; padding: 2px 8px; border-radius: 4px; font-size: 11px; font-weight: bold; text-transform: uppercase; color: white; }
+    .exec-risk-item .risk-why-matters { color: #6b7280; font-size: 13px; margin-top: 6px; line-height: 1.4; font-style: italic; }
+    .exec-risk-item .risk-badge.CRITICAL { background: #dc2626; }
+    .exec-risk-item .risk-badge.WARNING { background: #f59e0b; }
+    .exec-risk-item .risk-badge.INFO { background: #3b82f6; }
+    .exec-action { background: #eff6ff; border: 2px solid #3b82f6; border-radius: 8px; padding: 16px; margin-top: 16px; }
+    .exec-action h3 { color: #1e40af; margin: 0 0 10px 0; font-size: 16px; }
+    .exec-action p { color: #1f2937; font-size: 15px; font-weight: 500; margin: 0; line-height: 1.5; }
+    /* Phase 5 (Part 3): Noise Reduction - Collapsible Sections */
+    .collapsible-section { background: white; border: 1px solid #e5e7eb; border-radius: 10px; margin-top: 20px; box-shadow: 0 2px 4px rgba(0,0,0,0.06); overflow: hidden; }
+    .collapsible-section[open] { box-shadow: 0 2px 8px rgba(0,0,0,0.1); }
+    .section-toggle { cursor: pointer; padding: 16px; font-weight: 600; color: #1f2937; display: flex; align-items: center; gap: 8px; user-select: none; font-size: 15px; }
+    .section-toggle:hover { background: #f9fafb; }
+    .collapsible-content { padding: 16px; border-top: 1px solid #e5e7eb; display: none; }
+    .collapsible-section[open] .collapsible-content { display: block; }
+    .collapsible-section details { margin-top: 12px; }
+    .collapsible-section details summary { cursor: pointer; padding: 8px; font-weight: 500; color: #374151; user-select: none; }
+    .collapsible-section details summary:hover { background: #f3f4f6; border-radius: 4px; }
+    .collapsible-section table { margin-bottom: 0; }
   </style>
 </head>
 <body>
   <div class="container">
     <div class="header">
       <h1>Market Reality Report</h1>
-      <div class="verdict">${verdictEmoji} ${summary.overallVerdict}</div>
+      <div class="verdict">${verdictEmoji} ${overallCanonical}</div>
       <div class="meta">
         <div><strong>Run ID:</strong> ${runId}</div>
         <div><strong>Base URL:</strong> ${baseUrl}</div>
@@ -187,88 +246,139 @@ class MarketReporter {
       </div>
     </div>
 
-    <table>
-      <thead>
-        <tr>
-          <th>#</th>
-          <th>Attempt ID</th>
-          <th>Name</th>
-          <th>Outcome</th>
-          <th>Duration</th>
-          <th>Friction Signals</th>
-          <th>Reports</th>
-        </tr>
-      </thead>
-      <tbody>
-        ${attemptsRows}
-      </tbody>
-    </table>
+    <!-- Phase 5: Executive Summary -->
+    <div class="executive-summary">
+      <h2>🧠 Executive Summary</h2>
+      <div class="exec-grid">
+        <div class="exec-card">
+          <h3>Release Verdict</h3>
+          <div class="exec-verdict ${executiveSummary.verdictClass}">${executiveSummary.verdict}</div>
+        </div>
+        <div class="exec-card">
+          <h3>Overall Risk Score</h3>
+          <div class="exec-score">${executiveSummary.riskScore}</div>
+          <div class="exec-score-label">/ 100</div>
+        </div>
+      </div>
+      <div class="exec-card">
+        <h3>Top Reason</h3>
+        <p style="color: #1f2937; font-size: 15px; margin: 0;">${executiveSummary.topReason}</p>
+      </div>
+      ${executiveSummary.topRisks.length > 0 ? `
+      <div class="exec-card" style="margin-top: 20px;">
+        <h3>Top 3 Risks</h3>
+        <ul class="exec-risk-list">
+          ${executiveSummary.topRisks.map(risk => `
+            <li class="exec-risk-item">
+              <div class="risk-title">${risk.title}</div>
+              <span class="risk-badge ${risk.severity}">${risk.severity}</span>
+              <div class="risk-why-matters">Why this matters: ${risk.whyMatters}</div>
+            </li>
+          `).join('')}
+        </ul>
+      </div>
+      ` : ''}
+      <div class="exec-action">
+        <h3>📋 Recommended Next Action</h3>
+        <p>${executiveSummary.nextAction}</p>
+      </div>
+    </div>
+
+    <details class="collapsible-section">
+      <summary class="section-toggle">📋 Attempt Details (${results.length} runs)</summary>
+      <div class="collapsible-content">
+        <table>
+          <thead>
+            <tr>
+              <th>#</th>
+              <th>Attempt ID</th>
+              <th>Name</th>
+              <th>Outcome</th>
+              <th>Duration</th>
+              <th>Friction Signals</th>
+              <th>Reports</th>
+            </tr>
+          </thead>
+          <tbody>
+            ${attemptsRows}
+          </tbody>
+        </table>
 
-    <div class="details">${attemptDetails}</div>
+        <div class="details">${attemptDetails}</div>
+      </div>
+    </details>
 
     ${flows.length ? `
-    <h3 style="margin-top:24px;">Intent Flows</h3>
-    <table>
-      <thead>
-        <tr>
-          <th>#</th>
-          <th>Flow ID</th>
-          <th>Name</th>
-          <th>Outcome</th>
-          <th>Steps</th>
-          <th>Error</th>
-        </tr>
-      </thead>
-      <tbody>
-        ${flowRows}
-      </tbody>
-    </table>
+    <details class="collapsible-section">
+      <summary class="section-toggle">🔄 Intent Flows (${flows.length})</summary>
+      <div class="collapsible-content">
+        <table>
+          <thead>
+            <tr>
+              <th>#</th>
+              <th>Flow ID</th>
+              <th>Name</th>
+              <th>Outcome</th>
+              <th>Steps</th>
+              <th>Error</th>
+            </tr>
+          </thead>
+          <tbody>
+            ${flowRows}
+          </tbody>
+        </table>
+      </div>
+    </details>
     ` : ''}
 
     ${intelligence && intelligence.totalFailures > 0 ? `
-    <h3 style="margin-top:24px;">🔍 Breakage Intelligence</h3>
-    <div style="background:#fff; padding:16px; border-radius:10px; margin-top:12px;">
-      <p><strong>Critical Failures:</strong> ${intelligence.criticalCount} | <strong>Warnings:</strong> ${intelligence.warningCount} | <strong>Info:</strong> ${intelligence.infoCount}</p>
-      ${intelligence.escalationSignals.length ? `
-      <div style="background:#fef2f2; border:1px solid #fca5a5; padding:10px; border-radius:6px; margin-top:8px;">
-        <strong>⚠️ Escalation Signals:</strong>
-        <ul>
-          ${intelligence.escalationSignals.map(s => `<li>${s}</li>`).join('')}
-        </ul>
-      </div>
-      ` : ''}
-      ${intelligence.failures && intelligence.failures.slice(0, 5).map(f => `
-      <details style="margin-top:10px;">
-        <summary><strong>${f.name}</strong> — ${f.breakType} (${f.severity})</summary>
-        <div style="margin-top:8px; padding:8px; background:#f9fafb;">
-          <p><strong>Primary Hint:</strong> ${f.primaryHint}</p>
-          <p><strong>Why It Matters:</strong></p>
-          <ul>${f.whyItMatters.map(w => `<li>${w}</li>`).join('')}</ul>
-          <p><strong>Top Actions:</strong></p>
-          <ol>${f.topActions.map(a => `<li>${a}</li>`).join('')}</ol>
-          ${f.breakType === 'VISUAL' && f.visualDiff ? `
-          <div style="margin-top:12px; padding:8px; background:#fef3c7; border:1px solid #fbbf24; border-radius:6px;">
-            <p><strong>📊 Visual Regression Details:</strong></p>
+    <details class="collapsible-section" open>
+      <summary class="section-toggle">🔍 Breakage Intelligence</summary>
+      <div class="collapsible-content">
+        <div style="background:#fff; padding:16px; border-radius:10px; margin-top:12px;">
+          <p><strong>Critical Failures:</strong> ${intelligence.criticalCount} | <strong>Warnings:</strong> ${intelligence.warningCount} | <strong>Info:</strong> ${intelligence.infoCount}</p>
+          ${intelligence.escalationSignals.length ? `
+          <div style="background:#fef2f2; border:1px solid #fca5a5; padding:10px; border-radius:6px; margin-top:8px;">
+            <strong>⚠️ Escalation Signals:</strong>
             <ul>
-              <li><strong>Change Detected:</strong> ${f.visualDiff.hasDiff ? 'YES ⚠️' : 'NO ✅'}</li>
-              <li><strong>Diff Magnitude:</strong> ${(f.visualDiff.percentChange || 0).toFixed(1)}%</li>
-              ${f.visualDiff.reason ? `<li><strong>Reason:</strong> ${f.visualDiff.reason}</li>` : ''}
-              ${f.visualDiff.diffRegions && f.visualDiff.diffRegions.length > 0 ? `<li><strong>Changed Regions:</strong> ${f.visualDiff.diffRegions.join(', ')}</li>` : ''}
-            </ul>
-          </div>
-          ` : ''}
-          ${f.behavioralSignals ? `
-          <div style="margin-top:12px; padding:8px; background:#e0f2fe; border:1px solid #06b6d4; border-radius:6px;">
-            <p><strong>🎯 Behavioral Signals:</strong></p>
-            <ul>
-              ${f.behavioralSignals.map(sig => `<li><strong>${sig.type}:</strong> ${sig.status === 'VISIBLE' ? '✅' : '❌'} ${sig.description}</li>`).join('')}
+              ${intelligence.escalationSignals.map(s => `<li>${s}</li>`).join('')}
             </ul>
           </div>
           ` : ''}
+          ${intelligence.failures && intelligence.failures.slice(0, 5).map(f => `
+          <details style="margin-top:10px;">
+            <summary><strong>${f.name}</strong> — ${f.breakType} (${f.severity})</summary>
+            <div style="margin-top:8px; padding:8px; background:#f9fafb;">
+              <p><strong>Primary Hint:</strong> ${f.primaryHint}</p>
+              <p><strong>Why It Matters:</strong></p>
+              <ul>${f.whyItMatters.map(w => `<li>${w}</li>`).join('')}</ul>
+              <p><strong>Top Actions:</strong></p>
+              <ol>${f.topActions.map(a => `<li>${a}</li>`).join('')}</ol>
+              ${f.breakType === 'VISUAL' && f.visualDiff ? `
+              <div style="margin-top:12px; padding:8px; background:#fef3c7; border:1px solid #fbbf24; border-radius:6px;">
+                <p><strong>📊 Visual Regression Details:</strong></p>
+                <ul>
+                  <li><strong>Change Detected:</strong> ${f.visualDiff.hasDiff ? 'YES ⚠️' : 'NO ✅'}</li>
+                  <li><strong>Diff Magnitude:</strong> ${(f.visualDiff.percentChange || 0).toFixed(1)}%</li>
+                  ${f.visualDiff.reason ? `<li><strong>Reason:</strong> ${f.visualDiff.reason}</li>` : ''}
+                  ${f.visualDiff.diffRegions && f.visualDiff.diffRegions.length > 0 ? `<li><strong>Changed Regions:</strong> ${f.visualDiff.diffRegions.join(', ')}</li>` : ''}
+                </ul>
+              </div>
+              ` : ''}
+              ${f.behavioralSignals ? `
+              <div style="margin-top:12px; padding:8px; background:#e0f2fe; border:1px solid #06b6d4; border-radius:6px;">
+                <p><strong>🎯 Behavioral Signals:</strong></p>
+                <ul>
+                  ${f.behavioralSignals.map(sig => `<li><strong>${sig.type}:</strong> ${sig.status === 'VISIBLE' ? '✅' : '❌'} ${sig.description}</li>`).join('')}
+                </ul>
+              </div>
+              ` : ''}
+            </div>
+          </details>
+          `).join('')}
         </div>
-      </details>
-      `).join('')}
-    </div>
+      </div>
+    </details>
     ` : ''}
   </div>
 </body>
@@ -281,6 +391,169 @@ class MarketReporter {
     return htmlPath;
   }
 
+  /**
+   * Phase 5 (Part 2): Generate human-readable business impact explanation
+   * @private
+   */
+  _generateWhyMattersExplanation(breakType, domain) {
+    // Priority 1: Break type specific impacts
+    if (breakType === 'SUBMISSION') {
+      return 'Users cannot complete forms or checkout, causing direct revenue or lead loss.';
+    }
+    if (breakType === 'NAVIGATION') {
+      return 'Users may get stuck or lost, increasing abandonment rates.';
+    }
+    if (breakType === 'TIMEOUT') {
+      return 'Slow or unresponsive pages reduce trust and increase bounce rate.';
+    }
+    if (breakType === 'VISUAL') {
+      return 'Broken UI elements reduce credibility and user confidence.';
+    }
+    if (breakType === 'NETWORK') {
+      return 'Environment issues may break the site only in production.';
+    }
+    if (breakType === 'CONSOLE') {
+      return 'JavaScript errors may degrade functionality and user experience.';
+    }
+    if (breakType === 'VALIDATION') {
+      return 'Form validation failures prevent users from completing critical actions.';
+    }
+    
+    // Priority 2: Domain-specific fallbacks
+    if (domain === 'REVENUE') {
+      return 'Critical checkout or payment issues directly impact business revenue.';
+    }
+    if (domain === 'LEAD') {
+      return 'Signup or contact form issues prevent capturing customer interest.';
+    }
+    if (domain === 'TRUST') {
+      return 'Authentication or security issues erode user trust and safety.';
+    }
+    if (domain === 'UX') {
+      return 'User experience degradation may increase frustration and churn.';
+    }
+    
+    // Default fallback
+    return 'Critical functionality may be broken, impacting user satisfaction.';
+  }
+
+  /**
+   * Phase 5 (Part 3): Group similar issues by severity and type
+   * @private
+   */
+  _groupSimilarIssues(failures) {
+    const groups = {};
+    
+    for (const failure of failures) {
+      const severity = failure.severity || 'INFO';
+      const breakType = failure.breakType || 'UNKNOWN';
+      const key = `${severity}_${breakType}`;
+      
+      if (!groups[key]) {
+        groups[key] = [];
+      }
+      groups[key].push(failure);
+    }
+    
+    return groups;
+  }
+
+  /**
+   * Phase 5: Generate Executive Summary data
+   * @private
+   */
+  _generateExecutiveSummary(intelligence, results, flows) {
+    const failures = intelligence && intelligence.failures ? intelligence.failures : [];
+    
+    // Collect all failures with severity
+    const allFailures = [...failures];
+    
+    // Count by severity
+    const criticalCount = allFailures.filter(f => f.severity === 'CRITICAL').length;
+    const warningCount = allFailures.filter(f => f.severity === 'WARNING').length;
+    const infoCount = allFailures.filter(f => f.severity === 'INFO').length;
+    
+    // 1) Release Verdict
+    let verdict = '🟢 SAFE TO RELEASE';
+    let verdictClass = 'safe';
+    
+    if (criticalCount > 0) {
+      verdict = '🔴 DO NOT RELEASE';
+      verdictClass = 'danger';
+    } else if (warningCount > 0) {
+      verdict = '🟡 RELEASE WITH CAUTION';
+      verdictClass = 'caution';
+    }
+    
+    // 2) Risk Score (0-100)
+    // Use severity weights: CRITICAL=40, WARNING=15, INFO=5
+    const rawScore = (criticalCount * 40) + (warningCount * 15) + (infoCount * 5);
+    const riskScore = Math.min(100, rawScore);
+    
+    // 3) Top Reason
+    let topReason = 'No blocking risks detected';
+    if (allFailures.length > 0) {
+      // Sort by severity priority: CRITICAL > WARNING > INFO
+      const sortedFailures = [...allFailures].sort((a, b) => {
+        const severityOrder = { CRITICAL: 3, WARNING: 2, INFO: 1 };
+        return (severityOrder[b.severity] || 0) - (severityOrder[a.severity] || 0);
+      });
+      topReason = sortedFailures[0].name || sortedFailures[0].primaryHint || 'Failure detected';
+    }
+    
+    // 4) Top 3 Risks
+    const topRisks = allFailures
+      .sort((a, b) => {
+        const severityOrder = { CRITICAL: 3, WARNING: 2, INFO: 1 };
+        return (severityOrder[b.severity] || 0) - (severityOrder[a.severity] || 0);
+      })
+      .slice(0, 3)
+      .map(f => ({
+        title: f.name || f.primaryHint || 'Unknown issue',
+        severity: f.severity || 'INFO',
+        whyMatters: this._generateWhyMattersExplanation(f.breakType, f.domain)
+      }));
+    
+    // 5) Recommended Next Action
+    let nextAction = 'All systems nominal. Ready to deploy.';
+    
+    if (allFailures.length > 0) {
+      const topFailure = allFailures.sort((a, b) => {
+        const severityOrder = { CRITICAL: 3, WARNING: 2, INFO: 1 };
+        return (severityOrder[b.severity] || 0) - (severityOrder[a.severity] || 0);
+      })[0];
+      
+      // Generate action based on break type and domain
+      const breakType = topFailure.breakType || '';
+      const domain = topFailure.domain || '';
+      
+      if (breakType === 'SUBMISSION' || domain === 'REVENUE') {
+        nextAction = 'Fix checkout/submission flow before release — revenue impact detected.';
+      } else if (breakType === 'VISUAL') {
+        nextAction = 'Review visual regression and save a new baseline if changes are intentional.';
+      } else if (breakType === 'NAVIGATION' || breakType === 'NETWORK') {
+        nextAction = 'Verify deployment environment configuration and API availability.';
+      } else if (breakType === 'TIMEOUT') {
+        nextAction = 'Investigate performance issues and optimize slow endpoints.';
+      } else if (domain === 'LEAD') {
+        nextAction = 'Fix signup/contact form before release — lead generation impacted.';
+      } else if (domain === 'TRUST') {
+        nextAction = 'Fix authentication/login flow before release — user trust at risk.';
+      } else {
+        nextAction = `Address ${topFailure.severity || 'high-priority'} issue: ${topFailure.primaryHint || topFailure.name || 'detected failure'}.`;
+      }
+    }
+    
+    return {
+      verdict,
+      verdictClass,
+      riskScore,
+      topReason,
+      topRisks,
+      nextAction
+    };
+  }
+
   _buildSummary(results) {
     const successCount = results.filter(r => r.outcome === 'SUCCESS').length;
     const frictionCount = results.filter(r => r.outcome === 'FRICTION').length;
@@ -292,12 +565,14 @@ class MarketReporter {
     } else if (frictionCount > 0) {
       overallVerdict = 'FRICTION';
     }
+    const { toCanonicalVerdict } = require('./verdicts');
+    const overallCanonical = toCanonicalVerdict(overallVerdict);
 
     return {
       successCount,
       frictionCount,
       failureCount,
-      overallVerdict
+      overallVerdict: overallCanonical
     };
   }
 }

package/src/guardian/parallel-executor.js

@@ -0,0 +1,116 @@
+/**
+ * Phase 7.2 - Parallel Executor
+ * Controlled parallel execution of attempts with bounded concurrency
+ */
+
+/**
+ * Execute attempts with bounded parallelism
+ * @param {Array} attempts - Array of attempts to execute
+ * @param {Function} executeAttemptFn - Async function(attempt) => result
+ * @param {number} maxConcurrency - Max concurrent attempts (must be >= 1)
+ * @param {Object} options - { shouldStop?: Function }
+ * @returns {Promise<Array>} Results in original input order
+ */
+async function executeParallel(attempts, executeAttemptFn, maxConcurrency = 1, options = {}) {
+  if (maxConcurrency < 1) {
+    throw new Error('maxConcurrency must be >= 1');
+  }
+
+  // Handle empty queue immediately
+  if (!attempts || attempts.length === 0) {
+    return [];
+  }
+
+  const results = new Array(attempts.length);
+  const queue = attempts.map((attempt, index) => ({ attempt, index }));
+  let executing = 0;
+  let queueIndex = 0;
+  let shouldStop = false;
+
+  return new Promise((resolve, reject) => {
+    const processNext = async () => {
+      // Check if we should stop (e.g., fail-fast triggered)
+      if (options.shouldStop && options.shouldStop()) {
+        shouldStop = true;
+      }
+
+      // If no more work and nothing executing, we're done
+      if (queueIndex >= queue.length && executing === 0) {
+        resolve(results);
+        return;
+      }
+
+      // If we've hit the concurrency limit or have no more items, wait
+      if (executing >= maxConcurrency || queueIndex >= queue.length) {
+        return;
+      }
+
+      // Get next item from queue
+      const { attempt, index } = queue[queueIndex];
+      queueIndex++;
+      executing++;
+
+      try {
+        // Only execute if we haven't stopped
+        if (!shouldStop) {
+          results[index] = await executeAttemptFn(attempt);
+        } else {
+          // Mark as skipped if we stopped
+          results[index] = { skipped: true };
+        }
+      } catch (err) {
+        results[index] = { error: err, skipped: false };
+      } finally {
+        executing--;
+        // Process next item(s)
+        processNext();
+        if (executing < maxConcurrency && queueIndex < queue.length && !shouldStop) {
+          processNext();
+        }
+      }
+    };
+
+    // Start workers
+    for (let i = 0; i < Math.min(maxConcurrency, queue.length); i++) {
+      processNext();
+    }
+  });
+}
+
+/**
+ * Validate parallel concurrency value
+ * @param {number|string} value - Value to validate
+ * @returns {{ valid: boolean, parallel?: number, error?: string, hint?: string }}
+ */
+function validateParallel(value) {
+  if (value === undefined || value === null) {
+    return { valid: true, parallel: 1 };
+  }
+
+  const num = parseInt(value, 10);
+
+  // Check for NaN
+  if (isNaN(num)) {
+    return {
+      valid: false,
+      error: `Invalid --parallel value: '${value}' (expected integer >= 1)`,
+      hint: 'Example: --parallel 2'
+    };
+  }
+
+  // Check if less than 1
+  if (num < 1) {
+    return {
+      valid: false,
+      error: `Invalid --parallel value: ${num} (must be >= 1)`,
+      hint: 'Example: --parallel 2'
+    };
+  }
+
+  return { valid: true, parallel: num };
+}
+
+module.exports = {
+  executeParallel,
+  validateParallel
+};