Merge pull request #1 from DevArqf/v0.2.2

feat: Update to v0.2.2 - Roadmap v0.2.2 Complete

Author: DevArqf

.gitignore

@@ -16,6 +16,7 @@ dist/
 .coverage
 remove_comments.py
 htmlcov/
+dbug-test-env/
 
 # Database
 *.db

README.md

@@ -6,14 +6,12 @@
 Stop Googling. Understand your errors.
 
 [![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
-[![PyPI](https://img.shields.io/badge/pypi-v0.1.2-orange.svg)](https://pypi.org/project/debugbuddy-cli/0.1.2/)
+[![PyPI](https://img.shields.io/badge/pypi-v0.2.2-orange.svg)](https://pypi.org/project/debugbuddy-cli/0.2.2/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
 
 [Install](#installation) •
 [Quick Start](#quick-start) •
-[Features](#features-screenshots) •
-[Screenshots](#features-screenshots) •
 [Docs](#documentation)
 
 </div>
@@ -29,16 +27,16 @@ pip install debugbuddy-cli
 ## Quick Start
 
 ```bash
-db explain "NameError: name 'x' is not defined"
-db explain error.log
-python script.py 2>&1 | db explain
-db interactive
+dbug explain "NameError: name 'x' is not defined"
+dbug explain error.log
+python script.py 2>&1 | dbug explain
+dbug interactive
 ```
 
 ### Example Output
 
 ```bash
-$ db explain "NameError: name 'user_id' is not defined"
+$ dbug explain "NameError: name 'user_id' is not defined"
 
 ╭─────────────────── 🐛 Error Explanation ───────────────────╮
 │ NameError                                                  │
@@ -61,188 +59,112 @@ $ db explain "NameError: name 'user_id' is not defined"
 💭 You've seen this type of error before
    Last occurrence: 2 hours ago
 
-💡 Tip: Use db explain -e to see code examples
+💡 Tip: Use dbug explain -e to see code examples
 ```
 
-## Features-Screenshots
-
-```bash
-db
-```
-
-<img width="614" height="255" alt="db" src="https://github.com/user-attachments/assets/d468c297-bd2c-4eb9-a447-085941c71cf0" />
-
----
-
-```bash
-db explain "NameError: name 'user_id' is not defined"
-```
-
-<img width="1037" height="363" alt="db explain NameError" src="https://github.com/user-attachments/assets/244173c4-1b50-4c06-92cf-8e0574fdc914" />
-
----
-
-```bash
-db explain -e "IndexError: list index out of range"
-```
-
-<img width="1041" height="581" alt="db explain -e" src="https://github.com/user-attachments/assets/2e2f0c08-e276-48cd-a448-32f04707d876" />
-
----
-
-```bash
-db interactive
-```
-
-<img width="692" height="264" alt="db interactive" src="https://github.com/user-attachments/assets/8468bbe4-3fc8-4a65-b5ab-f10db2f8bd6c" />
-
----
-
-```bash
-[EXECUTED IN INTERACTIVE MENU] TypeError: unsupported operand type(s) for +: 'int' and 'str'
-```
-
-<img width="740" height="470" alt="db interactive  error debug + code example" src="https://github.com/user-attachments/assets/83620a8d-7eae-4a89-a43c-0d5adbf04890" />
-
----
-
-```bash
-[EXECUTED IN INTERACTIVE MENU] help
-```
-
-<img width="301" height="127" alt="db interactive  help" src="https://github.com/user-attachments/assets/698a1b98-2875-4358-a159-242d0ab2f2ff" />
-
----
+## Documentation
 
 ```bash
-[EXECUTED IN INTERACTIVE MENU] history
-```
-
-<img width="301" height="190" alt="db interactive  history" src="https://github.com/user-attachments/assets/998acfdd-6976-4a64-9284-d756415744b0" />
-
----
+All Commands
 
-```bash
-db history
+dbug explain <error>
+dbug interactive
+dbug watch <dir>
+dbug history
+dbug history --stats
+dbug search <keyword>
+dbug config --show
+dbug config --reset
+dbug --version
 ```
 
-<img width="691" height="604" alt="db history" src="https://github.com/user-attachments/assets/807b1dbb-5240-42cd-b55d-fe812286ae58" />
-
----
-
 ```bash
-db history --stats
-```
-
-<img width="740" height="276" alt="db history  --stats" src="https://github.com/user-attachments/assets/16f2f9bd-55e0-41be-a8b4-c4ae4b49df2e" />
-
----
+Extra Options
 
-```bash
-db search "import"
+dbug explain -e "SyntaxError: invalid syntax"
+dbug explain -v error.log
+dbug watch src/ --lang [CODING-LANG]
+dbug config ai_provider openai
+dbug config language [CODING-LANG]
+dbug config languages "" (Disables language filtering)
+dbug explain --ai "complex error"
 ```
 
-<img width="725" height="212" alt="db search" src="https://github.com/user-attachments/assets/4cd85f05-1132-4d1b-a9a2-f9386d55cb9b" />
+## Supported Error Types
 
----
+### Python (60+ built-in exceptions & common issues)
 
-```bash
-db config --show
-```
+- `ArithmeticError` • `AssertionError` • `AttributeError` • `BlockingIOError`
+- `BrokenPipeError` • `BufferError` • `ChildProcessError` • `ConnectionAbortedError`
+- `ConnectionError` • `ConnectionRefusedError` • `ConnectionResetError`
+- `EOFError` • `FileExistsError` • `FileNotFoundError` • `FloatingPointError`
+- `ImportError` • `IndentationError` • `IndexError` • `InterruptedError`
+- `IsADirectoryError` • `KeyError` • `KeyboardInterrupt` • `MemoryError`
+- `ModuleNotFoundError` • `NameError` • `NotADirectoryError` • `NotImplementedError`
+- `OSError` • `OverflowError` • `PermissionError` • `ProcessLookupError`
+- `RecursionError` • `ReferenceError` • `RuntimeError` • `StopIteration`
+- `SyntaxError` • `TabError` • `TimeoutError` • `TypeError`
+- `UnboundLocalError` • `UnicodeDecodeError` • `UnicodeEncodeError`
+- `ValueError` • `ZeroDivisionError` • and many more warnings (DeprecationWarning, FutureWarning, etc.)
 
-<img width="710" height="307" alt="db config  --show" src="https://github.com/user-attachments/assets/6d617847-501a-4f9b-876b-b473aab9ad2e" />
+### JavaScript / Node.js (All 7 built-in errors)
 
-## Documentation
+- `AggregateError` • `EvalError` • `InternalError` • `RangeError`
+- `ReferenceError` • `SyntaxError` • `TypeError` • `URIError`
 
-```bash
-All Commands
-
-db explain <error>
-db interactive
-db watch <dir>
-db history
-db history --stats
-db search <keyword>
-db config --show
-db --version
-```
+### TypeScript (Core compiler errors & type issues)
 
-```bash
-Extra Options
+- Type Error (`TS2345`: not assignable) • Declaration Error (`TS2304`: cannot find name, `TS1008`: expected)
+- Module Resolution (`TS2307`: cannot find module) • Interface Error (`TS2322/2324`: missing property)
+- Generic Type Error (`TS2322`: constraint violated) • Union Type Error (`TS2322/2345`: not assignable)
+- Async Type Error (`TS2322`: promise mismatch) • Syntax Error (`TS1003/1005`: invalid token)
+- Null/Undefined Error (`TS2532/2533`: strict null checks) • Import/Export Error (`TS2305/1192`: not found)
 
-db explain -e "SyntaxError: invalid syntax"
-db explain -v error.log
-db watch src/ --lang javascript
-db config --set ai_provider openai
-db config --set openai_api_key sk-...
-db explain --ai "complex error"
-```
-
-```
-Supported Python Errors
-
-- Syntax
-- Indentation
-- Name
-- Attribute
-- Type
-- Value
-- Import
-- Module not found
-- Index
-- Key
-- File not found
-- Recursion
-```
+### C / C++ (Compiler, linker & runtime)
 
-```
-Supported JavaScript Errors
+- Syntax Error • Undefined Reference / Linker Error
+- Segmentation Fault (segfault) • Null Pointer Dereference
+- Type Mismatch • Array Bounds Error • Memory Leak
+- Format String Mismatch • Division by Zero • Uninitialized Variable
+- Include Error • Undefined Behavior
 
-- Reference
-- Type
-- Syntax
-- Range
-```
+### PHP (All 16+ error levels)
 
-```
-Supported Universal Errors
+- Parse Error (`E_PARSE`) • Fatal Error (`E_ERROR`) • Warning (`E_WARNING`)
+- Notice (`E_NOTICE`) • Deprecated (`E_DEPRECATED`) • Type Error (`E_RECOVERABLE_ERROR`)
+- Division by Zero • Out of Memory • Strict (`E_STRICT`) • Core Error (`E_CORE_ERROR`)
+- Core Warning (`E_CORE_WARNING`) • Compile Error (`E_COMPILE_ERROR`)
+- Compile Warning (`E_COMPILE_WARNING`) • User Error (`E_USER_ERROR`)
+- User Warning (`E_USER_WARNING`) • User Notice (`E_USER_NOTICE`) • User Deprecated (`E_USER_DEPRECATED`)
 
-- Network
-- Permission
-- Database
-- API key
-```
+### Universal / Common Errors (cross-language)
 
-## Configuration
+- Compilation Error • Logic Error • Runtime Error • Linkage Error
+- Segmentation Fault • Network Error • Permission Error
+- Timeout Error • Memory Error • Database Error
+- API Key Error • SSL/Certificate Error • Input/Validation Error
+- Off-by-One Error • Infinite Loop
 
-```bash
-db config --show
-db config --set ai_provider openai
-db config --set default_language javascript
-db config --reset
-```
+> **Total supported error patterns:** **150+** and growing (expanded via official docs & common patterns)
 
 ## Contributing
 
 Contribute in any way you want. You can report bugs, add patterns, write docs, or extend support for other languages. See [CONTRIBUTING.md](https://github.com/DevArqf/DeBugBuddy/blob/main/docs/CONTRIBUTING.md) for the full guide.
 
 ## Roadmap
 
-### v0.2.0
+### v0.2.0 ✅
 
 - Typescript, C and PHP Language Support
-- VSCode extension
-- Local AI support
-- Team error sharing
+- AI support
 
-### v0.3.0
+### v0.3.0 ❌
 
-- IDE plugins
 - Error prediction
 - Custom pattern training
 - GitHub integration
 
-### v1.0.0
+### v1.0.0 ❌
 
 - 10 or more languages
 - Enterprise features
@@ -251,24 +173,15 @@ Contribute in any way you want. You can report bugs, add patterns, write docs, o
 
 ## FAQ
 
-**Q:** **Does it work offline?**
-**A:** Yes. You only need internet if you turn on optional AI mode.
-
 **Q:** **Is my code private?**
 **A:** Yes. Everything stays local unless you opt into AI mode.
 
-**Q:** **How is this different from ChatGPT?**
-**A:** It responds instantly, works offline, learns from your own history, and sits inside your terminal.
-
 **Q:** **Does it replace StackOverflow?**
 **A:** For debugging, yes. You stop switching tools.
 
 **Q:** **Can I add custom patterns?**
 **A:** Yes. Edit the JSON files in `~/.debugbuddy/patterns/`.
 
-**Q:** **Is team use planned?**
-**A:** Yes. It is on the roadmap.
-
 ## Support
 
 If DeBugBuddy helps you, star the GitHub repo. Stars help other developers discover the tool.
@@ -279,3 +192,4 @@ Made with ❤️ by DevArqf
 Stop Googling. Understand your errors.
 
 </div>
+```

build.bat

@@ -12,7 +12,7 @@ REM
 echo ▶ Cleaning old builds...
 if exist build rmdir /s /q build
 if exist dist rmdir /s /q dist
-if exist debugbuddy-cli.egg-info rmdir /s /q debugbuddy-cli.egg-info
+if exist debugbuddy_cli.egg-info rmdir /s /q debugbuddy_cli.egg-info
 echo ✓ Cleaned old builds
 echo.
 
@@ -78,9 +78,9 @@ if "%choice%"=="1" (
     echo ✓ Installed locally
     echo.
     echo Test it:
-    echo   db
-    echo   db --version
-    echo   db explain "test error"
+    echo   dbug
+    echo   dbug --version
+    echo   dbug explain "test error"
     pause
     goto :end
 ) else if "%choice%"=="2" (

build.sh

@@ -98,9 +98,9 @@ case $choice in
         print_success "Installed locally"
         echo ""
         echo "Test it:"
-        echo "  db"
-        echo "  db --version"
-        echo "  db explain \"test error\""
+        echo "  dbug"
+        echo "  dbug --version"
+        echo "  dbug explain \"test error\""
         ;;
     2)
         print_step "Uploading to TestPyPI..."

debugbuddy/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.1.2"
+__version__ = "0.2.2"
 __author__ = "DevArqf"
 __license__ = "MIT"
 

debugbuddy/ai/__init__.py

@@ -1 +1,7 @@
-__all__ = []
+from .providers import get_provider
+from .prompts import get_explanation_prompt
+
+__all__ = [
+    'get_provider', 
+    'get_explanation_prompt'
+]