testdelta 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TestDelta contributors
+
+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,153 @@
+# testdelta
+
+> Prove that changed tests fail before a patch and pass after it.
+
+`testdelta` is a local-first, language-independent CLI for regression-test proof. It runs the same changed tests against two isolated Git worktrees:
+
+```text
+changed tests + base code  -> must fail
+changed tests + head code  -> must pass
+```
+
+If both runs pass, the test is green but does not prove the patch. That distinction matters when tests are generated quickly, written after the implementation, or produced by a coding agent optimizing for a green CI signal.
+
+```console
+$ npx testdelta verify --base main --command "node --test {tests}"
+
+testdelta PROVEN
+The changed tests fail before the patch and pass after it.
+
+✓ before  exit 1  438ms
+✓ after   exit 0  301ms
+
+tests   math.test.js
+command node --test math.test.js
+base    1fcf8510a27a
+```
+
+No API key, service, account, container, or language-specific plugin is required. The published package has zero runtime dependencies.
+
+## Why this exists
+
+Normal CI answers one question: **does the current branch pass?**
+
+For a regression test, reviewers need a second answer: **would this test have caught the bug before the fix?** A test that passes on both revisions may exercise code, but it cannot demonstrate that the production change caused the behavior to become correct.
+
+Fail-to-pass testing is standard in software-engineering benchmarks, but it is still awkward to run on ordinary pull requests. `testdelta` turns it into one command.
+
+## Quick start
+
+Requirements: Node.js 20+ and Git.
+
+```bash
+npx testdelta init
+```
+
+Edit the generated `.testdelta.json`, then commit your production and test changes before running:
+
+```bash
+npx testdelta verify --base main --setup "npm ci"
+```
+
+Or skip configuration:
+
+```bash
+npx testdelta verify \
+  --base origin/main \
+  --command "pytest {tests}" \
+  --setup "python -m pip install -e ."
+```
+
+The `{tests}` placeholder expands to shell-quoted paths for the added or modified test files. Commands without `{tests}` are also supported, which is useful for `go test ./...` and `cargo test`.
+
+### Try from source
+
+```bash
+git clone <your-fork-url>/testdelta.git
+cd testdelta
+npm install
+npm test
+npm run demo
+```
+
+## Verdicts
+
+| Verdict | Before | After | Exit | Meaning |
+|---|---:|---:|---:|---|
+| `PROVEN` | fail | pass | `0` | The changed tests distinguish the patch from its base. |
+| `WEAK` | pass | pass | `2` | The tests pass without the production change. |
+| `BROKEN` | fail | fail | `3` | The tests still fail on the new revision. |
+| `REGRESSION` | pass | fail | `4` | The patch made previously passing behavior fail. |
+
+Tool/configuration errors exit with `1`. This makes every result except `PROVEN` fail closed in CI.
+
+## How it works
+
+1. Resolve the merge base between `--base` and `--head`.
+2. Find added or modified files matching the test patterns.
+3. Create detached temporary worktrees for the merge base and head revision.
+4. Apply only the changed-test patch to the base worktree.
+5. Run the optional setup command and identical test command in both worktrees.
+6. Remove both worktrees and emit a deterministic verdict.
+
+The production patch is never applied to the `before` worktree. The original checkout is never modified.
+
+## Configuration
+
+`.testdelta.json`:
+
+```json
+{
+  "command": "npm test -- {tests}",
+  "setupCommand": "npm ci",
+  "testPatterns": [
+    "**/*.test.*",
+    "**/*.spec.*",
+    "tests/**"
+  ],
+  "timeoutMs": 120000
+}
+```
+
+CLI options override configuration. Use repeated `--pattern` flags for custom layouts:
+
+```bash
+testdelta verify --pattern "spec/**" --pattern "packages/*/checks/**"
+```
+
+### JSON and receipts
+
+```bash
+testdelta verify --json
+testdelta verify --report .testdelta-report.json
+```
+
+The JSON report includes refs, merge base, test paths, command, exit codes, durations, output, timeout state, and schema version.
+
+## CI
+
+The important GitHub Actions setting is `fetch-depth: 0`; the merge base must exist locally. A complete workflow is in [docs/github-actions.md](docs/github-actions.md).
+
+For high-trust CI, pass `--command` in the protected workflow rather than allowing a pull request to redefine its own verifier.
+
+## What testdelta is not
+
+- It is not a test framework; it wraps the command you already trust.
+- It does not claim that a fail-to-pass test fully specifies the feature.
+- It does not semantically judge assertions or detect every form of test weakening.
+- It currently verifies committed changes between Git refs, not unstaged files.
+- A new test that cannot even load on the base revision counts as a failure. Review the captured `before` output to distinguish a meaningful assertion failure from missing infrastructure.
+
+## Why not just inspect the diff?
+
+Static test linters can detect `.skip`, `.only`, deleted assertions, and suspicious patterns. Command receipts can prove that a test command ran. Those are useful but answer different questions. `testdelta` executes the changed test in both realities and checks whether the production patch changes the outcome.
+
+## Project status
+
+The MVP supports cross-platform Git worktrees, conventional test discovery, custom globs, setup commands, timeouts, four verdicts, JSON output, and a public TypeScript API. See [ROADMAP.md](ROADMAP.md) for the path to v1.
+
+Contributions are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md) and the good-first-issue items in the roadmap.
+
+## License
+
+MIT © TestDelta contributors

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/cli.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { writeStarterConfig } from "./core/config.js";
+import { exitCodeFor, formatReport } from "./core/report.js";
+import { verify } from "./core/verify.js";
+const HELP = `testdelta — prove changed tests fail before and pass after a patch
+
+Usage:
+  testdelta verify [options]
+  testdelta init
+
+Options:
+  --base <ref>          Base branch or commit (default: main)
+  --head <ref>          Head branch or commit (default: HEAD)
+  --command <command>   Test command; use {tests} for changed test paths
+  --setup <command>     Optional dependency setup command for each worktree
+  --pattern <glob>      Test-file glob; repeatable
+  --timeout <ms>        Per-command timeout (default: 120000)
+  --json                Print JSON instead of the terminal report
+  --report <path>       Also write the JSON report to a file
+  --keep-worktrees      Keep temporary worktrees for debugging
+  -h, --help            Show help
+  -v, --version         Show version
+
+Exit codes: 0 proven, 1 tool error, 2 weak, 3 broken, 4 regression.
+`;
+async function main() {
+    const argv = process.argv.slice(2);
+    const subcommand = argv[0]?.startsWith("-") ? "verify" : (argv.shift() ?? "verify");
+    if (subcommand === "init") {
+        const path = await writeStarterConfig(process.cwd());
+        process.stdout.write(`Created ${path}\n`);
+        return;
+    }
+    if (subcommand !== "verify")
+        throw new Error(`Unknown command: ${subcommand}`);
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            base: { type: "string", default: "main" },
+            head: { type: "string", default: "HEAD" },
+            command: { type: "string" },
+            setup: { type: "string" },
+            pattern: { type: "string", multiple: true },
+            timeout: { type: "string" },
+            json: { type: "boolean", default: false },
+            report: { type: "string" },
+            "keep-worktrees": { type: "boolean", default: false },
+            help: { type: "boolean", short: "h", default: false },
+            version: { type: "boolean", short: "v", default: false },
+        },
+        strict: true,
+    });
+    if (values.help) {
+        process.stdout.write(HELP);
+        return;
+    }
+    if (values.version) {
+        process.stdout.write("0.1.0\n");
+        return;
+    }
+    const report = await verify({
+        cwd: process.cwd(),
+        base: values.base ?? "main",
+        head: values.head ?? "HEAD",
+        ...(values.command ? { command: values.command } : {}),
+        ...(values.setup ? { setupCommand: values.setup } : {}),
+        ...(values.pattern ? { testPatterns: values.pattern } : {}),
+        ...(values.timeout ? { timeoutMs: Number.parseInt(values.timeout, 10) } : {}),
+        keepWorktrees: values["keep-worktrees"] ?? false,
+    });
+    const json = `${JSON.stringify(report, null, 2)}\n`;
+    process.stdout.write(values.json ? json : formatReport(report));
+    if (values.report)
+        await writeFile(resolve(values.report), json);
+    process.exitCode = exitCodeFor(report.verdict);
+}
+main().catch((error) => {
+    process.stderr.write(`testdelta error: ${error.message}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/core/config.d.ts

@@ -0,0 +1,4 @@
+import type { TestDeltaConfig } from "../types.js";
+export declare function loadConfig(cwd: string): Promise<TestDeltaConfig>;
+export declare function detectTestCommand(cwd: string): Promise<string | undefined>;
+export declare function writeStarterConfig(cwd: string): Promise<string>;

package/dist/src/core/config.js

@@ -0,0 +1,66 @@
+import { access, readFile, writeFile } from "node:fs/promises";
+import { constants } from "node:fs";
+import { join } from "node:path";
+import { defaultTestPatterns } from "./patterns.js";
+const CONFIG_NAME = ".testdelta.json";
+export async function loadConfig(cwd) {
+    const defaults = {
+        testPatterns: defaultTestPatterns(),
+        timeoutMs: 120_000,
+    };
+    try {
+        const raw = await readFile(join(cwd, CONFIG_NAME), "utf8");
+        const parsed = JSON.parse(raw);
+        return {
+            ...defaults,
+            ...parsed,
+            testPatterns: parsed.testPatterns ?? defaults.testPatterns,
+        };
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT")
+            return defaults;
+        throw new Error(`Could not read ${CONFIG_NAME}: ${error.message}`);
+    }
+}
+export async function detectTestCommand(cwd) {
+    const exists = async (path) => {
+        try {
+            await access(join(cwd, path), constants.F_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    if (await exists("package.json")) {
+        const manifest = JSON.parse(await readFile(join(cwd, "package.json"), "utf8"));
+        if (manifest.scripts?.test) {
+            if (await exists("pnpm-lock.yaml"))
+                return "pnpm test -- {tests}";
+            if (await exists("yarn.lock"))
+                return "yarn test {tests}";
+            return "npm test -- {tests}";
+        }
+    }
+    if ((await exists("pyproject.toml")) || (await exists("pytest.ini")))
+        return "pytest {tests}";
+    if (await exists("go.mod"))
+        return "go test ./...";
+    if (await exists("Cargo.toml"))
+        return "cargo test";
+    return undefined;
+}
+export async function writeStarterConfig(cwd) {
+    const path = join(cwd, CONFIG_NAME);
+    const detectedCommand = await detectTestCommand(cwd);
+    const config = {
+        command: detectedCommand ?? "YOUR_TEST_COMMAND {tests}",
+        testPatterns: defaultTestPatterns(),
+        timeoutMs: 120_000,
+    };
+    await writeFile(path, `${JSON.stringify(config, null, 2)}\n`, { flag: "wx" });
+    return path;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/core/config.js.map

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

package/dist/src/core/git.d.ts

@@ -0,0 +1,7 @@
+export declare function assertGitRepository(cwd: string): Promise<void>;
+export declare function resolveRef(ref: string, cwd: string): Promise<string>;
+export declare function findMergeBase(base: string, head: string, cwd: string): Promise<string>;
+export declare function changedFiles(base: string, head: string, cwd: string): Promise<string[]>;
+export declare function createWorktree(ref: string, cwd: string, label: string): Promise<string>;
+export declare function applyTestPatch(base: string, head: string, testFiles: string[], sourceRepo: string, targetWorktree: string): Promise<void>;
+export declare function removeWorktree(path: string, cwd: string): Promise<void>;

package/dist/src/core/git.js

@@ -0,0 +1,42 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { runProcess } from "./process.js";
+async function git(args, cwd, allowFailure = false) {
+    return await runProcess("git", args, { cwd, allowFailure });
+}
+export async function assertGitRepository(cwd) {
+    await git(["rev-parse", "--show-toplevel"], cwd);
+}
+export async function resolveRef(ref, cwd) {
+    const result = await git(["rev-parse", "--verify", ref], cwd);
+    return result.stdout.trim();
+}
+export async function findMergeBase(base, head, cwd) {
+    const result = await git(["merge-base", base, head], cwd);
+    return result.stdout.trim();
+}
+export async function changedFiles(base, head, cwd) {
+    const result = await git(["diff", "--name-only", "--diff-filter=AM", "-z", base, head, "--"], cwd);
+    return result.stdout.split("\0").filter(Boolean);
+}
+export async function createWorktree(ref, cwd, label) {
+    const root = await mkdtemp(join(tmpdir(), `testdelta-${label}-`));
+    await git(["worktree", "add", "--detach", root, ref], cwd);
+    return root;
+}
+export async function applyTestPatch(base, head, testFiles, sourceRepo, targetWorktree) {
+    const patch = await git(["diff", "--binary", base, head, "--", ...testFiles], sourceRepo);
+    if (!patch.stdout.trim())
+        throw new Error("The selected test files produced an empty patch.");
+    await runProcess("git", ["apply", "--whitespace=nowarn", "-"], {
+        cwd: targetWorktree,
+        input: patch.stdout,
+    });
+}
+export async function removeWorktree(path, cwd) {
+    await git(["worktree", "remove", "--force", path], cwd, true);
+    await rm(path, { recursive: true, force: true });
+    await git(["worktree", "prune"], cwd, true);
+}
+//# sourceMappingURL=git.js.map

package/dist/src/core/git.js.map

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

package/dist/src/core/patterns.d.ts

@@ -0,0 +1,3 @@
+export declare function defaultTestPatterns(): string[];
+export declare function globToRegex(glob: string): RegExp;
+export declare function selectTestFiles(files: string[], patterns: string[]): string[];

package/dist/src/core/patterns.js

@@ -0,0 +1,44 @@
+const DEFAULT_TEST_PATTERNS = [
+    "**/*.test.*",
+    "**/*.spec.*",
+    "**/test_*.py",
+    "**/*_test.py",
+    "**/*_test.go",
+    "tests/**",
+    "test/**",
+    "__tests__/**",
+];
+export function defaultTestPatterns() {
+    return [...DEFAULT_TEST_PATTERNS];
+}
+function escapeRegex(character) {
+    return /[\\^$.*+?()[\]{}|]/.test(character) ? `\\${character}` : character;
+}
+export function globToRegex(glob) {
+    const normalized = glob.replaceAll("\\", "/");
+    let source = "^";
+    for (let index = 0; index < normalized.length; index += 1) {
+        const character = normalized[index] ?? "";
+        const next = normalized[index + 1];
+        if (character === "*" && next === "*") {
+            const followedBySlash = normalized[index + 2] === "/";
+            source += followedBySlash ? "(?:.*/)?" : ".*";
+            index += followedBySlash ? 2 : 1;
+        }
+        else if (character === "*") {
+            source += "[^/]*";
+        }
+        else if (character === "?") {
+            source += "[^/]";
+        }
+        else {
+            source += escapeRegex(character);
+        }
+    }
+    return new RegExp(`${source}$`);
+}
+export function selectTestFiles(files, patterns) {
+    const matchers = patterns.map(globToRegex);
+    return files.filter((file) => matchers.some((matcher) => matcher.test(file.replaceAll("\\", "/"))));
+}
+//# sourceMappingURL=patterns.js.map

package/dist/src/core/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../../src/core/patterns.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAAG;IAC5B,aAAa;IACb,aAAa;IACb,cAAc;IACd,cAAc;IACd,cAAc;IACd,UAAU;IACV,SAAS;IACT,cAAc;CACf,CAAC;AAEF,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,GAAG,qBAAqB,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB;IACpC,OAAO,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,MAAM,GAAG,GAAG,CAAC;IAEjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACnC,IAAI,SAAS,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACtC,MAAM,eAAe,GAAG,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;YACtD,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9C,KAAK,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,OAAO,CAAC;QACpB,CAAC;aAAM,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,MAAM,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAe,EAAE,QAAkB;IACjE,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACtG,CAAC"}

package/dist/src/core/process.d.ts

@@ -0,0 +1,10 @@
+import type { CommandResult } from "../types.js";
+interface RunOptions {
+    cwd: string;
+    timeoutMs?: number;
+    input?: string;
+    allowFailure?: boolean;
+}
+export declare function runProcess(executable: string, args: string[], options: RunOptions): Promise<CommandResult>;
+export declare function runShell(command: string, cwd: string, timeoutMs: number): Promise<CommandResult>;
+export {};

package/dist/src/core/process.js

@@ -0,0 +1,59 @@
+import { spawn } from "node:child_process";
+export async function runProcess(executable, args, options) {
+    const startedAt = Date.now();
+    const env = { ...process.env };
+    // A nested `node --test` must start as a fresh runner, not inherit the parent
+    // runner's private worker marker (relevant when testdelta itself runs in CI tests).
+    delete env.NODE_TEST_CONTEXT;
+    return await new Promise((resolve, reject) => {
+        const child = spawn(executable, args, {
+            cwd: options.cwd,
+            env,
+            shell: false,
+            stdio: "pipe",
+            windowsHide: true,
+        });
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => (stdout += chunk));
+        child.stderr.on("data", (chunk) => (stderr += chunk));
+        child.on("error", reject);
+        const timer = options.timeoutMs
+            ? setTimeout(() => {
+                timedOut = true;
+                child.kill("SIGTERM");
+            }, options.timeoutMs)
+            : undefined;
+        child.on("close", (code) => {
+            if (timer)
+                clearTimeout(timer);
+            const result = {
+                command: [executable, ...args].join(" "),
+                exitCode: timedOut ? 124 : (code ?? 1),
+                durationMs: Date.now() - startedAt,
+                stdout,
+                stderr,
+                timedOut,
+            };
+            if (!options.allowFailure && result.exitCode !== 0) {
+                reject(new Error(`${result.command} failed (${result.exitCode})\n${stderr || stdout}`));
+                return;
+            }
+            resolve(result);
+        });
+        if (options.input !== undefined)
+            child.stdin.end(options.input);
+        else
+            child.stdin.end();
+    });
+}
+export async function runShell(command, cwd, timeoutMs) {
+    const shell = process.platform === "win32" ? process.env.ComSpec ?? "cmd.exe" : "/bin/sh";
+    const args = process.platform === "win32" ? ["/d", "/s", "/c", command] : ["-c", command];
+    const result = await runProcess(shell, args, { cwd, timeoutMs, allowFailure: true });
+    return { ...result, command };
+}
+//# sourceMappingURL=process.js.map

package/dist/src/core/process.js.map

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

package/dist/src/core/report.d.ts

@@ -0,0 +1,3 @@
+import type { VerificationReport, Verdict } from "../types.js";
+export declare function formatReport(report: VerificationReport): string;
+export declare function exitCodeFor(verdict: Verdict): number;

package/dist/src/core/report.js

@@ -0,0 +1,38 @@
+const DESCRIPTIONS = {
+    PROVEN: "The changed tests fail before the patch and pass after it.",
+    WEAK: "The changed tests pass without the production patch; they do not prove the change.",
+    BROKEN: "The changed tests fail both before and after the patch.",
+    REGRESSION: "The changed tests pass before the patch but fail after it.",
+};
+function mark(exitCode, expectedPass) {
+    const passed = exitCode === 0;
+    return passed === expectedPass ? "✓" : "✗";
+}
+function failureDetails(label, exitCode, stdout, stderr) {
+    if (exitCode === 0)
+        return [];
+    const output = (stderr || stdout).trim().split(/\r?\n/).slice(-8);
+    return output.length > 0 ? ["", `${label} output:`, ...output.map((line) => `  ${line}`)] : [];
+}
+export function formatReport(report) {
+    const lines = [
+        "",
+        `testdelta ${report.verdict}`,
+        DESCRIPTIONS[report.verdict],
+        "",
+        `${mark(report.before.exitCode, false)} before  exit ${report.before.exitCode}  ${report.before.durationMs}ms`,
+        `${mark(report.after.exitCode, true)} after   exit ${report.after.exitCode}  ${report.after.durationMs}ms`,
+        "",
+        `tests   ${report.testFiles.join(", ")}`,
+        `command ${report.command}`,
+        `base    ${report.mergeBase.slice(0, 12)}`,
+        ...failureDetails("before", report.before.exitCode, report.before.stdout, report.before.stderr),
+        ...failureDetails("after", report.after.exitCode, report.after.stdout, report.after.stderr),
+        "",
+    ];
+    return lines.join("\n");
+}
+export function exitCodeFor(verdict) {
+    return { PROVEN: 0, WEAK: 2, BROKEN: 3, REGRESSION: 4 }[verdict];
+}
+//# sourceMappingURL=report.js.map

package/dist/src/core/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/core/report.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAA4B;IAC5C,MAAM,EAAE,4DAA4D;IACpE,IAAI,EAAE,oFAAoF;IAC1F,MAAM,EAAE,yDAAyD;IACjE,UAAU,EAAE,4DAA4D;CACzE,CAAC;AAEF,SAAS,IAAI,CAAC,QAAgB,EAAE,YAAqB;IACnD,MAAM,MAAM,GAAG,QAAQ,KAAK,CAAC,CAAC;IAC9B,OAAO,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,QAAgB,EAAE,MAAc,EAAE,MAAc;IACrF,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,KAAK,UAAU,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,MAAM,KAAK,GAAG;QACZ,EAAE;QACF,aAAa,MAAM,CAAC,OAAO,EAAE;QAC7B,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;QAC5B,EAAE;QACF,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,iBAAiB,MAAM,CAAC,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI;QAC9G,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,iBAAiB,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI;QAC1G,EAAE;QACF,WAAW,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACxC,WAAW,MAAM,CAAC,OAAO,EAAE;QAC3B,WAAW,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QAC1C,GAAG,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/F,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QAC3F,EAAE;KACH,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;AACnE,CAAC"}

package/dist/src/core/verify.d.ts

@@ -0,0 +1,3 @@
+import type { VerificationReport, VerifyOptions } from "../types.js";
+export declare function verify(options: VerifyOptions): Promise<VerificationReport>;
+export declare function projectName(cwd: string): string;

package/dist/src/core/verify.js

@@ -0,0 +1,92 @@
+import { basename } from "node:path";
+import { applyTestPatch, assertGitRepository, changedFiles, createWorktree, findMergeBase, removeWorktree, resolveRef, } from "./git.js";
+import { detectTestCommand, loadConfig } from "./config.js";
+import { runShell } from "./process.js";
+import { selectTestFiles } from "./patterns.js";
+function quoteArgument(value) {
+    if (/^[A-Za-z0-9_./\\-]+$/.test(value))
+        return value;
+    if (process.platform === "win32")
+        return `"${value.replaceAll('"', '\\"')}"`;
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function expandCommand(template, testFiles) {
+    const tests = testFiles.map(quoteArgument).join(" ");
+    return template.includes("{tests}") ? template.replaceAll("{tests}", tests) : template;
+}
+function verdictFor(beforeExit, afterExit) {
+    if (beforeExit !== 0 && afterExit === 0)
+        return "PROVEN";
+    if (beforeExit === 0 && afterExit === 0)
+        return "WEAK";
+    if (beforeExit !== 0 && afterExit !== 0)
+        return "BROKEN";
+    return "REGRESSION";
+}
+export async function verify(options) {
+    await assertGitRepository(options.cwd);
+    const config = await loadConfig(options.cwd);
+    const baseRef = await resolveRef(options.base, options.cwd);
+    const headRef = await resolveRef(options.head, options.cwd);
+    const mergeBase = await findMergeBase(baseRef, headRef, options.cwd);
+    const files = await changedFiles(mergeBase, headRef, options.cwd);
+    const patterns = options.testPatterns ?? config.testPatterns;
+    const testFiles = selectTestFiles(files, patterns);
+    if (testFiles.length === 0) {
+        throw new Error(`No added or modified test files matched: ${patterns.join(", ")}`);
+    }
+    const commandTemplate = options.command ?? config.command ?? (await detectTestCommand(options.cwd));
+    if (!commandTemplate) {
+        throw new Error("No test command found. Pass --command or run testdelta init.");
+    }
+    const command = expandCommand(commandTemplate, testFiles);
+    const setupCommand = options.setupCommand ?? config.setupCommand;
+    const timeoutMs = options.timeoutMs ?? config.timeoutMs;
+    let beforeWorktree;
+    let afterWorktree;
+    try {
+        beforeWorktree = await createWorktree(mergeBase, options.cwd, "before");
+        afterWorktree = await createWorktree(headRef, options.cwd, "after");
+        await applyTestPatch(mergeBase, headRef, testFiles, options.cwd, beforeWorktree);
+        if (setupCommand) {
+            const beforeSetup = await runShell(setupCommand, beforeWorktree, timeoutMs);
+            if (beforeSetup.exitCode !== 0)
+                throw new Error(`Setup failed in before worktree:\n${beforeSetup.stderr || beforeSetup.stdout}`);
+            const afterSetup = await runShell(setupCommand, afterWorktree, timeoutMs);
+            if (afterSetup.exitCode !== 0)
+                throw new Error(`Setup failed in after worktree:\n${afterSetup.stderr || afterSetup.stdout}`);
+        }
+        const before = await runShell(command, beforeWorktree, timeoutMs);
+        const after = await runShell(command, afterWorktree, timeoutMs);
+        return {
+            schemaVersion: 1,
+            verdict: verdictFor(before.exitCode, after.exitCode),
+            base: options.base,
+            head: options.head,
+            mergeBase,
+            testFiles,
+            command,
+            before,
+            after,
+            generatedAt: new Date().toISOString(),
+        };
+    }
+    finally {
+        if (!options.keepWorktrees) {
+            if (beforeWorktree)
+                await removeWorktree(beforeWorktree, options.cwd);
+            if (afterWorktree)
+                await removeWorktree(afterWorktree, options.cwd);
+        }
+        else {
+            if (beforeWorktree)
+                process.stderr.write(`Kept before worktree: ${beforeWorktree}\n`);
+            if (afterWorktree)
+                process.stderr.write(`Kept after worktree: ${afterWorktree}\n`);
+        }
+    }
+}
+export function projectName(cwd) {
+    return basename(cwd);
+}
+//# sourceMappingURL=verify.js.map

package/dist/src/core/verify.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export { verify } from "./core/verify.js";
+export { formatReport, exitCodeFor } from "./core/report.js";
+export { selectTestFiles, globToRegex, defaultTestPatterns } from "./core/patterns.js";
+export type { CommandResult, TestDeltaConfig, VerificationReport, VerifyOptions, Verdict, } from "./types.js";

package/dist/src/index.js

@@ -0,0 +1,4 @@
+export { verify } from "./core/verify.js";
+export { formatReport, exitCodeFor } from "./core/report.js";
+export { selectTestFiles, globToRegex, defaultTestPatterns } from "./core/patterns.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,37 @@
+export interface TestDeltaConfig {
+    command?: string;
+    setupCommand?: string;
+    testPatterns: string[];
+    timeoutMs: number;
+}
+export interface CommandResult {
+    command: string;
+    exitCode: number;
+    durationMs: number;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+}
+export type Verdict = "PROVEN" | "WEAK" | "BROKEN" | "REGRESSION";
+export interface VerificationReport {
+    schemaVersion: 1;
+    verdict: Verdict;
+    base: string;
+    head: string;
+    mergeBase: string;
+    testFiles: string[];
+    command: string;
+    before: CommandResult;
+    after: CommandResult;
+    generatedAt: string;
+}
+export interface VerifyOptions {
+    cwd: string;
+    base: string;
+    head: string;
+    command?: string;
+    setupCommand?: string;
+    testPatterns?: string[];
+    timeoutMs?: number;
+    keepWorktrees?: boolean;
+}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "testdelta",
+  "version": "0.1.0",
+  "description": "Prove that changed tests fail before a patch and pass after it.",
+  "type": "module",
+  "bin": {
+    "testdelta": "dist/src/cli.js"
+  },
+  "exports": {
+    ".": "./dist/src/index.js"
+  },
+  "files": [
+    "dist/src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test dist/tests/patterns.test.js dist/tests/report.test.js dist/tests/verify.integration.test.js",
+    "demo": "npm run build && node scripts/demo.mjs",
+    "prepublishOnly": "npm test"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "testing",
+    "regression",
+    "tdd",
+    "git",
+    "ci",
+    "coding-agents",
+    "fail-to-pass"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.8.0"
+  }
+}