@indigoai-us/hq-cloud 6.15.75 → 6.15.77

package/dist/sync/path-leases.d.ts

@@ -0,0 +1,31 @@
+import type { AreaId, CanonicalPath } from "./sync-work.js";
+export type PathLeaseRequest = {
+    targetUid: string;
+    areaId: AreaId;
+    canonicalPath: CanonicalPath;
+    mode: "mutation";
+};
+export type PathLeaseSnapshot = PathLeaseRequest & {
+    owner: string;
+};
+export declare function assertCanonicalPath(path: CanonicalPath): void;
+export declare function pathsConflict(left: CanonicalPath, right: CanonicalPath): boolean;
+/**
+ * Parent-owned mutation claims. Acquisition is intentionally synchronous and
+ * all-or-none: callers either own every path in a slice or none of them.
+ */
+export declare class PathLeaseManager {
+    private readonly held;
+    private nextLeaseId;
+    tryAcquire(owner: string, requested: readonly PathLeaseRequest[]): PathLease | undefined;
+    inspect(): readonly PathLeaseSnapshot[];
+    release(ids: readonly string[]): void;
+}
+export declare class PathLease {
+    private readonly manager;
+    private readonly ids;
+    private released;
+    constructor(manager: PathLeaseManager, ids: readonly string[]);
+    release(): void;
+}
+//# sourceMappingURL=path-leases.d.ts.map

package/dist/sync/path-leases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-leases.d.ts","sourceRoot":"","sources":["../../src/sync/path-leases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAU7D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAEhF;AAeD;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAC7D,OAAO,CAAC,WAAW,CAAK;IAExB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,GAAG,SAAS;IAyBxF,OAAO,IAAI,SAAS,iBAAiB,EAAE;IAIvC,OAAO,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;CAGtC;AAED,qBAAa,SAAS;IAIlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,QAAQ,CAAS;gBAGN,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,SAAS,MAAM,EAAE;IAGzC,OAAO,IAAI,IAAI;CAKhB"}

package/dist/sync/path-leases.js

@@ -0,0 +1,74 @@
+export function assertCanonicalPath(path) {
+    if (path.length === 0 ||
+        path.startsWith("/") ||
+        path.endsWith("/") ||
+        path.includes("\\") ||
+        path.split("/").some((part) => part.length === 0 || part === "." || part === "..")) {
+        throw new Error(`path lease requires a canonical relative path: ${path}`);
+    }
+}
+export function pathsConflict(left, right) {
+    return left === right || left.startsWith(`${right}/`) || right.startsWith(`${left}/`);
+}
+function sameResource(left, right) {
+    return left.targetUid === right.targetUid && left.areaId === right.areaId;
+}
+function compareRequests(left, right) {
+    return (left.targetUid.localeCompare(right.targetUid) ||
+        left.areaId.localeCompare(right.areaId) ||
+        left.canonicalPath.localeCompare(right.canonicalPath) ||
+        left.mode.localeCompare(right.mode));
+}
+/**
+ * Parent-owned mutation claims. Acquisition is intentionally synchronous and
+ * all-or-none: callers either own every path in a slice or none of them.
+ */
+export class PathLeaseManager {
+    held = new Map();
+    nextLeaseId = 1;
+    tryAcquire(owner, requested) {
+        if (owner.length === 0)
+            throw new Error("path lease owner is required");
+        const normalized = [...requested].sort(compareRequests);
+        for (const request of normalized)
+            assertCanonicalPath(request.canonicalPath);
+        const all = [...this.held.values()];
+        for (let index = 0; index < normalized.length; index += 1) {
+            const request = normalized[index];
+            if (all.some((lease) => sameResource(lease, request) && pathsConflict(lease.canonicalPath, request.canonicalPath)) ||
+                normalized.slice(0, index).some((other) => sameResource(other, request) && pathsConflict(other.canonicalPath, request.canonicalPath))) {
+                return undefined;
+            }
+        }
+        const ids = [];
+        for (const request of normalized) {
+            const id = `${this.nextLeaseId++}`;
+            this.held.set(id, { ...request, owner });
+            ids.push(id);
+        }
+        return new PathLease(this, ids);
+    }
+    inspect() {
+        return [...this.held.values()].sort((left, right) => compareRequests(left, right));
+    }
+    release(ids) {
+        for (const id of ids)
+            this.held.delete(id);
+    }
+}
+export class PathLease {
+    manager;
+    ids;
+    released = false;
+    constructor(manager, ids) {
+        this.manager = manager;
+        this.ids = ids;
+    }
+    release() {
+        if (this.released)
+            return;
+        this.released = true;
+        this.manager.release(this.ids);
+    }
+}
+//# sourceMappingURL=path-leases.js.map

