@gate-forge/pack-playwright 0.1.0

package/dist/reporter/ledger.js

@@ -0,0 +1,197 @@
+/**
+ * Reporter ledger computation (pure helpers).
+ *
+ * Per-claim verdicts are computed with the REAL verdict engine
+ * (`evaluateObligation`, G3 pin #9) — the reporter never trusts a test's
+ * own conclusion. Per-claim isolation: each row evaluates exactly that
+ * test's claim against the run's witness ledger; the engine attributes
+ * records by (obligationId, testId), so a claim cannot borrow another
+ * test's evidence.
+ *
+ * The ledger needs the run's obligations (from `GATEFORGE_OBLIGATIONS`)
+ * and each resource's classification (primaryKey etc.) from the witness
+ * (`GET /classifications`). When either is unavailable the row carries
+ * `verdict: null` and the reason says exactly what is missing.
+ */
+import { evaluateObligation, isWitnessedRecord, } from '@gate-forge/core';
+/** Load a valid claim-shaped object from the annotation source. */
+export function claimOf(obligationId, test) {
+    const location = test.location === undefined || test.location === null
+        ? null
+        : { file: test.location.file, line: test.location.line, col: test.location.column };
+    return {
+        obligationId,
+        testId: test.id,
+        testFile: location === null ? '' : location.file,
+        location,
+    };
+}
+/** Plain-object guard for lenient state parsing. */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Reads a lifecycle object leniently (absent booleans → false). */
+function lifecycleOf(value) {
+    if (typeof value !== 'object' || value === null) {
+        return { create: false, read: false, update: false, delete: false };
+    }
+    const entry = value;
+    return {
+        create: entry['create'] === true,
+        read: entry['read'] === true,
+        update: entry['update'] === true,
+        delete: entry['delete'] === true,
+        ...(entry['deleteSemantics'] === 'hard' || entry['deleteSemantics'] === 'archive'
+            ? { deleteSemantics: entry['deleteSemantics'] }
+            : {}),
+        ...(isPlainObject(entry['archiveFields'])
+            ? { archiveFields: entry['archiveFields'] }
+            : {}),
+        ...(Array.isArray(entry['updateableFields'])
+            ? { updateableFields: entry['updateableFields'].filter((f) => typeof f === 'string') }
+            : {}),
+    };
+}
+/** Parses the obligations document (fail-lenient: missing → null). */
+export function parseObligationsDocument(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null)
+            return null;
+        const entry = parsed;
+        if (!Array.isArray(entry['obligations']))
+            return null;
+        const obligations = entry['obligations'].flatMap((item) => {
+            if (typeof item !== 'object' || item === null)
+                return [];
+            const candidate = item;
+            if (typeof candidate['id'] !== 'string' || typeof candidate['contract'] !== 'string') {
+                return [];
+            }
+            return [
+                {
+                    id: candidate['id'],
+                    resourceId: typeof candidate['resourceId'] === 'string' ? candidate['resourceId'] : '',
+                    contract: candidate['contract'],
+                    policyId: typeof candidate['policyId'] === 'string' ? candidate['policyId'] : '',
+                    lifecycle: lifecycleOf(candidate['lifecycle']),
+                    fingerprint: typeof candidate['fingerprint'] === 'string' ? candidate['fingerprint'] : '',
+                    source: typeof candidate['source'] === 'string' ? candidate['source'] : '',
+                    location: typeof candidate['location'] === 'object' && candidate['location'] !== null
+                        ? candidate['location']
+                        : null,
+                },
+            ];
+        });
+        return { schemaVersion: 1, obligations };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Computes one ledger row for a claim.
+ *
+ * Advisory only (plan §9): the reporter runs inside the suite-side
+ * runtime, so its rows can never be authoritative. HTTP rows grade
+ * against the CLI-derived route inventory when the caller supplies it;
+ * without route context the core resolver blocks with a missing-context
+ * result — the reporter never shows an authoritative pass merely
+ * because it lacked the inventory.
+ *
+ * Args:
+ *   claim: the claim under judgment.
+ *   obligations: the run's obligations (state doc).
+ *   classifications: per-resource classification map (witness surface).
+ *   records: the full run ledger.
+ *   now: injected instant for the verdict engine.
+ *   httpRoutes: advisory route inventory (CLI-derived `http-routes.json`
+ *     when present, else null). The authoritative CLI recomputes this
+ *     from source and never trusts a reporter-supplied list.
+ *
+ * Returns:
+ *   LedgerRow: verdict + reason + considered record ids. `verdict:
+ *   null` (with reason) when required context is missing.
+ */
+export function ledgerRowFor(claim, obligations, classifications, records, now, httpRoutes) {
+    if (obligations === null) {
+        return {
+            claim: claim.obligationId,
+            testId: claim.testId,
+            testFile: claim.testFile,
+            verdict: null,
+            reason: 'obligations document unavailable; per-claim verdicts need the run obligations',
+            recordIds: [],
+            trustTier: null,
+        };
+    }
+    const obligation = obligations.obligations.find((entry) => entry.id === claim.obligationId);
+    if (obligation === undefined) {
+        return {
+            claim: claim.obligationId,
+            testId: claim.testId,
+            testFile: claim.testFile,
+            verdict: null,
+            reason: `claim references '${claim.obligationId}' which is not in the run's obligations`,
+            recordIds: [],
+            trustTier: null,
+        };
+    }
+    const classification = classifications[obligation.resourceId] ?? null;
+    const engineObligation = {
+        schemaVersion: 1,
+        id: obligation.id,
+        resourceId: obligation.resourceId,
+        contract: obligation.contract,
+        policyId: obligation.policyId,
+        lifecycle: obligation.lifecycle,
+    };
+    const outcome = evaluateObligation(engineObligation, {
+        claims: [
+            {
+                schemaVersion: 1,
+                obligationId: claim.obligationId,
+                testId: claim.testId,
+                // ClaimSchema requires a non-empty optional testFile: an absent
+                // location must omit the field entirely (an emitted '' made the
+                // strict schema drop the whole claim — honest evidence then
+                // graded `missing`).
+                ...(claim.testFile === '' ? {} : { testFile: claim.testFile }),
+                ...(claim.location === null ? {} : { location: claim.location }),
+            },
+        ],
+        records: records,
+        waivers: [],
+        classification,
+        // Advisory route context (plan §9): supplied by the caller from the
+        // CLI-derived inventory when available; null/undefined lets the
+        // core resolver return its blocking missing-context result.
+        httpRoutes: httpRoutes ?? null,
+        now,
+    });
+    const mine = records.filter((record) => record.testId === claim.testId);
+    // Provenance-aware (GF-23): a record counts as witnessed only when its
+    // recordId recomputes from its contents — the same predicate the
+    // engine applies, so the display can never disagree with the verdict.
+    const trustTier = mine.some((record) => isWitnessedRecord(record))
+        ? 'witnessed'
+        : mine.length > 0
+            ? 'claimed'
+            : null;
+    return {
+        claim: claim.obligationId,
+        testId: claim.testId,
+        testFile: claim.testFile,
+        verdict: outcome.verdict,
+        reason: outcome.reason,
+        recordIds: outcome.recordIds,
+        trustTier,
+    };
+}
+/** Blocks the run? (satisfied/waived are clean.) */
+export function isBlocking(verdict) {
+    return (verdict !== null &&
+        verdict !== 'satisfied' &&
+        verdict !== 'waived');
+}
+//# sourceMappingURL=ledger.js.map

