@glubean/runner 0.2.3 → 0.2.5

package/dist/project-runner.js

@@ -0,0 +1,214 @@
+/**
+ * @module project-runner
+ *
+ * `ProjectRunner` — single top-level API for "run the tests of a project".
+ *
+ * Wraps the orchestration primitives (`loadProjectEnv`, `bootstrap`,
+ * `RunOrchestrator`, `TestExecutor`) into one coherent pipeline with a
+ * well-typed event stream. Consumers (CLI, MCP, VSCode extension,
+ * third-party embedders) all go through this facade rather than re-
+ * assembling the primitives themselves.
+ *
+ * **Scope boundary:**
+ * - Facade does: env load → bootstrap → per-file-batched TestExecutor
+ *   loop with session setup/teardown, metric recording
+ * - Facade does NOT: console presentation, trace-file writing, upload,
+ *   result.json formatting, CI-specific flag guards, summary judgment.
+ *   Consumers build their own summary by observing events.
+ *
+ * Batching is fixed at per-file batched (one tsx subprocess per file,
+ * all of that file's testIds batched into `TestExecutor.run(fileUrl, "",
+ * ctx, {testIds})`).
+ */
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { loadProjectOverlays } from "@glubean/scanner";
+import { bootstrap } from "./bootstrap.js";
+import { TestExecutor } from "./executor.js";
+import { discoverSessionFile, RunOrchestrator, } from "./orchestrator.js";
+import { MetricCollector } from "./thresholds.js";
+import { toSingleExecutionOptions } from "./config.js";
+// =============================================================================
+// ProjectRunner
+// =============================================================================
+export class ProjectRunner {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Run the full pipeline as an async event stream.
+     *
+     * @example
+     * ```ts
+     * const runner = new ProjectRunner({...});
+     * for await (const event of runner.run()) {
+     *   switch (event.type) { ... }
+     * }
+     * ```
+     */
+    async *run() {
+        const { rootDir, sharedConfig, vars: envVars, secrets, tests, noSession = false, interactive = false, signal, } = this.options;
+        const sessionStartDir = this.options.sessionStartDir ?? rootDir;
+        const metricCollector = this.options.metricCollector ?? new MetricCollector();
+        // ── 1. Bootstrap ─────────────────────────────────────────────────
+        yield { type: "bootstrap:start", projectRoot: rootDir };
+        try {
+            await bootstrap(rootDir);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            yield { type: "bootstrap:failed", error };
+            yield { type: "run:failed", reason: "bootstrap-failed", error: error.message };
+            return;
+        }
+        // attachment-model §7.4: eagerly load every `*.bootstrap.{ts,js,mjs}`
+        // so `contract.bootstrap()` calls register their overlays before any
+        // test runs. Idempotent — CLI already calls this; second visit
+        // short-circuits via the scanner's mtime-keyed module cache.
+        // Per-file errors are surfaced but don't abort the run; a broken
+        // overlay file shouldn't block unrelated tests. Cases that depend
+        // on the missing overlay will hard-error at execute-time per §5.1.
+        const overlayLoad = await loadProjectOverlays(rootDir);
+        for (const err of overlayLoad.errors) {
+            yield { type: "overlay:load:failed", file: err.file, error: err.error };
+        }
+        yield { type: "bootstrap:done" };
+        // ── 3. Group tests by file (per-file batching) ───────────────────
+        const fileGroups = new Map();
+        for (const t of tests) {
+            const group = fileGroups.get(t.filePath) || [];
+            group.push(t);
+            fileGroups.set(t.filePath, group);
+        }
+        yield { type: "discovery:done", totalFiles: fileGroups.size, totalTests: tests.length };
+        // ── 4. Build executor (shared across all files) ──────────────────
+        const executor = this.options.executor ?? TestExecutor.fromSharedConfig(sharedConfig, {
+            cwd: rootDir,
+            ...(this.options.inspectBrk !== undefined && { inspectBrk: this.options.inspectBrk }),
+        });
+        const orchestrator = new RunOrchestrator(executor);
+        const sessionState = {};
+        let sessionSetupSucceeded = false;
+        // Wrap all post-executor-construction work in try/finally so the
+        // executor's own cleanup path (zero-project scratch teardown, any
+        // future finalizers) always runs — even on early return from
+        // session-setup failure or signal abort. This also covers the case
+        // where the generator is abandoned by its caller (iterator .return()
+        // triggers the finally block).
+        try {
+            // ── 5. Session setup ───────────────────────────────────────────
+            const sessionFile = noSession ? undefined : discoverSessionFile(sessionStartDir, rootDir);
+            yield { type: "session:discovered", sessionFile };
+            if (sessionFile) {
+                yield { type: "session:setup:start", sessionFile };
+                let setupFailed = false;
+                let failureInfo;
+                for await (const event of orchestrator.runSessionSetup(sessionFile, { vars: envVars, secrets, interactive }, toSingleExecutionOptions(sharedConfig))) {
+                    if (event.type === "session:set") {
+                        sessionState[event.key] = event.value;
+                    }
+                    else if (event.type === "status" && event.status === "failed") {
+                        setupFailed = true;
+                        failureInfo = { error: event.error, stack: event.stack };
+                    }
+                    yield { type: "session:setup:event", event };
+                }
+                if (setupFailed) {
+                    yield { type: "session:setup:failed", ...(failureInfo ?? {}) };
+                    // Best-effort teardown before bailing.
+                    yield { type: "session:teardown:start", sessionFile };
+                    for await (const event of orchestrator.runSessionTeardown(sessionFile, { vars: envVars, secrets }, sessionState, toSingleExecutionOptions(sharedConfig))) {
+                        yield { type: "session:teardown:event", event };
+                    }
+                    yield { type: "session:teardown:done" };
+                    yield {
+                        type: "run:failed",
+                        reason: "session-setup-failed",
+                        ...(failureInfo?.error !== undefined && { error: failureInfo.error }),
+                    };
+                    return;
+                }
+                sessionSetupSucceeded = true;
+                yield { type: "session:setup:done", stateKeys: Object.keys(sessionState) };
+            }
+            // ── 6. File loop (per-file batched) ────────────────────────────
+            let passedCount = 0;
+            let failedCount = 0;
+            let skippedCount = 0;
+            const failureLimit = sharedConfig.failAfter ??
+                (sharedConfig.failFast ? 1 : undefined);
+            for (const [filePath, fileTests] of fileGroups) {
+                if (signal?.aborted)
+                    break;
+                if (failureLimit !== undefined && failedCount >= failureLimit)
+                    break;
+                const testFileUrl = pathToFileURL(resolve(filePath)).href;
+                const testIds = fileTests.map((t) => t.meta.id);
+                const exportNames = {};
+                for (const t of fileTests)
+                    exportNames[t.meta.id] = t.exportName;
+                yield { type: "file:start", filePath, testCount: fileTests.length };
+                const fileStart = Date.now();
+                for await (const event of executor.run(testFileUrl, "", {
+                    vars: envVars,
+                    secrets,
+                    ...(Object.keys(sessionState).length > 0 && { session: sessionState }),
+                }, {
+                    ...toSingleExecutionOptions(sharedConfig),
+                    testIds,
+                    exportNames,
+                    ...(fileTests.some((t) => t.meta.parallel) && sharedConfig.concurrency > 1
+                        ? { concurrency: sharedConfig.concurrency }
+                        : {}),
+                })) {
+                    if (event.type === "session:set") {
+                        sessionState[event.key] = event.value;
+                    }
+                    if (event.type === "metric") {
+                        metricCollector.add(event.name, event.value);
+                    }
+                    if (event.type === "status") {
+                        if (event.status === "completed")
+                            passedCount += 1;
+                        else if (event.status === "skipped")
+                            skippedCount += 1;
+                        else
+                            failedCount += 1;
+                    }
+                    yield { type: "file:event", filePath, event };
+                }
+                yield { type: "file:complete", filePath, duration: Date.now() - fileStart };
+            }
+            // ── 7. Session teardown ────────────────────────────────────────
+            if (sessionFile && sessionSetupSucceeded) {
+                yield { type: "session:teardown:start", sessionFile };
+                for await (const event of orchestrator.runSessionTeardown(sessionFile, { vars: envVars, secrets }, sessionState, toSingleExecutionOptions(sharedConfig))) {
+                    yield { type: "session:teardown:event", event };
+                }
+                yield { type: "session:teardown:done" };
+            }
+            // ── 8. Done ────────────────────────────────────────────────────
+            yield { type: "run:complete", passedCount, failedCount, skippedCount };
+        }
+        finally {
+            // Drain executor.finalize() — zero-project scratch cleanup and any
+            // future executor-level finalizers. Safe to call even after session
+            // teardown already ran (executor.finalize() guards on _sessionSetupDone,
+            // which stays false when sessions are driven by RunOrchestrator rather
+            // than executor auto-session). Discard yielded events; this is pure
+            // cleanup, not part of the user-visible run.
+            try {
+                for await (const _ of executor.finalize()) {
+                    // intentionally drain
+                }
+            }
+            catch {
+                // Finalize errors are non-fatal — surface silently to avoid masking
+                // the primary run outcome. Could be upgraded to a warning event
+                // later if needed.
+            }
+        }
+    }
+}
+//# sourceMappingURL=project-runner.js.map

