niceeval 0.12.2-canary.31 → 0.13.0

package/dist/coordination/host/types.d.mts

@@ -0,0 +1,37 @@
+import type { Effect } from "effect";
+import type { RecordRoot } from "../../record/platform/root.mjs";
+import type { CaseLockEffectClaim, CaseLockRecord } from "../../runner/lock.mjs";
+import type { GateLeaseEffectClaim, GateLeaseRecord } from "../../runner/gate-lease.mjs";
+import type { RecordCoordination, RecordCoordinationError, RecordLease } from "../record-leases.mjs";
+/**
+ * One short-lived execution claim. It owns only local scheduling state and
+ * never grants access to a portable Record writer.
+ */
+export interface ExecutionClaim {
+    readonly caseClaim: CaseLockEffectClaim;
+    readonly gateClaim?: GateLeaseEffectClaim;
+    readonly caseTakenOver: boolean;
+    readonly gateTakenOver?: boolean;
+    readonly release: Effect.Effect<void, unknown>;
+}
+/** Input is rooted in project-local `.niceeval`, never in the portable Record root. */
+export interface ClaimExecutionRequest {
+    readonly localRoot: string;
+    readonly experimentId: string;
+    readonly evalId: string;
+    readonly maxConcurrency?: number;
+    readonly identity?: {
+        readonly pid: number;
+        readonly host: string;
+    };
+    readonly signal?: AbortSignal;
+    readonly onCaseWait?: (holder: CaseLockRecord) => void;
+    readonly onGateWait?: (holders: readonly GateLeaseRecord[]) => void;
+}
+/** Narrow coordination operations shared by the Record and command hosts. */
+export interface CoordinationHostSDK {
+    readonly claimExecution: (request: ClaimExecutionRequest) => Effect.Effect<ExecutionClaim, unknown>;
+    readonly enterRecordRead: (root: RecordRoot) => Effect.Effect<RecordLease, RecordCoordinationError, import("effect").Scope.Scope | RecordCoordination>;
+    readonly enterRecordAppend: (root: RecordRoot) => Effect.Effect<RecordLease, RecordCoordinationError, import("effect").Scope.Scope | RecordCoordination>;
+    readonly enterRecordMaintenance: (root: RecordRoot) => Effect.Effect<RecordLease, RecordCoordinationError, import("effect").Scope.Scope | RecordCoordination>;
+}

package/dist/coordination/host/types.d.ts

@@ -0,0 +1,37 @@
+import type { Effect } from "effect";
+import type { RecordRoot } from "../../record/platform/root.js";
+import type { CaseLockEffectClaim, CaseLockRecord } from "../../runner/lock.js";
+import type { GateLeaseEffectClaim, GateLeaseRecord } from "../../runner/gate-lease.js";
+import type { RecordCoordination, RecordCoordinationError, RecordLease } from "../record-leases.js";
+/**
+ * One short-lived execution claim. It owns only local scheduling state and
+ * never grants access to a portable Record writer.
+ */
+export interface ExecutionClaim {
+    readonly caseClaim: CaseLockEffectClaim;
+    readonly gateClaim?: GateLeaseEffectClaim;
+    readonly caseTakenOver: boolean;
+    readonly gateTakenOver?: boolean;
+    readonly release: Effect.Effect<void, unknown>;
+}
+/** Input is rooted in project-local `.niceeval`, never in the portable Record root. */
+export interface ClaimExecutionRequest {
+    readonly localRoot: string;
+    readonly experimentId: string;
+    readonly evalId: string;
+    readonly maxConcurrency?: number;
+    readonly identity?: {
+        readonly pid: number;
+        readonly host: string;
+    };
+    readonly signal?: AbortSignal;
+    readonly onCaseWait?: (holder: CaseLockRecord) => void;
+    readonly onGateWait?: (holders: readonly GateLeaseRecord[]) => void;
+}
+/** Narrow coordination operations shared by the Record and command hosts. */
+export interface CoordinationHostSDK {
+    readonly claimExecution: (request: ClaimExecutionRequest) => Effect.Effect<ExecutionClaim, unknown>;
+    readonly enterRecordRead: (root: RecordRoot) => Effect.Effect<RecordLease, RecordCoordinationError, import("effect").Scope.Scope | RecordCoordination>;
+    readonly enterRecordAppend: (root: RecordRoot) => Effect.Effect<RecordLease, RecordCoordinationError, import("effect").Scope.Scope | RecordCoordination>;
+    readonly enterRecordMaintenance: (root: RecordRoot) => Effect.Effect<RecordLease, RecordCoordinationError, import("effect").Scope.Scope | RecordCoordination>;
+}

