@agent-teams/repository-mutation 0.0.0

package/dist/repository-mutation/adapters/node/node-known-file-transaction-receipt.js

@@ -0,0 +1,43 @@
+import { sha256Json } from "../../../canonical-json.js";
+import { KnownFileTransactionError } from "./node-known-file-transaction-filesystem.js";
+export function compileRolledBackReceipt(journal) {
+    const operations = journal.operations.map((entry, index) => {
+        const planOperation = journal.plan.operations[index];
+        if (entry.state === "already-satisfied") {
+            return Object.freeze({
+                path: entry.path,
+                outcome: "already-satisfied",
+                resultDigest: planOperation.postimage.digest
+            });
+        }
+        if (planOperation.precondition.state === "absent") {
+            return Object.freeze({
+                path: entry.path,
+                outcome: "rolled-back-to-absent"
+            });
+        }
+        if (entry.matchedPreimage === undefined) {
+            throw new KnownFileTransactionError("KNOWN_FILE_JOURNAL_INVALID", `Replacement preimage binding is absent: ${entry.path}.`);
+        }
+        return Object.freeze({
+            path: entry.path,
+            outcome: "rolled-back-to-preimage",
+            resultDigest: planOperation.precondition.acceptedPreimages[entry.matchedPreimage].digest
+        });
+    });
+    const body = {
+        schemaVersion: 1,
+        protocol: "agent-teams.repository-mutation.known-file/v1",
+        planDigest: journal.plan.planDigest,
+        outcome: "rolled-back",
+        operations: Object.freeze(operations)
+    };
+    return Object.freeze({
+        ...body,
+        receiptDigest: sha256Json({
+            domain: "agent-teams.repository-mutation.known-file-receipt/v1",
+            body
+        })
+    });
+}
+//# sourceMappingURL=node-known-file-transaction-receipt.js.map

package/dist/repository-mutation/adapters/node/node-known-file-transaction-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-transaction-receipt.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-transaction-receipt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAGxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAExF,MAAM,UAAU,wBAAwB,CACtC,OAAsC;IAEtC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACzD,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAE,CAAC;QACtD,IAAI,KAAK,CAAC,KAAK,KAAK,mBAAmB,EAAE,CAAC;YACxC,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,mBAA4B;gBACrC,YAAY,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM;aAC7C,CAAC,CAAC;QACL,CAAC;QACD,IAAI,aAAa,CAAC,YAAY,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClD,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,uBAAgC;aAC1C,CAAC,CAAC;QACL,CAAC;QACD,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,yBAAyB,CACjC,4BAA4B,EAC5B,2CAA2C,KAAK,CAAC,IAAI,GAAG,CACzD,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,yBAAkC;YAC3C,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,CAAC,eAAe,CAAE,CAAC,MAAM;SAC1F,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG;QACX,aAAa,EAAE,CAAU;QACzB,QAAQ,EAAE,+CAAwD;QAClE,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU;QACnC,OAAO,EAAE,aAAsB;QAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;KACtC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,IAAI;QACP,aAAa,EAAE,UAAU,CAAC;YACxB,MAAM,EAAE,uDAAuD;YAC/D,IAAI;SACL,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/repository-mutation/adapters/node/node-known-file-transaction-recovery.d.ts

@@ -0,0 +1,14 @@
+import { type MutationClaim } from "../../../transaction-coordination/mutation-lease.js";
+import type { KnownFileTransactionReceiptV1 } from "../../application/model/known-file-transaction.js";
+import { type KnownFileRecoveryFaultInjector } from "./node-known-file-recovery-executor.js";
+export type { KnownFileRecoveryFaultInjector } from "./node-known-file-recovery-executor.js";
+export declare function recoverKnownFileTransactionWithFaults(options: {
+    readonly consumerRoot: string;
+    readonly claim?: MutationClaim;
+    readonly faultInjector?: KnownFileRecoveryFaultInjector;
+}): Promise<KnownFileTransactionReceiptV1>;
+export declare function recoverKnownFileTransaction(options: {
+    readonly consumerRoot: string;
+    readonly claim?: MutationClaim;
+}): Promise<KnownFileTransactionReceiptV1>;
+//# sourceMappingURL=node-known-file-transaction-recovery.d.ts.map

