@savestate/cli 0.2.0 → 0.3.0

package/dist/incremental.js

@@ -0,0 +1,289 @@
+/**
+ * SaveState Incremental Snapshots
+ *
+ * Instead of storing a full copy every time, incremental snapshots
+ * only capture what changed since the parent snapshot.
+ *
+ * How it works:
+ * 1. Hash every file in the current snapshot (SHA-256)
+ * 2. Load the parent snapshot's content hashes
+ * 3. Compare: identify added, modified, removed files
+ * 4. Store only the delta (changed + added files)
+ * 5. On restore: reconstruct by applying deltas from base → current
+ *
+ * The delta manifest tracks the relationship:
+ * ```
+ * base (full) → delta-1 → delta-2 → delta-3 (current)
+ * ```
+ *
+ * Every Nth snapshot (configurable, default 10) forces a full snapshot
+ * to keep the chain short and restore fast.
+ */
+import { createHash } from 'node:crypto';
+import { unpackFromArchive } from './format.js';
+import { decrypt } from './encryption.js';
+import { findEntry } from './index-file.js';
+// ─── Configuration ───────────────────────────────────────────
+/** Max chain depth before forcing a full snapshot */
+export const MAX_CHAIN_DEPTH = 10;
+/** If more than this fraction of files changed, just do a full snapshot */
+export const FULL_SNAPSHOT_THRESHOLD = 0.7;
+// ─── Content Hashing ─────────────────────────────────────────
+/**
+ * Compute SHA-256 hashes for every file in a packed snapshot.
+ */
+export function computeContentHashes(files) {
+    const hashes = {};
+    for (const [path, data] of files) {
+        hashes[path] = createHash('sha256').update(data).digest('hex');
+    }
+    // Root hash = hash of all sorted path:hash pairs
+    const sortedPairs = Object.entries(hashes)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([p, h]) => `${p}:${h}`)
+        .join('\n');
+    const rootHash = createHash('sha256').update(sortedPairs).digest('hex');
+    return {
+        files: hashes,
+        count: Object.keys(hashes).length,
+        rootHash,
+    };
+}
+// ─── Delta Computation ───────────────────────────────────────
+/**
+ * Compute the delta between the current snapshot files and a parent's content hashes.
+ *
+ * @param currentFiles - The full file map of the current snapshot
+ * @param parentHashes - Content hashes from the parent snapshot
+ * @param parentId - ID of the parent snapshot
+ * @param baseId - ID of the base (full) snapshot
+ * @param chainDepth - Current position in the chain
+ * @returns The computed delta and changed files
+ */
+export function computeDelta(currentFiles, parentHashes, parentId, baseId, chainDepth) {
+    const currentHashes = computeContentHashes(currentFiles);
+    const changedFiles = new Map();
+    const entries = [];
+    let added = 0;
+    let modified = 0;
+    let removed = 0;
+    let unchanged = 0;
+    let changedBytes = 0;
+    let totalBytes = 0;
+    // Check each current file against parent
+    for (const [path, data] of currentFiles) {
+        totalBytes += data.length;
+        const currentHash = currentHashes.files[path];
+        const parentHash = parentHashes.files[path];
+        if (!parentHash) {
+            // New file
+            entries.push({ path, type: 'added', hash: currentHash, size: data.length });
+            changedFiles.set(path, data);
+            changedBytes += data.length;
+            added++;
+        }
+        else if (currentHash !== parentHash) {
+            // Modified file
+            entries.push({ path, type: 'modified', hash: currentHash, size: data.length });
+            changedFiles.set(path, data);
+            changedBytes += data.length;
+            modified++;
+        }
+        else {
+            unchanged++;
+        }
+    }
+    // Check for removed files (in parent but not in current)
+    for (const path of Object.keys(parentHashes.files)) {
+        if (!currentFiles.has(path)) {
+            entries.push({ path, type: 'removed' });
+            removed++;
+        }
+    }
+    const totalFiles = currentFiles.size;
+    const changedCount = added + modified + removed;
+    const changeRatio = totalFiles > 0 ? changedCount / totalFiles : 0;
+    // Should we force a full snapshot?
+    const shouldForceFull = chainDepth >= MAX_CHAIN_DEPTH || changeRatio >= FULL_SNAPSHOT_THRESHOLD;
+    const delta = {
+        parentId,
+        baseId,
+        chainDepth,
+        resultHashes: currentHashes,
+        entries,
+        stats: {
+            added,
+            modified,
+            removed,
+            unchanged,
+            totalFiles,
+            bytesSaved: totalBytes - changedBytes,
+        },
+    };
+    return { delta, changedFiles, shouldForceFull };
+}
+// ─── Packing Incremental Archives ────────────────────────────
+/**
+ * Pack an incremental snapshot (delta only).
+ * The archive contains:
+ * - manifest.json (with parent reference)
+ * - meta/delta-manifest.json (the delta details)
+ * - meta/snapshot-chain.json (chain info)
+ * - Only the changed/added files (same paths as full snapshot)
+ */
+export function packDelta(snapshot, delta, changedFiles) {
+    const files = new Map();
+    // Always include manifest and meta
+    files.set('manifest.json', Buffer.from(JSON.stringify(snapshot.manifest, null, 2)));
+    files.set('meta/delta-manifest.json', Buffer.from(JSON.stringify(delta, null, 2)));
+    files.set('meta/platform.json', Buffer.from(JSON.stringify(snapshot.platform, null, 2)));
+    files.set('meta/snapshot-chain.json', Buffer.from(JSON.stringify(snapshot.chain, null, 2)));
+    files.set('meta/restore-hints.json', Buffer.from(JSON.stringify(snapshot.restoreHints, null, 2)));
+    // Include only changed/added files
+    for (const [path, data] of changedFiles) {
+        files.set(path, data);
+    }
+    return files;
+}
+// ─── Reconstruction ──────────────────────────────────────────
+/**
+ * Reconstruct a full snapshot by walking the chain from base to current.
+ *
+ * Starting from the base (full) snapshot, applies each delta in order:
+ * 1. Load base snapshot → full file map
+ * 2. For each delta in the chain:
+ *    a. Add/overwrite files from the delta
+ *    b. Remove files marked as 'removed'
+ * 3. Return the reconstructed full file map
+ *
+ * @param snapshotId - The target snapshot to reconstruct
+ * @param storage - Storage backend
+ * @param passphrase - Decryption passphrase
+ * @returns Reconstructed full file map
+ */
+export async function reconstructFromChain(snapshotId, storage, passphrase) {
+    // Build the chain: walk backwards from snapshotId to find the base
+    const chain = await buildChain(snapshotId, storage, passphrase);
+    if (chain.length === 0) {
+        throw new Error(`Could not build snapshot chain for ${snapshotId}`);
+    }
+    // chain[0] is the base (full) snapshot, chain[n-1] is the target
+    // Start with the base's full file map
+    const baseArchive = chain[0];
+    const files = new Map(baseArchive.files);
+    // Apply each delta in order
+    for (let i = 1; i < chain.length; i++) {
+        const { files: deltaFiles, delta } = chain[i];
+        if (!delta) {
+            // This is a full snapshot in the middle of the chain (shouldn't happen normally)
+            files.clear();
+            for (const [path, data] of deltaFiles) {
+                files.set(path, data);
+            }
+            continue;
+        }
+        // Apply additions and modifications
+        for (const [path, data] of deltaFiles) {
+            // Skip meta files — they're delta-specific
+            if (path === 'meta/delta-manifest.json')
+                continue;
+            files.set(path, data);
+        }
+        // Apply removals
+        for (const entry of delta.entries) {
+            if (entry.type === 'removed') {
+                files.delete(entry.path);
+            }
+        }
+    }
+    return files;
+}
+/**
+ * Build the full chain from base to the given snapshot.
+ * Returns an ordered array: [base, delta1, delta2, ..., target]
+ */
+async function buildChain(snapshotId, storage, passphrase) {
+    const links = [];
+    let currentId = snapshotId;
+    const visited = new Set();
+    // Walk backwards collecting snapshots
+    while (currentId && !visited.has(currentId)) {
+        visited.add(currentId);
+        const entry = await findEntry(currentId);
+        if (!entry) {
+            throw new Error(`Snapshot not found in index: ${currentId}`);
+        }
+        const encrypted = await storage.get(entry.filename);
+        const archive = await decrypt(encrypted, passphrase);
+        const files = await unpackFromArchive(archive);
+        // Check if this is a delta or full snapshot
+        const deltaManifestBuf = files.get('meta/delta-manifest.json');
+        let delta;
+        if (deltaManifestBuf) {
+            delta = JSON.parse(deltaManifestBuf.toString('utf-8'));
+            links.unshift({ id: currentId, files, delta });
+            currentId = delta.parentId;
+        }
+        else {
+            // Full snapshot — this is the base
+            links.unshift({ id: currentId, files, delta: undefined });
+            currentId = undefined; // Stop walking
+        }
+    }
+    return links;
+}
+// ─── Helpers ─────────────────────────────────────────────────
+/**
+ * Get content hashes for the latest snapshot (used as parent for incremental).
+ * Returns null if no previous snapshots exist.
+ */
+export async function getParentHashes(storage, passphrase) {
+    const { getLatestEntry } = await import('./index-file.js');
+    const latest = await getLatestEntry();
+    if (!latest)
+        return null;
+    try {
+        const encrypted = await storage.get(latest.filename);
+        const archive = await decrypt(encrypted, passphrase);
+        const files = await unpackFromArchive(archive);
+        // Check if the latest is itself a delta
+        const deltaManifestBuf = files.get('meta/delta-manifest.json');
+        if (deltaManifestBuf) {
+            const delta = JSON.parse(deltaManifestBuf.toString('utf-8'));
+            return {
+                hashes: delta.resultHashes,
+                parentId: latest.id,
+                baseId: delta.baseId,
+                chainDepth: delta.chainDepth + 1,
+            };
+        }
+        // Full snapshot — compute hashes from the file map
+        const hashes = computeContentHashes(files);
+        return {
+            hashes,
+            parentId: latest.id,
+            baseId: latest.id,
+            chainDepth: 1,
+        };
+    }
+    catch {
+        // Can't load parent — force full snapshot
+        return null;
+    }
+}
+/**
+ * Check if a snapshot is incremental (has a delta manifest).
+ */
+export function isIncremental(files) {
+    return files.has('meta/delta-manifest.json');
+}
+/**
+ * Get the delta manifest from an unpacked archive, if present.
+ */
+export function getDeltaManifest(files) {
+    const buf = files.get('meta/delta-manifest.json');
+    if (!buf)
+        return null;
+    return JSON.parse(buf.toString('utf-8'));
+}
+//# sourceMappingURL=incremental.js.map

