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

{devagent_cli-3.2.3/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.3
-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.3 → 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.2.3 → 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,
 )
 
@@ -296,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
 
@@ -466,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

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.3 → 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.3 → 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.3
-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.3 → 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.3 → devagent_cli-3.3.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devagent-cli"
-version = "3.2.3"
-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"}