@ricsam/r5d-worker 0.0.122 → 0.0.124

package/dist/cjs/recovery-store.cjs

@@ -73,6 +73,14 @@ class WorkerRecoveryStore {
   close() {
     this.db.close();
   }
+  /**
+   * Run several store operations as one durable commit (one FULL fsync).
+   * Operations that open their own transaction nest as savepoints. A throw
+   * rolls the whole group back; callers treat that as a journal failure.
+   */
+  batch(operations) {
+    return this.db.transaction(operations)();
+  }
   row(requestId) {
     return this.db.query("SELECT * FROM operations WHERE request_id=? OR request_id=(SELECT operation_id FROM aliases WHERE request_id=?)").get(requestId, requestId);
   }

package/dist/cjs/session-file-mutations.cjs

@@ -0,0 +1,61 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var session_file_mutations_exports = {};
+__export(session_file_mutations_exports, {
+  SessionFileMutationTracker: () => SessionFileMutationTracker
+});
+module.exports = __toCommonJS(session_file_mutations_exports);
+class SessionFileMutationTracker {
+  inFlight = /* @__PURE__ */ new Map();
+  /** Register a started mutation; it is forgotten when it settles, however it settles. */
+  track(sessionId, mutation) {
+    let mutations = this.inFlight.get(sessionId);
+    if (!mutations) {
+      mutations = /* @__PURE__ */ new Set();
+      this.inFlight.set(sessionId, mutations);
+    }
+    mutations.add(mutation);
+    const forget = () => {
+      const current = this.inFlight.get(sessionId);
+      if (!current) return;
+      current.delete(mutation);
+      if (current.size === 0) this.inFlight.delete(sessionId);
+    };
+    mutation.then(forget, forget);
+    return mutation;
+  }
+  count(sessionId) {
+    return this.inFlight.get(sessionId)?.size ?? 0;
+  }
+  /**
+   * Resolves once every mutation tracked for the session at the time of the
+   * call has settled. Mutations started later are not joined: the session's
+   * cancellation marker, recorded before this is awaited, makes their
+   * admission recheck refuse them.
+   */
+  settled(sessionId) {
+    const pending = [...this.inFlight.get(sessionId) ?? []];
+    if (pending.length === 0) return Promise.resolve();
+    return Promise.allSettled(pending).then(() => void 0);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SessionFileMutationTracker
+});

package/dist/cjs/working-tree-mirror.cjs

@@ -416,6 +416,7 @@ function filesEqual(leftPath, rightPath, entry) {
       const length = Math.min(leftBuffer.length, entry.size - offset);
       const leftRead = import_node_fs.default.readSync(left, leftBuffer, 0, length, offset);
       const rightRead = import_node_fs.default.readSync(right, rightBuffer, 0, length, offset);
+      if (leftRead <= 0 || rightRead <= 0) return false;
       if (leftRead !== rightRead || !leftBuffer.subarray(0, leftRead).equals(rightBuffer.subarray(0, rightRead))) return false;
       offset += leftRead;
     }

package/dist/cjs/workspace-command-sync-policy.cjs

@@ -25,22 +25,51 @@ __export(workspace_command_sync_policy_exports, {
   shouldSerializeWorkspaceCommand: () => shouldSerializeWorkspaceCommand
 });
 module.exports = __toCommonJS(workspace_command_sync_policy_exports);
+var import_workspace_mount_hold_fence = require("./workspace-mount-hold-fence.cjs");
 function requiresCurrentSyncBarrier(target) {
   return target.type === "workspace" && target.rootProfile === "visible_projects";
 }
-async function reserveWorkspaceCommandAfterCurrentSync(target, coordinator, reserve) {
-  if (!requiresCurrentSyncBarrier(target)) {
-    reserve();
-    return;
-  }
+async function reserveWorkspaceCommandAfterCurrentSync(target, coordinator, reserve, options = {}) {
   while (true) {
-    const currentSync = coordinator.afterCurrent();
-    await currentSync;
-    if (currentSync !== coordinator.afterCurrent()) continue;
+    if (requiresCurrentSyncBarrier(target)) {
+      const currentSync = coordinator.afterCurrent();
+      await raceWithAbort(currentSync, options.signal);
+      if (currentSync !== coordinator.afterCurrent()) continue;
+    }
+    if (options.signal?.aborted) throw new import_workspace_mount_hold_fence.WorkspaceMountHoldAbortedError(abortReason(options.signal));
+    const hold = coordinator.mountHold(target, options.signal);
+    if (hold) {
+      await hold;
+      continue;
+    }
     reserve();
     return;
   }
 }
+function raceWithAbort(waited, signal) {
+  if (!signal) return waited;
+  if (signal.aborted) return Promise.reject(new import_workspace_mount_hold_fence.WorkspaceMountHoldAbortedError(abortReason(signal)));
+  return new Promise((resolve, reject) => {
+    const onAbort = () => reject(new import_workspace_mount_hold_fence.WorkspaceMountHoldAbortedError(abortReason(signal)));
+    signal.addEventListener("abort", onAbort, { once: true });
+    waited.then(
+      () => {
+        signal.removeEventListener("abort", onAbort);
+        resolve();
+      },
+      (error) => {
+        signal.removeEventListener("abort", onAbort);
+        reject(error instanceof Error ? error : new Error(String(error)));
+      }
+    );
+  });
+}
+function abortReason(signal) {
+  const reason = signal.reason;
+  if (reason instanceof Error) return reason.message;
+  if (typeof reason === "string" && reason) return reason;
+  return "Workspace command reservation was aborted";
+}
 function shouldSerializeWorkspaceCommand(target) {
   return target.type === "workspace" && target.rootProfile === "canonical_sync";
 }

package/dist/cjs/workspace-filesystem-executor-thread.cjs

@@ -0,0 +1,36 @@
+"use strict";
+var import_node_worker_threads = require("node:worker_threads");
+var import_workspace_filesystem_job_types = require("./workspace-filesystem-job-types.cjs");
+var import_workspace_filesystem_jobs = require("./workspace-filesystem-jobs.cjs");
+if (import_node_worker_threads.isMainThread || !import_node_worker_threads.parentPort) {
+  throw new Error("The workspace filesystem executor thread must be started by the worker runtime");
+}
+const port = import_node_worker_threads.parentPort;
+function runRequest(request) {
+  if (!(0, import_workspace_filesystem_job_types.isWorkspaceFilesystemJobKind)(request.kind)) {
+    return {
+      type: "failure",
+      id: request.id,
+      error: (0, import_workspace_filesystem_job_types.serializeWorkspaceFilesystemError)(new Error(`Unknown workspace filesystem job kind: ${String(request.kind)}`))
+    };
+  }
+  const operation = import_workspace_filesystem_jobs.workspaceFilesystemJobOperations[request.kind];
+  const previousEnvironment = process.env;
+  process.env = { ...request.environment };
+  try {
+    const result = operation(request.input, {
+      progress: (progress) => port.postMessage({ type: "progress", id: request.id, progress })
+    });
+    return { type: "result", id: request.id, result };
+  } catch (error) {
+    return { type: "failure", id: request.id, error: (0, import_workspace_filesystem_job_types.serializeWorkspaceFilesystemError)(error) };
+  } finally {
+    process.env = previousEnvironment;
+  }
+}
+port.on("message", (message) => {
+  if (!message || typeof message !== "object") return;
+  const request = message;
+  if (request.type !== "run" || typeof request.id !== "number") return;
+  port.postMessage(runRequest(request));
+});

package/dist/cjs/workspace-filesystem-executor.cjs

@@ -0,0 +1,327 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var workspace_filesystem_executor_exports = {};
+__export(workspace_filesystem_executor_exports, {
+  WORKSPACE_FILESYSTEM_EXECUTOR_MAX_QUEUED: () => WORKSPACE_FILESYSTEM_EXECUTOR_MAX_QUEUED,
+  WORKSPACE_FILESYSTEM_EXECUTOR_QUEUE_TIMEOUT_MS: () => WORKSPACE_FILESYSTEM_EXECUTOR_QUEUE_TIMEOUT_MS,
+  WORKSPACE_FILESYSTEM_EXECUTOR_STALL_LOG_INTERVAL_MS: () => WORKSPACE_FILESYSTEM_EXECUTOR_STALL_LOG_INTERVAL_MS,
+  WorkspaceFilesystemExecutor: () => WorkspaceFilesystemExecutor,
+  WorkspaceFilesystemExecutorError: () => WorkspaceFilesystemExecutorError,
+  WorkspaceFilesystemExecutorThreadExitedError: () => WorkspaceFilesystemExecutorThreadExitedError,
+  installWorkspaceFilesystemExecutorFailureHandler: () => installWorkspaceFilesystemExecutorFailureHandler,
+  workspaceFilesystemExecutor: () => workspaceFilesystemExecutor,
+  workspaceFilesystemExecutorTestHarness: () => workspaceFilesystemExecutorTestHarness,
+  workspaceFilesystemExecutorThreadModulePath: () => workspaceFilesystemExecutorThreadModulePath
+});
+module.exports = __toCommonJS(workspace_filesystem_executor_exports);
+var import_node_path = __toESM(require("node:path"), 1);
+var import_node_worker_threads = require("node:worker_threads");
+var import_git_process_environment = require("./git-process-environment.cjs");
+var import_workspace_filesystem_job_types = require("./workspace-filesystem-job-types.cjs");
+const WORKSPACE_FILESYSTEM_EXECUTOR_MAX_QUEUED = 32;
+const WORKSPACE_FILESYSTEM_EXECUTOR_QUEUE_TIMEOUT_MS = 5 * 6e4;
+const WORKSPACE_FILESYSTEM_EXECUTOR_STALL_LOG_INTERVAL_MS = 3e4;
+class WorkspaceFilesystemExecutorError extends Error {
+  name = "WorkspaceFilesystemExecutorError";
+}
+class WorkspaceFilesystemExecutorThreadExitedError extends WorkspaceFilesystemExecutorError {
+  constructor(exitCode, description, cause) {
+    super(
+      `Workspace filesystem executor thread exited${exitCode === null ? "" : ` with code ${exitCode}`} while running ${description}; the filesystem state is whatever a process crash would have left`,
+      cause === void 0 ? void 0 : { cause }
+    );
+    this.exitCode = exitCode;
+    this.description = description;
+  }
+  exitCode;
+  description;
+}
+class WorkspaceFilesystemExecutor {
+  threadModulePath;
+  log;
+  now;
+  maxQueued;
+  queueTimeoutMs;
+  stallLogIntervalMs;
+  worker = null;
+  queue = [];
+  running = null;
+  nextJobId = 1;
+  failed = null;
+  closed = false;
+  /** Invoked once when the executor fails closed (thread exit under a running job). */
+  onFailure;
+  constructor(options) {
+    this.threadModulePath = options.threadModulePath;
+    this.log = options.log ?? ((line) => process.stderr.write(`${line}
+`));
+    this.now = options.now ?? (() => Date.now());
+    this.maxQueued = options.maxQueued ?? WORKSPACE_FILESYSTEM_EXECUTOR_MAX_QUEUED;
+    this.queueTimeoutMs = options.queueTimeoutMs ?? WORKSPACE_FILESYSTEM_EXECUTOR_QUEUE_TIMEOUT_MS;
+    this.stallLogIntervalMs = options.stallLogIntervalMs ?? WORKSPACE_FILESYSTEM_EXECUTOR_STALL_LOG_INTERVAL_MS;
+  }
+  /**
+   * Run one job to completion on the executor thread. Resolves with the
+   * job's result; rejects with the job's own error (properties preserved),
+   * with a queue-wait or capacity error when the job never started, or with
+   * WorkspaceFilesystemExecutorThreadExitedError when the thread died under it.
+   */
+  run(kind, input, options = {}) {
+    const description = (0, import_workspace_filesystem_job_types.describeWorkspaceFilesystemJob)(kind, input);
+    if (this.closed)
+      return Promise.reject(new WorkspaceFilesystemExecutorError(`Workspace filesystem executor is closed; refusing ${description}`));
+    if (this.failed) return Promise.reject(new WorkspaceFilesystemExecutorError(`${this.failed}; refusing ${description}`));
+    if (this.queue.length >= this.maxQueued) {
+      return Promise.reject(
+        new WorkspaceFilesystemExecutorError(
+          `Workspace filesystem executor queue is full (${this.queue.length} waiting behind ${this.describeRunning()}); refusing ${description}`
+        )
+      );
+    }
+    return new Promise((resolve, reject) => {
+      const job = {
+        id: this.nextJobId++,
+        kind,
+        input,
+        description,
+        onProgress: options.onProgress,
+        resolve: (result) => resolve(result),
+        reject,
+        queuedAtMs: this.now(),
+        queueTimer: void 0
+      };
+      this.queue.push(job);
+      if (this.running) {
+        job.queueTimer = setTimeout(() => this.expireQueued(job), this.queueTimeoutMs);
+      }
+      this.dispatch();
+    });
+  }
+  status() {
+    const running = this.running;
+    return {
+      running: running ? {
+        kind: running.kind,
+        description: running.description,
+        startedAtMs: running.startedAtMs,
+        ageMs: this.now() - running.startedAtMs
+      } : null,
+      queued: this.queue.length,
+      failed: this.failed
+    };
+  }
+  /**
+   * Stop accepting jobs, fail everything still queued and ask the thread to
+   * stop. A running job settles when the thread actually exits; a thread
+   * blocked in the kernel only exits with the process, which is the point.
+   */
+  close() {
+    if (this.closed) return;
+    this.closed = true;
+    for (const job of this.queue.splice(0)) {
+      if (job.queueTimer) clearTimeout(job.queueTimer);
+      job.reject(new WorkspaceFilesystemExecutorError(`Workspace filesystem executor is closed; ${job.description} did not start`));
+    }
+    const worker = this.worker;
+    if (worker && !this.running) {
+      this.worker = null;
+      void worker.terminate();
+    } else if (worker) {
+      void worker.terminate();
+    }
+  }
+  describeRunning() {
+    const running = this.running;
+    if (!running) return "an idle executor";
+    return `${running.description} (running for ${Math.round((this.now() - running.startedAtMs) / 1e3)}s)`;
+  }
+  expireQueued(job) {
+    const index = this.queue.indexOf(job);
+    if (index < 0) return;
+    this.queue.splice(index, 1);
+    job.queueTimer = void 0;
+    job.reject(
+      new WorkspaceFilesystemExecutorError(
+        `Workspace filesystem executor is blocked: ${this.describeRunning()} while ${job.description} waited ${Math.round((this.now() - job.queuedAtMs) / 1e3)}s for its turn; filesystem I/O may be stalled`
+      )
+    );
+  }
+  dispatch() {
+    if (this.running || this.closed || this.failed) return;
+    const job = this.queue.shift();
+    if (!job) {
+      this.worker?.unref();
+      return;
+    }
+    if (job.queueTimer) {
+      clearTimeout(job.queueTimer);
+      job.queueTimer = void 0;
+    }
+    let worker;
+    try {
+      worker = this.ensureWorker();
+    } catch (error) {
+      job.reject(error instanceof Error ? error : new Error(String(error)));
+      this.dispatch();
+      return;
+    }
+    const environment = {};
+    for (const [key, value] of Object.entries((0, import_git_process_environment.workerGitProcessEnvironment)(process.env))) if (value !== void 0) environment[key] = value;
+    const request = { type: "run", id: job.id, kind: job.kind, input: job.input, environment };
+    const startedAtMs = this.now();
+    const running = {
+      ...job,
+      startedAtMs,
+      stallTimer: setInterval(() => {
+        this.log(
+          `[r5d-worker] workspace filesystem job ${running.kind} (${running.description}) has run for ${Math.round((this.now() - startedAtMs) / 1e3)}s; filesystem I/O may be stalled (${this.queue.length} job(s) queued behind it)`
+        );
+      }, this.stallLogIntervalMs)
+    };
+    running.stallTimer.unref();
+    this.running = running;
+    worker.ref();
+    try {
+      worker.postMessage(request);
+    } catch (error) {
+      this.settleRunning(running, () => running.reject(error instanceof Error ? error : new Error(String(error))));
+    }
+  }
+  settleRunning(job, settle) {
+    if (this.running !== job) return;
+    clearInterval(job.stallTimer);
+    this.running = null;
+    settle();
+    this.dispatch();
+  }
+  ensureWorker() {
+    if (this.worker) return this.worker;
+    const worker = new import_node_worker_threads.Worker(this.threadModulePath);
+    this.worker = worker;
+    worker.on("message", (message) => this.onReply(worker, message));
+    worker.on("error", (error) => {
+      this.log(`[r5d-worker] workspace filesystem executor thread error: ${error.stack ?? error.message}`);
+      this.lastThreadError = error;
+    });
+    worker.on("exit", (code) => this.onExit(worker, code));
+    worker.unref();
+    return worker;
+  }
+  lastThreadError;
+  onReply(worker, message) {
+    if (this.worker !== worker) return;
+    const running = this.running;
+    if (!running || !message || typeof message !== "object" || message.id !== running.id) return;
+    if (message.type === "progress") {
+      running.onProgress?.(message.progress);
+      return;
+    }
+    if (message.type === "result") {
+      this.settleRunning(running, () => running.resolve(message.result));
+      return;
+    }
+    if (message.type === "failure") {
+      this.settleRunning(running, () => running.reject((0, import_workspace_filesystem_job_types.restoreWorkspaceFilesystemError)(message.error)));
+    }
+  }
+  onExit(worker, code) {
+    if (this.worker !== worker) return;
+    this.worker = null;
+    const cause = this.lastThreadError;
+    this.lastThreadError = void 0;
+    const running = this.running;
+    if (!running) {
+      if (!this.closed) this.dispatch();
+      return;
+    }
+    const failure = new WorkspaceFilesystemExecutorThreadExitedError(code, running.description, cause);
+    if (!this.closed) {
+      this.failed = `Workspace filesystem executor thread exited with code ${code} while running ${running.description}; the worker must restart and recover before it mutates the workspace again`;
+      this.log(`[r5d-worker] ${this.failed}`);
+    }
+    this.settleRunning(running, () => running.reject(failure));
+    for (const job of this.queue.splice(0)) {
+      if (job.queueTimer) clearTimeout(job.queueTimer);
+      job.reject(
+        new WorkspaceFilesystemExecutorError(
+          `${this.failed ?? "Workspace filesystem executor is closed"}; ${job.description} did not start`
+        )
+      );
+    }
+    if (!this.closed) this.onFailure?.(failure);
+  }
+}
+function workspaceFilesystemExecutorThreadModulePath() {
+  return import_node_path.default.join(import_node_path.default.dirname(__filename), `workspace-filesystem-executor-thread${import_node_path.default.extname(__filename)}`);
+}
+let processExecutor = null;
+let inlineRunner = null;
+function workspaceFilesystemExecutor() {
+  if (inlineRunner) return inlineRunner;
+  processExecutor ??= new WorkspaceFilesystemExecutor({ threadModulePath: workspaceFilesystemExecutorThreadModulePath() });
+  return processExecutor;
+}
+function installWorkspaceFilesystemExecutorFailureHandler(handler) {
+  processExecutor ??= new WorkspaceFilesystemExecutor({ threadModulePath: workspaceFilesystemExecutorThreadModulePath() });
+  processExecutor.onFailure = handler;
+}
+const workspaceFilesystemExecutorTestHarness = {
+  async runJobsInline(body) {
+    const { workspaceFilesystemJobOperations } = await import("./workspace-filesystem-jobs.cjs");
+    const previous = inlineRunner;
+    inlineRunner = {
+      async run(kind, input, options = {}) {
+        await Promise.resolve();
+        const operation = workspaceFilesystemJobOperations[kind];
+        return operation(input, { progress: (progress) => options.onProgress?.(progress) });
+      }
+    };
+    try {
+      return await body();
+    } finally {
+      inlineRunner = previous;
+    }
+  },
+  processExecutor() {
+    return processExecutor;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WORKSPACE_FILESYSTEM_EXECUTOR_MAX_QUEUED,
+  WORKSPACE_FILESYSTEM_EXECUTOR_QUEUE_TIMEOUT_MS,
+  WORKSPACE_FILESYSTEM_EXECUTOR_STALL_LOG_INTERVAL_MS,
+  WorkspaceFilesystemExecutor,
+  WorkspaceFilesystemExecutorError,
+  WorkspaceFilesystemExecutorThreadExitedError,
+  installWorkspaceFilesystemExecutorFailureHandler,
+  workspaceFilesystemExecutor,
+  workspaceFilesystemExecutorTestHarness,
+  workspaceFilesystemExecutorThreadModulePath
+});

package/dist/cjs/workspace-filesystem-job-types.cjs

@@ -0,0 +1,134 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var workspace_filesystem_job_types_exports = {};
+__export(workspace_filesystem_job_types_exports, {
+  WORKSPACE_FILESYSTEM_JOB_KINDS: () => WORKSPACE_FILESYSTEM_JOB_KINDS,
+  describeWorkspaceFilesystemJob: () => describeWorkspaceFilesystemJob,
+  isWorkspaceFilesystemJobKind: () => isWorkspaceFilesystemJobKind,
+  restoreWorkspaceFilesystemError: () => restoreWorkspaceFilesystemError,
+  serializeWorkspaceFilesystemError: () => serializeWorkspaceFilesystemError
+});
+module.exports = __toCommonJS(workspace_filesystem_job_types_exports);
+const WORKSPACE_FILESYSTEM_JOB_KINDS = [
+  "checkout_durability_recovery",
+  "hydration_recovery",
+  "hydration_transaction",
+  "hydration_raw",
+  "checkout_transition_begin",
+  "checkout_transition_complete",
+  "outer_checkout_fsync",
+  "projection_merge",
+  "projection_mirror",
+  "projection_outer_apply",
+  "projection_receipt",
+  "project_snapshot_create",
+  "project_snapshot_apply",
+  "project_snapshot_persist",
+  "project_snapshot_rollback",
+  "project_snapshots_recover",
+  "project_branch_create",
+  "project_checkout_path_move"
+];
+function isWorkspaceFilesystemJobKind(value) {
+  return typeof value === "string" && WORKSPACE_FILESYSTEM_JOB_KINDS.includes(value);
+}
+function summarizeIds(ids) {
+  if (ids.length === 0) return "no mounts";
+  const shown = ids.slice(0, 3).join(", ");
+  return ids.length > 3 ? `${ids.length} mounts (${shown}, \u2026)` : `${ids.length === 1 ? "mount" : "mounts"} ${shown}`;
+}
+function describeWorkspaceFilesystemJob(kind, input) {
+  switch (kind) {
+    case "checkout_durability_recovery":
+    case "hydration_recovery":
+    case "checkout_transition_begin":
+    case "checkout_transition_complete":
+    case "outer_checkout_fsync":
+      return `${kind.replaceAll("_", " ")} of ${input.workspacePath}`;
+    case "hydration_transaction": {
+      const hydration = input;
+      return `hydration of ${summarizeIds(hydration.hydrationMounts.map(({ id }) => id))} (durability ${summarizeIds(hydration.advancedDurabilityMounts.map(({ id }) => id))})`;
+    }
+    case "hydration_raw":
+      return `pre-clone hydration of ${summarizeIds(input.mounts.map(({ id }) => id))}`;
+    case "projection_merge":
+      return `merge projection of mount ${input.mount.id}`;
+    case "projection_mirror":
+      return `projection of mount ${input.mount.id}`;
+    case "projection_outer_apply": {
+      const apply = input;
+      return `outer-tree apply (${apply.removeMounts.length} removal(s), ${apply.materialize.length} merged subtree(s), ${apply.restoreFromHead.length} deferred restore(s))`;
+    }
+    case "projection_receipt":
+      return `projection receipt for ${summarizeIds(input.fsyncMounts.map(({ id }) => id))}`;
+    case "project_snapshot_create":
+      return `checkout snapshot of ${input.projectRoot}`;
+    case "project_snapshot_apply":
+      return `checkout snapshot restore into ${input.mirrors.map(({ targetPath }) => targetPath).join(", ") || "no checkouts"}`;
+    case "project_snapshot_persist":
+      return `checkout durability of ${input.snapshot.manifest.projectRoot}`;
+    case "project_snapshot_rollback":
+      return `checkout snapshot rollback of ${input.snapshot.manifest.projectRoot}`;
+    case "project_snapshots_recover":
+      return `interrupted checkout snapshot recovery under ${input.temporaryRoot}`;
+    case "project_branch_create": {
+      const create = input;
+      return `branch creation ${create.branchName} from ${create.sourceBranchName} in ${create.projectRoot}`;
+    }
+    case "project_checkout_path_move": {
+      const move = input;
+      return `checkout path move ${move.oldProjectRoot} \u2192 ${move.newProjectRoot}`;
+    }
+  }
+}
+function serializeWorkspaceFilesystemError(error, depth = 0) {
+  if (!(error instanceof Error)) return { name: "Error", message: String(error) };
+  const record = error;
+  const serialized = { name: error.name, message: error.message };
+  if (typeof error.stack === "string") serialized.stack = error.stack;
+  if (typeof record.code === "string") serialized.code = record.code;
+  if (record.branchMayExist === true) serialized.branchMayExist = true;
+  if (Array.isArray(record.cleanupFailures) && record.cleanupFailures.every((failure) => typeof failure === "string")) {
+    serialized.cleanupFailures = [...record.cleanupFailures];
+  }
+  if (depth < 4) {
+    if (Array.isArray(record.errors)) serialized.errors = record.errors.map((inner) => serializeWorkspaceFilesystemError(inner, depth + 1));
+    if (record.cause !== void 0) serialized.cause = serializeWorkspaceFilesystemError(record.cause, depth + 1);
+  }
+  return serialized;
+}
+function restoreWorkspaceFilesystemError(serialized) {
+  const cause = serialized.cause ? restoreWorkspaceFilesystemError(serialized.cause) : void 0;
+  const options = cause ? { cause } : void 0;
+  const error = serialized.errors ? new AggregateError(serialized.errors.map(restoreWorkspaceFilesystemError), serialized.message, options) : new Error(serialized.message, options);
+  error.name = serialized.name;
+  if (serialized.stack) error.stack = serialized.stack;
+  if (serialized.code !== void 0) error.code = serialized.code;
+  if (serialized.branchMayExist) error.branchMayExist = true;
+  if (serialized.cleanupFailures) error.cleanupFailures = [...serialized.cleanupFailures];
+  return error;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WORKSPACE_FILESYSTEM_JOB_KINDS,
+  describeWorkspaceFilesystemJob,
+  isWorkspaceFilesystemJobKind,
+  restoreWorkspaceFilesystemError,
+  serializeWorkspaceFilesystemError
+});