@gate-forge/pack-playwright 0.7.1 → 0.9.0

package/dist/cypress/spec-scan.js

@@ -0,0 +1,301 @@
+/**
+ * Static enumeration of a Cypress project's specs (plan 2026-09-25
+ * phase 2, job 1).
+ *
+ * Cypress has no `--list-tests` mode: the only runner-native way to
+ * learn the test set is to RUN the suite, which would execute the very
+ * tests whose set must be fixed BEFORE the run. So the expected set is
+ * read from the spec sources instead, and it is read FAIL CLOSED: a
+ * spec whose suite or test titles are not static string literals cannot
+ * be enumerated honestly, and the enumeration reports `unavailable`
+ * rather than a partial guess — supervision then blocks the run, never
+ * a green run against a half-known expected set.
+ *
+ * Scope: the spec files Cypress itself collects by default under a
+ * `cypress/` tree — `*.cy.{js,jsx,ts,tsx}` and `*.spec.{js,jsx,ts,tsx}`
+ * (support files and `node_modules` are never specs).
+ */
+import { readFileSync, readdirSync } from 'node:fs';
+import { join, relative } from 'node:path';
+/** Spec file extensions Cypress collects by default. */
+const SPEC_EXTENSIONS = [
+    '.cy.js',
+    '.cy.jsx',
+    '.cy.ts',
+    '.cy.tsx',
+    '.spec.js',
+    '.spec.jsx',
+    '.spec.ts',
+    '.spec.tsx',
+];
+/** Directory names never walked while collecting specs. */
+const SKIPPED_DIRECTORIES = [
+    'node_modules',
+    'support',
+    'downloads',
+    'screenshots',
+    'videos',
+];
+/** The opening token of a suite declaration (`describe`/`context`). */
+const SUITE_TOKENS = [
+    'describe.only',
+    'describe.skip',
+    'context.only',
+    'context.skip',
+    'describe',
+    'context',
+];
+/** A suite opening token (any `describe`/`context` modifier). */
+const SUITE_TOKEN = /^(?:describe|context)(?:\.(?:only|skip))?$/;
+/** A test opening token (`it`/`test`, any modifier). */
+const TEST_TOKEN = /^(?:it|test)(?:\.(?:only|skip))?$/;
+/** Why one spec could not be enumerated statically. */
+class UnscannableSpec extends Error {
+}
+/**
+ * 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 function cypressSpecFiles(root) {
+    const found = [];
+    const walk = (directory) => {
+        let entries;
+        try {
+            entries = readdirSync(directory, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                if (!SKIPPED_DIRECTORIES.includes(entry.name))
+                    walk(join(directory, entry.name));
+                continue;
+            }
+            if (SPEC_EXTENSIONS.some((extension) => entry.name.endsWith(extension))) {
+                found.push(relative(root, join(directory, entry.name)).split('\\').join('/'));
+            }
+        }
+    };
+    walk(join(root, 'cypress'));
+    return found.sort();
+}
+/**
+ * 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 function scanCypressSpecs(root) {
+    const files = cypressSpecFiles(root);
+    if (files.length === 0) {
+        return {
+            status: 'unavailable',
+            detail: `no Cypress spec file under ${join(root, 'cypress')} — a zero-test project never proves coverage`,
+        };
+    }
+    const tests = [];
+    for (const file of files) {
+        let source;
+        try {
+            source = readFileSync(join(root, file), 'utf8');
+        }
+        catch (error) {
+            return { status: 'unavailable', detail: `cannot read Cypress spec '${file}': ${error.message}` };
+        }
+        let declarations;
+        try {
+            declarations = declarationsOf(source);
+        }
+        catch (error) {
+            const reason = error instanceof UnscannableSpec ? error.message : error.message;
+            return {
+                status: 'unavailable',
+                detail: `Cypress spec '${file}' cannot be enumerated statically (${reason}) — ` +
+                    'the expected set is never guessed',
+            };
+        }
+        tests.push(...resolveTitlePaths(declarations).map((resolved) => ({ file, titlePath: resolved })));
+    }
+    if (tests.length === 0) {
+        return {
+            status: 'unavailable',
+            detail: `the ${String(files.length)} Cypress spec file(s) under ${root} declare no test`,
+        };
+    }
+    return { status: 'scanned', tests };
+}
+/**
+ * Scans one spec source into its suite/test declarations.
+ *
+ * Args:
+ *   source: the spec file text.
+ *
+ * Returns:
+ *   Declaration[]: declarations in source order.
+ *
+ * Throws:
+ *   UnscannableSpec: when a declaration's title is not a static string
+ *   literal (the expected set would be a guess).
+ */
+function declarationsOf(source) {
+    const declarations = [];
+    let index = 0;
+    let depth = 0;
+    while (index < source.length) {
+        const character = source[index];
+        if (character === '/' && (source[index + 1] === '/' || source[index + 1] === '*')) {
+            index = skipComment(source, index);
+            continue;
+        }
+        if (character === '"' || character === "'" || character === '`') {
+            index = skipStringLiteral(source, index, character);
+            continue;
+        }
+        if (character === '{') {
+            depth += 1;
+            index += 1;
+            continue;
+        }
+        if (character === '}') {
+            depth -= 1;
+            index += 1;
+            continue;
+        }
+        const declaration = declarationAt(source, index, depth);
+        if (declaration !== null) {
+            declarations.push(declaration.declaration);
+            index = declaration.next;
+            continue;
+        }
+        index += 1;
+    }
+    return declarations;
+}
+/** The index just past the line or block comment starting at `start`. */
+function skipComment(source, start) {
+    if (source[start + 1] === '/') {
+        const end = source.indexOf('\n', start);
+        return end === -1 ? source.length : end;
+    }
+    const end = source.indexOf('*/', start + 2);
+    return end === -1 ? source.length : end + 2;
+}
+/**
+ * Skips one string literal (quotes and escapes), returning the index
+ * just past its end.
+ */
+function skipStringLiteral(source, start, quote) {
+    let index = start + 1;
+    while (index < source.length) {
+        const character = source[index];
+        if (character === '\\') {
+            index += 2;
+            continue;
+        }
+        if (character === quote)
+            return index + 1;
+        index += 1;
+    }
+    return source.length;
+}
+/**
+ * Matches a suite/test declaration whose identifier starts at `index`.
+ *
+ * Args:
+ *   source: the spec file text.
+ *   index: the candidate identifier start.
+ *   depth: the brace depth in effect at `index`.
+ *
+ * Returns:
+ *   { declaration: Declaration; next: number } | null: the parsed
+ *   declaration and the index just past its argument list; null when
+ *   the position starts no declaration.
+ *
+ * Throws:
+ *   UnscannableSpec: when the declaration's title is not a literal.
+ */
+function declarationAt(source, index, depth) {
+    if (index > 0 && /[\w$.]/.test(source[index - 1]))
+        return null;
+    const window = source.slice(index, index + 40);
+    const suite = SUITE_TOKENS.find((token) => window.startsWith(token) && !/[\w$]/.test(window[token.length] ?? ''));
+    const test = /^(?:it|test)(?:\.(?:only|skip))?(?![A-Za-z0-9_$])/.exec(window);
+    const token = suite ?? test?.[0];
+    if (token === undefined)
+        return null;
+    const open = source.indexOf('(', index + token.length);
+    if (open === -1)
+        throw new UnscannableSpec(`'${token}' has no argument list`);
+    // Resume right after the TITLE literal, not after the whole argument
+    // list: a suite's body holds the declarations nested inside it, and
+    // brace-depth scoping resolves them.
+    const { title, end } = readLiteralTitle(source, open + 1, token);
+    return {
+        declaration: { kind: TEST_TOKEN.test(token) ? 'test' : 'suite', title, depth },
+        next: end,
+    };
+}
+/**
+ * Reads a declaration's static title literal.
+ *
+ * Args:
+ *   source: the spec file text.
+ *   start: the index just after the opening parenthesis.
+ *   token: the declaration token (named in the failure message).
+ *
+ * Returns:
+ *   { title: string; end: number }: the literal title and the index just
+ *   past its closing quote.
+ *
+ * Throws:
+ *   UnscannableSpec: when the first argument is not a string literal.
+ */
+function readLiteralTitle(source, start, token) {
+    let index = start;
+    while (index < source.length && /\s/.test(source[index]))
+        index += 1;
+    const quote = source[index];
+    if (quote !== '"' && quote !== "'" && quote !== '`') {
+        throw new UnscannableSpec(`'${token}' has a non-literal title`);
+    }
+    const end = skipStringLiteral(source, index, quote);
+    return { title: source.slice(index + 1, end - 1), end };
+}
+/**
+ * Resolves the full title path of every test declaration: a suite
+ * scopes the declarations nested inside its own brace depth.
+ *
+ * Args:
+ *   declarations: the declarations in source order, with brace depths.
+ *
+ * Returns:
+ *   string[][]: one suite chain + leaf title per test declaration.
+ */
+function resolveTitlePaths(declarations) {
+    const resolved = [];
+    const open = [];
+    for (const declaration of declarations) {
+        while (open.length > 0 && open[open.length - 1].depth >= declaration.depth) {
+            open.pop();
+        }
+        if (declaration.kind === 'suite') {
+            open.push({ title: declaration.title, depth: declaration.depth });
+            continue;
+        }
+        resolved.push([...open.map((suite) => suite.title), declaration.title]);
+    }
+    return resolved;
+}
+//# sourceMappingURL=spec-scan.js.map