package/dist/incremental.js.map

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

package/dist/index.d.ts

@@ -8,6 +8,8 @@ export { encrypt, decrypt, verify } from './encryption.js';
 export { packSnapshot, unpackSnapshot, computeChecksum, generateSnapshotId, snapshotFilename, SAF_EXTENSION, SAF_VERSION, } from './format.js';
 export { loadConfig, saveConfig, initializeProject, isInitialized, defaultConfig, SAVESTATE_DIR, GLOBAL_SAVESTATE_DIR, } from './config.js';
 export { createSnapshot, getLatestSnapshotId } from './snapshot.js';
+export { computeContentHashes, computeDelta, packDelta, reconstructFromChain, getParentHashes, isIncremental, getDeltaManifest, MAX_CHAIN_DEPTH, FULL_SNAPSHOT_THRESHOLD, } from './incremental.js';
+export type { ContentHashes, DeltaEntry, DeltaManifest, DeltaResult, } from './incremental.js';
 export { restoreSnapshot, validateSnapshot } from './restore.js';
 export { searchSnapshots, scoreMatch } from './search.js';
 export { LocalStorageBackend } from './storage/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,aAAa,EACb,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,aAAa,EACb,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpE,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,UAAU,EACV,aAAa,EACb,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -11,6 +11,8 @@ export { packSnapshot, unpackSnapshot, computeChecksum, generateSnapshotId, snap
 export { loadConfig, saveConfig, initializeProject, isInitialized, defaultConfig, SAVESTATE_DIR, GLOBAL_SAVESTATE_DIR, } from './config.js';
 // Snapshot
 export { createSnapshot, getLatestSnapshotId } from './snapshot.js';
