@gw-tools/gw 0.22.0-beta.1 → 0.25.0

package/README.md

@@ -771,6 +771,41 @@ gw install-shell --remove
 
 The `--remove` flag cleans up both the new eval-based format and any legacy file-based installations.
 
+#### Migrating from File-Based Integration
+
+If you previously used `gw install-shell` (before v0.22), you had file-based integration:
+
+- `~/.gw/shell/integration.zsh` (or `.bash`)
+- A source line in your shell config
+
+To migrate to the new eval-based approach:
+
+1. Remove old integration:
+
+   ```bash
+   gw install-shell --remove
+   ```
+
+2. Add new integration to your shell config:
+
+   ```bash
+   # Zsh (~/.zshrc)
+   eval "$(gw install-shell)"
+
+   # Bash (~/.bashrc)
+   eval "$(gw install-shell)"
+
+   # Fish (~/.config/fish/config.fish)
+   gw install-shell | source
+   ```
+
+3. Restart your terminal or source your config:
+   ```bash
+   source ~/.zshrc  # or ~/.bashrc
+   ```
+
+**Why the change?** The eval-based approach ensures shell integration stays up-to-date automatically when gw is updated, without requiring manual reinstallation.
+
 ### root
 
 Get the root directory of the current git repository. For git worktrees, returns the parent directory containing all worktrees.

package/install.js

@@ -197,13 +197,61 @@ function installShellIntegration() {
     return;
   }
 
-  // Check if already present
+  // Check if already present or needs migration
   if (fsExists(configFile)) {
-    const content = fsRead(configFile, 'utf8');
+    let content = fsRead(configFile, 'utf8');
+
+    // Check if new eval-based integration is already present
     if (content.includes('gw install-shell')) {
       console.log('✓ Shell integration already configured!');
       return;
     }
+
+    // Check for old source-based integration and migrate
+    const hasOldSource = content.includes('source ~/.gw/shell/integration') ||
+                         content.includes('source "$HOME/.gw/shell/integration');
+    if (hasOldSource) {
+      console.log('  Migrating from legacy file-based integration...');
+
+      // Remove old comment and source lines
+      const lines = content.split('\n');
+      const filtered = [];
+      let skipNext = false;
+
+      for (const line of lines) {
+        // Skip old comment line
+        if (line.includes('# gw-tools shell integration') && !line.includes('eval')) {
+          skipNext = true;
+          continue;
+        }
+        // Skip old source line
+        if (skipNext && line.includes('source') && line.includes('.gw/shell/integration')) {
+          skipNext = false;
+          continue;
+        }
+        skipNext = false;
+        filtered.push(line);
+      }
+
+      content = filtered.join('\n');
+      fsWrite(configFile, content);
+
+      // Remove old integration files
+      const legacyFiles = [
+        join(home, '.gw', 'shell', 'integration.zsh'),
+        join(home, '.gw', 'shell', 'integration.bash'),
+      ];
+      for (const file of legacyFiles) {
+        if (fsExists(file)) {
+          try {
+            require('fs').unlinkSync(file);
+            console.log(`  Removed legacy file: ${file}`);
+          } catch {
+            // Ignore removal errors
+          }
+        }
+      }
+    }
   }
 
   // Append eval line

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gw-tools/gw",
-  "version": "0.22.0-beta.1",
+  "version": "0.25.0",
   "description": "A command-line tool for managing git worktrees - copy files between worktrees with ease",
   "keywords": [
     "git",