@vkenliu/adit-cloud 0.2.0

package/dist/sync/engine.js

@@ -0,0 +1,152 @@
+/**
+ * Sync engine — orchestrates cursor-based incremental push.
+ *
+ * Protocol:
+ * 1. GET /api/sync/status → retrieve server's cursor
+ * 2. Build batch of local records after cursor
+ * 3. POST /api/sync/push → push batch
+ * 4. Update local cursor from response
+ * 5. Repeat until no more records
+ */
+import { getSyncState, upsertSyncState, withPerf } from "@vkenliu/adit-core";
+import { buildSyncBatch, batchRecordCount, countUnsyncedRecords } from "./serializer.js";
+import { handleConflicts } from "./conflicts.js";
+export class SyncEngine {
+    db;
+    client;
+    projectId;
+    batchSize;
+    serverUrl;
+    cloudClientId;
+    dataDir;
+    constructor(db, client, config) {
+        this.db = db;
+        this.client = client;
+        this.projectId = config.projectId;
+        this.batchSize = config.batchSize;
+        this.serverUrl = config.serverUrl;
+        this.cloudClientId = config.cloudClientId;
+        this.dataDir = config.dataDir ?? null;
+    }
+    /**
+     * Full incremental sync: push all unsynced records in batches.
+     *
+     * Fetches the server's cursor, then pushes batches until all
+     * local records have been synced.
+     */
+    async sync() {
+        const doSync = async () => {
+            // 1. Get server's current cursor
+            const serverStatus = await this.getRemoteStatus();
+            // 2. Extract per-project cursor (preferred) or fall back to global cursor.
+            //    The server returns projectCursors[projectId] with the watermark
+            //    for this specific project. If the server hasn't seen any events
+            //    for this project yet, the entry will be absent — meaning send all.
+            let cursor;
+            let lastSyncedAt;
+            let syncVersion = serverStatus.syncVersion;
+            const projectEntry = serverStatus.projectCursors?.[this.projectId];
+            if (projectEntry !== undefined) {
+                // Server has a per-project cursor — use it directly.
+                cursor = projectEntry.lastSyncedEventId;
+                lastSyncedAt = projectEntry.lastSyncedAt;
+                if (process.env.ADIT_DEBUG) {
+                    process.stderr.write(`[adit-cloud] sync: using per-project cursor for ${this.projectId}: ${cursor ?? "null"}\n`);
+                }
+            }
+            else if (serverStatus.projectCursors !== undefined) {
+                // Server supports per-project cursors but has no entry for this
+                // project — it has never seen events for it. Send everything.
+                cursor = null;
+                lastSyncedAt = null;
+                if (process.env.ADIT_DEBUG) {
+                    process.stderr.write(`[adit-cloud] sync: no per-project cursor for ${this.projectId} — full push\n`);
+                }
+            }
+            else {
+                // Legacy server without projectCursors — fall back to global cursor
+                // with the cursor-ahead guard for safety.
+                cursor = serverStatus.lastSyncedEventId;
+                lastSyncedAt = serverStatus.lastSyncedAt;
+                if (cursor) {
+                    const unsyncedWithCursor = countUnsyncedRecords(this.db, cursor, lastSyncedAt, this.projectId);
+                    const totalLocal = countUnsyncedRecords(this.db, null, null, this.projectId);
+                    if (unsyncedWithCursor === 0 && totalLocal > 0) {
+                        if (process.env.ADIT_DEBUG) {
+                            process.stderr.write(`[adit-cloud] sync: legacy global cursor ${cursor} is ahead of all ${totalLocal} local records — resetting to full push\n`);
+                        }
+                        cursor = null;
+                    }
+                }
+            }
+            const result = {
+                accepted: 0,
+                duplicates: 0,
+                conflicts: [],
+                newSyncCursor: cursor,
+                batches: 0,
+                totalRecords: 0,
+            };
+            // 3. Push batches until no more records
+            while (true) {
+                const batch = buildSyncBatch(this.db, cursor, lastSyncedAt, this.projectId, this.cloudClientId, this.batchSize);
+                const count = batchRecordCount(batch);
+                if (count === 0)
+                    break; // All synced
+                const response = await this.client.post("/api/sync/push", {
+                    clientId: this.cloudClientId,
+                    syncVersion,
+                    batch,
+                });
+                result.accepted += response.accepted;
+                result.duplicates += response.duplicates;
+                result.conflicts.push(...response.conflicts);
+                result.batches++;
+                result.totalRecords += count;
+                // Handle conflicts
+                if (response.conflicts.length > 0) {
+                    handleConflicts(response.conflicts);
+                }
+                // Update cursor
+                const prevCursor = cursor;
+                cursor = response.newSyncCursor;
+                syncVersion = response.newSyncVersion;
+                result.newSyncCursor = cursor;
+                // Guard against infinite loop: if all records were duplicates and
+                // the cursor didn't advance, the same batch would repeat forever.
+                if (response.accepted === 0 && cursor === prevCursor) {
+                    if (process.env.ADIT_DEBUG) {
+                        process.stderr.write(`[adit-cloud] sync: all ${count} records were duplicates and cursor unchanged — stopping\n`);
+                    }
+                    break;
+                }
+                // Persist progress after each batch (crash-safe)
+                upsertSyncState(this.db, {
+                    serverUrl: this.serverUrl,
+                    clientId: this.cloudClientId,
+                    lastSyncedEventId: cursor,
+                    lastSyncedAt: new Date().toISOString(),
+                    syncVersion,
+                });
+                // If batch was smaller than limit, we're done
+                if (count < this.batchSize)
+                    break;
+            }
+            return result;
+        };
+        if (this.dataDir) {
+            return withPerf(this.dataDir, "network", "cloud-sync", doSync);
+        }
+        return doSync();
+    }
+    /** Get sync status from server, scoped to this project. */
+    async getRemoteStatus() {
+        const params = new URLSearchParams({ projectId: this.projectId });
+        return this.client.get(`/api/sync/status?${params.toString()}`);
+    }
+    /** Get local sync state */
+    getLocalStatus() {
+        return getSyncState(this.db, this.serverUrl);
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/sync/engine.js.map

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

package/dist/sync/serializer.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Data serializer — builds sync batches from local SQLite data.
+ *
+ * Queries local tables for records not yet synced (after the cursor),
+ * converts them to the server's expected format, and respects the
+ * batch size limit (max 500 records per push).
+ */
+import type Database from "better-sqlite3";
+/**
+ * Server-facing record types.
+ * These use snake_case field names matching the adit-cloud PostgreSQL schema.
+ */
+export interface SyncSession {
+    id: string;
+    project_id: string;
+    client_id: string;
+    session_type: string;
+    platform: string;
+    started_at: string;
+    ended_at: string | null;
+    status: string;
+    metadata_json: string | null;
+    vclock_json: string | null;
+    deleted_at: string | null;
+}
+export interface SyncEvent {
+    id: string;
+    session_id: string;
+    client_id: string;
+    parent_event_id: string | null;
+    sequence: number;
+    event_type: string;
+    actor: string;
+    status: string;
+    prompt_text: string | null;
+    cot_text: string | null;
+    response_text: string | null;
+    tool_name: string | null;
+    tool_input_json: string | null;
+    tool_output_json: string | null;
+    checkpoint_sha: string | null;
+    checkpoint_ref: string | null;
+    diff_stat_json: string | null;
+    git_branch: string | null;
+    git_head_sha: string | null;
+    env_snapshot_id: string | null;
+    started_at: string;
+    ended_at: string | null;
+    error_json: string | null;
+    labels_json: string | null;
+    plan_task_id: string | null;
+    vclock_json: string | null;
+    deleted_at: string | null;
+}
+export interface SyncEnvSnapshot {
+    id: string;
+    session_id: string;
+    client_id: string;
+    git_branch: string | null;
+    git_head_sha: string | null;
+    modified_files: string | null;
+    lockfile_hash: string | null;
+    lockfile_path: string | null;
+    env_vars: string | null;
+    node_version: string | null;
+    python_version: string | null;
+    os_info: string | null;
+    container_info: string | null;
+    runtime_versions: string | null;
+    shell_info: string | null;
+    system_resources: string | null;
+    package_manager: string | null;
+    captured_at: string;
+    vclock_json: string | null;
+    deleted_at: string | null;
+}
+export interface SyncPlan {
+    id: string;
+    project_id: string;
+    client_id: string;
+    plan_type: string;
+    parent_plan_id: string | null;
+    title: string;
+    content_md: string;
+    status: string;
+    created_at: string;
+    updated_at: string | null;
+    vclock_json: string | null;
+    deleted_at: string | null;
+}
+export interface SyncDiff {
+    id: string;
+    event_id: string;
+    client_id: string;
+    diff_text: string;
+    file_filter: string | null;
+    created_at: string;
+}
+export interface SyncBatch {
+    sessions: SyncSession[];
+    events: SyncEvent[];
+    envSnapshots: SyncEnvSnapshot[];
+    plans: SyncPlan[];
+    diffs: SyncDiff[];
+}
+/**
+ * Build a sync batch of records after the given cursor.
+ *
+ * For append-only records (events, env_snapshots, diffs), only selects
+ * new records with id > cursor.
+ *
+ * For mutable records (sessions, plans), also includes records modified
+ * since lastSyncedAt so updates are captured.
+ *
+ * Priority ordering: sessions first (parents), then events, env_snapshots,
+ * plans, diffs — maintaining referential integrity on the server.
+ */
+export declare function buildSyncBatch(db: Database.Database, afterEventId: string | null, lastSyncedAt: string | null, projectId: string, cloudClientId: string, batchSize: number): SyncBatch;
+/** Count total unsynced records across all tables */
+export declare function countUnsyncedRecords(db: Database.Database, afterEventId: string | null, lastSyncedAt: string | null, projectId: string): number;
+/** Get total record count in a batch */
+export declare function batchRecordCount(batch: SyncBatch): number;
+//# sourceMappingURL=serializer.d.ts.map

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

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

package/dist/sync/serializer.js

@@ -0,0 +1,280 @@
+/**
+ * Data serializer — builds sync batches from local SQLite data.
+ *
+ * Queries local tables for records not yet synced (after the cursor),
+ * converts them to the server's expected format, and respects the
+ * batch size limit (max 500 records per push).
+ */
+/**
+ * Build a sync batch of records after the given cursor.
+ *
+ * For append-only records (events, env_snapshots, diffs), only selects
+ * new records with id > cursor.
+ *
+ * For mutable records (sessions, plans), also includes records modified
+ * since lastSyncedAt so updates are captured.
+ *
+ * Priority ordering: sessions first (parents), then events, env_snapshots,
+ * plans, diffs — maintaining referential integrity on the server.
+ */
+export function buildSyncBatch(db, afterEventId, lastSyncedAt, projectId, cloudClientId, batchSize) {
+    const batch = {
+        sessions: [],
+        events: [],
+        envSnapshots: [],
+        plans: [],
+        diffs: [],
+    };
+    let remaining = batchSize;
+    // 1. Sessions — new or modified since last sync
+    if (remaining > 0) {
+        batch.sessions = querySessions(db, afterEventId, lastSyncedAt, projectId, cloudClientId, remaining);
+        remaining -= batch.sessions.length;
+    }
+    // 2. Events — append-only, only new records
+    if (remaining > 0) {
+        batch.events = queryEvents(db, afterEventId, projectId, cloudClientId, remaining);
+        remaining -= batch.events.length;
+    }
+    // 3. Env snapshots — append-only, filtered by project
+    if (remaining > 0) {
+        batch.envSnapshots = queryEnvSnapshots(db, afterEventId, projectId, cloudClientId, remaining);
+        remaining -= batch.envSnapshots.length;
+    }
+    // 4. Plans — mutable, include modified
+    if (remaining > 0) {
+        batch.plans = queryPlans(db, afterEventId, lastSyncedAt, projectId, cloudClientId, remaining);
+        remaining -= batch.plans.length;
+    }
+    // 5. Diffs — keyed by event_id, only for events in this batch
+    if (batch.events.length > 0 && remaining > 0) {
+        const eventIds = batch.events.map((e) => e.id);
+        batch.diffs = queryDiffs(db, eventIds, cloudClientId, remaining);
+    }
+    return batch;
+}
+/** Count total unsynced records across all tables */
+export function countUnsyncedRecords(db, afterEventId, lastSyncedAt, projectId) {
+    let total = 0;
+    // Events
+    if (afterEventId) {
+        const eventRow = db
+            .prepare(`SELECT COUNT(*) as cnt FROM events e
+         JOIN sessions s ON e.session_id = s.id
+         WHERE e.id > ? AND s.project_id = ?`)
+            .get(afterEventId, projectId);
+        total += eventRow.cnt;
+    }
+    else {
+        const eventRow = db
+            .prepare(`SELECT COUNT(*) as cnt FROM events e
+         JOIN sessions s ON e.session_id = s.id
+         WHERE s.project_id = ?`)
+            .get(projectId);
+        total += eventRow.cnt;
+    }
+    // Sessions (new or modified)
+    if (afterEventId) {
+        const params = [projectId];
+        let sql = `SELECT COUNT(*) as cnt FROM sessions WHERE project_id = ? AND (id > ?`;
+        params.push(afterEventId);
+        if (lastSyncedAt) {
+            sql += ` OR ended_at > ?`;
+            params.push(lastSyncedAt);
+        }
+        sql += `)`;
+        const row = db.prepare(sql).get(...params);
+        total += row.cnt;
+    }
+    else {
+        const row = db
+            .prepare(`SELECT COUNT(*) as cnt FROM sessions WHERE project_id = ?`)
+            .get(projectId);
+        total += row.cnt;
+    }
+    return total;
+}
+/** Get total record count in a batch */
+export function batchRecordCount(batch) {
+    return (batch.sessions.length +
+        batch.events.length +
+        batch.envSnapshots.length +
+        batch.plans.length +
+        batch.diffs.length);
+}
+// --- Internal query helpers ---
+function querySessions(db, afterId, lastSyncedAt, projectId, cloudClientId, limit) {
+    let sql;
+    const params = [];
+    if (afterId) {
+        const conditions = ["project_id = ?", "(id > ?"];
+        params.push(projectId, afterId);
+        if (lastSyncedAt) {
+            conditions[1] += " OR ended_at > ?";
+            params.push(lastSyncedAt);
+        }
+        conditions[1] += ")";
+        sql = `SELECT * FROM sessions WHERE ${conditions.join(" AND ")} ORDER BY id ASC LIMIT ?`;
+    }
+    else {
+        sql = `SELECT * FROM sessions WHERE project_id = ? ORDER BY id ASC LIMIT ?`;
+        params.push(projectId);
+    }
+    params.push(limit);
+    const rows = db.prepare(sql).all(...params);
+    return rows.map((r) => ({
+        id: r.id,
+        project_id: r.project_id,
+        client_id: cloudClientId,
+        session_type: r.session_type,
+        platform: r.platform,
+        started_at: r.started_at,
+        ended_at: r.ended_at ?? null,
+        status: r.status,
+        metadata_json: r.metadata_json ?? null,
+        vclock_json: r.vclock_json ?? null,
+        deleted_at: r.deleted_at ?? null,
+    }));
+}
+function queryEvents(db, afterId, projectId, cloudClientId, limit) {
+    let sql;
+    const params = [];
+    if (afterId) {
+        sql = `SELECT e.* FROM events e
+           JOIN sessions s ON e.session_id = s.id
+           WHERE e.id > ? AND s.project_id = ?
+           ORDER BY e.id ASC LIMIT ?`;
+        params.push(afterId, projectId, limit);
+    }
+    else {
+        sql = `SELECT e.* FROM events e
+           JOIN sessions s ON e.session_id = s.id
+           WHERE s.project_id = ?
+           ORDER BY e.id ASC LIMIT ?`;
+        params.push(projectId, limit);
+    }
+    const rows = db.prepare(sql).all(...params);
+    return rows.map((r) => ({
+        id: r.id,
+        session_id: r.session_id,
+        client_id: cloudClientId,
+        parent_event_id: r.parent_event_id ?? null,
+        sequence: r.sequence,
+        event_type: r.event_type,
+        actor: r.actor,
+        status: r.status,
+        prompt_text: r.prompt_text ?? null,
+        cot_text: r.cot_text ?? null,
+        response_text: r.response_text ?? null,
+        tool_name: r.tool_name ?? null,
+        tool_input_json: r.tool_input_json ?? null,
+        tool_output_json: r.tool_output_json ?? null,
+        checkpoint_sha: r.checkpoint_sha ?? null,
+        checkpoint_ref: r.checkpoint_ref ?? null,
+        diff_stat_json: r.diff_stat_json ?? null,
+        git_branch: r.git_branch ?? null,
+        git_head_sha: r.git_head_sha ?? null,
+        env_snapshot_id: r.env_snapshot_id ?? null,
+        started_at: r.started_at,
+        ended_at: r.ended_at ?? null,
+        error_json: r.error_json ?? null,
+        labels_json: r.labels_json ?? null,
+        plan_task_id: r.plan_task_id ?? null,
+        vclock_json: r.vclock_json ?? null,
+        deleted_at: r.deleted_at ?? null,
+    }));
+}
+function queryEnvSnapshots(db, afterId, projectId, cloudClientId, limit) {
+    let sql;
+    const params = [];
+    // Join on sessions to filter by project_id (prevents cross-project leaks)
+    if (afterId) {
+        sql = `SELECT es.* FROM env_snapshots es
+           JOIN sessions s ON es.session_id = s.id
+           WHERE es.id > ? AND s.project_id = ?
+           ORDER BY es.id ASC LIMIT ?`;
+        params.push(afterId, projectId, limit);
+    }
+    else {
+        sql = `SELECT es.* FROM env_snapshots es
+           JOIN sessions s ON es.session_id = s.id
+           WHERE s.project_id = ?
+           ORDER BY es.id ASC LIMIT ?`;
+        params.push(projectId, limit);
+    }
+    const rows = db.prepare(sql).all(...params);
+    return rows.map((r) => ({
+        id: r.id,
+        session_id: r.session_id,
+        client_id: cloudClientId,
+        git_branch: r.git_branch ?? null,
+        git_head_sha: r.git_head_sha ?? null,
+        modified_files: r.modified_files ?? null,
+        lockfile_hash: r.dep_lock_hash ?? null,
+        lockfile_path: r.dep_lock_path ?? null,
+        env_vars: r.env_vars_json ?? null,
+        node_version: r.node_version ?? null,
+        python_version: r.python_version ?? null,
+        os_info: r.os_info ?? null,
+        container_info: r.container_info ?? null,
+        runtime_versions: r.runtime_versions_json ?? null,
+        shell_info: r.shell_info ?? null,
+        system_resources: r.system_resources_json ?? null,
+        package_manager: r.package_manager_json ?? null,
+        captured_at: r.captured_at,
+        vclock_json: r.vclock_json ?? null,
+        deleted_at: r.deleted_at ?? null,
+    }));
+}
+function queryPlans(db, afterId, lastSyncedAt, projectId, cloudClientId, limit) {
+    let sql;
+    const params = [];
+    if (afterId) {
+        const conditions = ["project_id = ?", "(id > ?"];
+        params.push(projectId, afterId);
+        if (lastSyncedAt) {
+            conditions[1] += " OR updated_at > ?";
+            params.push(lastSyncedAt);
+        }
+        conditions[1] += ")";
+        sql = `SELECT * FROM plans WHERE ${conditions.join(" AND ")} ORDER BY id ASC LIMIT ?`;
+    }
+    else {
+        sql = `SELECT * FROM plans WHERE project_id = ? ORDER BY id ASC LIMIT ?`;
+        params.push(projectId);
+    }
+    params.push(limit);
+    const rows = db.prepare(sql).all(...params);
+    return rows.map((r) => ({
+        id: r.id,
+        project_id: r.project_id,
+        client_id: cloudClientId,
+        plan_type: r.plan_type,
+        parent_plan_id: r.parent_plan_id ?? null,
+        title: r.title,
+        content_md: r.content_md,
+        status: r.status,
+        created_at: r.created_at,
+        updated_at: r.updated_at ?? null,
+        vclock_json: r.vclock_json ?? null,
+        deleted_at: r.deleted_at ?? null,
+    }));
+}
+function queryDiffs(db, eventIds, cloudClientId, limit) {
+    if (eventIds.length === 0)
+        return [];
+    const placeholders = eventIds.map(() => "?").join(",");
+    const sql = `SELECT * FROM diffs WHERE event_id IN (${placeholders}) LIMIT ?`;
+    const rows = db
+        .prepare(sql)
+        .all(...eventIds, limit);
+    return rows.map((r) => ({
+        id: r.id,
+        event_id: r.event_id,
+        client_id: cloudClientId,
+        diff_text: r.diff_text,
+        file_filter: r.file_filter ?? null,
+        created_at: r.created_at,
+    }));
+}
+//# sourceMappingURL=serializer.js.map

package/dist/sync/serializer.js.map

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

package/dist/transcript/auto-upload.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Auto-upload trigger — fire-and-forget transcript upload after hook events.
+ *
+ * Called from the hooks system via dynamic import. Fully fail-open:
+ * any error is swallowed so it never blocks the AI agent.
+ *
+ * Designed to be called on every hook event. Internally deduplicates
+ * by checking if there's actually new data to upload before doing work.
+ */
+import type Database from "better-sqlite3";
+import type { SyncUploadType } from "./uploader.js";
+/**
+ * Register a transcript and trigger pending uploads.
+ *
+ * Call this from hook handlers whenever a transcript_path is seen.
+ * The function is idempotent — calling it multiple times with the
+ * same path is safe and cheap.
+ *
+ * @param db - Open database connection
+ * @param sessionId - Current session ID
+ * @param transcriptPath - Absolute path to the transcript JSONL file
+ * @param type - Upload type (default: "transcript")
+ */
+export declare function triggerTranscriptUpload(db: Database.Database, sessionId: string, transcriptPath: string, type?: SyncUploadType): Promise<void>;
+//# sourceMappingURL=auto-upload.d.ts.map

package/dist/transcript/auto-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-upload.d.ts","sourceRoot":"","sources":["../../src/transcript/auto-upload.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAM3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE,cAA6B,GAClC,OAAO,CAAC,IAAI,CAAC,CAiDf"}