@savestate/cli 0.1.0 → 0.2.0

package/README.md

@@ -23,7 +23,6 @@ SaveState is an encrypted backup and restore system for AI agent state. Think **
 npx savestate init                     # Set up encryption + storage
 npx savestate snapshot                 # Capture current state
 npx savestate restore latest           # Restore from last snapshot
-npx savestate search "cocktail recs"   # Search across all snapshots
 npx savestate diff v3 v5               # What changed between snapshots
 ```
 
@@ -32,7 +31,6 @@ npx savestate diff v3 v5               # What changed between snapshots
 - 🔐 **Encrypted at rest** — AES-256-GCM with scrypt key derivation. Your keys, your data.
 - 📦 **Open archive format** — The SaveState Archive Format (SAF) is an open spec. No vendor lock-in.
 - 🔌 **Platform adapters** — Works with ChatGPT, Claude, Gemini, Clawdbot, OpenAI Assistants, and more.
-- 🔍 **Searchable** — Query across all snapshots without restoring. Find anything.
 - 📊 **Incremental** — Like git — only captures what changed. Full history, tiny storage.
 - 💾 **Flexible storage** — Local filesystem, S3, R2, Backblaze, Dropbox, iCloud — you choose.
 - ⏰ **Scheduled backups** — Set it and forget it. Auto-snapshot on your schedule.
@@ -54,9 +52,6 @@ savestate snapshot
 # List all snapshots
 savestate list
 
-# Search across snapshots
-savestate search "that recipe from last month"
-
 # Restore from a snapshot
 savestate restore latest
 ```
