@alchemy.run/test 0.0.0 → 2.0.0-beta.85

package/lib/FileLog.js

@@ -0,0 +1,136 @@
+import { closeSync, constants, openSync, writeSync } from "node:fs";
+/**
+ * Persistent run log: every test's pass/failure followed by its captured
+ * output, appended to `.alchemy/log/test.log` as the run progresses —
+ * color-free so agents and tooling can read it directly.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import { formatPlanPreview } from "./Plan.js";
+const formatDuration = (ms) => ms >= 1000 ? `${(ms / 1000).toFixed(1)}s` : `${Math.round(ms)}ms`;
+const formatLogs = (logs) => logs.map((log) => log.message).join("\n");
+const GLYPH = {
+    pass: "PASS",
+    fail: "FAIL",
+    skip: "SKIP",
+    todo: "TODO",
+};
+/** Render an event as a log chunk; `undefined` = nothing to write. */
+export const formatEvent = (event) => {
+    switch (event._tag) {
+        case "PlanPreview":
+            return `${formatPlanPreview(event.phases)}\n`;
+        case "PlanPhaseStart":
+            return `Plan phase ${event.phase}/${event.phases}: ${event.tests} tests\n`;
+        case "RunStart":
+            return `running ${event.tests.length} tests from ${event.files} files (${new Date().toISOString()})\n\n`;
+        case "TestEnd": {
+            const title = `${event.test.file} > ${event.test.titlePath.join(" > ")}`;
+            const retries = event.result.retries > 0 ? ` [retried x${event.result.retries}]` : "";
+            const lines = [
+                `${GLYPH[event.result.status]} ${title} (${formatDuration(event.result.durationMs)})${retries}`,
+            ];
+            if (event.result.error !== undefined) {
+                lines.push(event.result.error);
+            }
+            if (event.result.logs.length > 0) {
+                lines.push("--- captured output ---");
+                lines.push(formatLogs(event.result.logs));
+                lines.push("--- end output ---");
+            }
+            // One line per plain result; a blank separator only after multi-line
+            // entries (error/output blocks) so they don't run into the next entry.
+            return lines.length === 1 ? `${lines[0]}\n` : `${lines.join("\n")}\n\n`;
+        }
+        case "FileEnd": {
+            const lines = [];
+            if (event.error !== undefined) {
+                lines.push(`FAIL ${event.file} failed to run`, event.error);
+            }
+            if (event.logs.length > 0) {
+                lines.push(`--- file hook output (${event.file}) ---`);
+                lines.push(formatLogs(event.logs));
+                lines.push("--- end output ---");
+            }
+            return lines.length === 0 ? undefined : `${lines.join("\n")}\n\n`;
+        }
+        case "RunEnd": {
+            const s = event.summary;
+            return (`Tests: ${s.failed} failed | ${s.passed} passed` +
+                (s.skipped > 0 ? ` | ${s.skipped} skipped` : "") +
+                (s.todo > 0 ? ` | ${s.todo} todo` : "") +
+                (s.plan
+                    ? ` | ${s.plan.found} found | ${s.plan.selected} selected by plan | ${s.plan.excluded} excluded by plan`
+                    : "") +
+                ` (${s.files} files, ${formatDuration(s.durationMs)})\n`);
+        }
+        default:
+            return undefined;
+    }
+};
+const LOG_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
+/**
+ * Delete sibling run logs whose mtime (from stat — file names are never
+ * trusted) is older than a week, so the per-run log directory can't grow
+ * unboundedly. Best-effort: failures are ignored.
+ */
+const pruneOldLogs = Effect.fn(function* (dir) {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const entries = yield* fs
+        .readDirectory(dir)
+        .pipe(Effect.orElseSucceed(() => []));
+    const cutoff = Date.now() - LOG_RETENTION_MS;
+    for (const entry of entries) {
+        if (!entry.endsWith(".log"))
+            continue;
+        const file = path.join(dir, entry);
+        const info = yield* fs.stat(file).pipe(Effect.orElseSucceed(() => undefined));
+        const mtime = info === undefined ? undefined : Option.getOrUndefined(info.mtime);
+        if (mtime !== undefined && mtime.getTime() < cutoff) {
+            yield* fs.remove(file).pipe(Effect.ignore);
+        }
+    }
+});
+/** Create (truncate) the log file and return an event appender. */
+export const makeFileLog = Effect.fn(function* (logFile) {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    yield* fs.makeDirectory(path.dirname(logFile), { recursive: true }).pipe(Effect.ignore);
+    yield* pruneOldLogs(path.dirname(logFile));
+    const fd = yield* Effect.sync(() => openSync(logFile, constants.O_WRONLY | constants.O_CREAT | constants.O_TRUNC | constants.O_APPEND));
+    let closed = false;
+    const write = (text) => {
+        if (closed)
+            return;
+        const bytes = Buffer.from(text);
+        let offset = 0;
+        while (offset < bytes.length) {
+            offset += writeSync(fd, bytes, offset, bytes.length - offset);
+        }
+    };
+    const append = (event) => Effect.sync(() => {
+        const chunk = formatEvent(event);
+        if (chunk !== undefined)
+            write(chunk);
+    });
+    const appendLine = (label, entry) => {
+        write(`[${label}] ${entry.message}\n`);
+    };
+    const close = Effect.sync(() => {
+        if (closed)
+            return;
+        closed = true;
+        closeSync(fd);
+    });
+    yield* Effect.addFinalizer(() => close);
+    return {
+        append,
+        appendHookLine: (file, entry) => appendLine(`hook ${file}`, entry),
+        appendTestLine: (id, entry) => appendLine(`test ${id}`, entry),
+        close,
+    };
+});
+//# sourceMappingURL=FileLog.js.map

