gate-evm-tools 1.0.28 → 1.2.0

package/dist-runtime/delivery/public-calldata.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deliveryCalldataPath = exports.serializeDeliveryCalls = exports.archiveDeliveryCalls = void 0;
+exports.projectDeliveryCalls = projectDeliveryCalls;
+exports.mergeDeliveryCalls = mergeDeliveryCalls;
+/** Public business projection. Internal provenance and runtime progress stay separate. */
+const export_1 = require("./export");
+const calldata_review_1 = require("./calldata-review");
+const calldata_details_1 = require("./calldata-details");
+const canonicalData_1 = require("../workflow/lib/canonicalData");
+var calldata_archive_1 = require("./calldata-archive");
+Object.defineProperty(exports, "archiveDeliveryCalls", { enumerable: true, get: function () { return calldata_archive_1.archiveDeliveryCalls; } });
+var calldata_format_1 = require("./calldata-format");
+Object.defineProperty(exports, "serializeDeliveryCalls", { enumerable: true, get: function () { return calldata_format_1.serializeDeliveryCalls; } });
+Object.defineProperty(exports, "deliveryCalldataPath", { enumerable: true, get: function () { return calldata_format_1.deliveryCalldataPath; } });
+/** Frozen parameters independently re-encode and compare before any public projection. */
+function projectDeliveryCalls(input) {
+    const plan = (0, export_1.immutableDeliveryPlan)(input.plan);
+    const reviews = (0, calldata_review_1.parseCalldataReviews)(input.calldata, plan.transactions);
+    const journal = input.preparations ?? [];
+    const preparations = Array.isArray(journal) && !journal.length && !plan.deploymentBindings.length ? []
+        : require('./journal').parsePreparationJournal(journal, plan.transactions, plan.derivedBindings, { target: plan.target, chainId: plan.chainId, expectedStepIds: plan.deploymentBindings.map(d => d.stepId) });
+    return (0, canonicalData_1.deepFreeze)(plan.transactions.map((tx, index) => {
+        if (tx.operation !== 0)
+            throw Error('Public calldata supports ordinary CALL only');
+        const binding = plan.transactionBindings[index], operation = plan.operationBindings.find(o => o.stepId === binding.stepId);
+        if (!operation)
+            throw Error('Public calldata operation binding missing');
+        const source = operation.operationId === null ? input.operations.find(s => s.id === operation.sourceStepId)
+            : plan.customBindings.find(s => s.sourceStepId === operation.sourceStepId)?.operations.find(s => s.id === operation.operationId);
+        if (!source)
+            throw Error('Frozen operation intent missing');
+        const call = binding.callIndex === null ? undefined : source.calls?.[binding.callIndex];
+        const name = (0, canonicalData_1.nonempty)(call?.name ?? source.name, 'operation name');
+        const description = (0, canonicalData_1.nonempty)(call?.description ?? source.description, 'operation description');
+        const invocation = reviews[index].invocation;
+        if (invocation.kind !== 'function')
+            throw Error('Outer public transaction requires function ABI');
+        const entry = preparations.find(p => p.mappings.some(m => m.transactionId === tx.transactionId));
+        const details = (0, calldata_details_1.expandDeliveryInvocation)(invocation, tx.to, { name, description }, entry);
+        return { chains: [plan.chainId], executor: tx.executor, to: tx.to, name, description: (0, calldata_details_1.describeDeliveryInvocation)(description, invocation),
+            abi: (0, calldata_details_1.readableInvocationAbi)(invocation), calldata: tx.data, ...(BigInt(tx.value) === 0n ? {} : { value: tx.value }), ...(details ? { details } : {}) };
+    }));
+}
+/** Merge matching logical occurrences, never globally deduplicate calldata. */
+function mergeDeliveryCalls(inputs) {
+    if (!inputs.length)
+        throw Error('At least one independently frozen network is required');
+    const chains = new Set(), sequences = [];
+    const nodes = new Map();
+    for (const input of inputs) {
+        const plan = (0, export_1.immutableDeliveryPlan)(input.plan), chain = plan.chainId, calls = projectDeliveryCalls(input);
+        if (chains.has(chain))
+            throw Error('Duplicate chain projection');
+        chains.add(chain);
+        const keys = calls.map((call, index) => {
+            const binding = plan.transactionBindings[index], operation = plan.operationBindings.find(o => o.stepId === binding.stepId);
+            const { chains: _, ...content } = call;
+            const key = (0, canonicalData_1.semanticHash)({ logical: [operation.sourceStepId, operation.operationId, binding.role, binding.callIndex], content });
+            const existing = nodes.get(key);
+            if (existing) {
+                if (existing.call.chains.includes(chain))
+                    throw Error('Duplicate logical occurrence on one chain');
+                existing.call.chains.push(chain);
+            }
+            else
+                nodes.set(key, { call: { ...call, chains: [chain] }, next: new Set(), incoming: 0 });
+            return key;
+        });
+        sequences.push({ chain, calls, keys });
+        for (let i = 1; i < keys.length; i++) {
+            const a = nodes.get(keys[i - 1]), b = nodes.get(keys[i]);
+            if (!a.next.has(keys[i])) {
+                a.next.add(keys[i]);
+                b.incoming++;
+            }
+        }
+    }
+    const queue = [...nodes].filter(([, n]) => n.incoming === 0).map(([key]) => key), ordered = [];
+    for (let at = 0; at < queue.length; at++) {
+        const node = nodes.get(queue[at]);
+        ordered.push(node.call);
+        for (const key of node.next) {
+            const next = nodes.get(key);
+            if (--next.incoming === 0)
+                queue.push(key);
+        }
+    }
+    // Conflicting cross-chain ordering cannot share occurrences; keep exact per-chain sequences.
+    const result = ordered.length === nodes.size ? ordered : sequences.flatMap(s => s.calls.map(call => ({ ...call, chains: [s.chain] })));
+    const content = (call) => { const { chains: _, ...rest } = call; return rest; };
+    for (const sequence of sequences)
+        if ((0, canonicalData_1.canonicalJson)(result.filter(c => c.chains.includes(sequence.chain)).map(content)) !== (0, canonicalData_1.canonicalJson)(sequence.calls.map(content)))
+            throw Error('Merged calldata changed per-chain order or coverage');
+    return (0, canonicalData_1.deepFreeze)(result);
+}
+//# sourceMappingURL=public-calldata.js.map

