@astralyn/pi 0.81.1-1

package/dist/extensions/rewind/index.js

@@ -0,0 +1,253 @@
+/**
+ * rewind — file-backed checkpoint & rewind for Pi.
+ *
+ * Engine: instead of snapshotting the whole work tree into a per-session shadow
+ * git repo (the old design, which froze the UI in large directories like a
+ * multi-project parent folder and grew storage without bound), we back up ONLY
+ * the files Pi's edit/write tools are about to modify — one copyFile before each
+ * edit (see engine.ts, ported from Claude Code's file-history). Cost is
+ * proportional to how many files Pi changed, never to project size.
+ *
+ * Per turn: before_agent_start opens a snapshot frame (re-recording tracked files
+ * at their turn-start state); tool_call(edit|write) backs up each newly edited
+ * file before it lands; agent_settled persists the frame to the session JSONL
+ * (custom "pi-rewind-snapshot" entry) when it changed. agent_settled is used
+ * instead of agent_end so auto-retry, overflow compaction-retry, and queued
+ * follow-ups stay in one logical turn (agent_end can fire mid-continuation).
+ * On session_start the index is rebuilt from those entries; resume/fork
+ * hard-links the prior session's blobs.
+ *
+ * Time-travel is fused into /tree: navigating to a node whose turn changed files
+ * offers to sync the work tree to that point (session_before_tree/session_tree).
+ * /rewind itself is a settings + storage menu (menu.ts), not a restore picker.
+ *
+ * Restore safety: applySnapshot only rewrites files that differ and never throws
+ * out — a broken backup degrades to "leave the file alone", so it can never abort
+ * the user's session.
+ *
+ * Architecture informed by oh-my-pi (GPL-3.0) and Claude Code's file-history;
+ * independent implementation. No ANSI: all UI is native (ctx.ui.* + theme).
+ */
+import path from "node:path";
+import { loadRewindConfig, reloadRewindConfig } from "./config.js";
+import { beginTurn, disposeSession, endTurn, getSnapshots, migrateBackupsFromSession, registerSession, restoreStateFromSnapshots, trackEdit, } from "./engine.js";
+import { runGc, sessionIdFromFile } from "./gc.js";
+import { runRewindMenu } from "./menu.js";
+import { rewindBackupsRoot, sessionsDirectory } from "./paths.js";
+import { restoreToSnapshot, snapshotChangeDiffStats, snapshotChangedPaths, snapshotForEntry } from "./restore.js";
+import { isSnapshot, SNAPSHOT_ENTRY_TYPE } from "./snapshot.js";
+import { configureStorage } from "./storage.js";
+import { truncateText } from "./text.js";
+import { editWriteTargetPath, resolveToolPath } from "./tool-path.js";
+// Bind the engine/gc storage roots to the real on-disk locations (they avoid
+// importing paths.ts directly so they stay node-testable). Safe to call at load.
+configureStorage({ backupsRoot: rewindBackupsRoot(), sessionsRoot: sessionsDirectory() });
+// Global (one config.json). Reloaded from disk at session_start; /rewind menu
+// saveRewindConfig updates the in-memory cache so the next turn sees changes
+// without re-reading the file every before_agent_start.
+let config = loadRewindConfig();
+// Per-session transient state held by the integration layer.
+const pendingPrompt = new Map(); // turn prompt, captured for the snapshot label
+const pendingTreeRestore = new Map(); // /tree sync intent
+// ---- helpers --------------------------------------------------------------
+/** The id of the last user message in the current branch (the turn's anchor). */
+function lastUserEntryId(ctx) {
+    const branch = ctx.sessionManager.getBranch();
+    for (let i = branch.length - 1; i >= 0; i--) {
+        const e = branch[i];
+        if (e.type === "message" && e.message.role === "user")
+            return e.id;
+    }
+    return undefined;
+}
+/** Rebuild the snapshot list for a session from its persisted custom entries. */
+function rebuildSnapshots(ctx) {
+    const out = [];
+    for (const entry of ctx.sessionManager.getEntries()) {
+        if (entry.type === "custom" && entry.customType === SNAPSHOT_ENTRY_TYPE && isSnapshot(entry.data)) {
+            out.push(entry.data);
+        }
+    }
+    return out;
+}
+/** Max files listed in the /tree restore confirmation before "+N more". */
+const RESTORE_PREVIEW_LIMIT = 8;
+/** Max characters per previewed path (leading-truncated: the filename matters most). */
+const RESTORE_PREVIEW_PATH_MAX = 64;
+/**
+ * Bounded cwd-relative file list shown under the /tree restore question, so an
+ * irreversible work-tree rewrite is confirmed against WHICH files, not just a
+ * count. Multi-line select titles are upstream-sanctioned (ui.confirm joins
+ * title + message with \n through the same selector).
+ */
+function formatRestorePreview(changedPaths, cwd) {
+    const lines = changedPaths.slice(0, RESTORE_PREVIEW_LIMIT).map((p) => {
+        const rel = path.relative(cwd, p);
+        const display = rel && !rel.startsWith("..") && !path.isAbsolute(rel) ? rel : p;
+        const bounded = display.length > RESTORE_PREVIEW_PATH_MAX ? `…${display.slice(-(RESTORE_PREVIEW_PATH_MAX - 1))}` : display;
+        return `  ${bounded}`;
+    });
+    if (changedPaths.length > RESTORE_PREVIEW_LIMIT) {
+        lines.push(`  … +${changedPaths.length - RESTORE_PREVIEW_LIMIT} more`);
+    }
+    return lines.join("\n");
+}
+// ---- extension entry ------------------------------------------------------
+export default function rewind(pi) {
+    // session_start: rebuild the index, migrate fork/resume blobs, reclaim storage.
+    pi.on("session_start", async (event, ctx) => {
+        config = reloadRewindConfig();
+        const sid = ctx.sessionManager.getSessionId();
+        if (!sid)
+            return;
+        registerSession(sid, ctx.cwd);
+        const snapshots = rebuildSnapshots(ctx);
+        restoreStateFromSnapshots(sid, ctx.cwd, snapshots, config.maxSnapshots);
+        if ((event.reason === "resume" || event.reason === "fork") && event.previousSessionFile) {
+            const prevSid = sessionIdFromFile(event.previousSessionFile);
+            if (prevSid) {
+                try {
+                    await migrateBackupsFromSession(prevSid, sid, snapshots);
+                }
+                catch {
+                    // best-effort; a missing blob just means that version can't restore
+                }
+            }
+        }
+        try {
+            runGc(config.retentionDays, sid);
+        }
+        catch {
+            // GC is best-effort; never block startup
+        }
+    });
+    // tool_call: back up the target file BEFORE the edit/write lands. Synchronous
+    // so the backup is on disk before the hook returns control to the agent loop.
+    pi.on("tool_call", (event, ctx) => {
+        if (event.toolName !== "edit" && event.toolName !== "write")
+            return;
+        if (!config.enabled)
+            return;
+        const sid = ctx.sessionManager.getSessionId();
+        if (!sid)
+            return;
+        const rawPath = editWriteTargetPath(event.input);
+        if (!rawPath)
+            return;
+        const abs = resolveToolPath(rawPath, ctx.cwd);
+        try {
+            trackEdit(sid, abs);
+        }
+        catch {
+            // never block the edit on a backup failure
+        }
+    });
+    // before_agent_start: open the turn's snapshot frame.
+    pi.on("before_agent_start", async (event, ctx) => {
+        // Memory-cached; session_start reloads disk, /rewind save updates cache.
+        config = loadRewindConfig();
+        if (!config.enabled)
+            return;
+        const sid = ctx.sessionManager.getSessionId();
+        if (!sid)
+            return;
+        pendingPrompt.set(sid, event.prompt ?? "");
+        try {
+            await beginTurn(sid);
+        }
+        catch {
+            // non-fatal
+        }
+    });
+    // agent_settled: finalize + persist after Pi will not auto-continue (retry /
+    // compact-retry / follow-up). agent_end alone is too early for that.
+    pi.on("agent_settled", async (_event, ctx) => {
+        if (!config.enabled)
+            return;
+        const sid = ctx.sessionManager.getSessionId();
+        if (!sid)
+            return;
+        const userEntryId = lastUserEntryId(ctx) ?? "";
+        const turnId = ctx.sessionManager.getLeafId() ?? userEntryId;
+        const prompt = truncateText(pendingPrompt.get(sid) ?? "", 120, { collapseWhitespace: true });
+        pendingPrompt.delete(sid);
+        const frame = endTurn(sid, userEntryId, turnId, prompt, new Date().toISOString(), config.maxSnapshots);
+        if (frame && userEntryId) {
+            pi.appendEntry(SNAPSHOT_ENTRY_TYPE, frame);
+        }
+    });
+    // session_before_tree: offer to sync files when navigating to a changed point.
+    pi.on("session_before_tree", async (event, ctx) => {
+        const sid = ctx.sessionManager.getSessionId();
+        if (!sid)
+            return;
+        pendingTreeRestore.set(sid, null);
+        if (!config.enabled)
+            return;
+        const target = snapshotForEntry(getSnapshots(sid), ctx.sessionManager, event.preparation.targetId);
+        if (!target)
+            return;
+        const changed = await snapshotChangedPaths(sid, target);
+        if (changed.length === 0)
+            return; // silent nav, like native /tree
+        // Lifecycle handler: silent-return without UI. (hasUI is the guard for
+        // ctx.ui.*; checking ctx.mode here would wrongly proceed when a TUI
+        // session has no usable UI.)
+        if (!ctx.hasUI)
+            return;
+        const n = changed.length;
+        let lineStats = "";
+        try {
+            const stats = await snapshotChangeDiffStats(sid, target, changed);
+            if (stats.insertions > 0 || stats.deletions > 0) {
+                lineStats = `  (+${stats.insertions} / −${stats.deletions})`;
+            }
+        }
+        catch {
+            // Coarse stats are best-effort; still offer path preview.
+        }
+        const choice = await ctx.ui.select(`Restore ${n} file${n === 1 ? "" : "s"} to this point?${lineStats}\n${formatRestorePreview(changed, ctx.cwd)}`, ["Yes, restore files", "No, conversation only"]);
+        if (choice?.startsWith("Yes")) {
+            // Cache paths so session_tree can apply without a second full compare.
+            pendingTreeRestore.set(sid, { snapshot: target, changedPaths: changed });
+        }
+    });
+    // session_tree: execute any sync intent recorded above.
+    pi.on("session_tree", async (_event, ctx) => {
+        const sid = ctx.sessionManager.getSessionId();
+        if (!sid)
+            return;
+        const pending = pendingTreeRestore.get(sid);
+        pendingTreeRestore.set(sid, null);
+        if (!pending)
+            return;
+        try {
+            const changed = await restoreToSnapshot(sid, pending.snapshot, {
+                onlyPaths: new Set(pending.changedPaths),
+            });
+            if (changed.length > 0) {
+                ctx.ui.notify(`Restored ${changed.length} file${changed.length === 1 ? "" : "s"} to this checkpoint.`, "info");
+            }
+        }
+        catch (e) {
+            ctx.ui.notify(`Rewind restore failed: ${String(e)}`, "warning");
+        }
+    });
+    // session_shutdown: drop this session's in-memory state.
+    pi.on("session_shutdown", async (_event, ctx) => {
+        const sid = ctx.sessionManager.getSessionId();
+        if (!sid)
+            return;
+        disposeSession(sid);
+        pendingTreeRestore.delete(sid);
+        pendingPrompt.delete(sid);
+    });
+    // /rewind: settings + storage menu (time-travel itself is via /tree).
+    pi.registerCommand("rewind", {
+        description: "Rewind settings and backup storage (restore is via /tree)",
+        handler: async (_args, ctx) => {
+            await runRewindMenu(ctx);
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/rewind/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/rewind/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,OAAO,EAAE,gBAAgB,EAAqB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EACN,SAAS,EACT,cAAc,EACd,OAAO,EACP,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,yBAAyB,EACzB,SAAS,GACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAClH,OAAO,EAA4B,UAAU,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE,6EAA6E;AAC7E,iFAAiF;AACjF,gBAAgB,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAAE,YAAY,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAE1F,8EAA8E;AAC9E,6EAA6E;AAC7E,wDAAwD;AACxD,IAAI,MAAM,GAAiB,gBAAgB,EAAE,CAAC;AAQ9C,6DAA6D;AAC7D,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,+CAA+C;AAChG,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAqC,CAAC,CAAC,oBAAoB;AAE7F,8EAA8E;AAE9E,iFAAiF;AACjF,SAAS,eAAe,CAAC,GAAqB,EAAsB;IACnE,MAAM,MAAM,GAAG,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;IAC9C,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAK,CAAC,CAAC,OAAwB,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IACtF,CAAC;IACD,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,iFAAiF;AACjF,SAAS,gBAAgB,CAAC,GAAqB,EAAyB;IACvE,MAAM,GAAG,GAA0B,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,CAAC;QACrD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,mBAAmB,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC;AAAA,CACX;AAED,2EAA2E;AAC3E,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,wFAAwF;AACxF,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAEpC;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,YAAsB,EAAE,GAAW,EAAU;IAC1E,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,OAAO,GACZ,OAAO,CAAC,MAAM,GAAG,wBAAwB,CAAC,CAAC,CAAC,MAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,wBAAwB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5G,OAAO,KAAK,OAAO,EAAE,CAAC;IAAA,CACtB,CAAC,CAAC;IACH,IAAI,YAAY,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,UAAQ,YAAY,CAAC,MAAM,GAAG,qBAAqB,OAAO,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CACxB;AAED,8EAA8E;AAE9E,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,EAAgB,EAAQ;IACtD,gFAAgF;IAChF,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QAC5C,MAAM,GAAG,kBAAkB,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAE9B,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACxC,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAExE,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;YACzF,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAC7D,IAAI,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC;oBACJ,MAAM,yBAAyB,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;gBAC1D,CAAC;gBAAC,MAAM,CAAC;oBACR,oEAAoE;gBACrE,CAAC;YACF,CAAC;QACF,CAAC;QAED,IAAI,CAAC;YACJ,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACR,yCAAyC;QAC1C,CAAC;IAAA,CACD,CAAC,CAAC;IAEH,8EAA8E;IAC9E,8EAA8E;IAC9E,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO;QACpE,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC;YACJ,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACR,2CAA2C;QAC5C,CAAC;IAAA,CACD,CAAC,CAAC;IAEH,sDAAsD;IACtD,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QACjD,yEAAyE;QACzE,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC;YACJ,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACR,YAAY;QACb,CAAC;IAAA,CACD,CAAC,CAAC;IAEH,6EAA6E;IAC7E,qEAAqE;IACrE,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,WAAW,CAAC;QAC7D,MAAM,MAAM,GAAG,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7F,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QACvG,IAAI,KAAK,IAAI,WAAW,EAAE,CAAC;YAC1B,EAAE,CAAC,WAAW,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;IAAA,CACD,CAAC,CAAC;IAEH,+EAA+E;IAC/E,EAAE,CAAC,EAAE,CAAC,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAE5B,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACnG,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,gCAAgC;QAClE,uEAAuE;QACvE,oEAAoE;QACpE,6BAA6B;QAC7B,IAAI,CAAC,GAAG,CAAC,KAAK;YAAE,OAAO;QAEvB,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;QACzB,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAClE,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBACjD,SAAS,GAAG,OAAO,KAAK,CAAC,UAAU,SAAO,KAAK,CAAC,SAAS,GAAG,CAAC;YAC9D,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,0DAA0D;QAC3D,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CACjC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,kBAAkB,SAAS,KAAK,oBAAoB,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAC9G,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,CAC/C,CAAC;QACF,IAAI,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,uEAAuE;YACvE,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1E,CAAC;IAAA,CACD,CAAC,CAAC;IAEH,wDAAwD;IACxD,EAAE,CAAC,EAAE,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5C,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE;gBAC9D,SAAS,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC;aACxC,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,GAAG,CAAC,EAAE,CAAC,MAAM,CACZ,YAAY,OAAO,CAAC,MAAM,QAAQ,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,sBAAsB,EACvF,MAAM,CACN,CAAC;YACH,CAAC;QACF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,0BAA0B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACjE,CAAC;IAAA,CACD,CAAC,CAAC;IAEH,yDAAyD;IACzD,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,cAAc,CAAC,GAAG,CAAC,CAAC;QACpB,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAAA,CAC1B,CAAC,CAAC;IAEH,sEAAsE;IACtE,EAAE,CAAC,eAAe,CAAC,QAAQ,EAAE;QAC5B,WAAW,EAAE,2DAA2D;QACxE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;YAC9B,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QAAA,CACzB;KACD,CAAC,CAAC;AAAA,CACH","sourcesContent":["/**\n * rewind — file-backed checkpoint & rewind for Pi.\n *\n * Engine: instead of snapshotting the whole work tree into a per-session shadow\n * git repo (the old design, which froze the UI in large directories like a\n * multi-project parent folder and grew storage without bound), we back up ONLY\n * the files Pi's edit/write tools are about to modify — one copyFile before each\n * edit (see engine.ts, ported from Claude Code's file-history). Cost is\n * proportional to how many files Pi changed, never to project size.\n *\n * Per turn: before_agent_start opens a snapshot frame (re-recording tracked files\n * at their turn-start state); tool_call(edit|write) backs up each newly edited\n * file before it lands; agent_settled persists the frame to the session JSONL\n * (custom \"pi-rewind-snapshot\" entry) when it changed. agent_settled is used\n * instead of agent_end so auto-retry, overflow compaction-retry, and queued\n * follow-ups stay in one logical turn (agent_end can fire mid-continuation).\n * On session_start the index is rebuilt from those entries; resume/fork\n * hard-links the prior session's blobs.\n *\n * Time-travel is fused into /tree: navigating to a node whose turn changed files\n * offers to sync the work tree to that point (session_before_tree/session_tree).\n * /rewind itself is a settings + storage menu (menu.ts), not a restore picker.\n *\n * Restore safety: applySnapshot only rewrites files that differ and never throws\n * out — a broken backup degrades to \"leave the file alone\", so it can never abort\n * the user's session.\n *\n * Architecture informed by oh-my-pi (GPL-3.0) and Claude Code's file-history;\n * independent implementation. No ANSI: all UI is native (ctx.ui.* + theme).\n */\nimport path from \"node:path\";\n\nimport type { AgentMessage } from \"@earendil-works/pi-agent-core\";\nimport type { ExtensionAPI, ExtensionContext } from \"../../core/extensions/types.ts\";\n\nimport { loadRewindConfig, type RewindConfig, reloadRewindConfig } from \"./config.ts\";\nimport {\n\tbeginTurn,\n\tdisposeSession,\n\tendTurn,\n\tgetSnapshots,\n\tmigrateBackupsFromSession,\n\tregisterSession,\n\trestoreStateFromSnapshots,\n\ttrackEdit,\n} from \"./engine.ts\";\nimport { runGc, sessionIdFromFile } from \"./gc.ts\";\nimport { runRewindMenu } from \"./menu.ts\";\nimport { rewindBackupsRoot, sessionsDirectory } from \"./paths.ts\";\nimport { restoreToSnapshot, snapshotChangeDiffStats, snapshotChangedPaths, snapshotForEntry } from \"./restore.ts\";\nimport { type FileHistorySnapshot, isSnapshot, SNAPSHOT_ENTRY_TYPE } from \"./snapshot.ts\";\nimport { configureStorage } from \"./storage.ts\";\nimport { truncateText } from \"./text.ts\";\nimport { editWriteTargetPath, resolveToolPath } from \"./tool-path.ts\";\n\n// Bind the engine/gc storage roots to the real on-disk locations (they avoid\n// importing paths.ts directly so they stay node-testable). Safe to call at load.\nconfigureStorage({ backupsRoot: rewindBackupsRoot(), sessionsRoot: sessionsDirectory() });\n\n// Global (one config.json). Reloaded from disk at session_start; /rewind menu\n// saveRewindConfig updates the in-memory cache so the next turn sees changes\n// without re-reading the file every before_agent_start.\nlet config: RewindConfig = loadRewindConfig();\n\n/** /tree confirm → apply payload (changedPaths skips a second originChanged pass). */\ninterface PendingTreeRestore {\n\tsnapshot: FileHistorySnapshot;\n\tchangedPaths: string[];\n}\n\n// Per-session transient state held by the integration layer.\nconst pendingPrompt = new Map<string, string>(); // turn prompt, captured for the snapshot label\nconst pendingTreeRestore = new Map<string, PendingTreeRestore | null>(); // /tree sync intent\n\n// ---- helpers --------------------------------------------------------------\n\n/** The id of the last user message in the current branch (the turn's anchor). */\nfunction lastUserEntryId(ctx: ExtensionContext): string | undefined {\n\tconst branch = ctx.sessionManager.getBranch();\n\tfor (let i = branch.length - 1; i >= 0; i--) {\n\t\tconst e = branch[i];\n\t\tif (e.type === \"message\" && (e.message as AgentMessage).role === \"user\") return e.id;\n\t}\n\treturn undefined;\n}\n\n/** Rebuild the snapshot list for a session from its persisted custom entries. */\nfunction rebuildSnapshots(ctx: ExtensionContext): FileHistorySnapshot[] {\n\tconst out: FileHistorySnapshot[] = [];\n\tfor (const entry of ctx.sessionManager.getEntries()) {\n\t\tif (entry.type === \"custom\" && entry.customType === SNAPSHOT_ENTRY_TYPE && isSnapshot(entry.data)) {\n\t\t\tout.push(entry.data);\n\t\t}\n\t}\n\treturn out;\n}\n\n/** Max files listed in the /tree restore confirmation before \"+N more\". */\nconst RESTORE_PREVIEW_LIMIT = 8;\n/** Max characters per previewed path (leading-truncated: the filename matters most). */\nconst RESTORE_PREVIEW_PATH_MAX = 64;\n\n/**\n * Bounded cwd-relative file list shown under the /tree restore question, so an\n * irreversible work-tree rewrite is confirmed against WHICH files, not just a\n * count. Multi-line select titles are upstream-sanctioned (ui.confirm joins\n * title + message with \\n through the same selector).\n */\nfunction formatRestorePreview(changedPaths: string[], cwd: string): string {\n\tconst lines = changedPaths.slice(0, RESTORE_PREVIEW_LIMIT).map((p) => {\n\t\tconst rel = path.relative(cwd, p);\n\t\tconst display = rel && !rel.startsWith(\"..\") && !path.isAbsolute(rel) ? rel : p;\n\t\tconst bounded =\n\t\t\tdisplay.length > RESTORE_PREVIEW_PATH_MAX ? `…${display.slice(-(RESTORE_PREVIEW_PATH_MAX - 1))}` : display;\n\t\treturn `  ${bounded}`;\n\t});\n\tif (changedPaths.length > RESTORE_PREVIEW_LIMIT) {\n\t\tlines.push(`  … +${changedPaths.length - RESTORE_PREVIEW_LIMIT} more`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\n// ---- extension entry ------------------------------------------------------\n\nexport default function rewind(pi: ExtensionAPI): void {\n\t// session_start: rebuild the index, migrate fork/resume blobs, reclaim storage.\n\tpi.on(\"session_start\", async (event, ctx) => {\n\t\tconfig = reloadRewindConfig();\n\t\tconst sid = ctx.sessionManager.getSessionId();\n\t\tif (!sid) return;\n\t\tregisterSession(sid, ctx.cwd);\n\n\t\tconst snapshots = rebuildSnapshots(ctx);\n\t\trestoreStateFromSnapshots(sid, ctx.cwd, snapshots, config.maxSnapshots);\n\n\t\tif ((event.reason === \"resume\" || event.reason === \"fork\") && event.previousSessionFile) {\n\t\t\tconst prevSid = sessionIdFromFile(event.previousSessionFile);\n\t\t\tif (prevSid) {\n\t\t\t\ttry {\n\t\t\t\t\tawait migrateBackupsFromSession(prevSid, sid, snapshots);\n\t\t\t\t} catch {\n\t\t\t\t\t// best-effort; a missing blob just means that version can't restore\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\ttry {\n\t\t\trunGc(config.retentionDays, sid);\n\t\t} catch {\n\t\t\t// GC is best-effort; never block startup\n\t\t}\n\t});\n\n\t// tool_call: back up the target file BEFORE the edit/write lands. Synchronous\n\t// so the backup is on disk before the hook returns control to the agent loop.\n\tpi.on(\"tool_call\", (event, ctx) => {\n\t\tif (event.toolName !== \"edit\" && event.toolName !== \"write\") return;\n\t\tif (!config.enabled) return;\n\t\tconst sid = ctx.sessionManager.getSessionId();\n\t\tif (!sid) return;\n\t\tconst rawPath = editWriteTargetPath(event.input);\n\t\tif (!rawPath) return;\n\t\tconst abs = resolveToolPath(rawPath, ctx.cwd);\n\t\ttry {\n\t\t\ttrackEdit(sid, abs);\n\t\t} catch {\n\t\t\t// never block the edit on a backup failure\n\t\t}\n\t});\n\n\t// before_agent_start: open the turn's snapshot frame.\n\tpi.on(\"before_agent_start\", async (event, ctx) => {\n\t\t// Memory-cached; session_start reloads disk, /rewind save updates cache.\n\t\tconfig = loadRewindConfig();\n\t\tif (!config.enabled) return;\n\t\tconst sid = ctx.sessionManager.getSessionId();\n\t\tif (!sid) return;\n\t\tpendingPrompt.set(sid, event.prompt ?? \"\");\n\t\ttry {\n\t\t\tawait beginTurn(sid);\n\t\t} catch {\n\t\t\t// non-fatal\n\t\t}\n\t});\n\n\t// agent_settled: finalize + persist after Pi will not auto-continue (retry /\n\t// compact-retry / follow-up). agent_end alone is too early for that.\n\tpi.on(\"agent_settled\", async (_event, ctx) => {\n\t\tif (!config.enabled) return;\n\t\tconst sid = ctx.sessionManager.getSessionId();\n\t\tif (!sid) return;\n\t\tconst userEntryId = lastUserEntryId(ctx) ?? \"\";\n\t\tconst turnId = ctx.sessionManager.getLeafId() ?? userEntryId;\n\t\tconst prompt = truncateText(pendingPrompt.get(sid) ?? \"\", 120, { collapseWhitespace: true });\n\t\tpendingPrompt.delete(sid);\n\t\tconst frame = endTurn(sid, userEntryId, turnId, prompt, new Date().toISOString(), config.maxSnapshots);\n\t\tif (frame && userEntryId) {\n\t\t\tpi.appendEntry(SNAPSHOT_ENTRY_TYPE, frame);\n\t\t}\n\t});\n\n\t// session_before_tree: offer to sync files when navigating to a changed point.\n\tpi.on(\"session_before_tree\", async (event, ctx) => {\n\t\tconst sid = ctx.sessionManager.getSessionId();\n\t\tif (!sid) return;\n\t\tpendingTreeRestore.set(sid, null);\n\t\tif (!config.enabled) return;\n\n\t\tconst target = snapshotForEntry(getSnapshots(sid), ctx.sessionManager, event.preparation.targetId);\n\t\tif (!target) return;\n\t\tconst changed = await snapshotChangedPaths(sid, target);\n\t\tif (changed.length === 0) return; // silent nav, like native /tree\n\t\t// Lifecycle handler: silent-return without UI. (hasUI is the guard for\n\t\t// ctx.ui.*; checking ctx.mode here would wrongly proceed when a TUI\n\t\t// session has no usable UI.)\n\t\tif (!ctx.hasUI) return;\n\n\t\tconst n = changed.length;\n\t\tlet lineStats = \"\";\n\t\ttry {\n\t\t\tconst stats = await snapshotChangeDiffStats(sid, target, changed);\n\t\t\tif (stats.insertions > 0 || stats.deletions > 0) {\n\t\t\t\tlineStats = `  (+${stats.insertions} / −${stats.deletions})`;\n\t\t\t}\n\t\t} catch {\n\t\t\t// Coarse stats are best-effort; still offer path preview.\n\t\t}\n\t\tconst choice = await ctx.ui.select(\n\t\t\t`Restore ${n} file${n === 1 ? \"\" : \"s\"} to this point?${lineStats}\\n${formatRestorePreview(changed, ctx.cwd)}`,\n\t\t\t[\"Yes, restore files\", \"No, conversation only\"],\n\t\t);\n\t\tif (choice?.startsWith(\"Yes\")) {\n\t\t\t// Cache paths so session_tree can apply without a second full compare.\n\t\t\tpendingTreeRestore.set(sid, { snapshot: target, changedPaths: changed });\n\t\t}\n\t});\n\n\t// session_tree: execute any sync intent recorded above.\n\tpi.on(\"session_tree\", async (_event, ctx) => {\n\t\tconst sid = ctx.sessionManager.getSessionId();\n\t\tif (!sid) return;\n\t\tconst pending = pendingTreeRestore.get(sid);\n\t\tpendingTreeRestore.set(sid, null);\n\t\tif (!pending) return;\n\t\ttry {\n\t\t\tconst changed = await restoreToSnapshot(sid, pending.snapshot, {\n\t\t\t\tonlyPaths: new Set(pending.changedPaths),\n\t\t\t});\n\t\t\tif (changed.length > 0) {\n\t\t\t\tctx.ui.notify(\n\t\t\t\t\t`Restored ${changed.length} file${changed.length === 1 ? \"\" : \"s\"} to this checkpoint.`,\n\t\t\t\t\t\"info\",\n\t\t\t\t);\n\t\t\t}\n\t\t} catch (e) {\n\t\t\tctx.ui.notify(`Rewind restore failed: ${String(e)}`, \"warning\");\n\t\t}\n\t});\n\n\t// session_shutdown: drop this session's in-memory state.\n\tpi.on(\"session_shutdown\", async (_event, ctx) => {\n\t\tconst sid = ctx.sessionManager.getSessionId();\n\t\tif (!sid) return;\n\t\tdisposeSession(sid);\n\t\tpendingTreeRestore.delete(sid);\n\t\tpendingPrompt.delete(sid);\n\t});\n\n\t// /rewind: settings + storage menu (time-travel itself is via /tree).\n\tpi.registerCommand(\"rewind\", {\n\t\tdescription: \"Rewind settings and backup storage (restore is via /tree)\",\n\t\thandler: async (_args, ctx) => {\n\t\t\tawait runRewindMenu(ctx);\n\t\t},\n\t});\n}\n"]}

package/dist/extensions/rewind/menu.d.ts

@@ -0,0 +1,13 @@
+/**
+ * menu.ts — the `/rewind` settings menu.
+ *
+ * Per the design, /rewind no longer performs the time-travel itself — restoring
+ * files is fused into /tree navigation (see index.ts session_before_tree/
+ * session_tree). /rewind is purely a settings + storage console:
+ *   - toggle the master switch
+ *   - set the auto-clean retention window
+ *   - inspect and prune backup storage (aged / orphaned / all-but-current)
+ */
+import type { ExtensionCommandContext } from "../../core/extensions/types.ts";
+export declare function runRewindMenu(ctx: ExtensionCommandContext): Promise<void>;
+//# sourceMappingURL=menu.d.ts.map

package/dist/extensions/rewind/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../src/extensions/rewind/menu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAQ9E,wBAAsB,aAAa,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B/E","sourcesContent":["/**\n * menu.ts — the `/rewind` settings menu.\n *\n * Per the design, /rewind no longer performs the time-travel itself — restoring\n * files is fused into /tree navigation (see index.ts session_before_tree/\n * session_tree). /rewind is purely a settings + storage console:\n *   - toggle the master switch\n *   - set the auto-clean retention window\n *   - inspect and prune backup storage (aged / orphaned / all-but-current)\n */\nimport type { ExtensionCommandContext } from \"../../core/extensions/types.ts\";\n\nimport { loadRewindConfig, saveRewindConfig } from \"./config.ts\";\nimport { listSessions, removeSession, runGc } from \"./gc.ts\";\nimport { formatSize } from \"./text.ts\";\n\nconst RETENTION_PRESETS = [7, 14, 30, 60, 90];\n\nexport async function runRewindMenu(ctx: ExtensionCommandContext): Promise<void> {\n\tif (!ctx.hasUI) {\n\t\tctx.ui.notify(\"/rewind requires an interactive UI.\", \"warning\");\n\t\treturn;\n\t}\n\tconst sid = ctx.sessionManager.getSessionId() ?? undefined;\n\n\tfor (;;) {\n\t\tconst cfg = loadRewindConfig();\n\t\tconst sessions = listSessions(sid);\n\t\tconst total = sessions.reduce((n, s) => n + s.bytes, 0);\n\n\t\tconst enabledLabel = `Rewind: ${cfg.enabled ? \"on\" : \"off\"}`;\n\t\tconst retentionLabel = `Auto-clean backups: ${cfg.retentionDays > 0 ? `after ${cfg.retentionDays} days` : \"never (keep forever)\"}`;\n\t\tconst storageLabel = `Storage: ${formatSize(total)} across ${sessions.length} session${sessions.length === 1 ? \"\" : \"s\"}`;\n\n\t\tconst pick = await ctx.ui.select(\"Rewind settings (Esc to close)\", [enabledLabel, retentionLabel, storageLabel]);\n\t\tif (!pick) return;\n\n\t\tif (pick === enabledLabel) {\n\t\t\tsaveRewindConfig({ ...cfg, enabled: !cfg.enabled });\n\t\t\tctx.ui.notify(`Rewind ${cfg.enabled ? \"disabled\" : \"enabled\"}.`, \"info\");\n\t\t} else if (pick === retentionLabel) {\n\t\t\tawait pickRetention(ctx);\n\t\t} else if (pick === storageLabel) {\n\t\t\tawait storageMenu(ctx, sid);\n\t\t}\n\t}\n}\n\nasync function pickRetention(ctx: ExtensionCommandContext): Promise<void> {\n\tconst options = [...RETENTION_PRESETS.map((d) => `${d} days`), \"Keep forever\", \"Custom...\"];\n\tconst pick = await ctx.ui.select(\"Auto-clean backups after\", options);\n\tif (!pick) return;\n\n\tlet days: number;\n\tif (pick === \"Keep forever\") {\n\t\tdays = 0;\n\t} else if (pick === \"Custom...\") {\n\t\tconst value = await ctx.ui.input(\"Days to keep backups (0 = forever)\");\n\t\tif (value === undefined) return;\n\t\tconst n = Number.parseInt(value.trim(), 10);\n\t\tif (!Number.isFinite(n) || n < 0) {\n\t\t\tctx.ui.notify(\"Invalid number of days.\", \"warning\");\n\t\t\treturn;\n\t\t}\n\t\tdays = n;\n\t} else {\n\t\tdays = Number.parseInt(pick, 10);\n\t}\n\n\tconst cfg = loadRewindConfig();\n\tsaveRewindConfig({ ...cfg, retentionDays: days });\n\tctx.ui.notify(days > 0 ? `Backups now kept for ${days} days.` : \"Backups kept forever.\", \"info\");\n}\n\nasync function storageMenu(ctx: ExtensionCommandContext, sid: string | undefined): Promise<void> {\n\tfor (;;) {\n\t\tconst sessions = listSessions(sid);\n\t\tconst total = sessions.reduce((n, s) => n + s.bytes, 0);\n\t\tconst orphans = sessions.filter((s) => s.orphan);\n\t\tconst others = sessions.filter((s) => s.sessionId !== sid);\n\n\t\tconst cleanLabel = \"Clean now (aged + orphaned)\";\n\t\tconst orphanLabel = `Remove orphaned (${orphans.length})`;\n\t\tconst allLabel = `Remove all except current (${others.length})`;\n\n\t\tconst pick = await ctx.ui.select(\n\t\t\t`Rewind storage — ${formatSize(total)}, ${sessions.length} session${sessions.length === 1 ? \"\" : \"s\"} (Esc to close)`,\n\t\t\t[cleanLabel, orphanLabel, allLabel],\n\t\t);\n\t\tif (!pick) return;\n\n\t\tif (pick === cleanLabel) {\n\t\t\tconst r = runGc(loadRewindConfig().retentionDays, sid);\n\t\t\tctx.ui.notify(\n\t\t\t\tr.removed > 0\n\t\t\t\t\t? `Removed ${r.removed} session(s), reclaimed ${formatSize(r.reclaimedBytes)}.`\n\t\t\t\t\t: \"Nothing to clean.\",\n\t\t\t\t\"info\",\n\t\t\t);\n\t\t} else if (pick === orphanLabel) {\n\t\t\tif (orphans.length === 0) {\n\t\t\t\tctx.ui.notify(\"No orphaned backups.\", \"info\");\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst ok = await ctx.ui.confirm(\n\t\t\t\t\"Remove orphaned backups?\",\n\t\t\t\t`Deletes backups for ${orphans.length} session(s) with no session file.`,\n\t\t\t);\n\t\t\tif (!ok) continue;\n\t\t\tlet bytes = 0;\n\t\t\tlet removed = 0;\n\t\t\tfor (const s of orphans) {\n\t\t\t\tconst b = removeSession(s.sessionId);\n\t\t\t\tif (b !== null) {\n\t\t\t\t\tbytes += b;\n\t\t\t\t\tremoved++;\n\t\t\t\t}\n\t\t\t}\n\t\t\tctx.ui.notify(`Removed ${removed} orphaned session(s), reclaimed ${formatSize(bytes)}.`, \"info\");\n\t\t} else if (pick === allLabel) {\n\t\t\tif (others.length === 0) {\n\t\t\t\tctx.ui.notify(\"No other sessions' backups.\", \"info\");\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst ok = await ctx.ui.confirm(\n\t\t\t\t\"Remove all other backups?\",\n\t\t\t\t`Deletes backups for ${others.length} session(s), keeping only the current session.`,\n\t\t\t);\n\t\t\tif (!ok) continue;\n\t\t\tlet bytes = 0;\n\t\t\tlet removed = 0;\n\t\t\tfor (const s of others) {\n\t\t\t\tconst b = removeSession(s.sessionId);\n\t\t\t\tif (b !== null) {\n\t\t\t\t\tbytes += b;\n\t\t\t\t\tremoved++;\n\t\t\t\t}\n\t\t\t}\n\t\t\tctx.ui.notify(`Removed ${removed} session(s), reclaimed ${formatSize(bytes)}.`, \"info\");\n\t\t}\n\t}\n}\n"]}