+// Incremental
+export { computeContentHashes, computeDelta, packDelta, reconstructFromChain, getParentHashes, isIncremental, getDeltaManifest, MAX_CHAIN_DEPTH, FULL_SNAPSHOT_THRESHOLD, } from './incremental.js';
 // Restore
 export { restoreSnapshot, validateSnapshot } from './restore.js';
 // Search

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmCH,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE3D,SAAS;AACT,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,SAAS;AACT,OAAO,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,aAAa,EACb,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpE,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEjE,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D,UAAU;AACV,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,WAAW;AACX,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmCH,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE3D,SAAS;AACT,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,SAAS;AACT,OAAO,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,aAAa,EACb,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpE,cAAc;AACd,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAQ1B,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEjE,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D,UAAU;AACV,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,WAAW;AACX,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC"}

package/dist/restore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../src/restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKpE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,CAAC,UAAU,GAAG,QAAQ,GAAG,eAAe,CAAC,EAAE,CAAC;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,OAAO,CAAC,aAAa,CAAC,CAwExB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAClE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAYD"}
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../src/restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMpE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,CAAC,UAAU,GAAG,QAAQ,GAAG,eAAe,CAAC,EAAE,CAAC;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,OAAO,CAAC,aAAa,CAAC,CA8ExB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAClE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAYD"}

