evolution-engine 0.2.2__tar.gz → 0.3.1__tar.gz

{evolution_engine-0.2.2 → evolution_engine-0.3.1}/LICENSE

@@ -5,6 +5,7 @@ Parameters
 Licensor: CodeQual LLC
 
 Licensed Work: Evolution Engine Core Analysis Engine v0.2.0 (and all subsequent versions)
+                The Licensed Work is (c) 2025-2026 CodeQual LLC.
 
 Additional Use Grant: You may use the Licensed Work in non-production environments for internal testing and development without a commercial license. Production use requires a valid Pro subscription.
 

{evolution_engine-0.2.2 → evolution_engine-0.3.1}/LICENSE-MIT

@@ -2,18 +2,12 @@ MIT License
 
 Copyright (c) 2025-2026 CodeQual LLC
 
-This license applies to the following components of Evolution Engine:
-- Command-line interface wrapper (evolution/cli.py)
-- Adapter framework (evolution/adapters/)
-- Plugin interfaces
-- GitHub Action wrapper (action/)
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
-of the above-listed components and associated documentation files (the
-"Software"), to deal in the Software without restriction, including without
-limitation the rights to use, copy, modify, merge, publish, distribute,
-sublicense, and/or sell copies of the Software, and to permit persons to whom
-the Software is furnished to do so, subject to the following conditions:
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
@@ -25,3 +19,13 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+---
+
+This MIT license applies to the following components of Evolution Engine:
+- Command-line interface (evolution/cli.py)
+- Adapter framework (evolution/adapters/)
+- Plugin interfaces
+- GitHub Action (action/)
+
+The core analysis engine (Phases 2-5) is licensed under BSL 1.1. See LICENSE.

{evolution_engine-0.2.2/evolution_engine.egg-info → evolution_engine-0.3.1}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: evolution-engine
-Version: 0.2.2
+Version: 0.3.1
 Summary: Git-native codebase evolution indexer
 Author: Slava
 License: BSL-1.1
 Project-URL: Homepage, https://codequal.dev
-Project-URL: Repository, https://github.com/alpsla/evolution_monitor
-Project-URL: Bug Tracker, https://github.com/alpsla/evolution_monitor/issues
+Project-URL: Repository, https://github.com/alpsla/evolution-engine
+Project-URL: Bug Tracker, https://github.com/alpsla/evolution-engine/issues
 Keywords: git,devops,ci-cd,code-quality,evolution,drift-detection,codebase-analysis
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
@@ -23,24 +23,36 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: LICENSE-MIT
-Requires-Dist: GitPython>=3.1
-Requires-Dist: click>=8.0
-Requires-Dist: requests>=2.25
-Requires-Dist: jinja2>=3.0
+Requires-Dist: GitPython<4,>=3.1
+Requires-Dist: click<9,>=8.0
+Requires-Dist: requests<3,>=2.25
+Requires-Dist: jinja2<4,>=3.0
 Provides-Extra: llm
-Requires-Dist: requests>=2.25; extra == "llm"
+Requires-Dist: requests<3,>=2.25; extra == "llm"
+Provides-Extra: demo
+Requires-Dist: playwright<3,>=1.40; extra == "demo"
 Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0; extra == "dev"
-Requires-Dist: python-dotenv>=0.19; extra == "dev"
-Requires-Dist: stripe>=7.0; extra == "dev"
+Requires-Dist: pytest<9,>=7.0; extra == "dev"
+Requires-Dist: pytest-cov<6,>=4.0; extra == "dev"
+Requires-Dist: python-dotenv<2,>=0.19; extra == "dev"
+Requires-Dist: stripe<12,>=7.0; extra == "dev"
+Requires-Dist: build<2,>=1.0; extra == "dev"
 Dynamic: license-file
 
 # Evolution Engine
 
