@murphai/murph 0.2.6 → 0.2.10

package/node_modules/@murphai/core/dist/nutrition.js

@@ -0,0 +1,69 @@
+import { NUTRITION_CONFIDENCE_LEVELS, NUTRITION_PROVENANCE_SOURCES, } from "@murphai/contracts";
+import { optionalEnum, optionalString } from "./history/shared.js";
+import { requireObject, optionalFiniteNumber, stripUndefined } from "./bank/shared.js";
+import { VaultError } from "./errors.js";
+export function normalizeNutritionData(value, fieldName) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    const object = requireObject(value, fieldName);
+    if (Object.keys(object).length === 0) {
+        return undefined;
+    }
+    const normalized = stripUndefined({
+        calories: optionalFiniteNumber(object.calories, `${fieldName}.calories`, 0),
+        proteinGrams: optionalFiniteNumber(object.proteinGrams, `${fieldName}.proteinGrams`, 0),
+        carbsGrams: optionalFiniteNumber(object.carbsGrams, `${fieldName}.carbsGrams`, 0),
+        fatGrams: optionalFiniteNumber(object.fatGrams, `${fieldName}.fatGrams`, 0),
+        fiberGrams: optionalFiniteNumber(object.fiberGrams, `${fieldName}.fiberGrams`, 0),
+    });
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+export function normalizeNutritionProvenance(value, fieldName) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    const object = requireObject(value, fieldName);
+    if (Object.keys(object).length === 0) {
+        return undefined;
+    }
+    const source = optionalEnum(object.source, NUTRITION_PROVENANCE_SOURCES, `${fieldName}.source`);
+    if (!source) {
+        throw new VaultError("VAULT_INVALID_INPUT", `${fieldName}.source is required.`);
+    }
+    const normalized = stripUndefined({
+        source,
+        confidence: optionalEnum(object.confidence, NUTRITION_CONFIDENCE_LEVELS, `${fieldName}.confidence`),
+        sourceDetail: optionalString(object.sourceDetail, `${fieldName}.sourceDetail`, 240),
+    });
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+function normalizeWrappedNutrition(value, fieldName, metricField) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    const object = requireObject(value, fieldName);
+    if (Object.keys(object).length === 0) {
+        return undefined;
+    }
+    const provenance = normalizeNutritionProvenance(object.provenance, `${fieldName}.provenance`);
+    if (metricField === "perServing") {
+        const normalized = stripUndefined({
+            perServing: normalizeNutritionData(object.perServing, `${fieldName}.perServing`),
+            provenance,
+        });
+        return Object.keys(normalized).length > 0 ? normalized : undefined;
+    }
+    const normalized = stripUndefined({
+        totals: normalizeNutritionData(object.totals, `${fieldName}.totals`),
+        provenance,
+    });
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+export function normalizeFoodNutrition(value, fieldName) {
+    return normalizeWrappedNutrition(value, fieldName, "perServing");
+}
+export function normalizeMealNutrition(value, fieldName) {
+    return normalizeWrappedNutrition(value, fieldName, "totals");
+}
+//# sourceMappingURL=nutrition.js.map

package/node_modules/@murphai/core/dist/nutrition.js.map

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

package/node_modules/@murphai/core/dist/operations/canonical-resource-lock.d.ts

