@testomatio/reporter 2.7.9-beta.1-markdown → 2.7.9-beta.3-markdown

package/README.md

@@ -135,6 +135,7 @@ Bring this reporter on CI and never lose test results again!
   - [Gitlab](./docs/pipes/gitlab.md)
   - [CSV](./docs/pipes/csv.md)
   - [HTML report](./docs/pipes/html.md)
+  - [Markdown report](./docs/pipes/markdown.md)
   - [Bitbucket](./docs/pipes/bitbucket.md)
 - 🔗 [Linking Tests](./docs/linking-tests.md)
 - 📓 [JUnit](./docs/junit.md)

package/lib/client.js

@@ -199,6 +199,9 @@ class Client {
          */
         const { rid, error = null, steps: originalSteps, title, suite_title } = testData;
         let steps = originalSteps;
+        // Capture step artifact paths BEFORE uploadStepArtifacts mutates them to URLs,
+        // so we can exclude them from the test-level artifacts list later.
+        const stepArtifactPaths = collectStepArtifactPaths(steps);
         // Upload artifacts from steps
         try {
             await this.uploadStepArtifacts(steps, rid);
@@ -208,8 +211,14 @@ class Client {
         }
         const uploadedFiles = [];
         const stackArtifactsEnabled = (0, utils_js_1.transformEnvVarToBoolean)(process.env.TESTOMATIO_STACK_ARTIFACTS);
-        const { time = 0, example = null, files = [], filesBuffers = [], code = null, file, suite_id, test_id, timestamp, links, manuallyAttachedArtifacts, overwrite, tags, } = testData;
-        let { message = '', meta = {} } = testData;
+        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));
+            if (Array.isArray(manuallyAttachedArtifacts)) {
+                manuallyAttachedArtifacts = manuallyAttachedArtifacts.filter(a => !isStepArtifact(a, stepArtifactPaths));
+            }
+        }
         meta = Object.entries(meta)
             .filter(([, value]) => value !== null && value !== undefined)
             .reduce((acc, [key, value]) => {
@@ -371,6 +380,47 @@ class Client {
     }
 }
 exports.Client = Client;
+/**
+ * Walks the step tree and returns the set of artifact path/url values
+ * referenced by `step.artifacts` at any depth.
+ *
+ * @param {any} steps
+ * @returns {Set<string>}
+ */
+function collectStepArtifactPaths(steps) {
+    const 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);
+                }
+            }
+            if (Array.isArray(step.steps))
+                walk(step.steps);
+        }
+    };
+    walk(steps);
+    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,9 +112,10 @@ 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,
-            envVars: collectEnvironmentVariables(),
         };
         const md = renderDocument(data);
         fs_1.default.writeFileSync(outputPath, md, 'utf-8');