package/dist/restore.js

@@ -14,6 +14,7 @@
 import { unpackFromArchive, unpackSnapshot, computeChecksum, snapshotFilename } from './format.js';
 import { decrypt } from './encryption.js';
 import { findEntry, getLatestEntry } from './index-file.js';
+import { isIncremental, reconstructFromChain } from './incremental.js';
 /**
  * Restore from a snapshot.
  *
@@ -67,9 +68,13 @@ export async function restoreSnapshot(snapshotId, adapter, storage, passphrase,
         throw err;
     }
     // Step 4: Unpack SAF
-    const fileMap = await unpackFromArchive(archive);
+    let fileMap = await unpackFromArchive(archive);
+    // Step 4b: If incremental, reconstruct full state from chain
+    if (isIncremental(fileMap)) {
+        fileMap = await reconstructFromChain(resolvedId, storage, passphrase);
+    }
     const snapshot = unpackSnapshot(fileMap);
-    // Verify integrity
+    // Verify integrity (for full snapshots)
     const expectedChecksum = snapshot.manifest.checksum;
     if (expectedChecksum) {
         const actualChecksum = computeChecksum(archive);

package/dist/restore.js.map

@@ -1 +1 @@
-{"version":3,"file":"restore.js","sourceRoot":"","sources":["../src/restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAa5D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,OAAgB,EAChB,OAAuB,EACvB,UAAkB,EAClB,OAGC;IAED,iDAAiD;IACjD,IAAI,UAAU,GAAG,UAAU,CAAC;IAC5B,IAAI,QAAgB,CAAC;IAErB,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC;QACvB,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,KAAK,EAAE,CAAC;YACV,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,oCAAoC;YACpC,QAAQ,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,kCAAkC,QAAQ,IAAI;YAC9C,8BAA8B,OAAO,CAAC,EAAE,EAAE,CAC3C,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,qBAAqB;IACrB,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAEzC,mBAAmB;IACnB,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACpD,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAChD,sEAAsE;QACtE,qEAAqE;QACrE,4CAA4C;IAC9C,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QACrB,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,UAAU,EAAE,UAAU;QACtB,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS;QACtC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,QAAQ;QACpC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO;QAClC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK;QAC9B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM;QACxC,iBAAiB,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK;QAC/C,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW;KAC7C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAkB;IAIvD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC9D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACtE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACnE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ;QAAE,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAEjE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../src/restore.ts"],"names":[],"mappings":"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"}

package/dist/snapshot.d.ts

@@ -21,20 +21,36 @@ export interface CreateSnapshotResult {
     archiveSize: number;
     encryptedSize: number;
     fileCount: number;
+    /** Whether this is an incremental (delta) snapshot */
+    incremental: boolean;
+    /** Delta stats (only present for incremental snapshots) */
+    delta?: {
+        added: number;
+        modified: number;
+        removed: number;
+        unchanged: number;
+        bytesSaved: number;
+        chainDepth: number;
+    };
 }
 /**
  * Create a new snapshot by extracting state from an adapter.
  *
+ * Automatically uses incremental snapshots when a parent exists,
+ * unless `full` is explicitly requested or the chain is too deep.
+ *
  * @param adapter - Platform adapter to extract state from
  * @param storage - Storage backend to write to
  * @param passphrase - Encryption passphrase
- * @param options - Snapshot options (label, tags, etc.)
+ * @param options - Snapshot options (label, tags, full, etc.)
  * @returns Details about the created snapshot
  */
 export declare function createSnapshot(adapter: Adapter, storage: StorageBackend, passphrase: string, options?: {
     label?: string;
     tags?: string[];
     parentId?: string;
+    /** Force a full snapshot (skip incremental) */
+    full?: boolean;
 }): Promise<CreateSnapshotResult>;
 /**
  * Get the latest snapshot ID from the index.

package/dist/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAmB,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAYrF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,oBAAoB,CAAC,CAmE/B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIlE"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAmB,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmBrF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,OAAO,CAAC;IACrB,2DAA2D;IAC3D,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GACA,OAAO,CAAC,oBAAoB,CAAC,CAkI/B;AAYD;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIlE"}

package/dist/snapshot.js

@@ -17,13 +17,17 @@
 import { generateSnapshotId, SAF_VERSION, packSnapshot, packToArchive, computeChecksum, snapshotFilename, } from './format.js';
 import { encrypt } from './encryption.js';
 import { addToIndex } from './index-file.js';
+import { getParentHashes, computeDelta, packDelta, } from './incremental.js';
 /**
  * Create a new snapshot by extracting state from an adapter.
  *
+ * Automatically uses incremental snapshots when a parent exists,
+ * unless `full` is explicitly requested or the chain is too deep.
+ *
  * @param adapter - Platform adapter to extract state from
  * @param storage - Storage backend to write to
  * @param passphrase - Encryption passphrase
- * @param options - Snapshot options (label, tags, etc.)
+ * @param options - Snapshot options (label, tags, full, etc.)
  * @returns Details about the created snapshot
  */
 export async function createSnapshot(adapter, storage, passphrase, options) {
@@ -32,6 +36,31 @@ export async function createSnapshot(adapter, storage, passphrase, options) {
     // Step 2: Enrich manifest
     const snapshotId = generateSnapshotId();
     const now = new Date().toISOString();
+    // Step 3: Check for incremental opportunity
+    let parentInfo = null;
+    if (!options?.full) {
+        try {
+            parentInfo = await getParentHashes(storage, passphrase);
+        }
+        catch {
+            // Can't load parent — proceed with full snapshot
+        }
+    }
+    // Step 4: Pack the full snapshot to get file map
+    // (we need this regardless — for delta comparison or full storage)
+    const fullFileMap = packSnapshot(snapshot);
+    // Step 5: Determine if we should do incremental or full
+    let deltaManifest;
+    let deltaResult;
+    let isIncremental = false;
+    if (parentInfo) {
+        deltaResult = computeDelta(fullFileMap, parentInfo.hashes, parentInfo.parentId, parentInfo.baseId, parentInfo.chainDepth);
+        if (!deltaResult.shouldForceFull) {
+            isIncremental = true;
+            deltaManifest = deltaResult.delta;
+        }
+    }
+    // Step 6: Set manifest with parent reference
     snapshot.manifest = {
         ...snapshot.manifest,
         id: snapshotId,
@@ -41,31 +70,47 @@ export async function createSnapshot(adapter, storage, passphrase, options) {
         platform: adapter.platform,
         label: options?.label ?? snapshot.manifest.label,
         tags: options?.tags ?? snapshot.manifest.tags,
-        parent: options?.parentId,
+        parent: isIncremental ? parentInfo.parentId : options?.parentId,
     };
-    // Step 3: Update snapshot chain
+    // Step 7: Update snapshot chain
     snapshot.chain = {
         current: snapshotId,
-        parent: options?.parentId,
-        ancestors: options?.parentId
-            ? [...(snapshot.chain?.ancestors ?? []), options.parentId]
-            : [],
+        parent: isIncremental ? parentInfo.parentId : options?.parentId,
+        ancestors: isIncremental
+            ? [...(deltaManifest.chainDepth > 1
+                    ? (await getChainAncestors(parentInfo.parentId))
+                    : []), parentInfo.parentId]
+            : options?.parentId
+                ? [...(snapshot.chain?.ancestors ?? []), options.parentId]
+                : [],
     };
-    // Step 4: First pass — pack to get file map and compute checksum
-    const fileMap = packSnapshot(snapshot);
-    const firstArchive = packToArchive(fileMap);
+    // Step 8: Pack the archive (incremental or full)
+    let archiveFileMap;
+    if (isIncremental && deltaResult && deltaManifest) {
+        archiveFileMap = packDelta(snapshot, deltaManifest, deltaResult.changedFiles);
+    }
+    else {
+        archiveFileMap = packSnapshot(snapshot);
+    }
+    // Step 9: Compute checksum and finalize
+    const firstArchive = packToArchive(archiveFileMap);
     const checksum = computeChecksum(firstArchive);
-    // Step 5: Update manifest with checksum and size, then re-pack
     snapshot.manifest.checksum = checksum;
     snapshot.manifest.size = firstArchive.length;
-    const finalFileMap = packSnapshot(snapshot);
-    const finalArchive = packToArchive(finalFileMap);
-    // Step 6: Encrypt the archive
+    // Re-pack with updated manifest
+    if (isIncremental && deltaResult && deltaManifest) {
+        archiveFileMap.set('manifest.json', Buffer.from(JSON.stringify(snapshot.manifest, null, 2)));
+    }
+    else {
+        archiveFileMap = packSnapshot(snapshot);
+    }
+    const finalArchive = packToArchive(archiveFileMap);
+    // Step 10: Encrypt
     const encrypted = await encrypt(finalArchive, passphrase);
-    // Step 7: Store the encrypted archive
+    // Step 11: Store
     const filename = snapshotFilename(snapshotId);
     await storage.put(filename, encrypted);
-    // Step 8: Update local index
+    // Step 12: Update local index
     await addToIndex({
         id: snapshotId,
         timestamp: now,
@@ -81,9 +126,29 @@ export async function createSnapshot(adapter, storage, passphrase, options) {
         filename,
         archiveSize: finalArchive.length,
         encryptedSize: encrypted.length,
-        fileCount: finalFileMap.size,
+        fileCount: archiveFileMap.size,
+        incremental: isIncremental,
+        delta: isIncremental && deltaManifest
+            ? {
+                added: deltaManifest.stats.added,
+                modified: deltaManifest.stats.modified,
+                removed: deltaManifest.stats.removed,
+                unchanged: deltaManifest.stats.unchanged,
+                bytesSaved: deltaManifest.stats.bytesSaved,
+                chainDepth: deltaManifest.chainDepth,
+            }
+            : undefined,
     };
 }
+/**
+ * Helper: get the chain ancestors for a given snapshot ID.
+ */
+async function getChainAncestors(snapshotId) {
+    const index = await import('./index-file.js');
+    // We don't need to decrypt the full chain — just track IDs from the index
+    // For now, return empty. The chain info is primarily in meta/snapshot-chain.json
+    return [];
+}
 /**
  * Get the latest snapshot ID from the index.
  */

package/dist/snapshot.js.map

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

package/dist/storage/index.d.ts

@@ -2,6 +2,8 @@
  * Storage module re-exports
  */
 export { LocalStorageBackend } from './local.js';
+export { S3Storage, S3Error } from './s3.js';
+export type { S3StorageOptions } from './s3.js';
 export { resolveStorage } from './resolve.js';
 export type { StorageBackend } from './interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/storage/index.js

@@ -2,5 +2,6 @@
  * Storage module re-exports
  */
 export { LocalStorageBackend } from './local.js';
+export { S3Storage, S3Error } from './s3.js';
 export { resolveStorage } from './resolve.js';
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/storage/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/storage/resolve.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGnE;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CAatE"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/storage/resolve.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKnE;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CA6BtE"}