@gate-forge/pack-playwright 0.7.1 → 0.9.0

package/dist/discovery/git-ignore.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The subset of `paths` git ignores, or null when git cannot answer.
+ *
+ * Args:
+ *   cwd: absolute directory the relative paths are resolved against (the scan root).
+ *   paths: repo-relative posix paths, already filtered to scan candidates.
+ *
+ * Returns:
+ *   Set<string> | null: the ignored subset when git answered (possibly
+ *   empty), or null outside a work tree / when the query was unavailable.
+ */
+export declare function gitIgnoredPaths(cwd: string, paths: readonly string[]): Set<string> | null;
+//# sourceMappingURL=git-ignore.d.ts.map

package/dist/discovery/git-ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ignore.d.ts","sourceRoot":"","sources":["../../src/discovery/git-ignore.ts"],"names":[],"mappings":"AAiCA;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAkBzF"}

package/dist/discovery/git-ignore.js

@@ -0,0 +1,62 @@
+/**
+ * Git-ignore awareness for STATIC discovery candidates.
+ *
+ * The static scanner walks the filesystem with include/exclude globs and
+ * pruned build/dep directories only. A path the repository IGNORES —
+ * the built, git-ignored bundle a frontend build writes into the tree —
+ * is not source the owner runs or intends to change, and the runner can
+ * never enumerate a test inside it. Rows from such a file can only ever
+ * become `unenumeratedReason` gaps and permanent RUN_INCOMPLETE
+ * incompleteness, so an ignored file must never become a static row.
+ *
+ * The filter asks GIT, in ONE batched call, which of the candidate paths
+ * git ignores. Two deliberate properties:
+ *
+ * - **Untracked is not ignored.** `git check-ignore` without `--no-index`
+ *   never reports a TRACKED file, so a committed spec that matches an
+ *   ignore pattern is still scanned (and still fail-closed as
+ *   unresolved when its shape is unresolvable), while a brand-new
+ *   uncommitted spec — untracked, not ignored — is still planned.
+ * - **Absence of an answer is not an answer.** Outside a work tree
+ *   (plain fixture directories), or when git is missing, unreadable, or
+ *   too slow, the helper reports `null` and the caller keeps exactly
+ *   today's behavior. Git ignore rules are only consulted where they
+ *   actually exist.
+ */
+import { spawnSync } from 'node:child_process';
+/** Hard cap on the batched ignore query's output buffer. */
+const MAX_IGNORE_OUTPUT_BYTES = 64 * 1024 * 1024;
+/** The ignore query's deadline; a slower git answers nothing (today's behavior). */
+const IGNORE_QUERY_TIMEOUT_MS = 20_000;
+/**
+ * The subset of `paths` git ignores, or null when git cannot answer.
+ *
+ * Args:
+ *   cwd: absolute directory the relative paths are resolved against (the scan root).
+ *   paths: repo-relative posix paths, already filtered to scan candidates.
+ *
+ * Returns:
+ *   Set<string> | null: the ignored subset when git answered (possibly
+ *   empty), or null outside a work tree / when the query was unavailable.
+ */
+export function gitIgnoredPaths(cwd, paths) {
+    if (paths.length === 0)
+        return new Set();
+    const result = spawnSync('git', ['--no-replace-objects', 'check-ignore', '--stdin', '-z'], {
+        cwd,
+        encoding: 'utf8',
+        input: `${paths.join('\0')}\0`,
+        maxBuffer: MAX_IGNORE_OUTPUT_BYTES,
+        timeout: IGNORE_QUERY_TIMEOUT_MS,
+    });
+    if (result.error !== undefined)
+        return null; // git missing, killed, or timed out
+    // 0: at least one path is ignored. 1: none are (status 128: not a
+    // repository — "no work tree", which also means no filter).
+    if (result.status !== 0 && result.status !== 1)
+        return null;
+    return new Set((result.stdout ?? '')
+        .split('\0')
+        .filter((path) => path.length > 0));
+}
+//# sourceMappingURL=git-ignore.js.map