package/dist/extensions/rewind/menu.js

@@ -0,0 +1,118 @@
+import { loadRewindConfig, saveRewindConfig } from "./config.js";
+import { listSessions, removeSession, runGc } from "./gc.js";
+import { formatSize } from "./text.js";
+const RETENTION_PRESETS = [7, 14, 30, 60, 90];
+export async function runRewindMenu(ctx) {
+    if (!ctx.hasUI) {
+        ctx.ui.notify("/rewind requires an interactive UI.", "warning");
+        return;
+    }
+    const sid = ctx.sessionManager.getSessionId() ?? undefined;
+    for (;;) {
+        const cfg = loadRewindConfig();
+        const sessions = listSessions(sid);
+        const total = sessions.reduce((n, s) => n + s.bytes, 0);
+        const enabledLabel = `Rewind: ${cfg.enabled ? "on" : "off"}`;
+        const retentionLabel = `Auto-clean backups: ${cfg.retentionDays > 0 ? `after ${cfg.retentionDays} days` : "never (keep forever)"}`;
+        const storageLabel = `Storage: ${formatSize(total)} across ${sessions.length} session${sessions.length === 1 ? "" : "s"}`;
+        const pick = await ctx.ui.select("Rewind settings (Esc to close)", [enabledLabel, retentionLabel, storageLabel]);
+        if (!pick)
+            return;
+        if (pick === enabledLabel) {
+            saveRewindConfig({ ...cfg, enabled: !cfg.enabled });
+            ctx.ui.notify(`Rewind ${cfg.enabled ? "disabled" : "enabled"}.`, "info");
+        }
+        else if (pick === retentionLabel) {
+            await pickRetention(ctx);
+        }
+        else if (pick === storageLabel) {
+            await storageMenu(ctx, sid);
+        }
+    }
+}
+async function pickRetention(ctx) {
+    const options = [...RETENTION_PRESETS.map((d) => `${d} days`), "Keep forever", "Custom..."];
+    const pick = await ctx.ui.select("Auto-clean backups after", options);
+    if (!pick)
+        return;
+    let days;
+    if (pick === "Keep forever") {
+        days = 0;
+    }
+    else if (pick === "Custom...") {
+        const value = await ctx.ui.input("Days to keep backups (0 = forever)");
+        if (value === undefined)
+            return;
+        const n = Number.parseInt(value.trim(), 10);
+        if (!Number.isFinite(n) || n < 0) {
+            ctx.ui.notify("Invalid number of days.", "warning");
+            return;
+        }
+        days = n;
+    }
+    else {
+        days = Number.parseInt(pick, 10);
+    }
+    const cfg = loadRewindConfig();
+    saveRewindConfig({ ...cfg, retentionDays: days });
+    ctx.ui.notify(days > 0 ? `Backups now kept for ${days} days.` : "Backups kept forever.", "info");
+}
+async function storageMenu(ctx, sid) {
+    for (;;) {
+        const sessions = listSessions(sid);
+        const total = sessions.reduce((n, s) => n + s.bytes, 0);
+        const orphans = sessions.filter((s) => s.orphan);
+        const others = sessions.filter((s) => s.sessionId !== sid);
+        const cleanLabel = "Clean now (aged + orphaned)";
+        const orphanLabel = `Remove orphaned (${orphans.length})`;
+        const allLabel = `Remove all except current (${others.length})`;
+        const pick = await ctx.ui.select(`Rewind storage — ${formatSize(total)}, ${sessions.length} session${sessions.length === 1 ? "" : "s"} (Esc to close)`, [cleanLabel, orphanLabel, allLabel]);
+        if (!pick)
+            return;
+        if (pick === cleanLabel) {
+            const r = runGc(loadRewindConfig().retentionDays, sid);
+            ctx.ui.notify(r.removed > 0
+                ? `Removed ${r.removed} session(s), reclaimed ${formatSize(r.reclaimedBytes)}.`
+                : "Nothing to clean.", "info");
+        }
+        else if (pick === orphanLabel) {
+            if (orphans.length === 0) {
+                ctx.ui.notify("No orphaned backups.", "info");
+                continue;
+            }
+            const ok = await ctx.ui.confirm("Remove orphaned backups?", `Deletes backups for ${orphans.length} session(s) with no session file.`);
+            if (!ok)
+                continue;
+            let bytes = 0;
+            let removed = 0;
+            for (const s of orphans) {
+                const b = removeSession(s.sessionId);
+                if (b !== null) {
+                    bytes += b;
+                    removed++;
+                }
+            }
+            ctx.ui.notify(`Removed ${removed} orphaned session(s), reclaimed ${formatSize(bytes)}.`, "info");
+        }
+        else if (pick === allLabel) {
+            if (others.length === 0) {
+                ctx.ui.notify("No other sessions' backups.", "info");
+                continue;
+            }
+            const ok = await ctx.ui.confirm("Remove all other backups?", `Deletes backups for ${others.length} session(s), keeping only the current session.`);
+            if (!ok)
+                continue;
+            let bytes = 0;
+            let removed = 0;
+            for (const s of others) {
+                const b = removeSession(s.sessionId);
+                if (b !== null) {
+                    bytes += b;
+                    removed++;
+                }
+            }
+            ctx.ui.notify(`Removed ${removed} session(s), reclaimed ${formatSize(bytes)}.`, "info");
+        }
+    }
+}
+//# sourceMappingURL=menu.js.map

