@n42/cli 0.2.2 → 0.2.31

package/README.md

@@ -5,19 +5,17 @@ validation**, with support for the Peppol network.
 
 The Node42 CLI is designed for **system integrators, service providers,
 and operators** who need fast, repeatable insight into eDelivery
-routing, SMP resolution, and Access Point behavior.
+routing, SML/SMK, SMP resolution, and Access Point behavior.
 
 ------------------------------------------------------------------------
 
 ## Features
 
 - Peppol eDelivery path discovery
-- SMP and Access Point resolution diagnostics
+- SML/SMK, SMP and AP resolution diagnostics
 - Supported document type detection
-- PlantUML and SVG visualizations
-- Authenticated API access
-- Deterministic, script-friendly output
-- No browser automation or UI side effects
+- Discovery trace + diagram (SVG/PlantUML/MD)
+- Interactive diagrams with clickable links
 - Local artefact history inspection
 
 ## Installation
@@ -56,7 +54,28 @@ Check authentication status:
 n42 me
 ```
 
-------------------------------------------------------------------------
+## Configuration
+
+Configuration and cached data are stored under `~/.node42`
+
+``` bash
+~/.node42/
+├── artefacts
+│   ├── discovery
+│   ├── transactions
+│   └── validations
+├── assets
+├── config.json
+├── db.json
+└── tokens.json
+```
+
+## Help
+
+```bash
+n42 --help
+n42 discover --help
+```
 
 ## Peppol Discovery
 
@@ -116,7 +135,6 @@ Errors are printed with a clickable reference link:
 ## Security
 
 -   TLS verification enabled by default
--   Explicit `--insecure` flag for testing only
 -   Tokens stored locally, never logged
 
 ## License

package/eslint.config.js

@@ -3,6 +3,7 @@ const globals = require("globals");
 module.exports = [
   {
     files: ["src/**/*.js"],
+    ignores: ["src/assets/**"],
     languageOptions: {
       ecmaVersion: "latest",
       sourceType: "commonjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@n42/cli",
-  "version": "0.2.2",
+  "version": "0.2.31",
   "description": "Node42 CLI – Command-line interface for Peppol eDelivery path discovery, diagnostics, and tooling",
   "keywords": [
     "node42"

package/src/assets/node42-logo.svg

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   version="1.1"
+   id="svg2"
+   width="512"
+   height="512"
+   viewBox="0 0 512 512"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <defs
+     id="defs6" />
+  <g
+     id="g8"
+     style="fill:#800000">
+    <path
+       style="fill:#1f2933;stroke-width:0.912989;fill-opacity:1"
+       d="m 250.68278,504.43224 c -6.75028,-0.86235 -10.40179,-2.51239 -26.3886,-11.92466 -7.18686,-4.23127 -22.51642,-13.16255 -34.06573,-19.84729 -17.61184,-10.1937 -90.544282,-52.7204 -115.949676,-67.60997 -4.017154,-2.35436 -11.743692,-6.86653 -17.170137,-10.02703 -16.284811,-9.4848 -23.240148,-18.04125 -25.20828,-31.01095 -1.118138,-7.36878 -1.234179,-204.26795 -0.126175,-214.14802 1.591615,-14.19281 8.942732,-23.64927 26.074433,-33.542 5.521577,-3.18841 16.612757,-9.63032 24.647065,-14.31534 8.034307,-4.685016 16.867478,-9.829712 19.62928,-11.432657 17.1769,-9.969498 73.75066,-42.991708 84.45153,-49.294531 47.47308,-27.961746 51.8264,-30.43697 56.37802,-32.055582 2.13356,-0.7587307 7.16605,-1.6087879 11.18321,-1.8890209 8.43903,-0.5887139 15.57532,1.3129793 24.19422,6.4473399 11.55324,6.882426 111.15984,65.007391 126.44904,73.788753 6.52788,3.749301 15.97732,9.214337 20.99877,12.144522 5.02144,2.930186 15.69117,9.125136 23.71051,13.766556 8.52175,4.9322 16.48887,10.2859 19.17278,12.88365 5.33504,5.16375 9.89879,13.28156 11.34032,20.17152 0.70738,3.3811 1.00748,36.23792 0.99634,109.10225 -0.0173,113.56626 0.0429,112.1513 -5.14415,121.02986 -4.93927,8.45458 -10.50629,12.50751 -43.35365,31.56272 -17.25514,10.00989 -39.58978,22.99615 -49.63267,28.85833 -10.04288,5.86218 -22.16282,12.91081 -26.93319,15.66363 -4.77036,2.75282 -24.69636,14.37995 -44.27999,25.83807 -19.58362,11.45813 -37.80671,21.84456 -40.49573,23.08097 -5.83374,2.6824 -13.25232,3.68189 -20.47754,2.75888 z m 14.85899,-29.89157 c 2.26422,-1.42476 15.20959,-9.0542 28.76748,-16.95432 13.5579,-7.90012 28.1429,-16.42086 32.41113,-18.93499 4.26823,-2.51413 10.4309,-6.11089 13.69484,-7.99281 3.26394,-1.88191 11.89169,-6.91401 19.17279,-11.18242 7.28109,-4.26842 21.24982,-12.40258 31.04164,-18.0759 53.01967,-30.71936 58.89622,-34.32123 60.94205,-37.3528 l 2.05422,-3.04409 -0.0155,-104.63052 -0.0146,-104.63054 -2.03926,-3.52865 c -1.67451,-2.89764 -4.56978,-4.99685 -16.1905,-11.73906 -7.78324,-4.51573 -20.31402,-11.7971 -27.84618,-16.1808 -7.53217,-4.38371 -23.14428,-13.44247 -34.6936,-20.13058 C 361.27694,93.475073 335.39369,78.371241 315.30792,66.599109 295.22215,54.826977 274.54248,42.706959 269.35314,39.665745 257.47369,32.703707 254.7286,32.500567 245.65467,37.91202 c -3.36875,2.008997 -17.01228,9.996331 -30.3191,17.749611 -13.30683,7.75329 -30.3569,17.719374 -37.88907,22.146844 -7.53216,4.427469 -19.44667,11.391863 -26.47669,15.476414 -88.881545,51.641631 -89.2094,51.842921 -90.999955,55.875931 -1.619188,3.6468 -1.681179,8.27351 -1.451745,108.35075 0.23966,104.52557 0.240025,104.54166 2.153377,107.11876 1.073676,1.44611 8.888227,6.62152 17.803296,11.7907 8.739318,5.06728 45.675957,26.59849 82.081407,47.84713 73.96101,43.1686 89.06095,51.89982 91.7382,53.04588 2.93773,1.25756 8.78762,0.0329 13.24729,-2.77337 z m -28.29436,-75.06372 c -7.2811,-3.52372 -17.34681,-8.2419 -22.36825,-10.48486 -10.24337,-4.57547 -13.7466,-7.39987 -15.06505,-12.14599 -0.53337,-1.91984 -0.90422,-20.32266 -0.90724,-45.01664 l -0.009,-41.76926 h -55.28124 c -60.895308,0 -59.490583,0.12764 -61.482452,-5.58644 -1.409747,-4.0439 -1.3861,-60.58499 0.02739,-64.80577 1.678074,-5.01204 4.780869,-8.45119 12.83736,-14.22883 37.757152,-27.07736 65.494042,-46.8543 111.203142,-79.28991 5.77465,-4.09776 16.25122,-11.54944 23.28122,-16.55931 31.1481,-22.197349 31.90278,-22.648895 37.6947,-22.554255 4.14971,0.06783 7.6418,1.108571 17.08468,5.091788 6.52787,2.753613 17.10713,7.203213 23.50947,9.887997 6.40234,2.68479 11.64062,5.17413 11.64062,5.53185 0,0.35772 -2.15695,2.08594 -4.7932,3.84051 -5.48095,3.64782 -50.20301,34.30436 -61.85504,42.40107 -4.26823,2.96588 -18.76276,12.96271 -32.2099,22.2152 -13.44724,9.25249 -35.63289,24.59365 -49.30143,34.09147 -13.66865,9.49782 -26.50218,18.39808 -28.51907,19.77836 -6.05585,4.14437 -6.98975,5.6617 -7.51536,12.21021 l -0.47995,5.97854 h 32.07962 32.07971 l 0.0676,-18.48804 c 0.0375,-10.16842 0.34529,-20.28648 0.68474,-22.48456 l 0.61709,-3.99652 25.44192,-17.23049 c 13.9931,-9.47677 25.59949,-17.23048 25.79195,-17.23048 0.19254,0 0.35003,17.8625 0.35003,39.69445 v 39.69444 l 16.35493,0.24884 16.35502,0.24885 -12.92501,10.04288 c -12.04625,9.36017 -13.14256,10.471 -16.12668,16.34057 l -3.20175,6.29768 -0.25848,62.40478 c -0.14214,34.32263 -0.55298,62.37639 -0.91298,62.3417 -0.35999,-0.0347 -6.61177,-2.94611 -13.89286,-6.46983 z m 33.78061,-83.68734 c 0,-27.3488 0.63005,-31.48088 5.67669,-37.22868 3.31416,-3.77461 1.63736,-2.67278 50.92866,-33.46574 20.83898,-13.01842 39.11767,-24.87028 40.61945,-26.33749 2.45247,-2.39614 2.73121,-3.24747 2.73897,-8.36483 l 0.009,-5.6972 -48.63422,-0.23626 -48.63412,-0.23626 0.24568,-20.306 0.24578,-20.30601 h 71.21318 c 80.74068,0 75.84852,-0.4478 80.42525,7.36184 l 2.30237,3.92877 -0.27928,26.76582 c -0.26541,25.42998 -0.37798,26.94809 -2.25618,30.41778 -2.83922,5.24508 -7.70764,9.47403 -18.10888,15.73043 -5.02143,3.02042 -15.29257,9.35994 -22.82473,14.08782 -7.53216,4.7279 -23.8556,14.94877 -36.27426,22.71308 -12.41867,7.7643 -22.58709,14.42505 -22.59649,14.80165 -0.009,0.37661 23.19568,0.68474 51.56683,0.68474 28.37115,0 51.59541,0.30814 51.60956,0.68475 0.0137,0.3766 -1.29535,9.4152 -2.91006,20.08577 l -2.93571,19.40102 h -76.0636 -76.06352 z"
+       id="path170" />
+  </g>
+</svg>

package/src/assets/wrapper-light.css

@@ -0,0 +1,196 @@
+:root {
+  --bg: transparent;
+  --card: #ffffff;
+  --border: #e5e7eb;
+  --border-soft: #f1f5f9;
+  --border-strong: #d1d5db;
+  --text-light: #9ca3af;
+  --text: #111827;
+  --muted: #6b7280;
+  --brand-soft: #eaf3ff;        /* Soft, light blue */
+  --brand: #3f9cff;             /* Main brand color */
+  --brand-strong: #0b3a82;      /* Strong blue for contrast */
+  --brand-hover: #1e6fd0;       /* Slightly darker hover state */
+  --brand-active: #1666c1;      /* Active state */
+  --brand-button: #1d72d2;      /* Darker shade of the brand color */
+  --shadow-soft: 0 2px 4px rgba(0, 0, 0, 0.04);
+  --shadow-form: 0 3px 8px rgba(0, 0, 0, 0.05);
+}
+
+body { 
+    margin: 0; 
+    height: 100vh;
+    background: #fff;
+    font-family: system-ui, -apple-system, Segoe UI, Roboto, sans-serif;
+    overflow-y: auto; 
+}
+
+#page {
+    min-height: calc(100vh - 56px);
+    display: flex;
+    justify-content: center;
+    padding-top: 32px;
+}
+
+#app-shell {
+    width: 100%;
+    max-width: 1450px;
+    height: 100%;
+    display: flex;
+    flex-direction: column;
+}
+
+#app-header {
+  height: 62px;
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 0 16px;
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  z-index: 100;
+}
+
+.header-left {
+    gap: 16px;
+}
+
+.header-right {
+    gap: 16px;
+}
+
+#appBtn {
+    display: flex;
+    width: 34px;
+    height: 34px;
+    cursor: pointer;
+}
+
+#timeline {
+    flex: 1;
+    overflow-y: auto;
+    padding: 24px 16px 24px 16px;
+    background: var(--bg);
+    min-height: 0; /* for flex scroll containers */
+}
+
+.bubble {
+    position: relative;
+    background: #ffffff;
+    border-radius: 12px;
+    padding: 16px;
+    margin-bottom: 64px;
+    border: 1px solid var(--border);
+}
+.bubble.info {
+    width: 50%;
+}
+
+.bubble svg {
+    width: 100%;
+    height: auto;
+    max-width: 100%;
+    display: block;
+}
+
+.bubble-time {
+    position: absolute;
+    bottom: -24px;
+    left: 10px;
+    font-size: 0.65rem;
+    color: var(--text-light);
+    cursor: pointer;
+}
+
+.bubble-time:hover {
+    color: var(--text);
+}
+
+.bubble-link {
+    position: absolute;
+    bottom: 14px;
+    right: 21px;
+    display: inline-flex;
+    align-items: center;
+    gap: 2px;
+    font-size: 0.7rem;
+    text-decoration: none;
+    color: var(--text-light);
+    cursor: pointer;
+}
+
+.bubble-link svg {
+    width: 24px;
+}
+
+.bubble-link:hover {
+    color: var(--text);
+}
+
+.bubble-close {
+    position: absolute;
+    top: 10px;
+    right: 10px;
+    border: none;
+    background: #f6f6f6;
+    border-radius: 999px;
+    padding: 4px;
+    cursor: pointer;
+    line-height: 1;
+}
+
+.material-icons.bubble-close {
+    font-size: 14px;
+}
+
+.bubble-close:hover {
+    background: #fee2e2;;
+    color: #991b1b;
+}
+
+.bubble-info {
+    display: flex;
+    gap: 8px;
+    align-items: flex-start;
+}
+
+.bubble-info-icon {
+    font-size: 20px;
+    line-height: 1;
+}
+
+.bubble-info-icon.error {
+    color: #ef4444;
+}
+
+.bubble-info-icon.warning {
+    color: #f59e0b;
+}
+
+.bubble-info-icon.info {
+    color: #1f7fe5;
+}
+
+.bubble-info-header {
+    font-weight: 600;
+    margin-bottom: 2px;
+}
+
+.bubble-info-body {
+    font-size: 0.9rem;
+    line-height: 1.3;
+}
+
+.bubble-info-body a {
+    color: var(--text);
+    font-weight: 600;
+    text-decoration: underline;
+}
+
+.bubble-info-body a:hover {
+    color: var(--brand-active);
+    font-weight: 600;
+    text-decoration: none;
+}

package/src/assets/wrapper.html.template

@@ -0,0 +1,33 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <title>Node42</title>
+    <link rel="stylesheet" href="../../assets/wrapper-light.css">
+  </head>
+  <body>
+    <div id="app-header">
+      <div class="header-left">
+        <img id="appBtn" src="../../assets/node42-logo.svg" alt="Node42" onclick="window.open('https://www.node42.dev', '_blank');">
+      </div>
+      <div class="header-right"></div>
+    </div>
+    <div id="page">
+      <div id="app-shell">
+        <div id="timeline"></div>
+          <div id="bubble" class="bubble" data-uuid="/--UUID--/">
+            <!-- SVG -->
+            <div class="bubble-time"><!-- TIME --></div>
+            <a id="link" class="bubble-link" title="Download discovery PlantUML diagram (SVG)">
+              <svg width="24px" height="24px" viewBox="0 0 24 24" fill="none">
+                <path fill-rule="evenodd" clip-rule="evenodd" d="M5 18V13.5862H6.5V16.5H17.5V13.5862H19V18H5Z" fill="currentColor"/>
+                <path fill-rule="evenodd" clip-rule="evenodd" d="M12.75 11.1287L14.5253 9.35331L15.586 10.414L12 14L8.41393 10.414L9.47459 9.35331L11.25 11.1287V6H12.75V11.1287Z" fill="currentColor"/>
+              </svg>Download
+            </a>
+          </div>
+        </div>
+      </div>
+    </div>
+     <script src="../../assets/wrapper.js" defer></script>
+  </body>
+</html>

package/src/assets/wrapper.js

@@ -0,0 +1,48 @@
+function formatSvg() {
+  const bubble = document.getElementById("bubble");
+  const svgEl = bubble.querySelector("svg");
+  
+  if (svgEl) {
+    svgEl.removeAttribute("width");
+    svgEl.removeAttribute("height");
+    svgEl.setAttribute("preserveAspectRatio", "xMidYMid meet");
+    svgEl.style.removeProperty('width');
+    svgEl.style.removeProperty('height');
+
+    const svgTitleEl = svgEl.querySelector("title");
+    if (svgTitleEl) {
+      svgTitleEl.remove();
+    }
+  }
+}
+
+function addDownloadLinkListener() {
+  const bubble = document.getElementById("bubble");
+  const svgEl = bubble.querySelector("svg");
+  const svg = new XMLSerializer().serializeToString(svgEl);
+  const refId = bubble.dataset.uuid;
+
+  const linkEl = document.getElementById("link");
+  linkEl.addEventListener("click", (e) => {
+    e.preventDefault();
+
+    const blob = new Blob([svg], { type: "image/svg+xml" });
+    const url = URL.createObjectURL(blob);
+
+    const a = document.createElement("a");
+    a.href = url;
+    a.id = `discovery-${refId}`; 
+    a.download = `discovery${refId ? "-" + refId : ""}.svg`;
+
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+
+    URL.revokeObjectURL(url);
+  });
+}
+
+document.addEventListener("DOMContentLoaded", () => {
+  formatSvg();
+  addDownloadLinkListener();
+});

package/src/auth.js

@@ -2,15 +2,14 @@ const fs = require("fs");
 const { NODE42_DIR, TOKENS_FILE, API_URL, EP_SIGNIN, EP_REFRESH, EP_ME } = require("./config");
 const { handleError } = require("./errors");
 const { getUserWithIndex } = require("./user");
-const { clearScreen, ask, startSpinner } = require("./utils");
+const { ask, startSpinner } = require("./utils");
 
 const db = require("./db");
-const pkg = require("../package.json");
 const C = require("./colors");
 
 
 async function login() {
-  clearScreen(`Node42 CLI v${pkg.version}\n\n${C.BOLD}Sign in to your account${C.RESET}`);
+  console.log(`${C.BOLD}Sign in to your account${C.RESET}`);
   let user = getUserWithIndex(0);
 
   const username = await ask("Username", user.userMail ?? "");
@@ -65,6 +64,7 @@ function logout() {
     fs.unlinkSync(TOKENS_FILE);
   }
   db.clear("user");
+  console.log(`${C.RED}Sign out complete${C.RESET}\n`);
 }
 
 function loadTokens() {

package/src/cli.js

@@ -4,7 +4,7 @@ const { Command } = require("commander");
 const { login, logout, checkAuth } = require("./auth");
 const { getUserWithIndex, getUserUsage } = require("./user");
 const { runDiscovery } = require("./discover");
-const { clearScreen, startSpinner, validateEnv, validateId, createAppDirs, capitalize, cleanAppDirs } = require("./utils");
+const { startSpinner, validateEnv, validateId, createAppDirs, capitalize, cleanAppDirs } = require("./utils");
 const { NODE42_DIR, ARTEFACTS_DIR, DEFAULT_OUTPUT, DEFAULT_FORMAT } = require("./config");
 
 createAppDirs(); 
@@ -19,7 +19,7 @@ const path = require("path");
 
 program
   .name("n42")
-  .description("Node42 Command-line interface for eDelivery path discovery and diagnostics")
+  .description("Node42 CLI for eDelivery path discovery and diagnostics")
   .version(pkg.version);
 
 program
@@ -65,7 +65,7 @@ program
 
 program
   .command("me")
-  .description("Returns identity and billing status for the authenticated user.")
+  .description("Returns identity and service usage for the authenticated user.")
   .action(async () => {
     const stopSpinner = startSpinner();
     
@@ -73,13 +73,12 @@ program
     stopSpinner();
 
     if (!authenticated) {
-      console.error("Not authenticated");
       process.exit(1);
     }
     
     const user = getUserWithIndex(0);
     const currentMonth = new Date().toISOString().slice(0, 7);
-    console.log(`Node42 CLI v${pkg.version}
+    console.log(`Node42 Account (CLI v${pkg.version})
     ${C.BOLD}User${C.RESET}
       ID           : ${C.CYAN}${user.id}${C.RESET}
       Name         : ${user.userName}
@@ -100,7 +99,7 @@ program
 
 program
   .command("usage <service>")
-  .description("Returns usage for the authenticated user.")
+  .description("Returns service usage for the authenticated user.")
   .option("-m, --month <yyyy-mm>", "Show usage for a specific month")
   .action((service, options) => {
     const user = getUserWithIndex(0);
@@ -110,14 +109,13 @@ program
       usage = 0;
     }
 
-    clearScreen(`Node42 CLI v${pkg.version}\n`);
     console.log(`${C.BOLD}${capitalize(service)} usage${C.RESET}`);
     console.log(` • ${currentMonth}: ${C.RED}${usage}${C.RESET}\n`);
   });
 
 program
   .command("history [participantId]")
-  .description("Show local discovery history for a participant")
+  .description("Show local history with filtering")
   .option("--today", "Show only today's artefacts")
   .option("--day <yyyy-mm-dd>", "Show artefacts for a specific day")
   .option("--last <n>", "Show only last N results", parseInt)
@@ -156,14 +154,12 @@ program
     }
 
     if (!artefacts.length) {
-      clearScreen(`Node42 CLI v${pkg.version}\n`);
       const filter = dayFilter !== null ? ` (${dayFilter})` : ``;
       console.log(`${C.RED}No artefacts found.${C.RESET}${C.DIM}${filter}${C.RESET}\n`);
       return;
     }
 
     // ---- OUTPUT ----
-    clearScreen(`Node42 CLI v${pkg.version}\n`);
     console.log(`${C.BOLD}Found ${artefacts.length} artefact(s)${filterInfo}${C.RESET}\n`);
 
     const DATE = "DATE".padEnd(19);
@@ -176,7 +172,13 @@ program
       const iso = d.toISOString();           // 2026-01-30T16:53:28.123Z
       const date = iso.slice(0, 10);         // 2026-01-30
       const time = iso.slice(11, 19);        // 16:53:28
-      const file = path.join(ARTEFACTS_DIR, `${item.file}`);
+     
+      let file;
+      if (item.file.includes(".svg")) {
+        file = path.join(ARTEFACTS_DIR, `${item.file.replace(".svg", ".html")}`);
+      } else {
+        file = path.join(ARTEFACTS_DIR, `${item.file}`);
+      }
       const link = `\u001B]8;;file://${file}\u0007Open\u001B]8;;\u0007`
 
       let pid = item.participantId;
