@gate-forge/pack-playwright 0.1.0

package/dist/discovery/adapters.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Runner adapters over the core contract (plan 2026-09-13 phase 2 item
+ * 6 + Phase 4 items 1/9): the Playwright adapter and the bounded pytest
+ * diagnostic adapter.
+ *
+ * Capability honesty (declared, never implied):
+ * - Playwright: `inventory`, `resolveInstances`, and (since Phase 4)
+ *   `execute` are AVAILABLE. `execute` runs the suite under trusted
+ *   supervision (ADR 0005 D2 + execution-authority fix): the consumer's
+ *   config file is NEVER loaded — the supervisor synthesizes a minimal
+ *   trusted config (exact selected files, bare project names as data,
+ *   the engine reporter forced by absolute path, serial workers, zero
+ *   retries) and runs it with a finite timeout. The gateforge
+ *   reporter's runner-outcomes document is REQUIRED input; a missing
+ *   document is an incomplete run (never a silent green). Consumer
+ *   globalSetup/teardown/reporters/webServer/per-project options are
+ *   NOT honored (constrained model, see trusted-config.ts).
+ * - Pytest: `inventory` (bounded collection), `resolveInstances`
+ *   (node-id identity), and (since Phase 4) `execute` — the §3.5
+ *   diagnostic execution: one isolated junit-XML run per suite in the
+ *   excluded run-state dir. Its results are DIAGNOSTIC data (never
+ *   witness evidence, never E2E satisfaction).
+ *
+ * Both adapters fail closed: an undeclared capability is an error, and
+ * inventory problems come back as typed catalog rows, never silence.
+ */
+import { loadConfig } from '@gate-forge/core';
+import type { DiagnosticSuite, RunnerCapabilities, RunnerExecutionEnvelope, RunnerSelection, RunnerExecutionEnv, RunnerTestInstance, TestCatalog, TestCatalogEntry, TestRunnerAdapter } from '@gate-forge/core';
+import { type DiscoverOptions } from './discover.js';
+import { type DiagnosticRunResult } from './pytest-adapter.js';
+import { listNativePlaywrightTests } from './reconcile.js';
+import { type SupervisedRunOptions } from './supervised-run.js';
+/** Error thrown when an adapter capability is not available. */
+export declare class AdapterCapabilityError extends Error {
+    constructor(message: string);
+}
+/** Options the adapters need beyond cwd (config-loading override). */
+export interface AdapterOptions {
+    /** Discovery knobs (pytest collection, timeouts). */
+    discover?: Omit<DiscoverOptions, 'cwd' | 'config'>;
+    /**
+     * Pre-loaded config; when absent the adapter loads `.gateforge.yml`
+     * from `cwd` itself (fail-closed via core).
+     */
+    config?: ReturnType<typeof loadConfig>;
+    /**
+     * Supervised-run knobs for `execute` (runner command override for
+     * tests, whole-run timeout). Production uses the defaults.
+     */
+    run?: SupervisedRunOptions;
+}
+/** The Playwright runner adapter. */
+export declare class PlaywrightAdapter implements TestRunnerAdapter<TestCatalogEntry> {
+    private readonly options;
+    readonly runner = "playwright";
+    readonly capabilities: RunnerCapabilities;
+    constructor(options?: AdapterOptions);
+    /**
+     * Enumerates the configured playwright tests (static + reconciled).
+     *
+     * Args:
+     *   cwd: absolute repo root.
+     *
+     * Returns:
+     *   Promise<readonly TestCatalogEntry[]>: catalog rows (gaps included).
+     */
+    inventory(cwd: string): Promise<readonly TestCatalogEntry[]>;
+    /**
+     * Resolves a logical key to its runtime instances (project + native
+     * framework id) via the reconciled catalog.
+     *
+     * Args:
+     *   logicalKey: the stable logical identity.
+     *   cwd: absolute repo root.
+     *
+     * Returns:
+     *   Promise<readonly RunnerTestInstance[]>: matching instances (empty
+     *   when the key has no current instance — a visible stale mapping).
+     */
+    resolveInstances(logicalKey: string, cwd: string): Promise<readonly RunnerTestInstance[]>;
+    /**
+     * Executes the playwright suite under trusted supervision (plan
+     * Phase 4 item 1, ADR 0005 D2, execution-authority fix): the
+     * consumer's config file is never loaded (trusted-config synthesis
+     * over the exact selected files); the gateforge reporter's outcomes
+     * document is the per-instance data source. Expected-set comparison
+     * is the supervisor's job (core supervision module) — this envelope
+     * is structured INPUT, never a gate result.
+     *
+     * Args:
+     *   selection: exact logical keys the supervisor expects (carried for
+     *     the supervisor; the run itself is the full configured suite).
+     *   env: run-state dir + run identity + pre-sanitized child env vars.
+     *
+     * Returns:
+     *   Promise<RunnerExecutionEnvelope>: structured outcome envelope —
+     *   `complete: false` with a single-cause detail for missing config,
+     *   missing/malformed outcomes, timeout, or nonzero exit.
+     */
+    execute(selection: RunnerSelection, env: RunnerExecutionEnv): Promise<RunnerExecutionEnvelope>;
+}
+/** The bounded pytest diagnostic adapter (§3.5; collection + execution). */
+export declare class PytestAdapter implements TestRunnerAdapter<TestCatalogEntry> {
+    private readonly suite;
+    readonly runner = "pytest";
+    readonly capabilities: RunnerCapabilities;
+    constructor(suite: DiagnosticSuite);
+    /**
+     * Collects the configured suite (bounded, structured node ids).
+     *
+     * Args:
+     *   cwd: absolute repo root (suite.cwd resolves against it).
+     *
+     * Returns:
+     *   Promise<readonly TestCatalogEntry[]>: one row per collected node
+     *   id; collection failure yields a single unresolved row (never an
+     *   empty success).
+     */
+    inventory(cwd: string): Promise<readonly TestCatalogEntry[]>;
+    /**
+     * Resolves a logical key to its collected node ids.
+     *
+     * Args:
+     *   logicalKey: the stable logical identity.
+     *   cwd: absolute repo root.
+     *
+     * Returns:
+     *   Promise<readonly RunnerTestInstance[]>: matching instances.
+     */
+    resolveInstances(logicalKey: string, cwd: string): Promise<readonly RunnerTestInstance[]>;
+    /**
+     * Executes the configured diagnostic suite ONCE (plan Phase 4 item 9,
+     * §3.5): isolated process (GATEFORGE_* stripped), junit XML into the
+     * EXCLUDED run-state dir, finite timeout. The result is advisory
+     * diagnostic data — never witness evidence, never E2E satisfaction.
+     *
+     * Args:
+     *   selection: ignored (the suite's configured testPaths are the scope).
+     *   env: the run env whose stateDir hosts the junit report.
+     *
+     * Returns:
+     *   Promise<RunnerExecutionEnvelope>: a structured envelope wrapping
+     *   the diagnostic outcome — `complete` mirrors the diagnostic run's
+     *   completeness. Use {@link executeDiagnostic} for the full typed
+     *   result (causes, counters, report path).
+     */
+    execute(selection: RunnerSelection, env: RunnerExecutionEnv): Promise<RunnerExecutionEnvelope>;
+    /**
+     * Executes the configured diagnostic suite and returns the FULL typed
+     * diagnostic result (§3.5): status, exit code, counters (skips/xfail
+     * explicit), collection/setup errors, failure locations/messages,
+     * completeness, report path. Advisory data only.
+     *
+     * Args:
+     *   repoRoot: absolute repo root (suite.cwd resolves against it).
+     *   stateDir: absolute run-state dir for the junit report.
+     *
+     * Returns:
+     *   Promise<DiagnosticRunResult>: the structured diagnostic result.
+     */
+    executeDiagnostic(repoRoot: string, stateDir: string): Promise<DiagnosticRunResult>;
+}
+/** Loads the catalog a discovery run produced (shared helper). */
+export declare function loadCatalog(options: DiscoverOptions): Promise<TestCatalog>;
+/** Native list re-export for CLI-level reconciliation previews. */
+export { listNativePlaywrightTests };
+//# sourceMappingURL=adapters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/discovery/adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE7F,gEAAgE;AAChE,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC;IACnD;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACvC;;;OAGG;IACH,GAAG,CAAC,EAAE,oBAAoB,CAAC;CAC5B;AAED,qCAAqC;AACrC,qBAAa,iBAAkB,YAAW,iBAAiB,CAAC,gBAAgB,CAAC;IAY/D,OAAO,CAAC,QAAQ,CAAC,OAAO;IAXpC,QAAQ,CAAC,MAAM,gBAAgB;IAE/B,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAOvC;gBAE2B,OAAO,GAAE,cAAmB;IAEzD;;;;;;;;OAQG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC;IAUlE;;;;;;;;;;;OAWG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAgB/F;;;;;;;;;;;;;;;;;;OAkBG;IACG,OAAO,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAGrG;AAED,4EAA4E;AAC5E,qBAAa,aAAc,YAAW,iBAAiB,CAAC,gBAAgB,CAAC;IAU3D,OAAO,CAAC,QAAQ,CAAC,KAAK;IATlC,QAAQ,CAAC,MAAM,YAAY;IAE3B,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAKvC;gBAE2B,KAAK,EAAE,eAAe;IAEnD;;;;;;;;;;OAUG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC;IAkDlE;;;;;;;;;OASG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAW/F;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAuBpG;;;;;;;;;;;;OAYG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAG1F;AAED,kEAAkE;AAClE,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAGhF;AAED,mEAAmE;AACnE,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/discovery/adapters.js