package/dist-runtime/delivery/public-calldata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-calldata.js","sourceRoot":"","sources":["../../runtime/delivery/public-calldata.ts"],"names":[],"mappings":";;;AAkBA,oDAuBC;AAGD,gDA6BC;AAzED,0FAA0F;AAC1F,qCAAiD;AACjD,uDAAyD;AAEzD,yDAAuI;AACvI,iEAAkG;AAGlG,uDAA0D;AAAjD,wHAAA,oBAAoB,OAAA;AAC7B,qDAAiF;AAAxE,yHAAA,sBAAsB,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AAQrD,0FAA0F;AAC1F,SAAgB,oBAAoB,CAAC,KAA0B;IAC7D,MAAM,IAAI,GAAG,IAAA,8BAAqB,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAA,sCAAoB,EAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACxE,MAAM,OAAO,GAAC,KAAK,CAAC,YAAY,IAAE,EAAE,CAAC;IACrC,MAAM,YAAY,GAAuB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAE,CAAC,OAAO,CAAC,MAAM,IAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAA,CAAC,CAAA,EAAE;QAClH,CAAC,CAAE,OAAO,CAAC,WAAW,CAAgC,CAAC,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,eAAe,EAAE,EAAC,MAAM,EAAC,IAAI,CAAC,MAAM,EAAC,OAAO,EAAC,IAAI,CAAC,OAAO,EAAC,eAAe,EAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,MAAM,CAAC,EAAC,CAAC,CAAC;IACvO,OAAO,IAAA,0BAAU,EAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE;QACpD,IAAI,EAAE,CAAC,SAAS,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3H,IAAI,CAAC,SAAS;YAAE,MAAM,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,YAAY,CAAC;YACzG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,WAAW,CAAC,CAAC;QACnI,IAAI,CAAC,MAAM;YAAE,MAAM,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,MAAM,CAAC,KAA2B,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/G,MAAM,IAAI,GAAG,IAAA,wBAAQ,EAAC,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,IAAA,wBAAQ,EAAC,IAAI,EAAE,WAAW,IAAI,MAAM,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;QAC/F,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC;QAC7C,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU;YAAE,MAAM,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAClG,MAAM,KAAK,GAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,aAAa,KAAG,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;QACzF,MAAM,OAAO,GAAC,IAAA,2CAAwB,EAAC,UAAU,EAAC,EAAE,CAAC,EAAE,EAAC,EAAC,IAAI,EAAC,WAAW,EAAC,EAAC,KAAK,CAAC,CAAC;QAClF,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAC,IAAA,6CAA0B,EAAC,WAAW,EAAC,UAAU,CAAC;YACrI,GAAG,EAAE,IAAA,wCAAqB,EAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,EAAC,GAAG,CAAC,OAAO,CAAA,CAAC,CAAA,EAAC,OAAO,EAAC,CAAA,CAAC,CAAA,EAAE,CAAC,EAAE,CAAC;IACnJ,CAAC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,+EAA+E;AAC/E,SAAgB,kBAAkB,CAAC,MAAsC;IACvE,IAAG,CAAC,MAAM,CAAC,MAAM;QAAC,MAAM,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACvF,MAAM,MAAM,GAAC,IAAI,GAAG,EAAU,EAAE,SAAS,GAAmE,EAAE,CAAC;IAC/G,MAAM,KAAK,GAAC,IAAI,GAAG,EAA+D,CAAC;IACnF,KAAI,MAAM,KAAK,IAAI,MAAM,EAAC,CAAC;QACzB,MAAM,IAAI,GAAC,IAAA,8BAAqB,EAAC,KAAK,CAAC,IAAI,CAAC,EAAC,KAAK,GAAC,IAAI,CAAC,OAAO,EAAC,KAAK,GAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAClG,IAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;YAAC,MAAM,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAAA,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjF,MAAM,IAAI,GAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAC,KAAK,EAAC,EAAE;YACjC,MAAM,OAAO,GAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAC,SAAS,GAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,MAAM,KAAG,OAAO,CAAC,MAAM,CAAE,CAAC;YACnH,MAAM,EAAC,MAAM,EAAC,CAAC,EAAC,GAAG,OAAO,EAAC,GAAC,IAAI,CAAC;YACjC,MAAM,GAAG,GAAC,IAAA,4BAAY,EAAC,EAAC,OAAO,EAAC,CAAC,SAAS,CAAC,YAAY,EAAC,SAAS,CAAC,WAAW,EAAC,OAAO,CAAC,IAAI,EAAC,OAAO,CAAC,SAAS,CAAC,EAAC,OAAO,EAAC,CAAC,CAAC;YACxH,MAAM,QAAQ,GAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAG,QAAQ,EAAC,CAAC;gBAAA,IAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAAC,MAAM,KAAK,CAAC,2CAA2C,CAAC,CAAC;gBAAA,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAA,CAAC;;gBAC3I,KAAK,CAAC,GAAG,CAAC,GAAG,EAAC,EAAC,IAAI,EAAC,EAAC,GAAG,IAAI,EAAC,MAAM,EAAC,CAAC,KAAK,CAAC,EAAC,EAAC,IAAI,EAAC,IAAI,GAAG,EAAE,EAAC,QAAQ,EAAC,CAAC,EAAC,CAAC,CAAC;YAC9E,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;QACH,SAAS,CAAC,IAAI,CAAC,EAAC,KAAK,EAAC,KAAK,EAAC,IAAI,EAAC,CAAC,CAAC;QACnC,KAAI,IAAI,CAAC,GAAC,CAAC,EAAC,CAAC,GAAC,IAAI,CAAC,MAAM,EAAC,CAAC,EAAE,EAAC,CAAC;YAAA,MAAM,CAAC,GAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAC,CAAC,CAAC,CAAE,EAAC,CAAC,GAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC;YAAA,IAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAC,CAAC;gBAAA,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBAAA,CAAC,CAAC,QAAQ,EAAE,CAAC;YAAA,CAAC;QAAA,CAAC;IACjJ,CAAC;IACD,MAAM,KAAK,GAAC,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,EAAC,EAAE,CAAA,CAAC,CAAC,QAAQ,KAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAC,EAAE,CAAA,GAAG,CAAC,EAAC,OAAO,GAAgB,EAAE,CAAC;IAClG,KAAI,IAAI,EAAE,GAAC,CAAC,EAAC,EAAE,GAAC,KAAK,CAAC,MAAM,EAAC,EAAE,EAAE,EAAC,CAAC;QACjC,MAAM,IAAI,GAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAE,CAAC;QAAA,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,KAAI,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAC,CAAC;YAAA,MAAM,IAAI,GAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;YAAA,IAAG,EAAE,IAAI,CAAC,QAAQ,KAAG,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAA,CAAC;IACjG,CAAC;IACD,6FAA6F;IAC7F,MAAM,MAAM,GAAC,OAAO,CAAC,MAAM,KAAG,KAAK,CAAC,IAAI,CAAA,CAAC,CAAA,OAAO,CAAA,CAAC,CAAA,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAA,EAAE,CAAA,CAAC,EAAC,GAAG,IAAI,EAAC,MAAM,EAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAC,CAAC,CAAC,CAAC,CAAC;IACvH,MAAM,OAAO,GAAC,CAAC,IAAiB,EAAC,EAAE,GAAC,MAAM,EAAC,MAAM,EAAC,CAAC,EAAC,GAAG,IAAI,EAAC,GAAC,IAAI,CAAC,CAAA,OAAO,IAAI,CAAC,CAAA,CAAC,CAAC;IAChF,KAAI,MAAM,QAAQ,IAAI,SAAS;QAAC,IAAG,IAAA,6BAAa,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAG,IAAA,6BAAa,EAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAAC,MAAM,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACnO,OAAO,IAAA,0BAAU,EAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist-runtime/delivery/references.d.ts

