pi-rewind-hook 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.3.0] - 2026-01-05
+
+### Breaking Changes
+- Requires pi v0.35.0+ (unified extensions system)
+- Install location changed from `hooks/rewind` to `extensions/rewind`
+
+### Changed
+- Migrated from hooks to unified extensions system
+- Settings key changed from `hooks` to `extensions`
+- Install script now migrates old hooks config and cleans up old directory
+- Renamed "Hook" to "Extension" throughout codebase and docs
+
 ## [1.2.0] - 2025-01-03
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
-# Rewind Hook
+# Rewind Extension
 
-A Pi agent hook that enables rewinding file changes during coding sessions. Creates automatic checkpoints using git refs, allowing you to restore files to previous states while optionally preserving conversation history.
+A Pi agent extension that enables rewinding file changes during coding sessions. Creates automatic checkpoints using git refs, allowing you to restore files to previous states while optionally preserving conversation history.
 
 ## Screenshots
 
@@ -10,7 +10,7 @@ A Pi agent hook that enables rewinding file changes during coding sessions. Crea
 
 ## Requirements
 
-- Pi agent v0.31+
+- Pi agent v0.35.0+ (unified extensions system)
 - Node.js (for installation)
 - Git repository (checkpoints are stored as git refs)
 
@@ -21,9 +21,11 @@ npx pi-rewind-hook
 ```
 
 This will:
-1. Create `~/.pi/agent/hooks/rewind/`
-2. Download the hook files
-3. Add the hook to your `~/.pi/agent/settings.json`
+1. Create `~/.pi/agent/extensions/rewind/`
+2. Download the extension files
+3. Add the extension to your `~/.pi/agent/settings.json`
+4. Migrate any existing hooks config to extensions (if upgrading from v1.2.0)
+5. Clean up old `hooks/rewind` directory (if present)
 
 ### Alternative Installation
 
@@ -36,14 +38,14 @@ curl -fsSL https://raw.githubusercontent.com/nicobailon/pi-rewind-hook/main/inst
 Or clone the repo and configure manually:
 
 ```bash
-git clone https://github.com/nicobailon/pi-rewind-hook ~/.pi/agent/hooks/rewind
+git clone https://github.com/nicobailon/pi-rewind-hook ~/.pi/agent/extensions/rewind
 ```
 
 Then add to `~/.pi/agent/settings.json`:
 
 ```json
 {
-  "hooks": ["~/.pi/agent/hooks/rewind/index.ts"]
+  "extensions": ["~/.pi/agent/extensions/rewind/index.ts"]
 }
 ```
 
@@ -55,11 +57,20 @@ Then add to `~/.pi/agent/settings.json`:
 Invoke-WebRequest -Uri "https://raw.githubusercontent.com/nicobailon/pi-rewind-hook/main/install.js" -OutFile install.js; node install.js; Remove-Item install.js
 ```
 
+### Upgrading from v1.2.0
+
+If you're upgrading from pi-rewind-hook v1.2.0 (which used the hooks system), simply run `npx pi-rewind-hook` again. The installer will:
+- Move the extension from `hooks/rewind` to `extensions/rewind`
+- Migrate your settings.json from `hooks` to `extensions`
+- Clean up the old hooks directory
+
+**Note:** v1.3.0+ requires pi v0.35.0 or later. If you're on an older version of pi, stay on pi-rewind-hook v1.2.0.
+
 ## How It Works
 
 ### Checkpoints
 
-The hook creates git refs at two points:
+The extension creates git refs at two points:
 
 1. **Session start** - When pi starts, creates a "resume checkpoint" of the current file state
 2. **Each turn** - Before the agent processes each message, creates a checkpoint
@@ -100,7 +111,7 @@ To rewind via tree navigation:
 
 ### Resumed Sessions
 
-When you resume a session (`pi --resume`), the hook creates a resume checkpoint. If you branch to a message from before the current session, you can restore files to the state when you resumed (not per-message granularity, but a safety net).
+When you resume a session (`pi --resume`), the extension creates a resume checkpoint. If you branch to a message from before the current session, you can restore files to the state when you resumed (not per-message granularity, but a safety net).
 
 ## Examples
 
