chore: sync tools from main repository for v1.5.0

Complete interactive_utils migration with enhanced CI/automation support - eliminates EOF errors in CI/CD environments

Author: Vaibhav-api-code

.pytoolsrc

@@ -8,7 +8,7 @@
 # Author: Vaibhav-api-code
 # Co-Author: Claude Code (https://claude.ai/code)
 # Created: 2025-07-24
-# Updated: 2025-07-24
+# Updated: 2025-07-28  # v1.5.0 - Enhanced CI/automation support
 # License: Mozilla Public License 2.0 (MPL-2.0)
 
 [defaults]
@@ -26,6 +26,11 @@ assume_yes = false          # Require explicit confirmation
 force = false              # Never auto-confirm dangerous operations
 auto_confirm = false       # Require user interaction by default
 
+# v1.5.0 - Enhanced interactive behavior
+interactive_mode = true    # Allow interactive prompts by default
+ci_detection = true        # Auto-detect CI environments
+quiet_errors = false       # Show full error messages with hints
+
 # Development-friendly settings
 verbose = false            # Set to true for debugging
 dry_run = false           # Set to true to preview operations
@@ -87,22 +92,72 @@ show_dirs = true
 show_recent = true
 show_empty = false
 
-[replace_text]
-# Text replacement defaults
+[replace_text_v9]
+# Text replacement defaults (v9 with undo support)
 backup = true                        # Always backup before replacing
 whole_word = false
 dry_run = false
 check_compile = true
+track_undo = true                    # Enable undo tracking by default
+interpret_escapes = false            # Enable with --interpret-escapes flag
 # For automation, set these in environment or use --yes flag
 non_interactive = false
 assume_yes = false
 
-[replace_text_ast]
-# AST-based refactoring defaults
+[replace_text]
+# Legacy alias - redirects to v9 settings
+backup = true
+track_undo = true
+non_interactive = false
+assume_yes = false
+
+[replace_text_ast_v3]
+# AST-based refactoring defaults (v3 with undo support)
 dry_run = false
 backup = true
 language = auto                      # Auto-detect language
 check_compile = true
+track_undo = true                    # Enable undo tracking
+scope_aware = true                   # Enhanced scope analysis
+# v1.5.0 - Interactive support
+non_interactive = false
+assume_yes = false
+
+[replace_text_ast]
+# Legacy alias - redirects to v3 settings
+dry_run = false
+backup = true
+track_undo = true
+non_interactive = false
+assume_yes = false
+
+[text_undo]
+# Text undo system defaults (v1.5.0 - interactive_utils support)
+non_interactive = false
+assume_yes = false
+allow_interactive_selection = true   # Allow numbered menu selections
+max_history_days = 30                # Keep undo history for 30 days
+auto_cleanup = true                  # Automatically clean old entries
+
+[unified_refactor_v2]
+# Universal refactoring defaults (v2 with undo support)
+backend = auto                       # Auto-detect: java_scope for .java, python_ast for .py
+dry_run = false
+backup = true
+check_compile = true
+track_undo = true                    # Enable undo tracking
+# v1.5.0 - Interactive support
+non_interactive = false
+assume_yes = false
+
+[unified_refactor]
+# Legacy alias - redirects to v2 settings
+backend = auto                       # Auto-detect backend based on file type
+dry_run = false
+backup = true
+track_undo = true
+non_interactive = false
+assume_yes = false
 
 [navigate_ast]
 # AST navigation defaults
@@ -197,19 +252,56 @@ format = text
 #
 # Then use: export PYTOOLSRC=.pytoolsrc.ci
 
-# ===== ENVIRONMENT VARIABLE OVERRIDES =====
+# ===== ENVIRONMENT VARIABLE OVERRIDES (v1.5.0) =====
 # These override config file settings:
 #
 # SFM_ASSUME_YES=1                   - Auto-confirm safe_file_manager
 # SAFEGIT_NONINTERACTIVE=1           - Non-interactive git operations
 # PYTOOLSRC_NON_INTERACTIVE=1        - Global non-interactive mode
 # PYTOOLSRC=/path/to/config          - Use different config file
+#
+# Tool-specific variables (v1.5.0):
+# TEXT_UNDO_ASSUME_YES=1             - Auto-confirm text_undo operations
+# REPLACE_TEXT_ASSUME_YES=1          - Auto-confirm replace operations
+# REPLACE_TEXT_AST_ASSUME_YES=1      - Auto-confirm AST refactoring
+# UNIFIED_REFACTOR_ASSUME_YES=1      - Auto-confirm refactoring
 
 # ===== QUICK AUTOMATION SETUP =====
 # For temporary automation without changing this file:
 #
 # export SFM_ASSUME_YES=1
 # export SAFEGIT_NONINTERACTIVE=1
 # export SAFEGIT_ASSUME_YES=1
