forgecodecli 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

forgecodecli/tools.py

@@ -1,7 +1,35 @@
 from pathlib import Path
 import os
+import shutil
+from forgecodecli.path_resolver import resolve_path
 
+
+_undo_stack = []
+
+class FileOperation:
+    """Represent a reversible file operation"""
+    def __init__(self, op_type: str, src: str, dst: str = None, content: str = None):
+        self.op_type = op_type  # 'write', 'delete', 'move', 'mkdir', 'rmdir'
+        self.src = src
+        self.dst = dst
+        self.content = content  # For write operations
+    def undo(self):
+        """Reverse the operation"""
+        if self.op_type == "write":
+            os.remove(self.src)
+        elif self.op_type == "delete":
+            with open(self.src, "w", encoding="utf-8") as f:
+                f.write(self.content)
+        elif self.op_type == "move":
+            os.rename(self.dst, self.src)
+        elif self.op_type == "mkdir":
+            os.rmdir(self.src)
+        elif self.op_type == "rmdir":
+            os.makedirs(self.src, exist_ok=True)
+            
+            
 def is_safe_path(path: str) -> bool:
+    """Check if path is safe (no absolute paths, no parent directory traversal)"""
     if not path:
         return False
     if os.path.isabs(path):
@@ -13,19 +41,17 @@ def is_safe_path(path: str) -> bool:
 
 def read_file(path: str) -> str:
     """Read a file and return its contents"""
-    file_path = Path(path)
+    full_path = resolve_path(path)
+    file_path = Path(full_path)
  
     if not file_path.exists():
-     return f"Error: File '{path}' does not exist."
+        return f"Error: File '{path}' does not exist."
  
     return file_path.read_text()
 
 
-def list_files(path:str = ".")-> str:
-    if not is_safe_path(path):
-        return "Error: Unsafe path detected."
-    
-    full_path = os.path.join(os.getcwd(), path)
+def list_files(path: str = ".") -> str:
+    full_path = resolve_path(path)
     
     if not os.path.exists(full_path):
         return "❌ Path does not exist."
@@ -41,12 +67,10 @@ def list_files(path:str = ".")-> str:
         return "\n".join(sorted(items))
     except Exception as e:
         return f"❌ Error reading directory: {str(e)}"
+
     
 def write_file(path: str, content: str) -> str:
-    if not is_safe_path(path):
-        return "❌ Invalid path."
-
-    full_path = os.path.join(os.getcwd(), path)
+    full_path = resolve_path(path)
 
     # Prevent overwriting existing files (for now)
     if os.path.exists(full_path):
@@ -59,16 +83,98 @@ def write_file(path: str, content: str) -> str:
     try:
         with open(full_path, "w", encoding="utf-8") as f:
             f.write(content)
+        _undo_stack.append(FileOperation("write", full_path))
+
         return f"✅ File written: {path}"
     except Exception:
         return "❌ Failed to write file."
 
-def create_dir(path: str)-> str:
-    if not is_safe_path(path):
-        return "❌ Invalid path."
-    full_path = os.path.join(os.getcwd(), path)
+def create_dir(path: str) -> str:
+    full_path = resolve_path(path)
+    if os.path.exists(full_path):
+        return f"❌ Directory already exists: {path}"
     try:
         os.makedirs(full_path, exist_ok=True)
+        _undo_stack.append(FileOperation("mkdir", full_path))
         return f"✅ Directory created: {path}"
