@infinite-room-labs/claudesync-core 0.3.0 → 0.4.0

package/dist/sync/diff.js

@@ -0,0 +1,125 @@
+import { buildMessageTree, getAllBranches, shortLeafLabel, } from "../tree/message-tree.js";
+/**
+ * Diffs a freshly fetched conversation (with full message tree from
+ * ?tree=True) and its current artifact list against a previously stored
+ * SyncState.
+ *
+ * If prevState is undefined the result describes an "initial" sync: every
+ * branch is new, every artifact is added.
+ */
+export function diffConversation(prevState, conversation, artifacts) {
+    const nodeMap = buildMessageTree(conversation.chat_messages);
+    const branchMap = getAllBranches(nodeMap);
+    const allLeafUuids = Array.from(branchMap.keys());
+    const prevLeaves = new Map();
+    if (prevState) {
+        for (const l of prevState.leaves) {
+            prevLeaves.set(l.uuid, l.last_message_index);
+        }
+    }
+    // For each current leaf, find the deepest ancestor that was a previous
+    // leaf. If found, the current branch is an "extension" of that previous
+    // branch (same conceptual branch, new messages). If not, it's a brand-new
+    // branch. This avoids flagging "Branch main discovered" every time the
+    // current leaf moves forward.
+    const branches = [];
+    for (const [leafUuid, messages] of branchMap) {
+        const exactMatchIndex = prevLeaves.get(leafUuid);
+        let predecessorLeafUuid;
+        let predecessorIndex;
+        if (exactMatchIndex !== undefined) {
+            predecessorLeafUuid = leafUuid;
+            predecessorIndex = exactMatchIndex;
+        }
+        else {
+            // Walk root->leaf and pick the deepest ancestor that was a previous leaf.
+            for (const m of messages) {
+                const idx = prevLeaves.get(m.uuid);
+                if (idx !== undefined) {
+                    predecessorLeafUuid = m.uuid;
+                    predecessorIndex = idx;
+                }
+            }
+        }
+        const leafMsg = messages[messages.length - 1];
+        const currentIndex = leafMsg?.index ?? -1;
+        const isNew = predecessorLeafUuid === undefined;
+        const hasNewMessages = !isNew && currentIndex > (predecessorIndex ?? -1);
+        const newMessageIndices = isNew
+            ? messages.map((m) => m.index)
+            : messages
+                .filter((m) => m.index > (predecessorIndex ?? -1))
+                .map((m) => m.index);
+        branches.push({
+            leafUuid,
+            shortLabel: shortLeafLabel(leafUuid, allLeafUuids),
+            isMain: leafUuid === conversation.current_leaf_message_uuid,
+            isNew,
+            hasNewMessages,
+            newMessageIndices,
+            messages,
+        });
+    }
+    // Sort: main first, then newest leaves first.
+    branches.sort((a, b) => {
+        if (a.isMain !== b.isMain)
+            return a.isMain ? -1 : 1;
+        const aLast = a.messages[a.messages.length - 1]?.created_at ?? "";
+        const bLast = b.messages[b.messages.length - 1]?.created_at ?? "";
+        return bLast.localeCompare(aLast);
+    });
+    // Artifacts
+    const prevArtifacts = new Map();
+    if (prevState) {
+        for (const a of prevState.artifacts) {
+            prevArtifacts.set(a.path, { size: a.size, created_at: a.created_at });
+        }
+    }
+    const currentArtifacts = new Map();
+    for (const a of artifacts.files_metadata) {
+        currentArtifacts.set(a.path, { size: a.size, created_at: a.created_at });
+    }
+    const added = [];
+    const changed = [];
+    const removed = [];
+    for (const [p, info] of currentArtifacts) {
+        const prev = prevArtifacts.get(p);
+        if (!prev) {
+            added.push({ path: p, ...info });
+        }
+        else if (prev.size !== info.size || prev.created_at !== info.created_at) {
+            changed.push({
+                path: p,
+                size: info.size,
+                created_at: info.created_at,
+                prev_size: prev.size,
+                prev_created_at: prev.created_at,
+            });
+        }
+    }
+    for (const [p, prev] of prevArtifacts) {
+        if (!currentArtifacts.has(p)) {
+            removed.push({ path: p, size: prev.size, created_at: prev.created_at });
+        }
+    }
+    // Metadata
+    const metadata = {};
+    if (prevState && prevState.conversation_name !== conversation.name) {
+        metadata.renamed = {
+            from: prevState.conversation_name,
+            to: conversation.name,
+        };
+    }
+    // Note: we do not store the previous model in state v1 (could be added),
+    // so model changes are only detected if state has it. Future-proof here.
+    const isInitial = prevState === undefined;
+    const isUnchanged = !isInitial &&
+        branches.every((b) => !b.isNew && !b.hasNewMessages) &&
+        added.length === 0 &&
+        changed.length === 0 &&
+        removed.length === 0 &&
+        !metadata.renamed &&
+        !metadata.modelChanged;
+    return { isInitial, isUnchanged, branches, artifacts: { added, changed, removed }, metadata };
+}
+//# sourceMappingURL=diff.js.map