package/dist/coordination/identity.cjs

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordCoordinationIdentity = recordCoordinationIdentity;
+const node_crypto_1 = require("node:crypto");
+const node_path_1 = require("node:path");
+const root_ts_1 = require("../record/platform/root.cjs");
+const identities = new WeakMap();
+function recordKeyForPortableRoot(portableRoot) {
+    // The root has already been lexically canonicalized by makeRecordRoot(). A
+    // fixed digest keeps local paths opaque and avoids embedding host paths in
+    // portable state or user-facing diagnostics.
+    return (0, node_crypto_1.createHash)("sha256")
+        .update(portableRoot, "utf8")
+        .digest("hex")
+        .slice(0, 32);
+}
+function localStateRootFor(portableRoot, recordKey) {
+    const recordParent = (0, node_path_1.dirname)(portableRoot);
+    const coordinationRoot = (0, node_path_1.basename)(recordParent) === ".niceeval"
+        ? (0, node_path_1.join)(recordParent, "coordination")
+        : (0, node_path_1.join)(recordParent, ".niceeval", "coordination");
+    return (0, node_path_1.join)(coordinationRoot, "records", recordKey);
+}
+/**
+ * Returns the one local sidecar directory for an issued RecordRoot. A forged
+ * object does not receive an identity and must be rejected by the platform.
+ */
+function recordCoordinationIdentity(root) {
+    if (typeof root !== "object" || root === null) {
+        return undefined;
+    }
+    const cached = identities.get(root);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const paths = (0, root_ts_1.recordRootPaths)(root);
+    if (paths === undefined) {
+        return undefined;
+    }
+    const recordKey = recordKeyForPortableRoot(paths.portableRoot);
+    const identity = Object.freeze({
+        recordKey,
+        localStateRoot: localStateRootFor(paths.portableRoot, recordKey),
+    });
+    identities.set(root, identity);
+    return identity;
+}
+//# sourceMappingURL=identity.cjs.map

package/dist/coordination/identity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["identity.ts"],"names":[],"mappings":";;AAkCA,gEAmBC;AArDD,6CAAyC;AACzC,yCAAoD;AAEpD,wDAA6D;AAU7D,MAAM,UAAU,GAAG,IAAI,OAAO,EAAsC,CAAC;AACrE,SAAS,wBAAwB,CAAC,YAAoB;IAClD,2EAA2E;IAC3E,2EAA2E;IAC3E,6CAA6C;IAC7C,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC;SACtB,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC;SAC5B,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC;AACD,SAAS,iBAAiB,CAAC,YAAoB,EAAE,SAAiB;IAC9D,MAAM,YAAY,GAAG,IAAA,mBAAO,EAAC,YAAY,CAAC,CAAC;IAC3C,MAAM,gBAAgB,GAAG,IAAA,oBAAQ,EAAC,YAAY,CAAC,KAAK,WAAW;QAC3D,CAAC,CAAC,IAAA,gBAAI,EAAC,YAAY,EAAE,cAAc,CAAC;QACpC,CAAC,CAAC,IAAA,gBAAI,EAAC,YAAY,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IACtD,OAAO,IAAA,gBAAI,EAAC,gBAAgB,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC;AACD;;;GAGG;AACH,SAAgB,0BAA0B,CAAC,IAAa;IACpD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,IAAA,yBAAe,EAAC,IAAkB,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;QAC3B,SAAS;QACT,cAAc,EAAE,iBAAiB,CAAC,KAAK,CAAC,YAAY,EAAE,SAAS,CAAC;KACnE,CAAC,CAAC;IACH,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,QAAQ,CAAC;AACpB,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { basename, dirname, join } from \"node:path\";\nimport type { RecordRoot } from \"../record/platform/root.ts\";\nimport { recordRootPaths } from \"../record/platform/root.ts\";\n/**\n * Host-local identity for one canonical Record root. It intentionally never\n * becomes portable Record data: the durable `recordId` is checked separately\n * by the lease platform once `record.json` has been read.\n */\nexport interface RecordCoordinationIdentity {\n    readonly recordKey: string;\n    readonly localStateRoot: string;\n}\nconst identities = new WeakMap<object, RecordCoordinationIdentity>();\nfunction recordKeyForPortableRoot(portableRoot: string): string {\n    // The root has already been lexically canonicalized by makeRecordRoot(). A\n    // fixed digest keeps local paths opaque and avoids embedding host paths in\n    // portable state or user-facing diagnostics.\n    return createHash(\"sha256\")\n        .update(portableRoot, \"utf8\")\n        .digest(\"hex\")\n        .slice(0, 32);\n}\nfunction localStateRootFor(portableRoot: string, recordKey: string): string {\n    const recordParent = dirname(portableRoot);\n    const coordinationRoot = basename(recordParent) === \".niceeval\"\n        ? join(recordParent, \"coordination\")\n        : join(recordParent, \".niceeval\", \"coordination\");\n    return join(coordinationRoot, \"records\", recordKey);\n}\n/**\n * Returns the one local sidecar directory for an issued RecordRoot. A forged\n * object does not receive an identity and must be rejected by the platform.\n */\nexport function recordCoordinationIdentity(root: unknown): RecordCoordinationIdentity | undefined {\n    if (typeof root !== \"object\" || root === null) {\n        return undefined;\n    }\n    const cached = identities.get(root);\n    if (cached !== undefined) {\n        return cached;\n    }\n    const paths = recordRootPaths(root as RecordRoot);\n    if (paths === undefined) {\n        return undefined;\n    }\n    const recordKey = recordKeyForPortableRoot(paths.portableRoot);\n    const identity = Object.freeze({\n        recordKey,\n        localStateRoot: localStateRootFor(paths.portableRoot, recordKey),\n    });\n    identities.set(root, identity);\n    return identity;\n}\n"]}

package/dist/coordination/identity.d.cts

