@ricsam/r5d-worker 0.0.59 → 0.0.60

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/r5d-worker",
-  "version": "0.0.59",
+  "version": "0.0.60",
   "type": "commonjs"
 }

package/dist/cjs/workspace-convergence.cjs

@@ -28,85 +28,23 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var workspace_convergence_exports = {};
 __export(workspace_convergence_exports, {
-  ExplicitWorkspaceCheckpointQueue: () => ExplicitWorkspaceCheckpointQueue,
-  WORKSPACE_CHECKPOINT_QUIET_MS: () => WORKSPACE_CHECKPOINT_QUIET_MS,
+  ExplicitWorkspacePublicationQueue: () => ExplicitWorkspacePublicationQueue,
   WORKSPACE_IDLE_SAFETY_SCAN_MS: () => WORKSPACE_IDLE_SAFETY_SCAN_MS,
+  WORKSPACE_PUBLICATION_QUIET_MS: () => WORKSPACE_PUBLICATION_QUIET_MS,
   WorkspaceConvergenceState: () => WorkspaceConvergenceState,
-  WorkspaceFilesystemWriterGate: () => WorkspaceFilesystemWriterGate,
   WorkspaceManifestRevisionFence: () => WorkspaceManifestRevisionFence,
   processWorkspaceConvergenceState: () => processWorkspaceConvergenceState,
-  processWorkspaceFilesystemWriterGate: () => processWorkspaceFilesystemWriterGate,
   readWorkspaceConvergenceState: () => readWorkspaceConvergenceState,
-  waitForWorkspaceCheckpointOnShutdown: () => waitForWorkspaceCheckpointOnShutdown,
-  workspaceCheckpointIncidentAction: () => workspaceCheckpointIncidentAction,
-  workspaceCheckpointTelemetry: () => workspaceCheckpointTelemetry
+  waitForWorkspacePublicationOnShutdown: () => waitForWorkspacePublicationOnShutdown,
+  workspacePublicationIncidentAction: () => workspacePublicationIncidentAction,
+  workspacePublicationTelemetry: () => workspacePublicationTelemetry
 });
 module.exports = __toCommonJS(workspace_convergence_exports);
 var import_node_fs = __toESM(require("node:fs"), 1);
 var import_node_path = __toESM(require("node:path"), 1);
-const WORKSPACE_CHECKPOINT_QUIET_MS = 5e3;
+const WORKSPACE_PUBLICATION_QUIET_MS = 5e3;
 const WORKSPACE_IDLE_SAFETY_SCAN_MS = 6e4;
 const WORKSPACE_MANIFEST_REVISION_PATTERN = /^[0-9a-f]{64}$/;
-class WorkspaceFilesystemWriterGate {
-  activeWriters = 0;
-  checkpointActive = false;
-  waitingWriters = [];
-  waitingCheckpoints = [];
-  acquireWriter() {
-    if (!this.checkpointActive && this.waitingCheckpoints.length === 0) {
-      this.activeWriters += 1;
-      return Promise.resolve(this.writerRelease());
-    }
-    return new Promise((resolve) => this.waitingWriters.push(resolve));
-  }
-  tryAcquireCheckpoint() {
-    if (this.checkpointActive || this.activeWriters > 0 || this.waitingCheckpoints.length > 0) return null;
-    this.checkpointActive = true;
-    return this.checkpointRelease();
-  }
-  acquireCheckpoint() {
-    const immediate = this.tryAcquireCheckpoint();
-    if (immediate) return Promise.resolve(immediate);
-    return new Promise((resolve) => this.waitingCheckpoints.push(resolve));
-  }
-  checkpointRelease() {
-    let released = false;
-    return () => {
-      if (released) return;
-      released = true;
-      this.checkpointActive = false;
-      this.drain();
-    };
-  }
-  writerRelease() {
-    let released = false;
-    return () => {
-      if (released) return;
-      released = true;
-      this.activeWriters -= 1;
-      this.drain();
-    };
-  }
-  drain() {
-    if (this.checkpointActive || this.activeWriters > 0) return;
-    const checkpoint = this.waitingCheckpoints.shift();
-    if (checkpoint) {
-      this.checkpointActive = true;
-      checkpoint(this.checkpointRelease());
-      return;
-    }
-    while (this.waitingWriters.length > 0) {
-      const resolve = this.waitingWriters.shift();
-      if (!resolve) continue;
-      this.activeWriters += 1;
-      resolve(this.writerRelease());
-    }
-  }
-}
-const PROCESS_WORKSPACE_FILESYSTEM_WRITERS = new WorkspaceFilesystemWriterGate();
-function processWorkspaceFilesystemWriterGate() {
-  return PROCESS_WORKSPACE_FILESYSTEM_WRITERS;
-}
 class WorkspaceManifestRevisionFence {
   sequence = 0;
   requestedRevision = null;
@@ -132,7 +70,7 @@ class WorkspaceManifestRevisionFence {
     return this.completedRevision === this.requestedRevision ? this.completedRevision : null;
   }
 }
