@agent-teams/engineering-foundation 0.15.0 → 0.16.0

package/dist/scaffolding/adapters/node/node-scaffold-journal-store.js

@@ -0,0 +1,288 @@
+import { link, open, rename } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { FOUNDATION_TRANSACTION_FILE, FOUNDATION_TRANSACTION_TEMPORARY_FILE, LOCAL_STATE_DIRECTORY } from "../../../foundation-state-contract.js";
+import { captureFileHandleIdentity } from "./filesystem-file-identity.js";
+import { syncDirectory } from "./filesystem-path-guard.js";
+import { assertTerminalEvidenceDirectory, ensureTerminalEvidenceDirectory } from "../../../repository-mutation/adapters/node/node-terminal-evidence-directory.js";
+import { createPrivateScaffoldJournalEvidencePath, observeScaffoldJournalAuthority, readStoredScaffoldJournal, scaffoldJournalAuthority, scaffoldJournalRecoveryRequired, scaffoldJournalResidueNames, scaffoldQuarantinePrefix, scaffoldRetiredPrefix, serializeScaffoldJournal } from "./node-scaffold-journal-evidence.js";
+import { classifyCleanScaffoldJournalMutation, sameScaffoldJournalAuthority } from "./node-scaffold-journal-reconciliation.js";
+export class NodeScaffoldJournalStore {
+    #candidatePath;
+    #parent;
+    #path;
+    #operations;
+    #pending;
+    constructor(consumerRoot, operations = {}) {
+        this.#parent = join(consumerRoot, LOCAL_STATE_DIRECTORY);
+        this.#path = join(this.#parent, FOUNDATION_TRANSACTION_FILE);
+        this.#candidatePath = join(this.#parent, FOUNDATION_TRANSACTION_TEMPORARY_FILE);
+        this.#operations = {
+            ...operations,
+            syncDirectoryStrictly: operations.syncDirectoryStrictly ?? syncDirectory
+        };
+    }
+    async read() {
+        if (this.#pending !== undefined) {
+            throw scaffoldJournalRecoveryRequired("Scaffolding journal mutation must be stabilized before another read.");
+        }
+        const residues = await scaffoldJournalResidueNames(this.#parent);
+        if (residues.length !== 0) {
+            throw scaffoldJournalRecoveryRequired("Incomplete scaffolding journal transition evidence requires reconciliation.");
+        }
+        return readStoredScaffoldJournal(this.#path);
+    }
+    async stabilizeForReconciliation() {
+        await this.#operations.faultInjector?.({
+            phase: "before-reconciliation-directory-sync"
+        });
+        await this.#operations.syncDirectoryStrictly?.(this.#parent);
+        const observedResidues = await scaffoldJournalResidueNames(this.#parent);
+        const canonical = await readStoredScaffoldJournal(this.#path);
+        if (observedResidues.length !== 0) {
+            return {
+                ...(canonical === undefined ? {} : { canonical }),
+                outcome: "recovery-required",
+                residueNames: observedResidues
+            };
+        }
+        const pending = this.#pending;
+        if (pending === undefined) {
+            return {
+                outcome: "stable",
+                ...(canonical === undefined ? {} : { stored: canonical })
+            };
+        }
+        const outcome = classifyCleanScaffoldJournalMutation(pending, canonical);
+        if (outcome === "recovery-required") {
+            return {
+                ...(canonical === undefined ? {} : { canonical }),
+                outcome,
+                residueNames: []
+            };
+        }
+        this.#pending = undefined;
+        return {
+            outcome,
+            ...(canonical === undefined ? {} : { stored: canonical })
+        };
+    }
+    create(journal) {
+        return this.#mutate("create", undefined, journal);
+    }
+    replace(expected, journal) {
+        return this.#mutate("replace", expected, journal);
+    }
+    async remove(expected) {
+        if (this.#pending !== undefined) {
+            throw scaffoldJournalRecoveryRequired("Scaffolding journal mutation must be stabilized before removal.");
+        }
+        const residues = await scaffoldJournalResidueNames(this.#parent);
+        if (residues.length !== 0) {
+            throw scaffoldJournalRecoveryRequired("Scaffolding journal transition evidence must be reconciled before removal.");
+        }
+        const prior = await this.#requireStored(this.#path, expected, "Canonical scaffolding journal");
+        this.#pending = { kind: "remove", prior };
+        await this.#operations.faultInjector?.({
+            mutation: "remove",
+            phase: "before-shared-quarantine"
+        });
+        await this.#prove(this.#path, expected, "Canonical scaffolding journal");
+        const quarantine = await createPrivateScaffoldJournalEvidencePath(this.#parent, scaffoldQuarantinePrefix);
+        await this.#prove(this.#path, expected, "Canonical scaffolding journal");
+        await rename(this.#path, quarantine.path);
+        await this.#syncRenameBoundary(quarantine.directory, this.#parent, "remove");
+        await this.#prove(quarantine.path, expected, "Quarantined scaffolding journal");
+        await this.#operations.faultInjector?.({
+            mutation: "remove",
+            phase: "after-shared-quarantine-synced"
+        });
+        await this.#retire(quarantine.path, quarantine.directory, expected, "remove", "previous");
+        await this.#proveMissing(this.#path, "Canonical scaffolding journal");
+        await this.#operations.faultInjector?.({
+            mutation: "remove",
+            phase: "before-final-directory-sync"
+        });
+        await this.#proveMissing(this.#path, "Canonical scaffolding journal");
+        await this.#syncDirectory(this.#parent, "remove", "state-parent");
+        await this.#proveMissing(this.#path, "Canonical scaffolding journal");
+        this.#pending = undefined;
+    }
+    async #mutate(mutation, expected, journal) {
+        if (this.#pending !== undefined) {
+            throw scaffoldJournalRecoveryRequired("Scaffolding journal mutation must be stabilized before another mutation.");
+        }
+        const residues = await scaffoldJournalResidueNames(this.#parent);
+        if (residues.length !== 0) {
+            throw scaffoldJournalRecoveryRequired("Scaffolding journal transition evidence must be reconciled before mutation.");
+        }
+        const bytes = await serializeScaffoldJournal(journal);
+        if (expected === undefined &&
+            (await readStoredScaffoldJournal(this.#path)) !== undefined) {
+            throw scaffoldJournalRecoveryRequired("Canonical scaffolding journal slot is already occupied; it was preserved.");
+        }
+        const prior = expected === undefined
+            ? undefined
+            : await this.#requireStored(this.#path, expected, "Canonical scaffolding journal");
+        this.#pending = expected === undefined
+            ? { kind: "create" }
+            : { kind: "replace", prior: prior };
+        const candidate = await this.#prepareCandidate(bytes, mutation);
+        this.#pending.intendedAuthority = candidate;
+        let previous;
+        if (expected !== undefined) {
+            await this.#operations.faultInjector?.({
+                mutation: "replace",
+                phase: "before-shared-quarantine"
+            });
+            await this.#prove(this.#path, expected, "Canonical scaffolding journal");
+            const evidence = await createPrivateScaffoldJournalEvidencePath(this.#parent, scaffoldQuarantinePrefix);
+            await this.#prove(this.#path, expected, "Canonical scaffolding journal");
+            await rename(this.#path, evidence.path);
+            await this.#syncRenameBoundary(evidence.directory, this.#parent, "replace");
+            await this.#prove(evidence.path, expected, "Quarantined scaffolding journal");
+            previous = { authority: expected, ...evidence };
+            await this.#operations.faultInjector?.({
+                mutation: "replace",
+                phase: "after-shared-quarantine-synced"
+            });
+        }
+        await this.#operations.faultInjector?.({
+            mutation,
+            phase: "before-canonical-link"
+        });
+        await this.#prove(this.#candidatePath, candidate, "Scaffolding journal temporary");
+        try {
+            await link(this.#candidatePath, this.#path);
+        }
+        catch (error) {
+            throw scaffoldJournalRecoveryRequired("Canonical scaffolding journal slot is occupied; all evidence was preserved.", error);
+        }
+        await this.#prove(this.#path, candidate, "Canonical scaffolding journal");
+        await this.#operations.faultInjector?.({
+            mutation,
+            phase: "after-canonical-linked"
+        });
+        await this.#syncDirectory(this.#parent, mutation, "state-parent");
+        await this.#operations.faultInjector?.({
+            mutation,
+            phase: "after-canonical-synced"
+        });
+        await this.#retire(this.#candidatePath, this.#parent, candidate, mutation, "candidate");
+        if (previous !== undefined) {
+            await this.#retire(previous.path, previous.directory, previous.authority, mutation, "previous");
+        }
+        await this.#prove(this.#path, candidate, "Canonical scaffolding journal");
+        await this.#operations.faultInjector?.({
+            mutation,
+            phase: "before-final-directory-sync"
+        });
+        await this.#prove(this.#path, candidate, "Canonical scaffolding journal");
+        await this.#syncDirectory(this.#parent, mutation, "state-parent");
+        await this.#prove(this.#path, candidate, "Canonical scaffolding journal");
+        this.#pending = undefined;
+        return candidate;
+    }
+    async #prepareCandidate(bytes, mutation) {
+        let handle;
+        try {
+            handle = await open(this.#candidatePath, "wx", 0o600);
+        }
+        catch (error) {
+            throw scaffoldJournalRecoveryRequired(error instanceof Error && "code" in error &&
+                error.code === "EEXIST"
+                ? "Scaffolding journal temporary already exists and was preserved."
+                : "Scaffolding journal temporary could not be created safely.", error);
+        }
+        let candidate;
+        try {
+            await handle.writeFile(bytes);
+            await handle.sync();
+            candidate = scaffoldJournalAuthority(await captureFileHandleIdentity(handle), bytes);
+        }
+        finally {
+            await handle.close();
+        }
+        await this.#prove(this.#candidatePath, candidate, "Scaffolding journal temporary");
+        await this.#syncDirectory(this.#parent, mutation, "state-parent");
+        await this.#operations.faultInjector?.({
+            mutation,
+            phase: "after-candidate-synced"
+        });
+        await this.#prove(this.#candidatePath, candidate, "Scaffolding journal temporary");
+        return candidate;
+    }
+    async #prove(path, expected, description) {
+        if ((await observeScaffoldJournalAuthority(path, expected)) !== "match") {
+            throw scaffoldJournalRecoveryRequired(`${description} identity or bytes changed; all evidence was preserved.`);
+        }
+    }
+    async #requireStored(path, expected, description) {
+        const stored = await readStoredScaffoldJournal(path);
+        if (stored === undefined ||
+            !sameScaffoldJournalAuthority(stored.authority, expected)) {
+            throw scaffoldJournalRecoveryRequired(`${description} identity or bytes changed; all evidence was preserved.`);
+        }
+        return stored;
+    }
+    async #proveMissing(path, description) {
+        if ((await readStoredScaffoldJournal(path)) !== undefined) {
+            throw scaffoldJournalRecoveryRequired(`${description} was recreated concurrently; all evidence was preserved.`);
+        }
+    }
+    async #retire(path, sourceDirectory, expected, mutation, evidence) {
+        await this.#prove(path, expected, "Scaffolding journal evidence");
+        const retired = await createPrivateScaffoldJournalEvidencePath(this.#parent, scaffoldRetiredPrefix);
+        await this.#operations.faultInjector?.({
+            evidence,
+            mutation,
+            phase: "before-private-retirement"
+        });
+        await this.#operations.faultInjector?.({
+            evidence,
+            mutation,
+            phase: "before-private-retirement-rename"
+        });
+        await this.#prove(path, expected, "Scaffolding journal evidence");
+        await rename(path, retired.path);
+        await this.#syncRenameBoundary(retired.directory, sourceDirectory, mutation);
+        await this.#prove(retired.path, expected, "Retired scaffolding journal evidence");
+        await this.#operations.faultInjector?.({
+            evidence,
+            mutation,
+            phase: "before-logical-retirement"
+        });
+        await this.#prove(retired.path, expected, "Retired scaffolding journal evidence");
+        const terminalRoot = join(this.#parent, `${FOUNDATION_TRANSACTION_FILE}.completed-scaffold-evidence`);
+        const terminalAuthority = await ensureTerminalEvidenceDirectory(terminalRoot);
+        await this.#syncDirectory(this.#parent, mutation, "state-parent");
+        const terminalDirectory = join(terminalRoot, basename(retired.directory));
+        await assertTerminalEvidenceDirectory(terminalAuthority);
+        await rename(retired.directory, terminalDirectory);
+        await this.#syncDirectory(terminalRoot, mutation, "destination");
+        if (sourceDirectory !== this.#parent) {
+            await assertTerminalEvidenceDirectory(terminalAuthority);
+            await rename(sourceDirectory, join(terminalRoot, `${basename(sourceDirectory)}.empty`));
+            await this.#syncDirectory(terminalRoot, mutation, "destination");
+        }
+        await this.#syncDirectory(this.#parent, mutation, "state-parent");
+    }
+    async #syncDirectory(path, mutation, role) {
+        await this.#operations.faultInjector?.({
+            mutation,
+            path,
+            phase: "before-directory-sync",
+            role
+        });
+        await this.#operations.syncDirectoryStrictly?.(path);
+    }
+    async #syncRenameBoundary(destination, source, mutation) {
+        await this.#syncDirectory(destination, mutation, "destination");
+        if (source !== destination) {
+            await this.#syncDirectory(source, mutation, "source");
+        }
+        if (this.#parent !== destination && this.#parent !== source) {
+            await this.#syncDirectory(this.#parent, mutation, "state-parent");
+        }
+    }
+}
+//# sourceMappingURL=node-scaffold-journal-store.js.map

