WARDEN: Lifecycle Assurance & Release v0.1.21

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: shenald-dev <245350826+shenald-dev@users.noreply.github.com>

Author: shenald-dev

.jules/bolt.md

@@ -116,3 +116,11 @@ When passing raw user strings containing square brackets (like file paths, direc
 
 Action:
 Always use `rich.markup.escape(str(variable))` before injecting unvalidated user-provided strings into `rich` print statements to guarantee safe output.
+
+## 2026-04-28 — Pre-computing `_base_prefix` for Fast-Path Slicing
+
+Learning:
+Inside the `_is_ignored_impl` hot path in `watchdog`, calling `os.path.relpath` for relative event paths when they could be sliced using `len(self._base_prefix)` introduced measurable latency in high-volume events. Additionally, generically calling `.removeprefix('./')` on paths could cause unexpected resolution regressions.
+
+Action:
+Pre-compute `_base_prefix` during initialization (`os.path.join(self.base_path, '')`) and use it in `startswith()` alongside `_abs_base_path` for fast string slicing. Also removed the blind `.removeprefix('./')` behavior to improve robustness.

.jules/warden.md

@@ -152,3 +152,11 @@ Observed the preceding agent optimized console logging by escaping string inputs
 
 Alignment / Deferred:
 Version bumped to `0.1.20` as a patch release reflecting the crash fix. No dead code required pruning.
+
+## 2026-04-28 — Assessment & Lifecycle
+
+Observation / Pruned:
+Observed the preceding agent optimized the ignore file watcher hot path by pre-computing `_base_prefix` for fast string slicing of relative paths, mitigating `os.path.relpath` overhead during burst events. The `.removeprefix('./')` call was also removed to prevent potential path resolution regressions. Assured the logic remains structurally sound, and the test suite passes.
+
+Alignment / Deferred:
+Version bumped to `0.1.21` as a patch release. Updated CHANGELOG.md. No dead code or dependency upgrades required.

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.1.21] - 2026-04-28
+
+### Changed
+* **[Performance]:** Optimized the file event hot path by pre-computing directory prefixes to use fast string slicing instead of `os.path.relpath`.
+* **[Reliability]:** Removed blanket `.removeprefix('./')` calls on event paths to prevent unexpected path resolution regressions.
+
 ## [0.1.20] - 2026-04-27
 
 ### Changed

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "echo-watcher"
-version = "0.1.20"
+version = "0.1.21"
 description = "📡 Lightweight file watcher. Trigger commands on changes. <5MB RAM, single binary."
 authors = [
     { name = "shenald-dev", email = "bot@shenald.dev" }

src/echo/watcher.py

@@ -21,6 +21,7 @@ def __init__(self, command: str, base_path: str = ".", ignore_patterns: list[str
         self.command = command
         self.base_path = base_path
         self._abs_base_path = os.path.join(os.path.abspath(base_path), '')
+        self._base_prefix = os.path.join(self.base_path, '')
 
         # Default ignore patterns
         default_ignores = [".git", "__pycache__", ".pytest_cache", ".ruff_cache", "node_modules", ".venv", "venv"]
@@ -166,6 +167,8 @@ def _run_command(self, event_path):
     def _is_ignored_impl(self, path: str) -> bool:
         if path.startswith(self._abs_base_path):
             path = path[len(self._abs_base_path):]
+        elif path.startswith(self._base_prefix):
+            path = path[len(self._base_prefix):]
         elif path == self.base_path or path == self._abs_base_path.rstrip(os.sep):
             path = "."
         else:
@@ -176,7 +179,7 @@ def _is_ignored_impl(self, path: str) -> bool:
         if not path:
             return False
 
-        normalized_path = path.replace('\\', '/').removeprefix('./')
+        normalized_path = path.replace('\\', '/')
 
         parts = normalized_path.split('/')
         if not self.exact_ignores.isdisjoint(parts):