@openclaw/fs-safe 0.14.0 → 0.16.0

package/dist/sidecar-lock-admission-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-lock-admission-context.d.ts","sourceRoot":"","sources":["../src/sidecar-lock-admission-context.ts"],"names":[],"mappings":"AAEA,KAAK,iBAAiB,GAAG;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,wBAAwB,GAAG,SAAS,iBAAiB,EAAE,CAAC;AAkB7D,wFAAwF;AACxF,wBAAgB,+BAA+B,IAAI,wBAAwB,CAM1E;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CAGT;AA4BD,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,oBAAoB,EAAE,MAAM;mBAMd,OAAO;oBAHA,OAAO;eAKf,IAAI;eAKJ,IAAI;QAMX,CAAC,YAAY,MAAM,CAAC,GAAG,CAAC;EAI/B"}

package/dist/sidecar-lock-admission-context.js

@@ -0,0 +1,60 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const EMPTY_ANCESTRY = Object.freeze([]);
+const GLOBAL_CONTEXT_KEY = Symbol.for("fsSafe.sidecarLockAdmissionAsyncContext");
+function admissionContext() {
+    const shared = globalThis;
+    return shared[GLOBAL_CONTEXT_KEY] ??=
+        new AsyncLocalStorage();
+}
+/** Capture active ancestry now; later lifecycle changes cannot reclassify this call. */
+export function captureSidecarAdmissionAncestry() {
+    const current = admissionContext().getStore();
+    if (!current)
+        return EMPTY_ANCESTRY;
+    const active = current.ancestry.filter((entry) => entry.active);
+    if (current.active)
+        active.push(current);
+    return active.length === 0 ? EMPTY_ANCESTRY : active;
+}
+export function ancestryHasSidecarAdmission(ancestry, admissions, normalizedTargetPath) {
+    return ancestry.some((entry) => entry.admissions === admissions && entry.normalizedTargetPath === normalizedTargetPath);
+}
+function createSidecarAdmissionScope(ancestry, admissions, normalizedTargetPath, token) {
+    return { active: false, admissions, ancestry, normalizedTargetPath, started: false, token };
+}
+function activateSidecarAdmissionScope(scope) {
+    if (scope.started)
+        throw new Error("sidecar admission scope cannot be reactivated");
+    scope.started = true;
+    scope.active = true;
+}
+function deactivateSidecarAdmissionScope(scope) {
+    if (scope)
+        scope.active = false;
+}
+function runInSidecarAdmissionScope(scope, callback) {
+    return scope?.active ? admissionContext().run(scope, callback) : callback();
+}
+export function createSidecarAdmissionController(ancestry, admissions, normalizedTargetPath) {
+    let scope;
+    const hasToken = () => scope !== undefined && admissions.get(normalizedTargetPath) === scope.token;
+    return {
+        get owns() { return scope !== undefined; },
+        hasToken,
+        release() {
+            deactivateSidecarAdmissionScope(scope);
+            if (hasToken())
+                admissions.delete(normalizedTargetPath);
+            scope = undefined;
+        },
+        reserve() {
+            const token = {};
+            scope = createSidecarAdmissionScope(ancestry, admissions, normalizedTargetPath, token);
+            admissions.set(normalizedTargetPath, token);
+            activateSidecarAdmissionScope(scope);
+        },
+        run(callback) {
+            return runInSidecarAdmissionScope(scope, callback);
+        },
+    };
+}

package/dist/sidecar-lock-admission-parser.d.ts