-function workspaceCheckpointTelemetry(input) {
+function workspacePublicationTelemetry(input) {
   return {
     totalMs: Math.max(0, input.finishedAt - input.requestedAt),
     queueMs: Math.max(0, input.prepareStartedAt - input.requestedAt),
@@ -140,21 +78,21 @@ function workspaceCheckpointTelemetry(input) {
     synchronizeMs: Math.max(0, input.finishedAt - input.synchronizeStartedAt)
   };
 }
-function workspaceCheckpointIncidentAction(requestId) {
+function workspacePublicationIncidentAction(requestId) {
   return requestId ? "request_terminal_authority" : "defer_automatic";
 }
-class ExplicitWorkspaceCheckpointQueue {
+class ExplicitWorkspacePublicationQueue {
   scheduled;
   queued = [];
-  schedule(checkpoint, pendingRequestId) {
-    if (pendingRequestId === checkpoint.requestId || this.scheduled?.requestId === checkpoint.requestId || this.queued.some((queued) => queued.requestId === checkpoint.requestId)) {
+  schedule(publication, pendingRequestId) {
+    if (pendingRequestId === publication.requestId || this.scheduled?.requestId === publication.requestId || this.queued.some((queued) => queued.requestId === publication.requestId)) {
       return false;
     }
     if (pendingRequestId || this.scheduled) {
-      this.queued.push(checkpoint);
+      this.queued.push(publication);
       return false;
     }
-    this.scheduled = checkpoint;
+    this.scheduled = publication;
     return true;
   }
   hasScheduled() {
@@ -163,11 +101,11 @@ class ExplicitWorkspaceCheckpointQueue {
   consumeScheduled(requestId) {
     if (this.scheduled?.requestId === requestId) this.scheduled = void 0;
   }
-  enqueue(checkpoint, pendingRequestId) {
-    if (pendingRequestId === checkpoint.requestId || this.scheduled?.requestId === checkpoint.requestId || this.queued.some((queued) => queued.requestId === checkpoint.requestId)) {
+  enqueue(publication, pendingRequestId) {
+    if (pendingRequestId === publication.requestId || this.scheduled?.requestId === publication.requestId || this.queued.some((queued) => queued.requestId === publication.requestId)) {
       return;
     }
-    this.queued.push(checkpoint);
+    this.queued.push(publication);
   }
   next() {
     return this.queued.shift();
@@ -205,13 +143,13 @@ class WorkspaceConvergenceState {
   constructor(statePath) {
     this.statePath = statePath;
     this.state = readWorkspaceConvergenceState(statePath);
-    this.checkpointState = this.state.dirtyGeneration > this.state.publishedGeneration ? "scheduled" : "idle";
+    this.publicationState = this.state.dirtyGeneration > this.state.publishedGeneration ? "scheduled" : "idle";
   }
   statePath;
   state;
-  checkpointState;
+  publicationState;
   snapshot() {
-    return { ...this.state, checkpointState: this.checkpointState };
+    return { ...this.state, publicationState: this.publicationState };
   }
   setLocalHead(localHead) {
     if (!validHead(localHead)) throw new Error("Invalid local workspace head");
@@ -227,39 +165,39 @@ class WorkspaceConvergenceState {
   }
   markDirty() {
     this.state.dirtyGeneration += 1;
-    if (this.checkpointState === "idle") this.checkpointState = "scheduled";
+    if (this.publicationState === "idle") this.publicationState = "scheduled";
     this.persist();
     return this.state.dirtyGeneration;
   }
   schedule() {
-    if (this.checkpointState === "idle") this.checkpointState = "scheduled";
+    if (this.publicationState === "idle") this.publicationState = "scheduled";
   }
   beginPreparing() {
-    if (this.checkpointState === "preparing" || this.checkpointState === "submitting") {
-      throw new Error("A workspace checkpoint is already in flight");
+    if (this.publicationState === "preparing" || this.publicationState === "submitting") {
+      throw new Error("A workspace publication is already in flight");
     }
-    this.checkpointState = "preparing";
+    this.publicationState = "preparing";
   }
   beginSubmitting() {
-    if (this.checkpointState !== "preparing") throw new Error("Workspace checkpoint authority was not prepared");
-    this.checkpointState = "submitting";
+    if (this.publicationState !== "preparing") throw new Error("Workspace publication authority was not prepared");
+    this.publicationState = "submitting";
   }
   defer() {
-    this.checkpointState = "scheduled";
+    this.publicationState = "scheduled";
   }
   block() {
-    this.checkpointState = "blocked";
+    this.publicationState = "blocked";
   }
   releaseBlock() {
-    this.checkpointState = this.state.dirtyGeneration > this.state.publishedGeneration ? "scheduled" : "idle";
+    this.publicationState = this.state.dirtyGeneration > this.state.publishedGeneration ? "scheduled" : "idle";
   }
   observeIncidentState(blocked) {
-    if (this.checkpointState === "preparing" || this.checkpointState === "submitting") return;
+    if (this.publicationState === "preparing" || this.publicationState === "submitting") return;
     if (blocked) this.block();
     else this.releaseBlock();
   }
-  resetTransientCheckpointState() {
-    this.checkpointState = this.state.dirtyGeneration > this.state.publishedGeneration ? "scheduled" : "idle";
+  resetTransientPublicationState() {
+    this.publicationState = this.state.dirtyGeneration > this.state.publishedGeneration ? "scheduled" : "idle";
   }
   complete(input) {
     if (!validGeneration(input.generation) || input.generation > this.state.dirtyGeneration) {
@@ -271,7 +209,7 @@ class WorkspaceConvergenceState {
       this.state.localHead = input.canonicalHead;
       this.state.desiredCanonicalHead = input.canonicalHead;
     }
-    this.checkpointState = this.state.dirtyGeneration > this.state.publishedGeneration ? "scheduled" : "idle";
+    this.publicationState = this.state.dirtyGeneration > this.state.publishedGeneration ? "scheduled" : "idle";
     this.persist();
   }
   persist() {
@@ -291,30 +229,28 @@ function processWorkspaceConvergenceState(statePath) {
   PROCESS_WORKSPACE_CONVERGENCE_STATES.set(key, created);
   return created;
 }
-async function waitForWorkspaceCheckpointOnShutdown(input) {
-  input.forceCheckpoint();
+async function waitForWorkspacePublicationOnShutdown(input) {
+  input.forcePublication();
   const deadline = Date.now() + (input.timeoutMs ?? 1e4);
   const pollMs = input.pollMs ?? 50;
   while (Date.now() < deadline) {
     const snapshot = input.snapshot();
-    if (snapshot.checkpointState === "blocked") return "blocked";
-    if (snapshot.checkpointState === "idle" && snapshot.publishedGeneration >= snapshot.dirtyGeneration) return "settled";
+    if (snapshot.publicationState === "blocked") return "blocked";
+    if (snapshot.publicationState === "idle" && snapshot.publishedGeneration >= snapshot.dirtyGeneration) return "settled";
     await new Promise((resolve) => setTimeout(resolve, pollMs));
   }
   return "timed_out";
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ExplicitWorkspaceCheckpointQueue,
-  WORKSPACE_CHECKPOINT_QUIET_MS,
+  ExplicitWorkspacePublicationQueue,
   WORKSPACE_IDLE_SAFETY_SCAN_MS,
+  WORKSPACE_PUBLICATION_QUIET_MS,
   WorkspaceConvergenceState,
-  WorkspaceFilesystemWriterGate,
   WorkspaceManifestRevisionFence,
   processWorkspaceConvergenceState,
-  processWorkspaceFilesystemWriterGate,
   readWorkspaceConvergenceState,
-  waitForWorkspaceCheckpointOnShutdown,
-  workspaceCheckpointIncidentAction,
-  workspaceCheckpointTelemetry
+  waitForWorkspacePublicationOnShutdown,
+  workspacePublicationIncidentAction,
+  workspacePublicationTelemetry
 });

package/dist/cjs/workspace-manifest-admission.cjs

@@ -28,8 +28,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var workspace_manifest_admission_exports = {};
 __export(workspace_manifest_admission_exports, {
-  acquireWorkspaceManifestVisibleLease: () => acquireWorkspaceManifestVisibleLease,
-  inspectWorkspaceManifestAdmission: () => inspectWorkspaceManifestAdmission
+  inspectWorkspaceManifestFilesystem: () => inspectWorkspaceManifestFilesystem
 });
 module.exports = __toCommonJS(workspace_manifest_admission_exports);
 var import_node_fs = __toESM(require("node:fs"), 1);
@@ -39,7 +38,7 @@ function hasNormalGitDirectory(checkoutPath) {
   const gitPath = import_node_path.default.join(checkoutPath, ".git");
   return import_node_fs.default.existsSync(gitPath) && import_node_fs.default.statSync(gitPath).isDirectory();
 }
-function inspectWorkspaceManifestAdmission(input) {
+function inspectWorkspaceManifestFilesystem(input) {
   const firstBootstrap = !hasNormalGitDirectory(input.workspaceShadowRoot);
   const missingCheckouts = [];
   const migratedProjectIds = [];
@@ -56,15 +55,10 @@ function inspectWorkspaceManifestAdmission(input) {
   return {
     firstBootstrap,
     missingCheckouts,
-    migratedProjectIds,
-    requiresVisibleLease: firstBootstrap || migratedProjectIds.length > 0
+    migratedProjectIds
   };
 }
-async function acquireWorkspaceManifestVisibleLease(gate, admission) {
-  return admission.requiresVisibleLease ? await gate.acquireCheckpoint() : void 0;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  acquireWorkspaceManifestVisibleLease,
-  inspectWorkspaceManifestAdmission
+  inspectWorkspaceManifestFilesystem
 });

package/dist/cjs/workspace-sync.cjs

@@ -1759,9 +1759,7 @@ function assertWorkspaceQuarantineRef(quarantineRef) {
   const prefix = quarantineRef.startsWith(WORKSPACE_PUBLICATION_REF_PREFIX) ? WORKSPACE_PUBLICATION_REF_PREFIX : WORKSPACE_INTENT_REF_PREFIX;
   const suffix = quarantineRef.slice(prefix.length);
   if (!quarantineRef.startsWith(prefix) || !/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(suffix)) {
-    throw new Error(
-      `Workspace candidate ref must be below ${WORKSPACE_PUBLICATION_REF_PREFIX} or ${WORKSPACE_INTENT_REF_PREFIX}`
-    );
+    throw new Error(`Workspace candidate ref must be below ${WORKSPACE_PUBLICATION_REF_PREFIX} or ${WORKSPACE_INTENT_REF_PREFIX}`);
   }
   const result = Bun.spawnSync(["git", "check-ref-format", quarantineRef], {
     stdout: "pipe",
@@ -1979,11 +1977,7 @@ async function synchronizeWorkspace(rawInput) {
     const destructiveReductions = destructiveCheckoutReductions(input, baseRevision);
     if (destructiveReductions.length > 0 && !input.confirmedLargeDiff) {
       const summary = destructiveReductions.map(({ root, trackedBefore, trackedAfter }) => `${root} (${trackedBefore} -> ${trackedAfter} tracked files)`).join(", ");
-      return preserveLargeDiffCandidate(
-        input,
-        observed,
-        `Workspace safety guard blocked a destructive checkout reduction: ${summary}`
-      );
+      return preserveLargeDiffCandidate(input, observed, `Workspace safety guard blocked a destructive checkout reduction: ${summary}`);
     }
     if (paths.length > 0 && diffSizeBytes > MAX_WORKSPACE_SYNC_DIFF_BYTES && !input.confirmedLargeDiff && !input.trigger.canonicalCheckoutOnly) {
       return preserveLargeDiffCandidate(