@savestate/cli 0.1.0

package/dist/commands/snapshot.js

@@ -0,0 +1,84 @@
+/**
+ * savestate snapshot — Capture current AI state to encrypted archive
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { isInitialized, loadConfig } from '../config.js';
+import { detectAdapter, getAdapter } from '../adapters/registry.js';
+import { createSnapshot } from '../snapshot.js';
+import { resolveStorage } from '../storage/resolve.js';
+import { getPassphrase } from '../passphrase.js';
+export async function snapshotCommand(options) {
+    console.log();
+    if (!isInitialized()) {
+        console.log(chalk.red('✗ SaveState not initialized. Run `savestate init` first.'));
+        process.exit(1);
+    }
+    if (options.schedule) {
+        console.log(chalk.cyan(`⏰ Scheduled snapshots: every ${options.schedule}`));
+        console.log(chalk.dim('   [Coming soon] Will run as a background daemon.'));
+        console.log(chalk.dim('   For now, use cron: */6 * * * * savestate snapshot'));
+        console.log();
+        return;
+    }
+    const config = await loadConfig();
+    try {
+        // Resolve adapter
+        let adapter;
+        if (options.adapter) {
+            adapter = getAdapter(options.adapter);
+            if (!adapter) {
+                console.log(chalk.red(`✗ Unknown adapter: ${options.adapter}`));
+                process.exit(1);
+            }
+        }
+        else if (config.defaultAdapter) {
+            adapter = getAdapter(config.defaultAdapter);
+        }
+        else {
+            adapter = await detectAdapter();
+        }
+        if (!adapter) {
+            console.log(chalk.red('✗ No adapter found. Specify one with --adapter or configure a default.'));
+            process.exit(1);
+        }
+        // Get passphrase
+        const passphrase = await getPassphrase();
+        // Resolve storage backend
+        const storage = resolveStorage(config);
+        const spinner = ora(`Extracting state via ${adapter.name} adapter...`).start();
+        const result = await createSnapshot(adapter, storage, passphrase, {
+            label: options.label,
+            tags: options.tags?.split(',').map((t) => t.trim()),
+        });
+        spinner.succeed('Snapshot created!');
+        console.log();
+        console.log(`  ${chalk.dim('ID:')}         ${chalk.cyan(result.snapshot.manifest.id)}`);
+        console.log(`  ${chalk.dim('Adapter:')}    ${adapter.name}`);
+        if (options.label) {
+            console.log(`  ${chalk.dim('Label:')}      ${options.label}`);
+        }
+        console.log(`  ${chalk.dim('Files:')}      ${result.fileCount} files in archive`);
+        console.log(`  ${chalk.dim('Archive:')}    ${formatBytes(result.archiveSize)}`);
+        console.log(`  ${chalk.dim('Encrypted:')}  ${formatBytes(result.encryptedSize)}`);
+        console.log(`  ${chalk.dim('Storage:')}    ${config.storage.type}`);
+        console.log(`  ${chalk.dim('Status:')}     ${chalk.green('✓ Encrypted & stored')}`);
+        console.log();
+        console.log(chalk.dim(`  Restore with: savestate restore ${result.snapshot.manifest.id}`));
+        console.log();
+    }
+    catch (err) {
+        console.error();
+        console.error(chalk.red('✗ Snapshot failed'));
+        console.error(chalk.red(err instanceof Error ? err.message : String(err)));
+        process.exit(1);
+    }
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/commands/snapshot.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,44 @@
+/**
+ * SaveState Configuration
+ *
+ * Manages .savestate/config.json in the current project directory.
+ * Also supports global config at ~/.savestate/config.json.
+ */
+import type { SaveStateConfig } from './types.js';
+/** Directory name for local SaveState config */
+export declare const SAVESTATE_DIR = ".savestate";
+/** Config filename */
+export declare const CONFIG_FILE = "config.json";
+/** Global SaveState home directory */
+export declare const GLOBAL_SAVESTATE_DIR: string;
+/**
+ * Default configuration for new projects.
+ */
+export declare function defaultConfig(): SaveStateConfig;
+/**
+ * Resolve the local .savestate directory for the current project.
+ */
+export declare function localConfigDir(cwd?: string): string;
+/**
+ * Resolve the path to the local config file.
+ */
+export declare function localConfigPath(cwd?: string): string;
+/**
+ * Check if SaveState is initialized in the given directory.
+ */
+export declare function isInitialized(cwd?: string): boolean;
+/**
+ * Load the SaveState config from the local .savestate/ directory.
+ * Falls back to global config if local doesn't exist.
+ */
+export declare function loadConfig(cwd?: string): Promise<SaveStateConfig>;
+/**
+ * Save the SaveState config to the local .savestate/ directory.
+ */
+export declare function saveConfig(config: SaveStateConfig, cwd?: string): Promise<void>;
+/**
+ * Initialize SaveState in the given directory.
+ * Creates .savestate/ and writes default config.
+ */
+export declare function initializeProject(cwd?: string): Promise<SaveStateConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,gDAAgD;AAChD,eAAO,MAAM,aAAa,eAAe,CAAC;AAE1C,sBAAsB;AACtB,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,sCAAsC;AACtC,eAAO,MAAM,oBAAoB,QAAgC,CAAC;AAElE;;GAEG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAW/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAYvE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAI9E"}