@@ -0,0 +1,19 @@
+export declare const DEFERRED: unique symbol;
+export interface ReferenceObservation {
+    reference: string;
+    contentIdentity: string;
+    resolvedIdentity: string;
+}
+export interface BusinessReferenceContext {
+    params: unknown;
+    target: unknown;
+    state(): unknown;
+}
+export declare function parseBusinessReference(raw: unknown): string | null;
+export declare function resolveBusinessValue(raw: unknown, context: BusinessReferenceContext, options?: {
+    deferState?: boolean;
+}): {
+    value: unknown;
+    observations: ReferenceObservation[];
+};
+export declare function containsDeferred(value: unknown): boolean;

package/dist-runtime/delivery/references.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFERRED = void 0;
+exports.parseBusinessReference = parseBusinessReference;
+exports.resolveBusinessValue = resolveBusinessValue;
+exports.containsDeferred = containsDeferred;
+const canonicalData_1 = require("../workflow/lib/canonicalData");
+const data_1 = require("./data");
+const target_fields_1 = require("./target-fields");
+exports.DEFERRED = Symbol("delivery.future-state");
+const PUBLIC_TARGET = target_fields_1.PUBLIC_TARGET_FIELDS;
+function parseBusinessReference(raw) {
+    const value = (0, data_1.strictData)(raw);
+    let ref;
+    if (typeof value === "string" && value.startsWith("$"))
+        ref = value.slice(1);
+    else if (value &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        Object.hasOwn(value, "$ref")) {
+        if (Object.keys(value).length !== 1)
+            throw new Error("Business $ref requires exact shape");
+        ref = value.$ref;
+    }
+    else
+        return null;
+    if (typeof ref !== "string" ||
+        !/^(param|target|state)\.[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*$/.test(ref))
+        throw new Error("Invalid business reference namespace or path");
+    if (ref.startsWith("target.") && !PUBLIC_TARGET.has(ref.slice(7)))
+        throw new Error("Reference is outside public target boundary");
+    return ref;
+}
+function resolveBusinessValue(raw, context, options = {}) {
+    const params = (0, data_1.strictData)(context.params), input = (0, data_1.strictData)(raw), active = new Set();
+    const observations = [];
+    let state, stateRead = false;
+    const visit = (value) => {
+        const ref = parseBusinessReference(value);
+        if (ref) {
+            if (active.has(ref))
+                throw new Error(`Business reference cycle: ${ref}`);
+            const [ns, ...parts] = ref.split(".");
+            if (ns === "state" && options.deferState)
+                return exports.DEFERRED;
+            if (ns === "state" && !stateRead) {
+                // Runtime producers may retain unrelated optional undefined metadata.
+                // Validate the selected subtree below, never invoke descriptors on the path.
+                state = context.state();
+                stateRead = true;
+            }
+            // Read only the allowlisted target leaf; secret fields are never traversed or observed.
+            const source = (0, data_1.strictData)((0, data_1.ownPath)(ns === "param" ? params : ns === "state" ? state : context.target, parts, ref));
+            if (ns === "target" && (source === null || typeof source === "object"))
+                throw new Error("Public target references require scalar leaves");
+            active.add(ref);
+            const resolved = visit(source);
+            active.delete(ref);
+            if (!containsDeferred(resolved))
+                observations.push({
+                    reference: ref,
+                    contentIdentity: (0, canonicalData_1.semanticHash)(source),
+                    resolvedIdentity: (0, canonicalData_1.semanticHash)(resolved),
+                });
+            return resolved;
+        }
+        if (Array.isArray(value))
+            return value.map(visit);
+        if (value && typeof value === "object")
+            return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, visit(v)]));
+        return value;
+    };
+    return (0, canonicalData_1.deepFreeze)({
+        value: visit(input),
+        observations: observations.sort((a, b) => a.reference < b.reference ? -1 : a.reference > b.reference ? 1 : 0),
+    });
+}
+function containsDeferred(value) {
+    return (value === exports.DEFERRED ||
+        !!(value &&
+            typeof value === "object" &&
+            Object.values(value).some(containsDeferred)));
+}
+//# sourceMappingURL=references.js.map