package/dist/reporter/ledger.js.map

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

package/dist/reporter/reporter.cjs

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * CommonJS entry for `@gate-forge/pack-playwright/reporter` (the
+ * `require` export condition; compiled from this `.cts` to
+ * `dist/reporter/reporter.cjs`).
+ *
+ * WHY a shim and not a compiled CJS build: the pack AND its dependency
+ * `@gate-forge/core` are ESM-only (`"type": "module"`), so no CJS
+ * compilation of the reporter can `require()` the engine on every
+ * supported Node runtime. What CJS consumers actually need is a
+ * constructor: Playwright resolves custom reporters with
+ * `require.resolve('@gate-forge/pack-playwright/reporter')` (which needs
+ * this condition to exist — without it CJS playwright configs died with
+ * ERR_PACKAGE_PATH_NOT_EXPORTED) and then loads the resolved file with
+ * require-or-import. Plain `require()` gets THIS module: a class whose
+ * constructor synchronously returns while the ESM implementation loads
+ * in the background. EVERY runner callback is forwarded (buffered until
+ * the implementation arrives, in call order): `onTestBegin` is the
+ * trusted-supervisor session open (plan Phase 1) — dropping it would
+ * silently strip every test of its witness session and fail all
+ * evidence primitives; `onTestEnd` seals claims + the supervision
+ * outcome row; `onEnd` is awaited by the runner, so it can wait for the
+ * load and fails closed if the implementation never loads (evidence is
+ * never silently dropped).
+ *
+ * Supported syntaxes (both ESM and CJS playwright configs):
+ *
+ *   reporter: [['@gate-forge/pack-playwright/reporter']]
+ *
+ * and from any CJS script:
+ *
+ *   const GateforgeReporter =
+ *     require('@gate-forge/pack-playwright/reporter');
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+class GateforgeReporterCjs {
+    options;
+    buffered = [];
+    implementation = null;
+    loadError = null;
+    ready;
+    constructor(options = {}) {
+        this.options = options;
+        this.ready = import('./reporter.js').then((module) => {
+            const implementation = new module.GateforgeReporter(this.options);
+            this.implementation = implementation;
+            const buffered = this.buffered.splice(0, this.buffered.length);
+            for (const [name, args] of buffered) {
+                this.dispatch(implementation, name, args);
+            }
+        }, (error) => {
+            this.loadError = error instanceof Error ? error : new Error(String(error));
+        });
+    }
+    /** Runner callback (synchronous): buffered until the impl arrives. */
+    onTestBegin(test, result) {
+        this.forward('onTestBegin', [test, result]);
+    }
+    /** Runner callback (synchronous): buffered until the impl arrives. */
+    onTestEnd(test, result) {
+        this.forward('onTestEnd', [test, result]);
+    }
+    /** Runner callback (synchronous): buffered until the impl arrives. */
+    onError(error) {
+        this.forward('onError', [error]);
+    }
+    /** Runner callback (awaited): waits for the load, then delegates.
+     * The FullResult argument MUST be forwarded — it is the only source
+     * of the final run status the supervisor reads from the outcomes
+     * document (dropping it fails every supervised run as 'unknown'). */
+    async onEnd(result) {
+        await this.ready;
+        if (this.implementation === null) {
+            throw (this.loadError ??
+                new Error('gateforge reporter implementation failed to load (no error reported)'));
+        }
+        return this.implementation.onEnd(result);
+    }
+    /**
+     * Buffers or dispatches one runner callback. Order is preserved: the
+     * implementation replays the buffer in arrival order exactly once,
+     * and post-load calls dispatch straight through.
+     */
+    forward(name, args) {
+        if (this.implementation !== null) {
+            this.dispatch(this.implementation, name, args);
+            return;
+        }
+        this.buffered.push([name, args]);
+    }
+    dispatch(implementation, name, args) {
+        const method = implementation[name];
+        if (typeof method !== 'function') {
+            throw new Error(`gateforge reporter implementation has no ${name} method`);
+        }
+        void method.apply(implementation, args);
+    }
+}
+// Playwright expects the constructor itself (require-or-import default
+// resolution); the named/default aliases cover destructuring consumers.
+module.exports = GateforgeReporterCjs;
+module.exports['GateforgeReporter'] =
+    GateforgeReporterCjs;
+module.exports['default'] = GateforgeReporterCjs;
+//# sourceMappingURL=reporter.cjs.map