@@ -0,0 +1,276 @@
+/**
+ * Runner adapters over the core contract (plan 2026-09-13 phase 2 item
+ * 6 + Phase 4 items 1/9): the Playwright adapter and the bounded pytest
+ * diagnostic adapter.
+ *
+ * Capability honesty (declared, never implied):
+ * - Playwright: `inventory`, `resolveInstances`, and (since Phase 4)
+ *   `execute` are AVAILABLE. `execute` runs the suite under trusted
+ *   supervision (ADR 0005 D2 + execution-authority fix): the consumer's
+ *   config file is NEVER loaded — the supervisor synthesizes a minimal
+ *   trusted config (exact selected files, bare project names as data,
+ *   the engine reporter forced by absolute path, serial workers, zero
+ *   retries) and runs it with a finite timeout. The gateforge
+ *   reporter's runner-outcomes document is REQUIRED input; a missing
+ *   document is an incomplete run (never a silent green). Consumer
+ *   globalSetup/teardown/reporters/webServer/per-project options are
+ *   NOT honored (constrained model, see trusted-config.ts).
+ * - Pytest: `inventory` (bounded collection), `resolveInstances`
+ *   (node-id identity), and (since Phase 4) `execute` — the §3.5
+ *   diagnostic execution: one isolated junit-XML run per suite in the
+ *   excluded run-state dir. Its results are DIAGNOSTIC data (never
+ *   witness evidence, never E2E satisfaction).
+ *
+ * Both adapters fail closed: an undeclared capability is an error, and
+ * inventory problems come back as typed catalog rows, never silence.
+ */
+import { loadConfig } from '@gate-forge/core';
+import { discoverTestCatalog } from './discover.js';
+import { collectPytestSuite, executePytestSuite, pytestExecutionArgv, } from './pytest-adapter.js';
+import { listNativePlaywrightTests } from './reconcile.js';
+import { executeSupervisedPlaywright } from './supervised-run.js';
+/** Error thrown when an adapter capability is not available. */
+export class AdapterCapabilityError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AdapterCapabilityError';
+    }
+}
+/** The Playwright runner adapter. */
+export class PlaywrightAdapter {
+    options;
+    runner = 'playwright';
+    capabilities = {
+        inventory: 'available',
+        resolveInstances: 'available',
+        // Phase 4 + execution-authority fix: trusted supervision is wired —
+        // execute runs the trusted-synthesized suite (consumer config never
+        // loaded) and returns the structured outcome envelope (ADR 0005 D2).
+        execute: 'available',
+    };
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * Enumerates the configured playwright tests (static + reconciled).
+     *
+     * Args:
+     *   cwd: absolute repo root.
+     *
+     * Returns:
+     *   Promise<readonly TestCatalogEntry[]>: catalog rows (gaps included).
+     */
+    async inventory(cwd) {
+        const config = this.options.config ?? loadConfig(`${cwd}/.gateforge.yml`);
+        const { catalog } = await discoverTestCatalog({
+            cwd,
+            config,
+            ...this.options.discover,
+        });
+        return catalog.entries;
+    }
+    /**
+     * Resolves a logical key to its runtime instances (project + native
+     * framework id) via the reconciled catalog.
+     *
+     * Args:
+     *   logicalKey: the stable logical identity.
+     *   cwd: absolute repo root.
+     *
+     * Returns:
+     *   Promise<readonly RunnerTestInstance[]>: matching instances (empty
+     *   when the key has no current instance — a visible stale mapping).
+     */
+    async resolveInstances(logicalKey, cwd) {
+        const config = this.options.config ?? loadConfig(`${cwd}/.gateforge.yml`);
+        const { catalog } = await discoverTestCatalog({
+            cwd,
+            config,
+            ...this.options.discover,
+        });
+        return catalog.entries
+            .filter((entry) => entry.logicalKey === logicalKey)
+            .map((entry) => ({
+            logicalKey,
+            project: entry.project,
+            frameworkId: entry.parameterIdentity ?? '',
+        }));
+    }
+    /**
+     * Executes the playwright suite under trusted supervision (plan
+     * Phase 4 item 1, ADR 0005 D2, execution-authority fix): the
+     * consumer's config file is never loaded (trusted-config synthesis
+     * over the exact selected files); the gateforge reporter's outcomes
+     * document is the per-instance data source. Expected-set comparison
+     * is the supervisor's job (core supervision module) — this envelope
+     * is structured INPUT, never a gate result.
+     *
+     * Args:
+     *   selection: exact logical keys the supervisor expects (carried for
+     *     the supervisor; the run itself is the full configured suite).
+     *   env: run-state dir + run identity + pre-sanitized child env vars.
+     *
+     * Returns:
+     *   Promise<RunnerExecutionEnvelope>: structured outcome envelope —
+     *   `complete: false` with a single-cause detail for missing config,
+     *   missing/malformed outcomes, timeout, or nonzero exit.
+     */
+    async execute(selection, env) {
+        return executeSupervisedPlaywright(selection, env, this.options.run);
+    }
+}
+/** The bounded pytest diagnostic adapter (§3.5; collection + execution). */
+export class PytestAdapter {
+    suite;
+    runner = 'pytest';
+    capabilities = {
+        inventory: 'available',
+        resolveInstances: 'available',
+        // Phase 4: §3.5 diagnostic execution (junit-XML outcomes) is wired.
+        execute: 'available',
+    };
+    constructor(suite) {
+        this.suite = suite;
+    }
+    /**
+     * Collects the configured suite (bounded, structured node ids).
+     *
+     * Args:
+     *   cwd: absolute repo root (suite.cwd resolves against it).
+     *
+     * Returns:
+     *   Promise<readonly TestCatalogEntry[]>: one row per collected node
+     *   id; collection failure yields a single unresolved row (never an
+     *   empty success).
+     */
+    async inventory(cwd) {
+        const collection = await collectPytestSuite(this.suite, `${cwd}/${this.suite.cwd}`.replace('//', '/'));
+        if (collection.status !== 'discovered') {
+            return [
+                {
+                    logicalKey: `pytest:${this.suite.name}:<collection-unavailable>`,
+                    runner: 'pytest',
+                    project: this.suite.name,
+                    file: this.suite.cwd,
+                    titlePath: ['<collection-unavailable>'],
+                    title: '<collection-unavailable>',
+                    sourceLocation: { file: this.suite.cwd, line: 1, col: 0 },
+                    parameterIdentity: null,
+                    sourceDigest: 'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855',
+                    discoveryStatus: 'unresolved',
+                    reconciliation: 'unavailable',
+                    inferredKind: 'unknown',
+                    kindSignals: [],
+                    weakSignals: [],
+                    rulesFired: [],
+                    categorySignals: [],
+                    suppressionSignals: [],
+                    unresolvedReason: { code: 'pytest-collection-unavailable', detail: collection.detail },
+                },
+            ];
+        }
+        return collection.cases.map((testCase) => ({
+            logicalKey: `pytest:${this.suite.name}:${testCase.nodeId}`,
+            runner: 'pytest',
+            project: this.suite.name,
+            file: testCase.file,
+            titlePath: testCase.titlePath,
+            title: testCase.titlePath[testCase.titlePath.length - 1] ?? testCase.nodeId,
+            sourceLocation: { file: testCase.file, line: 1, col: 0 },
+            parameterIdentity: testCase.nodeId,
+            // Digest composition mirrors discover.ts (suite-cwd-relative →
+            // repo-relative); zero here only when the adapter is used
+            // standalone without a repo file backing the node id.
+            sourceDigest: 'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855',
+            discoveryStatus: 'discovered',
+            reconciliation: 'unavailable',
+            inferredKind: 'unknown',
+            kindSignals: [],
+            weakSignals: [],
+            rulesFired: [],
+            categorySignals: [],
+            suppressionSignals: [],
+        }));
+    }
+    /**
+     * Resolves a logical key to its collected node ids.
+     *
+     * Args:
+     *   logicalKey: the stable logical identity.
+     *   cwd: absolute repo root.
+     *
+     * Returns:
+     *   Promise<readonly RunnerTestInstance[]>: matching instances.
+     */
+    async resolveInstances(logicalKey, cwd) {
+        const entries = await this.inventory(cwd);
+        return entries
+            .filter((entry) => entry.logicalKey === logicalKey)
+            .map((entry) => ({
+            logicalKey,
+            project: entry.project,
+            frameworkId: entry.parameterIdentity ?? '',
+        }));
+    }
+    /**
+     * Executes the configured diagnostic suite ONCE (plan Phase 4 item 9,
+     * §3.5): isolated process (GATEFORGE_* stripped), junit XML into the
+     * EXCLUDED run-state dir, finite timeout. The result is advisory
+     * diagnostic data — never witness evidence, never E2E satisfaction.
+     *
+     * Args:
+     *   selection: ignored (the suite's configured testPaths are the scope).
+     *   env: the run env whose stateDir hosts the junit report.
+     *
+     * Returns:
+     *   Promise<RunnerExecutionEnvelope>: a structured envelope wrapping
+     *   the diagnostic outcome — `complete` mirrors the diagnostic run's
+     *   completeness. Use {@link executeDiagnostic} for the full typed
+     *   result (causes, counters, report path).
+     */
+    async execute(selection, env) {
+        void selection;
+        const result = await this.executeDiagnostic(`${env.stateDir}`, process.cwd());
+        const complete = result.complete && result.status === 'completed';
+        return {
+            processExit: result.exitCode,
+            complete,
+            outcomes: [],
+            fixtureOutcome: result.complete ? (complete ? 'passed' : 'failed') : 'unknown',
+            shards: null,
+            retriesDetected: false,
+            engines: { node: process.version },
+            browsers: {},
+            ...(complete
+                ? {}
+                : {
+                    incompleteDetail: result.incompleteDetail ??
+                        `suite '${this.suite.name}' reported failures — diagnostic data, never E2E satisfaction`,
+                }),
+        };
+    }
+    /**
+     * Executes the configured diagnostic suite and returns the FULL typed
+     * diagnostic result (§3.5): status, exit code, counters (skips/xfail
+     * explicit), collection/setup errors, failure locations/messages,
+     * completeness, report path. Advisory data only.
+     *
+     * Args:
+     *   repoRoot: absolute repo root (suite.cwd resolves against it).
+     *   stateDir: absolute run-state dir for the junit report.
+     *
+     * Returns:
+     *   Promise<DiagnosticRunResult>: the structured diagnostic result.
+     */
+    async executeDiagnostic(repoRoot, stateDir) {
+        return executePytestSuite(this.suite, repoRoot, stateDir);
+    }
+}
+/** Loads the catalog a discovery run produced (shared helper). */
+export async function loadCatalog(options) {
+    const { catalog } = await discoverTestCatalog(options);
+    return catalog;
+}
+/** Native list re-export for CLI-level reconciliation previews. */
+export { listNativePlaywrightTests };
+//# sourceMappingURL=adapters.js.map