package/dist/sync/path-leases.js.map

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

package/dist/sync/path-leases.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=path-leases.test.d.ts.map

package/dist/sync/path-leases.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-leases.test.d.ts","sourceRoot":"","sources":["../../src/sync/path-leases.test.ts"],"names":[],"mappings":""}

package/dist/sync/path-leases.test.js

@@ -0,0 +1,51 @@
+import { describe, expect, it } from "vitest";
+import { PathLeaseManager, pathsConflict } from "./path-leases.js";
+const request = (canonicalPath) => ({
+    targetUid: "personal",
+    areaId: "root:notes",
+    canonicalPath,
+    mode: "mutation",
+});
+describe("PathLeaseManager", () => {
+    it("acquires all paths atomically in deterministic order", () => {
+        const leases = new PathLeaseManager();
+        const first = leases.tryAcquire("first", [request("notes/b"), request("notes/a")]);
+        expect(first).toBeDefined();
+        expect(leases.inspect().map((entry) => entry.canonicalPath)).toEqual(["notes/a", "notes/b"]);
+        expect(leases.tryAcquire("second", [request("elsewhere"), request("notes/a/today")])).toBeUndefined();
+        expect(leases.inspect().map((entry) => entry.canonicalPath)).toEqual(["notes/a", "notes/b"]);
+        first?.release();
+        expect(leases.tryAcquire("second", [request("elsewhere"), request("notes/a/today")])).toBeDefined();
+        const empty = new PathLeaseManager();
+        expect(empty.tryAcquire("invalid-slice", [request("folder"), request("folder/child")])).toBeUndefined();
+        expect(empty.inspect()).toEqual([]);
+    });
+    it("uses exact ancestor-prefix semantics", () => {
+        expect(pathsConflict("a", "a")).toBe(true);
+        expect(pathsConflict("a", "a/b")).toBe(true);
+        expect(pathsConflict("a/b", "a")).toBe(true);
+        expect(pathsConflict("a", "ab")).toBe(false);
+    });
+    it("matches a randomized prefix model", () => {
+        let seed = 0x51c0ffee;
+        const next = () => {
+            seed = (seed * 1_664_525 + 1_013_904_223) >>> 0;
+            return seed;
+        };
+        const segment = () => String.fromCharCode(97 + (next() % 5));
+        const makePath = () => Array.from({ length: 1 + (next() % 4) }, segment).join("/");
+        for (let trial = 0; trial < 100; trial += 1) {
+            const manager = new PathLeaseManager();
+            const held = [];
+            for (let attempt = 0; attempt < 30; attempt += 1) {
+                const path = makePath();
+                const expected = !held.some((other) => pathsConflict(path, other));
+                const lease = manager.tryAcquire(`owner-${trial}-${attempt}`, [request(path)]);
+                expect(lease !== undefined).toBe(expected);
+                if (lease)
+                    held.push(path);
+            }
+        }
+    });
+});
+//# sourceMappingURL=path-leases.test.js.map

package/dist/sync/path-leases.test.js.map

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

package/dist/sync/state-store.d.ts

