backstep 0.1.4 → 0.1.5

package/README.md

@@ -53,7 +53,7 @@ With Claude Code: `claude mcp add files -- backstep wrap --name files -- <the se
 | `--rules <file>` | undo rules (or set `BACKSTEP_RULES`) |
 | `--pg <url>` | the Postgres database the wrapped server writes to. Enables database undo. Without it, SQL writes are recorded but can't be undone. |
 
-The undo key is ⌘Z and ctrl+z on a Mac (⌘Z where the terminal passes it on, as Ghostty, Kitty and WezTerm do; Terminal.app and iTerm2 keep ⌘Z for their own menu) and ctrl+z elsewhere. The first press asks "Undo Claude's last turn?" above the prompt and a second press within 5 seconds undoes, so a stray press does nothing. Change the key whenever you like: ask Claude ("change my Backstep undo key to ctrl+u"), or run `backstep key ctrl+u`. The line above the prompt is always there, even with nothing to undo, because the key only reaches Backstep while it's on screen; otherwise ctrl+z would fall through to the terminal and suspend Claude Code.
+The undo key is ctrl+z. The first press asks "Undo Claude's last turn?" above the prompt and a second press within 5 seconds undoes, so a stray press does nothing. Change the key whenever you like: ask Claude ("change my Backstep undo key to ctrl+u"), or run `backstep key ctrl+u`. The line above the prompt is always there, even with nothing to undo, because the key only reaches Backstep while it's on screen; otherwise ctrl+z would fall through to the terminal and suspend Claude Code.
 
 Backstep checks npm for a newer version as each Claude Code session starts and asks before updating (Update, Not now, or Skip this version; `backstep update` does it by hand, `BACKSTEP_UPDATE_CHECK=0` turns the check off).
 

package/dist/keys.js

@@ -8,10 +8,7 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 export const UNDO_ACTION = "app:cycleDiffBase";
 export const DEFAULT_KEY = "ctrl+z";
-// A Mac gets ⌘Z too, where the terminal passes it on (Ghostty, Kitty, WezTerm,
-// Claude Code's desktop app); Terminal.app and iTerm2 keep ⌘Z for their own
-// Edit menu, so ctrl+z stays bound alongside it.
-export const defaultKeys = () => (process.platform === "darwin" ? ["cmd+z", DEFAULT_KEY] : [DEFAULT_KEY]);
+export const defaultKeys = () => [DEFAULT_KEY];
 const CONTEXTS = ["Global", "Chat"];
 // Claude Code never hands these to anything else.
 const RESERVED = new Set(["ctrl+c", "ctrl+d", "ctrl+m", "ctrl+i", "ctrl+h", "ctrl+[", "ctrl+\\"]);

package/dist/setup.js

@@ -29,7 +29,7 @@ function keepCopy() {
     cpSync(dirname(ROOT), modules, { recursive: true });
     return { root: join(modules, "backstep"), onPath: false };
 }
-// Keeps a key the person picked; on a first install binds ⌘Z and ctrl+z on a Mac, ctrl+z elsewhere.
+// Keeps a key the person picked; binds ctrl+z on a first install.
 function bindUndoKey() {
     if (undoKey())
         return "";

package/dist/update.js

@@ -51,17 +51,39 @@ export function skipVersion(v) {
     mkdirSync(homeDir(), { recursive: true });
     writeFileSync(file(), JSON.stringify({ ...settings(), skipVersion: v }, null, 2) + "\n");
 }
+// What went wrong, in a line a person can act on: npm's own reason, not its
+// pointer to a log file.
+export function npmReason(out) {
+    if (/ETARGET|notarget|No matching version/i.test(out))
+        return "npm hasn't finished publishing it yet. Try again in a few minutes";
+    if (/ENOTFOUND|EAI_AGAIN|ECONNREFUSED|ETIMEDOUT|network/i.test(out))
+        return "couldn't reach npm. Check your internet connection";
+    if (/EACCES|permission denied/i.test(out))
+        return "npm wasn't allowed to install it (a permissions problem with npm's global folder)";
+    const lines = out.split("\n").map((l) => l.trim()).filter((l) => l && !/complete log of this run|^npm (error|ERR!)\s*$/i.test(l));
+    return (lines.find((l) => /^backstep:/.test(l)) ?? lines.findLast((l) => /error/i.test(l)) ?? lines.at(-1) ?? "npx failed").replace(/^(backstep:|npm (error|ERR!))\s*/i, "");
+}
+const pause = (ms) => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
 // The new version's setup puts its own copy in place, points Claude Code's mod
-// at it and re-wraps servers, exactly as a fresh install would.
-export function runUpdate(v) {
-    const r = spawnSync("npx", ["-y", `backstep@${v}`, "setup"], {
-        encoding: "utf8",
-        timeout: 5 * 60 * 1000,
-        env: { ...process.env, NO_COLOR: "1", BACKSTEP_TELEMETRY: "0" },
-        stdio: ["ignore", "pipe", "pipe"],
-    });
-    if (r.status === 0)
-        return { ok: true, detail: `updated to ${v}` };
-    const why = `${r.stderr ?? ""}${r.stdout ?? ""}`.trim().split("\n").filter(Boolean).at(-1) ?? "npx failed";
-    return { ok: false, detail: why.replace(/^backstep: /, "") };
+// at it and re-wraps servers, exactly as a fresh install would. npm is asked
+// online, never from its cache, which can be older than a version just
+// published; and asked again for a while if it still hasn't heard of it.
+export function runUpdate(v, tries = 4) {
+    let out = "";
+    for (let i = 0; i < tries; i++) {
+        if (i)
+            pause(15_000);
+        const r = spawnSync("npx", ["-y", "--prefer-online", `backstep@${v}`, "setup"], {
+            encoding: "utf8",
+            timeout: 5 * 60 * 1000,
+            env: { ...process.env, NO_COLOR: "1", BACKSTEP_TELEMETRY: "0" },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        if (r.status === 0)
+            return { ok: true, detail: `updated to ${v}` };
+        out = `${r.stderr ?? ""}\n${r.stdout ?? ""}`;
+        if (!/ETARGET|notarget|No matching version/i.test(out))
+            break;
+    }
+    return { ok: false, detail: npmReason(out) };
 }

package/mod/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "backstep",
-  "version": "0.1.0",
+  "version": "0.1.5",
   "description": "Press ctrl+z to rewind everything Claude did in its last turn: file edits, shell commands, and database and tool changes.",
   "types": "./types/index.d.ts",
   "userConfig": {

package/mod/hooks/register.tsx

@@ -403,7 +403,7 @@ async function offerUpdate($: EngineInterface) {
   if (answer !== UPDATE.yes) return
   $.ui.toast(`Updating Backstep to ${u.latest}…`)
   const done = await $.process
-    .run(backstep(['update', '--version', u.latest, '--json']), { timeoutMs: 300_000 })
+    .run(backstep(['update', '--version', u.latest, '--json']), { timeoutMs: 600_000 })
     .catch((err: unknown) => ({ exitCode: 1, stdout: '', stderr: err instanceof Error ? err.message : String(err) }))
   let r: { ok: boolean; detail: string } = { ok: false, detail: (done.stderr || 'it failed').trim().split('\n').at(-1) ?? 'it failed' }
   try {
@@ -419,7 +419,7 @@ const KEY = 'mcp__backstep__undo_key'
 const KEY_TOOL = {
   name: 'undo_key',
   description:
-    "Change the key that undoes Claude's last turn with Backstep (⌘Z and ctrl+z on a Mac, ctrl+z elsewhere, unless the user changed it). " +
+    "Change the key that undoes Claude's last turn with Backstep (ctrl+z unless the user changed it). " +
     'Use it when the user asks to change, rebind or pick a different Backstep or undo shortcut. ' +
     'Keys are written like ctrl+u, cmd+z (⌘ on a Mac; most Mac terminals keep ⌘ keys for themselves, so pair it with a ctrl key), meta+z (Option) or ctrl+shift+z. ' +
     'Several keys can share undo: separate them with commas. It takes effect right away, no restart.',

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "backstep",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Undo for everything your agents touch: an MCP proxy that makes agent actions reversible.",
   "scripts": {
     "dev": "node src/cli.ts",
     "ui": "node --disable-warning=ExperimentalWarning src/cli.ts ui",
     "demo": "node --disable-warning=ExperimentalWarning examples/demo-db.ts",
-    "build": "tsc -p tsconfig.json && cp src/ui/index.html dist/ui/index.html && chmod +x dist/cli.js",
+    "build": "tsc -p tsconfig.json && cp src/ui/index.html dist/ui/index.html && chmod +x dist/cli.js && node -e \"const f='mod/.claude-plugin/plugin.json',p=JSON.parse(require('fs').readFileSync(f));p.version=require('./package.json').version;require('fs').writeFileSync(f,JSON.stringify(p,null,2)+'\\\\n')\"",
     "test": "node --disable-warning=ExperimentalWarning --test test/*.test.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },