devagent-cli 3.2.2__tar.gz → 3.3.0__tar.gz

{devagent_cli-3.2.2/devagent_cli.egg-info → devagent_cli-3.3.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: devagent-cli
-Version: 3.2.2
-Summary: Professional Local autonomous coding agent powered by Ollama
+Version: 3.3.0
+Summary: A local autonomous coding agent CLI powered by Ollama.
 Author: Vedant Jadhav
 License: MIT
 Keywords: ai,agent,coding,ollama,local,devagent,devagent-cli
@@ -49,26 +49,23 @@ Dynamic: license-file
 
 </div>
 
-## 🤔 Why DevAgent?
+## 🛡️ Why DevAgent?
 
-Most AI coding tools are **chatbots** — they suggest code, you copy-paste, you pray.
+DevAgent is built on a "Safety-First" architecture for **high-integrity developer infrastructure**. Unlike chatbots that guess code, DevAgent is a local autonomous agent that operates within a strictly observed environment.
 
-DevAgent is a **real agent** with a retrieval-first, tool-grounded architecture:
+### 📊 Empirical Validation
+We don't hide our limitations. DevAgent v3.2.3 has been stress-tested against real-world, "messy" repositories, providing a transparent **[Benchmark Report](docs/benchmarks.md)**. 
 
-| | Chatbot | DevAgent |
+| | Other Agents | DevAgent |
 |---|---|---|
-| Searches your codebase | ❌ | ✅ ripgrep + semantic search |
-| Retrieves relevant code | ❌ | ✅ FAISS embeddings |
-| Plans before coding | ❌ | ✅ Planner layer |
-| Generates patches | ❌ | ✅ Unified diffs |
-| Reviews its own output | ❌ | ✅ Self-critique loop |
-| Runs your tests | ❌ | ✅ pytest integration |
-| Retries on failure | ❌ | ✅ Up to N iterations |
-| Works in sandbox | ❌ | ✅ Isolated workspace |
-| Works offline | ❌ | ✅ 100% local via Ollama |
-| Costs money | 💸 | ✅ Free forever |
-
-> **Philosophy:** Execution > Reasoning. Tools > Hallucination. Retrieval > Huge Context. Reliability > Intelligence.
+| **Safety Isolation** | ❌ | ✅ Strict Sandbox Mode |
+| **Recovery** | ❌ | ✅ Git-native + Snapshot Rollback |
+| **Validation** | ❌ | ✅ Empirical Stress Tests |
+| **Transparency** | ❌ | ✅ Visible Failure Taxonomy |
+| **Privacy** | ❌ | ✅ 100% Local (Ollama) |
+| **Costs** | 💸 | ✅ Zero API Costs |
+
+> **Philosophy:** Safety > Intelligence. Observability > Reasoning. Retrieval > Huge Context. Reliability > Hype.
 
 ---
 
@@ -141,13 +138,13 @@ devagent run --task "Fix the divide-by-zero bug" --root ./demo_project
 | `devagent models` | List available Ollama models |
 | `devagent version` | Show current version |
 
-### 🛡️ 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.
+#### 🛡️ Reliability & Safety
+DevAgent is built for **production-grade reliability**:
+- **Isolated Sandbox**: Agent works in `sandbox_workspace/`, keeping your source clean until success.
+- **Auto-Snapshot**: Creates a safety restore point before every execution.
+- **Instant Rollback**: Revert agent changes with `devagent rollback`.
+- **Traceability**: Every thought and tool call is logged to `logs/run.json`.
+- **Environment Awareness**: Detects and uses your project's Python environment automatically.
 
 #### 🕹️ Interactive Mode
 Run with `--interactive` (or `-i`) to review colorized diffs before they are applied to your project.

{devagent_cli-3.2.2 → devagent_cli-3.3.0}/README.md

@@ -23,26 +23,23 @@
 
 </div>
 
-## 🤔 Why DevAgent?
+## 🛡️ Why DevAgent?
 
-Most AI coding tools are **chatbots** — they suggest code, you copy-paste, you pray.
+DevAgent is built on a "Safety-First" architecture for **high-integrity developer infrastructure**. Unlike chatbots that guess code, DevAgent is a local autonomous agent that operates within a strictly observed environment.
 
-DevAgent is a **real agent** with a retrieval-first, tool-grounded architecture:
+### 📊 Empirical Validation
+We don't hide our limitations. DevAgent v3.2.3 has been stress-tested against real-world, "messy" repositories, providing a transparent **[Benchmark Report](docs/benchmarks.md)**. 
 
-| | Chatbot | DevAgent |
+| | Other Agents | DevAgent |
 |---|---|---|
-| Searches your codebase | ❌ | ✅ ripgrep + semantic search |
-| Retrieves relevant code | ❌ | ✅ FAISS embeddings |
-| Plans before coding | ❌ | ✅ Planner layer |
-| Generates patches | ❌ | ✅ Unified diffs |
-| Reviews its own output | ❌ | ✅ Self-critique loop |
-| Runs your tests | ❌ | ✅ pytest integration |
-| Retries on failure | ❌ | ✅ Up to N iterations |
-| Works in sandbox | ❌ | ✅ Isolated workspace |
-| Works offline | ❌ | ✅ 100% local via Ollama |
-| Costs money | 💸 | ✅ Free forever |
-
-> **Philosophy:** Execution > Reasoning. Tools > Hallucination. Retrieval > Huge Context. Reliability > Intelligence.
+| **Safety Isolation** | ❌ | ✅ Strict Sandbox Mode |
+| **Recovery** | ❌ | ✅ Git-native + Snapshot Rollback |
+| **Validation** | ❌ | ✅ Empirical Stress Tests |
+| **Transparency** | ❌ | ✅ Visible Failure Taxonomy |
+| **Privacy** | ❌ | ✅ 100% Local (Ollama) |
+| **Costs** | 💸 | ✅ Zero API Costs |
+
+> **Philosophy:** Safety > Intelligence. Observability > Reasoning. Retrieval > Huge Context. Reliability > Hype.
 
 ---
 
@@ -115,13 +112,13 @@ devagent run --task "Fix the divide-by-zero bug" --root ./demo_project
 | `devagent models` | List available Ollama models |
 | `devagent version` | Show current version |
 
-### 🛡️ 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.
+#### 🛡️ Reliability & Safety
+DevAgent is built for **production-grade reliability**:
+- **Isolated Sandbox**: Agent works in `sandbox_workspace/`, keeping your source clean until success.
+- **Auto-Snapshot**: Creates a safety restore point before every execution.
+- **Instant Rollback**: Revert agent changes with `devagent rollback`.
+- **Traceability**: Every thought and tool call is logged to `logs/run.json`.
+- **Environment Awareness**: Detects and uses your project's Python environment automatically.
 
 #### 🕹️ Interactive Mode
 Run with `--interactive` (or `-i`) to review colorized diffs before they are applied to your project.

devagent_cli-3.3.0/devagent/__init__.py

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

{devagent_cli-3.2.2 → devagent_cli-3.3.0}/devagent/app/agent.py

@@ -30,6 +30,7 @@ from devagent.app.patcher import generate_diff, apply_patch, format_diff_summary
 from devagent.app.memory import WorkingMemory, chunk_project, SemanticIndex
 from devagent.tools.search import search_code
 from devagent.tools.file_ops import read_file, write_file, list_files
+from devagent.tools.file_map import get_file_map
 from devagent.tools.test_runner import run_tests
 from devagent.tools.linter import lint_code
 from devagent.tools.git_tools import git_diff, git_status
@@ -47,7 +48,6 @@ You are a coding agent. Your task:
 
 Project root: {project_root}
 Current step: {step}/{max_steps}
-Previous attempts: {attempts}
 
 {plan_context}
 
@@ -59,9 +59,10 @@ Previous attempts: {attempts}
 
 Decide the SINGLE next action. Choose ONE:
 - list_files: <relative_path>
+- get_file_map: <relative_path>
 - search_code: <keyword>
 - semantic_search: <query>
-- read_file: <relative_path>
+- read_file: <relative_path>[:L<start>-<end>]
 - write_file: <relative_path>
 - surgical_patch: <file> | <SEARCH> | <REPLACE>
 - run_tests: <optional_path>
@@ -69,12 +70,11 @@ Decide the SINGLE next action. Choose ONE:
 - git_diff
 
 STRATEGY:
-1. START by using 'run_tests' to identify the exact failure location.
-2. USE 'read_file' on the failing file before attempting a fix.
-3. PREFER 'surgical_patch' for logic fixes. Format: file.py | <SEARCH> | <REPLACE>
-4. USE 'write_file' ONLY for creating brand new files.
-5. ALWAYS use full relative paths (e.g. benchmarks/math/calc.py).
-6. If tests pass but system errors remain, verify the file path is correct.
+1. START by using 'run_tests' to identify the failure.
+2. For large files (>50 lines), use 'get_file_map' FIRST to see the structure.
+3. USE 'read_file' with line ranges (e.g. file.py:L10-L50) for targeted reading.
+4. USE 'surgical_patch' for logic fixes. Format: file.py | <SEARCH> | <REPLACE>
+5. ALWAYS use full relative paths.
 
 Reply in this EXACT format (two lines only):
 THOUGHT: <your reasoning>
@@ -92,21 +92,11 @@ CURRENT CODE:
 
 {retrieval_context}
 
-TASK: {task}
-FILE: {file_path}
-
-{error_context}
-
-{retrieval_context}
-
-CURRENT CODE:
-{file_content}
-
 Fix the bug. Output ONLY the COMPLETE Python code.
 """
 
 EXTRACT_ACTION_PATTERN = re.compile(
-    r"ACTION:\s*(search_code|semantic_search|read_file|write_file|surgical_patch|run_tests|lint_code|list_files|git_diff)\s*:?\s*(.*)",
+    r"ACTION:\s*(get_file_map|search_code|semantic_search|read_file|write_file|surgical_patch|run_tests|lint_code|list_files|git_diff)\s*:?\s*(.*)",
     re.IGNORECASE,
 )
 
@@ -280,6 +270,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 = ""
@@ -290,8 +286,12 @@ class Agent:
             code_fix = self._generate_fix()
             self.state.last_code_fix = code_fix
 
-            # STEP 4 — SELF-REVIEW
+            # STEP 4 — SELF-REVIEW (with Synthetic Grounding)
             if code_fix:
+                # Add a "Dry Run" lint check to the review context
+                _, lint_output = lint_code(self.state.current_file)
+                self.state.last_observation += f"\n[LINT] {lint_output}"
+
                 code_fix, review_text = self._self_review(code_fix)
                 self.state.last_review = review_text
 
@@ -460,6 +460,9 @@ class Agent:
             self._extract_file_from_search(result)
             return result
 
+        elif action_name == "get_file_map":
+            return get_file_map(action_arg, root)
+
         elif action_name == "semantic_search":
             result = semantic_search(action_arg, root)
             # Try to extract file from results
@@ -555,9 +558,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.2 → devagent_cli-3.3.0}/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.2 → devagent_cli-3.3.0}/devagent/cli.py

@@ -142,7 +142,21 @@ 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]")
+            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:
@@ -273,6 +287,7 @@ def main():
     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

devagent_cli-3.3.0/devagent/tools/file_map.py

@@ -0,0 +1,21 @@
+"""
+File Map Tool — Provides a structural overview of a file using AST.
+"""
+
+from __future__ import annotations
+import os
+from devagent.utils.ast_utils import get_file_structure, format_structure_summary
+
+def get_file_map(file_path: str, root_dir: str = ".") -> str:
+    """Return a hierarchical map of functions and classes in the file."""
+    full_path = os.path.join(root_dir, file_path)
+    if not os.path.exists(full_path):
+        return f"Error: File {file_path} not found."
+    
+    symbols = get_file_structure(full_path)
+    if not symbols:
+        return f"Could not parse structure for {file_path} (possibly empty or non-python)."
+    
+    summary = format_structure_summary(symbols)
+    header = f"### Structure of {file_path} ###\n"
+    return header + summary + "\n\nUse read_file with specific line ranges to see the implementation."

{devagent_cli-3.2.2 → devagent_cli-3.3.0}/devagent/tools/file_ops.py

@@ -10,16 +10,36 @@ from pathlib import Path
 
 def read_file(path: str) -> str:
     """Read a file and return its contents.
-
+    
+    Supports range: path/to/file.py:L10-L50
     Returns an error string on failure (never raises).
     """
     try:
+        # Check for line range
+        line_range = None
+        if ":L" in path:
+            parts = path.split(":L")
+            path = parts[0]
+            line_range = parts[1]
+
         p = Path(path)
         if not p.exists():
             return f"[ERROR] File not found: {path}"
         if not p.is_file():
             return f"[ERROR] Not a file: {path}"
-        content = p.read_text(encoding="utf-8", errors="replace")
+        
+        lines = p.read_text(encoding="utf-8", errors="replace").splitlines()
+        
+        if line_range:
+            try:
+                start, end = map(int, line_range.split("-"))
+                lines = lines[start-1:end]
+                header = f"### {path} (Lines {start}-{end}) ###\n"
+                return header + "\n".join(lines)
+            except ValueError:
+                return f"[ERROR] Invalid line range: {line_range}"
+
+        content = "\n".join(lines)
         return content[:10000]  # cap to protect LLM context
     except Exception as exc:  # noqa: BLE001
         return f"[ERROR] Could not read {path}: {exc}"

devagent_cli-3.3.0/devagent/utils/ast_utils.py

@@ -0,0 +1,83 @@
+"""
+AST Utilities for DevAgent — Hierarchical mapping and structural analysis.
+
+Helps the agent understand file structure without reading the whole file.
+"""
+
+import ast
+from dataclasses import dataclass
+from typing import List, Optional
+
+@dataclass
+class CodeSymbol:
+    name: str
+    type: str  # 'function', 'class', 'method'
+    start_line: int
+    end_line: int
+    docstring: Optional[str] = None
+    children: List['CodeSymbol'] = None
+
+    def __post_init__(self):
+        if self.children is None:
+            self.children = []
+
+def get_file_structure(file_path: str) -> List[CodeSymbol]:
+    """Parse a Python file and return a hierarchical list of symbols."""
+    try:
+        with open(file_path, "r", encoding="utf-8", errors="replace") as f:
+            content = f.read()
+        
+        tree = ast.parse(content)
+        symbols = []
+
+        for node in ast.iter_child_nodes(tree):
+            if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef, ast.ClassDef)):
+                symbol = _parse_node(node)
+                if symbol:
+                    symbols.append(symbol)
+        
+        return symbols
+    except Exception:
+        return []
+
+def _parse_node(node: ast.AST) -> Optional[CodeSymbol]:
+    """Recursively parse an AST node into a CodeSymbol."""
+    if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
+        symbol = CodeSymbol(
+            name=node.name,
+            type="function",
+            start_line=node.lineno,
+            end_line=getattr(node, "end_lineno", node.lineno),
+            docstring=ast.get_docstring(node)
+        )
+        return symbol
+    
+    elif isinstance(node, ast.ClassDef):
+        symbol = CodeSymbol(
+            name=node.name,
+            type="class",
+            start_line=node.lineno,
+            end_line=getattr(node, "end_lineno", node.lineno),
+            docstring=ast.get_docstring(node)
+        )
+        # Parse methods
+        for child in node.body:
+            if isinstance(child, (ast.FunctionDef, ast.AsyncFunctionDef)):
+                method = _parse_node(child)
+                if method:
+                    method.type = "method"
+                    symbol.children.append(method)
+        return symbol
+    
+    return None
+
+def format_structure_summary(symbols: List[CodeSymbol], indent: int = 0) -> str:
+    """Format symbols into a readable tree summary."""
+    lines = []
+    for s in symbols:
+        prefix = "  " * indent
+        line = f"{prefix}- {s.type.capitalize()}: {s.name} (L{s.start_line}-{s.end_line})"
+        lines.append(line)
+        if s.children:
+            lines.append(format_structure_summary(s.children, indent + 1))
+    return "\n".join(lines)

{devagent_cli-3.2.2 → devagent_cli-3.3.0}/devagent/utils/config.py

@@ -54,6 +54,7 @@ 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
@@ -100,6 +101,7 @@ class AgentConfig:
             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.2 → devagent_cli-3.3.0}/devagent/utils/safety.py

@@ -5,6 +5,7 @@ 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
 
@@ -13,7 +14,7 @@ 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", "snapshots")
+        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."""
@@ -40,13 +41,29 @@ class SafetyManager:
                     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. Use [bold cyan]git checkout .[/bold cyan] to rollback.")
-            return False
+            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):