package/dist/cypress/spec-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-scan.js","sourceRoot":"","sources":["../../src/cypress/spec-scan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAe,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAe3C,wDAAwD;AACxD,MAAM,eAAe,GAAsB;IACzC,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,UAAU;IACV,WAAW;IACX,UAAU;IACV,WAAW;CACZ,CAAC;AAEF,2DAA2D;AAC3D,MAAM,mBAAmB,GAAsB;IAC7C,cAAc;IACd,SAAS;IACT,WAAW;IACX,aAAa;IACb,QAAQ;CACT,CAAC;AAEF,uEAAuE;AACvE,MAAM,YAAY,GAAsB;IACtC,eAAe;IACf,eAAe;IACf,cAAc;IACd,cAAc;IACd,UAAU;IACV,SAAS;CACV,CAAC;AAEF,iEAAiE;AACjE,MAAM,WAAW,GAAG,4CAA4C,CAAC;AAEjE,wDAAwD;AACxD,MAAM,UAAU,GAAG,mCAAmC,CAAC;AAEvD,uDAAuD;AACvD,MAAM,eAAgB,SAAQ,KAAK;CAAG;AAUtC;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAQ,EAAE;QACvC,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjF,SAAS;YACX,CAAC;YACD,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACxE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,8BAA8B,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,8CAA8C;SAC1G,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,6BAA6B,IAAI,MAAO,KAAe,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9G,CAAC;QACD,IAAI,YAA2B,CAAC;QAChC,IAAI,CAAC;YACH,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAE,KAAe,CAAC,OAAO,CAAC;YAC3F,OAAO;gBACL,MAAM,EAAE,aAAa;gBACrB,MAAM,EACJ,iBAAiB,IAAI,sCAAsC,MAAM,MAAM;oBACvE,mCAAmC;aACtC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IACpG,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,+BAA+B,IAAI,kBAAkB;SACzF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,YAAY,GAAkB,EAAE,CAAC;IACvC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAW,CAAC;QAC1C,IAAI,SAAS,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YAClF,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QACD,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YAChE,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QACD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,KAAK,IAAI,CAAC,CAAC;YACX,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,KAAK,IAAI,CAAC,CAAC;YACX,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACxD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YAC3C,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC;YACzB,SAAS;QACX,CAAC;QACD,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,yEAAyE;AACzE,SAAS,WAAW,CAAC,MAAc,EAAE,KAAa;IAChD,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1C,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5C,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,MAAc,EAAE,KAAa,EAAE,KAAa;IACrE,IAAI,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACtB,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,SAAS,KAAK,KAAK;YAAE,OAAO,KAAK,GAAG,CAAC,CAAC;QAC1C,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,aAAa,CACpB,MAAc,EACd,KAAa,EACb,KAAa;IAEb,IAAI,KAAK,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAC7B,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CACjF,CAAC;IACF,MAAM,IAAI,GAAG,mDAAmD,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,IAAI,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,IAAI,KAAK,wBAAwB,CAAC,CAAC;IAC9E,qEAAqE;IACrE,oEAAoE;IACpE,qCAAqC;IACrC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACjE,OAAO;QACL,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE;QAC9E,IAAI,EAAE,GAAG;KACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,gBAAgB,CACvB,MAAc,EACd,KAAa,EACb,KAAa;IAEb,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAW,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QACpD,MAAM,IAAI,eAAe,CAAC,IAAI,KAAK,2BAA2B,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,GAAG,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CAAC,YAAoC;IAC7D,MAAM,QAAQ,GAAe,EAAE,CAAC;IAChC,MAAM,IAAI,GAA4C,EAAE,CAAC;IACzD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAK,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAuB,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YAClG,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;QACD,IAAI,WAAW,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;YAClE,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/diagnosis.d.ts