package/dist/repository-mutation/adapters/node/node-known-file-transaction-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-transaction-recovery.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-transaction-recovery.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAEvG,OAAO,EAGL,KAAK,8BAA8B,EACpC,MAAM,wCAAwC,CAAC;AAUhD,YAAY,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAE7F,wBAAsB,qCAAqC,CAAC,OAAO,EAAE;IACnE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,8BAA8B,CAAC;CACzD,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAkEzC;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;CAChC,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA4BzC"}

package/dist/repository-mutation/adapters/node/node-known-file-transaction-recovery.js

@@ -0,0 +1,109 @@
+import { installedRepositoryMutationBuildIdentity } from "../../../installed-artifact-identity.js";
+import { installedRepositoryMutationVersion, REPOSITORY_MUTATION_PACKAGE_NAME } from "../../../package-version.js";
+import { pruneMutationStateDirectory } from "../../../transaction-coordination/adapters/node/node-state-directory.js";
+import { acquireMutationLease, claimMutation, consumeMutationClaim, mutationClaimIntent, observeMutationState, retainMutationBarrierOnEvidence, retainMutationClaimBarrierOnEvidence } from "../../../transaction-coordination/mutation-lease.js";
+import { classifyKnownFileRecoveryTransition } from "../../application/policies/classify-known-file-recovery-transition.js";
+import { executeApplyingKnownFileRollback, executeCommittedKnownFileRecovery } from "./node-known-file-recovery-executor.js";
+import { observeKnownFileRecoveryEvidence } from "./node-known-file-recovery-observation.js";
+import { canonicalKnownFileRoot, KnownFileTransactionError } from "./node-known-file-transaction-filesystem.js";
+import { releaseKnownFileTransactionLease } from "./node-known-file-transaction-lease-release.js";
+export async function recoverKnownFileTransactionWithFaults(options) {
+    if (process.platform === "win32") {
+        throw new KnownFileTransactionError("KNOWN_FILE_APPLY_UNSUPPORTED", "Known-file recovery requires strict directory durability and is not qualified on Windows.");
+    }
+    const root = await canonicalKnownFileRoot(options.consumerRoot);
+    let ownedLease;
+    let claim = options.claim;
+    ownedLease = claim === undefined ? await acquireMutationLease(root) : undefined;
+    let retainBarrier = true;
+    let primaryFailure;
+    try {
+        const [version, buildIdentity] = await Promise.all([
+            installedRepositoryMutationVersion(), installedRepositoryMutationBuildIdentity()
+        ]);
+        const artifact = { name: REPOSITORY_MUTATION_PACKAGE_NAME, version, buildIdentity };
+        if (claim === undefined) {
+            const lease = ownedLease;
+            claim = await claimMutation(lease, await observeMutationState(lease), {
+                kind: "recover-known-file", ownerArtifact: artifact, kernelArtifact: artifact
+            });
+        }
+        const claimedIntent = mutationClaimIntent(claim);
+        const exactArtifact = (candidate) => candidate.name === artifact.name && candidate.version === artifact.version &&
+            candidate.buildIdentity === artifact.buildIdentity;
+        if (claimedIntent.kind !== "recover-known-file" || !exactArtifact(claimedIntent.ownerArtifact) ||
+            !exactArtifact(claimedIntent.kernelArtifact) ||
+            await consumeMutationClaim(claim, "recover-known-file") !== root) {
+            throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", "Mutation claim has the wrong root, owner, or kernel identity.");
+        }
+        const evidence = await observeKnownFileRecoveryEvidence(root);
+        const transition = classifyKnownFileRecoveryTransition({
+            envelope: evidence.stored.envelope,
+            installedBuild: evidence.installedBuild
+        });
+        if (transition.action === "reject") {
+            throw new KnownFileTransactionError(transition.code, transition.message);
+        }
+        const execution = {
+            ...(options.faultInjector === undefined ? {} : { faultInjector: options.faultInjector }),
+            root,
+            store: evidence.store,
+            stored: evidence.stored
+        };
+        const result = transition.action === "resume-committed-cleanup"
+            ? await executeCommittedKnownFileRecovery(execution)
+            : await executeApplyingKnownFileRollback(execution);
+        retainBarrier = false;
+        return result;
+    }
+    catch (error) {
+        if (claim !== undefined) {
+            await retainMutationClaimBarrierOnEvidence(claim);
+        }
+        if (ownedLease !== undefined) {
+            await retainMutationBarrierOnEvidence(ownedLease);
+        }
+        primaryFailure = { reason: error };
+        throw error;
+    }
+    finally {
+        if (ownedLease !== undefined) {
+            await releaseKnownFileTransactionLease({
+                jointFailureMessage: "Known-file recovery and transaction lease release both failed.",
+                lease: ownedLease,
+                ...(primaryFailure === undefined ? {} : { primaryFailure }),
+                retainTransactionBarrier: retainBarrier
+            });
+        }
+        if (!retainBarrier) {
+            await pruneMutationStateDirectory(root);
+        }
+    }
+}
+export function recoverKnownFileTransaction(options) {
+    const keys = typeof options === "object" && options !== null
+        ? Reflect.ownKeys(options)
+        : [];
+    const expectedKeys = keys.includes("claim")
+        ? ["claim", "consumerRoot"]
+        : ["consumerRoot"];
+    if (typeof options !== "object" || options === null || Array.isArray(options) ||
+        ![Object.prototype, null].includes(Object.getPrototypeOf(options)) ||
+        keys.some((key) => typeof key !== "string") ||
+        keys.toSorted().join("\0") !== expectedKeys.toSorted().join("\0") ||
+        keys.some((key) => {
+            const descriptor = Object.getOwnPropertyDescriptor(options, key);
+            return descriptor === undefined || !("value" in descriptor) || !descriptor.enumerable;
+        })) {
+        return Promise.reject(new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", "Known-file recovery options contain unknown, missing, or executable properties."));
+    }
+    const values = Object.fromEntries(keys.map((key) => [
+        key,
+        Object.getOwnPropertyDescriptor(options, key).value
+    ]));
+    const input = Object.hasOwn(values, "claim")
+        ? { consumerRoot: values["consumerRoot"], claim: values["claim"] }
+        : { consumerRoot: values["consumerRoot"] };
+    return recoverKnownFileTransactionWithFaults(input);
+}
+//# sourceMappingURL=node-known-file-transaction-recovery.js.map

package/dist/repository-mutation/adapters/node/node-known-file-transaction-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-transaction-recovery.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-transaction-recovery.ts"],"names":[],"mappings":"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"}

package/dist/repository-mutation/adapters/node/node-known-file-transaction.d.ts

@@ -0,0 +1,21 @@
+import { type MutationClaim } from "../../../transaction-coordination/mutation-lease.js";
+import type { KnownFileTransactionPlanV1, KnownFileTransactionReceiptV1 } from "../../application/model/known-file-transaction.js";
+import type { KnownFileTransactionJournalV1 } from "../../application/model/known-file-transaction-journal.js";
+import type { KnownFileTransactionFaultInjector, KnownFileTransactionFaultPoint } from "./node-known-file-apply-faults.js";
+export { KnownFileTransactionError } from "./node-known-file-transaction-filesystem.js";
+export type { KnownFileTransactionFaultInjector, KnownFileTransactionFaultPoint };
+export declare function compileKnownFileTransactionReceipt(journal: KnownFileTransactionJournalV1, outcome: "already-satisfied" | "applied"): KnownFileTransactionReceiptV1;
+export { verifyCommittedKnownFilePostimages } from "./node-known-file-apply-observation.js";
+export declare function applyKnownFileTransactionWithFaults(options: {
+    readonly consumerRoot: string;
+    readonly plan: KnownFileTransactionPlanV1;
+    readonly claim?: MutationClaim;
+    readonly faultInjector?: KnownFileTransactionFaultInjector;
+}): Promise<KnownFileTransactionReceiptV1>;
+export declare function applyKnownFileTransaction(options: {
+    readonly consumerRoot: string;
+    readonly plan: KnownFileTransactionPlanV1;
+    readonly claim?: MutationClaim;
+}): Promise<KnownFileTransactionReceiptV1>;
+export declare function canonicalKnownFileTransactionReceipt(value: KnownFileTransactionReceiptV1): string;
+//# sourceMappingURL=node-known-file-transaction.d.ts.map

package/dist/repository-mutation/adapters/node/node-known-file-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-transaction.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-transaction.ts"],"names":[],"mappings":"AAIA,OAAO,EAG0B,KAAK,aAAa,EAClD,MAAM,qDAAqD,CAAC;AAC7D,OAAO,KAAK,EAEV,0BAA0B,EAC1B,6BAA6B,EAC9B,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2DAA2D,CAAC;AAI/G,OAAO,KAAK,EACV,iCAAiC,EACjC,8BAA8B,EAC/B,MAAM,mCAAmC,CAAC;AAkB3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,YAAY,EAAE,iCAAiC,EAAE,8BAA8B,EAAE,CAAC;AAElF,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,6BAA6B,EACtC,OAAO,EAAE,mBAAmB,GAAG,SAAS,GACvC,6BAA6B,CA2B/B;AAED,OAAO,EAAE,kCAAkC,EAAE,MAAM,wCAAwC,CAAC;AA+G5F,wBAAsB,mCAAmC,CAAC,OAAO,EAAE;IACjE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,iCAAiC,CAAC;CAC5D,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA6EzC;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;CAChC,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA4BzC;AAED,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,6BAA6B,GACnC,MAAM,CAER"}

package/dist/repository-mutation/adapters/node/node-known-file-transaction.js

@@ -0,0 +1,215 @@
+import { canonicalJson, sha256Json } from "../../../canonical-json.js";
+import { installedRepositoryMutationBuildIdentity } from "../../../installed-artifact-identity.js";
+import { installedRepositoryMutationVersion, REPOSITORY_MUTATION_PACKAGE_NAME } from "../../../package-version.js";
+import { ensureMutationStateDirectory } from "../../../transaction-coordination/adapters/node/node-state-directory.js";
+import { acquireMutationLease, claimMutation, consumeMutationClaim, mutationClaimIntent, observeMutationState, retainMutationBarrierOnEvidence, retainMutationClaimBarrierOnEvidence } from "../../../transaction-coordination/mutation-lease.js";
+import { compileKnownFileTransactionEnvelope } from "../../application/policies/known-file-transaction-envelope.js";
+import { assertKnownFileTransactionPlan } from "../../application/policies/known-file-transaction-plan.js";
+import { cleanupCommittedKnownFileCaptures } from "./node-known-file-recovery-filesystem.js";
+import { observeInitialKnownFileJournal, verifyApplyingKnownFilePostimages, verifyCommittedKnownFilePostimages } from "./node-known-file-apply-observation.js";
+import { executeKnownFileOperation } from "./node-known-file-apply-operation.js";
+import { persistKnownFileApplyState } from "./node-known-file-apply-state.js";
+import { canonicalKnownFileRoot, KnownFileTransactionError } from "./node-known-file-transaction-filesystem.js";
+import { NodeKnownFileTransactionJournalStore } from "./node-known-file-transaction-journal-store.js";
+import { releaseKnownFileTransactionLease } from "./node-known-file-transaction-lease-release.js";
+export { KnownFileTransactionError } from "./node-known-file-transaction-filesystem.js";
+export function compileKnownFileTransactionReceipt(journal, outcome) {
+    const operations = journal.operations.map((entry, index) => {
+        const planOperation = journal.plan.operations[index];
+        const operationOutcome = entry.state === "already-satisfied"
+            ? "already-satisfied"
+            : planOperation.precondition.state === "absent" ? "created" : "replaced";
+        return Object.freeze({
+            path: entry.path,
+            outcome: operationOutcome,
+            resultDigest: planOperation.postimage.digest
+        });
+    });
+    const body = {
+        schemaVersion: 1,
+        protocol: "agent-teams.repository-mutation.known-file/v1",
+        planDigest: journal.plan.planDigest,
+        outcome,
+        operations: Object.freeze(operations)
+    };
+    return Object.freeze({
+        ...body,
+        receiptDigest: sha256Json({
+            domain: "agent-teams.repository-mutation.known-file-receipt/v1",
+            body
+        })
+    });
+}
+export { verifyCommittedKnownFilePostimages } from "./node-known-file-apply-observation.js";
+async function executeKnownFileApply(options) {
+    for (let index = 0; index < options.stored.envelope.payload.plan.operations.length; index += 1) {
+        await executeKnownFileOperation({ ...options, index });
+    }
+    await verifyApplyingKnownFilePostimages(options.root, options.stored.envelope.payload);
+    await persistKnownFileApplyState(options.store, options.stored, options.stored.envelope.payload, "COMMITTED");
+    await options.faultInjector?.({ phase: "after-journal-committed" });
+    await verifyCommittedKnownFilePostimages(options.root, options.stored.envelope.payload);
+    await cleanupCommittedKnownFileCaptures(options.root, options.stored.envelope.payload, options.faultInjector);
+    await verifyCommittedKnownFilePostimages(options.root, options.stored.envelope.payload);
+    return compileKnownFileTransactionReceipt(options.stored.envelope.payload, "applied");
+}
+async function refreshBarrierRetention(store) {
+    if (store === undefined) {
+        return false;
+    }
+    try {
+        return await store.read() !== undefined;
+    }
+    catch {
+        return true;
+    }
+}
+async function installedMutationArtifact() {
+    const [version, buildIdentity] = await Promise.all([
+        installedRepositoryMutationVersion(),
+        installedRepositoryMutationBuildIdentity()
+    ]);
+    return { name: REPOSITORY_MUTATION_PACKAGE_NAME, version, buildIdentity };
+}
+async function ensureApplyClaim(options) {
+    if (options.claim !== undefined) {
+        return options.claim;
+    }
+    if (options.lease === undefined) {
+        throw new KnownFileTransactionError("KNOWN_FILE_PLAN_INVALID", "Known-file apply did not acquire its mutation lease.");
+    }
+    return claimMutation(options.lease, await observeMutationState(options.lease), {
+        kind: "apply-known-file",
+        planDigest: options.planDigest,
+        ownerArtifact: options.artifact,
+        kernelArtifact: options.artifact
+    });
+}
+function sameArtifact(candidate, expected) {
+    return candidate.name === expected.name &&
+        candidate.version === expected.version &&
+        candidate.buildIdentity === expected.buildIdentity;
+}
+async function assertApplyClaim(options) {
+    const intent = mutationClaimIntent(options.claim);
+    if (intent.kind !== "apply-known-file" ||
+        intent.planDigest !== options.planDigest ||
+        !sameArtifact(intent.ownerArtifact, options.artifact) ||
+        !sameArtifact(intent.kernelArtifact, options.artifact) ||
+        await consumeMutationClaim(options.claim, "apply-known-file") !== options.root) {
+        throw new KnownFileTransactionError("KNOWN_FILE_PLAN_INVALID", "Mutation claim belongs to another repository root, plan, owner, or kernel identity.");
+    }
+}
+function translateApplyAdmissionFailure(error) {
+    if (error instanceof Error && /Common transaction evidence/u.test(error.message)) {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_REQUIRED", "Common transaction evidence must be recovered before known-file apply.");
+    }
+    throw error;
+}
+export async function applyKnownFileTransactionWithFaults(options) {
+    assertKnownFileTransactionPlan(options.plan);
+    if (process.platform === "win32") {
+        throw new KnownFileTransactionError("KNOWN_FILE_APPLY_UNSUPPORTED", "Known-file apply requires strict directory durability and is not qualified on Windows.");
+    }
+    const root = await canonicalKnownFileRoot(options.consumerRoot);
+    let ownedLease;
+    let claim = options.claim;
+    ownedLease = claim === undefined ? await acquireMutationLease(root) : undefined;
+    let retainBarrier = false;
+    let store;
+    let primaryFailure;
+    try {
+        const mutationArtifact = await installedMutationArtifact();
+        claim = await ensureApplyClaim({
+            artifact: mutationArtifact,
+            claim,
+            lease: ownedLease,
+            planDigest: options.plan.planDigest
+        });
+        await assertApplyClaim({
+            artifact: mutationArtifact,
+            claim,
+            planDigest: options.plan.planDigest,
+            root
+        });
+        await options.faultInjector?.({ phase: "after-barrier-acquired" });
+        const journal = await observeInitialKnownFileJournal(root, options.plan);
+        if (journal.operations.every(({ state }) => state === "already-satisfied")) {
+            return compileKnownFileTransactionReceipt(journal, "already-satisfied");
+        }
+        const envelope = compileKnownFileTransactionEnvelope({
+            ownerArtifact: mutationArtifact,
+            kernelArtifact: mutationArtifact,
+            journal,
+            state: "APPLYING"
+        });
+        store = new NodeKnownFileTransactionJournalStore(await ensureMutationStateDirectory(root), mutationArtifact, mutationArtifact);
+        const stored = {
+            authority: await store.create(envelope),
+            envelope
+        };
+        retainBarrier = true;
+        await options.faultInjector?.({ phase: "after-journal-created" });
+        const result = await executeKnownFileApply({
+            ...(options.faultInjector === undefined ? {} : { faultInjector: options.faultInjector }),
+            root,
+            store,
+            stored
+        });
+        await store.remove(stored.authority);
+        await options.faultInjector?.({ phase: "after-journal-retired" });
+        retainBarrier = false;
+        return result;
+    }
+    catch (error) {
+        retainBarrier = await refreshBarrierRetention(store);
+        if (claim !== undefined) {
+            await retainMutationClaimBarrierOnEvidence(claim);
+        }
+        if (ownedLease !== undefined && !retainBarrier) {
+            retainBarrier = await retainMutationBarrierOnEvidence(ownedLease);
+        }
+        primaryFailure = { reason: error };
+        return translateApplyAdmissionFailure(error);
+    }
+    finally {
+        if (ownedLease !== undefined) {
+            await releaseKnownFileTransactionLease({
+                jointFailureMessage: "Known-file apply and transaction lease release both failed.",
+                lease: ownedLease,
+                ...(primaryFailure === undefined ? {} : { primaryFailure }),
+                retainTransactionBarrier: retainBarrier
+            });
+        }
+    }
+}
+export function applyKnownFileTransaction(options) {
+    const keys = typeof options === "object" && options !== null
+        ? Reflect.ownKeys(options)
+        : [];
+    const expectedKeys = keys.includes("claim")
+        ? ["claim", "consumerRoot", "plan"]
+        : ["consumerRoot", "plan"];
+    if (typeof options !== "object" || options === null || Array.isArray(options) ||
+        ![Object.prototype, null].includes(Object.getPrototypeOf(options)) ||
+        keys.some((key) => typeof key !== "string") ||
+        keys.toSorted().join("\0") !== expectedKeys.toSorted().join("\0") ||
+        keys.some((key) => {
+            const descriptor = Object.getOwnPropertyDescriptor(options, key);
+            return descriptor === undefined || !("value" in descriptor) || !descriptor.enumerable;
+        })) {
+        return Promise.reject(new KnownFileTransactionError("KNOWN_FILE_PLAN_INVALID", "Known-file apply options contain unknown, missing, or executable properties."));
+    }
+    const values = Object.fromEntries(keys.map((key) => [
+        key,
+        Object.getOwnPropertyDescriptor(options, key).value
+    ]));
+    const input = Object.hasOwn(values, "claim")
+        ? { consumerRoot: values["consumerRoot"], plan: values["plan"], claim: values["claim"] }
+        : { consumerRoot: values["consumerRoot"], plan: values["plan"] };
+    return applyKnownFileTransactionWithFaults(input);
+}
+export function canonicalKnownFileTransactionReceipt(value) {
+    return `${canonicalJson(value)}\n`;
+}
+//# sourceMappingURL=node-known-file-transaction.js.map

package/dist/repository-mutation/adapters/node/node-known-file-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-transaction.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-transaction.ts"],"names":[],"mappings":"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"}

package/dist/repository-mutation/adapters/node/node-prepare-exact-sibling-temporary.d.ts

@@ -0,0 +1,18 @@
+import type { FileHandle } from "node:fs/promises";
+import { type ExactFilePostimage } from "../../application/model/exact-postimage.js";
+import type { PortablePathIdentity } from "../../application/model/path-identity.js";
+export interface PrepareExactSiblingTemporaryOptions {
+    readonly displayPath: string;
+    readonly onIdentityCaptured: (identity: PortablePathIdentity) => void;
+    readonly validateOpenedPath?: (identity: PortablePathIdentity) => Promise<void>;
+    readonly open: (path: string, flags: "wx", mode: number) => Promise<FileHandle>;
+    readonly postimage: ExactFilePostimage;
+    readonly temporaryPath: string;
+}
+export declare function prepareExactSiblingTemporaryWithFaults(options: PrepareExactSiblingTemporaryOptions & {
+    readonly faultInjector?: (point: {
+        readonly phase: "after-temporary-written";
+    }) => Promise<void> | void;
+}): Promise<PortablePathIdentity>;
+export declare function prepareExactSiblingTemporary(options: PrepareExactSiblingTemporaryOptions): Promise<PortablePathIdentity>;
+//# sourceMappingURL=node-prepare-exact-sibling-temporary.d.ts.map

package/dist/repository-mutation/adapters/node/node-prepare-exact-sibling-temporary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-prepare-exact-sibling-temporary.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-prepare-exact-sibling-temporary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAA8B,KAAK,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AACjH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAIrF,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAC5B,QAAQ,EAAE,oBAAoB,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,CACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAsB,sCAAsC,CAC1D,OAAO,EAAE,mCAAmC,GAAG;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAC/B,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;KAC3C,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5B,GACA,OAAO,CAAC,oBAAoB,CAAC,CAyB/B;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,oBAAoB,CAAC,CAE/B"}

package/dist/repository-mutation/adapters/node/node-prepare-exact-sibling-temporary.js

@@ -0,0 +1,30 @@
+import { AbsentFilePublicationError } from "../../application/model/exact-postimage.js";
+import { captureFileHandleIdentity } from "./node-bounded-regular-file.js";
+import { publicationErrorCode } from "./node-absent-file-publication-private.js";
+export async function prepareExactSiblingTemporaryWithFaults(options) {
+    const handle = await options
+        .open(options.temporaryPath, "wx", 0o600)
+        .catch((error) => {
+        if (publicationErrorCode(error) === "EEXIST") {
+            throw new AbsentFilePublicationError("TEMPORARY_EXISTS", `Temporary path already exists: ${options.displayPath}.`, { cause: error });
+        }
+        throw error;
+    });
+    try {
+        const identity = await captureFileHandleIdentity(handle);
+        options.onIdentityCaptured(identity);
+        await options.validateOpenedPath?.(identity);
+        await handle.writeFile(options.postimage.bytes);
+        await options.faultInjector?.({ phase: "after-temporary-written" });
+        await handle.chmod(options.postimage.mode);
+        await handle.sync();
+        return identity;
+    }
+    finally {
+        await handle.close();
+    }
+}
+export function prepareExactSiblingTemporary(options) {
+    return prepareExactSiblingTemporaryWithFaults(options);
+}
+//# sourceMappingURL=node-prepare-exact-sibling-temporary.js.map

package/dist/repository-mutation/adapters/node/node-prepare-exact-sibling-temporary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-prepare-exact-sibling-temporary.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-prepare-exact-sibling-temporary.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAA2B,MAAM,4CAA4C,CAAC;AAEjH,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAiBjF,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAC1D,OAIC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO;SACzB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC;SACxC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACxB,IAAI,oBAAoB,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,IAAI,0BAA0B,CAClC,kBAAkB,EAClB,kCAAkC,OAAO,CAAC,WAAW,GAAG,EACxD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACL,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC,CAAC;QACpE,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAA4C;IAE5C,OAAO,sCAAsC,CAAC,OAAO,CAAC,CAAC;AACzD,CAAC"}

package/dist/repository-mutation/adapters/node/node-publish-prepared-absent-file.d.ts

@@ -0,0 +1,31 @@
+import type { ExactFilePostimage } from "../../application/model/exact-postimage.js";
+import type { PortablePathIdentity } from "../../application/model/path-identity.js";
+import { readBoundedRegularFile } from "./node-bounded-regular-file.js";
+import type { DirectoryDurability } from "./node-directory-durability.js";
+export declare function verifyPublishedAbsentFile(options: {
+    readonly destinationPath: string;
+    readonly displayPath: string;
+    readonly expectedIdentity: PortablePathIdentity;
+    readonly postimage: ExactFilePostimage;
+    readonly readBoundedRegularFile: typeof readBoundedRegularFile;
+}): Promise<void>;
+export interface PublishPreparedAbsentFileOptions {
+    readonly allowUnsupportedDirectoryDurability: boolean;
+    readonly classifyBoundedRegularFile: typeof readBoundedRegularFile;
+    readonly destinationPath: string;
+    readonly displayPath: string;
+    readonly expectedIdentity: PortablePathIdentity;
+    readonly link: (source: string, destination: string) => Promise<void>;
+    readonly parent: string;
+    readonly postimage: ExactFilePostimage;
+    readonly readBoundedRegularFile: typeof readBoundedRegularFile;
+    readonly syncDirectory: (path: string) => Promise<DirectoryDurability>;
+    readonly temporaryPath: string;
+}
+export declare function publishPreparedAbsentFileWithFaults(options: PublishPreparedAbsentFileOptions & {
+    readonly faultInjector?: (point: {
+        readonly phase: "after-hard-link";
+    }) => Promise<void> | void;
+}): Promise<"already-satisfied" | "published">;
+export declare function publishPreparedAbsentFile(options: PublishPreparedAbsentFileOptions): Promise<"already-satisfied" | "published">;
+//# sourceMappingURL=node-publish-prepared-absent-file.d.ts.map

package/dist/repository-mutation/adapters/node/node-publish-prepared-absent-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-publish-prepared-absent-file.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-publish-prepared-absent-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAsC1E,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CAChE,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,mCAAmC,EAAE,OAAO,CAAC;IACtD,QAAQ,CAAC,0BAA0B,EAAE,OAAO,sBAAsB,CAAC;IACnE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IAC/D,QAAQ,CAAC,aAAa,EAAE,CACtB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,gCAAgC,GAAG;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAC/B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;KACnC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5B,GACA,OAAO,CAAC,mBAAmB,GAAG,WAAW,CAAC,CAkC5C;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,mBAAmB,GAAG,WAAW,CAAC,CAE5C"}

package/dist/repository-mutation/adapters/node/node-publish-prepared-absent-file.js

@@ -0,0 +1,50 @@
+import { AbsentFilePublicationError } from "../../application/model/exact-postimage.js";
+import { readBoundedRegularFile } from "./node-bounded-regular-file.js";
+import { classifyExactFilePostimageWith, exactReadMatchesPostimage, publicationErrorCode, samePublicationIdentity, syncPublicationDirectory } from "./node-absent-file-publication-private.js";
+function isUnsupportedLink(error) {
+    return ["ENOSYS", "ENOTSUP", "EOPNOTSUPP", "EPERM", "EXDEV"].includes(publicationErrorCode(error) ?? "");
+}
+async function verifyPreparedTemporary(options) {
+    const stableTemporary = await options.readBoundedRegularFile(options.temporaryPath, options.postimage.size);
+    if (exactReadMatchesPostimage(stableTemporary, options.postimage) &&
+        samePublicationIdentity(stableTemporary.identity, options.expectedIdentity)) {
+        return;
+    }
+    throw new AbsentFilePublicationError("TEMPORARY_REPLACED", `Temporary path was replaced or modified concurrently: ${options.displayPath}.`);
+}
+export async function verifyPublishedAbsentFile(options) {
+    const publishedFile = await options.readBoundedRegularFile(options.destinationPath, options.postimage.size);
+    if (exactReadMatchesPostimage(publishedFile, options.postimage) &&
+        samePublicationIdentity(publishedFile.identity, options.expectedIdentity)) {
+        return;
+    }
+    throw new AbsentFilePublicationError("VERIFICATION_FAILED", `Published file failed identity or content verification: ${options.displayPath}.`);
+}
+export async function publishPreparedAbsentFileWithFaults(options) {
+    await verifyPreparedTemporary(options);
+    try {
+        await options.link(options.temporaryPath, options.destinationPath);
+    }
+    catch (error) {
+        if (publicationErrorCode(error) === "EEXIST") {
+            const state = await classifyExactFilePostimageWith(options.classifyBoundedRegularFile, options.destinationPath, options.postimage);
+            if (state === "exact") {
+                await syncPublicationDirectory(options);
+                return "already-satisfied";
+            }
+            throw new AbsentFilePublicationError("CONFLICT", `Destination changed concurrently: ${options.displayPath}.`, { cause: error });
+        }
+        if (isUnsupportedLink(error)) {
+            throw new AbsentFilePublicationError("PUBLICATION_UNSUPPORTED", `Atomic absent-only publication is unsupported: ${options.displayPath}.`, { cause: error });
+        }
+        throw error;
+    }
+    await options.faultInjector?.({ phase: "after-hard-link" });
+    await verifyPublishedAbsentFile(options);
+    await syncPublicationDirectory(options);
+    return "published";
+}
+export function publishPreparedAbsentFile(options) {
+    return publishPreparedAbsentFileWithFaults(options);
+}
+//# sourceMappingURL=node-publish-prepared-absent-file.js.map

package/dist/repository-mutation/adapters/node/node-publish-prepared-absent-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-publish-prepared-absent-file.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-publish-prepared-absent-file.ts"],"names":[],"mappings":"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"}

package/dist/repository-mutation/adapters/node/node-repository-path.d.ts

@@ -0,0 +1,2 @@
+export declare function isLexicallyContainedPath(root: string, candidate: string): boolean;
+//# sourceMappingURL=node-repository-path.d.ts.map

package/dist/repository-mutation/adapters/node/node-repository-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-repository-path.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-repository-path.ts"],"names":[],"mappings":"AAEA,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAMjF"}

package/dist/repository-mutation/adapters/node/node-repository-path.js

@@ -0,0 +1,7 @@
+import { isAbsolute, relative, sep } from "node:path";
+export function isLexicallyContainedPath(root, candidate) {
+    const relation = relative(root, candidate);
+    return (relation === "" ||
+        (!relation.startsWith(`..${sep}`) && relation !== ".." && !isAbsolute(relation)));
+}
+//# sourceMappingURL=node-repository-path.js.map