package/dist/sync/diff.js.map

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

package/dist/sync/incremental.d.ts

@@ -0,0 +1,36 @@
+import type { ClaudeSyncClient } from "../client/client.js";
+import type { ConversationSummary } from "../models/types.js";
+import { type SyncState } from "./state.js";
+export type ExportFormat = "git" | "files" | "json";
+export interface SyncConversationOptions {
+    format: ExportFormat;
+    authorName: string;
+    authorEmail: string;
+    /** Skip download entirely if list metadata matches stored state. */
+    skipSame?: boolean;
+    /** Skip if outputPath already exists (irrespective of state). */
+    skipExisting?: boolean;
+    /** Don't fetch artifacts. */
+    skipArtifacts?: boolean;
+}
+export interface SyncConversationResult {
+    action: "skipped" | "skipped-existing" | "full" | "incremental";
+    reason?: string;
+    changelogWritten: boolean;
+}
+/**
+ * Cheap predicate for --skip-same. Returns true when the list-endpoint summary
+ * matches what the sidecar state file recorded on the previous sync. Caller
+ * should still write a state file even when this returns false (bootstrap).
+ */
+export declare function isSameByListMetadata(summary: Pick<ConversationSummary, "updated_at" | "current_leaf_message_uuid">, prevState: SyncState | undefined): boolean;
+/**
+ * Orchestrates the sync of a single conversation: decides skip / full /
+ * incremental, fetches data, runs the right exporter, writes the state file
+ * and changelog. Returns metadata describing what happened.
+ *
+ * outputPath should be the conversation's directory (for files/git) or the
+ * directory that will hold `<slug>.json` (for json mode).
+ */
+export declare function syncConversation(client: ClaudeSyncClient, orgId: string, summary: ConversationSummary, outputPath: string, options: SyncConversationOptions): Promise<SyncConversationResult>;
+//# sourceMappingURL=incremental.d.ts.map

package/dist/sync/incremental.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental.d.ts","sourceRoot":"","sources":["../../src/sync/incremental.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAGV,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,GAAG,kBAAkB,GAAG,MAAM,GAAG,aAAa,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,2BAA2B,CAAC,EAC9E,SAAS,EAAE,SAAS,GAAG,SAAS,GAC/B,OAAO,CAMT;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CA+GjC"}

package/dist/sync/incremental.js

