vdelta 0.4.0 → 0.6.0

package/dist/adapter.d.ts

@@ -14,13 +14,15 @@
  * `splitCommandSelector` know only the runner's *argv surface*, `record` knows
  * only its *structured channel*.
  */
-import type { RunRecord } from './schema.js';
+import { CAPABILITY_VALUES, type CapabilityValue, type RunRecord } from './schema.js';
+export type { CapabilityValue };
 /**
- * The three-valued capability convention (§3.4). The value set is closed
- * (§14); capability *names* stay open so an adapter may declare its own.
+ * The three-valued capability convention (§3.4). Defined in `schema.ts`
+ * because `parseRunRecord` needs it for `instrument.capabilities` value
+ * validation; re-exported here so adapter code keeps importing it from the
+ * adapter seam.
  */
-export declare const CAPABILITY_VALUES: readonly ["pass", "fail", "unsupported"];
-export type CapabilityValue = (typeof CAPABILITY_VALUES)[number];
+export { CAPABILITY_VALUES };
 export type CapabilityDeclaration = Readonly<Record<string, CapabilityValue>>;
 /**
  * Where the adapter's structured channel lands. A single capture file is the

package/dist/adapter.js

@@ -1,8 +1,27 @@
 /**
- * The three-valued capability convention (§3.4). The value set is closed
- * (§14); capability *names* stay open so an adapter may declare its own.
+ * The adapter seam. The core (`run` / `compare` / `gate`) never reaches into a
+ * concrete runner: it resolves an {@link Adapter} descriptor from the registry
+ * (`src/adapters/registry.ts`) and talks to it through this interface only.
+ *
+ * Every type here is a promotion of a shape that already existed on the vitest
+ * side, so the seam is a rearrangement of what already ran rather than a new
+ * mechanism: {@link RecordContext} is the recorder's context object verbatim,
+ * {@link DetectResult} is the runner-token scan's return value,
+ * {@link InstrumentedChild} is the argv/env injection `vdelta run` already
+ * performed, and {@link CommandSelector} is the §6.4 inclusion-intent split.
+ *
+ * Dependency direction inside an adapter is one-way: `detect` / `instrument` /
+ * `splitCommandSelector` know only the runner's *argv surface*, `record` knows
+ * only its *structured channel*.
  */
-export const CAPABILITY_VALUES = ['pass', 'fail', 'unsupported'];
+import { CAPABILITY_VALUES, } from './schema.js';
+/**
+ * The three-valued capability convention (§3.4). Defined in `schema.ts`
+ * because `parseRunRecord` needs it for `instrument.capabilities` value
+ * validation; re-exported here so adapter code keeps importing it from the
+ * adapter seam.
+ */
+export { CAPABILITY_VALUES };
 /**
  * The capability names a declaration says the composition cannot meet, sorted
  * (§4.2 disclosure rule). `unsupported` is the only degraded value: `fail`

package/dist/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAU,CAAA;AAyDzE;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAA2B;IAC9D,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,aAAa,CAAC;SAC9C,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC;SACrB,IAAI,EAAE,CAAA;AACX,CAAC;AAWD;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,iBAAiB,GAGlB,MAAM,aAAa,CAAA;AAGpB;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,CAAA;AAwD5B;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAA2B;IAC9D,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,aAAa,CAAC;SAC9C,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC;SACrB,IAAI,EAAE,CAAA;AACX,CAAC;AAWD;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}

package/dist/adapters/playwright/adapter.d.ts

@@ -0,0 +1,27 @@
+import { type Adapter, type CommandSelector } from '../../adapter.js';
+import { PLAYWRIGHT_CAPABILITIES } from './recorder.js';
+/**
+ * Re-exported from the recorder (§3.4): the declaration lives in
+ * `recorder.ts` so `buildRunRecord` can write it into
+ * `instrument.capabilities` without an import cycle. Kept here too so
+ * existing consumers of this descriptor module keep importing it from
+ * `adapter.js` (same convention as `../vitest/adapter.ts`).
+ */
+export { PLAYWRIGHT_CAPABILITIES };
+/**
+ * Locate the playwright `test` invocation inside the child argv; `null` when
+ * absent. Unlike vitest, a matching binary token alone is not enough: only
+ * a binary token *immediately followed (modulo flags) by the `test`
+ * subcommand* counts. Injecting `--reporter` into e.g. `playwright install`
+ * would kill that child outright (INV-5 — veridelta is never worse than its
+ * absence).
+ */
+export declare function findPlaywrightToken(argv: readonly string[]): number | null;
+/**
+ * The invocation's selector is its inclusion intent (§6.4): the playwright
+ * CLI positional filters. The canonical command excludes them (§5.1), and
+ * keeps the `test` subcommand token (mirrors `../vitest/adapter.ts`'s
+ * treatment of the `run` subcommand token).
+ */
+export declare function splitCommandSelector(cmd: readonly string[]): CommandSelector;
+export declare const playwrightAdapter: Adapter;