package/dist/discovery/adapters.js.map

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

package/dist/discovery/discover.d.ts

@@ -0,0 +1,57 @@
+import { type GateforgeConfig, type TestCatalog } from '@gate-forge/core';
+import { repoRelative } from './pytest-adapter.js';
+/** Options for one discovery run. */
+export interface DiscoverOptions {
+    /** Absolute repo root. */
+    cwd: string;
+    /** The validated gateforge config. */
+    config: GateforgeConfig;
+    /** Collect configured pytest suites (default: list them only). */
+    collectPytest?: boolean;
+    /** Native playwright `--list` timeout (default 60s). */
+    playwrightTimeoutMs?: number;
+}
+/** The discovery result: the validated catalog plus its canonical JSON. */
+export interface DiscoverResult {
+    catalog: TestCatalog;
+    /** Canonical JSON of the catalog (deterministic, snapshot-able). */
+    json: string;
+}
+/**
+ * Runs discovery + reconciliation and returns the validated catalog.
+ *
+ * Pytest suites (plan §3.5) are registered-but-diagnostic-only by
+ * default: they appear in `runnerSummaries` with status `registered`
+ * (their configured identities, no execution, no collection). With
+ * `collectPytest: true` (CLI `--pytest`), the adapter runs the
+ * configured argv with `--collect-only -q` and adds one entry per
+ * collected node id; diagnostic EXECUTION remains Phase 4 work.
+ *
+ * Args:
+ *   options: cwd, config, optional pytest collection + timeouts.
+ *
+ * Returns:
+ *   Promise<DiscoverResult>: validated catalog + canonical JSON.
+ *
+ * Throws:
+ *   TestDiscoveryError: when an enabled native enumeration could not
+ *   run at all (spawn failure, timeout, unparseable output) — the CLI
+ *   maps this to exit 2. Scanner-detectable problems are rows, not
+ *   throws.
+ */
+export declare function discoverTestCatalog(options: DiscoverOptions): Promise<DiscoverResult>;
+/**
+ * Builds the instance-title matcher for a parameterized static title, or
+ * null when the title carries no `${}` template slots. Literal parts
+ * match exactly (regex-escaped); each slot matches any (possibly empty)
+ * text — the same expansion the runner performs over the loop values.
+ *
+ * Args:
+ *   title: the static title (may contain `${}` slots).
+ *
+ * Returns:
+ *   Anchored RegExp, or null for non-parameterized titles.
+ */
+export declare function templateTitlePattern(title: string): RegExp | null;
+export { repoRelative };
+//# sourceMappingURL=discover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/discovery/discover.ts"],"names":[],"mappings":"AA2BA,OAAO,EAOL,KAAK,eAAe,EAGpB,KAAK,WAAW,EAGjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAEL,YAAY,EACb,MAAM,qBAAqB,CAAC;AAe7B,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,kEAAkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAgD3F;AAgXD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIjE;AA6FD,OAAO,EAAE,YAAY,EAAE,CAAC"}