@@ -0,0 +1,229 @@
+import fs from "node:fs";
+import path from "node:path";
+import { rmSync } from "node:fs";
+import { buildGitBundle } from "../export/bundle-builder.js";
+import { exportToGit, appendToGit } from "../export/git-exporter.js";
+import { diffConversation } from "./diff.js";
+import { appendChangelog, renderChangelogSection, CHANGELOG_FILENAME, } from "./changelog.js";
+import { readSyncState, writeSyncState, STATE_FILENAME, } from "./state.js";
+import { buildMessageTree, findLeafMessages } from "../tree/message-tree.js";
+/**
+ * Cheap predicate for --skip-same. Returns true when the list-endpoint summary
+ * matches what the sidecar state file recorded on the previous sync. Caller
+ * should still write a state file even when this returns false (bootstrap).
+ */
+export function isSameByListMetadata(summary, prevState) {
+    if (!prevState)
+        return false;
+    if (prevState.updated_at !== summary.updated_at)
+        return false;
+    const prevLeaf = prevState.current_leaf_message_uuid ?? null;
+    const newLeaf = summary.current_leaf_message_uuid ?? null;
+    return prevLeaf === newLeaf;
+}
+/**
+ * Orchestrates the sync of a single conversation: decides skip / full /
+ * incremental, fetches data, runs the right exporter, writes the state file
+ * and changelog. Returns metadata describing what happened.
+ *
+ * outputPath should be the conversation's directory (for files/git) or the
+ * directory that will hold `<slug>.json` (for json mode).
+ */
+export async function syncConversation(client, orgId, summary, outputPath, options) {
+    const stateDir = options.format === "json"
+        ? path.dirname(outputPath)
+        : outputPath;
+    // --skip-existing: legacy, dumb existence check.
+    if (options.skipExisting) {
+        const target = options.format === "json" ? outputPath + ".json" : outputPath;
+        if (fs.existsSync(target)) {
+            return {
+                action: "skipped-existing",
+                reason: "output exists",
+                changelogWritten: false,
+            };
+        }
+    }
+    // --skip-same: read prior state, compare list metadata.
+    let prevState;
+    if (fs.existsSync(stateDir)) {
+        try {
+            prevState = readSyncState(stateDir);
+        }
+        catch {
+            // Corrupted state -> fall through to full sync, will overwrite.
+            prevState = undefined;
+        }
+    }
+    if (options.skipSame && isSameByListMetadata(summary, prevState)) {
+        return {
+            action: "skipped",
+            reason: "unchanged since last sync",
+            changelogWritten: false,
+        };
+    }
+    // Fetch full tree + artifacts.
+    const conversation = await client.getConversation(orgId, summary.uuid, {
+        tree: true,
+    });
+    const { artifacts, artifactContents } = await fetchArtifacts(client, orgId, summary.uuid, !options.skipArtifacts);
+    const diff = diffConversation(prevState, conversation, artifacts);
+    // For json mode: bundle is the full snapshot, written as a single JSON file.
+    if (options.format === "json") {
+        const bundle = buildGitBundle(conversation, artifacts, artifactContents, {
+            authorName: options.authorName,
+            authorEmail: options.authorEmail,
+            multiBranch: true,
+        });
+        fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+        fs.writeFileSync(outputPath + ".json", JSON.stringify(bundle, null, 2), "utf-8");
+        // For json mode, write state file to the directory containing the json file.
+        writeStateFile(stateDir, summary, conversation, artifacts, prevState ? "incremental" : "full");
+        return {
+            action: prevState ? "incremental" : "full",
+            changelogWritten: false,
+        };
+    }
+    // For files / git mode: build a multi-branch bundle.
+    const bundle = buildGitBundle(conversation, artifacts, artifactContents, {
+        authorName: options.authorName,
+        authorEmail: options.authorEmail,
+        multiBranch: true,
+    });
+    const isFresh = !fs.existsSync(outputPath);
+    if (options.format === "git") {
+        if (isFresh) {
+            await exportToGit(bundle, outputPath);
+        }
+        else {
+            await appendToGit(bundle, outputPath);
+        }
+    }
+    else {
+        // files mode: stage in tmp, swap.
+        await writeFilesMode(bundle, outputPath);
+    }
+    // After successful swap: write CHANGELOG, .gitignore (git only), state file.
+    let changelogWritten = false;
+    const section = renderChangelogSection(diff, new Date());
+    if (section) {
+        appendChangelog(outputPath, section);
+        changelogWritten = true;
+    }
+    if (options.format === "git") {
+        ensureGitignore(outputPath);
+    }
+    writeStateFile(outputPath, summary, conversation, artifacts, prevState ? "incremental" : "full");
+    return {
+        action: prevState ? "incremental" : "full",
+        changelogWritten,
+    };
+}
+async function fetchArtifacts(client, orgId, convId, enabled) {
+    const empty = {
+        success: true,
+        files: [],
+        files_metadata: [],
+    };
+    if (!enabled)
+        return { artifacts: empty, artifactContents: new Map() };
+    let artifacts = empty;
+    const artifactContents = new Map();
+    try {
+        artifacts = await client.listArtifacts(orgId, convId);
+        for (const meta of artifacts.files_metadata) {
+            try {
+                const content = await client.downloadArtifact(orgId, convId, meta.path);
+                artifactContents.set(meta.path, content);
+            }
+            catch {
+                // Skip failed artifact downloads.
+            }
+        }
+    }
+    catch {
+        // Some conversations don't support artifacts.
+    }
+    return { artifacts, artifactContents };
+}
+/**
+ * Files mode: replay bundle into outputPath via the same tmp+swap pattern as
+ * exportToGit, but strip .git at the end.
+ */
+async function writeFilesMode(bundle, outputPath) {
+    // Re-use exportToGit then strip .git. We need fresh tmp each time since
+    // exportToGit refuses to write into an existing path.
+    const stash = outputPath + ".prev";
+    const isUpdate = fs.existsSync(outputPath);
+    if (isUpdate) {
+        if (fs.existsSync(stash)) {
+            fs.rmSync(stash, { recursive: true, force: true });
+        }
+        fs.renameSync(outputPath, stash);
+    }
+    try {
+        await exportToGit(bundle, outputPath);
+        rmSync(path.join(outputPath, ".git"), { recursive: true, force: true });
+        // Preserve CHANGELOG.md from the previous tree (we'll append to it after).
+        if (isUpdate && fs.existsSync(path.join(stash, CHANGELOG_FILENAME))) {
+            fs.copyFileSync(path.join(stash, CHANGELOG_FILENAME), path.join(outputPath, CHANGELOG_FILENAME));
+        }
+        if (isUpdate && fs.existsSync(path.join(stash, STATE_FILENAME))) {
+            // State file gets rewritten by caller; nothing to preserve.
+        }
+        if (isUpdate) {
+            fs.rmSync(stash, { recursive: true, force: true });
+        }
+    }
+    catch (error) {
+        // Restore original on failure.
+        if (isUpdate) {
+            if (fs.existsSync(outputPath)) {
+                fs.rmSync(outputPath, { recursive: true, force: true });
+            }
+            if (fs.existsSync(stash)) {
+                fs.renameSync(stash, outputPath);
+            }
+        }
+        throw error;
+    }
+}
+function ensureGitignore(repoDir) {
+    const gitignorePath = path.join(repoDir, ".gitignore");
+    const line = STATE_FILENAME;
+    let contents = "";
+    if (fs.existsSync(gitignorePath)) {
+        contents = fs.readFileSync(gitignorePath, "utf-8");
+        if (contents.split(/\r?\n/).some((l) => l.trim() === line)) {
+            return;
+        }
+        if (!contents.endsWith("\n"))
+            contents += "\n";
+    }
+    contents += `${line}\n${STATE_FILENAME}.tmp\n`;
+    fs.writeFileSync(gitignorePath, contents, "utf-8");
+}
+function writeStateFile(dir, summary, conversation, artifacts, action) {
+    const nodeMap = buildMessageTree(conversation.chat_messages);
+    const leaves = findLeafMessages(nodeMap).map((m) => ({
+        uuid: m.uuid,
+        last_message_index: m.index,
+    }));
+    const state = {
+        schema_version: 1,
+        conversation_uuid: conversation.uuid,
+        conversation_name: conversation.name,
+        updated_at: summary.updated_at,
+        current_leaf_message_uuid: conversation.current_leaf_message_uuid ?? null,
+        leaves,
+        artifacts: artifacts.files_metadata.map((a) => ({
+            path: a.path,
+            size: a.size,
+            created_at: a.created_at,
+        })),
+        last_sync_at: new Date().toISOString(),
+        last_sync_action: action,
+    };
+    writeSyncState(dir, state);
+}
+//# sourceMappingURL=incremental.js.map

