backstep 0.1.32 → 0.1.33

package/CHANGES.json

@@ -0,0 +1,41 @@
+[
+  {
+    "version": "0.1.33",
+    "notes": [
+      "After an update, Backstep shows what's new, like this."
+    ]
+  },
+  {
+    "version": "0.1.32",
+    "notes": [
+      "Undoing a Notion change in auto mode now finishes properly when Claude makes the last step.",
+      "Opening a page, file or app is no longer listed as something that couldn't be undone.",
+      "When something can't be undone, Backstep says why in plain words."
+    ]
+  },
+  {
+    "version": "0.1.31",
+    "notes": [
+      "In auto mode, Notion undos are finished by Claude straight away, with no extra question and no red error."
+    ]
+  },
+  {
+    "version": "0.1.30",
+    "notes": [
+      "Updates now say when they're done and it's safe to close the terminal.",
+      "Notion undos work in auto mode."
+    ]
+  },
+  {
+    "version": "0.1.29",
+    "notes": [
+      "If you edited a file after Claude's turn, undo asks before taking your changes along. Keep my changes undoes only Claude's."
+    ]
+  },
+  {
+    "version": "0.1.28",
+    "notes": [
+      "Updates install the new version even when Claude Code is open in a project named backstep."
+    ]
+  }
+]

package/README.md

@@ -70,7 +70,7 @@ The undo key is ctrl+u (not ctrl+z: Claude Code suspends itself on ctrl+z in a t
 
 In the Claude Code desktop app, keys don't reach Backstep, so the line above the message box has an **Undo last turn** button to click instead (it asks once, then undoes). Typing `/backstep-undo` works everywhere and undoes straight away.
 
-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).
+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). Once an update is in place, Backstep says what's new, from `CHANGES.json`.
 
 Other commands: `backstep ui`, `backstep log`, `backstep undo <action-id>`, `backstep undo --run <run-id>`, `backstep connect [supabase|firebase]` (connects what the project uses, the same as asking Claude), `backstep disconnect supabase <ref>`.
 

package/dist/cli.js

@@ -57,7 +57,7 @@ import { connect } from "./connect.js";
 import { check, printCheck } from "./check.js";
 import { logo } from "./look.js";
 import { keyLabel, setUndoKey, undoKeys } from "./keys.js";