-    except Exception:
-        return "❌ Failed to create directory."
+    except Exception as e:
+        return f"❌ Failed to create directory: {str(e)}"
+    
+def delete_file(path: str) -> str:
+    full_path = resolve_path(path)
+    if not os.path.exists(full_path):
+        return f"❌ File '{path}' does not exist."
+    if os.path.isdir(full_path):
+        return f"❌ '{path}' is a directory, not a file."
+    try:
+        content = Path(full_path).read_text()
+        os.remove(full_path)
+        _undo_stack.append(FileOperation("delete", full_path, content=content))
+        return f"✅ File deleted: {path}"
+    except Exception as e:
+        return f"❌ Failed to delete file: {str(e)}"
+    
+def delete_dir(path: str) -> str:
+    full_path = resolve_path(path)
+    if not os.path.exists(full_path):
+        return f"❌ Directory '{path}' does not exist."
+    if not os.path.isdir(full_path):
+        return f"❌ '{path}' is not a directory."
+    try:
+        shutil.rmtree(full_path)
+        _undo_stack.append(FileOperation("rmdir", full_path))
+        return f"✅ Directory deleted: {path}"
+    except Exception as e:
+        return f"❌ Failed to delete directory: {str(e)}"
+    
+def move_file(src: str, dst: str) -> str:
+    full_src = resolve_path(src)
+    full_dst = resolve_path(dst)
+
+    if not os.path.exists(full_src):
+        return f"❌ Source file '{src}' does not exist."
+    if os.path.isdir(full_src):
+        return f"❌ Source '{src}' is a directory, not a file."
+    
+    dst_parent = os.path.dirname(full_dst)
+    if dst_parent and not os.path.exists(dst_parent):
+        return f"❌ Destination parent directory does not exist."
+
+    try:
+        os.rename(full_src, full_dst)
+        _undo_stack.append(FileOperation("move", full_src, full_dst))
+        return f"✅ File moved from '{src}' to '{dst}'"
+    except Exception as e:
+        return f"❌ Failed to move file: {str(e)}"
+    
+def move_dir(src: str, dst: str) -> str:
+    full_src = resolve_path(src)
+    full_dst = resolve_path(dst)
+
+    if not os.path.exists(full_src):
+        return f"❌ Source directory '{src}' does not exist."
+    if not os.path.isdir(full_src):
+        return f"❌ Source '{src}' is not a directory."
+    
+    dst_parent = os.path.dirname(full_dst)
+    if dst_parent and not os.path.exists(dst_parent):
+        return f"❌ Destination parent directory does not exist."
+
+    try:
+        os.rename(full_src, full_dst)
+        _undo_stack.append(FileOperation("move", full_src, full_dst))
+        return f"✅ Directory moved from '{src}' to '{dst}'"
+    except Exception as e:
+        return f"❌ Failed to move directory: {str(e)}"
+    
+def undo() -> str:
+    """Undo the last file operation"""
+    if not _undo_stack:
+        return "⚠️ Nothing to undo."
+    
+    try:
+        operation = _undo_stack.pop()
+        operation.undo()
+        return f"✅ Undid {operation.op_type} operation"
+    except Exception as e:
+        return f"❌ Failed to undo: {str(e)}"