+# export TEXT_UNDO_ASSUME_YES=1
+# export REPLACE_TEXT_ASSUME_YES=1
+# export REPLACE_TEXT_AST_ASSUME_YES=1
+# export UNIFIED_REFACTOR_ASSUME_YES=1
 # # Run your automated tasks...
-# unset SFM_ASSUME_YES SAFEGIT_NONINTERACTIVE SAFEGIT_ASSUME_YES
+# unset SFM_ASSUME_YES SAFEGIT_NONINTERACTIVE SAFEGIT_ASSUME_YES TEXT_UNDO_ASSUME_YES REPLACE_TEXT_ASSUME_YES REPLACE_TEXT_AST_ASSUME_YES UNIFIED_REFACTOR_ASSUME_YES
+
+# ===== CI/CD AUTOMATION PROFILE =====
+# Complete environment setup for CI/CD environments
+# Copy to .pytoolsrc.ci or export these variables:
+#
+# # Core automation
+# export PYTOOLSRC_NON_INTERACTIVE=1
+# export CI=true
+# export DISABLE_ERROR_LOGGING=1  # Optional: disable error logging in CI
+#
+# # File operations
+# export SFM_ASSUME_YES=1
+# export SFM_NON_INTERACTIVE=1
+#
+# # Git operations  
+# export SAFEGIT_NONINTERACTIVE=1
+# export SAFEGIT_ASSUME_YES=1
+#
+# # Text operations with undo
+# export TEXT_UNDO_ASSUME_YES=1
+# export REPLACE_TEXT_ASSUME_YES=1
+# export REPLACE_TEXT_AST_ASSUME_YES=1
+# export UNIFIED_REFACTOR_ASSUME_YES=1
+#
+# # Analysis tools
+# export FIND_TEXT_NON_INTERACTIVE=1
+# export NAVIGATE_AST_NON_INTERACTIVE=1

.pytoolsrc.README.md