@@ -18,6 +18,10 @@ export declare function setStateStoreReflinkCopyHookForTest(hook: (() => void) |
 export declare function setStateStorePositionalWriteForTest(write: ((fd: number, bytes: Buffer, offset: number, length: number, position: number) => number) | undefined): void;
 /** Test-only seam for rotation-claim PID write failures. */
 export declare function setStateStoreRotationClaimWriteHookForTest(hook: (() => void) | undefined): void;
+/** Test-only seam for proving same-process async lock waiters queue cooperatively. */
+export declare function setStateStoreScopeLockAcquiredHookForTest(hook: (() => void | Promise<void>) | undefined): void;
+/** Test-only seam for exercising async lock deadlines without a minute-long wait. */
+export declare function setStateStoreAsyncLockTimeoutForTest(timeoutMs: number | undefined): void;
 export interface StateStoreRecord<T = unknown> {
     sequence: number;
     type: number;
@@ -81,6 +85,9 @@ export interface StateStoreMaintenanceOptions {
 export declare class StateStoreCorruptionError extends Error {
     constructor(message: string, options?: ErrorOptions);
 }
+export declare class StateStoreLockError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
 /** A recovered v3 store. `append` is the ordinary hot path. */
 export declare class StateStore<T> {
     private readonly options;

package/dist/sync/state-store.d.ts.map

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

package/dist/sync/state-store.js

@@ -37,7 +37,10 @@ const FRAME_FIXED_BODY_BYTES = 8 + 2 + 2 + 4 + 4 + 32;
 const MAX_FRAME_BYTES = 256 * 1024 * 1024;
 const DEFAULT_MAX_WAL_BYTES_BEFORE_COMPACTION = 16 * 1024 * 1024;
 const LOCK_RETRY_MS = 10;
-const LOCK_TIMEOUT_MS = 5_000;
+// A synchronous caller can only be blocked by another process. Keep that
+// exceptional event-loop pause bounded; async callers wait without parking.
+const SYNC_LOCK_TIMEOUT_MS = 5_000;
+const ASYNC_LOCK_TIMEOUT_MS = 60_000;
 const REPLACE_STATE_MAX_ATTEMPTS = 3;
 const OPTIMISTIC_RECOVERY_MAX_RESAMPLES = 3;
 // Test instrumentation for materialisation regressions. Kept at the storage
@@ -52,6 +55,8 @@ let afterGenerationStageHookForTest;
 let reflinkCopyHookForTest;
 let positionalWriteForTest;
 let rotationClaimWriteHookForTest;
+let scopeLockAcquiredHookForTest;
+let asyncLockTimeoutMsForTest;
 export function resetStateStoreSnapshotRecoveryCountForTest() {
     snapshotRecoveryCount = 0;
 }
@@ -98,13 +103,21 @@ export function setStateStorePositionalWriteForTest(write) {
 export function setStateStoreRotationClaimWriteHookForTest(hook) {
     rotationClaimWriteHookForTest = hook;
 }
+/** Test-only seam for proving same-process async lock waiters queue cooperatively. */
+export function setStateStoreScopeLockAcquiredHookForTest(hook) {
+    scopeLockAcquiredHookForTest = hook;
+}
+/** Test-only seam for exercising async lock deadlines without a minute-long wait. */
+export function setStateStoreAsyncLockTimeoutForTest(timeoutMs) {
+    asyncLockTimeoutMsForTest = timeoutMs;
+}
 export class StateStoreCorruptionError extends Error {
     constructor(message, options) {
         super(`state-store corruption: ${message}`, options);
         this.name = "StateStoreCorruptionError";
     }
 }
-class StateStoreLockError extends Error {
+export class StateStoreLockError extends Error {
     constructor(message, options) {
         super(`state-store lock: ${message}`, options);
         this.name = "StateStoreLockError";
@@ -1469,7 +1482,7 @@ function readIntoSync(fd, target, position) {
 }
 function withScopeLock(dir, action) {
     const lockPath = path.join(dir, "append.lock");
-    const deadline = Date.now() + LOCK_TIMEOUT_MS;
+    const deadline = Date.now() + SYNC_LOCK_TIMEOUT_MS;
     let fd;
     while (fd === undefined) {
         try {
@@ -1577,53 +1590,101 @@ function withRotationClaim(dir, action) {
         throw actionError;
     return result;
 }
+const inProcessAsyncScopeLocks = new Map();
 /**
- * Acquire the same inter-process lock without parking the Node event loop
- * while another writer owns it. This is deliberately additive: pass-side
- * callers continue using {@link withScopeLock}'s synchronous contract.
+ * Serialize async acquisitions for one process before they reach append.lock.
+ *
+ * A synchronous state-store operation cannot await this queue. The async lock
+ * implementation below therefore performs every operation after the lock file
+ * is created synchronously: no async owner can leave append.lock behind while
+ * the event loop runs a synchronous contender.
  */
-async function withScopeLockAsync(dir, action) {
-    const lockPath = path.join(dir, "append.lock");
-    const deadline = Date.now() + LOCK_TIMEOUT_MS;
-    let handle;
-    while (handle === undefined) {
-        try {
-            handle = await fs.promises.open(lockPath, "wx");
-            await handle.writeFile(String(process.pid));
-            await handle.datasync();
+async function withInProcessAsyncScopeLock(dir, action) {
+    const key = path.resolve(dir);
+    const predecessor = inProcessAsyncScopeLocks.get(key) ?? Promise.resolve();
+    let release;
+    const tail = new Promise((resolve) => {
+        release = resolve;
+    });
+    const queueTail = predecessor.then(() => tail, () => tail);
+    inProcessAsyncScopeLocks.set(key, queueTail);
+    await predecessor.catch(() => undefined);
+    try {
+        return await action();
+    }
+    finally {
+        release();
+        if (inProcessAsyncScopeLocks.get(key) === queueTail) {
+            inProcessAsyncScopeLocks.delete(key);
         }
-        catch (error) {
-            if (!isAlreadyExists(error)) {
-                throw new StateStoreLockError(`cannot acquire ${lockPath}`, { cause: error });
-            }
-            if (await removeDeadLockAsync(lockPath))
-                continue;
+    }
+}
+function openExclusiveAsync(lockPath) {
+    return new Promise((resolve, reject) => {
+        fs.open(lockPath, "wx", (error, fd) => {
+            if (error)
+                reject(error);
+            else
+                resolve(fd);
+        });
+    });
+}
+/** Acquire append.lock without yielding after this process owns the file. */
+async function withScopeLockAsync(dir, action) {
+    // This deadline starts when the caller enters the same-process queue, not
+    // when it reaches the head. Otherwise each queued caller can spend a fresh
+    // timeout behind a live foreign lock, turning one contention window into an
+    // unbounded same-process backlog.
+    const deadline = Date.now() + (asyncLockTimeoutMsForTest ?? ASYNC_LOCK_TIMEOUT_MS);
+    return withInProcessAsyncScopeLock(dir, async () => {
+        const lockPath = path.join(dir, "append.lock");
+        let fd;
+        while (fd === undefined) {
             if (Date.now() >= deadline) {
                 throw new StateStoreLockError(`timed out acquiring ${lockPath}`);
             }
-            await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_MS));
+            try {
+                fd = await openExclusiveAsync(lockPath);
+                fs.writeFileSync(fd, String(process.pid));
+                fs.fdatasyncSync(fd);
+            }
+            catch (error) {
+                if (!isAlreadyExists(error)) {
+                    throw new StateStoreLockError(`cannot acquire ${lockPath}`, { cause: error });
+                }
+                if (await removeDeadLockAsync(lockPath))
+                    continue;
+                if (Date.now() >= deadline) {
+                    throw new StateStoreLockError(`timed out acquiring ${lockPath}`);
+                }
+                await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_MS));
+            }
         }
-    }
-    let result;
-    let actionError;
-    try {
-        result = await action();
-    }
-    catch (error) {
-        actionError = error;
-    }
-    finally {
-        await handle.close();
-    }
-    try {
-        await fs.promises.unlink(lockPath);
-    }
-    catch (error) {
-        throw new StateStoreLockError(`cannot release ${lockPath}`, { cause: error });
-    }
-    if (actionError !== undefined)
-        throw actionError;
-    return result;
+        let result;
+        let actionError;
+        try {
+            // All production callers supply a synchronous critical section. Keeping
+            // this turn-free is what prevents a sync waiter from observing our PID.
+            if (scopeLockAcquiredHookForTest)
+                await scopeLockAcquiredHookForTest();
+            result = action();
+        }
+        catch (error) {
+            actionError = error;
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        try {
+            fs.unlinkSync(lockPath);
+        }
+        catch (error) {
+            throw new StateStoreLockError(`cannot release ${lockPath}`, { cause: error });
+        }
+        if (actionError !== undefined)
+            throw actionError;
+        return result;
+    });
 }
 function removeDeadLock(lockPath) {
     let pid;