@slorenzot/memento-core 2.0.0 → 2.0.1

package/dist/sync/sync-engine.d.ts

@@ -0,0 +1,58 @@
+import type { MemoryEngine } from '../MemoryEngine.js';
+import type { SyncConfig, SyncMeta, SyncResult, SyncStatusResponse } from './types.js';
+/**
+ * SyncEngine — orchestrates bidirectional sync between local DB and memento-web.
+ *
+ * Protocol: cursor-based, version-tracked, last-write-wins
+ *
+ * Flow:
+ * 1. Pull: fetch remote changes since cursor
+ * 2. Apply remote changes locally
+ * 3. Push: send local changes since last sync (scope=project only)
+ * 4. Save new cursor
+ */
+export declare class SyncEngine {
+    private config;
+    private metaPath;
+    private client;
+    private tokenStore;
+    private deviceFingerprint;
+    constructor(config: SyncConfig);
+    /**
+     * Full bidirectional sync.
+     */
+    sync(engine: MemoryEngine): Promise<SyncResult>;
+    /**
+     * Pull-only: download remote changes to local DB.
+     */
+    pull(engine: MemoryEngine): Promise<SyncResult>;
+    /**
+     * Push-only: upload local changes to server.
+     */
+    push(engine: MemoryEngine): Promise<SyncResult>;
+    /**
+     * Get sync status.
+     */
+    getStatus(engine: MemoryEngine): Promise<{
+        meta: SyncMeta | null;
+        remote?: SyncStatusResponse;
+        local: {
+            totalObservations: number;
+            activeObservations: number;
+        };
+        authenticated: boolean;
+    }>;
+    private doPull;
+    private doPush;
+    /**
+     * Apply a SyncMemento to the local DB.
+     */
+    private applyToLocal;
+    /**
+     * Convert a local Observation to a SyncMemento for the wire.
+     */
+    private observationToMemento;
+    loadMeta(): SyncMeta;
+    saveMeta(meta: SyncMeta): void;
+}
+//# sourceMappingURL=sync-engine.d.ts.map

package/dist/sync/sync-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../../src/sync/sync-engine.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EAEV,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAOpB;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,MAAM,EAAE,UAAU;IAgB9B;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAiCrD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IA0BrD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IA0BrD;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;QAC7C,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;QACtB,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,KAAK,EAAE;YAAE,iBAAiB,EAAE,MAAM,CAAC;YAAC,kBAAkB,EAAE,MAAM,CAAA;SAAE,CAAC;QACjE,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;YA6BY,MAAM;YAmCN,MAAM;IA2DpB;;OAEG;YACW,YAAY;IAiD1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsB5B,QAAQ,IAAI,QAAQ;IAsBpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;CAO/B"}

package/dist/sync/sync-engine.js

