@agent-teams/engineering-foundation 0.7.0 → 0.8.0

package/dist/scaffolding/adapters/node/filesystem-finalization.js

@@ -0,0 +1,169 @@
+import { createAuthorityScaffoldReceipt } from "../../kernel/authority-receipt.js";
+import { recoveryRequiredForAuthority, resolveAuthority, safeClassifyPlan } from "./filesystem-authority.js";
+import { createAuthorityDiagnostic, freshAuthorityScaffoldJournal, replaceScaffoldJournalOperation, receiptFromJournalStates } from "./filesystem-journal-state.js";
+import { captureExpectedAuthorityScaffoldJournal, removeExpectedAuthorityScaffoldJournal, writeAuthorityScaffoldJournal } from "./filesystem-journal.js";
+import { assessScaffoldPlanAuthority } from "./node-plan-authority.js";
+export function staleBeforeJournal(plan) {
+    return createAuthorityScaffoldReceipt({
+        plan,
+        outcome: "authority-stale",
+        commitState: "rolled-back",
+        operations: plan.operations.map((operation) => ({
+            operationId: operation.id,
+            path: operation.path,
+            outcome: "not-applied"
+        })),
+        diagnostics: [
+            createAuthorityDiagnostic("scaffolding.authority.stale", "apply", plan.projectId, "Consumer authority changed after planning.", "Compile a new Plan from the current consumer authority.")
+        ]
+    });
+}
+function authorityUnverifiableBeforeJournal(plan) {
+    return recoveryRequiredForAuthority({
+        plan,
+        phase: "apply",
+        ruleId: "scaffolding.authority.unverifiable",
+        message: "Authority cannot be re-verified safely; no output was created.",
+        remediation: "Restore readable authority sources, then compile a new Plan."
+    });
+}
+async function classifyBeforeJournal(options) {
+    let states;
+    try {
+        states = await safeClassifyPlan(options.root, options.plan);
+    }
+    catch {
+        return recoveryRequiredForAuthority({
+            plan: options.plan,
+            phase: "apply",
+            ruleId: "scaffolding.apply.unverifiable-workspace",
+            message: "The workspace cannot be safely verified before commit.",
+            remediation: "Resolve the filesystem state manually, then compile a new Plan."
+        });
+    }
+    if (states.every(({ state }) => state === "after")) {
+        return states;
+    }
+    let journal = freshAuthorityScaffoldJournal(options.plan);
+    for (const { operation, state } of states) {
+        if (state === "after") {
+            journal = replaceScaffoldJournalOperation(journal, operation.id, "preexisting");
+        }
+    }
+    return receiptFromJournalStates({
+        plan: options.plan,
+        journal,
+        outcome: "rejected",
+        phase: "apply",
+        conflictOperationIds: new Set(states
+            .filter(({ state }) => state === "conflict")
+            .map(({ operation }) => operation.id))
+    });
+}
+export async function verifyAlreadyAppliedScaffold(options) {
+    await options.faultInjector?.({ phase: "before-final-authority-recheck" });
+    for (let pass = 0; pass < 2; pass += 1) {
+        const authority = await assessScaffoldPlanAuthority(options.root, options.plan);
+        if (authority.state === "stale") {
+            return staleBeforeJournal(options.plan);
+        }
+        if (authority.state === "unverifiable") {
+            return authorityUnverifiableBeforeJournal(options.plan);
+        }
+        const states = await classifyBeforeJournal(options);
+        if (isReceipt(states)) {
+            return states;
+        }
+    }
+    await options.faultInjector?.({ phase: "after-final-verification" });
+    return createAuthorityScaffoldReceipt({
+        plan: options.plan,
+        outcome: "already-applied",
+        commitState: "committed",
+        operations: options.plan.operations.map((operation) => ({
+            operationId: operation.id,
+            path: operation.path,
+            outcome: "already-satisfied",
+            resultDigest: operation.after.digest
+        }))
+    });
+}
+function isReceipt(value) {
+    return typeof value === "object" && value !== null && "receiptDigest" in value;
+}
+async function verifyOutputs(options) {
+    let states;
+    try {
+        states = await safeClassifyPlan(options.root, options.journal.plan);
+    }
+    catch {
+        return recoveryRequiredForAuthority({
+            plan: options.journal.plan,
+            phase: options.recovered ? "recovery" : "apply",
+            ruleId: "scaffolding.recovery.unverifiable-workspace",
+            message: "The workspace cannot be safely verified after publication.",
+            remediation: "Resolve the filesystem state manually, then retry recovery."
+        });
+    }
+    const conflictIds = new Set(states
+        .filter(({ state }) => state !== "after")
+        .map(({ operation }) => operation.id));
+    if (conflictIds.size === 0) {
+        return states;
+    }
+    await writeAuthorityScaffoldJournal(options.journalPath, options.journal);
+    return receiptFromJournalStates({
+        plan: options.journal.plan,
+        journal: options.journal,
+        outcome: "recovery-required",
+        phase: "recovery",
+        conflictOperationIds: conflictIds
+    });
+}
+function observedOperations(states) {
+    return states.map(({ operation }) => ({
+        operationId: operation.id,
+        path: operation.path,
+        outcome: "already-satisfied",
+        resultDigest: operation.after.digest
+    }));
+}
+export async function finalizeAuthorityScaffoldJournal(options) {
+    await options.faultInjector?.({ phase: "before-final-authority-recheck" });
+    const firstAuthority = await resolveAuthority(options);
+    if (firstAuthority !== undefined) {
+        return firstAuthority;
+    }
+    const firstStates = await verifyOutputs(options);
+    if (isReceipt(firstStates)) {
+        return firstStates;
+    }
+    const finalAuthority = await resolveAuthority({
+        ...options,
+        observedOperations: observedOperations(firstStates)
+    });
+    if (finalAuthority !== undefined) {
+        return finalAuthority;
+    }
+    const finalStates = await verifyOutputs(options);
+    if (isReceipt(finalStates)) {
+        return finalStates;
+    }
+    const journalIdentity = await captureExpectedAuthorityScaffoldJournal(options.journalPath, options.journal);
+    await options.faultInjector?.({ phase: "after-final-verification" });
+    await removeExpectedAuthorityScaffoldJournal(options.journalPath, journalIdentity, options.faultInjector === undefined
+        ? undefined
+        : () => options.faultInjector?.({ phase: "after-journal-unlinked" }));
+    return createAuthorityScaffoldReceipt({
+        plan: options.journal.plan,
+        outcome: options.recovered ? "failed-recovered" : "applied",
+        commitState: options.recovered ? "recovered" : "committed",
+        operations: options.journal.plan.operations.map((operation) => options.receipts.get(operation.id) ?? {
+            operationId: operation.id,
+            path: operation.path,
+            outcome: "already-satisfied",
+            resultDigest: operation.after.digest
+        })
+    });
+}
+//# sourceMappingURL=filesystem-finalization.js.map