@@ -0,0 +1,164 @@
+# Configuration Files for Code Intelligence Toolkit v1.5.0
+
+This directory contains multiple `.pytoolsrc` configuration files for different use cases.
+
+## Available Configurations
+
+### 1. `.pytoolsrc` (Default - Development)
+- **Purpose**: Interactive development with safety
+- **Mode**: Interactive with confirmations
+- **Best for**: Day-to-day development work
+- **Usage**: Default configuration (no setup needed)
+
+### 2. `.pytoolsrc.ci` (CI/CD Environments)
+- **Purpose**: Continuous integration and automated testing
+- **Mode**: Fully non-interactive, auto-confirm safe operations
+- **Best for**: GitHub Actions, GitLab CI, Jenkins, automated testing
+- **Usage**: `export PYTOOLSRC=.pytoolsrc.ci`
+
+### 3. `.pytoolsrc.automation` (General Automation)
+- **Purpose**: Local automation and batch processing
+- **Mode**: Non-interactive but keeps output for debugging
+- **Best for**: Scripts, batch operations, local automation
+- **Usage**: `export PYTOOLSRC=.pytoolsrc.automation`
+
+### 4. `.pytoolsrc.safe` (Maximum Safety)
+- **Purpose**: Maximum safety with extensive validation
+- **Mode**: Interactive with dry-run by default
+- **Best for**: Production changes, critical code, learning
+- **Usage**: `export PYTOOLSRC=.pytoolsrc.safe`
+
+## Quick Setup Examples
+
+### CI/CD (GitHub Actions)
+```yaml
+env:
+  PYTOOLSRC: .pytoolsrc.ci
+steps:
+  - run: ./run_any_python_tool.sh safe_file_manager.py organize src/
+```
+
+### Local Automation Script
+```bash
+#\!/bin/bash
+export PYTOOLSRC=.pytoolsrc.automation
+
+# Your automated operations
+./run_any_python_tool.sh replace_text_v9.py "TODO" "DONE" --scope src/
+./run_any_python_tool.sh safe_file_manager.py organize ~/Downloads
+```
+
+### Safe Mode for Critical Changes
+```bash
+export PYTOOLSRC=.pytoolsrc.safe
+./run_any_python_tool.sh replace_text_v9.py "oldAPI" "newAPI" --scope src/
+# Will preview changes and ask for confirmation
+```
+
+## Environment Variable Overrides
+
+You can override specific settings with environment variables (highest priority):
+
+```bash
+# Force non-interactive mode for any tool
+export PYTOOLSRC_NON_INTERACTIVE=1
+
+# Tool-specific overrides
+export SFM_ASSUME_YES=1                    # safe_file_manager
+export SAFEGIT_NONINTERACTIVE=1            # safegit
+export TEXT_UNDO_ASSUME_YES=1              # text_undo
+export REPLACE_TEXT_ASSUME_YES=1           # replace_text_v9
+export REPLACE_TEXT_AST_ASSUME_YES=1       # replace_text_ast_v3
+export UNIFIED_REFACTOR_ASSUME_YES=1       # unified_refactor_v2
+```
+
+## Configuration Priority
+
+Tools check settings in this order (first found wins):
+
+1. **Command-line flags** (e.g., `--yes`, `--non-interactive`)
+2. **Environment variables** (e.g., `TOOL_NAME_ASSUME_YES=1`)
+3. **Configuration file** (specified by `PYTOOLSRC`)
+4. **Default config** (`.pytoolsrc`)
+5. **Tool defaults** (interactive mode)
+
+## v1.5.0 Features
+
+All configurations support the new interactive_utils features:
+
+- ✅ **EOF Error Elimination**: No more "EOF when reading a line" crashes
+- ✅ **Auto CI Detection**: Automatically detects CI environments
+- ✅ **Unified Behavior**: Same patterns work across all migrated tools
+- ✅ **Clear Error Messages**: Actionable hints when interaction is required
+- ✅ **Multiple Prompt Types**: Yes/no, typed phrases, numbered selections
+- ✅ **Language-Aware Backends**: Auto-detects Java vs Python for optimal AST processing
+
+## Tool Migration Status (v1.5.0)
+
+**Fully Migrated** (support all configurations):
+- ✅ `text_undo.py` - Numbered selection menus
+- ✅ `safe_file_manager.py` - Risk-based confirmations  
+- ✅ `safegit.py` - Multi-choice prompts
+- ✅ `replace_text_v9.py` - Large change confirmations
+- ✅ `replace_text_ast_v3.py` - Batch operation confirmations
+
+**Legacy Tools** (basic environment variable support):
+- Tools using older patterns - use environment variables for non-interactive mode
+
+## Troubleshooting
+
+### Tool Still Prompts Despite Configuration
+1. Check `PYTOOLSRC` is set: `echo $PYTOOLSRC`
+2. Verify tool supports interactive_utils: `grep "interactive_utils" tool_name.py`
+3. Add tool-specific environment variable: `export TOOL_NAME_ASSUME_YES=1`
+4. Use command-line flag: `./run_any_python_tool.sh tool.py --yes`
+
+### Testing Non-Interactive Mode
+```bash
+# Test with no stdin (should not hang)
+(exec < /dev/null && PYTOOLSRC=.pytoolsrc.ci ./run_any_python_tool.sh safe_file_manager.py list .)
+```
+
+## Backend Auto-Detection (v1.5.0)
+
+All configurations use intelligent backend selection for `unified_refactor`:
+
+```ini
+[unified_refactor_v2]
+backend = auto                      # Auto-detect: java_scope for .java, python_ast for .py
+```
+
+**How it works:**
+- **`.java` files** → `java_scope` backend (Java AST analysis)
+- **`.py` files** → `python_ast` backend (Python AST analysis)
+- **Other files** → `text_based` backend (fallback)
+
+**Benefits:**
+- ✅ **Mixed codebases** work seamlessly without manual configuration
+- ✅ **Optimal performance** using language-specific AST parsers
+- ✅ **No configuration overhead** - just works for any file type
+- ✅ **Consistent behavior** across all configuration profiles
+
+## Creating Custom Configurations
+
+Copy an existing configuration and modify as needed:
+
+```bash
+cp .pytoolsrc.automation .pytoolsrc.custom
+# Edit .pytoolsrc.custom with your specific requirements
+export PYTOOLSRC=.pytoolsrc.custom
+```
+
+## Security Note
+
+- **Never set `force = true`** in configuration files
+- **Use environment variables** for temporary force operations
+- **Test configurations** in safe environments first
+- **Keep backups enabled** (`backup = true`) in all configurations
+
+---
+
+For complete documentation, see: 
+- [NON_INTERACTIVE_GUIDE.md](NON_INTERACTIVE_GUIDE.md)
+- [INTERACTIVE_UTILS_MIGRATION_STATUS.md](INTERACTIVE_UTILS_MIGRATION_STATUS.md)
+EOF < /dev/null