@sun-asterisk/sungen 3.2.35 → 3.3.0-alpha.10

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

@@ -0,0 +1,91 @@
+"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 not older than the .feature files and the lock it is asked to prove —
+ *                 judged by their content, not their file time (#967, trace-freshness.ts)
+ */
+const crypto_1 = require("crypto");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const trace_freshness_1 = require("./trace-freshness");
+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)');
+    }
+    const stale = i.contract ? (0, trace_freshness_1.staleReason)(i.contract, i.record) : null;
+    if (stale)
+        return fail(stale);
+    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":"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"}

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

@@ -0,0 +1,47 @@
+import { FileRead } from './read-file-once';
+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;
+/**
+ * A trace opened once (read-file-once.ts) → parsed: the size was checked on the descriptor BEFORE it
+ * was read into memory. `missing` / `outside` are the caller's to report; here they throw.
+ */
+export declare function traceFromRead(read: FileRead, label: string, limits?: TraceZipLimits): ParsedTrace;
+/** Read a trace from a trusted path (a fixture, a test): a regular file, opened once. */
+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":"AAcA,OAAO,EAAE,QAAQ,EAAgB,MAAM,kBAAkB,CAAC;AAE1D,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;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,cAAiC,GAAG,WAAW,CAQnH;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,cAAiC,GAAG,WAAW,CAElG"}

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

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readTraceBuffer = readTraceBuffer;
+exports.traceFromRead = traceFromRead;
+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 read_file_once_1 = require("./read-file-once");
+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;
+        },
+    };
+}
+/**
+ * A trace opened once (read-file-once.ts) → parsed: the size was checked on the descriptor BEFORE it
+ * was read into memory. `missing` / `outside` are the caller's to report; here they throw.
+ */
+function traceFromRead(read, label, limits = (0, trace_zip_limits_1.traceZipLimits)()) {
+    switch (read.status) {
+        case 'read': return readTraceBuffer(read.bytes, read.real, limits);
+        case 'too-large': throw new trace_zip_limits_1.TraceRejected('zip.too-large', `${read.size} B > ${limits.maxZipBytes}`);
+        case 'not-a-file': throw new trace_zip_limits_1.TraceRejected('zip.malformed', `${label} is not a regular file`);
+        case 'missing': throw new trace_zip_limits_1.TraceRejected('zip.malformed', `${label} does not exist`);
+        default: throw new trace_zip_limits_1.TraceRejected('zip.malformed', `${label} was not read: ${read.why}`);
+    }
+}
+/** Read a trace from a trusted path (a fixture, a test): a regular file, opened once. */
+function readTraceFile(file, limits = (0, trace_zip_limits_1.traceZipLimits)()) {
+    return traceFromRead((0, read_file_once_1.readFileOnce)(file, limits.maxZipBytes), 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-freshness.d.ts

@@ -0,0 +1,27 @@
+import type { RunRecord } from './trace-run-record';
+interface ContractFile {
+    rel: string;
+    sha: string;
+    mtimeMs: number;
+}
+interface LastCommit {
+    sha: string;
+    ms: number;
+}
+/** A unit's contract as it is NOW — its `.feature` files and lock, read once per verdict. */
+export interface UnitContract {
+    projectRoot: string;
+    files: ContractFile[];
+    /** Schema 1 only, asked of git at most once: project path → the last commit that changed each file git holds unchanged. */
+    committed?: Map<string, LastCommit> | null;
+    /** Schema 1 only: commit → is it an ancestor of HEAD (asked once per commit). */
+    ancestors?: Map<string, boolean>;
+}
+export declare function unitContract(projectRoot: string, unit: {
+    name: string;
+    dir: string;
+}): UnitContract;
+/** Why a trace bound to `record` is older than the unit's contract — null when it is not. */
+export declare function staleReason(c: UnitContract, record: RunRecord): string | null;
+export {};
+//# sourceMappingURL=trace-freshness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace-freshness.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/trace-freshness.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,UAAU,YAAY;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACpE,UAAU,UAAU;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAChD,6FAA6F;AAC7F,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,2HAA2H;IAC3H,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;IAC3C,iFAAiF;IACjF,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAMD,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAUnG;AAqCD,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAiB7E"}

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

@@ -0,0 +1,146 @@
+"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.unitContract = unitContract;
+exports.staleReason = staleReason;
+/**
+ * Is a trace newer than the contract it is asked to prove? (DOS-14.6: a trace older than the
+ * `.feature` or the lock is refused.) Judged by CONTENT, never by file time alone (#967): a `touch`,
+ * a checkout or a fresh clone changes no byte, so it stales nothing; an edit after the run always does.
+ *
+ *   schema 2 record   the reporter hashed every `.feature` and `contracts.lock.yaml` under `qa/` when
+ *                     the run started. Each of the unit's contract files must hash NOW to what the run
+ *                     saw: one that changed since, or did not exist yet, is newer than the trace → stale
+ *   schema 1 record   an older reporter recorded no content, so the files are dated against the run's
+ *                     start (the record's `startedAt`): one last written before it is older than the run;
+ *                     one written after it still is when git holds it unchanged and the commit that last
+ *                     changed it is an ancestor of HEAD committed before the run started (its bytes ARE
+ *                     that commit's). Anything else — edited, uncommitted, untracked, committed after the
+ *                     run started, no git, git failed or slow — is stale: fail closed.
+ *
+ * Limit of the schema-1 path: a commit time is what the committer's clock (or GIT_COMMITTER_DATE) said,
+ * so a backdated commit passes the time check — time-based checks cannot see through that. Schema 2
+ * compares content and retires this path: re-running the free tests once with the current reporter is
+ * the remedy.
+ */
+const child_process_1 = require("child_process");
+const crypto_1 = require("crypto");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const contracts_lock_file_1 = require("../contracts-lock-file");
+const normalize_feature_steps_1 = require("../normalize-feature-steps");
+/** Inside the Claude Code guard too: a slow git leaves a schema-1 trace stale rather than the hook waiting. */
+const GIT_TIMEOUT_MS = 2000;
+const posix = (p) => p.split(path.sep).join('/');
+function unitContract(projectRoot, unit) {
+    const root = path.resolve(projectRoot);
+    const lock = path.resolve((0, contracts_lock_file_1.lockPathFor)(unit.dir));
+    const files = [...(fs.existsSync(lock) ? [lock] : []), ...(0, normalize_feature_steps_1.contractFeatureFiles)(unit.dir, unit.name)].map((abs) => {
+        let sha = 'unreadable'; // never equal to a recorded sha256: an unreadable contract file is stale
+        let mtimeMs = Number.POSITIVE_INFINITY;
+        try {
+            sha = (0, crypto_1.createHash)('sha256').update(fs.readFileSync(abs)).digest('hex');
+            mtimeMs = fs.statSync(abs).mtimeMs;
+        }
+        catch { /* stale */ }
+        return { rel: posix(path.relative(root, abs)), sha, mtimeMs };
+    });
+    return { projectRoot: root, files };
+}
+function git(cwd, args) {
+    try {
+        return (0, child_process_1.execFileSync)('git', args, { cwd, stdio: ['ignore', 'pipe', 'ignore'], timeout: GIT_TIMEOUT_MS, maxBuffer: 16 * 1024 * 1024 }).toString('utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Each contract file git holds unchanged → the last commit (first-parent history, merges included)
+ * that changed it, with its committer time. Two git calls for the whole unit; null when git cannot say.
+ * Paths are passed as literal pathspecs: no glob or `:(magic)` reading of a unit's file names.
+ */
+function committedTimes(c) {
+    if (c.committed !== undefined)
+        return c.committed;
+    const rels = c.files.map((f) => f.rel);
+    const changed = git(c.projectRoot, ['--literal-pathspecs', 'diff', '--name-only', '--relative', '-z', 'HEAD', '--', ...rels]);
+    const log = git(c.projectRoot, ['-c', 'core.quotePath=false', '--literal-pathspecs', 'log', '--first-parent', '-m', '-n', '500', '--format=%x01%H %ct', '--name-only', '--relative', '--', ...rels]);
+    if (changed === null || log === null)
+        return (c.committed = null);
+    const dirty = new Set(changed.split('\0').filter(Boolean));
+    const times = new Map();
+    let at = null;
+    for (const raw of log.split('\n')) {
+        const line = raw.trim();
+        if (raw.startsWith('\x01')) {
+            const [sha, ct] = raw.slice(1).trim().split(' ');
+            at = /^[0-9a-f]{40,64}$/.test(sha ?? '') && Number(ct) > 0 ? { sha, ms: Number(ct) * 1000 } : null;
+        }
+        else if (line && at && !times.has(line) && !dirty.has(line))
+            times.set(line, at);
+    }
+    return (c.committed = times);
+}
+/** Is `sha` an ancestor of HEAD? First-parent history says so already; asserted, never assumed. */
+function isAncestorOfHead(c, sha) {
+    if (!c.ancestors)
+        c.ancestors = new Map();
+    if (!c.ancestors.has(sha))
+        c.ancestors.set(sha, git(c.projectRoot, ['merge-base', '--is-ancestor', sha, 'HEAD']) !== null);
+    return c.ancestors.get(sha);
+}
+/** Why a trace bound to `record` is older than the unit's contract — null when it is not. */
+function staleReason(c, record) {
+    if (record.contract) {
+        const f = c.files.find((x) => record.contract[x.rel] !== x.sha);
+        if (!f)
+            return null;
+        const why = record.contract[f.rel] === undefined ? 'it did not exist when the run started' : 'its content changed after the run';
+        return `the trace is older than ${f.rel}: ${why} (stale) — re-run the test`;
+    }
+    const runStart = Date.parse(record.startedAt); // unreadable → nothing is "before the run": stale
+    const late = c.files.filter((f) => !(f.mtimeMs <= runStart));
+    if (!late.length)
+        return null;
+    const committed = committedTimes(c);
+    const vouched = (rel) => {
+        const last = committed?.get(rel);
+        return !!last && last.ms <= runStart && isAncestorOfHead(c, last.sha);
+    };
+    const f = late.find((x) => !vouched(x.rel));
+    return f ? `the trace is older than ${f.rel}: it was written after the run, and no commit from before the run holds its bytes (stale) — re-run the test` : null;
+}
+//# sourceMappingURL=trace-freshness.js.map

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

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