@@ -0,0 +1,43 @@
+import type { Root } from "./root-impl.js";
+import type { HeldSidecarLock } from "./sidecar-lock-admission.js";
+import { readSidecarLockRawSnapshot, type SidecarLockSnapshot } from "./sidecar-lock-reclaim.js";
+type SidecarAdmissionRunner = {
+    hasToken(): boolean;
+    run<T>(callback: () => T): T;
+};
+export declare function runSidecarAdmissionBoundary<T>(admission: SidecarAdmissionRunner, assertCurrent: () => void, callback: () => T): T;
+export declare function awaitSidecarAdmissionBoundary<T>(admission: SidecarAdmissionRunner, assertCurrent: () => void, callback: () => T | PromiseLike<T>): Promise<{
+    readonly value: Awaited<T>;
+}>;
+export type SidecarLockParserState = {
+    observed: boolean;
+    parser?: (raw: string) => unknown;
+};
+export declare function observeSidecarLockParser(state: SidecarLockParserState, admission: SidecarAdmissionRunner, accessor: () => ((raw: string) => unknown) | undefined, assertCurrent: () => void): void;
+export declare function scopedSidecarLockParser(state: SidecarLockParserState, admission: SidecarAdmissionRunner, assertCurrent: () => void): ((raw: string) => unknown) | undefined;
+/** Cleanup may outlive its reservation; never invoke user code after authority is lost. */
+export declare function conditionalSidecarLockParser(state: SidecarLockParserState, admission: SidecarAdmissionRunner, isCurrent: () => boolean): ((raw: string) => unknown) | undefined;
+export declare function parseSidecarLockSnapshotUnderAdmission(raw: Awaited<ReturnType<typeof readSidecarLockRawSnapshot>>, state: SidecarLockParserState, admission: SidecarAdmissionRunner, assertCurrent: () => void): SidecarLockSnapshot | null;
+export type HeldSidecarParserObservation = {
+    kind: "observed";
+} | {
+    kind: "holder-changed";
+} | {
+    kind: "read-error";
+    error: unknown;
+    transientDenial: boolean;
+};
+/** Emulate the historical EEXIST read/parser boundary without opening another sidecar. */
+export declare function observeHeldSidecarParser(params: {
+    admission: SidecarAdmissionRunner;
+    assertToken(): void;
+    currentHeld(): HeldSidecarLock | undefined;
+    held: HeldSidecarLock;
+    lockPath: string;
+    lockRoot?: Root;
+    parserState: SidecarLockParserState;
+    parserAccessor(): ((raw: string) => unknown) | undefined;
+    isTransientDenial(error: unknown): boolean;
+}): Promise<HeldSidecarParserObservation>;
+export {};
+//# sourceMappingURL=sidecar-lock-admission-parser.d.ts.map

package/dist/sidecar-lock-admission-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-lock-admission-parser.d.ts","sourceRoot":"","sources":["../src/sidecar-lock-admission-parser.ts"],"names":[],"mappings":"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"}

package/dist/sidecar-lock-admission-parser.js

