@indigoai-us/hq-cloud 6.15.75 → 6.15.77

package/dist/sync/parallel-sync-coordinator.js

@@ -0,0 +1,287 @@
+import { assertCanonicalPath, PathLeaseManager, pathsConflict } from "./path-leases.js";
+function identityKey(path) {
+    return `${path.targetUid}\u0000${path.areaId}\u0000${path.canonicalPath}`;
+}
+function overlaps(left, right) {
+    return left.targetUid === right.targetUid && left.areaId === right.areaId && pathsConflict(left.canonicalPath, right.canonicalPath);
+}
+class SubmissionValidationError extends Error {
+    paths;
+    constructor(paths, message) {
+        super(message);
+        this.paths = paths;
+    }
+}
+/**
+ * Scheduler and fencing authority for semantic sync work. It deliberately owns
+ * mailboxes, lease acquisition, path epochs, and adapter selection so callers
+ * cannot smuggle in a lane, lock, argv, or worker choice.
+ */
+export class DefaultParallelSyncCoordinator {
+    options;
+    leases = new PathLeaseManager();
+    realtimeQueue = [];
+    choreQueue = [];
+    epochs = [];
+    clock;
+    identifyPath;
+    planChorePaths;
+    nextId = 1;
+    nextEpoch = 1;
+    realtimeRunning;
+    choreRunning;
+    stopping = false;
+    shutdownPromise;
+    constructor(options) {
+        this.options = options;
+        this.clock = options.clock ?? { now: () => Date.now() };
+        if (typeof options.identifyPath !== "function")
+            throw new Error("parallel sync coordinator requires identifyPath");
+        if (typeof options.planChorePaths !== "function")
+            throw new Error("parallel sync coordinator requires planChorePaths");
+        this.identifyPath = options.identifyPath;
+        this.planChorePaths = options.planChorePaths;
+    }
+    submit(work) {
+        if (this.stopping)
+            return Promise.resolve(this.retryableOutcome(this.pathsFor(work), "coordinator is shutting down"));
+        return new Promise((resolve) => {
+            let submission;
+            try {
+                submission = this.createSubmission(work, resolve);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                const paths = error instanceof SubmissionValidationError ? error.paths : [];
+                resolve({
+                    paths: paths.map((path) => ({ path, epoch: 0, status: "refused", reason: message })),
+                    error: message,
+                });
+                return;
+            }
+            if (this.hasInternallyConflictingPaths(submission.paths)) {
+                resolve(this.refusedOutcome(submission.paths, "submission contains internally conflicting paths"));
+                return;
+            }
+            this.registerEpochs(submission);
+            if (work.class === "realtime")
+                this.preemptForRealtime(submission);
+            const queue = work.class === "realtime" ? this.realtimeQueue : this.choreQueue;
+            queue.push(submission);
+            this.finishIfEmpty(submission);
+            this.drain();
+        });
+    }
+    inspect() {
+        return {
+            realtimeQueued: this.realtimeQueue.filter((submission) => !submission.finished).length,
+            choreQueued: this.choreQueue.filter((submission) => !submission.finished).length,
+            realtimeRunning: this.realtimeRunning !== undefined,
+            choreRunning: this.choreRunning !== undefined,
+            leases: this.leases.inspect(),
+            now: this.clock.now(),
+        };
+    }
+    shutdown() {
+        if (this.shutdownPromise)
+            return this.shutdownPromise;
+        this.stopping = true;
+        for (const submission of [...this.realtimeQueue, ...this.choreQueue]) {
+            this.completeRemaining(submission, "retryable", "coordinator is shutting down");
+        }
+        this.realtimeQueue.length = 0;
+        this.choreQueue.length = 0;
+        this.realtimeRunning?.controller.abort();
+        this.choreRunning?.controller.abort();
+        this.shutdownPromise = Promise.allSettled([this.realtimeRunning?.execution, this.choreRunning?.execution]
+            .filter((execution) => execution !== undefined)).then(() => undefined);
+        return this.shutdownPromise;
+    }
+    createSubmission(work, resolve) {
+        const paths = this.pathsFor(work);
+        return {
+            id: `sync-${this.nextId++}`,
+            work,
+            paths,
+            results: new Map(),
+            resolve,
+            controller: new AbortController(),
+            running: false,
+            finished: false,
+        };
+    }
+    pathsFor(work) {
+        const source = work.class === "realtime" ? work.paths : this.planChorePaths(work);
+        try {
+            for (const canonicalPath of source)
+                assertCanonicalPath(canonicalPath);
+        }
+        catch (error) {
+            throw new SubmissionValidationError(source, error instanceof Error ? error.message : String(error));
+        }
+        const unique = new Map();
+        for (const canonicalPath of source) {
+            let identity;
+            try {
+                identity = this.identifyPath(canonicalPath);
+            }
+            catch (error) {
+                throw new SubmissionValidationError(source, error instanceof Error ? error.message : String(error));
+            }
+            const scheduled = { canonicalPath, ...identity, epoch: this.nextEpoch++ };
+            unique.set(identityKey(scheduled), scheduled);
+        }
+        return [...unique.values()];
+    }
+    registerEpochs(submission) {
+        this.epochs.push(...submission.paths.map((path) => ({ ...path, class: submission.work.class })));
+    }
+    hasInternallyConflictingPaths(paths) {
+        return paths.some((path, index) => paths.slice(index + 1).some((other) => overlaps(path, other)));
+    }
+    preemptForRealtime(incoming) {
+        for (const queued of [...this.realtimeQueue, ...this.choreQueue]) {
+            const revoked = queued.paths.filter((path) => incoming.paths.some((candidate) => overlaps(path, candidate)));
+            if (revoked.length === 0)
+                continue;
+            for (const path of revoked)
+                this.setResult(queued, path, "refused", "superseded by newer realtime work");
+            queued.paths = queued.paths.filter((path) => !revoked.includes(path));
+            this.finishIfEmpty(queued);
+        }
+        for (const running of [this.realtimeRunning, this.choreRunning]) {
+            if (running && running.paths.some((path) => incoming.paths.some((candidate) => overlaps(path, candidate)))) {
+                running.controller.abort();
+            }
+        }
+    }
+    drain() {
+        if (this.stopping)
+            return;
+        if (!this.realtimeRunning)
+            this.startNext("realtime");
+        if (!this.choreRunning)
+            this.startNext("chore");
+    }
+    startNext(kind) {
+        const queue = kind === "realtime" ? this.realtimeQueue : this.choreQueue;
+        for (let index = 0; index < queue.length; index += 1) {
+            const submission = queue[index];
+            if (submission.finished)
+                continue;
+            const lease = this.leases.tryAcquire(submission.id, this.requestsFor(submission.paths));
+            if (!lease)
+                continue;
+            queue.splice(index, 1);
+            submission.lease = lease;
+            submission.running = true;
+            if (kind === "realtime")
+                this.realtimeRunning = submission;
+            else
+                this.choreRunning = submission;
+            submission.execution = this.execute(kind, submission);
+            return;
+        }
+    }
+    requestsFor(paths) {
+        return paths.map(({ targetUid, areaId, canonicalPath }) => ({ targetUid, areaId, canonicalPath, mode: "mutation" }));
+    }
+    async execute(kind, submission) {
+        const worker = kind === "realtime" ? this.options.realtimeWorker : this.options.choreWorker;
+        try {
+            const outcome = await worker.execute({
+                id: submission.id,
+                work: submission.work,
+                paths: submission.paths,
+                signal: submission.controller.signal,
+            });
+            this.applyWorkerOutcome(submission, outcome);
+        }
+        catch (error) {
+            this.completeAfterWorkerFailure(submission, error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            submission.lease?.release();
+            submission.running = false;
+            if (kind === "realtime")
+                this.realtimeRunning = undefined;
+            else
+                this.choreRunning = undefined;
+            this.finishIfEmpty(submission);
+            this.drain();
+        }
+    }
+    applyWorkerOutcome(submission, outcome) {
+        if (this.stopping) {
+            this.completeRemaining(submission, "retryable", "coordinator is shutting down");
+            return;
+        }
+        const byPath = new Map(outcome.paths.map((result) => [result.path, result]));
+        for (const path of submission.paths) {
+            if (this.isStale(path)) {
+                this.setResult(submission, path, "refused", "stale path epoch");
+                continue;
+            }
+            const result = byPath.get(path.canonicalPath);
+            if (!result || result.epoch !== path.epoch) {
+                this.setResult(submission, path, "retryable", outcome.error ?? "worker omitted or mismatched a path outcome");
+                continue;
+            }
+            this.setResult(submission, path, result.status, result.reason);
+        }
+    }
+    isStale(path) {
+        return this.epochs.some((intent) => intent.targetUid === path.targetUid &&
+            intent.areaId === path.areaId &&
+            intent.epoch > path.epoch &&
+            pathsConflict(intent.canonicalPath, path.canonicalPath) &&
+            intent.class === "realtime");
+    }
+    completeAfterWorkerFailure(submission, reason) {
+        for (const path of submission.paths) {
+            if (submission.results.has(identityKey(path)))
+                continue;
+            if (this.isStale(path))
+                this.setResult(submission, path, "refused", "stale path epoch");
+            else
+                this.setResult(submission, path, "retryable", reason);
+        }
+        this.finishIfEmpty(submission);
+    }
+    setResult(submission, path, status, reason) {
+        submission.results.set(identityKey(path), { path: path.canonicalPath, status, epoch: path.epoch, ...(reason ? { reason } : {}) });
+    }
+    completeRemaining(submission, status, reason) {
+        for (const path of submission.paths) {
+            if (!submission.results.has(identityKey(path)))
+                this.setResult(submission, path, status, reason);
+        }
+        this.finishIfEmpty(submission);
+    }
+    finishIfEmpty(submission) {
+        if (submission.finished || submission.running)
+            return;
+        if (submission.paths.some((path) => !submission.results.has(identityKey(path))))
+            return;
+        submission.finished = true;
+        submission.resolve({ paths: [...submission.results.values()] });
+        this.pruneEpochs();
+    }
+    pruneEpochs() {
+        const livePaths = [
+            ...this.realtimeQueue,
+            ...this.choreQueue,
+            this.realtimeRunning,
+            this.choreRunning,
+        ].flatMap((submission) => submission && !submission.finished ? submission.paths : []);
+        this.epochs = this.epochs.filter((intent) => livePaths.some((path) => identityKey(path) === identityKey(intent) && path.epoch === intent.epoch) ||
+            (intent.class === "realtime" && livePaths.some((path) => path.epoch < intent.epoch && overlaps(path, intent))));
+    }
+    refusedOutcome(paths, reason) {
+        return { paths: paths.map((path) => ({ path: path.canonicalPath, epoch: path.epoch, status: "refused", reason })) };
+    }
+    retryableOutcome(paths, reason) {
+        return { paths: paths.map((path) => ({ path: path.canonicalPath, epoch: path.epoch, status: "retryable", reason })) };
+    }
+}
+//# sourceMappingURL=parallel-sync-coordinator.js.map

package/dist/sync/parallel-sync-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-sync-coordinator.js","sourceRoot":"","sources":["../../src/sync/parallel-sync-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,aAAa,EAAyC,MAAM,kBAAkB,CAAC;AA0D/H,SAAS,WAAW,CAAC,IAAmE;IACtF,OAAO,GAAG,IAAI,CAAC,SAAS,SAAS,IAAI,CAAC,MAAM,SAAS,IAAI,CAAC,aAAa,EAAE,CAAC;AAC5E,CAAC;AAED,SAAS,QAAQ,CAAC,IAAmB,EAAE,KAAoB;IACzD,OAAO,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;AACtI,CAAC;AAED,MAAM,yBAA0B,SAAQ,KAAK;IAEhC;IADX,YACW,KAA+B,EACxC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,UAAK,GAAL,KAAK,CAA0B;IAI1C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,8BAA8B;IAeZ;IAdZ,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAChC,aAAa,GAAiB,EAAE,CAAC;IACjC,UAAU,GAAiB,EAAE,CAAC;IACvC,MAAM,GAAkB,EAAE,CAAC;IAClB,KAAK,CAAmB;IACxB,YAAY,CAAwC;IACpD,cAAc,CAAoD;IAC3E,MAAM,GAAG,CAAC,CAAC;IACX,SAAS,GAAG,CAAC,CAAC;IACd,eAAe,CAAc;IAC7B,YAAY,CAAc;IAC1B,QAAQ,GAAG,KAAK,CAAC;IACjB,eAAe,CAAiB;IAExC,YAA6B,OAAuC;QAAvC,YAAO,GAAP,OAAO,CAAgC;QAClE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACxD,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACnH,IAAI,OAAO,OAAO,CAAC,cAAc,KAAK,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvH,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,IAAc;QACnB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,8BAA8B,CAAC,CAAC,CAAC;QACtH,OAAO,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,EAAE;YAC1C,IAAI,UAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,MAAM,KAAK,GAAG,KAAK,YAAY,yBAAyB,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5E,OAAO,CAAC;oBACN,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;oBACpF,KAAK,EAAE,OAAO;iBACf,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzD,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,KAAK,EAAE,kDAAkD,CAAC,CAAC,CAAC;gBACnG,OAAO;YACT,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAChC,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU;gBAAE,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;YACnE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;YAC/E,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM;YACtF,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM;YAChF,eAAe,EAAE,IAAI,CAAC,eAAe,KAAK,SAAS;YACnD,YAAY,EAAE,IAAI,CAAC,YAAY,KAAK,SAAS;YAC7C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YAC7B,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,QAAQ;QACN,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC,eAAe,CAAC;QACtD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,KAAK,MAAM,UAAU,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,WAAW,EAAE,8BAA8B,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;QACzC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;QACtC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,UAAU,CACvC,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC;aAC5D,MAAM,CAAC,CAAC,SAAS,EAA8B,EAAE,CAAC,SAAS,KAAK,SAAS,CAAC,CAC9E,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAEO,gBAAgB,CAAC,IAAc,EAAE,OAA8B;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO;YACL,EAAE,EAAE,QAAQ,IAAI,CAAC,MAAM,EAAE,EAAE;YAC3B,IAAI;YACJ,KAAK;YACL,OAAO,EAAE,IAAI,GAAG,EAAE;YAClB,OAAO;YACP,UAAU,EAAE,IAAI,eAAe,EAAE;YACjC,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAEO,QAAQ,CAAC,IAAc;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAClF,IAAI,CAAC;YACH,KAAK,MAAM,aAAa,IAAI,MAAM;gBAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,yBAAyB,CAAC,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtG,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;QAChD,KAAK,MAAM,aAAa,IAAI,MAAM,EAAE,CAAC;YACnC,IAAI,QAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,yBAAyB,CAAC,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtG,CAAC;YACD,MAAM,SAAS,GAAkB,EAAE,aAAa,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACzF,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9B,CAAC;IAEO,cAAc,CAAC,UAAsB;QAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACnG,CAAC;IAEO,6BAA6B,CAAC,KAA+B;QACnE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACpG,CAAC;IAEO,kBAAkB,CAAC,QAAoB;QAC7C,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACjE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;YAC7G,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACnC,KAAK,MAAM,IAAI,IAAI,OAAO;gBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,mCAAmC,CAAC,CAAC;YACzG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAChE,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3G,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK;QACX,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAEO,SAAS,CAAC,IAA0B;QAC1C,MAAM,KAAK,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QACzE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACrD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;YACjC,IAAI,UAAU,CAAC,QAAQ;gBAAE,SAAS;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;YACxF,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACvB,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC;YACzB,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,IAAI,IAAI,KAAK,UAAU;gBAAE,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC;;gBACtD,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;YACpC,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,KAA+B;QACjD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IACvH,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAA0B,EAAE,UAAsB;QACtE,MAAM,MAAM,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QAC5F,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;gBACnC,EAAE,EAAE,UAAU,CAAC,EAAE;gBACjB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM;aACrC,CAAC,CAAC;YACH,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,0BAA0B,CAAC,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtG,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;YAC5B,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;YAC3B,IAAI,IAAI,KAAK,UAAU;gBAAE,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;;gBACrD,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,UAAsB,EAAE,OAAoB;QACrE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,WAAW,EAAE,8BAA8B,CAAC,CAAC;YAChF,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7E,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;gBAChE,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC3C,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,KAAK,IAAI,6CAA6C,CAAC,CAAC;gBAC9G,SAAS;YACX,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,IAAmB;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACjC,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;YACnC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAC7B,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;YACzB,aAAa,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC;YACvD,MAAM,CAAC,KAAK,KAAK,UAAU,CAC5B,CAAC;IACJ,CAAC;IAEO,0BAA0B,CAAC,UAAsB,EAAE,MAAc;QACvE,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAAE,SAAS;YACxD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;;gBACnF,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAEO,SAAS,CACf,UAAsB,EACtB,IAAmB,EACnB,MAAiC,EACjC,MAAe;QAEf,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACpI,CAAC;IAEO,iBAAiB,CAAC,UAAsB,EAAE,MAAiC,EAAE,MAAc;QACjG,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnG,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAEO,aAAa,CAAC,UAAsB;QAC1C,IAAI,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC,OAAO;YAAE,OAAO;QACtD,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO;QACxF,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC3B,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAEO,WAAW;QACjB,MAAM,SAAS,GAAG;YAChB,GAAG,IAAI,CAAC,aAAa;YACrB,GAAG,IAAI,CAAC,UAAU;YAClB,IAAI,CAAC,eAAe;YACpB,IAAI,CAAC,YAAY;SAClB,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAC1C,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC;YAClG,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAC/G,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,KAA+B,EAAE,MAAc;QACpE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC;IACtH,CAAC;IAEO,gBAAgB,CAAC,KAAsB,EAAE,MAAc;QAC7D,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC;IACxH,CAAC;CACF"}

package/dist/sync/parallel-sync-coordinator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parallel-sync-coordinator.test.d.ts.map

package/dist/sync/parallel-sync-coordinator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-sync-coordinator.test.d.ts","sourceRoot":"","sources":["../../src/sync/parallel-sync-coordinator.test.ts"],"names":[],"mappings":""}

package/dist/sync/parallel-sync-coordinator.test.js

@@ -0,0 +1,281 @@
+import { describe, expect, it, vi } from "vitest";
+import { DefaultParallelSyncCoordinator } from "./parallel-sync-coordinator.js";
+import { InlineSyncWorkerAdapter } from "./sync-work.js";
+function realtime(path, causality = path) {
+    return { class: "realtime", source: "watcher", direction: "push", paths: [path], causality };
+}
+function chore(kind = "full-reconcile") {
+    return { class: "chore", kind, areas: ["root:notes"] };
+}
+function durable(slice) {
+    return { paths: slice.paths.map((path) => ({ path: path.canonicalPath, epoch: path.epoch, status: "durable" })) };
+}
+function testIdentity(path) {
+    return { targetUid: "test-target", areaId: `root:${path.split("/")[0] ?? "files"}` };
+}
+function deferred() {
+    let resolve;
+    const promise = new Promise((done) => { resolve = done; });
+    return { promise, resolve };
+}
+async function flush() {
+    await Promise.resolve();
+    await Promise.resolve();
+}
+describe("DefaultParallelSyncCoordinator", () => {
+    it("starts realtime while an unrelated chore is indefinitely blocked", async () => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date("2026-08-27T12:00:00.000Z"));
+        const starts = [];
+        const never = new Promise(() => undefined);
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            choreWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                starts.push(`chore:${slice.paths[0]?.canonicalPath}`);
+                return never;
+            }),
+            realtimeWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                starts.push(`realtime:${slice.paths[0]?.canonicalPath}`);
+                return durable(slice);
+            }),
+            planChorePaths: () => ["slow/report"],
+            clock: { now: () => Date.now() },
+        });
+        void coordinator.submit(chore());
+        await flush();
+        await expect(coordinator.submit(realtime("fresh/file"))).resolves.toMatchObject({ paths: [{ path: "fresh/file", status: "durable" }] });
+        expect(starts).toEqual(["chore:slow/report", "realtime:fresh/file"]);
+        expect(coordinator.inspect().now).toBe(Date.parse("2026-08-27T12:00:00.000Z"));
+        vi.useRealTimers();
+    });
+    it("serializes ancestor conflicts and runs realtime immediately after the active chore", async () => {
+        const events = [];
+        const finishChore = deferred();
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            choreWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                events.push("chore:start");
+                slice.signal.addEventListener("abort", () => events.push("chore:cancel"), { once: true });
+                return finishChore.promise;
+            }),
+            realtimeWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                events.push("realtime:start");
+                return durable(slice);
+            }),
+            planChorePaths: () => ["notes/today"],
+        });
+        const choreOutcome = coordinator.submit(chore());
+        await flush();
+        const realtimeOutcome = coordinator.submit(realtime("notes"));
+        await flush();
+        expect(events).toEqual(["chore:start", "chore:cancel"]);
+        finishChore.resolve({ paths: [{ path: "notes/today", epoch: 1, status: "durable" }] });
+        await expect(realtimeOutcome).resolves.toMatchObject({ paths: [{ path: "notes", status: "durable" }] });
+        await expect(choreOutcome).resolves.toMatchObject({ paths: [{ path: "notes/today", status: "refused", reason: "stale path epoch" }] });
+        expect(events).toEqual(["chore:start", "chore:cancel", "realtime:start"]);
+    });
+    it("revokes unstarted chore paths and lets only the newest realtime event commit", async () => {
+        const firstRealtime = deferred();
+        const starts = [];
+        let realtimeCalls = 0;
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            choreWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                starts.push(`chore:${slice.paths[0]?.canonicalPath}`);
+                if (slice.paths[0]?.canonicalPath === "unrelated")
+                    return new Promise(() => undefined);
+                return durable(slice);
+            }),
+            realtimeWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                realtimeCalls += 1;
+                starts.push(`realtime:${realtimeCalls}`);
+                return realtimeCalls === 1 ? firstRealtime.promise : durable(slice);
+            }),
+            planChorePaths: (work) => work.kind === "cadence" ? ["unrelated"] : ["notes/today"],
+        });
+        void coordinator.submit(chore("cadence"));
+        await flush();
+        const queuedChore = coordinator.submit(chore());
+        const older = coordinator.submit(realtime("notes/today", "older"));
+        await flush();
+        const newest = coordinator.submit(realtime("notes/today", "newest"));
+        await flush();
+        firstRealtime.resolve({ paths: [{ path: "notes/today", epoch: 2, status: "durable" }] });
+        await expect(queuedChore).resolves.toMatchObject({ paths: [{ status: "refused", reason: "superseded by newer realtime work" }] });
+        await expect(older).resolves.toMatchObject({ paths: [{ status: "refused", reason: "stale path epoch" }] });
+        await expect(newest).resolves.toMatchObject({ paths: [{ status: "durable" }] });
+        expect(starts).toEqual(["chore:unrelated", "realtime:1", "realtime:2"]);
+    });
+    it("returns retryable outcomes and releases leases after worker failure", async () => {
+        let calls = 0;
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            planChorePaths: () => [],
+            choreWorker: new InlineSyncWorkerAdapter(async (slice) => durable(slice)),
+            realtimeWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                calls += 1;
+                if (calls === 1)
+                    throw new Error("worker lost");
+                return durable(slice);
+            }),
+        });
+        await expect(coordinator.submit(realtime("notes/today"))).resolves.toMatchObject({ paths: [{ status: "retryable", reason: "worker lost" }] });
+        expect(coordinator.inspect().leases).toEqual([]);
+        await expect(coordinator.submit(realtime("notes/today"))).resolves.toMatchObject({ paths: [{ status: "durable" }] });
+    });
+    it("refuses a worker result that is not fenced by the scheduled path epoch", async () => {
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            planChorePaths: () => [],
+            choreWorker: new InlineSyncWorkerAdapter(async (slice) => durable(slice)),
+            realtimeWorker: new InlineSyncWorkerAdapter(async (slice) => ({
+                paths: slice.paths.map((path) => ({ path: path.canonicalPath, epoch: path.epoch + 1, status: "durable" })),
+            })),
+        });
+        await expect(coordinator.submit(realtime("notes/today"))).resolves.toMatchObject({
+            paths: [{ status: "retryable", reason: "worker omitted or mismatched a path outcome" }],
+        });
+    });
+    it("waits for the cancellation boundary before shutdown releases an active lease", async () => {
+        const finish = deferred();
+        let cancelled = false;
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            planChorePaths: () => [],
+            choreWorker: new InlineSyncWorkerAdapter(async (slice) => durable(slice)),
+            realtimeWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                slice.signal.addEventListener("abort", () => { cancelled = true; }, { once: true });
+                return finish.promise;
+            }),
+        });
+        const outcome = coordinator.submit(realtime("notes/today"));
+        await flush();
+        let shutdownDone = false;
+        const shuttingDown = coordinator.shutdown().then(() => { shutdownDone = true; });
+        await flush();
+        expect(cancelled).toBe(true);
+        expect(shutdownDone).toBe(false);
+        expect(coordinator.inspect().leases).toHaveLength(1);
+        finish.resolve({ paths: [{ path: "notes/today", epoch: 1, status: "durable" }] });
+        await shuttingDown;
+        await expect(outcome).resolves.toMatchObject({ paths: [{ status: "retryable", reason: "coordinator is shutting down" }] });
+        expect(coordinator.inspect().leases).toEqual([]);
+    });
+    it("keeps a reserved chore worker making progress under realtime load", async () => {
+        const starts = [];
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            choreWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                starts.push("chore");
+                return durable(slice);
+            }),
+            realtimeWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                starts.push(`realtime:${slice.paths[0]?.canonicalPath}`);
+                return durable(slice);
+            }),
+            planChorePaths: () => ["chores/progress"],
+        });
+        const choreOutcome = coordinator.submit(chore());
+        const realtimeOutcomes = Array.from({ length: 20 }, (_, index) => coordinator.submit(realtime(`events/${index}`)));
+        await expect(choreOutcome).resolves.toMatchObject({ paths: [{ status: "durable" }] });
+        await Promise.all(realtimeOutcomes);
+        expect(starts).toContain("chore");
+    });
+    it("requires real ownership resolution and a chore planner", () => {
+        const worker = new InlineSyncWorkerAdapter(async (slice) => durable(slice));
+        expect(() => new DefaultParallelSyncCoordinator({ realtimeWorker: worker, choreWorker: worker })).toThrow("requires identifyPath");
+        expect(() => new DefaultParallelSyncCoordinator({
+            realtimeWorker: worker,
+            choreWorker: worker,
+            identifyPath: testIdentity,
+        })).toThrow("requires planChorePaths");
+    });
+    it("refuses malformed paths before they can block later work", async () => {
+        const calls = [];
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            planChorePaths: () => [],
+            choreWorker: new InlineSyncWorkerAdapter(async (slice) => durable(slice)),
+            realtimeWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                calls.push(slice.paths[0].canonicalPath);
+                return durable(slice);
+            }),
+        });
+        await expect(coordinator.submit(realtime("/notes"))).resolves.toMatchObject({
+            paths: [{ path: "/notes", status: "refused" }],
+        });
+        await expect(coordinator.submit(realtime("notes/today"))).resolves.toMatchObject({
+            paths: [{ path: "notes/today", status: "durable" }],
+        });
+        expect(calls).toEqual(["notes/today"]);
+    });
+    it("refuses internally conflicting batches instead of leaving them queued", async () => {
+        const worker = vi.fn(async (slice) => durable(slice));
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            planChorePaths: () => [],
+            choreWorker: new InlineSyncWorkerAdapter(worker),
+            realtimeWorker: new InlineSyncWorkerAdapter(worker),
+        });
+        await expect(coordinator.submit({ ...realtime("notes"), paths: ["notes", "notes/today"] })).resolves.toMatchObject({
+            paths: [
+                { path: "notes", status: "refused" },
+                { path: "notes/today", status: "refused" },
+            ],
+        });
+        expect(worker).not.toHaveBeenCalled();
+        expect(coordinator.inspect().realtimeQueued).toBe(0);
+    });
+    it("refuses a cancelled stale mutation when its worker rejects", async () => {
+        const cancelled = deferred();
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            planChorePaths: () => ["notes/today"],
+            choreWorker: new InlineSyncWorkerAdapter(async (slice) => {
+                slice.signal.addEventListener("abort", () => cancelled.resolve(undefined), { once: true });
+                await cancelled.promise;
+                throw new Error("worker cancelled");
+            }),
+            realtimeWorker: new InlineSyncWorkerAdapter(async (slice) => durable(slice)),
+        });
+        const stale = coordinator.submit(chore());
+        await flush();
+        const latest = coordinator.submit(realtime("notes/today"));
+        await expect(latest).resolves.toMatchObject({ paths: [{ status: "durable" }] });
+        await expect(stale).resolves.toMatchObject({ paths: [{ status: "refused", reason: "stale path epoch" }] });
+    });
+    it("returns the same shutdown drain to concurrent callers", async () => {
+        const finish = deferred();
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            planChorePaths: () => [],
+            choreWorker: new InlineSyncWorkerAdapter(async (slice) => durable(slice)),
+            realtimeWorker: new InlineSyncWorkerAdapter(async () => finish.promise),
+        });
+        void coordinator.submit(realtime("notes/today"));
+        await flush();
+        const first = coordinator.shutdown();
+        const second = coordinator.shutdown();
+        expect(second).toBe(first);
+        finish.resolve({ paths: [] });
+        await expect(Promise.all([first, second])).resolves.toEqual([undefined, undefined]);
+    });
+    it("compacts completed epoch history while retaining a newer realtime fence", async () => {
+        const finishChore = deferred();
+        const coordinator = new DefaultParallelSyncCoordinator({
+            identifyPath: testIdentity,
+            planChorePaths: () => ["notes/today"],
+            choreWorker: new InlineSyncWorkerAdapter(async () => finishChore.promise),
+            realtimeWorker: new InlineSyncWorkerAdapter(async (slice) => durable(slice)),
+        });
+        const choreOutcome = coordinator.submit(chore());
+        await flush();
+        const realtimeOutcome = coordinator.submit(realtime("notes/today"));
+        expect(coordinator.epochs).toHaveLength(2);
+        finishChore.resolve({ paths: [{ path: "notes/today", epoch: 1, status: "durable" }] });
+        await expect(realtimeOutcome).resolves.toMatchObject({ paths: [{ status: "durable" }] });
+        await expect(choreOutcome).resolves.toMatchObject({ paths: [{ status: "refused" }] });
+        expect(coordinator.epochs).toEqual([]);
+    });
+});
+//# sourceMappingURL=parallel-sync-coordinator.test.js.map

package/dist/sync/parallel-sync-coordinator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-sync-coordinator.test.js","sourceRoot":"","sources":["../../src/sync/parallel-sync-coordinator.test.ts"],"names":[],"mappings":"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"}