package/dist/scaffolding/adapters/node/node-scaffold-journal-store.js.map

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

package/dist/scaffolding/adapters/node/node-scaffold-journal-transaction-evidence.d.ts

@@ -0,0 +1,2 @@
+export declare function scaffoldTransactionEvidenceExists(journalPath: string): Promise<boolean>;
+//# sourceMappingURL=node-scaffold-journal-transaction-evidence.d.ts.map

package/dist/scaffolding/adapters/node/node-scaffold-journal-transaction-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-scaffold-journal-transaction-evidence.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-scaffold-journal-transaction-evidence.ts"],"names":[],"mappings":"AAwBA,wBAAsB,iCAAiC,CACrD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/scaffolding/adapters/node/node-scaffold-journal-transaction-evidence.js

@@ -0,0 +1,34 @@
+import { lstat, readdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { FOUNDATION_TRANSACTION_CLEANUP_RESIDUE_PREFIX } from "../../../foundation-state-contract.js";
+import { SCAFFOLD_JOURNAL_QUARANTINE_PREFIX } from "./filesystem-journal.js";
+import { scaffoldQuarantinePrefix, scaffoldRetiredPrefix } from "./node-scaffold-journal-evidence.js";
+async function pathEntryExists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error &&
+            error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function scaffoldTransactionEvidenceExists(journalPath) {
+    let entries;
+    try {
+        entries = await readdir(dirname(journalPath));
+    }
+    catch {
+        return true;
+    }
+    return (await pathEntryExists(journalPath)) ||
+        (await pathEntryExists(`${journalPath}.tmp`)) ||
+        entries.some((entry) => entry.startsWith(SCAFFOLD_JOURNAL_QUARANTINE_PREFIX) ||
+            entry.startsWith(scaffoldQuarantinePrefix) ||
+            entry.startsWith(scaffoldRetiredPrefix) ||
+            entry.startsWith(FOUNDATION_TRANSACTION_CLEANUP_RESIDUE_PREFIX));
+}
+//# sourceMappingURL=node-scaffold-journal-transaction-evidence.js.map

package/dist/scaffolding/adapters/node/node-scaffold-journal-transaction-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-scaffold-journal-transaction-evidence.js","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-scaffold-journal-transaction-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,6CAA6C,EAAE,MAAM,uCAAuC,CAAC;AAEtG,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,qCAAqC,CAAC;AAE7C,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK;YAC1C,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,WAAmB;IAEnB,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC,MAAM,eAAe,CAAC,GAAG,WAAW,MAAM,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,kCAAkC,CAAC;YAC1E,KAAK,CAAC,UAAU,CAAC,wBAAwB,CAAC;YAC1C,KAAK,CAAC,UAAU,CAAC,qBAAqB,CAAC;YACvC,KAAK,CAAC,UAAU,CAAC,6CAA6C,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/schema-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-catalog.d.ts","sourceRoot":"","sources":["../src/schema-catalog.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACxB,MAAM,iBAAiB,CAAC;AA0BzB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAE/E;AAUD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAEjB;AAwDD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAUf"}
+{"version":3,"file":"schema-catalog.d.ts","sourceRoot":"","sources":["../src/schema-catalog.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACxB,MAAM,iBAAiB,CAAC;AA8BzB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAE/E;AAUD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAEjB;AAwDD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/schema-catalog.js

@@ -23,6 +23,10 @@ const SCHEMA_DEPENDENCIES = {
         "scaffold-plan/v1",
         "scaffold-recovery-journal/v1"
     ],
+    "foundation-transaction-envelope/v3": [
+        "document-intent/v1",
+        "document-plan/v1"
+    ],
     "scaffold-recovery-journal/v1": ["scaffold-plan/v1"]
 };
 export function isFoundationSchemaId(value) {

package/dist/schema-catalog.js.map

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

package/dist/schema-ids.d.ts

@@ -1,4 +1,4 @@
-export declare const FOUNDATION_SCHEMA_IDS: readonly ["architecture-source-dependencies/v1", "contract-json-schema-release-baseline/v1", "contract-json-schema-releases/v1", "contract-protobuf-breaking-qualification/v1", "contract-protobuf-evolution-baseline/v1", "contract-protobuf-evolution/v1", "document-authoring-profile/v1", "document-command-envelope/v1", "document-intent/v1", "document-plan/v1", "document-receipt/v1", "documentation-local-references/v1", "foundation-config/v1", "foundation-check-report/v1", "foundation-transaction-envelope/v2", "governance-architecture-decision-baseline/v1", "governance-architecture-decisions/v1", "package-public-api-baseline/v1", "package-public-api-compatibility/v1", "quality-executable-specification-catalog/v1", "quality-executable-specifications/v1", "quality-suppression-governance/v1", "repository-agent-workflow/v1", "repository-security-baseline/v1", "scaffold-authority-evidence/v1", "scaffold-intent/v1", "scaffold-plan/v1", "scaffold-receipt/v1", "scaffold-recovery-journal/v1", "scaffold-target-catalog/v1", "scaffolding-config/v1", "workspace-dependency-declarations/v1"];
+export declare const FOUNDATION_SCHEMA_IDS: readonly ["architecture-source-dependencies/v1", "contract-json-schema-release-baseline/v1", "contract-json-schema-releases/v1", "contract-protobuf-breaking-qualification/v1", "contract-protobuf-evolution-baseline/v1", "contract-protobuf-evolution/v1", "document-authoring-profile/v1", "document-command-envelope/v1", "document-command-envelope/v2", "document-intent/v1", "document-plan/v1", "document-receipt/v1", "documentation-local-references/v1", "foundation-command-error/v1", "foundation-config/v1", "foundation-check-report/v1", "foundation-transaction-envelope/v2", "foundation-transaction-envelope/v3", "governance-architecture-decision-baseline/v1", "governance-architecture-decisions/v1", "package-public-api-baseline/v1", "package-public-api-compatibility/v1", "quality-executable-specification-catalog/v1", "quality-executable-specifications/v1", "quality-suppression-governance/v1", "repository-agent-workflow/v1", "repository-security-baseline/v1", "scaffold-authority-evidence/v1", "scaffold-intent/v1", "scaffold-plan/v1", "scaffold-receipt/v1", "scaffold-recovery-journal/v1", "scaffold-target-catalog/v1", "scaffolding-config/v1", "workspace-dependency-declarations/v1"];
 export type FoundationSchemaId = (typeof FOUNDATION_SCHEMA_IDS)[number];
 export type FoundationSchemaCatalogId = FoundationSchemaId;
 //# sourceMappingURL=schema-ids.d.ts.map

package/dist/schema-ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-ids.d.ts","sourceRoot":"","sources":["../src/schema-ids.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,YAChC,qCAAqC,EACrC,0CAA0C,EAC1C,kCAAkC,EAClC,6CAA6C,EAC7C,yCAAyC,EACzC,gCAAgC,EAChC,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,mCAAmC,EACnC,sBAAsB,EACtB,4BAA4B,EAC5B,oCAAoC,EACpC,8CAA8C,EAC9C,sCAAsC,EACtC,gCAAgC,EAChC,qCAAqC,EACrC,6CAA6C,EAC7C,sCAAsC,EACtC,mCAAmC,EACnC,8BAA8B,EAC9B,iCAAiC,EACjC,gCAAgC,EAChC,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,EAC9B,4BAA4B,EAC5B,uBAAuB,EACvB,sCAAsC,CAC9B,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC"}
+{"version":3,"file":"schema-ids.d.ts","sourceRoot":"","sources":["../src/schema-ids.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,YAChC,qCAAqC,EACrC,0CAA0C,EAC1C,kCAAkC,EAClC,6CAA6C,EAC7C,yCAAyC,EACzC,gCAAgC,EAChC,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,EAC9B,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,mCAAmC,EACnC,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,EAC5B,oCAAoC,EACpC,oCAAoC,EACpC,8CAA8C,EAC9C,sCAAsC,EACtC,gCAAgC,EAChC,qCAAqC,EACrC,6CAA6C,EAC7C,sCAAsC,EACtC,mCAAmC,EACnC,8BAA8B,EAC9B,iCAAiC,EACjC,gCAAgC,EAChC,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,EAC9B,4BAA4B,EAC5B,uBAAuB,EACvB,sCAAsC,CAC9B,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC"}

package/dist/schema-ids.js

@@ -7,13 +7,16 @@ export const FOUNDATION_SCHEMA_IDS = [
     "contract-protobuf-evolution/v1",
     "document-authoring-profile/v1",
     "document-command-envelope/v1",
+    "document-command-envelope/v2",
     "document-intent/v1",
     "document-plan/v1",
     "document-receipt/v1",
     "documentation-local-references/v1",
+    "foundation-command-error/v1",
     "foundation-config/v1",
     "foundation-check-report/v1",
     "foundation-transaction-envelope/v2",
+    "foundation-transaction-envelope/v3",
     "governance-architecture-decision-baseline/v1",
     "governance-architecture-decisions/v1",
     "package-public-api-baseline/v1",

package/dist/schema-ids.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-ids.js","sourceRoot":"","sources":["../src/schema-ids.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,qCAAqC;IACrC,0CAA0C;IAC1C,kCAAkC;IAClC,6CAA6C;IAC7C,yCAAyC;IACzC,gCAAgC;IAChC,+BAA+B;IAC/B,8BAA8B;IAC9B,oBAAoB;IACpB,kBAAkB;IAClB,qBAAqB;IACrB,mCAAmC;IACnC,sBAAsB;IACtB,4BAA4B;IAC5B,oCAAoC;IACpC,8CAA8C;IAC9C,sCAAsC;IACtC,gCAAgC;IAChC,qCAAqC;IACrC,6CAA6C;IAC7C,sCAAsC;IACtC,mCAAmC;IACnC,8BAA8B;IAC9B,iCAAiC;IACjC,gCAAgC;IAChC,oBAAoB;IACpB,kBAAkB;IAClB,qBAAqB;IACrB,8BAA8B;IAC9B,4BAA4B;IAC5B,uBAAuB;IACvB,sCAAsC;CAC9B,CAAC"}
+{"version":3,"file":"schema-ids.js","sourceRoot":"","sources":["../src/schema-ids.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,qCAAqC;IACrC,0CAA0C;IAC1C,kCAAkC;IAClC,6CAA6C;IAC7C,yCAAyC;IACzC,gCAAgC;IAChC,+BAA+B;IAC/B,8BAA8B;IAC9B,8BAA8B;IAC9B,oBAAoB;IACpB,kBAAkB;IAClB,qBAAqB;IACrB,mCAAmC;IACnC,6BAA6B;IAC7B,sBAAsB;IACtB,4BAA4B;IAC5B,oCAAoC;IACpC,oCAAoC;IACpC,8CAA8C;IAC9C,sCAAsC;IACtC,gCAAgC;IAChC,qCAAqC;IACrC,6CAA6C;IAC7C,sCAAsC;IACtC,mCAAmC;IACnC,8BAA8B;IAC9B,iCAAiC;IACjC,gCAAgC;IAChC,oBAAoB;IACpB,kBAAkB;IAClB,qBAAqB;IACrB,8BAA8B;IAC9B,4BAA4B;IAC5B,uBAAuB;IACvB,sCAAsC;CAC9B,CAAC"}

package/dist/source-inventory/adapters/outbound/filesystem/filesystem-source-tree-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-source-tree-reader.d.ts","sourceRoot":"","sources":["../../../../../src/source-inventory/adapters/outbound/filesystem/filesystem-source-tree-reader.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAC7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAsMzF,qBAAa,0BAA2B,YAAW,gBAAgB;IAC3D,IAAI,CACR,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAcxC;CACF"}
+{"version":3,"file":"filesystem-source-tree-reader.d.ts","sourceRoot":"","sources":["../../../../../src/source-inventory/adapters/outbound/filesystem/filesystem-source-tree-reader.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAC7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AA0MzF,qBAAa,0BAA2B,YAAW,gBAAgB;IAC3D,IAAI,CACR,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAcxC;CACF"}

package/dist/source-inventory/adapters/outbound/filesystem/filesystem-source-tree-reader.js

@@ -1,7 +1,7 @@
-import { lstat, opendir, readFile, realpath, stat } from "node:fs/promises";
+import { opendir, realpath, stat } from "node:fs/promises";
 import { isAbsolute, join, posix, relative, resolve, sep } from "node:path";
 import { CapabilityInputError } from "../../../../capability-runtime.js";
-import { pathTraversesSymbolicLink } from "../../../../filesystem-path-safety.js";
+import { ContainedFileReadError, pathTraversesSymbolicLink, readContainedRegularFile } from "../../../../filesystem-path-safety.js";
 import { assertNotCancelled, assertRepositoryRelativePath } from "../../../../strict-yaml.js";
 const SOURCE_EXTENSIONS = new Set([
     ".cjs",
@@ -105,18 +105,25 @@ async function readSourceFiles(canonicalRoot, paths, signal) {
     for (let index = 0; index < paths.length; index += READ_CONCURRENCY) {
         const loaded = await Promise.all(paths.slice(index, index + READ_CONCURRENCY).map(async (path) => {
             assertNotCancelled(signal);
-            const absolutePath = resolve(canonicalRoot, path);
-            const metadata = await lstat(absolutePath);
-            if (!metadata.isFile() ||
-                metadata.isSymbolicLink() ||
-                metadata.size > MAX_SOURCE_FILE_BYTES) {
-                inputError("SOURCE_FILE_INVALID", `Source must be a regular file no larger than ${MAX_SOURCE_FILE_BYTES} bytes: ${path}.`, "source-read");
+            let bytes;
+            try {
+                bytes = await readContainedRegularFile({
+                    candidate: resolve(canonicalRoot, path),
+                    maxBytes: MAX_SOURCE_FILE_BYTES,
+                    root: canonicalRoot
+                });
             }
-            const source = await readFile(absolutePath, "utf8");
+            catch (error) {
+                if (error instanceof ContainedFileReadError) {
+                    inputError("SOURCE_FILE_INVALID", `Source changed, escaped containment, or is not one stable regular file: ${path}.`, "source-read");
+                }
+                throw error;
+            }
+            const source = bytes.toString("utf8");
             if (source.includes("\0")) {
                 inputError("SOURCE_FILE_INVALID", `Source file contains prohibited NUL bytes: ${path}.`, "source-read");
             }
-            return { path, source, bytes: metadata.size };
+            return { path, source, bytes: bytes.byteLength };
         }));
         for (const file of loaded) {
             totalBytes += file.bytes;

package/dist/source-inventory/adapters/outbound/filesystem/filesystem-source-tree-reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-source-tree-reader.js","sourceRoot":"","sources":["../../../../../src/source-inventory/adapters/outbound/filesystem/filesystem-source-tree-reader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"filesystem-source-tree-reader.js","sourceRoot":"","sources":["../../../../../src/source-inventory/adapters/outbound/filesystem/filesystem-source-tree-reader.ts"],"names":[],"mappings":"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"}

package/dist/transaction-coordination/adapters/node/document-envelope-bindings.d.ts

@@ -0,0 +1,22 @@
+import type { InternalFoundationTransactionStatus } from "../../application/model/internal-transaction-status.js";
+export declare function inspectDocumentTransactionBindings(options: {
+    readonly foundation: Record<string, unknown>;
+    readonly format?: "envelope-v2" | "envelope-v3";
+    readonly journal: Record<string, unknown>;
+    readonly journalVersion: 1 | 2;
+    readonly legacyDigestSemantics?: boolean;
+    readonly plan: Record<string, unknown>;
+    readonly state: unknown;
+}): InternalFoundationTransactionStatus | undefined;
+export declare function inspectCurrentDocumentEnvelope(options: {
+    readonly value: Record<string, unknown>;
+    readonly installedVersion: string;
+    readonly installedBuildIdentity: string;
+    readonly pending: (identity: {
+        readonly foundationVersion: string;
+        readonly foundationBuildIdentity: string;
+        readonly installedVersion: string;
+        readonly installedBuildIdentity: string;
+    }) => InternalFoundationTransactionStatus;
+}): Promise<InternalFoundationTransactionStatus>;
+//# sourceMappingURL=document-envelope-bindings.d.ts.map

package/dist/transaction-coordination/adapters/node/document-envelope-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-envelope-bindings.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/document-envelope-bindings.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,wDAAwD,CAAC;AAoGlH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC;IAC/B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,GAAG,mCAAmC,GAAG,SAAS,CAiBlD;AAED,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;QACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;KACzC,KAAK,mCAAmC,CAAC;CAC3C,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAsC/C"}