Initial commit

tests/test_watcher_cli.py

@@ -0,0 +1,108 @@
+"""Watcher debounce and CLI smoke tests (SPEC 8, 10.1)."""
+
+from __future__ import annotations
+
+import time
+from pathlib import Path
+
+import pytest
+
+from mdcaldav.cli import main
+from mdcaldav.config import Config
+from mdcaldav.index import Index
+from mdcaldav.watcher import Watcher
+
+
+@pytest.fixture
+def index(vault: Path, tmp_path: Path):
+    cfg = Config()
+    cfg.vault.path = vault
+    cfg.index.db = tmp_path / "index.db"
+    idx = Index(cfg)
+    idx.rescan()
+    yield idx
+    idx.close()
+
+
+def _titles(index: Index) -> set[str]:
+    return {t.title for t in index.tasks.values()}
+
+
+def test_watcher_picks_up_a_new_task(index: Index, vault: Path):
+    watcher = Watcher(index.cfg, index)
+    watcher.start()
+    try:
+        rel = vault / "daily/2026-01-07.md"
+        rel.write_text(rel.read_text() + "- [ ] Order more compost\n")
+
+        deadline = time.monotonic() + 5
+        while time.monotonic() < deadline:
+            if "Order more compost" in _titles(index):
+                break
+            time.sleep(0.05)
+        assert "Order more compost" in _titles(index)
+    finally:
+        watcher.stop()
+
+
+def test_watcher_debounces_a_burst(index: Index, vault: Path):
+    """Many rapid saves should collapse into far fewer rescans."""
+    watcher = Watcher(index.cfg, index)
+    rel = vault / "daily/2026-01-07.md"
+    base = index.generation
+
+    for n in range(10):
+        rel.write_text(rel.read_text() + f"- [ ] burst {n}\n")
+        watcher.touch(rel)
+    watcher.flush()
+
+    assert index.generation - base == 1  # one rescan, not ten
+    assert "burst 9" in _titles(index)
+    watcher.stop()
+
+
+def test_watcher_ignores_paths_outside_the_vault(index: Index, tmp_path: Path):
+    watcher = Watcher(index.cfg, index)
+    watcher.touch(tmp_path / "elsewhere.md")
+    assert watcher._pending == set()
+    watcher.stop()
+
+
+def test_refresh_if_stale_is_a_noop_when_unchanged(index: Index):
+    assert index.refresh_if_stale() is False
+
+
+def test_refresh_if_stale_detects_deletion(index: Index, vault: Path):
+    (vault / "daily/2026-01-07.md").unlink()
+    assert index.refresh_if_stale() is True
+    assert "Book the soil test" not in _titles(index)
+
+
+def test_cli_scan(vault: Path, tmp_path: Path, capsys, monkeypatch):
+    monkeypatch.setenv("HOME", str(tmp_path))
+    rc = main(["--vault", str(vault), "scan"])
+    out = capsys.readouterr().out
+
+    assert rc == 0
+    assert "Plan the seed order" in out
+    assert "Email the council office" in out  # nested tasks are shown
+    assert "[#A] Book the soil test" in out  # priority rendered
+    assert "tasks in" in out
+
+
+def test_cli_doctor(vault: Path, tmp_path: Path, capsys, monkeypatch):
+    monkeypatch.setenv("HOME", str(tmp_path))
+    rc = main(["--vault", str(vault), "doctor"])
+    out = capsys.readouterr().out
+
+    assert rc == 0
+    assert "collections:" in out
+    assert "daily" in out
+
+
+def test_cli_doctor_flags_ambiguous_titles(vault: Path, tmp_path: Path, capsys, monkeypatch):
+    monkeypatch.setenv("HOME", str(tmp_path))
+    (vault / "daily/dupes.md").write_text("- [ ] same thing\n- [ ] same thing\n")
+
+    main(["--vault", str(vault), "doctor"])
+    assert "ambiguous titles" in capsys.readouterr().out