package/dist/extensions/rewind/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../../src/extensions/rewind/menu.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * menu.ts — the `/rewind` settings menu.\n *\n * Per the design, /rewind no longer performs the time-travel itself — restoring\n * files is fused into /tree navigation (see index.ts session_before_tree/\n * session_tree). /rewind is purely a settings + storage console:\n *   - toggle the master switch\n *   - set the auto-clean retention window\n *   - inspect and prune backup storage (aged / orphaned / all-but-current)\n */\nimport type { ExtensionCommandContext } from \"../../core/extensions/types.ts\";\n\nimport { loadRewindConfig, saveRewindConfig } from \"./config.ts\";\nimport { listSessions, removeSession, runGc } from \"./gc.ts\";\nimport { formatSize } from \"./text.ts\";\n\nconst RETENTION_PRESETS = [7, 14, 30, 60, 90];\n\nexport async function runRewindMenu(ctx: ExtensionCommandContext): Promise<void> {\n\tif (!ctx.hasUI) {\n\t\tctx.ui.notify(\"/rewind requires an interactive UI.\", \"warning\");\n\t\treturn;\n\t}\n\tconst sid = ctx.sessionManager.getSessionId() ?? undefined;\n\n\tfor (;;) {\n\t\tconst cfg = loadRewindConfig();\n\t\tconst sessions = listSessions(sid);\n\t\tconst total = sessions.reduce((n, s) => n + s.bytes, 0);\n\n\t\tconst enabledLabel = `Rewind: ${cfg.enabled ? \"on\" : \"off\"}`;\n\t\tconst retentionLabel = `Auto-clean backups: ${cfg.retentionDays > 0 ? `after ${cfg.retentionDays} days` : \"never (keep forever)\"}`;\n\t\tconst storageLabel = `Storage: ${formatSize(total)} across ${sessions.length} session${sessions.length === 1 ? \"\" : \"s\"}`;\n\n\t\tconst pick = await ctx.ui.select(\"Rewind settings (Esc to close)\", [enabledLabel, retentionLabel, storageLabel]);\n\t\tif (!pick) return;\n\n\t\tif (pick === enabledLabel) {\n\t\t\tsaveRewindConfig({ ...cfg, enabled: !cfg.enabled });\n\t\t\tctx.ui.notify(`Rewind ${cfg.enabled ? \"disabled\" : \"enabled\"}.`, \"info\");\n\t\t} else if (pick === retentionLabel) {\n\t\t\tawait pickRetention(ctx);\n\t\t} else if (pick === storageLabel) {\n\t\t\tawait storageMenu(ctx, sid);\n\t\t}\n\t}\n}\n\nasync function pickRetention(ctx: ExtensionCommandContext): Promise<void> {\n\tconst options = [...RETENTION_PRESETS.map((d) => `${d} days`), \"Keep forever\", \"Custom...\"];\n\tconst pick = await ctx.ui.select(\"Auto-clean backups after\", options);\n\tif (!pick) return;\n\n\tlet days: number;\n\tif (pick === \"Keep forever\") {\n\t\tdays = 0;\n\t} else if (pick === \"Custom...\") {\n\t\tconst value = await ctx.ui.input(\"Days to keep backups (0 = forever)\");\n\t\tif (value === undefined) return;\n\t\tconst n = Number.parseInt(value.trim(), 10);\n\t\tif (!Number.isFinite(n) || n < 0) {\n\t\t\tctx.ui.notify(\"Invalid number of days.\", \"warning\");\n\t\t\treturn;\n\t\t}\n\t\tdays = n;\n\t} else {\n\t\tdays = Number.parseInt(pick, 10);\n\t}\n\n\tconst cfg = loadRewindConfig();\n\tsaveRewindConfig({ ...cfg, retentionDays: days });\n\tctx.ui.notify(days > 0 ? `Backups now kept for ${days} days.` : \"Backups kept forever.\", \"info\");\n}\n\nasync function storageMenu(ctx: ExtensionCommandContext, sid: string | undefined): Promise<void> {\n\tfor (;;) {\n\t\tconst sessions = listSessions(sid);\n\t\tconst total = sessions.reduce((n, s) => n + s.bytes, 0);\n\t\tconst orphans = sessions.filter((s) => s.orphan);\n\t\tconst others = sessions.filter((s) => s.sessionId !== sid);\n\n\t\tconst cleanLabel = \"Clean now (aged + orphaned)\";\n\t\tconst orphanLabel = `Remove orphaned (${orphans.length})`;\n\t\tconst allLabel = `Remove all except current (${others.length})`;\n\n\t\tconst pick = await ctx.ui.select(\n\t\t\t`Rewind storage — ${formatSize(total)}, ${sessions.length} session${sessions.length === 1 ? \"\" : \"s\"} (Esc to close)`,\n\t\t\t[cleanLabel, orphanLabel, allLabel],\n\t\t);\n\t\tif (!pick) return;\n\n\t\tif (pick === cleanLabel) {\n\t\t\tconst r = runGc(loadRewindConfig().retentionDays, sid);\n\t\t\tctx.ui.notify(\n\t\t\t\tr.removed > 0\n\t\t\t\t\t? `Removed ${r.removed} session(s), reclaimed ${formatSize(r.reclaimedBytes)}.`\n\t\t\t\t\t: \"Nothing to clean.\",\n\t\t\t\t\"info\",\n\t\t\t);\n\t\t} else if (pick === orphanLabel) {\n\t\t\tif (orphans.length === 0) {\n\t\t\t\tctx.ui.notify(\"No orphaned backups.\", \"info\");\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst ok = await ctx.ui.confirm(\n\t\t\t\t\"Remove orphaned backups?\",\n\t\t\t\t`Deletes backups for ${orphans.length} session(s) with no session file.`,\n\t\t\t);\n\t\t\tif (!ok) continue;\n\t\t\tlet bytes = 0;\n\t\t\tlet removed = 0;\n\t\t\tfor (const s of orphans) {\n\t\t\t\tconst b = removeSession(s.sessionId);\n\t\t\t\tif (b !== null) {\n\t\t\t\t\tbytes += b;\n\t\t\t\t\tremoved++;\n\t\t\t\t}\n\t\t\t}\n\t\t\tctx.ui.notify(`Removed ${removed} orphaned session(s), reclaimed ${formatSize(bytes)}.`, \"info\");\n\t\t} else if (pick === allLabel) {\n\t\t\tif (others.length === 0) {\n\t\t\t\tctx.ui.notify(\"No other sessions' backups.\", \"info\");\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst ok = await ctx.ui.confirm(\n\t\t\t\t\"Remove all other backups?\",\n\t\t\t\t`Deletes backups for ${others.length} session(s), keeping only the current session.`,\n\t\t\t);\n\t\t\tif (!ok) continue;\n\t\t\tlet bytes = 0;\n\t\t\tlet removed = 0;\n\t\t\tfor (const s of others) {\n\t\t\t\tconst b = removeSession(s.sessionId);\n\t\t\t\tif (b !== null) {\n\t\t\t\t\tbytes += b;\n\t\t\t\t\tremoved++;\n\t\t\t\t}\n\t\t\t}\n\t\t\tctx.ui.notify(`Removed ${removed} session(s), reclaimed ${formatSize(bytes)}.`, \"info\");\n\t\t}\n\t}\n}\n"]}