package/dist/project-runner.js.map

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

package/dist/run-case.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @module run-case
+ *
+ * Public programmatic wrapper for the runner-input-channel surface
+ * (attachment-model §8). Mirrors CLI `--input-json` / `--bootstrap-json` /
+ * `--force-standalone` and MCP `glubean_run_local_file`'s `inputJson` /
+ * `bootstrapInput` / `forceStandalone` parameters.
+ *
+ * Use cases:
+ *   - Embedders / scripts that want to drive a single contract case with
+ *     a specific input shape without going through the CLI.
+ *   - Cookbook examples illustrating attachment-model §5.1 / §8 flows.
+ *
+ * Implementation strategy: serialize the per-test inputs into the same
+ * env vars the harness reads (`GLUBEAN_RUNNER_*`), then construct a
+ * `ProjectRunner` with a single test descriptor. Env vars are restored
+ * to their prior values in `finally`, so concurrent callers in the
+ * same process don't leak state.
+ */
+import type { ProjectRunEvent } from "./project-runner.js";
+import type { SharedRunConfig } from "./config.js";
+/** Result of running a single case via {@link runCase}. */
+export interface RunCaseResult {
+    /** Did the case pass? */
+    success: boolean;
+    /** Test id that ran. */
+    testId: string;
+    /** Project root resolved from the file path's ancestry. */
+    projectRoot: string;
+    /** All events emitted by `ProjectRunner` for this run, in order. */
+    events: ProjectRunEvent[];
+    /**
+     * If the run did not reach a per-test success/fail status (e.g.
+     * bootstrap or session setup failed), this carries the reason.
+     */
+    orchestrationError?: string;
+}
+/** Options for {@link runCase}. */
+export interface RunCaseOptions {
+    /** Absolute (preferred) path to the test/contract file. */
+    filePath: string;
+    /** Specific testId to dispatch (e.g. `"orders.create.success"`). */
+    testId: string;
+    /** Display name for the test. Optional; falls back to `testId`. */
+    testName?: string;
+    /** Export name on the file. When omitted, `ProjectRunner` resolves it. */
+    exportName?: string;
+    /** Project root override. When omitted, `filePath`'s directory is used. */
+    rootDir?: string;
+    /** Shared run config (timeouts, schema inference, etc.). */
+    sharedConfig: SharedRunConfig;
+    /**
+     * Skip session setup/teardown. Defaults to `false` to match CLI / MCP
+     * / `ProjectRunner` defaults — a programmatic single-case run sees
+     * the same `session.ts` lifecycle a `glubean run --filter` would.
+     * Set to `true` only when the caller has a reason to bypass session
+     * (e.g. invoking from inside a test that already established its own
+     * session, or driving a fixture project with no `session.ts`).
+     */
+    noSession?: boolean;
+    /**
+     * Spike 3 attachment-model §8 — explicit case input. Validated
+     * against the case's `needs` schema; runs raw (overlay skipped).
+     */
+    input?: unknown;
+    /**
+     * Spike 3 attachment-model §8 — bootstrap params. Validated against
+     * the overlay's `params` schema and passed to `run(ctx, params)`.
+     */
+    bootstrapInput?: unknown;
+    /**
+     * §6.3 debug escape valve for `runnability.requireAttachment` on
+     * no-needs cases. Emits a runtime warning when triggered.
+     */
+    forceStandalone?: boolean;
+    /**
+     * Optional env map for `{{VAR}}` substitution inside `input` /
+     * `bootstrapInput` (§8). When omitted, the templating env is built
+     * from `{ ...vars, ...secrets, ...process.env }` matching CLI / MCP
+     * precedence (process.env wins, secrets win over vars).
+     */
+    templatingEnv?: Record<string, string | undefined>;
+    /**
+     * Project env-file basename to load (e.g. `".env"` or
+     * `".env.staging"`). Loads `<rootDir>/<envFile>` and
+     * `<rootDir>/<envFile>.secrets`. Both files are silently treated as
+     * empty when absent. Defaults to `".env"` to match CLI / MCP.
+     *
+     * Set to `null` to skip env-file loading entirely (useful for
+     * fixture-driven tests / scripts that don't want any project env).
+     */
+    envFile?: string | null;
+    /**
+     * Project vars to inject into `ProjectRunner` (and therefore into
+     * `ctx.vars` for the running case). When provided, MERGED ON TOP OF
+     * the env loaded from `envFile` (caller-supplied vars win over file
+     * vars). Use this to override or extend env values without touching
+     * the on-disk `.env`.
+     */
+    vars?: Record<string, string>;
+    /**
+     * Project secrets to inject into `ProjectRunner` (and therefore into
+     * `ctx.secrets`). Same merge semantics as `vars` — caller-supplied
+     * wins over `envFile` values.
+     */
+    secrets?: Record<string, string>;
+}
+/**
+ * Run a single contract case programmatically with optional explicit
+ * input or bootstrap params. Mirrors the runtime resolution algorithm
+ * (§5.1) used by the CLI and MCP surfaces.
+ *
+ * @example Run a needs-case with explicit input (overlay skipped)
+ * ```ts
+ * import { runCase } from "@glubean/runner";
+ *
+ * const result = await runCase({
+ *   filePath: "/abs/path/to/users.contract.ts",
+ *   testId: "users.get.ok",
+ *   sharedConfig: { ...default... },
+ *   input: { token: "tk-1", userId: "u-42" },
+ * });
+ * console.log(result.success);
+ * ```
+ *
+ * @example Run with bootstrap params
+ * ```ts
+ * const result = await runCase({
+ *   filePath: "/abs/.../orders.contract.ts",
+ *   testId: "orders.list.seeded",
+ *   sharedConfig: { ...default... },
+ *   bootstrapInput: { projectId: "p_42" },
+ * });
+ * ```
+ */
+export declare function runCase(opts: RunCaseOptions): Promise<RunCaseResult>;
+//# sourceMappingURL=run-case.d.ts.map

