@testomatio/reporter 2.7.9-beta.2-markdown → 2.8.0

package/lib/client.js

@@ -214,9 +214,10 @@ class Client {
         const { time = 0, example = null, filesBuffers = [], code = null, file, suite_id, test_id, timestamp, links, overwrite, tags, } = testData;
         let { files = [], manuallyAttachedArtifacts, message = '', meta = {} } = testData;
         if (stepArtifactPaths.size) {
-            files = files.filter(f => !isStepArtifact(f, stepArtifactPaths));
+            const isStepArtifact = item => stepArtifactPaths.has(typeof item === 'object' ? item?.path : item);
+            files = files.filter(f => !isStepArtifact(f));
             if (Array.isArray(manuallyAttachedArtifacts)) {
-                manuallyAttachedArtifacts = manuallyAttachedArtifacts.filter(a => !isStepArtifact(a, stepArtifactPaths));
+                manuallyAttachedArtifacts = manuallyAttachedArtifacts.filter(a => !isStepArtifact(a));
             }
         }
         meta = Object.entries(meta)
@@ -385,42 +386,27 @@ exports.Client = Client;
  * referenced by `step.artifacts` at any depth.
  *
  * @param {any} steps
+ * @param {Set<string>} [paths]
  * @returns {Set<string>}
  */
-function collectStepArtifactPaths(steps) {
-    const paths = new Set();
+function collectStepArtifactPaths(steps, paths = new Set()) {
     if (!Array.isArray(steps))
         return paths;
-    const walk = arr => {
-        for (const step of arr) {
-            if (!step)
-                continue;
-            if (Array.isArray(step.artifacts)) {
-                for (const a of step.artifacts) {
-                    if (typeof a === 'string')
-                        paths.add(a);
-                    else if (a && typeof a === 'object' && typeof a.path === 'string')
-                        paths.add(a.path);
-                }
+    for (const step of steps) {
+        if (!step)
+            continue;
+        if (Array.isArray(step.artifacts)) {
+            for (const a of step.artifacts) {
+                if (typeof a === 'string')
+                    paths.add(a);
+                else if (a && typeof a === 'object' && typeof a.path === 'string')
+                    paths.add(a.path);
             }
-            if (Array.isArray(step.steps))
-                walk(step.steps);
         }
-    };
-    walk(steps);
+        collectStepArtifactPaths(step.steps, paths);
+    }
     return paths;
 }
-/**
- * @param {string|{path?: string}|null|undefined} item
- * @param {Set<string>} paths
- * @returns {boolean}
- */
-function isStepArtifact(item, paths) {
-    if (!item)
-        return false;
-    const p = typeof item === 'object' ? item.path : item;
-    return typeof p === 'string' && paths.has(p);
-}
 /**
  *
  * @param {TestData} testData

package/lib/pipe/html.d.ts

@@ -9,11 +9,12 @@ declare class HtmlPipe {
     htmlOutputPath: string;
     filenameMsg: string;
     tests: any[];
+    configuration: any;
     htmlReportDir: string;
     htmlReportName: string;
     templateFolderPath: string;
     templateHtmlPath: string;
-    createRun(): Promise<void>;
+    createRun(params?: {}): Promise<void>;
     prepareRun(): Promise<void>;
     updateRun(): void;
     /**

package/lib/pipe/html.js

@@ -9,6 +9,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const picocolors_1 = __importDefault(require("picocolors"));
 const handlebars_1 = __importDefault(require("handlebars"));
+const marked_1 = require("marked");
 const file_url_1 = __importDefault(require("file-url"));
 const utils_js_1 = require("../utils/utils.js");
 const constants_js_1 = require("../constants.js");
@@ -26,6 +27,7 @@ class HtmlPipe {
         this.htmlOutputPath = '';
         this.filenameMsg = '';
         this.tests = [];
+        this.configuration = null;
         if (this.isHtml) {
             this.isEnabled = true;
             this.htmlReportDir = process.env.TESTOMATIO_HTML_REPORT_FOLDER || constants_js_1.HTML_REPORT.FOLDER;
@@ -49,8 +51,10 @@ class HtmlPipe {
             debug(picocolors_1.default.yellow('HTML Pipe:'), `Save HTML report: ${this.isEnabled}`, `HTML report folder: ${this.htmlReportDir}, report name: ${this.htmlReportName}`);
         }
     }
-    async createRun() {
-        // empty
+    async createRun(params = {}) {
+        if (params?.configuration && typeof params.configuration === 'object') {
+            this.configuration = { ...(this.configuration || {}), ...params.configuration };
+        }
     }
     async prepareRun() { }
     updateRun() {
@@ -200,6 +204,8 @@ class HtmlPipe {
             runUrl: this.store.runUrl || '',
             executionTime: testExecutionSumTime(aggregatedTests),
             executionDate: getCurrentDateTimeFormatted(),
+            description: runParams.description || this.store.coverageDescription || this.store.description || '',
+            configuration: buildDisplayConfiguration(this.configuration || this.store.configuration || runParams.configuration || null),
             tests: aggregatedTests,
             envVars: collectEnvironmentVariables(),
         };
@@ -245,6 +251,11 @@ class HtmlPipe {
     }
     #loadReportHelpers() {
         handlebars_1.default.registerHelper('getTestsByStatus', (tests, status) => tests.filter(test => test.status.toLowerCase() === status.toLowerCase()).length);
+        handlebars_1.default.registerHelper('markdown', value => {
+            if (typeof value !== 'string' || !value.trim())
+                return '';
+            return new handlebars_1.default.SafeString(marked_1.marked.parse(value, { async: false }));
+        });
         handlebars_1.default.registerHelper('formatDuration', milliseconds => {
             if (!milliseconds || milliseconds === 0)
                 return '0ms';
@@ -948,4 +959,26 @@ function loadTracesFromFiles(test) {
         }
     }
 }
+function buildDisplayConfiguration(configuration) {
+    if (!configuration || typeof configuration !== 'object')
+        return null;
+    const entries = Object.entries(configuration).filter(([k]) => k !== 'tests' && k !== 'suites');
+    if (!entries.length)
+        return null;
+    entries.sort((a, b) => a[0].localeCompare(b[0]));
+    return entries.map(([key, value]) => ({ key, value: formatConfigDisplayValue(value) }));
+}
+function formatConfigDisplayValue(value) {
+    if (value == null)
+        return '';
+    if (typeof value === 'boolean' || typeof value === 'number' || typeof value === 'string') {
+        return String(value);
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch (_) {
+        return String(value);
+    }
+}
 module.exports = HtmlPipe;

package/lib/pipe/markdown.d.ts

@@ -9,9 +9,10 @@ declare class MarkdownPipe {
     markdownOutputPath: string;
     filenameMsg: string;
     tests: any[];
+    configuration: any;
     markdownReportDir: string;
     markdownReportName: string;
-    createRun(): Promise<void>;
+    createRun(params?: {}): Promise<void>;
     prepareRun(): Promise<void>;
     updateRun(): void;
     /**

package/lib/pipe/markdown.js

@@ -24,6 +24,7 @@ class MarkdownPipe {
         this.markdownOutputPath = '';
         this.filenameMsg = '';
         this.tests = [];
+        this.configuration = null;
         if (!this.isMarkdown)
             return;
         this.isEnabled = true;
@@ -45,8 +46,10 @@ class MarkdownPipe {
         utils_js_1.fileSystem.createDir(this.markdownReportDir);
         debug(picocolors_1.default.yellow('Markdown Pipe:'), `Save Markdown report: ${this.isEnabled}`, `Markdown report folder: ${this.markdownReportDir}, report name: ${this.markdownReportName}`);
     }
-    async createRun() {
-        // empty
+    async createRun(params = {}) {
+        if (params?.configuration && typeof params.configuration === 'object') {
+            this.configuration = { ...(this.configuration || {}), ...params.configuration };
+        }
     }
     async prepareRun() { }
     updateRun() {
@@ -109,6 +112,8 @@ class MarkdownPipe {
             isParallel: runParams?.isParallel,
             executionTime: testExecutionSumTime(aggregated),
             executionDate: getCurrentDateTimeFormatted(),
+            description: runParams?.description || this.store.coverageDescription || this.store.description || '',
+            configuration: this.configuration || this.store.configuration || runParams?.configuration || null,
             tests: aggregated,
             stats,
         };
@@ -135,9 +140,46 @@ function renderDocument(data) {
     const sections = [];
     sections.push(renderHeader(data));
     sections.push(renderRunMetadata(data));
+    sections.push(renderDescription(data.description));
+    sections.push(renderConfiguration(data.configuration));
     sections.push(renderTests(data.tests));
     return sections.filter(Boolean).join('\n\n') + '\n';
 }
+function renderDescription(description) {
+    if (typeof description !== 'string')
+        return '';
+    const trimmed = description.trim();
+    if (!trimmed)
+        return '';
+    return `## Description\n\n${trimmed}`;
+}
+function renderConfiguration(configuration) {
+    if (!configuration || typeof configuration !== 'object')
+        return '';
+    const entries = Object.entries(configuration).filter(([k]) => k !== 'tests' && k !== 'suites');
+    if (!entries.length)
+        return '';
+    entries.sort((a, b) => a[0].localeCompare(b[0]));
+    const lines = ['## Configuration', '', '| Key | Value |', '| --- | ----- |'];
+    for (const [k, v] of entries) {
+        lines.push(`| \`${k}\` | ${formatConfigValue(v)} |`);
+    }
+    return lines.join('\n');
+}
+function formatConfigValue(value) {
+    if (value == null)
+        return '';
+    if (typeof value === 'boolean' || typeof value === 'number')
+        return String(value);
+    if (typeof value === 'string')
+        return mdInline(value).replace(/\|/g, '\\|');
+    try {
+        return `\`${JSON.stringify(value)}\``;
+    }
+    catch (_) {
+        return String(value);
+    }
+}
 function renderHeader(data) {
     const overall = String(data.status || 'unknown').toLowerCase();
     const headline = `# ${data.title} — ${overall.toUpperCase()}`;

package/lib/pipe/testomatio.d.ts

@@ -47,12 +47,13 @@ declare class TestomatioPipe implements Pipe {
     prepareRun(opts: any): Promise<string[]>;
     /**
      * Creates a new run on Testomat.io
-     * @param {{isBatchEnabled?: boolean, kind?: string}} params
+     * @param {{isBatchEnabled?: boolean, kind?: string, configuration?: Record<string, any>}} params
      * @returns Promise<void>
      */
     createRun(params?: {
         isBatchEnabled?: boolean;
         kind?: string;
+        configuration?: Record<string, any>;
     }): Promise<void>;
     runUrl: string;
     runPublicUrl: any;

package/lib/pipe/testomatio.js

@@ -164,7 +164,7 @@ class TestomatioPipe {
     }
     /**
      * Creates a new run on Testomat.io
-     * @param {{isBatchEnabled?: boolean, kind?: string}} params
+     * @param {{isBatchEnabled?: boolean, kind?: string, configuration?: Record<string, any>}} params
      * @returns Promise<void>
      */
     async createRun(params = {}) {
@@ -202,6 +202,14 @@ class TestomatioPipe {
                 suites: coverageConfiguration.suites?.map(id => id.replace(/^S/, '')) || [],
             };
         }
+        // Merge caller-supplied configuration (e.g. { exploratory: true }) into runParams.configuration.
+        // Caller values win on key conflict; coverage-derived tests/suites lists are preserved when not overridden.
+        if (params.configuration && typeof params.configuration === 'object') {
+            configuration = { ...(configuration || {}), ...params.configuration };
+            if (this.store) {
+                this.store.configuration = { ...(this.store.configuration || {}), ...params.configuration };
+            }
+        }
         const runParams = Object.fromEntries(Object.entries({
             ci_build_url: buildUrl,
             api_key: this.apiKey.trim(),

package/lib/template/testomatio.hbs

@@ -163,6 +163,126 @@
             transform: none;
         }
 
+        .description-section {
+            padding: 24px 30px 0;
+            background: var(--gray-50);
+        }
+
+        .description-card {
+            background: white;
+            border: 1px solid var(--gray-200);
+            border-radius: var(--border-radius);
+            padding: 20px 24px;
+            box-shadow: 0 1px 3px rgba(0, 0, 0, 0.06);
+        }
+
+        .description-title {
+            font-size: 16px;
+            font-weight: 600;
+            color: var(--gray-700);
+            margin: 0 0 12px;
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+
+        .description-title i { color: var(--gray-500); }
+
+        .markdown-body { color: var(--gray-700); line-height: 1.55; font-size: 14px; }
+        .markdown-body p { margin: 0 0 10px; }
+        .markdown-body p:last-child { margin-bottom: 0; }
+        .markdown-body h1,
+        .markdown-body h2,
+        .markdown-body h3 {
+            margin: 14px 0 8px;
+            color: var(--gray-800);
+            line-height: 1.3;
+        }
+        .markdown-body h1 { font-size: 20px; }
+        .markdown-body h2 { font-size: 17px; }
+        .markdown-body h3 { font-size: 15px; }
+        .markdown-body ul,
+        .markdown-body ol { margin: 6px 0 10px 22px; padding: 0; }
+        .markdown-body li { margin: 2px 0; }
+        .markdown-body code {
+            background: var(--gray-100);
+            border-radius: 4px;
+            padding: 1px 5px;
+            font-size: 12.5px;
+            font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+        }
+        .markdown-body pre {
+            background: var(--gray-100);
+            border-radius: 6px;
+            padding: 10px 12px;
+            overflow-x: auto;
+            margin: 8px 0;
+        }
+        .markdown-body pre code { background: transparent; padding: 0; }
+        .markdown-body a { color: var(--primary, #2563eb); text-decoration: underline; }
+        .markdown-body blockquote {
+            margin: 8px 0;
+            padding: 4px 12px;
+            border-left: 3px solid var(--gray-300);
+            color: var(--gray-600);
+        }
+
+        .configuration-section {
+            padding: 16px 30px 0;
+            background: var(--gray-50);
+        }
+
+        .configuration-card {
+            background: white;
+            border: 1px solid var(--gray-200);
+            border-radius: var(--border-radius);
+            padding: 20px 24px;
+            box-shadow: 0 1px 3px rgba(0, 0, 0, 0.06);
+        }
+
+        .configuration-title {
+            font-size: 16px;
+            font-weight: 600;
+            color: var(--gray-700);
+            margin: 0 0 12px;
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+
+        .configuration-title i { color: var(--gray-500); }
+
+        .configuration-table {
+            width: 100%;
+            border-collapse: collapse;
+            font-size: 14px;
+        }
+
+        .configuration-table th,
+        .configuration-table td {
+            padding: 6px 12px;
+            text-align: left;
+            border-bottom: 1px solid var(--gray-100);
+        }
+
+        .configuration-table tr:last-child th,
+        .configuration-table tr:last-child td { border-bottom: 0; }
+
+        .configuration-table th {
+            font-weight: 600;
+            color: var(--gray-600);
+            width: 30%;
+            font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+            font-size: 12.5px;
+        }
+
+        .configuration-table td {
+            color: var(--gray-800);
+            font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+            font-size: 12.5px;
+            word-break: break-word;
+        }
+
         .stats-section {
             padding: 30px;
             background: var(--gray-50);
@@ -2078,6 +2198,39 @@
             </div>
         </header>
 
+        {{#if description}}
+            <section class='description-section'>
+                <div class='description-card'>
+                    <h2 class='description-title'>
+                        <i class='fas fa-info-circle'></i>
+                        Description
+                    </h2>
+                    <div class='description-body markdown-body'>{{markdown description}}</div>
+                </div>
+            </section>
+        {{/if}}
+
+        {{#if configuration}}
+            <section class='configuration-section'>
+                <div class='configuration-card'>
+                    <h2 class='configuration-title'>
+                        <i class='fas fa-sliders-h'></i>
+                        Configuration
+                    </h2>
+                    <table class='configuration-table'>
+                        <tbody>
+                            {{#each configuration}}
+                                <tr>
+                                    <th>{{this.key}}</th>
+                                    <td>{{this.value}}</td>
+                                </tr>
+                            {{/each}}
+                        </tbody>
+                    </table>
+                </div>
+            </section>
+        {{/if}}
+
         <section class='stats-section'>
             <div class='stats-grid'>
                 <div class='chart-container'>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testomatio/reporter",
-  "version": "2.7.9-beta.2-markdown",
+  "version": "2.8.0",
   "description": "Testomatio Reporter Client",
   "engines": {
     "node": ">=18"
@@ -36,6 +36,7 @@
     "json-cycle": "^1.3.0",
     "lodash.memoize": "^4.1.2",
     "lodash.merge": "^4.6.2",
+    "marked": "^14.1.4",
     "minimatch": "^10.2.4",
     "picocolors": "^1.0.1",
     "pretty-ms": "^7.0.1",

package/src/client.js

@@ -245,9 +245,10 @@ class Client {
     let { files = [], manuallyAttachedArtifacts, message = '', meta = {} } = testData;
 
     if (stepArtifactPaths.size) {
-      files = files.filter(f => !isStepArtifact(f, stepArtifactPaths));
+      const isStepArtifact = item => stepArtifactPaths.has(typeof item === 'object' ? item?.path : item);
+      files = files.filter(f => !isStepArtifact(f));
       if (Array.isArray(manuallyAttachedArtifacts)) {
-        manuallyAttachedArtifacts = manuallyAttachedArtifacts.filter(a => !isStepArtifact(a, stepArtifactPaths));
+        manuallyAttachedArtifacts = manuallyAttachedArtifacts.filter(a => !isStepArtifact(a));
       }
     }
 
@@ -464,38 +465,24 @@ class Client {
  * referenced by `step.artifacts` at any depth.
  *
  * @param {any} steps
+ * @param {Set<string>} [paths]
  * @returns {Set<string>}
  */
-function collectStepArtifactPaths(steps) {
-  const paths = new Set();
+function collectStepArtifactPaths(steps, paths = new Set()) {
   if (!Array.isArray(steps)) return paths;
-  const walk = arr => {
-    for (const step of arr) {
-      if (!step) continue;
-      if (Array.isArray(step.artifacts)) {
-        for (const a of step.artifacts) {
-          if (typeof a === 'string') paths.add(a);
-          else if (a && typeof a === 'object' && typeof a.path === 'string') paths.add(a.path);
-        }
+  for (const step of steps) {
+    if (!step) continue;
+    if (Array.isArray(step.artifacts)) {
+      for (const a of step.artifacts) {
+        if (typeof a === 'string') paths.add(a);
+        else if (a && typeof a === 'object' && typeof a.path === 'string') paths.add(a.path);
       }
-      if (Array.isArray(step.steps)) walk(step.steps);
     }
-  };
-  walk(steps);
+    collectStepArtifactPaths(step.steps, paths);
+  }
   return paths;
 }
 
-/**
- * @param {string|{path?: string}|null|undefined} item
- * @param {Set<string>} paths
- * @returns {boolean}
- */
-function isStepArtifact(item, paths) {
-  if (!item) return false;
-  const p = typeof item === 'object' ? item.path : item;
-  return typeof p === 'string' && paths.has(p);
-}
-
 /**
  *
  * @param {TestData} testData

package/src/pipe/html.js

@@ -4,6 +4,7 @@ import fs from 'fs';
 import path from 'path';
 import pc from 'picocolors';
 import handlebars from 'handlebars';
+import { marked } from 'marked';
 import fileUrl from 'file-url';
 import { fileSystem, isSameTest, ansiRegExp, formatStep } from '../utils/utils.js';
 import { HTML_REPORT } from '../constants.js';
@@ -27,6 +28,7 @@ class HtmlPipe {
     this.htmlOutputPath = '';
     this.filenameMsg = '';
     this.tests = [];
+    this.configuration = null;
 
     if (this.isHtml) {
       this.isEnabled = true;
@@ -61,8 +63,10 @@ class HtmlPipe {
     }
   }
 
-  async createRun() {
-    // empty
+  async createRun(params = {}) {
+    if (params?.configuration && typeof params.configuration === 'object') {
+      this.configuration = { ...(this.configuration || {}), ...params.configuration };
+    }
   }
 
   async prepareRun() {}
@@ -250,6 +254,10 @@ class HtmlPipe {
       runUrl: this.store.runUrl || '',
       executionTime: testExecutionSumTime(aggregatedTests),
       executionDate: getCurrentDateTimeFormatted(),
+      description: runParams.description || this.store.coverageDescription || this.store.description || '',
+      configuration: buildDisplayConfiguration(
+        this.configuration || this.store.configuration || runParams.configuration || null,
+      ),
       tests: aggregatedTests,
       envVars: collectEnvironmentVariables(),
     };
@@ -304,6 +312,11 @@ class HtmlPipe {
       (tests, status) => tests.filter(test => test.status.toLowerCase() === status.toLowerCase()).length,
     );
 
+    handlebars.registerHelper('markdown', value => {
+      if (typeof value !== 'string' || !value.trim()) return '';
+      return new handlebars.SafeString(marked.parse(value, { async: false }));
+    });
+
     handlebars.registerHelper('formatDuration', milliseconds => {
       if (!milliseconds || milliseconds === 0) return '0ms';
 
@@ -1110,4 +1123,24 @@ function loadTracesFromFiles(test) {
   }
 }
 
+function buildDisplayConfiguration(configuration) {
+  if (!configuration || typeof configuration !== 'object') return null;
+  const entries = Object.entries(configuration).filter(([k]) => k !== 'tests' && k !== 'suites');
+  if (!entries.length) return null;
+  entries.sort((a, b) => a[0].localeCompare(b[0]));
+  return entries.map(([key, value]) => ({ key, value: formatConfigDisplayValue(value) }));
+}
+
+function formatConfigDisplayValue(value) {
+  if (value == null) return '';
+  if (typeof value === 'boolean' || typeof value === 'number' || typeof value === 'string') {
+    return String(value);
+  }
+  try {
+    return JSON.stringify(value);
+  } catch (_) {
+    return String(value);
+  }
+}
+
 export default HtmlPipe;

package/src/pipe/markdown.js

@@ -24,6 +24,7 @@ class MarkdownPipe {
     this.markdownOutputPath = '';
     this.filenameMsg = '';
     this.tests = [];
+    this.configuration = null;
 
     if (!this.isMarkdown) return;
 
@@ -52,8 +53,10 @@ class MarkdownPipe {
     );
   }
 
-  async createRun() {
-    // empty
+  async createRun(params = {}) {
+    if (params?.configuration && typeof params.configuration === 'object') {
+      this.configuration = { ...(this.configuration || {}), ...params.configuration };
+    }
   }
 
   async prepareRun() {}
@@ -131,6 +134,8 @@ class MarkdownPipe {
       isParallel: runParams?.isParallel,
       executionTime: testExecutionSumTime(aggregated),
       executionDate: getCurrentDateTimeFormatted(),
+      description: runParams?.description || this.store.coverageDescription || this.store.description || '',
+      configuration: this.configuration || this.store.configuration || runParams?.configuration || null,
       tests: aggregated,
       stats,
     };
@@ -162,10 +167,44 @@ function renderDocument(data) {
   const sections = [];
   sections.push(renderHeader(data));
   sections.push(renderRunMetadata(data));
+  sections.push(renderDescription(data.description));
+  sections.push(renderConfiguration(data.configuration));
   sections.push(renderTests(data.tests));
   return sections.filter(Boolean).join('\n\n') + '\n';
 }
 
+function renderDescription(description) {
+  if (typeof description !== 'string') return '';
+  const trimmed = description.trim();
+  if (!trimmed) return '';
+  return `## Description\n\n${trimmed}`;
+}
+
+function renderConfiguration(configuration) {
+  if (!configuration || typeof configuration !== 'object') return '';
+  const entries = Object.entries(configuration).filter(([k]) => k !== 'tests' && k !== 'suites');
+  if (!entries.length) return '';
+
+  entries.sort((a, b) => a[0].localeCompare(b[0]));
+
+  const lines = ['## Configuration', '', '| Key | Value |', '| --- | ----- |'];
+  for (const [k, v] of entries) {
+    lines.push(`| \`${k}\` | ${formatConfigValue(v)} |`);
+  }
+  return lines.join('\n');
+}
+
+function formatConfigValue(value) {
+  if (value == null) return '';
+  if (typeof value === 'boolean' || typeof value === 'number') return String(value);
+  if (typeof value === 'string') return mdInline(value).replace(/\|/g, '\\|');
+  try {
+    return `\`${JSON.stringify(value)}\``;
+  } catch (_) {
+    return String(value);
+  }
+}
+
 function renderHeader(data) {
   const overall = String(data.status || 'unknown').toLowerCase();
   const headline = `# ${data.title} — ${overall.toUpperCase()}`;

package/src/pipe/testomatio.js

@@ -194,7 +194,7 @@ class TestomatioPipe {
 
   /**
    * Creates a new run on Testomat.io
-   * @param {{isBatchEnabled?: boolean, kind?: string}} params
+   * @param {{isBatchEnabled?: boolean, kind?: string, configuration?: Record<string, any>}} params
    * @returns Promise<void>
    */
   async createRun(params = {}) {
@@ -236,6 +236,15 @@ class TestomatioPipe {
         suites: coverageConfiguration.suites?.map(id => id.replace(/^S/, '')) || [],
       };
     }
+
+    // Merge caller-supplied configuration (e.g. { exploratory: true }) into runParams.configuration.
+    // Caller values win on key conflict; coverage-derived tests/suites lists are preserved when not overridden.
+    if (params.configuration && typeof params.configuration === 'object') {
+      configuration = { ...(configuration || {}), ...params.configuration };
+      if (this.store) {
+        this.store.configuration = { ...(this.store.configuration || {}), ...params.configuration };
+      }
+    }
     const runParams = Object.fromEntries(
       Object.entries({
         ci_build_url: buildUrl,

package/src/template/testomatio.hbs

@@ -163,6 +163,126 @@
             transform: none;
         }
 
+        .description-section {
+            padding: 24px 30px 0;
+            background: var(--gray-50);
+        }
+
+        .description-card {
+            background: white;
+            border: 1px solid var(--gray-200);
+            border-radius: var(--border-radius);
+            padding: 20px 24px;
+            box-shadow: 0 1px 3px rgba(0, 0, 0, 0.06);
+        }
+
+        .description-title {
+            font-size: 16px;
+            font-weight: 600;
+            color: var(--gray-700);
+            margin: 0 0 12px;
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+
+        .description-title i { color: var(--gray-500); }
+
+        .markdown-body { color: var(--gray-700); line-height: 1.55; font-size: 14px; }
+        .markdown-body p { margin: 0 0 10px; }
+        .markdown-body p:last-child { margin-bottom: 0; }
+        .markdown-body h1,
+        .markdown-body h2,
+        .markdown-body h3 {
+            margin: 14px 0 8px;
+            color: var(--gray-800);
+            line-height: 1.3;
+        }
+        .markdown-body h1 { font-size: 20px; }
+        .markdown-body h2 { font-size: 17px; }
+        .markdown-body h3 { font-size: 15px; }
+        .markdown-body ul,
+        .markdown-body ol { margin: 6px 0 10px 22px; padding: 0; }
+        .markdown-body li { margin: 2px 0; }
+        .markdown-body code {
+            background: var(--gray-100);
+            border-radius: 4px;
+            padding: 1px 5px;
+            font-size: 12.5px;
+            font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+        }
+        .markdown-body pre {
+            background: var(--gray-100);
+            border-radius: 6px;
+            padding: 10px 12px;
+            overflow-x: auto;
+            margin: 8px 0;
+        }
+        .markdown-body pre code { background: transparent; padding: 0; }
+        .markdown-body a { color: var(--primary, #2563eb); text-decoration: underline; }
+        .markdown-body blockquote {
+            margin: 8px 0;
+            padding: 4px 12px;
+            border-left: 3px solid var(--gray-300);
+            color: var(--gray-600);
+        }
+
+        .configuration-section {
+            padding: 16px 30px 0;
+            background: var(--gray-50);
+        }
+
+        .configuration-card {
+            background: white;
+            border: 1px solid var(--gray-200);
+            border-radius: var(--border-radius);
+            padding: 20px 24px;
+            box-shadow: 0 1px 3px rgba(0, 0, 0, 0.06);
+        }
+
+        .configuration-title {
+            font-size: 16px;
+            font-weight: 600;
+            color: var(--gray-700);
+            margin: 0 0 12px;
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+
+        .configuration-title i { color: var(--gray-500); }
+
+        .configuration-table {
+            width: 100%;
+            border-collapse: collapse;
+            font-size: 14px;
+        }
+
+        .configuration-table th,
+        .configuration-table td {
+            padding: 6px 12px;
+            text-align: left;
+            border-bottom: 1px solid var(--gray-100);
+        }
+
+        .configuration-table tr:last-child th,
+        .configuration-table tr:last-child td { border-bottom: 0; }
+
+        .configuration-table th {
+            font-weight: 600;
+            color: var(--gray-600);
+            width: 30%;
+            font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+            font-size: 12.5px;
+        }
+
+        .configuration-table td {
+            color: var(--gray-800);
+            font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+            font-size: 12.5px;
+            word-break: break-word;
+        }
+
         .stats-section {
             padding: 30px;
             background: var(--gray-50);
@@ -2078,6 +2198,39 @@
             </div>
         </header>
 
+        {{#if description}}
+            <section class='description-section'>
+                <div class='description-card'>
+                    <h2 class='description-title'>
+                        <i class='fas fa-info-circle'></i>
+                        Description
+                    </h2>
+                    <div class='description-body markdown-body'>{{markdown description}}</div>
+                </div>
+            </section>
+        {{/if}}
+
+        {{#if configuration}}
+            <section class='configuration-section'>
+                <div class='configuration-card'>
+                    <h2 class='configuration-title'>
+                        <i class='fas fa-sliders-h'></i>
+                        Configuration
+                    </h2>
+                    <table class='configuration-table'>
+                        <tbody>
+                            {{#each configuration}}
+                                <tr>
+                                    <th>{{this.key}}</th>
+                                    <td>{{this.value}}</td>
+                                </tr>
+                            {{/each}}
+                        </tbody>
+                    </table>
+                </div>
+            </section>
+        {{/if}}
+
         <section class='stats-section'>
             <div class='stats-grid'>
                 <div class='chart-container'>