newman-reporter-dashboard-wrapper 1.0.0

package/dist/.newman-history.json

@@ -0,0 +1,456 @@
+[
+  {
+    "runId": "RUN-683232",
+    "collectionName": "Public API Test Suite",
+    "timestamp": "2026-06-25 05:18:24",
+    "totalRequests": 2,
+    "passedAssertions": 4,
+    "failedAssertions": 0,
+    "avgResponseTime": 327,
+    "status": "Success",
+    "requests": [
+      {
+        "name": "Get All Posts",
+        "method": "GET",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      },
+      {
+        "name": "Create New Post",
+        "method": "POST",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      }
+    ]
+  },
+  {
+    "runId": "RUN-518049",
+    "collectionName": "Public API Test Suite",
+    "timestamp": "2026-06-25 05:19:13",
+    "totalRequests": 2,
+    "passedAssertions": 4,
+    "failedAssertions": 0,
+    "avgResponseTime": 469,
+    "status": "Success",
+    "requests": [
+      {
+        "name": "Get All Posts",
+        "method": "GET",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      },
+      {
+        "name": "Create New Post",
+        "method": "POST",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      }
+    ]
+  },
+  {
+    "runId": "RUN-854823",
+    "collectionName": "Public API Test Suite",
+    "timestamp": "2026-06-25 05:21:41",
+    "totalRequests": 2,
+    "passedAssertions": 4,
+    "failedAssertions": 0,
+    "avgResponseTime": 260,
+    "status": "Success",
+    "requests": [
+      {
+        "name": "Get All Posts",
+        "method": "GET",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      },
+      {
+        "name": "Create New Post",
+        "method": "POST",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      }
+    ]
+  },
+  {
+    "runId": "RUN-948995",
+    "collectionName": "Public API Test Suite",
+    "timestamp": "2026-06-25 06:12:26",
+    "totalRequests": 2,
+    "passedAssertions": 4,
+    "failedAssertions": 0,
+    "avgResponseTime": 302,
+    "status": "Success",
+    "requests": [
+      {
+        "name": "Get All Posts",
+        "method": "GET",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      },
+      {
+        "name": "Create New Post",
+        "method": "POST",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      }
+    ]
+  },
+  {
+    "runId": "RUN-759529",
+    "collectionName": "Public API Test Suite",
+    "timestamp": "2026-06-25 06:12:59",
+    "totalRequests": 2,
+    "passedAssertions": 4,
+    "failedAssertions": 0,
+    "avgResponseTime": 255,
+    "status": "Success",
+    "requests": [
+      {
+        "name": "Get All Posts",
+        "method": "GET",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      },
+      {
+        "name": "Create New Post",
+        "method": "POST",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      }
+    ]
+  },
+  {
+    "runId": "RUN-708198",
+    "collectionName": "Public API Test Suite",
+    "timestamp": "2026-06-25 06:14:17",
+    "totalRequests": 2,
+    "passedAssertions": 3,
+    "failedAssertions": 1,
+    "avgResponseTime": 487,
+    "status": "Failure",
+    "requests": [
+      {
+        "name": "Get All Posts",
+        "method": "GET",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      },
+      {
+        "name": "Create New Post",
+        "method": "POST",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      }
+    ]
+  },
+  {
+    "runId": "RUN-760015",
+    "collectionName": "Public API Test Suite",
+    "timestamp": "2026-06-25 06:18:20",
+    "totalRequests": 2,
+    "passedAssertions": 8,
+    "failedAssertions": 0,
+    "avgResponseTime": 545,
+    "status": "Success",
+    "requests": [
+      {
+        "name": "Get All Posts",
+        "method": "GET",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      },
+      {
+        "name": "Create New Post",
+        "method": "POST",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 0,
+        "responseTime": 0,
+        "assertions": []
+      }
+    ]
+  },
+  {
+    "runId": "RUN-766800",
+    "collectionName": "Public API Test Suite",
+    "timestamp": "2026-06-25 06:19:57",
+    "totalRequests": 2,
+    "passedAssertions": 8,
+    "failedAssertions": 0,
+    "avgResponseTime": 548,
+    "status": "Success",
+    "requests": [
+      {
+        "id": "623bbfa7-945e-4177-8908-d4095e3b523e",
+        "name": "Get All Posts",
+        "method": "GET",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 200,
+        "responseTime": 315,
+        "assertions": [
+          {
+            "name": "Status code is 200",
+            "passed": true
+          },
+          {
+            "name": "Response time is within acceptable SLA limits",
+            "passed": true
+          },
+          {
+            "name": "Response is an array containing posts",
+            "passed": true
+          },
+          {
+            "name": "First post object complies with data schema contract",
+            "passed": true
+          }
+        ]
+      },
+      {
+        "id": "e99530c3-e9b2-48c5-a23e-3b4c6d946f46",
+        "name": "Create New Post",
+        "method": "POST",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 201,
+        "responseTime": 780,
+        "assertions": [
+          {
+            "name": "Status code is 201 Created",
+            "passed": true
+          },
+          {
+            "name": "Response headers confirm JSON payload structure",
+            "passed": true
+          },
+          {
+            "name": "Response returns generated resource identity",
+            "passed": true
+          },
+          {
+            "name": "Response contains the complete mirrored request body data",
+            "passed": true
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "runId": "RUN-152281",
+    "collectionName": "Public API Test Suite",
+    "timestamp": "2026-06-25 06:24:56",
+    "totalRequests": 2,
+    "passedAssertions": 8,
+    "failedAssertions": 0,
+    "avgResponseTime": 315,
+    "status": "Success",
+    "requests": [
+      {
+        "id": "32d48e3e-2463-418e-81c6-9559fd9e3dcb",
+        "name": "Get All Posts",
+        "method": "GET",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 200,
+        "responseTime": 323,
+        "assertions": [
+          {
+            "name": "Status code is 200",
+            "passed": true
+          },
+          {
+            "name": "Response time is within acceptable SLA limits",
+            "passed": true
+          },
+          {
+            "name": "Response is an array containing posts",
+            "passed": true
+          },
+          {
+            "name": "First post object complies with data schema contract",
+            "passed": true
+          }
+        ]
+      },
+      {
+        "id": "a148ca0b-10a2-41fb-bf76-65e34813babb",
+        "name": "Create New Post",
+        "method": "POST",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 201,
+        "responseTime": 306,
+        "assertions": [
+          {
+            "name": "Status code is 201 Created",
+            "passed": true
+          },
+          {
+            "name": "Response headers confirm JSON payload structure",
+            "passed": true
+          },
+          {
+            "name": "Response returns generated resource identity",
+            "passed": true
+          },
+          {
+            "name": "Response contains the complete mirrored request body data",
+            "passed": true
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "runId": "RUN-132160",
+    "collectionName": "Public API Test Suite",
+    "timestamp": "2026-06-25 06:25:33",
+    "totalRequests": 2,
+    "passedAssertions": 7,
+    "failedAssertions": 1,
+    "avgResponseTime": 401,
+    "status": "Failure",
+    "requests": [
+      {
+        "id": "e2c848fc-90eb-447f-a59d-76711e6d082e",
+        "name": "Get All Posts",
+        "method": "GET",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 200,
+        "responseTime": 411,
+        "assertions": [
+          {
+            "name": "Status code is 200",
+            "passed": false,
+            "errorMessage": "expected response to have status code 201 but got 200"
+          },
+          {
+            "name": "Response time is within acceptable SLA limits",
+            "passed": true
+          },
+          {
+            "name": "Response is an array containing posts",
+            "passed": true
+          },
+          {
+            "name": "First post object complies with data schema contract",
+            "passed": true
+          }
+        ]
+      },
+      {
+        "id": "74b3409f-de1f-47a7-9994-7ebf08da94fe",
+        "name": "Create New Post",
+        "method": "POST",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 201,
+        "responseTime": 390,
+        "assertions": [
+          {
+            "name": "Status code is 201 Created",
+            "passed": true
+          },
+          {
+            "name": "Response headers confirm JSON payload structure",
+            "passed": true
+          },
+          {
+            "name": "Response returns generated resource identity",
+            "passed": true
+          },
+          {
+            "name": "Response contains the complete mirrored request body data",
+            "passed": true
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "runId": "RUN-975070",
+    "collectionName": "Public API Test Suite",
+    "timestamp": "2026-06-25 06:33:12",
+    "totalRequests": 2,
+    "passedAssertions": 7,
+    "failedAssertions": 1,
+    "avgResponseTime": 286,
+    "status": "Failure",
+    "requests": [
+      {
+        "id": "6e21365e-5752-4231-a7d9-bae2cef99003",
+        "name": "Get All Posts",
+        "method": "GET",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 200,
+        "responseTime": 282,
+        "assertions": [
+          {
+            "name": "Status code is 200",
+            "passed": false,
+            "errorMessage": "expected response to have status code 201 but got 200"
+          },
+          {
+            "name": "Response time is within acceptable SLA limits",
+            "passed": true
+          },
+          {
+            "name": "Response is an array containing posts",
+            "passed": true
+          },
+          {
+            "name": "First post object complies with data schema contract",
+            "passed": true
+          }
+        ]
+      },
+      {
+        "id": "9e3c5316-f15f-47c1-9065-0704235bc6d5",
+        "name": "Create New Post",
+        "method": "POST",
+        "url": "https://jsonplaceholder.typicode.com/posts",
+        "statusCode": 201,
+        "responseTime": 289,
+        "assertions": [
+          {
+            "name": "Status code is 201 Created",
+            "passed": true
+          },
+          {
+            "name": "Response headers confirm JSON payload structure",
+            "passed": true
+          },
+          {
+            "name": "Response returns generated resource identity",
+            "passed": true
+          },
+          {
+            "name": "Response contains the complete mirrored request body data",
+            "passed": true
+          }
+        ]
+      }
+    ]
+  }
+]

package/dist/dashboard.html

@@ -0,0 +1,384 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Newman Orchestrator: Interactive Analytics</title>
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/css/bootstrap.min.css" rel="stylesheet">
+    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+    <style>
+        body { background-color: #f4f6f9; font-family: system-ui, -apple-system, sans-serif; }
+        .card { border: none; border-radius: 12px; box-shadow: 0 4px 12px rgba(0,0,0,0.03); }
+        .clickable-row { cursor: pointer; transition: background-color 0.2s; }
+        .clickable-row:hover { background-color: #f0f4f8 !important; }
+        .status-Success { background-color: #d1e7dd; color: #0f5132; padding: 4px 10px; border-radius: 20px; font-size: 0.82rem; font-weight: 600; }
+        .status-Warning { background-color: #fff3cd; color: #664d03; padding: 4px 10px; border-radius: 20px; font-size: 0.82rem; font-weight: 600; }
+        .status-Failure { background-color: #f8d7da; color: #842029; padding: 4px 10px; border-radius: 20px; font-size: 0.82rem; font-weight: 600; }
+    </style>
+</head>
+<body>
+    <div class="container-fluid py-4 px-5">
+        <div class="d-flex justify-content-between align-items-center mb-4">
+            <h2 class="fw-bold m-0">🚀 Newman Orchestrator Analytics</h2>
+            <span class="badge bg-dark px-3 py-2 fs-6">V1.0.0</span>
+        </div>
+        
+        <div class="row g-3 mb-4">
+            <div class="col-md-4">
+                <div class="card p-3">
+                    <small class="text-muted text-uppercase fw-bold">Run History</small>
+                    <h3 id="stat-total-runs" class="fw-bold m-0">0 runs</h3>
+                </div>
+            </div>
+            <div class="col-md-4">
+                <div class="card p-3">
+                    <small class="text-muted text-uppercase fw-bold">Success Pass Rate</small>
+                    <h3 id="stat-success-rate" class="fw-bold m-0 text-success">0%</h3>
+                </div>
+            </div>
+            <div class="col-md-4">
+                <div class="card p-3">
+                    <small class="text-muted text-uppercase fw-bold">Details Engine</small>
+                    <h3 class="fw-bold m-0 text-primary">● Active</h3>
+                </div>
+            </div>
+        </div>
+
+        <div class="row g-3 mb-4">
+            <div class="col-md-8">
+                <div class="card p-3 h-100">
+                    <h6 class="fw-bold mb-3 text-secondary">Historical Pass / Fail Trend & Response Times</h6>
+                    <canvas id="trendChart" height="120"></canvas>
+                </div>
+            </div>
+            <div class="col-md-4">
+                <div class="card p-3 h-100">
+                    <canvas id="latencyChart"></canvas>
+                </div>
+            </div>
+        </div>
+
+        <div class="card p-4">
+            <h5 class="fw-bold mb-3">Execution Ledger <span class="fs-6 fw-normal text-muted">(Click any row or graph coordinate to reveal request details)</span></h5>
+            <div class="table-responsive">
+                <table class="table table-hover align-middle m-0">
+                    <thead class="table-light">
+                        <tr>
+                            <th>Run ID</th>
+                            <th>Collection Target</th>
+                            <th>Timestamp</th>
+                            <th>Assertions (P/F)</th>
+                            <th>Avg Response Time</th>
+                            <th>Status</th>
+                        </tr>
+                    </thead>
+                    <tbody id="execution-table-body"></tbody>
+                </table>
+            </div>
+        </div>
+    </div>
+
+    <div class="offcanvas offcanvas-end style-drawer" style="width: 45%;" tabIndex="-1" id="detailsDrawer" aria-labelledby="detailsDrawerLabel">
+        <div class="offcanvas-header bg-dark text-white">
+            <h5 class="offcanvas-title fw-bold" id="detailsDrawerLabel">Run Details</h5>
+            <button type="button" class="btn-close btn-close-white" data-bs-dismiss="offcanvas" aria-label="Close"></button>
+        </div>
+        <div class="offcanvas-body" id="drawer-content-body">
+            </div>
+    </div>
+
+    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/js/bootstrap.bundle.min.js"></script>
+    <script>
+        let cachedData = [];
+        const bsDrawer = new bootstrap.Offcanvas(document.getElementById('detailsDrawer'));
+
+        async function initMetricsEngine() {
+            try {
+                const res = await fetch('/api/history');
+                cachedData = await res.json();
+                
+                if (!cachedData || cachedData.length === 0) {
+                    console.warn("Database storage is currently empty.");
+                    document.getElementById('execution-table-body').innerHTML = 
+                        `<tr><td colspan="6" class="text-center text-muted py-4">No data streams captured yet. Please run your collection suite to feed data.</td></tr>`;
+                    return;
+                }
+
+                document.getElementById('stat-total-runs').innerText = `${cachedData.length} executions`;
+                const passCount = cachedData.filter(r => r.status !== 'Failure').length;
+                document.getElementById('stat-success-rate').innerText = `${Math.round((passCount / cachedData.length) * 100)}%`;
+
+                const tbody = document.getElementById('execution-table-body');
+                tbody.innerHTML = ""; 
+                
+                cachedData.slice().reverse().forEach(run => {
+                    const tr = document.createElement('tr');
+                    tr.className = 'clickable-row';
+                    tr.onclick = () => showDetailedRunBreakdown(run.runId);
+                    tr.innerHTML = `
+                        <td class="fw-bold text-primary">${run.runId}</td>
+                        <td>${run.collectionName}</td>
+                        <td class="text-muted">${run.timestamp}</td>
+                        <td><span class="text-success">${run.passedAssertions} ✓</span> / <span class="text-danger">${run.failedAssertions} ✗</span></td>
+                        <td><strong>${run.avgResponseTime}ms</strong></td>
+                        <td><span class="status-${run.status}">${run.status}</span></td>
+                    `;
+                    tbody.appendChild(tr);
+                });
+
+                renderCharts(cachedData);
+            } catch (err) {
+                console.error("Dashboard engine rendering failure:", err);
+            }
+        }
+
+        // Heuristic AI Engine to generate free, context-aware QA advice for failing runs
+        function generateAIAdvice(run) {
+            let insights = [];
+            const highLatencyRequests = run.requests.filter(r => r.responseTime > 800);
+            
+            // Captures requests that either have broken HTTP status codes OR have explicitly failed assertions
+            const failedRequests = run.requests.filter(r => 
+                r.statusCode >= 400 || 
+                (r.assertions && r.assertions.some(a => !a.passed))
+            );
+
+            // Scenario 1: Total Success Matrix
+            if (run.failedAssertions === 0 && run.status === 'Success' && highLatencyRequests.length === 0) {
+                return `
+                    <div class="alert alert-success border-0 shadow-sm mb-3">
+                        <h6 class="fw-bold mb-1">🤖 AI Advisor: System Healthy</h6>
+                        <small class="d-block text-secondary">All endpoints responded within benchmark thresholds with 100% assertion parity. No regression risks detected. Ready for deployment pipeline integration.</small>
+                    </div>`;
+            }
+
+            // Scenario 2: Global performance degradation
+            if (run.avgResponseTime > 1000) {
+                insights.push(`⚠️ <strong>Global Latency Warning:</strong> The collection's average response time is running slow at <strong>${run.avgResponseTime}ms</strong>. This suggests network congestion, slow environment proxies, or resource-heavy database lookups.`);
+            }
+
+            // Scenario 3: Individual latency outliers
+            if (highLatencyRequests.length > 0) {
+                highLatencyRequests.forEach(r => {
+                    insights.push(`🐢 <strong>Endpoint Degraded:</strong> <code>[${r.method}] ${r.name}</code> took <strong>${r.responseTime}ms</strong>. This exceeds safe interactive API performance budgets (800ms). Consider applying data caching or optimizing server queries.`);
+                });
+            }
+
+            // Scenario 4: Broken tests / assertions
+            if (failedRequests.length > 0) {
+                failedRequests.forEach(r => {
+                    const code = r.statusCode;
+                    const brokenAssertions = r.assertions ? r.assertions.filter(a => !a.passed) : [];
+                    
+                    if (code === 401 || code === 403) {
+                        insights.push(`🔒 <strong>Authentication Fault on "${r.name}":</strong> Request dropped an access error (<strong>Status ${code}</strong>). Check if your environmental Authorization header tokens, API keys, or OAuth sessions expired.`);
+                    } else if (code >= 500) {
+                        insights.push(`💥 <strong>Server-Side Crash on "${r.name}":</strong> Backend returned a <strong>Status ${code}</strong> internal runtime error. Check your server logs or application container traces for active unhandled exceptions.`);
+                    } else if (brokenAssertions.length > 0) {
+                        // Pinpoint exactly which script validation assertion failed
+                        brokenAssertions.forEach(a => {
+                            let adviceString = `❌ <strong>Assertion Failed on "${r.name}":</strong> The check <code>"${a.name}"</code> collapsed.`;
+                            if (a.errorMessage) {
+                                adviceString += ` Backend unexpected value details: <em class="text-danger">${a.errorMessage}</em>`;
+                            } else {
+                                adviceString += ` Review your endpoint's response payload structure to ensure it matches the Postman test schema expectation.`;
+                            }
+                            insights.push(adviceString);
+                        });
+                    } else {
+                        insights.push(`⚠️ <strong>Unexpected Code on "${r.name}":</strong> Returned a client-side warning error (<strong>Status ${code}</strong>). Verify parameter schema spelling parameters.`);
+                    }
+                });
+            }
+
+            // Render the advice box matrix inside the view canvas layout
+            return `
+                <div class="card bg-light border-0 shadow-sm mb-4">
+                    <div class="card-body">
+                        <h6 class="fw-bold text-dark mb-3 d-flex align-items-center gap-2">
+                            <span>🤖 AI QA Advisor Insights</span>
+                            <span class="badge bg-danger font-monospace text-white" style="font-size:10px;">${run.failedAssertions} Failure(s) Detected</span>
+                        </h6>
+                        <ul class="small text-dark ps-3 m-0 d-flex flex-column gap-2">
+                            ${insights.map(insight => `<li>${insight}</li>`).join('')}
+                        </ul>
+                    </div>
+                </div>`;
+        }
+
+        function showDetailedRunBreakdown(runId) {
+            const run = cachedData.find(r => r.runId === runId);
+            if (!run) return;
+
+            document.getElementById('detailsDrawerLabel').innerText = `Execution Report: ${run.runId}`;
+            const body = document.getElementById('drawer-content-body');
+            
+            const aiAdviceHTML = generateAIAdvice(run);
+
+            let htmlHTML = `<div class="mb-4">
+                <h6><strong>Collection Suite:</strong> ${run.collectionName}</h6>
+                <p class="text-muted mb-1">Executed at: ${run.timestamp}</p>
+                <div class="badge bg-secondary p-2">Average Response Latency: ${run.avgResponseTime}ms</div>
+            </div>
+            
+            ${aiAdviceHTML}
+            <hr/>`;
+
+            run.requests.forEach((req, idx) => {
+                const statusBadge = req.statusCode >= 200 && req.statusCode < 300 ? 'bg-success' : 'bg-danger';
+                
+                htmlHTML += `
+                <div class="card p-3 mb-3 border">
+                    <div class="d-flex justify-content-between align-items-center mb-2">
+                        <h6 class="fw-bold text-dark m-0">${idx + 1}. ${req.name}</h6>
+                        <span class="badge ${statusBadge}">${req.method} ${req.statusCode}</span>
+                    </div>
+                    <div class="text-muted font-monospace small mb-2 text-truncate">${req.url}</div>
+                    <div class="small text-secondary mb-2">Response Time: <strong>${req.responseTime}ms</strong></div>
+                    
+                    <div class="mt-2">
+                        <h6>Assertions:</h6>
+                        ${!req.assertions || req.assertions.length === 0 ? '<p class="text-muted small italic m-0">No assertions defined for this step.</p>' : ''}
+                        ${req.assertions ? req.assertions.map(a => `
+                            <div class="d-flex align-items-start gap-2 my-1">
+                                <span>${a.passed ? '✅' : '❌'}</span>
+                                <div>
+                                    <span class="${a.passed ? 'text-success' : 'text-danger fw-bold'}">${a.name}</span>
+                                    ${a.errorMessage ? `<div class="text-muted font-monospace text-xs" style="font-size:11px">${a.errorMessage}</div>` : ''}
+                                </div>
+                            </div>
+                        `).join('') : ''}
+                    </div>
+                </div>`;
+            });
+
+            body.innerHTML = htmlHTML;
+            bsDrawer.show();
+        }
+
+        function renderCharts(data) {
+            const existingTrendChart = Chart.getChart("trendChart");
+            if (existingTrendChart) existingTrendChart.destroy();
+            
+            const existingLatencyChart = Chart.getChart("latencyChart");
+            if (existingLatencyChart) existingLatencyChart.destroy();
+
+            const ctx = document.getElementById('trendChart');
+            if (!ctx) return;
+
+            new Chart(ctx, {
+                type: 'bar',
+                data: {
+                    labels: data.map(r => r.runId),
+                    datasets: [
+                        {
+                            label: 'Passed Assertions',
+                            data: data.map(r => r.passedAssertions),
+                            backgroundColor: 'rgba(25, 135, 84, 0.6)',
+                            borderColor: '#198754',
+                            borderWidth: 1,
+                            stack: 'assertions',
+                            yAxisID: 'y'
+                        },
+                        {
+                            label: 'Failed Assertions',
+                            data: data.map(r => r.failedAssertions),
+                            backgroundColor: 'rgba(220, 53, 69, 0.6)',
+                            borderColor: '#dc3545',
+                            borderWidth: 1,
+                            stack: 'assertions',
+                            yAxisID: 'y'
+                        },
+                        {
+                            label: 'Avg Response Time (ms)',
+                            data: data.map(r => r.avgResponseTime),
+                            type: 'line',
+                            borderColor: '#0d6efd',
+                            backgroundColor: 'rgba(13, 110, 253, 0.1)',
+                            tension: 0.3,
+                            fill: true,
+                            pointRadius: 5,
+                            pointHoverRadius: 8,
+                            yAxisID: 'y1'
+                        }
+                    ]
+                },
+                options: {
+                    responsive: true,
+                    plugins: {
+                        legend: { position: 'top' },
+                        tooltip: {
+                            mode: 'index',
+                            intersect: false,
+                            callbacks: {
+                                title: (context) => `Execution Details: ${context[0].label}`,
+                                label: function(context) {
+                                    let label = context.dataset.label || '';
+                                    if (label) label += ': ';
+                                    if (context.datasetIndex === 2) {
+                                        label += `${context.raw} ms`;
+                                    } else {
+                                        label += `${context.raw} checks`;
+                                    }
+                                    return label;
+                                },
+                                footer: (context) => '💡 Click point to open full API request trace panel.'
+                            }
+                        }
+                    },
+                    scales: {
+                        y: {
+                            type: 'linear',
+                            position: 'left',
+                            title: { display: true, text: 'Assertion Check Quantities' },
+                            grid: { drawOnChartArea: true }
+                        },
+                        y1: {
+                            type: 'linear',
+                            position: 'right',
+                            title: { display: true, text: 'Latency Speed (ms)' },
+                            grid: { drawOnChartArea: false }, 
+                            ticks: { callback: (value) => `${value}ms` }
+                        }
+                    },
+                    onClick: function(event, activeElements, chart) {
+                        const points = chart.getElementsAtEventForMode(event, 'nearest', { intersect: true }, true);
+                        if (points.length > 0) {
+                            const dataIndex = points[0].index;
+                            const selectedRunId = data.map(r => r.runId)[dataIndex];
+                            if (selectedRunId) {
+                                showDetailedRunBreakdown(selectedRunId); 
+                            }
+                        }
+                    }
+                }
+            });
+
+            const latencyCanvas = document.getElementById('latencyChart');
+            if (!latencyCanvas) return;
+
+            const latest = data[data.length - 1];
+            new Chart(latencyCanvas, {
+                type: 'doughnut',
+                data: {
+                    labels: ['Passed Assertions', 'Failed Assertions'],
+                    datasets: [{
+                        data: [latest.passedAssertions, latest.failedAssertions],
+                        backgroundColor: ['#198754', '#dc3545'],
+                        borderWidth: 2,
+                        hoverOffset: 4
+                    }]
+                },
+                options: {
+                    plugins: {
+                        legend: { position: 'bottom' },
+                        title: { display: true, text: `Latest Run State (${latest.runId})` }
+                    }
+                }
+            });
+        }
+
+        window.onload = initMetricsEngine;
+    </script>
+</body>
+</html>

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+import newman from 'newman';
+import express from 'express';
+import open from 'open';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const HISTORY_FILE = path.join(__dirname, '.newman-history.json');
+const SERVER_PORT = 8086;
+function fetchLocalLedger() {
+    if (!fs.existsSync(HISTORY_FILE)) {
+        fs.writeFileSync(HISTORY_FILE, JSON.stringify([]));
+    }
+    try {
+        return JSON.parse(fs.readFileSync(HISTORY_FILE, 'utf-8'));
+    }
+    catch {
+        return [];
+    }
+}
+function commitRunToHistory(metric) {
+    const history = fetchLocalLedger();
+    history.push(metric);
+    if (history.length > 50)
+        history.shift();
+    fs.writeFileSync(HISTORY_FILE, JSON.stringify(history, null, 2));
+    console.log(`\x1b[32m✓ [LEDGER SUCCESS]\x1b[0m Appended run ${metric.runId} successfully.`);
+}
+function executePipeline() {
+    const collectionArg = process.argv[2];
+    if (!collectionArg) {
+        console.error("\x1b[31m❌ Usage Error:\x1b[0m Please specify your Postman collection file.");
+        process.exit(1);
+    }
+    const resolutionPath = path.resolve(collectionArg);
+    console.log(`\x1b[36m[ORCHESTRATOR]\x1b[0m Booting runtime stream for: [${path.basename(resolutionPath)}]`);
+    let totalLatency = 0;
+    let totalRequests = 0;
+    let passedAssertions = 0;
+    let failedAssertions = 0;
+    const detailedRequests = [];
+    // Tracks the active request execution block reference context
+    let currentRequestRef = null;
+    let collectionData;
+    try {
+        collectionData = JSON.parse(fs.readFileSync(resolutionPath, 'utf-8'));
+    }
+    catch (e) {
+        console.error(`\x1b[31m[ERROR]\x1b[0m Failed to parse collection file: ${e.message}`);
+        process.exit(1);
+    }
+    newman.run({
+        collection: collectionData,
+        reporters: 'cli'
+    })
+        .on('request', (err, args) => {
+        if (err || !args.response)
+            return;
+        totalRequests++;
+        totalLatency += args.response.responseTime;
+        // Create the active request record block during execution runtime
+        currentRequestRef = {
+            id: args.cursor.ref, // Unique internal step identifier
+            name: args.item?.name || 'Unnamed Request',
+            method: args.item?.request?.method || 'GET',
+            url: args.item?.request?.url?.toString() || '',
+            statusCode: args.response.code || 0,
+            responseTime: args.response.responseTime || 0,
+            assertions: []
+        };
+        detailedRequests.push(currentRequestRef);
+    })
+        .on('assertion', (err, args) => {
+        // Safe global status monitoring tracking counters
+        if (err)
+            failedAssertions++;
+        else
+            passedAssertions++;
+        // Map assertions actively straight to the current request reference payload array
+        if (currentRequestRef && currentRequestRef.id === args.cursor.ref) {
+            currentRequestRef.assertions.push({
+                name: args.assertion || 'Unnamed Checkpoint',
+                passed: !err,
+                errorMessage: err ? err.message : undefined
+            });
+        }
+    })
+        .on('done', (err, summary) => {
+        if (err || !summary) {
+            console.error("\x1b[31m[CRITICAL]\x1b[0m Collection run crashed.", err);
+            process.exit(1);
+        }
+        const calculatedAvg = totalRequests > 0 ? Math.round(totalLatency / totalRequests) : 0;
+        let healthRating = 'Success';
+        if (failedAssertions > 0)
+            healthRating = 'Failure';
+        else if (calculatedAvg > 1000)
+            healthRating = 'Warning';
+        const metricsPayload = {
+            runId: `RUN-${Math.floor(100000 + Math.random() * 900000)}`,
+            collectionName: summary.collection.name || 'Postman Collection',
+            timestamp: new Date().toISOString().replace('T', ' ').substring(0, 19),
+            totalRequests,
+            passedAssertions,
+            failedAssertions,
+            avgResponseTime: calculatedAvg,
+            status: healthRating,
+            requests: detailedRequests
+        };
+        commitRunToHistory(metricsPayload);
+        setTimeout(() => {
+            spinUpDashboardPortal();
+        }, 300);
+    });
+}
+function spinUpDashboardPortal() {
+    const app = express();
+    app.get('/api/history', (req, res) => {
+        res.setHeader('Cache-Control', 'no-store, no-cache, must-revalidate, private');
+        res.json(fetchLocalLedger());
+    });
+    app.get('/', (req, res) => {
+        res.sendFile(path.join(__dirname, 'dashboard.html'));
+    });
+    app.listen(SERVER_PORT, async () => {
+        console.log(`\x1b[32m🚀 [PORTAL] Dashboard metrics serving at http://localhost:${SERVER_PORT}\x1b[0m`);
+        await open(`http://localhost:${SERVER_PORT}`);
+    });
+}
+executePipeline();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "newman-reporter-dashboard-wrapper",
+  "version": "1.0.0",
+  "description": "Historical trend reporting dashboard for Postman/Newman executions",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "newman-dashboard": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && copyfiles -u 1 src/dashboard.html dist/",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "express": "^4.19.2",
+    "newman": "^6.1.3",
+    "open": "^10.1.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/newman": "*",
+    "@types/node": "^20.11.0",
+    "copyfiles": "^2.4.1",
+    "typescript": "^5.3.3"
+  }
+}

package/readme.md

@@ -0,0 +1,20 @@
+# Newman Dashboard Orchestrator 🚀
+
+An interactive, real-time HTML5 analytics reporter dashboard for Postman collections executed via Newman. Includes a built-in, completely free, client-side **AI QA Advisor Insights** engine to instantly diagnose assertion and performance bottlenecks locally with zero external API dependencies.
+
+---
+
+## ⚡ Quick Start Guide
+
+Get up and running with your interactive dashboard wrapper in under 2 minutes.
+
+### 1. Prerequisites
+Ensure you have [Node.js](https://nodejs.org/) (v18 or higher) installed on your machine. You will also need a Postman collection exported as a `.json` file.
+
+### 2. Global Installation
+Open your terminal and install the orchestrator utility globally:
+```bash
+npm install -g newman-reporter-dashboard-orchestrator
+
+How to run the newman and invoke dashboard 
+newman-dashboard my_postman_collection.json