@@ -136,10 +140,46 @@ function renderDocument(data) {
     const sections = [];
     sections.push(renderHeader(data));
     sections.push(renderRunMetadata(data));
-    sections.push(renderEnvSection(data.envVars));
+    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()}`;
@@ -176,36 +216,6 @@ function renderRunMetadata(data) {
     }
     return lines.join('\n');
 }
-function renderEnvSection(envVars) {
-    if (!envVars)
-        return '';
-    const blocks = ['## Environment'];
-    const groups = [
-        { title: 'Testomat.io variables', vars: envVars.testomatio || {} },
-        { title: 'S3 variables', vars: envVars.s3 || {} },
-    ];
-    for (const group of groups) {
-        const entries = Object.entries(group.vars).filter(([, v]) => v && v.isSet);
-        if (!entries.length)
-            continue;
-        entries.sort((a, b) => a[0].localeCompare(b[0]));
-        const lines = [];
-        lines.push('<details>');
-        lines.push(`<summary>${group.title} (${entries.length})</summary>`);
-        lines.push('');
-        lines.push('| Variable | Value |');
-        lines.push('| -------- | ----- |');
-        for (const [name, info] of entries) {
-            lines.push(`| \`${name}\` | ${mdTableCell(String(info.value ?? ''))} |`);
-        }
-        lines.push('');
-        lines.push('</details>');
-        blocks.push(lines.join('\n'));
-    }
-    if (blocks.length === 1)
-        return '';
-    return blocks.join('\n\n');
-}
 function renderTests(tests) {
     if (!Array.isArray(tests) || tests.length === 0) {
         return '## Tests\n\n_No test results recorded._';
@@ -240,22 +250,27 @@ function renderTest(test) {
         displayStatus = 'todo';
     }
     const duration = formatStepDuration(test.run_time);
-    let header = `#### ${mdInline(title)}`;
-    if (duration)
-        header += ` — ${duration}`;
+    const header = `#### ${mdInline(title)}`;
     const lines = [header];
-    const meta = [`- **Status:** ${displayStatus}`];
+    const rows = [['Status', displayStatus]];
     const retries = computeRetries(test);
     if (retries.retryCount > 0) {
-        let retryLine = `- **Retries:** ${retries.retryCount}`;
+        let v = String(retries.retryCount);
         if (retries.flaky)
-            retryLine += ' (flaky)';
-        meta.push(retryLine);
+            v += ' (flaky)';
+        rows.push(['Retries', v]);
+    }
+    if (duration) {
+        rows.push(['Duration', duration]);
     }
     if (typeof test.test_id === 'string' && test.test_id) {
-        meta.push(`- **Test ID:** \`${test.test_id}\``);
+        rows.push(['Test ID', `\`${test.test_id}\``]);
     }
-    lines.push(meta.join('\n'));
+    const metaTable = ['| Key | Value |', '| --- | ----- |'];
+    for (const [k, v] of rows) {
+        metaTable.push(`| ${k} | ${v} |`);
+    }
+    lines.push(metaTable.join('\n'));
     const stepsBlock = renderSteps(test);
     if (stepsBlock)
         lines.push(stepsBlock);
@@ -285,10 +300,27 @@ function renderSteps(test) {
     }
     if (typeof steps === 'string' && steps.trim()) {
         const cleaned = steps.replace((0, utils_js_1.ansiRegExp)(), '').trim();
+        const parts = cleaned
+            .split(/<br\s*\/?>|\r?\n/i)
+            .map(s => s.trim())
+            .filter(Boolean);
+        if (parts.length > 1) {
+            const bullets = parts.map(line => formatStringStepBullet(line)).join('\n');
+            return `**Steps**\n\n${bullets}`;
+        }
         return `**Steps**\n\n${fence(cleaned)}`;
     }
     return '';
 }
+function formatStringStepBullet(line) {
+    const match = line.match(/^(.*?)[\s ]+(\d+)\s*ms\s*$/i);
+    if (match) {
+        const title = mdInline(match[1].trim());
+        const dur = `${match[2]}ms`;
+        return `- ${title} _(${dur})_`;
+    }
+    return `- ${mdInline(line)}`;
+}
 function renderStepTree(steps, depth) {
     const indent = '  '.repeat(depth);
     const lines = [];
@@ -400,7 +432,10 @@ function renderArtifacts(test) {
     }
     if (!items.length)
         return '';
-    const lines = ['**Artifacts**', ''];
+    const lines = [];
+    lines.push('<details>');
+    lines.push(`<summary><strong>Artifacts</strong> (${items.length})</summary>`);
+    lines.push('');
     for (const item of items) {
         if (item.isImage) {
             lines.push(`- ![${mdInline(item.name)}](${item.href})`);
@@ -409,6 +444,8 @@ function renderArtifacts(test) {
             lines.push(`- [${mdInline(item.name)}](${item.href})`);
         }
     }
+    lines.push('');
+    lines.push('</details>');
     return lines.join('\n');
 }
 function normalizeArtifact(raw) {
@@ -507,11 +544,6 @@ function mdInline(text) {
         return '';
     return String(text).replace(/\r?\n/g, ' ').trim();
 }
-function mdTableCell(text) {
-    if (text == null)
-        return '';
-    return String(text).replace(/\|/g, '\\|').replace(/\r?\n/g, '<br>').trim();
-}
 function formatStepDuration(value) {
     if (typeof value !== 'number' || Number.isNaN(value) || value <= 0)
         return '';
@@ -672,27 +704,4 @@ function aggregateTestRetries(tests) {
     });
     return aggregated;
 }
-const SENSITIVE_PATTERNS = [/TOKEN/, /SECRET/, /PASSWORD/, /KEY/, /^TESTOMATIO$/];
-function isSensitiveVarName(name) {
-    return SENSITIVE_PATTERNS.some(re => re.test(name));
-}
-function collectEnvironmentVariables() {
-    const groups = { testomatio: {}, s3: {} };
-    for (const [name, value] of Object.entries(process.env)) {
-        if (value === undefined)
-            continue;
-        let group = null;
-        if (name === 'TESTOMATIO' || name.startsWith('TESTOMATIO_'))
-            group = 'testomatio';
-        else if (name.startsWith('S3_'))
-            group = 's3';
-        if (!group)
-            continue;
-        let displayValue = value;
-        if (isSensitiveVarName(name))
-            displayValue = '***';
-        groups[group][name] = { value: displayValue, isSet: true };
-    }
-    return groups;
-}
 module.exports = MarkdownPipe;

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.1-markdown",
+  "version": "2.7.9-beta.3-markdown",
   "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

@@ -215,6 +215,10 @@ class Client {
     const { rid, error = null, steps: originalSteps, title, suite_title } = testData;
     let steps = originalSteps;
 
+    // Capture step artifact paths BEFORE uploadStepArtifacts mutates them to URLs,
+    // so we can exclude them from the test-level artifacts list later.
+    const stepArtifactPaths = collectStepArtifactPaths(steps);
+
     // Upload artifacts from steps
     try {
       await this.uploadStepArtifacts(steps, rid);
@@ -228,7 +232,6 @@ class Client {
     const {
       time = 0,
       example = null,
-      files = [],
       filesBuffers = [],
       code = null,
       file,
@@ -236,11 +239,17 @@ class Client {
       test_id,
       timestamp,
       links,
-      manuallyAttachedArtifacts,
       overwrite,
       tags,
     } = testData;
-    let { message = '', meta = {} } = testData;
+    let { files = [], manuallyAttachedArtifacts, message = '', meta = {} } = testData;
+
+    if (stepArtifactPaths.size) {
+      files = files.filter(f => !isStepArtifact(f, stepArtifactPaths));
+      if (Array.isArray(manuallyAttachedArtifacts)) {
+        manuallyAttachedArtifacts = manuallyAttachedArtifacts.filter(a => !isStepArtifact(a, stepArtifactPaths));
+      }
+    }
 
     meta = Object.entries(meta)
       .filter(([, value]) => value !== null && value !== undefined)
@@ -450,6 +459,43 @@ class Client {
   }
 }
 
+/**
+ * Walks the step tree and returns the set of artifact path/url values
+ * referenced by `step.artifacts` at any depth.
+ *
+ * @param {any} steps
+ * @returns {Set<string>}
+ */
+function collectStepArtifactPaths(steps) {
+  const 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);
+        }
+      }
+      if (Array.isArray(step.steps)) walk(step.steps);
+    }
+  };
+  walk(steps);
+  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,9 +134,10 @@ 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,
-      envVars: collectEnvironmentVariables(),
     };
 
     const md = renderDocument(data);
