@glubean/runner 0.5.0 → 0.8.0

package/dist/load/timeline.js

@@ -0,0 +1,158 @@
+/**
+ * Streaming over-time series for the load reducer.
+ *
+ * Buckets the run into fixed-width windows (from run start) so a consumer can draw the
+ * classic load curves: RPS, error-rate, latency percentiles, and concurrency vs time.
+ * Memory is bounded: windows start at `baseWindowMs` and, once they would exceed
+ * `maxWindows`, the width is DOUBLED and adjacent windows merged pairwise — so an
+ * arbitrarily long run keeps at most `maxWindows` windows. Each window keeps a bounded
+ * `LoadHistogram` for its latency percentiles (mergeable, so coarsening folds cleanly).
+ */
+import { LoadHistogram } from "./histogram.js";
+const ZERO_PCT = { p50: 0, p90: 0, p95: 0, p99: 0, max: 0 };
+function newWindow() {
+    return { requests: 0, errors: 0, latency: new LoadHistogram(), starts: 0, iterations: 0, peakSample: 0 };
+}
+export class LoadTimeline {
+    baseWindowMs;
+    maxWindows;
+    windowMs;
+    // Sparse: only windows with activity exist; finalize() fills the gaps with zeros so the
+    // emitted series is dense (a contiguous x-axis).
+    windows = new Map();
+    /** @param baseWindowMs initial window width (ms). @param maxWindows coarsening cap. */
+    constructor(baseWindowMs = 250, maxWindows = 600) {
+        this.baseWindowMs = baseWindowMs;
+        this.maxWindows = maxWindows;
+        this.windowMs = baseWindowMs;
+    }
+    /** The window index covering `offsetMs` (ms from run start), coarsening first if the
+     *  index would exceed the cap (so the series stays ≤ maxWindows). */
+    indexFor(offsetMs) {
+        let idx = Math.floor(Math.max(0, offsetMs) / this.windowMs);
+        while (idx >= this.maxWindows) {
+            this.coarsen();
+            idx = Math.floor(Math.max(0, offsetMs) / this.windowMs);
+        }
+        return idx;
+    }
+    /** 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. */
+    runEndIndex(runEndMs) {
+        if (runEndMs <= 0)
+            return -1;
+        while (Math.ceil(runEndMs / this.windowMs) - 1 >= this.maxWindows)
+            this.coarsen();
+        return Math.ceil(runEndMs / this.windowMs) - 1;
+    }
+    /** The window covering `offsetMs`, creating it if absent. */
+    windowFor(offsetMs) {
+        const idx = this.indexFor(offsetMs);
+        let w = this.windows.get(idx);
+        if (w === undefined) {
+            w = newWindow();
+            this.windows.set(idx, w);
+        }
+        return w;
+    }
+    /** 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. */
+    coarsen() {
+        const next = new Map();
+        for (const [i, w] of this.windows) {
+            const ni = Math.floor(i / 2);
+            const existing = next.get(ni);
+            if (existing === undefined) {
+                next.set(ni, w);
+            }
+            else {
+                existing.requests += w.requests;
+                existing.errors += w.errors;
+                existing.starts += w.starts;
+                existing.iterations += w.iterations;
+                if (w.peakSample > existing.peakSample)
+                    existing.peakSample = w.peakSample;
+                existing.latency.merge(w.latency);
+            }
+        }
+        this.windows = next;
+        this.windowMs *= 2;
+    }
+    /** 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, durationMs, ok, inFlight) {
+        const w = this.windowFor(offsetMs);
+        w.requests += 1;
+        if (!ok)
+            w.errors += 1;
+        w.latency.record(durationMs);
+        if (inFlight > w.peakSample)
+            w.peakSample = inFlight;
+    }
+    /** 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, inFlight) {
+        const w = this.windowFor(offsetMs);
+        w.starts += 1;
+        if (inFlight > w.peakSample)
+            w.peakSample = inFlight;
+    }
+    /** Record one completed iteration (iteration:end) at `offsetMs`. */
+    recordIterationEnd(offsetMs) {
+        this.windowFor(offsetMs).iterations += 1;
+    }
+    /** 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 = 0) {
+        if (this.windows.size === 0)
+            return { windowMs: this.windowMs, windows: [] };
+        // Extend to the last window the run actually covered (may coarsen existing windows).
+        let maxIdx = this.runEndIndex(runEndMs);
+        for (const i of this.windows.keys())
+            if (i > maxIdx)
+                maxIdx = i;
+        const windowSec = this.windowMs / 1000;
+        const windows = [];
+        // `carriedIn` = in-flight iterations ENTERING each window = Σ(starts − ends) through the
+        // PREVIOUS windows. The window's reported concurrency is max(its sampled peak, carriedIn):
+        //  - the sampled peak catches intra-window concurrency the net would cancel (a short
+        //    iteration that starts and ends in one window — even after coarsening);
+        //  - carriedIn catches a long iteration spanning quiet/idle windows (sustained, not zero).
+        let carriedIn = 0;
+        for (let i = 0; i <= maxIdx; i++) {
+            const w = this.windows.get(i);
+            const peakInFlight = Math.max(0, w?.peakSample ?? 0, carriedIn);
+            if (w === undefined) {
+                windows.push({
+                    offsetMs: i * this.windowMs,
+                    requests: 0,
+                    errors: 0,
+                    errorRate: 0,
+                    throughputPerSec: 0,
+                    latency: ZERO_PCT,
+                    iterations: 0,
+                    peakInFlight,
+                });
+            }
+            else {
+                windows.push({
+                    offsetMs: i * this.windowMs,
+                    requests: w.requests,
+                    errors: w.errors,
+                    errorRate: w.requests > 0 ? w.errors / w.requests : 0,
+                    throughputPerSec: windowSec > 0 ? w.requests / windowSec : 0,
+                    latency: w.latency.count > 0 ? w.latency.percentiles() : ZERO_PCT,
+                    iterations: w.iterations,
+                    peakInFlight,
+                });
+            }
+            carriedIn += (w?.starts ?? 0) - (w?.iterations ?? 0);
+        }
+        return { windowMs: this.windowMs, windows };
+    }
+}
+//# sourceMappingURL=timeline.js.map

package/dist/load/timeline.js.map

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

package/dist/load-harness.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=load-harness.d.ts.map

package/dist/load-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-harness.d.ts","sourceRoot":"","sources":["../src/load-harness.ts"],"names":[],"mappings":""}

package/dist/load-harness.js

@@ -0,0 +1,105 @@
+/**
+ * Load harness — runs INSIDE the Node.js subprocess (spawned via tsx by
+ * `runLoadFileInSubprocess`). The load-execution counterpart to `harness.ts`.
+ *
+ * Because this harness and the user `.load.ts` file are loaded in the SAME
+ * process — and resolved through the SAME project-local runner — both halves
+ * co-resolve one `@glubean/sdk`, so `runLoad`'s engine carrier and the scenario's
+ * runtime carrier are identical (no split-brain).
+ *
+ * Protocol:
+ *   stdin   ← JSON `{ vars, secrets }` (raw; env fallback applied here)
+ *   argv    ← `--file=<absolute path to the .load.ts>`
+ *   stdout  → `WIRE_PREFIX`-tagged NDJSON `LoadHarnessMessage` lines: one
+ *             `artifact` per completed plan, one `error` per import / plan-run
+ *             failure, a terminal `done`. The prefix lets the parent tell protocol
+ *             from ordinary user `console.log` (forwarded as-is); writes go through
+ *             `writeSync(1, …)` so they flush before exit. A crash (no `done`) is
+ *             surfaced by the parent from stderr.
+ */
+import { parseArgs } from "node:util";
+import { writeSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+import { bootstrap } from "./bootstrap.js";
+import { runLoad } from "./load/orchestrator.js";
+import { collectLoadPlans, withProcessEnvFallback, WIRE_PREFIX, } from "./load/subprocess.js";
+/** Write one protocol message synchronously to stdout (fd 1, flush-safe). The
+ *  LEADING newline guarantees the prefix begins a fresh line even when user /
+ *  plugin code wrote to stdout WITHOUT a trailing newline (otherwise the message
+ *  would be appended to that line and no longer start with the prefix). */
+function emit(msg) {
+    writeSync(1, "\n" + WIRE_PREFIX + JSON.stringify(msg) + "\n");
+}
+/** Mark the harness done (terminal sentinel) and exit cleanly. */
+function finishClean() {
+    emit({ type: "done" });
+    process.exit(0);
+}
+// A crash (uncaught error) is reported to stderr and exits nonzero WITHOUT a
+// `done` sentinel — the parent detects the missing sentinel and surfaces the
+// stderr text as a "did not complete" error, so nothing is silently lost.
+function crash(message) {
+    process.stderr.write(message + "\n");
+    process.exit(1);
+}
+process.on("uncaughtException", (error) => {
+    crash(`load harness crashed: ${error?.stack ?? error?.message ?? String(error)}`);
+});
+process.on("unhandledRejection", (reason) => {
+    crash(`load harness crashed: ${reason instanceof Error ? (reason.stack ?? reason.message) : String(reason)}`);
+});
+const { values: args } = parseArgs({
+    args: process.argv.slice(2),
+    options: { file: { type: "string" } },
+    strict: false,
+});
+const file = args.file;
+if (!file)
+    crash("load harness: missing required --file argument");
+/** Read the full stdin payload (the `{ vars, secrets }` JSON). */
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString("utf-8");
+}
+const stdinRaw = await readStdin();
+const { vars = {}, secrets = {} } = stdinRaw
+    ? JSON.parse(stdinRaw)
+    : {};
+// Register project plugins (matchers / protocol adapters) before importing the
+// load file, which may use them — same as the test/contract paths.
+await bootstrap(process.cwd());
+let ns;
+try {
+    // tsx (the spawning runtime) transforms full TypeScript; Node resolves the
+    // file's bare imports (`@glubean/sdk/load`) relative to the file's location.
+    ns = (await import(pathToFileURL(file).href));
+}
+catch (e) {
+    // A handled per-file failure (not a crash): emit the error + the done sentinel.
+    emit({
+        type: "error",
+        message: `failed to import load file ${file}: ${e instanceof Error ? e.message : String(e)} (ensure @glubean/sdk is resolvable from the file)`,
+    });
+    finishClean();
+}
+const envVars = withProcessEnvFallback(vars);
+const envSecrets = withProcessEnvFallback(secrets);
+for (const plan of collectLoadPlans(ns)) {
+    try {
+        // runLoad can throw for an invalid plan (traffic-mix, no termination bound,
+        // bad bounds) — report it per-plan and keep going so other plans' completed
+        // artifacts still emit.
+        const artifact = await runLoad(plan, { vars: envVars, secrets: envSecrets });
+        emit({ type: "artifact", runnerId: plan.id, artifact });
+    }
+    catch (e) {
+        emit({
+            type: "error",
+            message: `load plan "${plan.id}" (${file}) failed: ${e instanceof Error ? e.message : String(e)}`,
+        });
+    }
+}
+finishClean();
+//# sourceMappingURL=load-harness.js.map

package/dist/load-harness.js.map

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

package/dist/resolve.d.ts

@@ -54,23 +54,22 @@ export declare function isEachBuilder(obj: unknown): obj is {
     build(): Test<unknown>[];
 };
 /**
- * Type guard — check if a value is an un-built `FlowBuilder`
- * (from `contract.flow(id)...`).
+ * Type guard — check if a value is an un-built vNext `WorkflowBuilder`
+ * (from `workflow(id)...`).
  *
- * The builder carries `__glubean_type === "flow-builder"` and a `build()`
- * method that returns a `FlowContract` (array-extending with `_flow`).
+ * The builder carries `__glubean_type === "workflow-builder"` and a `build()`
+ * method that returns a `BuiltWorkflow` (a one-element `Test[]` that also
+ * carries the workflow IR fields).
  */
-export declare function isFlowBuilder(obj: unknown): obj is {
-    __glubean_type: "flow-builder";
-    build(): Test<unknown>[] & {
-        _flow?: unknown;
-    };
+export declare function isWorkflowBuilder(obj: unknown): obj is {
+    __glubean_type: "workflow-builder";
+    build(): Test<unknown>[];
 };
 /**
  * If the value is a `TestBuilder`, call `.build()` to get a `Test`.
  * If the value is an `EachBuilder`, call `.build()` to get a `Test[]`.
- * If the value is a `FlowBuilder`, call `.build()` to get a `FlowContract`
- * (array-extending Test[] with a `_flow` projection carrier).
+ * If the value is a vNext `WorkflowBuilder`, call `.build()` to get a
+ * `BuiltWorkflow` (array-extending Test[] carrying the workflow IR).
  * Otherwise return as-is.
  */
 export declare function autoResolve(value: unknown): unknown;

package/dist/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAMzC;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CASzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,GACX,GAAG,IAAI;IAAE,cAAc,EAAE,SAAS,CAAC;IAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,CAAA;CAAE,CAO9D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,GACX,GAAG,IAAI;IAAE,cAAc,EAAE,cAAc,CAAC;IAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAA;CAAE,CAOrE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,GACX,GAAG,IAAI;IACR,cAAc,EAAE,cAAc,CAAC;IAC/B,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAChD,CAOA;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKnD;AA2BD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,YAAY,EAAE,CAQhB;AAiDD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,EAAE,MAAM,GACb,IAAI,CAAC,OAAO,CAAC,GAAG,SAAS,CA2B3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,IAAI,EAAE,MAAM,GACX,IAAI,CAAC,OAAO,CAAC,GAAG,SAAS,CAiB3B"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAMzC;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CASzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,GACX,GAAG,IAAI;IAAE,cAAc,EAAE,SAAS,CAAC;IAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,CAAA;CAAE,CAO9D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,GACX,GAAG,IAAI;IAAE,cAAc,EAAE,cAAc,CAAC;IAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAA;CAAE,CAOrE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,GACX,GAAG,IAAI;IACR,cAAc,EAAE,kBAAkB,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;CAC1B,CAOA;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKnD;AA2BD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,YAAY,EAAE,CAQhB;AAuDD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,EAAE,MAAM,GACb,IAAI,CAAC,OAAO,CAAC,GAAG,SAAS,CA2B3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,IAAI,EAAE,MAAM,GACX,IAAI,CAAC,OAAO,CAAC,GAAG,SAAS,CA0B3B"}

package/dist/resolve.js

@@ -49,16 +49,17 @@ export function isEachBuilder(obj) {
         typeof obj.build === "function");
 }
 /**
- * Type guard — check if a value is an un-built `FlowBuilder`
- * (from `contract.flow(id)...`).
+ * Type guard — check if a value is an un-built vNext `WorkflowBuilder`
+ * (from `workflow(id)...`).
  *
- * The builder carries `__glubean_type === "flow-builder"` and a `build()`
- * method that returns a `FlowContract` (array-extending with `_flow`).
+ * The builder carries `__glubean_type === "workflow-builder"` and a `build()`
+ * method that returns a `BuiltWorkflow` (a one-element `Test[]` that also
+ * carries the workflow IR fields).
  */
