@gate-forge/pack-playwright 0.7.1 → 0.8.0

package/dist/cypress/plugin.js

@@ -0,0 +1,369 @@
+/**
+ * The Cypress side of the witness channel (plan 2026-09-25 phase 2).
+ *
+ * Cypress exposes exactly two runner-side seams, and this module uses
+ * both — nothing else about a Cypress run is trusted:
+ *
+ * - `setupNodeEvents` (`on('task')` + `on('after:run')`) runs in the
+ *   Cypress PROCESS. The pack registers the lifecycle tasks the
+ *   generated support file calls (`gateforge:test-begin` /
+ *   `gateforge:test-end`): each appends the same lifecycle spool event
+ *   the Playwright reporter writes (testBegin with the obligation
+ *   claims, testEnd with the outcome and attempt), and `test-begin`
+ *   additionally resolves the supervisor-issued session for the
+ *   running test and hands its proxy origin to the browser. That
+ *   process holds no verifier key and no supervisor rights — the
+ *   TRUSTED CLI drain reads the spool and performs the witness calls.
+ * - `on('after:run')` receives mocha's own results. The plugin writes
+ *   them to the run's report document in the pack's fixed shape
+ *   (`<stateDir>/cypress/<runId>/report.json`): per spec, per test the
+ *   title path, the state, and the ATTEMPT COUNT. A runner-assisted
+ *   retry (Cypress `retries`) is therefore visible in the report and
+ *   blocks the run — required retries are zero.
+ *
+ * Everything is INERT without supervised wiring: with no
+ * `GATEFORGE_STATE_DIR`/`GATEFORGE_RUN_ID` in the environment the tasks
+ * are not registered, the support file's calls fail loudly, and a
+ * plain `cypress run` behaves exactly as without the pack.
+ */
+import { appendFileSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { failureDiagnosisOf } from '../diagnosis.js';
+import { dirname, join } from 'node:path';
+import { canonicalOf } from '../json.js';
+import { claimInjectionsFor } from '../runner-claims.js';
+/** The Cypress task the support file calls when a test starts. */
+const TASK_TEST_BEGIN = 'gateforge:test-begin';
+/** The Cypress task the support file calls when a test ends. */
+const TASK_TEST_END = 'gateforge:test-end';
+/** Header the run token travels in (the same name the fixture uses). */
+const RUN_HEADER = 'x-gateforge-run';
+/** How long a started test waits for the drain to open its session. */
+const SESSION_RESOLVE_TIMEOUT_MS = 10_000;
+/** Poll cadence for the session resolve (supervisor → witness latency). */
+const SESSION_RESOLVE_POLL_MS = 50;
+/** The mocha error the support file reports for a failing test. */
+function errorOf(payload) {
+    if (typeof payload !== 'object' || payload === null || !('error' in payload))
+        return undefined;
+    const error = payload.error;
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    return [error];
+}
+/** The run-scoped wiring read from the environment, once. */
+function pluginEnv() {
+    const stateDir = process.env['GATEFORGE_STATE_DIR'] ?? '';
+    const runId = process.env['GATEFORGE_RUN_ID'] ?? '';
+    const witnessUrl = process.env['GATEFORGE_WITNESS_URL'] ?? '';
+    const runToken = process.env['GATEFORGE_RUN_TOKEN'] ?? '';
+    const spooled = stateDir !== '' && runId !== '';
+    return {
+        stateDir: spooled ? stateDir : null,
+        runId: spooled ? runId : null,
+        witnessUrl: witnessUrl === '' ? null : witnessUrl,
+        runToken: runToken === '' ? null : runToken,
+        appBaseUrl: process.env['GATEFORGE_APP_BASE_URL'] ?? '',
+    };
+}
+/**
+ * Registers the gateforge Cypress tasks and the run report writer.
+ *
+ * Args:
+ *   on: Cypress's `setupNodeEvents(on, config)` registrar.
+ *
+ * Returns:
+ *   void
+ */
+export function registerGateforgeCypressPlugin(on) {
+    const env = pluginEnv();
+    if (env.stateDir === null || env.runId === null)
+        return;
+    // With a run-scoped state dir the tasks ARE registered even when no
+    // witness is wired: the lifecycle spool is the runner's own record,
+    // and a test that then addresses a configured app without an open
+    // session is refused rather than passing untagged.
+    const spoolFile = join(env.stateDir, 'spool', env.runId, 'events.jsonl');
+    const reportFile = join(env.stateDir, 'cypress', env.runId, 'report.json');
+    on('task', {
+        [TASK_TEST_BEGIN]: async (payload) => {
+            const identity = identityOf(payload);
+            appendEvent(spoolFile, {
+                kind: 'testBegin',
+                testId: identity.testId,
+                workerIndex: 0,
+                file: identity.file,
+                titlePath: identity.titlePath,
+                project: null,
+                ...claimsFor(env.stateDir, identity.testId),
+            });
+            const credential = env.witnessUrl === null || env.runToken === null
+                ? { sessionId: '', sessionToken: '', proxyUrl: null }
+                : await resolveSession(env, identity);
+            return { ...credential, appBaseUrl: env.appBaseUrl };
+        },
+        [TASK_TEST_END]: (payload) => {
+            const identity = identityOf(payload);
+            const state = stateOf(payload);
+            appendEvent(spoolFile, {
+                kind: 'testEnd',
+                testId: identity.testId,
+                workerIndex: 0,
+                file: identity.file,
+                titlePath: identity.titlePath,
+                project: null,
+                outcome: state === 'passed' ? 'passed' : state === 'pending' ? 'skipped' : 'failed',
+                attempt: attemptOf(payload),
+                // Additive diagnosis for a non-passing test (mocha's own
+                // `err`): the CI progress stream and the failures artifact are
+                // the only readers, and the CLI screens the message first.
+                ...(state === 'passed' ? {} : (failureDiagnosisOf(errorOf(payload)) ?? {})),
+            });
+            return null;
+        },
+    });
+    on('after:run', (results) => {
+        writeRunReport(reportFile, results);
+    });
+}
+/**
+ * Normalizes the identity the support file reports, or refuses it: a
+ * task payload with no file and no title is never attributed to a test.
+ *
+ * Args:
+ *   payload: the raw `cy.task` payload.
+ *
+ * Returns:
+ *   { testId: string; file: string | null; titlePath: string[] }: the
+ *   reconciliation identity (`<file>#<title path>`).
+ *
+ * Throws:
+ *   Error: when the payload carries no file and no title path.
+ */
+function identityOf(payload) {
+    const record = (typeof payload === 'object' && payload !== null ? payload : {});
+    const file = typeof record.file === 'string' && record.file !== '' ? record.file : null;
+    const titlePath = Array.isArray(record.titlePath)
+        ? record.titlePath.filter((title) => typeof title === 'string')
+        : typeof record.testId === 'string' && record.testId.includes('#')
+            ? [record.testId.split('#')[1]]
+            : [];
+    if (file === null && titlePath.length === 0) {
+        throw new Error('gateforge: the Cypress support file reported a test with no file and no title — ' +
+            'such a test can never be attributed to a session');
+    }
+    const key = `${file ?? '-'}>${titlePath.join('>')}`;
+    return { testId: typeof record.testId === 'string' && record.testId !== '' ? record.testId : key, file, titlePath };
+}
+/** The observed state the support file reports (default: failed). */
+function stateOf(payload) {
+    const record = (typeof payload === 'object' && payload !== null ? payload : {});
+    return typeof record.state === 'string' ? record.state : 'failed';
+}
+/** The 1-based attempt the support file reports (default: 1). */
+function attemptOf(payload) {
+    const record = (typeof payload === 'object' && payload !== null ? payload : {});
+    return typeof record.attempt === 'number' && record.attempt >= 1 ? Math.trunc(record.attempt) : 1;
+}
+/** The claims a spooled `testBegin` carries for one key. */
+function claimsFor(stateDir, testId) {
+    const claims = claimInjectionsFor(stateDir, testId);
+    return claims.length > 0 ? { claims } : {};
+}
+/** Appends one lifecycle event (never crashes the run on failure). */
+function appendEvent(spoolFile, event) {
+    try {
+        mkdirSync(dirname(spoolFile), { recursive: true });
+        appendFileSync(spoolFile, `${canonicalOf(event)}\n`, 'utf8');
+    }
+    catch (error) {
+        console.warn(`[gateforge] cannot append to the lifecycle spool: ${error.message}`);
+    }
+}
+/**
+ * Resolves the supervisor-issued session for a started test by asking
+ * the witness, exactly like the Playwright fixture and the pytest
+ * plugin. The drain opens the session from the spooled `testBegin`, so
+ * the first attempts race it and are retried briefly.
+ *
+ * Args:
+ *   env: the run-scoped wiring.
+ *   identity: the started test's reconciliation identity.
+ *
+ * Returns:
+ *   Promise<CypressSessionCredential>: the open session's credential.
+ *
+ * Throws:
+ *   Error: when no open session answers within the bound — an
+ *   unattributable test fails loudly instead of running untagged.
+ */
+async function resolveSession(env, identity) {
+    const witnessUrl = env.witnessUrl;
+    const runToken = env.runToken;
+    const deadline = Date.now() + SESSION_RESOLVE_TIMEOUT_MS;
+    let lastDetail = 'no answer';
+    while (Date.now() < deadline) {
+        try {
+            const response = await fetch(`${witnessUrl.replace(/\/$/, '')}/sessions/resolve`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json', [RUN_HEADER]: runToken },
+                body: JSON.stringify({ testId: identity.testId, workerIndex: 0 }),
+            });
+            if (response.ok) {
+                const body = (await response.json());
+                if (typeof body.sessionId === 'string' && body.sessionId !== '') {
+                    return {
+                        sessionId: body.sessionId,
+                        sessionToken: typeof body.sessionToken === 'string' ? body.sessionToken : '',
+                        proxyUrl: typeof body.proxyUrl === 'string' && body.proxyUrl !== '' ? body.proxyUrl : null,
+                    };
+                }
+                lastDetail = 'malformed resolve response';
+            }
+            else if (response.status !== 404) {
+                lastDetail = `HTTP ${String(response.status)} from /sessions/resolve`;
+            }
+        }
+        catch (error) {
+            lastDetail = error.message;
+        }
+        await new Promise((resolveSleep) => {
+            setTimeout(resolveSleep, SESSION_RESOLVE_POLL_MS);
+        });
+    }
+    throw new Error(`[gateforge] no open witness session answered for Cypress test '${identity.testId}' within ` +
+        `${String(SESSION_RESOLVE_TIMEOUT_MS)}ms (${lastDetail}) — a test whose traffic cannot be ` +
+        'attributed is never allowed to pass');
+}
+/**
+ * Writes the run's report document from mocha's own `after:run`
+ * results: per spec, per test the title path, the state, and the
+ * attempt count. A test with more than one attempt is a
+ * runner-assisted retry, which blocks the run.
+ *
+ * Args:
+ *   reportFile: the run-scoped report path.
+ *   results: Cypress's `after:run` payload.
+ */
+function writeRunReport(reportFile, results) {
+    const specs = [];
+    let retriesDetected = false;
+    for (const run of results.runs ?? []) {
+        const file = typeof run.spec?.relative === 'string' ? run.spec.relative : '';
+        const tests = (run.tests ?? []).map((test) => {
+            const titlePath = Array.isArray(test.title)
+                ? test.title.filter((title) => typeof title === 'string')
+                : [];
+            const attempts = Array.isArray(test.attempts) ? test.attempts.length : 1;
+            if (attempts > 1)
+                retriesDetected = true;
+            return {
+                titlePath,
+                state: typeof test.state === 'string' ? test.state : 'failed',
+                attempts: Math.max(1, attempts),
+            };
+        });
+        specs.push({ file, tests });
+    }
+    try {
+        mkdirSync(dirname(reportFile), { recursive: true });
+        const report = { schemaVersion: 1, retriesDetected, specs };
+        writeFileSync(reportFile, `${canonicalOf(report)}\n`, 'utf8');
+    }
+    catch (error) {
+        console.warn(`[gateforge] cannot write the Cypress run report: ${error.message}`);
+    }
+}
+/**
+ * The generated Cypress support file: the in-browser half of the
+ * channel. It opens each test's session through the plugin task, and
+ * rewrites `cy.request` traffic addressed at the app origin onto that
+ * session's proxy origin, so every exchange is attributed to the test
+ * that issued it. Traffic addressed anywhere else (a raw browser
+ * `fetch` to the app, a third-party origin) is left ALONE and therefore
+ * stays unattributed — the witness credits it to nothing.
+ *
+ * Args:
+ *   projectSupportFile: the project's own support file (required first,
+ *     so its hooks and commands keep working), or null.
+ *
+ * Returns:
+ *   string: CommonJS support-file source.
+ */
+export function cypressSupportSource(projectSupportFile) {
+    const chained = projectSupportFile === null
+        ? ''
+        : `require(${JSON.stringify(projectSupportFile)});\n`;
+    return `// Generated by gateforge (plan 2026-09-25 phase 2). Do not edit.
+'use strict';
+${chained}
+const gateforgeSession = { proxyUrl: null, appBaseUrl: '' };
+
+beforeEach(function () {
+  const current = this.currentTest;
+  if (!current || typeof current.titlePath !== 'function') return;
+  const file = (Cypress.spec && Cypress.spec.relative) || '';
+  const titlePath = current.titlePath();
+  const attempt = (typeof this.test._currentRetry === 'number' ? this.test._currentRetry : 0) + 1;
+  cy.task('gateforge:test-begin', { testId: file + '#' + titlePath.join('>'), file: file, titlePath: titlePath, attempt: attempt })
+    .then((session) => {
+      gateforgeSession.proxyUrl = session && typeof session.proxyUrl === 'string' ? session.proxyUrl : null;
+      gateforgeSession.appBaseUrl = session && typeof session.appBaseUrl === 'string' ? session.appBaseUrl : '';
+    });
+});
+
+afterEach(function () {
+  const current = this.currentTest;
+  gateforgeSession.proxyUrl = null;
+  if (!current || typeof current.titlePath !== 'function') return;
+  const file = (Cypress.spec && Cypress.spec.relative) || '';
+  const titlePath = current.titlePath();
+  const attempt = (typeof this.test._currentRetry === 'number' ? this.test._currentRetry : 0) + 1;
+  cy.task('gateforge:test-end', {
+    testId: file + '#' + titlePath.join('>'),
+    file: file,
+    titlePath: titlePath,
+    state: current.state,
+    attempt: attempt,
+    error: current.err ? { message: String(current.err.message || ''), stack: String(current.err.stack || '') } : null,
+  });
+});
+
+// Job 2: cy.request traffic at the app origin crosses THIS test's
+// session proxy. Without an open session the request is refused: an
+// untagged request can never be witnessed evidence, so it must not
+// pass quietly.
+Cypress.Commands.overwrite('request', function (originalFn, ...args) {
+  const gateforgeRewrite = (value) => {
+    if (typeof value !== 'string' || gateforgeSession.appBaseUrl === '') return value;
+    let target;
+    try {
+      target = new URL(value, gateforgeSession.appBaseUrl);
+    } catch (error) {
+      return value;
+    }
+    let app;
+    try {
+      app = new URL(gateforgeSession.appBaseUrl);
+    } catch (error) {
+      return value;
+    }
+    if (target.origin !== app.origin) return value;
+    if (gateforgeSession.proxyUrl === null || gateforgeSession.proxyUrl === '') {
+      throw new Error(
+        'gateforge: this cy.request has no open witness session for the running test, so it could ' +
+          'never be witnessed evidence — run under gateforge test-gates (or the CypressRunnerAdapter) ' +
+          'and use cy.request (not a raw fetch) for app traffic. [GATEFORGE_WITNESS_SESSION_MISSING]'
+      );
+    }
+    return gateforgeSession.proxyUrl + target.pathname + target.search + target.hash;
+  };
+  const rewritten = args.map((arg) =>
+    arg !== null && typeof arg === 'object' && typeof arg.url === 'string'
+      ? Object.assign({}, arg, { url: gateforgeRewrite(arg.url) })
+      : gateforgeRewrite(arg)
+  );
+  return originalFn.apply(this, rewritten);
+});
+`;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/cypress/plugin.js.map

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

package/dist/cypress/spec-scan.d.ts

@@ -0,0 +1,39 @@
+/** One statically enumerated Cypress test. */
+export interface ScannedCypressTest {
+    /** Repo-relative posix spec path. */
+    readonly file: string;
+    /** Suite chain titles, then the leaf test title. */
+    readonly titlePath: readonly string[];
+}
+/** The outcome of scanning one project's spec tree. */
+export type SpecScanResult = {
+    readonly status: 'scanned';
+    readonly tests: readonly ScannedCypressTest[];
+} | {
+    readonly status: 'unavailable';
+    readonly detail: string;
+};
+/**
+ * Collects the spec files of a project (repo-relative posix paths,
+ * sorted). Only the default `cypress/` spec tree is walked.
+ *
+ * Args:
+ *   root: absolute project root.
+ *
+ * Returns:
+ *   string[]: the spec files, sorted; [] when the project has none.
+ */
+export declare function cypressSpecFiles(root: string): string[];
+/**
+ * Statically enumerates every test a project's specs declare.
+ *
+ * Args:
+ *   root: absolute project root.
+ *
+ * Returns:
+ *   SpecScanResult: the declared tests, or `unavailable` with a single
+ *   cause when a spec uses a non-literal title or declares no test
+ *   (never a partial set, never a faked empty success).
+ */
+export declare function scanCypressSpecs(root: string): SpecScanResult;
+//# sourceMappingURL=spec-scan.d.ts.map

package/dist/cypress/spec-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-scan.d.ts","sourceRoot":"","sources":["../../src/cypress/spec-scan.ts"],"names":[],"mappings":"AAoBA,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,uDAAuD;AACvD,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAkDhE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAqC7D"}