@@ -0,0 +1,14 @@
+/**
+ * Host-local identity for one canonical Record root. It intentionally never
+ * becomes portable Record data: the durable `recordId` is checked separately
+ * by the lease platform once `record.json` has been read.
+ */
+export interface RecordCoordinationIdentity {
+    readonly recordKey: string;
+    readonly localStateRoot: string;
+}
+/**
+ * Returns the one local sidecar directory for an issued RecordRoot. A forged
+ * object does not receive an identity and must be rejected by the platform.
+ */
+export declare function recordCoordinationIdentity(root: unknown): RecordCoordinationIdentity | undefined;

package/dist/coordination/identity.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Host-local identity for one canonical Record root. It intentionally never
+ * becomes portable Record data: the durable `recordId` is checked separately
+ * by the lease platform once `record.json` has been read.
+ */
+export interface RecordCoordinationIdentity {
+    readonly recordKey: string;
+    readonly localStateRoot: string;
+}
+/**
+ * Returns the one local sidecar directory for an issued RecordRoot. A forged
+ * object does not receive an identity and must be rejected by the platform.
+ */
+export declare function recordCoordinationIdentity(root: unknown): RecordCoordinationIdentity | undefined;

package/dist/coordination/identity.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Host-local identity for one canonical Record root. It intentionally never
+ * becomes portable Record data: the durable `recordId` is checked separately
+ * by the lease platform once `record.json` has been read.
+ */
+export interface RecordCoordinationIdentity {
+    readonly recordKey: string;
+    readonly localStateRoot: string;
+}
+/**
+ * Returns the one local sidecar directory for an issued RecordRoot. A forged
+ * object does not receive an identity and must be rejected by the platform.
+ */
+export declare function recordCoordinationIdentity(root: unknown): RecordCoordinationIdentity | undefined;

package/dist/coordination/identity.js

@@ -0,0 +1,6 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./identity.cjs");
+const __niceevalExport0 = __niceevalCanonical["recordCoordinationIdentity"];
+export { __niceevalExport0 as recordCoordinationIdentity };
+//# sourceMappingURL=identity.js.map

package/dist/coordination/index.cjs

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./identity.cjs"), exports);
+__exportStar(require("./record-leases.cjs"), exports);
+__exportStar(require("./platform/index.cjs"), exports);
+__exportStar(require("./host/index.cjs"), exports);
+__exportStar(require("./identity.cjs"), exports);
+__exportStar(require("./record-leases.cjs"), exports);
+//# sourceMappingURL=index.cjs.map

package/dist/coordination/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,qDAAmC;AACnC,sDAAoC;AACpC,kDAAgC;AAChC,gDAA8B;AAC9B,qDAAmC","sourcesContent":["export * from \"./identity.ts\";\nexport * from \"./record-leases.ts\";\nexport * from \"./platform/index.ts\";\nexport * from \"./host/index.ts\";\nexport * from \"./identity.ts\";\nexport * from \"./record-leases.ts\";\n"]}

package/dist/coordination/index.d.cts

@@ -0,0 +1,6 @@
+export * from "./identity.cjs";
+export * from "./record-leases.cjs";
+export * from "./platform/index.cjs";
+export * from "./host/index.cjs";
+export * from "./identity.cjs";
+export * from "./record-leases.cjs";

package/dist/coordination/index.d.mts

@@ -0,0 +1,6 @@
+export * from "./identity.mjs";
+export * from "./record-leases.mjs";
+export * from "./platform/index.mjs";
+export * from "./host/index.mjs";
+export * from "./identity.mjs";
+export * from "./record-leases.mjs";

package/dist/coordination/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./identity.js";
+export * from "./record-leases.js";
+export * from "./platform/index.js";
+export * from "./host/index.js";
+export * from "./identity.js";
+export * from "./record-leases.js";

package/dist/coordination/index.js

@@ -0,0 +1,16 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./index.cjs");
+const __niceevalExport0 = __niceevalCanonical["NodeRecordCoordinationLive"];
+export { __niceevalExport0 as NodeRecordCoordinationLive };
+const __niceevalExport1 = __niceevalCanonical["RecordCoordination"];
+export { __niceevalExport1 as RecordCoordination };
+const __niceevalExport2 = __niceevalCanonical["coordinationHost"];
+export { __niceevalExport2 as coordinationHost };
+const __niceevalExport3 = __niceevalCanonical["issueRecordLease"];
+export { __niceevalExport3 as issueRecordLease };
+const __niceevalExport4 = __niceevalCanonical["recordCoordinationIdentity"];
+export { __niceevalExport4 as recordCoordinationIdentity };
+const __niceevalExport5 = __niceevalCanonical["recordCoordinationIdentityMismatch"];
+export { __niceevalExport5 as recordCoordinationIdentityMismatch };
+//# sourceMappingURL=index.js.map

package/dist/coordination/platform/index.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./node.cjs"), exports);
+//# sourceMappingURL=index.cjs.map

package/dist/coordination/platform/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B","sourcesContent":["export * from \"./node.ts\";\n"]}

package/dist/coordination/platform/index.d.cts

@@ -0,0 +1 @@
+export * from "./node.cjs";

package/dist/coordination/platform/index.d.mts

@@ -0,0 +1 @@
+export * from "./node.mjs";

package/dist/coordination/platform/index.d.ts

@@ -0,0 +1 @@
+export * from "./node.js";

package/dist/coordination/platform/index.js

@@ -0,0 +1,6 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./index.cjs");
+const __niceevalExport0 = __niceevalCanonical["NodeRecordCoordinationLive"];
+export { __niceevalExport0 as NodeRecordCoordinationLive };
+//# sourceMappingURL=index.js.map