package/dist/discovery/git-ignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ignore.js","sourceRoot":"","sources":["../../src/discovery/git-ignore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,4DAA4D;AAC5D,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,oFAAoF;AACpF,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,KAAwB;IACnE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,sBAAsB,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;QACzF,GAAG;QACH,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QAC9B,SAAS,EAAE,uBAAuB;QAClC,OAAO,EAAE,uBAAuB;KACjC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,CAAC,oCAAoC;IACjF,kEAAkE;IAClE,4DAA4D;IAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5D,OAAO,IAAI,GAAG,CACZ,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;SAClB,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CACrC,CAAC;AACJ,CAAC"}

package/dist/discovery/index.d.ts

@@ -3,14 +3,24 @@
  * phase 2): bounded static scanning, native reconciliation, kind
  * inference, the runner adapters, and the pytest diagnostic adapter.
  */
+export * from './adapter-projection.js';
 export * from './static-discovery.js';
+export * from './git-ignore.js';
 export * from './inference.js';
 export * from './reconcile.js';
+export * from './prepare-barrier.js';
+export { localPlaywrightCliCandidates } from '../runner-resolution.js';
+export { CONFIG_SEARCH_PRUNED_DIRS, PLAYWRIGHT_CONFIG_NAMES } from './config-locations.js';
 export * from './pytest-adapter.js';
 export * from './discover.js';
 export * from './adapters.js';
 export * from './supervised-run.js';
 export * from './trusted-config.js';
 export * from './runner-env.js';
+export * from './runner-file-scope.js';
 export * from './surface-doctor.js';
+export * from './playwright-runner-adapter.js';
+export * from './pytest-runner-adapter.js';
+export * from './vitest-runner-adapter.js';
+export * from './cypress-runner-adapter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/discovery/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC"}

package/dist/discovery/index.js

@@ -3,14 +3,24 @@
  * phase 2): bounded static scanning, native reconciliation, kind
  * inference, the runner adapters, and the pytest diagnostic adapter.
  */
+export * from './adapter-projection.js';
 export * from './static-discovery.js';
+export * from './git-ignore.js';
 export * from './inference.js';
 export * from './reconcile.js';
+export * from './prepare-barrier.js';
+export { localPlaywrightCliCandidates } from '../runner-resolution.js';
+export { CONFIG_SEARCH_PRUNED_DIRS, PLAYWRIGHT_CONFIG_NAMES } from './config-locations.js';
 export * from './pytest-adapter.js';
 export * from './discover.js';
 export * from './adapters.js';
 export * from './supervised-run.js';
 export * from './trusted-config.js';
 export * from './runner-env.js';
+export * from './runner-file-scope.js';
 export * from './surface-doctor.js';
+export * from './playwright-runner-adapter.js';
+export * from './pytest-runner-adapter.js';
+export * from './vitest-runner-adapter.js';
+export * from './cypress-runner-adapter.js';
 //# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC"}

