wup 0.2.79__tar.gz → 0.2.81__tar.gz

{wup-0.2.79 → wup-0.2.81}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wup
-Version: 0.2.79
+Version: 0.2.81
 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
@@ -47,17 +47,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.79-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-$7.70-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-54.6h-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.81-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-$7.74-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-55.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.6978 (109 commits)
-- 👤 **Human dev:** ~$5461 (54.6h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.7367 (112 commits)
+- 👤 **Human dev:** ~$5566 (55.7h @ $100/h, 30min dedup)
 
-Generated on 2026-07-29 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-08-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.79-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.81-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.
 
@@ -157,6 +157,13 @@ wup testql-endpoints /path/to/scenarios --output testql-deps.json
 Pass several project roots to watch them all at once in a single process. Each
 project keeps its own `wup.yaml`, dependency map, file observer and test queue.
 
+When the current directory is a workspace containing projects in immediate
+subfolders, plain `wup watch .` auto-detects their common source directories,
+for example `api/src`, `worker/services` and `frontend/app`. This also repairs
+the runtime behaviour of older auto-generated configs that still point only to
+missing root-level `app`, `src` and `routes` directories. The config file is not
+rewritten by this fallback.
+
 ```bash
 # Watch several projects at the same time
 wup watch ./service-a ./service-b ./service-c
@@ -176,6 +183,50 @@ path is resolved per project, so each project uses its own `deps.json`.
 > The live `--dashboard` and single `--config` options apply to single-project
 > runs only; when watching multiple projects each uses its own `wup.yaml`.
 
+### Continuous Intent Monitoring with todo2code
+
+WUP can run todo2code on startup, periodically and after debounced source-file
+changes. Diagnostics are projected into the regular service-health stream as
+`<project>:intent`: blocking findings produce `down`, review-required findings
+produce `degraded`, and a clean audit produces `up`.
+
+The integration is opt-in and deterministic by default, so merely installing
+WUP never starts paid LLM requests:
+
+```yaml
+intent_monitoring:
+  enabled: true
+  runner: cli
+  command:
+    - node
+    - /path/to/todo2code/dist/src/cli.js
+  interval_s: 300
+  debounce_s: 10
+  run_on_start: true
+  run_on_change: true
+  mode: deterministic
+  task_file: TASK.md
+  todo_file: TODO.md
+  changelog_file: CHANGELOG.md
+  docs:
+    - README.md
+    - docs/**/*.md
+  output_dir: .wup/intent
+  fail_severities:
+    - blocking
+    - review_required
+```
+
+Set `runner: python` to use the dependency-free `todo2code-sdk` bridge. Install
+it from todo2code's `sdk/python` directory and set `cli_path` to the built
+`dist/src/cli.js`. The Python package still delegates semantic processing to
+the canonical Node/TypeScript runtime.
+
+`mode: prefer-llm` or `mode: require-llm` enables LLM enrichment for NL and
+TODO/CHANGELOG. Documentation and final-summary LLM calls remain separately
+controlled by `docs_llm` and `summary_llm`. Use these modes deliberately: an
+audit may run after every debounce interval and therefore incur provider cost.
+
 ### Initialize Configuration
 
 ```bash
@@ -294,6 +345,8 @@ 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
+- **Detected watch paths**: Existing common source directories at the project
+  root and one level below it
 
 Example `wup.yaml`:
 

{wup-0.2.79 → wup-0.2.81}/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.79-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-$7.70-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-54.6h-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.81-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-$7.74-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-55.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.6978 (109 commits)
-- 👤 **Human dev:** ~$5461 (54.6h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.7367 (112 commits)
+- 👤 **Human dev:** ~$5566 (55.7h @ $100/h, 30min dedup)
 
-Generated on 2026-07-29 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-08-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.79-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.81-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.
 
@@ -113,6 +113,13 @@ wup testql-endpoints /path/to/scenarios --output testql-deps.json
 Pass several project roots to watch them all at once in a single process. Each
 project keeps its own `wup.yaml`, dependency map, file observer and test queue.
 
+When the current directory is a workspace containing projects in immediate
+subfolders, plain `wup watch .` auto-detects their common source directories,
+for example `api/src`, `worker/services` and `frontend/app`. This also repairs
+the runtime behaviour of older auto-generated configs that still point only to
+missing root-level `app`, `src` and `routes` directories. The config file is not
+rewritten by this fallback.
+
 ```bash
 # Watch several projects at the same time
 wup watch ./service-a ./service-b ./service-c
@@ -132,6 +139,50 @@ path is resolved per project, so each project uses its own `deps.json`.
 > The live `--dashboard` and single `--config` options apply to single-project
 > runs only; when watching multiple projects each uses its own `wup.yaml`.
 
+### Continuous Intent Monitoring with todo2code
+
+WUP can run todo2code on startup, periodically and after debounced source-file
+changes. Diagnostics are projected into the regular service-health stream as
+`<project>:intent`: blocking findings produce `down`, review-required findings
+produce `degraded`, and a clean audit produces `up`.
+
+The integration is opt-in and deterministic by default, so merely installing
+WUP never starts paid LLM requests:
+
+```yaml
+intent_monitoring:
+  enabled: true
+  runner: cli
+  command:
+    - node
+    - /path/to/todo2code/dist/src/cli.js
+  interval_s: 300
+  debounce_s: 10
+  run_on_start: true
+  run_on_change: true
+  mode: deterministic
+  task_file: TASK.md
+  todo_file: TODO.md
+  changelog_file: CHANGELOG.md
+  docs:
+    - README.md
+    - docs/**/*.md
+  output_dir: .wup/intent
+  fail_severities:
+    - blocking
+    - review_required
+```
+
+Set `runner: python` to use the dependency-free `todo2code-sdk` bridge. Install
+it from todo2code's `sdk/python` directory and set `cli_path` to the built
+`dist/src/cli.js`. The Python package still delegates semantic processing to
+the canonical Node/TypeScript runtime.
+
+`mode: prefer-llm` or `mode: require-llm` enables LLM enrichment for NL and
+TODO/CHANGELOG. Documentation and final-summary LLM calls remain separately
+controlled by `docs_llm` and `summary_llm`. Use these modes deliberately: an
+audit may run after every debounce interval and therefore incur provider cost.
+
 ### Initialize Configuration
 
 ```bash
@@ -250,6 +301,8 @@ 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
+- **Detected watch paths**: Existing common source directories at the project
+  root and one level below it
 
 Example `wup.yaml`:
 

{wup-0.2.79 → wup-0.2.81}/pyproject.toml

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

wup-0.2.81/tests/test_intent_monitor.py

@@ -0,0 +1,208 @@
+"""Tests for continuous todo2code Intent-vs-Reality monitoring."""
+
+from __future__ import annotations
+
+import json
+import sys
+import types
+from pathlib import Path
+from types import SimpleNamespace
+
+from wup.config import load_config, save_config
+from wup.intent_monitor import IntentAuditResult, Todo2CodeIntentMonitor
+from wup.models.config import IntentMonitoringConfig, ProjectConfig, WupConfig
+from wup.testql_watcher import TestQLWatcher
+
+
+def _diagnostics(tmp_path: Path, items: list[dict]) -> Path:
+    path = tmp_path / "diagnostics.json"
+    path.write_text(json.dumps({"diagnostics": items}), encoding="utf-8")
+    return path
+
+
+def test_config_round_trip_preserves_intent_monitoring(tmp_path: Path) -> None:
+    config = WupConfig(
+        project=ProjectConfig(name="demo"),
+        intent_monitoring=IntentMonitoringConfig(
+            enabled=True,
+            runner="python",
+            cli_path="/opt/todo2code/dist/src/cli.js",
+            interval_s=120,
+            mode="require-llm",
+            docs_llm=True,
+            fail_codes=["PLANNED_NOT_IMPLEMENTED"],
+        ),
+    )
+    save_config(config, tmp_path / "wup.yaml")
+
+    loaded = load_config(tmp_path)
+
+    assert loaded.intent_monitoring.enabled is True
+    assert loaded.intent_monitoring.runner == "python"
+    assert loaded.intent_monitoring.interval_s == 120
+    assert loaded.intent_monitoring.mode == "require-llm"
+    assert loaded.intent_monitoring.docs_llm is True
+    assert loaded.intent_monitoring.fail_codes == ["PLANNED_NOT_IMPLEMENTED"]
+
+
+def test_cli_monitor_maps_blocking_diagnostics_to_down(tmp_path: Path, monkeypatch) -> None:
+    path = _diagnostics(
+        tmp_path,
+        [{"severity": "blocking", "code": "PLANNED_NOT_IMPLEMENTED"}],
+    )
+    calls = []
+
+    def fake_run(command, **kwargs):
+        calls.append((command, kwargs))
+        payload = {"diagnosticsPath": str(path), "runDirectory": str(tmp_path / "run")}
+        return SimpleNamespace(returncode=0, stdout=json.dumps(payload), stderr="")
+
+    monkeypatch.setattr("wup.intent_monitor.subprocess.run", fake_run)
+    results = []
+    config = IntentMonitoringConfig(
+        enabled=True,
+        command=["node", "/opt/todo2code/cli.js"],
+        mode="deterministic",
+    )
+    monitor = Todo2CodeIntentMonitor(tmp_path, config, results.append)
+
+    result = monitor.run_once()
+
+    assert result.status == "down"
+    assert len(result.diagnostics) == 1
+    assert results == [result]
+    command, kwargs = calls[0]
+    assert command[:3] == ["node", "/opt/todo2code/cli.js", "pipeline"]
+    assert "--no-docs-llm" in command
+    assert "--no-summary-llm" in command
+    assert kwargs.get("shell", False) is False
+
+
+def test_cli_monitor_resolves_single_javascript_launcher(tmp_path: Path, monkeypatch) -> None:
+    path = _diagnostics(tmp_path, [])
+    cli_path = tmp_path / "cli.js"
+    cli_path.write_text("", encoding="utf-8")
+    observed = {}
+
+    monkeypatch.setattr("wup.intent_monitor.shutil.which", lambda command: str(cli_path))
+
+    def fake_run(command, **kwargs):
+        observed["command"] = command
+        return SimpleNamespace(
+            returncode=0,
+            stdout=json.dumps({"diagnosticsPath": str(path)}),
+            stderr="",
+        )
+
+    monkeypatch.setattr("wup.intent_monitor.subprocess.run", fake_run)
+    monitor = Todo2CodeIntentMonitor(
+        tmp_path,
+        IntentMonitoringConfig(enabled=True, command=["t2c"]),
+        lambda result: None,
+    )
+
+    result = monitor.run_once()
+
+    assert result.status == "up"
+    assert observed["command"][:2] == ["node", str(cli_path.resolve())]
+
+
+def test_monitor_filters_codes_and_maps_review_required_to_degraded(tmp_path: Path) -> None:
+    path = _diagnostics(
+        tmp_path,
+        [
+            {"severity": "review_required", "code": "CHANGELOG_WITHOUT_IMPLEMENTATION"},
+            {"severity": "blocking", "code": "UNRELATED"},
+        ],
+    )
+    config = IntentMonitoringConfig(
+        fail_codes=["CHANGELOG_WITHOUT_IMPLEMENTATION"]
+    )
+    monitor = Todo2CodeIntentMonitor(tmp_path, config, lambda result: None)
+
+    result = monitor._result_from_payload({"diagnosticsPath": str(path)})
+
+    assert result.status == "degraded"
+    assert [item["code"] for item in result.diagnostics] == [
+        "CHANGELOG_WITHOUT_IMPLEMENTATION"
+    ]
+
+
+def test_monitor_reports_runner_failure_as_down(tmp_path: Path, monkeypatch) -> None:
+    monkeypatch.setattr(
+        "wup.intent_monitor.subprocess.run",
+        lambda *args, **kwargs: SimpleNamespace(
+            returncode=2, stdout="", stderr="structured output invalid"
+        ),
+    )
+    results = []
+    monitor = Todo2CodeIntentMonitor(
+        tmp_path, IntentMonitoringConfig(enabled=True), results.append
+    )
+
+    result = monitor.run_once()
+
+    assert result.status == "down"
+    assert "structured output invalid" in result.message
+    assert results == [result]
+
+
+def test_python_runner_uses_todo2code_sdk_bridge(tmp_path: Path, monkeypatch) -> None:
+    path = _diagnostics(tmp_path, [])
+    observed = {}
+
+    class FakeRuntime:
+        def __init__(self, root, **kwargs):
+            observed["root"] = root
+            observed["init"] = kwargs
+
+        def invoke(self, arguments):
+            observed["arguments"] = arguments
+            payload = {"diagnosticsPath": str(path), "runDirectory": "python-run"}
+            return SimpleNamespace(stdout=json.dumps(payload))
+
+    module = types.ModuleType("todo2code")
+    module.TypeScriptRuntime = FakeRuntime
+    monkeypatch.setitem(sys.modules, "todo2code", module)
+    config = IntentMonitoringConfig(
+        enabled=True,
+        runner="python",
+        cli_path="/opt/todo2code/dist/src/cli.js",
+        mode="prefer-llm",
+        docs_llm=True,
+    )
+    monitor = Todo2CodeIntentMonitor(tmp_path, config, lambda result: None)
+
+    result = monitor.run_once()
+
+    assert result.status == "up"
+    assert observed["root"] == tmp_path.resolve()
+    assert observed["init"]["cli_path"] == config.cli_path
+    assert observed["arguments"][:2] == ["pipeline", str(tmp_path.resolve())]
+    assert observed["arguments"][observed["arguments"].index("--markdown-mode") + 1] == "prefer-llm"
+    assert "--no-docs-llm" not in observed["arguments"]
+    assert "--no-communication" in observed["arguments"]
+
+
+def test_testql_watcher_projects_intent_result_as_project_health() -> None:
+    watcher = object.__new__(TestQLWatcher)
+    watcher.config = SimpleNamespace(project=SimpleNamespace(name="workspace"))
+    transitions = []
+    watcher._record_health_transition = lambda **values: transitions.append(values)
+    result = IntentAuditResult(
+        status="down",
+        message="todo2code found 3 intent issue(s), 1 blocking",
+        diagnostics_path="/tmp/diagnostics.json",
+    )
+
+    watcher._record_intent_audit(result)
+
+    assert transitions == [
+        {
+            "service": "workspace:intent",
+            "status": "down",
+            "stage": "intent",
+            "message": result.message,
+            "track_file": result.diagnostics_path,
+        }
+    ]

{wup-0.2.79 → wup-0.2.81}/tests/test_multi_project.py

@@ -58,6 +58,29 @@ def test_detect_watch_paths_backend_frontend(tmp_path: Path) -> None:
     assert "app/**" not in paths
 
 
+def test_detect_watch_paths_finds_source_dirs_in_project_subfolders(
+    tmp_path: Path,
+) -> None:
+    (tmp_path / "api" / "src").mkdir(parents=True)
+    (tmp_path / "worker" / "services").mkdir(parents=True)
+
+    assert detect_watch_paths(tmp_path) == ["api/src/**", "worker/services/**"]
+
+
+def test_detect_watch_paths_combines_root_and_project_subfolders(tmp_path: Path) -> None:
+    (tmp_path / "src").mkdir()
+    (tmp_path / "worker" / "src").mkdir(parents=True)
+
+    assert detect_watch_paths(tmp_path) == ["src/**", "worker/src/**"]
+
+
+def test_detect_watch_paths_skips_nested_vendor_and_hidden_dirs(tmp_path: Path) -> None:
+    (tmp_path / "node_modules" / "package" / "src").mkdir(parents=True)
+    (tmp_path / ".cache" / "src").mkdir(parents=True)
+
+    assert detect_watch_paths(tmp_path) == ["app/**", "src/**", "routes/**"]
+
+
 def test_default_config_watches_only_real_dirs(tmp_path: Path) -> None:
     (tmp_path / "services").mkdir()
     cfg = get_default_config(tmp_path)
@@ -122,6 +145,25 @@ def test_prepare_observer_none_when_no_valid_paths(tmp_path: Path) -> None:
     assert watcher.prepare_observer() is None
 
 
+def test_watcher_falls_back_to_source_dirs_in_project_subfolders(
+    tmp_path: Path,
+) -> None:
+    nested_src = tmp_path / "api" / "src"
+    nested_services = tmp_path / "worker" / "services"
+    nested_src.mkdir(parents=True)
+    nested_services.mkdir(parents=True)
+    watcher = _watcher(tmp_path, paths=["app/**", "src/**", "routes/**"])
+
+    assert watcher.build_watched_paths() == [str(nested_src), str(nested_services)]
+
+
+def test_watcher_does_not_replace_invalid_custom_paths(tmp_path: Path) -> None:
+    (tmp_path / "src").mkdir()
+    watcher = _watcher(tmp_path, paths=["misspelled-source/**"])
+
+    assert watcher.build_watched_paths() == []
+
+
 def test_multi_watcher_returns_false_when_all_invalid(tmp_path: Path) -> None:
     w1 = _watcher(tmp_path, paths=["missing-a/**"])
     w2 = _watcher(tmp_path, paths=["missing-b/**"])

{wup-0.2.79 → wup-0.2.81}/tests/test_planfile_reporter_dedupe.py

@@ -35,6 +35,13 @@ def _seed_dedupe(rep: PlanfileReporter, fingerprint_kwargs: dict, ticket_id: str
 FAIL = {"service": "svc", "status": "down", "stage": "probe", "message": "connection refused"}
 
 
+def test_parse_ticket_id_supports_project_specific_prefixes(tmp_path):
+    rep = _reporter(tmp_path)
+
+    assert rep._parse_ticket_id("✓ Created STARTER-074: intent failure") == "STARTER-074"
+    assert rep._parse_ticket_id("Created PLF-2") == "PLF-2"
+
+
 def test_open_ticket_still_mutes_recurrence(tmp_path, monkeypatch):
     rep = _reporter(tmp_path)
     _seed_dedupe(rep, FAIL, "PLF-1")

{wup-0.2.79 → wup-0.2.81}/tests/test_testql_watcher.py

@@ -253,8 +253,11 @@ def test_planfile_reporter_creates_deduped_ticket(monkeypatch):
         assert calls[0][:3] == ["planfile", "ticket", "create"]
         assert "--label" in calls[0]
         assert "llm-ready" in calls[0]
-        assert "--files" in calls[0]
-        assert ".wup/tracks/one.json" in calls[0]
+        # Runtime evidence remains linked in the description but must not
+        # become Koru's source-edit scope in Planfile ``files``.
+        assert "--files" not in calls[0]
+        description = calls[0][calls[0].index("--description") + 1]
+        assert ".wup/tracks/one.json" in description
 
 
 def test_planfile_reporter_clears_dedupe_after_recovery(monkeypatch):
@@ -307,7 +310,7 @@ def test_planfile_reporter_retries_without_files_for_old_planfile_cli(monkeypatc
             status="failed",
             stage="detail",
             message="detail failed",
-            track_file=".wup/tracks/firmware_detail.json",
+            track_file="src/firmware.py",
         )
 
         assert ticket_id == "PLF-998"

{wup-0.2.79 → wup-0.2.81}/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.79"
+__version__ = "0.2.81"
 __author__ = "Tom Sapletta"
 
 from .config import load_config, save_config, get_default_config

{wup-0.2.79 → wup-0.2.81}/wup/config.py

@@ -13,6 +13,7 @@ import yaml
 
 from .models.config import (
     AnomalyDetectionConfig,
+    IntentMonitoringConfig,
     NotifyConfig,
     PlanfileConfig,
     ProjectConfig,
@@ -438,6 +439,52 @@ def _parse_semcod_tools_config(raw: dict) -> SemcodToolsConfig:
     )
 
 
+def _parse_intent_monitoring_config(raw: dict) -> IntentMonitoringConfig:
+    intent_raw = raw.get("intent_monitoring", {})
+    if not isinstance(intent_raw, dict):
+        return IntentMonitoringConfig()
+
+    defaults = IntentMonitoringConfig()
+    command_raw = intent_raw.get("command", defaults.command)
+    if isinstance(command_raw, str):
+        command = [command_raw]
+    elif isinstance(command_raw, list):
+        command = [str(part) for part in command_raw if str(part)]
+    else:
+        command = defaults.command
+
+    docs_raw = intent_raw.get("docs", defaults.docs)
+    severities_raw = intent_raw.get("fail_severities", defaults.fail_severities)
+    codes_raw = intent_raw.get("fail_codes", defaults.fail_codes)
+    return IntentMonitoringConfig(
+        enabled=bool(intent_raw.get("enabled", defaults.enabled)),
+        runner=str(intent_raw.get("runner", defaults.runner)),
+        command=command or defaults.command,
+        cli_path=str(intent_raw.get("cli_path", defaults.cli_path)),
+        interval_s=max(0, int(intent_raw.get("interval_s", defaults.interval_s))),
+        debounce_s=max(0, int(intent_raw.get("debounce_s", defaults.debounce_s))),
+        timeout_s=max(1, int(intent_raw.get("timeout_s", defaults.timeout_s))),
+        run_on_start=bool(intent_raw.get("run_on_start", defaults.run_on_start)),
+        run_on_change=bool(intent_raw.get("run_on_change", defaults.run_on_change)),
+        mode=str(intent_raw.get("mode", defaults.mode)),
+        docs_llm=bool(intent_raw.get("docs_llm", defaults.docs_llm)),
+        summary_llm=bool(intent_raw.get("summary_llm", defaults.summary_llm)),
+        task_file=str(intent_raw.get("task_file", defaults.task_file)),
+        todo_file=str(intent_raw.get("todo_file", defaults.todo_file)),
+        changelog_file=str(intent_raw.get("changelog_file", defaults.changelog_file)),
+        docs=[str(item) for item in docs_raw]
+        if isinstance(docs_raw, list)
+        else defaults.docs,
+        output_dir=str(intent_raw.get("output_dir", defaults.output_dir)),
+        fail_severities=[str(item) for item in severities_raw]
+        if isinstance(severities_raw, list)
+        else defaults.fail_severities,
+        fail_codes=[str(item) for item in codes_raw]
+        if isinstance(codes_raw, list)
+        else defaults.fail_codes,
+    )
+
+
 def validate_config(
     raw: dict, *, environ: Mapping[str, str] | None = None
 ) -> WupConfig:
@@ -465,6 +512,7 @@ def validate_config(
         planfile=_parse_planfile_config(raw, effective_environ),
         anomaly_detection=_parse_anomaly_detection_config(raw),
         semcod_tools=_parse_semcod_tools_config(raw),
+        intent_monitoring=_parse_intent_monitoring_config(raw),
     )
 
 
@@ -485,18 +533,52 @@ _DEFAULT_SOURCE_DIRS = [
     "cmd",
 ]
 
+_WATCH_DISCOVERY_SKIP_DIRS = {
+    ".git",
+    ".venv",
+    "venv",
+    "node_modules",
+    "__pycache__",
+    "dist",
+    "build",
+}
+
 
 def detect_watch_paths(project_root: Path) -> list:
     """
     Pick watch-path globs for a project by probing for common source directories.
 
     Returns ``["<dir>/**", ...]`` for every well-known source directory that
-    exists under ``project_root``. Falls back to the classic app/src/routes
-    guess only when none are found, so a brand-new project still gets a config.
+    exists directly under ``project_root``. For a directory containing several
+    projects, the same probe is also performed one level down (for example,
+    ``api/src/**`` and ``worker/app/**``). Hidden and vendor/build directories
+    are skipped. Falls back to the classic app/src/routes guess only when none
+    are found, so a brand-new project still gets a config.
     """
     found = [
         f"{name}/**" for name in _DEFAULT_SOURCE_DIRS if (project_root / name).is_dir()
     ]
+
+    # A common workspace layout is ``root/project/src``.  WUP used to only
+    # inspect ``root/src``, producing an unusable app/src/routes config for such
+    # workspaces. Limit discovery to one project level so we do not accidentally
+    # select vendored source trees deep inside dependencies.
+    try:
+        children = sorted(project_root.iterdir(), key=lambda path: path.name)
+    except OSError:
+        children = []
+
+    for child in children:
+        if (
+            not child.is_dir()
+            or child.name.startswith(".")
+            or child.name in _WATCH_DISCOVERY_SKIP_DIRS
+        ):
+            continue
+        for name in _DEFAULT_SOURCE_DIRS:
+            if (child / name).is_dir():
+                found.append(f"{child.name}/{name}/**")
+
     return found or ["app/**", "src/**", "routes/**"]