@nestia/benchmark 14.0.0 → 14.0.2

package/lib/DynamicBenchmarker.js

@@ -47,9 +47,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DynamicBenchmarker = void 0;
 const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
 const tgrid_1 = require("tgrid");
 const tstl_1 = require("tstl");
 const DynamicBenchmarkReporter_1 = require("./internal/DynamicBenchmarkReporter");
+const DynamicBenchmarkStatistics_1 = require("./internal/DynamicBenchmarkStatistics");
 /**
  * Dynamic benchmark executor running prefixed functions.
  *
@@ -75,12 +78,46 @@ const DynamicBenchmarkReporter_1 = require("./internal/DynamicBenchmarkReporter"
  * Additionally, if you hope to see some utilization cases, see the below
  * example tagged links.
  *
+ * Processing cost: Totals are split across T servants once; E events are
+ * aggregated with hash-based endpoint grouping. Progress notifications update
+ * the aggregate from one servant counter delta in constant time. Event
+ * statistics and rendering traverse their input populations; discovery visits
+ * each real directory once.
+ *
+ * Computation reuse: A master distributes distinct request budgets rather than
+ * replaying one effectful request. Endpoint grouping shares one event
+ * population across whole-run and endpoint statistics. Results are not cached
+ * across benchmark runs because server state and timing change.
+ *
+ * Resource ownership: Each master owns at most threads connectors and
+ * simultaneous function workers; connector closure is attempted on
+ * connection/execution success or failure; a rejected close is suppressed and
+ * may leave an unreleased child process. Events retained by servants/master
+ * scale with logged events, and memory samples with run duration. The
+ * independent sampler detaches its report target on stop or rejection and
+ * clears/wakes its owned timer. A pending caller memory getter has no
+ * cancellation hook, but its task retains only the sampler state/getter and
+ * cannot keep the master report arrays, connectors or event collections through
+ * that state. Its eventual result is discarded after deactivation. Returned
+ * reports transfer their arrays to callers.
+ *
+ * Platform boundary: WorkerConnector process mode owns Node child-process
+ * launch/IPC and its explicit stdio modes. Feature discovery resolves the
+ * caller location with native path and fs realpath/stat, follows directory
+ * links with realpath cycle detection and imports discovered native absolute
+ * paths. It does not infer filesystem case policy from OS names.
+ *
  * @author Jeongho Nam - https://github.com/samchon
  * @example
  *   https://github.com/samchon/nestia-start/blob/master/test/benchmaark/index.ts
  *
  * @example
  *   https://github.com/samchon/backend/blob/master/test/benchmark/index.ts
+ *
+ * @evidence contracts/common.md#principled-implementation The master spawns one child process per thread through tgrid's process-mode `WorkerConnector`, drives each servant over RPC, and merges the returned events; totals are split by floor plus remainder so the shares sum to the requested count and simultaneous budget.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace is the public surface (master, servant, markdown, props, report); execution, discovery, and cleanup helpers stay private, and statistics and rendering live in their own internal namespaces.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Nothing names a server, feature, or file: the feature extension, prefix, and filter are caller inputs, and the servant path is a property rather than an assumed location.
+ * @evidence contracts/common.md#meaningful-documentation The namespace prose explains the two-program model, what each program does, and how to obtain markdown, with links to the member documentation and to example repositories.
  */
 var DynamicBenchmarker;
 (function (DynamicBenchmarker) {
@@ -92,55 +129,106 @@ var DynamicBenchmarker;
      * Note that, {@link IMasterProps.servant} property must be the path of the
      * servant program executing the {@link servant} function.
      *
+     * The servants are child processes. When a servant fails to connect or to
+     * execute, every servant receives a close attempt before the returned promise
+     * rejects.
+     *
+     * Processing cost: Totals are split across T servants once; E events are
+     * aggregated with hash-based endpoint grouping. Progress notifications update
+     * the aggregate from one servant counter delta in constant time. Event
+     * statistics and rendering traverse their input populations; discovery visits
+     * each real directory once.
+     *
+     * Computation reuse: A master distributes distinct request budgets rather
+     * than replaying one effectful request. Endpoint grouping shares one event
+     * population across whole-run and endpoint statistics. Results are not cached
+     * across benchmark runs because server state and timing change.
+     *
+     * Resource ownership: Each master owns at most threads connectors and
+     * simultaneous function workers; connector closure is attempted on
+     * connection/execution success or failure; a rejected close is suppressed and
+     * may leave an unreleased child process. Events retained by servants/master
+     * scale with logged events, and memory samples with run duration. The
+     * independent sampler detaches its report target on stop or rejection and
+     * clears/wakes its owned timer. A pending caller memory getter has no
+     * cancellation hook, but its task retains only the sampler state/getter and
+     * cannot keep the master report arrays, connectors or event collections
+     * through that state. Its eventual result is discarded after deactivation.
+     * Returned reports transfer their arrays to callers.
+     *
+     * Platform boundary: WorkerConnector process mode owns Node child-process
+     * launch/IPC and its explicit stdio modes. Feature discovery resolves the
+     * caller location with native path and fs realpath/stat, follows directory
+     * links with realpath cycle detection and imports discovered native absolute
+     * paths. It does not infer filesystem case policy from OS names.
+     *
      * @param props Properties of the master program
      * @returns Benchmark report
+     * @evidence contracts/common.md#principled-implementation Inputs are validated as safe integers before any process starts; totals are distributed by floor plus remainder; servants execute concurrently and every event is grouped by method and path template in a hash map; closing is attempted for every spawned servant on success and on failure, and the memory sampler is deactivated when the run ends, detaching its report array and clearing/waking its owned timer immediately; a pending caller getter may settle later but cannot append.
+     * @evidence contracts/common.md#clear-and-simple-design One function owns the run and keeps the sequence readable: validate, spawn, sample, execute, close, aggregate; statistics come from `DynamicBenchmarkStatistics` and the closing helper is shared by the failure and success paths.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts A servant that fails to close cannot alter a finished report and is not allowed to hide the run's own error, so closing failures are dropped on purpose; no other error is swallowed except a rejecting memory getter, which ends sampling as documented.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the master does, that the servant property must name the servant program, that servants are child processes, and that every servant receives a close attempt before a failure rejects.
      */
     DynamicBenchmarker.master = (props) => __awaiter(this, void 0, void 0, function* () {
-        var _a;
+        var _a, _b;
         if (!Number.isSafeInteger(props.count) || props.count < 0)
             throw new Error("DynamicBenchmarker.master(): count must be a non-negative integer.");
         if (!Number.isSafeInteger(props.threads) || props.threads <= 0)
             throw new Error("DynamicBenchmarker.master(): threads must be a positive integer.");
         if (!Number.isSafeInteger(props.simultaneous) || props.simultaneous <= 0)
             throw new Error("DynamicBenchmarker.master(): simultaneous must be a positive integer.");
+        if (props.simultaneous < props.threads)
+            throw new Error(`DynamicBenchmarker.master(): simultaneous (${props.simultaneous}) must not be less than threads (${props.threads}), as each servant runs at least one request at a time.`);
         const completes = new Array(props.threads).fill(0);
-        const counts = new Array(props.threads)
+        let completed = 0;
+        // the first `total % threads` servants take one more than the rest, so the
+        // shares sum to the total
+        const distribute = (total) => new Array(props.threads)
             .fill(0)
-            .map((_, index) => Math.floor(props.count / props.threads) +
-            (index < props.count % props.threads ? 1 : 0));
-        const servants = yield Promise.all(new Array(props.threads).fill(null).map((_, i) => __awaiter(this, void 0, void 0, function* () {
+            .map((_, index) => Math.floor(total / props.threads) +
+            (index < total % props.threads ? 1 : 0));
+        const counts = distribute(props.count);
+        const budgets = distribute(props.simultaneous);
+        // every servant is a child process, so each connector created must be
+        // closed on every path out of this function, including a failed connection
+        // of a sibling
+        const spawned = [];
+        const settled = yield Promise.allSettled(new Array(props.threads).fill(null).map((_, i) => __awaiter(this, void 0, void 0, function* () {
             var _a;
             const connector = new tgrid_1.WorkerConnector(null, {
                 filter: (_a = props.filter) !== null && _a !== void 0 ? _a : (() => true),
                 progress: (current) => {
+                    completed += current - completes[i];
                     completes[i] = current;
                     if (props.progress)
-                        props.progress(completes.reduce((a, b) => a + b, 0));
+                        props.progress(completed);
                 },
             }, "process");
+            spawned.push(connector);
             yield connector.connect(props.servant, { stdio: props.stdio });
-            return connector;
         })));
+        const refused = settled.find((result) => result.status === "rejected");
+        if (refused !== undefined) {
+            yield closeAll(spawned);
+            throw refused.reason;
+        }
+        const servants = spawned;
         const started_at = new Date();
         const memories = [];
-        let completed_at = null;
-        (() => __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            const getter = (_a = props.memory) !== null && _a !== void 0 ? _a : (() => __awaiter(this, void 0, void 0, function* () { return process.memoryUsage(); }));
-            while (completed_at === null) {
-                yield (0, tstl_1.sleep_for)(1000);
-                memories.push({
-                    usage: yield getter(),
-                    time: new Date().toISOString(),
-                });
-            }
-        }))().catch(() => { });
-        const events = (yield Promise.all(servants.map((connector, index) => connector.getDriver().execute({
-            count: counts[index],
-            simultaneous: Math.ceil(props.simultaneous / props.threads),
-        })))).flat();
-        completed_at = new Date();
-        yield Promise.all(servants.map((connector) => connector.close()));
+        let completed_at;
+        let events;
+        const stopSampling = startMemorySampler((_a = props.memory) !== null && _a !== void 0 ? _a : (() => __awaiter(this, void 0, void 0, function* () { return process.memoryUsage(); })), memories);
+        try {
+            events = (yield Promise.all(servants.map((connector, index) => connector.getDriver().execute({
+                count: counts[index],
+                simultaneous: budgets[index],
+            })))).flat();
+            completed_at = new Date();
+        }
+        finally {
+            stopSampling();
+            yield closeAll(servants);
+        }
         if (props.progress)
             props.progress(props.count);
         const endpoints = new tstl_1.HashMap((key) => (0, tstl_1.hash)(key.method, key.path), (x, y) => x.method === y.method && x.path === y.path);
@@ -148,15 +236,15 @@ var DynamicBenchmarker;
             endpoints
                 .take({
                 method: e.metadata.method,
-                path: (_a = e.metadata.template) !== null && _a !== void 0 ? _a : e.metadata.path,
+                path: (_b = e.metadata.template) !== null && _b !== void 0 ? _b : e.metadata.path,
             }, () => [])
                 .push(e);
         return {
             count: props.count,
             threads: props.threads,
             simultaneous: props.simultaneous,
-            statistics: statistics(events),
-            endpoints: [...endpoints].map((it) => (Object.assign(Object.assign({}, statistics(it.second)), it.first))),
+            statistics: DynamicBenchmarkStatistics_1.DynamicBenchmarkStatistics.of(events),
+            endpoints: [...endpoints].map((it) => (Object.assign(Object.assign({}, DynamicBenchmarkStatistics_1.DynamicBenchmarkStatistics.of(it.second)), it.first))),
             started_at: started_at.toISOString(),
             completed_at: completed_at.toISOString(),
             memories,
@@ -167,8 +255,33 @@ var DynamicBenchmarker;
      *
      * Creates a servant program executing the prefixed functions in parallel.
      *
+     * Processing cost: Each execute request discovers matching modules once, then
+     * runs at most simultaneous loop workers and count invocations. Event storage
+     * grows with actual logger calls rather than an assumed one event per
+     * invocation.
+     *
+     * Computation reuse: Discovery is refreshed for each execute request because
+     * the supplied filter and filesystem can change; requests themselves are
+     * effectful and cannot reuse earlier observations.
+     *
+     * Resource ownership: The returned WorkerServer transfers connection
+     * lifecycle to its caller. Each execute owns its discovery collections,
+     * workers and event arrays until it completes; the master closes its servant
+     * process. No discovered-module cache is retained by this namespace beyond
+     * Node own loader.
+     *
+     * Platform boundary: WorkerConnector process mode owns Node child-process
+     * launch/IPC and its explicit stdio modes. Feature discovery resolves the
+     * caller location with native path and fs realpath/stat, follows directory
+     * links with realpath cycle detection and imports discovered native absolute
+     * paths. It does not infer filesystem case policy from OS names.
+     *
      * @param props Properties of the servant program
      * @returns Servant program as a worker server
+     * @evidence contracts/common.md#principled-implementation A servant opens a `WorkerServer` that exposes one `execute` operation; the master decides counts and budgets, so the servant only needs the location and naming rules to find functions.
+     * @evidence contracts/common.md#clear-and-simple-design A thin adapter over the worker server whose behavior lives in the private `execute` and `iterate` helpers.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Discovery is driven by the caller's location, extension, and prefix, and by the master's filter; no file or function name is assumed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states that it creates the servant program and returns it as a worker server.
      */
     DynamicBenchmarker.servant = (props) => __awaiter(this, void 0, void 0, function* () {
         const server = new tgrid_1.WorkerServer();
@@ -183,19 +296,36 @@ var DynamicBenchmarker;
     /**
      * Convert the benchmark report to markdown content.
      *
+     * Processing cost: Rendering delegates to the reporter and scales with report
+     * endpoints, samples and output bytes; host metadata is obtained through Node
+     * os APIs.
+     *
+     * Platform boundary: The wrapper obtains host information through Node os
+     * APIs and passes those facts to the pure renderer without constructing
+     * native file paths or shell commands.
+     *
      * @param report Benchmark report
      * @returns Markdown content
+     * @evidence contracts/common.md#principled-implementation Rendering is a pure function of the report and a few host facts, delegated to the reporter so the report type and its presentation stay separate.
+     * @evidence contracts/common.md#clear-and-simple-design The wrapper captures three native host facts and delegates rendering, giving users one entry point without exposing the internal reporter.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The function observes native host facts and formats the report without altering its measurements.
+     * @evidence contracts/common.md#meaningful-documentation The comment states input and output: a report in, markdown content out.
      */
-    DynamicBenchmarker.markdown = (report) => DynamicBenchmarkReporter_1.DynamicBenchmarkReporter.markdown(report);
+    DynamicBenchmarker.markdown = (report) => { var _a; return DynamicBenchmarkReporter_1.DynamicBenchmarkReporter.markdown(report, {
+        cpu: (_a = os_1.default.cpus()[0]) === null || _a === void 0 ? void 0 : _a.model,
+        memory: os_1.default.totalmem(),
+        node: process.version,
+    }); };
     const execute = (ctx) => (mass) => __awaiter(this, void 0, void 0, function* () {
         const functions = [];
         yield iterate({
             collection: functions,
             driver: ctx.driver,
             props: ctx.props,
-        })(ctx.props.location);
+        })(path_1.default.resolve(ctx.props.location));
         const entireEvents = [];
         let scheduled = 0;
+        let completed = 0;
         yield Promise.all(new Array(mass.simultaneous)
             .fill(null)
             .map(() => 1)
@@ -225,29 +355,84 @@ var DynamicBenchmarker;
                     for (const e of localEvents)
                         e.success = false;
                 }
-                if (localEvents.length !== 0)
-                    ctx.driver.progress(entireEvents.length).catch(() => { });
+                ctx.driver.progress(++completed).catch(() => { });
             }
         })));
-        yield ctx.driver.progress(entireEvents.length);
+        yield ctx.driver.progress(completed);
         return entireEvents;
     });
 })(DynamicBenchmarker || (exports.DynamicBenchmarker = DynamicBenchmarker = {}));
