aidevops 2.59.0 → 2.60.1

package/README.md

@@ -57,7 +57,7 @@ The result: AI agents that work *with* your development process, not around it.
 [![GitHub commits since latest release](https://img.shields.io/github/commits-since/marcusquinn/aidevops/latest)](https://github.com/marcusquinn/aidevops/commits/main)
 
 <!-- Repository Stats -->
-[![Version](https://img.shields.io/badge/Version-2.59.0-blue)](https://github.com/marcusquinn/aidevops/releases)
+[![Version](https://img.shields.io/badge/Version-2.60.1-blue)](https://github.com/marcusquinn/aidevops/releases)
 [![GitHub repo size](https://img.shields.io/github/repo-size/marcusquinn/aidevops?style=flat&color=blue)](https://github.com/marcusquinn/aidevops)
 [![Lines of code](https://img.shields.io/badge/Lines%20of%20Code-18%2C000%2B-brightgreen)](https://github.com/marcusquinn/aidevops)
 [![GitHub language count](https://img.shields.io/github/languages/count/marcusquinn/aidevops)](https://github.com/marcusquinn/aidevops)
@@ -445,13 +445,33 @@ See `.agent/aidevops/architecture.md` for detailed implementation notes and refe
 
 ```bash
 # Install dependencies (auto-detected by setup.sh)
-brew install sshpass jq curl mkcert dnsmasq  # macOS
-sudo apt-get install sshpass jq curl dnsmasq  # Ubuntu/Debian
+brew install sshpass jq curl mkcert dnsmasq fd ripgrep  # macOS
+sudo apt-get install sshpass jq curl dnsmasq fd-find ripgrep  # Ubuntu/Debian
 
 # Generate SSH key
 ssh-keygen -t ed25519 -C "your-email@domain.com"
 ```
 
+### **File Discovery Tools**
+
+AI agents use fast file discovery tools for efficient codebase navigation:
+
+| Tool | Purpose | Speed |
+|------|---------|-------|
+| `fd` | Fast file finder (replaces `find`) | ~10x faster |
+| `ripgrep` | Fast content search (replaces `grep`) | ~10x faster |
+
+Both tools respect `.gitignore` by default and are written in Rust for maximum performance.
+
+**Preference order for file discovery:**
+
+1. `git ls-files '*.md'` - Instant, git-tracked files only
+2. `fd -e md` - Fast, respects .gitignore
+3. `rg --files -g '*.md'` - Fast, respects .gitignore
+4. Built-in glob tools - Fallback when bash unavailable
+
+The setup script offers to install these tools automatically.
+
 ## **Comprehensive Service Coverage**
 
 ### **Infrastructure & Hosting**
@@ -1124,17 +1144,32 @@ See `.agent/scripts/commands/full-loop.md` for complete documentation.
 
 Work on multiple branches simultaneously without stashing or switching. Each branch gets its own directory.
 
-**Quick usage:**
+**Recommended: [Worktrunk](https://worktrunk.dev)** (`wt`) - Git worktree management with shell integration, CI status, and PR links:
 
 ```bash
-# Create worktree for a new branch
-~/.aidevops/agents/scripts/worktree-helper.sh add feature/my-feature
-# Creates: ~/Git/aidevops-feature-my-feature/
+# Install (macOS/Linux)
+brew install max-sixty/worktrunk/wt && wt config shell install
+# Restart your shell for shell integration to take effect
 
-# List all worktrees
-~/.aidevops/agents/scripts/worktree-helper.sh list
+# Create worktree + cd into it
+wt switch -c feature/my-feature
 
-# Clean up after merge
+# Create worktree + start any AI CLI (-x runs command after switch)
+wt switch -c -x claude feature/ai-task
+
+# List worktrees with CI status and PR links
+wt list
+
+# Merge + cleanup (squash/rebase options)
+wt merge
+```
+
+**Fallback** (no dependencies):
+
+```bash
+~/.aidevops/agents/scripts/worktree-helper.sh add feature/my-feature
+# Creates: ~/Git/{repo}-feature-my-feature/ (cd there manually)
+~/.aidevops/agents/scripts/worktree-helper.sh list
 ~/.aidevops/agents/scripts/worktree-helper.sh clean
 ```
 
@@ -1142,11 +1177,11 @@ Work on multiple branches simultaneously without stashing or switching. Each bra
 - Run tests on one branch while coding on another
 - Compare implementations side-by-side
 - No context switching or stash management
-- Each OpenCode session can work on a different branch
+- Each AI session can work on a different branch
 
 **Worktree-first workflow:** The pre-edit check now **enforces** worktrees as the default when creating branches, keeping your main directory on `main`. This prevents uncommitted changes from blocking branch switches and ensures parallel sessions don't inherit wrong branch state.
 
-See `.agent/workflows/worktree.md` for the complete guide.
+See `.agent/workflows/worktree.md` for the complete guide and `.agent/tools/git/worktrunk.md` for Worktrunk documentation.
 
 ### Session Management - Parallel AI Sessions
 
@@ -1170,9 +1205,11 @@ opencode --non-interactive --prompt "Continue with feature X" &
 # New terminal tab (macOS)
 osascript -e 'tell application "Terminal" to do script "cd ~/Git/project && opencode"'
 
-# Worktree-based (isolated branch)
-~/.aidevops/agents/scripts/worktree-helper.sh add feature/next-feature
-cd ../project-feature-next-feature && opencode
+# Worktree-based (isolated branch) - recommended
+wt switch -c -x opencode feature/next-feature  # Worktrunk: create + start AI CLI
+# Or fallback:
+# ~/.aidevops/agents/scripts/worktree-helper.sh add feature/next-feature
+# cd ~/Git/{repo}-feature-next-feature && opencode
 ```
 
 **Session handoff pattern:**

package/VERSION

@@ -1 +1 @@
-2.59.0
+2.60.1

package/aidevops.sh

@@ -3,7 +3,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 2.59.0
+# Version: 2.60.1
 
 set -euo pipefail
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "2.59.0",
+  "version": "2.60.1",
   "description": "AI DevOps Framework - AI-assisted development workflows, code quality, and deployment automation",
   "type": "module",
   "main": "index.js",

package/setup.sh

@@ -3,7 +3,7 @@
 # AI Assistant Server Access Framework Setup Script
 # Helps developers set up the framework for their infrastructure
 #
-# Version: 2.59.0
+# Version: 2.60.1
 #
 # Quick Install (one-liner):
 #   bash <(curl -fsSL https://aidevops.dev/install)
@@ -562,6 +562,109 @@ setup_git_clis() {
     return 0
 }
 
+# Setup file discovery tools (fd, ripgrep) for efficient file searching
+setup_file_discovery_tools() {
+    print_info "Setting up file discovery tools..."
+    
+    local missing_tools=()
+    local missing_packages=()
+    local missing_names=()
+    
+    # Check for fd (fd-find)
+    if ! command -v fd >/dev/null 2>&1; then
+        missing_tools+=("fd")
+        missing_packages+=("fd")
+        missing_names+=("fd (fast file finder)")
+    else
+        local fd_version
+        fd_version=$(fd --version 2>/dev/null | head -1 || echo "unknown")
+        print_success "fd found: $fd_version"
+    fi
+    
+    # Check for ripgrep
+    if ! command -v rg >/dev/null 2>&1; then
+        missing_tools+=("rg")
+        missing_packages+=("ripgrep")
+        missing_names+=("ripgrep (fast content search)")
+    else
+        local rg_version
+        rg_version=$(rg --version 2>/dev/null | head -1 || echo "unknown")
+        print_success "ripgrep found: $rg_version"
+    fi
+    
+    # Offer to install missing tools
+    if [[ ${#missing_tools[@]} -gt 0 ]]; then
+        print_warning "Missing file discovery tools: ${missing_names[*]}"
+        echo ""
+        echo "  These tools provide 10x faster file discovery than built-in glob:"
+        echo "    fd      - Fast alternative to 'find', respects .gitignore"
+        echo "    ripgrep - Fast alternative to 'grep', respects .gitignore"
+        echo ""
+        echo "  AI agents use these for efficient codebase navigation."
+        echo ""
+        
+        local pkg_manager
+        pkg_manager=$(detect_package_manager)
+        
+        if [[ "$pkg_manager" != "unknown" ]]; then
+            read -r -p "Install file discovery tools (${missing_packages[*]}) using $pkg_manager? (y/n): " install_fd_tools
+            
+            if [[ "$install_fd_tools" == "y" ]]; then
+                print_info "Installing ${missing_packages[*]}..."
+                
+                # Handle package name differences across package managers
+                local actual_packages=()
+                for pkg in "${missing_packages[@]}"; do
+                    case "$pkg_manager" in
+                        apt)
+                            # Debian/Ubuntu uses fd-find instead of fd
+                            if [[ "$pkg" == "fd" ]]; then
+                                actual_packages+=("fd-find")
+                            else
+                                actual_packages+=("$pkg")
+                            fi
+                            ;;
+                        *)
+                            actual_packages+=("$pkg")
+                            ;;
+                    esac
+                done
+                
+                if install_packages "$pkg_manager" "${actual_packages[@]}"; then
+                    print_success "File discovery tools installed"
+                    
+                    # On Debian/Ubuntu, fd is installed as fdfind - create alias
+                    if [[ "$pkg_manager" == "apt" ]] && command -v fdfind >/dev/null 2>&1 && ! command -v fd >/dev/null 2>&1; then
+                        print_info "Note: On Debian/Ubuntu, fd is installed as 'fdfind'"
+                        echo "  Consider adding to your shell config: alias fd=fdfind"
+                    fi
+                else
+                    print_warning "Failed to install some file discovery tools (non-critical)"
+                fi
+            else
+                print_info "Skipped file discovery tools installation"
+                echo ""
+                echo "  Manual installation:"
+                echo "    macOS:        brew install fd ripgrep"
+                echo "    Ubuntu/Debian: sudo apt install fd-find ripgrep"
+                echo "    Fedora:       sudo dnf install fd-find ripgrep"
+                echo "    Arch:         sudo pacman -S fd ripgrep"
+            fi
+        else
+            echo ""
+            echo "  Manual installation:"
+            echo "    macOS:        brew install fd ripgrep"
+            echo "    Ubuntu/Debian: sudo apt install fd-find ripgrep"
+            echo "    Fedora:       sudo dnf install fd-find ripgrep"
+            echo "    Arch:         sudo pacman -S fd ripgrep"
+        fi
+    else
+        print_success "All file discovery tools installed!"
+    fi
+    
+    return 0
+}
+
 # Setup Worktrunk - Git worktree management for parallel AI agent workflows
 setup_worktrunk() {
     print_info "Setting up Worktrunk (git worktree management)..."
@@ -2439,6 +2542,7 @@ main() {
     confirm_step "Check optional dependencies (bun, node, python)" && check_optional_deps
     confirm_step "Setup recommended tools (Tabby, Zed, etc.)" && setup_recommended_tools
     confirm_step "Setup Git CLIs (gh, glab, tea)" && setup_git_clis
+    confirm_step "Setup file discovery tools (fd, ripgrep)" && setup_file_discovery_tools
     confirm_step "Setup Worktrunk (git worktree management)" && setup_worktrunk
     confirm_step "Setup SSH key" && setup_ssh_key
     confirm_step "Setup configuration files" && setup_configs