feat(wup): add on-change status gate

Author: tom-sapletta-com

.planfile/sprints/current.yaml

@@ -612,23 +612,68 @@ sprint:
 
 
         Role: intelligent file watcher (3-layer: detect → quick → full).'
+      execution:
+        assigned_to: codex
+        attempt: 0
+        finished_at: '2026-05-14T11:15:42.775900Z'
+        max_attempts: 1
+        queue: default
+        started_at: '2026-05-14T11:15:41.961161Z'
+        state: done
       files: []
-      history: []
+      history:
+      - action: update
+        changes:
+        - execution
+        - status
+        execution_state: running
+        previous_execution_state: null
+        previous_status: open
+        source: planfile.store
+        status: in_progress
+        timestamp: '2026-05-14T11:15:42.112255+00:00'
+      - action: update
+        changes:
+        - execution
+        - outputs
+        - status
+        execution_state: done
+        previous_execution_state: running
+        previous_status: in_progress
+        source: planfile.store
+        status: done
+        timestamp: '2026-05-14T11:15:42.927604+00:00'
       id: STARTER-004
       labels:
       - bootstrap
       - gates
       - scan
       name: Bootstrap wup on-change gate
+      outputs:
+        artifacts:
+        - wup.yaml
+        - Taskfile.yml
+        - docs/llm-tools/wup/README.md
+        - tests/test_wup_taskfile.py
+        notes:
+        - wup.yaml already existed; added a topology-aware quality:wup task that validates
+          the on-change watcher with wup status, documented the WUP loop, and added
+          regression coverage for Taskfile wiring and root config.
+        result:
+          status: done
+          tests:
+          - uv run pytest -q tests/test_wup_taskfile.py
+          - task quality:wup
+          - git diff --check
       priority: normal
       source:
         context: {}
         timestamp: '2026-05-12T09:35:46.467501Z'
         tool: koru-scan
       sprint: current
-      status: open
+      status: done
       sync: {}
-      updated_at: '2026-05-12T09:35:46.468376Z'
+      updated_at: '2026-05-14T11:15:42.927572+00:00'
     STARTER-005:
       acceptance_criteria: []
       blocked_by: []

Taskfile.yml

@@ -268,6 +268,27 @@ tasks:
       - sh: which regix
         msg: "regix not installed. Run: task install:tools"
 
+  quality:wup:
+    desc: Check WUP on-change watcher configuration
+    cmds:
+      - |
+        set -euo pipefail
+        if python3 -m koru.cli topology --project . --is-enabled gate:wup >/dev/null 2>&1; then
+          wup status
+        else
+          rc=$?
+          if [ "$rc" -eq 1 ]; then
+            echo "quality:wup skipped (gate:wup disabled in topology)"
+            exit 0
+          fi
+          wup status
+        fi
+    preconditions:
+      - sh: which wup
+        msg: "wup not installed. Run: task install:tools"
+      - sh: test -f wup.yaml
+        msg: "wup.yaml missing. Run: task template:install:wup"
+
   quality:redup:
     desc: 'Run redup duplicate detection (default: current dir)'
     cmds:

docs/README.md

@@ -82,6 +82,7 @@ planfile ticket show PLF-XXX
 # ...
 
 # Validate locally (no LLM API calls)
+task quality:wup
 task quality:regix:local
 task test
 task monitor:probe

docs/llm-tools/README.md

@@ -45,6 +45,7 @@ SPECIALIZED (LLM-free):
 
 ON-CHANGE GATES TRIAD (LLM-free, continuous):
   wup       [intelligent file watcher → priority/full testql probes]
+            task quality:wup checks watcher config; wup watch runs the loop
   + regix     (delta gate, see WALIDACJA above)
   + testql    (HTTP probe, see WYKRYWANIE above)
   → koru brief surfaces all three in "On-change gates" section

docs/llm-tools/wup/README.md

@@ -0,0 +1,32 @@
+# WUP on-change gate
+
+`wup` is the local file watcher in the on-change gate triad. In koru it is
+configured by [`../../../wup.yaml`](../../../wup.yaml) and is meant for the
+developer loop between saving files and committing changes.
+
+## Commands
+
+| Scenario | Command |
+|---|---|
+| Check config/status | `task quality:wup` |
+| Direct status check | `wup status` |
+| Start watcher | `wup watch` |
+| Rebuild dependency map | `wup map-deps` |
+| Inspect TestQL endpoints | `wup testql-endpoints` |
+
+## Koru bootstrap
+
+The root `wup.yaml` watches:
+
+- `src/**` for core Python changes
+- `plugins/koru-autopilot-vscode/src/**` for autopilot plugin changes
+
+The lightweight `task quality:wup` gate validates that `wup` is installed,
+`wup.yaml` exists, `gate:wup` is enabled in topology, and `wup status` can read
+the configuration. It does not start the long-running watcher.
+
+Use `wup watch` when you want the continuous 3-layer loop:
+
+1. detect file changes
+2. run quick related probes
+3. run full detail/blame checks only after quick failures

tests/test_wup_taskfile.py

@@ -0,0 +1,26 @@
+"""Regression tests for WUP on-change gate task wiring."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def test_quality_wup_checks_status_and_respects_topology_gate() -> None:
+    taskfile = (ROOT / "Taskfile.yml").read_text(encoding="utf-8")
+
+    assert "quality:wup:" in taskfile
+    assert "gate:wup" in taskfile
+    assert "wup status" in taskfile
+    assert "test -f wup.yaml" in taskfile
+
+
+def test_wup_yaml_is_bootstrapped_for_koru_project() -> None:
+    wup_yaml = (ROOT / "wup.yaml").read_text(encoding="utf-8")
+
+    assert 'name: "koru"' in wup_yaml
+    assert "src/**" in wup_yaml
+    assert "plugins/koru-autopilot-vscode/src/**" in wup_yaml
+    assert "debounce_s: 2" in wup_yaml