package/dist/discovery/playwright-runner-adapter.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The Playwright runner adapter behind the runner-neutral
+ * `RunnerAdapter` contract (plan 2026-09-25 phase 0).
+ *
+ * This is NOT a rewrite of the Playwright path: every call lands on the
+ * code the supervised run already used (`discoverTestCatalog`,
+ * `executeSupervisedPlaywright`, `parseOutcomesText`). Its job is to
+ * state the four jobs — enumerate, tag, execute, parse — in the shape
+ * every other runner will use, so the contract suite has something
+ * honest to grade (phase 0 acceptance: "the contract suite runs against
+ * the current Playwright path and passes").
+ *
+ * Compatibility: nothing here is on the supervised-run path. The
+ * existing `PlaywrightAdapter` (discovery/adapters.ts) keeps serving the
+ * CLI unchanged; this adapter is the contract-shaped view of the same
+ * machinery.
+ */
+import { type GateforgeConfig } from '@gate-forge/core';
+import type { RunnerExecutionEnvelope } from '@gate-forge/core';
+import type { RunnerAdapter, RunnerChildEnv, RunnerChildEnvContext, RunnerEnumeration, RunnerExecuteRequest, RunnerRawResults, RunnerSessionTag } from '@gate-forge/witness/adapter';
+import { type DiscoverOptions } from './discover.js';
+import { type SupervisedRunOptions } from './supervised-run.js';
+/**
+ * Per-test session variables a runner adapter publishes to the test.
+ *
+ * These are the values the trusted CLI resolves for ONE supervisor-
+ * opened session and hands to that test alone. They are new env NAMES
+ * (additive — the frozen Playwright child allowlist is untouched, so an
+ * existing Playwright user's run env is byte-identical); the Playwright
+ * fixture itself receives the same values through the supervisor's
+ * session-resolve response rather than through the environment.
+ */
+export declare const ENV_SESSION_ID = "GATEFORGE_SESSION_ID";
+export declare const ENV_SESSION_TOKEN = "GATEFORGE_SESSION_TOKEN";
+export declare const ENV_SESSION_PROXY_URL = "GATEFORGE_SESSION_PROXY_URL";
+/** The variables that carry ONE test's identity to its traffic. */
+export declare const PLAYWRIGHT_IDENTITY_ENV: readonly string[];
+/** Options the Playwright runner adapter accepts. */
+export interface PlaywrightRunnerAdapterOptions {
+    /** Discovery knobs (native list availability, timeouts). */
+    discover?: Omit<DiscoverOptions, 'cwd' | 'config'>;
+    /** Pre-loaded config; absent means load `<cwd>/.gateforge.yml`. */
+    config?: GateforgeConfig;
+    /** Supervised-run knobs (runner command override, timeout). */
+    run?: SupervisedRunOptions;
+}
+/** Playwright behind the runner-neutral contract. */
+export declare class PlaywrightRunnerAdapter implements RunnerAdapter {
+    private readonly options;
+    readonly runner = "playwright";
+    readonly capabilities: {
+        readonly inventory: "available";
+        readonly resolveInstances: "available";
+        readonly execute: "available";
+    };
+    constructor(options?: PlaywrightRunnerAdapterOptions);
+    /**
+     * Job 1: the expected set, fixed BEFORE the run (static scan
+     * reconciled against the native list).
+     *
+     * Args:
+     *   cwd: absolute repo root the playwright configuration lives under.
+     *
+     * Returns:
+     *   Promise<RunnerEnumeration>: the enumerated tests, or an
+     *   `unavailable` verdict. A project with no configured tests is
+     *   `unavailable`, never an empty `discovered` list: nothing executed
+     *   proves nothing.
+     */
+    enumerate(cwd: string): Promise<RunnerEnumeration>;
+    /**
+     * Job 2: the per-test tag. Playwright's channel is the session proxy
+     * origin: the fixture resolves the supervisor-opened session for the
+     * current test and routes the page through that origin, so every
+     * exchange — absolute paths included — is attributed to THAT session.
+     *
+     * Args:
+     *   session: the test being tagged.
+     *   context: run-scoped, non-secret witness wiring.
+     *
+     * Returns:
+     *   RunnerChildEnv: the run identity plus the session-scoped tag.
+     */
+    childEnv(_session: RunnerSessionTag, context: RunnerChildEnvContext): RunnerChildEnv;
+    /**
+     * Job 3: the supervised run (unchanged machinery, contract shape).
+     *
+     * Args:
+     *   request: the exact selection, run identity, and wall-clock bound.
+     *
+     * Returns:
+     *   Promise<RunnerExecutionEnvelope>: the structured outcome envelope.
+     */
+    execute(request: RunnerExecuteRequest): Promise<RunnerExecutionEnvelope>;
+    /**
+     * Job 4: the gateforge reporter's runner-outcomes document, through
+     * the SAME validation and mapping the supervised run uses.
+     *
+     * Args:
+     *   raw: the outcomes document JSON text plus the runner exit status.
+     *
+     * Returns:
+     *   RunnerExecutionEnvelope: reporter input, never a verdict. An
+     *   unreadable or malformed document is `complete: false`.
+     */
+    parseResults(raw: RunnerRawResults): RunnerExecutionEnvelope;
+}
+//# sourceMappingURL=playwright-runner-adapter.d.ts.map

package/dist/discovery/playwright-runner-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-runner-adapter.d.ts","sourceRoot":"","sources":["../../src/discovery/playwright-runner-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAkD,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhH;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,yBAAyB,CAAC;AACrD,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAC3D,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AAEnE,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAIpD,CAAC;AAEF,qDAAqD;AACrD,MAAM,WAAW,8BAA8B;IAC7C,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC;IACnD,mEAAmE;IACnE,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,oBAAoB,CAAC;CAC5B;AAED,qDAAqD;AACrD,qBAAa,uBAAwB,YAAW,aAAa;IAS/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,QAAQ,CAAC,MAAM,gBAAgB;IAE/B,QAAQ,CAAC,YAAY;;;;MAIV;gBAEkB,OAAO,GAAE,8BAAmC;IAEzE;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmDxD;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,qBAAqB,GAAG,cAAc;IAiBpF;;;;;;;;OAQG;IACG,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAkB9E;;;;;;;;;;OAUG;IACH,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,uBAAuB;CAG7D"}

package/dist/discovery/playwright-runner-adapter.js

@@ -0,0 +1,185 @@
+/**
+ * The Playwright runner adapter behind the runner-neutral
+ * `RunnerAdapter` contract (plan 2026-09-25 phase 0).
+ *
+ * This is NOT a rewrite of the Playwright path: every call lands on the
+ * code the supervised run already used (`discoverTestCatalog`,
+ * `executeSupervisedPlaywright`, `parseOutcomesText`). Its job is to
+ * state the four jobs — enumerate, tag, execute, parse — in the shape
+ * every other runner will use, so the contract suite has something
+ * honest to grade (phase 0 acceptance: "the contract suite runs against
+ * the current Playwright path and passes").
+ *
+ * Compatibility: nothing here is on the supervised-run path. The
+ * existing `PlaywrightAdapter` (discovery/adapters.ts) keeps serving the
+ * CLI unchanged; this adapter is the contract-shaped view of the same
+ * machinery.
+ */
+import { loadConfig } from '@gate-forge/core';
+import { ENV_APP_BASE_URL, ENV_RUN_TOKEN, ENV_WITNESS_URL } from '../constants.js';
+import { discoverTestCatalog } from './discover.js';
+import { executeSupervisedPlaywright, parseOutcomesText } from './supervised-run.js';
+/**
+ * Per-test session variables a runner adapter publishes to the test.
+ *
+ * These are the values the trusted CLI resolves for ONE supervisor-
+ * opened session and hands to that test alone. They are new env NAMES
+ * (additive — the frozen Playwright child allowlist is untouched, so an
+ * existing Playwright user's run env is byte-identical); the Playwright
+ * fixture itself receives the same values through the supervisor's
+ * session-resolve response rather than through the environment.
+ */
+export const ENV_SESSION_ID = 'GATEFORGE_SESSION_ID';
+export const ENV_SESSION_TOKEN = 'GATEFORGE_SESSION_TOKEN';
+export const ENV_SESSION_PROXY_URL = 'GATEFORGE_SESSION_PROXY_URL';
+/** The variables that carry ONE test's identity to its traffic. */
+export const PLAYWRIGHT_IDENTITY_ENV = [
+    ENV_SESSION_ID,
+    ENV_SESSION_TOKEN,
+    ENV_SESSION_PROXY_URL,
+];
+/** Playwright behind the runner-neutral contract. */
+export class PlaywrightRunnerAdapter {
+    options;
+    runner = 'playwright';
+    capabilities = {
+        inventory: 'available',
+        resolveInstances: 'available',
+        execute: 'available',
+    };
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * Job 1: the expected set, fixed BEFORE the run (static scan
+     * reconciled against the native list).
+     *
+     * Args:
+     *   cwd: absolute repo root the playwright configuration lives under.
+     *
+     * Returns:
+     *   Promise<RunnerEnumeration>: the enumerated tests, or an
+     *   `unavailable` verdict. A project with no configured tests is
+     *   `unavailable`, never an empty `discovered` list: nothing executed
+     *   proves nothing.
+     */
+    async enumerate(cwd) {
+        let config;
+        try {
+            config = this.options.config ?? loadConfig(`${cwd}/.gateforge.yml`);
+        }
+        catch (error) {
+            return {
+                status: 'unavailable',
+                detail: `playwright enumeration could not load the gateforge config: ${describeError(error)}`,
+                tests: [],
+            };
+        }
+        let catalog;
+        try {
+            const discovered = await discoverTestCatalog({ cwd, config, ...this.options.discover });
+            catalog = discovered.catalog;
+        }
+        catch (error) {
+            return {
+                status: 'unavailable',
+                detail: `playwright enumeration failed: ${describeError(error)}`,
+                tests: [],
+            };
+        }
+        const tests = catalog.entries
+            .filter((entry) => entry.runner === 'playwright')
+            .map((entry) => ({
+            logicalKey: entry.logicalKey,
+            project: entry.project,
+            file: entry.file,
+            titlePath: entry.titlePath,
+            blockingAnnotations: [
+                ...new Set(entry.suppressionSignals
+                    .filter((signal) => signal.kind === 'only' || signal.kind === 'skip' || signal.kind === 'fixme')
+                    .map((signal) => signal.kind)),
+            ].sort(),
+            // The native reporter's own instance id (the same value the
+            // supervised registration path uses).
+            frameworkId: entry.parameterIdentity ?? undefined,
+        }))
+            .sort((a, b) => (a.logicalKey < b.logicalKey ? -1 : a.logicalKey > b.logicalKey ? 1 : 0));
+        if (tests.length === 0) {
+            return {
+                status: 'unavailable',
+                detail: `playwright enumeration found no tests under ${cwd} — a zero-test run never proves coverage`,
+                tests: [],
+            };
+        }
+        return { status: 'discovered', detail: `enumerated ${String(tests.length)} playwright test(s)`, tests };
+    }
+    /**
+     * Job 2: the per-test tag. Playwright's channel is the session proxy
+     * origin: the fixture resolves the supervisor-opened session for the
+     * current test and routes the page through that origin, so every
+     * exchange — absolute paths included — is attributed to THAT session.
+     *
+     * Args:
+     *   session: the test being tagged.
+     *   context: run-scoped, non-secret witness wiring.
+     *
+     * Returns:
+     *   RunnerChildEnv: the run identity plus the session-scoped tag.
+     */
+    childEnv(_session, context) {
+        return {
+            vars: {
+                [ENV_WITNESS_URL]: context.witnessUrl,
+                [ENV_RUN_TOKEN]: context.runToken,
+                [ENV_APP_BASE_URL]: context.appBaseUrl,
+                [ENV_SESSION_ID]: context.sessionId,
+                [ENV_SESSION_TOKEN]: context.sessionToken,
+                [ENV_SESSION_PROXY_URL]: context.sessionProxyUrl,
+            },
+            tagChannel: 'session-proxy',
+            identityVars: PLAYWRIGHT_IDENTITY_ENV,
+            mechanism: 'gateforge playwright fixture resolves the supervisor session for the running test and routes its page through the per-test session proxy origin',
+        };
+    }
+    /**
+     * Job 3: the supervised run (unchanged machinery, contract shape).
+     *
+     * Args:
+     *   request: the exact selection, run identity, and wall-clock bound.
+     *
+     * Returns:
+     *   Promise<RunnerExecutionEnvelope>: the structured outcome envelope.
+     */
+    async execute(request) {
+        return executeSupervisedPlaywright({ logicalKeys: request.logicalKeys }, { stateDir: request.stateDir, runId: request.runId, vars: {} }, {
+            cwd: request.cwd,
+            timeoutMs: request.timeoutMs,
+            // The project selection is part of the identity join key: a run
+            // that does not select the enumerated projects reports outcomes
+            // under different identities than the expected set was fixed
+            // with, and supervision (correctly) calls them unplanned.
+            ...(request.testLocations !== undefined ? { testLocations: request.testLocations } : {}),
+            ...(request.projects !== undefined ? { projects: request.projects } : {}),
+            ...this.options.run,
+        });
+    }
+    /**
+     * Job 4: the gateforge reporter's runner-outcomes document, through
+     * the SAME validation and mapping the supervised run uses.
+     *
+     * Args:
+     *   raw: the outcomes document JSON text plus the runner exit status.
+     *
+     * Returns:
+     *   RunnerExecutionEnvelope: reporter input, never a verdict. An
+     *   unreadable or malformed document is `complete: false`.
+     */
+    parseResults(raw) {
+        return parseOutcomesText(raw.report, raw.processExit);
+    }
+}
+/** Single-line message of an unknown thrown value. */
+function describeError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=playwright-runner-adapter.js.map

package/dist/discovery/playwright-runner-adapter.js.map

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