package/lib/FileLog.js.map

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

package/lib/Http.d.ts

@@ -0,0 +1,109 @@
+import * as Effect from "effect/Effect";
+import * as HttpClient from "effect/http/HttpClient";
+import * as HttpClientRequest from "effect/http/HttpClientRequest";
+import type { HttpClientResponse } from "effect/http/HttpClientResponse";
+import * as Layer from "effect/Layer";
+import * as RpcClient from "effect/rpc/RpcClient";
+import * as RpcSerialization from "effect/rpc/RpcSerialization";
+import * as Schedule from "effect/Schedule";
+declare const WorkerNotReady_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "WorkerNotReady";
+} & Readonly<A>;
+/**
+ * A freshly-deployed Cloudflare Worker is not instantly reachable over HTTP.
+ * Its `workers.dev` route, the script, and each binding (R2 / D1 / DO / Secrets
+ * Store) propagate to the edge independently and asynchronously, so the first
+ * requests to a new URL can transiently return:
+ *
+ *  - `404` while the `workers.dev` subdomain / route is still propagating
+ *    (Cloudflare serves its "There is nothing here yet" placeholder), or
+ *  - `5xx` while the script is up but a binding it depends on isn't ready yet.
+ *
+ * This is ordinary eventual consistency that belongs at the call site, not in
+ * the resource provider — the provider returning before every edge PoP has
+ * converged is correct. Consumers ride out the window by retrying the request.
+ */
+export declare class WorkerNotReady extends WorkerNotReady_base<{
+    status: number;
+}> {
+}
+export interface WhenReadyOptions {
+    /** Max retry attempts before surfacing {@link WorkerNotReady}. Default `20`. */
+    times?: number;
+}
+/**
+ * Execute an arbitrary {@link HttpClientRequest.HttpClientRequest}, retrying
+ * through the Cloudflare cold-start window ({@link isColdStartStatus}) until the
+ * Worker serves a non-transient response. The returned response can carry any
+ * non-cold-start status (e.g. `200`, `202`, `401`) for the caller to assert on.
+ */
+export declare const executeWhenReady: (request: HttpClientRequest.HttpClientRequest, options?: WhenReadyOptions) => Effect.Effect<HttpClientResponse, unknown, HttpClient.HttpClient>;
+/**
+ * Convenience wrapper over {@link executeWhenReady} for a plain `GET`.
+ */
+export declare const getWhenReady: (url: string, options?: WhenReadyOptions) => Effect.Effect<HttpClientResponse, unknown, HttpClient.HttpClient>;
+/**
+ * Options for the edge-transient response guard applied by
+ * {@link guardContentType} / {@link rpcClientLayer}. Pass per suite via
+ * `Test.make({ http: { ... } })` or per call site.
+ */
+export interface EdgeGuardOptions {
+    /**
+     * Retry schedule for edge-transient responses (and transport errors).
+     * Default: exponential from 500ms capped at 3s.
+     */
+    schedule?: Schedule.Schedule<unknown, unknown>;
+    /** Max transport-level retry attempts. Default `5`. */
+    times?: number;
+}
+/**
+ * Guard an `HttpClient` against edge-generated bodies on a freshly deployed
+ * Worker URL.
+ *
+ * Protocol clients like effect RPC's `layerProtocolHttp` never inspect the
+ * response status or content-type — they pipe the raw body straight into the
+ * serialization parser, so every edge-generated HTML page (the workers.dev
+ * placeholder, which serves with HTTP **200**; 1101/1102 error pages;
+ * 429/1015 rate limits) surfaces as an opaque decode defect (e.g.
+ * `RpcClientDefect: Error decoding HTTP response`).
+ *
+ * This transform rejects any response whose `content-type` doesn't match the
+ * expected one as a typed `HttpClientError` that records the status + a body
+ * snippet — so a failure names its cause — and retries the request through a
+ * bounded schedule so callers ride out the cold-start window
+ * ({@link WorkerNotReady} documents why this belongs at the call site).
+ */
+export declare const guardContentType: (contentType: string, options?: EdgeGuardOptions) => (client: HttpClient.HttpClient) => HttpClient.HttpClient;
+/**
+ * A fetch-backed `HttpClient` layer wrapped with {@link guardContentType}.
+ *
+ * Deliberately a standalone layer rather than a transform of the ambient
+ * test `HttpClient`: the ambient client also serves the engine's own cloud
+ * API calls during `deploy`/`destroy` and distilled SDK calls in
+ * `test.provider` bodies, which must NOT be subjected to this guard.
+ */
+export declare const guardedFetchLayer: (contentType: string, options?: EdgeGuardOptions) => Layer.Layer<HttpClient.HttpClient>;
+/**
+ * Complete RPC-over-HTTP client transport for driving a deployed Worker:
+ * `RpcClient.layerProtocolHttp` + the given serialization (ndjson by
+ * default) + a {@link guardedFetchLayer} expecting that serialization's
+ * content-type.
+ *
+ * ```ts
+ * const client = yield* RpcClient.make(WorkerRpcs);
+ * // ...
+ * }).pipe(Effect.scoped, Effect.provide(Test.Http.rpcClientLayer(url)));
+ * ```
+ */
+export declare const rpcClientLayer: (url: string, options?: EdgeGuardOptions & {
+    /** RPC wire serialization. Default {@link RpcSerialization.ndjson}. */
+    serialization?: RpcSerialization.RpcSerialization["Service"];
+    /**
+     * Set `false` to skip the edge guard entirely and use a plain fetch
+     * transport — e.g. for a test that asserts on the raw edge behavior
+     * itself. Default `true`.
+     */
+    guard?: boolean;
+}) => Layer.Layer<RpcClient.Protocol>;
+export {};
+//# sourceMappingURL=Http.d.ts.map