@@ -165,15 +176,15 @@ git for-each-ref --format='%(refname)' refs/pi-checkpoints/ | xargs -n1 git upda
 
 ## Uninstalling
 
-1. Remove the hook directory:
+1. Remove the extension directory:
    ```bash
-   rm -rf ~/.pi/agent/hooks/rewind
+   rm -rf ~/.pi/agent/extensions/rewind
    ```
-   On Windows (PowerShell): `Remove-Item -Recurse -Force ~/.pi/agent/hooks/rewind`
+   On Windows (PowerShell): `Remove-Item -Recurse -Force ~/.pi/agent/extensions/rewind`
 
-2. Remove the hook from `~/.pi/agent/settings.json` (delete the line with `rewind/index.ts` from the `hooks` array)
+2. Remove the extension from `~/.pi/agent/settings.json` (delete the line with `rewind/index.ts` from the `extensions` array)
 
-3. Optionally, clean up git refs in each repo where you used the hook:
+3. Optionally, clean up git refs in each repo where you used the extension:
    ```bash
    git for-each-ref --format='%(refname)' refs/pi-checkpoints/ | xargs -n1 git update-ref -d
    ```

package/index.ts

@@ -1,13 +1,13 @@
 /**
- * Rewind Hook - Git-based file restoration for pi branching
+ * Rewind Extension - Git-based file restoration for pi branching
  *
  * Creates worktree snapshots at each turn so /branch can restore code state.
  * Supports: restore files + conversation, files only, conversation only, undo last restore.
  *
- * Updated for pi-coding-agent v0.31+ (granular session events API)
+ * Updated for pi-coding-agent v0.35.0+ (unified extensions system)
  */
 