package/dist/scaffolding/adapters/node/filesystem-finalization.js.map

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

package/dist/scaffolding/adapters/node/filesystem-journal-state.d.ts

@@ -0,0 +1,25 @@
+import type { ScaffoldDiagnosticV1, AuthorityScaffoldJournalOperation, AuthorityScaffoldJournal, AuthorityScaffoldOperationReceipt, AuthorityScaffoldPlan, AuthorityScaffoldReceipt } from "../../contract/types.js";
+export declare function createAuthorityDiagnostic(ruleId: string, phase: ScaffoldDiagnosticV1["phase"], subject: string, message: string, remediation: string): ScaffoldDiagnosticV1;
+export declare function receiptFromJournalStates(options: {
+    readonly plan: AuthorityScaffoldPlan;
+    readonly journal: AuthorityScaffoldJournal;
+    readonly outcome: "recovery-required" | "rejected";
+    readonly phase: "apply" | "recovery";
+    readonly conflictOperationIds: ReadonlySet<string>;
+}): AuthorityScaffoldReceipt;
+export declare function createRecoveryRequiredReceipt(options: {
+    readonly plan: AuthorityScaffoldPlan;
+    readonly phase: "apply" | "recovery";
+    readonly ruleId: string;
+    readonly subject: string;
+    readonly message: string;
+    readonly remediation: string;
+    readonly operations?: readonly AuthorityScaffoldOperationReceipt[];
+}): AuthorityScaffoldReceipt;
+export declare function freshAuthorityScaffoldJournal(plan: AuthorityScaffoldPlan): AuthorityScaffoldJournal;
+export declare function replaceScaffoldJournalOperation(journal: AuthorityScaffoldJournal, operationId: string, state: AuthorityScaffoldJournalOperation["state"]): AuthorityScaffoldJournal;
+export declare function reconcileAuthorityScaffoldJournal(root: string, journal: AuthorityScaffoldJournal): Promise<{
+    readonly journal: AuthorityScaffoldJournal;
+    readonly conflictIds: ReadonlySet<string>;
+}>;
+//# sourceMappingURL=filesystem-journal-state.d.ts.map

