synap-git 2.1.0__tar.gz → 2.1.2__tar.gz

{synap_git-2.1.0 → synap_git-2.1.2}/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.2] - 2026-06-11
+
+### Fixed
+- **CRITICAL: Daemon Thread Explosion**: Patched a massive concurrency edge case in `SynapRuntime` where large repository indexing would trigger unbounded `threading.Thread` loops for LLM embeddings. A bounded `ThreadPoolExecutor` has been introduced to prevent OOMs, OS thread starvation, and rate-limit hits during first-run indexing.
+- **Daemon Lifecycle**: Ensure `embedding_executor` shuts down cleanly without leaking background threads when the daemon loop receives SIGTERM.
+
+## [2.1.1] - 2026-06-11
+
+### Fixed
+- **CRITICAL: MCP StdIO Stream Corruption**: Fixed a bug where `synap mcp start` and `signal_low_context` would accidentally print progress bars or notifications to `sys.stdout` instead of `sys.stderr`, which corrupted the MCP protocol stream and disconnected IDEs like Cursor/Windsurf.
+- **UX Improvements**: Improved the silence logic in CLI initialization to prevent unnecessary rich formatting in JSON/MCP environments.
+
 ## [2.1.0] - 2026-05-29
 
 ### Added

{synap_git-2.1.0 → synap_git-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synap-git
-Version: 2.1.0
+Version: 2.1.2
 Summary: Persistent structural context infrastructure for AI coding agents.
 Project-URL: Homepage, https://github.com/saahilpal/synap-git
 Project-URL: Repository, https://github.com/saahilpal/synap-git

{synap_git-2.1.0 → synap_git-2.1.2}/src/synap_git/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "2.1.0"
+__version__ = "2.1.2"

{synap_git-2.1.0 → synap_git-2.1.2}/src/synap_git/cli/main.py

@@ -1470,7 +1470,7 @@ def mcp_start(
     path: Annotated[str, typer.Argument(help="Repository path.")] = ".",
 ) -> None:
     """Start the MCP server."""
-    settings = _settings(path)
+    settings = _settings(path, json_output=True)
     runtime = SynapRuntime(settings)
     runtime.bootstrap()
 

{synap_git-2.1.0 → synap_git-2.1.2}/src/synap_git/indexer/daemon.py

@@ -123,6 +123,7 @@ class RuntimeDaemon:
                 except (asyncio.CancelledError, Exception):
                     pass
 
+            self.runtime.shutdown()
             self._delete_heartbeat()
             self.logger.info("daemon_stopped")
 

{synap_git-2.1.0 → synap_git-2.1.2}/src/synap_git/indexer/engine.py

@@ -81,6 +81,17 @@ class SynapRuntime:
         self.wiki = WikiEngine(settings, self.store)
         self.commit_count = 0
 
+        import concurrent.futures
+
+        self.embedding_executor = concurrent.futures.ThreadPoolExecutor(
+            max_workers=5, thread_name_prefix="embed_worker"
+        )
+
+    def shutdown(self) -> None:
+        """Gracefully shutdown background tasks and executors."""
+        self.logger.info("shutting_down_embedding_executor")
+        self.embedding_executor.shutdown(wait=False)
+
     def initialize_storage(self, *, auto_recover: bool = True) -> None:
         self.settings.ensure_directories()
         if auto_recover and self.store.path.exists() and self.store.recover_if_corrupted():
@@ -284,15 +295,7 @@ class SynapRuntime:
             except Exception as e:
                 logger.warning("background_embed_failed", error=str(e))
 
-        try:
-            import asyncio
-
-            loop = asyncio.get_running_loop()
-            loop.create_task(asyncio.to_thread(_worker))
-        except RuntimeError:
-            import threading
-
-            threading.Thread(target=_worker, daemon=True).start()
+        self.embedding_executor.submit(_worker)
 
     def _first_run_index(self, git_state: GitState) -> str | None:
         self.logger.info("first_run_indexing_started", branch=git_state.effective_branch)
@@ -317,7 +320,7 @@ class SynapRuntime:
         from rich.console import Console
         from rich.progress import BarColumn, Progress, SpinnerColumn, TextColumn, TimeElapsedColumn
 
-        console = Console()
+        console = Console(stderr=True)
         show_progress = self.settings.logging_mode.name == "HUMAN" and num_files > 5
 
         if show_progress:

{synap_git-2.1.0 → synap_git-2.1.2}/src/synap_git/mcp/server.py

@@ -83,7 +83,11 @@ class SynapMCPFacade:
         if should_checkpoint:
             message += f"Threshold ({threshold:.1%}) reached. Checkpoint recommended."
             # Emit CLI notification
-            print(f"\n[Synapse] ⚠ Agent at {percentage:.0%} context — checkpoint recommended.")
+            import sys
+
+            sys.stderr.write(
+                f"\n[Synapse] ⚠ Agent at {percentage:.0%} context — checkpoint recommended.\n"
+            )
         else:
             message += f"Context is within limits (threshold {threshold:.1%})."
 

{synap_git-2.1.0 → synap_git-2.1.2}/src/synap_git/retrieval/engine.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import functools
 from dataclasses import dataclass
 from datetime import UTC, datetime
 from pathlib import Path
@@ -22,23 +23,32 @@ class TraceElement:
     tokens: int
 
 
-def _get_snippet(repo_path: Path, rel_path: str, start_line: int, end_line: int) -> str:
+@functools.lru_cache(maxsize=256)
+def _get_file_lines(repo_path: Path, rel_path: str) -> list[str] | None:
     try:
         p = repo_path / rel_path
-        lines = p.read_text(encoding="utf-8", errors="replace").splitlines()
-        s_idx = max(0, start_line - 1)
-        e_idx = min(len(lines), end_line)
-        return "\n".join(lines[s_idx:e_idx])
-    except Exception:
+        return p.read_text(encoding="utf-8", errors="replace").splitlines()
+    except Exception as e:
+        import structlog
+
+        structlog.get_logger().warning("file_read_failed", path=rel_path, error=str(e))
+        return None
+
+
+def _get_snippet(repo_path: Path, rel_path: str, start_line: int, end_line: int) -> str:
+    lines = _get_file_lines(repo_path, rel_path)
+    if lines is None:
         return ""
+    s_idx = max(0, start_line - 1)
+    e_idx = min(len(lines), end_line)
+    return "\n".join(lines[s_idx:e_idx])
 
 
 def _get_full_file(repo_path: Path, rel_path: str) -> str:
-    try:
-        p = repo_path / rel_path
-        return p.read_text(encoding="utf-8", errors="replace")
-    except Exception:
+    lines = _get_file_lines(repo_path, rel_path)
+    if lines is None:
         return ""
+    return "\n".join(lines)
 
 
 class HybridRetrievalEngine:
@@ -93,20 +103,15 @@ class HybridRetrievalEngine:
         # 2. Lexical Matches (BM25)
         query_words = {word.lower().strip() for word in query.split() if len(word) > 2}
         lexical_candidates: dict[str, dict[str, Any]] = {}
-        for word in query_words:
-            symbols = self.store.get_symbols_by_name(word)
-            for rank, sym in enumerate(symbols):
-                sid = sym["symbol_id"]
-                if sid not in lexical_candidates:
-                    lexical_candidates[sid] = {
-                        **sym,
-                        "reason": f"lexical:'{word}'",
-                        "lexical_rank": rank,
-                    }
-                else:
-                    lexical_candidates[sid]["lexical_rank"] = min(
-                        lexical_candidates[sid].get("lexical_rank", rank), rank
-                    )
+        symbols = self.store.get_symbols_by_lexical_query(query_words)
+        for rank, sym in enumerate(symbols):
+            sid = sym["symbol_id"]
+            if sid not in lexical_candidates:
+                lexical_candidates[sid] = {
+                    **sym,
+                    "reason": "lexical_match",
+                    "lexical_rank": rank,
+                }
 
         t_lexical = time.perf_counter()
 

{synap_git-2.1.0 → synap_git-2.1.2}/src/synap_git/storage/sqlite.py

@@ -45,7 +45,7 @@ class SynapStore:
         self.path.parent.mkdir(parents=True, exist_ok=True)
         with self.connect() as conn:
             conn.execute("PRAGMA journal_mode=WAL")
-            conn.execute("PRAGMA synchronous=FULL")
+            conn.execute("PRAGMA synchronous=NORMAL")
             conn.execute("PRAGMA foreign_keys=ON")
 
             # Get current user version
@@ -287,7 +287,7 @@ class SynapStore:
         conn.create_function("cosine_similarity", 2, _cosine_similarity)
         try:
             conn.execute("PRAGMA foreign_keys=ON")
-            conn.execute("PRAGMA synchronous=FULL")
+            conn.execute("PRAGMA synchronous=NORMAL")
             yield conn
             conn.commit()
         except Exception:
@@ -395,7 +395,16 @@ class SynapStore:
             ).fetchall()
         return [dict(row) for row in rows]
 
-    def get_symbols_by_name(self, clean_name: str, limit: int = 50) -> list[dict[str, Any]]:
+    def get_symbols_by_lexical_query(
+        self, query_words: set[str], limit: int = 50
+    ) -> list[dict[str, Any]]:
+        if not query_words:
+            return []
+        parts = []
+        for w in query_words:
+            parts.append(f'"{w}"*')
+            parts.append(f'body:"{w}"*')
+        match_expr = " OR ".join(parts)
         with self.connect() as conn:
             rows = conn.execute(
                 """
@@ -407,7 +416,7 @@ class SynapStore:
                 ORDER BY rank
                 LIMIT ?
                 """,
-                (f'"{clean_name}"* OR body:"{clean_name}"*', limit),
+                (match_expr, limit),
             ).fetchall()
         return [dict(row) for row in rows]