indelible-mcp 5.7.0 → 5.7.2

package/CLI_HANDBOOK.md

@@ -25,6 +25,32 @@ You don't have to memorize any of this. In Claude Code you can just say what you
 
 Three things worth knowing, once: **your key stays on your machine** (nothing we run ever sees it) · **reading is always free** (saves cost fractions of a cent in Bitcoin fees) · **your stop button beats everything** (pause works even with no wallet at all).
 
+## Honest Receipts + the Wallet (5.7.0)
+
+**"Committed" now means mined.** A fresh save reports `pending` until a miner buries it in a block
+(usually within about ten minutes), then confirms on its own. Your data still broadcasts in seconds;
+only the word got stricter. No server's acceptance — including ours — is ever reported as
+confirmation anymore.
+
+**Double-spends are final the first time the network says so.** If two of your machines ever race
+for the same coin, the losing save is told the truth immediately and rebuilds on fresh coins,
+instead of being retried until something said yes.
+
+**The wrong-key guard.** If your config ever holds a key that does not match your account address,
+every save refuses before any money moves and names both addresses, because data written with the
+wrong key can never be read back by your wallet.
+
+### `indelible-mcp wallet`
+Shows every coin reservation your wallet is holding: which process holds it, whether that process is
+alive, and what it has locked. If a crashed process left a stuck reservation, free it with
+`indelible-mcp wallet --cancel=<token-prefix>`. It refuses to cancel anything a live process still
+holds, and anything with a signed transaction attached — freeing those is how double-spends happen,
+so it structurally cannot.
+
+### Background auto-save
+Runs every 15 minutes by default on every install. Change the pace on the MCP tab at indelible.one —
+your machine picks the new setting up automatically.
+
 ## Two Pilots (5.2.0)
 
 Indelible works with Claude Code, with OpenAI's Codex CLI, or with both at once on the same memory.

package/CUSTOMER_AGENT_HANDBOOK.md

@@ -192,6 +192,15 @@ This fetches the pack and backfills meaning-vectors for your existing history. I
 
 **`diary_recall`** is the same power scoped to your companion's own history. `scope: "diary"` for saved diary entries, `"duo"` for live Claude-plus-companion rounds, `"all"` for both.
 
+### Honest receipts (5.7.0)
+
+A save now reports `pending` until a miner buries it in a block, then it becomes `committed` on its
+own. Nothing — not our servers, not a relay — can call your save confirmed anymore. Only the chain
+can. If a save ever loses a race to another machine spending the same coin, you are told the truth
+immediately and the save rebuilds itself on fresh coins. And if your configuration ever holds a key
+that does not belong to your account, saving refuses before any money moves, because data written
+under the wrong key is data your wallet can never read back.
+
 ### Two pilots on one memory (5.2.0)
 
 Your memory is not tied to one AI. Wire OpenAI's Codex CLI to the same install (`~/.codex/config.toml` → `[mcp_servers.indelible]` `command = "indelible-mcp"`) and it reads and writes the same chain as Claude Code. Every save is stamped with its author inside the encrypted record; the Context tab on indelible.one shows `Saved by Claude` or `Saved by Codex` once your record decrypts, and if an index ever claims a different author than your decrypted record proves, the app shows you both values and trusts neither.

package/LICENSE

@@ -11,7 +11,7 @@ Additional Use Grant: You may make use of the Licensed Work for personal,
                       commercial blockchain storage, session saving, or
                       encrypted vault service without written permission
                       from the Licensor.
-Change Date:          August 13, 2030
+Change Date:          August 14, 2030
 Change License:       MIT License
 
 Terms

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "indelible-mcp",
-  "version": "5.7.0",
+  "version": "5.7.2",
   "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

@@ -3122,7 +3122,12 @@ function appendReceipt(receipt, meta = {}) {
       // has the IDE shown this entry yet?
     };
     appendFileSync(LOG, JSON.stringify(entry) + "\n");
-  } catch {
+  } catch (e) {
+    try {
+      process.stderr.write(`[save-log] \u26A0\uFE0F could not record receipt for ${String(receipt.txid).slice(0, 12)}\u2026 (${e.message}) \u2014 the save is on chain, but this receipt is not in the local ledger; reconciliation by content may be needed later
+`);
+    } catch {
+    }
   }
 }
 var DIR2, LOG;
@@ -9098,7 +9103,7 @@ function makeHeartbeat(cfg2) {
     }
     return set;
   };
