@indigoai-us/hq-cloud 6.15.2 → 6.15.3

package/dist/sync/mutation-session.js

@@ -0,0 +1,282 @@
+/**
+ * Local, enrolled V2 mutation session for the desktop sidecar boundary.
+ *
+ * This intentionally obtains fresh inventory + lease authority through the
+ * same RealtimePassAuthorizer used by the sync machinery.  The caller gives
+ * us only a change; bearer, lease, device binding, revisions, and generation
+ * remain local to hq-cloud and never cross stdin.
+ */
+import { createHash, randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { CognitoAuthError, CognitoRefreshError, getValidAccessToken, VaultClient } from "../index.js";
+import { pickCanonicalPersonEntity } from "../vault-client.js";
+import { HQ_CLOUD_VERSION } from "../version.js";
+import { getOrCreateMachineId } from "../lib/machine-id.js";
+import { RealtimeEnrollmentUnavailableError, RealtimeLeaseClient, RealtimePassAuthorizer, membershipRevisionFromLease, } from "./lease-client.js";
+import { MutationClient } from "./mutation-client.js";
+import { DurableAttemptSpool } from "./multipart-uploader.js";
+import { RealtimeRolloutClient } from "./realtime-rollout.js";
+import { resolveAuthoritativeBaseVersion } from "./base-version-resolver.js";
+import { UploaderFinalizer, openUploaderFinalizationStore } from "./uploader-finalization.js";
+const DEFAULT_API_URL = process.env.HQ_VAULT_API_URL ?? "https://hqapi.hq.computer";
+const EMPTY_SHA256 = `sha256:${createHash("sha256").update("").digest("hex")}`;
+export const SYNC_MUTATION_NOT_ENROLLED_EXIT = 3;
+export class SyncMutationNotEnrolledError extends Error {
+    constructor() {
+        super("local hq-cloud session is not enrolled for realtime V2 mutations");
+        this.name = "SyncMutationNotEnrolledError";
+    }
+}
+function defaultHqRoot() {
+    return process.env.HQ_HOME ?? process.env.HQ_ROOT ?? path.join(os.homedir(), "hq");
+}
+function defaultCognitoConfig() {
+    return {
+        region: process.env.AWS_REGION ?? "us-east-1",
+        userPoolDomain: process.env.HQ_COGNITO_DOMAIN ?? "vault-indigo-hq-prod",
+        clientId: process.env.HQ_COGNITO_CLIENT_ID ?? "7acei2c8v870enheptb1j5foln",
+        port: process.env.HQ_COGNITO_CALLBACK_PORT ? Number(process.env.HQ_COGNITO_CALLBACK_PORT) : 8765,
+    };
+}
+function fingerprint(value) {
+    return createHash("sha256").update(JSON.stringify(value)).digest("hex");
+}
+function sourceDigest(bytes) {
+    return `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
+}
+/**
+ * Builds complete V2 requests from one local enrolled session.  A fresh lease
+ * is issued for every submission; stale/revoked inventory never falls back to
+ * a legacy path.
+ */
+export class LocalEnrolledMutationSession {
+    apiUrl;
+    hqRoot;
+    getAccessToken;
+    resolvePersonalScopeUid;
+    mutationClient;
+    authorizer;
+    deviceId;
+    capabilityVector;
+    resolveBaseVersion;
+    constructor(deps = {}) {
+        this.apiUrl = (deps.apiUrl ?? DEFAULT_API_URL).replace(/\/+$/, "");
+        this.hqRoot = deps.hqRoot ?? defaultHqRoot();
+        this.getAccessToken = deps.getAccessToken ?? (() => getValidAccessToken(defaultCognitoConfig(), { interactive: false }));
+        this.resolvePersonalScopeUid = deps.resolvePersonalScopeUid ?? (async (bearer) => {
+            const client = new VaultClient({ apiUrl: this.apiUrl, authToken: bearer, region: process.env.AWS_REGION ?? "us-east-1" });
+            const person = pickCanonicalPersonEntity(await client.entity.listByType("person"));
+            if (!person?.uid)
+                throw new SyncMutationNotEnrolledError();
+            return person.uid;
+        });
+        this.mutationClient = deps.createMutationClient?.(this.apiUrl) ?? new MutationClient({ apiUrl: this.apiUrl });
+        this.deviceId = deps.deviceId ?? getOrCreateMachineId(this.hqRoot);
+        this.capabilityVector = deps.capabilityVector ?? {
+            hqCloud: HQ_CLOUD_VERSION,
+            hqDesktop: process.env.HQ_INSTALLER_VERSION ?? "none",
+            protocol: 2,
+            journal: 3,
+            durableApply: 2,
+        };
+        this.resolveBaseVersion = deps.resolveBaseVersion ?? ((input) => resolveAuthoritativeBaseVersion(input, input.canonicalPath));
+        this.authorizer = deps.authorizer ?? new RealtimePassAuthorizer(this.getAccessToken, new RealtimeRolloutClient({ apiUrl: this.apiUrl }), new RealtimeLeaseClient({ apiUrl: this.apiUrl }));
+    }
+    async submit(change) {
+        let bearer;
+        try {
+            bearer = await this.getAccessToken();
+        }
+        catch (error) {
+            if (error instanceof CognitoAuthError && !(error instanceof CognitoRefreshError && !error.requiresReauth)) {
+                throw new SyncMutationNotEnrolledError();
+            }
+            throw error;
+        }
+        const scopeUid = await this.resolvePersonalScopeUid(bearer);
+        let authorized;
+        try {
+            authorized = await this.authorizer.authorizeWithBearer(bearer, {
+                deviceId: this.deviceId,
+                capabilityVector: this.capabilityVector,
+                configurationFingerprint: fingerprint(this.capabilityVector),
+                scopeFingerprint: fingerprint([scopeUid]),
+                scopeUids: [scopeUid],
+            });
+        }
+        catch (error) {
+            if (error instanceof RealtimeEnrollmentUnavailableError)
+                throw new SyncMutationNotEnrolledError();
+            throw error;
+        }
+        const scope = authorized.scopes[0];
+        if (!scope)
+            throw new SyncMutationNotEnrolledError();
+        if (Date.parse(scope.lease.expiresAt) <= Date.now()) {
+            throw new Error("realtime mutation: lease expired before local submission");
+        }
+        const membershipRevision = membershipRevisionFromLease(scope.lease);
+        const stateRoot = path.join(this.hqRoot, ".hq", "realtime-mutation-state");
+        const releasePathLock = await acquireMutationPathLock(stateRoot, scopeUid, change.canonicalPath);
+        try {
+            const finalizer = new UploaderFinalizer(openUploaderFinalizationStore({
+                rootDir: stateRoot,
+                scopeId: `${scopeUid}:uploader`,
+            }));
+            const authorization = {
+                bearer: authorized.bearer,
+                deviceId: this.deviceId,
+                capabilityVector: this.capabilityVector,
+                lease: scope.lease,
+            };
+            const existing = finalizer.getState().paths[change.canonicalPath];
+            const planned = existing?.plannedMutation;
+            if (planned) {
+                const recovered = await this.resumePlan(finalizer, planned, authorization, membershipRevision, scope.grant.scopeRevision);
+                if (recovered.status.status !== "committed" || isSameChange(planned, change))
+                    return recovered;
+            }
+            const previous = finalizer.getState().paths[change.canonicalPath];
+            const source = change.op === "upsert" ? requireBytes(change) : undefined;
+            const sha256 = source ? sourceDigest(source) : previous?.sha256 ?? EMPTY_SHA256;
+            const generation = (previous?.generation ?? -1) + 1;
+            const baseVersionId = previous?.synchronizedVersionId ?? this.resolveBaseVersion({ apiUrl: this.apiUrl, hqRoot: this.hqRoot, scopeUid, canonicalPath: change.canonicalPath });
+            finalizer.recordDirty({ path: change.canonicalPath, generation, sha256, baseVersionId });
+            const plan = {
+                path: change.canonicalPath, generation, sha256, baseVersionId,
+                clientMutationId: randomUUID(), operation: change.op, membershipRevision, scopeRevision: scope.grant.scopeRevision,
+                ...(source ? { bytes: persistBytes(path.join(stateRoot, "pending-by-client-id"), randomUUID(), source, sourceModeFor(this.hqRoot, change.canonicalPath)) } : {}),
+            };
+            finalizer.recordMutationPlan(plan);
+            return this.submitPlan(finalizer, plan, authorization);
+        }
+        finally {
+            releasePathLock();
+        }
+    }
+    async resumePlan(finalizer, plan, authorization, membershipRevision, scopeRevision) {
+        if (plan.membershipRevision !== membershipRevision || plan.scopeRevision !== scopeRevision) {
+            throw new Error("realtime mutation: pending attempt authorization changed; recover only after V2 reset");
+        }
+        return this.submitPlan(finalizer, plan, authorization);
+    }
+    async submitPlan(finalizer, plan, authorization) {
+        const bytes = plan.operation === "upsert" ? readPersistedBytes(plan) : undefined;
+        const request = {
+            contractVersion: 2,
+            deviceId: this.deviceId,
+            clientMutationId: plan.clientMutationId,
+            canonicalPath: plan.path,
+            operation: plan.operation,
+            baseVersionId: plan.baseVersionId,
+            generation: plan.generation,
+            membershipRevision: plan.membershipRevision,
+            scopeRevision: plan.scopeRevision,
+            ...(plan.operation === "upsert" ? { source: { kind: "regular", mode: plan.bytes.mode, sha256: plan.sha256, size: bytes.byteLength } } : {}),
+        };
+        const result = await this.mutationClient.submit({
+            authorization, request, ...(bytes ? { bytes, spoolDirectory: path.dirname(plan.bytes.filePath) } : {}),
+            onPrepared: (attemptId) => finalizer.recordAttempt({ attemptId, path: plan.path, generation: plan.generation, sha256: plan.sha256, baseVersionId: plan.baseVersionId }),
+        });
+        if (result.status.status === "committed") {
+            // A lost prepare/commit response can leave the server terminal before a
+            // process had a chance to append onPrepared. Reconstruct the immutable
+            // attempt from the pre-prepare plan before finalization consumes it.
+            if (!finalizer.getState().paths[plan.path]?.attempts[result.status.attemptId]) {
+                finalizer.recordAttempt({ attemptId: result.status.attemptId, path: plan.path, generation: plan.generation, sha256: plan.sha256, baseVersionId: plan.baseVersionId });
+            }
+            finalizer.finalize({ attemptId: result.status.attemptId, path: plan.path, generation: plan.generation, sha256: plan.sha256, versionId: result.status.versionId, deltaId: result.status.deltaId });
+            if (plan.bytes) {
+                try {
+                    fs.unlinkSync(plan.bytes.filePath);
+                }
+                catch { /* a retained committed spool is harmless recovery evidence */ }
+            }
+        }
+        return result;
+    }
+}
+function requireBytes(change) {
+    if (!change.bytes)
+        throw new Error("sync mutation: upsert requires contentBase64");
+    return change.bytes;
+}
+function persistBytes(directory, spoolId, bytes, mode) {
+    const spool = DurableAttemptSpool.create(directory, spoolId, bytes);
+    return { filePath: spool.filePath, size: spool.size, sha256: spool.sha256, mode };
+}
+function sourceModeFor(hqRoot, canonicalPath) {
+    const root = path.resolve(hqRoot);
+    const localPath = path.resolve(root, canonicalPath);
+    const relative = path.relative(root, localPath);
+    if (!relative || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+        throw new Error("realtime mutation: canonical path escapes the local HQ root");
+    }
+    const stat = fs.statSync(localPath);
+    if (!stat.isFile())
+        throw new Error("realtime mutation: upsert source is not a regular file");
+    return stat.mode & 0o777;
+}
+/**
+ * Cross-process, stale-owner-recovering serialization for one scope/path.
+ * It covers generation allocation through commit, so concurrent sidecars cannot
+ * both reserve the same durable generation. The async poll deliberately keeps
+ * this process's event loop free while another local submission is in flight.
+ */
+async function acquireMutationPathLock(stateRoot, scopeUid, canonicalPath) {
+    const directory = path.join(stateRoot, "submission-locks");
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    const owner = `${process.pid}\n`;
+    const lockPath = path.join(directory, createHash("sha256").update(`${scopeUid}\0${canonicalPath}`).digest("hex") + ".lock");
+    for (;;) {
+        try {
+            const fd = fs.openSync(lockPath, "wx", 0o600);
+            try {
+                fs.writeFileSync(fd, owner);
+                fs.fsyncSync(fd);
+            }
+            finally {
+                fs.closeSync(fd);
+            }
+            return () => {
+                try {
+                    if (fs.readFileSync(lockPath, "utf8") === owner)
+                        fs.unlinkSync(lockPath);
+                }
+                catch {
+                    // A stale owner can be reclaimed by a later process.
+                }
+            };
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            try {
+                const ownerPid = Number(fs.readFileSync(lockPath, "utf8"));
+                try {
+                    process.kill(ownerPid, 0);
+                }
+                catch (probeError) {
+                    if (probeError.code === "ESRCH")
+                        fs.unlinkSync(lockPath);
+                }
+            }
+            catch (readError) {
+                if (readError.code === "ENOENT")
+                    continue;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 20));
+        }
+    }
+}
+function readPersistedBytes(plan) {
+    if (!plan.bytes)
+        throw new Error("realtime mutation: durable recovery bytes are unavailable");
+    return Uint8Array.from(fs.readFileSync(plan.bytes.filePath));
+}
+function isSameChange(plan, change) {
+    return plan.operation === change.op && (change.op === "delete" || plan.sha256 === sourceDigest(requireBytes(change)));
+}
+//# sourceMappingURL=mutation-session.js.map

package/dist/sync/mutation-session.js.map

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

package/dist/sync/mutation-session.test.d.ts

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

package/dist/sync/mutation-session.test.d.ts.map

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

package/dist/sync/mutation-session.test.js

@@ -0,0 +1,190 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { describe, expect, it, vi } from "vitest";
+import { LocalEnrolledMutationSession, SyncMutationNotEnrolledError, } from "./mutation-session.js";
+import { RealtimeEnrollmentUnavailableError } from "./lease-client.js";
+import { CognitoAuthError, CognitoRefreshError } from "../cognito-auth.js";
+function enrolledAuthorization(overrides = {}) {
+    const leasePayload = Buffer.from(JSON.stringify({ membershipRevision: "membership_7" })).toString("base64url");
+    return {
+        bearer: "bearer_1",
+        scopes: [{
+                grant: { scopeUid: "person_1", scopeHandle: "scope_1", scopeRevision: "scope_9", state: "v2-ready", cursor: "cursor_1" },
+                lease: {
+                    lease: `${leasePayload}.signature`,
+                    issuedAt: new Date(Date.now() - 1_000).toISOString(),
+                    expiresAt: new Date(Date.now() + 30_000).toISOString(),
+                    authorizationEpoch: "epoch_1",
+                    ...overrides,
+                },
+            }],
+    };
+}
+function committed() {
+    return { requestDigest: "digest_1", status: { status: "committed", attemptId: "attempt_1", versionId: "version_1", deltaId: "delta_1" } };
+}
+describe("LocalEnrolledMutationSession", () => {
+    it("builds a complete authorized V2 upsert from only path and bytes", async () => {
+        const hqRoot = fs.mkdtempSync(path.join(os.tmpdir(), "hq-cloud-mutation-session-"));
+        const authorization = enrolledAuthorization();
+        fs.mkdirSync(path.join(hqRoot, "notes"), { recursive: true });
+        fs.writeFileSync(path.join(hqRoot, "notes", "a.md"), Buffer.from([0, 1, 2]));
+        fs.chmodSync(path.join(hqRoot, "notes", "a.md"), 0o754);
+        const authorizeWithBearer = vi.fn().mockResolvedValue(authorization);
+        let submitted;
+        const submit = vi.fn(async (input) => {
+            submitted = input;
+            await input.onPrepared?.("attempt_1");
+            return committed();
+        });
+        try {
+            const session = new LocalEnrolledMutationSession({
+                hqRoot,
+                deviceId: "device_1",
+                getAccessToken: async () => "bearer_1",
+                resolvePersonalScopeUid: async () => "person_1",
+                authorizer: { authorizeWithBearer },
+                resolveBaseVersion: () => "version_sync",
+                createMutationClient: () => ({ submit }),
+            });
+            await expect(session.submit({ canonicalPath: "notes/a.md", op: "upsert", bytes: Uint8Array.from([0, 1, 2]) })).resolves.toEqual(committed());
+            expect(authorizeWithBearer).toHaveBeenCalledWith("bearer_1", expect.objectContaining({ deviceId: "device_1", scopeUids: ["person_1"] }));
+            expect(submitted).toMatchObject({
+                authorization: { bearer: "bearer_1", deviceId: "device_1", lease: authorization.scopes[0].lease },
+                request: expect.objectContaining({
+                    contractVersion: 2,
+                    canonicalPath: "notes/a.md",
+                    operation: "upsert",
+                    baseVersionId: "version_sync",
+                    generation: 0,
+                    membershipRevision: "membership_7",
+                    scopeRevision: "scope_9",
+                    source: expect.objectContaining({ size: 3, mode: 0o754 }),
+                }),
+                bytes: Uint8Array.from([0, 1, 2]),
+            });
+        }
+        finally {
+            fs.rmSync(hqRoot, { recursive: true, force: true });
+        }
+    });
+    it("submits a delete without bytes", async () => {
+        const hqRoot = fs.mkdtempSync(path.join(os.tmpdir(), "hq-cloud-mutation-session-"));
+        const submit = vi.fn(async (input) => {
+            await input.onPrepared?.("attempt_1");
+            return committed();
+        });
+        try {
+            const session = new LocalEnrolledMutationSession({
+                hqRoot, deviceId: "device_1", getAccessToken: async () => "bearer_1",
+                resolvePersonalScopeUid: async () => "person_1", authorizer: { authorizeWithBearer: async () => enrolledAuthorization() },
+                resolveBaseVersion: () => null,
+                createMutationClient: () => ({ submit }),
+            });
+            await session.submit({ canonicalPath: "notes/a.md", op: "delete" });
+            expect(submit).toHaveBeenCalledWith(expect.objectContaining({
+                request: expect.objectContaining({ operation: "delete" }),
+            }));
+            expect(submit.mock.calls[0][0].request).not.toHaveProperty("source");
+            expect(submit.mock.calls[0][0]).not.toHaveProperty("bytes");
+        }
+        finally {
+            fs.rmSync(hqRoot, { recursive: true, force: true });
+        }
+    });
+    it("fails closed before V2 I/O when the local session is not enrolled or rollout-enabled", async () => {
+        const submit = vi.fn();
+        const hqRoot = fs.mkdtempSync(path.join(os.tmpdir(), "hq-cloud-mutation-session-"));
+        const session = new LocalEnrolledMutationSession({
+            hqRoot,
+            getAccessToken: async () => "bearer_1", resolvePersonalScopeUid: async () => "person_1",
+            authorizer: { authorizeWithBearer: async () => { throw new RealtimeEnrollmentUnavailableError(); } },
+            createMutationClient: () => ({ submit }),
+        });
+        await expect(session.submit({ canonicalPath: "notes/a.md", op: "delete" })).rejects.toBeInstanceOf(SyncMutationNotEnrolledError);
+        expect(submit).not.toHaveBeenCalled();
+        fs.rmSync(hqRoot, { recursive: true, force: true });
+    });
+    it("replays the exact durable prepared attempt before allocating another generation", async () => {
+        const hqRoot = fs.mkdtempSync(path.join(os.tmpdir(), "hq-cloud-mutation-session-"));
+        fs.mkdirSync(path.join(hqRoot, "notes"), { recursive: true });
+        fs.writeFileSync(path.join(hqRoot, "notes", "a.md"), Buffer.from([1, 2, 3]));
+        const firstSubmit = vi.fn(async (input) => {
+            await input.onPrepared?.("attempt_1");
+            throw new Error("lost commit response");
+        });
+        const resolveBaseVersion = vi.fn(() => "version_sync");
+        const common = {
+            hqRoot, deviceId: "device_1", getAccessToken: async () => "bearer_1",
+            resolvePersonalScopeUid: async () => "person_1", authorizer: { authorizeWithBearer: async () => enrolledAuthorization() },
+            resolveBaseVersion,
+        };
+        try {
+            const first = new LocalEnrolledMutationSession({ ...common, createMutationClient: () => ({ submit: firstSubmit }) });
+            await expect(first.submit({ canonicalPath: "notes/a.md", op: "upsert", bytes: Uint8Array.from([1, 2, 3]) })).rejects.toThrow("lost commit response");
+            const firstRequest = firstSubmit.mock.calls[0][0].request;
+            const recoveredSubmit = vi.fn(async (_input) => committed());
+            const second = new LocalEnrolledMutationSession({ ...common, createMutationClient: () => ({ submit: recoveredSubmit }) });
+            await expect(second.submit({ canonicalPath: "notes/a.md", op: "upsert", bytes: Uint8Array.from([1, 2, 3]) })).resolves.toEqual(committed());
+            expect(recoveredSubmit.mock.calls[0][0].request).toMatchObject({
+                clientMutationId: firstRequest.clientMutationId,
+                generation: firstRequest.generation,
+                baseVersionId: "version_sync",
+            });
+            expect(recoveredSubmit.mock.calls[0][0].bytes).toEqual(Uint8Array.from([1, 2, 3]));
+            expect(resolveBaseVersion).toHaveBeenCalledTimes(1);
+        }
+        finally {
+            fs.rmSync(hqRoot, { recursive: true, force: true });
+        }
+    });
+    it("reports a missing local login as not enrolled without starting mutation I/O", async () => {
+        const submit = vi.fn();
+        const session = new LocalEnrolledMutationSession({
+            getAccessToken: async () => { throw new CognitoAuthError("No valid HQ session"); },
+            resolvePersonalScopeUid: async () => "person_1",
+            authorizer: { authorizeWithBearer: async () => enrolledAuthorization() },
+            createMutationClient: () => ({ submit }),
+        });
+        await expect(session.submit({ canonicalPath: "notes/a.md", op: "delete" })).rejects.toBeInstanceOf(SyncMutationNotEnrolledError);
+        expect(submit).not.toHaveBeenCalled();
+    });
+    it("keeps a transient token refresh failure retryable", async () => {
+        const transient = new CognitoRefreshError("refresh temporarily unavailable", false, 503);
+        const submit = vi.fn();
+        const session = new LocalEnrolledMutationSession({
+            getAccessToken: async () => { throw transient; },
+            resolvePersonalScopeUid: async () => "person_1",
+            authorizer: { authorizeWithBearer: async () => enrolledAuthorization() },
+            createMutationClient: () => ({ submit }),
+        });
+        await expect(session.submit({ canonicalPath: "notes/a.md", op: "delete" })).rejects.toBe(transient);
+        expect(submit).not.toHaveBeenCalled();
+    });
+    it("refuses stale leases or a stale-revision authorization before mutation I/O", async () => {
+        const staleLeaseSubmit = vi.fn();
+        const staleLeaseRoot = fs.mkdtempSync(path.join(os.tmpdir(), "hq-cloud-mutation-session-"));
+        const staleLease = new LocalEnrolledMutationSession({
+            hqRoot: staleLeaseRoot,
+            getAccessToken: async () => "bearer_1", resolvePersonalScopeUid: async () => "person_1",
+            authorizer: { authorizeWithBearer: async () => enrolledAuthorization({ expiresAt: new Date(Date.now() - 1).toISOString() }) },
+            createMutationClient: () => ({ submit: staleLeaseSubmit }),
+        });
+        await expect(staleLease.submit({ canonicalPath: "notes/a.md", op: "delete" })).rejects.toThrow("lease expired");
+        expect(staleLeaseSubmit).not.toHaveBeenCalled();
+        const staleRevisionSubmit = vi.fn();
+        const staleRevisionRoot = fs.mkdtempSync(path.join(os.tmpdir(), "hq-cloud-mutation-session-"));
+        const staleRevision = new LocalEnrolledMutationSession({
+            hqRoot: staleRevisionRoot,
+            getAccessToken: async () => "bearer_1", resolvePersonalScopeUid: async () => "person_1",
+            authorizer: { authorizeWithBearer: async () => { throw new Error("realtime authorization: scope revision is stale"); } },
+            createMutationClient: () => ({ submit: staleRevisionSubmit }),
+        });
+        await expect(staleRevision.submit({ canonicalPath: "notes/a.md", op: "delete" })).rejects.toThrow("scope revision is stale");
+        expect(staleRevisionSubmit).not.toHaveBeenCalled();
+        fs.rmSync(staleLeaseRoot, { recursive: true, force: true });
+        fs.rmSync(staleRevisionRoot, { recursive: true, force: true });
+    });
+});
+//# sourceMappingURL=mutation-session.test.js.map

package/dist/sync/mutation-session.test.js.map

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

package/dist/sync/uploader-finalization.d.ts

@@ -23,6 +23,23 @@ export interface DirtyGeneration {
 export interface LocalAttempt extends DirtyGeneration {
     attemptId: string;
 }
+/**
+ * The immutable local identity and recovery bytes selected before `prepare`.
+ * Keeping this in the v3 journal makes a lost prepare response replayable with
+ * the same idempotency key rather than allocating a second generation.
+ */
+export interface PlannedMutation extends DirtyGeneration {
+    clientMutationId: string;
+    operation: "upsert" | "delete";
+    membershipRevision: string;
+    scopeRevision: string;
+    bytes?: {
+        filePath: string;
+        size: number;
+        sha256: `sha256:${string}`;
+        mode: number;
+    };
+}
 export interface CommittedMutation {
     attemptId: string;
     path: string;
@@ -52,6 +69,7 @@ export interface UploaderPathState {
     baseVersionId: string | null;
     synchronizedVersionId: string | null;
     pendingAttemptId?: string;
+    plannedMutation?: PlannedMutation;
     attempts: Record<string, LocalAttempt>;
 }
 export interface UploaderFinalizationState {
@@ -82,6 +100,8 @@ export declare class UploaderFinalizer {
     getState(): UploaderFinalizationState;
     recordDirty(input: DirtyGeneration): void;
     recordAttempt(input: LocalAttempt): void;
+    /** Persist the replay identity and durable source before any prepare I/O. */
+    recordMutationPlan(input: PlannedMutation): void;
     /**
      * Atomically records the logical server result and the self-delta marker.
      * It never changes the scope cursor: only consumeSelfDelta may do that.

package/dist/sync/uploader-finalization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploader-finalization.d.ts","sourceRoot":"","sources":["../../src/sync/uploader-finalization.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"uploader-finalization.d.ts","sourceRoot":"","sources":["../../src/sync/uploader-finalization.ts"],"names":[],"mappings":"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"}