-import { checkUpdate, runUpdate, skipVersion } from "./update.js";
+import { changesSince, checkUpdate, runUpdate, skipVersion } from "./update.js";
 import { askConnectionString } from "./setup.js";
 // Header values can name env vars, so tokens don't have to sit in agent config files.
 function parseHeaders(list) {
@@ -124,6 +124,8 @@ const HELP = `backstep: undo for everything your agents touch
   backstep undo --since <ms> [--until <ms>] [--json] [--via-claude-code] [--manual ask|undo|keep]
                                undo everything any agent did in that window; files changed since
                                (often by hand) are undone too, kept, or named first with ask
+  backstep changes --since <version> [--json]
+                               what's new since that version
   backstep after <action-id>   note how a tool left the files, once it ran (used by the Claude Code mod)
   backstep snap --session <id> --tool <name> [--cwd <dir>] -- <paths...>
                                save paths before Claude Code's own tools change them (used by the Claude Code mod)
@@ -340,6 +342,19 @@ async function main() {
         return;
     }
     // `backstep update` installs the newest version; --skip <v> stops asking about that one.
+    // What's new since a version, for the mod to show once an update is in place.
+    if (cmd === "changes") {
+        const { values } = parseArgs({ args: rest, options: { since: { type: "string" }, json: { type: "boolean", default: false } } });
+        if (!values.since)
+            throw new Error("usage: backstep changes --since <version> [--json]");
+        const list = changesSince(values.since);
+        if (values.json)
+            console.log(JSON.stringify(list));
+        else
+            for (const c of list)
+                console.log(`${c.version}\n${c.notes.map((n) => `  - ${n}`).join("\n")}`);
+        return;
+    }
     if (cmd === "update") {
         const { values } = parseArgs({ args: rest, options: { skip: { type: "string" }, version: { type: "string" }, json: { type: "boolean", default: false } } });
         if (values.skip) {

package/dist/update.js

@@ -4,7 +4,8 @@
 // Off with BACKSTEP_UPDATE_CHECK=0.
 import { spawnSync } from "./spawn.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { tmpdir } from "node:os";
 import { homeDir } from "./store.js";
 import { version } from "./telemetry.js";
@@ -48,6 +49,15 @@ export async function checkUpdate() {
     const available = latest !== null && newer(latest, current) && settings().skipVersion !== latest;
     return { current, latest, available };
 }
+export function changesSince(from, upTo = version()) {
+    try {
+        const all = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "CHANGES.json"), "utf8"));
+        return all.filter((c) => newer(c.version, from) && !newer(c.version, upTo)).sort((a, b) => (newer(a.version, b.version) ? -1 : 1));
+    }
+    catch {
+        return [];
+    }
+}
 export function skipVersion(v) {
     mkdirSync(homeDir(), { recursive: true });
     writeFileSync(file(), JSON.stringify({ ...settings(), skipVersion: v }, null, 2) + "\n");

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

@@ -1,6 +1,6 @@
 {
   "name": "backstep",
-  "version": "0.1.32",
+  "version": "0.1.33",
   "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

@@ -1277,6 +1277,8 @@ test('an update that reloads the mod partway is finished by the reloaded mod: it
     }
     const stdout = argv.includes('update-check')
       ? JSON.stringify({ current: started ? '0.2.0' : '0.1.2', latest: '0.2.0', available: !started })
+      : argv.includes('changes')
+        ? JSON.stringify(argv.includes('0.1.2') ? [{ version: '0.2.0', notes: ['Undo is faster.', 'Notion undos finish in auto mode.'] }] : [])
       : argv.includes('status')
         ? JSON.stringify({ items: [], suggest: [] })
         : '[]'
@@ -1320,6 +1322,8 @@ test('an update that reloads the mod partway is finished by the reloaded mod: it
   }
   expect(statuses.at(-1)).toBeUndefined()
   expect(logs.join('\n')).toContain('Backstep is updated to 0.2.0 (you had 0.1.2). It\'s safe to close this terminal now.')
+  // Then what changed, from the new version's own notes.
+  expect(logs.join('\n')).toContain("What's new in 0.2.0:\n  • Undo is faster.\n  • Notion undos finish in auto mode.")
   await ui.unmount()
 })
 

package/mod/hooks/register.tsx

@@ -905,9 +905,26 @@ async function offerUpdate($: EngineInterface) {
   await installUpdate($, u.current, u.latest)
 }
 
-function updated($: EngineInterface, u: Updating) {
+async function updated($: EngineInterface, u: Updating) {
   $.ui.log(`${MARK_TEXT} Backstep is updated to ${u.to}${u.from ? ` (you had ${u.from})` : ''}. It's safe to close ${u.win} now. Restart Claude Code to start using ${u.to}.`)
   $.ui.toast(`Backstep is updated to ${u.to}. Restart Claude Code to use it.`)
+  if (u.from) await whatsNew($, u.from)
+}
+
+// What changed since the version before, from the new version's own notes.
+async function whatsNew($: EngineInterface, from: string) {
+  const ran = await $.process.run(backstep(['changes', '--since', from, '--json']), { timeoutMs: 15_000 }).catch(() => null)
+  let list: { version: string; notes: string[] }[] = []
+  try {
+    list = JSON.parse(ran?.stdout || '[]') as typeof list
+  } catch {
+    return
+  }
+  list = list.filter((c) => c.notes?.length)
+  if (!list.length) return
+  const one = list.length === 1
+  const lines = one ? list[0].notes.map((n) => `  • ${n}`) : list.flatMap((c) => [`  ${c.version}`, ...c.notes.map((n) => `    • ${n}`)])
+  $.ui.log([`${MARK_TEXT} What's new${one ? ` in ${list[0].version}` : ` since ${from}`}:`, ...lines].join('\n'))
 }
 
 // After a reload in the middle of an update: once the new version is in place,
@@ -929,7 +946,7 @@ async function finishUpdate($: EngineInterface) {
       await $.clock.sleep(5000)
       $.ui.status(undefined)
       await update($, updating, () => null)
-      updated($, u)
+      await updated($, u)
       return
     }
     await $.clock.sleep(5000)
@@ -961,7 +978,7 @@ async function installUpdate($: EngineInterface, current: string | undefined, la
   $.ui.status(undefined)
   await update($, updating, () => null)
   if (r.ok) {
-    updated($, { ...(u.current ? { from: u.current } : {}), to: latest, win })
+    await updated($, { ...(u.current ? { from: u.current } : {}), to: latest, win })
     return true
   } else {
     $.ui.log(`${MARK_TEXT} Backstep couldn't update to ${u.latest}: ${r.detail}. You're still on ${u.current ?? 'the version you had'}${forced ? '' : ', which keeps working'}. To try again, run: npx backstep@latest setup`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backstep",
-  "version": "0.1.32",
+  "version": "0.1.33",
   "description": "Undo for everything your agents touch: an MCP proxy that makes agent actions reversible.",
   "homepage": "https://getbackstep.com",
   "scripts": {
@@ -37,7 +37,8 @@
   "files": [
     "dist",
     "mod",
-    "README.md"
+    "README.md",
+    "CHANGES.json"
   ],
   "keywords": [
     "mcp",