PyPI - wup - Versions diffs - 0.2.26__tar.gz → 0.2.28__tar.gz - Mend

wup 0.2.26tar.gz → 0.2.28tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (36) hide show

{wup-0.2.26/wup.egg-info → wup-0.2.28}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wup
-Version: 0.2.26
+Version: 0.2.28
 Summary: WUP (What's Up) - Intelligent file watcher for regression testing in large projects
 Author-email: Tom Sapletta <tom@sapletta.com>
 License-Expression: 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.26-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-$1.95-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-15.3h-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.28-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.27-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-16.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
-- 🤖 **LLM usage:** $1.9540 (36 commits)
-- 👤 **Human dev:** ~$1532 (15.3h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $2.2653 (38 commits)
+- 👤 **Human dev:** ~$1632 (16.3h @ $100/h, 30min dedup)
-Generated on 2026-05-16 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-05-17 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.26-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.28-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.
@@ -83,7 +83,7 @@ wup assistant --quick --template fastapi
 # 3. Build dependency map (one-time setup)
 wup map-deps ./my-project
-# 4. Start watching for changes
+# 4. Start watching (TestQL + live probes every 60s by default)
 wup watch ./my-project
 # 5. Start with live dashboard
@@ -110,14 +110,18 @@ wup map-deps ./my-project --output my-deps.json
 ### Watch Project
 ```bash
-# Basic watching (uses wup.yaml if present)
+# Basic watching: TestQL mode + live HTTP probes every 60s (uses wup.yaml if present)
 wup watch ./my-project
+# Legacy HTTP-only watcher (no TestQL, no periodic probes unless configured)
+wup watch ./my-project --mode default --probe-interval 0
 # With custom settings
 wup watch ./my-project \
   --cpu-throttle 0.5 \
   --debounce 3 \
-  --cooldown 600
+  --cooldown 600 \
+  --probe-interval 120
 # With live dashboard
 wup watch ./my-project --dashboard
@@ -125,9 +129,6 @@ wup watch ./my-project --dashboard
 # Use specific config file
 wup watch ./my-project --config custom-config.yaml
-# TestQL mode
-wup watch ./my-project --mode testql
 # Discover endpoints from TestQL scenarios
 wup testql-endpoints /path/to/scenarios --output testql-deps.json
 ```

{wup-0.2.26 → wup-0.2.28}/README.md RENAMED Viewed

@@ -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.26-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-$1.95-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-15.3h-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.28-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.27-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-16.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
-- 🤖 **LLM usage:** $1.9540 (36 commits)
-- 👤 **Human dev:** ~$1532 (15.3h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $2.2653 (38 commits)
+- 👤 **Human dev:** ~$1632 (16.3h @ $100/h, 30min dedup)
-Generated on 2026-05-16 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-05-17 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.26-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.28-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.
@@ -57,7 +57,7 @@ wup assistant --quick --template fastapi
 # 3. Build dependency map (one-time setup)
 wup map-deps ./my-project
-# 4. Start watching for changes
+# 4. Start watching (TestQL + live probes every 60s by default)
 wup watch ./my-project
 # 5. Start with live dashboard
@@ -84,14 +84,18 @@ wup map-deps ./my-project --output my-deps.json
 ### Watch Project
 ```bash
-# Basic watching (uses wup.yaml if present)
+# Basic watching: TestQL mode + live HTTP probes every 60s (uses wup.yaml if present)
 wup watch ./my-project
+# Legacy HTTP-only watcher (no TestQL, no periodic probes unless configured)
+wup watch ./my-project --mode default --probe-interval 0
 # With custom settings
 wup watch ./my-project \
   --cpu-throttle 0.5 \
   --debounce 3 \
-  --cooldown 600
+  --cooldown 600 \
+  --probe-interval 120
 # With live dashboard
 wup watch ./my-project --dashboard
@@ -99,9 +103,6 @@ wup watch ./my-project --dashboard
 # Use specific config file
 wup watch ./my-project --config custom-config.yaml
-# TestQL mode
-wup watch ./my-project --mode testql
 # Discover endpoints from TestQL scenarios
 wup testql-endpoints /path/to/scenarios --output testql-deps.json
 ```

{wup-0.2.26 → wup-0.2.28}/pyproject.toml RENAMED Viewed

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

{wup-0.2.26 → wup-0.2.28}/tests/test_testql_monitor.py RENAMED Viewed

@@ -34,6 +34,31 @@ API[1]{method, endpoint, expected_status}:
     assert is_monitoring_probe(probes[0])
+def test_firmware_plugin_health_on_8202_not_live_probe():
+    probe = ProbeTarget(url="http://localhost:8202/api/v1/plugins/modbus-io/health")
+    assert not is_monitoring_probe(probe)
+    direct = ProbeTarget(url="http://localhost:8202/health")
+    assert is_monitoring_probe(direct)
+def test_connect_api_paths_on_8100_are_not_monitoring_probes():
+    probe = ProbeTarget(url="http://localhost:8100/api/id/health")
+    assert not is_monitoring_probe(probe)
+    assert assign_probe_to_service(
+        probe,
+        [ServiceConfig(name="backend", paths=["backend/**", "api/**"])],
+    ) != "backend"
+def test_connect_health_on_8103_not_assigned_to_backend():
+    services = [
+        ServiceConfig(name="frontend", paths=["frontend/**"]),
+        ServiceConfig(name="backend", paths=["backend/**"]),
+    ]
+    probe = ProbeTarget(url="http://localhost:8103/api/id/health")
+    assert assign_probe_to_service(probe, services) is None
 def test_assign_firmware_service():
     services = [
         ServiceConfig(name="frontend", paths=["frontend/**"]),
@@ -87,6 +112,28 @@ def test_monitor_merges_config_and_service_map():
         assert "http://localhost:8100/firmware/api/v1/execution/logs" in urls
+def test_probes_for_service_ignores_non_health_extra_paths():
+    with tempfile.TemporaryDirectory() as tmpdir:
+        root = Path(tmpdir)
+        cfg = WupConfig(
+            project=ProjectConfig(name="demo"),
+            services=[ServiceConfig(name="backend", paths=["backend/**"])],
+            watch=WatchConfig(),
+            testql=TestQLConfig(
+                base_url="http://localhost:8100",
+                api_base_url="http://localhost:8101",
+                endpoints_by_service={"backend": ["http://localhost:8101/api/v3/health"]},
+            ),
+        )
+        monitor = TestQLMonitor(root, cfg)
+        probes = monitor.probes_for_service(
+            "backend",
+            ["/connect-config", "http://localhost:8101/connect-config"],
+        )
+        urls = {p.url for p in probes}
+        assert urls == {"http://localhost:8101/api/v3/health"}
 def test_live_probe_failure_updates_health():
     with tempfile.TemporaryDirectory() as tmpdir:
         root = Path(tmpdir)

{wup-0.2.26 → wup-0.2.28}/tests/test_testql_watcher.py RENAMED Viewed

@@ -6,7 +6,14 @@ from pathlib import Path
 from subprocess import CompletedProcess
 from wup.testql_watcher import TestQLWatcher
-from wup.models.config import WupConfig, ProjectConfig, TestQLConfig, VisualDiffConfig
+from wup.models.config import (
+    ProjectConfig,
+    ServiceConfig,
+    TestQLConfig,
+    VisualDiffConfig,
+    WatchConfig,
+    WupConfig,
+)
 def test_process_changed_file_creates_track_on_failure():
@@ -97,6 +104,7 @@ def test_config_endpoints_use_base_url_from_yaml_config():
         root = Path(tmpdir)
         cfg = WupConfig(
             project=ProjectConfig(name="demo"),
+            services=[ServiceConfig(name="connect-config", paths=["connect-config/**"])],
             testql=TestQLConfig(
                 base_url="http://localhost:8100",
                 explicit_endpoints=["/connect-config"],
@@ -122,6 +130,7 @@ def test_config_endpoints_use_base_url_from_env_when_yaml_missing():
         root = Path(tmpdir)
         cfg = WupConfig(
             project=ProjectConfig(name="demo"),
+            services=[ServiceConfig(name="connect-data", paths=["connect-data/**"])],
             testql=TestQLConfig(
                 base_url="",
                 base_url_env="WUP_BASE_URL",
@@ -201,6 +210,76 @@ def test_service_health_transitions_are_persisted():
         assert "up" in statuses
+def test_normalize_fleet_health_entry_down_to_degraded():
+    with tempfile.TemporaryDirectory() as tmpdir:
+        root = Path(tmpdir)
+        health_path = root / ".wup" / "service-health.json"
+        health_path.parent.mkdir(parents=True)
+        health_path.write_text(
+            json.dumps(
+                {
+                    "demo": {
+                        "status": "down",
+                        "stage": "health_scenario",
+                        "message": "partial",
+                    }
+                }
+            ),
+            encoding="utf-8",
+        )
+        cfg = WupConfig(
+            project=ProjectConfig(name="demo"),
+            services=[ServiceConfig(name="frontend", paths=["frontend/**"])],
+            watch=WatchConfig(),
+            testql=TestQLConfig(health_scenario_strict=False),
+        )
+        TestQLWatcher(
+            project_root=str(root),
+            deps_file=str(root / "deps.json"),
+            scenarios_dir="testql-scenarios",
+            track_dir=".wup/tracks",
+            config=cfg,
+        )
+        state = json.loads(health_path.read_text(encoding="utf-8"))
+        assert state["demo"]["status"] == "degraded"
+def test_fleet_health_scenario_non_strict_records_degraded_not_down():
+    with tempfile.TemporaryDirectory() as tmpdir:
+        root = Path(tmpdir)
+        scenario_dir = root / "testql-scenarios"
+        scenario_dir.mkdir(parents=True, exist_ok=True)
+        (scenario_dir / "fleet.testql.toon.yaml").write_text("name: fleet\n", encoding="utf-8")
+        cfg = WupConfig(
+            project=ProjectConfig(name="demo"),
+            services=[ServiceConfig(name="frontend", paths=["frontend/**"])],
+            watch=WatchConfig(),
+            testql=TestQLConfig(
+                scenario_dir="testql-scenarios",
+                health_scenario="fleet.testql.toon.yaml",
+                health_scenario_strict=False,
+            ),
+        )
+        watcher = TestQLWatcher(
+            project_root=str(root),
+            deps_file=str(root / "deps.json"),
+            scenarios_dir="testql-scenarios",
+            track_dir=".wup/tracks",
+            config=cfg,
+        )
+        watcher._run_testql = lambda args, timeout: CompletedProcess(  # type: ignore[method-assign]
+            args=args,
+            returncode=1,
+            stdout='{"passed": 1, "failed": 1, "errors": ["L1: bad"]}',
+            stderr="",
+        )
+        assert asyncio.run(watcher._run_fleet_health_scenario()) is True
+        state = json.loads((root / ".wup" / "service-health.json").read_text(encoding="utf-8"))
+        assert state["demo"]["status"] == "degraded"
+        assert state["demo"]["stage"] == "health_scenario"
 def test_visual_differ_disabled_by_default():
     """visual_differ exists but is disabled (no-op) when visual_diff.enabled=False."""
     with tempfile.TemporaryDirectory() as tmpdir:

{wup-0.2.26 → wup-0.2.28}/wup/__init__.py RENAMED Viewed

@@ -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.26"
+__version__ = "0.2.28"
 __author__ = "Tom Sapletta"
 from .config import load_config, save_config, get_default_config

{wup-0.2.26 → wup-0.2.28}/wup/cli.py RENAMED Viewed

@@ -31,8 +31,16 @@ def watch(
     debounce: int = typer.Option(2, "--debounce", "-b", help="Debounce time in seconds"),
     cooldown: int = typer.Option(300, "--cooldown", "-t", help="Test cooldown in seconds"),
     dashboard: bool = typer.Option(False, "--dashboard", help="Enable live dashboard"),
-    mode: str = typer.Option("default", "--mode", help="Watcher mode: default or testql"),
-    scenarios_dir: str = typer.Option("testql-scenarios", "--scenarios-dir", help="Directory with TestQL scenario files"),
+    mode: str = typer.Option(
+        "testql",
+        "--mode",
+        help="Watcher mode: testql (default) or default (HTTP-only, no TestQL)",
+    ),
+    scenarios_dir: Optional[str] = typer.Option(
+        None,
+        "--scenarios-dir",
+        help="TestQL scenarios directory (default: testql.scenario_dir from wup.yaml)",
+    ),
     testql_bin: str = typer.Option("testql", "--testql-bin", help="TestQL executable name/path"),
     browser_service_url: Optional[str] = typer.Option(None, "--browser-service-url", help="HTTP endpoint for browser notifications"),
     track_dir: str = typer.Option(".wup/tracks", "--track-dir", help="Directory where error track JSON files are written"),
@@ -40,17 +48,16 @@ def watch(
     probe_interval: Optional[int] = typer.Option(
         None,
         "--probe-interval",
-        help="Periodic live HTTP/TestQL probes in seconds (overrides testql.probe_interval_s)",
+        help="Periodic live HTTP probes in seconds (default: 60 in testql mode, or testql.probe_interval_s from wup.yaml; use 0 to disable)",
     ),
     config: Optional[str] = typer.Option(None, "--config", "-C", help="Path to wup.yaml config file"),
 ):
     """
-    Watch project for file changes and run intelligent regression tests.
-    Uses a 3-layer approach:
-    1. Detection: File watching with heuristics
-    2. Priority: Quick tests of related services (3 endpoints max)
-    3. Detail: Full tests with blame reports (only on failure)
+    Watch project for file changes and run regression tests.
+    Defaults (no extra flags): ``--mode testql`` and live probes every **60s**
+    (unless ``testql.probe_interval_s`` is set in wup.yaml). Use
+    ``--mode default`` for the legacy HTTP-only watcher without TestQL.
     """
     project_path = Path(project).resolve()
@@ -63,6 +70,10 @@ def watch(
     wup_config = load_config(project_path, config_path)
     if probe_interval is not None:
         wup_config.testql.probe_interval_s = int(probe_interval)
+    elif mode.lower() == "testql" and not wup_config.testql.probe_interval_s:
+        wup_config.testql.probe_interval_s = 60
+    effective_scenarios_dir = scenarios_dir or wup_config.testql.scenario_dir
     console.print(f"[bold cyan]🚀 WUP Watcher[/bold cyan]")
     console.print(f"[dim]Project: {wup_config.project.name}[/dim]")
@@ -92,7 +103,7 @@ def watch(
             cpu_throttle=cpu_throttle,
             debounce_seconds=debounce,
             test_cooldown_seconds=cooldown,
-            scenarios_dir=scenarios_dir,
+            scenarios_dir=effective_scenarios_dir,
             testql_bin=testql_bin,
             browser_service_url=browser_service_url,
             track_dir=track_dir,

{wup-0.2.26 → wup-0.2.28}/wup/config.py RENAMED Viewed

@@ -178,9 +178,12 @@ def validate_config(raw: dict) -> WupConfig:
         endpoint_discovery=testql_raw.get("endpoint_discovery", True),
         probe_interval_s=int(testql_raw.get("probe_interval_s", 0) or 0),
         health_scenario=testql_raw.get("health_scenario", ""),
+        health_scenario_strict=bool(testql_raw.get("health_scenario_strict", False)),
         service_map_globs=testql_raw.get("service_map_globs", []),
         base_url=testql_raw.get("base_url", ""),
+        api_base_url=testql_raw.get("api_base_url", ""),
         base_url_env=testql_raw.get("base_url_env", "WUP_BASE_URL"),
+        service_base_urls=testql_raw.get("service_base_urls", {}),
         explicit_endpoints=testql_raw.get("explicit_endpoints", []),
         endpoints_by_service=testql_raw.get("endpoints_by_service", {})
     )
@@ -215,7 +218,8 @@ def validate_config(raw: dict) -> WupConfig:
         snapshot_dir=vd_raw.get("snapshot_dir", ".wup/visual-snapshots"),
         diff_dir=vd_raw.get("diff_dir", ".wup/visual-diffs"),
         pages=vd_raw.get("pages", []),
-        pages_from_endpoints=vd_raw.get("pages_from_endpoints", True),
+        pages_from_endpoints=vd_raw.get("pages_from_endpoints", False),
+        max_pages=int(vd_raw.get("max_pages", 5)),
         threshold_added=int(vd_raw.get("threshold_added", 3)),
         threshold_removed=int(vd_raw.get("threshold_removed", 3)),
         threshold_changed=int(vd_raw.get("threshold_changed", 5)),
@@ -304,7 +308,7 @@ def save_config(config: WupConfig, output_path: Path):
         f"#   wupbro (optional dashboard): pip install wupbro",
         f"#",
         f"# Quick Start:",
-        f"#   1. wup watch .                    # Start watching",
+        f"#   1. wup watch .                    # TestQL + live probes every 60s",
         f"#   2. wup watch . --dashboard        # With live dashboard",
         f"#   3. wup map-deps .                 # Build dependency map",
         f"#",
@@ -333,9 +337,12 @@ def save_config(config: WupConfig, output_path: Path):
             "endpoint_discovery": config.testql.endpoint_discovery,
             "probe_interval_s": config.testql.probe_interval_s,
             "health_scenario": config.testql.health_scenario,
+            "health_scenario_strict": config.testql.health_scenario_strict,
             "service_map_globs": config.testql.service_map_globs,
             "base_url": config.testql.base_url,
+            "api_base_url": config.testql.api_base_url,
             "base_url_env": config.testql.base_url_env,
+            "service_base_urls": config.testql.service_base_urls,
             "explicit_endpoints": config.testql.explicit_endpoints,
             "endpoints_by_service": config.testql.endpoints_by_service,
         },
@@ -349,6 +356,7 @@ def save_config(config: WupConfig, output_path: Path):
             "diff_dir": config.visual_diff.diff_dir,
             "pages": config.visual_diff.pages,
             "pages_from_endpoints": config.visual_diff.pages_from_endpoints,
+            "max_pages": config.visual_diff.max_pages,
             "threshold_added": config.visual_diff.threshold_added,
             "threshold_removed": config.visual_diff.threshold_removed,
             "threshold_changed": config.visual_diff.threshold_changed,

{wup-0.2.26 → wup-0.2.28}/wup/models/config.py RENAMED Viewed

@@ -56,16 +56,20 @@ class TestStrategyConfig:
 @dataclass
 class TestQLConfig:
     """TestQL-specific configuration."""
+    __test__ = False
     scenario_dir: str = "scenarios/tests"
     smoke_scenario: str = "smoke.testql.toon.yaml"
     output_format: str = "json"
     extra_args: List[str] = field(default_factory=lambda: ["--timeout 10s"])
     endpoint_discovery: bool = True  # Merge health probes from scenarios + service maps
     probe_interval_s: int = 0  # Periodic live probes for all services (0 = file-change only)
-    health_scenario: str = ""  # Optional TestQL scenario run live (not --dry-run) on each quick pass
+    health_scenario: str = ""  # Fleet TestQL scenario on each periodic probe cycle (live run)
+    health_scenario_strict: bool = False  # If false, fleet scenario failure is logged but does not block per-service probes
     service_map_globs: List[str] = field(default_factory=list)  # e.g. testql-testing/service-map/*.yaml
     base_url: str = ""
+    api_base_url: str = ""  # Core API (c2004: http://localhost:8101) — used for backend probes
     base_url_env: str = "WUP_BASE_URL"
+    service_base_urls: Dict[str, str] = field(default_factory=dict)  # optional per-service override
     explicit_endpoints: List[str] = field(default_factory=list)
     endpoints_by_service: Dict[str, List[str]] = field(default_factory=dict)
@@ -81,7 +85,8 @@ class VisualDiffConfig:
     snapshot_dir: str = ".wup/visual-snapshots"
     diff_dir: str = ".wup/visual-diffs"
     pages: List[str] = field(default_factory=list)  # explicit page paths to scan
-    pages_from_endpoints: bool = True  # infer pages from explicit_endpoints
+    pages_from_endpoints: bool = True
+    max_pages: int = 5  # cap DOM scans per service per file change
     threshold_added: int = 3         # min added nodes to report
     threshold_removed: int = 3       # min removed nodes to report
     threshold_changed: int = 5       # min changed attrs to report

{wup-0.2.26 → wup-0.2.28}/wup/testql_monitor.py RENAMED Viewed

@@ -22,6 +22,18 @@ _HEALTH_HINT = re.compile(
     r"(/health|/healthz|/ready|/live|/status|/openapi\.json|/execution/status|/execution/logs)",
     re.IGNORECASE,
 )
+# Connect module APIs live on :8103+ — not valid health probes on frontend proxy :8100
+_CONNECT_API_PREFIXES = (
+    "/api/id",
+    "/api/manager",
+    "/api/scenario",
+    "/api/test",
+    "/api/template",
+    "/api/cql",
+    "/api/v1/data",
+    "/api/v2/menu",
+)
+_PATH_TOKEN_BLOCKLIST = frozenset({"api", "app", "src", "lib", "bin", "dist", "out"})
 @dataclass(frozen=True)
@@ -102,12 +114,41 @@ def parse_service_map_probes(map_path: Path) -> List[ProbeTarget]:
     return probes
+def _connect_module_api_on_frontend_proxy(probe: ProbeTarget) -> bool:
+    """True when a connect-* API path would be wrongly probed via :8100."""
+    if not probe.url.startswith("http"):
+        return False
+    parsed = urlparse(probe.url)
+    if parsed.port not in (None, 8100):
+        return False
+    path = (parsed.path or "").lower()
+    return any(path.startswith(prefix) for prefix in _CONNECT_API_PREFIXES)
+def _firmware_plugin_probe_without_runtime(probe: ProbeTarget) -> bool:
+    """Plugin health on :8202 requires loaded plugins — skip for bare simulator live probes."""
+    if not probe.url.startswith("http"):
+        return False
+    parsed = urlparse(probe.url)
+    if parsed.port != 8202:
+        return False
+    path = (parsed.path or "").lower()
+    return "/api/v1/plugins/" in path and path.endswith("/health")
 def is_monitoring_probe(probe: ProbeTarget) -> bool:
     """True when this endpoint should be used for live service health checks."""
+    if _connect_module_api_on_frontend_proxy(probe):
+        return False
+    if _firmware_plugin_probe_without_runtime(probe):
+        return False
     if probe.url.startswith("http"):
         path = urlparse(probe.url).path or probe.url
     else:
         path = probe.url
+    path_lower = path.lower()
+    if any(path_lower.startswith(prefix) for prefix in _CONNECT_API_PREFIXES):
+        return False
     if _HEALTH_HINT.search(path):
         return True
     # Short GET smoke paths (/, /health) without heavy write APIs
@@ -128,14 +169,38 @@ def _service_path_patterns(services: Sequence[ServiceConfig]) -> Dict[str, List[
 def assign_probe_to_service(probe: ProbeTarget, services: Sequence[ServiceConfig]) -> Optional[str]:
     """Map a probe URL/path to a configured WUP service name."""
+    wup_names = {s.name.lower() for s in services}
     path = urlparse(probe.url).path if probe.url.startswith("http") else probe.url
     path_lower = path.lower()
+    if probe.url.startswith("http"):
+        parsed = urlparse(probe.url)
+        port = parsed.port
+        if port == 8101 and "backend" in wup_names:
+            return next(s.name for s in services if s.name.lower() == "backend")
+        if port == 8202:
+            for svc in services:
+                if "firmware" in svc.name.lower():
+                    return svc.name
+        if port == 8100:
+            if path_lower.startswith("/firmware"):
+                for svc in services:
+                    if "firmware" in svc.name.lower():
+                        return svc.name
+            if "frontend" in wup_names:
+                return next(s.name for s in services if s.name.lower() == "frontend")
+        # Connect-* backends on 8103+ — only if a matching WUP service exists
+        for svc in services:
+            token = svc.name.lower().replace("_", "-")
+            if token.startswith("connect-") and token.replace("connect-", "") in path_lower:
+                return svc.name
+        return None
     best: Optional[str] = None
     best_len = -1
     for svc in services:
         for token in _service_path_patterns([svc]).get(svc.name, []):
-            if len(token) < 3:
+            if len(token) < 4 or token in _PATH_TOKEN_BLOCKLIST:
                 continue
             if token in path_lower and len(token) > best_len:
                 best = svc.name
@@ -148,7 +213,7 @@ def assign_probe_to_service(probe: ProbeTarget, services: Sequence[ServiceConfig
         for svc in services:
             if "firmware" in svc.name.lower():
                 return svc.name
-    if path_lower.startswith("/api/"):
+    if path_lower.startswith("/api/v3"):
         for svc in services:
             if svc.name.lower() in {"backend", "api"}:
                 return svc.name
@@ -193,23 +258,28 @@ class TestQLMonitor:
             seen[service].add(key)
             by_service[service].append(probe)
-        # 1) Config-declared endpoints (paths or full URLs)
-        base = self._resolve_base_url()
+        # 1) Config-declared endpoints (paths or full URLs) — per-service base URL
         for svc_name, paths in (self.config.testql.endpoints_by_service or {}).items():
+            base = self._resolve_base_url_for_service(svc_name)
             for path in paths:
                 url = self._probeable_url(path, base)
                 if not url:
                     continue
                 probe = ProbeTarget(url=url, source="wup.yaml:endpoints_by_service")
-                add(svc_name, probe)
+                if is_monitoring_probe(probe):
+                    add(svc_name, probe)
         for path in self.config.testql.explicit_endpoints or []:
+            probe = ProbeTarget(url=path, source="wup.yaml:explicit_endpoints")
+            assigned = assign_probe_to_service(probe, self.config.services)
+            if not assigned:
+                continue
+            base = self._resolve_base_url_for_service(assigned)
             url = self._probeable_url(path, base)
             if not url:
                 continue
             probe = ProbeTarget(url=url, source="wup.yaml:explicit_endpoints")
-            assigned = assign_probe_to_service(probe, self.config.services)
-            if assigned:
+            if is_monitoring_probe(probe):
                 add(assigned, probe)
         if not self.config.testql.endpoint_discovery:
@@ -235,6 +305,19 @@ class TestQLMonitor:
         return by_service
+    def _resolve_base_url_for_service(self, service: str) -> str:
+        tq = self.config.testql
+        overrides = getattr(tq, "service_base_urls", None) or {}
+        if isinstance(overrides, dict):
+            override = (overrides.get(service) or "").strip().rstrip("/")
+            if override:
+                return override
+        if service.lower() in {"backend", "api"}:
+            api_base = (getattr(tq, "api_base_url", None) or "").strip().rstrip("/")
+            if api_base:
+                return api_base
+        return self._resolve_base_url()
     def _probeable_url(self, path: str, base: str) -> Optional[str]:
         if path.startswith("http://") or path.startswith("https://"):
             return path
@@ -245,7 +328,7 @@ class TestQLMonitor:
     def probes_for_service(self, service: str, extra_paths: Iterable[str] = ()) -> List[ProbeTarget]:
         """Merged probe list for one service (discovery + config + caller extras)."""
         discovered = self.discover_probes_by_service().get(service, [])
-        base = self._resolve_base_url()
+        base = self._resolve_base_url_for_service(service)
         merged: List[ProbeTarget] = list(discovered)
         keys = {f"{p.method}:{p.url}" for p in merged}
@@ -253,24 +336,31 @@ class TestQLMonitor:
             url = self._probeable_url(path, base)
             if not url:
                 continue
-            key = f"GET:{url}"
-            if key in keys:
-                continue
-            keys.add(key)
-            merged.append(ProbeTarget(url=url, source="runtime"))
-        for path in self.config.testql.endpoints_by_service.get(service, []):
-            url = self._probeable_url(path, base)
-            if not url:
+            probe = ProbeTarget(url=url, source="runtime")
+            if not is_monitoring_probe(probe):
                 continue
-            key = f"GET:{url}"
+            key = f"{probe.method}:{probe.url}"
             if key in keys:
                 continue
             keys.add(key)
-            merged.append(ProbeTarget(url=url, source="wup.yaml"))
+            merged.append(probe)
         return [p for p in merged if p.url.startswith("http://") or p.url.startswith("https://")]
+    @staticmethod
+    def _sort_probes_for_live(probes: Sequence[ProbeTarget]) -> List[ProbeTarget]:
+        """Prefer wup.yaml endpoints before scenario discovery for pass/fail."""
+        def rank(probe: ProbeTarget) -> Tuple[int, str]:
+            source = probe.source or ""
+            if source.startswith("wup.yaml:endpoints_by_service"):
+                return (0, probe.url)
+            if source.startswith("wup.yaml:explicit_endpoints"):
+                return (1, probe.url)
+            return (2, probe.url)
+        return sorted(probes, key=rank)
     def run_probes(
         self,
         service: str,
@@ -284,7 +374,8 @@ class TestQLMonitor:
             return True, ""
         failed: List[str] = []
-        for probe in list(probes)[:max_count]:
+        ordered = self._sort_probes_for_live(probes)
+        for probe in ordered[:max_count]:
             ok, detail = probe.probe(timeout_s=timeout_s)
             if ok:
                 continue

{wup-0.2.26 → wup-0.2.28}/wup/testql_watcher.py RENAMED Viewed

@@ -101,6 +101,27 @@ class TestQLWatcher(WupWatcher):
         self.visual_differ = VisualDiffer(project_root, config.visual_diff) if config and config.visual_diff else None
         self.web_client = WebClient(config.web) if config and getattr(config, "web", None) else WebClient()
         self._probe_thread = None
+        self._normalize_fleet_health_entry()
+    def _normalize_fleet_health_entry(self) -> None:
+        """Upgrade stale fleet ``down`` to ``degraded`` when health_scenario is non-strict."""
+        if not self.config:
+            return
+        strict = bool(getattr(self.config.testql, "health_scenario_strict", False))
+        if strict:
+            return
+        fleet = self.config.project.name
+        entry = self.service_health.get(fleet)
+        if not isinstance(entry, dict):
+            return
+        if entry.get("stage") != "health_scenario":
+            return
+        if str(entry.get("status", "")).lower() != "down":
+            return
+        entry = dict(entry)
+        entry["status"] = "degraded"
+        self.service_health[fleet] = entry
+        self._save_service_health()
     def _load_service_health(self) -> Dict[str, Dict]:
         if not self.health_state_path.exists():
@@ -188,17 +209,51 @@ class TestQLWatcher(WupWatcher):
         return [token for token in raw_tokens if len(token) >= 3]
     def _get_config_endpoints_for_service(self, service: str) -> List[str]:
+        """Endpoints for *service* only — never attach all explicit_endpoints to every service."""
+        from .testql_monitor import ProbeTarget, assign_probe_to_service
         by_service = self.config.testql.endpoints_by_service or {}
         explicit = self.config.testql.explicit_endpoints or []
-        service_specific = by_service.get(service, [])
         merged: List[str] = []
-        for endpoint in [*service_specific, *explicit]:
-            endpoint_url = self._to_full_url(endpoint)
-            if endpoint_url not in merged:
+        for endpoint in by_service.get(service, []):
+            endpoint_url = self._to_full_url_for_service(service, endpoint)
+            if endpoint_url and endpoint_url not in merged:
                 merged.append(endpoint_url)
+        for endpoint in explicit:
+            probe = ProbeTarget(
+                url=self._to_full_url_for_service(service, endpoint) or endpoint,
+                source="wup.yaml:explicit_endpoints",
+            )
+            if assign_probe_to_service(probe, self.config.services) == service:
+                if probe.url not in merged:
+                    merged.append(probe.url)
         return merged
+    def _to_full_url_for_service(self, service: str, endpoint: str) -> str:
+        if endpoint.startswith("http://") or endpoint.startswith("https://"):
+            return endpoint
+        base = self._resolve_base_url_for_service(service)
+        if not base:
+            return endpoint
+        if endpoint.startswith("/"):
+            return f"{base}{endpoint}"
+        return f"{base}/{endpoint}"
+    def _resolve_base_url_for_service(self, service: str) -> str:
+        """Per-service base URL (e.g. backend API on :8101, frontend proxy on :8100)."""
+        overrides = getattr(self.config.testql, "service_base_urls", None) or {}
+        if isinstance(overrides, dict):
+            override = (overrides.get(service) or "").strip().rstrip("/")
+            if override:
+                return override
+        if service.lower() in {"backend", "api"}:
+            api_base = (getattr(self.config.testql, "api_base_url", None) or "").strip().rstrip("/")
+            if api_base:
+                return api_base
+        return self._resolve_base_url()
     def _resolve_base_url(self) -> str:
         base_url = (self.config.testql.base_url or "").strip()
         if base_url:
@@ -253,6 +308,8 @@ class TestQLWatcher(WupWatcher):
             score += 2
         if "infra" in name or "smoke" in name:
             score += 1
+        if "generated-api-smoke" in name:
+            score -= 5
         return score
     def _select_scenarios_for_service(self, service: str) -> List[Path]:
@@ -260,20 +317,28 @@ class TestQLWatcher(WupWatcher):
         if not all_scenarios:
             return []
+        svc_config = self.get_service_config(service)
+        limit = (svc_config.quick_tests.max_endpoints
+                 if svc_config and svc_config.quick_tests else self.quick_limit)
         tokens = self._tokenize_service(service)
         scored = sorted(
             ((self._score_scenario(s, tokens), s) for s in all_scenarios),
             key=lambda item: (item[0], item[1].name),
             reverse=True,
         )
-        selected = [s for score, s in scored if score > 0]
+        selected = [s for score, s in scored if score > 0][:limit]
         if selected:
             return selected
-        svc_config = self.get_service_config(service)
-        limit = (svc_config.quick_tests.max_endpoints
-                 if svc_config and svc_config.quick_tests else self.quick_limit)
-        return all_scenarios if limit >= len(all_scenarios) else all_scenarios[:limit]
+        smoke_name = (self.config.testql.smoke_scenario or "").strip()
+        if smoke_name:
+            for base in (self.scenarios_dir, self.project_root):
+                candidate = base / smoke_name
+                if candidate.exists():
+                    return [candidate]
+        return []
     def _run_testql(self, args: Sequence[str], timeout: int) -> subprocess.CompletedProcess:
         cmd = [self.testql_bin, *args]
@@ -396,7 +461,8 @@ class TestQLWatcher(WupWatcher):
         if not self.monitor:
             return True
-        probes = self.monitor.probes_for_service(service, merged_endpoints)
+        # Health probes come only from wup.yaml + TestQL discovery — not deps.json page routes.
+        probes = self.monitor.probes_for_service(service)
         if not probes:
             return True
@@ -427,6 +493,36 @@ class TestQLWatcher(WupWatcher):
             )
         return False
+    @staticmethod
+    def _summarize_health_scenario_failure(result: subprocess.CompletedProcess) -> str:
+        """Extract a short human summary from TestQL --output json (avoid trailing '}')."""
+        blob = "\n".join(part for part in (result.stdout or "", result.stderr or "") if part).strip()
+        if not blob:
+            return "health_scenario failed"
+        start = blob.rfind("{")
+        if start >= 0:
+            try:
+                data = json.loads(blob[start:])
+            except json.JSONDecodeError:
+                data = None
+            if isinstance(data, dict):
+                passed = data.get("passed")
+                failed = data.get("failed")
+                if isinstance(passed, int) and isinstance(failed, int):
+                    total = passed + failed
+                    errors = data.get("errors") or []
+                    hint = f" — {errors[0]}" if errors else ""
+                    return f"{passed}/{total} passed, {failed} failed{hint}"
+        for line in reversed(blob.splitlines()):
+            stripped = line.strip()
+            if not stripped or stripped in {"}", "{"}:
+                continue
+            if "passed" in stripped.lower() or "failed" in stripped.lower() or "❌" in stripped:
+                return stripped
+        return "health_scenario failed"
     async def _run_fleet_health_scenario(self) -> bool:
         """Optional full TestQL run (not dry-run) for fleet-wide health scenarios."""
         scenario_name = (self.config.testql.health_scenario or "").strip()
@@ -435,9 +531,12 @@ class TestQLWatcher(WupWatcher):
         scenario_path = Path(scenario_name)
         if not scenario_path.is_absolute():
-            scenario_path = self.project_root / scenario_name
-        if not scenario_path.exists():
-            scenario_path = self.scenarios_dir / scenario_name
+            candidates = [
+                self.scenarios_dir / scenario_name,
+                self.project_root / scenario_name,
+                self.project_root / self.config.testql.scenario_dir / scenario_name,
+            ]
+            scenario_path = next((p for p in candidates if p.exists()), candidates[0])
         if not scenario_path.exists():
             self.console.print(f"[yellow]⚠ health_scenario not found: {scenario_name}[/yellow]")
             return True
@@ -454,17 +553,26 @@ class TestQLWatcher(WupWatcher):
             )
             return True
-        reason = result.stderr.strip() or result.stdout.strip() or "health_scenario failed"
+        summary = self._summarize_health_scenario_failure(result)
         track_path = self._write_track(service=fleet, stage="health_scenario", scenario=scenario_path, result=result)
+        strict = bool(getattr(self.config.testql, "health_scenario_strict", False))
+        # Non-strict: informational only — must not mark fleet "down" (koru reads service-health.json).
+        fleet_status = "down" if strict else "degraded"
         self._record_health_transition(
             service=fleet,
-            status="down",
+            status=fleet_status,
             stage="health_scenario",
-            message=reason,
+            message=summary[:500],
             track_file=str(track_path),
         )
-        self.console.print(f"[red]✗ Fleet health scenario failed: {reason}[/red]")
-        return False
+        if strict:
+            self.console.print(f"[red]✗ Fleet health scenario failed: {summary}[/red]")
+            return False
+        self.console.print(
+            f"[yellow]⚠ Fleet health scenario incomplete: {summary} "
+            f"(per-service probes continue; set testql.health_scenario_strict: true to hard-fail)[/yellow]"
+        )
+        return True
     async def run_quick_test(self, service: str, endpoints: List[str]) -> bool:
         merged_endpoints = self._merge_endpoints(service, endpoints)

{wup-0.2.26 → wup-0.2.28}/wup/visual_diff.py RENAMED Viewed

@@ -35,6 +35,7 @@ console = Console()
 # ---------------------------------------------------------------------------
 _PW_AVAILABLE: Optional[bool] = None
+_PW_WARNED: bool = False
 def _playwright_available() -> bool:
@@ -48,6 +49,17 @@ def _playwright_available() -> bool:
     return _PW_AVAILABLE
+def _warn_playwright_missing() -> None:
+    global _PW_WARNED
+    if _PW_WARNED:
+        return
+    _PW_WARNED = True
+    console.print(
+        "[yellow]visual_diff: playwright not installed — DOM scan skipped "
+        "(pip install playwright && playwright install chromium)[/yellow]"
+    )
 _DOM_SNAPSHOT_JS = """
 (maxDepth) => {
     function snapshot(node, depth) {
@@ -85,7 +97,7 @@ async def _fetch_dom_snapshot(
 ) -> Optional[Dict]:
     """Return a DOM structure dict for *url* using Playwright."""
     if not _playwright_available():
-        console.print("[yellow]visual_diff: playwright not installed — skipping DOM scan[/yellow]")
+        _warn_playwright_missing()
         return None
     try:
         from playwright.async_api import async_playwright
@@ -273,7 +285,8 @@ class VisualDiffer:
         pages: List[str] = list(self.cfg.pages)
         if self.cfg.pages_from_endpoints and endpoints:
-            pages.extend(endpoints)
+            for endpoint in endpoints:
+                pages.append(endpoint)
         if not pages:
             pages = [f"/{service}"]
@@ -297,10 +310,17 @@ class VisualDiffer:
         if not self.cfg.enabled:
             return []
+        if not _playwright_available():
+            _warn_playwright_missing()
+            return []
         if self.cfg.delay_seconds > 0:
             await asyncio.sleep(self.cfg.delay_seconds)
         pages = self._pages_for_service(service, endpoints)
+        max_pages = max(1, int(self.cfg.max_pages or 5))
+        if len(pages) > max_pages:
+            pages = pages[:max_pages]
         results = []
         for url in pages:
             result = await self._check_page(service, url)
@@ -321,7 +341,10 @@ class VisualDiffer:
                     )
             elif result["diff"]["status"] == "new":
                 console.print(f"[dim]📷 Baseline snapshot: {url}[/dim]")
-            else:
+            elif result["diff"]["status"] == "error":
+                message = result["diff"].get("message", "scan failed")
+                console.print(f"[yellow]⚠ Visual diff skipped: {url} ({message})[/yellow]")
+            elif result["diff"]["status"] == "ok":
                 console.print(f"[dim green]✓ No DOM change: {url}[/dim green]")
         return results

{wup-0.2.26 → wup-0.2.28}/wup/web_client.py RENAMED Viewed

@@ -26,6 +26,7 @@ from .models.config import WebConfig
 _console = Console()
 _HTTPX_AVAILABLE: Optional[bool] = None
 _HTTPX_WARN_LOGGED: bool = False
+_SEND_FAIL_WARNED: bool = False
 def _httpx_available() -> bool:
@@ -122,7 +123,13 @@ class WebClient:
                 )
                 return False
         except Exception as exc:  # noqa: BLE001 — soft-fail by design
-            _console.print(f"[yellow]wup.web_client: send_event failed ({exc})[/yellow]")
+            global _SEND_FAIL_WARNED
+            if not _SEND_FAIL_WARNED:
+                _SEND_FAIL_WARNED = True
+                _console.print(
+                    f"[yellow]wup.web_client: send_event failed ({exc}) — "
+                    f"set web.enabled=false or start wupbro at {self.endpoint}[/yellow]"
+                )
             return False
     async def send_regression(

{wup-0.2.26 → wup-0.2.28/wup.egg-info}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wup
-Version: 0.2.26
+Version: 0.2.28
 Summary: WUP (What's Up) - Intelligent file watcher for regression testing in large projects
 Author-email: Tom Sapletta <tom@sapletta.com>
 License-Expression: 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.26-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-$1.95-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-15.3h-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.28-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.27-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-16.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
-- 🤖 **LLM usage:** $1.9540 (36 commits)
-- 👤 **Human dev:** ~$1532 (15.3h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $2.2653 (38 commits)
+- 👤 **Human dev:** ~$1632 (16.3h @ $100/h, 30min dedup)
-Generated on 2026-05-16 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-05-17 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.26-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.28-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.
@@ -83,7 +83,7 @@ wup assistant --quick --template fastapi
 # 3. Build dependency map (one-time setup)
 wup map-deps ./my-project
-# 4. Start watching for changes
+# 4. Start watching (TestQL + live probes every 60s by default)
 wup watch ./my-project
 # 5. Start with live dashboard
@@ -110,14 +110,18 @@ wup map-deps ./my-project --output my-deps.json
 ### Watch Project
 ```bash
-# Basic watching (uses wup.yaml if present)
+# Basic watching: TestQL mode + live HTTP probes every 60s (uses wup.yaml if present)
 wup watch ./my-project
+# Legacy HTTP-only watcher (no TestQL, no periodic probes unless configured)
+wup watch ./my-project --mode default --probe-interval 0
 # With custom settings
 wup watch ./my-project \
   --cpu-throttle 0.5 \
   --debounce 3 \
-  --cooldown 600
+  --cooldown 600 \
+  --probe-interval 120
 # With live dashboard
 wup watch ./my-project --dashboard
@@ -125,9 +129,6 @@ wup watch ./my-project --dashboard
 # Use specific config file
 wup watch ./my-project --config custom-config.yaml
-# TestQL mode
-wup watch ./my-project --mode testql
 # Discover endpoints from TestQL scenarios
 wup testql-endpoints /path/to/scenarios --output testql-deps.json
 ```