@@ -79,13 +74,13 @@ Community adapters welcome! See [Contributing](#contributing).
 ```
 ┌─────────────────────────────────────────────────┐
 │                  SaveState CLI                    │
-│    init · snapshot · restore · search · diff      │
+│    init · snapshot · restore · list · diff         │
 ├─────────────────────────────────────────────────┤
 │              Adapter Layer                        │
 │   clawdbot · chatgpt · claude · openai · custom   │
 ├─────────────────────────────────────────────────┤
 │              Core Engine                          │
-│   snapshot · restore · search · diff · format     │
+│   snapshot · restore · diff · format              │
 ├─────────────────────────────────────────────────┤
 │              Encryption Layer                     │
 │   AES-256-GCM · scrypt KDF · integrity check     │
@@ -147,9 +142,6 @@ savestate restore [snapshot-id]       Restore from a snapshot (default: latest)
 savestate list                        List all snapshots
   --json                             Output as JSON
   --limit <n>                        Max snapshots to show
-savestate search <query>              Search across snapshots
-  --type <types>                     Filter by content type
-  --limit <n>                        Max results
 savestate diff <a> <b>                Compare two snapshots
 savestate config                      View/edit configuration
   --set <key=value>                  Set a config value
@@ -225,13 +217,11 @@ src/
 ├── config.ts           # Configuration management
 ├── snapshot.ts         # Snapshot creation
 ├── restore.ts          # Snapshot restoration
-├── search.ts           # Cross-snapshot search
 ├── commands/           # CLI command handlers
 │   ├── init.ts
 │   ├── snapshot.ts
 │   ├── restore.ts
 │   ├── list.ts
-│   ├── search.ts
 │   ├── diff.ts
 │   ├── config.ts
 │   └── adapters.ts

package/dist/adapters/chatgpt.d.ts

@@ -0,0 +1,113 @@
+/**
+ * ChatGPT Adapter
+ *
+ * Export-based adapter for ChatGPT data.
+ * Captures conversations, memories, custom instructions, and user profile
+ * from a ChatGPT data export (Settings → Data Controls → Export Data).
+ *
+ * Export structure:
+ *   conversations.json  — All conversations (tree-structured mapping)
+ *   memories.json       — ChatGPT memories (newer exports)
+ *   custom_instructions.json — About user + response preferences
+ *   user.json           — User profile metadata
+ *   model_comparisons.json — A/B testing data
+ *   shared_conversations.json — Publicly shared conversations
+ *   message_feedback.json — Thumbs up/down on messages
+ *   chat.html           — HTML render of conversations
+ *
+ * Detection:
+ *   - SAVESTATE_CHATGPT_EXPORT env var → path to export directory or zip
+ *   - chatgpt-export/ or conversations.json in cwd
+ *   - .savestate/imports/chatgpt/ extracted export
+ *
+ * Restore is partial — ChatGPT has no public API for importing
+ * conversations. Generates chatgpt-restore-guide.md with data
+ * for manual re-entry.
+ */
+import type { Adapter, PlatformMeta, Snapshot } from '../types.js';
+export declare class ChatGPTAdapter implements Adapter {
+    readonly id = "chatgpt";
+    readonly name = "ChatGPT";
+    readonly platform = "chatgpt";
+    readonly version = "0.1.0";
+    private exportDir;
+    private warnings;
+    detect(): Promise<boolean>;
+    extract(): Promise<Snapshot>;
+    restore(snapshot: Snapshot): Promise<void>;
+    identify(): Promise<PlatformMeta>;
+    /**
+     * Resolve the export directory path from env var, cwd, or .savestate/imports/.
+     * Returns null if no valid export is found.
+     */
+    private resolveExportPath;
+    /**
+     * Check if a directory contains ChatGPT export files.
+     */
+    private hasExportFiles;
+    /**
+     * Safely read and parse a JSON file from the export directory.
+     */
+    private readJsonFile;
+    /**
+     * Read user.json for profile metadata.
+     */
+    private readUserJson;
+    /**
+     * Read custom_instructions.json and build personality string.
+     */
+    private readCustomInstructions;
+    /**
+     * Read memories.json into MemoryEntry array.
+     */
+    private readMemories;
+    /**
+     * Read conversations.json, walk tree structures, and produce metadata + entries.
+     */
+    private readConversations;
+    /**
+     * Walk the conversation tree (mapping) and produce a linear list of messages.
+     *
+     * Algorithm:
+     * 1. Find root node (parent is null or missing)
+     * 2. Walk children depth-first
+     * 3. When a node has multiple children (branching = user edited), take the last branch
+     * 4. Skip null/system messages without content
+     * 5. Collect messages in order
+     */
+    private walkConversationTree;
+    /**
+     * Recursively collect messages by walking the tree depth-first.
+     * For branches (multiple children), take the last child (most recent edit/branch).
+     */
+    private collectMessages;
+    /**
+     * Extract a Message from a ChatGPT message node.
+     * Returns null if the message should be skipped (system, empty, etc.)
+     */
+    private extractMessage;
+    /**
+     * Extract text from ChatGPT content structure.
+     * Handles content_type: "text", "code", "tether_browsing_display", etc.
+     */
+    private extractContent;
+    /**
+     * Build the chatgpt-restore-guide.md content.
+     */
+    private buildRestoreGuide;
+    /**
+     * Build a standalone memories document.
+     */
+    private buildMemoriesDoc;
+    /**
+     * Build a standalone custom instructions document.
+     */
+    private buildInstructionsDoc;
+    private log;
+    private warn;
+    /**
+     * Simple string hash for generating IDs when conversation_id is missing.
+     */
+    private hashString;
+}
+//# sourceMappingURL=chatgpt.d.ts.map

package/dist/adapters/chatgpt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatgpt.d.ts","sourceRoot":"","sources":["../../src/adapters/chatgpt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,QAAQ,EAKT,MAAM,aAAa,CAAC;AAkFrB,qBAAa,cAAe,YAAW,OAAO;IAC5C,QAAQ,CAAC,EAAE,aAAa;IACxB,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,QAAQ,aAAa;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,QAAQ,CAAgB;IAE1B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAK1B,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;IAwH5B,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA8C1C,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAUvC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAmDzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;YACW,YAAY;IAa1B;;OAEG;YACW,YAAY;IAc1B;;OAEG;YACW,sBAAsB;IA2BpC;;OAEG;YACW,YAAY;IAqB1B;;OAEG;YACW,iBAAiB;IAsF/B;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAwBvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAyCtB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAwCtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuFzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,IAAI;IAIZ;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB"}