package/lib/Http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Http.d.ts","sourceRoot":"","sources":["../src/Http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,iBAAiB,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,gBAAgB,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;;;;AAE5C;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAe,SAAQ,oBAAmC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;CAAG;AAU7F,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,YAClB,iBAAiB,CAAC,iBAAiB,YAClC,gBAAgB,KACzB,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,OAAO,EAAE,UAAU,CAAC,UAAU,CAiB/D,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,YAAY,QAClB,MAAM,YACD,gBAAgB,KACzB,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,OAAO,EAAE,UAAU,CAAC,UAAU,CACZ,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,gBACb,MAAM,YAAY,gBAAgB,cACvC,UAAU,CAAC,UAAU,KAAG,UAAU,CAAC,UA4BzC,CAAC;AAEN;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,gBACf,MAAM,YACT,gBAAgB,KACzB,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAMU,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,QACpB,MAAM,YACD,gBAAgB,GAAG;IAC3B,uEAAuE;IACvE,aAAa,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC7D;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,KACA,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAUhC,CAAC"}

package/lib/Http.js

@@ -0,0 +1,123 @@
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import * as HttpClient from "effect/http/HttpClient";
+import { DecodeError, HttpClientError } from "effect/http/HttpClientError";
+import * as HttpClientRequest from "effect/http/HttpClientRequest";
+import * as Layer from "effect/Layer";
+import * as RpcClient from "effect/rpc/RpcClient";
+import * as RpcSerialization from "effect/rpc/RpcSerialization";
+import * as Schedule from "effect/Schedule";
+/**
+ * A freshly-deployed Cloudflare Worker is not instantly reachable over HTTP.
+ * Its `workers.dev` route, the script, and each binding (R2 / D1 / DO / Secrets
+ * Store) propagate to the edge independently and asynchronously, so the first
+ * requests to a new URL can transiently return:
+ *
+ *  - `404` while the `workers.dev` subdomain / route is still propagating
+ *    (Cloudflare serves its "There is nothing here yet" placeholder), or
+ *  - `5xx` while the script is up but a binding it depends on isn't ready yet.
+ *
+ * This is ordinary eventual consistency that belongs at the call site, not in
+ * the resource provider — the provider returning before every edge PoP has
+ * converged is correct. Consumers ride out the window by retrying the request.
+ */
+export class WorkerNotReady extends Data.TaggedError("WorkerNotReady") {
+}
+/**
+ * Status codes that indicate the edge hasn't finished converging on a fresh
+ * deploy. Deliberate client errors (`401`, `403`, `400`, …) are NOT in this
+ * set, so assertions on those statuses still observe them immediately rather
+ * than being retried away.
+ */
+const isColdStartStatus = (status) => status === 404 || status >= 500;
+/**
+ * Execute an arbitrary {@link HttpClientRequest.HttpClientRequest}, retrying
+ * through the Cloudflare cold-start window ({@link isColdStartStatus}) until the
+ * Worker serves a non-transient response. The returned response can carry any
+ * non-cold-start status (e.g. `200`, `202`, `401`) for the caller to assert on.
+ */
+export const executeWhenReady = (request, options) => Effect.gen(function* () {
+    const client = yield* HttpClient.HttpClient;
+    return yield* client.execute(request).pipe(Effect.flatMap((response) => isColdStartStatus(response.status)
+        ? Effect.fail(new WorkerNotReady({ status: response.status }))
+        : Effect.succeed(response)), Effect.retry({
+        while: (error) => error instanceof WorkerNotReady,
+        schedule: Schedule.max([
+            Schedule.exponential("500 millis"),
+            Schedule.recurs(options?.times ?? 20),
+        ]),
+    }));
+});
+/**
+ * Convenience wrapper over {@link executeWhenReady} for a plain `GET`.
+ */
+export const getWhenReady = (url, options) => executeWhenReady(HttpClientRequest.get(url), options);
+const defaultGuardSchedule = Schedule.min([
+    Schedule.exponential("500 millis"),
+    Schedule.spaced("3 seconds"),
+]);
+/**
+ * Guard an `HttpClient` against edge-generated bodies on a freshly deployed
+ * Worker URL.
+ *
+ * Protocol clients like effect RPC's `layerProtocolHttp` never inspect the
+ * response status or content-type — they pipe the raw body straight into the
+ * serialization parser, so every edge-generated HTML page (the workers.dev
+ * placeholder, which serves with HTTP **200**; 1101/1102 error pages;
+ * 429/1015 rate limits) surfaces as an opaque decode defect (e.g.
+ * `RpcClientDefect: Error decoding HTTP response`).
+ *
+ * This transform rejects any response whose `content-type` doesn't match the
+ * expected one as a typed `HttpClientError` that records the status + a body
+ * snippet — so a failure names its cause — and retries the request through a
+ * bounded schedule so callers ride out the cold-start window
+ * ({@link WorkerNotReady} documents why this belongs at the call site).
+ */
+export const guardContentType = (contentType, options) => (client) => client.pipe(HttpClient.transform((effect, request) => Effect.flatMap(effect, (response) => {
+    const observed = response.headers["content-type"] ?? "";
+    if (observed.includes(contentType)) {
+        return Effect.succeed(response);
+    }
+    return response.text.pipe(Effect.orElseSucceed(() => "<unreadable body>"), Effect.flatMap((body) => Effect.fail(new HttpClientError({
+        reason: new DecodeError({
+            request,
+            response,
+            description: `expected "${contentType}", got "${observed}" (status ${response.status}): ${body.slice(0, 200)}`,
+        }),
+    }))));
+})), HttpClient.retry({
+    schedule: options?.schedule ?? defaultGuardSchedule,
+    times: options?.times ?? 5,
+}));
+/**
+ * A fetch-backed `HttpClient` layer wrapped with {@link guardContentType}.
+ *
+ * Deliberately a standalone layer rather than a transform of the ambient
+ * test `HttpClient`: the ambient client also serves the engine's own cloud
+ * API calls during `deploy`/`destroy` and distilled SDK calls in
+ * `test.provider` bodies, which must NOT be subjected to this guard.
+ */
+export const guardedFetchLayer = (contentType, options) => Layer.effect(HttpClient.HttpClient)(Effect.gen(function* () {
+    const client = yield* HttpClient.HttpClient;
+    return guardContentType(contentType, options)(client);
+})).pipe(Layer.provide(FetchHttpClient.layer));
+/**
+ * Complete RPC-over-HTTP client transport for driving a deployed Worker:
+ * `RpcClient.layerProtocolHttp` + the given serialization (ndjson by
+ * default) + a {@link guardedFetchLayer} expecting that serialization's
+ * content-type.
+ *
+ * ```ts
+ * const client = yield* RpcClient.make(WorkerRpcs);
+ * // ...
+ * }).pipe(Effect.scoped, Effect.provide(Test.Http.rpcClientLayer(url)));
+ * ```
+ */
+export const rpcClientLayer = (url, options) => {
+    const serialization = options?.serialization ?? RpcSerialization.ndjson;
+    return RpcClient.layerProtocolHttp({ url }).pipe(Layer.provide(options?.guard === false
+        ? FetchHttpClient.layer
+        : guardedFetchLayer(serialization.contentType, options)), Layer.provide(Layer.succeed(RpcSerialization.RpcSerialization, serialization)));
+};
+//# sourceMappingURL=Http.js.map