@@ -208,8 +210,6 @@ discover
   .option("--reverse-lookup", "Enable reverse lookup", false)
   .option("--probe-endpoints", "Probe resolved endpoints", false)
   .action((participantId, options) => {
-    clearScreen(`Node42 CLI v${pkg.version}`);
-    
     try { validateEnv(options.env); }
     catch (e) { 
       console.error(e.message);

package/src/discover.js

@@ -1,13 +1,12 @@
 const fs = require("fs");
 const path = require("path");
-const pkg = require("../package.json");
 const db = require("./db");
 const C = require("./colors");
 
 const { fetchWithAuth } = require("./auth");
-const { API_URL, EP_DISCOVER, DEFAULT_OUTPUT, DEFAULT_FORMAT, ARTEFACTS_DIR } = require("./config");
+const { API_URL, EP_DISCOVER, DEFAULT_OUTPUT, DEFAULT_FORMAT, NODE42_DIR, ARTEFACTS_DIR } = require("./config");
 const { getUserWithIndex, setUserUsage } = require("./user");
-const { clearScreen, startSpinner, buildDocLabel, promptForDocument, getShortId, getArtefactExt } = require("./utils");
+const { startSpinner, buildDocLabel, promptForDocument, getShortId, getArtefactExt } = require("./utils");
 const { handleError } = require("./errors"); 
 
 const DEFAULT_DISCOVERY_INPUT = {
@@ -35,6 +34,27 @@ const DEFAULT_DISCOVERY_INPUT = {
 const discoveryInput = DEFAULT_DISCOVERY_INPUT;
 let docSelected = false;
 
+function wrapSvg(fileId, refId, svg) {
+  let html;
+
+  const now = new Date();
+  const timeText = now.toLocaleTimeString([], {
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+
+  const templateFile = path.join(NODE42_DIR, "assets/wrapper.html.template");
+  const template = fs.readFileSync(templateFile, "utf8");
+  
+  html = template.replace("<!-- SVG -->", svg);
+  html = html.replace("<!-- TIME -->", `${timeText}  •  ${refId}`);
+  html = html.replace("/--UUID--/", fileId);
+  
+  const htmlFile = path.join(ARTEFACTS_DIR, `${fileId}.html`);
+  fs.writeFileSync(htmlFile, html);
+  return htmlFile;
+}
+
 async function processSupportedDocuments(encodedDocs, onDone) {
   if (encodedDocs && !docSelected) {
       const docs = JSON.parse(Buffer.from(encodedDocs, "base64").toString("utf8"))
@@ -88,7 +108,6 @@ async function runDiscovery(participantId, options) {
     }
   };
 
-  clearScreen(`Node42 CLI v${pkg.version}\n`);
   const stopSpinner = startSpinner();
 
   const url = `${API_URL}/${EP_DISCOVER}?output=${output}&format=${format}`;
@@ -153,7 +172,8 @@ async function runDiscovery(participantId, options) {
     const file = path.join(ARTEFACTS_DIR, `${fileName}`);
     fs.writeFileSync(file, svg);
 
-    const link = `\u001B]8;;file://${file}\u0007Open\u001B]8;;\u0007`;
+    const htmlFile = wrapSvg(fileId, refId, svg);
+    const link = `\u001B]8;;file://${htmlFile}\u0007Open\u001B]8;;\u0007`;
 
     console.log(`${C.BOLD}Discovery completed${C.RESET}`);
     console.log(`PID      : ${participantId}`);

package/src/utils.js

@@ -1,16 +1,24 @@
-const fs = require("fs");
+
 const inquirer = require("inquirer");
 const readline = require("readline");
+
+const fs = require("fs");
+const path = require("path");
+
 const config = require("./config");
 const pkg = require("../package.json");
 const db = require("./db");
 const C = require("./colors");
 
 
-function clearScreen(text) {
-  process.stdout.write("\x1Bc");
-  if (text) {
+function writeHeader(text, clearScreen=false) {
+  if (clearScreen) {
+    process.stdout.write("\x1Bc");
+  }
+  if (text && text.length > 0) {
     process.stdout.write(text + "\n");
+  } else {
+     process.stdout.write(`Node42 CLI v${pkg.version}`);
   }
 }
 
@@ -115,6 +123,10 @@ function createAppDirs(force=false) {
   fs.mkdirSync(config.TRANSACTIONS_DIR, { recursive: true });
   fs.mkdirSync(config.VALIDATIONS_DIR, { recursive: true });
 
+  const wrapperSrc = path.join(__dirname, "assets");
+  const wrapperDest = path.join(config.NODE42_DIR, "assets");
+  fs.cpSync(wrapperSrc, wrapperDest, { recursive: true });
+
   if (!fs.existsSync(config.CONFIG_FILE) || force) {
     fs.writeFileSync(
       config.CONFIG_FILE,
@@ -141,8 +153,6 @@ function cleanAppDirs(options) {
     return;
   }
 
-  clearScreen(`Node42 CLI v${pkg.version}\n`);
-
   const removed = [];
 
   if ((all || tokens) && fs.existsSync(config.TOKENS_FILE)) {
@@ -252,4 +262,4 @@ function getArtefactExt(output, format) {
   }
 }
 
-module.exports = { clearScreen, startSpinner, ask, buildDocLabel, promptForDocument, validateEnv, validateId, getShortId, capitalize, createAppDirs, cleanAppDirs, getArtefactExt };
+module.exports = { writeHeader, startSpinner, ask, buildDocLabel, promptForDocument, validateEnv, validateId, getShortId, capitalize, createAppDirs, cleanAppDirs, getArtefactExt };

package/test/auth.test.js

@@ -30,7 +30,7 @@ describe("auth", () => {
       utils = require("../src/utils");
       user = require("../src/user");
       
-      sinon.stub(utils, "clearScreen");
+      //sinon.stub(utils, "writeHeader");
       sinon.stub(utils, "ask")
         .onFirstCall().resolves("user")
         .onSecondCall().resolves("secret");