{devagent_cli-3.2.2 → devagent_cli-3.3.0/devagent_cli.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: devagent-cli
-Version: 3.2.2
-Summary: Professional Local autonomous coding agent powered by Ollama
+Version: 3.3.0
+Summary: A local autonomous coding agent CLI powered by Ollama.
 Author: Vedant Jadhav
 License: MIT
 Keywords: ai,agent,coding,ollama,local,devagent,devagent-cli
@@ -49,26 +49,23 @@ Dynamic: license-file
 
 </div>
 
-## 🤔 Why DevAgent?
+## 🛡️ Why DevAgent?
 
-Most AI coding tools are **chatbots** — they suggest code, you copy-paste, you pray.
+DevAgent is built on a "Safety-First" architecture for **high-integrity developer infrastructure**. Unlike chatbots that guess code, DevAgent is a local autonomous agent that operates within a strictly observed environment.
 
-DevAgent is a **real agent** with a retrieval-first, tool-grounded architecture:
+### 📊 Empirical Validation
+We don't hide our limitations. DevAgent v3.2.3 has been stress-tested against real-world, "messy" repositories, providing a transparent **[Benchmark Report](docs/benchmarks.md)**. 
 
-| | Chatbot | DevAgent |
+| | Other Agents | DevAgent |
 |---|---|---|
-| Searches your codebase | ❌ | ✅ ripgrep + semantic search |
-| Retrieves relevant code | ❌ | ✅ FAISS embeddings |
-| Plans before coding | ❌ | ✅ Planner layer |
-| Generates patches | ❌ | ✅ Unified diffs |
-| Reviews its own output | ❌ | ✅ Self-critique loop |
-| Runs your tests | ❌ | ✅ pytest integration |
-| Retries on failure | ❌ | ✅ Up to N iterations |
-| Works in sandbox | ❌ | ✅ Isolated workspace |
-| Works offline | ❌ | ✅ 100% local via Ollama |
-| Costs money | 💸 | ✅ Free forever |
-
-> **Philosophy:** Execution > Reasoning. Tools > Hallucination. Retrieval > Huge Context. Reliability > Intelligence.
+| **Safety Isolation** | ❌ | ✅ Strict Sandbox Mode |
+| **Recovery** | ❌ | ✅ Git-native + Snapshot Rollback |
+| **Validation** | ❌ | ✅ Empirical Stress Tests |
+| **Transparency** | ❌ | ✅ Visible Failure Taxonomy |
+| **Privacy** | ❌ | ✅ 100% Local (Ollama) |
+| **Costs** | 💸 | ✅ Zero API Costs |
+
+> **Philosophy:** Safety > Intelligence. Observability > Reasoning. Retrieval > Huge Context. Reliability > Hype.
 
 ---
 
@@ -141,13 +138,13 @@ devagent run --task "Fix the divide-by-zero bug" --root ./demo_project
 | `devagent models` | List available Ollama models |
 | `devagent version` | Show current version |
 
-### 🛡️ 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.
+#### 🛡️ Reliability & Safety
+DevAgent is built for **production-grade reliability**:
+- **Isolated Sandbox**: Agent works in `sandbox_workspace/`, keeping your source clean until success.
+- **Auto-Snapshot**: Creates a safety restore point before every execution.
+- **Instant Rollback**: Revert agent changes with `devagent rollback`.
+- **Traceability**: Every thought and tool call is logged to `logs/run.json`.
+- **Environment Awareness**: Detects and uses your project's Python environment automatically.
 
 #### 🕹️ Interactive Mode
 Run with `--interactive` (or `-i`) to review colorized diffs before they are applied to your project.

{devagent_cli-3.2.2 → devagent_cli-3.3.0}/devagent_cli.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ devagent/app/sandbox.py
 devagent/app/state.py
 devagent/tools/__init__.py
 devagent/tools/benchmark_runner.py
+devagent/tools/file_map.py
 devagent/tools/file_ops.py
 devagent/tools/git_tools.py
 devagent/tools/linter.py
@@ -22,6 +23,7 @@ devagent/tools/semantic_search.py
 devagent/tools/surgical_patcher.py
 devagent/tools/test_runner.py
 devagent/utils/__init__.py
+devagent/utils/ast_utils.py
 devagent/utils/config.py
 devagent/utils/logger.py
 devagent/utils/metrics.py

{devagent_cli-3.2.2 → devagent_cli-3.3.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devagent-cli"
-version = "3.2.2"
-description = "Professional Local autonomous coding agent powered by Ollama"
+version = "3.3.0"
+description = "A local autonomous coding agent CLI powered by Ollama."
 readme = "README.md"
 requires-python = ">=3.11"
 license = {text = "MIT"}

devagent_cli-3.2.2/devagent/__init__.py

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