package/dist/adapters/playwright/adapter.js

@@ -0,0 +1,175 @@
+/**
+ * playwright adapter, descriptor side: the runner-facing half of the seam
+ * (`src/adapter.ts`). Everything playwright-specific about *invoking* a run
+ * lives here — locating the playwright binary in the child argv, injecting
+ * the capture reporter, and splitting inclusion intent out of the command
+ * (§6.4) using playwright's own CLI surface. The recorder half (capture →
+ * RunRecord) stays in `./recorder.ts`; this module only owns reading and
+ * parsing the channel. Structured 1:1 on `../vitest/adapter.ts`.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { AdapterCaptureError, } from '../../adapter.js';
+import { ADAPTER_NAME, buildRunRecord, COMPOSITION_ID, DECLARED_ENV_VARS, PLAYWRIGHT_CAPABILITIES, } from './recorder.js';
+/**
+ * Re-exported from the recorder (§3.4): the declaration lives in
+ * `recorder.ts` so `buildRunRecord` can write it into
+ * `instrument.capabilities` without an import cycle. Kept here too so
+ * existing consumers of this descriptor module keep importing it from
+ * `adapter.js` (same convention as `../vitest/adapter.ts`).
+ */
+export { PLAYWRIGHT_CAPABILITIES };
+/**
+ * Absolute path of the in-process playwright reporter that writes the
+ * capture. Resolved relative to this module so it points at the built
+ * sibling (`dist/adapters/playwright/reporter.cjs`) rather than a source
+ * path. `.cjs`, not `.js`: an ESM reporter file makes playwright 1.49.1's
+ * loader (`node_modules/playwright/lib/util.js` `fileIsModule()` →
+ * `transform.js` `requireOrImport()`'s `eval("import(...)")` branch) hang
+ * indefinitely in this environment. `.cjs` is unconditionally treated as
+ * CommonJS and loads via `require()` instead (`reporter.cts`'s doc comment
+ * has the full account).
+ */
+function reporterModulePath() {
+    return join(dirname(fileURLToPath(import.meta.url)), 'reporter.cjs');
+}
+/** The one env var the capture reporter reads (`reporter.ts` — active/inert gate). */
+const CAPTURE_FILE_ENV = 'VDELTA_CAPTURE_FILE';
+function channelEnv(channel) {
+    return { [CAPTURE_FILE_ENV]: channel.path };
+}
+/** Parse the channel, or `undefined` when there is nothing readable in it. */
+function readCapture(channel) {
+    try {
+        return JSON.parse(readFileSync(channel.path, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+function isPlaywrightBinaryToken(token) {
+    return (token === 'playwright' ||
+        /(^|[\\/])playwright(\.m?js)?$/.test(token) ||
+        /[\\/]@playwright[\\/]test[\\/]cli\.(m?)js$/.test(token));
+}
+/**
+ * Locate the playwright `test` invocation inside the child argv; `null` when
+ * absent. Unlike vitest, a matching binary token alone is not enough: only
+ * a binary token *immediately followed (modulo flags) by the `test`
+ * subcommand* counts. Injecting `--reporter` into e.g. `playwright install`
+ * would kill that child outright (INV-5 — veridelta is never worse than its
+ * absence).
+ */
+export function findPlaywrightToken(argv) {
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i];
+        if (!isPlaywrightBinaryToken(token))
+            continue;
+        let j = i + 1;
+        while (j < argv.length && argv[j].startsWith('-'))
+            j++;
+        if (j < argv.length && argv[j] === 'test')
+            return i;
+    }
+    return null;
+}
+/**
+ * playwright 1.49.x CLI flags that always take their value as a *separate*
+ * argv token (`--flag value`), never combined into the flag token itself.
+ * Same role/limitation as `../vitest/adapter.ts`'s `VITEST_VALUE_FLAGS`:
+ * flags with an optional value are deliberately excluded, so a
+ * space-separated token after them stays a selector token rather than being
+ * silently swallowed.
+ */
+const PLAYWRIGHT_VALUE_FLAGS = new Set([
+    '--project',
+    '--config',
+    '-c',
+    '--grep',
+    '-g',
+    '--grep-invert',
+    '--workers',
+    '-j',
+    '--retries',
+    '--repeat-each',
+    '--timeout',
+    '--global-timeout',
+    '--max-failures',
+    '--shard',
+    '--reporter',
+    '--output',
+    '--tsconfig',
+]);
+/**
+ * The invocation's selector is its inclusion intent (§6.4): the playwright
+ * CLI positional filters. The canonical command excludes them (§5.1), and
+ * keeps the `test` subcommand token (mirrors `../vitest/adapter.ts`'s
+ * treatment of the `run` subcommand token).
+ */
+export function splitCommandSelector(cmd) {
+    const idx = findPlaywrightToken(cmd);
+    if (idx === null)
+        return { command: [...cmd], selector: [] };
+    const command = cmd.slice(0, idx + 1);
+    const selector = [];
+    for (let i = idx + 1; i < cmd.length; i++) {
+        const token = cmd[i];
+        if (token === 'test' && i === idx + 1) {
+            command.push(token);
+            continue;
+        }
+        if (!token.startsWith('-')) {
+            selector.push(token);
+            continue;
+        }
+        if (token.includes('=')) {
+            command.push(token);
+            continue;
+        }
+        const next = cmd[i + 1];
+        if (PLAYWRIGHT_VALUE_FLAGS.has(token) &&
+            next !== undefined &&
+            !next.startsWith('-')) {
+            command.push(`${token}=${next}`);
+            i++;
+            continue;
+        }
+        command.push(token);
+    }
+    return { command, selector };
+}
+export const playwrightAdapter = {
+    name: ADAPTER_NAME,
+    compositionId: COMPOSITION_ID,
+    declaredCapabilities: PLAYWRIGHT_CAPABILITIES,
+    declaredEnvVars: DECLARED_ENV_VARS,
+    detect(argv) {
+        const i = findPlaywrightToken(argv);
+        return i === null ? null : { tokenIndex: i };
+    },
+    channelEnv,
+    instrument(argv, channel) {
+        return {
+            argv: [...argv, `--reporter=list,${reporterModulePath()}`],
+            env: channelEnv(channel),
+        };
+    },
+    splitCommandSelector,
+    claimsCapture(channel) {
+        // Authorship only, from the payload's own self-identification
+        // (`capture.ts` — a literal `'playwright'`). Not a version/shape check:
+        // a capture this adapter wrote but cannot read must reach `record` so
+        // the run degrades with *that* diagnostic instead of the generic
+        // "is the child a playwright invocation?" (same division as vitest's).
+        return readCapture(channel)?.runner === 'playwright';
+    },
+    record(channel, ctx) {
+        const capture = readCapture(channel);
+        if (capture === undefined) {
+            throw new AdapterCaptureError('no capture from the playwright reporter — is the child a playwright invocation?');
+        }
+        return buildRunRecord(capture, ctx);
+    },
+};
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/playwright/adapter.js.map

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

package/dist/adapters/playwright/capture.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Capture interchange format between the in-process playwright reporter and
+ * the out-of-process recorder (`vdelta run`). Raw structured-channel data
+ * only; canonicalization/redaction/digesting happen in the recorder (mirrors
+ * `../vitest/capture.ts`). Field names diverge where playwright's structured
+ * channel differs from vitest's: test IDs are project-scoped
+ * (`TestCase.id`), results are per-attempt (retries produce multiple
+ * `onTestEnd` calls for the same test), and dependency-skip cascades can
+ * leave whole projects unreported (`unreported_tests`).
+ */
+export declare const CAPTURE_VERSION = 1;
+export interface CapturedPwFrame {
+    file: string;
+    line: number;
+    column: number;
+}
+export interface CapturedPwError {
+    message: string;
+    stack?: string;
+    location?: {
+        file: string;
+        line: number;
+        column: number;
+    };
+    /**
+     * Deterministically parsed from `stack` (named `at symbol (file:line:col)`
+     * frames only — see `parseStackFrames` in `reporter.ts`). Used by the
+     * recorder to reconstruct a line-shift-stable failing source region
+     * without relying on the runner's rendered `snippet` (CE-4).
+     */
+    frames: CapturedPwFrame[];
+}
+export interface CapturedPwAttachment {
+    name: string;
+    content_type: string;
+    /**
+     * sha256 hex digest of the attachment body (from `body` if present,
+     * otherwise read from `path`). `null` when neither is readable. The
+     * absolute path string itself is never carried into the capture.
+     */
+    body_digest: string | null;
+}
+export interface CapturedPwAttempt {
+    status: 'passed' | 'failed' | 'timedOut' | 'skipped' | 'interrupted';
+    retry: number;
+    errors: CapturedPwError[];
+    stdio: {
+        type: 'stdout' | 'stderr';
+        text: string;
+    }[];
+    attachments: CapturedPwAttachment[];
+    duration_ms: number;
+}
+interface CapturedPwTestMeta {
+    test_case_id: string;
+    file_abs: string;
+    project: string;
+    /** `titlePath()` with the leading `''` / project / file entries removed. */
+    titles: string[];
+    location_line: number | null;
+    expected_status: 'passed' | 'failed' | 'timedOut' | 'skipped' | 'interrupted';
+    annotations: {
+        type: string;
+        description?: string;
+    }[];
+}
+export interface CapturedPwTest extends CapturedPwTestMeta {
+    attempts: CapturedPwAttempt[];
+}
+/**
+ * A `TestCase` that `allTests()` enumerates but that never reached
+ * `onTestEnd` (e.g. blocked by a failed `dependencies` project). No attempts
+ * exist for it, so it carries the same identifying fields as
+ * `CapturedPwTest` minus `attempts`.
+ */
+export type CapturedPwUnreportedTest = CapturedPwTestMeta;
+export interface CapturedPwProjectConfig {
+    name: string;
+    /** `RegExp`/array entries safe-serialized (`.toString()`), see `safeSerialize`. */
+    testMatch: unknown;
+    testIgnore: unknown;
+    dependencies: string[];
+    retries: number;
+    timeout: number;
+    /** `use` safe-serialized; may contain absolute paths (e.g. `launchOptions.executablePath`). */
+    use: unknown;
+}
+export interface Capture {
+    capture_version: number;
+    runner: 'playwright';
+    runner_version: string;
+    status: 'passed' | 'failed' | 'timedout' | 'interrupted';
+    unhandled_errors: number;
+    /**
+     * Only the fields `docs/compositions/playwright-native-1.md` §4 judges
+     * `yes` (evidence-affecting / test-selection-affecting). `reporter` is
+     * omitted (§4 `no`); `testDir`/`rootDir`/`configFile` are omitted (§4 `no`
+     * — absolute-path administrative values, see `config_files` instead).
+     */
+    config: {
+        fullyParallel: boolean;
+        workers: number;
+        shard: {
+            total: number;
+            current: number;
+        } | null;
+        forbidOnly: boolean;
+        maxFailures: number;
+        grep: unknown;
+        grepInvert: unknown;
+        globalTimeout: number;
+        projects: CapturedPwProjectConfig[];
+    };
+    tests: CapturedPwTest[];
+    unreported_tests: CapturedPwUnreportedTest[];
+    /** `[config.configFile]` when playwright resolved one, else `[]`. */
+    config_files: string[];
+}
+export {};

package/dist/adapters/playwright/capture.js

@@ -0,0 +1,12 @@
+/**
+ * Capture interchange format between the in-process playwright reporter and
+ * the out-of-process recorder (`vdelta run`). Raw structured-channel data
+ * only; canonicalization/redaction/digesting happen in the recorder (mirrors
+ * `../vitest/capture.ts`). Field names diverge where playwright's structured
+ * channel differs from vitest's: test IDs are project-scoped
+ * (`TestCase.id`), results are per-attempt (retries produce multiple
+ * `onTestEnd` calls for the same test), and dependency-skip cascades can
+ * leave whole projects unreported (`unreported_tests`).
+ */
+export const CAPTURE_VERSION = 1;
+//# sourceMappingURL=capture.js.map

package/dist/adapters/playwright/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../src/adapters/playwright/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA"}

package/dist/adapters/playwright/recorder.d.ts

@@ -0,0 +1,65 @@
+import { AdapterCaptureError, type CapabilityDeclaration, type RecordContext } from '../../adapter.js';
+import { type RunRecord } from '../../schema.js';
+import { type Capture } from './capture.js';
+export declare const ADAPTER_NAME = "playwright";
+export declare const COMPOSITION_ID = "playwright-native/1";
+/** Env vars whose values (fingerprinted, never stored) are comparison-relevant. */
+export declare const DECLARED_ENV_VARS: readonly ["CI", "NODE_ENV", "TZ", "LANG"];
+/**
+ * A capture the recorder cannot turn into a record: unsupported capture
+ * version, or an ambiguity it refuses to guess through (§12 fail-closed).
+ * A subtype of `AdapterCaptureError` so the core degrades to raw passthrough
+ * (INV-5) without knowing which adapter raised it.
+ */
+export declare class RecorderError extends AdapterCaptureError {
+    constructor(message: string);
+}
+/** Re-exported from the seam: the context shape is runner-neutral (§4.1). */
+export type { RecordContext };
+/**
+ * Capability declaration for `playwright-native/1`
+ * (docs/compositions/playwright-native-1.md §8, decision 6). Unlike vitest,
+ * `source-region-text` is `pass` (tree-reconstructed — provenance below), and
+ * `retry-evidence` is `pass` (per-attempt evidence lands in
+ * `FailureFinding.annex.attempts`). `resolved-config-coverage` is
+ * `unsupported`: playwright's resolved `FullConfig`/`FullProject` never
+ * expose `expect.timeout` to the reporter (doc §4 `expect.timeout` row),
+ * so `instrumentConfigDigest` below cannot cover it. This capability is
+ * intentionally not one of `schema.ts`'s `EVIDENCE_CAPABILITY_NAMES` — it is
+ * an instrument-config capability, not an evidence capability, so a report's
+ * `failure_evidence.degraded_capabilities` never lists it (decision 6).
+ */
+export declare const PLAYWRIGHT_CAPABILITIES: CapabilityDeclaration;
+export declare function buildRunRecord(capture: Capture, ctx: RecordContext): RunRecord;
+/**
+ * The §4-judged-`yes` covering set (docs/compositions/playwright-native-1.md
+ * §4): every field the resolved `FullConfig`/`FullProject` exposes that can
+ * change evidence bytes or test-selection verdicts. `testDir`/`rootDir`/
+ * `configFile`/`reporter` are `no` in the judgement table and are absent from
+ * `Capture['config']`/`CapturedPwProjectConfig` by construction (never
+ * captured at all — see `./capture.ts`), so no extra filtering is needed
+ * here. `expect.timeout` is `channel-unavailable` (§4) and is likewise absent
+ * from the capture; it is disclosed instead via
+ * `PLAYWRIGHT_CAPABILITIES['resolved-config-coverage'] === 'unsupported'`.
+ */
+export declare function instrumentConfigDigest(capture: Capture): string;
+/**
+ * Project-scoped test id: `${rel}::${project}::${titles.join(' > ')}`.
+ * `rel` is computed here (not carried in the capture) because the reporter
+ * runs in-process without the worktree root; only the recorder — which has
+ * `RecordContext.worktree` — can normalize `file_abs` into a worktree-relative
+ * path.
+ */
+export declare function testId(t: {
+    file_abs: string;
+    project: string;
+    titles: readonly string[];
+}, worktree: string): string;
+/**
+ * Normalizes an absolute path into a `surface.config_sources`/test-file key:
+ * a worktree-relative POSIX-style path when the file lives inside the
+ * worktree, or `external:<abs path>` when it doesn't. Private duplicate of
+ * `../vitest/recorder.ts`'s `configSourceKey` (same convention) — the vitest
+ * module is not imported from here, and is not modified by this file.
+ */
+export declare function configSourceKey(absPath: string, worktree: string): string;