donobu 5.26.0 → 5.27.0

package/dist/esm/{cli/playwright-json-to-html.js → reporter/render.js}

@@ -1,24 +1,19 @@
-#!/usr/bin/env node
 "use strict";
 /**
- * @fileoverview Playwright JSON Report to HTML Report Converter
+ * @fileoverview Donobu HTML report renderer.
  *
- * Converts Playwright JSON test reports (optionally enriched with Donobu triage
- * data) into a polished, self-contained HTML report for test writers, maintainers,
- * and debuggers.
- *
- * @usage
- * ```bash
- * npm exec playwright-json-to-html report.json -o report.html
- * npm exec playwright-json-to-html report.json --triage-dir ./donobu-triage/run-id/ -o report.html
- * cat merged-report.json | npx playwright-json-to-html --triage-dir ./triage/ -o report.html
- * ```
+ * Pure library that turns a `DonobuReport` (Playwright-JSON superset with
+ * optional triage data) into a self-contained HTML document. No filesystem
+ * writes, no CLI arg parsing, no environment variable reads — callers (the
+ * reporter and the auto-heal orchestrator) own I/O.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripAnsi = stripAnsi;
 exports.loadTriageData = loadTriageData;
-exports.generateHtml = generateHtml;
+exports.renderHtml = renderHtml;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const reportWalk_1 = require("./reportWalk");
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -132,41 +127,6 @@ function normalizeTestFile(filePath) {
     // normalize to "foo.test.ts".
     return (0, path_1.basename)(filePath);
 }
-// ---------------------------------------------------------------------------
-// CLI argument parsing
-// ---------------------------------------------------------------------------
-function parseArgs() {
-    const args = process.argv.slice(2);
-    let outputFile = null;
-    let triageDir = null;
-    let inputFile = null;
-    for (let i = 0; i < args.length; i++) {
-        if ((args[i] === '-o' || args[i] === '--output') && i + 1 < args.length) {
-            outputFile = args[i + 1];
-            i++;
-        }
-        else if (args[i] === '--triage-dir' && i + 1 < args.length) {
-            triageDir = args[i + 1];
-            i++;
-        }
-        else if (!args[i].startsWith('-')) {
-            inputFile = args[i];
-        }
-    }
-    const jsonData = inputFile
-        ? JSON.parse((0, fs_1.readFileSync)(inputFile, 'utf8'))
-        : JSON.parse((0, fs_1.readFileSync)(0, 'utf8'));
-    // Default output to a sibling of the input JSON so asset relative paths work
-    if (!outputFile && inputFile) {
-        outputFile = (0, path_1.join)((0, path_1.dirname)((0, path_1.resolve)(inputFile)), 'index.html');
-    }
-    return {
-        jsonData,
-        outputFile,
-        triageDir: triageDir ? (0, path_1.resolve)(triageDir) : null,
-        inputFile,
-    };
-}
 function loadTriageData(triageDir) {
     const plans = [];
     const evidence = [];
@@ -287,22 +247,13 @@ function parseStderrSteps(stderrEntries) {
     }
     return steps;
 }
-// Recursively collect all specs from a suite and its nested sub-suites
-function collectSpecs(suite) {
-    const specs = [...(suite.specs ?? [])];
-    for (const child of suite.suites ?? []) {
-        specs.push(...collectSpecs(child));
-    }
-    return specs;
-}
 function extractTests(jsonData) {
     const tests = [];
     for (const suite of jsonData.suites ?? []) {
-        for (const spec of collectSpecs(suite)) {
+        for (const spec of (0, reportWalk_1.collectSpecs)(suite)) {
             for (const test of spec.tests ?? []) {
                 const annotations = test.annotations ?? [];
-                const hasHealAnnotation = annotations.some((a) => a.type === 'self-healed');
-                const isSelfHealed = hasHealAnnotation || test.donobuStatus === 'healed';
+                const isSelfHealed = (0, reportWalk_1.isSelfHealed)(test);
                 let status;
                 const lastResult = test.results?.at(-1);
                 if (test.status === 'skipped' ||
@@ -621,25 +572,40 @@ function renderNativeStep(ns) {
     const locationStr = ns.location?.file
         ? esc(`${ns.location.file.replace(/.*[/\\]/, '')}:${ns.location.line}`)
         : '';
-    let html = `<div class="filmstrip-step native-step">`;
-    html += `<div class="filmstrip-header">`;
-    html += statusIcon;
-    html += `<span class="native-step-title">${esc(ns.title)}</span>`;
-    html += categoryBadge;
-    if (locationStr) {
-        html += `<span class="native-step-location">${locationStr}</span>`;
-    }
-    html += `</div>`;
+    const snippet = ns.location?.file
+        ? readSourceSnippet(ns.location.file, ns.location.line)
+        : null;
+    const hasBody = snippet || (!ns.passed && ns.error?.message);
+    const renderHeader = (tag) => {
+        let header = `<${tag} class="filmstrip-header">`;
+        header += statusIcon;
+        header += `<span class="native-step-title">${esc(ns.title)}</span>`;
+        header += categoryBadge;
+        if (locationStr) {
+            header += `<span class="native-step-location">${locationStr}</span>`;
+        }
+        if (tag === 'summary') {
+            header +=
+                '<span class="native-step-chevron" aria-hidden="true">&#9656;</span>';
+        }
+        header += `</${tag}>`;
+        return header;
+    };
+    if (!hasBody) {
+        return `<div class="filmstrip-step native-step">${renderHeader('div')}</div>`;
+    }
+    // Failing steps render expanded so the error is immediately visible;
+    // passing steps collapse so a test with many expects stays scannable.
+    const passClass = ns.passed ? 'native-step--passed' : 'native-step--failed';
+    let html = `<details class="filmstrip-step native-step ${passClass}"${ns.passed ? '' : ' open'}>`;
+    html += renderHeader('summary');
     if (!ns.passed && ns.error?.message) {
         html += `<pre class="native-step-error">${ansiToHtml(ns.error.message)}</pre>`;
     }
-    if (!ns.passed && ns.location?.file) {
-        const snippet = readSourceSnippet(ns.location.file, ns.location.line);
-        if (snippet) {
-            html += snippet;
-        }
+    if (snippet) {
+        html += snippet;
     }
-    html += `</div>`;
+    html += `</details>`;
     return html;
 }
 const AUDIT_CHECK_DEFS = [
@@ -1223,7 +1189,8 @@ function renderResultTimeline(results, outputDir) {
     return html;
 }
 const LOGO_SVG = '<svg viewBox="0 0 245 238" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#logo-clip)"><path d="M8.75 123.921L21.3889 110.367H32.0833L40.8333 133.602L43.75 155.869L32.0833 158.774L19.4444 155.869L8.75 123.921Z" fill="#FF7F3A"/><path d="M237.225 125.857L224.586 112.303H213.891L205.141 135.539L202.225 157.806L213.891 160.71L226.53 157.806L237.225 125.857Z" fill="#FF7F3A"/><path d="M130.276 57.1198L55.415 78.4187L46.665 88.1V142.315V164.583L68.0539 206.212L93.3317 225.575L117.637 231.384C130.276 230.416 156.332 227.898 159.443 225.575C163.332 222.671 186.665 192.658 190.554 182.977C194.443 173.296 195.415 157.806 195.415 147.156C195.415 136.507 196.387 120.048 195.415 115.208C194.637 111.335 177.591 89.0682 169.165 78.4187L130.276 57.1198Z" fill="#FF7F3A"/><path d="M129.868 30.4824C131.882 28.9302 134.006 26.8043 135.359 24.6522C136.96 22.1107 137.166 19.9586 138.26 17.5486C138.487 17.0434 138.418 16.0226 139.353 16.8172C139.565 16.9961 141.99 20.9373 142.291 21.5214C144.854 26.5781 145.435 32.282 145.943 37.8597C168.385 44.6265 188.639 58.1076 200.824 78.3555C205.004 85.296 209.099 93.9466 210.108 101.971C224.772 94.6044 239.515 103.244 243.626 118.262C250.342 142.793 231.583 169.955 205.421 169.855C204.697 174.096 204.153 178.232 202.975 182.4C196.089 206.684 169.943 227.994 146.101 234.582C99.7856 247.374 45.9189 218.933 39.5938 169.782C13.2839 169.982-5.80773 142.093 1.61651 117.51C5.93895 103.192 20.5496 94.6201 34.5791 101.955C35.3453 101.903 36.3176 96.3197 36.6875 95.1358C41.9188 78.566 53.1846 63.2537 67.0819 52.8614C80.1232 43.1111 99.2202 37.8281 107.247 22.9421C111.099 15.7964 111.564 7.89294 110.333-.0157471C123.083 4.47268 130.724 17.1855 129.863 30.4719L129.868 30.4824ZM121.953 106.181C116.272 96.8144 103.95 89.0267 93.0272 87.4008C79.1774 85.3434 65.745 91.2788 58.8492 103.544C48.8727 121.288 56.6246 142.414 74.9606 150.349C50.8279 179.885 74.8179 211.972 107.157 218.949C130.492 223.985 160.295 216.781 173.69 195.828C183.032 181.216 180.908 163.446 169.98 150.349C195.931 140.352 197.643 103.692 172.971 90.8526C155.042 81.5232 133.636 89.8213 123.041 105.849L121.953 106.181ZM36.9517 154.538C35.9107 151.496 35.1075 148.334 34.4787 145.182C33.4219 139.889 32.328 133.38 32.1801 128.018C32.0057 121.793 35.266 115.552 26.954 113.774C15.5138 111.327 12.3803 123.834 13.2628 132.664C14.4306 144.345 24.3067 156.327 36.957 154.538H36.9517ZM217.876 113.658C216.338 113.968 212.423 116.331 212.195 118.036C212.053 119.12 212.734 120.425 212.761 121.666C212.882 127.481 212.407 133.658 211.53 139.41C210.8 144.193 209.553 149.255 208.063 153.864C207.921 155.969 213.178 154.69 214.436 154.401C222.732 152.512 229.21 144.277 231.055 136.253C233.237 126.734 231.261 110.937 217.871 113.663L217.876 113.658Z" fill="#1a1a1a"/><path d="M158.212 170.413C162.36 169.755 164.738 174.88 161.018 178.48C148.087 190.971 111.162 196.554 95.0185 189.509C91.848 188.125 91.1293 183.589 94.2998 181.958C96.5192 180.816 102.902 183.021 105.904 183.399C119.711 185.136 134.507 183.226 147.104 177.248C149.308 176.206 157.44 170.539 158.206 170.413H158.212Z" fill="#1a1a1a"/><path d="M150.305 114.72C163.975 111.91 165.682 135.542 153.835 137.152C140.884 138.915 139.943 116.846 150.305 114.72Z" fill="#1a1a1a"/><path d="M92.7645 114.721C103.808 112.437 108.141 129.933 99.2058 135.853C88.7326 142.788 79.628 123.75 90.0061 116.178C90.767 115.626 91.8503 114.91 92.7645 114.721Z" fill="#1a1a1a"/><path d="M132.355 145.198C137.211 144.109 140.059 148.608 137.713 152.643C136.217 155.222 126.283 159.526 124.841 156.653C123.715 152.88 128.74 146.008 132.355 145.198Z" fill="#1a1a1a"/><path d="M110.192 145.188C116.206 143.872 123.155 155.432 119.847 157.453C115.984 158.085 107.223 154.901 106.657 150.56C106.367 148.308 107.899 145.693 110.198 145.188H110.192Z" fill="#1a1a1a"/></g><defs><clipPath id="logo-clip"><rect width="245" height="237.65" fill="white"/></clipPath></defs></svg>';
-function generateHtml(jsonData, triage, outputDir) {
+function renderHtml(report, triage, outputDir) {
+    const jsonData = report;
     const tests = extractTests(jsonData);
     const isMergedReport = !!jsonData.metadata?.donobuMergedReport;
     // Match triage data to tests
@@ -1555,9 +1522,9 @@ body::before{content:'';position:fixed;top:-750px;left:50%;transform:translateX(
 
 /* Steps */
 .steps-section{margin:8px 0;border:1px solid var(--border-subtle);border-radius:var(--radius);overflow:hidden}