package/dist-runtime/delivery/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../runtime/delivery/references.ts"],"names":[],"mappings":";;;AAeA,wDAsBC;AACD,oDAyDC;AACD,4CASC;AAzGD,iEAAyE;AACzE,iCAA6C;AAC7C,mDAAuD;AAC1C,QAAA,QAAQ,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAWxD,MAAM,aAAa,GAAG,oCAAoB,CAAC;AAC3C,SAAgB,sBAAsB,CAAC,GAAY;IACjD,MAAM,KAAK,GAAG,IAAA,iBAAU,EAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAY,CAAC;IACjB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACxE,IACH,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,EAC5B,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,GAAG,GAAI,KAAiC,CAAC,IAAI,CAAC;IAChD,CAAC;;QAAM,OAAO,IAAI,CAAC;IACnB,IACE,OAAO,GAAG,KAAK,QAAQ;QACvB,CAAC,6DAA6D,CAAC,IAAI,CAAC,GAAG,CAAC;QAExE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,OAAO,GAAG,CAAC;AACb,CAAC;AACD,SAAgB,oBAAoB,CAClC,GAAY,EACZ,OAAiC,EACjC,UAAoC,EAAE;IAEtC,MAAM,MAAM,GAAG,IAAA,iBAAU,EAAC,OAAO,CAAC,MAAM,CAAC,EACvC,KAAK,GAAG,IAAA,iBAAU,EAAC,GAAG,CAAC,EACvB,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAC7B,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,IAAI,KAAc,EAChB,SAAS,GAAG,KAAK,CAAC;IACpB,MAAM,KAAK,GAAG,CAAC,KAAc,EAAW,EAAE;QACxC,MAAM,GAAG,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;YACzE,MAAM,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,EAAE,KAAK,OAAO,IAAI,OAAO,CAAC,UAAU;gBAAE,OAAO,gBAAQ,CAAC;YAC1D,IAAI,EAAE,KAAK,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjC,sEAAsE;gBACtE,6EAA6E;gBAC7E,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;gBACxB,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;YACD,wFAAwF;YACxF,MAAM,MAAM,GAAG,IAAA,iBAAU,EACvB,IAAA,cAAO,EACL,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EACjE,KAAK,EACL,GAAG,CACJ,CACF,CAAC;YACF,IAAI,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC;gBACpE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACnB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;gBAC7B,YAAY,CAAC,IAAI,CAAC;oBAChB,SAAS,EAAE,GAAG;oBACd,eAAe,EAAE,IAAA,4BAAY,EAAC,MAAM,CAAC;oBACrC,gBAAgB,EAAE,IAAA,4BAAY,EAAC,QAAQ,CAAC;iBACzC,CAAC,CAAC;YACL,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YACpC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CACrD,CAAC;QACJ,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO,IAAA,0BAAU,EAAC;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;QACnB,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACvC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACnE;KACF,CAAC,CAAC;AACL,CAAC;AACD,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,KAAK,KAAK,gBAAQ;QAClB,CAAC,CAAC,CACA,KAAK;YACL,OAAO,KAAK,KAAK,QAAQ;YACzB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAC5C,CACF,CAAC;AACJ,CAAC"}

package/dist-runtime/delivery/release-graph.d.ts