forgecodecli-0.2.0.dist-info/METADATA

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: forgecodecli
+Version: 0.2.0
+Summary: A minimal agentic CLI for forging code
+Author: Sudhanshu
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: keyring>=24.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.25.0; extra == "anthropic"
+
+# ForgeCodeCLI
+
+An agentic, file-aware command-line tool that lets you manage and modify your codebase using natural language — powered by LLMs.
+
+It acts as a safe, deterministic AI agent that can read files, create/delete directories, and write code only through explicit tools, not raw hallucination.
+
+## Features
+
+- ✅ **Agentic workflow** - LLM decides actions, CLI executes them safely
+- ✅ **File operations** - Read, list, create, write, delete, move files & directories
+- ✅ **Undo support** - Reverse the last file operation with `undo`
+- ✅ **Multi-provider LLMs** - Gemini, OpenAI (GPT), Anthropic (Claude), Groq
+- ✅ **Model selection** - Choose specific models for each provider
+- ✅ **Secure storage** - API keys stored in system keyring (no env vars)
+- ✅ **Deterministic** - Rule-based execution with validation
+- ✅ **Interactive CLI** - Real-time agent feedback
+
+## Installation
+
+Requires Python 3.9+
+
+```bash
+pip install forgecodecli
+```
+
+**Optional:** For Anthropic (Claude) support, install with the anthropic extra:
+
+```bash
+pip install forgecodecli[anthropic]
+```
+
+Or install later when prompted during setup.
+
+## Quick Start
+
+### Initialize (one-time setup)
+
+```bash
+forgecodecli init
+```
+
+You will be prompted to:
+
+1. **Select LLM Provider**
+
+   ```
+   1) Google Gemini
+   2) OpenAI
+   3) Anthropic (Claude)
+   4) Groq
+   ```
+
+2. **Select Model** (varies by provider)
+   - Gemini: `gemini-2.5-flash`, `gemini-2.0-flash`, `gemini-1.5-pro`
+   - OpenAI: `gpt-4o`, `gpt-4-turbo`, `gpt-3.5-turbo`
+   - Claude: `claude-3-5-sonnet`, `claude-3-opus`, `claude-3-haiku`
+   - Groq: `llama-3.3-70b`, `mixtral-8x7b`, `gemma2-9b-it`
+
+3. **Enter API Key** (stored securely in system keyring)
+
+### Start the agent
+
+```bash
+forgecodecli
+```
+
+You are now in interactive agent mode. Example commands:
+
+```
+create a folder src/app with main.py that prints "Hello World"
+read the config.py file
+list all files in src
+delete old_backup folder
+move test.py to tests/test.py
+undo
+```
+
+Type `help` for built-in commands, or press `Ctrl + C` to exit.
+
+## Reset Configuration
+
+To remove all configuration and API keys:
+
+```bash
+forgecodecli reset
+```
+
+## Security
+
+- API keys are stored using the system keyring
+- No API keys are written to config files or environment variables
+- Config files contain only non-sensitive metadata
+
+## How It Works
+
+1. You enter a natural language command
+2. The LLM decides the next valid action
+3. ForgeCodeCLI executes the action with validation
+4. The agent receives feedback and responds
+5. Process repeats until agent provides an answer
+
+**Safety mechanisms:**
+
+- Action limit of 2 per request (prevents infinite loops)
+- Conversation context maintained for agent awareness
+- All operations logged and reversible with `undo`
+- Strict tool validation
+
+## Supported Actions
+
+The agent can execute these operations:
+
+**File Operations:**
+| Action | Description |
+|--------|-------------|
+| `read_file` | Read and display file contents |
+| `list_files` | List files in a directory |
+| `create_dir` | Create new directories |
+| `write_file` | Create and write files |
+| `delete_file` | Delete files permanently |
+| `delete_dir` | Delete directories |
+| `move_file` | Move or rename files |
+| `move_dir` | Move or rename directories |
+| `undo` | Reverse the last operation |
+
+**Git Operations:**
+| Action | Description |
+|--------|-------------|
+| `git_init` | Initialize git repository |
+| `git_add` | Stage files for commit |
+| `git_commit` | Commit staged changes |
+| `git_push` | Push to remote repository |
+| `git_set_origin` | Set remote repository URL |
+| `git_status` | Show repository status |
+| `git_log` | View commit history |
+| `git_branch` | Manage branches |
+| `git_pull` | Pull from remote |
+| `git_clone` | Clone a repository |
+
+All actions are executed safely with validation and error handling.
+
+## Roadmap
+
+### ✅ v1 (Released)
+
+- Basic file operations (read, list, create, write)
+- Gemini support
+- Interactive CLI
+
+### ✅ v2 (Released)
+
+- **Undo functionality** - Stack-based operation reversal
+- **Delete & move operations** - Full file/directory manipulation
+- **Multi-provider support** - Gemini, OpenAI, Anthropic, Groq
+- **Model selection** - Choose specific models per provider
+- **Auto-install SDKs** - Anthropic SDK installs on demand
+- **Fixed agent loop** - Proper conversation flow with max actions
+
+### ✅ v3 (Current)
+
+- **Git operations** - init, add, commit, push, pull, status, log, branch, clone, set_origin
+- **Git workflow support** - Full version control integration
+- **Repository management** - Clone and manage git repos
+
+### 🚀 v4 (Planned)
+
+- Copy files/directories
+- Full undo/redo history (not just last operation)
+- File search capabilities
+- Code generation templates
+- Batch operations
+- Backup/snapshot functionality
+
+## License
+
+MIT License
+
+## Author
+
+Built by Sudhanshu

forgecodecli-0.2.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+forgecodecli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+forgecodecli/agent.py,sha256=4CDG8mVWwCpqmJlxrqIa7JXB3TQV-w_BBbXROpv9YPY,9651
+forgecodecli/cli.py,sha256=K7YE7gAoOjSSQkoXE5L5gkHnmDP-kdedDtQLeo3yitw,15214
+forgecodecli/config.py,sha256=VFl21RTu0aTkYS3ConcgLoHD7LuV890d9LoXsAaYs5M,595
+forgecodecli/git_tools.py,sha256=BAjkqLlv-TqLhJka9UM2wHxXJAgVOjKLmgZgJp83thQ,2168
+forgecodecli/path_resolver.py,sha256=sjAATxw6Y6pfDri1LIHXTm88iVkngNpiYf_sYSJArno,509
+forgecodecli/secrets.py,sha256=ZEaHYF9TkibST0IwEBHZbbazaLWJZR04n4FyGx9n1gU,328
+forgecodecli/tools.py,sha256=3NzX7S7eHVm0jVK4O1Z8BstIlZPvSVsRK5bbCOu02jE,6094
+forgecodecli-0.2.0.dist-info/METADATA,sha256=yWBa7ZGhVvZwOpmxwTVnQ0ieZc7E1cykYtv7NGf65eM,5595
+forgecodecli-0.2.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+forgecodecli-0.2.0.dist-info/entry_points.txt,sha256=KQDckJoVfVJtVxu3icUI99k-gpbIn_tihUG_ZwU4BAw,55
+forgecodecli-0.2.0.dist-info/top_level.txt,sha256=OJLRIfDbRvaNKg55kSvPDagGlTxajt3m1jnI3X5x204,13
+forgecodecli-0.2.0.dist-info/RECORD,,