package/dist/reporter/reporter.cjs.map

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

package/dist/reporter/reporter.d.cts

@@ -0,0 +1,35 @@
+/**
+ * CommonJS entry for `@gate-forge/pack-playwright/reporter` (the
+ * `require` export condition; compiled from this `.cts` to
+ * `dist/reporter/reporter.cjs`).
+ *
+ * WHY a shim and not a compiled CJS build: the pack AND its dependency
+ * `@gate-forge/core` are ESM-only (`"type": "module"`), so no CJS
+ * compilation of the reporter can `require()` the engine on every
+ * supported Node runtime. What CJS consumers actually need is a
+ * constructor: Playwright resolves custom reporters with
+ * `require.resolve('@gate-forge/pack-playwright/reporter')` (which needs
+ * this condition to exist — without it CJS playwright configs died with
+ * ERR_PACKAGE_PATH_NOT_EXPORTED) and then loads the resolved file with
+ * require-or-import. Plain `require()` gets THIS module: a class whose
+ * constructor synchronously returns while the ESM implementation loads
+ * in the background. EVERY runner callback is forwarded (buffered until
+ * the implementation arrives, in call order): `onTestBegin` is the
+ * trusted-supervisor session open (plan Phase 1) — dropping it would
+ * silently strip every test of its witness session and fail all
+ * evidence primitives; `onTestEnd` seals claims + the supervision
+ * outcome row; `onEnd` is awaited by the runner, so it can wait for the
+ * load and fails closed if the implementation never loads (evidence is
+ * never silently dropped).
+ *
+ * Supported syntaxes (both ESM and CJS playwright configs):
+ *
+ *   reporter: [['@gate-forge/pack-playwright/reporter']]
+ *
+ * and from any CJS script:
+ *
+ *   const GateforgeReporter =
+ *     require('@gate-forge/pack-playwright/reporter');
+ */
+export {};
+//# sourceMappingURL=reporter.d.cts.map

