@continuous-excellence/testmints-js 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Continuous Excellence
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# Testmints
+
+> **Status: incubating and experimental. Do not integrate Testmints into a project at this time.**
+> Its API, behavior, artifact format, package availability, and release policy may change or be
+> withdrawn without compatibility guarantees.
+
+Testmints gives ordinary tests an explicit shape: **setup → exercise → verify → teardown**.
+It owns phase sequencing and locally acquired resource cleanup, while your test runner and assertion
+library remain yours.
+
+This is an early implementation of `@continuous-excellence/testmints-js`. It supports a
+runner-independent executor, Vitest registration, and an opt-in local phase stream. Cancellation
+policy, task groups, browser reporting, and additional runners are intentionally not available yet.
+
+The test suite is first-class usage documentation: each test should show a realistic scenario while
+also proving the library behavior it relies on.
+
+```ts
+import { expect } from 'vitest'
+import { mintTest } from '@continuous-excellence/testmints-js/vitest'
+
+mintTest('15 produces FizzBuzz', {
+  setup: () => 15,
+  exercise: (input) => fizzBuzz(input),
+  verify: (output) => expect(output).toBe('FizzBuzz'),
+})
+```
+
+## Local phase artifacts with Vitest
+
+Enable the Node/Vitest reporting plugin in `vitest.config.ts`. Existing `mintTest` calls need no
+per-test configuration.
+
+```ts
+import { defineConfig } from 'vitest/config'
+import { testmintsVitest } from '@continuous-excellence/testmints-js/vitest'
+
+export default defineConfig({
+  plugins: [testmintsVitest()],
+})
+```
+
+Each Vitest process writes a run directory under `.testmints/` (or the supplied `outputDir`). Each
+worker appends only to its own NDJSON file. The run manifest records whether reporting completed;
+reporting problems are visible but never turn a test pass into a failure or prevent cleanup.
+
+Inspect a completed run with the package command:
+
+```sh
+testmints inspect .testmints/run-…
+```
+
+```text
+a member can save their display name — FAILED
+  setup        41 ms  passed
+  exercise    184 ms  passed
+  verify        2 ms  failed — expected "Ada", received "Grace"
+  teardown     18 ms  passed
+```
+
+The first reporter is deliberately Node/Vitest-only. It records Testmints phase boundaries and
+does not inspect assertion libraries, capture arbitrary data, or promise cancellation beyond the
+runner signal passed to active phases.
+
+Resources acquired through `scope.using()` survive verification and are released in reverse order,
+including after a failed setup, exercise, or verification.
+
+```ts
+mintTest('a member can save their display name', {
+  setup: async ({ scope }) => ({
+    account: await scope.using('temporary account', createAccount, deleteAccount),
+    displayName: 'Ada',
+  }),
+  exercise: ({ account, displayName }) => updateProfile(account.id, { displayName }),
+  verify: (profile) => expect(profile.displayName).toBe('Ada'),
+})
+```
+
+## Development
+
+`npm run check` runs formatting/lint checks, type fixtures, and the test suite. Every test is both
+evidence for the library and an example of its intended use. Core-contract scenarios also use
+`mintTest`, exercising lower-level bootstrap primitives within that same test shape.
+
+Contributors should begin with [the project philosophy](docs/project-philosophy.md). The
+[library direction log](docs/library-direction.md) captures longer-term design questions that are
+not current commitments. Maintainers can follow the [publishing guide](docs/publishing.md) for the
+one-time `0.0.0` bootstrap and the subsequent trunk-based release flow.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function inspect(directory: string): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAoEA,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkEhE"}