package/dist/scaffolding/adapters/node/filesystem-journal-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-journal-state.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-journal-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,iCAAiC,EACjC,wBAAwB,EACxB,iCAAiC,EACjC,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AAKjC,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,EACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,oBAAoB,CAStB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,UAAU,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpD,GAAG,wBAAwB,CA6C3B;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,iCAAiC,EAAE,CAAC;CACpE,GAAG,wBAAwB,CAsB3B;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,qBAAqB,GAAG,wBAAwB,CAenG;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,wBAAwB,EACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,iCAAiC,CAAC,OAAO,CAAC,GAChD,wBAAwB,CAW1B;AAED,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC;IACT,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC3C,CAAC,CAwCD"}

package/dist/scaffolding/adapters/node/filesystem-journal-state.js

@@ -0,0 +1,119 @@
+import { createAuthorityScaffoldReceipt } from "../../kernel/authority-receipt.js";
+import { assertSafeExistingAncestors } from "./filesystem-path-guard.js";
+import { classifyFilesystemOperation } from "./filesystem-operation-state.js";
+export function createAuthorityDiagnostic(ruleId, phase, subject, message, remediation) {
+    return Object.freeze({
+        ruleId,
+        severity: "error",
+        phase,
+        subject,
+        message,
+        remediation
+    });
+}
+export function receiptFromJournalStates(options) {
+    return createAuthorityScaffoldReceipt({
+        plan: options.plan,
+        outcome: options.outcome,
+        commitState: options.outcome === "recovery-required" ? "recovery-required" : "rejected",
+        operations: options.plan.operations.map((operation) => {
+            const journalOperation = options.journal.operations.find((candidate) => candidate.operationId === operation.id);
+            if (options.conflictOperationIds.has(operation.id)) {
+                return { operationId: operation.id, path: operation.path, outcome: "conflict" };
+            }
+            if (journalOperation?.state === "preexisting" ||
+                journalOperation?.state === "published") {
+                return {
+                    operationId: operation.id,
+                    path: operation.path,
+                    outcome: "already-satisfied",
+                    resultDigest: operation.after.digest
+                };
+            }
+            return {
+                operationId: operation.id,
+                path: operation.path,
+                outcome: journalOperation?.state === "publishing" ? "unobserved" : "not-applied"
+            };
+        }),
+        diagnostics: [
+            createAuthorityDiagnostic(options.phase === "recovery"
+                ? "scaffolding.recovery.third-state"
+                : "scaffolding.apply.precondition-conflict", options.phase, options.plan.target.path, "Scaffolding output cannot be proven safe for the requested transaction state.", options.phase === "recovery"
+                ? "Resolve the output manually, then retry recovery."
+                : "Compile a new Plan from the current workspace state.")
+        ]
+    });
+}
+export function createRecoveryRequiredReceipt(options) {
+    return createAuthorityScaffoldReceipt({
+        plan: options.plan,
+        outcome: "recovery-required",
+        commitState: "recovery-required",
+        operations: options.operations ??
+            options.plan.operations.map((operation) => ({
+                operationId: operation.id,
+                path: operation.path,
+                outcome: "unobserved"
+            })),
+        diagnostics: [
+            createAuthorityDiagnostic(options.ruleId, options.phase, options.subject, options.message, options.remediation)
+        ]
+    });
+}
+export function freshAuthorityScaffoldJournal(plan) {
+    return Object.freeze({
+        schemaVersion: 2,
+        state: "PREPARED",
+        plan,
+        operations: Object.freeze(plan.operations.map((operation) => Object.freeze({
+            operationId: operation.id,
+            path: operation.path,
+            state: "pending"
+        })))
+    });
+}
+export function replaceScaffoldJournalOperation(journal, operationId, state) {
+    return Object.freeze({
+        ...journal,
+        operations: Object.freeze(journal.operations.map((operation) => operation.operationId === operationId
+            ? Object.freeze({ ...operation, state })
+            : operation))
+    });
+}
+export async function reconcileAuthorityScaffoldJournal(root, journal) {
+    let next = journal;
+    const conflictIds = new Set();
+    for (const operation of journal.plan.operations) {
+        const recorded = next.operations.find((candidate) => candidate.operationId === operation.id);
+        if (recorded === undefined) {
+            conflictIds.add(operation.id);
+            continue;
+        }
+        await assertSafeExistingAncestors(root, operation.path);
+        const state = await classifyFilesystemOperation(root, operation);
+        if (state === "conflict") {
+            conflictIds.add(operation.id);
+            continue;
+        }
+        if (recorded.state === "preexisting") {
+            if (state === "absent") {
+                next = replaceScaffoldJournalOperation(next, operation.id, "pending");
+            }
+            continue;
+        }
+        if (recorded.state === "pending" && state === "after") {
+            next = replaceScaffoldJournalOperation(next, operation.id, "preexisting");
+            continue;
+        }
+        if (recorded.state === "publishing") {
+            next = replaceScaffoldJournalOperation(next, operation.id, state === "after" ? "published" : "pending");
+            continue;
+        }
+        if (recorded.state === "published" && state === "absent") {
+            conflictIds.add(operation.id);
+        }
+    }
+    return { journal: next, conflictIds };
+}
+//# sourceMappingURL=filesystem-journal-state.js.map