@@ -0,0 +1,113 @@
+import { parseSidecarLockSnapshot, readSidecarLockRawSnapshot, } from "./sidecar-lock-reclaim.js";
+export function runSidecarAdmissionBoundary(admission, assertCurrent, callback) {
+    assertCurrent();
+    try {
+        return admission.run(callback);
+    }
+    finally {
+        assertCurrent();
+    }
+}
+export async function awaitSidecarAdmissionBoundary(admission, assertCurrent, callback) {
+    assertCurrent();
+    try {
+        return await admission.run(async () => {
+            const boxed = Object.create(null);
+            Object.defineProperty(boxed, "value", {
+                value: undefined, enumerable: true, writable: true,
+            });
+            boxed.value = await callback();
+            return boxed;
+        });
+    }
+    finally {
+        assertCurrent();
+    }
+}
+export function observeSidecarLockParser(state, admission, accessor, assertCurrent) {
+    assertCurrent();
+    if (state.observed)
+        return;
+    try {
+        state.parser = admission.run(accessor);
+    }
+    finally {
+        assertCurrent();
+    }
+    state.observed = true;
+}
+export function scopedSidecarLockParser(state, admission, assertCurrent) {
+    const parser = state.parser;
+    return parser && ((raw) => admission.run(() => {
+        assertCurrent();
+        try {
+            return Reflect.apply(parser, undefined, [raw]);
+        }
+        finally {
+            assertCurrent();
+        }
+    }));
+}
+/** Cleanup may outlive its reservation; never invoke user code after authority is lost. */
+export function conditionalSidecarLockParser(state, admission, isCurrent) {
+    const parser = state.parser;
+    return parser && ((raw) => {
+        if (!isCurrent())
+            return undefined;
+        return admission.run(() => {
+            if (!isCurrent())
+                return undefined;
+            let parsed;
+            try {
+                parsed = Reflect.apply(parser, undefined, [raw]);
+            }
+            catch (error) {
+                if (!isCurrent())
+                    return undefined;
+                throw error;
+            }
+            return isCurrent() ? parsed : undefined;
+        });
+    });
+}
+export function parseSidecarLockSnapshotUnderAdmission(raw, state, admission, assertCurrent) {
+    return parseSidecarLockSnapshot(raw, scopedSidecarLockParser(state, admission, assertCurrent));
+}
+/** Emulate the historical EEXIST read/parser boundary without opening another sidecar. */
+export async function observeHeldSidecarParser(params) {
+    const holderChanged = {};
+    const assertCurrentHolder = () => {
+        params.assertToken();
+        if (params.currentHeld() !== params.held || params.held.releasePromise) {
+            throw holderChanged;
+        }
+    };
+    let transientDenial = false;
+    let raw;
+    try {
+        raw = await params.admission.run(async () => await readSidecarLockRawSnapshot(params.lockPath, {
+            lockRoot: params.lockRoot,
+            rejectNonFile: true,
+            discardObservation: "changed",
+            onOpenFailure: (error) => { transientDenial = params.isTransientDenial(error); },
+        }));
+    }
+    catch (error) {
+        return { kind: "read-error", error, transientDenial };
+    }
+    params.assertToken();
+    if (params.currentHeld() !== params.held || params.held.releasePromise) {
+        return { kind: "holder-changed" };
+    }
+    try {
+        observeSidecarLockParser(params.parserState, params.admission, params.parserAccessor, assertCurrentHolder);
+        parseSidecarLockSnapshotUnderAdmission(raw, params.parserState, params.admission, assertCurrentHolder);
+        assertCurrentHolder();
+    }
+    catch (error) {
+        if (error === holderChanged)
+            return { kind: "holder-changed" };
+        throw error;
+    }
+    return { kind: "observed" };
+}

package/dist/sidecar-lock-admission.d.ts

@@ -0,0 +1,35 @@
+import type { NativeFileHandle } from "./native-operations.js";
+import type { Root } from "./root-impl.js";
+import type { SidecarLockSnapshot } from "./sidecar-lock-reclaim.js";
+import type { SidecarLockHandle } from "./sidecar-lock-types.js";
+type SidecarFileHandle = Pick<NativeFileHandle, "fd" | "close" | "stat" | "writeFile">;
+export type HeldSidecarLock = {
+    refCount: number;
+    reentrantOwner?: string;
+    handle: SidecarFileHandle;
+    lockPath: string;
+    snapshot: SidecarLockSnapshot;
+    acquiredAt: number;
+    metadata: Record<string, unknown>;
+    releasePromise?: Promise<void>;
+    lockRoot?: Root;
+    retainOnExit?: boolean;
+    parsePayload?: (raw: string) => unknown;
+    compromiseTimer?: NodeJS.Timeout;
+};
+export type SidecarLockAcquisitionContext = {
+    held: Map<string, HeldSidecarLock>;
+    admissions: Map<string, object>;
+    reclaimGuards: Set<string>;
+    ensureExitCleanupRegistered(): {
+        armed: boolean;
+    };
+    armExitCleanup(lifecycle: {
+        armed: boolean;
+    }): void;
+    assertRetainOnExitSupported(retainOnExit: boolean | undefined): void;
+    handleForHeldLock(normalizedTargetPath: string, held: HeldSidecarLock): SidecarLockHandle;
+};
+export declare function sidecarLockTimeout(lockPath: string, normalizedTargetPath: string): Error;
+export {};
+//# sourceMappingURL=sidecar-lock-admission.d.ts.map