@@ -0,0 +1,38 @@
+export declare const CANONICAL_RESOURCE_LOCK_DIRECTORY = ".runtime/locks/canonical-resources";
+export declare const CANONICAL_RESOURCE_LOCK_METADATA_BASENAME = "owner.json";
+export interface CanonicalMutationResource {
+    key: string;
+    label: string;
+}
+export interface CanonicalResourceLockMetadata {
+    command: string;
+    host: string;
+    pid: number;
+    resourceKey: string;
+    resourceLabel: string;
+    startedAt: string;
+}
+export interface CanonicalResourceLockHandle {
+    readonly metadata: CanonicalResourceLockMetadata;
+    readonly resource: CanonicalMutationResource;
+    release(): Promise<void>;
+}
+interface AcquireCanonicalResourceLockInput {
+    ownerToken?: string;
+    timeoutMs?: number;
+    resource: CanonicalMutationResource;
+    vaultRoot: string;
+}
+export declare function canonicalPathResource(relativePath: string): CanonicalMutationResource;
+export declare function canonicalLogicalResource(key: string, label?: string): CanonicalMutationResource;
+export declare function dedupeCanonicalResources(resources: readonly CanonicalMutationResource[]): CanonicalMutationResource[];
+export declare function isCanonicalResourceLockScopeActive(vaultRoot: string): boolean;
+export declare function withCanonicalResourceLocks<TResult>(input: {
+    vaultRoot: string;
+    timeoutMs?: number;
+    resources: readonly CanonicalMutationResource[];
+    run: () => Promise<TResult>;
+}): Promise<TResult>;
+export declare function acquireCanonicalResourceLock(input: AcquireCanonicalResourceLockInput): Promise<CanonicalResourceLockHandle>;
+export {};
+//# sourceMappingURL=canonical-resource-lock.d.ts.map

package/node_modules/@murphai/core/dist/operations/canonical-resource-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-resource-lock.d.ts","sourceRoot":"","sources":["../../src/operations/canonical-resource-lock.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,yCAAyC,eAAe,CAAC;AAMtE,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,6BAA6B,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAOD,UAAU,iCAAiC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,yBAAyB,CAMrF;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,yBAAyB,CAc5F;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,yBAAyB,EAAE,GAC9C,yBAAyB,EAAE,CAS7B;AAED,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG7E;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,KAAK,EAAE;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAChD,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B,GAAG,OAAO,CAAC,OAAO,CAAC,CAqCnB;AAED,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,2BAA2B,CAAC,CAqFtC"}

package/node_modules/@murphai/core/dist/operations/canonical-resource-lock.js

