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

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

@@ -0,0 +1,35 @@
+import { TraceZipLimits } from './trace-zip-limits';
+export type TraceEvent = {
+    type: string;
+} & Record<string, unknown>;
+export interface StackFrame {
+    file: string;
+    line: number;
+    column: number;
+}
+export interface LibraryPart {
+    name: string;
+    events: TraceEvent[];
+    network: TraceEvent[];
+    stacks: Map<number, 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,MAAM,WAAW,WAAW;IAAG,IAAI,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;AAE7H,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;AA2CD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,cAAiC,GAAG,WAAW,CAqClH;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,155 @@
+"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 number → 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) || typeof row[0] !== 'number' || !Array.isArray(row[1]))
+            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(row[0], 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$/, '');
+        return {
+            name: n,
+            events: parseJsonl(zip, n),
+            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"}

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

@@ -0,0 +1,96 @@
+"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.fingerprintOf = void 0;
+exports.normalizeGherkinLines = normalizeGherkinLines;
+exports.fingerprintsOf = fingerprintsOf;
+/**
+ * A trace → its contract fingerprint: the rendered Gherkin steps normalized by the SAME parser and
+ * normalizer a hand-written `.feature` goes through (DOS-14.1), then hashed with the implementation
+ * path (DOS-14.2). So the fingerprint of a trace and the lock of the `.free.feature` derived from it
+ * are equal by construction — not by a second, parallel normalizer that could drift.
+ *
+ * The rendered steps are written to a throw-away `.feature` and read back with
+ * `scenariosOfFeatureFile`; nothing else in the pipeline parses Gherkin.
+ */
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const contract_hash_1 = require("../contract-hash");
+const normalize_feature_steps_1 = require("../normalize-feature-steps");
+const KEYWORD = /^(Given|When|Then|And|But)\s/;
+/** Normalize several step lists in one parse; `lines[i]` are full Gherkin lines (keyword first). */
+function normalizeGherkinLines(blocks) {
+    if (!blocks.length)
+        return [];
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'sungen-fingerprint-'));
+    try {
+        const file = path.join(dir, 'fingerprint.feature');
+        const text = ['Feature: fingerprint', '', ...blocks.flatMap((lines, i) => [
+                `  Scenario: FP-${i + 1}0`, ...lines.map((l) => `    ${KEYWORD.test(l.trim()) ? l.trim() : `When ${l.trim()}`}`), '',
+            ])].join('\n');
+        fs.writeFileSync(file, text);
+        const parsed = (0, normalize_feature_steps_1.scenariosOfFeatureFile)(file);
+        if (parsed.length !== blocks.length)
+            throw new Error(`fingerprint: ${blocks.length} step lists normalized to ${parsed.length} scenarios`);
+        return parsed.map((s) => s.steps);
+    }
+    finally {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+}
+/** Many fingerprints from ONE temp-file parse (a unit's scenarios × runs) — the guard path's cost. */
+function fingerprintsOf(items) {
+    const blocks = [];
+    const plan = items.map(({ rendered, implementation }) => {
+        const titles = implementation === 'impl:code' ? [...new Set(rendered.map((r) => r.group).filter((g) => !!g))] : [];
+        const at = blocks.push(rendered.map((r) => `${r.keyword} ${r.sentence}`)) - 1;
+        const titlesAt = titles.length ? blocks.push(titles) - 1 : -1;
+        return { at, titlesAt, titles };
+    });
+    const normalized = normalizeGherkinLines(blocks);
+    return items.map(({ rendered, implementation }, i) => {
+        const { at, titlesAt, titles } = plan[i];
+        const steps = normalized[at];
+        const titleSteps = titlesAt >= 0 ? normalized[titlesAt] : [];
+        const groups = titles.map((title, k) => ({
+            title, titleStep: titleSteps[k], members: rendered.map((r, j) => (r.group === title ? j : -1)).filter((j) => j >= 0),
+        }));
+        return { steps, hash: (0, contract_hash_1.contractHash)(implementation, steps), rendered, groups };
+    });
+}
+const fingerprintOf = (rendered, implementation) => fingerprintsOf([{ rendered, implementation }])[0];
+exports.fingerprintOf = fingerprintOf;
+//# sourceMappingURL=trace-fingerprint.js.map

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

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

package/dist/contract/trace/trace-identity-resolution.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Every target of a trace → its identity (DOS-14.5): the driver's answer from the identity cache
+ * when one exists for the exact HTML core rendered, otherwise core's heuristic (always `low`).
+ *
+ * `resolveWithDriver` is the only asynchronous part of trace conformance: it renders the snapshots,
+ * asks the registered `traceIdentity` resolver (driver-ui: a real browser, JS off, every request
+ * blocked) for the ones not cached yet, and writes the cache. Everything else stays a plain
+ * function of the files on disk, so the CLI and the Claude Code guard build the same verdict.
+ */
+import { IdentityCache } from './identity-cache';
+import { TraceIdentityRequest, TraceIdentityResolver } from './target-identity';
+import type { ParsedTrace } from './trace-file-reader';
+import { IntentStep } from './trace-steps';
+import type { ResolvedTarget } from '../render-free-gherkin';
+/** Steps aimed at the page itself carry no element identity. */
+export declare const isPageLevel: (s: IntentStep) => boolean;
+export declare function identitiesFor(trace: ParsedTrace, steps: IntentStep[], cache: IdentityCache): Map<string, ResolvedTarget>;
+/** One replay request per element target of a trace, keyed by the sha256 of its rendered HTML. */
+export declare function identityRequestsFor(trace: ParsedTrace): TraceIdentityRequest[];
+/** Ask the driver about every not-yet-cached target of these traces; rewrite the cache. */
+export declare function resolveWithDriver(projectRoot: string, traces: ParsedTrace[], resolver: TraceIdentityResolver): Promise<{
+    asked: number;
+    resolver: string;
+    blockedRequests: number;
+}>;
+//# sourceMappingURL=trace-identity-resolution.d.ts.map

package/dist/contract/trace/trace-identity-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-identity-resolution.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/trace-identity-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAkB,aAAa,EAAyC,MAAM,kBAAkB,CAAC;AAGxG,OAAO,EAAqB,oBAAoB,EAAE,qBAAqB,EAAyC,MAAM,mBAAmB,CAAC;AAC1I,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAoB,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,gEAAgE;AAChE,eAAO,MAAM,WAAW,GAAI,GAAG,UAAU,KAAG,OAC2G,CAAC;AAOxJ,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAcxH;AAED,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,oBAAoB,EAAE,CAK9E;AAED,2FAA2F;AAC3F,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB1L"}

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

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPageLevel = void 0;
+exports.identitiesFor = identitiesFor;
+exports.identityRequestsFor = identityRequestsFor;
+exports.resolveWithDriver = resolveWithDriver;
+/**
+ * Every target of a trace → its identity (DOS-14.5): the driver's answer from the identity cache
+ * when one exists for the exact HTML core rendered, otherwise core's heuristic (always `low`).
+ *
+ * `resolveWithDriver` is the only asynchronous part of trace conformance: it renders the snapshots,
+ * asks the registered `traceIdentity` resolver (driver-ui: a real browser, JS off, every request
+ * blocked) for the ones not cached yet, and writes the cache. Everything else stays a plain
+ * function of the files on disk, so the CLI and the Claude Code guard build the same verdict.
+ */
+const identity_cache_1 = require("./identity-cache");
+const snapshot_resolver_1 = require("./snapshot-resolver");
+const snapshot_store_1 = require("./snapshot-store");
+const target_identity_1 = require("./target-identity");
+const trace_steps_1 = require("./trace-steps");
+const NO_DRIVER = 'no driver identity yet — run `sungen contract check --trace` (needs @sungen/driver-ui and a browser)';
+/** Steps aimed at the page itself carry no element identity. */
+const isPageLevel = (s) => s.method === 'goto' || /^keyboard/.test(s.method) || /^to\.have\.(url|title)$/.test(String(s.params.expression ?? '')) || s.kind.startsWith('opaque');
+exports.isPageLevel = isPageLevel;
+function targetCalls(trace, steps) {
+    const store = new snapshot_store_1.SnapshotStore(trace.library);
+    return steps.filter((s) => s.callId && !(0, exports.isPageLevel)(s)).map((s) => ({ callId: s.callId, target: (0, snapshot_resolver_1.resolveCallTarget)(store, trace, s.callId) }));
+}
+function identitiesFor(trace, steps, cache) {
+    const out = new Map();
+    for (const { callId, target } of targetCalls(trace, steps)) {
+        if (!target) {
+            out.set(callId, { identity: (0, target_identity_1.heuristicIdentity)(null, 'no snapshot marks this target') });
+            continue;
+        }
+        const hit = cache.entries.get(target.snapshotSha256);
+        if (!hit) {
+            out.set(callId, { identity: (0, target_identity_1.heuristicIdentity)(target.facts, NO_DRIVER), facts: target.facts });
+            continue;
+        }
+        // What core already knows (missing CSS, broken refs) caps the driver's answer, whatever it says.
+        const reasons = [...target.capReasons, ...hit.reasons];
+        out.set(callId, {
+            identity: { ...hit, identityConfidence: reasons.length ? 'low' : hit.identityConfidence, reasons, source: 'driver' },
+            facts: target.facts,
+        });
+    }
+    return out;
+}
+/** One replay request per element target of a trace, keyed by the sha256 of its rendered HTML. */
+function identityRequestsFor(trace) {
+    return targetCalls(trace, (0, trace_steps_1.traceIntentSteps)(trace)).filter((t) => t.target).map(({ callId, target }) => ({
+        key: target.snapshotSha256, html: target.html, viewport: target.viewport,
+        targetSelector: `[__playwright_target__="${callId}"]`, capReasons: target.capReasons,
+    }));
+}
+/** Ask the driver about every not-yet-cached target of these traces; rewrite the cache. */
+async function resolveWithDriver(projectRoot, traces, resolver) {
+    const { cache } = (0, identity_cache_1.readIdentityCache)(projectRoot);
+    // The cache is project-wide (every unit's traces): answers are only ever ADDED, never pruned here.
+    const keep = new Map(cache.entries);
+    const requests = new Map();
+    for (const req of traces.flatMap(identityRequestsFor))
+        if (!keep.has(req.key))
+            requests.set(req.key, req);
+    if (!requests.size)
+        return { asked: 0, resolver: cache.resolver, blockedRequests: 0 };
+    const answer = await resolver({ requests: [...requests.values()] });
+    if (!answer || !Array.isArray(answer.results))
+        throw new Error('the trace identity resolver returned no results');
+    if (!target_identity_1.TRUSTED_RESOLVER.test(String(answer.resolver)) || typeof answer.browser !== 'string' || !answer.browser) {
+        throw new Error(`the trace identity resolver "${String(answer.resolver).slice(0, 40)}" is not driver-ui's, or named no browser — its answers are not kept`);
+    }
+    for (const raw of answer.results) {
+        const r = (0, target_identity_1.validIdentityResult)(raw);
+        if (!r || !requests.has(r.key))
+            throw new Error(`the trace identity resolver returned a malformed or unasked-for result (${JSON.stringify(raw).slice(0, 120)})`);
+        const { key, ...rest } = r;
+        keep.set(key, { ...rest, browser: answer.browser.slice(0, 100) });
+    }
+    (0, identity_cache_1.writeIdentityCache)(projectRoot, answer.resolver, keep);
+    return { asked: requests.size, resolver: String(answer.resolver), blockedRequests: Number(answer.blockedRequests) || 0 };
+}
+//# sourceMappingURL=trace-identity-resolution.js.map

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

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

package/dist/contract/trace/trace-run-record.d.ts

@@ -0,0 +1,27 @@
+export interface RunRecordAttempt {
+    testId: string;
+    file: string;
+    title: string;
+    retry: number;
+    status: string;
+    startTime: string;
+    duration: number;
+    trace: {
+        sha256: string;
+    } | null;
+}
+export interface RunRecord {
+    file: string;
+    runId: string;
+    startedAt: string;
+    playwrightVersion: string;
+    shard: string | null;
+    report: string | null;
+    specs: Record<string, string>;
+    attempts: RunRecordAttempt[];
+}
+export declare const RUN_RECORD_DIR = "test-results";
+export declare function findRunRecords(projectRoot: string): string[];
+/** Read and check one record; throws an Error naming what is wrong. */
+export declare function readRunRecord(file: string): RunRecord;
+//# sourceMappingURL=trace-run-record.d.ts.map

package/dist/contract/trace/trace-run-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-run-record.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/trace-run-record.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAC3E,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACvE;AACD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAOD,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAK5D;AAgBD,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAgBrD"}

package/dist/contract/trace/trace-run-record.js

@@ -0,0 +1,115 @@
+"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.RUN_RECORD_DIR = void 0;
+exports.findRunRecords = findRunRecords;
+exports.readRunRecord = readRunRecord;
+/**
+ * sungen's own run record (G5, DOS-14.6): written by `@sungen/driver-ui`'s run-record reporter
+ * next to the traces, read here STRICTLY — it is the only place a trace's run id and the hash of
+ * the code that produced it live, so an unknown key, a wrong type or a malformed hash means the
+ * record is not trusted at all (every trace it would vouch for is unbound).
+ *
+ * Found by convention: `<project>/test-results/sungen-run-record*.json` (one per run or shard).
+ * Playwright wipes `test-results/` at the start of every run, so a record and its traces share a
+ * lifetime.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const TOP = new Set(['schema', 'tool', 'runId', 'startedAt', 'playwrightVersion', 'shard', 'report', 'specs', 'attempts']);
+const ATTEMPT = new Set(['testId', 'file', 'title', 'retry', 'status', 'startTime', 'duration', 'trace']);
+const SHA = /^[0-9a-f]{64}$/;
+const isObj = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+exports.RUN_RECORD_DIR = 'test-results';
+function findRunRecords(projectRoot) {
+    const dir = path.join(projectRoot, exports.RUN_RECORD_DIR);
+    let names;
+    try {
+        names = fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    return names.filter((n) => /^sungen-run-record(?:\.[A-Za-z0-9._-]+)?\.json$/.test(n)).sort().map((n) => path.join(dir, n));
+}
+function attemptOf(raw, i) {
+    const at = `attempt ${i + 1}`;
+    if (!isObj(raw))
+        throw new Error(`${at} is not an object`);
+    const extra = Object.keys(raw).find((k) => !ATTEMPT.has(k));
+    if (extra)
+        throw new Error(`${at} has an unknown key "${extra}"`);
+    const { testId, file, title, retry, status, startTime, duration, trace } = raw;
+    if (typeof testId !== 'string' || typeof file !== 'string' || typeof title !== 'string' || typeof status !== 'string')
+        throw new Error(`${at}: testId, file, title and status must be strings`);
+    if (!Number.isInteger(retry) || retry < 0 || typeof duration !== 'number' || typeof startTime !== 'string' || Number.isNaN(Date.parse(startTime))) {
+        throw new Error(`${at}: retry, duration and startTime are malformed`);
+    }
+    if (trace !== null && !(isObj(trace) && Object.keys(trace).length === 1 && typeof trace.sha256 === 'string' && SHA.test(trace.sha256)))
+        throw new Error(`${at}: trace must be null or {sha256}`);
+    return { testId, file, title, retry: retry, status, startTime, duration, trace: trace };
+}
+/** Read and check one record; throws an Error naming what is wrong. */
+function readRunRecord(file) {
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch (e) {
+        throw new Error(`not readable JSON (${e.message.split('\n')[0]})`);
+    }
+    if (!isObj(raw))
+        throw new Error('not an object');
+    const extra = Object.keys(raw).find((k) => !TOP.has(k));
+    if (extra)
+        throw new Error(`unknown key "${extra}"`);
+    if (raw.schema !== 1 || raw.tool !== 'sungen-trace-run-record')
+        throw new Error('not a sungen run record (schema 1)');
+    if (typeof raw.runId !== 'string' || !raw.runId || typeof raw.startedAt !== 'string' || typeof raw.playwrightVersion !== 'string')
+        throw new Error('runId, startedAt and playwrightVersion must be strings');
+    if (raw.shard !== null && typeof raw.shard !== 'string')
+        throw new Error('shard must be a string or null');
+    if (raw.report !== null && typeof raw.report !== 'string')
+        throw new Error('report must be a string or null');
+    if (!isObj(raw.specs) || !Object.values(raw.specs).every((v) => typeof v === 'string' && (v === '' || SHA.test(v))))
+        throw new Error('specs must map files to sha256');
+    if (!Array.isArray(raw.attempts))
+        throw new Error('attempts must be a list');
+    return {
+        file, runId: raw.runId, startedAt: raw.startedAt, playwrightVersion: raw.playwrightVersion, shard: raw.shard,
+        report: raw.report, specs: raw.specs, attempts: raw.attempts.map(attemptOf),
+    };
+}
+//# sourceMappingURL=trace-run-record.js.map

package/dist/contract/trace/trace-run-record.js.map

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