package/dist/extensions/rewind/paths.d.ts

@@ -0,0 +1,4 @@
+export declare function rewindConfigPath(): string;
+export declare function rewindBackupsRoot(): string;
+export declare function sessionsDirectory(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/extensions/rewind/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/extensions/rewind/paths.ts"],"names":[],"mappings":"AAQA,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C","sourcesContent":["import { join } from \"node:path\";\n\nimport { getAgentDir } from \"../../config.ts\";\n\nfunction rewindDirectory(): string {\n\treturn join(getAgentDir(), \"rewind\");\n}\n\nexport function rewindConfigPath(): string {\n\treturn join(rewindDirectory(), \"config.json\");\n}\n\nexport function rewindBackupsRoot(): string {\n\treturn join(rewindDirectory(), \"backups\");\n}\n\nexport function sessionsDirectory(): string {\n\treturn join(getAgentDir(), \"sessions\");\n}\n"]}

package/dist/extensions/rewind/paths.js

@@ -0,0 +1,15 @@
+import { join } from "node:path";
+import { getAgentDir } from "../../config.js";
+function rewindDirectory() {
+    return join(getAgentDir(), "rewind");
+}
+export function rewindConfigPath() {
+    return join(rewindDirectory(), "config.json");
+}
+export function rewindBackupsRoot() {
+    return join(rewindDirectory(), "backups");
+}
+export function sessionsDirectory() {
+    return join(getAgentDir(), "sessions");
+}
+//# sourceMappingURL=paths.js.map

