wup 0.2.82__tar.gz → 0.2.83__tar.gz

{wup-0.2.82 → wup-0.2.83}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wup
-Version: 0.2.82
+Version: 0.2.83
 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
@@ -25,9 +25,9 @@ Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=5.0; extra == "dev"
 Requires-Dist: ruff>=0.8; extra == "dev"
-Requires-Dist: goal>=2.1.0; extra == "dev"
+Requires-Dist: goal>=2.1.0; python_version >= "3.12" and extra == "dev"
 Requires-Dist: costs>=0.1.20; extra == "dev"
-Requires-Dist: pfix>=0.1.60; extra == "dev"
+Requires-Dist: pfix>=0.1.60; python_version >= "3.10" and extra == "dev"
 Requires-Dist: uri2wup; extra == "dev"
 Requires-Dist: dsl2wup; extra == "dev"
 Requires-Dist: nlp2wup; extra == "dev"
@@ -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.82-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.59-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-57.8h-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.83-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-$6.83-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-63.8h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5884 (114 commits)
-- 👤 **Human dev:** ~$5778 (57.8h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $6.8315 (120 commits)
+- 👤 **Human dev:** ~$6379 (63.8h @ $100/h, 30min dedup)
 
-Generated on 2026-08-01 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-09-11 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.82-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.83-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.
 

{wup-0.2.82 → wup-0.2.83}/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.82-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.59-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-57.8h-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.83-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-$6.83-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-63.8h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5884 (114 commits)
-- 👤 **Human dev:** ~$5778 (57.8h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $6.8315 (120 commits)
+- 👤 **Human dev:** ~$6379 (63.8h @ $100/h, 30min dedup)
 
-Generated on 2026-08-01 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-09-11 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.82-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.83-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.
 

{wup-0.2.82 → wup-0.2.83}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "wup"
-version = "0.2.82"
+version = "0.2.83"
 description = "WUP (What's Up) - Intelligent file watcher for regression testing in large projects"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -34,9 +34,9 @@ dev = [
     "pytest>=7.0.0",
     "pytest-cov>=5.0",
     "ruff>=0.8",
-    "goal>=2.1.0",
+    "goal>=2.1.0; python_version >= '3.12'",
     "costs>=0.1.20",
-    "pfix>=0.1.60",
+    "pfix>=0.1.60; python_version >= '3.10'",
     "uri2wup",
     "dsl2wup",
     "nlp2wup",

{wup-0.2.82 → wup-0.2.83}/tests/test_control.py

@@ -13,6 +13,8 @@ def test_dispatch_validate_shim(tmp_path: Path) -> None:
         "project:\n  name: demo\n  description: test\nwatch:\n  paths: []\nservices: []\n",
         encoding="utf-8",
     )
-    result = dispatch_validate(str(config), project=str(tmp_path))
+    result = dispatch_validate(
+        str(config), project=str(tmp_path), default_file=str(tmp_path / "app.doql.less")
+    )
     assert "ok" in result
     assert result["action"] == "validate"

{wup-0.2.82 → wup-0.2.83}/tests/test_endpoints_init_cli.py

@@ -38,7 +38,10 @@ def test_discover_testql_endpoints(tmp_path: Path) -> None:
 def test_endpoints_via_bus(tmp_path: Path) -> None:
     scen = tmp_path / "scenarios"
     _write_scenario(scen)
-    result = dispatch(f"ENDPOINTS {scen} OUT {tmp_path / 'out.json'}")
+    result = dispatch(
+        f"ENDPOINTS {scen} OUT {tmp_path / 'out.json'}",
+        default_file=str(tmp_path / "app.doql.less"),
+    )
     assert result.ok
     assert (tmp_path / "out.json").exists()
 
@@ -50,7 +53,10 @@ def test_init_cli_via_bus(tmp_path: Path) -> None:
     )
     (tmp_path / "demo").mkdir()
     (tmp_path / "demo" / "__init__.py").write_text("def main(): pass\n", encoding="utf-8")
-    result = dispatch(f"INIT_CLI {tmp_path} OUT wup.yaml SCENARIOS testql-scenarios")
+    result = dispatch(
+        f"INIT_CLI {tmp_path} OUT wup.yaml SCENARIOS testql-scenarios",
+        default_file=str(tmp_path / "app.doql.less"),
+    )
     assert result.ok
     assert (tmp_path / "wup.yaml").exists()
     assert (tmp_path / "testql-scenarios").is_dir()

wup-0.2.83/tests/test_realtime_anomalies.py

@@ -0,0 +1,214 @@
+"""Tests for realtime anomaly helpers and their integration in the watch loop."""
+
+import tempfile
+from pathlib import Path
+
+from wup.config import WupConfig, ProjectConfig, WatchConfig, ServiceConfig, ServiceTestConfig, TestStrategyConfig, TestQLConfig
+from wup.core import WupWatcher
+from wup.realtime_anomalies import BurstAnomaly, ChangeBurstDetector, LatencyTracker
+
+
+class TestLatencyTracker:
+    def test_no_anomaly_below_min_samples(self):
+        tracker = LatencyTracker()
+        for _ in range(7):
+            assert tracker.record("/ep", 10.0) is None
+
+    def test_flags_spike_over_baseline(self):
+        tracker = LatencyTracker(
+            min_samples=5,
+            ratio_threshold=3.0,
+            absolute_floor_ms=50.0,
+            confirm_samples=1,
+        )
+        for _ in range(5):
+            tracker.record("/ep", 20.0)
+        anomaly = tracker.record("/ep", 200.0)
+        assert anomaly is not None
+        assert anomaly.endpoint == "/ep"
+        assert anomaly.ratio >= 3.0
+
+    def test_no_flag_when_latency_below_absolute_floor(self):
+        tracker = LatencyTracker(min_samples=5, ratio_threshold=3.0, absolute_floor_ms=50.0)
+        for _ in range(5):
+            tracker.record("/ep", 5.0)
+        # ratio is huge but latency (15ms) is under the 50ms floor
+        assert tracker.record("/ep", 15.0) is None
+
+    def test_no_ratio_flag_for_trivial_baseline_blip(self):
+        # Dev-host reality: idle endpoint at ~1 ms, ordinary load blip at
+        # 74 ms. Ratio is meaningless there and must not flag (PLF-2229).
+        tracker = LatencyTracker(min_samples=5, confirm_samples=1)
+        for _ in range(5):
+            tracker.record("/ep", 1.0)
+        assert tracker.record("/ep", 74.0) is None
+        assert tracker.record("/ep", 120.0) is None
+
+    def test_trivial_baseline_flags_on_sustained_absolute_slowness(self):
+        tracker = LatencyTracker(
+            min_samples=5,
+            baseline_floor_ms=10.0,
+            slow_absolute_ms=300.0,
+            confirm_samples=3,
+        )
+        for _ in range(5):
+            tracker.record("/ep", 1.0)
+        assert tracker.record("/ep", 800.0) is None
+        assert tracker.record("/ep", 800.0) is None
+        anomaly = tracker.record("/ep", 800.0)
+        assert anomaly is not None
+        assert anomaly.latency_ms == 800.0
+
+    def test_sustained_blip_below_slow_absolute_never_flags(self):
+        tracker = LatencyTracker(
+            min_samples=5,
+            baseline_floor_ms=10.0,
+            slow_absolute_ms=300.0,
+            confirm_samples=3,
+        )
+        for _ in range(5):
+            tracker.record("/ep", 2.0)
+        for _ in range(10):
+            assert tracker.record("/ep", 120.0) is None
+
+    def test_ratio_anomaly_needs_consecutive_confirmation(self):
+        tracker = LatencyTracker(
+            min_samples=5,
+            ratio_threshold=3.0,
+            absolute_floor_ms=50.0,
+            confirm_samples=3,
+        )
+        for _ in range(5):
+            tracker.record("/ep", 20.0)
+        assert tracker.record("/ep", 200.0) is None
+        # single fast sample resets the streak
+        assert tracker.record("/ep", 20.0) is None
+        assert tracker.record("/ep", 200.0) is None
+        assert tracker.record("/ep", 200.0) is None
+        anomaly = tracker.record("/ep", 200.0)
+        assert anomaly is not None
+        assert anomaly.ratio >= 3.0
+
+    def test_reports_once_per_episode_then_rearms(self):
+        tracker = LatencyTracker(
+            min_samples=5,
+            ratio_threshold=3.0,
+            absolute_floor_ms=50.0,
+            confirm_samples=2,
+        )
+        for _ in range(5):
+            tracker.record("/ep", 20.0)
+        assert tracker.record("/ep", 200.0) is None
+        first = tracker.record("/ep", 220.0)
+        assert first is not None
+        # sustained slowness: no further reports until latency recovers
+        assert tracker.record("/ep", 240.0) is None
+        assert tracker.record("/ep", 260.0) is None
+        # recovery re-arms the tracker
+        assert tracker.record("/ep", 20.0) is None
+        assert tracker.record("/ep", 200.0) is None
+        second = tracker.record("/ep", 200.0)
+        assert second is not None
+
+    def test_baseline_unlearned_until_min_samples(self):
+        tracker = LatencyTracker(min_samples=5)
+        assert tracker.baseline("/ep") is None
+        for _ in range(5):
+            tracker.record("/ep", 10.0)
+        assert tracker.baseline("/ep") == 10.0
+
+    def test_slow_endpoint_never_flagged_when_consistently_slow(self):
+        tracker = LatencyTracker(min_samples=5)
+        for _ in range(10):
+            assert tracker.record("/ep", 900.0) is None
+
+
+class TestChangeBurstDetector:
+    def test_no_burst_under_threshold(self):
+        detector = ChangeBurstDetector(burst_threshold=5, window_s=10.0)
+        for i in range(4):
+            assert detector.record("svc", now=100.0 + i) is None
+
+    def test_burst_reported_once_then_rearmed(self):
+        detector = ChangeBurstDetector(burst_threshold=5, window_s=10.0)
+        anomalies = [detector.record("svc", now=100.0 + i * 0.1) for i in range(6)]
+        # 5th event (index 4) crosses the threshold -> reported once
+        reported = [a for a in anomalies if a is not None]
+        assert len(reported) == 1
+        assert isinstance(reported[0], BurstAnomaly)
+        assert reported[0].service == "svc"
+        assert reported[0].events == 5
+        # detector re-armed: next few events within window report nothing
+        for i in range(3):
+            assert detector.record("svc", now=100.5 + i * 0.1) is None
+
+    def test_old_events_expire_out_of_window(self):
+        detector = ChangeBurstDetector(burst_threshold=5, window_s=10.0)
+        for _ in range(4):
+            detector.record("svc", now=100.0)
+        # long gap: window slides past previous events
+        assert detector.record("svc", now=200.0) is None
+
+
+class TestWatcherDebounce:
+    def _make_watcher(self, tmpdir, service="users"):
+        (Path(tmpdir) / "app" / service).mkdir(parents=True, exist_ok=True)
+        config = WupConfig(
+            project=ProjectConfig(name="test"),
+            watch=WatchConfig(paths=["app/**"]),
+            services=[ServiceConfig(
+                name=service,
+                root=f"app/{service}",
+                paths=[f"app/{service}/**"],
+                quick_tests=ServiceTestConfig(scope="all", max_endpoints=3),
+            )],
+            test_strategy=TestStrategyConfig(),
+            testql=TestQLConfig(),
+        )
+        watcher = WupWatcher(tmpdir, config=config)
+        watcher.dependency_mapper.service_to_endpoints[service] = ["/api/users"]
+        return watcher
+
+    def test_single_save_emits_one_quick_test(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            watcher = self._make_watcher(tmpdir)
+            file_path = str(Path(tmpdir) / "app" / "users" / "routes.py")
+            watcher.on_file_change(file_path)
+            watcher.on_file_change(file_path)  # cascade: same save, second event
+            watcher._pending_event_times["users"] = 0
+            watcher._flush_pending_events()
+            assert len(watcher.test_queue) == 1
+
+    def test_burst_event_storm_still_emits_one_test(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            watcher = self._make_watcher(tmpdir)
+            file_path = str(Path(tmpdir) / "app" / "users" / "routes.py")
+            for _ in range(150):
+                watcher.on_file_change(file_path)
+            watcher._pending_event_times["users"] = 0
+            watcher._flush_pending_events()
+            assert len(watcher.test_queue) == 1
+
+    def test_events_buffered_during_debounce_window(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            watcher = self._make_watcher(tmpdir)
+            file_path = str(Path(tmpdir) / "app" / "users" / "routes.py")
+            watcher.on_file_change(file_path)
+            # window not elapsed: nothing scheduled, event stays buffered
+            watcher._flush_pending_events()
+            assert len(watcher.test_queue) == 0
+            assert watcher._pending_events["users"]
+
+    def test_cooldown_prevents_rescheduling(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            watcher = self._make_watcher(tmpdir)
+            file_path = str(Path(tmpdir) / "app" / "users" / "routes.py")
+            watcher.on_file_change(file_path)
+            watcher._pending_event_times["users"] = 0
+            watcher._flush_pending_events()
+            assert len(watcher.test_queue) == 1
+            # immediately re-flush with fresh events: cooldown blocks a second test
+            watcher.on_file_change(file_path)
+            watcher._pending_event_times["users"] = 0
+            watcher._flush_pending_events()
+            assert len(watcher.test_queue) == 1

{wup-0.2.82 → wup-0.2.83}/tests/test_service_inference.py

@@ -202,8 +202,10 @@ def test_file_change_uses_configured_services_when_inference_fails():
         tested_services = []
         watcher.schedule_quick_test = lambda s: tested_services.append(s)
         
-        # Trigger file change
+        # Trigger file change (event debounced per service)
         watcher.on_file_change(str(test_file))
-        
+        watcher._pending_event_times["my-service"] = 0  # force window elapsed
+        watcher._flush_pending_events()
+
         # Should test the configured service even though inference failed
         assert "my-service" in tested_services

{wup-0.2.82 → wup-0.2.83}/tests/test_status_data.py

@@ -29,6 +29,9 @@ def test_status_via_bus(tmp_path: Path) -> None:
         "project:\n  name: demo\nwatch:\n  paths: []\nservices:\n  - name: api\n    type: web\n",
         encoding="utf-8",
     )
-    result = dispatch(f"STATUS PROJECT {tmp_path} FILE wup.yaml")
+    result = dispatch(
+        f"STATUS PROJECT {tmp_path} FILE wup.yaml",
+        default_file=str(tmp_path / "app.doql.less"),
+    )
     assert result.ok
     assert result.data["project_name"] == "demo"

{wup-0.2.82 → wup-0.2.83}/tests/test_testql_watcher.py

@@ -564,7 +564,7 @@ def test_quick_pass_actions_prefer_config_endpoints_for_visual_diff():
         assert differ.calls == [("backend", ["http://localhost:8101/api/v3/health"])]
 
 
-def test_quick_interrupt_does_not_create_failure_track():
+def test_quick_interrupt_keeps_watcher_active_without_failure_track():
     with tempfile.TemporaryDirectory() as tmpdir:
         root = Path(tmpdir)
         scenario_dir = root / "testql-scenarios"
@@ -592,8 +592,49 @@ def test_quick_interrupt_does_not_create_failure_track():
             stderr="",
         )
 
-        with pytest.raises(KeyboardInterrupt):
-            asyncio.run(watcher.run_quick_test("connect-config", []))
+        assert asyncio.run(watcher.run_quick_test("connect-config", [])) is False
 
         tracks = list((root / ".wup" / "tracks").glob("*.json"))
         assert tracks == []
+
+
+def test_run_quick_test_accepts_parent_service_test_target():
+    """WupWatcher.process_test_queue_once calls run_quick_test(ServiceTestTarget)."""
+    from wup.models.target import ServiceTestTarget
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        root = Path(tmpdir)
+        scenario_dir = root / "testql-scenarios"
+        scenario_dir.mkdir(parents=True, exist_ok=True)
+        (scenario_dir / "backend-smoke.testql.toon.yaml").write_text("name: smoke\n", encoding="utf-8")
+
+        cfg = WupConfig(
+            project=ProjectConfig(name="demo"),
+            services=[ServiceConfig(name="backend", paths=["backend/**"])],
+            watch=WatchConfig(),
+            testql=TestQLConfig(scenario_dir="testql-scenarios"),
+        )
+        watcher = TestQLWatcher(
+            project_root=str(root),
+            deps_file=str(root / "deps.json"),
+            scenarios_dir="testql-scenarios",
+            track_dir=".wup/tracks",
+            config=cfg,
+        )
+
+        async def skip_probes(service, endpoints):
+            return True
+
+        watcher._run_live_http_probes = skip_probes  # type: ignore[method-assign]
+        watcher._get_quick_scenarios = lambda service: []  # type: ignore[method-assign]
+
+        async def no_scenarios(service, merged):
+            return True
+
+        watcher._run_quick_test_no_scenarios = no_scenarios  # type: ignore[method-assign]
+
+        target = ServiceTestTarget(service="backend", endpoints=["http://127.0.0.1/health"])
+        assert asyncio.run(watcher.run_quick_test(target)) is True
+
+        watcher.test_queue.append(("quick", "backend", ["http://127.0.0.1/health"]))
+        asyncio.run(watcher.process_test_queue_once())

{wup-0.2.82 → wup-0.2.83}/tests/test_wup.py

@@ -689,13 +689,15 @@ class TestIntegrationWorkflow:
                 "/api/users/create"
             ]
             
-            # Simulate file change
+            # Simulate file change (debounced per service)
             file_path = str(Path(tmpdir) / "app" / "users" / "routes.py")
             watcher.on_file_change(file_path)
-            
+            watcher._pending_event_times["users"] = 0  # force window elapsed
+            watcher._flush_pending_events()
+
             # Verify service was detected
             assert "users" in watcher.changed_services
-            
+
             # Verify test was scheduled
             assert len(watcher.test_queue) == 1
             test_type, service_name, endpoints = watcher.test_queue[0]

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

{wup-0.2.82 → wup-0.2.83}/wup/cli.py

@@ -595,6 +595,85 @@ def _build_status_panel(
     return Group(*lines)
 
 
+@app.command()
+def health(
+    config: Optional[str] = typer.Option(None, "--config", "-C", help="Path to wup.yaml config file"),
+    since: Optional[int] = typer.Option(None, "--since", help="Only show transitions newer than this unix timestamp"),
+    failed_only: bool = typer.Option(False, "--failed-only", help="Only services currently down/degraded"),
+    quiet: bool = typer.Option(False, "--quiet", "-q", help="No output; exit code only"),
+):
+    """Runtime service health snapshot (reads the shared watcher state).
+
+    Designed for LLM agents and scripts: stable JSON on stdout, exit code
+    reflects health (0 = all up, 1 = degraded, 2 = something down,
+    3 = no watcher state yet).
+    """
+    import json as json_mod
+
+    project_path = Path(".").resolve()
+    from .paths import health_events_path as _health_events_path
+    from .paths import health_state_path as _health_state_path
+
+    state = {}
+    state_path = _health_state_path(project_path)
+    if state_path.exists():
+        try:
+            state = json_mod.loads(state_path.read_text(encoding="utf-8"))
+        except (OSError, ValueError):
+            state = {}
+
+    if since is not None:
+        events_path = _health_events_path(project_path)
+        recent = []
+        if events_path.exists():
+            for line in reversed(events_path.read_text(encoding="utf-8").splitlines()):
+                if not line.strip():
+                    continue
+                try:
+                    record = json_mod.loads(line)
+                except ValueError:
+                    continue
+                if int(record.get("timestamp", 0)) < since:
+                    break
+                recent.append(record)
+        payload = {
+            "project": project_path.name,
+            "since": since,
+            "transitions": list(reversed(recent)),
+            "state": state,
+        }
+    else:
+        payload = {
+            "project": project_path.name,
+            "state": state,
+        }
+
+    has_state = bool(state)
+    if failed_only:
+        payload["state"] = {
+            name: entry
+            for name, entry in payload["state"].items()
+            if str(entry.get("status", "")).lower() in ("down", "degraded")
+        }
+
+    statuses = {
+        str(entry.get("status", "")).lower()
+        for entry in payload["state"].values()
+    }
+    if "down" in statuses:
+        code = 2
+    elif "degraded" in statuses:
+        code = 1
+    elif not has_state:
+        code = 3
+    else:
+        code = 0
+
+    if not quiet:
+        print(json_mod.dumps(payload, ensure_ascii=False, indent=2))
+    raise typer.Exit(code)
+
+
 @app.command()
 def status(
     deps_file: str = typer.Option("deps.json", "--deps", "-d", help="Path to dependency map file"),