@@ -0,0 +1,39 @@
+/** The structural shape every runner's serialized error reduces to. */
+export interface SerializedFailure {
+    /** The runner's own error message. */
+    message?: string;
+    /** The runner's own serialized stack, when it exposes one. */
+    stack?: string;
+}
+/** The diagnosis one failed test contributes to its `testEnd` event. */
+export interface FailureDiagnosis {
+    /** The runner's first error message. */
+    errorMessage: string;
+    /** Up to five repo-relative `file:line` frames, in runner order. */
+    stackFrames: string[];
+}
+/**
+ * The `file:line` frames of a serialized stack, repo-relative, first
+ * five. Anything that is not a source frame (a message line, a runtime
+ * banner, a frame outside the tested tree) is dropped — a diagnosis
+ * points a human at a line of the repository, nothing else.
+ *
+ * Args:
+ *   stack: the runner's serialized stack text.
+ *
+ * Returns:
+ *   string[]: deduplicated `file:line` frames in the order reported.
+ */
+export declare function stackFramesOf(stack: string): string[];
+/**
+ * The diagnosis of one failed test, or null when the runner reported
+ * nothing usable (a passing test, or a runner that exposes no error).
+ *
+ * Args:
+ *   errors: the runner's serialized errors for the test, in its order.
+ *
+ * Returns:
+ *   FailureDiagnosis | null: the first error's message and short stack.
+ */
+export declare function failureDiagnosisOf(errors: readonly SerializedFailure[] | undefined): FailureDiagnosis | null;
+//# sourceMappingURL=diagnosis.d.ts.map

