backstep 0.1.24 → 0.1.25

package/dist/cli.js

@@ -17,7 +17,7 @@ import { snapshotRest } from "./adapters/rest.js";
 const PUSH = /\bgit\b[^;&|]*\bpush\b/;
 import { classifyShell, commandDir, supabaseTarget, touchesDatabase, touchesFirebase, touchesSqlite, touchesSupabase } from "./shell.js";
 import { watchEnd, watchStart } from "./watch.js";
-import { sendActive } from "./telemetry.js";
+import { sendActive, version } from "./telemetry.js";
 import { readFileSync, rmSync } from "node:fs";
 import { loadRules } from "./rules.js";
 import { setup } from "./setup.js";
@@ -315,8 +315,15 @@ async function main() {
         const target = values.version ?? (await checkUpdate()).latest;
         if (!target)
             throw new Error("couldn't reach npm to find the newest version");
+        const was = version();
+        if (!values.json)
+            console.log(`Updating Backstep from ${was} to ${target}… Don't close this terminal until it says it's done (about a minute).`);
         const out = runUpdate(target);
-        console.log(values.json ? JSON.stringify(out) : out.ok ? `Backstep ${out.detail}. Restart Claude Code to use it.` : `Update failed: ${out.detail}`);
+        console.log(values.json
+            ? JSON.stringify(out)
+            : out.ok
+                ? `Backstep is updated to ${target} (you had ${was}). It's safe to close the terminal now. Restart Claude Code to start using ${target}.`
+                : `Backstep couldn't update to ${target}: ${out.detail}. You're still on ${was}, which keeps working.`);
         if (!out.ok)
             process.exitCode = 1;
         return;

package/dist/setup.js

@@ -1,5 +1,5 @@
 import { spawnSync } from "./spawn.js";
-import { cpSync, readFileSync, rmSync } from "node:fs";
+import { cpSync, existsSync, readFileSync, renameSync, rmSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homeDir } from "./store.js";
@@ -24,9 +24,28 @@ function keepCopy() {
     if (run("npm", ["install", "-g", `backstep@${version}`]).ok) {
         return { root: join(run("npm", ["root", "-g"]).out, "backstep"), onPath: true };
     }
-    const modules = join(homeDir(), "app", "node_modules");
-    rmSync(modules, { recursive: true, force: true });
-    cpSync(dirname(ROOT), modules, { recursive: true });
+    // The new copy is made beside the old one, then swapped in: closing the
+    // terminal partway through leaves the old copy whole and working.
+    const app = join(homeDir(), "app");
+    const modules = join(app, "node_modules");
+    const fresh = join(app, "node_modules.new");
+    const old = join(app, "node_modules.old");
+    rmSync(fresh, { recursive: true, force: true });
+    cpSync(dirname(ROOT), fresh, { recursive: true });
+    rmSync(old, { recursive: true, force: true });
+    try {
+        if (existsSync(modules))
+            renameSync(modules, old);
+        renameSync(fresh, modules);
+    }
+    catch {
+        // A file still open (Windows won't move it): copy over the old copy where it is instead.
+        if (!existsSync(modules) && existsSync(old))
+            renameSync(old, modules);
+        cpSync(fresh, modules, { recursive: true, force: true });
+    }
+    rmSync(fresh, { recursive: true, force: true });
+    rmSync(old, { recursive: true, force: true });
     return { root: join(modules, "backstep"), onPath: false };
 }
 const WHERE = `In Supabase, open your project, press Connect at the top, and copy the URI under

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

@@ -1,6 +1,6 @@
 {
   "name": "backstep",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "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.test.tsx

@@ -589,7 +589,16 @@ function updates(on: On, answer: string) {
     toasts.push(e.text)
     return { value: undefined }
   })
-  on('ui.log', () => ({ value: undefined }))
+  const logs: string[] = []
+  const statuses: (string | undefined)[] = []
+  on('ui.log', (_, e) => {
+    logs.push(e.text)
+    return { value: undefined }
+  })
+  on('ui.status', (_, e) => {
+    statuses.push(e.text)
+    return { value: undefined }
+  })
   on('tool.register', (_, e) => ({ value: { tool: `mcp__backstep__${e.name}` } }))
   on('tool.call', { tool: 'AskUserQuestion' }, (_, e) => {
     const questions = (e as unknown as { questions: { question: string }[] }).questions
@@ -600,7 +609,7 @@ function updates(on: On, answer: string) {
   on('session.cwd', () => ({ value: '/repo' }))
   on('session.id', () => ({ value: 's1' }))
   on('tool.call', () => ({ result: {} }))
-  return { runs, toasts, asked }
+  return { runs, toasts, asked, logs, statuses }
 }
 
 // Claude is about to change the database: the moment Backstep asks.
@@ -614,12 +623,17 @@ async function changeDatabase($: Parameters<Parameters<typeof test>[2]>[0], on:
 }
 
 test('a newer version is offered as a session starts, and Update installs it', { options: { cli: CLI } }, async ($, on) => {
-  const { runs, toasts, asked } = updates(on, 'Update')
+  const { runs, toasts, asked, logs, statuses } = updates(on, 'Update')
   await $.session.start({ cwd: '/repo', surface: 'terminal', hasPerson: true } as never)
   await settle()
   expect(asked).toEqual(['Backstep 0.2.0 is out (you have 0.1.2). Update now?'])
   expect(runs.some((r) => r.slice(3).join(' ') === 'update --version 0.2.0 --json')).toBe(true)
-  expect(toasts.at(-1)).toBe('Backstep updated to 0.2.0. Restart Claude Code to use it.')
+  expect(toasts.at(-1)).toBe('Backstep is updated to 0.2.0. Restart Claude Code to use it.')
+  // While it runs it says not to close the terminal; once done, which version it updated to.
+  expect(logs.find((l) => l.includes('Updating Backstep from 0.1.2 to 0.2.0'))).toContain("Don't close this terminal")
+  expect(statuses[0]).toContain("don't close this terminal")
+  expect(statuses.at(-1)).toBeUndefined()
+  expect(logs.at(-1)).toContain('Backstep is updated to 0.2.0 (you had 0.1.2)')
 })
 
 test('Skip this version stops asking about it, and Not now changes nothing', { options: { cli: CLI } }, async ($, on) => {

package/mod/hooks/register.tsx

@@ -661,7 +661,11 @@ async function offerUpdate($: EngineInterface) {
     return
   }
   if (answer !== UPDATE.yes) return
-  $.ui.toast(`Updating Backstep to ${u.latest}…`)
+  // Said where it stays (the conversation) and where it's seen while it runs (the status line).
+  const from = u.current ? ` from ${u.current}` : ''
+  $.ui.log(`${MARK_TEXT} Updating Backstep${from} to ${u.latest}… Don't close this terminal until it says it's done (about a minute).`)
+  $.ui.toast(`Updating Backstep to ${u.latest}. Don't close this terminal until it's done.`, { timeoutMs: 15_000 })
+  $.ui.status(`◀◀ Updating Backstep to ${u.latest}… don't close this terminal`)
   const done = await $.process
     .run(backstep(['update', '--version', u.latest, '--json']), { timeoutMs: 600_000 })
     .catch((err: unknown) => ({ exitCode: 1, stdout: '', stderr: err instanceof Error ? err.message : String(err) }))
@@ -671,7 +675,14 @@ async function offerUpdate($: EngineInterface) {
   } catch {
     // keep the error above
   }
-  $.ui.toast(r.ok ? `Backstep ${r.detail}. Restart Claude Code to use it.` : `Backstep couldn't update: ${r.detail}. Try: npx backstep@latest setup`)
+  $.ui.status(undefined)
+  if (r.ok) {
+    $.ui.log(`${MARK_TEXT} Backstep is updated to ${u.latest}${u.current ? ` (you had ${u.current})` : ''}. It's safe to close the terminal now. Restart Claude Code to start using ${u.latest}.`)
+    $.ui.toast(`Backstep is updated to ${u.latest}. Restart Claude Code to use it.`)
+  } else {
+    $.ui.log(`${MARK_TEXT} Backstep couldn't update to ${u.latest}: ${r.detail}. You're still on ${u.current ?? 'the version you had'}, which keeps working. To try again, run: npx backstep@latest setup`)
+    $.ui.toast(`Backstep couldn't update: ${r.detail}. Try: npx backstep@latest setup`)
+  }
 }
 
 const KEY = 'mcp__backstep__undo_key'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backstep",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "description": "Undo for everything your agents touch: an MCP proxy that makes agent actions reversible.",
   "homepage": "https://getbackstep.com",
   "scripts": {