@@ -0,0 +1,221 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { createHash, randomUUID } from "node:crypto";
+import { setTimeout as sleep } from "node:timers/promises";
+import { acquireDirectoryLock, buildProcessCommand, DirectoryLockHeldError, fingerprintHost, hashVaultRoot, isProcessRunning, } from "@murphai/runtime-state/node";
+import { VaultError } from "../errors.js";
+import { normalizeRelativeVaultPath, normalizeVaultRoot, resolveVaultPath, } from "../path-safety.js";
+import { toIsoTimestamp } from "../time.js";
+export const CANONICAL_RESOURCE_LOCK_DIRECTORY = ".runtime/locks/canonical-resources";
+export const CANONICAL_RESOURCE_LOCK_METADATA_BASENAME = "owner.json";
+const DEFAULT_CANONICAL_RESOURCE_LOCK_TIMEOUT_MS = 30_000;
+const MAX_CANONICAL_RESOURCE_LOCK_WAIT_MS = 250;
+const CANONICAL_RESOURCE_LOCK_CLEANUP_RETRIES = 8;
+const CANONICAL_RESOURCE_LOCK_CLEANUP_RETRY_DELAY_MS = 25;
+const canonicalResourceLockContextStorage = new AsyncLocalStorage();
+const processCanonicalResourceQueues = new Map();
+export function canonicalPathResource(relativePath) {
+    const normalizedRelativePath = normalizeRelativeVaultPath(relativePath);
+    return {
+        key: `path:${normalizedRelativePath}`,
+        label: normalizedRelativePath,
+    };
+}
+export function canonicalLogicalResource(key, label = key) {
+    const normalizedKey = String(key).trim();
+    const normalizedLabel = String(label).trim();
+    if (normalizedKey.length === 0 || normalizedLabel.length === 0) {
+        throw new VaultError("CANONICAL_RESOURCE_INVALID", "Canonical logical resource keys and labels must be non-empty.");
+    }
+    return {
+        key: `logical:${normalizedKey}`,
+        label: normalizedLabel,
+    };
+}
+export function dedupeCanonicalResources(resources) {
+    const unique = new Map();
+    for (const resource of resources) {
+        if (!unique.has(resource.key)) {
+            unique.set(resource.key, resource);
+        }
+    }
+    return [...unique.values()].sort((left, right) => left.key.localeCompare(right.key));
+}
+export function isCanonicalResourceLockScopeActive(vaultRoot) {
+    const context = canonicalResourceLockContextStorage.getStore();
+    return context?.vaultRoot === normalizeVaultRoot(vaultRoot);
+}
+export async function withCanonicalResourceLocks(input) {
+    const vaultRoot = normalizeVaultRoot(input.vaultRoot);
+    const resources = dedupeCanonicalResources(input.resources);
+    if (resources.length === 0) {
+        return await input.run();
+    }
+    const parentContext = canonicalResourceLockContextStorage.getStore();
+    const ownerToken = parentContext?.vaultRoot === vaultRoot ? parentContext.ownerToken : randomUUID().replace(/-/g, "");
+    const context = parentContext?.vaultRoot === vaultRoot
+        ? parentContext
+        : {
+            ownerToken,
+            vaultRoot,
+        };
+    const acquiredHandles = [];
+    try {
+        for (const resource of resources) {
+            acquiredHandles.push(await acquireCanonicalResourceLock({
+                vaultRoot,
+                resource,
+                timeoutMs: input.timeoutMs,
+                ownerToken,
+            }));
+        }
+        if (parentContext?.vaultRoot === vaultRoot) {
+            return await input.run();
+        }
+        return await canonicalResourceLockContextStorage.run(context, input.run);
+    }
+    finally {
+        await releaseCanonicalResourceLocks(acquiredHandles);
+    }
+}
+export async function acquireCanonicalResourceLock(input) {
+    const vaultRoot = normalizeVaultRoot(input.vaultRoot);
+    const context = canonicalResourceLockContextStorage.getStore();
+    const ownerToken = input.ownerToken ??
+        context?.ownerToken ??
+        randomUUID().replace(/-/g, "");
+    const isReentrantOwner = context?.vaultRoot === vaultRoot && context.ownerToken === ownerToken;
+    const metadata = buildCanonicalResourceLockMetadata(input.resource);
+    const ownerKey = `canonical-resource:${hashVaultRoot(vaultRoot)}:${input.resource.key}:${ownerToken}`;
+    const { lockPath, metadataPath } = resolveCanonicalResourceLockPaths(vaultRoot, input.resource);
+    const queueKey = `${hashVaultRoot(vaultRoot)}:${input.resource.key}`;
+    const releaseQueue = isReentrantOwner
+        ? null
+        : await acquireCanonicalResourceQueueSlot(queueKey);
+    const startedAt = Date.now();
+    let attempt = 0;
+    try {
+        while (true) {
+            try {
+                const handle = await acquireDirectoryLock({
+                    ownerKey,
+                    lockPath,
+                    metadataPath,
+                    metadata,
+                    cleanupRetries: CANONICAL_RESOURCE_LOCK_CLEANUP_RETRIES,
+                    cleanupRetryDelayMs: CANONICAL_RESOURCE_LOCK_CLEANUP_RETRY_DELAY_MS,
+                    parseMetadata(value) {
+                        return isCanonicalResourceLockMetadata(value) ? value : null;
+                    },
+                    invalidMetadataReason: "Canonical resource lock metadata is malformed.",
+                    inspectStale(lockMetadata) {
+                        if (lockMetadata.host === fingerprintHost() && !isProcessRunning(lockMetadata.pid)) {
+                            return `Process ${lockMetadata.pid} is no longer running.`;
+                        }
+                        return null;
+                    },
+                });
+                let released = false;
+                return {
+                    metadata: handle.metadata,
+                    resource: input.resource,
+                    async release() {
+                        if (released) {
+                            return;
+                        }
+                        released = true;
+                        try {
+                            await handle.release();
+                        }
+                        finally {
+                            releaseQueue?.();
+                        }
+                    },
+                };
+            }
+            catch (error) {
+                if (!(error instanceof DirectoryLockHeldError)) {
+                    throw error;
+                }
+                if (Date.now() - startedAt >= (input.timeoutMs ?? DEFAULT_CANONICAL_RESOURCE_LOCK_TIMEOUT_MS)) {
+                    throw new VaultError("CANONICAL_RESOURCE_LOCKED", buildCanonicalResourceLockTimeoutMessage(input.resource, error.inspection.metadata), {
+                        resourceKey: input.resource.key,
+                        resourceLabel: input.resource.label,
+                        metadata: error.inspection.metadata ?? null,
+                    });
+                }
+                const waitMs = Math.min(MAX_CANONICAL_RESOURCE_LOCK_WAIT_MS, 25 * 2 ** Math.min(attempt, 3));
+                attempt += 1;
+                await sleep(waitMs);
+            }
+        }
+    }
+    catch (error) {
+        releaseQueue?.();
+        throw error;
+    }
+}
+async function acquireCanonicalResourceQueueSlot(queueKey) {
+    const prior = processCanonicalResourceQueues.get(queueKey) ?? Promise.resolve();
+    let releaseQueue;
+    const queued = new Promise((resolve) => {
+        releaseQueue = resolve;
+    });
+    const tail = prior.then(() => queued, () => queued);
+    processCanonicalResourceQueues.set(queueKey, tail);
+    await prior.catch(() => undefined);
+    return () => {
+        releaseQueue();
+        if (processCanonicalResourceQueues.get(queueKey) === tail) {
+            processCanonicalResourceQueues.delete(queueKey);
+        }
+    };
+}
+async function releaseCanonicalResourceLocks(handles) {
+    for (const handle of [...handles].reverse()) {
+        await handle.release();
+    }
+}
+function buildCanonicalResourceLockMetadata(resource) {
+    return {
+        command: buildProcessCommand(),
+        host: fingerprintHost(),
+        pid: process.pid,
+        resourceKey: resource.key,
+        resourceLabel: resource.label,
+        startedAt: toIsoTimestamp(new Date(), "startedAt"),
+    };
+}
+function resolveCanonicalResourceLockPaths(vaultRoot, resource) {
+    const resourceHash = createHash("sha1").update(resource.key).digest("hex");
+    const lockRelativePath = `${CANONICAL_RESOURCE_LOCK_DIRECTORY}/${resourceHash}`;
+    const lockPath = resolveVaultPath(vaultRoot, lockRelativePath).absolutePath;
+    const metadataPath = resolveVaultPath(vaultRoot, `${lockRelativePath}/${CANONICAL_RESOURCE_LOCK_METADATA_BASENAME}`).absolutePath;
+    return {
+        lockPath,
+        metadataPath,
+    };
+}
+function buildCanonicalResourceLockTimeoutMessage(resource, metadata) {
+    if (!metadata) {
+        return `Timed out waiting for canonical resource "${resource.label}".`;
+    }
+    return `Timed out waiting for canonical resource "${resource.label}" held by pid=${metadata.pid}, startedAt=${metadata.startedAt}, command=${metadata.command}.`;
+}
+function isCanonicalResourceLockMetadata(value) {
+    return Boolean(value &&
+        typeof value === "object" &&
+        "command" in value &&
+        typeof value.command === "string" &&
+        "host" in value &&
+        typeof value.host === "string" &&
+        "pid" in value &&
+        typeof value.pid === "number" &&
+        Number.isInteger(value.pid) &&
+        "resourceKey" in value &&
+        typeof value.resourceKey === "string" &&
+        "resourceLabel" in value &&
+        typeof value.resourceLabel === "string" &&
+        "startedAt" in value &&
+        typeof value.startedAt === "string");
+}
+//# sourceMappingURL=canonical-resource-lock.js.map

