@sun-asterisk/sungen 3.2.34 → 3.3.0-alpha.2

package/dist/contract/trace/target-identity.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRUSTED_RESOLVER = void 0;
+exports.heuristicIdentity = heuristicIdentity;
+exports.validIdentityResult = validIdentityResult;
+const INPUT_ROLE = {
+    checkbox: 'checkbox', radio: 'radio', submit: 'button', button: 'button', reset: 'button', image: 'button',
+    search: 'searchbox', number: 'spinbutton', range: 'slider',
+};
+function heuristicRole(f) {
+    if (f.attrs.role)
+        return f.attrs.role.split(/\s+/)[0].toLowerCase();
+    const tag = f.tag.toUpperCase();
+    if (tag === 'A' && f.attrs.href !== undefined)
+        return 'link';
+    if (tag === 'BUTTON')
+        return 'button';
+    if (tag === 'INPUT')
+        return INPUT_ROLE[(f.attrs.type || 'text').toLowerCase()] ?? 'textbox';
+    if (tag === 'SELECT')
+        return 'combobox';
+    if (tag === 'TEXTAREA')
+        return 'textbox';
+    if (/^H[1-6]$/.test(tag))
+        return 'heading';
+    if (tag === 'IMG')
+        return 'img';
+    return 'generic';
+}
+/** Core's own reading of the snapshot — never better than `low`. */
+function heuristicIdentity(f, why) {
+    if (!f)
+        return { role: 'generic', name: '', identityConfidence: 'low', reasons: [why, 'no-target-in-snapshot'], source: 'heuristic' };
+    const role = heuristicRole(f);
+    const named = role === 'button' || role === 'link' || role === 'heading';
+    const name = f.attrs['aria-label'] || f.labelText || (named ? f.text : '') || f.attrs.placeholder || f.attrs.alt || f.attrs.title || '';
+    const level = /^H([1-6])$/i.exec(f.tag)?.[1];
+    return { role, name: name.replace(/\s+/g, ' ').trim(), ...(level ? { level: Number(level) } : {}), identityConfidence: 'low', reasons: [why], source: 'heuristic' };
+}
+const RESULT_KEYS = new Set(['key', 'role', 'name', 'level', 'scope', 'identityConfidence', 'reasons']);
+const isObj = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+/** Bounded strings: an identity is a role and a name, never a payload. */
+const str = (v, max) => typeof v === 'string' && v.length <= max;
+const ROLE_MAX = 64;
+const NAME_MAX = 1000;
+/** The only resolver whose answers the identity cache keeps (driver-ui's Playwright replay). */
+exports.TRUSTED_RESOLVER = /^driver-ui\/playwright-aria@\d+$/;
+/** A resolver's result, checked strictly (unknown keys rejected) — null when it is not well-formed. */
+function validIdentityResult(raw) {
+    if (!isObj(raw) || Object.keys(raw).some((k) => !RESULT_KEYS.has(k)))
+        return null;
+    const { key, role, name, level, scope, identityConfidence, reasons } = raw;
+    if (!str(key, 128) || !str(role, ROLE_MAX) || !str(name, NAME_MAX))
+        return null;
+    if (identityConfidence !== 'high' && identityConfidence !== 'low')
+        return null;
+    if (!Array.isArray(reasons) || reasons.length > 20 || !reasons.every((r) => str(r, 300)))
+        return null;
+    if (level !== undefined && !(Number.isInteger(level) && level >= 1 && level <= 6))
+        return null;
+    if (scope !== undefined && !(isObj(scope) && str(scope.role, ROLE_MAX) && str(scope.name, NAME_MAX) && Object.keys(scope).length === 2))
+        return null;
+    // `high` with a reason is a contradiction: a reason is what makes an identity low.
+    if (identityConfidence === 'high' && reasons.length)
+        return null;
+    return { key, role, name, ...(level !== undefined ? { level: level } : {}), ...(scope ? { scope: scope } : {}), identityConfidence, reasons: reasons };
+}
+//# sourceMappingURL=target-identity.js.map