package/dist/extensions/rewind/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/extensions/rewind/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,SAAS,eAAe,GAAW;IAClC,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;AAAA,CACrC;AAED,MAAM,UAAU,gBAAgB,GAAW;IAC1C,OAAO,IAAI,CAAC,eAAe,EAAE,EAAE,aAAa,CAAC,CAAC;AAAA,CAC9C;AAED,MAAM,UAAU,iBAAiB,GAAW;IAC3C,OAAO,IAAI,CAAC,eAAe,EAAE,EAAE,SAAS,CAAC,CAAC;AAAA,CAC1C;AAED,MAAM,UAAU,iBAAiB,GAAW;IAC3C,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,UAAU,CAAC,CAAC;AAAA,CACvC","sourcesContent":["import { join } from \"node:path\";\n\nimport { getAgentDir } from \"../../config.ts\";\n\nfunction rewindDirectory(): string {\n\treturn join(getAgentDir(), \"rewind\");\n}\n\nexport function rewindConfigPath(): string {\n\treturn join(rewindDirectory(), \"config.json\");\n}\n\nexport function rewindBackupsRoot(): string {\n\treturn join(rewindDirectory(), \"backups\");\n}\n\nexport function sessionsDirectory(): string {\n\treturn join(getAgentDir(), \"sessions\");\n}\n"]}