@@ -0,0 +1,370 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncEngine = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const crypto = __importStar(require("crypto"));
+const sync_client_js_1 = require("./sync-client.js");
+const token_store_js_1 = require("../auth/token-store.js");
+const DEFAULT_META_PATH = path.join(os.homedir(), '.memento', 'sync-meta.json');
+/**
+ * SyncEngine — orchestrates bidirectional sync between local DB and memento-web.
+ *
+ * Protocol: cursor-based, version-tracked, last-write-wins
+ *
+ * Flow:
+ * 1. Pull: fetch remote changes since cursor
+ * 2. Apply remote changes locally
+ * 3. Push: send local changes since last sync (scope=project only)
+ * 4. Save new cursor
+ */
+class SyncEngine {
+    config;
+    metaPath;
+    client;
+    tokenStore;
+    deviceFingerprint;
+    constructor(config) {
+        this.config = config;
+        this.metaPath = config.metaFilePath || DEFAULT_META_PATH;
+        this.tokenStore = new token_store_js_1.TokenStore();
+        this.deviceFingerprint = generateDeviceFingerprint();
+        this.client = new sync_client_js_1.SyncClient({
+            serverUrl: config.serverUrl,
+            getToken: () => {
+                const t = this.tokenStore.getToken();
+                return Promise.resolve(t?.accessToken ?? null);
+            },
+            fetchFunction: config.fetchFunction,
+        });
+    }
+    /**
+     * Full bidirectional sync.
+     */
+    async sync(engine) {
+        const start = Date.now();
+        const meta = this.loadMeta();
+        // Pull first
+        const pullResult = await this.doPull(engine, meta.lastCursor);
+        // Then push
+        const pushResult = await this.doPush(engine, meta.lastCursor);
+        // Save meta with new cursor
+        const newCursor = pullResult.newCursor || pushResult.newCursor || meta.lastCursor;
+        this.saveMeta({
+            lastSyncAt: Date.now(),
+            lastSyncDirection: 'bidirectional',
+            lastCursor: newCursor,
+            lastPullCount: pullResult.applied,
+            lastPushCount: pushResult.pushed,
+            lastConflictCount: pullResult.conflicts.length + pushResult.conflicts.length,
+            serverUrl: this.config.serverUrl,
+            updatedAt: Date.now(),
+        });
+        return {
+            direction: 'bidirectional',
+            pulled: pullResult.applied,
+            pushed: pushResult.pushed,
+            conflicts: [...pullResult.conflicts, ...pushResult.conflicts],
+            errors: [...pullResult.errors, ...pushResult.errors],
+            durationMs: Date.now() - start,
+        };
+    }
+    /**
+     * Pull-only: download remote changes to local DB.
+     */
+    async pull(engine) {
+        const start = Date.now();
+        const meta = this.loadMeta();
+        const result = await this.doPull(engine, meta.lastCursor);
+        this.saveMeta({
+            lastSyncAt: Date.now(),
+            lastSyncDirection: 'pull',
+            lastCursor: result.newCursor || meta.lastCursor,
+            lastPullCount: result.applied,
+            lastPushCount: 0,
+            lastConflictCount: result.conflicts.length,
+            serverUrl: this.config.serverUrl,
+            updatedAt: Date.now(),
+        });
+        return {
+            direction: 'pull',
+            pulled: result.applied,
+            pushed: 0,
+            conflicts: result.conflicts,
+            errors: result.errors,
+            durationMs: Date.now() - start,
+        };
+    }
+    /**
+     * Push-only: upload local changes to server.
+     */
+    async push(engine) {
+        const start = Date.now();
+        const meta = this.loadMeta();
+        const result = await this.doPush(engine, meta.lastCursor);
+        this.saveMeta({
+            lastSyncAt: Date.now(),
+            lastSyncDirection: 'push',
+            lastCursor: result.newCursor || meta.lastCursor,
+            lastPullCount: 0,
+            lastPushCount: result.pushed,
+            lastConflictCount: result.conflicts.length,
+            serverUrl: this.config.serverUrl,
+            updatedAt: Date.now(),
+        });
+        return {
+            direction: 'push',
+            pulled: 0,
+            pushed: result.pushed,
+            conflicts: result.conflicts,
+            errors: result.errors,
+            durationMs: Date.now() - start,
+        };
+    }
+    /**
+     * Get sync status.
+     */
+    async getStatus(engine) {
+        const meta = this.loadMeta();
+        const token = this.tokenStore.getToken();
+        const authenticated = !!token;
+        // Local stats
+        const localActive = (await engine.search({ projectId: this.config.projectId, limit: 0 })).total;
+        const localDeleted = (await engine.listDeleted({ limit: 0 })).total;
+        let remote;
+        if (authenticated) {
+            try {
+                remote = await this.client.status(this.config.projectId);
+            }
+            catch {
+                // Remote unreachable
+            }
+        }
+        return {
+            meta: meta.lastSyncAt ? meta : null,
+            remote,
+            local: { totalObservations: localActive + localDeleted, activeObservations: localActive },
+            authenticated,
+        };
+    }
+    // ── Internal ────────────────────────────────────────────────
+    async doPull(engine, cursor) {
+        const errors = [];
+        const conflicts = [];
+        let hasMore = true;
+        let totalApplied = 0;
+        let latestCursor = cursor;
+        // Paginated pull
+        while (hasMore) {
+            const response = await this.client.pull({
+                projectId: this.config.projectId,
+                cursor: latestCursor,
+                limit: 100,
+            });
+            for (const change of response.changes) {
+                try {
+                    await this.applyToLocal(engine, change);
+                    totalApplied++;
+                }
+                catch (err) {
+                    errors.push(`Failed to apply ${change.uuid}: ${err}`);
+                }
+            }
+            latestCursor = response.newCursor;
+            hasMore = response.hasMore;
+        }
+        return { applied: totalApplied, conflicts, errors, newCursor: latestCursor || '' };
+    }
+    async doPush(engine, cursor) {
+        // Get local observations with scope=project (personal stays local)
+        const active = await engine.search({
+            projectId: this.config.projectId,
+            limit: 100000,
+        });
+        const deleted = await engine.listDeleted({
+            projectId: this.config.projectId,
+            limit: 100000,
+        });
+        const all = [...active.observations, ...deleted.observations];
+        // All items (project + personal scope) get pushed
+        // Filter: only items modified since cursor
+        let itemsToSync = all;
+        if (cursor) {
+            const cursorDate = new Date(cursor);
+            itemsToSync = all.filter(obs => obs.updatedAt > cursorDate);
+        }
+        if (itemsToSync.length === 0) {
+            return { pushed: 0, conflicts: [], errors: [], newCursor: cursor || '' };
+        }
+        // Convert to SyncMemento wire format
+        const items = itemsToSync.map(obs => this.observationToMemento(obs));
+        const result = await this.client.push({
+            projectId: this.config.projectId,
+            cursor,
+            deviceFingerprint: this.deviceFingerprint,
+            clientVersion: '1.0.0',
+            items,
+        });
+        // Handle conflicts — apply server data for server_wins
+        for (const conflict of result.conflicts) {
+            if (conflict.resolution === 'server_wins' && conflict.serverData) {
+                try {
+                    await this.applyToLocal(engine, conflict.serverData);
+                }
+                catch (err) {
+                    // Best effort
+                }
+            }
+        }
+        return {
+            pushed: result.synced,
+            conflicts: result.conflicts,
+            errors: [],
+            newCursor: result.newCursor,
+        };
+    }
+    /**
+     * Apply a SyncMemento to the local DB.
+     */
+    async applyToLocal(engine, memento) {
+        const existing = engine.getObservationByUuid(memento.uuid);
+        if (existing) {
+            if (existing.readOnly)
+                return;
+            await engine.updateObservation(existing.id, {
+                title: memento.title,
+                content: memento.content,
+                type: memento.type,
+                topicKey: memento.topicKey,
+                metadata: memento.metadata,
+                pinned: memento.pinned,
+                readOnly: memento.readOnly,
+            });
+        }
+        else {
+            // Find or create session
+            const sessions = await engine.listSessions({
+                projectId: memento.projectId,
+                limit: 1,
+                activeOnly: false,
+            });
+            let sessionId;
+            if (sessions.sessions.length > 0) {
+                sessionId = sessions.sessions[0].id;
+            }
+            else {
+                const session = await engine.createSession({
+                    projectId: memento.projectId,
+                    endedAt: null,
+                    metadata: { source: 'sync', syncedAt: Date.now() },
+                });
+                sessionId = session.id;
+            }
+            await engine.createObservation({
+                sessionId,
+                title: memento.title,
+                content: memento.content,
+                type: memento.type,
+                topicKey: memento.topicKey,
+                projectId: memento.projectId,
+                scope: memento.scope,
+                pinned: memento.pinned,
+                readOnly: memento.readOnly,
+                metadata: { ...memento.metadata, syncedUuid: memento.uuid },
+            });
+        }
+    }
+    /**
+     * Convert a local Observation to a SyncMemento for the wire.
+     */
+    observationToMemento(obs) {
+        return {
+            uuid: obs.uuid,
+            title: obs.title,
+            content: obs.content,
+            type: obs.type,
+            topicKey: obs.topicKey,
+            scope: obs.scope,
+            pinned: obs.pinned,
+            readOnly: obs.readOnly,
+            revisionCount: obs.revisionCount,
+            projectId: obs.projectId,
+            metadata: obs.metadata,
+            localCreatedAt: obs.createdAt.toISOString(),
+            localUpdatedAt: obs.updatedAt.toISOString(),
+            version: obs.revisionCount + 1, // Version = revisionCount + 1 (first version is 1)
+            deletedAt: obs.deletedAt ? obs.deletedAt.toISOString() : null,
+        };
+    }
+    // ── Sync Meta Persistence ────────────────────────────────────
+    loadMeta() {
+        try {
+            if (fs.existsSync(this.metaPath)) {
+                const raw = fs.readFileSync(this.metaPath, 'utf-8');
+                return JSON.parse(raw);
+            }
+        }
+        catch {
+            // Corrupted — start fresh
+        }
+        return {
+            lastSyncAt: null,
+            lastSyncDirection: null,
+            lastCursor: null,
+            lastPullCount: 0,
+            lastPushCount: 0,
+            lastConflictCount: 0,
+            serverUrl: this.config.serverUrl,
+            updatedAt: Date.now(),
+        };
+    }
+    saveMeta(meta) {
+        const dir = path.dirname(this.metaPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(this.metaPath, JSON.stringify(meta, null, 2), 'utf-8');
+    }
+}
+exports.SyncEngine = SyncEngine;
+/** Generate a stable device fingerprint based on hostname + username */
+function generateDeviceFingerprint() {
+    const hostname = os.hostname();
+    const username = os.userInfo().username;
+    return crypto.createHash('sha256').update(`${hostname}:${username}`).digest('hex').slice(0, 16);
+}
+//# sourceMappingURL=sync-engine.js.map

package/dist/sync/sync-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.js","sourceRoot":"","sources":["../../src/sync/sync-engine.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AACzB,+CAAiC;AAUjC,qDAA8C;AAE9C,2DAAoD;AAEpD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,MAAa,UAAU;IACb,MAAM,CAAa;IACnB,QAAQ,CAAS;IACjB,MAAM,CAAa;IACnB,UAAU,CAAa;IACvB,iBAAiB,CAAS;IAElC,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,YAAY,IAAI,iBAAiB,CAAC;QACzD,IAAI,CAAC,UAAU,GAAG,IAAI,2BAAU,EAAE,CAAC;QACnC,IAAI,CAAC,iBAAiB,GAAG,yBAAyB,EAAE,CAAC;QAErD,IAAI,CAAC,MAAM,GAAG,IAAI,2BAAU,CAAC;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,GAAG,EAAE;gBACb,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;gBACrC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,WAAW,IAAI,IAAI,CAAC,CAAC;YACjD,CAAC;YACD,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAoB;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAE7B,aAAa;QACb,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAE9D,YAAY;QACZ,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAE9D,4BAA4B;QAC5B,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC;QAClF,IAAI,CAAC,QAAQ,CAAC;YACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,iBAAiB,EAAE,eAAe;YAClC,UAAU,EAAE,SAAS;YACrB,aAAa,EAAE,UAAU,CAAC,OAAO;YACjC,aAAa,EAAE,UAAU,CAAC,MAAM;YAChC,iBAAiB,EAAE,UAAU,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM;YAC5E,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QAEH,OAAO;YACL,SAAS,EAAE,eAAe;YAC1B,MAAM,EAAE,UAAU,CAAC,OAAO;YAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,SAAS,EAAE,CAAC,GAAG,UAAU,CAAC,SAAS,EAAE,GAAG,UAAU,CAAC,SAAS,CAAC;YAC7D,MAAM,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC;YACpD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAoB;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAE1D,IAAI,CAAC,QAAQ,CAAC;YACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,iBAAiB,EAAE,MAAM;YACzB,UAAU,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU;YAC/C,aAAa,EAAE,MAAM,CAAC,OAAO;YAC7B,aAAa,EAAE,CAAC;YAChB,iBAAiB,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;YAC1C,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QAEH,OAAO;YACL,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,MAAM,CAAC,OAAO;YACtB,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAoB;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAE1D,IAAI,CAAC,QAAQ,CAAC;YACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,iBAAiB,EAAE,MAAM;YACzB,UAAU,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU;YAC/C,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,MAAM,CAAC,MAAM;YAC5B,iBAAiB,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;YAC1C,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QAEH,OAAO;YACL,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,MAAoB;QAMlC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC;QAE9B,cAAc;QACd,MAAM,WAAW,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAChG,MAAM,YAAY,GAAG,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAEpE,IAAI,MAAsC,CAAC;QAE3C,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3D,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;YACnC,MAAM;YACN,KAAK,EAAE,EAAE,iBAAiB,EAAE,WAAW,GAAG,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE;YACzF,aAAa;SACd,CAAC;IACJ,CAAC;IAED,+DAA+D;IAEvD,KAAK,CAAC,MAAM,CAClB,MAAoB,EACpB,MAAqB;QAErB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAU,EAAE,CAAC;QAE5B,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,YAAY,GAAG,MAAM,CAAC;QAE1B,iBAAiB;QACjB,OAAO,OAAO,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACtC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;gBAChC,MAAM,EAAE,YAAY;gBACpB,KAAK,EAAE,GAAG;aACX,CAAC,CAAC;YAEH,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtC,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBACxC,YAAY,EAAE,CAAC;gBACjB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;gBACxD,CAAC;YACH,CAAC;YAED,YAAY,GAAG,QAAQ,CAAC,SAAS,CAAC;YAClC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC7B,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,IAAI,EAAE,EAAE,CAAC;IACrF,CAAC;IAEO,KAAK,CAAC,MAAM,CAClB,MAAoB,EACpB,MAAqB;QAErB,mEAAmE;QACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YACjC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;YACvC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAE9D,kDAAkD;QAClD,2CAA2C;QAC3C,IAAI,WAAW,GAAG,GAAG,CAAC;QACtB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QAC3E,CAAC;QAED,qCAAqC;QACrC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC;QAErE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACpC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,MAAM;YACN,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,aAAa,EAAE,OAAO;YACtB,KAAK;SACN,CAAC,CAAC;QAEH,uDAAuD;QACvD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACxC,IAAI,QAAQ,CAAC,UAAU,KAAK,aAAa,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACjE,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACvD,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,cAAc;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,EAAE;YACV,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CAAC,MAAoB,EAAE,OAAoB;QACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE3D,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,QAAQ,CAAC,QAAQ;gBAAE,OAAO;YAC9B,MAAM,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,EAAE;gBAC1C,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAA2B;gBACzC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,yBAAyB;YACzB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;gBACzC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,KAAK,EAAE,CAAC;gBACR,UAAU,EAAE,KAAK;aAClB,CAAC,CAAC;YAEH,IAAI,SAAiB,CAAC;YACtB,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;oBACzC,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,OAAO,EAAE,IAAI;oBACb,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE;iBACnD,CAAC,CAAC;gBACH,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC;YACzB,CAAC;YAED,MAAM,MAAM,CAAC,iBAAiB,CAAC;gBAC7B,SAAS;gBACT,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAA2B;gBACzC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE;aAC5D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,GAAgB;QAC3C,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,cAAc,EAAE,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE;YAC3C,cAAc,EAAE,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE;YAC3C,OAAO,EAAE,GAAG,CAAC,aAAa,GAAG,CAAC,EAAE,mDAAmD;YACnF,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;SAC9D,CAAC;IACJ,CAAC;IAED,gEAAgE;IAEhE,QAAQ;QACN,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACpD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;QAED,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,iBAAiB,EAAE,IAAI;YACvB,UAAU,EAAE,IAAI;YAChB,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,CAAC;YAChB,iBAAiB,EAAE,CAAC;YACpB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,IAAc;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;CACF;AAlWD,gCAkWC;AAED,wEAAwE;AACxE,SAAS,yBAAyB;IAChC,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACxC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClG,CAAC"}

package/dist/sync/types.d.ts

@@ -0,0 +1,107 @@
+/** Sync direction */
+export type SyncDirection = 'pull' | 'push' | 'bidirectional';
+/**
+ * A memento item as transferred over the wire.
+ * Matches memento-web SyncMemento exactly.
+ */
+export interface SyncMemento {
+    uuid: string;
+    title: string;
+    content: string;
+    type: string;
+    topicKey: string | null;
+    scope: 'project' | 'personal';
+    pinned: boolean;
+    readOnly: boolean;
+    revisionCount: number;
+    projectId: string;
+    metadata: Record<string, unknown>;
+    localCreatedAt: string;
+    localUpdatedAt: string;
+    version: number;
+    deletedAt: string | null;
+}
+/** Push request body — matches memento-web SyncPushRequest */
+export interface SyncPushRequest {
+    projectId: string;
+    cursor: string | null;
+    deviceFingerprint?: string;
+    clientVersion?: string;
+    items: SyncMemento[];
+}
+/** Push response from memento-web */
+export interface SyncPushResponse {
+    synced: number;
+    created: number;
+    updated: number;
+    conflicts: SyncConflict[];
+    newCursor: string;
+}
+/** Pull response from memento-web */
+export interface SyncPullResponse {
+    changes: SyncMemento[];
+    hasMore: boolean;
+    totalChanges: number;
+    newCursor: string;
+}
+/** Pull query params */
+export interface SyncPullParams {
+    projectId: string;
+    cursor: string | null;
+    limit?: number;
+}
+/** Conflict during push */
+export interface SyncConflict {
+    uuid: string;
+    localVersion: number;
+    serverVersion: number;
+    resolution: 'client_wins' | 'server_wins';
+    serverData?: SyncMemento;
+}
+/** Status response from memento-web */
+export interface SyncStatusResponse {
+    projectId: string;
+    lastSyncAt: string | null;
+    totalMementos: number;
+    pendingChanges: number | null;
+    conflicts: number;
+    device: {
+        fingerprint: string;
+        lastSyncAt: string | null;
+    } | null;
+}
+/** Sync metadata persisted locally */
+export interface SyncMeta {
+    lastSyncAt: number | null;
+    lastSyncDirection: SyncDirection | null;
+    lastCursor: string | null;
+    lastPullCount: number;
+    lastPushCount: number;
+    lastConflictCount: number;
+    serverUrl: string;
+    updatedAt: number;
+}
+/** Result of a sync operation */
+export interface SyncResult {
+    direction: SyncDirection;
+    pulled: number;
+    pushed: number;
+    conflicts: SyncConflict[];
+    errors: string[];
+    durationMs: number;
+}
+/** Configuration for the sync engine */
+export interface SyncConfig {
+    serverUrl: string;
+    projectId: string;
+    fetchFunction?: typeof fetch;
+    metaFilePath?: string;
+}
+/** HTTP error from sync API */
+export declare class SyncApiError extends Error {
+    status: number;
+    code?: string | undefined;
+    body?: string | undefined;
+    constructor(message: string, status: number, code?: string | undefined, body?: string | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/sync/types.js

@@ -0,0 +1,20 @@
+"use strict";
+// ─── Sync Types — Memento v1 Protocol ──────────────────────────
+// Matches memento-web/src/types/sync.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncApiError = void 0;
+/** HTTP error from sync API */
+class SyncApiError extends Error {
+    status;
+    code;
+    body;
+    constructor(message, status, code, body) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.body = body;
+        this.name = 'SyncApiError';
+    }
+}
+exports.SyncApiError = SyncApiError;
+//# sourceMappingURL=types.js.map

package/dist/sync/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":";AAAA,kEAAkE;AAClE,wCAAwC;;;AAgHxC,+BAA+B;AAC/B,MAAa,YAAa,SAAQ,KAAK;IAG5B;IACA;IACA;IAJT,YACE,OAAe,EACR,MAAc,EACd,IAAa,EACb,IAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAS;QACb,SAAI,GAAJ,IAAI,CAAS;QAGpB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAVD,oCAUC"}

package/dist/token-savings.d.ts

@@ -0,0 +1,42 @@
+import type { Observation } from './types';
+/**
+ * Estimate the number of tokens in a string.
+ * Uses simple chars/4 ratio — no tokenizer dependency needed.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Get the multiplier for an observation type.
+ */
+export declare function getTypeMultiplier(type: Observation['type']): number;
+/**
+ * Estimate token savings for a single observation.
+ * Formula: content_tokens × type_multiplier
+ */
+export declare function estimateSavingsForObservation(obs: {
+    content: string;
+    type: Observation['type'];
+}): number;
+/**
+ * Estimate total token savings for a list of observations.
+ * Returns raw savings without multiplier (contentTokens) and total with multiplier.
+ */
+export declare function estimateTotalSavings(observations: Array<{
+    content: string;
+    type: Observation['type'];
+}>): {
+    /** Sum of raw content tokens across all observations */
+    contentTokens: number;
+    /** Sum of (content_tokens × type_multiplier) across all observations */
+    estimatedTokensSaved: number;
+    /** Number of observations used in the calculation */
+    observationCount: number;
+};
+/**
+ * Format token savings as a human-readable string for MCP responses.
+ */
+export declare function formatTokenSavings(savings: {
+    estimatedTokensSaved: number;
+    observationCount: number;
+    contentTokens: number;
+}): string;
+//# sourceMappingURL=token-savings.d.ts.map

package/dist/token-savings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-savings.d.ts","sourceRoot":"","sources":["../src/token-savings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAsC3C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAEnE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,MAAM,CAIzG;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,GAAG;IACzG,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAgBA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAsBT"}