package/dist/diagnosis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosis.d.ts","sourceRoot":"","sources":["../src/diagnosis.ts"],"names":[],"mappings":"AAcA,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAWrD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,GAC/C,gBAAgB,GAAG,IAAI,CAOzB"}

package/dist/diagnosis.js

@@ -0,0 +1,63 @@
+/**
+ * The ADDITIVE failure diagnosis a runner adapter may attach to its
+ * `testEnd` spool event, for the CI progress stream and the
+ * Gateforge-owned failures artifact.
+ *
+ * This is the one place runner output is ever consulted, and it is
+ * consulted structurally, never as text: a failing test's first error
+ * message and up to five `file:line` frames. The runner's raw log is
+ * never copied, filtered, or tailed — a filter over secret text is not
+ * secret-free, and the trusted CLI screens the message against the
+ * credential shapes before it reaches a console or an artifact.
+ */
+import { relative, sep } from 'node:path';
+/** The most stack frames a diagnosis keeps. */
+const MAX_FRAMES = 5;
+/**
+ * The `file:line` frames of a serialized stack, repo-relative, first
+ * five. Anything that is not a source frame (a message line, a runtime
+ * banner, a frame outside the tested tree) is dropped — a diagnosis
+ * points a human at a line of the repository, nothing else.
+ *
+ * Args:
+ *   stack: the runner's serialized stack text.
+ *
+ * Returns:
+ *   string[]: deduplicated `file:line` frames in the order reported.
+ */
+export function stackFramesOf(stack) {
+    const frames = [];
+    for (const line of stack.split('\n')) {
+        const match = /(?:at\s+.*\()?(\S+):(\d+)(?::\d+)?\)?\s*$/.exec(line.trim());
+        if (match === null)
+            continue;
+        const file = relative(process.cwd(), match[1] ?? '').split(sep).join('/');
+        if (file.length === 0 || file.startsWith('..'))
+            continue;
+        frames.push(`${file}:${match[2] ?? '0'}`);
+        if (frames.length === MAX_FRAMES)
+            break;
+    }
+    return frames;
+}
+/**
+ * The diagnosis of one failed test, or null when the runner reported
+ * nothing usable (a passing test, or a runner that exposes no error).
+ *
+ * Args:
+ *   errors: the runner's serialized errors for the test, in its order.
+ *
+ * Returns:
+ *   FailureDiagnosis | null: the first error's message and short stack.
+ */
+export function failureDiagnosisOf(errors) {
+    const first = errors?.[0];
+    if (first === undefined)
+        return null;
+    const message = typeof first.message === 'string' ? first.message : '';
+    const frames = typeof first.stack === 'string' ? [...new Set(stackFramesOf(first.stack))] : [];
+    if (message.length === 0 && frames.length === 0)
+        return null;
+    return { errorMessage: message, stackFrames: frames };
+}
+//# sourceMappingURL=diagnosis.js.map

