@ricsam/r5d-worker 0.0.55 → 0.0.56

package/dist/types/workspace-command-sync-policy.d.ts

@@ -0,0 +1,19 @@
+type WorkspaceCommandTarget = {
+    type: "project";
+} | {
+    type: "workspace";
+    rootProfile: "visible_projects" | "canonical_sync";
+};
+type WorkspaceCommandMutationCoordinator = {
+    runMutation<T>(operation: () => Promise<T> | T): Promise<T>;
+    acquireMutation(): Promise<() => void>;
+};
+/**
+ * Commands in visible checkouts behave like independent Git clients and may
+ * overlap periodic synchronization. Canonical remediation commands mutate the
+ * sync checkout itself, so they must remain serialized with synchronization.
+ */
+export declare function shouldSerializeWorkspaceCommand(target: WorkspaceCommandTarget): boolean;
+export declare function runWorkspaceCommand<T>(target: WorkspaceCommandTarget, coordinator: WorkspaceCommandMutationCoordinator, operation: () => Promise<T> | T): Promise<T>;
+export declare function acquireWorkspaceCommandMutation(target: WorkspaceCommandTarget, coordinator: WorkspaceCommandMutationCoordinator): Promise<(() => void) | undefined>;
+export {};

package/dist/types/workspace-mutation-gate.d.ts

@@ -4,7 +4,9 @@ export type WorkspaceMutationLease = () => void;
  *
  * Ordinary worktree activity may overlap other ordinary activity, but a sync
  * gets exclusive access. Once a sync is queued, later mutations wait behind it
- * so a busy shell cannot starve canonical publication indefinitely.
+ * so a queued sync cannot be starved by later short mutations. Long-running
+ * visible-checkout commands do not enter this gate; canonical remediation
+ * commands do because they operate on the sync checkout itself.
  */
 export declare class WorkspaceMutationGate {
     private activeMutations;

package/dist/types/workspace-sync.d.ts

@@ -93,13 +93,24 @@ type GitlinkEntry = {
     filePath: string;
     objectId: string;
 };
+type VisibleHydrationEntry = {
+    kind: "blob";
+    mode: "100644" | "100755" | "120000";
+    objectId: string;
+} | {
+    kind: "gitlink";
+    objectId: string;
+};
+type VisibleHydrationPreimage = Map<string, VisibleHydrationEntry>;
+type VisibleHydrationPreimages = Map<string, VisibleHydrationPreimage | null>;
 type GitlinkProjection = {
     entries: GitlinkEntry[];
     opaqueRoots: string[];
+    visiblePreimages?: VisibleHydrationPreimages;
 };
 export declare function assertCanonicalCheckoutIndexMatchesWorktree(checkoutPath: string): void;
 export declare function mirrorVisibleWorkspaceToShadow(input: WorkspaceSyncInput, excludedCheckouts?: ReadonlySet<string>): GitlinkProjection;
-export declare function mirrorShadowWorkspaceToVisible(input: WorkspaceSyncInput, opaqueWorkspaceRoots?: readonly string[]): void;
+export declare function mirrorShadowWorkspaceToVisible(input: WorkspaceSyncInput, opaqueWorkspaceRoots?: readonly string[], hydrationPreimages?: VisibleHydrationPreimages): void;
 export declare function assertWorkspaceQuarantineRef(quarantineRef: string): void;
 export declare function synchronizeWorkspace(rawInput: WorkspaceSyncInput): Promise<WorkspaceSyncResult>;
 export declare function calculateWorkspaceDiffFingerprint(rawInput: WorkspaceSyncInput): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/r5d-worker",
-  "version": "0.0.55",
+  "version": "0.0.56",
   "type": "module",
   "main": "./dist/cjs/main.cjs",
   "module": "./dist/mjs/main.mjs",