package/dist/contract/trace/target-identity.js.map

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

package/dist/contract/trace/test-step-join.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Join the test runner's steps (test.trace) with the browser calls (<N>-trace.trace) — phase 07
+ * criterion 2, proven 114/114 on a real app. Up to format 9 a library call's `stepId` is the runner
+ * step's `callId`; from format 10 (Playwright 1.64) the two share ONE id and `stepId` is gone, so the
+ * call's own `callId` is the step. Walking the runner's `parentId` chain says where the call ran:
+ *
+ *   body       the test function itself, with the path of enclosing `test.step` titles
+ *   hook       a user `beforeEach` / `afterEach` (stage setup | teardown)
+ *   fixture    a fixture's setup or teardown (`Fixture "signedInPage"`)
+ *   runner     the runner's own Before/After Hooks plumbing (browser launch, context close)
+ *
+ * Only body and user `beforeEach` calls are the test's behaviour; fixtures and teardown are
+ * environment, kept apart so a shared fixture cannot leak into every test's contract.
+ */
+import type { ParsedTrace, StackFrame, TraceEvent } from './trace-file-reader';
+export interface RunnerStep {
+    id: string;
+    parentId?: string;
+    method: string;
+    title: string;
+    params: Record<string, unknown>;
+    stack: StackFrame[];
+    failed: boolean;
+}
+export type CallPhase = {
+    phase: 'body';
+    stepPath: string[];
+} | {
+    phase: 'hook';
+    stage: 'setup' | 'teardown';
+    name: string;
+} | {
+    phase: 'fixture';
+    stage: 'setup' | 'teardown';
+    name: string;
+} | {
+    phase: 'runner';
+    stage: 'setup' | 'teardown';
+    name: string;
+} | {
+    phase: 'unjoined';
+};
+export interface JoinedCall {
+    part: string;
+    callId: string;
+    class: string;
+    method: string;
+    params: Record<string, unknown>;
+    stepId?: string;
+    where: CallPhase;
+    failed: boolean;
+    startTime: number;
+}
+export declare function indexRunnerSteps(runner: TraceEvent[]): Map<string, RunnerStep>;
+/** The runner steps from `id` up to the root (self first). Cycles end the walk. */
+export declare function ancestry(steps: Map<string, RunnerStep>, id: string): RunnerStep[];
+export declare function classifyStep(steps: Map<string, RunnerStep>, stepId: string): CallPhase;
+/** Is this phase the test's own behaviour (body, or a user `beforeEach`)? */
+export declare const isBehaviour: (w: CallPhase) => boolean;
+/** Every library call, joined to its runner step, in start order across parts. */
+export declare function joinCalls(trace: ParsedTrace): {
+    steps: Map<string, RunnerStep>;
+    calls: JoinedCall[];
+};
+//# sourceMappingURL=test-step-join.d.ts.map

package/dist/contract/trace/test-step-join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-step-join.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/test-step-join.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAC7D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;CACvE;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAE1B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAC5D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;CACxG;AAWD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAa9E;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,EAAE,CAQjF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAWtF;AAED,6EAA6E;AAC7E,eAAO,MAAM,WAAW,GAAI,GAAG,SAAS,KAAG,OAA4E,CAAC;AAExH,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAkBrG"}