@@ -0,0 +1,97 @@
+/** Actual-file release graph classification. No caller-selected roots or target subsets. */
+import { deploymentPurpose } from './source';
+export interface ReleaseGraphOptions {
+    workspaceRoot: string;
+    projectRoot: string;
+    handoff: string;
+    taskId: string;
+    deploymentId: string;
+    releaseRef: {
+        path: string;
+        releaseId: string;
+        inputsHash: string;
+    };
+}
+export declare const sameReleaseData: (a: unknown, b: unknown, label: string) => void;
+/** A completed simulation-only script task supplies reports, never on-chain acceptance. */
+export declare function isDevelopmentAcceptancePrerequisite(task: Parameters<typeof deploymentPurpose>[0]): any;
+export declare function readReleaseUniverse(input: Omit<ReleaseGraphOptions, 'releaseRef'>): {
+    workspace: string;
+    root: string;
+    text: string;
+    plan: import("../vendor/plan-codec/index.cjs").Plan;
+    entries: {
+        lane: string;
+        task: import("../vendor/plan-codec/index.cjs").PlanTask;
+    }[];
+    relevant: {
+        lane: string;
+        task: import("../vendor/plan-codec/index.cjs").PlanTask;
+    }[];
+    targets: string[];
+    qualifications: import("../vendor/plan-codec/index.cjs").PlanTask[];
+    upstream: Readonly<{
+        snapshot: import("./source").DeepReadonly<import("./source").DefinitionSnapshot>;
+        bytes: string;
+    }>;
+    developmentNetwork: string;
+};
+export declare function readReleaseGraph(input: ReleaseGraphOptions): {
+    targets: string[];
+    graph: {
+        readonly contract: typeof import("../vendor/plan-codec/index.cjs").DEFINITION_CONTRACT;
+        readonly schema: typeof import("../vendor/plan-codec/index.cjs").SCHEMA;
+        readonly taskId: string;
+        readonly flow?: string | undefined;
+        readonly roots: readonly string[];
+        readonly lanes: {
+            readonly [x: string]: {
+                readonly state: "enabled" | "disabled";
+                readonly skill?: string | undefined;
+                readonly steps: readonly string[];
+            };
+        };
+        readonly tasks: readonly {
+            readonly planKey: string;
+            readonly rev: number;
+            readonly step?: string | undefined;
+            readonly scope?: {
+                readonly [x: string]: unknown;
+            } | undefined;
+            readonly objective: string;
+            readonly acceptance: readonly string[];
+            readonly dependsOn: readonly string[];
+            readonly parameters?: readonly unknown[] | undefined;
+            readonly expectedArtifacts?: readonly string[] | undefined;
+            readonly allowedChanges?: readonly string[] | undefined;
+            readonly lane: string;
+        }[];
+    };
+    prodTaskGraphHash: string;
+};
+/** Progress is deliberately outside sourceDefinitionHash: eligibility is checked anew. */
+export declare function currentReleasePrerequisites(input: Omit<ReleaseGraphOptions, 'releaseRef'>): {
+    required: {
+        lane: string;
+        task: import("../vendor/plan-codec/index.cjs").PlanTask;
+    }[];
+    workspace: string;
+    root: string;
+    text: string;
+    plan: import("../vendor/plan-codec/index.cjs").Plan;
+    entries: {
+        lane: string;
+        task: import("../vendor/plan-codec/index.cjs").PlanTask;
+    }[];
+    relevant: {
+        lane: string;
+        task: import("../vendor/plan-codec/index.cjs").PlanTask;
+    }[];
+    targets: string[];
+    qualifications: import("../vendor/plan-codec/index.cjs").PlanTask[];
+    upstream: Readonly<{
+        snapshot: import("./source").DeepReadonly<import("./source").DefinitionSnapshot>;
+        bytes: string;
+    }>;
+    developmentNetwork: string;
+};

