@agent-teams/engineering-foundation 0.15.0 → 0.16.0

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

@@ -1,7 +1,9 @@
 import { createAuthorityScaffoldReceipt } from "../../kernel/authority-receipt.js";
 import { recoveryRequiredForAuthority, resolveAuthority, safeClassifyPlan } from "./filesystem-authority.js";
+import { assertNoOwnedCleanupResidue } from "./filesystem-operation-state.js";
 import { createAuthorityDiagnostic, freshAuthorityScaffoldJournal, replaceScaffoldJournalOperation, receiptFromJournalStates } from "./filesystem-journal-state.js";
-import { captureExpectedAuthorityScaffoldJournal, removeExpectedAuthorityScaffoldJournal, writeAuthorityScaffoldJournal } from "./filesystem-journal.js";
+import { createScaffoldJournalReconciled, removeScaffoldJournalReconciled, replaceScaffoldJournalReconciled } from "./node-scaffold-journal-gateway.js";
+import { NodeScaffoldJournalStore } from "./node-scaffold-journal-store.js";
 import { assessScaffoldPlanAuthority } from "./node-plan-authority.js";
 export function staleBeforeJournal(plan) {
     return createAuthorityScaffoldReceipt({
@@ -30,6 +32,7 @@ function authorityUnverifiableBeforeJournal(plan) {
 async function classifyBeforeJournal(options) {
     let states;
     try {
+        await assertNoOwnedCleanupResidue(options.root, options.plan);
         states = await safeClassifyPlan(options.root, options.plan);
     }
     catch {
@@ -76,6 +79,17 @@ export async function verifyAlreadyAppliedScaffold(options) {
         }
     }
     await options.faultInjector?.({ phase: "after-final-verification" });
+    try {
+        await assertNoOwnedCleanupResidue(options.root, options.plan);
+    }
+    catch (error) {
+        let journal = freshAuthorityScaffoldJournal(options.plan);
+        for (const operation of options.plan.operations) {
+            journal = replaceScaffoldJournalOperation(journal, operation.id, "preexisting");
+        }
+        await createScaffoldJournalReconciled(options.journalStore, journal);
+        throw error;
+    }
     return createAuthorityScaffoldReceipt({
         plan: options.plan,
         outcome: "already-applied",
@@ -94,6 +108,7 @@ function isReceipt(value) {
 async function verifyOutputs(options) {
     let states;
     try {
+        await assertNoOwnedCleanupResidue(options.root, options.journal.plan);
         states = await safeClassifyPlan(options.root, options.journal.plan);
     }
     catch {
@@ -111,7 +126,7 @@ async function verifyOutputs(options) {
     if (conflictIds.size === 0) {
         return states;
     }
-    await writeAuthorityScaffoldJournal(options.journalPath, options.journal);
+    await replaceScaffoldJournalReconciled(options.journalStore, { journal: options.journal, journalAuthority: options.journalAuthority }, options.journal);
     return receiptFromJournalStates({
         plan: options.journal.plan,
         journal: options.journal,
@@ -149,11 +164,24 @@ export async function finalizeAuthorityScaffoldJournal(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" }));
+    await assertNoOwnedCleanupResidue(options.root, options.journal.plan);
+    options.journalFaultContext.finalizing = true;
+    await removeScaffoldJournalReconciled(options.journalStore, {
+        journal: options.journal,
+        journalAuthority: options.journalAuthority
+    });
+    options.journalFaultContext.finalizing = false;
+    try {
+        await options.faultInjector?.({ phase: "after-journal-unlinked" });
+    }
+    catch (error) {
+        const observed = await options.journalStore.stabilizeForReconciliation();
+        if (observed.outcome !== "stable" ||
+            observed.stored !== undefined) {
+            throw error;
+        }
+    }
     return createAuthorityScaffoldReceipt({
         plan: options.journal.plan,
         outcome: options.recovered ? "failed-recovered" : "applied",

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

@@ -1 +1 @@
-{"version":3,"file":"filesystem-finalization.js","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-finalization.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"filesystem-finalization.js","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-finalization.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,+BAA+B,EAC/B,wBAAwB,EACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAC/B,gCAAgC,EACjC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,wBAAwB,EAEzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAcvE,MAAM,UAAU,kBAAkB,CAAC,IAA2B;IAC5D,OAAO,8BAA8B,CAAC;QACpC,IAAI;QACJ,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,aAAa;QAC1B,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAC9C,WAAW,EAAE,SAAS,CAAC,EAAE;YACzB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,OAAO,EAAE,aAAa;SACvB,CAAC,CAAC;QACH,WAAW,EAAE;YACX,yBAAyB,CACvB,6BAA6B,EAC7B,OAAO,EACP,IAAI,CAAC,SAAS,EACd,4CAA4C,EAC5C,yDAAyD,CAC1D;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kCAAkC,CACzC,IAA2B;IAE3B,OAAO,4BAA4B,CAAC;QAClC,IAAI;QACJ,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,oCAAoC;QAC5C,OAAO,EAAE,gEAAgE;QACzE,WAAW,EAAE,8DAA8D;KAC5E,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,OAGpC;IACC,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,2BAA2B,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,4BAA4B,CAAC;YAClC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,0CAA0C;YAClD,OAAO,EAAE,wDAAwD;YACjE,WAAW,EAAE,iEAAiE;SAC/E,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,CAAC,EAAE,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,GAAG,6BAA6B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,KAAK,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;QAC1C,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,OAAO,GAAG,+BAA+B,CACvC,OAAO,EACP,SAAS,CAAC,EAAE,EACZ,aAAa,CACd,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,wBAAwB,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO;QACP,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,OAAO;QACd,oBAAoB,EAAE,IAAI,GAAG,CAC3B,MAAM;aACH,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,UAAU,CAAC;aAC3C,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CACxC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,OAMlD;IACC,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC,CAAC;IAC3E,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,MAAM,2BAA2B,CACjD,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,IAAI,CACb,CAAC;QACF,IAAI,SAAS,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAChC,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,SAAS,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YACvC,OAAO,kCAAkC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC;QACH,MAAM,2BAA2B,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,GAAG,6BAA6B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1D,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChD,OAAO,GAAG,+BAA+B,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,+BAA+B,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrE,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,8BAA8B,CAAC;QACpC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,WAAW;QACxB,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACtD,WAAW,EAAE,SAAS,CAAC,EAAE;YACzB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,OAAO,EAAE,mBAAmB;YAC5B,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM;SACrC,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC;AAcD,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,eAAe,IAAI,KAAK,CAAC;AACjF,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,OAA4B;IAQ5B,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,2BAA2B,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtE,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,4BAA4B,CAAC;YAClC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;YAC1B,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO;YAC/C,MAAM,EAAE,6CAA6C;YACrD,OAAO,EAAE,4DAA4D;YACrE,WAAW,EAAE,6DAA6D;SAC3E,CAAC,CAAC;IACL,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,MAAM;SACH,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,CAAC;SACxC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CACxC,CAAC;IACF,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,gCAAgC,CACpC,OAAO,CAAC,YAAY,EACpB,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,EACxE,OAAO,CAAC,OAAO,CAChB,CAAC;IACF,OAAO,wBAAwB,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,mBAAmB;QAC5B,KAAK,EAAE,UAAU;QACjB,oBAAoB,EAAE,WAAW;KAClC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CACzB,MAGG;IAEH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,WAAW,EAAE,SAAS,CAAC,EAAE;QACzB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EAAE,mBAA4B;QACrC,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM;KACrC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,OAA4B;IAE5B,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC,CAAC;IAC3E,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC;QAC5C,GAAG,OAAO;QACV,kBAAkB,EAAE,kBAAkB,CAAC,WAAW,CAAC;KACpD,CAAC,CAAC;IACH,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC,CAAC;IACrE,MAAM,2BAA2B,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,OAAO,CAAC,mBAAmB,CAAC,UAAU,GAAG,IAAI,CAAC;IAC9C,MAAM,+BAA+B,CAAC,OAAO,CAAC,YAAY,EAAE;QAC1D,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;KAC3C,CAAC,CAAC;IACH,OAAO,CAAC,mBAAmB,CAAC,UAAU,GAAG,KAAK,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,0BAA0B,EAAE,CAAC;QACzE,IACE,QAAQ,CAAC,OAAO,KAAK,QAAQ;YAC7B,QAAQ,CAAC,MAAM,KAAK,SAAS,EAC7B,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,8BAA8B,CAAC;QACpC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;QAC1B,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS;QAC3D,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW;QAC1D,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAC5D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI;YACpC,WAAW,EAAE,SAAS,CAAC,EAAE;YACzB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,OAAO,EAAE,mBAA4B;YACrC,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM;SACrC,CACF;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -1 +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"}
+{"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;AAQjC,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,CAyCD"}

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

@@ -1,6 +1,6 @@
 import { createAuthorityScaffoldReceipt } from "../../kernel/authority-receipt.js";
 import { assertSafeExistingAncestors } from "./filesystem-path-guard.js";
-import { classifyFilesystemOperation } from "./filesystem-operation-state.js";
+import { assertNoOwnedCleanupResidue, classifyFilesystemOperation } from "./filesystem-operation-state.js";
 export function createAuthorityDiagnostic(ruleId, phase, subject, message, remediation) {
     return Object.freeze({
         ruleId,
@@ -82,6 +82,7 @@ export function replaceScaffoldJournalOperation(journal, operationId, state) {
     });
 }
 export async function reconcileAuthorityScaffoldJournal(root, journal) {
+    await assertNoOwnedCleanupResidue(root, journal.plan);
     let next = journal;
     const conflictIds = new Set();
     for (const operation of journal.plan.operations) {

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

@@ -1 +1 @@
-{"version":3,"file":"filesystem-journal-state.js","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-journal-state.ts"],"names":[],"mappings":"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"}
+{"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,9 +1,17 @@
 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 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>;
+export declare const SCAFFOLD_JOURNAL_QUARANTINE_PREFIX: string;
+export declare function writeAuthorityScaffoldJournal(path: string, journal: AuthorityScaffoldJournal, options?: {
+    readonly expectedAuthority?: ScaffoldJournalAuthority;
+    readonly faultInjector?: (() => Promise<void> | void) | undefined;
+}): Promise<ScaffoldJournalAuthority>;
+export interface ScaffoldJournalAuthority {
+    readonly identity: PortableFileIdentity;
+    readonly authorityDigest: string;
+}
+export declare function removeExpectedAuthorityScaffoldJournal(path: string, expectedAuthority: ScaffoldJournalAuthority, faultInjector?: {
+    readonly beforeQuarantine?: () => Promise<void> | void;
+    readonly afterQuarantine?: () => 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,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAMxE,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,+BAA+B,CAAC;AAIvC,eAAO,MAAM,qBAAqB,gCAA8B,CAAC;AAsEjE,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;AAgFD,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"}
+{"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;AAGxE,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,+BAA+B,CAAC;AASvC,eAAO,MAAM,qBAAqB,gCAA8B,CAAC;AACjE,eAAO,MAAM,kCAAkC,QACQ,CAAC;AAsGxD,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,wBAAwB,EACjC,OAAO,GAAE;IACP,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IACtD,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;CAC9D,GACL,OAAO,CAAC,wBAAwB,CAAC,CAEnC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAiFD,wBAAsB,sCAAsC,CAC1D,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,wBAAwB,EAC3C,aAAa,CAAC,EAAE;IACd,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvD,GACA,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

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

@@ -1,20 +1,21 @@
-import { lstat, mkdir, open, rename, rm } from "node:fs/promises";
-import { dirname } from "node:path";
-import { assertAuthorityScaffoldJournal } from "../../kernel/authority-journal-validation.js";
+import { link, mkdir, open, rename } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
 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 { captureFileHandleIdentity, pathMatchesFileIdentity, readBoundedRegularFile } from "./filesystem-file-identity.js";
 import { MAX_SCAFFOLD_PLAN_BYTES } from "./node-scaffold-limits.js";
 import { FOUNDATION_TRANSACTION_FILE } from "../../../foundation-state-contract.js";
+import { sha256Bytes } from "../../kernel/canonical-json.js";
+import { assertTerminalEvidenceDirectory, ensureTerminalEvidenceDirectory } from "../../../repository-mutation/adapters/node/node-terminal-evidence-directory.js";
 export const SCAFFOLD_JOURNAL_FILE = FOUNDATION_TRANSACTION_FILE;
+export const SCAFFOLD_JOURNAL_QUARANTINE_PREFIX = `${FOUNDATION_TRANSACTION_FILE}.document-quarantine.`;
+let quarantineSequence = 0;
 function isMissing(error) {
     return (error instanceof Error &&
         "code" in error &&
         error.code === "ENOENT");
 }
-async function writeAuthorityJournalFile(path, journal, faultInjector) {
+async function writeAuthorityJournalFile(path, journal, options) {
     const parent = dirname(path);
     await mkdir(parent, { recursive: true });
     const temporary = `${path}.tmp`;
@@ -37,102 +38,139 @@ async function writeAuthorityJournalFile(path, journal, faultInjector) {
         finally {
             await handle.close();
         }
-        await faultInjector?.();
-        if ((await pathMatchesFileIdentity(temporary, temporaryIdentity)) !== "match") {
+        await options.faultInjector?.();
+        const temporaryAuthority = {
+            identity: temporaryIdentity,
+            authorityDigest: contentDigest(Buffer.from(`${JSON.stringify(journal, null, 2)}\n`, "utf8"))
+        };
+        if (!(await authorityMatches(temporary, temporaryAuthority))) {
             throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding journal temporary path was replaced concurrently.");
         }
-        await rename(temporary, path);
-        renamed = true;
+        const existing = options.expectedAuthority;
+        let quarantine;
+        if (existing !== undefined) {
+            quarantine = await createPrivateQuarantine(path, existing.identity);
+            await rename(path, quarantine.path);
+            await syncRenameBoundary(quarantine.directory, parent);
+            if (!(await authorityMatches(quarantine.path, existing))) {
+                throw recoveryRequired("Quarantined scaffolding journal changed concurrently.");
+            }
+        }
+        try {
+            await link(temporary, path);
+        }
+        catch (error) {
+            throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding journal slot changed during publication; all evidence was preserved.", [], { cause: error });
+        }
+        if (!(await authorityMatches(path, temporaryAuthority))) {
+            throw recoveryRequired("Published scaffolding journal changed concurrently.");
+        }
         await syncDirectory(parent);
-        return temporaryIdentity;
+        await retirePrivateEvidence(temporary, temporaryAuthority, parent);
+        renamed = true;
+        if (quarantine !== undefined) {
+            await retirePrivateEvidence(quarantine.path, existing, quarantine.directory);
+            await syncDirectory(parent);
+        }
+        return temporaryAuthority;
     }
     finally {
         if (!renamed && temporaryIdentity !== undefined) {
-            const ownership = await pathMatchesFileIdentity(temporary, temporaryIdentity);
-            if (ownership === "match") {
-                await rm(temporary);
-                await syncDirectory(parent);
+            const expected = {
+                identity: temporaryIdentity,
+                authorityDigest: contentDigest(Buffer.from(`${JSON.stringify(journal, null, 2)}\n`, "utf8"))
+            };
+            if (await authorityMatches(temporary, expected)) {
+                await retirePrivateEvidence(temporary, expected, parent);
             }
         }
     }
 }
-export async function writeAuthorityScaffoldJournal(path, journal, faultInjector) {
-    return writeAuthorityJournalFile(path, journal, faultInjector);
+export async function writeAuthorityScaffoldJournal(path, journal, options = {}) {
+    return writeAuthorityJournalFile(path, journal, options);
+}
+function contentDigest(bytes) {
+    return sha256Bytes(bytes);
+}
+function recoveryRequired(message) {
+    return new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", message);
 }
-async function readJournalSource(path) {
+async function authorityMatches(path, expected) {
     try {
-        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.");
-        }
-        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")
-        };
+        const observed = await readBoundedRegularFile(path, MAX_SCAFFOLD_PLAN_BYTES);
+        return observed.outcome === "read" &&
+            (await pathMatchesFileIdentity(path, expected.identity)) === "match" &&
+            contentDigest(observed.bytes) === expected.authorityDigest;
     }
     catch (error) {
         if (isMissing(error)) {
-            return undefined;
+            return false;
         }
         throw error;
     }
 }
-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) ||
-        !("schemaVersion" in value)) {
-        throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding recovery journal is invalid.");
-    }
-    if (value.schemaVersion !== 1) {
-        throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "A released 0.5 scaffolding journal must be recovered before upgrading.");
+async function createPrivateQuarantine(path, identity) {
+    const parent = dirname(path);
+    for (;;) {
+        quarantineSequence += 1;
+        const directory = join(parent, `${SCAFFOLD_JOURNAL_QUARANTINE_PREFIX}${identity.dev}.${identity.ino}.${identity.birthtimeNs}.${process.pid}.${quarantineSequence}`);
+        try {
+            await mkdir(directory, { mode: 0o700 });
+            return { directory, path: join(directory, "evidence") };
+        }
+        catch (error) {
+            if (!(error instanceof Error) ||
+                !("code" in error) ||
+                error.code !== "EEXIST") {
+                throw error;
+            }
+        }
     }
-    await assertSchema("scaffold-recovery-journal/v1", value, "scaffold-recovery-journal");
-    const journal = value;
-    await assertSchema("scaffold-plan/v1", journal.plan, "scaffold-recovery-journal");
-    assertAuthorityScaffoldJournal(journal);
-    return { identity: record.identity, journal };
-}
-export async function readScaffoldJournalEnvelope(path) {
-    return (await readScaffoldJournalRecord(path))?.journal;
 }
-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.");
+async function syncRenameBoundary(destination, source) {
+    await syncDirectory(destination);
+    if (destination !== source) {
+        await syncDirectory(source);
     }
-    return record.identity;
 }
-export async function assertAuthorityScaffoldJournalTemporaryAbsent(path) {
-    const temporary = `${path}.tmp`;
-    try {
-        await lstat(temporary);
+async function retirePrivateEvidence(path, expected, sourceDirectory) {
+    if (!(await authorityMatches(path, expected))) {
+        throw recoveryRequired("Scaffolding journal evidence changed before retirement; it was preserved.");
     }
-    catch (error) {
-        if (isMissing(error)) {
-            return;
-        }
-        throw error;
+    const quarantine = await createPrivateQuarantine(path, expected.identity);
+    await rename(path, quarantine.path);
+    await syncRenameBoundary(quarantine.directory, sourceDirectory);
+    if (!(await authorityMatches(quarantine.path, expected))) {
+        throw recoveryRequired("Quarantined scaffolding journal evidence changed concurrently.");
     }
-    // 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.");
+    const terminalRoot = join(dirname(quarantine.directory), `${FOUNDATION_TRANSACTION_FILE}.completed-scaffold-evidence`);
+    const terminalAuthority = await ensureTerminalEvidenceDirectory(terminalRoot);
+    await syncDirectory(dirname(quarantine.directory));
+    const terminalDirectory = join(terminalRoot, basename(quarantine.directory));
+    await assertTerminalEvidenceDirectory(terminalAuthority);
+    await rename(quarantine.directory, terminalDirectory);
+    await syncDirectory(terminalRoot);
+    await syncDirectory(dirname(quarantine.directory));
 }
-export async function removeExpectedAuthorityScaffoldJournal(path, expectedIdentity, faultInjector) {
-    if ((await pathMatchesFileIdentity(path, expectedIdentity)) !== "match") {
+export async function removeExpectedAuthorityScaffoldJournal(path, expectedAuthority, faultInjector) {
+    if (!(await authorityMatches(path, expectedAuthority))) {
         throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding journal changed before it could be removed.");
     }
-    await rm(path);
-    await faultInjector?.();
+    const quarantine = await createPrivateQuarantine(path, expectedAuthority.identity);
+    await faultInjector?.beforeQuarantine?.();
+    await rename(path, quarantine.path);
+    await syncRenameBoundary(quarantine.directory, dirname(path));
+    if (!(await authorityMatches(quarantine.path, expectedAuthority))) {
+        throw recoveryRequired("Quarantined scaffolding journal changed concurrently.");
+    }
+    const terminalRoot = join(dirname(quarantine.directory), `${FOUNDATION_TRANSACTION_FILE}.completed-scaffold-evidence`);
+    const terminalAuthority = await ensureTerminalEvidenceDirectory(terminalRoot);
+    await syncDirectory(dirname(quarantine.directory));
+    const terminalDirectory = join(terminalRoot, basename(quarantine.directory));
+    await assertTerminalEvidenceDirectory(terminalAuthority);
+    await rename(quarantine.directory, terminalDirectory);
+    await syncDirectory(terminalRoot);
     await syncDirectory(dirname(path));
+    await faultInjector?.afterQuarantine?.();
 }
 //# 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

@@ -1,5 +1,6 @@
 import { type AbsentFilePublicationFaultPoint } from "../../../repository-mutation/adapters/node/node-absent-file-publication.js";
 import type { MaterializeFileOperation } from "../../contract/scaffold-contract.js";
+import type { OwnedTemporaryCleanupTransitionPort } from "../../../repository-mutation/application/ports/owned-temporary-cleanup-transition.js";
 export type FilesystemOperationState = "absent" | "after" | "conflict";
 interface FilesystemPublicationFaultPoint {
     readonly phase: AbsentFilePublicationFaultPoint["phase"];
@@ -7,11 +8,19 @@ interface FilesystemPublicationFaultPoint {
     readonly operationPath: string;
 }
 export type FilesystemPublicationFaultInjector = (point: FilesystemPublicationFaultPoint) => Promise<void> | void;
+interface FilesystemPublicationOptions {
+    readonly cleanupTransition: OwnedTemporaryCleanupTransitionPort;
+    readonly faultInjector?: FilesystemPublicationFaultInjector;
+}
 export declare function classifyFilesystemOperation(root: string, operation: MaterializeFileOperation): Promise<FilesystemOperationState>;
+export declare function assertNoOwnedCleanupResidue(root: string, plan: {
+    readonly planDigest: string;
+    readonly operations: readonly MaterializeFileOperation[];
+}): Promise<void>;
 export declare function assertTransactionTemporariesAbsent(root: string, plan: {
     readonly planDigest: string;
     readonly operations: readonly MaterializeFileOperation[];
 }): Promise<void>;
-export declare function publishFilesystemOperation(root: string, operation: MaterializeFileOperation, planDigest: string, operationIndex: number, faultInjector?: FilesystemPublicationFaultInjector): Promise<"already-satisfied" | "applied">;
+export declare function publishFilesystemOperation(root: string, operation: MaterializeFileOperation, planDigest: string, operationIndex: number, faultInjectorOrOptions?: FilesystemPublicationFaultInjector | FilesystemPublicationOptions): Promise<"already-satisfied" | "applied">;
 export {};
 //# sourceMappingURL=filesystem-operation-state.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"filesystem-operation-state.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-operation-state.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,+BAA+B,EACrC,MAAM,4EAA4E,CAAC;AAEpF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AASpF,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvE,UAAU,+BAA+B;IACvC,QAAQ,CAAC,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,CAAC;IACzD,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;AAW1B,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,wBAAwB,GAClC,OAAO,CAAC,wBAAwB,CAAC,CAOnC;AAYD,wBAAsB,kCAAkC,CACtD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC1D,GACA,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAyDD,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,wBAAwB,EACnC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,kCAAkC,GACjD,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAwC1C"}
+{"version":3,"file":"filesystem-operation-state.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-operation-state.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,+BAA+B,EACrC,MAAM,4EAA4E,CAAC;AAGpF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAGpF,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,sFAAsF,CAAC;AAOhJ,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvE,UAAU,+BAA+B;IACvC,QAAQ,CAAC,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,CAAC;IACzD,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;AAE1B,UAAU,4BAA4B;IACpC,QAAQ,CAAC,iBAAiB,EAAE,mCAAmC,CAAC;IAChE,QAAQ,CAAC,aAAa,CAAC,EAAE,kCAAkC,CAAC;CAC7D;AAWD,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,wBAAwB,GAClC,OAAO,CAAC,wBAAwB,CAAC,CAOnC;AAYD,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC1D,GACA,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED,wBAAsB,kCAAkC,CACtD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC1D,GACA,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAyDD,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,wBAAwB,EACnC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,sBAAsB,CAAC,EACnB,kCAAkC,GAClC,4BAA4B,GAC/B,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAuD1C"}

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

@@ -1,6 +1,8 @@
+import { readdir } from "node:fs/promises";
 import { basename, dirname, join, resolve } from "node:path";
 import { assertTemporaryPathsAbsent, classifyExactFilePostimage, publishAbsentFile } from "../../../repository-mutation/adapters/node/node-absent-file-publication.js";
 import { AbsentFilePublicationError } from "../../../repository-mutation/application/model/exact-postimage.js";
+import { ownedTemporaryCleanupResiduePrefix } from "../../../repository-mutation/adapters/node/node-cleanup-owned-temporary.js";
 import { sha256Text } from "../../kernel/canonical-json.js";
 import { ScaffoldError } from "../../scaffold-error.js";
 import { assertSafeExistingAncestors, ensureSafeParent, isContainedPath } from "./filesystem-path-guard.js";
@@ -24,7 +26,30 @@ function transactionTemporaryName(planDigest, operation) {
     const identity = sha256Text(`${planDigest}:${operation.id}`).slice("sha256:".length);
     return `.foundation-${identity}.tmp`;
 }
+export async function assertNoOwnedCleanupResidue(root, plan) {
+    for (const operation of plan.operations) {
+        const parent = dirname(resolve(root, operation.path));
+        const temporary = join(parent, transactionTemporaryName(plan.planDigest, operation));
+        const prefix = ownedTemporaryCleanupResiduePrefix(temporary);
+        let entries;
+        try {
+            entries = await readdir(parent);
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                "code" in error &&
+                error.code === "ENOENT") {
+                continue;
+            }
+            throw error;
+        }
+        if (entries.some((entry) => entry.startsWith(prefix))) {
+            throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", `Scaffolding owned temporary cleanup residue requires manual recovery: ${operation.path}.`);
+        }
+    }
+}
 export async function assertTransactionTemporariesAbsent(root, plan) {
+    await assertNoOwnedCleanupResidue(root, plan);
     try {
         await assertTemporaryPathsAbsent(plan.operations.map((operation) => {
             const parent = dirname(resolve(root, operation.path));
@@ -71,8 +96,18 @@ function translatePublicationError(error, operation) {
             throw error.cause instanceof Error ? error.cause : error;
     }
 }
-export async function publishFilesystemOperation(root, operation, planDigest, operationIndex, faultInjector) {
+export async function publishFilesystemOperation(root, operation, planDigest, operationIndex, faultInjectorOrOptions) {
+    const faultInjector = typeof faultInjectorOrOptions === "function"
+        ? faultInjectorOrOptions
+        : faultInjectorOrOptions?.faultInjector;
+    const cleanupTransition = typeof faultInjectorOrOptions === "function"
+        ? undefined
+        : faultInjectorOrOptions?.cleanupTransition;
     await assertSafeExistingAncestors(root, operation.path);
+    await assertNoOwnedCleanupResidue(root, {
+        planDigest,
+        operations: [operation]
+    });
     const state = await classifyFilesystemOperation(root, operation);
     if (state === "after") {
         return "already-satisfied";
@@ -98,7 +133,10 @@ export async function publishFilesystemOperation(root, operation, planDigest, op
                     })
                 }),
             postimage: postimage(operation),
-            temporaryPath: temporary
+            temporaryPath: temporary,
+            ...(cleanupTransition === undefined
+                ? {}
+                : { transition: cleanupTransition })
         });
         return outcome === "published" ? "applied" : "already-satisfied";
     }