package/dist/run-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-case.d.ts","sourceRoot":"","sources":["../src/run-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA+CnD,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,YAAY,EAAE,eAAe,CAAC;IAC9B;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAEnD;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAmJ1E"}

package/dist/run-case.js

@@ -0,0 +1,233 @@
+/**
+ * @module run-case
+ *
+ * Public programmatic wrapper for the runner-input-channel surface
+ * (attachment-model §8). Mirrors CLI `--input-json` / `--bootstrap-json` /
+ * `--force-standalone` and MCP `glubean_run_local_file`'s `inputJson` /
+ * `bootstrapInput` / `forceStandalone` parameters.
+ *
+ * Use cases:
+ *   - Embedders / scripts that want to drive a single contract case with
+ *     a specific input shape without going through the CLI.
+ *   - Cookbook examples illustrating attachment-model §5.1 / §8 flows.
+ *
+ * Implementation strategy: serialize the per-test inputs into the same
+ * env vars the harness reads (`GLUBEAN_RUNNER_*`), then construct a
+ * `ProjectRunner` with a single test descriptor. Env vars are restored
+ * to their prior values in `finally`, so concurrent callers in the
+ * same process don't leak state.
+ */
+import { dirname, resolve } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { ProjectRunner } from "./project-runner.js";
+import { applyEnvTemplating } from "./runner-input-templating.js";
+import { loadProjectEnv } from "./env.js";
+/**
+ * Walk up from `filePath` to find the **Glubean project root** — the
+ * nearest ancestor containing a `package.json` that declares
+ * `@glubean/sdk` (in deps or devDeps) OR carries a `glubean` config
+ * field. Mirrors `findProjectConfig` in CLI run.ts.
+ *
+ * The "Glubean project" filter matters in monorepos / nested-package
+ * setups: a contract under `apps/foo/tests/x.contract.ts` should resolve
+ * to the workspace root (where `glubean.setup.ts` / root `.env` /
+ * top-level overlay registrations live), NOT to `apps/foo/` if that
+ * subpackage's `package.json` doesn't depend on `@glubean/sdk`. Stopping
+ * at the first `package.json` would silently misroute everything.
+ *
+ * Fallback when no Glubean project is found anywhere up the tree:
+ * `dirname(filePath)`. This keeps ad-hoc / scratch test runs working
+ * (matches CLI's "scratch mode" — no glubean project found).
+ */
+function findProjectRoot(filePath) {
+    let dir = dirname(filePath);
+    while (dir !== dirname(dir)) {
+        const pkgPath = resolve(dir, "package.json");
+        if (existsSync(pkgPath)) {
+            try {
+                const content = JSON.parse(readFileSync(pkgPath, "utf-8"));
+                const deps = { ...content.dependencies, ...content.devDependencies };
+                if ("@glubean/sdk" in deps || content.glubean !== undefined) {
+                    return dir;
+                }
+                // Non-Glubean package.json — keep walking; might be a nested
+                // tooling package whose Glubean root is higher up.
+            }
+            catch {
+                // Parse error — skip this package.json and keep walking.
+            }
+        }
+        dir = dirname(dir);
+    }
+    return dirname(filePath);
+}
+/**
+ * Run a single contract case programmatically with optional explicit
+ * input or bootstrap params. Mirrors the runtime resolution algorithm
+ * (§5.1) used by the CLI and MCP surfaces.
+ *
+ * @example Run a needs-case with explicit input (overlay skipped)
+ * ```ts
+ * import { runCase } from "@glubean/runner";
+ *
+ * const result = await runCase({
+ *   filePath: "/abs/path/to/users.contract.ts",
+ *   testId: "users.get.ok",
+ *   sharedConfig: { ...default... },
+ *   input: { token: "tk-1", userId: "u-42" },
+ * });
+ * console.log(result.success);
+ * ```
+ *
+ * @example Run with bootstrap params
+ * ```ts
+ * const result = await runCase({
+ *   filePath: "/abs/.../orders.contract.ts",
+ *   testId: "orders.list.seeded",
+ *   sharedConfig: { ...default... },
+ *   bootstrapInput: { projectId: "p_42" },
+ * });
+ * ```
+ */
+export async function runCase(opts) {
+    // §5.1 invariant: explicit input always wins; overlay never invoked.
+    // The two channels are mutually exclusive — surface boundary enforces
+    // it so the dispatcher never silently drops the bootstrap-params side.
+    if (opts.input !== undefined && opts.bootstrapInput !== undefined) {
+        throw new Error(`runCase: \`input\` and \`bootstrapInput\` are mutually exclusive. ` +
+            `Per attachment-model §5.1: explicit input bypasses the overlay, ` +
+            `so bootstrap params would be ignored. Pick one channel per call.`);
+    }
+    const filePath = resolve(opts.filePath);
+    // §7.4 / glubean.setup.ts location: project root must be the directory
+    // containing `package.json` and (typically) `glubean.setup.ts` — NOT
+    // just the directory of the contract file. A file under `tests/` or
+    // `contracts/` would otherwise miss the project's plugin bootstrap and
+    // env loading. Caller can pass an explicit `rootDir` to override; if
+    // omitted, walk up from the file looking for `package.json`.
+    const rootDir = opts.rootDir ?? findProjectRoot(filePath);
+    // Load project env (matches CLI / MCP behavior). `envFile: null` skips
+    // the load; otherwise default basename is `.env`. Caller-supplied
+    // `vars` / `secrets` merge on top (caller wins over file).
+    //
+    // No try/catch around `loadProjectEnv`: it treats missing `.env` /
+    // `.env.secrets` files as empty internally and only throws on real
+    // load failures (parse errors, IO errors). Letting those bubble up
+    // matches CLI / MCP behavior — silently empty-env-then-run is a
+    // worse failure mode than a clear parse error to the caller.
+    let loadedVars = {};
+    let loadedSecrets = {};
+    if (opts.envFile !== null) {
+        const envFileName = opts.envFile ?? ".env";
+        const loaded = await loadProjectEnv(rootDir, envFileName);
+        loadedVars = loaded.vars;
+        loadedSecrets = loaded.secrets;
+    }
+    const effectiveVars = { ...loadedVars, ...(opts.vars ?? {}) };
+    const effectiveSecrets = { ...loadedSecrets, ...(opts.secrets ?? {}) };
+    // Capture & set env vars BEFORE constructing ProjectRunner — the
+    // executor inherits parent env when spawning the harness subprocess.
+    const savedExplicit = process.env["GLUBEAN_RUNNER_EXPLICIT_INPUT_MAP"];
+    const savedBootstrap = process.env["GLUBEAN_RUNNER_BOOTSTRAP_INPUT_MAP"];
+    const savedForce = process.env["GLUBEAN_RUNNER_FORCE_STANDALONE_IDS"];
+    // §8 templating env — caller override, else built from
+    // `{ ...vars, ...secrets, ...process.env }` matching CLI / MCP
+    // precedence (process.env wins, secrets win over vars). Substitution
+    // happens before env-var serialization, so the harness sees ready-to-
+    // validate JSON.
+    const templatingEnv = opts.templatingEnv ?? {
+        ...effectiveVars,
+        ...effectiveSecrets,
+        ...process.env,
+    };
+    if (opts.input !== undefined) {
+        const templated = applyEnvTemplating(opts.input, templatingEnv);
+        process.env["GLUBEAN_RUNNER_EXPLICIT_INPUT_MAP"] = JSON.stringify({
+            [opts.testId]: templated,
+        });
+    }
+    if (opts.bootstrapInput !== undefined) {
+        const templated = applyEnvTemplating(opts.bootstrapInput, templatingEnv);
+        process.env["GLUBEAN_RUNNER_BOOTSTRAP_INPUT_MAP"] = JSON.stringify({
+            [opts.testId]: templated,
+        });
+    }
+    if (opts.forceStandalone === true) {
+        process.env["GLUBEAN_RUNNER_FORCE_STANDALONE_IDS"] = JSON.stringify([
+            opts.testId,
+        ]);
+    }
+    const restoreEnv = () => {
+        if (savedExplicit === undefined) {
+            delete process.env["GLUBEAN_RUNNER_EXPLICIT_INPUT_MAP"];
+        }
+        else {
+            process.env["GLUBEAN_RUNNER_EXPLICIT_INPUT_MAP"] = savedExplicit;
+        }
+        if (savedBootstrap === undefined) {
+            delete process.env["GLUBEAN_RUNNER_BOOTSTRAP_INPUT_MAP"];
+        }
+        else {
+            process.env["GLUBEAN_RUNNER_BOOTSTRAP_INPUT_MAP"] = savedBootstrap;
+        }
+        if (savedForce === undefined) {
+            delete process.env["GLUBEAN_RUNNER_FORCE_STANDALONE_IDS"];
+        }
+        else {
+            process.env["GLUBEAN_RUNNER_FORCE_STANDALONE_IDS"] = savedForce;
+        }
+    };
+    const test = {
+        filePath,
+        exportName: opts.exportName ?? "",
+        meta: {
+            id: opts.testId,
+            name: opts.testName ?? opts.testId,
+        },
+    };
+    const runner = new ProjectRunner({
+        rootDir,
+        sharedConfig: opts.sharedConfig,
+        vars: effectiveVars,
+        secrets: effectiveSecrets,
+        tests: [test],
+        noSession: opts.noSession ?? false,
+    });
+    const events = [];
+    let success = false;
+    let orchestrationError;
+    try {
+        for await (const evt of runner.run()) {
+            events.push(evt);
+            if (evt.type === "bootstrap:failed") {
+                orchestrationError = `Bootstrap failed: ${evt.error.message}`;
+            }
+            else if (evt.type === "session:setup:failed") {
+                orchestrationError = `Session setup failed${evt.error ? `: ${evt.error}` : ""}`;
+            }
+            else if (evt.type === "run:failed") {
+                if (!orchestrationError) {
+                    orchestrationError = `Run failed (${evt.reason})${evt.error ? `: ${evt.error}` : ""}`;
+                }
+            }
+            else if (evt.type === "file:event") {
+                // ExecutionEvent's `status` event encodes the final per-test
+                // outcome: "completed" = pass, "failed" = fail, "skipped" = neither.
+                if (evt.event.type === "status" && evt.event.id === opts.testId) {
+                    success = evt.event.status === "completed";
+                }
+            }
+        }
+    }
+    finally {
+        restoreEnv();
+    }
+    return {
+        success,
+        testId: opts.testId,
+        projectRoot: rootDir,
+        events,
+        ...(orchestrationError !== undefined ? { orchestrationError } : {}),
+    };
+}
+//# sourceMappingURL=run-case.js.map