package/dist-runtime/delivery/release-graph.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sameReleaseData = void 0;
+exports.isDevelopmentAcceptancePrerequisite = isDevelopmentAcceptancePrerequisite;
+exports.readReleaseUniverse = readReleaseUniverse;
+exports.readReleaseGraph = readReleaseGraph;
+exports.currentReleasePrerequisites = currentReleasePrerequisites;
+/** Actual-file release graph classification. No caller-selected roots or target subsets. */
+const source_1 = require("./source");
+const project_files_1 = require("./project-files");
+const input_files_1 = require("./input-files");
+const canonicalData_1 = require("../workflow/lib/canonicalData");
+const protocol_1 = require("./protocol");
+const sameReleaseData = (a, b, label) => { if ((0, canonicalData_1.canonicalJson)(a) !== (0, canonicalData_1.canonicalJson)(b))
+    throw Error(`${label} mismatch`); };
+exports.sameReleaseData = sameReleaseData;
+/** A completed simulation-only script task supplies reports, never on-chain acceptance. */
+function isDevelopmentAcceptancePrerequisite(task) {
+    const d = task.scope?.deployment;
+    return (0, source_1.deploymentPurpose)(task) === 'dev-execution' && Array.isArray(d?.allowedActions) && d.allowedActions.some((action) => action !== 'simulate');
+}
+function readReleaseUniverse(input) {
+    const workspace = (0, project_files_1.projectRoot)(input.workspaceRoot, '.'), root = (0, project_files_1.projectRoot)(workspace, input.projectRoot);
+    (0, protocol_1.safeId)(input.deploymentId, 'deploymentId');
+    (0, protocol_1.portablePath)(input.handoff, 'handoff');
+    const text = (0, input_files_1.readInputBytes)(workspace, input.handoff).toString();
+    (0, input_files_1.assertUnambiguousHandoff)(text);
+    const plan = (0, source_1.parseCanonicalPlan)(text);
+    if (plan.taskId !== input.taskId)
+        throw Error('Current task identity mismatch');
+    const task = (0, protocol_1.object)((0, input_files_1.parseInputDocument)((0, input_files_1.readInputBytes)(root, `scripts/tasks/${input.deploymentId}/task.yaml`), 'yaml'), 'task.yaml', ['version', 'id', 'developmentNetwork', 'releaseTargetNetworks', 'requirementRef', 'productionRequirementRef', 'referenceDeploymentId']);
+    if (task.version !== 1 || task.id !== input.deploymentId || !Array.isArray(task.releaseTargetNetworks) || !task.releaseTargetNetworks.length)
+        throw Error('Invalid release target scope');
+    const targets = task.releaseTargetNetworks;
+    if (new Set(targets).size !== targets.length)
+        throw Error('Duplicate release target');
+    const entries = Object.entries(plan.tasks).flatMap(([lane, tasks]) => tasks.map(task => ({ lane, task }))), relevant = entries.filter(({ task: t }) => { const d = t.scope?.deployment; return d?.projectRoot === input.projectRoot && d?.deploymentId === input.deploymentId; });
+    for (const { task: t } of relevant) {
+        const d = t.scope.deployment;
+        (0, exports.sameReleaseData)(d.developmentNetwork, task.developmentNetwork, 'Current development target');
+        if (['prod-qualification', 'prod-execution'].includes((0, source_1.deploymentPurpose)(t))) {
+            (0, exports.sameReleaseData)(d.releaseTargetNetworks, targets, 'Current selected targets');
+            (0, exports.sameReleaseData)(d.productionRequirementRef ?? null, task.productionRequirementRef ?? null, 'Current production confirmation');
+        }
+        else if ((d.releaseTargetNetworks ?? []).some((network) => !targets.includes(network)))
+            throw Error('Current selected targets removed a development-declared target');
+    }
+    const qualifications = targets.map(target => { const rows = relevant.filter(({ task: t }) => (0, source_1.deploymentPurpose)(t) === 'prod-qualification' && t.scope.deployment.targetNetwork === target); if (rows.length !== 1)
+        throw Error('Missing or ambiguous qualification target'); const row = rows[0], d = row.task.scope.deployment; if (plan.lanes[row.lane].state !== 'enabled' || row.task.status === 'cancelled' || d.environment !== 'prod' || d.releaseRef !== undefined)
+        throw Error('Ineligible qualification task'); (0, exports.sameReleaseData)([...d.allowedActions].sort(), ['simulate', 'verify'], 'Qualification allowedActions'); return row.task; });
+    if (relevant.some(({ task: t }) => (0, source_1.deploymentPurpose)(t) === 'prod-qualification' && !targets.includes(t.scope.deployment.targetNetwork)))
+        throw Error('Unknown qualification target');
+    const upstream = (0, source_1.projectCanonicalDefinitions)(text, { roots: qualifications.map(t => t.planKey), mode: 'upstream' });
+    return { workspace, root, text, plan, entries, relevant, targets, qualifications, upstream, developmentNetwork: task.developmentNetwork };
+}
+function readReleaseGraph(input) {
+    const u = readReleaseUniverse(input);
+    (0, protocol_1.safeId)(input.releaseRef.releaseId, 'releaseId');
+    (0, protocol_1.portablePath)(input.releaseRef.path, 'releaseRef.path');
+    if (!/^[a-f0-9]{64}$/.test(input.releaseRef.inputsHash))
+        throw Error('Invalid release input hash');
+    // Classify ALL relevant production tasks first. Filtering a good ref first conceals split/wrong bindings.
+    const groups = new Map();
+    for (const row of u.relevant.filter(({ task }) => (0, source_1.deploymentPurpose)(task) === 'prod-execution')) {
+        const d = row.task.scope.deployment, ref = d.releaseRef;
+        if (!ref)
+            throw Error('Missing release binding');
+        const key = (0, canonicalData_1.canonicalJson)(ref), rows = groups.get(key) ?? [];
+        rows.push(row);
+        groups.set(key, rows);
+    }
+    const selectedKey = (0, canonicalData_1.canonicalJson)(input.releaseRef);
+    for (const [key, rows] of groups) {
+        const ref = rows[0].task.scope.deployment.releaseRef;
+        if (ref.releaseId === input.releaseRef.releaseId && key !== selectedKey)
+            throw Error('Split release binding');
+        if (rows.some(({ task }) => !u.targets.includes(task.scope.deployment.targetNetwork)))
+            throw Error('Unknown production target');
+        const byKey = new Map(u.entries.map(row => [row.task.planKey, row.task]));
+        const ancestors = (task, seen = new Set()) => { for (const id of task.dependsOn) {
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            const prior = byKey.get(id);
+            if (prior)
+                ancestors(prior, seen);
+        } return seen; };
+        for (const target of u.targets) {
+            const tasks = rows.filter(({ task }) => task.scope.deployment.targetNetwork === target).sort((a, b) => a.task.no - b.task.no);
+            if (!tasks.length)
+                throw Error('Missing complete release stage graph');
+            const qualification = u.qualifications.find(t => t.scope.deployment.targetNetwork === target);
+            const actions = (task) => task.scope.deployment.allowedActions;
+            const prepares = tasks.filter(({ task }) => actions(task).includes('simulate'));
+            const effects = tasks.filter(({ task }) => actions(task).some(a => ['execute', 'export-calldata'].includes(a)));
+            const verifies = tasks.filter(({ task }) => actions(task).includes('verify'));
+            if (!prepares.length || !effects.length || !verifies.length)
+                throw Error('Incomplete production stage graph: simulate, execute/export and verify required');
+            for (let index = 1; index < tasks.length; index++)
+                if (!ancestors(tasks[index].task).has(tasks[index - 1].task.planKey))
+                    throw Error('Split or duplicate release dependency graph');
+            if (!actions(tasks.at(-1).task).includes('verify'))
+                throw Error('Production graph must finish with verification');
+            for (const { lane, task } of tasks) {
+                const d = task.scope.deployment, upstream = ancestors(task);
+                if (u.plan.lanes[lane].state !== 'enabled' || task.status === 'cancelled' || d.environment !== 'prod')
+                    throw Error('Ineligible production task');
+                if (actions(task).some(a => ['execute', 'export-calldata'].includes(a)) && !actions(task).some(a => ['reconcile', 'verify'].includes(a)))
+                    throw Error('Production effect task requires reconcile or verify to observe completion');
+                if (!upstream.has(qualification.planKey))
+                    throw Error('Split release dependency graph');
+                if (actions(task).some(a => ['execute', 'export-calldata'].includes(a)) && !prepares.some(p => p.task.planKey === task.planKey || upstream.has(p.task.planKey)))
+                    throw Error('Missing production preparation dependency');
+                if (actions(task).includes('verify') && effects.some(e => e.task.planKey !== task.planKey && !upstream.has(e.task.planKey)))
+                    throw Error('Missing production verification dependency');
+            }
+        }
+    }
+    const selected = groups.get(selectedKey);
+    if (!selected)
+        throw Error('Missing complete release graph');
+    const graph = (0, source_1.projectCanonicalDefinitions)(u.text, { roots: selected.map(r => r.task.planKey), mode: 'full' });
+    return (0, canonicalData_1.deepFreeze)({ targets: u.targets, graph: graph.snapshot, prodTaskGraphHash: (0, canonicalData_1.semanticHash)(graph.snapshot) });
+}
+/** Progress is deliberately outside sourceDefinitionHash: eligibility is checked anew. */
+function currentReleasePrerequisites(input) {
+    const u = readReleaseUniverse(input), keys = new Set(u.upstream.snapshot.tasks.map(t => t.planKey)), qual = new Set(u.qualifications.map(t => t.planKey));
+    const requirementKeys = new Set(u.relevant.map(({ task }) => task.scope?.deployment?.requirementRef?.planKey).filter(Boolean));
+    const required = u.entries.filter(({ lane, task }) => keys.has(task.planKey) && !qual.has(task.planKey) && !requirementKeys.has(task.planKey) && u.plan.lanes[lane].state === 'enabled');
+    // Explicit dependencies (including the requirement's prerequisites) define this
+    // round. Unrelated development/audit work appended later is not a prerequisite.
+    if (!required.some(({ task }) => { const d = task.scope?.deployment; return isDevelopmentAcceptancePrerequisite(task) && d.deploymentId === input.deploymentId && d.projectRoot === input.projectRoot && d.environment === 'dev' && d.targetNetwork === u.developmentNetwork && d.allowedActions.includes('verify'); }))
+        throw Error('Missing development acceptance prerequisite: verify');
+    for (const { task } of required)
+        if (task.status !== 'completed' || task.result?.kind !== 'success' || task.adoptedRev !== task.rev)
+            throw Error(`Current prerequisite is incomplete or stale: ${task.planKey}`);
+    return { ...u, required };
+}
+//# sourceMappingURL=release-graph.js.map

