indelible-mcp 4.9.7 → 4.9.8

package/package.json

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

@@ -1489,6 +1489,13 @@ function appendReceipt(receipt, meta = {}) {
       trigger: meta.trigger || "interactive",
       // interactive | auto (background/hook)
       label: meta.label || null,
+      // g-363 self-reconciling ledger (Ben's ask, 2026-07-16): persist the content
+      // identity so a stranded receipt can ALWAYS be reconciled by content — even
+      // months later, after the 60-min tx-cache has pruned. This is the durable
+      // targetKey for findByContentKey; null for saves with no single content hash
+      // (e.g. session deltas). Cheap to write, and it removes the biggest
+      // "cannot learn content key" unresolvable bucket for good.
+      contentHash: receipt.contentHash ?? receipt.content_hash ?? meta.contentHash ?? null,
       surfaced: false
       // has the IDE shown this entry yet?
     };
@@ -4326,17 +4333,37 @@ function computeMapLayout(dated) {
   };
   const globalTF = /* @__PURE__ */ new Map();
   for (const s of dated) for (const w of grams(s.title)) globalTF.set(w, (globalTF.get(w) || 0) + 1);
-  function nameOf(members, nTerms) {
+  function nameOf(members, nTerms, allowFallback = false) {
     const tf = /* @__PURE__ */ new Map();
     for (const s of members) for (const w of grams(s.title)) tf.set(w, (tf.get(w) || 0) + 1);
-    const scored = [...tf.entries()].filter(([w, f]) => f >= 3).map(([w, f]) => [w, (w.includes(" ") ? 1.6 : 1) * f * f / (globalTF.get(w) || 1)]).sort((a, b) => b[1] - a[1]);
+    const minF = Math.min(3, Math.max(1, Math.round(members.length * 0.2)));
+    const scored = [...tf.entries()].filter(([w, f]) => f >= minF).map(([w, f]) => [w, (w.includes(" ") ? 1.6 : 1) * f * f / (globalTF.get(w) || 1)]).sort((a, b) => b[1] - a[1]);
     const picked = [];
     for (const [w] of scored) {
       if (picked.some((p) => p.includes(w) || w.includes(p))) continue;
       picked.push(w);
       if (picked.length >= nTerms) break;
     }
-    return picked.join(" \xB7 ") || "(misc)";
+    if (picked.length) return picked.join(" \xB7 ");
+    if (!allowFallback) return "(misc)";
+    let best = "";
+    let bestScore = -1;
+    for (const s of members) {
+      let sc = 0;
+      const seen = /* @__PURE__ */ new Set();
+      for (const w of grams(s.title)) {
+        if (!seen.has(w)) {
+          seen.add(w);
+          sc += (tf.get(w) || 0) / (globalTF.get(w) || 1);
+        }
+      }
+      if (sc > bestScore) {
+        bestScore = sc;
+        best = s.title || "";
+      }
+    }
+    const distinct = tok(best).sort((a, b) => (globalTF.get(a) || 1) - (globalTF.get(b) || 1)).slice(0, nTerms);
+    return distinct.length ? distinct.join(" \xB7 ") : "(untitled)";
   }
   const centroidOf = (members) => ({
     cx: members.reduce((a, s) => a + s.x, 0) / (members.length || 1),
@@ -4344,7 +4371,7 @@ function computeMapLayout(dated) {
     cz: members.reduce((a, s) => a + s.z, 0) / (members.length || 1)
   });
   function kmeansLocal(members, k) {
-    if (members.length < k * 25) return null;
+    if (members.length < k * 3) return null;
     const c0 = [members[Math.floor(rnd() * members.length)].v.slice()];
     while (c0.length < k) {
       const d = members.map((s) => Math.min(...c0.map((c) => dist2(s.v, c))));
@@ -4386,7 +4413,12 @@ function computeMapLayout(dated) {
   const subLabels = [];
   for (let c = 0; c < K; c++) {
     const members = dated.filter((s) => s.c === c);
-    const label = nameOf(members, 3);
+    const label = nameOf(
+      members,
+      3,
+      /* allowFallback */
+      true
+    );
     const mDates = members.map((s) => s.date).sort();
     clusterInfo.push({
       c,
@@ -4397,11 +4429,13 @@ function computeMapLayout(dated) {
       last_touched: mDates.length ? mDates[mDates.length - 1].slice(0, 10) : null,
       ...centroidOf(members)
     });
-    const sub = kmeansLocal(members, 3);
+    const subK = members.length >= 30 ? 3 : 2;
+    const subFloor = members.length >= 75 ? 25 : Math.max(4, Math.round(members.length * 0.15));
+    const sub = members.length >= 12 ? kmeansLocal(members, subK) : null;
     if (sub) {
-      for (let sc = 0; sc < 3; sc++) {
+      for (let sc = 0; sc < subK; sc++) {
         const m = members.filter((_, i) => sub[i] === sc);
-        if (m.length < 25) continue;
+        if (m.length < subFloor) continue;
         const sl = nameOf(m, 2);
         if (sl === "(misc)" || sl === label) continue;
         subLabels.push({ label: sl, count: m.length, ...centroidOf(m) });
@@ -4648,8 +4682,8 @@ function draw(){
   const vg=g.createRadialGradient(W/2,H/2,H*0.2,W/2,H/2,Math.max(W,H)*0.75);
   vg.addColorStop(0,'#0e0a07');vg.addColorStop(1,'#070503');g.fillStyle=vg;g.fillRect(0,0,W,H);
   projected=P.map(p=>({p,q:proj(p)}));
-  // time thread
-  g.strokeStyle='rgba(244,168,58,0.04)';g.beginPath();
+  // time thread \u2014 opacity scales with map size (a few segments need more alpha than 5,000)
+  g.strokeStyle='rgba(244,168,58,'+Math.min(0.28,Math.max(0.04,4/P.length))+')';g.beginPath();
   projected.forEach((e,i)=>{i?g.lineTo(e.q.X,e.q.Y):g.moveTo(e.q.X,e.q.Y)});g.stroke();
   // points: crisp everywhere. Heat = the DOT'S OWN color from the density ramp
   // (no additive accumulation \u2014 that both lagged and blew the core out to mush).
@@ -5596,7 +5630,27 @@ async function _run({ dir, key, address, contentKey, build, broadcast, checkConf
   });
   prune(dir, now()).catch((e) => process.stderr.write(`[build-cache] prune failed (non-fatal): ${e?.message}
 `));
-  const write = await broadcast(fresh.txHex);
+  let write;
+  try {
+    write = await broadcast(fresh.txHex);
+  } catch (err) {
+    let seen = null;
+    try {
+      seen = await checkConfirmation2(fresh.txId);
+    } catch {
+    }
+    if (seen && (seen.confirmed || seen.inMempool || seen.exists === true)) {
+      process.stderr.write(`[g-363] broadcast ack failed but ${fresh.txId.slice(0, 12)}\u2026 is on-chain/mempool \u2014 slow-ack recovered, no rival (${err?.message || "timeout"})
+`);
+      return {
+        ...fresh,
+        write: { txid: fresh.txId, via: "chain-verified", source: "slow-ack-recovered", confirmed: !!seen.confirmed },
+        reused: false,
+        alreadyOnChain: true
+      };
+    }
+    throw err;
+  }
   if (write?.txid && fresh.txId && write.txid.toLowerCase() !== fresh.txId.toLowerCase()) {
     process.stderr.write(`[g-363 TRIPWIRE] bridge-computed txid ${write.txid} differs from built txid ${fresh.txId} \u2014 possible transit mutation, receipt kept as built
 `);
@@ -5853,7 +5907,7 @@ async function saveFile(filePath, options = {}) {
     }
     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 });
-    appendReceipt(receipt, { trigger: "interactive", saveType: "file" });
+    appendReceipt(receipt, { trigger: "interactive", saveType: "file", contentHash: `sha256:${contentHash}` });
     return {
       success: true,
       txId: masterTxId,
@@ -7117,22 +7171,25 @@ async function findByContentKey({
   excludeTxids = [],
   maxScan = 400,
   confirmedOnly = false,
-  stopAtFirst = true
+  stopAtFirst = true,
+  matchCap = 10
 }) {
-  if (!address || !targetKey) return { matches: [], scanned: 0, truncated: false };
+  if (!address || !targetKey) return { matches: [], scanned: 0, truncated: false, fetchFailures: 0, classification: "absent" };
   const exclude = new Set(excludeTxids.map((t) => String(t).toLowerCase()));
   let history = [];
   try {
     history = await getHistory(address);
   } catch {
-    return { matches: [], scanned: 0, truncated: false, error: "history-unreachable" };
+    return { matches: [], scanned: 0, truncated: false, fetchFailures: 0, classification: "inconclusive-history-unreachable", error: "history-unreachable" };
   }
-  if (!Array.isArray(history)) return { matches: [], scanned: 0, truncated: false };
+  if (!Array.isArray(history)) return { matches: [], scanned: 0, truncated: false, fetchFailures: 0, classification: "absent" };
   const ordered = [...history].sort((a, b) => (b.height || 0) - (a.height || 0));
   const truncated = ordered.length > maxScan;
   const candidates = ordered.slice(0, maxScan);
   const matches = [];
   let scanned = 0;
+  let fetchFailures = 0;
+  let confirmedFound = false;
   for (const h of candidates) {
     const txid = (h.tx_hash || h.txid || "").toString();
     if (!txid || exclude.has(txid.toLowerCase())) continue;
@@ -7142,23 +7199,62 @@ async function findByContentKey({
     try {
       payload = await fetchPayload(txid);
     } catch {
+      fetchFailures++;
       continue;
     }
     if (payloadContentKey(payload) === targetKey) {
-      matches.push({ txid, height: h.height || null });
-      if (stopAtFirst) break;
+      const height = h.height || null;
+      matches.push({ txid, height });
+      if (height > 0) confirmedFound = true;
+      if (stopAtFirst && confirmedFound) break;
+      if (matches.length >= matchCap) break;
     }
   }
-  return { matches, scanned, truncated };
+  matches.sort((a, b) => {
+    const ac = a.height > 0 ? 1 : 0, bc = b.height > 0 ? 1 : 0;
+    if (ac !== bc) return bc - ac;
+    return (b.height || 0) - (a.height || 0);
+  });
+  const result = stopAtFirst && matches.length ? [matches[0]] : matches;
+  let classification;
+  if (result.length) classification = "found";
+  else if (truncated) classification = "inconclusive-truncated";
+  else if (fetchFailures > 0) classification = "inconclusive-fetch-degraded";
+  else classification = "absent";
+  return { matches: result, scanned, truncated, fetchFailures, classification };
 }
 
 // mcp-server/tools/load_file.js
 var TX_CACHE_DIR3 = join12(homedir12(), ".indelible", "tx-cache");
+var SAVE_LOG_PATH = join12(homedir12(), ".indelible", "save-log.jsonl");
+async function contentKeyFromSaveLog(txid) {
+  try {
+    const raw = await readFile6(SAVE_LOG_PATH, "utf-8");
+    for (const line of raw.split("\n")) {
+      if (!line.trim()) continue;
+      let e;
+      try {
+        e = JSON.parse(line);
+      } catch {
+        continue;
+      }
+      if (e.txid === txid && e.contentHash) return String(e.contentHash).replace(/^sha256:/, "");
+    }
+  } catch {
+  }
+  return null;
+}
 async function healStrandedTxid(strandedTxId, config) {
   try {
+    let targetKey = null;
     const cachedRaw = await readFile6(join12(TX_CACHE_DIR3, `${strandedTxId.trim()}.json`), "utf-8").catch(() => null);
-    if (!cachedRaw) return null;
-    const targetKey = payloadContentKey(JSON.parse(cachedRaw));
+    if (cachedRaw) {
+      try {
+        targetKey = payloadContentKey(JSON.parse(cachedRaw));
+      } catch {
+      }
+    }
+    if (!targetKey) targetKey = await contentKeyFromSaveLog(strandedTxId.trim());
     const address = config?.address;
     if (!targetKey || !address) return null;
     const { matches } = await findByContentKey({
@@ -8502,7 +8598,7 @@ function redactSecrets2(s) {
   return redactCredentials(String(s));
 }
 async function reportBug(args2 = {}, mcpVersion) {
-  const { summary, description, severity = "medium", tool_name = null, last_error = null } = args2;
+  const { summary, description, severity = "medium", tool_name = null, last_error = null, still_file = false } = args2;
   if (!summary || !description) {
     return { success: false, error: "summary and description are required (you supply the narrative; the tool supplies the facts)." };
   }
@@ -8514,6 +8610,10 @@ async function reportBug(args2 = {}, mcpVersion) {
     severity: ["low", "medium", "high"].includes(severity) ? severity : "medium",
     tool_name: tool_name ? String(tool_name).slice(0, 80) : null,
     last_error: redactSecrets2(last_error),
+    // User override: "no, my case is genuinely different." When true, the intake
+    // files a real ticket + pages the team even if the report matches a known,
+    // already-fixed issue — so a false match can never trap a real report.
+    still_file: still_file === true,
     // Machine-pulled facts (the AI cannot get these wrong)
     mcp_version: getMcpVersion(mcpVersion),
     wallet_address: getWalletAddress(config),
@@ -8533,9 +8633,17 @@ async function reportBug(args2 = {}, mcpVersion) {
     }
     const data = await resp.json().catch(() => ({}));
     if (data.known_issue) {
-      return { success: true, status: "known_issue", issue_id: data.issue_id || null, message: data.message || "Matched a known, already-fixed issue." };
+      return {
+        success: true,
+        status: "known_issue",
+        issue_id: data.issue_id || null,
+        message: data.message || "Matched a known, already-fixed issue.",
+        // The team was already notified (the intake never swallows), but if the
+        // narrative describes something genuinely different, the user can escalate.
+        override_hint: "If this does not match your situation, call report_bug again with still_file: true to open a ticket and page the team anyway."
+      };
     }
-    return { success: true, status: "filed", ticket_id: data.ticket_id || null, message: data.message || "Bug report sent to the Indelible team." };
+    return { success: true, status: "filed", ticket_id: data.ticket_id || null, forced: !!data.forced, message: data.message || "Bug report sent to the Indelible team." };
   } catch (err) {
     return { success: false, error: `could not reach intake (${err.message}). Fallback: save_file the report on-chain and share the txid.` };
   }
@@ -9121,7 +9229,7 @@ Commands:
 }
 function printHelp() {
   console.log(`
-Indelible MCP \u2014 Blockchain memory for Claude Code (v4.9.7)
+Indelible MCP \u2014 Blockchain memory for Claude Code (v4.9.8)
 
 Setup:
   indelible-mcp setup --wif=KEY --pin=PIN    Import and encrypt your private key
@@ -9428,7 +9536,7 @@ function readStdin() {
 }
 var SERVER_INFO = {
   name: "indelible",
-  version: "4.9.7",
+  version: "4.9.8",
   description: "Blockchain-backed memory and code storage for Claude Code"
 };
 var TOOLS = [
@@ -9754,7 +9862,8 @@ var TOOLS = [
         description: { type: "string", description: "What you were doing, what went wrong, and exact repro steps." },
         severity: { type: "string", enum: ["low", "medium", "high"], description: "User-facing impact." },
         tool_name: { type: "string", description: "Which Indelible tool/command failed (optional)." },
-        last_error: { type: "string", description: "The exact error string you saw (optional)." }
+        last_error: { type: "string", description: "The exact error string you saw (optional)." },
+        still_file: { type: "boolean", description: "Set true ONLY to override a known-issue match \u2014 files a ticket and pages the team even if the report looks like an already-fixed issue. Use when the user says their case is genuinely different." }
       },
       required: ["summary", "description"]
     }
@@ -9909,7 +10018,8 @@ async function handleMcpRequest(request) {
               description: args2?.description,
               severity: args2?.severity || "medium",
               tool_name: args2?.tool_name || null,
-              last_error: args2?.last_error || null
+              last_error: args2?.last_error || null,
+              still_file: args2?.still_file === true
             });
             break;
           case "share_session":