Skip to content

Self-improving AI Employees for everyone

chore: cull dead stubs + stale docs + untracked test artifacts

trohitg4343cb9371a5
diff --git a/.gitignore b/.gitignore
index f38bcadd..1d2f9320 100644
--- a/.gitignore
+++ b/.gitignore
@@ -81,6 +81,11 @@ __pycache__/
nul
NUL
+# Test artifacts — when a test passes a MagicMock to Path(...).mkdir
+# the mock's repr() materialises as a real folder tree. Belt-and-braces
+# guard so future stray runs don't pollute the worktree.
+MagicMock/
+
# =============================================================================
# Build artifacts
# =============================================================================
diff --git a/server/services/execution/recovery.py b/server/services/execution/recovery.py
index 8dbe341a..16faf778 100644
--- a/server/services/execution/recovery.py
+++ b/server/services/execution/recovery.py
@@ -199,24 +199,6 @@ class RecoverySweeper:
return needs_recovery
- async def cleanup_old_executions(self, max_age_hours: int = 24) -> int:
- """Clean up completed executions older than max_age.
-
- Args:
- max_age_hours: Maximum age in hours
-
- Returns:
- Number of executions cleaned up
- """
- cleaned = 0
- max_age_hours * 3600
- time.time()
-
- # This would need a scan of all execution keys
- # For now, we rely on Redis TTL for cleanup
- logger.info("Cleanup skipped - using Redis TTL",
- max_age_hours=max_age_hours)
-
return cleaned
diff --git a/server/services/handlers/__init__.py b/server/services/handlers/__init__.py
index fef2a517..9fb94af3 100644
--- a/server/services/handlers/__init__.py
+++ b/server/services/handlers/__init__.py
@@ -1,21 +1,17 @@
-"""Node handler shims.
+"""Cross-cutting node-handler machinery.
-Most handler bodies were inlined into their plugin files during Wave
-11.D / 11.E. What remains here is the cross-cutting machinery:
+Per-plugin handler bodies were inlined into their plugin files during
+Wave 11.D / 11.E and the self-contained plugin folders (Wave 11.H/I)
+absorbed the rest. What remains in this package is the work that
+doesn't belong to any single plugin:
-- ``tools.py`` — AI-tool dispatcher + plugin fast-path + Android
- toolkit + agent delegation.
-- ``ai.py`` — agent-execution shims (``handle_ai_agent`` etc.)
- called by the agent plugins via
- ``nodes/agent/_inline.prepare_agent_call``.
-- ``android.py`` — direct Android service execution.
-- ``browser.py`` — agent-browser CLI wrapper.
-- ``claude_code.py`` — Claude Code SDK wrapper.
-- ``deep_agent.py`` — DeepAgents bridge.
-- ``rlm.py`` — RLM agent execution.
-- ``triggers.py`` — generic trigger node handler.
-- ``google_auth.py`` — shared OAuth helper for Google plugins (kept
- alive by ``credentials/google.GoogleCredential``).
+- ``tools.py`` — AI-tool dispatcher + plugin fast-path + Android
+ toolkit + agent delegation.
+- ``triggers.py`` — generic trigger-node handler (cron / event waiters
+ flow through here regardless of which plugin
+ registered the trigger).
+- ``todo.py`` — writeTodos execution shim used by every agent's
+ ``write_todos`` tool call.
The package ``__init__.py`` deliberately stays empty: nothing imports
from ``services.handlers`` at the package level — every consumer