package/dist/coordination/platform/node.cjs

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeRecordCoordinationLive = void 0;
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const effect_1 = require("effect");
+const errors_ts_1 = require("../../record/platform/errors.cjs");
+const identity_ts_1 = require("../identity.cjs");
+const record_leases_ts_1 = require("../record-leases.cjs");
+const textEncoder = new TextEncoder();
+const leases = new WeakMap();
+function errorCode(cause) {
+    return typeof cause === "object" && cause !== null && "code" in cause &&
+        typeof cause.code === "string"
+        ? cause.code
+        : undefined;
+}
+function isMissing(cause) {
+    return errorCode(cause) === "ENOENT";
+}
+function isAlreadyExists(cause) {
+    return errorCode(cause) === "EEXIST";
+}
+function fileSystemError(operation, path, cause) {
+    return errorCode(cause) === "EACCES" || errorCode(cause) === "EPERM"
+        ? new errors_ts_1.RecordPermissionError({
+            code: "record-permission-denied",
+            operation,
+            path,
+            cause,
+        })
+        : new errors_ts_1.RecordIoError({
+            code: "record-io-error",
+            operation,
+            path,
+            cause,
+        });
+}
+function nodeIo(input) {
+    return effect_1.Effect.tryPromise({
+        try: input.run,
+        catch: (cause) => fileSystemError(input.operation, input.path, cause),
+    });
+}
+function layoutFor(root) {
+    const identity = (0, identity_ts_1.recordCoordinationIdentity)(root);
+    return identity === undefined
+        ? effect_1.Effect.fail(new errors_ts_1.RecordRootInvalid({ code: "record-root-invalid" }))
+        : effect_1.Effect.succeed(Object.freeze({
+            localStateRoot: identity.localStateRoot,
+            recordKey: identity.recordKey,
+            readDirectory: (0, node_path_1.join)(identity.localStateRoot, "leases", "read"),
+            appendDirectory: (0, node_path_1.join)(identity.localStateRoot, "leases", "append"),
+            maintenanceFile: (0, node_path_1.join)(identity.localStateRoot, "leases", "maintenance.lock"),
+            identityFile: (0, node_path_1.join)(identity.localStateRoot, "identity.json"),
+        }));
+}
+function ensureDirectory(path) {
+    return nodeIo({
+        operation: "create-directory",
+        path,
+        run: () => (0, promises_1.mkdir)(path, { recursive: true }),
+    });
+}
+function closeHandle(handle, operation, path) {
+    return nodeIo({ operation, path, run: () => handle.close() }).pipe(effect_1.Effect.orDie);
+}
+function syncDirectory(path) {
+    return effect_1.Effect.scoped(effect_1.Effect.acquireRelease(nodeIo({ operation: "sync-directory", path, run: () => (0, promises_1.open)(path, "r") }), (handle) => closeHandle(handle, "sync-directory", path)).pipe(effect_1.Effect.flatMap((handle) => nodeIo({ operation: "sync-directory", path, run: () => handle.sync() }))));
+}
+function writeExclusiveFile(path, bytes) {
+    const parent = (0, node_path_1.dirname)(path);
+    const acquire = effect_1.Effect.tryPromise({
+        try: () => (0, promises_1.open)(path, "wx", 0o600),
+        catch: (cause) => isAlreadyExists(cause)
+            ? new errors_ts_1.RecordPathAlreadyExists({
+                code: "record-path-already-exists",
+                path,
+            })
+            : fileSystemError("write-file", path, cause),
+    });
+    return effect_1.Effect.gen(function* () {
+        yield* ensureDirectory(parent);
+        yield* effect_1.Effect.scoped(effect_1.Effect.acquireRelease(acquire, (handle) => closeHandle(handle, "write-file", path)).pipe(effect_1.Effect.flatMap((handle) => nodeIo({ operation: "write-file", path, run: () => handle.writeFile(bytes) }).pipe(effect_1.Effect.zipRight(nodeIo({ operation: "sync-file", path, run: () => handle.sync() }))))));
+        yield* syncDirectory(parent);
+    });
+}
+function removeFileIfPresent(path) {
+    return nodeIo({ operation: "release-record-lease", path, run: () => (0, promises_1.unlink)(path) }).pipe(effect_1.Effect.catchAll((error) => isMissing(error.cause) ? effect_1.Effect.void : effect_1.Effect.fail(error)), effect_1.Effect.zipRight(syncDirectory((0, node_path_1.dirname)(path))));
+}
+function pathPresent(path) {
+    return nodeIo({ operation: "read-file", path, run: async () => {
+            try {
+                await (0, promises_1.readFile)(path);
+                return true;
+            }
+            catch (cause) {
+                if (isMissing(cause))
+                    return false;
+                throw cause;
+            }
+        } });
+}
+function leasePayload(kind) {
+    return textEncoder.encode(JSON.stringify({
+        version: 1,
+        kind,
+        host: (0, node_os_1.hostname)(),
+        pid: process.pid,
+        nonce: (0, node_crypto_1.randomUUID)(),
+    }));
+}
+function makeLease(kind, path) {
+    const lease = (0, record_leases_ts_1.issueRecordLease)(kind);
+    leases.set(lease, path);
+    return lease;
+}
+function sharedDirectory(layout, kind) {
+    return kind === "read" ? layout.readDirectory : layout.appendDirectory;
+}
+function sharedEntriesPresent(layout) {
+    const directories = [layout.readDirectory, layout.appendDirectory];
+    return effect_1.Effect.forEach(directories, (directory) => ensureDirectory(directory).pipe(effect_1.Effect.zipRight(nodeIo({
+        operation: "list-directory",
+        path: directory,
+        run: () => (0, promises_1.readdir)(directory),
+    }))), { concurrency: 1 }).pipe(effect_1.Effect.map((entries) => entries.some((items) => items.length > 0)));
+}
+function maintenanceBusy(requested) {
+    return new errors_ts_1.RecordMaintenanceBusy({ code: "record-maintenance-busy", requested });
+}
+function enterSharedLease(root, kind) {
+    return effect_1.Effect.gen(function* () {
+        const layout = yield* layoutFor(root);
+        const directory = sharedDirectory(layout, kind);
+        yield* ensureDirectory(directory);
+        if (yield* pathPresent(layout.maintenanceFile)) {
+            return yield* effect_1.Effect.fail(maintenanceBusy("shared"));
+        }
+        const path = (0, node_path_1.join)(directory, `${process.pid}-${(0, node_crypto_1.randomUUID)()}.lease`);
+        const created = yield* writeExclusiveFile(path, leasePayload(kind)).pipe(effect_1.Effect.matchEffect({
+            onFailure: (error) => error instanceof errors_ts_1.RecordPathAlreadyExists
+                ? effect_1.Effect.succeed(false)
+                : effect_1.Effect.fail(error),
+            onSuccess: () => effect_1.Effect.succeed(true),
+        }));
+        if (!created) {
+            return yield* effect_1.Effect.fail(maintenanceBusy("shared"));
+        }
+        if (yield* pathPresent(layout.maintenanceFile)) {
+            yield* removeFileIfPresent(path);
+            return yield* effect_1.Effect.fail(maintenanceBusy("shared"));
+        }
+        return makeLease(kind, path);
+    });
+}
+function enterMaintenanceLease(root) {
+    return effect_1.Effect.gen(function* () {
+        const layout = yield* layoutFor(root);
+        yield* ensureDirectory((0, node_path_1.dirname)(layout.maintenanceFile));
+        const created = yield* writeExclusiveFile(layout.maintenanceFile, leasePayload("maintenance")).pipe(effect_1.Effect.matchEffect({
+            onFailure: (error) => error instanceof errors_ts_1.RecordPathAlreadyExists
+                ? effect_1.Effect.succeed(false)
+                : effect_1.Effect.fail(error),
+            onSuccess: () => effect_1.Effect.succeed(true),
+        }));
+        if (!created) {
+            return yield* effect_1.Effect.fail(maintenanceBusy("exclusive"));
+        }
+        if (yield* sharedEntriesPresent(layout)) {
+            yield* removeFileIfPresent(layout.maintenanceFile);
+            return yield* effect_1.Effect.fail(maintenanceBusy("exclusive"));
+        }
+        return makeLease("maintenance", layout.maintenanceFile);
+    });
+}
+function release(lease) {
+    const path = leases.get(lease);
+    return path === undefined
+        ? effect_1.Effect.die("Record coordination lease was not issued by this platform")
+        : removeFileIfPresent(path).pipe(effect_1.Effect.orDie);
+}
+function readIdentity(path) {
+    return nodeIo({ operation: "read-file", path, run: () => (0, promises_1.readFile)(path, "utf8") }).pipe(effect_1.Effect.map((text) => {
+        try {
+            const value = JSON.parse(text);
+            if (typeof value !== "object" || value === null || Array.isArray(value) ||
+                Reflect.get(value, "version") !== 1 ||
+                typeof Reflect.get(value, "recordKey") !== "string" ||
+                typeof Reflect.get(value, "recordId") !== "string") {
+                return undefined;
+            }
+            return Object.freeze({
+                version: 1,
+                recordKey: Reflect.get(value, "recordKey"),
+                recordId: Reflect.get(value, "recordId"),
+            });
+        }
+        catch {
+            return undefined;
+        }
+    }), effect_1.Effect.catchAll((error) => isMissing(error.cause) ? effect_1.Effect.succeed(undefined) : effect_1.Effect.fail(error)));
+}
+function identityBytes(input) {
+    return textEncoder.encode(JSON.stringify(input));
+}
+function identityMatches(identity, layout, recordId) {
+    return identity !== undefined &&
+        identity.recordKey === layout.recordKey &&
+        identity.recordId === recordId;
+}
+function verifyIdentity(input) {
+    return effect_1.Effect.gen(function* () {
+        const layout = yield* layoutFor(input.root);
+        yield* ensureDirectory(layout.localStateRoot);
+        const existing = yield* readIdentity(layout.identityFile);
+        if (existing !== undefined) {
+            return identityMatches(existing, layout, input.recordId)
+                ? undefined
+                : yield* effect_1.Effect.fail((0, record_leases_ts_1.recordCoordinationIdentityMismatch)());
+        }
+        const expected = {
+            version: 1,
+            recordKey: layout.recordKey,
+            recordId: input.recordId,
+        };
+        const created = yield* writeExclusiveFile(layout.identityFile, identityBytes(expected)).pipe(effect_1.Effect.matchEffect({
+            onFailure: (error) => error instanceof errors_ts_1.RecordPathAlreadyExists
+                ? effect_1.Effect.succeed(false)
+                : effect_1.Effect.fail(error),
+            onSuccess: () => effect_1.Effect.succeed(true),
+        }));
+        if (created) {
+            return;
+        }
+        const raced = yield* readIdentity(layout.identityFile);
+        if (!identityMatches(raced, layout, input.recordId)) {
+            return yield* effect_1.Effect.fail((0, record_leases_ts_1.recordCoordinationIdentityMismatch)());
+        }
+    });
+}
+const nodeRecordCoordination = {
+    enterRecordRead: (root) => effect_1.Effect.acquireRelease(enterSharedLease(root, "read"), (lease) => release(lease)),
+    enterRecordAppend: (root) => effect_1.Effect.acquireRelease(enterSharedLease(root, "append"), (lease) => release(lease)),
+    enterRecordMaintenance: (root) => effect_1.Effect.acquireRelease(enterMaintenanceLease(root), (lease) => release(lease)),
+    verifyRecordIdentity: verifyIdentity,
+};
+exports.NodeRecordCoordinationLive = effect_1.Layer.succeed(record_leases_ts_1.RecordCoordination, nodeRecordCoordination);
+//# sourceMappingURL=node.cjs.map