package/dist/extensions/rewind/restore.d.ts

@@ -0,0 +1,37 @@
+/**
+ * restore.ts — map a /tree navigation target to the snapshot that should be
+ * restored and apply it via the engine.
+ */
+import { type ApplySnapshotOptions, type CoarseDiffStats } from "./engine.ts";
+import type { FileHistorySnapshot } from "./snapshot.ts";
+/** Minimal session view we need to walk the entry tree. */
+export interface EntryTreeView {
+    getEntry(id: string): {
+        id: string;
+        parentId: string | null;
+    } | undefined;
+}
+/** Collect the ancestor id set of `targetId` (inclusive), walking parentId to root. */
+export declare function ancestorIds(view: EntryTreeView, targetId: string): Set<string>;
+/**
+ * The snapshot that best matches navigating to `targetId`: the most recent
+ * snapshot (chronological) whose turn anchor (userEntryId) is an ancestor of, or
+ * equal to, the target. Undefined when no recorded turn precedes the target.
+ */
+export declare function snapshotForEntry(snapshots: FileHistorySnapshot[], view: EntryTreeView, targetId: string): FileHistorySnapshot | undefined;
+/**
+ * Absolute file paths restoring to this snapshot would change on disk (empty =
+ * none). Callers use the length for the count and the paths for the preview.
+ */
+export declare function snapshotChangedPaths(sessionId: string, snapshot: FileHistorySnapshot): Promise<string[]>;
+/**
+ * Coarse +N/−M line stats for the confirm dialog (paths must already be known
+ * changed — typically from snapshotChangedPaths).
+ */
+export declare function snapshotChangeDiffStats(sessionId: string, snapshot: FileHistorySnapshot, changedPaths: readonly string[]): Promise<CoarseDiffStats>;
+/**
+ * Restore the work tree to `snapshot` and return changed absolute paths.
+ * Pass `onlyPaths` from a prior snapshotChangedPaths call to skip re-compare.
+ */
+export declare function restoreToSnapshot(sessionId: string, snapshot: FileHistorySnapshot, opts?: ApplySnapshotOptions): Promise<string[]>;
+//# sourceMappingURL=restore.d.ts.map

