devagent-cli 3.2.1__tar.gz → 3.2.3__tar.gz

{devagent_cli-3.2.1/devagent_cli.egg-info → devagent_cli-3.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devagent-cli
-Version: 3.2.1
+Version: 3.2.3
 Summary: Professional Local autonomous coding agent powered by Ollama
 Author: Vedant Jadhav
 License: MIT
@@ -31,6 +31,7 @@ Dynamic: license-file
 ### A Lightweight Local Open-Source Miniature of Claude Code CLI
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI version](https://badge.fury.io/py/devagent-cli.svg)](https://badge.fury.io/py/devagent-cli)
 [![Python 3.11+](https://img.shields.io/badge/Python-3.11+-3776AB.svg?logo=python&logoColor=white)](https://www.python.org/)
 [![Ollama](https://img.shields.io/badge/Ollama-Local%20LLM-black.svg?logo=ollama)](https://ollama.ai)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
@@ -140,16 +141,16 @@ devagent run --task "Fix the divide-by-zero bug" --root ./demo_project
 | `devagent models` | List available Ollama models |
 | `devagent version` | Show current version |
 
-### ✨ New: Trust & Safety
-
-#### 🛡️ Reliability Hardening (v3.2.1+)
-DevAgent is now built for **Enterprise-grade reliability** in complex projects:
-- **Path Anchoring**: Automatically corrects "root hallucinations." If the agent targets a file in a subdirectory but assumes it's at the root, the system auto-anchors it to the correct project location.
-- **Forensic Test Detection**: Built-in intelligence to "see through" environment noise. It detects successful test runs even if unrelated parts of the repository have collection errors.
-- **Confidence Scoring**: Every fix is graded (0-100%) based on test results, surgical precision, and self-review quality.
+### 🛡️ Reliability & Safety (v3.2.1+)
+DevAgent is built for **Enterprise-grade safety**:
+- **Dry Run Mode**: Use `--dry-run` to see what the agent *would* do without touching your files.
+- **Auto-Snapshot**: Creates a safety restore point before every run.
+- **Rollback**: Revert the last agent changes instantly with `devagent rollback`.
+- **Forensic Test Detection**: Detects successful test runs even in noisy environments.
+- **Path Anchoring**: Automatically corrects "root hallucinations" for subdirectories.
 
 #### 🕹️ Interactive Mode
-Run with `--interactive` (or `-i`) to review diffs before they are applied to your project.
+Run with `--interactive` (or `-i`) to review colorized diffs before they are applied to your project.
 ```bash
 devagent run --task "Fix bug" --interactive
 ```
@@ -161,6 +162,7 @@ devagent run --task "Fix bug" --interactive
 ```mermaid
 graph TD
     CLI[DevAgent CLI] --> Orchestrator[ReAct Orchestrator]
+    Orchestrator --> Safety[Safety Manager: Snapshots]
     Orchestrator --> Memory[Working Memory]
     Orchestrator --> Retrieval[Semantic Retrieval FAISS]
     Orchestrator --> Tools[Tool Suite: pytest, ripgrep, git]

{devagent_cli-3.2.1 → devagent_cli-3.2.3}/README.md

@@ -5,6 +5,7 @@
 ### A Lightweight Local Open-Source Miniature of Claude Code CLI
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI version](https://badge.fury.io/py/devagent-cli.svg)](https://badge.fury.io/py/devagent-cli)
 [![Python 3.11+](https://img.shields.io/badge/Python-3.11+-3776AB.svg?logo=python&logoColor=white)](https://www.python.org/)
 [![Ollama](https://img.shields.io/badge/Ollama-Local%20LLM-black.svg?logo=ollama)](https://ollama.ai)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
@@ -114,16 +115,16 @@ devagent run --task "Fix the divide-by-zero bug" --root ./demo_project
 | `devagent models` | List available Ollama models |
 | `devagent version` | Show current version |
 
-### ✨ New: Trust & Safety
-
-#### 🛡️ Reliability Hardening (v3.2.1+)
-DevAgent is now built for **Enterprise-grade reliability** in complex projects:
-- **Path Anchoring**: Automatically corrects "root hallucinations." If the agent targets a file in a subdirectory but assumes it's at the root, the system auto-anchors it to the correct project location.
-- **Forensic Test Detection**: Built-in intelligence to "see through" environment noise. It detects successful test runs even if unrelated parts of the repository have collection errors.
-- **Confidence Scoring**: Every fix is graded (0-100%) based on test results, surgical precision, and self-review quality.
+### 🛡️ Reliability & Safety (v3.2.1+)
+DevAgent is built for **Enterprise-grade safety**:
+- **Dry Run Mode**: Use `--dry-run` to see what the agent *would* do without touching your files.
+- **Auto-Snapshot**: Creates a safety restore point before every run.
+- **Rollback**: Revert the last agent changes instantly with `devagent rollback`.
+- **Forensic Test Detection**: Detects successful test runs even in noisy environments.
+- **Path Anchoring**: Automatically corrects "root hallucinations" for subdirectories.
 
 #### 🕹️ Interactive Mode
-Run with `--interactive` (or `-i`) to review diffs before they are applied to your project.
+Run with `--interactive` (or `-i`) to review colorized diffs before they are applied to your project.
 ```bash
 devagent run --task "Fix bug" --interactive
 ```
@@ -135,6 +136,7 @@ devagent run --task "Fix bug" --interactive
 ```mermaid
 graph TD
     CLI[DevAgent CLI] --> Orchestrator[ReAct Orchestrator]
+    Orchestrator --> Safety[Safety Manager: Snapshots]
     Orchestrator --> Memory[Working Memory]
     Orchestrator --> Retrieval[Semantic Retrieval FAISS]
     Orchestrator --> Tools[Tool Suite: pytest, ripgrep, git]

devagent_cli-3.2.3/devagent/__init__.py

@@ -0,0 +1 @@
+__version__ = "3.2.3"

{devagent_cli-3.2.1 → devagent_cli-3.2.3}/devagent/app/agent.py

@@ -114,13 +114,14 @@ EXTRACT_ACTION_PATTERN = re.compile(
 class Agent:
     """ReAct agent with planner, retrieval, self-review, and sandbox support."""
 
-    def __init__(self, task: str, project_root: str = ".", max_steps: int = 5):
+    def __init__(self, task: str, project_root: str = ".", max_steps: int = 5, dry_run: bool = False):
         self.state = AgentState(
             task=task,
             project_root=os.path.abspath(project_root),
             max_steps=max_steps,
             working_root=os.path.abspath(project_root),
         )
+        self.dry_run = dry_run
         self.logger = AgentLogger(log_dir=os.path.join(project_root, "logs"))
         self.metrics = RunMetrics(task=task)
         self.memory = WorkingMemory()
@@ -279,6 +280,12 @@ class Agent:
         observation = self._execute_action(action_name, action_arg)
         self.state.last_observation = observation
         self.state.observations.append(observation[:2000])
+        
+        self.state.explanations.append({
+            "type": "action",
+            "action": f"{action_name}: {action_arg}",
+            "reason": thought
+        })
 
         # STEP 3 — GENERATE FIX (if we have a file in context)
         code_fix = ""
@@ -554,8 +561,21 @@ class Agent:
             print(f"  [REVIEW] #{revision + 1}: {review_text[:100]}")
 
             if approved:
+                self.state.explanations.append({
+                    "type": "review",
+                    "file": self.state.current_file,
+                    "reason": review_text,
+                    "status": "APPROVED"
+                })
                 return code_fix, review_text
 
+            self.metrics.patch_rejections += 1
+            self.state.explanations.append({
+                "type": "review",
+                "file": self.state.current_file,
+                "reason": review_text,
+                "status": "REJECTED"
+            })
             print(f"  [REVISE] Revising code (attempt {revision + 1})...")
             code_fix = revise_code(code_fix, review_text, self.state.task)
             code_fix = self._strip_code_fences(code_fix)

{devagent_cli-3.2.1 → devagent_cli-3.2.3}/devagent/app/state.py

@@ -73,6 +73,7 @@ class AgentState:
     # -- Trust & Confidence --
     confidence_score: float = 0.0
     confidence_reasons: list[str] = field(default_factory=list)
+    explanations: list[dict[str, str]] = field(default_factory=list)
 
     def to_dict(self) -> dict[str, Any]:
         """Return a JSON-serialisable snapshot of the current state."""

{devagent_cli-3.2.1 → devagent_cli-3.2.3}/devagent/cli.py

@@ -92,15 +92,24 @@ def cmd_run(args):
     # Sandbox setup
     sandbox = None
     working_root = root
-    if config.sandbox:
+    if config.sandbox or config.dry_run:
+        if config.dry_run:
+            console.print("[bold yellow][DRY RUN][/bold yellow] Agent will work in an isolated sandbox. No changes will be applied.")
         sandbox = SandboxManager(root)
         working_root = sandbox.create()
 
+    # Safety Snapshot
+    if not config.dry_run:
+        from devagent.utils.safety import SafetyManager
+        safety = SafetyManager(root)
+        safety.create_snapshot(task_id=config.task[:10].replace(" ", "_"))
+
     # Run agent
     agent = Agent(
         task=config.task,
         project_root=working_root,
         max_steps=config.max_steps,
+        dry_run=config.dry_run
     )
 
     start_time = time.time()
@@ -133,12 +142,35 @@ def cmd_run(args):
     if final_state.confidence_reasons:
         console.print("\n[bold]Confidence Breakdown:[/bold]")
         for reason in final_state.confidence_reasons:
-            console.print(f"  [dim]• {reason}[/dim]")
-
-    # Sandbox apply
+            console.print(f"  [green]✓[/green] {reason}")
+
+    # Explain Mode
+    if config.explain and final_state.explanations:
+        console.print("\n" + "=" * 60)
+        console.print("  [bold cyan]TRACEABILITY REPORT (EXPLAIN MODE)[/bold cyan]")
+        console.print("=" * 60)
+        for exp in final_state.explanations:
+            if exp["type"] == "action":
+                console.print(f"\n[bold yellow]Selection:[/bold yellow] {exp['action']}")
+                console.print(f"  [dim]Why:[/dim] {exp['reason']}")
+            elif exp["type"] == "review":
+                status_color = "green" if exp["status"] == "APPROVED" else "red"
+                console.print(f"\n[bold {status_color}]Review:[/bold {status_color}] {exp['file']} ({exp['status']})")
+                console.print(f"  [dim]Logic:[/dim] {exp['reason']}")
+
+    # Sandbox apply / Dry Run
     if sandbox and sandbox.is_active:
+        if config.dry_run:
+            console.print("\n[bold yellow][DRY RUN][/bold yellow] Completed. No changes applied.")
+            # Show diffs anyway to show what would have happened
+            for i, patch in enumerate(final_state.patches_applied):
+                console.print(f"\n[bold]Proposed Patch #{i+1}[/bold] for [cyan]{patch.get('file', 'unknown')}[/cyan]:")
+                console.print(f"[dim]{patch.get('diff', 'No diff available')}[/dim]")
+            sandbox.destroy()
+            return 0
+
         if final_state.status == "success":
-            if getattr(args, "interactive", False):
+            if config.interactive:
                 console.print("\n[bold yellow][INTERACTIVE][/bold yellow] Reviewing changes...")
                 # Show diff for each applied patch
                 for i, patch in enumerate(final_state.patches_applied):
@@ -159,7 +191,7 @@ def cmd_run(args):
         sandbox.destroy()
 
     # Git operations
-    if final_state.status == "success" and config.auto_commit:
+    if final_state.status == "success" and config.auto_commit and not config.dry_run:
         _handle_git(root, config)
 
     return 0 if final_state.status == "success" else 1
@@ -231,6 +263,13 @@ def cmd_models(args):
         console.print("[red][ERROR][/red] Could not list Ollama models.")
     return 0
 
+def cmd_rollback(args):
+    """Implementation of 'devagent rollback' command."""
+    from devagent.utils.safety import SafetyManager
+    root = os.path.abspath(getattr(args, "root", "."))
+    safety = SafetyManager(root)
+    return 0 if safety.rollback() else 1
+
 def main():
     parser = argparse.ArgumentParser(description="DevAgent CLI — Professional local coding agent.")
     parser.add_argument("--version", action="version", version=f"DevAgent v{__version__}")
@@ -247,6 +286,8 @@ def main():
     run_parser.add_argument("--auto-commit", action="store_true", help="Auto-commit on success")
     run_parser.add_argument("--auto-push", action="store_true", help="Auto-push after commit")
     run_parser.add_argument("--interactive", "-i", action="store_true", help="Review changes before applying")
+    run_parser.add_argument("--dry-run", action="store_true", help="Run without applying any changes")
+    run_parser.add_argument("--explain", action="store_true", help="Explain why files were chosen and patches applied")
     run_parser.add_argument("--verbose", action="store_true", help="Verbose output")
 
     # Command: benchmark
@@ -260,6 +301,10 @@ def main():
     # Command: models
     subparsers.add_parser("models", help="List installed Ollama models")
 
+    # Command: rollback
+    roll_parser = subparsers.add_parser("rollback", help="Revert the last agent changes")
+    roll_parser.add_argument("--root", "-r", default=".", help="Project root")
+
     # Command: version
     subparsers.add_parser("version", help="Show version")
 
@@ -273,6 +318,8 @@ def main():
         sys.exit(cmd_doctor(args))
     elif args.command == "models":
         sys.exit(cmd_models(args))
+    elif args.command == "rollback":
+        sys.exit(cmd_rollback(args))
     elif args.command == "version":
         console.print(f"DevAgent CLI v{__version__}")
     else:

{devagent_cli-3.2.1 → devagent_cli-3.2.3}/devagent/utils/config.py

@@ -53,6 +53,8 @@ class AgentConfig:
 
     # ── Feature flags ──
     sandbox: bool = True
+    dry_run: bool = False
+    explain: bool = False
     auto_commit: bool = False
     auto_push: bool = False       # DISABLED by default — safety first
     benchmark: bool = False
@@ -98,6 +100,8 @@ class AgentConfig:
             max_steps=getattr(args, "max_steps", 5),
             verbose=getattr(args, "verbose", False),
             sandbox=getattr(args, "sandbox", True),
+            dry_run=getattr(args, "dry_run", False),
+            explain=getattr(args, "explain", False),
             auto_commit=getattr(args, "auto_commit", False),
             auto_push=getattr(args, "auto_push", False),
             benchmark=getattr(args, "benchmark", False),

{devagent_cli-3.2.1 → devagent_cli-3.2.3}/devagent/utils/metrics.py

@@ -36,6 +36,7 @@ class RunMetrics:
     end_time: float = 0.0
     total_steps: int = 0
     retries: int = 0
+    patch_rejections: int = 0
     successes: int = 0
     failures: int = 0
     total_latency_s: float = 0.0
@@ -88,6 +89,7 @@ class RunMetrics:
             "task": self.task[:100],
             "total_steps": self.total_steps,
             "retries": self.retries,
+            "patch_rejections": self.patch_rejections,
             "successes": self.successes,
             "failures": self.failures,
             "total_latency_s": round(self.total_latency_s, 2),

devagent_cli-3.2.3/devagent/utils/safety.py

@@ -0,0 +1,90 @@
+"""
+Safety Manager — handles snapshots and rollbacks.
+"""
+
+import os
+import shutil
+import time
+import subprocess
+from rich.console import Console
+from devagent.tools.git_tools import is_git_repo
+
+console = Console()
+
+class SafetyManager:
+    def __init__(self, project_root: str):
+        self.root = os.path.abspath(project_root)
+        self.snapshot_dir = os.path.join(self.root, ".devagent_backups")
+        
+    def create_snapshot(self, task_id: str = "latest") -> str:
+        """Create a safety snapshot of the current project state."""
+        if is_git_repo(self.root):
+            # For git repos, we rely on the user's ability to git checkout
+            # but we could also do a 'git stash' here for safety.
+            return "git"
+
+        # For non-git repos, we do a physical backup of .py files
+        os.makedirs(self.snapshot_dir, exist_ok=True)
+        timestamp = int(time.time())
+        dest = os.path.join(self.snapshot_dir, f"{task_id}_{timestamp}")
+        
+        # Simple copy of python files
+        os.makedirs(dest, exist_ok=True)
+        for root, _, files in os.walk(self.root):
+            if ".devagent" in root or "venv" in root:
+                continue
+            for f in files:
+                if f.endswith(".py"):
+                    src_file = os.path.join(root, f)
+                    rel_path = os.path.relpath(src_file, self.root)
+                    target_file = os.path.join(dest, rel_path)
+                    os.makedirs(os.path.dirname(target_file), exist_ok=True)
+                    shutil.copy2(src_file, target_file)
+        
+        # Save metadata
+        metadata = {
+            "task_id": task_id,
+            "timestamp": timestamp,
+            "root": self.root
+        }
+        with open(os.path.join(dest, "metadata.json"), "w") as f:
+            import json
+            json.dump(metadata, f, indent=2)
+
+        return dest
+
+    def rollback(self, snapshot_id: str = "latest") -> bool:
+        """Rollback the project to a previous snapshot."""
+        if is_git_repo(self.root):
+            console.print("[bold yellow][SAFETY][/bold yellow] This is a Git repository. Reverting all local changes...")
+            try:
+                subprocess.run(["git", "checkout", "."], cwd=self.root, check=True, capture_output=True)
+                console.print("[bold green]Git rollback complete.[/bold green]")
+                return True
+            except Exception as e:
+                console.print(f"[bold red][ERROR][/bold red] Git rollback failed: {e}")
+                return False
+
+        # Find latest snapshot if not specified
+        if not os.path.exists(self.snapshot_dir):
+            console.print("[bold red][ERROR][/bold red] No snapshots found.")
+            return False
+            
+        snapshots = sorted(os.listdir(self.snapshot_dir))
+        if not snapshots:
+            console.print("[bold red][ERROR][/bold red] No snapshots found.")
+            return False
+            
+        target = os.path.join(self.snapshot_dir, snapshots[-1])
+        console.print(f"[bold yellow][SAFETY][/bold yellow] Rolling back from {target}...")
+        
+        # Restore files
+        for root, _, files in os.walk(target):
+            for f in files:
+                src_file = os.path.join(root, f)
+                rel_path = os.path.relpath(src_file, target)
+                dest_file = os.path.join(self.root, rel_path)
+                shutil.copy2(src_file, dest_file)
+        
+        console.print("[bold green]Rollback complete.[/bold green]")
+        return True

{devagent_cli-3.2.1 → devagent_cli-3.2.3/devagent_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devagent-cli
-Version: 3.2.1
+Version: 3.2.3
 Summary: Professional Local autonomous coding agent powered by Ollama
 Author: Vedant Jadhav
 License: MIT
@@ -31,6 +31,7 @@ Dynamic: license-file
 ### A Lightweight Local Open-Source Miniature of Claude Code CLI
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI version](https://badge.fury.io/py/devagent-cli.svg)](https://badge.fury.io/py/devagent-cli)
 [![Python 3.11+](https://img.shields.io/badge/Python-3.11+-3776AB.svg?logo=python&logoColor=white)](https://www.python.org/)
 [![Ollama](https://img.shields.io/badge/Ollama-Local%20LLM-black.svg?logo=ollama)](https://ollama.ai)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
@@ -140,16 +141,16 @@ devagent run --task "Fix the divide-by-zero bug" --root ./demo_project
 | `devagent models` | List available Ollama models |
 | `devagent version` | Show current version |
 
-### ✨ New: Trust & Safety
-
-#### 🛡️ Reliability Hardening (v3.2.1+)
-DevAgent is now built for **Enterprise-grade reliability** in complex projects:
-- **Path Anchoring**: Automatically corrects "root hallucinations." If the agent targets a file in a subdirectory but assumes it's at the root, the system auto-anchors it to the correct project location.
-- **Forensic Test Detection**: Built-in intelligence to "see through" environment noise. It detects successful test runs even if unrelated parts of the repository have collection errors.
-- **Confidence Scoring**: Every fix is graded (0-100%) based on test results, surgical precision, and self-review quality.
+### 🛡️ Reliability & Safety (v3.2.1+)
+DevAgent is built for **Enterprise-grade safety**:
+- **Dry Run Mode**: Use `--dry-run` to see what the agent *would* do without touching your files.
+- **Auto-Snapshot**: Creates a safety restore point before every run.
+- **Rollback**: Revert the last agent changes instantly with `devagent rollback`.
+- **Forensic Test Detection**: Detects successful test runs even in noisy environments.
+- **Path Anchoring**: Automatically corrects "root hallucinations" for subdirectories.
 
 #### 🕹️ Interactive Mode
-Run with `--interactive` (or `-i`) to review diffs before they are applied to your project.
+Run with `--interactive` (or `-i`) to review colorized diffs before they are applied to your project.
 ```bash
 devagent run --task "Fix bug" --interactive
 ```
@@ -161,6 +162,7 @@ devagent run --task "Fix bug" --interactive
 ```mermaid
 graph TD
     CLI[DevAgent CLI] --> Orchestrator[ReAct Orchestrator]
+    Orchestrator --> Safety[Safety Manager: Snapshots]
     Orchestrator --> Memory[Working Memory]
     Orchestrator --> Retrieval[Semantic Retrieval FAISS]
     Orchestrator --> Tools[Tool Suite: pytest, ripgrep, git]

{devagent_cli-3.2.1 → devagent_cli-3.2.3}/devagent_cli.egg-info/SOURCES.txt

@@ -25,6 +25,7 @@ devagent/utils/__init__.py
 devagent/utils/config.py
 devagent/utils/logger.py
 devagent/utils/metrics.py
+devagent/utils/safety.py
 devagent_cli.egg-info/PKG-INFO
 devagent_cli.egg-info/SOURCES.txt
 devagent_cli.egg-info/dependency_links.txt

{devagent_cli-3.2.1 → devagent_cli-3.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devagent-cli"
-version = "3.2.1"
+version = "3.2.3"
 description = "Professional Local autonomous coding agent powered by Ollama"
 readme = "README.md"
 requires-python = ">=3.11"

devagent_cli-3.2.1/devagent/__init__.py

@@ -1 +0,0 @@
-__version__ = "3.2.1"