backthread 0.5.0 → 0.5.1

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "backthread",
   "displayName": "Backthread",
   "description": "Backthread helps you understand your codebase while AI ships features. It captures the why behind every Claude Code session so you can ask \"how does X work?\" without digging through PRs.",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "author": {
     "name": "Backthread"
   },

package/dist-bundle/backthread.js

@@ -8333,6 +8333,9 @@ var execFileP = promisify(execFile);
 var MCP_COMMAND = "npx";
 var MCP_ARGS = ["-y", "backthread", "mcp"];
 function hookCommand(agent) {
+  return `npx -y backthread@latest capture --from-hook --agent ${agent} --detach`;
+}
+function legacyHookCommand(agent) {
   return `npx -y backthread capture --from-hook --agent ${agent} --detach`;
 }
 var MIN_VERSION = {
@@ -8382,16 +8385,36 @@ function withMcpServer(settings) {
   mcpServers.backthread = desired;
   return { next: { ...settings, mcpServers }, changed: true };
 }
-function withNestedHook(settings, event, command, extra = {}) {
+function groupRunsCommand(group, command) {
+  const inner = group?.hooks;
+  return Array.isArray(inner) && inner.some((h) => h?.command === command);
+}
+function rewriteLegacyInGroup(group, legacyCommands, command) {
+  const inner = group?.hooks;
+  if (!Array.isArray(inner)) return group;
+  let changed = false;
+  const nextInner = inner.map((h) => {
+    const cmd = h?.command;
+    if (typeof cmd === "string" && cmd !== command && legacyCommands.includes(cmd)) {
+      changed = true;
+      return { ...h, command };
+    }
+    return h;
+  });
+  return changed ? { ...group, hooks: nextInner } : group;
+}
+function withNestedHook(settings, event, command, extra = {}, legacyCommands = []) {
   const hooks = asObject(settings.hooks);
   const list = Array.isArray(hooks[event]) ? [...hooks[event]] : [];
-  const present = list.some((g) => {
-    const inner = g?.hooks;
-    return Array.isArray(inner) && inner.some((h) => h?.command === command);
+  if (list.some((g) => groupRunsCommand(g, command))) return { next: settings, changed: false };
+  let migrated = false;
+  const nextList = list.map((g) => {
+    const rewritten = rewriteLegacyInGroup(g, legacyCommands, command);
+    if (rewritten !== g) migrated = true;
+    return rewritten;
   });
-  if (present) return { next: settings, changed: false };
-  list.push({ hooks: [{ type: "command", command, ...extra }] });
-  hooks[event] = list;
+  if (!migrated) nextList.push({ hooks: [{ type: "command", command, ...extra }] });
+  hooks[event] = nextList;
   return { next: { ...settings, hooks }, changed: true };
 }
 async function writeJson(deps, path, obj) {
@@ -8405,7 +8428,9 @@ async function installGemini(home, deps) {
   const path = join8(home, ".gemini", "settings.json");
   const current = await loadJsonObject(doRead, path);
   const a = withMcpServer(current);
-  const b = withNestedHook(a.next, "SessionEnd", hookCommand("gemini-cli"), { name: "backthread-capture" });
+  const b = withNestedHook(a.next, "SessionEnd", hookCommand("gemini-cli"), { name: "backthread-capture" }, [
+    legacyHookCommand("gemini-cli")
+  ]);
   if (a.changed || b.changed) await writeJson(deps, path, b.next);
   return [{ path, wrote: a.changed || b.changed }];
 }
@@ -8435,7 +8460,7 @@ args = [${MCP_ARGS.map((a) => `"${a}"`).join(", ")}]
   }
   const hooksPath = join8(home, ".codex", "hooks.json");
   const current = await loadJsonObject(doRead, hooksPath);
-  const h = withNestedHook(current, "Stop", hookCommand("codex"), { timeout: 60 });
+  const h = withNestedHook(current, "Stop", hookCommand("codex"), { timeout: 60 }, [legacyHookCommand("codex")]);
   if (h.changed) await writeJson(deps, hooksPath, h.next);
   writes.push({ path: hooksPath, wrote: h.changed });
   return writes;
@@ -8451,7 +8476,8 @@ async function installCursor(home, deps) {
     await writeCursorScript(
       deps,
       captureScriptPath,
-      cursorWrapperScript(nodeBinDir, "capture --from-hook --agent cursor --detach")
+      // capture hook → self-updating (@latest), like the other agents' hooks (ARP-739).
+      cursorWrapperScript(nodeBinDir, "capture --from-hook --agent cursor --detach", true)
     )
   );
   writes.push(await writeCursorScript(deps, mcpScriptPath, cursorWrapperScript(nodeBinDir, "mcp")));
@@ -8470,7 +8496,8 @@ async function installCursor(home, deps) {
 function shSingleQuote(s) {
   return `'${s.replace(/'/g, `'\\''`)}'`;
 }
-function cursorWrapperScript(nodeBinDir, backthreadArgs) {
+function cursorWrapperScript(nodeBinDir, backthreadArgs, latest = false) {
+  const pkg = latest ? "backthread@latest" : "backthread";
   return [
     "#!/bin/sh",
     "# Backthread wrapper for Cursor \u2014 generated by `backthread install --agent cursor` (ARP-692).",
@@ -8489,7 +8516,7 @@ function cursorWrapperScript(nodeBinDir, backthreadArgs) {
     '  PATH="$NODE_BIN_DIR:$PATH"',
     "  export PATH",
     "fi",
-    `exec npx -y backthread ${backthreadArgs}`
+    `exec npx -y ${pkg} ${backthreadArgs}`
   ].join("\n") + "\n";
 }
 async function writeCursorScript(deps, path, content) {
@@ -8523,7 +8550,7 @@ function withCursorMcpServer(settings, mcpScriptPath) {
   return { next: { ...settings, mcpServers }, changed: true };
 }
 function withCursorStopHook(settings, captureScriptPath) {
-  const legacyInline = hookCommand("cursor");
+  const legacyInline = legacyHookCommand("cursor");
   const hooks = asObject(settings.hooks);
   const stop = Array.isArray(hooks.stop) ? [...hooks.stop] : [];
   const hadDesired = stop.some((h) => h?.command === captureScriptPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backthread",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Backthread helps you understand your codebase while AI ships features. The CLI captures the why behind every AI session and lets you ask how your codebase works, right from the terminal.",
   "license": "MIT",
   "author": "Backthread",