package/dist/scaffolding/adapters/node/filesystem-journal-state.js.map

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

package/dist/scaffolding/adapters/node/filesystem-journal.d.ts

@@ -1,6 +1,9 @@
-import type { ScaffoldPlanV1 } from "../../contract/types.js";
+import type { AuthorityScaffoldJournal } from "../../contract/types.js";
+import { type PortableFileIdentity } from "./filesystem-file-identity.js";
 export declare const SCAFFOLD_JOURNAL_FILE = "scaffolding-transaction.json";
-export declare function writeScaffoldJournal(path: string, plan: ScaffoldPlanV1): Promise<void>;
-export declare function readScaffoldJournal(path: string): Promise<ScaffoldPlanV1 | undefined>;
-export declare function removeScaffoldJournal(path: string): Promise<void>;
+export declare function writeAuthorityScaffoldJournal(path: string, journal: AuthorityScaffoldJournal, faultInjector?: () => Promise<void> | void): Promise<PortableFileIdentity>;
+export declare function readScaffoldJournalEnvelope(path: string): Promise<AuthorityScaffoldJournal | undefined>;
+export declare function captureExpectedAuthorityScaffoldJournal(path: string, expected: AuthorityScaffoldJournal): Promise<PortableFileIdentity>;
+export declare function assertAuthorityScaffoldJournalTemporaryAbsent(path: string): Promise<void>;
+export declare function removeExpectedAuthorityScaffoldJournal(path: string, expectedIdentity: PortableFileIdentity, faultInjector?: () => Promise<void> | void): Promise<void>;
 //# sourceMappingURL=filesystem-journal.d.ts.map

