feat: add pre-processing agent system

Author: Pro0f

.gitignore

@@ -208,3 +208,4 @@ __marimo__/
 
 # DevsContext specific
 .devscontext.yaml
+.devscontext/

pyproject.toml

@@ -29,6 +29,7 @@ dependencies = [
     "pyyaml>=6.0",
     "click>=8.0",
     "pydantic>=2.0",
+    "aiosqlite>=0.20",
 ]
 
 [project.optional-dependencies]
@@ -109,6 +110,7 @@ show_column_numbers = true
 module = [
     "mcp.*",
     "yaml",
+    "aiosqlite",
 ]
 ignore_missing_imports = true
 

src/devscontext/adapters/jira.py

@@ -17,7 +17,7 @@
 import asyncio
 import time
 from datetime import UTC, datetime
-from typing import TYPE_CHECKING, Any, ClassVar
+from typing import Any, ClassVar
 
 import httpx
 
@@ -40,9 +40,6 @@
 )
 from devscontext.plugins.base import Adapter, SearchResult, SourceContext
 
-if TYPE_CHECKING:
-    pass
-
 logger = get_logger(__name__)
 
 

src/devscontext/agents/__init__.py

@@ -0,0 +1,28 @@
+"""Background agents for DevsContext.
+
+This package contains the background pre-processing agent that watches Jira
+for tickets moving to "Ready for Development" and pre-builds rich context
+before anyone picks them up.
+
+Components:
+    JiraWatcher: Polls Jira for tickets in target status
+    PreprocessingPipeline: Builds rich context with multi-pass synthesis
+
+Example:
+    from devscontext.agents import JiraWatcher, PreprocessingPipeline
+    from devscontext.storage import PrebuiltContextStorage
+
+    storage = PrebuiltContextStorage(".devscontext/cache.db")
+    await storage.initialize()
+
+    pipeline = PreprocessingPipeline(config, storage)
+    watcher = JiraWatcher(config, pipeline)
+
+    # Run the polling loop
+    await watcher.run()
+"""
+
+from devscontext.agents.preprocessor import PreprocessingPipeline
+from devscontext.agents.watcher import JiraWatcher
+
+__all__ = ["JiraWatcher", "PreprocessingPipeline"]