@glubean/runner 0.7.0 → 0.8.0

package/dist/load/subprocess.js

@@ -0,0 +1,229 @@
+/**
+ * Subprocess load execution — spawn the runner's `load-harness` in a child
+ * process so the harness (which calls `runLoad`) and the user `.load.ts` file
+ * CO-RESOLVE the same `@glubean/sdk`, mirroring how `glubean run` spawns the
+ * project-local test harness.
+ *
+ * Why a subprocess at all: running `runLoad` in-process against a user file that
+ * resolves a DIFFERENT `@glubean/sdk` instance (a globally-installed CLI vs. a
+ * project with its own, non-deduped sdk) split-brains the SDK runtime carrier —
+ * the scenario reads one AsyncLocalStorage carrier while `runLoad` installs
+ * another. Spawning the project-local runner via tsx makes both halves resolve
+ * the project's sdk, eliminating the hazard.
+ *
+ * This module owns the PARENT side (`runLoadFileInSubprocess`) plus the small
+ * pure helpers the child `load-harness` shares (`collectLoadPlans`,
+ * `withProcessEnvFallback`) and the wire-message contract between them
+ * (`WIRE_PREFIX` / `LoadHarnessMessage`) — kept here as a single source of truth
+ * so producer and consumer can't drift.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { resolveRunnerRoot, resolveTsxPath, prepareZeroProject } from "../runner-resolve.js";
+// ── Shared wire contract (child stdout → parent) ─────────────────────────────
+/**
+ * Marker prefixed to every harness protocol line on stdout. The user's load file
+ * + plugins share stdout, whose `console.log` may itself print JSON; gating on
+ * this token stops a stray `{"type":"error",...}` log from spoofing an outcome or
+ * a failure. It leads with the ASCII Unit Separator (0x1F) — a control byte that
+ * ordinary text logs never emit — so collision is negligible. Lines without it
+ * are forwarded to the parent's stdout as ordinary user output.
+ *
+ * (stdout, not a dedicated fd: tsx re-spawns an inner node process and forwards
+ * only fd 0/1/2, so an extra protocol fd wouldn't reach the harness.)
+ */
+export const WIRE_PREFIX = "\x1fglubean-load-wire\x1f";
+// ── Shared pure helpers (used by load-harness in the child) ──────────────────
+/** A LoadPlan-shaped export: the runnable marker the orchestrator consumes. */
+function isLoadPlan(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value.__glubean_type === "load-runner");
+}
+/**
+ * Collect every LoadPlan exported by a module namespace (flattening `.each()`
+ * arrays of plans).
+ */
+export function collectLoadPlans(ns) {
+    const plans = [];
+    for (const value of Object.values(ns)) {
+        if (isLoadPlan(value)) {
+            plans.push(value);
+        }
+        else if (Array.isArray(value)) {
+            for (const v of value)
+                if (isLoadPlan(v))
+                    plans.push(v);
+        }
+    }
+    return plans;
+}
+/**
+ * Wrap an env map so a missing key falls back to `process.env` — the same
+ * shell/CI env semantics the test harness gives `ctx.vars` / `ctx.secrets`, so
+ * `BASE_URL=... glubean load ...` resolves even without a `.env` entry.
+ *
+ * Applied INSIDE the child (which inherits the parent's `process.env`): the
+ * parent ships the raw resolved `{ vars, secrets }` over stdin — a Proxy can't
+ * survive JSON serialization, so the fallback must be re-established where
+ * `process.env` is actually present. Spreading the proxy (for `ctx.vars.all()`)
+ * still yields only the explicit map's own keys, not the whole environment.
+ */
+export function withProcessEnvFallback(map) {
+    // Parity with the test harness's env proxy: an empty/nullish map value is
+    // treated as MISSING and falls back to process.env (so `BASE_URL=` in .env plus
+    // `BASE_URL=... glubean load` resolves), and process.env empties read as unset.
+    return new Proxy(map, {
+        get(target, prop) {
+            if (typeof prop === "string") {
+                const value = target[prop];
+                if (value !== undefined && value !== null && value !== "")
+                    return value;
+                return process.env[prop] || undefined;
+            }
+            return Reflect.get(target, prop);
+        },
+        has(target, prop) {
+            return Reflect.has(target, prop) || (typeof prop === "string" && process.env[prop] !== undefined);
+        },
+    });
+}
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// This module builds to dist/load/subprocess.js; load-harness.js and the runner
+// package root sit two and three levels up respectively.
+const BUNDLED_DIST_DIR = resolve(__dirname, "..");
+const BUNDLED_PKG_ROOT = resolve(__dirname, "..", "..");
+/** Parse one prefixed protocol line into a wire message, or null if malformed. */
+function parseHarnessLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return null; // partial / malformed protocol line — ignore
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return null;
+    const msg = parsed;
+    if (msg.type === "artifact" && typeof msg.runnerId === "string" && msg.artifact && typeof msg.artifact === "object") {
+        return { type: "artifact", runnerId: msg.runnerId, artifact: msg.artifact };
+    }
+    if (msg.type === "error" && typeof msg.message === "string") {
+        return { type: "error", message: msg.message };
+    }
+    if (msg.type === "done")
+        return { type: "done" };
+    return null;
+}
+/**
+ * Run one `.load.ts` file's plans in a child process and collect their
+ * artifacts. Spawns `load-harness.js` (project-local when the project ships a
+ * built runner with it, else the CLI's bundled copy) through tsx so the harness
+ * and the user file resolve the same `@glubean/sdk`. The raw `{ vars, secrets }`
+ * are written to the child's stdin; the child applies the process.env fallback.
+ *
+ * Mirrors the in-process contract: a file's import failure or a plan's run
+ * failure becomes an `errors[]` entry (never throws), so other files/plans still
+ * produce results.
+ */
+export async function runLoadFileInSubprocess(file, opts) {
+    const { vars, secrets, cwd } = opts;
+    // Resolve the runner the same way `glubean run` does (dual-package hazard fix).
+    const resolved = resolveRunnerRoot(cwd, BUNDLED_DIST_DIR, BUNDLED_PKG_ROOT);
+    let distDir = resolved.distDir;
+    let pkgRoot = resolved.pkgRoot;
+    let harnessPath = resolve(distDir, "load-harness.js");
+    if (!existsSync(harnessPath)) {
+        // The resolved runner predates load support (has harness.js but no
+        // load-harness.js). Fall back to the bundled harness so load still runs.
+        // (Re-introduces the in-process split-brain only when the project ALSO ships
+        // its own non-deduped sdk against a too-old runner — no worse than before,
+        // and the common up-to-date case is fully correct. Upgrading the project's
+        // @glubean/runner restores shared module identity.)
+        distDir = BUNDLED_DIST_DIR;
+        pkgRoot = BUNDLED_PKG_ROOT;
+        harnessPath = resolve(BUNDLED_DIST_DIR, "load-harness.js");
+    }
+    const zp = prepareZeroProject(cwd, distDir, pkgRoot);
+    try {
+        const env = { ...process.env, ...zp.env };
+        const child = spawn("node", [resolveTsxPath(), ...zp.tsxArgs, harnessPath, `--file=${file}`], {
+            cwd,
+            env,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        child.stdin.write(JSON.stringify({ vars, secrets }));
+        child.stdin.end();
+        const outcomes = [];
+        const errors = [];
+        let stdoutBuffer = "";
+        let sawDone = false;
+        const stderrChunks = [];
+        const consumeLine = (line) => {
+            if (!line.startsWith(WIRE_PREFIX)) {
+                // Ordinary user/plugin output — forward it so nothing is swallowed.
+                if (line.length > 0)
+                    process.stdout.write(line + "\n");
+                return;
+            }
+            const msg = parseHarnessLine(line.slice(WIRE_PREFIX.length));
+            if (!msg)
+                return;
+            if (msg.type === "artifact")
+                outcomes.push({ runnerId: msg.runnerId, artifact: msg.artifact });
+            else if (msg.type === "error")
+                errors.push({ message: msg.message });
+            else
+                sawDone = true; // terminal sentinel: the harness finished cleanly
+        };
+        child.stdout.on("data", (chunk) => {
+            stdoutBuffer += chunk.toString();
+            const lines = stdoutBuffer.split("\n");
+            stdoutBuffer = lines.pop() ?? "";
+            for (const line of lines)
+                consumeLine(line);
+        });
+        // Forward child stderr LIVE so user/plugin diagnostics (console.error) stay
+        // visible as they did in-process, and keep a copy for the crash message.
+        child.stderr.on("data", (chunk) => {
+            stderrChunks.push(chunk);
+            process.stderr.write(chunk);
+        });
+        await new Promise((resolveClose) => {
+            child.on("error", (err) => {
+                errors.push({
+                    message: err.code === "ENOENT"
+                        ? "NODE_NOT_FOUND: Node.js is not installed. Glubean requires Node.js 20+ to run load plans."
+                        : `failed to start load subprocess for ${file}: ${err.message}`,
+                });
+                resolveClose();
+            });
+            child.on("close", (code, signal) => {
+                if (stdoutBuffer)
+                    consumeLine(stdoutBuffer);
+                // No `done` sentinel ⇒ the child died before finishing (crash / OOM /
+                // SIGKILL), even if it already emitted some artifacts. Surface a crash
+                // error so a PARTIAL run is never mistaken for a complete one. (A clean
+                // import-failure path still emits `done`, so it never lands here.)
+                if (!sawDone) {
+                    const stderr = Buffer.concat(stderrChunks).toString().trim();
+                    const how = signal ? `signal ${signal}` : `exit code ${code}`;
+                    errors.push({
+                        message: `load subprocess for ${file} did not complete (${how})${stderr ? `:\n${stderr}` : ""}`,
+                    });
+                }
+                resolveClose();
+            });
+        });
+        return { outcomes, errors };
+    }
+    finally {
+        zp.cleanup();
+    }
+}
+//# sourceMappingURL=subprocess.js.map

package/dist/load/subprocess.js.map

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

package/dist/load/threshold.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Structured threshold parsing + evaluation (M4-a).
+ *
+ * A `loadRunner({ thresholds })` config carries human expressions per scope/metric
+ * (`errorRate: "<1%"`, `p95: "<800ms"`, `throughputPerSec: ">100/s"`). This module
+ * parses those expressions, evaluates them against a finalized `LoadArtifact`, and
+ * produces the `ThresholdEvaluation[]` + a refined pass verdict (a crash-free run
+ * only passes if every configured-and-evaluable threshold holds).
+ *
+ * Evaluation runs OUTSIDE the reducer (which never sees the plan's thresholds) as a
+ * post-finalize step in the orchestrator. Scopes whose data isn't present yet
+ * (primary / endToEnd / continuation phase splits — M5/M6) and metrics N/A to a
+ * scope (e.g. throughput on a step) are skipped rather than failed.
+ */
+import type { LoadArtifact, LoadThresholds, ThresholdEvaluation } from "@glubean/sdk/load";
+type Op = "<" | "<=" | ">" | ">=";
+/** Metrics a threshold can target (the keys of `LoadThresholdScope`). */
+declare const THRESHOLD_METRICS: readonly ["errorRate", "p50", "p90", "p95", "p99", "throughputPerSec", "backlog", "backpressureMs"];
+type ThresholdMetric = (typeof THRESHOLD_METRICS)[number];
+/** A parsed threshold: comparison operator + the value in the metric's base unit. */
+export interface ParsedThreshold {
+    op: Op;
+    /** Value in the metric's base unit: errorRate=fraction, latency/backpressure=ms,
+     *  throughput=/s, backlog=count. */
+    value: number;
+}
+/**
+ * Parse one threshold expression for a given metric, normalizing its value to the
+ * metric's base unit (`%`→fraction, `s`→ms, etc.). Throws on a malformed
+ * expression or a unit that doesn't fit the metric.
+ */
+export declare function parseThresholdExpression(expr: string, metric: ThresholdMetric): ParsedThreshold;
+/**
+ * Evaluate every configured threshold against the artifact, returning the
+ * `ThresholdEvaluation[]` and the refined run pass (crash-free AND every evaluable
+ * threshold holds). Thresholds whose scope data is absent or whose metric is N/A
+ * to the scope are skipped (not failed).
+ */
+export declare function evaluateThresholds(artifact: LoadArtifact, thresholds: LoadThresholds): {
+    thresholds: ThresholdEvaluation[];
+    pass: boolean;
+};
+export {};
+//# sourceMappingURL=threshold.d.ts.map

package/dist/load/threshold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threshold.d.ts","sourceRoot":"","sources":["../../src/load/threshold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EACV,YAAY,EAEZ,cAAc,EACd,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,EAAE,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;AAElC,yEAAyE;AACzE,QAAA,MAAM,iBAAiB,qGASb,CAAC;AACX,KAAK,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,EAAE,CAAC;IACP;wCACoC;IACpC,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,eAAe,CAqC/F;AA+FD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,cAAc,GACzB;IAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAgFtD"}

package/dist/load/threshold.js

@@ -0,0 +1,197 @@
+/** Metrics a threshold can target (the keys of `LoadThresholdScope`). */
+const THRESHOLD_METRICS = [
+    "errorRate",
+    "p50",
+    "p90",
+    "p95",
+    "p99",
+    "throughputPerSec",
+    "backlog",
+    "backpressureMs",
+];
+const EXPR_RE = /^(<=|>=|<|>)\s*(-?[0-9.]+)\s*(%|ms|s|\/s)?$/;
+/**
+ * Parse one threshold expression for a given metric, normalizing its value to the
+ * metric's base unit (`%`→fraction, `s`→ms, etc.). Throws on a malformed
+ * expression or a unit that doesn't fit the metric.
+ */
+export function parseThresholdExpression(expr, metric) {
+    const m = EXPR_RE.exec(expr.trim());
+    if (!m) {
+        throw new Error(`invalid threshold expression ${JSON.stringify(expr)} — expected e.g. "<1%", "<800ms", ">100/s"`);
+    }
+    const op = m[1];
+    const num = Number(m[2]);
+    const unit = m[3];
+    if (!Number.isFinite(num))
+        throw new Error(`invalid threshold number in ${JSON.stringify(expr)}`);
+    const badUnit = () => {
+        throw new Error(`threshold unit "${unit}" is not valid for metric "${metric}" (in ${JSON.stringify(expr)})`);
+    };
+    let value;
+    switch (metric) {
+        case "errorRate":
+            // A bare number is already a fraction (0..1); "%" scales a percentage down.
+            value = unit === "%" ? num / 100 : unit === undefined ? num : badUnit();
+            break;
+        case "p50":
+        case "p90":
+        case "p95":
+        case "p99":
+        case "backpressureMs":
+            value = unit === "s" ? num * 1000 : unit === "ms" || unit === undefined ? num : badUnit();
+            break;
+        case "throughputPerSec":
+            value = unit === "/s" || unit === undefined ? num : badUnit();
+            break;
+        case "backlog":
+            value = unit === undefined ? num : badUnit();
+            break;
+    }
+    return { op, value };
+}
+function compare(actual, op, value) {
+    switch (op) {
+        case "<":
+            return actual < value;
+        case "<=":
+            return actual <= value;
+        case ">":
+            return actual > value;
+        case ">=":
+            return actual >= value;
+    }
+}
+/**
+ * Combine an endpoint's / step's per-phase rows (M5 splits a route or step hit in
+ * both phases into two rows) into ONE scope for thresholding:
+ *  - throughput is ADDITIVE → summed (60/s primary + 60/s continuation = 120/s);
+ *  - errorRate is weighted by each row's denominator (Σ rate·weight / Σ weight), so
+ *    it stays request-based for endpoints and invocation-based for steps;
+ *  - percentiles can't be merged from summaries, so each is the MAX across rows —
+ *    exact for the usual `<` upper-bound threshold (every row under X ⟺ max under X
+ *    ⟹ the merged distribution is under X), conservative otherwise.
+ * A single row (the no-split common case) combines to its own values unchanged.
+ */
+function combineRows(rows) {
+    let errorWeighted = 0;
+    let errorWeight = 0;
+    let throughput = 0;
+    let hasThroughput = false;
+    const latency = { p50: 0, p90: 0, p95: 0, p99: 0 };
+    for (const r of rows) {
+        errorWeighted += r.errorRate * r.errorWeight;
+        errorWeight += r.errorWeight;
+        if (r.throughputPerSec !== undefined) {
+            throughput += r.throughputPerSec;
+            hasThroughput = true;
+        }
+        latency.p50 = Math.max(latency.p50, r.latency.p50);
+        latency.p90 = Math.max(latency.p90, r.latency.p90);
+        latency.p95 = Math.max(latency.p95, r.latency.p95);
+        latency.p99 = Math.max(latency.p99, r.latency.p99);
+    }
+    return {
+        errorRate: errorWeight > 0 ? errorWeighted / errorWeight : 0,
+        ...(hasThroughput ? { throughputPerSec: throughput } : {}),
+        latency,
+    };
+}
+/** Pull the actual value for `metric` from a scope's data, or undefined if N/A. */
+function actualFor(metric, data) {
+    switch (metric) {
+        case "errorRate":
+            return data.errorRate;
+        case "p50":
+            return data.latency?.p50;
+        case "p90":
+            return data.latency?.p90;
+        case "p95":
+            return data.latency?.p95;
+        case "p99":
+            return data.latency?.p99;
+        case "throughputPerSec":
+            return data.throughputPerSec;
+        case "backlog":
+            return data.backlog;
+        case "backpressureMs":
+            return data.backpressureMs;
+    }
+}
+/**
+ * Evaluate every configured threshold against the artifact, returning the
+ * `ThresholdEvaluation[]` and the refined run pass (crash-free AND every evaluable
+ * threshold holds). Thresholds whose scope data is absent or whose metric is N/A
+ * to the scope are skipped (not failed).
+ */
+export function evaluateThresholds(artifact, thresholds) {
+    const out = [];
+    const evalScope = (scope, target, data, cfg) => {
+        if (!data || !cfg)
+            return;
+        for (const metric of THRESHOLD_METRICS) {
+            const expr = cfg[metric];
+            if (expr === undefined)
+                continue;
+            const actual = actualFor(metric, data);
+            if (actual === undefined)
+                continue; // metric not applicable to this scope
+            const { op, value } = parseThresholdExpression(expr, metric);
+            out.push({
+                scope,
+                ...(target !== undefined ? { target } : {}),
+                metric,
+                expression: expr,
+                actual,
+                pass: compare(actual, op, value),
+                source: "glubean",
+            });
+        }
+    };
+    const s = artifact.summary;
+    evalScope("transaction", undefined, { errorRate: s.errorRate, latency: s.latency, throughputPerSec: s.throughputPerSec }, thresholds.transaction);
+    evalScope("primary", undefined, s.primary, thresholds.primary);
+    evalScope("endToEnd", undefined, s.endToEnd, thresholds.endToEnd);
+    // The continuation summary needs numeric projection: `backpressureMs` is a
+    // percentile distribution (compare against p95), and the threshold-relevant
+    // backlog is the PEAK (`maxBacklog`), not the drained-to-0 live count.
+    const continuationData = s.continuation
+        ? { backlog: s.continuation.maxBacklog, backpressureMs: s.continuation.backpressureMs?.p95 ?? 0 }
+        : undefined;
+    evalScope("continuation", undefined, continuationData, thresholds.continuation);
+    // Endpoints / steps can split into per-phase rows (M5: a route or step hit in
+    // both the primary and continuation phase appears twice). Combine the matching
+    // rows into one scope so additive metrics (throughput) sum and a slow phase still
+    // shows up (latency = max) — picking one row (e.g. `find`) would let a slow
+    // continuation hide behind a fast primary. No matching row → skipped, not failed.
+    if (thresholds.endpoints) {
+        for (const [routeKey, cfg] of Object.entries(thresholds.endpoints)) {
+            const eps = artifact.endpoints.filter((e) => e.routeKey === routeKey);
+            // Endpoint error rate is over REQUESTS.
+            const rows = eps.map((e) => ({
+                errorRate: e.errorRate,
+                errorWeight: e.requestCount,
+                throughputPerSec: e.throughputPerSec,
+                latency: e.latency,
+            }));
+            evalScope("endpoint", routeKey, rows.length > 0 ? combineRows(rows) : undefined, cfg);
+        }
+    }
+    if (thresholds.steps) {
+        for (const [stepId, cfg] of Object.entries(thresholds.steps)) {
+            const sts = artifact.steps.filter((x) => x.stepId === stepId);
+            // Step error rate is over EXECUTED invocations (skipped ones aren't failures);
+            // steps have no throughput metric.
+            const rows = sts.map((s) => ({
+                errorRate: s.errorRate,
+                errorWeight: Math.max(0, s.invocationCount - s.skippedCount),
+                latency: s.latency,
+            }));
+            evalScope("step", stepId, rows.length > 0 ? combineRows(rows) : undefined, cfg);
+        }
+    }
+    // A crash already fails the run; otherwise every evaluable threshold must hold.
+    const pass = s.pass && out.every((e) => e.pass);
+    return { thresholds: out, pass };
+}
+//# sourceMappingURL=threshold.js.map

package/dist/load/threshold.js.map

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

package/dist/load/timeline.d.ts

@@ -0,0 +1,36 @@
+import type { LoadTimeline as LoadTimelineArtifact } from "@glubean/sdk/load";
+export declare class LoadTimeline {
+    private readonly baseWindowMs;
+    private readonly maxWindows;
+    private windowMs;
+    private windows;
+    /** @param baseWindowMs initial window width (ms). @param maxWindows coarsening cap. */
+    constructor(baseWindowMs?: number, maxWindows?: number);
+    /** The window index covering `offsetMs` (ms from run start), coarsening first if the
+     *  index would exceed the cap (so the series stays ≤ maxWindows). */
+    private indexFor;
+    /** The LAST window covered by a run of length `runEndMs` (the run spans [0, runEndMs)), or
+     *  -1 for a non-positive length. A run ending exactly on a boundary (runEndMs = k·windowMs)
+     *  covers windows 0..k-1, NOT a window that starts at the run end (codex). Coarsens so the
+     *  index fits the cap. */
+    private runEndIndex;
+    /** The window covering `offsetMs`, creating it if absent. */
+    private windowFor;
+    /** Double the window width and merge each adjacent pair (2k, 2k+1 → k). All folds are
+     *  commutative (sum / max / histogram merge), so Map iteration order is irrelevant. */
+    private coarsen;
+    /** Record one request observation at `offsetMs`. `inFlight` is the live iteration count
+     *  at that moment — sampled so a window busy with requests (e.g. a poll) shows concurrency. */
+    recordRequest(offsetMs: number, durationMs: number, ok: boolean, inFlight: number): void;
+    /** Record one started iteration at `offsetMs`. `inFlight` is the live count just after the
+     *  start (its local peak), sampled so even a same-window start+end shows its concurrency. */
+    recordIterationStart(offsetMs: number, inFlight: number): void;
+    /** Record one completed iteration (iteration:end) at `offsetMs`. */
+    recordIterationEnd(offsetMs: number): void;
+    /** Emit the dense series: every window from 0..last, idle windows zero-filled. `runEndMs`
+     *  (the run's `load:end` offset) extends the series to the actual run end, so a trailing
+     *  idle / sustained-in-flight period after the last recorded event (an abort, drain timeout,
+     *  or hung iteration) is still present instead of being truncated (codex). */
+    finalize(runEndMs?: number): LoadTimelineArtifact;
+}
+//# sourceMappingURL=timeline.d.ts.map

package/dist/load/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/load/timeline.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,IAAI,oBAAoB,EAAmC,MAAM,mBAAmB,CAAC;AAoB/G,qBAAa,YAAY;IAQrB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR7B,OAAO,CAAC,QAAQ,CAAS;IAGzB,OAAO,CAAC,OAAO,CAA6B;IAE5C,uFAAuF;gBAEpE,YAAY,SAAM,EAClB,UAAU,SAAM;IAKnC;yEACqE;IACrE,OAAO,CAAC,QAAQ;IAShB;;;8BAG0B;IAC1B,OAAO,CAAC,WAAW;IAMnB,6DAA6D;IAC7D,OAAO,CAAC,SAAS;IAUjB;2FACuF;IACvF,OAAO,CAAC,OAAO;IAoBf;mGAC+F;IAC/F,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQxF;iGAC6F;IAC7F,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM9D,oEAAoE;IACpE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI1C;;;kFAG8E;IAC9E,QAAQ,CAAC,QAAQ,SAAI,GAAG,oBAAoB;CA2C7C"}