package/lib/Http.js.map

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

package/lib/Model.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Core data model for the alchemy-test harness.
+ *
+ * A test file is collected into a tree of {@link Suite}s and {@link TestCase}s
+ * by evaluating its module body (describe/test calls register nodes). The
+ * runner then walks the tree and executes every test as an Effect.
+ */
+import type * as Effect from "effect/Effect";
+import { type Tags } from "./Tags.ts";
+/** Execution mode attached to a suite or test at registration time. */
+export type Mode = "run" | "skip" | "only" | "todo";
+/** A single log line captured from a test's Effect Logger or Console. */
+export interface LogEntry {
+    readonly level: string;
+    readonly message: string;
+    readonly time: Date;
+}
+/**
+ * The body of a test. Always an Effect — plain-function tests are wrapped
+ * at registration time. The Effect must be self-contained (R = never);
+ * wrapping (scope, TestClock/TestConsole, shared layers) happens in the
+ * harness closures, NOT in the runner.
+ */
+export type TestBody = () => Effect.Effect<unknown, unknown, never>;
+/** A hook body. Same contract as {@link TestBody}. */
+export type HookBody = () => Effect.Effect<unknown, unknown, never>;
+/** `true` for the whole-process lock, or a label naming a narrower lock. */
+export type Exclusive = boolean | string;
+export interface Hook {
+    readonly body: HookBody;
+    readonly timeout?: number | undefined;
+    /**
+     * `true` takes the whole-process write lock for this hook. A label (e.g.
+     * `"hetzner"`) only serializes the hook with tests and hooks holding the
+     * same label — use it for deploys that consume a scarce cloud quota.
+     */
+    readonly exclusive?: Exclusive;
+}
+export interface TestCase {
+    /** Deduplicated labels, including tags inherited from suites. */
+    readonly tags: ReadonlyArray<string>;
+    /** Inherited tags requiring explicit selection. */
+    readonly optInTags: ReadonlyArray<string>;
+    readonly type: "test";
+    readonly name: string;
+    readonly mode: Mode;
+    /** Invert the result: the test passes only if the body fails. */
+    readonly fails?: boolean;
+    /**
+     * `true` runs this test with the whole-process write lock: no other test
+     * in the run executes concurrently with it. Required for tests that mutate
+     * process-global state (e.g. `process.env.PATH`) — the runner executes
+     * everything in ONE bun process, so such mutations are visible everywhere.
+     *
+     * A label (e.g. `"hetzner"`) only serializes the test with others holding
+     * the same label — use it for a shared cloud quota, not global state.
+     */
+    readonly exclusive?: Exclusive;
+    /** Override the run-wide retry budget for this test. */
+    readonly retry?: number | undefined;
+    readonly timeout?: number | undefined;
+    readonly body: TestBody | undefined;
+    readonly parent: Suite;
+}
+export interface Suite {
+    /** Deduplicated labels, including tags inherited from parent suites. */
+    readonly tags: ReadonlyArray<string>;
+    /** Inherited tags requiring explicit selection. */
+    readonly optInTags: ReadonlyArray<string>;
+    readonly type: "suite";
+    readonly name: string;
+    mode: Mode;
+    /** When true, children run one at a time (the default; describe.concurrent opts out). */
+    sequential: boolean;
+    readonly children: Array<Suite | TestCase>;
+    readonly beforeAll: Array<Hook>;
+    readonly afterAll: Array<Hook>;
+    readonly beforeEach: Array<Hook>;
+    readonly afterEach: Array<Hook>;
+    readonly parent: Suite | undefined;
+}
+/** The root suite of a single test file. */
+export interface FileSuite extends Suite {
+    /** Path relative to the run root, e.g. `test/Cloudflare/R2/Bucket.test.ts`. */
+    readonly file: string;
+    /** Framework resources, disposed even when user hooks are skipped. */
+    readonly cleanups: Array<Hook>;
+}
+export declare const makeSuite: (name: string, parent: Suite | undefined, mode?: Mode, tags?: Tags, optInTags?: Tags) => Suite;
+export declare const makeFileSuite: (file: string) => FileSuite;
+/** Full title path from the file root down to (and including) this node. */
+export declare const titlePath: (node: Suite | TestCase) => ReadonlyArray<string>;
+export declare const fullTitle: (node: Suite | TestCase) => string;
+/** Walk every test in a suite subtree (depth-first, registration order). */
+export declare const forEachTest: (suite: Suite, f: (test: TestCase) => void) => void;
+/** True if the subtree contains a node marked `only`. */
+export declare const containsOnly: (suite: Suite) => boolean;
+//# sourceMappingURL=Model.d.ts.map