package/dist/diagnosis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosis.js","sourceRoot":"","sources":["../src/diagnosis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAkB1C,+CAA+C;AAC/C,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5E,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAC7B,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACzD,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU;YAAE,MAAM;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAgD;IAEhD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AACxD,CAAC"}

package/dist/discovery/adapter-projection.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Reads a literal `fields` array from an adapter's default export without
+ * evaluating the adapter module.
+ *
+ * Args:
+ *   sourceText: JavaScript or TypeScript module source.
+ *
+ * Returns:
+ *   string[] | null: the declared literal field projection, or null when absent
+ *   or when the module uses a dynamic/unrecognized declaration.
+ */
+export declare function staticAdapterFieldsFromSource(sourceText: string): string[] | null;
+//# sourceMappingURL=adapter-projection.d.ts.map

package/dist/discovery/adapter-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-projection.d.ts","sourceRoot":"","sources":["../../src/discovery/adapter-projection.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAyCjF"}

package/dist/discovery/adapter-projection.js

@@ -0,0 +1,84 @@
+/**
+ * Safe static extraction of adapter field projections. Adapter modules
+ * are never executed to answer repository policy questions.
+ */
+import ts from 'typescript';
+/**
+ * Removes syntax-only wrappers from a statically inspectable expression.
+ *
+ * Args:
+ *   expression: parsed TypeScript expression.
+ *
+ * Returns:
+ *   ts.Expression: the wrapped expression without parentheses or type syntax.
+ */
+function unwrapStaticExpression(expression) {
+    let current = expression;
+    while (ts.isParenthesizedExpression(current) ||
+        ts.isAsExpression(current) ||
+        ts.isTypeAssertionExpression(current) ||
+        ts.isNonNullExpression(current) ||
+        ts.isSatisfiesExpression(current)) {
+        current = current.expression;
+    }
+    return current;
+}
+/**
+ * Reads a literal `fields` array from an adapter's default export without
+ * evaluating the adapter module.
+ *
+ * Args:
+ *   sourceText: JavaScript or TypeScript module source.
+ *
+ * Returns:
+ *   string[] | null: the declared literal field projection, or null when absent
+ *   or when the module uses a dynamic/unrecognized declaration.
+ */
+export function staticAdapterFieldsFromSource(sourceText) {
+    const source = ts.createSourceFile('adapter.mjs', sourceText, ts.ScriptTarget.Latest, true, ts.ScriptKind.JS);
+    const parseDiagnostics = source.parseDiagnostics ?? [];
+    if (parseDiagnostics.length > 0)
+        return null;
+    const exportAssignment = source.statements.find((statement) => ts.isExportAssignment(statement) && !statement.isExportEquals);
+    if (exportAssignment === undefined)
+        return null;
+    let exported = unwrapStaticExpression(exportAssignment.expression);
+    if (ts.isIdentifier(exported)) {
+        const exportName = exported.text;
+        const declaration = source.statements
+            .filter(ts.isVariableStatement)
+            .flatMap((statement) => statement.declarationList.declarations)
+            .find((candidate) => ts.isIdentifier(candidate.name) && candidate.name.text === exportName);
+        if (declaration?.initializer === undefined)
+            return null;
+        exported = unwrapStaticExpression(declaration.initializer);
+    }
+    if (!ts.isObjectLiteralExpression(exported))
+        return null;
+    const fieldProperties = exported.properties.filter((member) => {
+        if (!ts.isPropertyAssignment(member))
+            return false;
+        const name = member.name;
+        return ((ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNoSubstitutionTemplateLiteral(name)) &&
+            name.text === 'fields');
+    });
+    if (fieldProperties.length !== 1)
+        return null;
+    const property = fieldProperties[0];
+    if (property === undefined || !ts.isPropertyAssignment(property))
+        return null;
+    const initializer = unwrapStaticExpression(property.initializer);
+    if (!ts.isArrayLiteralExpression(initializer))
+        return null;
+    const fields = [];
+    for (const element of initializer.elements) {
+        const value = unwrapStaticExpression(element);
+        if (!ts.isStringLiteral(value) && !ts.isNoSubstitutionTemplateLiteral(value))
+            return null;
+        if (value.text.length === 0)
+            return null;
+        fields.push(value.text);
+    }
+    return fields;
+}
+//# sourceMappingURL=adapter-projection.js.map