package/dist/contract/trace/test-step-join.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBehaviour = void 0;
+exports.indexRunnerSteps = indexRunnerSteps;
+exports.ancestry = ancestry;
+exports.classifyStep = classifyStep;
+exports.joinCalls = joinCalls;
+const str = (v) => (typeof v === 'string' ? v : '');
+const RUNNER_HOOKS = /^(Before Hooks|After Hooks|Worker Cleanup)$/;
+function stackOf(e) {
+    const raw = Array.isArray(e.stack) ? e.stack : [];
+    return raw.filter((f) => !!f && typeof f === 'object')
+        .map((f) => ({ file: str(f.file), line: Number(f.line) || 0, column: Number(f.column) || 0 }));
+}
+function indexRunnerSteps(runner) {
+    const steps = new Map();
+    for (const e of runner) {
+        const id = str(e.callId);
+        if (e.type === 'before' && id) {
+            steps.set(id, {
+                id, parentId: str(e.parentId) || undefined, method: str(e.method), title: str(e.title),
+                params: (e.params && typeof e.params === 'object' ? e.params : {}), stack: stackOf(e), failed: false,
+            });
+        }
+        if (e.type === 'after' && steps.has(id) && e.error)
+            steps.get(id).failed = true;
+    }
+    return steps;
+}
+/** The runner steps from `id` up to the root (self first). Cycles end the walk. */
+function ancestry(steps, id) {
+    const chain = [];
+    const seen = new Set();
+    for (let cur = steps.get(id); cur && !seen.has(cur.id); cur = cur.parentId ? steps.get(cur.parentId) : undefined) {
+        seen.add(cur.id);
+        chain.push(cur);
+    }
+    return chain;
+}
+function classifyStep(steps, stepId) {
+    const chain = ancestry(steps, stepId);
+    if (!chain.length)
+        return { phase: 'unjoined' };
+    const root = chain[chain.length - 1];
+    const stage = root.method === 'hook' && root.title === 'After Hooks' ? 'teardown' : 'setup';
+    const fixture = chain.find((s) => s.method === 'fixture');
+    if (fixture)
+        return { phase: 'fixture', stage, name: fixture.title.replace(/^Fixture "(.*)"$/, '$1') };
+    const userHook = chain.find((s) => s.method === 'hook' && !RUNNER_HOOKS.test(s.title));
+    if (userHook)
+        return { phase: 'hook', stage, name: userHook.title };
+    if (root.method === 'hook')
+        return { phase: 'runner', stage, name: root.title };
+    return { phase: 'body', stepPath: chain.filter((s) => s.method === 'test.step').map((s) => s.title).reverse() };
+}
+/** Is this phase the test's own behaviour (body, or a user `beforeEach`)? */
+const isBehaviour = (w) => w.phase === 'body' || (w.phase === 'hook' && w.stage === 'setup');
+exports.isBehaviour = isBehaviour;
+/** Every library call, joined to its runner step, in start order across parts. */
+function joinCalls(trace) {
+    const steps = indexRunnerSteps(trace.runner);
+    const calls = [];
+    for (const part of trace.library) {
+        const failed = new Set(part.events.filter((e) => e.type === 'after' && e.error).map((e) => str(e.callId)));
+        for (const e of part.events) {
+            if (e.type !== 'before')
+                continue;
+            const callId = str(e.callId);
+            const stepId = str(e.stepId) || (part.version >= 10 ? callId : '') || undefined;
+            calls.push({
+                part: part.name, callId, class: str(e.class), method: str(e.method),
+                params: (e.params && typeof e.params === 'object' ? e.params : {}),
+                stepId, where: stepId ? classifyStep(steps, stepId) : { phase: 'unjoined' }, failed: failed.has(callId), startTime: Number(e.startTime) || 0,
+            });
+        }
+    }
+    calls.sort((a, b) => a.startTime - b.startTime);
+    return { steps, calls };
+}
+//# sourceMappingURL=test-step-join.js.map

package/dist/contract/trace/test-step-join.js.map

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

package/dist/contract/trace/trace-binding.d.ts