-export function isFlowBuilder(obj) {
+export function isWorkflowBuilder(obj) {
     return (typeof obj === "object" &&
         obj !== null &&
-        obj.__glubean_type === "flow-builder" &&
+        obj.__glubean_type === "workflow-builder" &&
         typeof obj.build === "function");
 }
 // ---------------------------------------------------------------------------
@@ -67,8 +68,8 @@ export function isFlowBuilder(obj) {
 /**
  * If the value is a `TestBuilder`, call `.build()` to get a `Test`.
  * If the value is an `EachBuilder`, call `.build()` to get a `Test[]`.
- * If the value is a `FlowBuilder`, call `.build()` to get a `FlowContract`
- * (array-extending Test[] with a `_flow` projection carrier).
+ * If the value is a vNext `WorkflowBuilder`, call `.build()` to get a
+ * `BuiltWorkflow` (array-extending Test[] carrying the workflow IR).
  * Otherwise return as-is.
  */
 export function autoResolve(value) {
@@ -76,7 +77,7 @@ export function autoResolve(value) {
         return value.build();
     if (isEachBuilder(value))
         return value.build();
-    if (isFlowBuilder(value))
+    if (isWorkflowBuilder(value))
         return value.build();
     return value;
 }
@@ -135,6 +136,14 @@ function collectTests(exportName, value, out) {
             if (isTest(resolvedItem)) {
                 out.push(toResolvedTest(exportName, resolvedItem));
             }
+            else if (Array.isArray(resolvedItem)) {
+                // One nesting level: workflow.each() returns BuiltWorkflow[] where
+                // each member is itself a one-element Test[] (the dual array handle).
+                for (const inner of resolvedItem) {
+                    if (isTest(inner))
+                        out.push(toResolvedTest(exportName, inner));
+                }
+            }
         }
     }
 }
@@ -219,6 +228,16 @@ export function findTestByExport(userModule, name) {
             if (isTest(item)) {
                 return item;
             }
+            // One nesting level: workflow.each()/pick() exports BuiltWorkflow[]
+            // whose members are themselves one-element Test[] handles. The
+            // export-name fallback exists exactly for pick's run-to-run randomness —
+            // it must see nested members too (codex S2.12 R1 P1).
+            if (Array.isArray(item)) {
+                for (const inner of item) {
+                    if (isTest(inner))
+                        return inner;
+                }
+            }
         }
     }
     return undefined;

