devloop 0.4.1__tar.gz → 0.5.0__tar.gz

{devloop-0.4.1 → devloop-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devloop
-Version: 0.4.1
+Version: 0.5.0
 Summary: Intelligent background agents for development workflow automation
 License: MIT
 License-File: LICENSE
@@ -26,8 +26,10 @@ Provides-Extra: ci-monitor
 Provides-Extra: code-rabbit
 Provides-Extra: snyk
 Requires-Dist: aiofiles (>=23.2,<24.0)
+Requires-Dist: lsprotocol (>=2023.0.0,<2024.0.0)
 Requires-Dist: psutil (>=5.9,<6.0)
 Requires-Dist: pydantic (>=2.5,<3.0)
+Requires-Dist: pygls (>=1.3.0,<2.0.0)
 Requires-Dist: rich (>=13.7,<14.0)
 Requires-Dist: typer (>=0.15,<1.0)
 Requires-Dist: watchdog (>=3.0,<4.0)
@@ -214,7 +216,9 @@ All agents run **non-intrusively in the background**, respecting your workflow.
 
 ### Installation
 
-**Prerequisites:** Python 3.11+
+**Prerequisites:**
+- Python 3.11 or later
+- For release workflow: Poetry 1.7+ and GitHub CLI 2.78+
 
 #### Option 1: From PyPI (Recommended)
 
@@ -250,13 +254,27 @@ DevLoop automatically detects and uses several system tools. Install them for fu
 
 **For Pre-Push CI Verification (Optional but Recommended):**
 ```bash
-# GitHub CLI (for checking CI status before push)
+# GitHub CLI 2.78+ (for checking CI status before push)
 # Ubuntu/Debian:
 sudo apt-get install -y gh
 
 # macOS:
 brew install gh
 
+# Verify installation
+gh --version
+```
+
+**For Release Management (Optional but Recommended for Publishing):**
+```bash
+# Poetry 1.7+ (for package management and publishing)
+curl -sSL https://install.python-poetry.org | python3 -
+
+# Verify installation
+poetry --version
+
+# Configure PyPI credentials (get token from https://pypi.org/account/)
+poetry config pypi-token.pypi "pypi-AgEIcHlwaS5vcmc..."
 ```
 
 **For Task Management Integration (Optional):**
@@ -266,8 +284,9 @@ pip install beads-mcp
 ```
 
 **What happens if missing:**
-- `gh`: Pre-push CI verification is skipped (but DevLoop still works)
-- `bd`: Pre-push hook won't create task queue issues (but DevLoop still works)
+- `gh` (2.78+): Pre-push CI verification is skipped (but DevLoop still works)
+- `poetry` (1.7+): Release workflow unavailable (but development still works)
+- `bd`: Task creation on push won't work (but DevLoop still works)
 
 DevLoop will warn you during `devloop init` if any tools are missing and provide installation instructions. You can install them later and they'll be detected automatically.
 
@@ -343,6 +362,43 @@ devloop custom-create my_agent pattern_matcher
 
 [View all CLI commands →](./docs/cli-commands.md)
 
+### Verify Installation & Version Compatibility
+
+After installation, verify everything is working:
+
+```bash
+# Check DevLoop version
+devloop --version
+
+# Verify system dependencies are detected
+devloop init --check-requirements
+
+# Check daemon status (if running)
+devloop status
+
+# Verify git hooks are installed (in your project)
+cat .git/hooks/pre-commit    # Should exist
+cat .git/hooks/pre-push      # Should exist
+```
+
+**Version compatibility:**
+- DevLoop 0.4.1+ requires Python 3.11+
+- Release workflow requires Poetry 1.7+ and GitHub CLI 2.78+
+- AGENTS.md template was updated in DevLoop 0.4.0+
+
+**If you're upgrading DevLoop:**
+```bash
+# Upgrade to latest
+pip install --upgrade devloop
+
+# Update your project's AGENTS.md (templates may have changed)
+devloop init --merge-templates /path/to/your/project
+
+# Restart the daemon
+devloop stop
+devloop watch .
+```
+
 ---
 
 ## Architecture

{devloop-0.4.1 → devloop-0.5.0}/README.md

@@ -176,7 +176,9 @@ All agents run **non-intrusively in the background**, respecting your workflow.
 
 ### Installation
 
-**Prerequisites:** Python 3.11+
+**Prerequisites:**
+- Python 3.11 or later
+- For release workflow: Poetry 1.7+ and GitHub CLI 2.78+
 
 #### Option 1: From PyPI (Recommended)
 
@@ -212,13 +214,27 @@ DevLoop automatically detects and uses several system tools. Install them for fu
 
 **For Pre-Push CI Verification (Optional but Recommended):**
 ```bash
-# GitHub CLI (for checking CI status before push)
+# GitHub CLI 2.78+ (for checking CI status before push)
 # Ubuntu/Debian:
 sudo apt-get install -y gh
 
 # macOS:
 brew install gh
 
+# Verify installation
+gh --version
+```
+
+**For Release Management (Optional but Recommended for Publishing):**
+```bash
+# Poetry 1.7+ (for package management and publishing)
+curl -sSL https://install.python-poetry.org | python3 -
+
+# Verify installation
+poetry --version
+
+# Configure PyPI credentials (get token from https://pypi.org/account/)
+poetry config pypi-token.pypi "pypi-AgEIcHlwaS5vcmc..."
 ```
 
 **For Task Management Integration (Optional):**
@@ -228,8 +244,9 @@ pip install beads-mcp
 ```
 
 **What happens if missing:**
-- `gh`: Pre-push CI verification is skipped (but DevLoop still works)
-- `bd`: Pre-push hook won't create task queue issues (but DevLoop still works)
+- `gh` (2.78+): Pre-push CI verification is skipped (but DevLoop still works)
+- `poetry` (1.7+): Release workflow unavailable (but development still works)
+- `bd`: Task creation on push won't work (but DevLoop still works)
 
 DevLoop will warn you during `devloop init` if any tools are missing and provide installation instructions. You can install them later and they'll be detected automatically.
 
@@ -305,6 +322,43 @@ devloop custom-create my_agent pattern_matcher
 
 [View all CLI commands →](./docs/cli-commands.md)
 
+### Verify Installation & Version Compatibility
+
+After installation, verify everything is working:
+
+```bash
+# Check DevLoop version
+devloop --version
+
+# Verify system dependencies are detected
+devloop init --check-requirements
+
+# Check daemon status (if running)
+devloop status
+
+# Verify git hooks are installed (in your project)
+cat .git/hooks/pre-commit    # Should exist
+cat .git/hooks/pre-push      # Should exist
+```
+
+**Version compatibility:**
+- DevLoop 0.4.1+ requires Python 3.11+
+- Release workflow requires Poetry 1.7+ and GitHub CLI 2.78+
+- AGENTS.md template was updated in DevLoop 0.4.0+
+
+**If you're upgrading DevLoop:**
+```bash
+# Upgrade to latest
+pip install --upgrade devloop
+
+# Update your project's AGENTS.md (templates may have changed)
+devloop init --merge-templates /path/to/your/project
+
+# Restart the daemon
+devloop stop
+devloop watch .
+```
+
 ---
 
 ## Architecture

{devloop-0.4.1 → devloop-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "devloop"
-version = "0.4.1"
+version = "0.5.0"
 description = "Intelligent background agents for development workflow automation"
 authors = ["DevLoop Contributors <devloop@example.com>"]
 license = "MIT"
@@ -47,6 +47,8 @@ typer = ">=0.15,<1.0"
 rich = "^13.7"
 aiofiles = "^23.2"
 psutil = "^5.9"
+pygls = "^1.3.0"
+lsprotocol = "^2023.0.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^7.4"
@@ -77,12 +79,18 @@ target-version = ['py311']
 
 [tool.ruff]
 line-length = 88
-target-version = "0.4.1"
+target-version = "py311"
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 testpaths = ["tests"]
 pythonpath = ["src"]
+markers = [
+    "integration: marks tests as integration tests",
+    "performance: marks tests as performance benchmarks",
+    "security: marks tests as security tests",
+    "benchmark: marks tests as benchmarks",
+]
 
 [tool.mypy]
 python_version = "0.4.1"

{devloop-0.4.1 → devloop-0.5.0}/src/devloop/agents/ci_monitor.py

@@ -1,6 +1,5 @@
-"""CI Monitor Agent - Monitors GitHub Actions CI status."""
+"""CI Monitor Agent - Monitors CI system status (platform-agnostic)."""
 
-import json
 import subprocess
 from datetime import datetime, timedelta
 from typing import Any, Dict, List, Optional
@@ -8,10 +7,12 @@ from typing import Any, Dict, List, Optional
 from devloop.core.agent import Agent, AgentResult
 from devloop.core.context_store import Finding, Severity
 from devloop.core.event import Event
+from devloop.providers.ci_provider import CIProvider, RunConclusion, RunStatus
+from devloop.providers.provider_manager import get_provider_manager
 
 
 class CIMonitorAgent(Agent):
-    """Monitors GitHub Actions CI status and reports failures."""
+    """Monitors CI status and reports failures (provider-agnostic)."""
 
     def __init__(
         self,
@@ -19,7 +20,9 @@ class CIMonitorAgent(Agent):
         triggers: List[str],
         event_bus: Any,
         check_interval: int = 300,
-    ):  # 5 minutes default
+        ci_provider: Optional[CIProvider] = None,
+        provider_name: str = "github",
+    ):
         """
         Initialize CI monitor agent.
 
@@ -28,14 +31,36 @@ class CIMonitorAgent(Agent):
             triggers: Event triggers for this agent
             event_bus: Event bus for publishing events
             check_interval: How often to check CI status (in seconds)
+            ci_provider: Optional pre-configured CIProvider. If not provided, auto-detects.
+            provider_name: CI provider name (e.g., "github", "gitlab") if ci_provider not provided
         """
         super().__init__(name, triggers, event_bus)
         self.check_interval = check_interval
         self.last_check: Optional[datetime] = None
         self.last_status: Optional[dict] = None
 
+        # Use provided provider or auto-detect
+        if ci_provider:
+            self.provider: Optional[CIProvider] = ci_provider
+        else:
+            manager = get_provider_manager()
+            provider = manager.get_ci_provider(provider_name)
+            if provider:
+                self.provider = provider
+            else:
+                # Fall back to auto-detection
+                self.provider = manager.auto_detect_ci_provider()
+
     async def handle(self, event: Event) -> AgentResult:
         """Handle events and check CI status."""
+        if not self.provider:
+            return AgentResult(
+                agent_name=self.name,
+                success=False,
+                duration=0,
+                error="No CI provider available",
+            )
+
         # Check if it's time for periodic check
         should_check = False
 
@@ -55,11 +80,29 @@ class CIMonitorAgent(Agent):
 
         # Check CI status
         try:
-            status = await self._check_ci_status()
+            branch = self._get_current_branch()
+            if not branch:
+                return AgentResult(
+                    agent_name=self.name,
+                    success=False,
+                    duration=0,
+                    error="Could not determine current branch",
+                )
+
+            # Check if provider is available
+            if not self.provider.is_available():
+                return AgentResult(
+                    agent_name=self.name,
+                    success=True,
+                    duration=0,
+                    message=f"CI provider '{self.provider.get_provider_name()}' not available",
+                )
+
+            # Get latest runs
+            runs = self.provider.list_runs(branch, limit=5)
             self.last_check = datetime.now()
-            self.last_status = status
 
-            if not status:
+            if not runs:
                 return AgentResult(
                     agent_name=self.name,
                     success=True,
@@ -68,7 +111,7 @@ class CIMonitorAgent(Agent):
                 )
 
             # Analyze status and create findings
-            findings = self._analyze_ci_status(status)
+            findings = self._analyze_runs(runs)
 
             if findings:
                 return AgentResult(
@@ -102,40 +145,8 @@ class CIMonitorAgent(Agent):
         time_since_check = datetime.now() - self.last_check
         return time_since_check > timedelta(seconds=self.check_interval)
 
-    async def _check_ci_status(self) -> Optional[dict]:
-        """
-        Check CI status using gh CLI.
-
-        Returns:
-            CI status dict or None if unavailable
-        """
-        # Check if gh CLI is available
-        try:
-            result = subprocess.run(
-                ["gh", "--version"],
-                capture_output=True,
-                text=True,
-                timeout=5,
-            )
-            if result.returncode != 0:
-                return None
-        except (FileNotFoundError, subprocess.TimeoutExpired):
-            return None
-
-        # Check if authenticated
-        try:
-            result = subprocess.run(
-                ["gh", "auth", "status"],
-                capture_output=True,
-                text=True,
-                timeout=5,
-            )
-            if result.returncode != 0:
-                return None
-        except subprocess.TimeoutExpired:
-            return None
-
-        # Get current branch
+    def _get_current_branch(self) -> Optional[str]:
+        """Get the current git branch."""
         try:
             result = subprocess.run(
                 ["git", "rev-parse", "--abbrev-ref", "HEAD"],
@@ -144,92 +155,55 @@ class CIMonitorAgent(Agent):
                 check=True,
                 timeout=5,
             )
-            branch = result.stdout.strip()
+            return result.stdout.strip()
         except (subprocess.CalledProcessError, subprocess.TimeoutExpired):
             return None
 
-        # Get latest workflow runs
-        try:
-            result = subprocess.run(
-                [
-                    "gh",
-                    "run",
-                    "list",
-                    "--branch",
-                    branch,
-                    "--limit",
-                    "5",
-                    "--json",
-                    "status,conclusion,name,databaseId,createdAt,workflowName",
-                ],
-                capture_output=True,
-                text=True,
-                check=True,
-                timeout=10,
-            )
-
-            if result.stdout.strip():
-                runs = json.loads(result.stdout)
-                return {
-                    "branch": branch,
-                    "runs": runs,
-                    "checked_at": datetime.now().isoformat(),
-                }
-        except (
-            subprocess.CalledProcessError,
-            subprocess.TimeoutExpired,
-            json.JSONDecodeError,
-        ):
-            return None
-
-        return None
+    def _analyze_runs(self, runs: List) -> list[Finding]:
+        """Analyze CI runs and create findings for issues."""
+        findings: list[Finding] = []
 
-    def _analyze_ci_status(self, status: dict) -> list[Finding]:
-        """Analyze CI status and create findings for issues."""
-        findings = []
-        runs = status.get("runs", [])
-        branch = status.get("branch", "unknown")
+        # Ensure provider is available for messages
+        if not self.provider:
+            return findings
 
-        # Group runs by workflow
+        # Group runs by workflow name
         workflows: Dict[str, list] = {}
         for run in runs:
-            workflow_name = run.get("workflowName", run.get("name", "Unknown"))
+            workflow_name = run.name
             if workflow_name not in workflows:
                 workflows[workflow_name] = []
             workflows[workflow_name].append(run)
 
         # Check each workflow's latest run
         for workflow_name, workflow_runs in workflows.items():
-            latest_run = workflow_runs[0]  # Already sorted by createdAt descending
-            conclusion = latest_run.get("conclusion")
-            status_val = latest_run.get("status")
-            run_id = latest_run.get("databaseId", "unknown")
+            latest_run = workflow_runs[0]
 
-            if conclusion == "failure":
+            if latest_run.conclusion == RunConclusion.FAILURE:
                 findings.append(
                     Finding(
-                        id=f"ci-{run_id}",
+                        id=f"ci-{latest_run.id}",
                         agent="ci-monitor",
                         timestamp=datetime.now().isoformat(),
                         file=".github/workflows/ci.yml",
                         category="ci",
                         severity=Severity.ERROR,
-                        message=f"CI workflow '{workflow_name}' failed on branch '{branch}' (Run #{run_id})",
-                        suggestion=f"View details: gh run view {run_id}\nRerun: gh run rerun {run_id}",
+                        message=f"CI workflow '{workflow_name}' failed on branch '{latest_run.branch}' (Run #{latest_run.id})",
+                        suggestion=f"View details: {latest_run.url}\nProvider: {self.provider.get_provider_name()}",
                         auto_fixable=False,
                     )
                 )
-            elif status_val == "in_progress":
+            elif latest_run.status == RunStatus.IN_PROGRESS:
                 findings.append(
                     Finding(
-                        id=f"ci-{run_id}",
+                        id=f"ci-{latest_run.id}",
                         agent="ci-monitor",
                         timestamp=datetime.now().isoformat(),
                         file=".github/workflows/ci.yml",
                         category="ci",
                         severity=Severity.INFO,
-                        message=f"CI workflow '{workflow_name}' is running on branch '{branch}' (Run #{run_id})",
-                        suggestion=f"Watch progress: gh run watch {run_id}",
+                        message=f"CI workflow '{workflow_name}' is running on branch '{latest_run.branch}' (Run #{latest_run.id})",
+                        suggestion=f"Watch progress at: {latest_run.url}",
                         auto_fixable=False,
                     )
                 )