wup 0.2.16__tar.gz → 0.2.21__tar.gz

{wup-0.2.16/wup.egg-info → wup-0.2.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wup
-Version: 0.2.16
+Version: 0.2.21
 Summary: WUP (What's Up) - Intelligent file watcher for regression testing in large projects
 Author-email: Tom Sapletta <tom@sapletta.com>
 License: Apache-2.0
@@ -29,17 +29,17 @@ Dynamic: license-file
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.16-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$2.55-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-4.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.21-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$4.80-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-9.1h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $2.5500 (17 commits)
-- 👤 **Human dev:** ~$445 (4.5h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $4.8000 (32 commits)
+- 👤 **Human dev:** ~$913 (9.1h @ $100/h, 30min dedup)
 
-Generated on 2026-04-29 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-05-01 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![PyPI](https://img.shields.io/badge/pypi-wup-blue) ![Version](https://img.shields.io/badge/version-0.2.16-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-wup-blue) ![Version](https://img.shields.io/badge/version-0.2.21-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 
 **WUP (What's Up)** - Intelligent file watcher for regression testing in large projects.
 
@@ -74,16 +74,19 @@ pip install -e ".[dev]"
 ## Quick Start
 
 ```bash
-# 1. Initialize configuration (optional)
-wup init
+# 1. Interactive configuration (recommended)
+wup assistant
+
+# 2. Or quick auto-setup
+wup assistant --quick --template fastapi
 
-# 2. Build dependency map (one-time setup)
+# 3. Build dependency map (one-time setup)
 wup map-deps ./my-project
 
-# 3. Start watching for changes
+# 4. Start watching for changes
 wup watch ./my-project
 
-# 4. Start with live dashboard
+# 5. Start with live dashboard
 wup watch ./my-project --dashboard
 ```
 
@@ -186,6 +189,16 @@ Full regression: 15s test → 15% CPU spike
 
 ## Configuration
 
+### Service Types
+
+WUP supports three service types for coincidence detection and intelligent testing:
+
+- **web** - HTTP/API services (FastAPI, Flask, Django, Express.js, etc.)
+- **shell** - CLI tools, scripts, and command-line services
+- **auto** - Automatic detection (default)
+
+Coincidence detection allows WUP to identify related services. For example, if you have `users-web` and `users-shell`, WUP will detect they share the same domain and test both when relevant files change.
+
 ### wup.yaml Configuration File
 
 WUP supports declarative configuration via `wup.yaml` (or `.wup.yaml`) in your project root. This allows you to define watch paths, service-specific settings, and test strategies.
@@ -196,6 +209,11 @@ Generate a default configuration:
 wup init
 ```
 
+The generated `wup.yaml` includes:
+- **Metadata header**: Version, generation date, documentation links
+- **Dependencies info**: WUP version and optional wupbro dashboard
+- **Quick start guide**: Common commands to get started
+
 Example `wup.yaml`:
 
 ```yaml
@@ -285,6 +303,26 @@ export WUP_CPU_THROTTLE=0.5
 export WUP_DEBOUNCE=3
 ```
 
+Full list of supported variables (see `.env.example`):
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `WUP_CPU_THROTTLE` | — | CPU usage threshold (0.0-1.0) |
+| `WUP_DEBOUNCE` | — | Debounce time in seconds |
+| `WUPBRO_ENDPOINT` | — | wupbro backend URL |
+| `WUP_BASE_URL` | — | Base URL for visual diff page scanning |
+| `OPENROUTER_API_KEY` | *(not set)* | Required for LLM features (https://openrouter.ai/keys) |
+| `LLM_MODEL` | `openrouter/qwen/qwen3-coder-next` | LLM model for assistant |
+| `PFIX_AUTO_APPLY` | `true` | Apply fixes without asking |
+| `PFIX_AUTO_INSTALL_DEPS` | `true` | Auto pip/uv install missing deps |
+| `PFIX_AUTO_RESTART` | `false` | Restart process after fix |
+| `PFIX_MAX_RETRIES` | `3` | Max fix retries |
+| `PFIX_DRY_RUN` | `false` | Dry-run mode (no changes written) |
+| `PFIX_ENABLED` | `true` | Enable/disable pfix |
+| `PFIX_GIT_COMMIT` | `false` | Auto-commit fixes |
+| `PFIX_GIT_PREFIX` | `pfix:` | Commit message prefix |
+| `PFIX_CREATE_BACKUPS` | `false` | Create .pfix_backups/ directory |
+
 ## Visual DOM Diff
 
 WUP optionally scans configured pages with Playwright after each successful quick test, compares the DOM structure to the previous snapshot, and reports significant changes.
@@ -333,15 +371,15 @@ Visible in `wup status` as a "Visual DOM diffs" section.
 
 If Playwright is not installed, the visual diff module logs a warning and skips scanning — it does **not** break the watcher.
 
-## Web Dashboard (wup-web)
+## Web Dashboard (wupbro)
 
 Optional FastAPI backend that receives events from WUP agents and renders a live dashboard.
 
 ### Run
 
 ```bash
-pip install -e wup-web/
-wup-web --reload --port 8000
+pip install -e wupbro/
+wupbro --reload --port 8000
 ```
 
 Open <http://localhost:8000/> to see regressions, passes, anomalies, visual diffs, and health transitions in real time.
@@ -359,12 +397,12 @@ web:
 Or via env:
 
 ```bash
-export WUP_WEB_ENDPOINT=http://localhost:8000
+export WUPBRO_ENDPOINT=http://localhost:8000
 ```
 
 The agent fire-and-forgets `REGRESSION`, `PASS`, `ANOMALY`, `VISUAL_DIFF`, and `HEALTH_TRANSITION` events. Network errors never break the watcher (soft-fail).
 
-See `wup-web/README.md` for full API reference and driver endpoints (DOM diff, browserless, anomaly).
+See `wupbro/README.md` for full API reference and driver endpoints (DOM diff, browserless, anomaly).
 
 ## Project Structure
 
@@ -372,19 +410,21 @@ See `wup-web/README.md` for full API reference and driver endpoints (DOM diff, b
 wup/
 ├── wup/
 │   ├── __init__.py            # Package exports
-│   ├── cli.py                 # CLI: watch, map-deps, status, init, testql-endpoints
+│   ├── anomaly_detector.py    # AnomalyDetector: hash, YAML structure, AST diff
+│   ├── assistant.py           # WupAssistant: interactive configuration wizard
+│   ├── cli.py                 # CLI: watch, map-deps, status, init, testql-endpoints, assistant, version
 │   ├── config.py              # Config loading/saving + .wup.env support
 │   ├── core.py                # WupWatcher: detection, inference, scheduling
 │   ├── dependency_mapper.py   # DependencyMapper: codebase → deps.json
 │   ├── testql_discovery.py    # TestQLEndpointDiscovery: scenario parsing
 │   ├── testql_watcher.py      # TestQLWatcher: scenario runner + health tracking
 │   ├── visual_diff.py         # VisualDiffer: Playwright DOM snapshot + diff engine
-│   ├── web_client.py          # WebClient: async HTTP event sink → wup-web
+│   ├── web_client.py          # WebClient: async HTTP event sink → wupbro
 │   └── models/
 │       ├── __init__.py
-│       └── config.py          # Dataclasses: WupConfig, VisualDiffConfig, WebConfig...
-├── wup-web/                   # Optional FastAPI dashboard (separate package)
-│   ├── wup_web/
+│       └── config.py          # Dataclasses: WupConfig, ServiceConfig, WatchConfig, TestStrategyConfig, TestQLConfig, VisualDiffConfig, WebConfig, AnomalyDetectionConfig...
+├── wupbro/                   # Optional FastAPI dashboard (separate package)
+│   ├── wupbro/
 │   │   ├── main.py            # FastAPI app
 │   │   ├── routers/           # events, drivers, dashboard
 │   │   ├── storage.py         # EventStore (in-memory + JSONL)
@@ -436,6 +476,18 @@ python3 examples/visual_diff_demo.py http://localhost:8100/health
 
 # TestQL + visual diff integration
 python3 examples/testql_integration.py /path/to/project
+
+# Monorepo analysis (c2004-style large projects)
+python3 examples/c2004_monorepo_demo.py /path/to/monorepo
+
+# CI/CD integration patterns
+python3 examples/ci_cd_integration.py
+
+# Generate GitHub Actions workflow
+python3 examples/ci_cd_integration.py --generate-github-actions
+
+# Webhook notifications (Slack, Teams, Discord)
+python3 examples/webhook_notifications.py
 ```
 
 ### Building & Publishing
@@ -444,6 +496,39 @@ python3 examples/testql_integration.py /path/to/project
 python -m build
 ```
 
+## Real-World Testing
+
+WUP has been tested on production-scale projects:
+
+- **c2004 Project** (maskservice/c2004): Large IoT platform with 21+ connect-* modules
+  - 29 services auto-detected by assistant
+  - 100+ YAML configuration files monitored
+  - Anomaly detection: 0.06s for 5 config files (~1ms/file)
+  - Framework: Custom Python/FastAPI hybrid
+
+## Documentation
+
+Comprehensive documentation is available in the `docs/` directory:
+
+- **[Configuration Assistant](docs/WUP_ASSISTANT.md)** - Interactive setup guide for `wup.yaml`
+  - `wup assistant` - Interactive configuration wizard
+  - Auto-detects framework and services
+  - Intelligent suggestions and validation
+
+- **[Anomaly Detection](docs/ANOMALY_DETECTION.md)** - Fast alternatives to Playwright
+  - Hash-based change detection (~1ms per file)
+  - YAML structure analysis
+  - Python AST diff for API changes
+  - Configure with `anomaly_detection:` in wup.yaml
+
+- **[Browser Notifications](docs/NOTIFICATIONS.md)** - Real-time alerts in wupbro
+  - 7 notification types (regressions, status changes, recoveries)
+  - Configurable per-type with cooldown
+  - Server-Sent Events for instant delivery
+  - Browser Notifications API integration
+
+- **[TestQL Integration](docs/TESTQL_INTEGRATION.md)** - TestQL scenario support
+
 ## License
 
 Licensed under Apache-2.0.

{wup-0.2.16 → wup-0.2.21}/README.md

@@ -3,17 +3,17 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.16-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$2.55-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-4.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.21-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$4.80-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-9.1h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $2.5500 (17 commits)
-- 👤 **Human dev:** ~$445 (4.5h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $4.8000 (32 commits)
+- 👤 **Human dev:** ~$913 (9.1h @ $100/h, 30min dedup)
 
-Generated on 2026-04-29 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-05-01 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![PyPI](https://img.shields.io/badge/pypi-wup-blue) ![Version](https://img.shields.io/badge/version-0.2.16-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-wup-blue) ![Version](https://img.shields.io/badge/version-0.2.21-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 
 **WUP (What's Up)** - Intelligent file watcher for regression testing in large projects.
 
@@ -48,16 +48,19 @@ pip install -e ".[dev]"
 ## Quick Start
 
 ```bash
-# 1. Initialize configuration (optional)
-wup init
+# 1. Interactive configuration (recommended)
+wup assistant
+
+# 2. Or quick auto-setup
+wup assistant --quick --template fastapi
 
-# 2. Build dependency map (one-time setup)
+# 3. Build dependency map (one-time setup)
 wup map-deps ./my-project
 
-# 3. Start watching for changes
+# 4. Start watching for changes
 wup watch ./my-project
 
-# 4. Start with live dashboard
+# 5. Start with live dashboard
 wup watch ./my-project --dashboard
 ```
 
@@ -160,6 +163,16 @@ Full regression: 15s test → 15% CPU spike
 
 ## Configuration
 
+### Service Types
+
+WUP supports three service types for coincidence detection and intelligent testing:
+
+- **web** - HTTP/API services (FastAPI, Flask, Django, Express.js, etc.)
+- **shell** - CLI tools, scripts, and command-line services
+- **auto** - Automatic detection (default)
+
+Coincidence detection allows WUP to identify related services. For example, if you have `users-web` and `users-shell`, WUP will detect they share the same domain and test both when relevant files change.
+
 ### wup.yaml Configuration File
 
 WUP supports declarative configuration via `wup.yaml` (or `.wup.yaml`) in your project root. This allows you to define watch paths, service-specific settings, and test strategies.
@@ -170,6 +183,11 @@ Generate a default configuration:
 wup init
 ```
 
+The generated `wup.yaml` includes:
+- **Metadata header**: Version, generation date, documentation links
+- **Dependencies info**: WUP version and optional wupbro dashboard
+- **Quick start guide**: Common commands to get started
+
 Example `wup.yaml`:
 
 ```yaml
@@ -259,6 +277,26 @@ export WUP_CPU_THROTTLE=0.5
 export WUP_DEBOUNCE=3
 ```
 
+Full list of supported variables (see `.env.example`):
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `WUP_CPU_THROTTLE` | — | CPU usage threshold (0.0-1.0) |
+| `WUP_DEBOUNCE` | — | Debounce time in seconds |
+| `WUPBRO_ENDPOINT` | — | wupbro backend URL |
+| `WUP_BASE_URL` | — | Base URL for visual diff page scanning |
+| `OPENROUTER_API_KEY` | *(not set)* | Required for LLM features (https://openrouter.ai/keys) |
+| `LLM_MODEL` | `openrouter/qwen/qwen3-coder-next` | LLM model for assistant |
+| `PFIX_AUTO_APPLY` | `true` | Apply fixes without asking |
+| `PFIX_AUTO_INSTALL_DEPS` | `true` | Auto pip/uv install missing deps |
+| `PFIX_AUTO_RESTART` | `false` | Restart process after fix |
+| `PFIX_MAX_RETRIES` | `3` | Max fix retries |
+| `PFIX_DRY_RUN` | `false` | Dry-run mode (no changes written) |
+| `PFIX_ENABLED` | `true` | Enable/disable pfix |
+| `PFIX_GIT_COMMIT` | `false` | Auto-commit fixes |
+| `PFIX_GIT_PREFIX` | `pfix:` | Commit message prefix |
+| `PFIX_CREATE_BACKUPS` | `false` | Create .pfix_backups/ directory |
+
 ## Visual DOM Diff
 
 WUP optionally scans configured pages with Playwright after each successful quick test, compares the DOM structure to the previous snapshot, and reports significant changes.
@@ -307,15 +345,15 @@ Visible in `wup status` as a "Visual DOM diffs" section.
 
 If Playwright is not installed, the visual diff module logs a warning and skips scanning — it does **not** break the watcher.
 
-## Web Dashboard (wup-web)
+## Web Dashboard (wupbro)
 
 Optional FastAPI backend that receives events from WUP agents and renders a live dashboard.
 
 ### Run
 
 ```bash
-pip install -e wup-web/
-wup-web --reload --port 8000
+pip install -e wupbro/
+wupbro --reload --port 8000
 ```
 
 Open <http://localhost:8000/> to see regressions, passes, anomalies, visual diffs, and health transitions in real time.
@@ -333,12 +371,12 @@ web:
 Or via env:
 
 ```bash
-export WUP_WEB_ENDPOINT=http://localhost:8000
+export WUPBRO_ENDPOINT=http://localhost:8000
 ```
 
 The agent fire-and-forgets `REGRESSION`, `PASS`, `ANOMALY`, `VISUAL_DIFF`, and `HEALTH_TRANSITION` events. Network errors never break the watcher (soft-fail).
 
-See `wup-web/README.md` for full API reference and driver endpoints (DOM diff, browserless, anomaly).
+See `wupbro/README.md` for full API reference and driver endpoints (DOM diff, browserless, anomaly).
 
 ## Project Structure
 
@@ -346,19 +384,21 @@ See `wup-web/README.md` for full API reference and driver endpoints (DOM diff, b
 wup/
 ├── wup/
 │   ├── __init__.py            # Package exports
-│   ├── cli.py                 # CLI: watch, map-deps, status, init, testql-endpoints
+│   ├── anomaly_detector.py    # AnomalyDetector: hash, YAML structure, AST diff
+│   ├── assistant.py           # WupAssistant: interactive configuration wizard
+│   ├── cli.py                 # CLI: watch, map-deps, status, init, testql-endpoints, assistant, version
 │   ├── config.py              # Config loading/saving + .wup.env support
 │   ├── core.py                # WupWatcher: detection, inference, scheduling
 │   ├── dependency_mapper.py   # DependencyMapper: codebase → deps.json
 │   ├── testql_discovery.py    # TestQLEndpointDiscovery: scenario parsing
 │   ├── testql_watcher.py      # TestQLWatcher: scenario runner + health tracking
 │   ├── visual_diff.py         # VisualDiffer: Playwright DOM snapshot + diff engine
-│   ├── web_client.py          # WebClient: async HTTP event sink → wup-web
+│   ├── web_client.py          # WebClient: async HTTP event sink → wupbro
 │   └── models/
 │       ├── __init__.py
-│       └── config.py          # Dataclasses: WupConfig, VisualDiffConfig, WebConfig...
-├── wup-web/                   # Optional FastAPI dashboard (separate package)
-│   ├── wup_web/
+│       └── config.py          # Dataclasses: WupConfig, ServiceConfig, WatchConfig, TestStrategyConfig, TestQLConfig, VisualDiffConfig, WebConfig, AnomalyDetectionConfig...
+├── wupbro/                   # Optional FastAPI dashboard (separate package)
+│   ├── wupbro/
 │   │   ├── main.py            # FastAPI app
 │   │   ├── routers/           # events, drivers, dashboard
 │   │   ├── storage.py         # EventStore (in-memory + JSONL)
@@ -410,6 +450,18 @@ python3 examples/visual_diff_demo.py http://localhost:8100/health
 
 # TestQL + visual diff integration
 python3 examples/testql_integration.py /path/to/project
+
+# Monorepo analysis (c2004-style large projects)
+python3 examples/c2004_monorepo_demo.py /path/to/monorepo
+
+# CI/CD integration patterns
+python3 examples/ci_cd_integration.py
+
+# Generate GitHub Actions workflow
+python3 examples/ci_cd_integration.py --generate-github-actions
+
+# Webhook notifications (Slack, Teams, Discord)
+python3 examples/webhook_notifications.py
 ```
 
 ### Building & Publishing
@@ -418,6 +470,39 @@ python3 examples/testql_integration.py /path/to/project
 python -m build
 ```
 
+## Real-World Testing
+
+WUP has been tested on production-scale projects:
+
+- **c2004 Project** (maskservice/c2004): Large IoT platform with 21+ connect-* modules
+  - 29 services auto-detected by assistant
+  - 100+ YAML configuration files monitored
+  - Anomaly detection: 0.06s for 5 config files (~1ms/file)
+  - Framework: Custom Python/FastAPI hybrid
+
+## Documentation
+
+Comprehensive documentation is available in the `docs/` directory:
+
+- **[Configuration Assistant](docs/WUP_ASSISTANT.md)** - Interactive setup guide for `wup.yaml`
+  - `wup assistant` - Interactive configuration wizard
+  - Auto-detects framework and services
+  - Intelligent suggestions and validation
+
+- **[Anomaly Detection](docs/ANOMALY_DETECTION.md)** - Fast alternatives to Playwright
+  - Hash-based change detection (~1ms per file)
+  - YAML structure analysis
+  - Python AST diff for API changes
+  - Configure with `anomaly_detection:` in wup.yaml
+
+- **[Browser Notifications](docs/NOTIFICATIONS.md)** - Real-time alerts in wupbro
+  - 7 notification types (regressions, status changes, recoveries)
+  - Configurable per-type with cooldown
+  - Server-Sent Events for instant delivery
+  - Browser Notifications API integration
+
+- **[TestQL Integration](docs/TESTQL_INTEGRATION.md)** - TestQL scenario support
+
 ## License
 
 Licensed under Apache-2.0.

{wup-0.2.16 → wup-0.2.21}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "wup"
-version = "0.2.16"
+version = "0.2.21"
 description = "WUP (What's Up) - Intelligent file watcher for regression testing in large projects"
 readme = "README.md"
 requires-python = ">=3.9"

{wup-0.2.16 → wup-0.2.21}/wup/__init__.py

@@ -7,7 +7,7 @@ WUP monitors file changes and runs intelligent regression tests using a 3-layer
 3. Detail Layer: Full tests with blame reports (only on failure)
 """
 
-__version__ = "0.2.16"
+__version__ = "0.2.21"
 __author__ = "Tom Sapletta"
 
 from .config import load_config, save_config, get_default_config

wup-0.2.21/wup/_ast_detector.py

@@ -0,0 +1,124 @@
+"""Python AST-based anomaly detection."""
+
+from __future__ import annotations
+
+import ast
+import json
+from pathlib import Path
+from typing import Dict, List, Optional
+
+from .anomaly_models import AnomalyResult
+
+
+class ASTDetector:
+    """Detect changes in Python files using AST comparison."""
+
+    def __init__(self, snapshot_dir: Path):
+        self.snapshot_dir = snapshot_dir / 'ast_snapshots'
+        self.snapshot_dir.mkdir(parents=True, exist_ok=True)
+
+    @staticmethod
+    def _collect_import(node: ast.Import) -> List[str]:
+        return [f"import {alias.name}" for alias in node.names]
+
+    @staticmethod
+    def _collect_import_from(node: ast.ImportFrom) -> str:
+        module = node.module or ''
+        names = ', '.join(a.name for a in node.names)
+        return f"from {module} import {names}"
+
+    @staticmethod
+    def _collect_class(node: ast.ClassDef) -> Dict:
+        methods = [n.name for n in node.body if isinstance(n, ast.FunctionDef)]
+        bases = [ast.unparse(b) for b in node.bases] if hasattr(ast, 'unparse') else []
+        return {'name': node.name, 'methods': methods, 'bases': bases}
+
+    @staticmethod
+    def _collect_function(node: ast.FunctionDef) -> Dict:
+        return {'name': node.name, 'args': len(node.args.args),
+                'decorators': len(node.decorator_list)}
+
+    def _extract_ast_info(self, tree: ast.AST) -> Dict:
+        info: Dict = {'imports': [], 'classes': [], 'functions': [], 'top_level': []}
+        _handlers = {
+            ast.Import: lambda n: info['imports'].extend(self._collect_import(n)),
+            ast.ImportFrom: lambda n: info['imports'].append(self._collect_import_from(n)),
+            ast.ClassDef: lambda n: info['classes'].append(self._collect_class(n)),
+            ast.FunctionDef: lambda n: info['functions'].append(self._collect_function(n)),
+        }
+        for node in ast.iter_child_nodes(tree):
+            handler = _handlers.get(type(node))
+            if handler:
+                handler(node)
+            elif isinstance(node, ast.Assign):
+                for target in node.targets:
+                    if isinstance(target, ast.Name):
+                        info['top_level'].append(target.id)
+        return info
+
+    def _snapshot_path(self, file_path: Path) -> Path:
+        rel_path = str(file_path).replace('/', '_').replace('\\', '_')
+        return self.snapshot_dir / f"{rel_path}.ast.json"
+
+    def _compute_changes(self, old_info: Dict, new_info: Dict) -> List[str]:
+        changes: List[str] = []
+        old_classes = {c['name']: c for c in old_info.get('classes', [])}
+        new_classes = {c['name']: c for c in new_info.get('classes', [])}
+
+        for name in set(old_classes) | set(new_classes):
+            if name not in new_classes:
+                changes.append(f"Klasa usunięta: {name}")
+            elif name not in old_classes:
+                changes.append(f"Nowa klasa: {name}")
+            elif old_classes[name] != new_classes[name]:
+                changes.append(f"Klasa zmieniona: {name}")
+
+        old_funcs = {f['name'] for f in old_info.get('functions', [])}
+        new_funcs = {f['name'] for f in new_info.get('functions', [])}
+        for name in old_funcs - new_funcs:
+            changes.append(f"Funkcja usunięta: {name}")
+        for name in new_funcs - old_funcs:
+            changes.append(f"Nowa funkcja: {name}")
+
+        return changes
+
+    def detect(self, file_path: Path) -> Optional[AnomalyResult]:
+        """Detect changes in Python file structure."""
+        if not str(file_path).endswith('.py'):
+            return None
+
+        try:
+            content = file_path.read_text(encoding='utf-8')
+            tree = ast.parse(content)
+            new_info = self._extract_ast_info(tree)
+            snap_path = self._snapshot_path(file_path)
+
+            if snap_path.exists():
+                old_info = json.loads(snap_path.read_text())
+                changes = self._compute_changes(old_info, new_info)
+                if changes:
+                    snap_path.write_text(json.dumps(new_info, indent=2))
+                    return AnomalyResult(
+                        detector='ast',
+                        file_path=str(file_path),
+                        anomaly_type='changed',
+                        severity='high',
+                        message=f"Struktura Python zmieniona ({len(changes)} zmian)",
+                        details={'changes': changes[:10]},
+                        suggestions=["Przejrzyj zmiany w API przed deploymentem"],
+                    )
+            else:
+                snap_path.write_text(json.dumps(new_info, indent=2))
+
+            return None
+
+        except SyntaxError as e:
+            return AnomalyResult(
+                detector='ast',
+                file_path=str(file_path),
+                anomaly_type='error',
+                severity='critical',
+                message=f"Błąd składni Python: {e}",
+            )
+        except Exception:
+            return None

wup-0.2.21/wup/_hash_detector.py

@@ -0,0 +1,72 @@
+"""Fast hash-based anomaly detection."""
+
+from __future__ import annotations
+
+import hashlib
+from pathlib import Path
+from typing import Optional
+
+from .anomaly_models import AnomalyResult
+
+
+class HashDetector:
+    """Fast anomaly detection using file hashes."""
+
+    def __init__(self, snapshot_dir: Path):
+        self.snapshot_dir = snapshot_dir / 'hash_snapshots'
+        self.snapshot_dir.mkdir(parents=True, exist_ok=True)
+
+    def _compute_hash(self, content: str) -> str:
+        return hashlib.sha256(content.encode('utf-8')).hexdigest()[:16]
+
+    def _snapshot_path(self, file_path: Path) -> Path:
+        rel_path = str(file_path).replace('/', '_').replace('\\', '_')
+        return self.snapshot_dir / f"{rel_path}.hash"
+
+    def detect(self, file_path: Path) -> Optional[AnomalyResult]:
+        """Detect changes using hash comparison."""
+        try:
+            if not file_path.exists():
+                return None
+
+            content = file_path.read_text(encoding='utf-8')
+            current_hash = self._compute_hash(content)
+            snap_path = self._snapshot_path(file_path)
+
+            if snap_path.exists():
+                old_hash = snap_path.read_text().strip()
+                if old_hash != current_hash:
+                    snap_path.write_text(current_hash)
+                    return AnomalyResult(
+                        detector='hash',
+                        file_path=str(file_path),
+                        anomaly_type='changed',
+                        severity='medium',
+                        message=f"Plik zmieniony (hash: {old_hash[:8]} → {current_hash[:8]})",
+                        details={
+                            'old_hash': old_hash,
+                            'new_hash': current_hash,
+                            'file_size': len(content),
+                        },
+                    )
+            else:
+                snap_path.write_text(current_hash)
+                return AnomalyResult(
+                    detector='hash',
+                    file_path=str(file_path),
+                    anomaly_type='added',
+                    severity='low',
+                    message=f"Nowy plik wykryty (hash: {current_hash[:8]})",
+                    details={'new_hash': current_hash},
+                )
+
+            return None
+
+        except Exception as e:
+            return AnomalyResult(
+                detector='hash',
+                file_path=str(file_path),
+                anomaly_type='error',
+                severity='low',
+                message=f"Błąd hash detection: {e}",
+            )