@ricsam/r5d-worker 0.0.57 → 0.0.59

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

@@ -2,8 +2,8 @@ import { type CheckoutPathSegments } from "./managed-paths";
 import { type WorkspaceMutationLease } from "./workspace-mutation-gate";
 export declare const WORKSPACE_BRANCH = "main";
 export declare const WORKSPACE_INTENT_REF_PREFIX = "refs/r5d/workspace-intents/";
+export declare const WORKSPACE_PUBLICATION_REF_PREFIX = "refs/r5d/workspace-publications/";
 export declare const MAX_WORKSPACE_SYNC_DIFF_BYTES: number;
-export declare const WORKSPACE_PERIODIC_SCAN_INTERVAL_MS = 5000;
 export type WorkspaceProjectManifestEntry = {
     projectId: string;
     checkoutPathSegments: CheckoutPathSegments;
@@ -32,7 +32,7 @@ export type WorkspaceSyncTrigger = {
     canonicalCheckoutOnly?: boolean;
     detail?: string;
 };
-export type WorkspaceSyncOutcome = "no_change" | "candidate_ready" | "published" | "updated" | "conflict_reset" | "large_diff_blocked" | "reset" | "failed";
+export type WorkspaceSyncOutcome = "no_change" | "candidate_ready" | "published" | "updated" | "conflict_reset" | "large_diff_blocked" | "conflict_blocked" | "reset" | "failed";
 export type WorkspaceSyncResult = {
     type: "workspace_sync";
     attemptId: string;
@@ -51,7 +51,14 @@ export type WorkspaceSyncResult = {
     affectedPaths: string[];
     discardedPaths: string[];
     localChangesDiscarded: boolean;
+    dirtyGeneration?: number;
     sampledCanonicalCheckoutTreeHash?: string;
+    telemetry?: {
+        totalMs: number;
+        queueMs: number;
+        prepareMs: number;
+        synchronizeMs: number;
+    };
     error?: string;
 };
 export type WorkspaceSyncInput = {
@@ -69,6 +76,8 @@ export type WorkspaceSyncInput = {
      * Workers never publish the canonical workspace branch directly.
      */
     quarantineRef?: string;
+    /** Exact canonical head fenced by checkpoint authority. */
+    expectedCanonicalHead?: string | null;
     confirmedLargeDiff?: boolean;
     confirmationReason?: string;
     resetToCanonical?: boolean;
@@ -113,6 +122,25 @@ export declare function mirrorVisibleWorkspaceToShadow(input: WorkspaceSyncInput
 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 type WorkspaceHeadConvergenceResult = {
+    localHead: string | null;
+    canonicalHead: string | null;
+    localChanges: boolean;
+    hydrated: boolean;
+    hydrationConflicts: string[];
+};
+/**
+ * Fetches the newest canonical head without treating an inbound overlap as an
+ * incident. A busy caller passes hydrateVisible=false, which updates only the
+ * remote-tracking ref. An idle caller may hydrate only after proving that its
+ * visible tree still matches the local workspace head.
+ */
+export declare function convergeWorkspaceHead(rawInput: WorkspaceSyncInput, options: {
+    hydrateVisible: boolean;
+}): Promise<WorkspaceHeadConvergenceResult>;
+/** Returns a local-only fingerprint. Unlike the legacy periodic observation it
+ * deliberately ignores whether origin/main has advanced. */
+export declare function calculateWorkspaceLocalDiffFingerprint(rawInput: WorkspaceSyncInput): string;
 export declare function calculateWorkspaceDiffFingerprint(rawInput: WorkspaceSyncInput): string;
 export declare class WorkspaceSyncSingleFlight {
     private readonly mutationGate;
@@ -122,6 +150,7 @@ export declare class WorkspaceSyncSingleFlight {
     runPrepared(prepare: () => WorkspaceSyncInput): Promise<WorkspaceSyncResult>;
     fingerprint(input: WorkspaceSyncInput): Promise<string>;
     fingerprintPrepared(prepare: () => WorkspaceSyncInput): Promise<string>;
+    runExclusive<T>(operation: () => Promise<T> | T): Promise<T>;
     runMutation<T>(operation: () => Promise<T> | T): Promise<T>;
     acquireMutation(): Promise<WorkspaceMutationLease>;
     afterCurrent(): Promise<void>;

package/package.json

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