@@ -0,0 +1,21 @@
+import type { ParsedTrace } from './trace-file-reader';
+import type { RunRecord } from './trace-run-record';
+import type { ReportResult, ReportTest } from './select-final-attempt';
+export interface BindingInput {
+    projectRoot: string;
+    test: ReportTest;
+    result: ReportResult;
+    record: RunRecord;
+    trace: ParsedTrace;
+    /** Epoch ms: the newest mtime of the unit's .feature files and lock. */
+    notBefore: number;
+}
+export type Binding = {
+    ok: true;
+    specFile: string;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function bindTrace(i: BindingInput): Binding;
+//# sourceMappingURL=trace-binding.d.ts.map

package/dist/contract/trace/trace-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-binding.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/trace-binding.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,MAAM,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAIrF,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAuBlD"}

package/dist/contract/trace/trace-binding.js

@@ -0,0 +1,88 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bindTrace = bindTrace;
+/**
+ * May THIS trace speak for THIS test's final attempt? (DOS-14.6, red-team #5; phase 07 criterion 5.)
+ * A good trace of another test, of the same test from another run, or from before the contract
+ * changed is the "green by swap" path — every link below must hold:
+ *
+ *   run record    the attempt (testId, retry) is in sungen's own record of the run, passed
+ *   bytes         sha256(trace.zip) equals what the record wrote at the end of that run
+ *   code          sha256 of the test file NOW equals the hash the record took at run start
+ *   title         every library part says `<file>:<line> › … › <title>` of exactly this test
+ *   clock         the trace started inside the attempt's window (±2 s)
+ *   fresh         the trace is newer than the .feature and the lock it is asked to prove
+ */
+const crypto_1 = require("crypto");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const CLOCK_SLACK_MS = 2000;
+function bindTrace(i) {
+    const fail = (reason) => ({ ok: false, reason });
+    const attempt = i.record.attempts.find((a) => a.testId === i.test.testId && a.retry === i.result.retry);
+    if (!attempt)
+        return fail(`run ${i.record.runId} has no record of this attempt (retry ${i.result.retry}) — the trace is not bound to a sungen run`);
+    if (attempt.status !== 'passed')
+        return fail(`the run record says this attempt ${attempt.status}`);
+    if (!attempt.trace || attempt.trace.sha256 !== i.trace.sha256) {
+        return fail('this is not the trace the run recorded (sha256 differs) — swapped or edited after the run');
+    }
+    const specPath = path.join(i.projectRoot, attempt.file);
+    let now;
+    try {
+        now = (0, crypto_1.createHash)('sha256').update(fs.readFileSync(specPath)).digest('hex');
+    }
+    catch {
+        return fail(`the test file ${attempt.file} is gone`);
+    }
+    if (i.record.specs[attempt.file] !== now)
+        return fail(`the test file ${attempt.file} changed since the run — re-run it`);
+    const prefix = `${i.test.file}:${i.test.line} › `;
+    if (!i.trace.titles.length)
+        return fail('the trace names no test (no title in its header)');
+    const other = i.trace.titles.find((t) => !(t.startsWith(prefix) && t.endsWith(` › ${i.test.title}`)));
+    if (other)
+        return fail(`the trace belongs to another test ("${other}")`);
+    const start = Date.parse(i.result.startTime);
+    const wall = i.trace.wallTime;
+    if (typeof wall !== 'number' || Number.isNaN(start) || wall < start - CLOCK_SLACK_MS || wall > start + i.result.duration + CLOCK_SLACK_MS) {
+        return fail('the trace was not recorded during this attempt (clock window)');
+    }
+    if (wall < i.notBefore)
+        return fail('the trace is older than the .feature or the lock it should prove (stale) — re-run the test');
+    return { ok: true, specFile: attempt.file };
+}
+//# sourceMappingURL=trace-binding.js.map

package/dist/contract/trace/trace-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-binding.js","sourceRoot":"","sources":["../../../src/contract/trace/trace-binding.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,8BAuBC;AAvDD;;;;;;;;;;;GAWG;AACH,mCAAoC;AACpC,uCAAyB;AACzB,2CAA6B;AAgB7B,MAAM,cAAc,GAAG,IAAK,CAAC;AAE7B,SAAgB,SAAS,CAAC,CAAe;IACvC,MAAM,IAAI,GAAG,CAAC,MAAc,EAAW,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxG,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,yCAAyC,CAAC,CAAC,MAAM,CAAC,KAAK,4CAA4C,CAAC,CAAC;IACpJ,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,oCAAoC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC,2FAA2F,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QAAC,GAAG,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC,iBAAiB,OAAO,CAAC,IAAI,UAAU,CAAC,CAAC;IAAC,CAAC;IACnJ,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC,iBAAiB,OAAO,CAAC,IAAI,oCAAoC,CAAC,CAAC;IACzH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;IAClD,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACtG,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC,uCAAuC,KAAK,IAAI,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,KAAK,GAAG,cAAc,IAAI,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,cAAc,EAAE,CAAC;QAC1I,OAAO,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,IAAI,GAAG,CAAC,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC,4FAA4F,CAAC,CAAC;IAClI,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC"}

package/dist/contract/trace/trace-file-reader.d.ts

@@ -0,0 +1,41 @@
+import { TraceZipLimits } from './trace-zip-limits';
+export type TraceEvent = {
+    type: string;
+} & Record<string, unknown>;
+export interface StackFrame {
+    file: string;
+    line: number;
+    column: number;
+}
+/**
+ * One library part. `version` is its declared format (already accepted by the gate); `stacks` is
+ * keyed by call id — v8/v9 wrote a call NUMBER (`11` → `call@11`, Playwright's legacy id), v10 the
+ * call id itself, which it shares with the runner step (`ulgt@50`).
+ */
+export interface LibraryPart {
+    name: string;
+    version: number;
+    events: TraceEvent[];
+    network: TraceEvent[];
+    stacks: Map<string, StackFrame[]>;
+}
+export interface ParsedTrace {
+    label: string;
+    sha256: string;
+    versions: Array<{
+        part: string;
+        version: unknown;
+    }>;
+    runner: TraceEvent[];
+    library: LibraryPart[];
+    /** `wallTime` (epoch ms) of the runner's header: when the attempt started. */
+    wallTime: number | undefined;
+    /** `title` of every library part's header: `<file>:<line> › <describe…> › <test title>`. */
+    titles: string[];
+    /** A resource body by sha1 (v8) or entry name `resources/<sha1>.<ext>` (v9); null when absent. */
+    readResource(ref: string): string | null;
+}
+export declare function readTraceBuffer(buf: Buffer, label: string, limits?: TraceZipLimits): ParsedTrace;
+/** Read a trace from disk: a regular file, size-checked BEFORE it is read into memory. */
+export declare function readTraceFile(file: string, limits?: TraceZipLimits): ParsedTrace;
+//# sourceMappingURL=trace-file-reader.d.ts.map

package/dist/contract/trace/trace-file-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-file-reader.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/trace-file-reader.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA2D,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE7G,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACpE,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC1E;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;CAAE;AAE9I,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpD,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,4FAA4F;IAC5F,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kGAAkG;IAClG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC1C;AA6CD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,cAAiC,GAAG,WAAW,CAwClH;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,cAAiC,GAAG,WAAW,CAKlG"}

package/dist/contract/trace/trace-file-reader.js

@@ -0,0 +1,161 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readTraceBuffer = readTraceBuffer;
+exports.readTraceFile = readTraceFile;
+/**
+ * One Playwright trace.zip → its parsed parts, after the zip limits and the format-version gate
+ * (DOS-14.6, DOS-14.7). Nothing past this point sees a trace that was not accepted here.
+ *
+ *   test.trace            the test runner's steps (test.step, hooks, fixtures, expect, pw:api)
+ *   <N>-trace.trace       a library part: the browser calls, frame snapshots, logs
+ *   <N>-trace.network     resources (stylesheets inlined into a replayed snapshot come from here)
+ *   <N>-trace.stacks      call id → source frames (`file:line` of an opaque step)
+ *   resources/<sha1>      resource bodies
+ *
+ * Every part that has a header (test.trace and each library part) must declare a supported version;
+ * a part without one is refused. Every JSONL line must parse — a line that does not is never skipped.
+ */
+const crypto_1 = require("crypto");
+const fs = __importStar(require("fs"));
+const trace_zip_reader_1 = require("./trace-zip-reader");
+const trace_zip_limits_1 = require("./trace-zip-limits");
+const CALL_ID = /^[\w@.:-]{1,128}$/;
+function parseJsonl(zip, name) {
+    const out = [];
+    zip.readText(name).split('\n').forEach((line, i) => {
+        if (!line.trim())
+            return;
+        let v;
+        try {
+            v = JSON.parse(line);
+        }
+        catch {
+            throw new trace_zip_limits_1.TraceRejected('trace.malformed', `${name} line ${i + 1} is not JSON`);
+        }
+        if (!v || typeof v !== 'object' || Array.isArray(v) || typeof v.type !== 'string') {
+            throw new trace_zip_limits_1.TraceRejected('trace.malformed', `${name} line ${i + 1} is not a trace event`);
+        }
+        // Call ids end up inside a CSS selector of the replay (`[__playwright_target__="…"]`).
+        const e = v;
+        const snap = e.snapshot && typeof e.snapshot === 'object' ? e.snapshot.callId : undefined;
+        for (const id of [e.callId, e.stepId, e.parentId, snap]) {
+            if (id !== undefined && (typeof id !== 'string' || !CALL_ID.test(id)))
+                throw new trace_zip_limits_1.TraceRejected('trace.malformed', `${name} line ${i + 1}: ${JSON.stringify(String(id)).slice(0, 40)} is not a call id`);
+        }
+        out.push(v);
+    });
+    return out;
+}
+function parseStacks(zip, name) {
+    const out = new Map();
+    if (!zip.has(name))
+        return out;
+    let doc;
+    try {
+        doc = JSON.parse(zip.readText(name));
+    }
+    catch {
+        throw new trace_zip_limits_1.TraceRejected('trace.malformed', `${name} is not JSON`);
+    }
+    const files = Array.isArray(doc.files) ? doc.files.map(String) : [];
+    for (const row of Array.isArray(doc.stacks) ? doc.stacks : []) {
+        if (!Array.isArray(row) || !Array.isArray(row[1]))
+            continue;
+        const id = typeof row[0] === 'number' ? `call@${row[0]}` : row[0];
+        if (typeof id !== 'string' || !CALL_ID.test(id))
+            continue;
+        const frames = row[1].filter(Array.isArray).map((f) => {
+            const [fileIdx, line, column] = f;
+            return { file: files[fileIdx] ?? '', line: Number(line) || 0, column: Number(column) || 0 };
+        });
+        out.set(id, frames);
+    }
+    return out;
+}
+const headerOf = (events) => events.find((e) => e.type === 'context-options');
+function readTraceBuffer(buf, label, limits = (0, trace_zip_limits_1.traceZipLimits)()) {
+    const zip = (0, trace_zip_reader_1.openZip)(buf, limits);
+    if (!zip.has('test.trace'))
+        throw new trace_zip_limits_1.TraceRejected('trace.malformed', 'no test.trace — not a Playwright Test trace (runner steps are required)');
+    const runner = parseJsonl(zip, 'test.trace');
+    const library = zip.names().filter((n) => /^\d+-trace\.trace$/.test(n)).sort().map((n) => {
+        const base = n.replace(/\.trace$/, '');
+        const events = parseJsonl(zip, n);
+        const version = headerOf(events)?.version;
+        return {
+            name: n,
+            version: typeof version === 'number' ? version : NaN, // a non-number is refused just below
+            events,
+            network: zip.has(`${base}.network`) ? parseJsonl(zip, `${base}.network`) : [],
+            stacks: parseStacks(zip, `${base}.stacks`),
+        };
+    });
+    const versions = [{ part: 'test.trace', version: headerOf(runner)?.version }, ...library.map((l) => ({ part: l.name, version: headerOf(l.events)?.version }))];
+    const bad = versions.filter((v) => typeof v.version !== 'number' || !trace_zip_limits_1.SUPPORTED_TRACE_VERSIONS.has(v.version));
+    if (bad.length) {
+        throw new trace_zip_limits_1.TraceRejected('trace.version-unsupported', `${bad.map((v) => `${v.part}=${v.version === undefined ? 'missing' : JSON.stringify(v.version)}`).join(', ')} (supported: ${[...trace_zip_limits_1.SUPPORTED_TRACE_VERSIONS].join(', ')})`);
+    }
+    const head = headerOf(runner);
+    const cache = new Map();
+    return {
+        label,
+        sha256: (0, crypto_1.createHash)('sha256').update(buf).digest('hex'),
+        versions,
+        runner,
+        library,
+        wallTime: typeof head?.wallTime === 'number' ? head.wallTime : undefined,
+        titles: library.map((l) => headerOf(l.events)?.title).filter((t) => typeof t === 'string'),
+        readResource(ref) {
+            // v8 names a resource by its sha1; v9 by its entry, `resources/<sha1>.<ext>`.
+            const name = ref.replace(/^resources\//, '');
+            if (!/^[A-Za-z0-9_-][A-Za-z0-9._-]*$/.test(name))
+                return null;
+            if (!cache.has(name))
+                cache.set(name, zip.has(`resources/${name}`) ? zip.readText(`resources/${name}`) : null);
+            return cache.get(name) ?? null;
+        },
+    };
+}
+/** Read a trace from disk: a regular file, size-checked BEFORE it is read into memory. */
+function readTraceFile(file, limits = (0, trace_zip_limits_1.traceZipLimits)()) {
+    const st = fs.statSync(file);
+    if (!st.isFile())
+        throw new trace_zip_limits_1.TraceRejected('zip.malformed', `${file} is not a regular file`);
+    if (st.size > limits.maxZipBytes)
+        throw new trace_zip_limits_1.TraceRejected('zip.too-large', `${st.size} B > ${limits.maxZipBytes}`);
+    return readTraceBuffer(fs.readFileSync(file), file, limits);
+}
+//# sourceMappingURL=trace-file-reader.js.map

package/dist/contract/trace/trace-file-reader.js.map

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

package/dist/contract/trace/trace-fingerprint.d.ts

@@ -0,0 +1,22 @@
+import type { ContractStep, Implementation } from '../contract-schema';
+import type { RenderedStep } from '../render-free-gherkin';
+/** Normalize several step lists in one parse; `lines[i]` are full Gherkin lines (keyword first). */
+export declare function normalizeGherkinLines(blocks: string[][]): ContractStep[][];
+export interface TraceFingerprint {
+    steps: ContractStep[];
+    hash: string;
+    rendered: RenderedStep[];
+    /** impl:code: each `test.step` title (normalized) and the indexes of the steps it holds. */
+    groups: Array<{
+        title: string;
+        titleStep: ContractStep;
+        members: number[];
+    }>;
+}
+/** Many fingerprints from ONE temp-file parse (a unit's scenarios × runs) — the guard path's cost. */
+export declare function fingerprintsOf(items: Array<{
+    rendered: RenderedStep[];
+    implementation: Implementation;
+}>): TraceFingerprint[];
+export declare const fingerprintOf: (rendered: RenderedStep[], implementation: Implementation) => TraceFingerprint;
+//# sourceMappingURL=trace-fingerprint.d.ts.map

package/dist/contract/trace/trace-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-fingerprint.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/trace-fingerprint.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D,oGAAoG;AACpG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,YAAY,EAAE,EAAE,CAe1E;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,4FAA4F;IAC5F,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IAAC,cAAc,EAAE,cAAc,CAAA;CAAE,CAAC,GAAG,gBAAgB,EAAE,CAkB7H;AAED,eAAO,MAAM,aAAa,GAAI,UAAU,YAAY,EAAE,EAAE,gBAAgB,cAAc,KAAG,gBACtC,CAAC"}