-const iterate = (ctx) => (path) => __awaiter(void 0, void 0, void 0, function* () {
+/**
+ * Keeps the sampler's pending caller task separate from the master's report,
+ * connectors and events. Stopping detaches the report array immediately;
+ * cancellation of a caller-owned getter remains its caller's responsibility.
+ */
+const startMemorySampler = (getter, memories) => {
+    const state = {
+        active: true,
+        target: memories,
+    };
+    sampleMemory(getter, state).catch(() => { });
+    return () => stopMemorySampler(state);
+};
+const stopMemorySampler = (state) => {
+    state.active = false;
+    state.target = null;
+    if (state.timer !== undefined)
+        clearTimeout(state.timer);
+    state.timer = undefined;
+    const wake = state.wake;
+    state.wake = undefined;
+    wake === null || wake === void 0 ? void 0 : wake();
+};
+const sampleMemory = (getter, state) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        while (state.active) {
+            yield new Promise((resolve) => {
+                state.wake = resolve;
+                state.timer = setTimeout(() => {
+                    state.timer = undefined;
+                    state.wake = undefined;
+                    resolve();
+                }, 1000);
+            });
+            if (!state.active)
+                return;
+            const usage = yield getter();
+            if (!state.active)
+                return;
+            state.target.push({ usage, time: new Date().toISOString() });
+        }
+    }
+    finally {
+        stopMemorySampler(state);
+    }
+});
+// A servant that fails to close cannot change a finished report, and must not
+// hide the error that ended the run, so a failed close is dropped.
+const closeAll = (servants) => __awaiter(void 0, void 0, void 0, function* () {
+    yield Promise.allSettled(servants.map((connector) => connector.close()));
+});
+const iterate = (ctx) => (path_2, ...args_1) => __awaiter(void 0, [path_2, ...args_1], void 0, function* (path, visited = new Set()) {
     var _a;
+    const identity = yield fs_1.default.promises.realpath(path);
+    if (visited.has(identity))
+        return;
+    visited.add(identity);
     const directory = yield fs_1.default.promises.readdir(path);
     for (const file of directory) {
         const location = `${path}/${file}`;
         const stat = yield fs_1.default.promises.stat(location);
         if (stat.isDirectory() === true)
-            yield iterate(ctx)(location);
+            yield iterate(ctx)(location, visited);
         // Load feature files whose extension matches `props.extension`. This is
         // configurable instead of inferred from the servant's own module
         // extension, because the benchmark library may be built (`.js`) while the
         // feature files it drives are run from source (`.ts`, e.g. under `ttsx`);
         // inferring would look for `.js` features that do not exist, load
         // nothing, and spin forever.
-        else if (file.endsWith(`.${(_a = ctx.props.extension) !== null && _a !== void 0 ? _a : "js"}`) &&
+        else if (stat.isFile() &&
+            file.endsWith(`.${(_a = ctx.props.extension) !== null && _a !== void 0 ? _a : "js"}`) &&
             file.endsWith(".d.ts") === false) {
             // GATE BY FILE NAME (PREFIX & FILTER), SO THAT EXCLUDED FILES ARE
             // NEVER IMPORTED.
@@ -269,32 +454,4 @@ const iterate = (ctx) => (path) => __awaiter(void 0, void 0, void 0, function* (
         }
     }
 });
-const statistics = (events) => {
-    const successes = events.filter((event) => event.success);
-    return Object.assign({ count: events.length, success: successes.length }, average(events));
-};
-const average = (events) => {
-    if (events.length === 0)
-        return {
-            mean: null,
-            stdev: null,
-            minimum: null,
-            maximum: null,
-        };
-    let mean = 0;
-    let stdev = 0;
-    let minimum = Number.MAX_SAFE_INTEGER;
-    let maximum = Number.MIN_SAFE_INTEGER;
-    for (const event of events) {
-        const elapsed = new Date(event.completed_at).getTime() -
-            new Date(event.started_at).getTime();
-        mean += elapsed;
-        stdev += elapsed * elapsed;
-        minimum = Math.min(minimum, elapsed);
-        maximum = Math.max(maximum, elapsed);
-    }
-    mean /= events.length;
-    stdev = Math.sqrt(stdev / events.length - mean * mean);
-    return { mean, stdev, minimum, maximum };
-};
 //# sourceMappingURL=DynamicBenchmarker.js.map

package/lib/DynamicBenchmarker.js.map

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

package/lib/IBenchmarkEvent.d.ts

@@ -1,9 +1,28 @@
 import { IFetchRoute } from "@nestia/fetcher";
+/**
+ * One benchmarked request as the servant observed it.
+ *
+ * `metadata` is the fetch route, `status` is the HTTP status or `null` when
+ * there was no response, and the three timestamps are ISO 8601 strings, with
+ * `respond_at` `null` when no response arrived. `success` is `false` for every
+ * request made by a benchmark function that threw.
+ *
+ * @evidence contracts/common.md#principled-implementation The event mirrors the fetcher's log event with timestamps in ISO strings, so it can cross the process boundary as plain data.
+ * @evidence contracts/common.md#clear-and-simple-design A flat record shared by the servant, the master, and the report code.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Route, status and times come from the fetcher's event; success records whether the enclosing benchmark function threw, independent of HTTP status.
+ * @evidence contracts/common.md#meaningful-documentation The comment states each optional state and the meaning of success.
+ */
 export interface IBenchmarkEvent {
+    /** Fetch route, including its concrete path and optional grouping template. */
     metadata: IFetchRoute<any>;
+    /** HTTP status, or null when the request received no response. */
     status: number | null;
+    /** ISO 8601 time when the request started. */
     started_at: string;
+    /** ISO 8601 response time, or null when no response arrived. */
     respond_at: string | null;
+    /** ISO 8601 time when the request completed or failed. */
     completed_at: string;
+    /** Whether the enclosing benchmark function completed without throwing. */
     success: boolean;
 }

package/lib/internal/DynamicBenchmarkReporter.d.ts

@@ -1,4 +1,53 @@
 import { DynamicBenchmarker } from "../DynamicBenchmarker";
+/**
+ * Renders a benchmark report as markdown.
+ *
+ * @evidence contracts/common.md#principled-implementation The reporter formats one report into fixed sections (specifications, arguments, time, statistics, memory chart, endpoints, failures) using a fixed locale.
+ * @evidence contracts/common.md#clear-and-simple-design A one-function namespace, internal to the package, that keeps presentation out of the benchmark logic.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The content is computed from the report and host facts; no numbers are hardcoded.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its single job.
+ */
 export declare namespace DynamicBenchmarkReporter {
-    const markdown: (report: DynamicBenchmarker.IReport) => string;
+    /**
+     * Host facts captured by the caller when a report is rendered.
+     *
+     * An absent CPU model means the platform exposed no CPU information. Memory
+     * remains in bytes until rendering, and the Node version is displayed
+     * verbatim.
+     *
+     * Platform boundary: Missing CPU data is represented explicitly rather than
+     * inferred from an operating-system name; memory and version retain Node's
+     * native units and spelling.
+     *
+     * @evidence contracts/common.md#principled-implementation CPU absence, memory bytes and the runtime version represent the three facts displayed by the renderer without depending on a platform-specific provider.
+     * @evidence contracts/common.md#clear-and-simple-design One record separates host observation from report formatting; each member supplies one displayed fact.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The record describes native facts supplied by the actual public caller and introduces no fixture-specific behavior.
+     * @evidence contracts/common.md#meaningful-documentation Member comments explain absence, units and display semantics.
+     */
+    interface IHost {
+        /** First CPU model, or undefined when the platform reports no CPU. */
+        cpu: string | undefined;
+        /** Total host memory in bytes. */
+        memory: number;
+        /** Node runtime version as reported by process.version. */
+        node: string;
+    }
+    /**
+     * Renders the report as markdown.
+     *
+     * Numbers use the fixed `en-US` locale, so a report reads the same on every
+     * machine. Decimals are truncated, not rounded, to two places. The CPU model
+     * is `unknown` when the platform exposes no CPU information.
+     *
+     * Processing cost: Endpoint and failure ordering require comparison sorts,
+     * costing O(E log E); four memory series each scan M samples, and temporary
+     * rows and final text scale with displayed data. Sorting copies preserve the
+     * caller's endpoint order.
+     *
+     * @evidence contracts/common.md#principled-implementation Each table row is built from the same statistics record; `Math.trunc` on the value scaled by 100 truncates toward zero to two decimals, including negative elapsed values after a wall-clock adjustment. `en-US` fixes separators, and an absent CPU model is displayed as `unknown`.
+     * @evidence contracts/common.md#clear-and-simple-design Small local helpers (`integer`, `format`, `row`, `line`) share the formatting rules inside one function, so one place decides how a number reads.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The report states only the report's measurements and supplied host facts; nothing describes an unmeasured backend server or changes foreign runtime methods.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the locale, the truncation, and the CPU fallback.
+     */
+    const markdown: (report: DynamicBenchmarker.IReport, host: IHost) => string;
 }