+[![PyPI version](https://img.shields.io/pypi/v/evolution-engine)](https://pypi.org/project/evolution-engine/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/evolution-engine)](https://pypi.org/project/evolution-engine/)
+[![License: BSL 1.1](https://img.shields.io/badge/license-BSL%201.1-blue)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-1770%20passing-brightgreen)]()
+
 **AI coding tools write correct code that silently breaks your architecture. Evolution Engine detects the drift, shows you the exact commit, and lets your AI fix it — with evidence.**
 
-Calibrated on 90+ open-source repos. 6.18M signals analyzed. Your code never leaves your machine.
+Calibrated on 200+ open-source repos. 6.18M signals analyzed. Your code never leaves your machine.
+
+**[codequal.dev](https://codequal.dev)** | [Quickstart](QUICKSTART.md) | [PyPI](https://pypi.org/project/evolution-engine/)
+
+![Evolution Engine CLI Demo](docs/images/demo.gif)
 
 ---
 
@@ -53,18 +65,35 @@ Evolution Engine is a **drift detector for AI-assisted development**. It learns
 ### The Loop: Detect → Evidence → Fix → Verify
 
 ```
-  evo analyze .          What changed? Is it unusual for THIS repo?
+  evo analyze .              What changed? Is it unusual for THIS repo?
        |
-  evo investigate .      AI identifies the root cause commit + drift pattern
+  evo analyze . --show-prompt   Copy the investigation prompt with evidence
        |
-  evo fix .              AI proposes a fix based on evidence, not guesswork
+  You + your AI tool         Paste into Claude Code / Cursor / Copilot to fix
        |
-  evo verify .           Did the fix resolve the drift? Or did it make it worse?
+  evo analyze . --verify     Did the fix resolve the drift? Or make it worse?
        |
-  evo accept . 1 2       Expected change? Accept it. Move on.
+  evo accept . 1 2           Expected change? Accept it. Move on.
 ```
 
-This is the full cycle no other tool offers: detect drift, provide evidence, let AI fix it, verify the fix worked, and let humans decide what's intentional.
+EE generates the evidence and the prompt — you bring your own AI tool to investigate and fix. Then EE verifies whether the drift resolved. No other tool closes this loop.
+
+### Sample Reports
+
+<table>
+<tr>
+<td width="50%"><strong>Analyze Report</strong></td>
+<td width="50%"><strong>Verification Report</strong></td>
+</tr>
+<tr>
+<td><a href="docs/images/report-analyze.png"><img src="docs/images/report-analyze.png" alt="Analyze Report" width="400"></a></td>
+<td><a href="docs/images/report-verify.png"><img src="docs/images/report-verify.png" alt="Verification Report" width="400"></a></td>
+</tr>
+<tr>
+<td><em>Findings, patterns, and investigation prompt</em></td>
+<td><em>Verification banner shows what resolved</em></td>
+</tr>
+</table>
 
 ### How It Works (5-Phase Pipeline)
 
@@ -83,7 +112,7 @@ Your Repo → Phase 1 (Record events) → Phase 2 (Detect deviation from YOUR ba
 | **Phase 1** | Records immutable events — commits, builds, deps, releases |
 | **Phase 2** | Computes per-repo baselines, flags statistical deviation (MAD/IQR) |
 | **Phase 3** | Explains signals in human language — PM-friendly, evidence-backed |
-| **Phase 4** | Matches against 44 validated patterns from 90+ repos |
+| **Phase 4** | Matches against 44 validated patterns from 200+ repos |
 | **Phase 5** | Prioritized advisory with severity, evidence, and action items |
 
 ---
@@ -124,10 +153,6 @@ evo init . --path all
 
 Free tier covers Path 1 (CLI). Pro unlocks Path 2 (hooks) and Path 3 (CI integration), plus AI investigation, AI fix loop, and inline PR review comments.
 
-### Founding Member Program
-
-We're looking for 50 developers who use AI coding tools daily. In exchange for monthly feedback, you get founding member pricing: **$9.50/month for 3 months** (regular: $19/month). Use code `FOUNDING50` at checkout.
-
 ### Environment Variables
 
 ```bash
@@ -135,7 +160,7 @@ We're looking for 50 developers who use AI coding tools daily. In exchange for m
 GITHUB_TOKEN=ghp_xxx            # Unlocks CI, deployment, security adapters
 GITLAB_TOKEN=glpat-xxx          # Unlocks GitLab CI, releases adapters
 EVO_LICENSE_KEY=xxx              # Pro features (free tier works without)
-ANTHROPIC_API_KEY=sk-ant-xxx    # For evo investigate / evo fix (Pro)
+ANTHROPIC_API_KEY=sk-ant-xxx    # For evo fix automated loop (Pro)
 ```
 
 ---
@@ -188,9 +213,10 @@ evo analyze [path]               # Detect adapters, run full pipeline
 evo analyze . --families git,ci  # Override auto-detection
 evo report [path]                # Generate HTML report from last run
 evo status                       # Show detected adapters and event counts
-evo investigate [path]           # AI root cause analysis (Pro)
-evo fix [path]                   # AI fix-verify loop (Pro)
-evo fix [path] --residual        # Iteration-aware prompt (current vs previous)
+evo analyze . --show-prompt      # Copy investigation prompt for your AI tool
+evo fix [path] --dry-run         # Generate evidence-backed fix prompt (Pro)
+evo fix [path] --dry-run --residual  # Iteration-aware prompt (what's fixed vs still broken)
+evo fix [path]                   # Automated fix-verify loop with CLI agent (Pro, advanced)
 evo verify <advisory>            # Compare current state to a previous advisory
 
 # Setup & Integration
@@ -343,7 +369,7 @@ evolution-engine/
 │   ├── pattern_validator.py       # Pattern package validation
 │   ├── pattern_scaffold.py        # Pattern package scaffolding
 │   ├── report_generator.py        # Standalone HTML report generator
-│   ├── investigator.py            # AI investigation (evo investigate, Pro)
+│   ├── investigator.py            # AI investigation engine (Pro)
 │   ├── fixer.py                   # AI fix-verify loop (evo fix, Pro)
 │   ├── adapter_validator.py       # 13-check adapter certification
 │   ├── adapter_scaffold.py        # Package scaffolding + AI prompt gen
@@ -397,7 +423,7 @@ evolution-engine/
 
 AI coding tools are generating more code than ever. Teams ship faster — but structural quality is invisible until something breaks. EE provides the missing feedback loop: a guardrail that tells you (and your AI) when development patterns drift from what's normal for your project.
 
-Calibrated on **90+ open-source repos**, **6.18 million SDLC signals**, and **2.1 million commits**. 44 validated cross-signal patterns. 1.6% false positive rate.
+Calibrated on **200+ open-source repos**, **6.18 million SDLC signals**, and **2.1 million commits**. 44 validated cross-signal patterns. 1.6% false positive rate.
 
 ## Open-Core Model
 

{evolution_engine-0.2.2 → evolution_engine-0.3.1}/README.md

@@ -1,8 +1,17 @@
 # Evolution Engine
 
+[![PyPI version](https://img.shields.io/pypi/v/evolution-engine)](https://pypi.org/project/evolution-engine/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/evolution-engine)](https://pypi.org/project/evolution-engine/)
+[![License: BSL 1.1](https://img.shields.io/badge/license-BSL%201.1-blue)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-1770%20passing-brightgreen)]()
+
 **AI coding tools write correct code that silently breaks your architecture. Evolution Engine detects the drift, shows you the exact commit, and lets your AI fix it — with evidence.**
 
-Calibrated on 90+ open-source repos. 6.18M signals analyzed. Your code never leaves your machine.
+Calibrated on 200+ open-source repos. 6.18M signals analyzed. Your code never leaves your machine.
+
+**[codequal.dev](https://codequal.dev)** | [Quickstart](QUICKSTART.md) | [PyPI](https://pypi.org/project/evolution-engine/)
+
+![Evolution Engine CLI Demo](docs/images/demo.gif)
 
 ---
 
@@ -15,18 +24,35 @@ Evolution Engine is a **drift detector for AI-assisted development**. It learns
 ### The Loop: Detect → Evidence → Fix → Verify
 
 ```
-  evo analyze .          What changed? Is it unusual for THIS repo?
+  evo analyze .              What changed? Is it unusual for THIS repo?
        |
-  evo investigate .      AI identifies the root cause commit + drift pattern
+  evo analyze . --show-prompt   Copy the investigation prompt with evidence
        |
-  evo fix .              AI proposes a fix based on evidence, not guesswork
+  You + your AI tool         Paste into Claude Code / Cursor / Copilot to fix
        |
-  evo verify .           Did the fix resolve the drift? Or did it make it worse?
+  evo analyze . --verify     Did the fix resolve the drift? Or make it worse?
        |
-  evo accept . 1 2       Expected change? Accept it. Move on.
+  evo accept . 1 2           Expected change? Accept it. Move on.
 ```
 
-This is the full cycle no other tool offers: detect drift, provide evidence, let AI fix it, verify the fix worked, and let humans decide what's intentional.
+EE generates the evidence and the prompt — you bring your own AI tool to investigate and fix. Then EE verifies whether the drift resolved. No other tool closes this loop.
+
+### Sample Reports
+
+<table>
+<tr>
+<td width="50%"><strong>Analyze Report</strong></td>
+<td width="50%"><strong>Verification Report</strong></td>
+</tr>
+<tr>
+<td><a href="docs/images/report-analyze.png"><img src="docs/images/report-analyze.png" alt="Analyze Report" width="400"></a></td>
+<td><a href="docs/images/report-verify.png"><img src="docs/images/report-verify.png" alt="Verification Report" width="400"></a></td>
+</tr>
+<tr>
+<td><em>Findings, patterns, and investigation prompt</em></td>
+<td><em>Verification banner shows what resolved</em></td>
+</tr>
+</table>
 
 ### How It Works (5-Phase Pipeline)
 
@@ -45,7 +71,7 @@ Your Repo → Phase 1 (Record events) → Phase 2 (Detect deviation from YOUR ba
 | **Phase 1** | Records immutable events — commits, builds, deps, releases |
 | **Phase 2** | Computes per-repo baselines, flags statistical deviation (MAD/IQR) |
 | **Phase 3** | Explains signals in human language — PM-friendly, evidence-backed |
-| **Phase 4** | Matches against 44 validated patterns from 90+ repos |
+| **Phase 4** | Matches against 44 validated patterns from 200+ repos |
 | **Phase 5** | Prioritized advisory with severity, evidence, and action items |
 
 ---
@@ -86,10 +112,6 @@ evo init . --path all
 
 Free tier covers Path 1 (CLI). Pro unlocks Path 2 (hooks) and Path 3 (CI integration), plus AI investigation, AI fix loop, and inline PR review comments.
 
-### Founding Member Program
-
-We're looking for 50 developers who use AI coding tools daily. In exchange for monthly feedback, you get founding member pricing: **$9.50/month for 3 months** (regular: $19/month). Use code `FOUNDING50` at checkout.
-
 ### Environment Variables
 
 ```bash
@@ -97,7 +119,7 @@ We're looking for 50 developers who use AI coding tools daily. In exchange for m
 GITHUB_TOKEN=ghp_xxx            # Unlocks CI, deployment, security adapters
 GITLAB_TOKEN=glpat-xxx          # Unlocks GitLab CI, releases adapters
 EVO_LICENSE_KEY=xxx              # Pro features (free tier works without)
-ANTHROPIC_API_KEY=sk-ant-xxx    # For evo investigate / evo fix (Pro)
+ANTHROPIC_API_KEY=sk-ant-xxx    # For evo fix automated loop (Pro)
 ```
 
 ---
@@ -150,9 +172,10 @@ evo analyze [path]               # Detect adapters, run full pipeline
 evo analyze . --families git,ci  # Override auto-detection
 evo report [path]                # Generate HTML report from last run
 evo status                       # Show detected adapters and event counts
-evo investigate [path]           # AI root cause analysis (Pro)
-evo fix [path]                   # AI fix-verify loop (Pro)
-evo fix [path] --residual        # Iteration-aware prompt (current vs previous)
+evo analyze . --show-prompt      # Copy investigation prompt for your AI tool
+evo fix [path] --dry-run         # Generate evidence-backed fix prompt (Pro)
+evo fix [path] --dry-run --residual  # Iteration-aware prompt (what's fixed vs still broken)
+evo fix [path]                   # Automated fix-verify loop with CLI agent (Pro, advanced)
 evo verify <advisory>            # Compare current state to a previous advisory
 
 # Setup & Integration
@@ -305,7 +328,7 @@ evolution-engine/
 │   ├── pattern_validator.py       # Pattern package validation
 │   ├── pattern_scaffold.py        # Pattern package scaffolding
 │   ├── report_generator.py        # Standalone HTML report generator
-│   ├── investigator.py            # AI investigation (evo investigate, Pro)
+│   ├── investigator.py            # AI investigation engine (Pro)
 │   ├── fixer.py                   # AI fix-verify loop (evo fix, Pro)
 │   ├── adapter_validator.py       # 13-check adapter certification
 │   ├── adapter_scaffold.py        # Package scaffolding + AI prompt gen
@@ -359,7 +382,7 @@ evolution-engine/
 
 AI coding tools are generating more code than ever. Teams ship faster — but structural quality is invisible until something breaks. EE provides the missing feedback loop: a guardrail that tells you (and your AI) when development patterns drift from what's normal for your project.
 
-Calibrated on **90+ open-source repos**, **6.18 million SDLC signals**, and **2.1 million commits**. 44 validated cross-signal patterns. 1.6% false positive rate.
+Calibrated on **200+ open-source repos**, **6.18 million SDLC signals**, and **2.1 million commits**. 44 validated cross-signal patterns. 1.6% false positive rate.
 
 ## Open-Core Model
 

evolution_engine-0.3.1/evolution/__init__.py

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

evolution_engine-0.3.1/evolution/adapters/error_tracking/sentry_adapter.py

@@ -0,0 +1,243 @@
+"""
+Sentry Source Adapter (Error Tracking)
+
+Emits canonical SourceEvent payloads for Sentry issues.
+Conforms to:
+  - docs/ADAPTER_CONTRACT.md (universal)
+
+Supports:
+  - API mode: Fetches issues from Sentry API v0 (requires auth token)
+  - Fixture mode: Pre-parsed issue dicts (for testing)
+
+Auth is via SENTRY_AUTH_TOKEN env var (Bearer token).
+Supports self-hosted Sentry instances via base_url parameter.
+"""
+
+import json
+import os
+import hashlib
+from pathlib import Path
+from typing import Optional
+
+try:
+    import requests as _requests
+except ImportError:
+    _requests = None
+
+
+class SentryAdapter:
+    source_family = "error_tracking"
+    source_type = "sentry"
+    ordering_mode = "temporal"
+    attestation_tier = "medium"
+
+    API_BASE = "https://sentry.io/api/0"
+
+    def __init__(self, *, org: str = None, project: str = None,
+                 token: str = None, issues: list = None,
+                 source_id: str = None, max_issues: int = 500,
+                 cache_dir: Path = None, base_url: str = None):
+        """
+        Args:
+            org: Sentry organization slug
+            project: Sentry project slug
+            token: Sentry auth token (or SENTRY_AUTH_TOKEN env)
+            issues: Pre-parsed list of issue dicts (fixture mode)
+            source_id: Unique identifier
+            max_issues: Maximum issues to fetch (default 500)
+            cache_dir: Directory for response caching (optional)
+            base_url: Base URL for self-hosted Sentry (e.g. "https://sentry.mycompany.com/api/0")
+        """
+        self._fixture_issues = issues
+        self._api_base = base_url or self.API_BASE
+        self.source_id = source_id or (
+            f"sentry:{org}/{project}" if org and project else "sentry:fixture"
+        )
+        self.max_issues = max_issues
+        self._org = org
+        self._project = project
+        self._token = token or os.getenv("SENTRY_AUTH_TOKEN")
+        self._cache_dir = cache_dir
+        self._requests_made = 0
+
+        if issues is None:
+            if _requests is None:
+                raise RuntimeError("requests library required. pip install requests")
+            if not org or not project:
+                raise RuntimeError(
+                    "Provide org and project, or issues for fixture mode."
+                )
+            if not self._token:
+                raise RuntimeError(
+                    "Sentry auth token required. Set SENTRY_AUTH_TOKEN env var or pass token=."
+                )
+
+    def _headers(self) -> dict:
+        return {
+            "Authorization": f"Bearer {self._token}",
+            "Accept": "application/json",
+        }
+
+    def _cache_key(self, url: str, params: dict = None) -> str:
+        raw = f"{url}:{json.dumps(params or {}, sort_keys=True)}"
+        return hashlib.sha256(raw.encode()).hexdigest()[:16]
+
+    def _get(self, url: str, params: dict = None) -> tuple:
+        """GET with caching. Returns (json_data, response_headers)."""
+        if self._cache_dir:
+            key = self._cache_key(url, params)
+            cache_file = self._cache_dir / f"{key}.json"
+            if cache_file.exists():
+                return json.loads(cache_file.read_text(encoding="utf-8")), {}
+
+        resp = _requests.get(url, headers=self._headers(),
+                             params=params, timeout=30)
+        self._requests_made += 1
+        resp.raise_for_status()
+        data = resp.json()
+
+        if self._cache_dir:
+            self._cache_dir.mkdir(parents=True, exist_ok=True)
+            cache_file = self._cache_dir / f"{key}.json"
+            cache_file.write_text(json.dumps(data, indent=2), encoding="utf-8")
+
+        return data, resp.headers
+
+    def _normalize_level(self, level: str) -> str:
+        """Normalize Sentry issue level."""
+        level_map = {
+            "fatal": "fatal",
+            "error": "error",
+            "warning": "warning",
+            "info": "info",
+            "debug": "debug",
+            "sample": "info",
+        }
+        return level_map.get(level, "error") if level else "error"
+
+    def _normalize_status(self, status: str) -> str:
+        """Normalize Sentry issue status."""
+        status_map = {
+            "unresolved": "unresolved",
+            "resolved": "resolved",
+            "ignored": "ignored",
+            "muted": "ignored",
+            "resolvedInNextRelease": "resolved",
+        }
+        return status_map.get(status, "unresolved") if status else "unresolved"
+
+    def _fetch_issues(self) -> list:
+        """Fetch issues from Sentry API."""
+        url = f"{self._api_base}/projects/{self._org}/{self._project}/issues/"
+        all_issues = []
+        params = {
+            "query": "is:unresolved",
+            "statsPeriod": "90d",
+            "sort": "date",
+        }
+
+        while len(all_issues) < self.max_issues:
+            data, headers = self._get(url, params=params)
+
+            if not isinstance(data, list) or not data:
+                break
+
+            all_issues.extend(data)
+
+            # Cursor-based pagination via Link header
+            link = headers.get("Link", "")
+            next_url = self._parse_next_link(link)
+            if not next_url:
+                break
+            url = next_url
+            params = {}  # URL already contains params
+
+        return all_issues[:self.max_issues]
+
+    def _parse_next_link(self, link_header: str) -> Optional[str]:
+        """Parse Sentry's Link header for the next page URL.
+
+        Validates that the next URL has the same scheme and host as
+        self._api_base to prevent open-redirect / SSRF attacks.
+        """
+        from urllib.parse import urlparse
+
+        if not link_header:
+            return None
+        for part in link_header.split(","):
+            part = part.strip()
+            if 'rel="next"' in part and 'results="true"' in part:
+                url = part.split(";")[0].strip().strip("<>")
+                # Validate scheme + host match self._api_base
+                parsed_base = urlparse(self._api_base)
+                parsed_next = urlparse(url)
+                if (parsed_next.scheme != parsed_base.scheme or
+                        parsed_next.hostname != parsed_base.hostname):
+                    return None
+                return url
+        return None
+
+    def iter_events(self):
+        if self._fixture_issues is not None:
+            issues = self._fixture_issues
+        else:
+            issues = self._fetch_issues()
+
+        # Sort by firstSeen for temporal ordering
+        issues.sort(key=lambda i: i.get("firstSeen", ""))
+
+        for issue in issues:
+            yield self._issue_to_event(issue)
+
+    def _issue_to_event(self, issue: dict) -> dict:
+        """Convert a Sentry issue dict to a SourceEvent."""
+        issue_id = str(issue.get("id", ""))
+        first_seen = issue.get("firstSeen", "")
+        last_seen = issue.get("lastSeen", "")
+        level = self._normalize_level(issue.get("level", "error"))
+        status = self._normalize_status(issue.get("status", "unresolved"))
+        is_unhandled = bool(issue.get("isUnhandled", False))
+        title = issue.get("title", "")
+        count = int(issue.get("count", 0))
+        user_count = int(issue.get("userCount", 0))
+
+        # Extract release from metadata if available
+        release = ""
+        metadata = issue.get("metadata", {})
+        if isinstance(metadata, dict):
+            release = metadata.get("release", "")
+
+        payload = {
+            "issue_id": issue_id,
+            "title": title,
+            "level": level,
+            "status": status,
+            "is_unhandled": is_unhandled,
+            "trigger": {
+                "type": "error",
+                "commit_sha": "",
+                "release": release,
+            },
+            "timing": {
+                "first_seen": first_seen,
+                "last_seen": last_seen,
+            },
+            "stats": {
+                "event_count": count,
+                "user_count": user_count,
+            },
+        }
+
+        return {
+            "source_family": self.source_family,
+            "source_type": self.source_type,
+            "source_id": self.source_id,
+            "ordering_mode": self.ordering_mode,
+            "attestation": {
+                "type": "error_issue",
+                "issue_id": issue_id,
+                "trust_tier": self.attestation_tier,
+            },
+            "predecessor_refs": None,
+            "payload": payload,
+        }

{evolution_engine-0.2.2 → evolution_engine-0.3.1}/evolution/agents/base.py

@@ -128,12 +128,29 @@ def get_agent(
             key = api_key or os.environ.get("ANTHROPIC_API_KEY", "")
             return AnthropicAgent(api_key=key, model=model)
         except ImportError:
-            pass  # anthropic package not installed
+            if prefer == "anthropic":
+                import sys
+                print(
+                    "Warning: 'anthropic' package not installed. "
+                    "Install it with: pip install anthropic\n"
+                    "Falling back to prompt display mode.",
+                    file=sys.stderr,
+                )
 
     if prefer == "cli" or (prefer is None and _has_cli(cli_command)):
         from evolution.agents.cli_agent import CliAgent
         return CliAgent(command=cli_command or "claude", model=model)
 
+    if prefer is None and _has_anthropic_key(api_key):
+        # API key is set but anthropic package is missing — warn the user
+        import sys
+        print(
+            "Note: ANTHROPIC_API_KEY is set but the 'anthropic' package is not installed.\n"
+            "Install it with: pip install anthropic\n"
+            "Using prompt display mode instead.",
+            file=sys.stderr,
+        )
+
     return ShowPromptAgent()