package/node_modules/@murphai/core/dist/operations/canonical-resource-lock.js.map

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

package/node_modules/@murphai/core/dist/operations/canonical-write-lock.d.ts

@@ -25,5 +25,6 @@ export type CanonicalWriteLockInspection = {
     reason: string;
 };
 export declare function inspectCanonicalWriteLock(vaultRoot: string): Promise<CanonicalWriteLockInspection>;
+export declare function withCanonicalWriteLockScope<TResult>(vaultRoot: string, run: () => Promise<TResult>): Promise<TResult>;
 export declare function acquireCanonicalWriteLock(vaultRoot: string): Promise<CanonicalWriteLockHandle>;
 //# sourceMappingURL=canonical-write-lock.d.ts.map

package/node_modules/@murphai/core/dist/operations/canonical-write-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-write-lock.d.ts","sourceRoot":"","sources":["../../src/operations/canonical-write-lock.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,8BAA8B,mCAAmC,CAAC;AAC/E,eAAO,MAAM,kCAAkC,8CAAiD,CAAC;AAEjG,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,OAAO,8BAA8B,CAAC;IAC7D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,MAAM,4BAA4B,GACpC;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,OAAO,8BAA8B,CAAC;CACrD,GACD;IACE,KAAK,EAAE,QAAQ,CAAC;IAChB,YAAY,EAAE,OAAO,8BAA8B,CAAC;IACpD,QAAQ,EAAE,0BAA0B,CAAC;CACtC,GACD;IACE,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,8BAA8B,CAAC;IACpD,QAAQ,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAkEN,wBAAsB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CA0CxG;AAED,wBAAsB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA6EpG"}
+{"version":3,"file":"canonical-write-lock.d.ts","sourceRoot":"","sources":["../../src/operations/canonical-write-lock.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,8BAA8B,mCAAmC,CAAC;AAC/E,eAAO,MAAM,kCAAkC,8CAAiD,CAAC;AAEjG,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,OAAO,8BAA8B,CAAC;IAC7D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAOD,MAAM,MAAM,4BAA4B,GACpC;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,OAAO,8BAA8B,CAAC;CACrD,GACD;IACE,KAAK,EAAE,QAAQ,CAAC;IAChB,YAAY,EAAE,OAAO,8BAA8B,CAAC;IACpD,QAAQ,EAAE,0BAA0B,CAAC;CACtC,GACD;IACE,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,8BAA8B,CAAC;IACpD,QAAQ,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAqEN,wBAAsB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CA0CxG;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EACvD,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAC1B,OAAO,CAAC,OAAO,CAAC,CAelB;AAED,wBAAsB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA4FpG"}

package/node_modules/@murphai/core/dist/operations/canonical-write-lock.js

@@ -1,3 +1,5 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
 import path from "node:path";
 import { acquireDirectoryLock, buildProcessCommand, DirectoryLockHeldError, fingerprintHost, inspectDirectoryLock, isProcessRunning, } from "@murphai/runtime-state/node";
 import { VaultError } from "../errors.js";
@@ -6,6 +8,8 @@ import { toIsoTimestamp } from "../time.js";
 import { isErrnoException, isPlainRecord } from "../types.js";
 export const CANONICAL_WRITE_LOCK_DIRECTORY = ".runtime/locks/canonical-write";
 export const CANONICAL_WRITE_LOCK_METADATA_PATH = `${CANONICAL_WRITE_LOCK_DIRECTORY}/owner.json`;
+const canonicalWriteLockContextStorage = new AsyncLocalStorage();
+const processCanonicalWriteQueues = new Map();
 function buildMetadata() {
     return {
         pid: process.pid,
@@ -90,13 +94,30 @@ export async function inspectCanonicalWriteLock(vaultRoot) {
         metadata: inspection.metadata,
     };
 }
+export async function withCanonicalWriteLockScope(vaultRoot, run) {
+    const absoluteRoot = normalizeVaultRoot(vaultRoot);
+    const parentContext = canonicalWriteLockContextStorage.getStore();
+    if (parentContext?.vaultRoot === absoluteRoot) {
+        return await run();
+    }
+    return await canonicalWriteLockContextStorage.run({
+        ownerToken: randomUUID().replace(/-/g, ""),
+        vaultRoot: absoluteRoot,
+    }, run);
+}
 export async function acquireCanonicalWriteLock(vaultRoot) {
     const absoluteRoot = normalizeVaultRoot(vaultRoot);
+    const context = canonicalWriteLockContextStorage.getStore();
+    const ownerToken = context?.vaultRoot === absoluteRoot
+        ? context.ownerToken
+        : randomUUID().replace(/-/g, "");
+    const isReentrantOwner = context?.vaultRoot === absoluteRoot && context.ownerToken === ownerToken;
+    const releaseQueue = isReentrantOwner ? null : await acquireCanonicalWriteQueueSlot(absoluteRoot);
     const lockPath = resolveVaultPath(absoluteRoot, CANONICAL_WRITE_LOCK_DIRECTORY);
     const metadataPath = resolveVaultPath(absoluteRoot, CANONICAL_WRITE_LOCK_METADATA_PATH);
     try {
         const handle = await acquireDirectoryLock({
-            ownerKey: `canonical-write:${absoluteRoot}`,
+            ownerKey: `canonical-write:${absoluteRoot}:${ownerToken}`,
             lockPath: lockPath.absolutePath,
             metadataPath: metadataPath.absolutePath,
             metadata: buildMetadata(),
@@ -115,10 +136,18 @@ export async function acquireCanonicalWriteLock(vaultRoot) {
         return {
             metadata: handle.metadata,
             relativePath: CANONICAL_WRITE_LOCK_DIRECTORY,
-            release: handle.release,
+            async release() {
+                try {
+                    await handle.release();
+                }
+                finally {
+                    releaseQueue?.();
+                }
+            },
         };
     }
     catch (error) {
+        releaseQueue?.();
         if (error instanceof DirectoryLockHeldError) {
             const inspection = mapDirectoryLockInspection(error.inspection.state === "active"
                 ? {
@@ -161,4 +190,21 @@ export async function acquireCanonicalWriteLock(vaultRoot) {
         throw error;
     }
 }
+async function acquireCanonicalWriteQueueSlot(vaultRoot) {
+    const queueKey = `canonical-write:${vaultRoot}`;
+    const prior = processCanonicalWriteQueues.get(queueKey) ?? Promise.resolve();
+    let releaseQueue;
+    const queued = new Promise((resolve) => {
+        releaseQueue = resolve;
+    });
+    const tail = prior.then(() => queued, () => queued);
+    processCanonicalWriteQueues.set(queueKey, tail);
+    await prior.catch(() => undefined);
+    return () => {
+        releaseQueue();
+        if (processCanonicalWriteQueues.get(queueKey) === tail) {
+            processCanonicalWriteQueues.delete(queueKey);
+        }
+    };
+}
 //# sourceMappingURL=canonical-write-lock.js.map

package/node_modules/@murphai/core/dist/operations/canonical-write-lock.js.map

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

package/node_modules/@murphai/core/dist/operations/index.d.ts

@@ -1,4 +1,6 @@
-export { acquireCanonicalWriteLock, CANONICAL_WRITE_LOCK_DIRECTORY, CANONICAL_WRITE_LOCK_METADATA_PATH, inspectCanonicalWriteLock, } from "./canonical-write-lock.ts";
+export { acquireCanonicalResourceLock, CANONICAL_RESOURCE_LOCK_DIRECTORY, CANONICAL_RESOURCE_LOCK_METADATA_BASENAME, canonicalLogicalResource, canonicalPathResource, dedupeCanonicalResources, isCanonicalResourceLockScopeActive, withCanonicalResourceLocks, } from "./canonical-resource-lock.ts";
+export type { CanonicalMutationResource, CanonicalResourceLockHandle, CanonicalResourceLockMetadata, } from "./canonical-resource-lock.ts";
+export { acquireCanonicalWriteLock, CANONICAL_WRITE_LOCK_DIRECTORY, CANONICAL_WRITE_LOCK_METADATA_PATH, inspectCanonicalWriteLock, withCanonicalWriteLockScope, } from "./canonical-write-lock.ts";
 export type { CanonicalWriteLockHandle, CanonicalWriteLockInspection, CanonicalWriteLockMetadata, } from "./canonical-write-lock.ts";
 export { isProtectedCanonicalPath, listProtectedCanonicalPaths, readRecoverableStoredWriteOperation, isTerminalWriteOperationStatus, listWriteOperationMetadataPaths, readStoredWriteOperation, runCanonicalWrite, WriteBatch, WRITE_OPERATION_DIRECTORY, WRITE_OPERATION_SCHEMA_VERSION, } from "./write-batch.ts";
 export type { RecoverableStoredWriteOperation } from "./write-batch.ts";

package/node_modules/@murphai/core/dist/operations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,kCAAkC,EAClC,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,wBAAwB,EACxB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,mCAAmC,EACnC,8BAA8B,EAC9B,+BAA+B,EAC/B,wBAAwB,EACxB,iBAAiB,EACjB,UAAU,EACV,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,iCAAiC,EACjC,yCAAyC,EACzC,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,kCAAkC,EAClC,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,kCAAkC,EAClC,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,wBAAwB,EACxB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,mCAAmC,EACnC,8BAA8B,EAC9B,+BAA+B,EAC/B,wBAAwB,EACxB,iBAAiB,EACjB,UAAU,EACV,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC"}

package/node_modules/@murphai/core/dist/operations/index.js

@@ -1,3 +1,4 @@
-export { acquireCanonicalWriteLock, CANONICAL_WRITE_LOCK_DIRECTORY, CANONICAL_WRITE_LOCK_METADATA_PATH, inspectCanonicalWriteLock, } from "./canonical-write-lock.js";
+export { acquireCanonicalResourceLock, CANONICAL_RESOURCE_LOCK_DIRECTORY, CANONICAL_RESOURCE_LOCK_METADATA_BASENAME, canonicalLogicalResource, canonicalPathResource, dedupeCanonicalResources, isCanonicalResourceLockScopeActive, withCanonicalResourceLocks, } from "./canonical-resource-lock.js";
+export { acquireCanonicalWriteLock, CANONICAL_WRITE_LOCK_DIRECTORY, CANONICAL_WRITE_LOCK_METADATA_PATH, inspectCanonicalWriteLock, withCanonicalWriteLockScope, } from "./canonical-write-lock.js";
 export { isProtectedCanonicalPath, listProtectedCanonicalPaths, readRecoverableStoredWriteOperation, isTerminalWriteOperationStatus, listWriteOperationMetadataPaths, readStoredWriteOperation, runCanonicalWrite, WriteBatch, WRITE_OPERATION_DIRECTORY, WRITE_OPERATION_SCHEMA_VERSION, } from "./write-batch.js";
 //# sourceMappingURL=index.js.map

package/node_modules/@murphai/core/dist/operations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,kCAAkC,EAClC,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,mCAAmC,EACnC,8BAA8B,EAC9B,+BAA+B,EAC/B,wBAAwB,EACxB,iBAAiB,EACjB,UAAU,EACV,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,iCAAiC,EACjC,yCAAyC,EACzC,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,kCAAkC,EAClC,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC;AAMtC,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,kCAAkC,EAClC,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,mCAAmC,EACnC,8BAA8B,EAC9B,+BAA+B,EAC/B,wBAAwB,EACxB,iBAAiB,EACjB,UAAU,EACV,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC"}

package/node_modules/@murphai/core/dist/operations/write-batch.js

@@ -657,7 +657,7 @@ export class WriteBatch {
             throw error;
         }
         finally {
-            await lock.release();
+            await lock?.release();
         }
     }
     async rollback() {
@@ -672,7 +672,7 @@ export class WriteBatch {
             await this.cleanupStageArtifacts();
         }
         finally {
-            await lock.release();
+            await lock?.release();
         }
     }
     assertMutable() {