package/dist/coordination/platform/node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["node.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { mkdir, open, readdir, readFile, unlink, type FileHandle } from \"node:fs/promises\";\nimport { hostname } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport { Effect, Layer } from \"effect\";\nimport type { RecordId } from \"../../record/model/identifiers.ts\";\nimport { RecordIoError, RecordMaintenanceBusy, RecordPathAlreadyExists, RecordPermissionError, RecordRootInvalid, type RecordFileSystemError, type RecordPlatformOperation, } from \"../../record/platform/errors.ts\";\nimport type { RecordRoot } from \"../../record/platform/root.ts\";\nimport { recordCoordinationIdentity } from \"../identity.ts\";\nimport { RecordCoordination, issueRecordLease, recordCoordinationIdentityMismatch, type RecordCoordinationError, type RecordCoordinationService, type RecordLease, type RecordLeaseKind, } from \"../record-leases.ts\";\ninterface LeaseLayout {\n    readonly localStateRoot: string;\n    readonly recordKey: string;\n    readonly readDirectory: string;\n    readonly appendDirectory: string;\n    readonly maintenanceFile: string;\n    readonly identityFile: string;\n}\ninterface IdentityFile {\n    readonly version: 1;\n    readonly recordKey: string;\n    readonly recordId: string;\n}\nconst textEncoder = new TextEncoder();\nconst leases = new WeakMap<RecordLease, string>();\nfunction errorCode(cause: unknown): string | undefined {\n    return typeof cause === \"object\" && cause !== null && \"code\" in cause &&\n        typeof cause.code === \"string\"\n        ? cause.code\n        : undefined;\n}\nfunction isMissing(cause: unknown): boolean {\n    return errorCode(cause) === \"ENOENT\";\n}\nfunction isAlreadyExists(cause: unknown): boolean {\n    return errorCode(cause) === \"EEXIST\";\n}\nfunction fileSystemError(operation: RecordPlatformOperation, path: string, cause: unknown): RecordIoError | RecordPermissionError {\n    return errorCode(cause) === \"EACCES\" || errorCode(cause) === \"EPERM\"\n        ? new RecordPermissionError({\n            code: \"record-permission-denied\",\n            operation,\n            path,\n            cause,\n        })\n        : new RecordIoError({\n            code: \"record-io-error\",\n            operation,\n            path,\n            cause,\n        });\n}\nfunction nodeIo<A>(input: {\n    readonly operation: RecordPlatformOperation;\n    readonly path: string;\n    readonly run: () => Promise<A>;\n}): Effect.Effect<A, RecordIoError | RecordPermissionError> {\n    return Effect.tryPromise({\n        try: input.run,\n        catch: (cause) => fileSystemError(input.operation, input.path, cause),\n    });\n}\nfunction layoutFor(root: unknown): Effect.Effect<LeaseLayout, RecordRootInvalid> {\n    const identity = recordCoordinationIdentity(root);\n    return identity === undefined\n        ? Effect.fail(new RecordRootInvalid({ code: \"record-root-invalid\" }))\n        : Effect.succeed(Object.freeze({\n            localStateRoot: identity.localStateRoot,\n            recordKey: identity.recordKey,\n            readDirectory: join(identity.localStateRoot, \"leases\", \"read\"),\n            appendDirectory: join(identity.localStateRoot, \"leases\", \"append\"),\n            maintenanceFile: join(identity.localStateRoot, \"leases\", \"maintenance.lock\"),\n            identityFile: join(identity.localStateRoot, \"identity.json\"),\n        }));\n}\nfunction ensureDirectory(path: string): Effect.Effect<void, RecordFileSystemError> {\n    return nodeIo({\n        operation: \"create-directory\",\n        path,\n        run: () => mkdir(path, { recursive: true }),\n    });\n}\nfunction closeHandle(handle: FileHandle, operation: RecordPlatformOperation, path: string): Effect.Effect<void> {\n    return nodeIo({ operation, path, run: () => handle.close() }).pipe(Effect.orDie);\n}\nfunction syncDirectory(path: string): Effect.Effect<void, RecordFileSystemError> {\n    return Effect.scoped(Effect.acquireRelease(nodeIo({ operation: \"sync-directory\", path, run: () => open(path, \"r\") }), (handle) => closeHandle(handle, \"sync-directory\", path)).pipe(Effect.flatMap((handle) => nodeIo({ operation: \"sync-directory\", path, run: () => handle.sync() }))));\n}\nfunction writeExclusiveFile(path: string, bytes: Uint8Array): Effect.Effect<void, RecordFileSystemError> {\n    const parent = dirname(path);\n    const acquire = Effect.tryPromise({\n        try: () => open(path, \"wx\", 0o600),\n        catch: (cause) => isAlreadyExists(cause)\n            ? new RecordPathAlreadyExists({\n                code: \"record-path-already-exists\",\n                path,\n            })\n            : fileSystemError(\"write-file\", path, cause),\n    });\n    return Effect.gen(function* () {\n        yield* ensureDirectory(parent);\n        yield* Effect.scoped(Effect.acquireRelease(acquire, (handle) => closeHandle(handle, \"write-file\", path)).pipe(Effect.flatMap((handle) => nodeIo({ operation: \"write-file\", path, run: () => handle.writeFile(bytes) }).pipe(Effect.zipRight(nodeIo({ operation: \"sync-file\", path, run: () => handle.sync() }))))));\n        yield* syncDirectory(parent);\n    });\n}\nfunction removeFileIfPresent(path: string): Effect.Effect<void, RecordFileSystemError> {\n    return nodeIo({ operation: \"release-record-lease\", path, run: () => unlink(path) }).pipe(Effect.catchAll((error) => isMissing(error.cause) ? Effect.void : Effect.fail(error)), Effect.zipRight(syncDirectory(dirname(path))));\n}\nfunction pathPresent(path: string): Effect.Effect<boolean, RecordFileSystemError> {\n    return nodeIo({ operation: \"read-file\", path, run: async () => {\n            try {\n                await readFile(path);\n                return true;\n            }\n            catch (cause) {\n                if (isMissing(cause))\n                    return false;\n                throw cause;\n            }\n        } });\n}\nfunction leasePayload(kind: RecordLeaseKind): Uint8Array {\n    return textEncoder.encode(JSON.stringify({\n        version: 1,\n        kind,\n        host: hostname(),\n        pid: process.pid,\n        nonce: randomUUID(),\n    }));\n}\nfunction makeLease(kind: RecordLeaseKind, path: string): RecordLease {\n    const lease = issueRecordLease(kind);\n    leases.set(lease, path);\n    return lease;\n}\nfunction sharedDirectory(layout: LeaseLayout, kind: \"read\" | \"append\"): string {\n    return kind === \"read\" ? layout.readDirectory : layout.appendDirectory;\n}\nfunction sharedEntriesPresent(layout: LeaseLayout): Effect.Effect<boolean, RecordFileSystemError> {\n    const directories = [layout.readDirectory, layout.appendDirectory] as const;\n    return Effect.forEach(directories, (directory) => ensureDirectory(directory).pipe(Effect.zipRight(nodeIo({\n        operation: \"list-directory\",\n        path: directory,\n        run: () => readdir(directory),\n    }))), { concurrency: 1 }).pipe(Effect.map((entries) => entries.some((items) => items.length > 0)));\n}\nfunction maintenanceBusy(requested: \"shared\" | \"exclusive\"): RecordMaintenanceBusy {\n    return new RecordMaintenanceBusy({ code: \"record-maintenance-busy\", requested });\n}\nfunction enterSharedLease(root: RecordRoot, kind: \"read\" | \"append\"): Effect.Effect<RecordLease, RecordCoordinationError> {\n    return Effect.gen(function* () {\n        const layout = yield* layoutFor(root);\n        const directory = sharedDirectory(layout, kind);\n        yield* ensureDirectory(directory);\n        if (yield* pathPresent(layout.maintenanceFile)) {\n            return yield* Effect.fail(maintenanceBusy(\"shared\"));\n        }\n        const path = join(directory, `${process.pid}-${randomUUID()}.lease`);\n        const created = yield* writeExclusiveFile(path, leasePayload(kind)).pipe(Effect.matchEffect({\n            onFailure: (error) => error instanceof RecordPathAlreadyExists\n                ? Effect.succeed(false)\n                : Effect.fail(error),\n            onSuccess: () => Effect.succeed(true),\n        }));\n        if (!created) {\n            return yield* Effect.fail(maintenanceBusy(\"shared\"));\n        }\n        if (yield* pathPresent(layout.maintenanceFile)) {\n            yield* removeFileIfPresent(path);\n            return yield* Effect.fail(maintenanceBusy(\"shared\"));\n        }\n        return makeLease(kind, path);\n    });\n}\nfunction enterMaintenanceLease(root: RecordRoot): Effect.Effect<RecordLease, RecordCoordinationError> {\n    return Effect.gen(function* () {\n        const layout = yield* layoutFor(root);\n        yield* ensureDirectory(dirname(layout.maintenanceFile));\n        const created = yield* writeExclusiveFile(layout.maintenanceFile, leasePayload(\"maintenance\")).pipe(Effect.matchEffect({\n            onFailure: (error) => error instanceof RecordPathAlreadyExists\n                ? Effect.succeed(false)\n                : Effect.fail(error),\n            onSuccess: () => Effect.succeed(true),\n        }));\n        if (!created) {\n            return yield* Effect.fail(maintenanceBusy(\"exclusive\"));\n        }\n        if (yield* sharedEntriesPresent(layout)) {\n            yield* removeFileIfPresent(layout.maintenanceFile);\n            return yield* Effect.fail(maintenanceBusy(\"exclusive\"));\n        }\n        return makeLease(\"maintenance\", layout.maintenanceFile);\n    });\n}\nfunction release(lease: RecordLease): Effect.Effect<void> {\n    const path = leases.get(lease);\n    return path === undefined\n        ? Effect.die(\"Record coordination lease was not issued by this platform\")\n        : removeFileIfPresent(path).pipe(Effect.orDie);\n}\nfunction readIdentity(path: string): Effect.Effect<IdentityFile | undefined, RecordFileSystemError> {\n    return nodeIo({ operation: \"read-file\", path, run: () => readFile(path, \"utf8\") }).pipe(Effect.map((text) => {\n        try {\n            const value: unknown = JSON.parse(text);\n            if (typeof value !== \"object\" || value === null || Array.isArray(value) ||\n                Reflect.get(value, \"version\") !== 1 ||\n                typeof Reflect.get(value, \"recordKey\") !== \"string\" ||\n                typeof Reflect.get(value, \"recordId\") !== \"string\") {\n                return undefined;\n            }\n            return Object.freeze({\n                version: 1 as const,\n                recordKey: Reflect.get(value, \"recordKey\") as string,\n                recordId: Reflect.get(value, \"recordId\") as string,\n            });\n        }\n        catch {\n            return undefined;\n        }\n    }), Effect.catchAll((error) => isMissing(error.cause) ? Effect.succeed(undefined) : Effect.fail(error)));\n}\nfunction identityBytes(input: IdentityFile): Uint8Array {\n    return textEncoder.encode(JSON.stringify(input));\n}\nfunction identityMatches(identity: IdentityFile | undefined, layout: LeaseLayout, recordId: RecordId): boolean {\n    return identity !== undefined &&\n        identity.recordKey === layout.recordKey &&\n        identity.recordId === recordId;\n}\nfunction verifyIdentity(input: {\n    readonly root: RecordRoot;\n    readonly recordId: RecordId;\n}): Effect.Effect<void, RecordCoordinationError> {\n    return Effect.gen(function* () {\n        const layout = yield* layoutFor(input.root);\n        yield* ensureDirectory(layout.localStateRoot);\n        const existing = yield* readIdentity(layout.identityFile);\n        if (existing !== undefined) {\n            return identityMatches(existing, layout, input.recordId)\n                ? undefined\n                : yield* Effect.fail(recordCoordinationIdentityMismatch());\n        }\n        const expected: IdentityFile = {\n            version: 1,\n            recordKey: layout.recordKey,\n            recordId: input.recordId,\n        };\n        const created = yield* writeExclusiveFile(layout.identityFile, identityBytes(expected)).pipe(Effect.matchEffect({\n            onFailure: (error) => error instanceof RecordPathAlreadyExists\n                ? Effect.succeed(false)\n                : Effect.fail(error),\n            onSuccess: () => Effect.succeed(true),\n        }));\n        if (created) {\n            return;\n        }\n        const raced = yield* readIdentity(layout.identityFile);\n        if (!identityMatches(raced, layout, input.recordId)) {\n            return yield* Effect.fail(recordCoordinationIdentityMismatch());\n        }\n    });\n}\nconst nodeRecordCoordination: RecordCoordinationService = {\n    enterRecordRead: (root) => Effect.acquireRelease(enterSharedLease(root, \"read\"), (lease) => release(lease)),\n    enterRecordAppend: (root) => Effect.acquireRelease(enterSharedLease(root, \"append\"), (lease) => release(lease)),\n    enterRecordMaintenance: (root) => Effect.acquireRelease(enterMaintenanceLease(root), (lease) => release(lease)),\n    verifyRecordIdentity: verifyIdentity,\n};\nexport const NodeRecordCoordinationLive = Layer.succeed(RecordCoordination, nodeRecordCoordination);\n"]}

package/dist/coordination/platform/node.d.cts

@@ -0,0 +1,3 @@
+import { Layer } from "effect";
+import { RecordCoordination } from "../record-leases.cjs";
+export declare const NodeRecordCoordinationLive: Layer.Layer<RecordCoordination, never, never>;

package/dist/coordination/platform/node.d.mts

@@ -0,0 +1,3 @@
+import { Layer } from "effect";
+import { RecordCoordination } from "../record-leases.mjs";
+export declare const NodeRecordCoordinationLive: Layer.Layer<RecordCoordination, never, never>;

package/dist/coordination/platform/node.d.ts

@@ -0,0 +1,3 @@
+import { Layer } from "effect";
+import { RecordCoordination } from "../record-leases.js";
+export declare const NodeRecordCoordinationLive: Layer.Layer<RecordCoordination, never, never>;

package/dist/coordination/platform/node.js

@@ -0,0 +1,6 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./node.cjs");
+const __niceevalExport0 = __niceevalCanonical["NodeRecordCoordinationLive"];
+export { __niceevalExport0 as NodeRecordCoordinationLive };
+//# sourceMappingURL=node.js.map

package/dist/coordination/platform/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sources":[],"names":[],"mappings":""}