package/dist/sync/incremental.js.map

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

package/dist/sync/state.d.ts

@@ -0,0 +1,108 @@
+import { z } from "zod";
+export declare const STATE_FILENAME = ".claudesync-state.json";
+export declare const SyncStateLeafSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    last_message_index: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    uuid: string;
+    last_message_index: number;
+}, {
+    uuid: string;
+    last_message_index: number;
+}>;
+export declare const SyncStateArtifactSchema: z.ZodObject<{
+    path: z.ZodString;
+    size: z.ZodNumber;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    created_at: string;
+    size: number;
+}, {
+    path: string;
+    created_at: string;
+    size: number;
+}>;
+export declare const SyncStateSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    conversation_uuid: z.ZodString;
+    conversation_name: z.ZodString;
+    updated_at: z.ZodString;
+    current_leaf_message_uuid: z.ZodNullable<z.ZodString>;
+    leaves: z.ZodArray<z.ZodObject<{
+        uuid: z.ZodString;
+        last_message_index: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        uuid: string;
+        last_message_index: number;
+    }, {
+        uuid: string;
+        last_message_index: number;
+    }>, "many">;
+    artifacts: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        size: z.ZodNumber;
+        created_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        created_at: string;
+        size: number;
+    }, {
+        path: string;
+        created_at: string;
+        size: number;
+    }>, "many">;
+    last_sync_at: z.ZodString;
+    last_sync_action: z.ZodEnum<["full", "incremental", "skipped"]>;
+}, "strip", z.ZodTypeAny, {
+    updated_at: string;
+    current_leaf_message_uuid: string | null;
+    conversation_uuid: string;
+    schema_version: 1;
+    conversation_name: string;
+    leaves: {
+        uuid: string;
+        last_message_index: number;
+    }[];
+    artifacts: {
+        path: string;
+        created_at: string;
+        size: number;
+    }[];
+    last_sync_at: string;
+    last_sync_action: "full" | "incremental" | "skipped";
+}, {
+    updated_at: string;
+    current_leaf_message_uuid: string | null;
+    conversation_uuid: string;
+    schema_version: 1;
+    conversation_name: string;
+    leaves: {
+        uuid: string;
+        last_message_index: number;
+    }[];
+    artifacts: {
+        path: string;
+        created_at: string;
+        size: number;
+    }[];
+    last_sync_at: string;
+    last_sync_action: "full" | "incremental" | "skipped";
+}>;
+export type SyncState = z.infer<typeof SyncStateSchema>;
+export type SyncStateLeaf = z.infer<typeof SyncStateLeafSchema>;
+export type SyncStateArtifact = z.infer<typeof SyncStateArtifactSchema>;
+/**
+ * Reads the sync state file from a conversation directory.
+ * Returns undefined if the file does not exist (bootstrap case).
+ * Throws on parse failure (corrupted state should not silently fall back to
+ * full re-sync without the user noticing).
+ */
+export declare function readSyncState(dir: string): SyncState | undefined;
+/**
+ * Writes the sync state file atomically (write to .tmp, then rename).
+ * Survives interruption: if the process dies mid-write, the original file
+ * (if any) is left intact.
+ */
+export declare function writeSyncState(dir: string, state: SyncState): void;
+//# sourceMappingURL=state.d.ts.map