{forgecodecli-0.1.0.dist-info → forgecodecli-0.2.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (82.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

forgecodecli-0.1.0.dist-info/METADATA

@@ -1,127 +0,0 @@
-Metadata-Version: 2.4
-Name: forgecodecli
-Version: 0.1.0
-Summary: A minimal agentic CLI for forging code
-Author: Sudhanshu
-License: MIT
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: typer[all]>=0.9.0
-Requires-Dist: openai>=1.0.0
-Requires-Dist: keyring>=24.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-
-# ForgeCodeCLI
-
-An agentic, file-aware command-line tool that lets you manage and modify your codebase using natural language — powered by LLMs.
-
-It acts as a safe, deterministic AI agent that can read files, create directories, and write code only through explicit tools, not raw hallucination.
-
-## Features
-
-- Agentic workflow (LLM decides actions, CLI executes them)
-- File-aware (read, list, create, write files & directories)
-- Secure API key storage (no env vars required after setup)
-- Deterministic and rule-based execution
-- Interactive CLI experience
-- Built to support multiple LLM providers (Gemini first)
-
-## Installation
-
-Requires Python 3.9+
-
-```bash
-pip install forgecodecli
-```
-
-## Quick Start
-
-### Initialize (one-time setup)
-
-```bash
-forgecodecli init
-```
-
-You will be prompted to:
-- Select an LLM provider
-- Enter your API key (stored securely)
-
-### Start the agent
-
-```bash
-forgecodecli
-```
-
-You are now in interactive agent mode. Example commands:
-
-```
-create a folder src/app and add a main.py file that prints hello
-read the README.md file
-list all files in the src directory
-quit
-```
-
-Or press `Ctrl + C` to exit.
-
-## Reset Configuration
-
-To remove all configuration and API keys:
-
-```bash
-forgecodecli reset
-```
-
-## Security
-
-- API keys are stored using the system keyring
-- No API keys are written to config files or environment variables
-- Config files contain only non-sensitive metadata
-
-## How It Works
-
-1. You enter a natural language command
-2. The LLM decides the next valid action
-3. ForgeCodeCLI executes the action safely
-4. The agent responds with the result
-
-The agent is strictly limited to predefined tools, ensuring predictable and safe behavior.
-
-## Supported Actions
-
-- `read_file`
-- `list_files`
-- `create_dir`
-- `write_file`
-
-No action outside these tools is permitted.
-
-## Status
-
-This project is in active development.
-
-**Current version supports:**
-- Gemini LLM
-- Interactive agent mode
-
-**Planned features:**
-- Multiple LLM providers
-- Model switching
-- Streaming responses
-- Session memory
-
-## License
-
-MIT License
-
-## Author
-
-Built by Sudhanshu
-
-
-
-
-
-

forgecodecli-0.1.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-forgecodecli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-forgecodecli/agent.py,sha256=ta-Ab8ORFzEQ0pbnCjf7CR6g4itBzZtjD6XMmay5Vgg,4124
-forgecodecli/cli.py,sha256=h1ip6kRoDLwco5558vYfyCEp8XMQDNvTVt8cqBRhuJA,7116
-forgecodecli/config.py,sha256=VFl21RTu0aTkYS3ConcgLoHD7LuV890d9LoXsAaYs5M,595
-forgecodecli/secrets.py,sha256=ZEaHYF9TkibST0IwEBHZbbazaLWJZR04n4FyGx9n1gU,328
-forgecodecli/tools.py,sha256=f6_bsblRpbYerHussznXNdnF93j3G6ppYWCHUgveoAI,2096
-forgecodecli-0.1.0.dist-info/METADATA,sha256=4w3PTAFjS7q-n8FeJ16PoMutA_-YxMqZ2WyIAlOpKAE,2677
-forgecodecli-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-forgecodecli-0.1.0.dist-info/entry_points.txt,sha256=KQDckJoVfVJtVxu3icUI99k-gpbIn_tihUG_ZwU4BAw,55
-forgecodecli-0.1.0.dist-info/top_level.txt,sha256=OJLRIfDbRvaNKg55kSvPDagGlTxajt3m1jnI3X5x204,13
-forgecodecli-0.1.0.dist-info/RECORD,,