package/dist/scaffolding/adapters/node/filesystem-journal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-journal.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-journal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAQ9D,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAUpE,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA0CrC;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvE"}
+{"version":3,"file":"filesystem-journal.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-journal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAMxE,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,+BAA+B,CAAC;AAGvC,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAsEpE,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,wBAAwB,EACjC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAE/B;AA4GD,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAE/C;AAED,wBAAsB,uCAAuC,CAC3D,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,wBAAwB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAY/B;AAED,wBAAsB,6CAA6C,CACjE,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,sCAAsC,CAC1D,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,oBAAoB,EACtC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACzC,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/scaffolding/adapters/node/filesystem-journal.js

@@ -1,53 +1,76 @@
-import { lstat, mkdir, open, readFile, rename, rm } from "node:fs/promises";
+import { lstat, mkdir, open, rename, rm } from "node:fs/promises";
 import { dirname } from "node:path";
-import { assertScaffoldPlanDigest } from "../../kernel/plan-validation.js";
+import { assertAuthorityScaffoldPlanDigest } from "../../kernel/plan-validation.js";
 import { ScaffoldError } from "../../scaffold-error.js";
 import { assertSchema } from "../../../schema-catalog.js";
 import { parseStrictYamlSource } from "../../../strict-yaml.js";
 import { syncDirectory } from "./filesystem-path-guard.js";
-import { MAX_SCAFFOLD_PLAN_BYTES } from "./node-input-loader.js";
+import { captureFileHandleIdentity, pathMatchesFileIdentity, readBoundedRegularFile } from "./filesystem-file-identity.js";
+import { MAX_SCAFFOLD_PLAN_BYTES } from "./node-scaffold-limits.js";
 export const SCAFFOLD_JOURNAL_FILE = "scaffolding-transaction.json";
 function isMissing(error) {
     return (error instanceof Error &&
         "code" in error &&
         error.code === "ENOENT");
 }
-export async function writeScaffoldJournal(path, plan) {
+async function writeAuthorityJournalFile(path, journal, faultInjector) {
     const parent = dirname(path);
     await mkdir(parent, { recursive: true });
     const temporary = `${path}.tmp`;
-    await rm(temporary, { force: true });
     let renamed = false;
+    let temporaryIdentity;
     try {
-        const handle = await open(temporary, "wx", 0o600);
+        const handle = await open(temporary, "wx", 0o600).catch((error) => {
+            if (error instanceof Error &&
+                "code" in error &&
+                error.code === "EEXIST") {
+                throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding journal temporary path already exists.", [], { cause: error });
+            }
+            throw error;
+        });
         try {
-            const journal = { schemaVersion: 1, state: "PREPARED", plan };
             await handle.writeFile(`${JSON.stringify(journal, null, 2)}\n`, "utf8");
             await handle.sync();
+            temporaryIdentity = await captureFileHandleIdentity(handle);
         }
         finally {
             await handle.close();
         }
+        await faultInjector?.();
+        if ((await pathMatchesFileIdentity(temporary, temporaryIdentity)) !== "match") {
+            throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding journal temporary path was replaced concurrently.");
+        }
         await rename(temporary, path);
         renamed = true;
         await syncDirectory(parent);
+        return temporaryIdentity;
     }
     finally {
-        if (!renamed) {
-            await rm(temporary, { force: true });
+        if (!renamed && temporaryIdentity !== undefined) {
+            const ownership = await pathMatchesFileIdentity(temporary, temporaryIdentity);
+            if (ownership === "match") {
+                await rm(temporary);
+                await syncDirectory(parent);
+            }
         }
     }
 }
-export async function readScaffoldJournal(path) {
-    let source;
+export async function writeAuthorityScaffoldJournal(path, journal, faultInjector) {
+    return writeAuthorityJournalFile(path, journal, faultInjector);
+}
+async function readJournalSource(path) {
     try {
-        const metadata = await lstat(path);
-        if (metadata.isSymbolicLink() ||
-            !metadata.isFile() ||
-            metadata.size > MAX_SCAFFOLD_PLAN_BYTES) {
+        const result = await readBoundedRegularFile(path, MAX_SCAFFOLD_PLAN_BYTES);
+        if (result.outcome === "invalid") {
             throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding recovery journal is not a bounded regular file.");
         }
-        source = await readFile(path, "utf8");
+        if (result.outcome === "changed") {
+            throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding recovery journal changed while it was being read.");
+        }
+        return {
+            identity: result.identity,
+            source: result.bytes.toString("utf8")
+        };
     }
     catch (error) {
         if (isMissing(error)) {
@@ -55,25 +78,77 @@ export async function readScaffoldJournal(path) {
         }
         throw error;
     }
-    const value = parseStrictYamlSource(source, "scaffold-recovery-journal");
+}
+function assertAuthorityJournalOperationBindings(journal) {
+    if (journal.operations.length !== journal.plan.operations.length) {
+        throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding recovery journal operation evidence does not match its Plan.");
+    }
+    const planOperations = new Map(journal.plan.operations.map((operation) => [operation.id, operation]));
+    const seen = new Set();
+    for (const operation of journal.operations) {
+        const planned = planOperations.get(operation.operationId);
+        if (planned === undefined ||
+            planned.path !== operation.path ||
+            seen.has(operation.operationId)) {
+            throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding recovery journal operation evidence is invalid.");
+        }
+        seen.add(operation.operationId);
+    }
+}
+async function readScaffoldJournalRecord(path) {
+    const record = await readJournalSource(path);
+    if (record === undefined) {
+        return undefined;
+    }
+    const value = parseStrictYamlSource(record.source, "scaffold-recovery-journal");
     if (typeof value !== "object" ||
         value === null ||
         Array.isArray(value) ||
-        Object.keys(value).length !== 3 ||
-        !("schemaVersion" in value) ||
-        value.schemaVersion !== 1 ||
-        !("state" in value) ||
-        value.state !== "PREPARED" ||
-        !("plan" in value)) {
+        !("schemaVersion" in value)) {
         throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding recovery journal is invalid.");
     }
-    await assertSchema("scaffold-plan/v1", value.plan, "scaffold-recovery-journal");
-    const plan = value.plan;
-    assertScaffoldPlanDigest(plan);
-    return plan;
+    if (value.schemaVersion !== 2) {
+        throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "A released 0.5 scaffolding journal must be recovered before upgrading.");
+    }
+    await assertSchema("scaffold-recovery-journal", value, "scaffold-recovery-journal");
+    const journal = value;
+    await assertSchema("scaffold-plan", journal.plan, "scaffold-recovery-journal");
+    assertAuthorityScaffoldPlanDigest(journal.plan);
+    assertAuthorityJournalOperationBindings(journal);
+    return { identity: record.identity, journal };
+}
+export async function readScaffoldJournalEnvelope(path) {
+    return (await readScaffoldJournalRecord(path))?.journal;
 }
-export async function removeScaffoldJournal(path) {
-    await rm(path, { force: true });
+export async function captureExpectedAuthorityScaffoldJournal(path, expected) {
+    const record = await readScaffoldJournalRecord(path);
+    if (record === undefined ||
+        JSON.stringify(record.journal) !== JSON.stringify(expected)) {
+        throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding recovery journal changed before finalization.");
+    }
+    return record.identity;
+}
+export async function assertAuthorityScaffoldJournalTemporaryAbsent(path) {
+    const temporary = `${path}.tmp`;
+    try {
+        await lstat(temporary);
+    }
+    catch (error) {
+        if (isMissing(error)) {
+            return;
+        }
+        throw error;
+    }
+    // Creator-handle identity does not survive a crash, so restart recovery has
+    // no evidence that authorizes promotion or deletion of this path.
+    throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding journal temporary cannot be proven transaction-owned; it was preserved and requires manual recovery.");
+}
+export async function removeExpectedAuthorityScaffoldJournal(path, expectedIdentity, faultInjector) {
+    if ((await pathMatchesFileIdentity(path, expectedIdentity)) !== "match") {
+        throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding journal changed before it could be removed.");
+    }
+    await rm(path);
+    await faultInjector?.();
     await syncDirectory(dirname(path));
 }
 //# sourceMappingURL=filesystem-journal.js.map

package/dist/scaffolding/adapters/node/filesystem-journal.js.map

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

package/dist/scaffolding/adapters/node/filesystem-operation-state.d.ts

@@ -0,0 +1,23 @@
+import type { MaterializeFileOperationV1 } from "../../contract/types.js";
+export type FilesystemOperationState = "absent" | "after" | "conflict";
+interface FilesystemPublicationFaultPoint {
+    readonly phase: "after-hard-link" | "after-temporary-synced" | "after-temporary-written";
+    readonly operationIndex: number;
+    readonly operationPath: string;
+}
+export type FilesystemPublicationFaultInjector = (point: FilesystemPublicationFaultPoint) => Promise<void> | void;
+export declare function classifyFilesystemOperation(root: string, operation: MaterializeFileOperationV1): Promise<FilesystemOperationState>;
+export declare function removeTransactionTemporary(root: string, planDigest: string, operation: MaterializeFileOperationV1): Promise<void>;
+export declare function assertTransactionTemporariesAbsent(root: string, plan: {
+    readonly planDigest: string;
+    readonly operations: readonly MaterializeFileOperationV1[];
+}): Promise<void>;
+export declare function publishFilesystemOperation(root: string, operation: MaterializeFileOperationV1, planDigest: string, operationIndex: number, faultInjector?: FilesystemPublicationFaultInjector): Promise<"already-satisfied" | "applied">;
+export declare function classifyFilesystemPlan(root: string, plan: {
+    readonly operations: readonly MaterializeFileOperationV1[];
+}): Promise<readonly {
+    readonly operation: MaterializeFileOperationV1;
+    readonly state: FilesystemOperationState;
+}[]>;
+export {};
+//# sourceMappingURL=filesystem-operation-state.d.ts.map

package/dist/scaffolding/adapters/node/filesystem-operation-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-operation-state.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-operation-state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAgB1E,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvE,UAAU,+BAA+B;IACvC,QAAQ,CAAC,KAAK,EACV,iBAAiB,GACjB,wBAAwB,GACxB,yBAAyB,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,kCAAkC,GAAG,CAC/C,KAAK,EAAE,+BAA+B,KACnC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAkB1B,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,0BAA0B,GACpC,OAAO,CAAC,wBAAwB,CAAC,CAwBnC;AAYD,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,0BAA0B,GACpC,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,kCAAkC,CACtD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,0BAA0B,EAAE,CAAA;CAAE,GAChG,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,0BAA0B,EACrC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,kCAAkC,GACjD,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAuH1C;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,0BAA0B,EAAE,CAAA;CAAE,GACnE,OAAO,CAAC,SAAS;IAClB,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;CAC1C,EAAE,CAAC,CAOH"}