package/dist/discovery/adapter-projection.js.map

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

package/dist/discovery/config-locations.d.ts

@@ -0,0 +1,5 @@
+/** Configuration search convention shared by enumeration and sealed-tree re-sealing. */
+export declare const PLAYWRIGHT_CONFIG_NAMES: readonly ["playwright.config.ts", "playwright.config.mts", "playwright.config.cts", "playwright.config.js", "playwright.config.mjs", "playwright.config.cjs"];
+/** Dependency trees, build output, VCS state, and runner artifacts are not projects. */
+export declare const CONFIG_SEARCH_PRUNED_DIRS: Readonly<Record<string, true>>;
+//# sourceMappingURL=config-locations.d.ts.map

package/dist/discovery/config-locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-locations.d.ts","sourceRoot":"","sources":["../../src/discovery/config-locations.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,eAAO,MAAM,uBAAuB,+JAO1B,CAAC;AAEX,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAOpE,CAAC"}

package/dist/discovery/config-locations.js

@@ -0,0 +1,19 @@
+/** Configuration search convention shared by enumeration and sealed-tree re-sealing. */
+export const PLAYWRIGHT_CONFIG_NAMES = [
+    'playwright.config.ts',
+    'playwright.config.mts',
+    'playwright.config.cts',
+    'playwright.config.js',
+    'playwright.config.mjs',
+    'playwright.config.cjs',
+];
+/** Dependency trees, build output, VCS state, and runner artifacts are not projects. */
+export const CONFIG_SEARCH_PRUNED_DIRS = {
+    node_modules: true,
+    dist: true,
+    '.git': true,
+    'test-results': true,
+    coverage: true,
+    build: true,
+};
+//# sourceMappingURL=config-locations.js.map

package/dist/discovery/config-locations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-locations.js","sourceRoot":"","sources":["../../src/discovery/config-locations.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;IACvB,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;CACf,CAAC;AAEX,wFAAwF;AACxF,MAAM,CAAC,MAAM,yBAAyB,GAAmC;IACvE,YAAY,EAAE,IAAI;IAClB,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;IACZ,cAAc,EAAE,IAAI;IACpB,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;CACZ,CAAC"}