package/dist/run-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-case.js","sourceRoot":"","sources":["../src/run-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,OAAO,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC7C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAIxD,CAAC;gBACF,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;gBACrE,IAAI,cAAc,IAAI,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC5D,OAAO,GAAG,CAAC;gBACb,CAAC;gBACD,6DAA6D;gBAC7D,mDAAmD;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,yDAAyD;YAC3D,CAAC;QACH,CAAC;QACD,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAiGD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAoB;IAChD,qEAAqE;IACrE,sEAAsE;IACtE,uEAAuE;IACvE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CACb,oEAAoE;YAClE,kEAAkE;YAClE,kEAAkE,CACrE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,uEAAuE;IACvE,qEAAqE;IACrE,oEAAoE;IACpE,uEAAuE;IACvE,qEAAqE;IACrE,6DAA6D;IAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE1D,uEAAuE;IACvE,kEAAkE;IAClE,2DAA2D;IAC3D,EAAE;IACF,mEAAmE;IACnE,mEAAmE;IACnE,mEAAmE;IACnE,gEAAgE;IAChE,6DAA6D;IAC7D,IAAI,UAAU,GAA2B,EAAE,CAAC;IAC5C,IAAI,aAAa,GAA2B,EAAE,CAAC;IAC/C,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC1D,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;IACjC,CAAC;IACD,MAAM,aAAa,GAAG,EAAE,GAAG,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IAC9D,MAAM,gBAAgB,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IAEvE,iEAAiE;IACjE,qEAAqE;IACrE,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACvE,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IAEtE,uDAAuD;IACvD,+DAA+D;IAC/D,qEAAqE;IACrE,sEAAsE;IACtE,iBAAiB;IACjB,MAAM,aAAa,GACjB,IAAI,CAAC,aAAa,IAAI;QACpB,GAAG,aAAa;QAChB,GAAG,gBAAgB;QACnB,GAAG,OAAO,CAAC,GAAG;KACf,CAAC;IAEJ,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAChE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS;SACzB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YACjE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS;SACzB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAClE,IAAI,CAAC,MAAM;SACZ,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,GAAG,aAAa,CAAC;QACnE,CAAC;QACD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,GAAG,cAAc,CAAC;QACrE,CAAC;QACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,GAAG,UAAU,CAAC;QAClE,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,GAAsB;QAC9B,QAAQ;QACR,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;QACjC,IAAI,EAAE;YACJ,EAAE,EAAE,IAAI,CAAC,MAAM;YACf,IAAI,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM;SACN;KAC/B,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;QAC/B,OAAO;QACP,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,gBAAgB;QACzB,KAAK,EAAE,CAAC,IAAI,CAAC;QACb,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,KAAK;KACnC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,kBAAsC,CAAC;IAE3C,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACpC,kBAAkB,GAAG,qBAAqB,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAChE,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBAC/C,kBAAkB,GAAG,uBAAuB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAClF,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACrC,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBACxB,kBAAkB,GAAG,eAAe,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACxF,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACrC,6DAA6D;gBAC7D,qEAAqE;gBACrE,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChE,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,UAAU,EAAE,CAAC;IACf,CAAC;IAED,OAAO;QACL,OAAO;QACP,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,OAAO;QACpB,MAAM;QACN,GAAG,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC"}