-import type { HookAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { exec as execCb } from "child_process";
 import { mkdtemp, rm } from "fs/promises";
 import { tmpdir } from "os";
@@ -22,14 +22,14 @@ const MAX_CHECKPOINTS = 100;
 
 type ExecFn = (cmd: string, args: string[]) => Promise<{ stdout: string; stderr: string; code: number }>;
 
-export default function (pi: HookAPI) {
+export default function (pi: ExtensionAPI) {
   const checkpoints = new Map<string, string>();
   let currentEntryId: string | undefined;
   let resumeCheckpoint: string | null = null;
   let repoRoot: string | null = null;
   let isGitRepo = false;
 
-  console.error(`[rewind] Hook loaded`);
+  console.error(`[rewind] Extension loaded`);
 
   async function findBeforeRestoreRef(exec: ExecFn): Promise<{ refName: string; commitSha: string } | null> {
     try {

package/install.js

@@ -6,9 +6,10 @@ const https = require("https");
 const os = require("os");
 
 const REPO_URL = "https://raw.githubusercontent.com/nicobailon/pi-rewind-hook/main";
-const HOOK_DIR = path.join(os.homedir(), ".pi", "agent", "hooks", "rewind");
+const EXT_DIR = path.join(os.homedir(), ".pi", "agent", "extensions", "rewind");
+const OLD_HOOK_DIR = path.join(os.homedir(), ".pi", "agent", "hooks", "rewind");
 const SETTINGS_FILE = path.join(os.homedir(), ".pi", "agent", "settings.json");
-const HOOK_PATH = "~/.pi/agent/hooks/rewind/index.ts";
+const EXT_PATH = "~/.pi/agent/extensions/rewind/index.ts";
 
 function download(url) {
   return new Promise((resolve, reject) => {
@@ -28,22 +29,19 @@ function download(url) {
 }
 
 async function main() {
-  console.log("Installing pi-rewind-hook...\n");
+  console.log("Installing pi-rewind-hook (Rewind Extension)...\n");
 
-  // Create hook directory
-  console.log(`Creating directory: ${HOOK_DIR}`);
-  fs.mkdirSync(HOOK_DIR, { recursive: true });
+  fs.mkdirSync(EXT_DIR, { recursive: true });
+  console.log(`Created directory: ${EXT_DIR}`);
 
-  // Download hook files
   console.log("Downloading index.ts...");
-  const hookContent = await download(`${REPO_URL}/index.ts`);
-  fs.writeFileSync(path.join(HOOK_DIR, "index.ts"), hookContent);
+  const extContent = await download(`${REPO_URL}/index.ts`);
+  fs.writeFileSync(path.join(EXT_DIR, "index.ts"), extContent);
 
   console.log("Downloading README.md...");
   const readmeContent = await download(`${REPO_URL}/README.md`);
-  fs.writeFileSync(path.join(HOOK_DIR, "README.md"), readmeContent);
+  fs.writeFileSync(path.join(EXT_DIR, "README.md"), readmeContent);
 
-  // Update settings.json
   console.log(`\nUpdating settings: ${SETTINGS_FILE}`);
   
   let settings = {};
@@ -56,25 +54,54 @@ async function main() {
     }
   }
 
-  // Ensure hooks array exists
-  if (!Array.isArray(settings.hooks)) {
-    settings.hooks = [];
+  if (settings.hooks && Array.isArray(settings.hooks) && settings.hooks.length > 0) {
+    console.log("\nMigrating hooks to extensions...");
+    if (!Array.isArray(settings.extensions)) {
+      settings.extensions = [];
+    }
+    for (const entry of settings.hooks) {
+      if (entry.includes("/hooks/rewind")) {
+        continue;
+      }
+      const newPath = entry.replace("/hooks/", "/extensions/");
+      if (!settings.extensions.includes(newPath)) {
+        settings.extensions.push(newPath);
+        console.log(`  Migrated: ${entry} -> ${newPath}`);
+      }
+    }
+    delete settings.hooks;
+    console.log("Removed old 'hooks' key from settings");
+  }
+
+  if (!Array.isArray(settings.extensions)) {
+    settings.extensions = [];
   }
 
-  // Add hook if not already present
-  if (!settings.hooks.includes(HOOK_PATH)) {
-    settings.hooks.push(HOOK_PATH);
-    
-    // Ensure parent directory exists
-    fs.mkdirSync(path.dirname(SETTINGS_FILE), { recursive: true });
-    fs.writeFileSync(SETTINGS_FILE, JSON.stringify(settings, null, 2) + "\n");
-    console.log(`Added "${HOOK_PATH}" to hooks array`);
+  const EXT_PATH_ALT = "~/.pi/agent/extensions/rewind";
+  const hasRewindExt = settings.extensions.some(p => 
+    p === EXT_PATH || p === EXT_PATH_ALT || 
+    p.includes("/extensions/rewind/index.ts") || 
+    p.endsWith("/extensions/rewind")
+  );
+
+  if (!hasRewindExt) {
+    settings.extensions.push(EXT_PATH);
+    console.log(`Added "${EXT_PATH}" to extensions array`);
   } else {
-    console.log("Hook already configured in settings.json");
+    console.log("Extension already configured in settings.json");
+  }
+
+  fs.mkdirSync(path.dirname(SETTINGS_FILE), { recursive: true });
+  fs.writeFileSync(SETTINGS_FILE, JSON.stringify(settings, null, 2) + "\n");
+
+  if (fs.existsSync(OLD_HOOK_DIR)) {
+    console.log(`\nCleaning up old hooks directory: ${OLD_HOOK_DIR}`);
+    fs.rmSync(OLD_HOOK_DIR, { recursive: true, force: true });
+    console.log("Removed old hooks/rewind directory");
   }
 
   console.log("\nInstallation complete!");
-  console.log("\nThe rewind hook will load automatically when you start pi.");
+  console.log("\nThe rewind extension will load automatically when you start pi.");
   console.log("Use /branch to rewind to a previous checkpoint.");
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-rewind-hook",
-  "version": "1.2.0",
-  "description": "Rewind hook for Pi agent - automatic git checkpoints with file/conversation restore",
+  "version": "1.3.0",
+  "description": "Rewind extension for Pi agent - automatic git checkpoints with file/conversation restore",
   "bin": {
     "pi-rewind-hook": "./install.js"
   },
@@ -12,11 +12,14 @@
   "keywords": [
     "pi",
     "pi-agent",
-    "hook",
+    "extension",
     "checkpoint",
     "rewind",
     "git"
   ],
   "author": "nicobailon",
-  "license": "MIT"
+  "license": "MIT",
+  "pi": {
+    "extensions": ["./index.ts"]
+  }
 }