package/dist/extensions/rewind/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../src/extensions/rewind/restore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACN,KAAK,oBAAoB,EAEzB,KAAK,eAAe,EAGpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,SAAS,CAAC;CAC1E;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAS9E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,mBAAmB,EAAE,EAChC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,MAAM,GACd,mBAAmB,GAAG,SAAS,CAOjC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAExG;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACtC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,mBAAmB,EAC7B,YAAY,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACtC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,CAAC,EAAE,oBAAoB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB","sourcesContent":["/**\n * restore.ts — map a /tree navigation target to the snapshot that should be\n * restored and apply it via the engine.\n */\nimport {\n\ttype ApplySnapshotOptions,\n\tapplySnapshot,\n\ttype CoarseDiffStats,\n\tcollectChangeDiffStats,\n\tcollectChanges,\n} from \"./engine.ts\";\nimport type { FileHistorySnapshot } from \"./snapshot.ts\";\n\n/** Minimal session view we need to walk the entry tree. */\nexport interface EntryTreeView {\n\tgetEntry(id: string): { id: string; parentId: string | null } | undefined;\n}\n\n/** Collect the ancestor id set of `targetId` (inclusive), walking parentId to root. */\nexport function ancestorIds(view: EntryTreeView, targetId: string): Set<string> {\n\tconst set = new Set<string>();\n\tlet cur: string | null = targetId;\n\tlet guard = 0;\n\twhile (cur && !set.has(cur) && guard++ < 100_000) {\n\t\tset.add(cur);\n\t\tcur = view.getEntry(cur)?.parentId ?? null;\n\t}\n\treturn set;\n}\n\n/**\n * The snapshot that best matches navigating to `targetId`: the most recent\n * snapshot (chronological) whose turn anchor (userEntryId) is an ancestor of, or\n * equal to, the target. Undefined when no recorded turn precedes the target.\n */\nexport function snapshotForEntry(\n\tsnapshots: FileHistorySnapshot[],\n\tview: EntryTreeView,\n\ttargetId: string,\n): FileHistorySnapshot | undefined {\n\tconst ancestors = ancestorIds(view, targetId);\n\tlet best: FileHistorySnapshot | undefined;\n\tfor (const snap of snapshots) {\n\t\tif (ancestors.has(snap.userEntryId)) best = snap; // snapshots are in chronological order\n\t}\n\treturn best;\n}\n\n/**\n * Absolute file paths restoring to this snapshot would change on disk (empty =\n * none). Callers use the length for the count and the paths for the preview.\n */\nexport function snapshotChangedPaths(sessionId: string, snapshot: FileHistorySnapshot): Promise<string[]> {\n\treturn collectChanges(sessionId, snapshot);\n}\n\n/**\n * Coarse +N/−M line stats for the confirm dialog (paths must already be known\n * changed — typically from snapshotChangedPaths).\n */\nexport function snapshotChangeDiffStats(\n\tsessionId: string,\n\tsnapshot: FileHistorySnapshot,\n\tchangedPaths: readonly string[],\n): Promise<CoarseDiffStats> {\n\treturn collectChangeDiffStats(sessionId, snapshot, changedPaths);\n}\n\n/**\n * Restore the work tree to `snapshot` and return changed absolute paths.\n * Pass `onlyPaths` from a prior snapshotChangedPaths call to skip re-compare.\n */\nexport async function restoreToSnapshot(\n\tsessionId: string,\n\tsnapshot: FileHistorySnapshot,\n\topts?: ApplySnapshotOptions,\n): Promise<string[]> {\n\treturn applySnapshot(sessionId, snapshot, opts);\n}\n"]}

