@gate-forge/pack-playwright 0.7.1 → 0.8.0

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

@@ -0,0 +1,172 @@
+import type { RunnerExecutionEnvelope } from '@gate-forge/core';
+import type { RunnerAdapter, RunnerChildEnv, RunnerChildEnvContext, RunnerEnumeration, RunnerExecuteRequest, RunnerRawResults, RunnerSessionTag } from '@gate-forge/witness/adapter';
+/** Per-test session variables a runner adapter publishes to the test. */
+export declare const VITEST_ENV_SESSION_ID = "GATEFORGE_SESSION_ID";
+export declare const VITEST_ENV_SESSION_TOKEN = "GATEFORGE_SESSION_TOKEN";
+export declare const VITEST_ENV_SESSION_PROXY_URL = "GATEFORGE_SESSION_PROXY_URL";
+/** The variables that carry ONE test's identity to its traffic. */
+export declare const VITEST_IDENTITY_ENV: readonly string[];
+/** One jest-compatible assertion row (structural subset of the reporter JSON). */
+interface VitestAssertionRow {
+    readonly ancestorTitles?: readonly unknown[];
+    readonly title?: unknown;
+    readonly status?: unknown;
+    readonly fullName?: unknown;
+}
+/** One jest-compatible suite row. */
+interface VitestSuiteRow {
+    readonly name?: unknown;
+    readonly status?: unknown;
+    readonly assertionResults?: readonly VitestAssertionRow[];
+}
+/** The jest-compatible JSON document the Vitest reporter writes. */
+export interface VitestJsonReport {
+    readonly numTotalTests?: unknown;
+    readonly testResults?: readonly VitestSuiteRow[];
+}
+/** Options the Vitest runner adapter accepts. */
+export interface VitestRunnerAdapterOptions {
+    /**
+     * Run-scoped witness wiring for `execute` (the trusted caller's
+     * channel). Absent falls back to the ambient
+     * `GATEFORGE_WITNESS_URL`/`GATEFORGE_RUN_TOKEN`/
+     * `GATEFORGE_APP_BASE_URL`.
+     */
+    witness?: {
+        url?: string;
+        token?: string;
+        appBaseUrl?: string;
+    };
+    /** Explicit vitest CLI entry (absolute `vitest.mjs` or a bin name). */
+    vitestEntry?: string;
+}
+/**
+ * The Vitest runner adapter.
+ *
+ * The child's vitest resolves from the project under test first
+ * (`<cwd>/node_modules/vitest/vitest.mjs`, the same local-first rule
+ * the supervised Playwright run applies to its CLI), then the parent
+ * process's own module graph, then `vitest` on PATH.
+ */
+export declare class VitestRunnerAdapter implements RunnerAdapter<VitestJsonReport | null> {
+    private readonly options;
+    readonly runner = "vitest";
+    readonly capabilities: {
+        readonly inventory: "available";
+        readonly resolveInstances: "available";
+        readonly execute: "available";
+    };
+    constructor(options?: VitestRunnerAdapterOptions);
+    /**
+     * Job 1: the runnable set, fixed BEFORE the run (the project's own
+     * vitest CLI, JSON output).
+     *
+     * Args:
+     *   cwd: absolute repo root the vitest project lives under.
+     *
+     * Returns:
+     *   Promise<RunnerEnumeration>: the enumerated tests, or an
+     *   `unavailable` verdict with a single cause. An empty project, a
+     *   vitest failure, and an unreadable listing are all `unavailable`.
+     */
+    enumerate(cwd: string): Promise<RunnerEnumeration>;
+    /**
+     * Job 2: the per-test tag. The pack's Vitest reporter spools the
+     * lifecycle events; the in-test helper resolves the supervisor
+     * session for the running test and rewrites its supertest traffic
+     * through that session's proxy origin.
+     *
+     * 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: runs the SELECTED vitest tests under the jest-compatible
+     * JSON reporter plus the pack's gateforge reporter, with the
+     * witnessed-session env allowlist (the run identity the reporter
+     * needs to address the lifecycle spool plus the non-secret run
+     * wiring — never the verifier key, never any other parent-side name).
+     * A `named-selection` run adds the anchored full-name pattern so only
+     * the named tests execute, never their file neighbours.
+     *
+     * Args:
+     *   request: the exact selection (with its mode), run identity, and
+     *     wall-clock bound.
+     *
+     * Returns:
+     *   Promise<RunnerExecutionEnvelope>: the structured outcome envelope
+     *   (a runner exit code alone is never a gate result).
+     */
+    execute(request: RunnerExecuteRequest): Promise<RunnerExecutionEnvelope>;
+    /**
+     * Job 4: the jest-compatible JSON document, strictly mapped.
+     *
+     * Args:
+     *   raw: the JSON report text plus the runner exit status.
+     *
+     * Returns:
+     *   RunnerExecutionEnvelope: reporter INPUT, never a verdict. An
+     *   unreadable report, a zero-test run, and a report whose rows carry
+     *   no attributable identity are all `complete: false`.
+     */
+    parseResults(raw: RunnerRawResults): RunnerExecutionEnvelope;
+    /**
+     * The runner's native parsed report (diagnostics surfaces).
+     *
+     * Args:
+     *   raw: the JSON report text plus the runner exit status.
+     *
+     * Returns:
+     *   VitestJsonReport | null: the parsed document, or null when the
+     *   report is absent or unparsable (never a guess).
+     */
+    parseReport(raw: RunnerRawResults): VitestJsonReport | null;
+    /** The runner-flags document of one run (null when absent/broken). */
+    private readRunnerFlags;
+    /** The vitest CLI entry for a project (local-first), or null. */
+    private vitestEntryOf;
+    /**
+     * One bounded vitest CLI invocation (stdout/stderr captured).
+     *
+     * ENUMERATION runs the CONSUMER's own vitest config, so the child
+     * environment is the `untrustedEnv` one: every ambient `GATEFORGE_*`
+     * name is stripped, which keeps the verifier key, the run token and
+     * the witness URL out of reach of the repository being gated. The
+     * ambient `GATEFORGE_REPORTER_FAIL_RUN` the old merge carried is
+     * stripped by the same rule, so the list child cannot be armed to
+     * fail a run it never reports.
+     */
+    private spawnVitest;
+}
+/**
+ * Merges the gateforge reporter's runner-flags document into an
+ * envelope (retry detection is only observable from the reporter, not
+ * from the JSON document).
+ *
+ * Args:
+ *   envelope: the envelope `parseResults` produced.
+ *   flagsJson: the runner-flags document text (empty when absent).
+ *
+ * Returns:
+ *   RunnerExecutionEnvelope: the envelope with retry evidence merged;
+ *   a retry-detected run blocks (required retries are zero).
+ */
+export declare function mergeVitestRunnerFlags(envelope: RunnerExecutionEnvelope, flagsJson: string): RunnerExecutionEnvelope;
+/**
+ * Escapes one literal test name for use inside a regular expression, so
+ * a name that contains regex metacharacters matches itself and nothing
+ * else.
+ *
+ * Args:
+ *   value: the literal title text.
+ *
+ * Returns:
+ *   string: the escaped literal.
+ */
+export declare function escapeRegExp(value: string): string;
+export {};
+//# sourceMappingURL=vitest-runner-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-runner-adapter.d.ts","sourceRoot":"","sources":["../../src/discovery/vitest-runner-adapter.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,6BAA6B,CAAC;AAMrC,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,yBAAyB,CAAC;AAC5D,eAAO,MAAM,wBAAwB,4BAA4B,CAAC;AAClE,eAAO,MAAM,4BAA4B,gCAAgC,CAAC;AAE1E,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAIhD,CAAC;AAKF,kFAAkF;AAClF,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,qCAAqC;AACrC,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC3D;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAClD;AAQD,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,aAAa,CAAC,gBAAgB,GAAG,IAAI,CAAC;IASpE,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,QAAQ,CAAC,MAAM,YAAY;IAE3B,QAAQ,CAAC,YAAY;;;;MAIV;gBAEkB,OAAO,GAAE,0BAA+B;IAErE;;;;;;;;;;;OAWG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoDxD;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,qBAAqB,GAAG,cAAc;IAoBpF;;;;;;;;;;;;;;;;OAgBG;IACG,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAyH9E;;;;;;;;;;OAUG;IACH,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,uBAAuB;IA0D5D;;;;;;;;;OASG;IACH,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,IAAI;IAS3D,sEAAsE;IACtE,OAAO,CAAC,eAAe;IAWvB,iEAAiE;IACjE,OAAO,CAAC,aAAa;IAWrB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;CAkCpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,uBAAuB,EACjC,SAAS,EAAE,MAAM,GAChB,uBAAuB,CAiBzB;AAiFD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD"}