package/dist/runner-input-templating.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @module runner-input-templating
+ *
+ * `{{VAR}}` substitution for runner-supplied inputs (attachment-model
+ * §8). The runner interpolates string scalars before schema validation;
+ * `env` is never read inside bootstrap (§8).
+ *
+ * Patterns supported (per §8 spec — kept minimal in v0):
+ *   - `{{VAR}}` — substitute the entire string with the env value
+ *     (preserves type only when string; numeric envs stay strings)
+ *   - `prefix-{{VAR}}-suffix` — string interpolation; result is a string
+ *   - `{{VAR1}}{{VAR2}}` — multiple substitutions in one string
+ *
+ * Errors:
+ *   - Missing required var → `Error("Templating: missing env var \"VAR\"")`
+ *   - Whitespace inside braces is stripped; `{{ VAR }}` works.
+ *
+ * Scope:
+ *   - Recursive across plain objects and arrays.
+ *   - Strings get substitution; numbers / booleans / null pass through.
+ *   - Functions / class instances / Maps / Sets / etc. are unsupported
+ *     for v0 (the input is JSON-shaped by the time it reaches us, so
+ *     this is fine).
+ */
+/**
+ * Apply `{{VAR}}` substitution to all string scalars inside `value`,
+ * resolving variables from `env`. Returns a new value (does not mutate
+ * the input).
+ *
+ * @throws when a referenced var is missing in `env`.
+ */
+export declare function applyEnvTemplating(value: unknown, env: Record<string, string | undefined>): unknown;
+//# sourceMappingURL=runner-input-templating.d.ts.map

package/dist/runner-input-templating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-input-templating.d.ts","sourceRoot":"","sources":["../src/runner-input-templating.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,OAAO,CAeT"}