package/lib/Model.d.ts.map

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

package/lib/Model.js

@@ -0,0 +1,59 @@
+import { mergeTags } from "./Tags.js";
+export const makeSuite = (name, parent, mode = "run", tags, optInTags) => ({
+    tags: mergeTags(parent?.tags ?? [], tags),
+    optInTags: mergeTags(parent?.optInTags ?? [], optInTags),
+    type: "suite",
+    name,
+    mode,
+    sequential: true,
+    children: [],
+    beforeAll: [],
+    afterAll: [],
+    beforeEach: [],
+    afterEach: [],
+    parent,
+});
+export const makeFileSuite = (file) => ({
+    ...makeSuite(file, undefined),
+    file,
+    cleanups: [],
+});
+/** Full title path from the file root down to (and including) this node. */
+export const titlePath = (node) => {
+    const parts = [];
+    let current = node;
+    while (current !== undefined) {
+        // Skip the file-root suite name (it's reported separately as `file`).
+        if (current.parent !== undefined || current.type === "test") {
+            parts.unshift(current.name);
+        }
+        else if (current.parent === undefined && current.type === "suite") {
+            // file root — stop
+        }
+        current = current.parent;
+    }
+    return parts;
+};
+export const fullTitle = (node) => titlePath(node).join(" > ");
+/** Walk every test in a suite subtree (depth-first, registration order). */
+export const forEachTest = (suite, f) => {
+    for (const child of suite.children) {
+        if (child.type === "test")
+            f(child);
+        else
+            forEachTest(child, f);
+    }
+};
+/** True if the subtree contains a node marked `only`. */
+export const containsOnly = (suite) => {
+    if (suite.mode === "only")
+        return true;
+    for (const child of suite.children) {
+        if (child.type === "test" && child.mode === "only")
+            return true;
+        if (child.type === "suite" && containsOnly(child))
+            return true;
+    }
+    return false;
+};
+//# sourceMappingURL=Model.js.map