package/dist/sync/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/sync/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,cAAc,2BAA2B,CAAC;AAEvD,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAIlC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAQhE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAMlE"}

package/dist/sync/state.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import fs from "node:fs";
+import path from "node:path";
+export const STATE_FILENAME = ".claudesync-state.json";
+export const SyncStateLeafSchema = z.object({
+    uuid: z.string(),
+    last_message_index: z.number(),
+});
+export const SyncStateArtifactSchema = z.object({
+    path: z.string(),
+    size: z.number(),
+    created_at: z.string(),
+});
+export const SyncStateSchema = z.object({
+    schema_version: z.literal(1),
+    conversation_uuid: z.string(),
+    conversation_name: z.string(),
+    updated_at: z.string(),
+    current_leaf_message_uuid: z.string().nullable(),
+    leaves: z.array(SyncStateLeafSchema),
+    artifacts: z.array(SyncStateArtifactSchema),
+    last_sync_at: z.string(),
+    last_sync_action: z.enum(["full", "incremental", "skipped"]),
+});
+/**
+ * Reads the sync state file from a conversation directory.
+ * Returns undefined if the file does not exist (bootstrap case).
+ * Throws on parse failure (corrupted state should not silently fall back to
+ * full re-sync without the user noticing).
+ */
+export function readSyncState(dir) {
+    const filePath = path.join(dir, STATE_FILENAME);
+    if (!fs.existsSync(filePath)) {
+        return undefined;
+    }
+    const raw = fs.readFileSync(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    return SyncStateSchema.parse(parsed);
+}
+/**
+ * Writes the sync state file atomically (write to .tmp, then rename).
+ * Survives interruption: if the process dies mid-write, the original file
+ * (if any) is left intact.
+ */
+export function writeSyncState(dir, state) {
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = path.join(dir, STATE_FILENAME);
+    const tmpPath = filePath + ".tmp";
+    fs.writeFileSync(tmpPath, JSON.stringify(state, null, 2) + "\n", "utf-8");
+    fs.renameSync(tmpPath, filePath);
+}
+//# sourceMappingURL=state.js.map

package/dist/sync/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/sync/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,cAAc,GAAG,wBAAwB,CAAC;AAEvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC3C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;CAC7D,CAAC,CAAC;AAMH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,KAAgB;IAC1D,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1E,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC"}

package/dist/tree/__tests__/message-tree.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { buildMessageTree, findLeafMessages, getLinearBranch, } from "../message-tree.js";
+import { buildMessageTree, findLeafMessages, getLinearBranch, getAllBranches, findDivergencePoint, shortLeafLabel, } from "../message-tree.js";
 /**
  * Helper to create a minimal ChatMessage for testing.
  * Only uuid, parent_message_uuid, index, and sender are meaningful
@@ -173,4 +173,64 @@ describe("getLinearBranch", () => {
         expect(branch.map((m) => m.uuid)).toEqual(["root", "a1"]);
     });
 });
+describe("getAllBranches", () => {
+    it("returns one branch per leaf in a forked tree", () => {
+        const messages = [
+            makeMessage("root", "sentinel", 0, "human"),
+            makeMessage("a1", "root", 1, "assistant"),
+            makeMessage("h2-v1", "a1", 2, "human"),
+            makeMessage("h2-v2", "a1", 3, "human"),
+            makeMessage("a3-v2", "h2-v2", 4, "assistant"),
+        ];
+        const tree = buildMessageTree(messages);
+        const branches = getAllBranches(tree);
+        expect(branches.size).toBe(2);
+        expect(branches.has("h2-v1")).toBe(true);
+        expect(branches.has("a3-v2")).toBe(true);
+        expect(branches.get("h2-v1").map((m) => m.uuid)).toEqual([
+            "root",
+            "a1",
+            "h2-v1",
+        ]);
+        expect(branches.get("a3-v2").map((m) => m.uuid)).toEqual([
+            "root",
+            "a1",
+            "h2-v2",
+            "a3-v2",
+        ]);
+    });
+});
+describe("findDivergencePoint", () => {
+    it("finds the deepest shared ancestor between two branches", () => {
+        const messages = [
+            makeMessage("root", "sentinel", 0, "human"),
+            makeMessage("a1", "root", 1, "assistant"),
+            makeMessage("h2-v1", "a1", 2, "human"),
+            makeMessage("h2-v2", "a1", 3, "human"),
+            makeMessage("a3-v2", "h2-v2", 4, "assistant"),
+        ];
+        const tree = buildMessageTree(messages);
+        const v1 = getLinearBranch(tree, "h2-v1");
+        const v2 = getLinearBranch(tree, "a3-v2");
+        expect(findDivergencePoint(v1, v2)).toBe("a1");
+    });
+    it("returns undefined when branches share no ancestor", () => {
+        const m1 = makeMessage("a", "sentinel", 0);
+        const m2 = makeMessage("b", "sentinel", 1);
+        expect(findDivergencePoint([m1], [m2])).toBeUndefined();
+    });
+});
+describe("shortLeafLabel", () => {
+    it("returns 8-char prefix when unique", () => {
+        expect(shortLeafLabel("019ddeab-d142", ["019ddea7-ef2a"])).toBe("019ddeab");
+    });
+    it("falls back to 12 chars when 8 chars collide", () => {
+        expect(shortLeafLabel("019ddeab-d142-7b87-8a6a", [
+            "019ddeab-7716-7019-93f1",
+        ])).toBe("019ddeab-d14");
+    });
+    it("throws when no unique prefix exists within 16 chars", () => {
+        expect(() => shortLeafLabel("aaaa-bbbb-cccc-dddd", ["aaaa-bbbb-cccc-dddd-shared"])).toThrow();
+    });
+});
 //# sourceMappingURL=message-tree.test.js.map