@agent-teams/engineering-foundation 0.17.0-rc.8 → 0.18.0

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

@@ -0,0 +1,172 @@
+import { lstat, mkdir, readdir, rename, rmdir, unlink } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { deserializeKnownFileIdentity, serializeKnownFileIdentity } from "../../application/model/known-file-transaction-journal.js";
+import { pathMatchesRegularFileIdentity } from "./node-bounded-regular-file.js";
+import { syncDirectoryStrictly } from "./node-directory-durability.js";
+import { knownFileErrorCode, knownFileTemporaryName, KnownFileTransactionError, sameKnownFileIdentity } from "./node-known-file-transaction-filesystem.js";
+import { persistRecoveryJournal, replaceRecoveryOperation } from "./node-known-file-recovery-state.js";
+function clearOperationRetirement(operation) {
+    if (operation.retirement === undefined) {
+        return operation;
+    }
+    const { retirement: _retirement, ...cleared } = operation;
+    return Object.freeze(cleared);
+}
+function retirementPath(options) {
+    const leaf = basename(options.operation.path);
+    const directory = join(options.parent, `.${leaf}.agent-teams.retire.${options.planDigest.slice(7, 23)}.${options.operationIndex}.${options.kind}`);
+    const source = options.kind === "destination"
+        ? join(options.parent, leaf)
+        : options.kind === "temporary"
+            ? join(options.parent, knownFileTemporaryName(options.operation.path, options.planDigest, options.operationIndex))
+            : join(options.parent, `.${leaf}.agent-teams.rollback.${options.operationIndex}.tmp`);
+    return { captured: join(directory, "captured"), directory, source };
+}
+async function createRetirementAuthority(options, operation, parent, paths, journalOperation) {
+    if (await pathMatchesRegularFileIdentity(paths.source, options.expectedIdentity) !== "match") {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Identity-bound recovery path changed before retirement: ${operation.path}.`);
+    }
+    const directory = await mkdir(paths.directory, { mode: 0o700 }).then(() => lstat(paths.directory, { bigint: true })).catch((error) => {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Retirement directory could not be exclusively created: ${operation.path}.`, { cause: error });
+    });
+    await syncDirectoryStrictly(parent);
+    const durableDirectory = await lstat(paths.directory, { bigint: true }).catch((error) => {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Retirement directory disappeared before durable identity binding: ${operation.path}.`, { cause: error });
+    });
+    if (!durableDirectory.isDirectory() || durableDirectory.isSymbolicLink() ||
+        durableDirectory.birthtimeNs !== directory.birthtimeNs ||
+        durableDirectory.dev !== directory.dev || durableDirectory.ino !== directory.ino) {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Retirement directory changed before durable identity binding: ${operation.path}.`);
+    }
+    const retirement = Object.freeze({
+        kind: options.kind,
+        state: "ready",
+        directoryIdentity: serializeKnownFileIdentity(directory),
+        pathIdentity: serializeKnownFileIdentity(options.expectedIdentity)
+    });
+    const updated = Object.freeze({ ...journalOperation, retirement });
+    await persistRecoveryJournal(options.store, options.stored, replaceRecoveryOperation(options.stored.envelope.journal, options.operationIndex, updated));
+    await options.faultInjector?.({
+        phase: "after-retirement-directory-bound",
+        operationIndex: options.operationIndex,
+        path: operation.path
+    });
+    return updated;
+}
+async function reconcileRetirementDirectory(options, operation, paths, journalOperation, retirement) {
+    const expectedDirectory = deserializeKnownFileIdentity(retirement.directoryIdentity);
+    const directory = await lstat(paths.directory, { bigint: true }).catch((error) => {
+        if (knownFileErrorCode(error) === "ENOENT") {
+            return null;
+        }
+        throw error;
+    });
+    if (directory === null) {
+        if (retirement.state !== "unlink-authorized" ||
+            await pathMatchesRegularFileIdentity(paths.source, options.expectedIdentity) === "match") {
+            throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Journal-bound retirement directory disappeared: ${operation.path}.`);
+        }
+        await persistRecoveryJournal(options.store, options.stored, replaceRecoveryOperation(options.stored.envelope.journal, options.operationIndex, clearOperationRetirement(journalOperation)));
+        return "complete";
+    }
+    if (!directory.isDirectory() || directory.isSymbolicLink() ||
+        directory.birthtimeNs !== expectedDirectory.birthtimeNs ||
+        directory.dev !== expectedDirectory.dev || directory.ino !== expectedDirectory.ino) {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Journal-bound retirement directory changed: ${operation.path}.`);
+    }
+    return "continue";
+}
+async function captureRetirementPath(options, context) {
+    const { journalOperation, operation, parent, paths, retirement } = context;
+    if (retirement.state !== "ready") {
+        return journalOperation;
+    }
+    const capturedMatch = await pathMatchesRegularFileIdentity(paths.captured, options.expectedIdentity);
+    const sourceMatch = await pathMatchesRegularFileIdentity(paths.source, options.expectedIdentity);
+    if (capturedMatch === "missing" && sourceMatch === "match") {
+        await rename(paths.source, paths.captured);
+        await syncDirectoryStrictly(paths.directory);
+        await syncDirectoryStrictly(parent);
+    }
+    else if (capturedMatch !== "match" || sourceMatch === "match") {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Journal-bound retirement capture is ambiguous: ${operation.path}.`);
+    }
+    const updated = Object.freeze({
+        ...journalOperation,
+        retirement: Object.freeze({ ...retirement, state: "captured" })
+    });
+    await persistRecoveryJournal(options.store, options.stored, replaceRecoveryOperation(options.stored.envelope.journal, options.operationIndex, updated));
+    await options.faultInjector?.({
+        phase: "after-retirement-captured",
+        operationIndex: options.operationIndex,
+        path: operation.path
+    });
+    return updated;
+}
+async function authorizeRetirementUnlink(options, operation, paths, journalOperation) {
+    const retirement = journalOperation.retirement;
+    if (retirement.state !== "captured") {
+        return journalOperation;
+    }
+    if (await pathMatchesRegularFileIdentity(paths.captured, options.expectedIdentity) !== "match") {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Journal-bound retired bytes changed: ${operation.path}.`);
+    }
+    const updated = Object.freeze({
+        ...journalOperation,
+        retirement: Object.freeze({ ...retirement, state: "unlink-authorized" })
+    });
+    await persistRecoveryJournal(options.store, options.stored, replaceRecoveryOperation(options.stored.envelope.journal, options.operationIndex, updated));
+    await options.faultInjector?.({
+        phase: "after-retirement-unlink-authorized",
+        operationIndex: options.operationIndex,
+        path: operation.path
+    });
+    return updated;
+}
+async function removeRetirementEvidence(options, operation, parent, paths, journalOperation) {
+    const captured = await pathMatchesRegularFileIdentity(paths.captured, options.expectedIdentity);
+    if (captured === "match") {
+        await unlink(paths.captured);
+        await syncDirectoryStrictly(paths.directory);
+    }
+    else if (captured !== "missing") {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Authorized retirement capture became foreign: ${operation.path}.`);
+    }
+    if ((await readdir(paths.directory)).length !== 0) {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Retirement directory contains foreign evidence: ${operation.path}.`);
+    }
+    await rmdir(paths.directory);
+    await syncDirectoryStrictly(parent);
+    await persistRecoveryJournal(options.store, options.stored, replaceRecoveryOperation(options.stored.envelope.journal, options.operationIndex, clearOperationRetirement(journalOperation)));
+}
+export async function retireJournalBoundPath(options) {
+    const operation = options.stored.envelope.journal.plan.operations[options.operationIndex];
+    const parent = dirname(join(options.root, ...operation.path.split("/")));
+    const paths = retirementPath({
+        kind: options.kind,
+        operation,
+        operationIndex: options.operationIndex,
+        parent,
+        planDigest: options.stored.envelope.journal.plan.planDigest
+    });
+    const initial = options.stored.envelope.journal.operations[options.operationIndex];
+    if (!("temporaryIdentity" in initial)) {
+        throw new KnownFileTransactionError("KNOWN_FILE_JOURNAL_INVALID", `Retirement requires durable operation identity: ${operation.path}.`);
+    }
+    let journalOperation = initial;
+    if (journalOperation.retirement === undefined) {
+        journalOperation = await createRetirementAuthority(options, operation, parent, paths, journalOperation);
+    }
+    const retirement = journalOperation.retirement;
+    if (retirement.kind !== options.kind ||
+        !sameKnownFileIdentity(deserializeKnownFileIdentity(retirement.pathIdentity), options.expectedIdentity)) {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Retirement authority does not match the requested path: ${operation.path}.`);
+    }
+    if (await reconcileRetirementDirectory(options, operation, paths, journalOperation, retirement) === "complete") {
+        return;
+    }
+    journalOperation = await captureRetirementPath(options, { journalOperation, operation, parent, paths, retirement });
+    journalOperation = await authorizeRetirementUnlink(options, operation, paths, journalOperation);
+    await removeRetirementEvidence(options, operation, parent, paths, journalOperation);
+}
+//# sourceMappingURL=node-known-file-recovery-retirement.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { KnownFileTransactionJournalV1 } from "../../application/model/known-file-transaction-journal.js";
+import type { NodeKnownFileTransactionJournalStore } from "./node-known-file-transaction-journal-store.js";
+import type { StoredKnownFileRecoveryJournal } from "./node-known-file-recovery-observation.js";
+export type StoredRecoveryJournal = StoredKnownFileRecoveryJournal;
+export type KnownFileRecoveryFaultInjector = (point: {
+    readonly phase: "after-committed-capture-unlinked" | "after-destination-retired" | "after-rollback-linked" | "after-rollback-capture-unlinked" | "after-retirement-directory-bound" | "after-retirement-captured" | "after-retirement-unlink-authorized";
+    readonly operationIndex: number;
+    readonly path: string;
+}) => Promise<void> | void;
+export declare function persistRecoveryJournal(store: NodeKnownFileTransactionJournalStore, stored: StoredRecoveryJournal, journal: KnownFileTransactionJournalV1): Promise<void>;
+export declare function replaceRecoveryOperation(journal: KnownFileTransactionJournalV1, index: number, operation: KnownFileTransactionJournalV1["operations"][number]): KnownFileTransactionJournalV1;
+//# sourceMappingURL=node-known-file-recovery-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-recovery-state.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-recovery-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2DAA2D,CAAC;AAE/G,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,gDAAgD,CAAC;AAC3G,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2CAA2C,CAAC;AAEhG,MAAM,MAAM,qBAAqB,GAAG,8BAA8B,CAAC;AAEnE,MAAM,MAAM,8BAA8B,GAAG,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,KAAK,EACV,kCAAkC,GAClC,2BAA2B,GAC3B,uBAAuB,GACvB,iCAAiC,GACjC,kCAAkC,GAClC,2BAA2B,GAC3B,oCAAoC,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE3B,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,oCAAoC,EAC3C,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,6BAA6B,EACtC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,6BAA6B,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,GAC7D,6BAA6B,CAK/B"}

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

@@ -0,0 +1,17 @@
+import { compileKnownFileTransactionEnvelope } from "../../application/policies/known-file-transaction-envelope.js";
+export async function persistRecoveryJournal(store, stored, journal) {
+    const envelope = compileKnownFileTransactionEnvelope({
+        foundation: stored.envelope.foundation,
+        journal,
+        state: stored.envelope.state
+    });
+    stored.authority = await store.replace(stored.authority, envelope);
+    stored.envelope = envelope;
+}
+export function replaceRecoveryOperation(journal, index, operation) {
+    return Object.freeze({
+        ...journal,
+        operations: Object.freeze(journal.operations.with(index, operation))
+    });
+}
+//# sourceMappingURL=node-known-file-recovery-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-recovery-state.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-recovery-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mCAAmC,EAAE,MAAM,+DAA+D,CAAC;AAmBpH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAA2C,EAC3C,MAA6B,EAC7B,OAAsC;IAEtC,MAAM,QAAQ,GAAG,mCAAmC,CAAC;QACnD,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;QACtC,OAAO;QACP,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK;KAC7B,CAAC,CAAC;IACH,MAAM,CAAC,SAAS,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAAsC,EACtC,KAAa,EACb,SAA8D;IAE9D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,OAAO;QACV,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;KACrE,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,9 +1,6 @@
 import type { KnownFileTransactionReceiptV1 } from "../../application/model/known-file-transaction.js";
-export type KnownFileRecoveryFaultInjector = (point: {
-    readonly phase: "after-committed-capture-unlinked" | "after-destination-retired" | "after-rollback-linked" | "after-rollback-capture-unlinked" | "after-retirement-directory-bound" | "after-retirement-captured" | "after-retirement-unlink-authorized";
-    readonly operationIndex: number;
-    readonly path: string;
-}) => Promise<void> | void;
+import { type KnownFileRecoveryFaultInjector } from "./node-known-file-recovery-executor.js";
+export type { KnownFileRecoveryFaultInjector } from "./node-known-file-recovery-executor.js";
 export declare function recoverKnownFileTransaction(options: {
     readonly consumerRoot: string;
     readonly faultInjector?: KnownFileRecoveryFaultInjector;

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

@@ -1 +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":"AAgBA,OAAO,KAAK,EAGV,6BAA6B,EAC9B,MAAM,mDAAmD,CAAC;AA8C3D,MAAM,MAAM,8BAA8B,GAAG,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,KAAK,EACV,kCAAkC,GAClC,2BAA2B,GAC3B,uBAAuB,GACvB,iCAAiC,GACjC,kCAAkC,GAClC,2BAA2B,GAC3B,oCAAoC,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAgqC3B,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,8BAA8B,CAAC;CACzD,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAqEzC"}
+{"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":"AAEA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAEvG,OAAO,EAGL,KAAK,8BAA8B,EACpC,MAAM,wCAAwC,CAAC;AAShD,YAAY,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAE7F,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,8BAA8B,CAAC;CACzD,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAsCzC"}