-  const emit = async (kind, payload2, parents, entryEpoch) => {
+  const emit2 = async (kind, payload2, parents, entryEpoch) => {
     const ikBasis = digest2(DIGEST_DOMAINS.event, canonicalize2({ me, kind, payload: payload2, parents }));
     const ev = makeEvent({
       event_kind: kind,
@@ -9148,7 +9153,7 @@ function makeHeartbeat(cfg2) {
     for (const pe of peerEvents) {
       const reply = cfg2.respond?.(pe);
       if (reply) {
-        const r = await emit(reply.kind, reply.payload, [pe.event_id], epoch);
+        const r = await emit2(reply.kind, reply.payload, [pe.event_id], epoch);
         if (r.published) {
           cfg2.onLine?.(`[${me}] \u2192 ${reply.line ?? reply.kind} (answering ${pe.actor.host})`);
           reacted = { to: pe.event_id, emitted: r.event_id };
@@ -9166,7 +9171,7 @@ function makeHeartbeat(cfg2) {
     if (!reacted) {
       const move = cfg2.generate?.();
       if (move) {
-        const r = await emit(move.kind, move.payload, [], epoch);
+        const r = await emit2(move.kind, move.payload, [], epoch);
         if (r.published) {
           cfg2.onLine?.(`[${me}] \u270E ${move.line ?? move.kind}`);
           generated = r.event_id;
@@ -11028,14 +11033,18 @@ async function saveFile(filePath, options = {}) {
       timestamp
     });
     await saveConfig({ ...config2, file_txids: files });
+    let indexed = false;
     try {
       const apiUrl = config2.api_url || "https://indelible.one";
-      await fetch(`${apiUrl}/api/files/index`, {
+      const ir = await fetch(`${apiUrl}/api/files/index`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ address: config2.address, txId: masterTxId, filename, path: relativePath, size: fileSize, contentHash: `sha256:${contentHash}`, timestamp })
+        body: JSON.stringify({ address: config2.address, txId: masterTxId, filename, path: relativePath, size: fileSize, contentHash: `sha256:${contentHash}`, timestamp }),
+        signal: AbortSignal.timeout(5e3)
       });
+      indexed = !!(ir && ir.ok);
     } catch {
+      indexed = false;
     }
     const chunkCount = encrypted.length <= MAX_CHUNK_SIZE ? 1 : Math.ceil(encrypted.length / MAX_CHUNK_SIZE);
     const receipt = buildReceipt(_finalWrite, { txId: masterTxId, fee: _saveFee, txSize: _finalSize });
@@ -11049,6 +11058,8 @@ async function saveFile(filePath, options = {}) {
       contentHash: `sha256:${contentHash}`,
       chunks: chunkCount,
       changeUtxos: finalChangeUtxos,
+      indexed,
+      // QA 94701: file-save receipts now report index state, like session saves already do
       receipt,
       message: `File "${filename}" saved to blockchain.${chunkCount > 1 ? ` (${chunkCount} chunks)` : ""}
 
@@ -14176,7 +14187,7 @@ var err5 = (code, msg) => {
   return e;
 };
 var ROLES = ["propose", "attack", "arbitrate"];
-async function conveneChamber({ scope, seats, task, context = "", provider = "anthropic", model, client, chamber_id, emit = true } = {}) {
+async function conveneChamber({ scope, seats, task, context = "", provider = "anthropic", model, client, chamber_id, emit: emit2 = true } = {}) {
   if (!task || typeof task !== "string") throw err5("CHAMBER_ARGS", "task is required");
   if (!Array.isArray(seats) || seats.length !== 3) throw err5("CHAMBER_SEATS", "a chamber seats exactly three: propose, attack, arbitrate");
   const byRole = {};
@@ -14196,7 +14207,7 @@ async function conveneChamber({ scope, seats, task, context = "", provider = "an
   }
   const idSeed = `${task}|${byRole.propose},${byRole.attack},${byRole.arbitrate}`;
   const id = chamber_id || `chamber-${Math.abs([...idSeed].reduce((h, c) => h * 31 + c.charCodeAt(0) | 0, 7))}`;
-  const court = emit ? beginCourt({ court_id: id, domain: "chamber", mode: "single", label: task.slice(0, 100) }) : null;
+  const court = emit2 ? beginCourt({ court_id: id, domain: "chamber", mode: "single", label: task.slice(0, 100) }) : null;
   const rounds = [];
   const run = (name, roundTask, roundContext) => runCustomAgent({ scope, name, task: roundTask, context: roundContext, provider, model, client });
   const p = await run(byRole.propose, task, context);
@@ -15083,6 +15094,11 @@ function runPreToolUseGuard() {
   }
   process.exit(code);
 }
+function emit(result) {
+  console.log(JSON.stringify(result, null, 2));
+  if (result && result.success === false) process.exitCode = 1;
+  return result;
+}
 async function runCli(args2) {
   const command = args2[0];
   switch (command) {
@@ -15149,7 +15165,7 @@ async function runCli(args2) {
       const summaryIdx = args2.indexOf("--summary");
       const summary = summaryIdx !== -1 ? args2.slice(summaryIdx + 1).join(" ") : void 0;
       const result = await saveSession(CONTEXT_FILE2, summary);
-      console.log(JSON.stringify(result, null, 2));
+      emit(result);
       break;
     }
     case "load": {
@@ -15185,20 +15201,22 @@ async function runCli(args2) {
         const filePath = args2[2];
         if (!filePath) {
           console.error("Usage: indelible-mcp vault save-file <path>");
+          process.exitCode = 1;
           break;
         }
         const result = await saveFile(filePath);
-        console.log(JSON.stringify(result, null, 2));
+        emit(result);
       } else if (subCmd === "save-project") {
         const dirPath = args2[2];
         if (!dirPath) {
           console.error("Usage: indelible-mcp vault save-project <dir>");
+          process.exitCode = 1;
           break;
         }
         const nameArg = args2.find((a) => a.startsWith("--name="));
         const name = nameArg ? nameArg.split("=")[1] : void 0;
         const result = await saveProject(dirPath, { name });
-        console.log(JSON.stringify(result, null, 2));
+        emit(result);
       } else if (subCmd === "load-file") {
         const txId = args2[2];
         if (!txId) {
@@ -15208,7 +15226,7 @@ async function runCli(args2) {
         const outArg = args2.find((a) => a.startsWith("--output="));
         const outputPath = outArg ? outArg.split("=")[1] : void 0;
         const result = await loadFile(txId, { outputPath });
-        console.log(JSON.stringify(result, null, 2));
+        emit(result);
       } else if (subCmd === "load-project") {
         const txId = args2[2];
         if (!txId) {
@@ -15218,7 +15236,7 @@ async function runCli(args2) {
         const outArg = args2.find((a) => a.startsWith("--output-dir="));
         const outputDir = outArg ? outArg.split("=")[1] : void 0;
         const result = await loadProject(txId, { outputDir });
-        console.log(JSON.stringify(result, null, 2));
+        emit(result);
       } else if (subCmd === "save-style") {
         const filePath = args2[2];
         const nameArg = args2.find((a) => a.startsWith("--name="));
@@ -15232,14 +15250,14 @@ async function runCli(args2) {
           console.error("Usage: indelible-mcp vault save-style <file> [--name=NAME] [--desc=DESC]");
           break;
         }
-        console.log(JSON.stringify(result, null, 2));
+        emit(result);
       } else if (subCmd === "load-style") {
         const txId = args2[2];
         const result = await loadStyle(txId);
         console.log(JSON.stringify(result, null, 2));
       } else if (subCmd === "update-index") {
         const result = await updateVaultIndex();
-        console.log(JSON.stringify(result, null, 2));
+        emit(result);
       } else {
         console.log(`
 Code Vault \u2014 Encrypted code storage on BSV blockchain
@@ -16114,13 +16132,21 @@ Answer THAT message and nothing else \u2014 the wire also carries unrelated conv
   drift ledger [--n=20]                        THE BOOKS: every summoned mind \u2014 when, who, why, how it ended`);
       break;
     }
+    case "version":
+    case "--version":
+    case "-v":
+      console.log(SERVER_INFO.version);
+      break;
     default:
+      if (command) console.error(`\u2717 unknown command: ${command}
+`);
       printHelp();
+      if (command) process.exitCode = 1;
   }
 }
 function printHelp() {
   console.log(`
-Indelible MCP \u2014 Blockchain memory for Claude Code (v5.7.0)
+Indelible MCP \u2014 Blockchain memory for Claude Code (v5.7.2)
 
 Setup:
   indelible-mcp setup --wif=KEY --pin=PIN    Import and encrypt your private key
@@ -16447,7 +16473,7 @@ function readStdin() {
 }
 var SERVER_INFO = {
   name: "indelible",
-  version: "5.7.0",
+  version: "5.7.2",
   description: "Blockchain-backed memory and code storage for Claude Code"
 };
 var TOOLS = [