package/dist/sidecar-lock-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-lock-admission.d.ts","sourceRoot":"","sources":["../src/sidecar-lock-admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,KAAK,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC;AAEvF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,2BAA2B,IAAI;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAClD,cAAc,CAAC,SAAS,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACpD,2BAA2B,CAAC,YAAY,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;IACrE,iBAAiB,CAAC,oBAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,iBAAiB,CAAC;CAC3F,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAG,KAAK,CAMxF"}

package/dist/sidecar-lock-admission.js

@@ -0,0 +1,7 @@
+export function sidecarLockTimeout(lockPath, normalizedTargetPath) {
+    return Object.assign(new Error(`file lock timeout for ${normalizedTargetPath}`), {
+        code: "file_lock_timeout",
+        lockPath,
+        normalizedTargetPath,
+    });
+}

package/dist/sidecar-lock-reclaim.d.ts

@@ -38,7 +38,7 @@ export declare function readSidecarLockRawSnapshotSync(lockPath: string, options
     rejectNonFile?: boolean;
     onOpenFailure?: (error: unknown) => void;
 }): SidecarLockRawSnapshot | null;
-export declare function removeSidecarLockIfUnchangedSync(lockPath: string, observed: SidecarLockSnapshot): boolean;
+export declare function removeSidecarLockIfUnchangedSync(lockPath: string, observed: SidecarLockSnapshot, assertAuthorized?: () => void): boolean;
 export declare function sidecarLockSnapshotMatches(current: SidecarLockSnapshot, observed: SidecarLockSnapshot): boolean;
 export declare function removeSidecarLockIfUnchanged(lockPath: string, observed: SidecarLockSnapshot | null, options?: {
     lockRoot?: Root;
@@ -48,9 +48,12 @@ export declare function sidecarLockSnapshotStillPresent(lockPath: string, observ
     lockRoot?: Root;
     parsePayload?: (raw: string) => unknown;
 }): Promise<boolean>;
-export declare function sidecarReclaimGuardExists(pathname: string): Promise<boolean>;
-export declare function tryAcquireSidecarReclaimGuard(reclaimGuards: Set<string>, reclaimGuardPath: string): Promise<boolean>;
-export declare function releaseSidecarReclaimGuard(reclaimGuards: Set<string>, reclaimGuardPath: string): Promise<void>;
+export type SidecarReclaimGuard = {
+    assertHeld?(): Promise<void>;
+    release(): Promise<void>;
+};
+export declare function sidecarReclaimGuardExists(pathname: string, lockRoot?: Root): Promise<boolean>;
+export declare function tryAcquireSidecarReclaimGuard(reclaimGuards: Set<string>, pathname: string, lockRoot?: Root): Promise<SidecarReclaimGuard | undefined>;
 export declare function removeStaleSidecarLockIfAllowed(params: {
     lockPath: string;
     normalizedTargetPath: string;
@@ -58,6 +61,8 @@ export declare function removeStaleSidecarLockIfAllowed(params: {
     shouldRemoveStaleLock?: (snapshot: SidecarLockStaleSnapshot) => boolean | Promise<boolean>;
     lockRoot?: Root;
     parsePayload?: (raw: string) => unknown;
+    assertAuthorized?: () => void;
+    assertGuardHeld?: () => Promise<void>;
 }): Promise<"removed" | "changed" | "not-approved">;
 export {};
 //# sourceMappingURL=sidecar-lock-reclaim.d.ts.map

package/dist/sidecar-lock-reclaim.d.ts.map

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

package/dist/sidecar-lock-reclaim.js

@@ -4,10 +4,11 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { readFileDescriptorBoundedSync, readFileHandleBounded } from "./bounded-read.js";
 import { FsSafeError } from "./errors.js";
-import { sameFileIdentity } from "./file-identity.js";
+import { sameFileIdentity, sameFileIdentityForCleanup } from "./file-identity.js";
 import { resolveReadOpenFlags } from "./read-open-flags.js";
 import { openSidecarRoot } from "./sidecar-lock-root.js";
 import { getFsSafeTestHooks } from "./test-hooks.js";
+import { sidecarExclusiveCreate } from "./root-create-input.js";
 const MAX_LOCK_PAYLOAD_BYTES = 1024 * 1024;
 const SIDECAR_LOCK_OWNERSHIP_TOKEN_BYTES = 16;
 const SIDECAR_LOCK_OWNERSHIP_TOKEN_BITS = SIDECAR_LOCK_OWNERSHIP_TOKEN_BYTES * 8;
@@ -204,10 +205,13 @@ export function readSidecarLockRawSnapshotSync(lockPath, options = {}) {
             fsSync.closeSync(fd);
     }
 }
-export function removeSidecarLockIfUnchangedSync(lockPath, observed) {
+export function removeSidecarLockIfUnchangedSync(lockPath, observed, assertAuthorized) {
+    assertAuthorized?.();
     const current = readSidecarLockSnapshotSync(lockPath);
+    assertAuthorized?.();
     if (!current || !sidecarLockSnapshotMatches(current, observed))
         return false;
+    assertAuthorized?.();
     fsSync.rmSync(lockPath);
     return true;
 }
@@ -220,7 +224,9 @@ export function sidecarLockSnapshotMatches(current, observed) {
             readSidecarLockOwnershipToken(observed.raw) === observed.ownershipToken &&
             current.raw === observed.raw);
     }
-    if (observed.stat && current.stat && !sameFileIdentity(observed.stat, current.stat)) {
+    if (observed.stat &&
+        current.stat &&
+        !sameFileIdentityForCleanup(observed.stat, current.stat)) {
         return false;
     }
     if (observed.raw !== undefined) {
@@ -251,41 +257,84 @@ export async function sidecarLockSnapshotStillPresent(lockPath, observed, option
     });
     return !!current && !!observed && sidecarLockSnapshotMatches(current, observed);
 }
-export async function sidecarReclaimGuardExists(pathname) {
+export async function sidecarReclaimGuardExists(pathname, lockRoot) {
     try {
-        fsSync.lstatSync(pathname);
+        if (lockRoot)
+            await lockRoot.stat(relativeSidecarLockPath(lockRoot, pathname));
+        else
+            fsSync.lstatSync(pathname);
         return true;
     }
-    catch (err) {
-        if (err.code === "ENOENT") {
+    catch (error) {
+        const code = error?.code;
+        if (code === "ENOENT" || (lockRoot && code === "not-found"))
             return false;
-        }
-        throw err;
+        throw error;
     }
 }
-export async function tryAcquireSidecarReclaimGuard(reclaimGuards, reclaimGuardPath) {
+export async function tryAcquireSidecarReclaimGuard(reclaimGuards, pathname, lockRoot) {
+    if (lockRoot) {
+        const relative = relativeSidecarLockPath(lockRoot, pathname);
+        const payload = { pid: process.pid, createdAt: new Date().toISOString() };
+        const snapshot = { ...serializeSidecarLockPayload(payload), payload };
+        try {
+            await lockRoot.create(relative, snapshot.raw, { ...sidecarExclusiveCreate, mkdir: false, mode: 0o600, durable: false });
+        }
+        catch (error) {
+            if (error instanceof FsSafeError && error.code === "already-exists")
+                return;
+            // A raw reclaimer can create its directory after our occupancy check.
+            if (error instanceof FsSafeError && error.code === "not-file") {
+                await sidecarReclaimGuardExists(pathname, lockRoot);
+                return;
+            }
+            throw error;
+        }
+        // This attempt owns only its minted token and exact bytes. Root guards
+        // never enter raw exit cleanup; interrupted/ambiguous operations preserve them.
+        let released = false;
+        const changed = () => new FsSafeError("path-mismatch", "sidecar reclaim guard ownership changed");
+        return {
+            async assertHeld() {
+                if (released || !await sidecarLockSnapshotStillPresent(pathname, snapshot, { lockRoot }))
+                    throw changed();
+            },
+            async release() {
+                if (released)
+                    return;
+                if (!await removeSidecarLockIfUnchanged(pathname, snapshot, { lockRoot }))
+                    throw changed();
+                released = true;
+            },
+        };
+    }
     try {
-        await fs.mkdir(reclaimGuardPath);
-        reclaimGuards.add(reclaimGuardPath);
-        return true;
+        await fs.mkdir(pathname);
     }
-    catch (err) {
-        if (err.code === "EEXIST") {
-            return false;
-        }
-        throw err;
+    catch (error) {
+        if (error?.code === "EEXIST")
+            return;
+        throw error;
     }
-}
-export async function releaseSidecarReclaimGuard(reclaimGuards, reclaimGuardPath) {
-    await fs.rmdir(reclaimGuardPath);
-    reclaimGuards.delete(reclaimGuardPath);
+    reclaimGuards.add(pathname);
+    let released = false;
+    return { async release() {
+            if (released)
+                return;
+            await fs.rmdir(pathname);
+            reclaimGuards.delete(pathname);
+            released = true;
+        } };
 }
 export async function removeStaleSidecarLockIfAllowed(params) {
     if (!params.shouldRemoveStaleLock || params.snapshot.raw === undefined) {
         return "not-approved";
     }
     const ioOptions = { lockRoot: params.lockRoot, parsePayload: params.parsePayload };
-    if (!(await sidecarLockSnapshotStillPresent(params.lockPath, params.snapshot, ioOptions))) {
+    params.assertAuthorized?.();
+    const presentBeforeApproval = await sidecarLockSnapshotStillPresent(params.lockPath, params.snapshot, ioOptions);
+    params.assertAuthorized?.();
+    if (!presentBeforeApproval) {
         return "changed";
     }
     if (!(await params.shouldRemoveStaleLock({
@@ -296,12 +345,18 @@ export async function removeStaleSidecarLockIfAllowed(params) {
     }))) {
         return "not-approved";
     }
-    if (!(await sidecarLockSnapshotStillPresent(params.lockPath, params.snapshot, ioOptions))) {
+    params.assertAuthorized?.();
+    const presentBeforeRemoval = await sidecarLockSnapshotStillPresent(params.lockPath, params.snapshot, ioOptions);
+    params.assertAuthorized?.();
+    if (!presentBeforeRemoval) {
         return "changed";
     }
+    if (params.assertGuardHeld)
+        await params.assertGuardHeld();
+    params.assertAuthorized?.();
     try {
         if (params.lockRoot) {
-            await params.lockRoot.remove(relativeSidecarLockPath(params.lockRoot, params.lockPath));
+            await params.lockRoot.remove(relativeSidecarLockPath(params.lockRoot, params.lockPath), { assertBeforeMutation: params.assertAuthorized });
         }
         else {
             await fs.rm(params.lockPath);

package/dist/sidecar-lock-root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidecar-lock-root.d.ts","sourceRoot":"","sources":["../src/sidecar-lock-root.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGvD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,IAAI,EACd,QAAQ,EAAE,MAAM,EAChB,kBAAkB,CAAC,EAAE,UAAU,GAAG,SAAS,EAC3C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACvC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAyD5B"}
+{"version":3,"file":"sidecar-lock-root.d.ts","sourceRoot":"","sources":["../src/sidecar-lock-root.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGvD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,IAAI,EACd,QAAQ,EAAE,MAAM,EAChB,kBAAkB,CAAC,EAAE,UAAU,GAAG,SAAS,EAC3C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACvC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA0D5B"}

package/dist/sidecar-lock-root.js

@@ -61,7 +61,8 @@ export async function openSidecarRoot(lockRoot, relative, discardObservation, on
             }
             catch (probeError) {
                 if (!(probeError instanceof FsSafeError && probeError.code === "not-found") &&
-                    !probe.has(probeError, `stat-leaf-missing:${expectedRealPath}`))
+                    !probe.has(probeError, `stat-leaf-missing:${expectedRealPath}`) &&
+                    !probe.has(probeError, `stat-leaf-changed:${expectedRealPath}`))
                     throw probeError;
             }
             for (const { dir, stat } of parents)

package/dist/sidecar-lock-stale-admission.d.ts

@@ -0,0 +1,39 @@
+import { type SidecarReclaimGuard } from "./sidecar-lock-reclaim.js";
+import { type SidecarLockParserState } from "./sidecar-lock-admission-parser.js";
+import type { Root } from "./root-impl.js";
+import type { SidecarLockAcquireOptions } from "./sidecar-lock-types.js";
+type SidecarAdmissionRunner = {
+    hasToken(): boolean;
+    run<T>(callback: () => T): T;
+};
+type StaleOptions = Pick<SidecarLockAcquireOptions<Record<string, unknown>>, "shouldReclaim" | "shouldRemoveStaleLock" | "staleRecovery">;
+export type SidecarLockStaleOptionsState = {
+    shouldReclaimObserved?: boolean;
+    shouldReclaim?: StaleOptions["shouldReclaim"];
+    shouldRemoveObserved?: boolean;
+    shouldRemove?: StaleOptions["shouldRemoveStaleLock"];
+    staleRecoveryObserved?: boolean;
+    staleRecovery?: StaleOptions["staleRecovery"];
+};
+/** Handle one historical EEXIST attempt while its canonical admission is held. */
+export declare function handleStaleSidecarAdmission<TPayload extends Record<string, unknown>>(params: {
+    admission: SidecarAdmissionRunner;
+    assertToken(): void;
+    currentHeld(): unknown;
+    lockPath: string;
+    lockRoot?: Root;
+    normalizedTargetPath: string;
+    options: SidecarLockAcquireOptions<TPayload>;
+    parserState: SidecarLockParserState;
+    reclaimGuardPath: string;
+    reclaimGuards: Set<string>;
+    setReclaimGuard(guard: SidecarReclaimGuard): void;
+    releaseReclaimGuard(): Promise<void>;
+    staleOptionsState: SidecarLockStaleOptionsState;
+    staleMs: number;
+    withinDenialBudget(): boolean;
+    retryOrRethrowDenial(error: unknown): Promise<void>;
+    waitForRetry(): Promise<void>;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=sidecar-lock-stale-admission.d.ts.map

package/dist/sidecar-lock-stale-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-lock-stale-admission.d.ts","sourceRoot":"","sources":["../src/sidecar-lock-stale-admission.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,mBAAmB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEzE,KAAK,sBAAsB,GAAG;IAC5B,QAAQ,IAAI,OAAO,CAAC;IACpB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CAC9B,CAAC;AAEF,KAAK,YAAY,GAAG,IAAI,CACtB,yBAAyB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAClD,eAAe,GAAG,uBAAuB,GAAG,eAAe,CAC5D,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;IAC9C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC,uBAAuB,CAAC,CAAC;IACrD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;CAC/C,CAAC;AAEF,kFAAkF;AAClF,wBAAsB,2BAA2B,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxF,MAAM,EAAE;IACN,SAAS,EAAE,sBAAsB,CAAC;IAClC,WAAW,IAAI,IAAI,CAAC;IACpB,WAAW,IAAI,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAC7C,WAAW,EAAE,sBAAsB,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClD,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,iBAAiB,EAAE,4BAA4B,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,IAAI,OAAO,CAAC;IAC9B,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,GACA,OAAO,CAAC,IAAI,CAAC,CA0Nf"}