@@ -163,11 +167,44 @@ function renderDocument(data) {
   const sections = [];
   sections.push(renderHeader(data));
   sections.push(renderRunMetadata(data));
-  sections.push(renderEnvSection(data.envVars));
+  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()}`;
@@ -211,41 +248,6 @@ function renderRunMetadata(data) {
   return lines.join('\n');
 }
 
-function renderEnvSection(envVars) {
-  if (!envVars) return '';
-
-  const blocks = ['## Environment'];
-
-  const groups = [
-    { title: 'Testomat.io variables', vars: envVars.testomatio || {} },
-    { title: 'S3 variables', vars: envVars.s3 || {} },
-  ];
-
-  for (const group of groups) {
-    const entries = Object.entries(group.vars).filter(([, v]) => v && v.isSet);
-    if (!entries.length) continue;
-
-    entries.sort((a, b) => a[0].localeCompare(b[0]));
-
-    const lines = [];
-    lines.push('<details>');
-    lines.push(`<summary>${group.title} (${entries.length})</summary>`);
-    lines.push('');
-    lines.push('| Variable | Value |');
-    lines.push('| -------- | ----- |');
-    for (const [name, info] of entries) {
-      lines.push(`| \`${name}\` | ${mdTableCell(String(info.value ?? ''))} |`);
-    }
-    lines.push('');
-    lines.push('</details>');
-
-    blocks.push(lines.join('\n'));
-  }
-
-  if (blocks.length === 1) return '';
-  return blocks.join('\n\n');
-}
-
 function renderTests(tests) {
   if (!Array.isArray(tests) || tests.length === 0) {
     return '## Tests\n\n_No test results recorded._';
@@ -286,23 +288,30 @@ function renderTest(test) {
   }
 
   const duration = formatStepDuration(test.run_time);
-  let header = `#### ${mdInline(title)}`;
-  if (duration) header += ` — ${duration}`;
+  const header = `#### ${mdInline(title)}`;
 
   const lines = [header];
 
-  const meta = [`- **Status:** ${displayStatus}`];
+  const rows = [['Status', displayStatus]];
 
   const retries = computeRetries(test);
   if (retries.retryCount > 0) {
-    let retryLine = `- **Retries:** ${retries.retryCount}`;
-    if (retries.flaky) retryLine += ' (flaky)';
-    meta.push(retryLine);
+    let v = String(retries.retryCount);
+    if (retries.flaky) v += ' (flaky)';
+    rows.push(['Retries', v]);
+  }
+  if (duration) {
+    rows.push(['Duration', duration]);
   }
   if (typeof test.test_id === 'string' && test.test_id) {
-    meta.push(`- **Test ID:** \`${test.test_id}\``);
+    rows.push(['Test ID', `\`${test.test_id}\``]);
   }
-  lines.push(meta.join('\n'));
+
+  const metaTable = ['| Key | Value |', '| --- | ----- |'];
+  for (const [k, v] of rows) {
+    metaTable.push(`| ${k} | ${v} |`);
+  }
+  lines.push(metaTable.join('\n'));
 
   const stepsBlock = renderSteps(test);
   if (stepsBlock) lines.push(stepsBlock);
@@ -335,12 +344,32 @@ function renderSteps(test) {
 
   if (typeof steps === 'string' && steps.trim()) {
     const cleaned = steps.replace(ansiRegExp(), '').trim();
+    const parts = cleaned
+      .split(/<br\s*\/?>|\r?\n/i)
+      .map(s => s.trim())
+      .filter(Boolean);
+
+    if (parts.length > 1) {
+      const bullets = parts.map(line => formatStringStepBullet(line)).join('\n');
+      return `**Steps**\n\n${bullets}`;
+    }
+
     return `**Steps**\n\n${fence(cleaned)}`;
   }
 
   return '';
 }
 
+function formatStringStepBullet(line) {
+  const match = line.match(/^(.*?)[\s ]+(\d+)\s*ms\s*$/i);
+  if (match) {
+    const title = mdInline(match[1].trim());
+    const dur = `${match[2]}ms`;
+    return `- ${title} _(${dur})_`;
+  }
+  return `- ${mdInline(line)}`;
+}
+
 function renderStepTree(steps, depth) {
   const indent = '  '.repeat(depth);
   const lines = [];
@@ -445,7 +474,10 @@ function renderArtifacts(test) {
 
   if (!items.length) return '';
 
-  const lines = ['**Artifacts**', ''];
+  const lines = [];
+  lines.push('<details>');
+  lines.push(`<summary><strong>Artifacts</strong> (${items.length})</summary>`);
+  lines.push('');
   for (const item of items) {
     if (item.isImage) {
       lines.push(`- ![${mdInline(item.name)}](${item.href})`);
@@ -453,6 +485,8 @@ function renderArtifacts(test) {
       lines.push(`- [${mdInline(item.name)}](${item.href})`);
     }
   }
+  lines.push('');
+  lines.push('</details>');
   return lines.join('\n');
 }
 
@@ -549,11 +583,6 @@ function mdInline(text) {
   return String(text).replace(/\r?\n/g, ' ').trim();
 }
 
-function mdTableCell(text) {
-  if (text == null) return '';
-  return String(text).replace(/\|/g, '\\|').replace(/\r?\n/g, '<br>').trim();
-}
-
 function formatStepDuration(value) {
   if (typeof value !== 'number' || Number.isNaN(value) || value <= 0) return '';
   if (value < 1000) return `${value}ms`;
@@ -714,30 +743,4 @@ function aggregateTestRetries(tests) {
   return aggregated;
 }
 
-const SENSITIVE_PATTERNS = [/TOKEN/, /SECRET/, /PASSWORD/, /KEY/, /^TESTOMATIO$/];
-
-function isSensitiveVarName(name) {
-  return SENSITIVE_PATTERNS.some(re => re.test(name));
-}
-
-function collectEnvironmentVariables() {
-  const groups = { testomatio: {}, s3: {} };
-
-  for (const [name, value] of Object.entries(process.env)) {
-    if (value === undefined) continue;
-
-    let group = null;
-    if (name === 'TESTOMATIO' || name.startsWith('TESTOMATIO_')) group = 'testomatio';
-    else if (name.startsWith('S3_')) group = 's3';
-    if (!group) continue;
-
-    let displayValue = value;
-    if (isSensitiveVarName(name)) displayValue = '***';
-
-    groups[group][name] = { value: displayValue, isSet: true };
-  }
-
-  return groups;
-}
-
 export default MarkdownPipe;

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'>