indelible-mcp 3.9.0 → 4.1.0

package/README.md

@@ -67,19 +67,23 @@ indelible-mcp hook post-compact  Post-compaction restore hook
 ## How It Works
 
 1. Your conversation is encrypted locally with your WIF key
-2. An OP_RETURN transaction is built and signed locally using `@bsv/sdk`
-3. The signed transaction is broadcast via Indelible's SPV bridge
-4. Your private key **never** leaves your machine
+2. A minimal OP_RETURN transaction is built containing only `{protocol, encrypted}` — no metadata leaks
+3. The signed transaction is broadcast via Indelible's federation bridges
+4. Session metadata is automatically indexed across all federation bridges for fast retrieval
+5. Your private key **never** leaves your machine
 
 ## Federation
 
 Indelible uses a multi-seed architecture — your saves and loads automatically try multiple federation bridges. If one bridge is down, the next picks up. No single point of failure.
 
+Bridges sync session metadata via SessionRelay (WebSocket peer-to-peer), so all your sessions are available from any bridge in the mesh. The web app and CLI read from bridges first, with blockchain fallback.
+
 The federation mesh is powered by [Relay Federation](https://github.com/zcoolz/relay-federation).
 
 ## Security
 
 - **Zero-knowledge encryption** - your WIF-derived AES-256-GCM key encrypts all data before it touches the network
+- **Privacy-hardened transactions** - OP_RETURN contains only `{protocol, encrypted}` — no plaintext metadata on-chain
 - **Self-sovereign keys** - generated locally with `@bsv/sdk`, never transmitted
 - **Immutable storage** - once on BSV, your data cannot be altered or deleted
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "indelible-mcp",
-  "version": "3.9.0",
+  "version": "4.1.0",
   "description": "Blockchain-backed memory and code storage for Claude Code. Save AI conversations and source code permanently on BSV.",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -13,6 +13,7 @@
  */
 
 import { createInterface } from 'node:readline'
+import { execSync } from 'node:child_process'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
 import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs'
@@ -30,6 +31,7 @@ import { updateVaultIndex } from './tools/update_vault_index.js'
 import { diaryConnect } from './tools/diary_connect.js'
 import { diaryChat } from './tools/diary_chat.js'
 import { diarySave } from './tools/diary_save.js'
+import * as spv from './lib/spv.js'
 
 const CONTEXT_FILE = join(homedir(), '.indelible', 'indelible-context.jsonl')
 
@@ -254,7 +256,7 @@ Commands:
 
 function printHelp() {
   console.log(`
-Indelible MCP — Blockchain memory for Claude Code (v3.9.0)
+Indelible MCP — Blockchain memory for Claude Code (v4.1.0)
 
 Setup:
   indelible-mcp setup --wif=KEY --pin=PIN    Import and encrypt your private key
@@ -466,7 +468,7 @@ function readStdin() {
 
 const SERVER_INFO = {
   name: 'indelible',
-  version: '3.9.0',
+  version: '4.1.0',
   description: 'Blockchain-backed memory and code storage for Claude Code'
 }
 
@@ -732,6 +734,258 @@ async function runMcpServer() {
   }
 }
 
+// ============ SETUP WIZARD ============
+
+async function runWizard() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout })
+  const ask = (q) => new Promise(resolve => rl.question(q, resolve))
+
+  console.log('\n  Welcome to Indelible!\n')
+  console.log('  This wizard will set everything up for you.\n')
+
+  // Check existing config — run health check or resume wizard
+  let config = null
+  try { config = await loadConfig() } catch {}
+
+  if (config && config.address) {
+    // Run health check
+    console.log('  Checking your setup...\n')
+    let allGood = true
+
+    // Claude Code
+    try {
+      execSync('claude --version', { stdio: 'pipe' })
+      console.log('  ✓ Claude Code installed')
+    } catch {
+      console.log('  ✗ Claude Code not found')
+      allGood = false
+    }
+
+    // MCP registered
+    const claudeSettings = join(homedir(), '.claude', 'settings.json')
+    let mcpOk = false
+    try {
+      const s = JSON.parse(readFileSync(claudeSettings, 'utf8'))
+      mcpOk = !!s?.mcpServers?.indelible
+    } catch {}
+    console.log(mcpOk ? '  ✓ MCP registered with Claude Code' : '  ✗ MCP not registered')
+    if (!mcpOk) allGood = false
+
+    // Hooks installed
+    const hooksPath = join(homedir(), '.claude', 'settings.local.json')
+    let hooksOk = false
+    try {
+      const s = JSON.parse(readFileSync(hooksPath, 'utf8'))
+      hooksOk = s?.hooks?.PreCompact?.some(h =>
+        h.hooks?.some(hh => hh.command?.includes('indelible-mcp')) ||
+        h.command?.includes('indelible-mcp')
+      ) && s?.hooks?.SessionStart?.some(h =>
+        h.hooks?.some(hh => hh.command?.includes('indelible-mcp')) ||
+        h.command?.includes('indelible-mcp')
+      )
+    } catch {}
+    console.log(hooksOk ? '  ✓ Auto-save hooks installed' : '  ✗ Auto-save hooks missing')
+    if (!hooksOk) allGood = false
+
+    // Wallet
+    console.log(`  ✓ Wallet configured (${config.address})`)
+
+    // Funded
+    let funded = false
+    try {
+      const utxos = await spv.getUtxos(config.address)
+      if (utxos && utxos.length > 0) {
+        const total = utxos.reduce((sum, u) => sum + u.satoshis, 0)
+        console.log(`  ✓ Wallet funded (${total} sats)`)
+        funded = true
+      } else {
+        console.log('  ✗ Wallet not funded')
+        allGood = false
+      }
+    } catch {
+      console.log('  ✗ Could not check balance')
+      allGood = false
+    }
+
+    // Style
+    const hasStyle = !!config.style_txid
+    console.log(hasStyle ? '  ✓ AI style saved' : '  ✗ No AI style chosen')
+    if (!hasStyle) allGood = false
+
+    // API reachable
+    try {
+      const res = await fetch('https://indelible.one/api/health')
+      console.log(res.ok ? '  ✓ API reachable' : '  ✗ API unreachable')
+      if (!res.ok) allGood = false
+    } catch {
+      console.log('  ✗ API unreachable')
+      allGood = false
+    }
+
+    console.log('')
+
+    if (allGood) {
+      console.log('  Everything looks good! Open Claude Code in VS Code and start coding.\n')
+      rl.close()
+      return
+    }
+
+    // Resume wizard at the right point
+    if (!funded) {
+      console.log('  Resuming setup — your wallet needs funding.\n')
+      // Fall through to balance polling below
+    } else if (!hasStyle) {
+      console.log('  Resuming setup — pick your AI style.\n')
+      // Skip to style selection (fall through, balance polling will pass instantly)
+    } else {
+      // Something else failed (hooks, MCP, etc) — try to fix
+      if (!mcpOk) {
+        console.log('  Fixing: registering MCP with Claude Code...')
+        try {
+          execSync('claude mcp add indelible -- indelible-mcp', { stdio: 'pipe' })
+          console.log('  ✓ MCP registered\n')
+        } catch {
+          console.log('  Run this yourself: claude mcp add indelible -- indelible-mcp\n')
+        }
+      }
+      if (!hooksOk) {
+        console.log('  Fixing: installing auto-save hooks...')
+        installHooks()
+        console.log('  ✓ Hooks installed\n')
+      }
+      rl.close()
+      return
+    }
+  } else {
+    // Fresh install — run full wizard
+
+    // Check for Claude Code
+    try {
+      execSync('claude --version', { stdio: 'pipe' })
+      console.log('  ✓ Claude Code found\n')
+    } catch {
+      console.log('  Claude Code not found. Installing...\n')
+      try {
+        execSync('npm install -g @anthropic-ai/claude-code', { stdio: 'inherit' })
+        console.log('\n  ✓ Claude Code installed\n')
+      } catch {
+        console.log('\n  Could not install Claude Code automatically.')
+        console.log('  Run this yourself: npm install -g @anthropic-ai/claude-code')
+        console.log('  Then run indelible-mcp again.\n')
+        rl.close()
+        return
+      }
+    }
+
+    // Ask for WIF
+    console.log('  Next: connect your wallet.\n')
+    console.log('  Go to https://indelible.one → Sign in → Settings → copy your Private Key (WIF)\n')
+    const wifInput = await ask('  Paste your WIF here: ')
+    if (!wifInput || !wifInput.trim()) {
+      console.log('  No WIF provided. Run indelible-mcp again when ready.\n')
+      rl.close()
+      return
+    }
+
+    // Ask for PIN
+    console.log('')
+    const pinInput = await ask('  Choose a PIN (min 4 characters — you\'ll need this to unlock): ')
+    if (!pinInput || pinInput.trim().length < 4) {
+      console.log('  PIN must be at least 4 characters. Run indelible-mcp again.\n')
+      rl.close()
+      return
+    }
+
+    // Run setupWallet
+    console.log('\n  Setting up wallet...')
+    const result = await setupWallet(undefined, wifInput.trim(), pinInput.trim())
+    if (!result.success) {
+      console.log(`  Error: ${result.error || result.message}\n`)
+      rl.close()
+      return
+    }
+    console.log('  ✓ Wallet configured\n')
+
+    // Register MCP with Claude Code
+    console.log('  Registering Indelible with Claude Code...')
+    try {
+      execSync('claude mcp add indelible -- indelible-mcp', { stdio: 'pipe' })
+      console.log('  ✓ MCP registered\n')
+    } catch {
+      console.log('  Could not register automatically.')
+      console.log('  Run this yourself: claude mcp add indelible -- indelible-mcp\n')
+    }
+
+    config = await loadConfig()
+  }
+  // Check if already funded — skip polling if so
+  let alreadyFunded = false
+  try {
+    const utxos = await spv.getUtxos(config.address)
+    if (utxos && utxos.length > 0) alreadyFunded = true
+  } catch {}
+
+  if (!alreadyFunded) {
+    console.log(`  Your BSV address: ${config.address}`)
+    console.log('  Send BSV to this address to fund your wallet.')
+    console.log('  Each save costs less than $0.01 — even $1 gets you hundreds of saves.\n')
+    console.log('  Waiting for funds...')
+
+    while (true) {
+      try {
+        const utxos = await spv.getUtxos(config.address)
+        if (utxos && utxos.length > 0) {
+          const total = utxos.reduce((sum, u) => sum + u.satoshis, 0)
+          console.log(`\n  ✓ Funded! Balance: ${total} sats\n`)
+          break
+        }
+      } catch {}
+      await new Promise(r => setTimeout(r, 10000))
+      process.stdout.write('.')
+    }
+  }
+
+  // Choose AI style — skip if already saved
+  if (!config.style_txid) {
+    console.log('  Last step — choose how your AI behaves:\n')
+    console.log('  1. Strict        — Confirm everything. Never assume. Never get creative.')
+    console.log('  2. Collaborative — Suggest ideas but wait for approval before coding.')
+    console.log('  3. Autonomous    — Move fast. Fix what you see. Commit when ready.\n')
+
+    const styleChoice = await ask('  Pick 1, 2, or 3 (recommended: 1): ')
+    const styleMap = { '1': 'strict', '2': 'collaborative', '3': 'autonomous' }
+    const styleName = styleMap[styleChoice?.trim()] || 'strict'
+
+    console.log(`\n  Saving "${styleName}" style to blockchain...`)
+    try {
+      const presetRes = await fetch('https://indelible.one/api/styles/presets/' + styleName)
+      if (presetRes.ok) {
+        const preset = await presetRes.json()
+        const rulesText = preset.rules.map((r, i) => `${i + 1}. ${r}`).join('\n')
+        const styleResult = await saveStyle(rulesText, preset.name, preset.description)
+        if (styleResult.success) {
+          console.log(`  ✓ Style saved to blockchain (tx: ${styleResult.txId.slice(0, 8)}...)\n`)
+        } else {
+          console.log(`  Warning: ${styleResult.error}\n`)
+        }
+      }
+    } catch (e) {
+      console.log(`  Warning: Could not save style — ${e.message}\n`)
+    }
+  }
+
+  console.log('  =========================================')
+  console.log('  You\'re all set! Open Claude Code in VS Code and start coding.')
+  console.log('')
+  console.log('  Quick commands to tell your AI:')
+  console.log('    "Save this session to blockchain"')
+  console.log('    "Load my previous context"')
+  console.log('    "Delta save"')
+  console.log('  =========================================\n')
+
+  rl.close()
+}
+
 // ============ MAIN ============
 
 const args = process.argv.slice(2)
@@ -765,5 +1019,5 @@ Add this to your Claude Code settings.json:
   // No args, piped stdin = MCP server mode
   runMcpServer().catch(console.error)
 } else {
-  printHelp()
+  runWizard().catch(e => { console.error('Error:', e.message); process.exit(1) })
 }

package/src/tools/load_context.js

@@ -9,6 +9,7 @@
  */
 
 import { readFileSync, existsSync } from 'node:fs'
+import { gunzipSync } from 'node:zlib'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
 import { Transaction } from '@bsv/sdk'
@@ -21,6 +22,16 @@ import { loadStyle } from './load_style.js'
 const RECENT_MESSAGES_FULL = 25
 const OLDER_MESSAGES_SUMMARIZED = 15
 
+/** Decrypt and optionally gunzip a session payload (handles gz: prefix) */
+function decryptSession(encrypted, wif) {
+  const text = decrypt(encrypted, wif)
+  if (text.startsWith('gz:')) {
+    const buf = gunzipSync(Buffer.from(text.slice(3), 'base64'))
+    return JSON.parse(buf.toString('utf8'))
+  }
+  return JSON.parse(text)
+}
+
 function mergeDeltaSessions(sessions) {
   if (sessions.length === 0) return sessions
   const ordered = [...sessions].reverse()
@@ -195,7 +206,7 @@ export async function loadContext(numSessions = 5) {
       for (const entry of recent) {
         try {
           if (entry.encrypted) {
-            const data = JSON.parse(decrypt(entry.encrypted, wif))
+            const data = decryptSession(entry.encrypted, wif)
             decrypted.push(data)
           }
         } catch { /* skip sessions that fail to decrypt */ }
@@ -240,12 +251,12 @@ export async function loadContext(numSessions = 5) {
       for (const session of sessions) {
         try {
           if (session.encrypted) {
-            const data = JSON.parse(decrypt(session.encrypted, wif))
+            const data = decryptSession(session.encrypted, wif)
             decrypted.push(data)
           } else if (session.txId) {
             const encrypted = await fetchEncryptedFromChain(session.txId)
             if (encrypted) {
-              const data = JSON.parse(decrypt(encrypted, wif))
+              const data = decryptSession(encrypted, wif)
               decrypted.push(data)
             }
           }

package/src/tools/load_file.js

@@ -4,6 +4,7 @@
  * Supports v1 (plaintext metadata) and v2 (encrypted metadata).
  */
 
+import { gunzipSync } from 'node:zlib'
 import { writeFileSync } from 'node:fs'
 import { dirname } from 'node:path'
 import { mkdirSync, existsSync } from 'node:fs'
@@ -72,8 +73,10 @@ export async function loadFile(txId, options = {}) {
         }
       }
       content = decrypt(encryptedFull, wif)
+      if (content.startsWith('gz:')) content = gunzipSync(Buffer.from(content.slice(3), 'base64')).toString('utf8')
     } else {
       content = decrypt(payload.encrypted, wif)
+      if (content.startsWith('gz:')) content = gunzipSync(Buffer.from(content.slice(3), 'base64')).toString('utf8')
     }
 
     // Decrypt metadata (v2) or use plaintext (v1)

package/src/tools/save_file.js

@@ -4,6 +4,7 @@
  * On-chain: only encrypted data, no plaintext filenames.
  */
 
+import { gzipSync } from 'node:zlib'
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'
 import { basename, join } from 'node:path'
 import { homedir } from 'node:os'
@@ -40,8 +41,9 @@ export async function saveFile(filePath, options = {}) {
   const filename = basename(filePath)
   const relativePath = options.relativePath || filePath
 
-  // Encrypt content and metadata
-  const encrypted = encrypt(content, wif)
+  // Gzip compress then encrypt content
+  const compressed = gzipSync(Buffer.from(content))
+  const encrypted = encrypt('gz:' + compressed.toString('base64'), wif)
   const filenameEnc = encrypt(filename, wif)
   const pathEnc = encrypt(relativePath, wif)
 

package/src/tools/save_session.js

@@ -14,6 +14,7 @@
  */
 
 import { readFileSync, writeFileSync, existsSync, statSync, mkdirSync, readdirSync } from 'node:fs'
+import { gzipSync } from 'node:zlib'
 import { dirname, join } from 'node:path'
 import { homedir } from 'node:os'
 import { execSync } from 'node:child_process'
@@ -534,7 +535,8 @@ export async function saveSession(transcriptPath, summary) {
   if (estimatedFee > COST_WARNING_SATS) {
     process.stderr.write(`[indelible] WARNING: Estimated cost ~${estimatedFee} sats (~$${(estimatedFee / 1e8 * 15).toFixed(2)}). Rich mode is ${richMode ? 'ON' : 'OFF'}. Set "rich_saves": false in config to reduce cost.\n`)
   }
-  const encrypted = encrypt(sessionJson, wif)
+  const compressed = gzipSync(Buffer.from(sessionJson))
+  const encrypted = encrypt('gz:' + compressed.toString('base64'), wif)
 
   // Build the blockchain payload
   const payload = {