package/dist/resolve.js.map

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

package/dist/runner-resolve.d.ts

@@ -0,0 +1,53 @@
+/** Diagnostic warning emitted by the executor's runner resolver. */
+export interface RunnerWarning {
+    /** Human-readable message. */
+    message: string;
+    /** Stable code for filtering / consumer dedupe. */
+    code: "runner_fallback_no_project" | "runner_fallback_no_dist" | "runner_protocol_old" | "runner_pkg_root_not_found";
+}
+export interface ResolvedRunner {
+    distDir: string;
+    pkgRoot: string;
+    source: "project" | "bundled";
+    resolvedFrom?: string;
+    version?: string;
+    pendingWarnings: RunnerWarning[];
+}
+/**
+ * Resolve the runner dist/ directory + package root.
+ *
+ * Preference: project-local `@glubean/runner` (found from `projectCwd`'s
+ * `node_modules` chain). Fallback: bundled (the consumer's own runner copy).
+ *
+ * Returns warnings to be yielded as `{ type: "warning", ... }` events at
+ * the start of every `run()` call. Always emits a warning when falling
+ * back to bundled (so users see why "configure() values..." errors may
+ * appear in a misconfigured project).
+ */
+export declare function resolveRunnerRoot(projectCwd: string, bundledDistDir: string, bundledPkgRoot: string): ResolvedRunner;
+/** Resolve the tsx CLI entry used to transform the user's TypeScript in the
+ *  spawned harness subprocess. Cached after the first lookup. */
+export declare function resolveTsxPath(): string;
+/** A computed zero-project plan: extra tsx `--import` args, env redirects, and a
+ *  cleanup that undoes any temp package.json. */
+export interface ZeroProjectSetup {
+    /** tsx args to prepend (`--import <zero-project-register.mjs>`), or `[]`. */
+    tsxArgs: string[];
+    /** Env additions (`GLUBEAN_VENDORED_ROOT`), or `{}`. */
+    env: Record<string, string>;
+    /** Restore the working dir's package.json to its original state. Idempotent. */
+    cleanup(): void;
+}
+/**
+ * Set up zero-project (scratch) mode for a spawn rooted at `cwd`: when the cwd
+ * has no `@glubean/sdk` in node_modules, redirect the user file's `@glubean/*`
+ * imports to the resolved runner's vendored copy (via the register hook +
+ * `GLUBEAN_VENDORED_ROOT`) and ensure a `"type":"module"` package.json so the
+ * `.ts` file loads as ESM. When the cwd already has `@glubean/sdk`, this is a
+ * no-op (empty args/env, no-op cleanup).
+ *
+ * Pure w.r.t. instance state — both `TestExecutor` and the load spawn call it
+ * and own the returned `tsxArgs`/`env`/`cleanup`.
+ */
+export declare function prepareZeroProject(cwd: string, runnerDistDir: string, runnerPkgRoot: string): ZeroProjectSetup;
+//# sourceMappingURL=runner-resolve.d.ts.map

package/dist/runner-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-resolve.d.ts","sourceRoot":"","sources":["../src/runner-resolve.ts"],"names":[],"mappings":"AAqEA,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,IAAI,EAAE,4BAA4B,GAAG,yBAAyB,GAAG,qBAAqB,GAAG,2BAA2B,CAAC;CACtH;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,aAAa,EAAE,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GACrB,cAAc,CAuGhB;AAQD;iEACiE;AACjE,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAID;iDACiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,gFAAgF;IAChF,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACpB,gBAAgB,CA2DlB"}