package/dist-runtime/delivery/release-graph.js.map

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

package/dist-runtime/delivery/release-history-capture.d.ts

@@ -0,0 +1,7 @@
+import type { DeliveryAggregate, DeliveryAggregateOptions } from './aggregate';
+import type { HistoricalDevelopmentFiles } from './release-history';
+export declare function captureDevelopmentReleaseHistory(input: {
+    root: string;
+    source: DeliveryAggregateOptions;
+    aggregate: DeliveryAggregate;
+}): HistoricalDevelopmentFiles;

package/dist-runtime/delivery/release-history-capture.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.captureDevelopmentReleaseHistory = captureDevelopmentReleaseHistory;
+/** Narrow R1→R2 handoff: capture the currently installed producer and changing containers BEFORE prod edits. */
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_zlib_1 = require("node:zlib");
+const input_files_1 = require("./input-files");
+const project_files_1 = require("./project-files");
+const materialization_1 = require("./materialization");
+const canonicalData_1 = require("../workflow/lib/canonicalData");
+const plan_1 = require("./plan");
+const protocol_1 = require("./protocol");
+function captureDevelopmentReleaseHistory(input) {
+    const root = node_fs_1.default.realpathSync(input.root), a = input.aggregate, plan = (0, plan_1.parseDeliveryPlan)(a.collections[0]?.plan);
+    if (input.source.selection !== 'development' || a.collections.length !== 1 || plan.environment !== 'dev' || (0, project_files_1.projectRoot)(input.source.workspaceRoot, input.source.projectRoot) !== root)
+        throw Error('Historical capture requires original development source');
+    (0, protocol_1.safeId)(plan.executionId, 'executionId');
+    const base = `.gate-delivery/history/${plan.executionId}`, readyPath = `${base}/READY.json`;
+    const acceptanceFile = `.gate-delivery/development/${plan.executionId}.acceptance.json`, acceptance = JSON.parse((0, input_files_1.readInputBytes)(root, acceptanceFile).toString());
+    if (acceptance.status !== 'accepted' || acceptance.planHash !== plan.planHash || acceptance.inputsHash !== a.inputsHash || (0, canonicalData_1.semanticHash)(acceptance.runtimeIdentity) !== (0, canonicalData_1.semanticHash)(plan.runtimeIdentity))
+        throw Error('Historical capture requires actual accepted development');
+    const original = a.inputs.runtime.package;
+    if (original.name !== 'gate-evm-tools' || original.lockLocation !== 'node_modules/gate-evm-tools')
+        throw Error('Unsupported historical producer location');
+    const files = [];
+    const visit = (relative) => { const dir = (0, project_files_1.confinedFile)(root, `${original.lockLocation}/${relative}`.replace(/\/$/, ''), 'directory'); for (const name of node_fs_1.default.readdirSync(dir).sort()) {
+        const rel = relative ? `${relative}/${name}` : name;
+        const stat = node_fs_1.default.lstatSync(node_path_1.default.join(dir, name));
+        if (stat.isDirectory()) {
+            if (name === 'node_modules')
+                continue;
+            visit(rel);
+        }
+        else {
+            const bytes = (0, input_files_1.readInputBytes)(root, `${original.lockLocation}/${rel}`);
+            files.push({ path: rel, digest: (0, materialization_1.byteHash)(bytes), base64: bytes.toString('base64') });
+        }
+    } };
+    visit('');
+    files.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+    if ((0, canonicalData_1.semanticHash)(files.map(({ path, digest }) => ({ path, digest }))) !== (0, canonicalData_1.semanticHash)(original.payload))
+        throw Error('Historical capture must precede producer/runtime replacement');
+    const descriptor = { aggregateFile: `${base}/aggregate.json`, sourceFile: `${base}/source.json`, acceptanceFile, packageRoot: `${base}/package`, inputsRoot: `${base}/inputs`, archiveFile: `${base}/package.snapshot.json.gz` };
+    if (node_fs_1.default.existsSync((0, materialization_1.developmentPath)(root, readyPath))) {
+        const ready = JSON.parse((0, input_files_1.readInputBytes)(root, readyPath).toString());
+        if (ready.schema !== 'gate-delivery-history-ready' || ready.generation !== 'complete' || ready.planHash !== plan.planHash || ready.aggregateHash !== (0, canonicalData_1.semanticHash)(a))
+            throw Error('Conflicting historical capture');
+        for (const f of ready.files)
+            if ((0, materialization_1.byteHash)((0, input_files_1.readInputBytes)(root, f.path)) !== f.sha256)
+                throw Error('Captured historical file drift');
+        return descriptor;
+    }
+    const saved = [];
+    const write = (relative, bytes) => { const file = (0, materialization_1.developmentPath)(root, relative); node_fs_1.default.mkdirSync(node_path_1.default.dirname(file), { recursive: true, mode: 0o700 }); if (node_fs_1.default.existsSync(file) && !(0, input_files_1.readInputBytes)(root, relative).equals(bytes))
+        throw Error('Partial historical capture conflict'); const fd = node_fs_1.default.openSync(file, 'w', 0o600); try {
+        node_fs_1.default.writeFileSync(fd, bytes);
+        node_fs_1.default.fsyncSync(fd);
+    }
+    finally {
+        node_fs_1.default.closeSync(fd);
+    } saved.push({ path: relative, sha256: (0, materialization_1.byteHash)(bytes) }); };
+    for (const file of files)
+        write(`${base}/package/${file.path}`, Buffer.from(file.base64, 'base64'));
+    for (const name of [`${a.inputs.business.businessRoot}/task.yaml`, `${a.inputs.business.businessRoot}/parameters.yaml`, `${a.inputs.business.businessRoot}/parameters.provenance.json`, 'config.yaml', 'hardhat.config.ts', 'package-lock.json', 'contractInfo.json', 'deploymentInfo.json'])
+        write(`${base}/inputs/${name}`, (0, input_files_1.readInputBytes)(root, name));
+    write(descriptor.aggregateFile, Buffer.from((0, canonicalData_1.canonicalJson)(a) + '\n'));
+    write(descriptor.sourceFile, Buffer.from((0, canonicalData_1.canonicalJson)(input.source) + '\n'));
+    write(descriptor.archiveFile, (0, node_zlib_1.gzipSync)(Buffer.from((0, canonicalData_1.canonicalJson)({ schema: 'gate-delivery-package-snapshot', version: 1, runtimeIdentity: plan.runtimeIdentity, observedPackage: original, files }))));
+    (0, materialization_1.atomicDevelopmentWrite)(root, readyPath, (0, canonicalData_1.canonicalJson)({ schema: 'gate-delivery-history-ready', version: 1, generation: 'complete', planHash: plan.planHash, aggregateHash: (0, canonicalData_1.semanticHash)(a), descriptor, files: saved }) + '\n');
+    return descriptor;
+}
+//# sourceMappingURL=release-history-capture.js.map

package/dist-runtime/delivery/release-history-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-history-capture.js","sourceRoot":"","sources":["../../runtime/delivery/release-history-capture.ts"],"names":[],"mappings":"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"}