package/dist/extensions/rewind/restore.js

@@ -0,0 +1,52 @@
+/**
+ * restore.ts — map a /tree navigation target to the snapshot that should be
+ * restored and apply it via the engine.
+ */
+import { applySnapshot, collectChangeDiffStats, collectChanges, } from "./engine.js";
+/** Collect the ancestor id set of `targetId` (inclusive), walking parentId to root. */
+export function ancestorIds(view, targetId) {
+    const set = new Set();
+    let cur = targetId;
+    let guard = 0;
+    while (cur && !set.has(cur) && guard++ < 100_000) {
+        set.add(cur);
+        cur = view.getEntry(cur)?.parentId ?? null;
+    }
+    return set;
+}
+/**
+ * The snapshot that best matches navigating to `targetId`: the most recent
+ * snapshot (chronological) whose turn anchor (userEntryId) is an ancestor of, or
+ * equal to, the target. Undefined when no recorded turn precedes the target.
+ */
+export function snapshotForEntry(snapshots, view, targetId) {
+    const ancestors = ancestorIds(view, targetId);
+    let best;
+    for (const snap of snapshots) {
+        if (ancestors.has(snap.userEntryId))
+            best = snap; // snapshots are in chronological order
+    }
+    return best;
+}
+/**
+ * Absolute file paths restoring to this snapshot would change on disk (empty =
+ * none). Callers use the length for the count and the paths for the preview.
+ */
+export function snapshotChangedPaths(sessionId, snapshot) {
+    return collectChanges(sessionId, snapshot);
+}
+/**
+ * Coarse +N/−M line stats for the confirm dialog (paths must already be known
+ * changed — typically from snapshotChangedPaths).
+ */
+export function snapshotChangeDiffStats(sessionId, snapshot, changedPaths) {
+    return collectChangeDiffStats(sessionId, snapshot, changedPaths);
+}
+/**
+ * Restore the work tree to `snapshot` and return changed absolute paths.
+ * Pass `onlyPaths` from a prior snapshotChangedPaths call to skip re-compare.
+ */
+export async function restoreToSnapshot(sessionId, snapshot, opts) {
+    return applySnapshot(sessionId, snapshot, opts);
+}
+//# sourceMappingURL=restore.js.map

package/dist/extensions/rewind/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/extensions/rewind/restore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEN,aAAa,EAEb,sBAAsB,EACtB,cAAc,GACd,MAAM,aAAa,CAAC;AAQrB,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAAC,IAAmB,EAAE,QAAgB,EAAe;IAC/E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,IAAI,GAAG,GAAkB,QAAQ,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AAAA,CACX;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC/B,SAAgC,EAChC,IAAmB,EACnB,QAAgB,EACkB;IAClC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,IAAI,IAAqC,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC;YAAE,IAAI,GAAG,IAAI,CAAC,CAAC,uCAAuC;IAC1F,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACZ;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,QAA6B,EAAqB;IACzG,OAAO,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAAA,CAC3C;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACtC,SAAiB,EACjB,QAA6B,EAC7B,YAA+B,EACJ;IAC3B,OAAO,sBAAsB,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AAAA,CACjE;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,SAAiB,EACjB,QAA6B,EAC7B,IAA2B,EACP;IACpB,OAAO,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AAAA,CAChD","sourcesContent":["/**\n * restore.ts — map a /tree navigation target to the snapshot that should be\n * restored and apply it via the engine.\n */\nimport {\n\ttype ApplySnapshotOptions,\n\tapplySnapshot,\n\ttype CoarseDiffStats,\n\tcollectChangeDiffStats,\n\tcollectChanges,\n} from \"./engine.ts\";\nimport type { FileHistorySnapshot } from \"./snapshot.ts\";\n\n/** Minimal session view we need to walk the entry tree. */\nexport interface EntryTreeView {\n\tgetEntry(id: string): { id: string; parentId: string | null } | undefined;\n}\n\n/** Collect the ancestor id set of `targetId` (inclusive), walking parentId to root. */\nexport function ancestorIds(view: EntryTreeView, targetId: string): Set<string> {\n\tconst set = new Set<string>();\n\tlet cur: string | null = targetId;\n\tlet guard = 0;\n\twhile (cur && !set.has(cur) && guard++ < 100_000) {\n\t\tset.add(cur);\n\t\tcur = view.getEntry(cur)?.parentId ?? null;\n\t}\n\treturn set;\n}\n\n/**\n * The snapshot that best matches navigating to `targetId`: the most recent\n * snapshot (chronological) whose turn anchor (userEntryId) is an ancestor of, or\n * equal to, the target. Undefined when no recorded turn precedes the target.\n */\nexport function snapshotForEntry(\n\tsnapshots: FileHistorySnapshot[],\n\tview: EntryTreeView,\n\ttargetId: string,\n): FileHistorySnapshot | undefined {\n\tconst ancestors = ancestorIds(view, targetId);\n\tlet best: FileHistorySnapshot | undefined;\n\tfor (const snap of snapshots) {\n\t\tif (ancestors.has(snap.userEntryId)) best = snap; // snapshots are in chronological order\n\t}\n\treturn best;\n}\n\n/**\n * Absolute file paths restoring to this snapshot would change on disk (empty =\n * none). Callers use the length for the count and the paths for the preview.\n */\nexport function snapshotChangedPaths(sessionId: string, snapshot: FileHistorySnapshot): Promise<string[]> {\n\treturn collectChanges(sessionId, snapshot);\n}\n\n/**\n * Coarse +N/−M line stats for the confirm dialog (paths must already be known\n * changed — typically from snapshotChangedPaths).\n */\nexport function snapshotChangeDiffStats(\n\tsessionId: string,\n\tsnapshot: FileHistorySnapshot,\n\tchangedPaths: readonly string[],\n): Promise<CoarseDiffStats> {\n\treturn collectChangeDiffStats(sessionId, snapshot, changedPaths);\n}\n\n/**\n * Restore the work tree to `snapshot` and return changed absolute paths.\n * Pass `onlyPaths` from a prior snapshotChangedPaths call to skip re-compare.\n */\nexport async function restoreToSnapshot(\n\tsessionId: string,\n\tsnapshot: FileHistorySnapshot,\n\topts?: ApplySnapshotOptions,\n): Promise<string[]> {\n\treturn applySnapshot(sessionId, snapshot, opts);\n}\n"]}