package/dist/cli.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+import { readFile, realpath } from "node:fs/promises";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { readManifest, } from "./reporting.js";
+function usage() {
+    console.error("Usage: testmints inspect <artifact-dir>");
+    process.exit(2);
+}
+function duration(durationMs) {
+    return `${Math.round(durationMs)} ms`;
+}
+async function readEvents(directory, files) {
+    const events = [];
+    let incomplete = false;
+    for (const file of files) {
+        let text;
+        try {
+            text = await readFile(resolve(directory, "events", file), "utf8");
+        }
+        catch {
+            incomplete = true;
+            continue;
+        }
+        const lines = text.split("\n");
+        for (const [index, line] of lines.entries()) {
+            if (line === "")
+                continue;
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch {
+                if (index !== lines.length - 1)
+                    incomplete = true;
+            }
+        }
+    }
+    return { events, incomplete };
+}
+function phaseEvents(events) {
+    return events.filter((event) => event.kind === "phase.end");
+}
+async function readRunnerResults(directory) {
+    try {
+        return (await readFile(resolve(directory, "events", "runner.ndjson"), "utf8"))
+            .trim()
+            .split("\n")
+            .filter((line) => line !== "")
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+export async function inspect(directory) {
+    let manifest;
+    try {
+        manifest = await readManifest(directory);
+    }
+    catch (error) {
+        console.error(`Cannot read Testmints manifest: ${String(error)}`);
+        return 1;
+    }
+    const { events, incomplete: malformed } = await readEvents(directory, manifest.producerFiles);
+    const runnerResults = new Map((await readRunnerResults(directory)).map((result) => [
+        result.testId,
+        result,
+    ]));
+    const attempts = new Map();
+    for (const event of events) {
+        const grouped = attempts.get(event.attemptId) ?? [];
+        grouped.push(event);
+        attempts.set(event.attemptId, grouped);
+    }
+    let failed = false;
+    let interrupted = false;
+    for (const attempt of attempts.values()) {
+        attempt.sort((left, right) => left.seq - right.seq);
+        const started = attempt.find((event) => event.kind === "attempt.start");
+        const ended = attempt.find((event) => event.kind === "attempt.end");
+        if (!started)
+            continue;
+        if (!ended)
+            interrupted = true;
+        const runner = runnerResults.get(started.testId);
+        const attemptFailed = (ended?.kind === "attempt.end" && ended.status === "failed") ||
+            runner?.status === "failed";
+        failed ||= attemptFailed;
+        console.log(`${started.title} — ${attemptFailed ? "FAILED" : "passed"}`);
+        for (const phase of phaseEvents(attempt)) {
+            const detail = phase.status === "failed"
+                ? ` — ${phase.error?.message ?? "failed"}`
+                : phase.status === "skipped"
+                    ? ` — ${phase.reason ?? "skipped"}`
+                    : "";
+            console.log(`  ${phase.phase.padEnd(10)} ${duration(phase.durationMs).padStart(7)}  ${phase.status}${detail}`);
+        }
+        if (runner?.status === "failed" &&
+            ended?.kind === "attempt.end" &&
+            ended.status === "passed") {
+            console.log(`  runner              failed — ${runner.error?.message ?? "failed"}`);
+        }
+    }
+    const incomplete = malformed ||
+        interrupted ||
+        manifest.status !== "complete" ||
+        (manifest.failureFiles?.length ?? 0) > 0;
+    if (incomplete)
+        console.error("Testmints artifacts are incomplete.");
+    return failed || incomplete ? 1 : 0;
+}
+const invokedPath = process.argv[1];
+if (invokedPath !== undefined &&
+    import.meta.url === pathToFileURL(await realpath(invokedPath)).href) {
+    if (process.argv[2] !== "inspect" || process.argv[3] === undefined)
+        usage();
+    process.exitCode = await inspect(resolve(process.argv[3]));
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/core.d.ts

@@ -0,0 +1,78 @@
+export type Awaitable<T> = T | PromiseLike<T>;
+export type PhaseName = "setup" | "exercise" | "verify" | "teardown";
+export type PhaseStatus = "passed" | "failed" | "skipped";
+export interface EventContext {
+    runId: string;
+    producerId: string;
+    attemptId: string;
+    testId: string;
+    title: string;
+}
+export interface EventError {
+    name: string;
+    message: string;
+    stack?: string;
+}
+interface EventBase extends EventContext {
+    v: 1;
+    seq: number;
+    timestamp: string;
+}
+export interface AttemptStartedEvent extends EventBase {
+    kind: "attempt.start";
+}
+export interface AttemptEndedEvent extends EventBase {
+    kind: "attempt.end";
+    status: Exclude<PhaseStatus, "skipped">;
+    error?: EventError;
+}
+export interface PhaseStartedEvent extends EventBase {
+    kind: "phase.start";
+    phase: PhaseName;
+}
+export interface PhaseEndedEvent extends EventBase {
+    kind: "phase.end";
+    phase: PhaseName;
+    status: PhaseStatus;
+    durationMs: number;
+    reason?: string;
+    error?: EventError;
+}
+export type TestmintEvent = AttemptStartedEvent | AttemptEndedEvent | PhaseStartedEvent | PhaseEndedEvent;
+/** Observational only: a sink can never alter test execution. */
+export interface EventSink {
+    emit(event: TestmintEvent): void | PromiseLike<void>;
+}
+export interface PhaseTools {
+    readonly signal: AbortSignal;
+}
+export interface CleanupTools extends PhaseTools {
+}
+export interface ResourceScope {
+    using<T>(name: string, acquire: () => Awaitable<T>, release: (resource: T, tools: CleanupTools) => Awaitable<unknown>): Promise<T>;
+    defer(name: string, release: (tools: CleanupTools) => Awaitable<unknown>): void;
+}
+export interface SetupTools extends PhaseTools {
+    readonly scope: ResourceScope;
+}
+export interface ExerciseTools extends PhaseTools {
+    readonly scope: ResourceScope;
+}
+export interface TestmintDefinition<Input, Output> {
+    setup: (tools: SetupTools) => Awaitable<Input>;
+    exercise: (input: Input, tools: ExerciseTools) => Awaitable<Output>;
+    verify: (output: Output, input: Input, tools: PhaseTools) => Awaitable<unknown>;
+    teardown?: (input: Input, tools: CleanupTools) => Awaitable<unknown>;
+}
+export type ValidatedDefinition<Input, Output> = Readonly<TestmintDefinition<Input, Output>>;
+export interface ExecuteOptions {
+    signal?: AbortSignal;
+    sink?: EventSink;
+    eventContext?: EventContext;
+    /** Supplies a producer-wide event sequence when reporting spans attempts. */
+    nextEventSequence?: () => number;
+}
+export declare function validateDefinition<Input, Output>(candidate: TestmintDefinition<Input, Output>): ValidatedDefinition<Input, Output>;
+export declare function executeDefinition<Input, Output>(definition: ValidatedDefinition<Input, Output>, options?: ExecuteOptions): Promise<void>;
+export {};
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

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

package/dist/core.js

@@ -0,0 +1,250 @@
+const phaseKeys = new Set(["setup", "exercise", "verify", "teardown"]);
+function isDefinitionCandidate(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function requiredCallback(definition, phase) {
+    const callback = definition[phase];
+    if (typeof callback !== "function") {
+        throw new TypeError(`Testmint definition requires a callable ${phase} phase.`);
+    }
+    return (...arguments_) => callback(...arguments_);
+}
+function optionalCallback(definition) {
+    const callback = definition.teardown;
+    if (callback === undefined)
+        return undefined;
+    if (typeof callback !== "function") {
+        throw new TypeError("Testmint teardown must be a function when provided.");
+    }
+    return (...arguments_) => callback(...arguments_);
+}
+export function validateDefinition(candidate) {
+    if (!isDefinitionCandidate(candidate)) {
+        throw new TypeError("A Testmint definition must be an object.");
+    }
+    const definition = candidate;
+    for (const key of Object.keys(definition)) {
+        if (!phaseKeys.has(key)) {
+            throw new TypeError(`Unknown Testmint definition key: ${key}`);
+        }
+    }
+    const setup = requiredCallback(definition, "setup");
+    const exercise = requiredCallback(definition, "exercise");
+    const verify = requiredCallback(definition, "verify");
+    const teardown = optionalCallback(definition);
+    const validated = {
+        setup: (tools) => setup(tools),
+        exercise: (input, tools) => exercise(input, tools),
+        verify: (output, input, tools) => verify(output, input, tools),
+    };
+    return Object.freeze(teardown === undefined
+        ? validated
+        : {
+            ...validated,
+            teardown: (input, tools) => teardown(input, tools),
+        });
+}
+class AttemptScope {
+    #releases = [];
+    #pending = new Set();
+    #closing = false;
+    using(name, acquire, release) {
+        this.assertOpen();
+        const pending = Promise.resolve()
+            .then(acquire)
+            .then((resource) => {
+            this.#releases.push({
+                name,
+                release: (tools) => release(resource, tools),
+            });
+            return resource;
+        });
+        this.#pending.add(pending);
+        void pending
+            .finally(() => this.#pending.delete(pending))
+            .catch(() => undefined);
+        return pending;
+    }
+    defer(name, release) {
+        this.assertOpen();
+        this.#releases.push({ name, release });
+    }
+    async close(tools) {
+        if (this.#closing)
+            return [];
+        this.#closing = true;
+        await Promise.allSettled([...this.#pending]);
+        const errors = [];
+        for (const registration of [...this.#releases].reverse()) {
+            try {
+                await registration.release(tools);
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        return errors;
+    }
+    assertOpen() {
+        if (this.#closing)
+            throw new Error("Cannot acquire or defer a resource after cleanup has begun.");
+    }
+}
+function eventError(error) {
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+            ...(error.stack === undefined ? {} : { stack: error.stack }),
+        };
+    }
+    return { name: "Error", message: String(error) };
+}
+class EventEmitter {
+    sink;
+    context;
+    nextSequence;
+    #sequence = 0;
+    constructor(sink, context, nextSequence) {
+        this.sink = sink;
+        this.context = context;
+        this.nextSequence = nextSequence;
+    }
+    async emit(event) {
+        if (!this.sink)
+            return;
+        const complete = {
+            ...(this.context ?? {
+                runId: "local",
+                producerId: "local",
+                attemptId: "local",
+                testId: "local",
+                title: "local",
+            }),
+            ...event,
+            v: 1,
+            seq: this.nextSequence?.() ?? this.#sequence++,
+            timestamp: new Date().toISOString(),
+        };
+        try {
+            await this.sink.emit(complete);
+        }
+        catch {
+            // Instrumentation is not allowed to affect test behavior in this slice.
+        }
+    }
+}
+async function runPhase(phase, emitter, callback) {
+    const startedAt = performance.now();
+    await emitter.emit({ kind: "phase.start", phase });
+    try {
+        const value = await callback();
+        await emitter.emit({
+            kind: "phase.end",
+            phase,
+            status: "passed",
+            durationMs: performance.now() - startedAt,
+        });
+        return { ok: true, value };
+    }
+    catch (error) {
+        await emitter.emit({
+            kind: "phase.end",
+            phase,
+            status: "failed",
+            durationMs: performance.now() - startedAt,
+            error: eventError(error),
+        });
+        return { ok: false, error };
+    }
+}
+async function skipPhase(emitter, phase, reason) {
+    await emitter.emit({
+        kind: "phase.end",
+        phase,
+        status: "skipped",
+        durationMs: 0,
+        reason,
+    });
+}
+export async function executeDefinition(definition, options = {}) {
+    const scope = new AttemptScope();
+    const emitter = new EventEmitter(options.sink, options.eventContext, options.nextEventSequence);
+    const signal = options.signal ?? new AbortController().signal;
+    const setupTools = { signal, scope };
+    const exerciseTools = { signal, scope };
+    const phaseTools = { signal };
+    const cleanupTools = { signal: new AbortController().signal };
+    let completedSetup;
+    let primaryError;
+    const cleanupErrors = [];
+    await emitter.emit({ kind: "attempt.start" });
+    const setup = await runPhase("setup", emitter, () => definition.setup(setupTools));
+    if (setup.ok) {
+        const input = setup.value;
+        completedSetup = { input };
+        const exercise = await runPhase("exercise", emitter, () => definition.exercise(input, exerciseTools));
+        if (exercise.ok) {
+            const verify = await runPhase("verify", emitter, () => definition.verify(exercise.value, input, phaseTools));
+            if (!verify.ok)
+                primaryError = verify.error;
+        }
+        else {
+            primaryError = exercise.error;
+            await skipPhase(emitter, "verify", "exercise failed");
+        }
+    }
+    else {
+        primaryError = setup.error;
+        await skipPhase(emitter, "exercise", "setup failed");
+        await skipPhase(emitter, "verify", "setup failed");
+    }
+    const teardownStartedAt = performance.now();
+    await emitter.emit({ kind: "phase.start", phase: "teardown" });
+    if (completedSetup && definition.teardown) {
+        try {
+            await definition.teardown(completedSetup.input, cleanupTools);
+        }
+        catch (error) {
+            cleanupErrors.push(error);
+        }
+    }
+    cleanupErrors.push(...(await scope.close(cleanupTools)));
+    if (cleanupErrors.length === 0) {
+        await emitter.emit({
+            kind: "phase.end",
+            phase: "teardown",
+            status: "passed",
+            durationMs: performance.now() - teardownStartedAt,
+        });
+    }
+    else {
+        const teardownError = cleanupErrors.length === 1
+            ? cleanupErrors[0]
+            : new AggregateError(cleanupErrors, "Testmint cleanup failed.");
+        await emitter.emit({
+            kind: "phase.end",
+            phase: "teardown",
+            status: "failed",
+            durationMs: performance.now() - teardownStartedAt,
+            error: eventError(teardownError),
+        });
+    }
+    const finalError = primaryError === undefined && cleanupErrors.length === 0
+        ? undefined
+        : primaryError === undefined
+            ? cleanupErrors.length === 1
+                ? cleanupErrors[0]
+                : new AggregateError(cleanupErrors, "Testmint execution and cleanup failed.")
+            : cleanupErrors.length === 0
+                ? primaryError
+                : new AggregateError([primaryError, ...cleanupErrors], "Testmint execution and cleanup failed.");
+    await emitter.emit({
+        kind: "attempt.end",
+        status: finalError === undefined ? "passed" : "failed",
+        ...(finalError === undefined ? {} : { error: eventError(finalError) }),
+    });
+    if (finalError !== undefined)
+        throw finalError;
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { type Awaitable, type CleanupTools, type EventContext, type EventError, type EventSink, type ExecuteOptions, type ExerciseTools, executeDefinition, type PhaseName, type PhaseTools, type ResourceScope, type SetupTools, type TestmintDefinition, type TestmintEvent, type ValidatedDefinition, validateDefinition, } from "./core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,kBAAkB,GAClB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { executeDefinition, validateDefinition, } from "./core.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAQN,iBAAiB,EAQjB,kBAAkB,GAClB,MAAM,WAAW,CAAC"}

package/dist/reporting.d.ts

@@ -0,0 +1,40 @@
+import type { EventSink, TestmintEvent } from "./core.js";
+export interface ReportingContext {
+    readonly outputDir: string;
+    readonly runId: string;
+}
+export interface RunManifest {
+    v: 1;
+    runId: string;
+    status: "running" | "complete" | "incomplete";
+    producerFiles: string[];
+    failureFiles: string[];
+}
+export interface RunnerResultEvent {
+    v: 1;
+    kind: "runner.result";
+    runId: string;
+    testId: string;
+    title: string;
+    status: "passed" | "failed" | "skipped";
+    timestamp: string;
+    error?: {
+        name: string;
+        message: string;
+    };
+}
+/** A Node-only, append-only sink; each Vitest worker owns its output file. */
+export declare class NdjsonEventSink implements EventSink {
+    #private;
+    private readonly context;
+    constructor(context: ReportingContext);
+    emit(event: TestmintEvent): Promise<void>;
+    private recordFailure;
+}
+export declare function startManifest(context: ReportingContext): Promise<void>;
+export declare function completeManifest(context: ReportingContext, status: "complete" | "incomplete"): Promise<void>;
+export declare function readManifest(directory: string): Promise<RunManifest>;
+export declare function appendRunnerResult(context: ReportingContext, result: Omit<RunnerResultEvent, "v" | "kind" | "runId" | "timestamp" | "error"> & {
+    error?: unknown;
+}): Promise<void>;
+//# sourceMappingURL=reporting.d.ts.map

package/dist/reporting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting.d.ts","sourceRoot":"","sources":["../src/reporting.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC3B,CAAC,EAAE,CAAC,CAAC;IACL,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;IAC9C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IACjC,CAAC,EAAE,CAAC,CAAC;IACL,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAoBD,8EAA8E;AAC9E,qBAAa,eAAgB,YAAW,SAAS;;IAKpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,gBAAgB,EAErD;IAEK,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9C;YAEa,aAAa;CAe3B;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAc5E;AAED,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,UAAU,GAAG,YAAY,GAC/B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAI1E;AAkBD,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,IAAI,CACX,iBAAiB,EACjB,GAAG,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAC9C,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACrB,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/reporting.js

@@ -0,0 +1,115 @@
+import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { threadId } from "node:worker_threads";
+function producerFile(context) {
+    return resolve(context.outputDir, context.runId, "events", `producer-${process.pid}-${threadId}.ndjson`);
+}
+function producerFailureFile(context) {
+    return resolve(context.outputDir, context.runId, "events", `producer-${process.pid}-${threadId}.failure.json`);
+}
+/** A Node-only, append-only sink; each Vitest worker owns its output file. */
+export class NdjsonEventSink {
+    context;
+    #file;
+    #ready;
+    #reportedFailure = false;
+    constructor(context) {
+        this.context = context;
+        this.#file = producerFile(context);
+    }
+    async emit(event) {
+        try {
+            this.#ready ??= mkdir(resolve(this.#file, ".."), {
+                recursive: true,
+            }).then(() => undefined);
+            await this.#ready;
+            await appendFile(this.#file, `${JSON.stringify(event)}\n`, "utf8");
+        }
+        catch (error) {
+            await this.recordFailure(error);
+            throw error;
+        }
+    }
+    async recordFailure(error) {
+        if (this.#reportedFailure)
+            return;
+        this.#reportedFailure = true;
+        const detail = runnerError(error);
+        try {
+            await writeFile(producerFailureFile(this.context), JSON.stringify(detail), "utf8");
+        }
+        catch {
+            // The original I/O failure is reported below even when its marker cannot persist.
+        }
+        console.error("Testmints reporting could not write a phase event.", error);
+    }
+}
+export async function startManifest(context) {
+    const directory = resolve(context.outputDir, context.runId);
+    await mkdir(directory, { recursive: true });
+    await writeFile(resolve(directory, "manifest.json"), JSON.stringify({
+        v: 1,
+        runId: context.runId,
+        status: "running",
+        producerFiles: [],
+        failureFiles: [],
+    }), "utf8");
+}
+export async function completeManifest(context, status) {
+    const directory = resolve(context.outputDir, context.runId);
+    const events = resolve(directory, "events");
+    let producerFiles = [];
+    let failureFiles = [];
+    try {
+        const { readdir } = await import("node:fs/promises");
+        const files = await readdir(events);
+        producerFiles = files.filter((file) => file.startsWith("producer-") && file.endsWith(".ndjson"));
+        failureFiles = files.filter((file) => file.startsWith("producer-") && file.endsWith(".failure.json"));
+        if (failureFiles.length > 0)
+            status = "incomplete";
+    }
+    catch {
+        status = "incomplete";
+    }
+    await writeFile(resolve(directory, "manifest.json"), JSON.stringify({
+        v: 1,
+        runId: context.runId,
+        status,
+        producerFiles,
+        failureFiles,
+    }), "utf8");
+}
+export async function readManifest(directory) {
+    return JSON.parse(await readFile(resolve(directory, "manifest.json"), "utf8"));
+}
+function runnerError(error) {
+    if (error instanceof Error)
+        return { name: error.name, message: error.message };
+    if (error !== null && typeof error === "object") {
+        const candidate = error;
+        return {
+            name: typeof candidate.name === "string" ? candidate.name : "Error",
+            message: typeof candidate.message === "string"
+                ? candidate.message
+                : String(error),
+        };
+    }
+    return { name: "Error", message: String(error) };
+}
+export async function appendRunnerResult(context, result) {
+    const file = resolve(context.outputDir, context.runId, "events", "runner.ndjson");
+    await mkdir(resolve(file, ".."), { recursive: true });
+    await appendFile(file, `${JSON.stringify({
+        v: 1,
+        kind: "runner.result",
+        runId: context.runId,
+        testId: result.testId,
+        title: result.title,
+        status: result.status,
+        timestamp: new Date().toISOString(),
+        ...(result.error === undefined
+            ? {}
+            : { error: runnerError(result.error) }),
+    })}\n`, "utf8");
+}
+//# sourceMappingURL=reporting.js.map

package/dist/reporting.js.map

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

package/dist/vitest.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from "vite";
+import { type TestmintDefinition } from "./core.js";
+export interface TestmintsVitestOptions {
+    /** Root directory for run artifacts. Defaults to `.testmints`. */
+    outputDir?: string;
+}
+/** Register a complete Testmint definition with Vitest. */
+export declare function mintTest<Input, Output>(name: string, definition: TestmintDefinition<Input, Output>): void;
+/** Enable local Testmints NDJSON artifacts for a Node Vitest project. */
+export declare function testmintsVitest(options?: TestmintsVitestOptions): Plugin;
+//# sourceMappingURL=vitest.d.ts.map

package/dist/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../src/vitest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAInC,OAAO,EAEN,KAAK,kBAAkB,EAEvB,MAAM,WAAW,CAAC;AASnB,MAAM,WAAW,sBAAsB;IACtC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAaD,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EACrC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,GAC3C,IAAI,CAsBN;AAyDD,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,MAAM,CA4B5E"}

package/dist/vitest.js

@@ -0,0 +1,109 @@
+import { threadId } from "node:worker_threads";
+import { inject, test } from "vitest";
+import { executeDefinition, validateDefinition, } from "./core.js";
+import { appendRunnerResult, completeManifest, NdjsonEventSink, startManifest, } from "./reporting.js";
+function reportingContext() {
+    return inject("testmints");
+}
+function id() {
+    return crypto.randomUUID();
+}
+const producerId = `${process.pid}-${threadId}`;
+let producerSequence = 0;
+/** Register a complete Testmint definition with Vitest. */
+export function mintTest(name, definition) {
+    const validated = validateDefinition(definition);
+    test(name, async (context) => {
+        const reporting = reportingContext();
+        const task = context.task;
+        await executeDefinition(validated, {
+            signal: context.signal,
+            ...(reporting === undefined
+                ? {}
+                : {
+                    sink: new NdjsonEventSink(reporting),
+                    eventContext: {
+                        runId: reporting.runId,
+                        producerId,
+                        attemptId: id(),
+                        testId: task.id,
+                        title: task.fullName,
+                    },
+                    nextEventSequence: () => producerSequence++,
+                }),
+        });
+    });
+}
+class TestmintsReporter {
+    context;
+    #incomplete = false;
+    constructor(context) {
+        this.context = context;
+    }
+    async onTestRunStart() {
+        try {
+            await startManifest(this.context);
+        }
+        catch (error) {
+            this.#incomplete = true;
+            console.error("Testmints reporting could not create its artifact directory.", error);
+        }
+    }
+    async onTestRunEnd() {
+        try {
+            await completeManifest(this.context, this.#incomplete ? "incomplete" : "complete");
+        }
+        catch (error) {
+            console.error("Testmints reporting could not finalize its artifacts.", error);
+        }
+    }
+    async onTestCaseResult(testCase) {
+        const result = testCase.result();
+        if (result.state === "pending")
+            return;
+        try {
+            await appendRunnerResult(this.context, {
+                testId: testCase.id,
+                title: testCase.fullName,
+                status: result.state,
+                ...(result.errors?.[0] === undefined
+                    ? {}
+                    : { error: result.errors[0] }),
+            });
+        }
+        catch (error) {
+            this.#incomplete = true;
+            console.error("Testmints reporting could not record a Vitest outcome.", error);
+        }
+    }
+}
+/** Enable local Testmints NDJSON artifacts for a Node Vitest project. */
+export function testmintsVitest(options = {}) {
+    const outputDir = options.outputDir ?? ".testmints";
+    const context = {
+        outputDir,
+        runId: `run-${new Date().toISOString().replaceAll(":", "-")}-${id()}`,
+    };
+    const plugin = {
+        name: "testmints-vitest",
+        config: (config) => {
+            const configured = config.test?.reporters;
+            const reporters = configured === undefined
+                ? []
+                : Array.isArray(configured)
+                    ? configured
+                    : [configured];
+            return {
+                test: {
+                    provide: { testmints: context },
+                    reporters: [
+                        ...(reporters.length === 0 ? ["default"] : reporters),
+                        new TestmintsReporter(context),
+                    ],
+                },
+            };
+        },
+    };
+    return plugin;
+}
+//# sourceMappingURL=vitest.js.map

package/dist/vitest.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+	"name": "@continuous-excellence/testmints-js",
+	"version": "0.0.1",
+	"description": "Readable tests with explicit setup, exercise, verify, and teardown phases.",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/robertfmurdock/testmints-js.git"
+	},
+	"bugs": {
+		"url": "https://github.com/robertfmurdock/testmints-js/issues"
+	},
+	"homepage": "https://github.com/robertfmurdock/testmints-js#readme",
+	"type": "module",
+	"bin": {
+		"testmints": "./dist/cli.js"
+	},
+	"packageManager": "npm@11.19.1",
+	"engines": {
+		"node": ">=22",
+		"npm": ">=11"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./vitest": {
+			"types": "./dist/vitest.d.ts",
+			"import": "./dist/vitest.js"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"peerDependencies": {
+		"vitest": "^5.0.0"
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"typecheck": "tsc -p tsconfig.json --noEmit && tsc -p test/types/tsconfig.json --noEmit",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"lint": "biome check .",
+		"format": "biome check --write .",
+		"check": "npm run lint && npm run typecheck && npm run test",
+		"release:version": "bash scripts/release-version.sh",
+		"release:pack": "npm run build && node scripts/pack-release.mjs",
+		"release:verify": "node scripts/verify-release-package.mjs",
+		"release:tag": "bash scripts/tag-release.sh"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.5.14",
+		"@continuous-excellence/tagger": "3.6.18",
+		"@types/node": "^26.6.1",
+		"typescript": "^7.0.2",
+		"vitest": "^5.0.1"
+	}
+}