package/dist/config.js

@@ -0,0 +1,83 @@
+/**
+ * SaveState Configuration
+ *
+ * Manages .savestate/config.json in the current project directory.
+ * Also supports global config at ~/.savestate/config.json.
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+/** Directory name for local SaveState config */
+export const SAVESTATE_DIR = '.savestate';
+/** Config filename */
+export const CONFIG_FILE = 'config.json';
+/** Global SaveState home directory */
+export const GLOBAL_SAVESTATE_DIR = join(homedir(), '.savestate');
+/**
+ * Default configuration for new projects.
+ */
+export function defaultConfig() {
+    return {
+        version: '0.1.0',
+        storage: {
+            type: 'local',
+            options: {
+                path: GLOBAL_SAVESTATE_DIR,
+            },
+        },
+        adapters: [],
+    };
+}
+/**
+ * Resolve the local .savestate directory for the current project.
+ */
+export function localConfigDir(cwd) {
+    return join(resolve(cwd ?? process.cwd()), SAVESTATE_DIR);
+}
+/**
+ * Resolve the path to the local config file.
+ */
+export function localConfigPath(cwd) {
+    return join(localConfigDir(cwd), CONFIG_FILE);
+}
+/**
+ * Check if SaveState is initialized in the given directory.
+ */
+export function isInitialized(cwd) {
+    return existsSync(localConfigPath(cwd));
+}
+/**
+ * Load the SaveState config from the local .savestate/ directory.
+ * Falls back to global config if local doesn't exist.
+ */
+export async function loadConfig(cwd) {
+    const localPath = localConfigPath(cwd);
+    const globalPath = join(GLOBAL_SAVESTATE_DIR, CONFIG_FILE);
+    for (const configPath of [localPath, globalPath]) {
+        if (existsSync(configPath)) {
+            const raw = await readFile(configPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+    }
+    return defaultConfig();
+}
+/**
+ * Save the SaveState config to the local .savestate/ directory.
+ */
+export async function saveConfig(config, cwd) {
+    const dir = localConfigDir(cwd);
+    await mkdir(dir, { recursive: true });
+    const configPath = join(dir, CONFIG_FILE);
+    await writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Initialize SaveState in the given directory.
+ * Creates .savestate/ and writes default config.
+ */
+export async function initializeProject(cwd) {
+    const config = defaultConfig();
+    await saveConfig(config, cwd);
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAE1C,sBAAsB;AACtB,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AAEzC,sCAAsC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE;YACP,IAAI,EAAE,OAAO;YACb,OAAO,EAAE;gBACP,IAAI,EAAE,oBAAoB;aAC3B;SACF;QACD,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,UAAU,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAY;IAC3C,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC;IAE3D,KAAK,MAAM,UAAU,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC;QACjD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAuB,EAAE,GAAY;IACpE,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAY;IAClD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/encryption.d.ts

@@ -0,0 +1,40 @@
+/**
+ * SaveState Encryption Module
+ *
+ * Provides AES-256-GCM encryption with scrypt key derivation.
+ * All data is encrypted before leaving the machine.
+ *
+ * Key derivation: passphrase → scrypt → 256-bit key
+ * Encryption: AES-256-GCM (authenticated encryption)
+ * Integrity: Built into GCM auth tag
+ */
+/**
+ * Encrypt data with a passphrase.
+ *
+ * Returns a single buffer containing the version header, salt, IV,
+ * auth tag, and ciphertext. This buffer is self-contained — everything
+ * needed to decrypt (except the passphrase) is included.
+ *
+ * @param data - Plaintext data to encrypt
+ * @param passphrase - User passphrase for key derivation
+ * @returns Encrypted buffer with header
+ */
+export declare function encrypt(data: Buffer, passphrase: string): Promise<Buffer>;
+/**
+ * Decrypt data with a passphrase.
+ *
+ * Reads the version header, extracts salt/IV/authTag, derives the key,
+ * and decrypts. GCM auth tag verification ensures integrity automatically.
+ *
+ * @param data - Encrypted buffer (as produced by encrypt())
+ * @param passphrase - User passphrase for key derivation
+ * @returns Decrypted plaintext buffer
+ * @throws Error if passphrase is wrong or data is tampered
+ */
+export declare function decrypt(data: Buffer, passphrase: string): Promise<Buffer>;
+/**
+ * Verify that encrypted data can be decrypted with the given passphrase
+ * without actually returning the plaintext.
+ */
+export declare function verify(data: Buffer, passphrase: string): Promise<boolean>;
+//# sourceMappingURL=encryption.d.ts.map

package/dist/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../src/encryption.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsCH;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB/E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC/E;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/E"}

package/dist/encryption.js

@@ -0,0 +1,120 @@
+/**
+ * SaveState Encryption Module
+ *
+ * Provides AES-256-GCM encryption with scrypt key derivation.
+ * All data is encrypted before leaving the machine.
+ *
+ * Key derivation: passphrase → scrypt → 256-bit key
+ * Encryption: AES-256-GCM (authenticated encryption)
+ * Integrity: Built into GCM auth tag
+ */
+import { randomBytes, scryptSync, createCipheriv, createDecipheriv } from 'node:crypto';
+/** Encryption parameters */
+const ALGORITHM = 'aes-256-gcm';
+const KEY_LENGTH = 32; // 256 bits
+const IV_LENGTH = 16; // 128 bits (GCM standard)
+const AUTH_TAG_LENGTH = 16; // 128 bits
+const SALT_LENGTH = 32; // 256 bits
+/**
+ * scrypt parameters — intentionally memory-hard to resist brute force.
+ * N=2^17 (~128MB), r=8, p=1 — comparable to Argon2id defaults.
+ */
+const SCRYPT_N = 131072; // 2^17 — CPU/memory cost
+const SCRYPT_R = 8; // block size
+const SCRYPT_P = 1; // parallelization
+/**
+ * Header format: [version(1)] [salt(32)] [iv(16)] [authTag(16)] [ciphertext(...)]
+ * Total overhead: 1 + 32 + 16 + 16 = 65 bytes
+ */
+const HEADER_VERSION = 0x01;
+const HEADER_OVERHEAD = 1 + SALT_LENGTH + IV_LENGTH + AUTH_TAG_LENGTH;
+/**
+ * Derive an encryption key from a passphrase using scrypt.
+ */
+function deriveKey(passphrase, salt) {
+    return scryptSync(passphrase, salt, KEY_LENGTH, {
+        N: SCRYPT_N,
+        r: SCRYPT_R,
+        p: SCRYPT_P,
+        maxmem: 256 * 1024 * 1024, // 256MB max memory
+    });
+}
+/**
+ * Encrypt data with a passphrase.
+ *
+ * Returns a single buffer containing the version header, salt, IV,
+ * auth tag, and ciphertext. This buffer is self-contained — everything
+ * needed to decrypt (except the passphrase) is included.
+ *
+ * @param data - Plaintext data to encrypt
+ * @param passphrase - User passphrase for key derivation
+ * @returns Encrypted buffer with header
+ */
+export async function encrypt(data, passphrase) {
+    const salt = randomBytes(SALT_LENGTH);
+    const iv = randomBytes(IV_LENGTH);
+    const key = deriveKey(passphrase, salt);
+    const cipher = createCipheriv(ALGORITHM, key, iv, { authTagLength: AUTH_TAG_LENGTH });
+    const encrypted = Buffer.concat([cipher.update(data), cipher.final()]);
+    const authTag = cipher.getAuthTag();
+    // Pack: [version][salt][iv][authTag][ciphertext]
+    return Buffer.concat([
+        Buffer.from([HEADER_VERSION]),
+        salt,
+        iv,
+        authTag,
+        encrypted,
+    ]);
+}
+/**
+ * Decrypt data with a passphrase.
+ *
+ * Reads the version header, extracts salt/IV/authTag, derives the key,
+ * and decrypts. GCM auth tag verification ensures integrity automatically.
+ *
+ * @param data - Encrypted buffer (as produced by encrypt())
+ * @param passphrase - User passphrase for key derivation
+ * @returns Decrypted plaintext buffer
+ * @throws Error if passphrase is wrong or data is tampered
+ */
+export async function decrypt(data, passphrase) {
+    if (data.length < HEADER_OVERHEAD) {
+        throw new Error('Invalid encrypted data: too short');
+    }
+    const version = data[0];
+    if (version !== HEADER_VERSION) {
+        throw new Error(`Unsupported encryption format version: ${version}`);
+    }
+    let offset = 1;
+    const salt = data.subarray(offset, offset + SALT_LENGTH);
+    offset += SALT_LENGTH;
+    const iv = data.subarray(offset, offset + IV_LENGTH);
+    offset += IV_LENGTH;
+    const authTag = data.subarray(offset, offset + AUTH_TAG_LENGTH);
+    offset += AUTH_TAG_LENGTH;
+    const ciphertext = data.subarray(offset);
+    const key = deriveKey(passphrase, salt);
+    const decipher = createDecipheriv(ALGORITHM, key, iv, { authTagLength: AUTH_TAG_LENGTH });
+    decipher.setAuthTag(authTag);
+    try {
+        return Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+    }
+    catch {
+        throw new Error('Decryption failed — wrong passphrase or corrupted data. ' +
+            'GCM authentication tag verification failed.');
+    }
+}
+/**
+ * Verify that encrypted data can be decrypted with the given passphrase
+ * without actually returning the plaintext.
+ */
+export async function verify(data, passphrase) {
+    try {
+        await decrypt(data, passphrase);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=encryption.js.map

package/dist/encryption.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SaveState Archive Format (SAF)
+ *
+ * Packing: JSON + files → tar.gz → encrypt → .saf.enc
+ * Unpacking: .saf.enc → decrypt → tar.gz → extract
+ */
+import type { Snapshot } from './types.js';
+/** File extension for encrypted SaveState archives */
+export declare const SAF_EXTENSION = ".saf.enc";
+/** Current SAF format version */
+export declare const SAF_VERSION = "0.1.0";
+/**
+ * Build the directory structure for a snapshot, ready to be tarred.
+ * Returns a map of relative paths → content buffers.
+ */
+export declare function packSnapshot(snapshot: Snapshot): Map<string, Buffer>;
+/**
+ * Unpack a snapshot from extracted archive files.
+ */
+export declare function unpackSnapshot(files: Map<string, Buffer>): Snapshot;
+/**
+ * Compute SHA-256 checksum of a buffer.
+ */
+export declare function computeChecksum(data: Buffer): string;
+/**
+ * Generate a snapshot ID from timestamp + random suffix.
+ */
+export declare function generateSnapshotId(): string;
+/**
+ * Generate a filename for a snapshot archive.
+ */
+export declare function snapshotFilename(id: string): string;
+/**
+ * Pack a file map into a tar.gz buffer.
+ *
+ * Creates an in-memory tar archive, gzips it, and returns the buffer.
+ * Each entry in the map is a relative path → content buffer.
+ */
+export declare function packToArchive(files: Map<string, Buffer>): Buffer;
+/**
+ * Unpack a tar.gz buffer into a file map.
+ *
+ * Decompresses and extracts all files from the archive,
+ * returning their paths and content buffers.
+ */
+export declare function unpackFromArchive(archive: Buffer): Promise<Map<string, Buffer>>;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,sDAAsD;AACtD,eAAO,MAAM,aAAa,aAAa,CAAC;AAExC,iCAAiC;AACjC,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA+CpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAmDnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAuCD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAGhE;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAoBrF"}

package/dist/format.js

@@ -0,0 +1,198 @@
+/**
+ * SaveState Archive Format (SAF)
+ *
+ * Packing: JSON + files → tar.gz → encrypt → .saf.enc
+ * Unpacking: .saf.enc → decrypt → tar.gz → extract
+ */
+import { createHash } from 'node:crypto';
+import { gzipSync, gunzipSync } from 'node:zlib';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { Header, Parser } from 'tar';
+/** File extension for encrypted SaveState archives */
+export const SAF_EXTENSION = '.saf.enc';
+/** Current SAF format version */
+export const SAF_VERSION = '0.1.0';
+/**
+ * Build the directory structure for a snapshot, ready to be tarred.
+ * Returns a map of relative paths → content buffers.
+ */
+export function packSnapshot(snapshot) {
+    const files = new Map();
+    // manifest.json
+    files.set('manifest.json', Buffer.from(JSON.stringify(snapshot.manifest, null, 2)));
+    // identity/
+    if (snapshot.identity.personality) {
+        files.set('identity/personality.md', Buffer.from(snapshot.identity.personality));
+    }
+    if (snapshot.identity.config) {
+        files.set('identity/config.json', Buffer.from(JSON.stringify(snapshot.identity.config, null, 2)));
+    }
+    if (snapshot.identity.tools?.length) {
+        files.set('identity/tools.json', Buffer.from(JSON.stringify(snapshot.identity.tools, null, 2)));
+    }
+    if (snapshot.identity.skills?.length) {
+        files.set('identity/skills.json', Buffer.from(JSON.stringify(snapshot.identity.skills, null, 2)));
+    }
+    if (snapshot.identity.scripts?.length) {
+        files.set('identity/scripts.json', Buffer.from(JSON.stringify(snapshot.identity.scripts, null, 2)));
+    }
+    if (snapshot.identity.extensions?.length) {
+        files.set('identity/extensions.json', Buffer.from(JSON.stringify(snapshot.identity.extensions, null, 2)));
+    }
+    if (snapshot.identity.fileManifest?.length) {
+        files.set('identity/file-manifest.json', Buffer.from(JSON.stringify(snapshot.identity.fileManifest, null, 2)));
+    }
+    if (snapshot.identity.projectMeta && Object.keys(snapshot.identity.projectMeta).length > 0) {
+        files.set('identity/project-meta.json', Buffer.from(JSON.stringify(snapshot.identity.projectMeta, null, 2)));
+    }
+    // memory/
+    files.set('memory/core.json', Buffer.from(JSON.stringify(snapshot.memory.core, null, 2)));
+    if (snapshot.memory.knowledge.length > 0) {
+        files.set('memory/knowledge/index.json', Buffer.from(JSON.stringify(snapshot.memory.knowledge, null, 2)));
+    }
+    // conversations/
+    files.set('conversations/index.json', Buffer.from(JSON.stringify(snapshot.conversations, null, 2)));
+    // meta/
+    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)));
+    return files;
+}
+/**
+ * Unpack a snapshot from extracted archive files.
+ */
+export function unpackSnapshot(files) {
+    const getJson = (path) => {
+        const buf = files.get(path);
+        if (!buf)
+            throw new Error(`Missing required file in archive: ${path}`);
+        return JSON.parse(buf.toString('utf-8'));
+    };
+    const getText = (path) => {
+        const buf = files.get(path);
+        return buf ? buf.toString('utf-8') : undefined;
+    };
+    const manifest = getJson('manifest.json');
+    const identity = {
+        personality: getText('identity/personality.md'),
+        config: files.has('identity/config.json')
+            ? getJson('identity/config.json')
+            : undefined,
+        tools: files.has('identity/tools.json')
+            ? getJson('identity/tools.json')
+            : undefined,
+        skills: files.has('identity/skills.json')
+            ? getJson('identity/skills.json')
+            : undefined,
+        scripts: files.has('identity/scripts.json')
+            ? getJson('identity/scripts.json')
+            : undefined,
+        extensions: files.has('identity/extensions.json')
+            ? getJson('identity/extensions.json')
+            : undefined,
+        fileManifest: files.has('identity/file-manifest.json')
+            ? getJson('identity/file-manifest.json')
+            : undefined,
+        projectMeta: files.has('identity/project-meta.json')
+            ? getJson('identity/project-meta.json')
+            : undefined,
+    };
+    const memory = {
+        core: getJson('memory/core.json'),
+        knowledge: files.has('memory/knowledge/index.json')
+            ? getJson('memory/knowledge/index.json')
+            : [],
+    };
+    const conversations = getJson('conversations/index.json');
+    const platform = getJson('meta/platform.json');
+    const chain = getJson('meta/snapshot-chain.json');
+    const restoreHints = getJson('meta/restore-hints.json');
+    return { manifest, identity, memory, conversations, platform, chain, restoreHints };
+}
+/**
+ * Compute SHA-256 checksum of a buffer.
+ */
+export function computeChecksum(data) {
+    return createHash('sha256').update(data).digest('hex');
+}
+/**
+ * Generate a snapshot ID from timestamp + random suffix.
+ */
+export function generateSnapshotId() {
+    const ts = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const rand = Math.random().toString(36).slice(2, 8);
+    return `ss-${ts}-${rand}`;
+}
+/**
+ * Generate a filename for a snapshot archive.
+ */
+export function snapshotFilename(id) {
+    return `${id}${SAF_EXTENSION}`;
+}
+/**
+ * Build a raw tar archive from in-memory files.
+ * Uses tar's Header class for proper POSIX-compliant headers.
+ */
+function buildTar(files) {
+    const blocks = [];
+    for (const [path, data] of files) {
+        const headerBuf = Buffer.alloc(512);
+        const h = new Header();
+        h.path = path;
+        h.size = data.length;
+        h.type = 'File';
+        h.mode = 0o644;
+        h.mtime = new Date();
+        h.uid = 0;
+        h.gid = 0;
+        h.uname = 'savestate';
+        h.gname = 'savestate';
+        h.encode(headerBuf, 0);
+        blocks.push(headerBuf);
+        blocks.push(data);
+        // Pad data to 512-byte boundary
+        const remainder = data.length % 512;
+        if (remainder > 0) {
+            blocks.push(Buffer.alloc(512 - remainder));
+        }
+    }
+    // End-of-archive marker: two 512-byte zero blocks
+    blocks.push(Buffer.alloc(1024));
+    return Buffer.concat(blocks);
+}
+/**
+ * Pack a file map into a tar.gz buffer.
+ *
+ * Creates an in-memory tar archive, gzips it, and returns the buffer.
+ * Each entry in the map is a relative path → content buffer.
+ */
+export function packToArchive(files) {
+    const tar = buildTar(files);
+    return gzipSync(tar);
+}
+/**
+ * Unpack a tar.gz buffer into a file map.
+ *
+ * Decompresses and extracts all files from the archive,
+ * returning their paths and content buffers.
+ */
+export async function unpackFromArchive(archive) {
+    const files = new Map();
+    const tar = gunzipSync(archive);
+    const parser = new Parser({
+        onReadEntry: (entry) => {
+            const chunks = [];
+            entry.on('data', (chunk) => chunks.push(chunk));
+            entry.on('end', () => {
+                if (entry.type === 'File') {
+                    files.set(entry.path, Buffer.concat(chunks));
+                }
+            });
+        },
+    });
+    const source = Readable.from(tar);
+    await pipeline(source, parser);
+    return files;
+}
+//# sourceMappingURL=format.js.map