-.steps-section summary{font-size:12px;font-weight:600;color:var(--text-muted);padding:8px 12px;cursor:pointer;user-select:none;background:var(--surface-raised)}
+.steps-section>summary{font-size:12px;font-weight:600;color:var(--text-muted);padding:8px 12px;cursor:pointer;user-select:none;background:var(--surface-raised)}
 .steps-section summary:hover{background:var(--surface)}
-.steps-section[open] summary{border-bottom:1px solid var(--border-subtle)}
+.steps-section[open]>summary{border-bottom:1px solid var(--border-subtle)}
 .steps-list{padding:4px 0}
 .step-entry{display:flex;gap:8px;padding:4px 12px;font-size:12px;align-items:baseline}
 .step-time{color:var(--text-dim);font-family:var(--mono);font-size:11px;flex-shrink:0;width:85px}
@@ -1632,18 +1599,23 @@ body::before{content:'';position:fixed;top:-750px;left:50%;transform:translateX(
 .audit-a11y-more{font-size:10px;color:var(--text-dim);margin-top:2px}
 
 /* Native Playwright steps (expect / test.step) inside the filmstrip */
-.native-step{background:var(--bg)}
+details.native-step>summary{list-style:none;cursor:pointer}
+details.native-step>summary::-webkit-details-marker{display:none}
 .native-step-title{font-size:12px;font-weight:500;color:var(--text);font-family:var(--mono);flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .native-step-badge{font-size:10px;font-weight:600;padding:1px 5px;border-radius:3px;white-space:nowrap;flex-shrink:0}
 .native-step-badge--expect{background:rgba(99,102,241,.12);color:#818cf8}
 .native-step-badge--test\.step{background:rgba(16,185,129,.10);color:#34d399}
 .native-step-location{font-size:10px;color:var(--text-dim);font-family:var(--mono);margin-left:auto;flex-shrink:0;white-space:nowrap}
+.native-step-chevron{font-size:10px;color:var(--text-dim);flex-shrink:0;transition:transform .12s;display:inline-block;margin-left:4px}
+details.native-step[open]>summary .native-step-chevron{transform:rotate(90deg)}
 .native-step-error{font-size:11px;font-family:var(--mono);padding:4px 0 2px 22px;margin:0;white-space:pre-wrap;word-break:break-word;color:var(--text-muted)}
-.native-step-snippet{font-size:11px;font-family:var(--mono);margin:4px 0 2px 22px;border-radius:var(--radius);overflow:hidden;border:1px solid var(--border-subtle)}
+.native-step-snippet{font-size:11px;font-family:var(--mono);margin:4px 0 2px 22px;overflow:hidden}
 .snippet-line{display:flex;padding:1px 8px;white-space:pre}
 .snippet-line--target{background:rgba(239,68,68,.10)}
 .snippet-linenum{color:var(--text-dim);min-width:40px;user-select:none}
 .snippet-line--target .snippet-linenum{color:var(--red)}
+.native-step--passed .snippet-line--target{background:rgba(52,211,153,.10)}
+.native-step--passed .snippet-line--target .snippet-linenum{color:var(--green)}
 .snippet-code{color:var(--text)}
 
 /* Result timeline */
@@ -1871,76 +1843,4 @@ body::before{content:'';position:fixed;top:-750px;left:50%;transform:translateX(
 </body>
 </html>`;
 }
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-// Only run CLI logic when this file is executed directly (not imported as a module).
-if (require.main === module) {
-    try {
-        const { jsonData, outputFile, triageDir, inputFile } = parseArgs();
-        // Auto-discover triage dir from merged report metadata if not explicitly given
-        let resolvedTriageDir = triageDir;
-        // Prefer the explicit triageRunDir recorded during the merge.
-        if (!resolvedTriageDir && jsonData.metadata?.triageRunDir) {
-            const candidate = jsonData.metadata.triageRunDir;
-            if ((0, fs_1.existsSync)(candidate)) {
-                resolvedTriageDir = candidate;
-            }
-        }
-        // Legacy fallback: derive triage dir from the initial report path (older
-        // merged reports stored the initial-playwright-report.json copy inside the
-        // triage run directory).
-        if (!resolvedTriageDir && jsonData.metadata?.sources?.initial) {
-            const initialPath = jsonData.metadata.sources.initial;
-            // Try the absolute path first (works when running in the same env as CI)
-            const candidate = (0, path_1.dirname)(initialPath);
-            if ((0, fs_1.existsSync)(candidate) && (0, path_1.basename)(candidate) !== '.') {
-                resolvedTriageDir = candidate;
-            }
-            else {
-                // Fallback: extract the donobu-triage/... suffix and resolve relative
-                // to the input file. This handles downloaded CI artifacts where the
-                // absolute CI path no longer exists.
-                const triageMatch = initialPath.match(/donobu-triage[/\\][^/\\]+[/\\]?.*$/);
-                if (triageMatch && inputFile) {
-                    const localCandidate = (0, path_1.resolve)((0, path_1.dirname)((0, path_1.resolve)(inputFile)), (0, path_1.dirname)(triageMatch[0]));
-                    if ((0, fs_1.existsSync)(localCandidate)) {
-                        resolvedTriageDir = localCandidate;
-                    }
-                }
-            }
-        }
-        // Last resort: scan for donobu-triage dirs next to the input file
-        if (!resolvedTriageDir && inputFile) {
-            const triageRoot = (0, path_1.resolve)((0, path_1.dirname)((0, path_1.resolve)(inputFile)), 'donobu-triage');
-            if ((0, fs_1.existsSync)(triageRoot)) {
-                // Use the most recent triage run directory
-                const subdirs = (0, fs_1.readdirSync)(triageRoot)
-                    .filter((d) => (0, fs_1.existsSync)((0, path_1.resolve)(triageRoot, d, '.')))
-                    .sort()
-                    .reverse();
-                if (subdirs.length > 0) {
-                    resolvedTriageDir = (0, path_1.resolve)(triageRoot, subdirs[0]);
-                }
-            }
-        }
-        const triage = resolvedTriageDir
-            ? loadTriageData(resolvedTriageDir)
-            : { plans: [], evidence: [] };
-        const outputDir = outputFile ? (0, path_1.dirname)((0, path_1.resolve)(outputFile)) : null;
-        const html = generateHtml(jsonData, triage, outputDir);
-        if (outputFile) {
-            (0, fs_1.writeFileSync)(outputFile, html, 'utf8');
-            console.error(`Report written to ${outputFile}`);
-        }
-        else {
-            console.log(html);
-        }
-    }
-    catch (error) {
-        console.error('Error processing JSON:', error.message);
-        process.exit(1);
-    }
-}
-// end of CLI guard
-//# sourceMappingURL=playwright-json-to-html.js.map
+//# sourceMappingURL=render.js.map

package/dist/esm/reporter/renderMarkdown.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Donobu Markdown report renderer.
+ *
+ * Pure library that turns a `DonobuReport` into a Markdown string suitable
+ * for GitHub Actions step summaries, PR comments, or any other
+ * Markdown-consuming surface. No filesystem writes, no CLI arg parsing, no
+ * environment variable reads — callers own I/O.
+ */
+import type { DonobuReport } from './model';
+export declare function renderMarkdown(report: DonobuReport): string;
+//# sourceMappingURL=renderMarkdown.d.ts.map

package/dist/esm/{cli/playwright-json-to-markdown.js → reporter/renderMarkdown.js}

@@ -1,51 +1,16 @@
-#!/usr/bin/env node
 "use strict";
 /**
- * @fileoverview Playwright JSON Report to Markdown Converter
+ * @fileoverview Donobu Markdown report renderer.
  *
- * A command-line utility that converts Playwright JSON test reports into human-readable Markdown format.
- * This tool is designed to be used in CI/CD pipelines to generate formatted test reports for GitHub
- * Actions summaries, pull request comments, or documentation.
- *
- * @usage
- * Read from file:
- * ```bash
- * npm exec playwright-json-to-markdown report.json
- * ```
- *
- * Read from stdin (useful in pipelines):
- * ```bash
- * cat test-results/results.json | npx playwright-json-to-markdown
- * npm exec playwright test --reporter=json | npx playwright-json-to-markdown
- * ```
- *
- * @input
- * Expects a Playwright JSON report with the following structure:
- * - config: Test configuration including projects.
- * - suites: Array of test suites containing specs and tests.
- * - stats: Summary statistics (duration, expected, unexpected, flaky, skipped).
- *
- * @output
- * Generates a Markdown report containing:
- * - 📊 Summary table with test counts and duration.
- * - Overall pass/fail status with appropriate emoji.
- * - 📋 Detailed results organized by file and test suite.
- * - ❌ Error details and locations for failed tests.
- * - 🚀 List of configured projects.
- *
- * @features
- * - Emoji indicators for test status (✅ passed, ❌ failed).
- * - Human-readable duration formatting (ms, s, m s).
- * - Hierarchical organization (file → spec → test).
- * - Error message and location details for failures.
- * - Summary statistics in tabular format.
+ * Pure library that turns a `DonobuReport` into a Markdown string suitable
+ * for GitHub Actions step summaries, PR comments, or any other
+ * Markdown-consuming surface. No filesystem writes, no CLI arg parsing, no
+ * environment variable reads — callers own I/O.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = require("fs");
-function stripAnsiCodes(str) {
-    return str.replace(/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, '');
-}
-// Function to format duration in a readable way
+exports.renderMarkdown = renderMarkdown;
+const render_1 = require("./render");
+const reportWalk_1 = require("./reportWalk");
 function formatDuration(ms) {
     if (ms < 1000) {
         return `${ms}ms`;
@@ -58,38 +23,16 @@ function formatDuration(ms) {
     const remainingSeconds = seconds % 60;
     return `${minutes}m ${remainingSeconds}s`;
 }
-// Read the JSON data from file or stdin
-function readInput() {
-    const args = process.argv.slice(2);
-    if (args.length > 0) {
-        return JSON.parse((0, fs_1.readFileSync)(args[0], 'utf8'));
-    }
-    else {
-        return JSON.parse((0, fs_1.readFileSync)(0, 'utf8')); // Read from stdin
-    }
-}
-// Recursively collect all specs from a suite and its nested sub-suites
-function collectSpecs(suite) {
-    const specs = [...(suite.specs ?? [])];
-    for (const child of suite.suites ?? []) {
-        specs.push(...collectSpecs(child));
-    }
-    return specs;
-}
-// Process JSON and create markdown
-function generateMarkdown(jsonData) {
-    const { suites } = jsonData;
-    // Create report header
+function renderMarkdown(report) {
+    const suites = (report.suites ?? []);
     let markdown = `# Playwright Test Report\n\n`;
-    if (jsonData.metadata?.donobuMergedReport) {
+    if (report.metadata?.donobuMergedReport) {
         markdown += `> ⚙️ Auto-heal summary generated by Donobu (merged initial and retry runs).\n\n`;
     }
-    // Tests by file
+    // Per-file summary table
     markdown += `## Summary\n\n`;
-    // Create file summary table with status counts
     markdown += `| File | Passed | Self-Healed | Failed | Timed Out | Skipped | Interrupted | Duration |\n`;
     markdown += `| - | - | - | - | - | - | - | - |\n`;
-    // Track totals for summary row
     let totalPassed = 0;
     let totalFailed = 0;
     let totalTimedOut = 0;
@@ -98,27 +41,23 @@ function generateMarkdown(jsonData) {
     let totalSelfHealed = 0;
     let totalDuration = 0;
     suites.forEach((suite) => {
-        // Count tests by status for this file
         let passed = 0;
         let failed = 0;
         let timedOut = 0;
         let skipped = 0;
         let interrupted = 0;
         let selfHealed = 0;
-        const allSpecs = collectSpecs(suite);
+        const allSpecs = (0, reportWalk_1.collectSpecs)(suite);
         const fileDuration = allSpecs.reduce((total, spec) => total +
-            spec.tests.reduce((testTotal, test) => {
+            (spec.tests ?? []).reduce((testTotal, test) => {
                 const result = test.results?.at(-1);
-                const annotations = test.annotations ?? [];
-                const hasAnnotation = annotations.some((a) => a.type === 'self-healed');
-                const donobuHealed = test.donobuStatus === 'healed';
-                const isSelfHealed = hasAnnotation || donobuHealed;
+                const healed = (0, reportWalk_1.isSelfHealed)(test);
                 if (test.status === 'skipped' ||
                     (!result && test.status === undefined)) {
                     skipped++;
                 }
                 else if (result) {
-                    if (isSelfHealed) {
+                    if (healed) {
                         selfHealed++;
                     }
                     else {
@@ -143,7 +82,6 @@ function generateMarkdown(jsonData) {
                 }
                 return testTotal + (result?.duration || 0);
             }, 0), 0);
-        // Add to totals
         totalPassed += passed;
         totalFailed += failed;
         totalTimedOut += timedOut;
@@ -153,35 +91,31 @@ function generateMarkdown(jsonData) {
         totalDuration += fileDuration;
         markdown += `| ${suite.file} | ${passed ? passed + ' ✅' : ''} | ${selfHealed ? selfHealed + ' ❤️‍🩹' : ''} | ${failed ? failed + ' ❌' : ''} | ${timedOut ? timedOut + ' ⏰' : ''} | ${skipped ? skipped + ' ⏭️' : ''} | ${interrupted ? interrupted + ' ⚡' : ''} | ${formatDuration(fileDuration)} |\n`;
     });
-    // Add totals row
     markdown += `| **TOTAL** | **${totalPassed + ' ✅'}** | **${totalSelfHealed + ' ❤️‍🩹'}** | **${totalFailed + ' ❌'}** | **${totalTimedOut + ' ⏰'}** | **${totalSkipped + ' ⏭️'}** | **${totalInterrupted + ' ⚡'}** | **${formatDuration(totalDuration)}** |\n`;
     markdown += `\n`;
-    // Generate test details sections
+    // Per-test details
     suites.forEach((suite) => {
         const fileName = suite.file;
         markdown += `## ${fileName}\n\n`;
-        collectSpecs(suite).forEach((spec) => {
+        (0, reportWalk_1.collectSpecs)(suite).forEach((spec) => {
             markdown += `### ${spec.title}\n\n`;
-            spec.tests.forEach((test) => {
+            (spec.tests ?? []).forEach((test) => {
                 const result = test.results?.at(-1);
-                if (test.status === 'skipped' || !result || test.status === undefined) {
+                if (test.status === 'skipped' ||
+                    (!result && test.status === undefined)) {
                     markdown += `**Status**: ⏭️ Skipped  \n`;
                     markdown += `**Duration**: N/A  \n`;
                     const objectiveAnnotation = test.annotations?.find((a) => a.type === 'objective');
                     if (objectiveAnnotation) {
-                        const objective = (objectiveAnnotation.description || 'No objective provided').replace(/```/g, '\\`\\`\\`'); // escape triple backticks
+                        const objective = (objectiveAnnotation.description || 'No objective provided').replace(/```/g, '\\`\\`\\`');
                         markdown += `**Objective**:\n\`\`\`\n${objective}\n\`\`\`\n`;
                     }
                     markdown += `\n---\n\n`;
                     return;
                 }
-                const annotations = test.annotations ?? [];
-                const hasAnnotation = annotations.some((a) => a.type === 'self-healed');
-                const donobuHealed = test.donobuStatus === 'healed';
-                const isSelfHealed = hasAnnotation || donobuHealed;
-                // Determine status based on result status and self-healing annotation
+                const healed = (0, reportWalk_1.isSelfHealed)(test);
                 let status;
-                if (isSelfHealed) {
+                if (healed) {
                     status = '❤️‍🩹 Healed';
                 }
                 else {
@@ -208,21 +142,19 @@ function generateMarkdown(jsonData) {
                 const duration = formatDuration(result.duration || 0);
                 markdown += `**Status**: ${status}  \n`;
                 markdown += `**Duration**: ${duration}  \n`;
-                if (isSelfHealed) {
+                if (healed) {
                     markdown += `> ❤️‍🩹 This test was automatically healed by re-running with Donobu treatment plan directives.\n\n`;
                 }
                 const objectiveAnnotation = test.annotations?.find((a) => a.type === 'objective');
                 if (objectiveAnnotation) {
-                    const objective = (objectiveAnnotation.description || 'No objective provided').replace(/```/g, '\\`\\`\\`'); // escape triple backticks
+                    const objective = (objectiveAnnotation.description || 'No objective provided').replace(/```/g, '\\`\\`\\`');
                     markdown += `**Objective**:\n\`\`\`\n${objective}\n\`\`\`\n`;
                 }
-                // Add error details if test failed
                 if (result.status === 'failed' && result.error) {
                     markdown += `\n<details>\n<summary>⚠️ Error Details</summary>\n\n`;
                     markdown += `\`\`\`\n${result.error.message || 'No error message available'}\n\`\`\`\n\n`;
-                    // Include code snippet if available
                     if (result.error.snippet) {
-                        markdown += `**Code Snippet**:\n\`\`\`\n${stripAnsiCodes(result.error.snippet)}\n\`\`\`\n\n`;
+                        markdown += `**Code Snippet**:\n\`\`\`\n${(0, render_1.stripAnsi)(result.error.snippet)}\n\`\`\`\n\n`;
                     }
                     markdown += `</details>\n\n`;
                 }
@@ -230,26 +162,15 @@ function generateMarkdown(jsonData) {
             });
         });
     });
-    if (Array.isArray(jsonData.metadata?.donobuHealedTests) &&
-        jsonData.metadata.donobuHealedTests.length > 0) {
+    if (Array.isArray(report.metadata?.donobuHealedTests) &&
+        report.metadata.donobuHealedTests.length > 0) {
         markdown += `### Auto-Healed Tests\n\n`;
-        jsonData.metadata.donobuHealedTests.forEach((entry) => {
+        report.metadata.donobuHealedTests.forEach((entry) => {
             markdown += `- ❤️‍🩹 ${entry}\n`;
         });
         markdown += `\n`;
     }
-    // Add timestamp footer
     markdown += `_Report generated on ${new Date().toLocaleString()} by Donobu_\n`;
     return markdown;
 }
-// Main execution
-try {
-    const jsonData = readInput();
-    const markdown = generateMarkdown(jsonData);
-    console.log(markdown);
-}
-catch (error) {
-    console.error('Error processing JSON: ', error.message);
-    process.exit(1);
-}
-//# sourceMappingURL=playwright-json-to-markdown.js.map
+//# sourceMappingURL=renderMarkdown.js.map

package/dist/esm/reporter/renderSlack.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Donobu Slack payload renderer.
+ *
+ * Pure library that turns a `DonobuReport` into a Slack Block Kit payload
+ * suitable for POSTing to an Incoming Webhook. No filesystem writes, no
+ * network calls, no env-var reads — callers own I/O.
+ */
+import type { DonobuReport } from './model';
+export interface RenderSlackOptions {
+    /** Optional URL linking back to the full HTML report or CI job. */
+    reportUrl?: string;
+}
+export interface SlackBlockPayload {
+    blocks: unknown[];
+}
+export declare function renderSlack(report: DonobuReport, options?: RenderSlackOptions): SlackBlockPayload;
+//# sourceMappingURL=renderSlack.d.ts.map

package/dist/esm/reporter/renderSlack.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * @fileoverview Donobu Slack payload renderer.
+ *
+ * Pure library that turns a `DonobuReport` into a Slack Block Kit payload
+ * suitable for POSTing to an Incoming Webhook. No filesystem writes, no
+ * network calls, no env-var reads — callers own I/O.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSlack = renderSlack;
+const reportWalk_1 = require("./reportWalk");
+function renderSlack(report, options = {}) {
+    const suites = (report.suites ?? []);
+    const blocks = [];
+    blocks.push({
+        type: 'header',
+        text: { type: 'plain_text', text: '🐵 Donobu Test Summary' },
+    });
+    let totalPassed = 0;
+    let totalFailed = 0;
+    let totalTimedOut = 0;
+    let totalSkipped = 0;
+    let totalInterrupted = 0;
+    let totalSelfHealed = 0;
+    suites.forEach((suite) => {
+        (0, reportWalk_1.collectSpecs)(suite).forEach((spec) => {
+            (spec.tests ?? []).forEach((test) => {
+                const result = test.results?.at(-1);
+                const healed = (0, reportWalk_1.isSelfHealed)(test);
+                if (test.status === 'skipped' ||
+                    (!result && test.status === undefined)) {
+                    totalSkipped++;
+                }
+                else if (result) {
+                    if (healed) {
+                        totalSelfHealed++;
+                    }
+                    else {
+                        switch (result.status) {
+                            case 'passed':
+                                totalPassed++;
+                                break;
+                            case 'failed':
+                                totalFailed++;
+                                break;
+                            case 'timedOut':
+                                totalTimedOut++;
+                                break;
+                            case 'skipped':
+                                totalSkipped++;
+                                break;
+                            case 'interrupted':
+                                totalInterrupted++;
+                                break;
+                        }
+                    }
+                }
+            });
+        });
+    });
+    const statusRows = [
+        { name: 'Passed', emoji: '✅', count: totalPassed },
+        { name: 'Self-Healed', emoji: '❤️‍🩹', count: totalSelfHealed },
+        { name: 'Failed', emoji: '❌', count: totalFailed },
+        { name: 'Timed Out', emoji: '⏰', count: totalTimedOut },
+        { name: 'Skipped', emoji: '⏭️', count: totalSkipped },
+        { name: 'Interrupted', emoji: '⚡', count: totalInterrupted },
+    ];
+    statusRows.forEach((row) => {
+        blocks.push({
+            type: 'section',
+            fields: [
+                { type: 'mrkdwn', text: `${row.emoji} ${row.name}` },
+                { type: 'mrkdwn', text: `${row.count}` },
+            ],
+        });
+    });
+    if (options.reportUrl) {
+        blocks.push({ type: 'divider' });
+        blocks.push({
+            type: 'section',
+            text: {
+                type: 'mrkdwn',
+                text: `📊 <${options.reportUrl}|View Full Report>`,
+            },
+        });
+    }
+    blocks.push({ type: 'divider' });
+    blocks.push({
+        type: 'context',
+        elements: [
+            {
+                type: 'mrkdwn',
+                text: `Report generated on ${new Date().toLocaleString()} by Donobu`,
+            },
+        ],
+    });
+    return { blocks };
+}
+//# sourceMappingURL=renderSlack.js.map