package/lib/Model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Model.js","sourceRoot":"","sources":["../src/Model.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAa,MAAM,WAAW,CAAC;AA0FjD,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,IAAY,EACZ,MAAyB,EACzB,IAAI,GAAS,KAAK,EAClB,IAAW,EACX,SAAgB,EACT,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC;IACzC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,EAAE,SAAS,CAAC;IACxD,IAAI,EAAE,OAAO;IACb,IAAI;IACJ,IAAI;IACJ,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,EAAE;IACb,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAa,EAAE,CAAC,CAAC;IACzD,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC;IAC7B,IAAI;IACJ,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAsB,EAAyB,EAAE;IACzE,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,IAAI,OAAO,GAAiC,IAAI,CAAC;IACjD,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;QAC7B,sEAAsE;QACtE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5D,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACpE,mBAAmB;QACrB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAsB,EAAU,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAEzF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAY,EAAE,CAA2B,EAAQ,EAAE;IAC7E,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,CAAC,CAAC,KAAK,CAAC,CAAC;;YAC/B,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAY,EAAW,EAAE;IACpD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAChE,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IACjE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/lib/PlainReporter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Line-oriented reporter for non-interactive terminals and CI.
+ *
+ * Reports progress through the collection phase (importing a large suite's
+ * files takes tens of seconds before any test can run), then logs one line per
+ * test as it finishes, prefixed with a `[done/total]` counter (failures include
+ * their error and captured output inline); if nothing finishes for 10s it
+ * prints the list of currently-running tests; at the end every failure is
+ * repeated consolidated.
+ */
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import type { LogEntry } from "./Model.ts";
+import { Reporter, type RunSummary } from "./Reporter.ts";
+export declare const printSummary: (summary: RunSummary, 
+/** Buffered deploy/destroy output per file, printed once per failing file. */
+hookLogs?: ReadonlyMap<string, ReadonlyArray<LogEntry>>) => Effect.Effect<void>;
+export declare const PlainReporterLive: Layer.Layer<Reporter>;
+//# sourceMappingURL=PlainReporter.d.ts.map

package/lib/PlainReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlainReporter.d.ts","sourceRoot":"","sources":["../src/PlainReporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAmC,MAAM,eAAe,CAAC;AA4S3F,eAAO,MAAM,YAAY,YACd,UAAU;AACnB,8EAA8E;WACnE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,KACtD,MAAM,CAAC,MAAM,CAAC,IAAI,CA4DjB,CAAC;AAEL,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CA6ClD,CAAC"}