wup 0.2.16__tar.gz → 0.2.20__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wup
-Version: 0.2.16
+Version: 0.2.20
 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.20-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.65-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-7.3h-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.6500 (31 commits)
+- 👤 **Human dev:** ~$732 (7.3h @ $100/h, 30min dedup)
 
 Generated on 2026-04-29 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.20-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
@@ -333,15 +351,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 +377,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
 
@@ -379,12 +397,12 @@ wup/
 │   ├── 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/
+├── wupbro/                   # Optional FastAPI dashboard (separate package)
+│   ├── wupbro/
 │   │   ├── main.py            # FastAPI app
 │   │   ├── routers/           # events, drivers, dashboard
 │   │   ├── storage.py         # EventStore (in-memory + JSONL)
@@ -436,6 +454,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 +474,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.20}/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.20-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.65-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-7.3h-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.6500 (31 commits)
+- 👤 **Human dev:** ~$732 (7.3h @ $100/h, 30min dedup)
 
 Generated on 2026-04-29 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.20-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
@@ -307,15 +325,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 +351,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
 
@@ -353,12 +371,12 @@ wup/
 │   ├── 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/
+├── wupbro/                   # Optional FastAPI dashboard (separate package)
+│   ├── wupbro/
 │   │   ├── main.py            # FastAPI app
 │   │   ├── routers/           # events, drivers, dashboard
 │   │   ├── storage.py         # EventStore (in-memory + JSONL)
@@ -410,6 +428,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 +448,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.20}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "wup"
-version = "0.2.16"
+version = "0.2.20"
 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.20}/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.20"
 __author__ = "Tom Sapletta"
 
 from .config import load_config, save_config, get_default_config