package/dist/reporter/reporter.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.cts","sourceRoot":"","sources":["../../src/reporter/reporter.cts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG"}

package/dist/reporter/reporter.d.ts

@@ -0,0 +1,167 @@
+import { type LedgerRow } from './ledger.js';
+/** Minimal reporter-side test shape (Playwright's TestCase in practice). */
+export interface ReporterTest {
+    id: string;
+    title?: string;
+    titlePath?: () => string[];
+    annotations?: Array<{
+        type: string;
+        description?: string;
+    }>;
+    location?: {
+        file: string;
+        line: number;
+        column: number;
+    };
+    /** Project name when the runner exposes it (best effort). */
+    project?: {
+        name?: string;
+    } | null;
+    /**
+     * The enclosing suite (playwright's reporter hierarchy
+     * root → project → file → describe), when the runner exposes it —
+     * the describe-stack source for the catalog-identity title path.
+     */
+    parent?: ReporterSuiteLike | null;
+}
+/** Structural subset of the runner's suite node (see {@link ReporterTest}). */
+export interface ReporterSuiteLike {
+    /** Suite title ('' for root, project-less, and file suites). */
+    title?: string;
+    /** Source location; MISSING for root and project suites. */
+    location?: {
+        file: string;
+        line: number;
+        column: number;
+    } | null;
+    /** Suite kind when the runner exposes it (`root`/`project`/`file`/`describe`). */
+    type?: 'root' | 'project' | 'file' | 'describe';
+    parent?: ReporterSuiteLike | null;
+}
+/**
+ * Computes the honest aggregate line (plan Phase 4 item 7, §2 row): the
+ * reporter NEVER prints an overall gate pass based only on claimed rows
+ * while unclaimed obligations block. Pure and deterministic — exported
+ * so the honesty contract is directly testable.
+ *
+ * Args:
+ *   rows: the per-claim ledger rows.
+ *   unclaimedObligations: count of run obligations with no claim row.
+ *
+ * Returns:
+ *   string: the aggregate summary line.
+ */
+export declare function gateSummaryLine(rows: readonly LedgerRow[], unclaimedObligations: number): string;
+/** Constructor options for the gateforge reporter (trusted-config path). */
+export interface GateforgeReporterOptions {
+    /** Run-state dir override (precedence over GATEFORGE_STATE_DIR env). */
+    stateDir?: string;
+    /** Run id override (precedence over GATEFORGE_RUN_ID env). */
+    runId?: string;
+    /** Runner-outcomes path override (precedence over GATEFORGE_OUTCOMES_FILE env). */
+    outcomesPath?: string;
+    /** Obligations document path override (precedence over GATEFORGE_OBLIGATIONS env). */
+    obligationsPath?: string;
+}
+/**
+ * The gateforge reporter. No options today; the constructor signature is
+ * the Playwright reporter contract (`(options: object)`).
+ */
+export declare class GateforgeReporter {
+    private readonly rows;
+    /**
+     * Phase 4 claim injections (reconciliation key → obligation ids),
+     * loaded once from the CLI-written run-state document. Declarations
+     * only — they never satisfy anything by themselves.
+     */
+    private readonly injections;
+    /** Phase 4 runner-outcome capture (supervision input, ADR 0005 D2). */
+    private readonly runnerOutcomes;
+    private runStatus;
+    private readonly runnerErrors;
+    /** The lifecycle spool file (null when the run has no state dir). */
+    private readonly spoolFile;
+    /** Resolved run-state paths (options win, env is the legacy fallback). */
+    private readonly resolved;
+    constructor(options?: GateforgeReporterOptions);
+    /**
+     * Lifecycle spool write (enforcement-review fix 3): announces the
+     * STARTED test to the trusted CLI's drain — which opens the witness
+     * session on the supervisor channel, carrying the mapped obligation
+     * claims for sidecar/native-mapped tests (Phase 4 claim injection) —
+     * and binds worker → session there. The runner itself performs no
+     * privileged call. Synchronous API: the CLI's poll cadence absorbs
+     * the dispatch latency (the fixture's session resolve waits up to 5s).
+     */
+    onTestBegin(test: ReporterTest, result: {
+        workerIndex?: number;
+    }): void;
+    /** Runner-level error hook: a global setup/teardown/runner error. */
+    onError(error: {
+        message?: string;
+    }): void;
+    /** Collects claims + test identity + the outcome row at test end (synchronous). */
+    onTestEnd(test: ReporterTest, result: {
+        status: string;
+        workerIndex?: number;
+        retry?: number;
+    }): void;
+    /** Playswright `onEnd`: seal the run-level outcome + write artifacts. */
+    onEnd(result?: {
+        status?: string;
+    }): Promise<void>;
+    /** Full title path of a test (runner API when present, else [title]). */
+    /**
+     * The catalog-identity title path: describe titles + the test title —
+     * NOT the runner's full path. Playwright's suite hierarchy is
+     * root → project → file → describe; identity joins (supervision,
+     * claim injections) use the SAME shape the native `--list` enumeration
+     * reports (describes + title), so the root/project/file suites are
+     * stripped here — by suite `type` when exposed, else by the location
+     * heuristic (root/project suites carry no source location; the file
+     * suite is the outermost suite that does). A project name or file name
+     * must never leak into the identity. Without a parent chain, the bare
+     * title keeps the row visible (never misjoined).
+     */
+    private titlePathOf;
+    /**
+     * The runner project name for the supervision identity: the
+     * `project`-typed ancestor's title (reporter-API `TestCase` carries no
+     * `project` member), else the first location-less ancestor, else the
+     * runner-provided `project.name` best-effort. Absence stays `null` —
+     * never a fabricated project.
+     */
+    private projectOf;
+    /**
+     * Whether this suite is at or above the describe level (root, project,
+     * or the file suite itself) — walking must stop here. By `type` when
+     * exposed; otherwise the file suite is the OUTERMOST suite with a
+     * source location (its parent is root/project or absent).
+     */
+    private isDescribeBoundary;
+    /** Repo-relative posix file of a test (null when unknown). */
+    private repoRelativeOf;
+    /** Native annotation claims of one test (`{type: 'gateforge'}`). */
+    private annotationClaimsOf;
+    /** Injection-key lookup for one test: `<file>#<titlePath.join('>')>`. */
+    private injectedClaimsFor;
+    /** Writes the runner-outcomes document when the supervisor asked for it. */
+    private writeRunnerOutcomes;
+    /** The witness classification projection (real lifecycle + primaryKey). */
+    private fetchClassifications;
+    private ledgerRows;
+    /** Deterministic instant: the run manifest's injected `startedAt`. */
+    private runInstant;
+    /**
+     * Prints the per-claim verdict ledger + the HONEST aggregate line
+     * (plan Phase 4 item 7): never an overall pass while unclaimed
+     * obligations block; the authoritative CLI remains the only final
+     * gate result.
+     */
+    private printLedger;
+    /** GF-24 observability: obligations nobody claimed + records nobody claimed. */
+    private printRegistryMismatches;
+}
+export default GateforgeReporter;
+export type { LedgerRow };
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter/reporter.d.ts.map

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