evolution-engine 0.1.0__tar.gz → 0.2.0__tar.gz

{evolution_engine-0.1.0/evolution_engine.egg-info → evolution_engine-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: evolution-engine
-Version: 0.1.0
+Version: 0.2.0
 Summary: Git-native codebase evolution indexer
 Author: Slava
 License: MIT
@@ -72,22 +72,39 @@ Sources → Phase 1 (Record) → Phase 2 (Measure) → Phase 3 (Explain)
 ## Quick Start
 
 ```bash
-# Install
 pip install evolution-engine
-
-# Analyze any git repository
 evo analyze .
+```
+
+### Three Integration Paths
 
-# With a GitHub token (unlocks CI, deployment, security data)
-evo analyze . --token ghp_xxx
+| Path | Command | When to use |
+|------|---------|-------------|
+| **CLI Explorer** | `evo analyze .` | Start here -- manual analysis, reports, investigation |
+| **Git Hooks** | `evo init . --path hooks` | Automate locally -- analyze on every commit or push |
+| **GitHub Action** | `evo init . --path action` | Automate in CI -- PR comments with risk badges |
 
-# Generate an HTML report
-evo report .
+Start with the CLI. Graduate to hooks when you trust the output. Add the GitHub Action for team-wide coverage. See [QUICKSTART.md](QUICKSTART.md) for the full walkthrough.
+
+```bash
+# Path 1: CLI Explorer (start here)
+evo analyze .                    # Run the full pipeline
+evo report . --open              # Visual HTML report
+evo status                       # Detected adapters and run info
 
-# See what adapters were detected
-evo status
+# Path 2: Git Hooks (automate locally)
+evo init . --path hooks          # Install post-commit hook
+evo watch .                      # Or poll for commits continuously
+
+# Path 3: GitHub Action (CI)
+evo init . --path action         # Generate workflow file, then push
+
+# All paths at once
+evo init . --path all
 ```
 
+Free tier gets all three paths. Pro adds AI investigation, fix suggestions, and inline PR review comments.
+
 ### From Source
 
 ```bash
@@ -97,7 +114,7 @@ python -m venv .venv
 source .venv/bin/activate
 pip install -e .
 
-# Run the test suite (246 tests)
+# Run the test suite (840+ tests)
 python -m pytest tests/ -v
 ```
 
@@ -156,25 +173,65 @@ The **Git History Walker** extracts dependency, schema, and config files from gi
 ## CLI Commands
 
 ```bash
-# Core
+# Core Analysis
 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 verify <advisory>            # Compare current state to a previous advisory
+
+# Setup & Integration
+evo init [path]                  # Detect environment and suggest integration path
+evo init . --path hooks          # Install git hooks for auto-analysis
+evo init . --path action         # Generate GitHub Action workflow
+evo init . --path all            # Set up all integration paths
+evo setup [path]                 # Interactive configuration wizard
+evo setup --ui                   # Browser-based settings page
+evo watch [path]                 # Watch for commits and auto-analyze
+evo watch . --daemon             # Run watcher in background
+evo hooks install [path]         # Install git hooks
+evo hooks uninstall [path]       # Remove git hooks
+evo hooks status [path]          # Show hook status
 
 # Patterns & Knowledge Base
 evo patterns list                # Show discovered patterns
+evo patterns pull [path]         # Fetch community patterns from registry
+evo patterns push [path]         # Share anonymized patterns (requires privacy_level >= 1)
 evo patterns export              # Export anonymized pattern digests
 evo patterns import <file>       # Import community patterns
-evo patterns sync                # Sync universal patterns
+evo patterns packages            # List pattern packages + cache status
+evo patterns new <name>          # Scaffold a pattern package
+evo patterns validate <path>     # Validate a pattern package
+evo patterns publish <path>      # Publish pattern package to PyPI
+evo patterns add <package>       # Subscribe to a pattern package
+evo patterns remove <package>    # Unsubscribe from a pattern package
+evo patterns block <name>        # Block a pattern package
+evo patterns unblock <name>      # Unblock a pattern package
 
 # Adapter Ecosystem
-evo adapter list                 # Show detected + installed adapters
+evo adapter list                 # Show detected adapters with trust badges
+evo adapter discover [path]      # Find available adapters for your tools
 evo adapter validate <class>     # Run 13-check certification
+evo adapter validate <class> --security  # + security scan
+evo adapter security-check <mod> # Standalone security scan
 evo adapter guide                # How to build an adapter
 evo adapter new <name> --family ci   # Scaffold a pip-installable package
 evo adapter prompt <name> --family ci  # Generate AI prompt for building
 evo adapter request <description>     # Request an adapter from the community
+evo adapter block <name> -r "reason"  # Block an adapter locally
+evo adapter unblock <name>       # Unblock a blocked adapter
+evo adapter check-updates        # Check PyPI for plugin updates
+evo adapter report <name>        # Report a broken/malicious adapter
+
+# Configuration & History
+evo config list                  # Show all settings
+evo config set <key> <val>       # Update a setting
+evo license status               # Check license tier
+evo history list [path]          # Show run history
+evo history diff [r1 r2]         # Compare two runs
 ```
 
 ---
@@ -203,7 +260,7 @@ pip install -e .
 evo adapter validate evo_jenkins.JenkinsAdapter
 ```
 
-Checks include: required class attributes, valid family, iter_events yields valid events, JSON serialization, attestation structure, and more.
+Adapters pass 13 structural checks + security scanning before certification.
 
 ### Learn More
 
@@ -221,9 +278,38 @@ The Evolution Engine discovers cross-family patterns automatically:
 - **Lift-based co-occurrence**: deviations co-occur more than chance (lift >= 1.5)
 - **Presence-based**: metric distributions differ when events co-occur (Cohen's d >= 0.2)
 
-Patterns progress through scopes: **local** (this repo) -> **community** (shared anonymously) -> **confirmed** (local + community match) -> **universal** (bundled in package).
+Patterns progress through scopes: **local** (this repo) -> **community** (shared anonymously) -> **confirmed** (local + community match).
+
+Community patterns are distributed through two redundant channels:
+- **Registry** (real-time) — patterns pushed by users are immediately available via `codequal.dev/api`
+- **PyPI packages** (durable) — periodic snapshots published as [`evo-patterns-community`](https://pypi.org/project/evo-patterns-community/), auto-fetched without `pip install`
 
-Universal patterns ship with the pip package and are recognized instantly on new repositories.
+If the registry is unavailable, PyPI packages still work. Both are checked automatically on `evo analyze`.
+
+### Pattern Distribution
+
+```bash
+# Auto-fetch happens on every `evo analyze` — no manual install needed
+evo analyze .
+#   Imported 25 pattern(s) from community registry
+#   Imported 25 pattern(s) from community packages
+
+# Pull/push patterns from the community registry
+evo patterns pull .
+evo patterns push .   # requires: evo config set sync.privacy_level 2
+
+# Add a third-party pattern package to your sources
+evo patterns add evo-patterns-web-security
+
+# Block an unwanted package
+evo patterns block evo-patterns-untrusted
+
+# Build and publish your own pattern package
+evo patterns new my-patterns
+# ... edit patterns.json ...
+evo patterns validate evo-patterns-my-patterns
+evo patterns publish evo-patterns-my-patterns
+```
 
 ---
 
@@ -244,6 +330,9 @@ evolution-engine/
 │   ├── knowledge_store.py         # SQLite knowledge base
 │   ├── kb_export.py               # Anonymized pattern export/import
 │   ├── kb_security.py             # Import validation (XSS, injection, traversal)
+│   ├── pattern_registry.py        # Auto-fetch pattern packages from PyPI
+│   ├── pattern_validator.py       # Pattern package validation
+│   ├── pattern_scaffold.py        # Pattern package scaffolding
 │   ├── report_generator.py        # Standalone HTML report generator
 │   ├── adapter_validator.py       # 13-check adapter certification
 │   ├── adapter_scaffold.py        # Package scaffolding + AI prompt gen
@@ -252,7 +341,9 @@ evolution-engine/
 │   ├── llm_anthropic.py           # Anthropic LLM client
 │   ├── validation_gate.py         # LLM output validation
 │   ├── data/
-│   │   └── universal_patterns.json  # Bundled universal patterns
+│   │   ├── universal_patterns.json  # Bundled universal patterns
+│   │   ├── pattern_index.json       # Known pattern packages
+│   │   └── pattern_blocklist.json   # Blocked pattern packages
 │   └── adapters/
 │       ├── git/                   # Version Control (+ Git History Walker)
 │       ├── ci/                    # CI / Build Pipeline (GitHub Actions)

{evolution_engine-0.1.0 → evolution_engine-0.2.0}/README.md

@@ -37,22 +37,39 @@ Sources → Phase 1 (Record) → Phase 2 (Measure) → Phase 3 (Explain)
 ## Quick Start
 
 ```bash
-# Install
 pip install evolution-engine
-
-# Analyze any git repository
 evo analyze .
+```
+
+### Three Integration Paths
 
-# With a GitHub token (unlocks CI, deployment, security data)
-evo analyze . --token ghp_xxx
+| Path | Command | When to use |
+|------|---------|-------------|
+| **CLI Explorer** | `evo analyze .` | Start here -- manual analysis, reports, investigation |
+| **Git Hooks** | `evo init . --path hooks` | Automate locally -- analyze on every commit or push |
+| **GitHub Action** | `evo init . --path action` | Automate in CI -- PR comments with risk badges |
 
-# Generate an HTML report
-evo report .
+Start with the CLI. Graduate to hooks when you trust the output. Add the GitHub Action for team-wide coverage. See [QUICKSTART.md](QUICKSTART.md) for the full walkthrough.
+
+```bash
+# Path 1: CLI Explorer (start here)
+evo analyze .                    # Run the full pipeline
+evo report . --open              # Visual HTML report
+evo status                       # Detected adapters and run info
 
-# See what adapters were detected
-evo status
+# Path 2: Git Hooks (automate locally)
+evo init . --path hooks          # Install post-commit hook
+evo watch .                      # Or poll for commits continuously
+
+# Path 3: GitHub Action (CI)
+evo init . --path action         # Generate workflow file, then push
+
+# All paths at once
+evo init . --path all
 ```
 
+Free tier gets all three paths. Pro adds AI investigation, fix suggestions, and inline PR review comments.
+
 ### From Source
 
 ```bash
@@ -62,7 +79,7 @@ python -m venv .venv
 source .venv/bin/activate
 pip install -e .
 
-# Run the test suite (246 tests)
+# Run the test suite (840+ tests)
 python -m pytest tests/ -v
 ```
 
@@ -121,25 +138,65 @@ The **Git History Walker** extracts dependency, schema, and config files from gi
 ## CLI Commands
 
 ```bash
-# Core
+# Core Analysis
 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 verify <advisory>            # Compare current state to a previous advisory
+
+# Setup & Integration
+evo init [path]                  # Detect environment and suggest integration path
+evo init . --path hooks          # Install git hooks for auto-analysis
+evo init . --path action         # Generate GitHub Action workflow
+evo init . --path all            # Set up all integration paths
+evo setup [path]                 # Interactive configuration wizard
+evo setup --ui                   # Browser-based settings page
+evo watch [path]                 # Watch for commits and auto-analyze
+evo watch . --daemon             # Run watcher in background
+evo hooks install [path]         # Install git hooks
+evo hooks uninstall [path]       # Remove git hooks
+evo hooks status [path]          # Show hook status
 
 # Patterns & Knowledge Base
 evo patterns list                # Show discovered patterns
+evo patterns pull [path]         # Fetch community patterns from registry
+evo patterns push [path]         # Share anonymized patterns (requires privacy_level >= 1)
 evo patterns export              # Export anonymized pattern digests
 evo patterns import <file>       # Import community patterns
-evo patterns sync                # Sync universal patterns
+evo patterns packages            # List pattern packages + cache status
+evo patterns new <name>          # Scaffold a pattern package
+evo patterns validate <path>     # Validate a pattern package
+evo patterns publish <path>      # Publish pattern package to PyPI
+evo patterns add <package>       # Subscribe to a pattern package
+evo patterns remove <package>    # Unsubscribe from a pattern package
+evo patterns block <name>        # Block a pattern package
+evo patterns unblock <name>      # Unblock a pattern package
 
 # Adapter Ecosystem
-evo adapter list                 # Show detected + installed adapters
+evo adapter list                 # Show detected adapters with trust badges
+evo adapter discover [path]      # Find available adapters for your tools
 evo adapter validate <class>     # Run 13-check certification
+evo adapter validate <class> --security  # + security scan
+evo adapter security-check <mod> # Standalone security scan
 evo adapter guide                # How to build an adapter
 evo adapter new <name> --family ci   # Scaffold a pip-installable package
 evo adapter prompt <name> --family ci  # Generate AI prompt for building
 evo adapter request <description>     # Request an adapter from the community
+evo adapter block <name> -r "reason"  # Block an adapter locally
+evo adapter unblock <name>       # Unblock a blocked adapter
+evo adapter check-updates        # Check PyPI for plugin updates
+evo adapter report <name>        # Report a broken/malicious adapter
+
+# Configuration & History
+evo config list                  # Show all settings
+evo config set <key> <val>       # Update a setting
+evo license status               # Check license tier
+evo history list [path]          # Show run history
+evo history diff [r1 r2]         # Compare two runs
 ```
 
 ---
@@ -168,7 +225,7 @@ pip install -e .
 evo adapter validate evo_jenkins.JenkinsAdapter
 ```
 
-Checks include: required class attributes, valid family, iter_events yields valid events, JSON serialization, attestation structure, and more.
+Adapters pass 13 structural checks + security scanning before certification.
 
 ### Learn More
 
@@ -186,9 +243,38 @@ The Evolution Engine discovers cross-family patterns automatically:
 - **Lift-based co-occurrence**: deviations co-occur more than chance (lift >= 1.5)
 - **Presence-based**: metric distributions differ when events co-occur (Cohen's d >= 0.2)
 
-Patterns progress through scopes: **local** (this repo) -> **community** (shared anonymously) -> **confirmed** (local + community match) -> **universal** (bundled in package).
+Patterns progress through scopes: **local** (this repo) -> **community** (shared anonymously) -> **confirmed** (local + community match).
+
+Community patterns are distributed through two redundant channels:
+- **Registry** (real-time) — patterns pushed by users are immediately available via `codequal.dev/api`
+- **PyPI packages** (durable) — periodic snapshots published as [`evo-patterns-community`](https://pypi.org/project/evo-patterns-community/), auto-fetched without `pip install`
 
-Universal patterns ship with the pip package and are recognized instantly on new repositories.
+If the registry is unavailable, PyPI packages still work. Both are checked automatically on `evo analyze`.
+
+### Pattern Distribution
+
+```bash
+# Auto-fetch happens on every `evo analyze` — no manual install needed
+evo analyze .
+#   Imported 25 pattern(s) from community registry
+#   Imported 25 pattern(s) from community packages
+
+# Pull/push patterns from the community registry
+evo patterns pull .
+evo patterns push .   # requires: evo config set sync.privacy_level 2
+
+# Add a third-party pattern package to your sources
+evo patterns add evo-patterns-web-security
+
+# Block an unwanted package
+evo patterns block evo-patterns-untrusted
+
+# Build and publish your own pattern package
+evo patterns new my-patterns
+# ... edit patterns.json ...
+evo patterns validate evo-patterns-my-patterns
+evo patterns publish evo-patterns-my-patterns
+```
 
 ---
 
@@ -209,6 +295,9 @@ evolution-engine/
 │   ├── knowledge_store.py         # SQLite knowledge base
 │   ├── kb_export.py               # Anonymized pattern export/import
 │   ├── kb_security.py             # Import validation (XSS, injection, traversal)
+│   ├── pattern_registry.py        # Auto-fetch pattern packages from PyPI
+│   ├── pattern_validator.py       # Pattern package validation
+│   ├── pattern_scaffold.py        # Pattern package scaffolding
 │   ├── report_generator.py        # Standalone HTML report generator
 │   ├── adapter_validator.py       # 13-check adapter certification
 │   ├── adapter_scaffold.py        # Package scaffolding + AI prompt gen
@@ -217,7 +306,9 @@ evolution-engine/
 │   ├── llm_anthropic.py           # Anthropic LLM client
 │   ├── validation_gate.py         # LLM output validation
 │   ├── data/
-│   │   └── universal_patterns.json  # Bundled universal patterns
+│   │   ├── universal_patterns.json  # Bundled universal patterns
+│   │   ├── pattern_index.json       # Known pattern packages
+│   │   └── pattern_blocklist.json   # Blocked pattern packages
 │   └── adapters/
 │       ├── git/                   # Version Control (+ Git History Walker)
 │       ├── ci/                    # CI / Build Pipeline (GitHub Actions)

evolution_engine-0.2.0/evolution/__init__.py

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