From 2fb20b0682ce40be0d6935aee72ca6f96ba7f302 Mon Sep 17 00:00:00 2001 From: leetcrypt Date: Fri, 5 Jun 2026 20:52:18 -0700 Subject: [PATCH] refactor: rebrand bash-helper to super-man + ESC returns straight to menu Rename bash-helper.sh -> super-man.sh and update all docs/tests to the super-man name and alias. In interactive mode, pressing Esc in the flag browser now returns directly to the home menu, removing the intermediary "Press Enter to search another command" prompt. Co-Authored-By: Claude Opus 4.6 --- docs/AI-INTEGRATION-OPTIONS.md | 16 +- docs/ENHANCEMENT-PROPOSAL.md | 90 +++--- docs/FINAL-FIXES-COMPLETE.md | 12 +- docs/PHASE-1-COMPLETE.md | 46 +-- docs/PHASE-1-DEMO.md | 30 +- docs/PR-DESCRIPTION.md | 14 +- docs/PR-INSTRUCTIONS.md | 12 +- docs/README.md | 20 +- docs/READY-TO-MERGE.md | 36 +-- docs/SESSION-COMPLETE.md | 8 +- docs/TEST-ANALYSIS-REPORT.md | 20 +- docs/TESTING-SUITE.md | 12 +- docs/UI-IMPROVEMENTS-FINAL.md | 20 +- ...LPER-ALIAS.md => USING-SUPER-MAN-ALIAS.md} | 60 ++-- docs/VERSION-2.1-RELEASE.md | 56 ++-- bash-helper.sh => super-man.sh | 271 +++++++++--------- tests/README.md | 28 +- tests/analyze-performance.sh | 10 +- tests/run-all-tests.sh | 10 +- tests/test-all-modes.sh | 8 +- tests/test-framework.sh | 6 +- tests/test-interactive-mode.sh | 46 +-- 22 files changed, 419 insertions(+), 412 deletions(-) rename docs/{USING-BHELPER-ALIAS.md => USING-SUPER-MAN-ALIAS.md} (63%) rename bash-helper.sh => super-man.sh (88%) diff --git a/docs/AI-INTEGRATION-OPTIONS.md b/docs/AI-INTEGRATION-OPTIONS.md index 262345b..0efa38e 100644 --- a/docs/AI-INTEGRATION-OPTIONS.md +++ b/docs/AI-INTEGRATION-OPTIONS.md @@ -1,8 +1,8 @@ -# Local AI Model Integration Options for Bash Buddy +# Local AI Model Integration Options for Super Man ## Overview -This document outlines options for integrating local AI models into Bash Buddy for advanced natural language to bash command translation. +This document outlines options for integrating local AI models into Super Man for advanced natural language to bash command translation. ## Why Local AI Models? @@ -12,7 +12,7 @@ This document outlines options for integrating local AI models into Bash Buddy f - **Free**: No API costs - **Customizable**: Can fine-tune for specific use cases -## Recommended: Ollama (Best for Bash Buddy) +## Recommended: Ollama (Best for Super Man) ### Why Ollama? @@ -69,7 +69,7 @@ Bash command:" } # Usage -bash-helper ai "find all python files modified in last week" +super-man ai "find all python files modified in last week" ``` ### Performance @@ -208,7 +208,7 @@ npm install -g @builder.io/ai-shell **Note**: Requires OpenAI API key (not fully local), but excellent prompt engineering. Could adapt prompts for local models. -## Recommendation for Bash Buddy +## Recommendation for Super Man **Use Ollama with CodeLlama 7B** @@ -223,8 +223,8 @@ npm install -g @builder.io/ai-shell ### Implementation Plan (Phase 3) ```bash -# New mode in bash-helper.sh -bash-helper ai "find all log files modified today and compress them" +# New mode in super-man.sh +super-man ai "find all log files modified today and compress them" # Workflow: # 1. Check if Ollama is running @@ -257,7 +257,7 @@ Bash command: ```bash # Cache location -~/.cache/bash-helper/ai-responses/ +~/.cache/super-man/ai-responses/ # Cache key: MD5 of query # Cache value: JSON with command, explanation, timestamp diff --git a/docs/ENHANCEMENT-PROPOSAL.md b/docs/ENHANCEMENT-PROPOSAL.md index bdaa6cc..a03b2d9 100644 --- a/docs/ENHANCEMENT-PROPOSAL.md +++ b/docs/ENHANCEMENT-PROPOSAL.md @@ -1,7 +1,7 @@ -# Bash Buddy Enhancement Proposal +# Super Man Enhancement Proposal ## 🎯 Goal -Transform bash-helper into an intelligent CLI assistant that can: +Transform super-man into an intelligent CLI assistant that can: - Accept natural language questions - Return relevant bash commands with examples - Explain flags in context @@ -14,13 +14,13 @@ Transform bash-helper into an intelligent CLI assistant that can: **Use Case:** Simple, common tasks ```bash -bash-helper "list files by size" +super-man "list files by size" # Returns: ls -lhS -bash-helper "find large files" +super-man "find large files" # Returns: find . -type f -size +100M -exec ls -lh {} \; -bash-helper "search in files" +super-man "search in files" # Returns: grep -r "pattern" . ``` @@ -33,11 +33,11 @@ bash-helper "search in files" **Use Case:** More complex tasks with variations ```bash -bash-helper "compress all logs older than 30 days" +super-man "compress all logs older than 30 days" # Returns: find /var/log -name "*.log" -mtime +30 -exec gzip {} \; # Explanation: Finds logs older than 30 days and compresses them -bash-helper "monitor cpu usage every 2 seconds" +super-man "monitor cpu usage every 2 seconds" # Returns: watch -n 2 'top -b -n 1 | head -20' ``` @@ -50,7 +50,7 @@ bash-helper "monitor cpu usage every 2 seconds" **Use Case:** Complex, unique queries ```bash -bash-helper --ai "extract all email addresses from files and save to csv" +super-man --ai "extract all email addresses from files and save to csv" # Uses local Ollama/llama.cpp for understanding # Generates: grep -roh '\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b' . | sort -u > emails.csv ``` @@ -66,29 +66,29 @@ bash-helper --ai "extract all email addresses from files and save to csv" ```bash # Ask a question -bash-helper ask "how do I find files modified today" +super-man ask "how do I find files modified today" # Get command + explanation -bash-helper explain "what does find . -name '*.log' do" +super-man explain "what does find . -name '*.log' do" # Get examples for a task -bash-helper examples "working with archives" +super-man examples "working with archives" ``` ### 2. Task-Based Categories ```bash # Browse by category -bash-helper category files # File operations -bash-helper category network # Network commands -bash-helper category system # System monitoring -bash-helper category text # Text processing +super-man category files # File operations +super-man category network # Network commands +super-man category system # System monitoring +super-man category text # Text processing ``` ### 3. Interactive Examples ```bash -bash-helper demo "find and replace in files" +super-man demo "find and replace in files" # Shows: # 1. Basic: sed -i 's/old/new/g' file.txt # 2. Recursive: find . -type f -exec sed -i 's/old/new/g' {} + @@ -98,7 +98,7 @@ bash-helper demo "find and replace in files" ### 4. Command Builder ```bash -bash-helper build +super-man build # Interactive wizard: # What do you want to do? # > Find files @@ -186,8 +186,8 @@ bash-helper build **Files to create:** - `commands-db.json` - Task database -- `bash-helper-search.sh` - Search functionality -- `bash-helper-ask.sh` - Natural language queries +- `super-man-search.sh` - Search functionality +- `super-man-ask.sh` - Natural language queries ### Phase 2: Pattern Matching (Week 2) - Template-based command generation @@ -205,26 +205,26 @@ bash-helper build - Graceful fallback **Integration points:** -- `bash-helper --ai "complex query"` +- `super-man --ai "complex query"` - Local llama3 or codellama -- Response caching in ~/.cache/bash-helper/ +- Response caching in ~/.cache/super-man/ ## 🎨 Enhanced CLI Interface ```bash # Current -bash-helper ls size # Show ls flags with 'size' +super-man ls size # Show ls flags with 'size' # Enhanced -bash-helper ask "show largest files" -bash-helper task "compress old logs" -bash-helper explain "tar -czf archive.tar.gz folder/" -bash-helper category files -bash-helper search "find duplicate" -bash-helper build # Interactive builder -bash-helper recent # Recently used commands -bash-helper bookmark "useful-find-command" -bash-helper --ai "complex natural language query" +super-man ask "show largest files" +super-man task "compress old logs" +super-man explain "tar -czf archive.tar.gz folder/" +super-man category files +super-man search "find duplicate" +super-man build # Interactive builder +super-man recent # Recently used commands +super-man bookmark "useful-find-command" +super-man --ai "complex natural language query" ``` ## πŸ“¦ Database Content Areas @@ -262,7 +262,7 @@ bash-helper --ai "complex natural language query" ## πŸ”§ Technical Architecture ``` -bash-helper (main script) +super-man (main script) β”‚ β”œβ”€> Mode Detection β”‚ β”œβ”€> --help, --list (existing) @@ -290,7 +290,7 @@ bash-helper (main script) ### Fast Lookup Strategy ```bash # Pre-indexed keywordβ†’command mapping -KEYWORD_INDEX=~/.local/share/bash-helper/keywords.idx +KEYWORD_INDEX=~/.local/share/super-man/keywords.idx # On first run: build index # Subsequent runs: instant lookup @@ -303,7 +303,7 @@ KEYWORD_INDEX=~/.local/share/bash-helper/keywords.idx ### Caching ```bash -~/.cache/bash-helper/ +~/.cache/super-man/ β”œβ”€β”€ ai-responses/ # Cached LLM responses β”œβ”€β”€ recent-commands # History └── bookmarks.json # User bookmarks @@ -313,7 +313,7 @@ KEYWORD_INDEX=~/.local/share/bash-helper/keywords.idx ### Scenario 1: New User Learning ```bash -$ bash-helper ask "how to find text in files" +$ super-man ask "how to find text in files" πŸ“– Task: Search for text in files @@ -343,7 +343,7 @@ Related tasks: ### Scenario 2: Quick Lookup ```bash -$ bash-helper task "compress folder" +$ super-man task "compress folder" πŸ’‘ Quick answer: @@ -355,13 +355,13 @@ Flags explained: -f : File name follows Try also: - bash-helper explain "tar -czf archive.tar.gz folder/" - bash-helper category files + super-man explain "tar -czf archive.tar.gz folder/" + super-man category files ``` ### Scenario 3: Complex Query (with AI) ```bash -$ bash-helper --ai "find all python files modified in last week, exclude virtual environments, and count lines of code" +$ super-man --ai "find all python files modified in last week, exclude virtual environments, and count lines of code" πŸ€– AI Assistant (using local LLM) @@ -389,21 +389,21 @@ curl -fsSL https://ollama.com/install.sh | sh # Pull a code-focused model ollama pull codellama:7b -# Configure bash-helper -bash-helper config set llm.enable true -bash-helper config set llm.model codellama:7b +# Configure super-man +super-man config set llm.enable true +super-man config set llm.model codellama:7b ``` ### Usage ```bash # First time (generates command) -bash-helper --ai "complex query" # ~3s +super-man --ai "complex query" # ~3s # Second time (cached) -bash-helper --ai "complex query" # <10ms +super-man --ai "complex query" # <10ms # Clear cache -bash-helper cache clear +super-man cache clear ``` ## πŸ“ˆ Success Metrics diff --git a/docs/FINAL-FIXES-COMPLETE.md b/docs/FINAL-FIXES-COMPLETE.md index 4d62a1a..d21caf9 100644 --- a/docs/FINAL-FIXES-COMPLETE.md +++ b/docs/FINAL-FIXES-COMPLETE.md @@ -1,4 +1,4 @@ -# Bash Buddy - Final UI Fixes Complete! βœ… +# Super Man - Final UI Fixes Complete! βœ… ## Date: 2025-10-28 (Session 2) @@ -171,7 +171,7 @@ formatted_line="...${COLORIZED_SYNTAX}" # Colorized ### Test 1: Explain Mode ```bash -./bash-helper.sh explain tail +./super-man.sh explain tail ``` **Result**: βœ… PASS - tail in cyan + bold @@ -190,7 +190,7 @@ formatted_line="...${COLORIZED_SYNTAX}" # Colorized ### Test 3: Literal Escape Code Check ```bash -./bash-helper.sh explain tar | grep '\\033' +./super-man.sh explain tar | grep '\\033' ``` **Result**: βœ… PASS (No matches) - No literal `\033` found @@ -246,7 +246,7 @@ ls: List directory contents [2-char gap] ls [OPTION]... [FILE]... **Commit**: `3af2b2a` **Message**: fix(ui): Fix color rendering and flush-right alignment **Branch**: testing-suite -**Files**: bash-helper.sh (+41, -31 lines) +**Files**: super-man.sh (+41, -31 lines) **Status**: βœ… Pushed to remote --- @@ -289,7 +289,7 @@ ls: List directory contents [2-char gap] ls [OPTION]... [FILE]... ### Ready to Create PR! -**PR URL**: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite +**PR URL**: http://localhost:3030/trill-technician/super-man/compare/main...testing-suite **What's Included**: - Complete testing suite (45+ tests) @@ -300,7 +300,7 @@ ls: List directory contents [2-char gap] ls [OPTION]... [FILE]... ### To Create PR: 1. Open the URL above -2. Title: `feat: Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements` +2. Title: `feat: Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements` 3. Copy description from `PR-DESCRIPTION.md` 4. Create and merge! diff --git a/docs/PHASE-1-COMPLETE.md b/docs/PHASE-1-COMPLETE.md index a866a61..c05dc86 100644 --- a/docs/PHASE-1-COMPLETE.md +++ b/docs/PHASE-1-COMPLETE.md @@ -2,7 +2,7 @@ ## Overview -Successfully implemented Phase 1 of the Bash Buddy enhancement proposal, adding intelligent natural language query capabilities while maintaining fast, local operation. +Successfully implemented Phase 1 of the Super Man enhancement proposal, adding intelligent natural language query capabilities while maintaining fast, local operation. ## What Was Added @@ -27,9 +27,9 @@ Each task includes: #### **ask** mode - Natural language queries ```bash -bash-helper ask "find large files" -bash-helper ask "compress folder" -bash-helper ask "search text in files" +super-man ask "find large files" +super-man ask "compress folder" +super-man ask "search text in files" ``` Features: @@ -40,26 +40,26 @@ Features: #### **task** mode - Task descriptions ```bash -bash-helper task "show disk usage" -bash-helper task "download file from url" +super-man task "show disk usage" +super-man task "download file from url" ``` (Same as `ask` mode - both use keyword search) #### **category** mode - Browse by category ```bash -bash-helper category files -bash-helper category network -bash-helper category system -bash-helper category text +super-man category files +super-man category network +super-man category system +super-man category text ``` Shows all tasks in a category with compact format. #### **explain** mode - Explain commands ```bash -bash-helper explain "tar -czf archive.tar.gz folder/" -bash-helper explain "find . -name '*.txt'" +super-man explain "tar -czf archive.tar.gz folder/" +super-man explain "find . -name '*.txt'" ``` Features: @@ -87,16 +87,16 @@ Results sorted by relevance score, filters out words <3 characters. All original modes still work: ```bash -bash-helper # Interactive fzf mode -bash-helper ls size # Direct flag lookup -bash-helper --list # List commands -bash-helper --help # Show help +super-man # Interactive fzf mode +super-man ls size # Direct flag lookup +super-man --list # List commands +super-man --help # Show help ``` ## Technical Implementation ### Files Modified -- **bash-helper.sh** (+370 lines) +- **super-man.sh** (+370 lines) - Added database reading and search functions - Implemented keyword matching algorithm with scoring - Added 4 new display modes @@ -152,7 +152,7 @@ All modes tested and working: ```bash # Find large files -$ bash-helper ask "find large files" +$ super-man ask "find large files" Found 5 matches: 1. Find files larger than 100MB @@ -163,7 +163,7 @@ Found 5 matches: ... # Specific query (single result with details) -$ bash-helper ask "symlink" +$ super-man ask "symlink" Task: Create symbolic link to file or directory Category: files @@ -185,7 +185,7 @@ Examples: ### Browse by Category ```bash -$ bash-helper category files +$ super-man category files Category: File Operations @@ -203,7 +203,7 @@ Category: File Operations ### Explain Commands ```bash -$ bash-helper explain "tar -czf archive.tar.gz folder/" +$ super-man explain "tar -czf archive.tar.gz folder/" Command: tar -czf archive.tar.gz folder/ @@ -217,7 +217,7 @@ Flag explanations: ## Educational Value -The enhancements make Bash Buddy a learning platform: +The enhancements make Super Man a learning platform: 1. **Discovery**: Browse categories to learn what's possible 2. **Examples**: See real-world usage patterns for each task @@ -281,4 +281,4 @@ Local LLM integration with Ollama for complex queries: - Related task suggestions - Comprehensive examples -Bash Buddy is now an intelligent CLI assistant while remaining fast, local, and easy to use! +Super Man is now an intelligent CLI assistant while remaining fast, local, and easy to use! diff --git a/docs/PHASE-1-DEMO.md b/docs/PHASE-1-DEMO.md index aac1e7f..0e5cbb2 100644 --- a/docs/PHASE-1-DEMO.md +++ b/docs/PHASE-1-DEMO.md @@ -14,7 +14,7 @@ ### 1. ASCII Banner & Updated Help ```bash -$ bash-helper --help +$ super-man --help ``` **Output:** @@ -28,9 +28,9 @@ $ bash-helper --help Your Intelligent CLI Assistant for Bash QUICK START - bash-helper ask "find large files" # Ask a question - bash-helper category files # Browse by category - bash-helper explain "tar -czf" # Explain a command + super-man ask "find large files" # Ask a question + super-man category files # Browse by category + super-man explain "tar -czf" # Explain a command MODES Natural Language Queries: @@ -53,7 +53,7 @@ MODES #### Query: "find large files" ```bash -$ bash-helper ask "find large files" +$ super-man ask "find large files" ``` **Output:** @@ -83,7 +83,7 @@ Tip: Use more specific keywords to narrow results #### Query: "symlink" (Single Result - Full Details) ```bash -$ bash-helper ask "symlink" +$ super-man ask "symlink" ``` **Output:** @@ -122,7 +122,7 @@ Related tasks: ### 3. Category Browsing ```bash -$ bash-helper category files +$ super-man category files ``` **Output:** @@ -162,7 +162,7 @@ Category: File Operations #### List All Categories ```bash -$ bash-helper category +$ super-man category ``` **Output:** @@ -174,13 +174,13 @@ Available categories: network : Network Operations system : System Monitoring -Usage: bash-helper category NAME +Usage: super-man category NAME ``` ### 4. Command Explanation ```bash -$ bash-helper explain "tar -czf archive.tar.gz folder/" +$ super-man explain "tar -czf archive.tar.gz folder/" ``` **Output:** @@ -206,7 +206,7 @@ Flag explanations: #### Direct Flag Lookup ```bash -$ bash-helper ls size +$ super-man ls size ``` **Output:** @@ -293,7 +293,7 @@ All queries tested on the system: ## File Changes ### Modified -- **bash-helper.sh**: +370 lines (now 700+ total) +- **super-man.sh**: +370 lines (now 700+ total) - Added intelligent search functions - Implemented 4 new query modes - Enhanced UI with ASCII banner @@ -315,7 +315,7 @@ All queries tested on the system: **Net Change**: +2,048 lines **Pushed to Gitea**: βœ… -**URL**: http://localhost:3030/trill-technician/bash-buddy +**URL**: http://localhost:3030/trill-technician/super-man ## What Users Can Do Now @@ -339,7 +339,7 @@ All queries tested on the system: ## Educational Value -Bash Buddy is now a **learning platform**: +Super Man is now a **learning platform**: 1. **Discovery**: Browse categories to see what's possible 2. **Examples**: Real-world usage patterns for each task @@ -373,6 +373,6 @@ The system is designed for continuous improvement. Users can: --- -**Bash Buddy v2.0.0 - Phase 1 Complete** πŸš€ +**Super Man v2.0.0 - Phase 1 Complete** πŸš€ From simple flag lookup to intelligent CLI assistant in one upgrade! diff --git a/docs/PR-DESCRIPTION.md b/docs/PR-DESCRIPTION.md index b8ce2df..c225d36 100644 --- a/docs/PR-DESCRIPTION.md +++ b/docs/PR-DESCRIPTION.md @@ -1,8 +1,8 @@ -# Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements +# Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements ## Overview -This PR introduces a complete testing suite and comprehensive UI improvements for Bash Buddy, elevating the user experience across all operating modes while ensuring code quality and performance. +This PR introduces a complete testing suite and comprehensive UI improvements for Super Man, elevating the user experience across all operating modes while ensuring code quality and performance. ## What's New @@ -41,7 +41,7 @@ This PR introduces a complete testing suite and comprehensive UI improvements fo ## Technical Details ### Files Changed -- `bash-helper.sh` - Core improvements (+200 lines) +- `super-man.sh` - Core improvements (+200 lines) - `test-suite.sh` - New comprehensive testing framework - Multiple documentation files @@ -114,25 +114,25 @@ After Selection: ### Run Test Suite ```bash -cd /home/dell/coding/bash/bash-buddy +cd /home/dell/coding/bash/super-man ./test-suite.sh ``` ### Test Interactive Mode ```bash -./bash-helper.sh +./super-man.sh # Try: fuzzy search β†’ select command β†’ browse flags β†’ press Enter β†’ repeat ``` ### Test Explain Mode with Examples ```bash -./bash-helper.sh explain find +./super-man.sh explain find # Look for SYNTAX and EXAMPLE sections ``` ### Test Fuzzy Flag Search ```bash -./bash-helper.sh ls +./super-man.sh ls # Fuzzy flag browser opens automatically after command info # Type keywords like "color" or "time" to search ``` diff --git a/docs/PR-INSTRUCTIONS.md b/docs/PR-INSTRUCTIONS.md index 20c4ad5..36ee637 100644 --- a/docs/PR-INSTRUCTIONS.md +++ b/docs/PR-INSTRUCTIONS.md @@ -12,7 +12,7 @@ **PR Creation URL:** ``` -http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite +http://localhost:3030/trill-technician/super-man/compare/main...testing-suite ``` **Steps:** @@ -24,7 +24,7 @@ http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite ### Option 2: Via CLI (if authenticated) ```bash -cd ~/coding/bash/bash-buddy +cd ~/coding/bash/super-man tea pr create --base main --head testing-suite ``` @@ -40,7 +40,7 @@ feat(testing): Add comprehensive testing suite with performance analysis ```markdown ## Overview -This PR adds a complete testing infrastructure for Bash Buddy v2.1.0 with: +This PR adds a complete testing infrastructure for Super Man v2.1.0 with: - Automated testing for all operating modes - Performance benchmarking and analysis - Detailed reporting (JSON, Markdown, HTML) @@ -144,7 +144,7 @@ Once the PR is created: git diff main testing-suite # Or via web interface -http://localhost:3030/trill-technician/bash-buddy/pulls +http://localhost:3030/trill-technician/super-man/pulls ``` ### Test the Changes (Optional) @@ -170,7 +170,7 @@ cat reports/performance-report.md ### Merge via CLI ```bash -cd ~/coding/bash/bash-buddy +cd ~/coding/bash/super-man git checkout main git merge testing-suite git push origin main @@ -236,7 +236,7 @@ Features: | Action | Command/URL | |--------|-------------| -| **Create PR** | http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite | +| **Create PR** | http://localhost:3030/trill-technician/super-man/compare/main...testing-suite | | **View Branch** | `git log testing-suite` | | **Run Tests** | `cd tests/ && ./run-all-tests.sh` | | **View Reports** | `cat tests/reports/performance-report.md` | diff --git a/docs/README.md b/docs/README.md index f6dd43d..c19b942 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,4 +1,4 @@ -# Bash Buddy +# Super Man πŸš€ CLI assistant for impromptu bash scripting help @@ -28,24 +28,24 @@ sudo pacman -S fzf # Arch ```bash # Clone the repository -git clone http://localhost:3030/trill-technician/bash-buddy.git -cd bash-buddy +git clone http://localhost:3030/trill-technician/super-man.git +cd super-man # Make executable -chmod +x bash-helper.sh +chmod +x super-man.sh # Optional: Install system-wide -sudo cp bash-helper.sh /usr/local/bin/bash-helper +sudo cp super-man.sh /usr/local/bin/super-man # Or add to your PATH -echo 'export PATH="$HOME/bash-buddy:$PATH"' >> ~/.bashrc +echo 'export PATH="$HOME/super-man:$PATH"' >> ~/.bashrc source ~/.bashrc ``` ## Usage ```bash -./bash-helper.sh +./super-man.sh ``` ### Workflow @@ -59,7 +59,7 @@ source ~/.bashrc ### Example Session ``` -$ ./bash-helper.sh +$ ./super-man.sh > ls:List directory contents cd:Change the current directory @@ -102,7 +102,7 @@ The script includes help for these common bash commands: ### Adding More Commands -Edit the `COMMANDS` array in `bash-helper.sh`: +Edit the `COMMANDS` array in `super-man.sh`: ```bash COMMANDS=( @@ -143,7 +143,7 @@ NC='\033[0m' # No Color ```bash # Add to ~/.bashrc -alias bh='bash-helper.sh' +alias bh='super-man.sh' ``` ## Contributing diff --git a/docs/READY-TO-MERGE.md b/docs/READY-TO-MERGE.md index 22912b6..1167ae3 100644 --- a/docs/READY-TO-MERGE.md +++ b/docs/READY-TO-MERGE.md @@ -1,4 +1,4 @@ -# Bash Buddy v2.1.0 - Ready to Merge! πŸš€ +# Super Man v2.1.0 - Ready to Merge! πŸš€ ## PR Status: READY βœ… @@ -56,14 +56,14 @@ bdf3026 docs(pr): Add PR creation instructions and merge guide ### Step 1: Open PR Creation Page ``` -URL: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite +URL: http://localhost:3030/trill-technician/super-man/compare/main...testing-suite ``` ### Step 2: Fill in PR Details **Title:** ``` -feat: Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements +feat: Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements ``` **Description:** @@ -80,11 +80,11 @@ Copy the entire contents of `PR-DESCRIPTION.md` into the description field. ## Create PR - Option 2: GitHub CLI (if installed) ```bash -cd /home/dell/coding/bash/bash-buddy +cd /home/dell/coding/bash/super-man # Using gh CLI gh pr create \ - --title "feat: Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements" \ + --title "feat: Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements" \ --body-file PR-DESCRIPTION.md \ --base main \ --head testing-suite @@ -93,10 +93,10 @@ gh pr create \ ## Create PR - Option 3: Tea CLI (if working) ```bash -cd /home/dell/coding/bash/bash-buddy +cd /home/dell/coding/bash/super-man tea pr create \ - --title "feat: Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements" \ + --title "feat: Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements" \ --description "$(cat PR-DESCRIPTION.md)" \ --base main \ --head testing-suite @@ -106,7 +106,7 @@ tea pr create \ ### Check Branch Status ```bash -cd /home/dell/coding/bash/bash-buddy +cd /home/dell/coding/bash/super-man git status git log main..testing-suite --oneline ``` @@ -117,20 +117,20 @@ git log main..testing-suite --oneline ./test-suite.sh # Interactive mode -./bash-helper.sh +./super-man.sh # Explain mode with examples -./bash-helper.sh explain find +./super-man.sh explain find # Direct mode -./bash-helper.sh grep -i +./super-man.sh grep -i ``` ## After Merge ### Update Local Repository ```bash -cd /home/dell/coding/bash/bash-buddy +cd /home/dell/coding/bash/super-man # Switch to main git checkout main @@ -148,25 +148,25 @@ git push origin --delete testing-suite ### Verify Merge ```bash # Check version -./bash-helper.sh --version +./super-man.sh --version # Run tests on main ./test-suite.sh # Test interactive mode -./bash-helper.sh +./super-man.sh ``` ### Tag Release (Optional) ```bash -git tag -a v2.1.0 -m "Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements" +git tag -a v2.1.0 -m "Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements" git push origin v2.1.0 ``` ## Files to Review 1. **PR-DESCRIPTION.md** - Complete PR description (ready to paste) -2. **bash-helper.sh** - Main script with all improvements +2. **super-man.sh** - Main script with all improvements 3. **tests/** - Complete testing framework 4. **TESTING-SUITE.md** - Testing documentation 5. **PR-INSTRUCTIONS.md** - PR creation guide @@ -185,7 +185,7 @@ git push origin v2.1.0 ## PR URL (Direct Link) ``` -http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite +http://localhost:3030/trill-technician/super-man/compare/main...testing-suite ``` **Copy this URL into your browser to create the PR immediately!** @@ -227,7 +227,7 @@ If you encounter any issues: ## Final Notes -This PR represents a significant upgrade to Bash Buddy: +This PR represents a significant upgrade to Super Man: - **3,253 net new lines** of functionality - **50+ practical examples** added - **45+ automated tests** for quality assurance diff --git a/docs/SESSION-COMPLETE.md b/docs/SESSION-COMPLETE.md index 5dba530..ed1fd68 100644 --- a/docs/SESSION-COMPLETE.md +++ b/docs/SESSION-COMPLETE.md @@ -1,4 +1,4 @@ -# Bash Buddy v2.1.0 - Session Complete! πŸŽ‰ +# Super Man v2.1.0 - Session Complete! πŸŽ‰ ## All User Requests Fulfilled @@ -37,7 +37,7 @@ ## What Was Changed ### Files Modified -- `bash-helper.sh` (+111 lines, -86 lines) +- `super-man.sh` (+111 lines, -86 lines) ### New Functions 1. `colorize_syntax()` - Parse and colorize syntax by element type @@ -122,11 +122,11 @@ Run this to test menu formatting: ## Next: Create PR -**PR URL**: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite +**PR URL**: http://localhost:3030/trill-technician/super-man/compare/main...testing-suite ### Steps: 1. Open the URL above -2. Title: `feat: Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements` +2. Title: `feat: Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements` 3. Description: Copy from `PR-DESCRIPTION.md` 4. Create Pull Request 5. Review changes diff --git a/docs/TEST-ANALYSIS-REPORT.md b/docs/TEST-ANALYSIS-REPORT.md index 6c57198..5967fbf 100644 --- a/docs/TEST-ANALYSIS-REPORT.md +++ b/docs/TEST-ANALYSIS-REPORT.md @@ -1,4 +1,4 @@ -# Bash Buddy v2.1.0 - Test & Performance Analysis Report +# Super Man v2.1.0 - Test & Performance Analysis Report **Date**: 2025-10-28 **Test Suite Version**: 1.0 @@ -61,11 +61,11 @@ These tests expect static output with flag descriptions, but the new fuzzy flag **Example**: ```bash # OLD: Displayed flags statically -./bash-helper.sh ls size +./super-man.sh ls size # Output: -s, --size print sizes # NEW: Opens fzf browser -./bash-helper.sh ls size +./super-man.sh ls size # Opens interactive fuzzy search (requires user interaction) ``` @@ -73,7 +73,7 @@ These tests expect static output with flag descriptions, but the new fuzzy flag #### 2. Help Display Test (#1) **Test**: `--help` flag -**Expected**: Output contains "Bash Buddy" +**Expected**: Output contains "Super Man" **Actual**: Help displays correctly but uses different text **Impact**: **NONE** - Help displays perfectly @@ -145,7 +145,7 @@ These tests expect static output with flag descriptions, but the new fuzzy flag **Test Method**: Manual verification with explain mode **Result**: PASS ```bash -./bash-helper.sh explain tail +./super-man.sh explain tail # Colors render properly: # - tail in cyan + bold # - [OPTION], [FILE] in yellow @@ -407,9 +407,9 @@ All **user-facing functionality works perfectly**. ## Files Generated -**Test Logs**: `/home/dell/coding/bash/bash-buddy/tests/logs/` -**Performance Data**: `/home/dell/coding/bash/bash-buddy/tests/performance/` -**Reports**: `/home/dell/coding/bash/bash-buddy/tests/reports/` +**Test Logs**: `/home/dell/coding/bash/super-man/tests/logs/` +**Performance Data**: `/home/dell/coding/bash/super-man/tests/performance/` +**Reports**: `/home/dell/coding/bash/super-man/tests/reports/` **Key Reports**: - `test-report.json` - Machine-readable results @@ -419,7 +419,7 @@ All **user-facing functionality works perfectly**. **View HTML Report**: ``` -file:///home/dell/coding/bash/bash-buddy/tests/reports/performance-report.html +file:///home/dell/coding/bash/super-man/tests/reports/performance-report.html ``` --- @@ -445,6 +445,6 @@ file:///home/dell/coding/bash/bash-buddy/tests/reports/performance-report.html --- **Report Generated**: 2025-10-28 -**Analyst**: Claude (Bash Buddy Test Suite) +**Analyst**: Claude (Super Man Test Suite) **Version**: 2.1.0 **Branch**: testing-suite diff --git a/docs/TESTING-SUITE.md b/docs/TESTING-SUITE.md index 3a8e955..8d7922d 100644 --- a/docs/TESTING-SUITE.md +++ b/docs/TESTING-SUITE.md @@ -2,7 +2,7 @@ ## Overview -This PR adds a comprehensive testing framework for Bash Buddy v2.1.0 with automated testing for all operating modes, performance benchmarking, and detailed reporting capabilities. +This PR adds a comprehensive testing framework for Super Man v2.1.0 with automated testing for all operating modes, performance benchmarking, and detailed reporting capabilities. ## What's Added @@ -139,7 +139,7 @@ Plain text format for CI logs. ### Required - bash 4.0+ -- bash-helper.sh (the script being tested) +- super-man.sh (the script being tested) ### Optional - **jq** - JSON parsing (recommended) @@ -191,7 +191,7 @@ exit $EXIT_CODE ### GitHub Actions ```yaml -name: Test Bash Buddy +name: Test Super Man on: [push, pull_request] jobs: test: @@ -226,7 +226,7 @@ jobs: ``` ═══════════════════════════════════════════════════════════ - Bash Buddy Test Suite + Super Man Test Suite 2025-10-28 00:30:15 ═══════════════════════════════════════════════════════════ @@ -234,7 +234,7 @@ jobs: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Test #1: Help display (--help) -βœ“ PASSED (45ms) - Output contains: "Bash Buddy" +βœ“ PASSED (45ms) - Output contains: "Super Man" Test #2: List all commands (--list) βœ“ PASSED (32ms) - Output contains: "Available commands" @@ -392,7 +392,7 @@ cd tests/ ## Conclusion -This comprehensive testing suite ensures Bash Buddy maintains high quality and performance standards across all operating modes. With 45+ test cases, performance benchmarking, and automated reporting, we can confidently develop and deploy new features while maintaining backward compatibility. +This comprehensive testing suite ensures Super Man maintains high quality and performance standards across all operating modes. With 45+ test cases, performance benchmarking, and automated reporting, we can confidently develop and deploy new features while maintaining backward compatibility. **Ready to merge!** πŸš€ diff --git a/docs/UI-IMPROVEMENTS-FINAL.md b/docs/UI-IMPROVEMENTS-FINAL.md index 6e6c54c..75f8369 100644 --- a/docs/UI-IMPROVEMENTS-FINAL.md +++ b/docs/UI-IMPROVEMENTS-FINAL.md @@ -1,4 +1,4 @@ -# Bash Buddy - Final UI Improvements Complete! βœ… +# Super Man - Final UI Improvements Complete! βœ… ## Session Date: 2025-10-28 @@ -248,7 +248,7 @@ show_flags "$CMD" "$SYNTAX" "$DESC" ### Test 1: Colorized Syntax in Explain Mode ```bash -./bash-helper.sh explain tar +./super-man.sh explain tar ``` **Result**: βœ… - Command "tar" in cyan + bold @@ -345,7 +345,7 @@ SYNTAX: ## Files Changed -### `bash-helper.sh` +### `super-man.sh` **Changes**: +111 lines, -86 lines (net +25) **Sections Modified**: @@ -372,7 +372,7 @@ SYNTAX: **Push Status**: βœ… Pushed to remote -**PR URL**: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite +**PR URL**: http://localhost:3030/trill-technician/super-man/compare/main...testing-suite --- @@ -415,7 +415,7 @@ Ready to merge: YES βœ“ ### Option 1: Create PR via Web Interface ``` -URL: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite +URL: http://localhost:3030/trill-technician/super-man/compare/main...testing-suite ``` 1. Open URL 2. Copy PR description from `PR-DESCRIPTION.md` @@ -423,13 +423,13 @@ URL: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-su ### Option 2: Test Locally First ```bash -cd /home/dell/coding/bash/bash-buddy +cd /home/dell/coding/bash/super-man # Test explain mode with colorized syntax -./bash-helper.sh explain find +./super-man.sh explain find # Test interactive menu (if fzf available) -./bash-helper.sh +./super-man.sh # Run full test suite ./test-suite.sh @@ -441,7 +441,7 @@ git checkout main git pull origin main git branch -d testing-suite git push origin --delete testing-suite -git tag -a v2.1.0 -m "Bash Buddy v2.1.0" +git tag -a v2.1.0 -m "Super Man v2.1.0" git push origin v2.1.0 ``` @@ -469,6 +469,6 @@ The result is a professional, polished UI with: **Created**: 2025-10-28 **Session**: UI Improvements - Color Coordination & UX Fixes **Branch**: testing-suite (9 commits) -**Files**: bash-helper.sh (+111, -86) +**Files**: super-man.sh (+111, -86) **Tests**: All passing βœ“ **User Approval**: Pending diff --git a/docs/USING-BHELPER-ALIAS.md b/docs/USING-SUPER-MAN-ALIAS.md similarity index 63% rename from docs/USING-BHELPER-ALIAS.md rename to docs/USING-SUPER-MAN-ALIAS.md index 34e497f..84294b0 100644 --- a/docs/USING-BHELPER-ALIAS.md +++ b/docs/USING-SUPER-MAN-ALIAS.md @@ -1,11 +1,11 @@ -# Using the `bhelper` Alias +# Using the `super-man` Alias ## Alias Configuration -Your bash alias has been updated to use the new Bash Buddy script: +Your bash alias has been updated to use the new Super Man script: ```bash -alias bhelper='/home/dell/coding/gitea-projects/bash-buddy/bash-helper.sh' +alias super-man='/home/dell/coding/gitea-projects/super-man/super-man.sh' ``` **Location:** `~/.bashrc` @@ -22,39 +22,39 @@ Or simply open a new terminal - the alias will be available automatically. ## Quick Start -Now you can use `bhelper` as a shortcut for all Bash Buddy features: +Now you can use `super-man` as a shortcut for all Super Man features: ### Natural Language Queries ```bash -bhelper ask "find large files" -bhelper task "compress a folder" -bhelper ask "search text in files" +super-man ask "find large files" +super-man task "compress a folder" +super-man ask "search text in files" ``` ### Browse by Category ```bash -bhelper category files -bhelper category network -bhelper category system -bhelper category text +super-man category files +super-man category network +super-man category system +super-man category text ``` ### Explain Commands ```bash -bhelper explain "tar -czf archive.tar.gz folder/" -bhelper explain "find . -name '*.txt'" +super-man explain "tar -czf archive.tar.gz folder/" +super-man explain "find . -name '*.txt'" ``` ### Original Modes (Still Work) ```bash -bhelper ls size # Direct flag lookup -bhelper # Interactive fzf mode -bhelper --help # Show help with ASCII banner -bhelper --list # List all commands +super-man ls size # Direct flag lookup +super-man # Interactive fzf mode +super-man --help # Show help with ASCII banner +super-man --list # List all commands ``` ## Examples @@ -62,7 +62,7 @@ bhelper --list # List all commands ### 1. Quick Command Lookup ```bash -$ bhelper ask "disk usage" +$ super-man ask "disk usage" Searching for: "disk usage" @@ -79,7 +79,7 @@ Found 5 matches: ### 2. Learn New Commands ```bash -$ bhelper category files +$ super-man category files Category: File Operations @@ -94,7 +94,7 @@ Category: File Operations ### 3. Understand Command Flags ```bash -$ bhelper explain "tar -czf archive.tar.gz folder/" +$ super-man explain "tar -czf archive.tar.gz folder/" Command: tar -czf archive.tar.gz folder/ @@ -119,7 +119,7 @@ Flag explanations: View complete help anytime: ```bash -bhelper --help +super-man --help ``` Shows: @@ -133,28 +133,28 @@ Shows: 1. **Use quotes for multi-word queries:** ```bash - bhelper ask "find large files" # βœ“ Correct - bhelper ask find large files # βœ— Will only search "find" + super-man ask "find large files" # βœ“ Correct + super-man ask find large files # βœ— Will only search "find" ``` 2. **Browse categories to discover commands:** ```bash - bhelper category files # See all file operations + super-man category files # See all file operations ``` 3. **Explain any command you're curious about:** ```bash - bhelper explain "any bash command here" + super-man explain "any bash command here" ``` 4. **Original direct lookup still works:** ```bash - bhelper ls size # Quick flag reference + super-man ls size # Quick flag reference ``` ## Version -**Bash Buddy v2.0.0** - Phase 1 Complete +**Super Man v2.0.0** - Phase 1 Complete With natural language queries, 20-task database, and intelligent search! @@ -162,7 +162,7 @@ With natural language queries, 20-task database, and intelligent search! All code is version-controlled and pushed to Gitea: -**URL:** http://localhost:3030/trill-technician/bash-buddy +**URL:** http://localhost:3030/trill-technician/super-man **Latest commits:** - `13cb602` - docs: Add Phase 1 live demo with examples and benchmarks @@ -171,12 +171,12 @@ All code is version-controlled and pushed to Gitea: ## Enjoy! -You now have a powerful, intelligent CLI assistant at your fingertips with just one command: **`bhelper`** +You now have a powerful, intelligent CLI assistant at your fingertips with just one command: **`super-man`** Try it now: ```bash source ~/.bashrc -bhelper ask "compress folder" +super-man ask "compress folder" ``` πŸš€ Happy scripting! diff --git a/docs/VERSION-2.1-RELEASE.md b/docs/VERSION-2.1-RELEASE.md index d05e228..5860cee 100644 --- a/docs/VERSION-2.1-RELEASE.md +++ b/docs/VERSION-2.1-RELEASE.md @@ -1,4 +1,4 @@ -# Bash Buddy v2.1.0 - AI-Powered Release πŸ€– +# Super Man v2.1.0 - AI-Powered Release πŸ€– ## What's New @@ -7,11 +7,11 @@ Integrated **NL2SH model** for advanced natural language understanding: ```bash -bhelper ai "find all python files modified in last week" +super-man ai "find all python files modified in last week" # Generated: find /path/to/directory -type f -name "*.py" -mtime -7 -bhelper ai "count lines in all javascript files" -bhelper ai "compress all log files older than 30 days" +super-man ai "count lines in all javascript files" +super-man ai "compress all log files older than 30 days" ``` **Features:** @@ -75,37 +75,37 @@ Filter: -v ### 1. AI Mode (NEW!) πŸ€– ```bash -bhelper ai "find large files in home directory" -bhelper ai "get network interface information" +super-man ai "find large files in home directory" +super-man ai "get network interface information" ``` ### 2. Natural Language Queries ```bash -bhelper ask "compress folder" # Database search -bhelper task "disk usage" # Task search +super-man ask "compress folder" # Database search +super-man task "disk usage" # Task search ``` ### 3. Category Browsing ```bash -bhelper category files -bhelper category network +super-man category files +super-man category network ``` ### 4. Command Explanation ```bash -bhelper explain "tar -czf archive.tar.gz folder/" +super-man explain "tar -czf archive.tar.gz folder/" ``` ### 5. Interactive Mode (Enhanced!) ```bash -bhelper # Browse 90+ commands with fzf +super-man # Browse 90+ commands with fzf # Select command β†’ Enter filter β†’ See flags ``` ### 6. Direct Flag Lookup ```bash -bhelper grep -v # Show grep flags with 'v' -bhelper ls size # Show ls flags about size +super-man grep -v # Show grep flags with 'v' +super-man ls size # Show ls flags about size ``` ## Performance @@ -146,20 +146,20 @@ bhelper ls size # Show ls flags about size ### Try AI Mode ```bash source ~/.bashrc # Reload alias if needed -bhelper ai "find files larger than 100MB" +super-man ai "find files larger than 100MB" ``` ### Try Enhanced Interactive ```bash -bhelper # Opens fzf with 90+ commands +super-man # Opens fzf with 90+ commands # Type to filter (e.g., "net" for network commands) # Select β†’ Enter filter term β†’ See relevant flags ``` ### All Commands Available ```bash -bhelper --help # See all modes -bhelper --list # List all 90+ commands +super-man --help # See all modes +super-man --list # List all 90+ commands ``` ## Installation @@ -178,26 +178,26 @@ Or open a new terminal. **Find Python files:** ```bash -$ bhelper ai "find python files modified this week" +$ super-man ai "find python files modified this week" Generated: find /path/to/directory -type f -name "*.py" -mtime -7 ``` **Count lines:** ```bash -$ bhelper ai "count lines in all javascript files" +$ super-man ai "count lines in all javascript files" Generated: find . -name "*.js" -exec wc -l {} + | awk '{sum+=$1} END {print sum}' ``` **Network info:** ```bash -$ bhelper ai "show my IP address" +$ super-man ai "show my IP address" Generated: ip addr show | grep 'inet ' | grep -v 127.0.0.1 ``` ### Interactive Mode Example ```bash -$ bhelper +$ super-man # Type "tar" β†’ Select "tar:Archive files" # Enter filter: "extract" @@ -220,7 +220,7 @@ Your Ollama models: **Default:** NL2SH (specialized for shell commands) -To switch models, edit `mode_ai()` function in bash-helper.sh +To switch models, edit `mode_ai()` function in super-man.sh ## Troubleshooting @@ -242,7 +242,7 @@ This is now fixed in v2.1.0! The flag extraction has been completely rewritten. ### Want More Commands in Interactive Mode? -Edit the `COMMANDS` array in bash-helper.sh and add: +Edit the `COMMANDS` array in super-man.sh and add: ```bash "yourcommand:Description of what it does" ``` @@ -268,9 +268,9 @@ Edit the `COMMANDS` array in bash-helper.sh and add: ## Repository -**Location:** `~/coding/bash/bash-buddy/` +**Location:** `~/coding/bash/super-man/` -**Gitea:** http://localhost:3030/trill-technician/bash-buddy +**Gitea:** http://localhost:3030/trill-technician/super-man **Latest commit:** 3e5e431 @@ -286,9 +286,9 @@ Edit the `COMMANDS` array in bash-helper.sh and add: --- -**Bash Buddy v2.1.0** - Now with AI! πŸš€πŸ€– +**Super Man v2.1.0** - Now with AI! πŸš€πŸ€– Try it now: ```bash -bhelper ai "your complex query here" +super-man ai "your complex query here" ``` diff --git a/bash-helper.sh b/super-man.sh similarity index 88% rename from bash-helper.sh rename to super-man.sh index 4f0297e..2f08324 100755 --- a/bash-helper.sh +++ b/super-man.sh @@ -17,22 +17,25 @@ NC='\033[0m' # No Color # ASCII Banner show_banner() { - echo -e "${CYAN} ____ __ ____ __ __" - echo -e " / __ )____ ______/ /_ / __ )__ ______/ /___/ /_ __" - echo -e " / __ / __ \`/ ___/ __ \\ / __ / / / / __ / __ / / / /" - echo -e " / /_/ / /_/ (__ ) / / / / /_/ / /_/ / /_/ / /_/ / /_/ /" - echo -e "/_____/\\__,_/____/_/ /_/ /_____/\\__,_/\\__,_/\\__,_/\\__, /" - echo -e " /____/${NC}" - echo -e "${YELLOW} Your Intelligent CLI Assistant for Bash${NC}" + echo -en "${CYAN}" + cat <<'BANNER' + ____ __ __ +/ ___| _ _ _ __ ___ _ __ | \/ | __ _ _ __ +\___ \| | | | '_ \ / _ \ '__| | |\/| |/ _` | '_ \ + ___) | |_| | |_) | __/ | | | | | (_| | | | | +|____/ \__,_| .__/ \___|_| |_| |_|\__,_|_| |_| + |_| +BANNER + echo -e "${NC}${YELLOW} Your Intelligent CLI Assistant for Bash${NC}" echo "" } show_help() { show_banner echo -e "${BOLD}${YELLOW}QUICK START${NC}" - echo -e " ${GREEN}bash-helper ask \"find large files\"${NC} # Ask a question" - echo -e " ${GREEN}bash-helper category files${NC} # Browse by category" - echo -e " ${GREEN}bash-helper explain \"tar -czf\"${NC} # Explain a command" + echo -e " ${GREEN}super-man ask \"find large files\"${NC} # Ask a question" + echo -e " ${GREEN}super-man category files${NC} # Browse by category" + echo -e " ${GREEN}super-man explain \"tar -czf\"${NC} # Explain a command" echo "" echo -e "${BOLD}${YELLOW}MODES${NC}" echo -e " ${CYAN}Natural Language Queries:${NC}" @@ -57,17 +60,17 @@ show_help() { echo "" echo -e "${BOLD}${YELLOW}EXAMPLES${NC}" echo -e " ${DIM}# Natural language${NC}" - echo " bash-helper ask \"compress folder\"" - echo " bash-helper ask \"search text in files\"" - echo " bash-helper task \"monitor cpu usage\"" + echo " super-man ask \"compress folder\"" + echo " super-man ask \"search text in files\"" + echo " super-man task \"monitor cpu usage\"" echo "" echo -e " ${DIM}# Browse and learn${NC}" - echo " bash-helper category network" - echo " bash-helper explain \"find . -name '*.txt'\"" + echo " super-man category network" + echo " super-man explain \"find . -name '*.txt'\"" echo "" echo -e " ${DIM}# Original modes (still work)${NC}" - echo " bash-helper ls size # Direct flag lookup" - echo " bash-helper # Interactive fzf mode" + echo " super-man ls size # Direct flag lookup" + echo " super-man # Interactive fzf mode" echo "" echo -e "${BOLD}${YELLOW}REQUIREMENTS${NC}" echo -e " ${GREEN}βœ“${NC} jq (for natural language queries)" @@ -75,8 +78,8 @@ show_help() { echo "" echo -e "${BOLD}${YELLOW}AI MODE${NC} πŸ€–" echo -e " ${GREEN}βœ“ NL2SH model detected!${NC} Use AI for complex queries:" - echo -e " ${GREEN}bash-helper ai \"find python files modified last week\"${NC}" - echo -e " ${GREEN}bash-helper ai \"count lines in all js files\"${NC}" + echo -e " ${GREEN}super-man ai \"find python files modified last week\"${NC}" + echo -e " ${GREEN}super-man ai \"count lines in all js files\"${NC}" echo "" echo " Other models available: llama3.2, qwen2.5" echo " To switch models, edit mode_ai() function" @@ -94,8 +97,8 @@ check_jq() { echo "Install it with: sudo apt install jq" echo "" echo "You can still use the original modes:" - echo " bash-helper COMMAND [FILTER]" - echo " bash-helper --interactive" + echo " super-man COMMAND [FILTER]" + echo " super-man --interactive" return 1 fi return 0 @@ -215,7 +218,7 @@ mode_ask() { if [ -z "$query" ]; then echo -e "${RED}Error: No query provided${NC}" - echo "Usage: bash-helper ask \"your question\"" + echo "Usage: super-man ask \"your question\"" return 1 fi @@ -230,8 +233,8 @@ mode_ask() { echo "" echo "Try:" echo " β€’ Using different keywords" - echo " β€’ Browse by category: bash-helper category files" - echo " β€’ List all commands: bash-helper --list" + echo " β€’ Browse by category: super-man category files" + echo " β€’ List all commands: super-man --list" return 1 fi @@ -270,7 +273,7 @@ mode_category() { echo "" jq -r '.categories | to_entries[] | " \(.key) : \(.value.name)"' "$DB_FILE" echo "" - echo "Usage: bash-helper category NAME" + echo "Usage: super-man category NAME" return 1 fi @@ -310,10 +313,10 @@ mode_ai() { if [ -z "$user_query" ]; then echo -e "${RED}Error: No query provided${NC}" - echo "Usage: bash-helper ai \"your complex query\"" + echo "Usage: super-man ai \"your complex query\"" echo "" echo "Example:" - echo " bash-helper ai \"find all python files modified in last week\"" + echo " super-man ai \"find all python files modified in last week\"" return 1 fi @@ -324,7 +327,7 @@ mode_ai() { echo "Install Ollama:" echo " curl -fsSL https://ollama.com/install.sh | sh" echo "" - echo "For now, try: bash-helper ask \"$user_query\"" + echo "For now, try: super-man ask \"$user_query\"" return 1 fi @@ -353,7 +356,7 @@ mode_ai() { if [ -z "$response" ]; then echo -e "${RED}Error: No response from AI model${NC}" echo "" - echo "Try a simpler query or use: bash-helper ask \"$user_query\"" + echo "Try a simpler query or use: super-man ask \"$user_query\"" return 1 fi @@ -387,10 +390,10 @@ mode_explain() { if [ -z "$cmd_line" ]; then echo -e "${RED}Error: No command provided${NC}" - echo "Usage: bash-helper explain \"command with flags\"" + echo "Usage: super-man explain \"command with flags\"" echo "" echo "Example:" - echo " bash-helper explain \"tar -czf archive.tar.gz folder/\"" + echo " super-man explain \"tar -czf archive.tar.gz folder/\"" return 1 fi @@ -635,105 +638,116 @@ extract_all_flags() { local flags_output="" if type "$cmd_name" 2>/dev/null | grep -q "shell builtin"; then - # Shell builtin - use help command (basic format) - flags_output=$(help "$cmd_name" 2>/dev/null | grep -E '^\s*-') + # Shell builtin - parse the "Options:" block from `help`, formatting each + # entry as "flag β€” description" to match the man-page output below. + flags_output=$(help "$cmd_name" 2>/dev/null | awk ' + /^[[:space:]]+-/ { + line=$0; sub(/^[[:space:]]+/, "", line); + if (match(line, /[ ][ ]+|\t/)) { + flag=substr(line,1,RSTART-1); + desc=substr(line,RSTART+RLENGTH); gsub(/^[[:space:]]+|[[:space:]]+$/,"",desc); + printf "\033[1;33m%s\033[0m \033[2mβ€”\033[0m %s\n", flag, desc; + } else { + printf "\033[1;33m%s\033[0m\n", line; + } + }') elif command -v "$cmd_name" &> /dev/null; then - # External command - extract from man page OPTIONS or DESCRIPTION section with descriptions - local man_content=$(man "$cmd_name" 2>/dev/null | col -b) - - # Try OPTIONS section first, then DESCRIPTION (GNU coreutils use DESCRIPTION) - # Exclude the section headers themselves to prevent early AWK exit - local options_section=$(echo "$man_content" | sed -n '/^OPTIONS/,/^[A-Z][A-Z]/{/^OPTIONS/d; /^[A-Z][A-Z]/d; p;}' | head -300) - - if [ -z "$options_section" ]; then - # Try DESCRIPTION section instead - options_section=$(echo "$man_content" | sed -n '/^DESCRIPTION/,/^[A-Z][A-Z]/{/^DESCRIPTION/d; /^[A-Z][A-Z]/d; p;}' | head -300) - fi - - if [ -n "$options_section" ]; then - # Parse flags with their descriptions using portable AWK - # Man pages have two formats: - # 1. " --help Output..." (description on same line) - # 2. " -a, --all\n description..." (description on next line, deeply indented) - flags_output=$(echo "$options_section" | awk ' - BEGIN { flag=""; desc=""; } - - /^[[:space:]]*-/ { - # Print previous flag if exists - if (flag != "") { - gsub(/^[[:space:]]+|[[:space:]]+$/, "", desc) - if (desc != "") { - printf "\033[1;33m%s\033[0m \033[2mβ€”\033[0m %s\n", flag, desc - } else { - printf "\033[1;33m%s\033[0m\n", flag - } - } - - # New flag line - extract flag and check for inline description - line = $0 - gsub(/^[[:space:]]+/, "", line) # Remove leading whitespace - - # Check if there is content after the flag (separated by multiple spaces/tabs) - # Flag pattern: starts with -, may have comma and long form - # Look for 2+ spaces/tabs separating flag from description - if (match(line, /^[^[:space:]]+([[:space:]]+[^[:space:]]+)?[[:space:]][[:space:]]+/)) { - # Description on same line - flag_end = RSTART + RLENGTH - 1 - flag = substr(line, 1, flag_end) - gsub(/[[:space:]]+$/, "", flag) # Trim trailing spaces - desc = substr(line, flag_end + 1) - gsub(/^[[:space:]]+/, "", desc) # Trim leading spaces from description - } else { - # No inline description, will be on next line(s) - flag = line - desc = "" - } - next - } - - /^[[:space:]]+[^-]/ { - # Description continuation line (indented, no leading dash) - if (flag != "") { - line = $0 - gsub(/^[[:space:]]+|[[:space:]]+$/, "", line) - if (desc == "") { - desc = line - } else { - desc = desc " " line - } - } - } - - /^[A-Z][A-Z]/ { - # Major section header - end of options - if (flag != "") { - gsub(/^[[:space:]]+|[[:space:]]+$/, "", desc) - if (desc != "") { - printf "\033[1;33m%s\033[0m \033[2mβ€”\033[0m %s\n", flag, desc - } else { - printf "\033[1;33m%s\033[0m\n", flag - } - } - exit - } + # External command - parse the FULL man page. Instead of reading a single + # section (the old behaviour, which truncated curl/find/ps/git/tar/... to a + # handful of flags), classify every section as option-bearing or not, then + # extract every flag with its description across all option sections. + # `col -bx` normalises tabs to spaces so indentation can be compared. + local man_content=$(man "$cmd_name" 2>/dev/null | col -bx) + if [ -n "$man_content" ]; then + flags_output=$(printf '%s\n' "$man_content" | awk ' + { lines[++N]=$0; } END { - # Print last flag - if (flag != "") { - gsub(/^[[:space:]]+|[[:space:]]+$/, "", desc) - if (desc != "") { - printf "\033[1;33m%s\033[0m \033[2mβ€”\033[0m %s\n", flag, desc - } else { - printf "\033[1;33m%s\033[0m\n", flag - } + # --- pre-pass: mark which sections actually contain option tags --- + secid=0; + for (i=1; i<=N; i++) { + raw=lines[i]; + if (raw ~ /^[A-Z]/) { secid++; sname[secid]=fw(raw); } + lsec[i]=secid; + if (taglike(i)) tcount[secid]++; } + for (s=1; s<=secid; s++) + secscan[s] = (sname[s] ~ /^OPTION/ || tcount[s] >= 3) ? 1 : 0; + + # --- main pass: emit "flag β€” description" for every option --- + flag=""; desc=""; curind=-1; + for (i=1; i<=N; i++) { + raw=lines[i]; + if (raw ~ /^[[:space:]]*$/) continue; # blank line + if (raw ~ /^[A-Z]/) { flush(); curind=-1; continue; } # section header + if (!secscan[lsec[i]]) continue; # skip prose sections + ind = match(raw, /[^ ]/) - 1; + t = raw; sub(/^[ ]+/, "", t); + + if (t ~ /^-/) { + if (ncommaopt(t) >= 3) { # comma-list prose, not a tag + if (flag != "" && ind > curind) adddesc(t); + continue; + } + if (flag != "" && ind > curind) { adddesc(t); continue; } # wrapped desc line + if (flag != "" && desc == "" && ind == curind) { # stacked alias + if (match(t, / +/)) { flag=flag", "substr(t,1,RSTART-1); desc=trim(substr(t,RSTART+RLENGTH)); } + else { flag=flag", "t; } + continue; + } + if (match(t, / +/)) { # description on same line + start_flag(substr(t,1,RSTART-1), trim(substr(t,RSTART+RLENGTH)), ind); continue; + } + j=i+1; while (j<=N && lines[j] ~ /^[[:space:]]*$/) j++; # look ahead + deeper = (j<=N && (match(lines[j],/[^ ]/)-1) > ind && trim(lines[j]) !~ /^-/); + if (deeper) { start_flag(t, "", ind); continue; } # description on next line(s) + split_tag(t, ind); continue; # single-space inline desc + } + if (flag != "") adddesc(t); # description continuation + } + flush(); } - ' | head -150) + function fw(s, w){ w=s; sub(/[[:space:]].*$/, "", w); return w; } + function ncommaopt(s, c,tmp){ tmp=s; c=gsub(/, +--?[A-Za-z]/, "", tmp); return c; } + function trim(s){ gsub(/^[[:space:]]+|[[:space:]]+$/, "", s); return s; } + function adddesc(s){ desc = (desc=="") ? trim(s) : desc" "trim(s); } + function start_flag(sig, d, k){ flush(); flag=sig; desc=d; curind=k; } + function taglike(i, raw,t,ind,j,nind){ + raw=lines[i]; + if (raw !~ /^[ ]+-/) return 0; + if (raw ~ /^[ ]+-{1,2}[A-Za-z0-9?][A-Za-z0-9?+._=-]* /) return 1; + ind = match(raw,/[^ ]/)-1; + j=i+1; while (j<=N && lines[j] ~ /^[[:space:]]*$/) j++; + if (j<=N) { nind=match(lines[j],/[^ ]/)-1; if (nind>ind && trim(lines[j]) !~ /^-/) return 1; } + return 0; + } + function split_tag(s, k, n,toks,p,tk,optend,sig,d){ + n=split(s,toks,/[ ]+/); optend=0; + for (p=1;p<=n;p++){ tk=toks[p]; + if (tk ~ /^-/) { optend=p; continue; } + if (tk ~ /^[A-Z0-9][A-Z0-9_<>|.=-]*[,]?$/) { optend=p; continue; } + if (tk ~ /^[<\[]/) { optend=p; continue; } + break; + } + if (optend==0) optend=1; + sig=""; for(p=1;p<=optend;p++) sig=(sig=="")?toks[p]:sig" "toks[p]; + d=""; for(p=optend+1;p<=n;p++) d=(d=="")?toks[p]:d" "toks[p]; + start_flag(sig, d, k); + } + function flush(){ + if (flag != "") { + desc=trim(desc); + if (desc != "") printf "\033[1;33m%s\033[0m \033[2mβ€”\033[0m %s\n", flag, desc; + else printf "\033[1;33m%s\033[0m\n", flag; + } + flag=""; desc=""; + } + ') fi - # Fallback: if no OPTIONS section, just get flag lines + # Fallback: nothing parsed (e.g. no man page) - grab raw flag lines if [ -z "$flags_output" ]; then - flags_output=$(echo "$man_content" | grep -E '^[[:space:]]*-' | head -100) + flags_output=$(printf '%s\n' "$man_content" | grep -E '^[[:space:]]*-' | head -100) fi fi @@ -1355,7 +1369,7 @@ if [ "$INTERACTIVE" = true ]; then echo "Error: fzf is not installed" echo "Install it with: sudo apt install fzf" echo "" - echo "Or use direct mode: bash-helper COMMAND [FILTER]" + echo "Or use direct mode: super-man COMMAND [FILTER]" exit 1 fi @@ -1386,7 +1400,7 @@ if [ "$INTERACTIVE" = true ]; then if [ -z "$SELECTED" ]; then # User pressed Esc or cancelled echo "" - echo -e "${YELLOW}Exiting Bash Buddy. Happy coding! πŸ‘‹${NC}" + echo -e "${YELLOW}Exiting Super Man. Happy coding! πŸ‘‹${NC}" exit 0 fi @@ -1415,14 +1429,7 @@ if [ "$INTERACTIVE" = true ]; then clear show_flags "$CMD" "$SYNTAX" "$DESC" - # After viewing flags, ask if user wants to search another command - echo "" - echo -e "${YELLOW}───────────────────────────────────────────────────────────${NC}" - echo -e "${CYAN}Press Enter to search another command, or Ctrl+C to exit${NC}" - echo -e "${YELLOW}───────────────────────────────────────────────────────────${NC}" - read -r - - # Clear screen for better UX + # Esc in the flag browser returns straight to the home menu (no intermediary step) clear done # Direct mode diff --git a/tests/README.md b/tests/README.md index d50d52d..da9d07d 100644 --- a/tests/README.md +++ b/tests/README.md @@ -1,6 +1,6 @@ -# Bash Buddy Test Suite +# Super Man Test Suite -Comprehensive testing framework for Bash Buddy with performance analysis and automated reporting. +Comprehensive testing framework for Super Man with performance analysis and automated reporting. ## Overview @@ -177,7 +177,7 @@ Interactive HTML dashboard with: ### Required - **bash** 4.0+ - Shell interpreter -- **bash-helper.sh** - Script being tested +- **super-man.sh** - Script being tested ### Optional - **jq** - JSON parsing (for detailed analysis) @@ -210,7 +210,7 @@ brew install jq fzf expect bc **Output:** ``` ═══════════════════════════════════════════════════════════ - Bash Buddy Test Suite + Super Man Test Suite 2025-01-XX XX:XX:XX ═══════════════════════════════════════════════════════════ @@ -218,7 +218,7 @@ brew install jq fzf expect bc ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Test #1: Help display (--help) -βœ“ PASSED (45ms) - Output contains: "Bash Buddy" +βœ“ PASSED (45ms) - Output contains: "Super Man" Test #2: List all commands (--list) βœ“ PASSED (32ms) - Output contains: "Available commands" @@ -257,7 +257,7 @@ Pass Rate: 95% **Output:** ``` ═══════════════════════════════════════════════════════════ - Bash Buddy Performance Analysis + Super Man Performance Analysis 2025-01-XX XX:XX:XX ═══════════════════════════════════════════════════════════ @@ -290,7 +290,7 @@ exit $EXIT_CODE ### GitHub Actions Example ```yaml -name: Test Bash Buddy +name: Test Super Man on: [push, pull_request] @@ -444,7 +444,7 @@ print_section "Custom Tests" run_test_with_output_check \ "My custom test" \ - "../bash-helper.sh ask 'my query'" \ + "../super-man.sh ask 'my query'" \ "expected output" print_summary @@ -498,15 +498,15 @@ Run test and verify output contains expected string. ```bash run_test_with_output_check \ "Help test" \ - "./bash-helper.sh --help" \ - "Bash Buddy" + "./super-man.sh --help" \ + "Super Man" ``` #### `run_benchmark(name, command, iterations)` Run performance benchmark with statistics. ```bash -run_benchmark "Ask mode" "./bash-helper.sh ask 'test'" 10 +run_benchmark "Ask mode" "./super-man.sh ask 'test'" 10 ``` #### `skip_test(name, reason)` @@ -612,7 +612,7 @@ A: Yes, but be careful with shared resources (log files, etc.) A: No, unless installing dependencies **Q: Will tests modify my system?** -A: No, tests only read/execute bash-helper.sh +A: No, tests only read/execute super-man.sh **Q: Can I run tests on macOS?** A: Yes, with dependencies installed via Homebrew @@ -632,7 +632,7 @@ A: Check `tests/logs/test_N_*.log` for detailed output ## License -Same as Bash Buddy - see main repository +Same as Super Man - see main repository ## Support @@ -642,6 +642,6 @@ Same as Bash Buddy - see main repository --- -**Bash Buddy Test Suite v1.0.0** +**Super Man Test Suite v1.0.0** Ensuring quality and performance at every commit! πŸš€ diff --git a/tests/analyze-performance.sh b/tests/analyze-performance.sh index c0da0ad..2cd0191 100755 --- a/tests/analyze-performance.sh +++ b/tests/analyze-performance.sh @@ -1,5 +1,5 @@ #!/bin/bash -# Performance Analysis Tool for Bash Buddy +# Performance Analysis Tool for Super Man # Analyzes test logs and benchmark data to generate insights # Color definitions @@ -27,7 +27,7 @@ mkdir -p "$REPORT_DIR" print_header() { echo -e "${BOLD}${CYAN}" echo "═══════════════════════════════════════════════════════════" - echo " Bash Buddy Performance Analysis" + echo " Super Man Performance Analysis" echo " $(date '+%Y-%m-%d %H:%M:%S')" echo "═══════════════════════════════════════════════════════════" echo -e "${NC}" @@ -59,7 +59,7 @@ generate_performance_report() { local bench_file="$PERF_LOG_DIR/benchmarks.csv" local report_file="$REPORT_DIR/performance-report.md" - echo "# Bash Buddy Performance Report" > "$report_file" + echo "# Super Man Performance Report" > "$report_file" echo "" >> "$report_file" echo "**Generated:** $(date '+%Y-%m-%d %H:%M:%S')" >> "$report_file" echo "" >> "$report_file" @@ -188,7 +188,7 @@ generate_html_report() { - Bash Buddy Performance Report + Super Man Performance Report