synap-git 2.1.1__tar.gz → 2.1.3__tar.gz

{synap_git-2.1.1 → synap_git-2.1.3}/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.3] - 2026-06-11
+
+### Changed
+- **CLI Interactivity Enhancement**: Wrapped all long-running `synap` CLI commands (`init`, `start`, `stop`, `rollback`, `repair`) with interactive rich status spinners to ensure users never stare at an empty screen.
+- **Incremental Indexing Progress**: Added a rich progress status to the `_incremental_index` background loop to provide visibility into parsing tasks during cache hits.
+
+## [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

{synap_git-2.1.1 → synap_git-2.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synap-git
-Version: 2.1.1
+Version: 2.1.3
 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.1 → synap_git-2.1.3}/src/synap_git/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "2.1.1"
+__version__ = "2.1.3"

{synap_git-2.1.1 → synap_git-2.1.3}/src/synap_git/cli/main.py

@@ -524,7 +524,13 @@ def init(
     _auto_protect_synap(settings.repository_path)
 
     runtime = SynapRuntime(settings)
-    commit = runtime.bootstrap(force=force)
+    if not quiet and not json_output:
+        with console.status(
+            "[yellow]Initializing Synap runtime and scanning repository...[/yellow]", spinner="dots"
+        ):
+            commit = runtime.bootstrap(force=force)
+    else:
+        commit = runtime.bootstrap(force=force)
 
     if json_output:
         _emit({"active_commit": commit, "state": "initialized"}, json_output=True)
@@ -670,20 +676,22 @@ def start(
         console.print(f"[bold red]✗ Failed to start daemon:[/bold red] {e}")
         raise typer.Exit(1)
 
-    console.print("[yellow]Starting Synap daemon...[/yellow]")
     success = False
-    for _ in range(15):  # wait up to 3 seconds
-        time.sleep(0.2)
-        if pid_file.exists():
-            hb = _read_daemon_heartbeat(abs_path)
-            if hb and hb.get("status") in ("healthy", "degraded"):
-                success = True
-                port = hb.get("port", 9876)
-                pid = int(hb.get("pid", 0))
-                console.print(f"[green]✓ Synap daemon started (PID {pid})[/green]")
-                console.print("[green]✓ Runtime healthy[/green]")
-                console.print(f"[green]✓ UI available at http://127.0.0.1:{port}[/green]")
-                break
+    with console.status(
+        "[yellow]Starting Synap daemon and awaiting health check...[/yellow]", spinner="dots"
+    ):
+        for _ in range(15):  # wait up to 3 seconds
+            time.sleep(0.2)
+            if pid_file.exists():
+                hb = _read_daemon_heartbeat(abs_path)
+                if hb and hb.get("status") in ("healthy", "degraded"):
+                    success = True
+                    port = hb.get("port", 9876)
+                    pid = int(hb.get("pid", 0))
+                    console.print(f"[green]✓ Synap daemon started (PID {pid})[/green]")
+                    console.print("[green]✓ Runtime healthy[/green]")
+                    console.print(f"[green]✓ UI available at http://127.0.0.1:{port}[/green]")
+                    break
 
     if not success:
         console.print(
@@ -766,11 +774,15 @@ def stop(
 
     # Wait for graceful shutdown (up to 10 seconds)
     success = False
-    for _ in range(50):
-        time.sleep(0.2)
-        if not _is_process_running(pid):
-            success = True
-            break
+    with console.status(
+        f"[yellow]Waiting for daemon (PID {pid}) to shut down gracefully...[/yellow]",
+        spinner="dots",
+    ):
+        for _ in range(50):
+            time.sleep(0.2)
+            if not _is_process_running(pid):
+                success = True
+                break
 
     # If graceful failed, force kill
     if not success:
@@ -1234,7 +1246,10 @@ def rollback(
 
         structlog.get_logger().error("suppressed_error_caught", error=str(e), exc_info=True)
 
-    runtime.bootstrap(force=True)
+    with console.status(
+        f"[yellow]Reindexing repository to match {selected_commit}...[/yellow]", spinner="dots"
+    ):
+        runtime.bootstrap(force=True)
     console.print(f"[green]✓ Rolled back successfully to {selected_commit}[/green]")
 
 
@@ -1294,15 +1309,17 @@ def repair(
 
     runtime.initialize_storage()
     console.print("[2/3] Reindexing all symbols")
-    runtime.bootstrap(force=True)
+    with console.status("[yellow]Reindexing repository...[/yellow]", spinner="dots"):
+        runtime.bootstrap(force=True)
 
     console.print("[3/3] Regenerating wiki from last known state")
-    try:
-        runtime.wiki.generate_project_wiki()
-    except Exception as e:
-        import structlog
+    with console.status("[yellow]Regenerating wiki documentation...[/yellow]", spinner="dots"):
+        try:
+            runtime.wiki.generate_project_wiki()
+        except Exception as e:
+            import structlog
 
-        structlog.get_logger().error("suppressed_error_caught", error=str(e), exc_info=True)
+            structlog.get_logger().error("suppressed_error_caught", error=str(e), exc_info=True)
 
     status_info = runtime.status()
     console.print(f"\n[green]✓ Recovery complete. {status_info.files} files restored.[/green]")

{synap_git-2.1.1 → synap_git-2.1.3}/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.1 → synap_git-2.1.3}/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)
@@ -598,55 +601,77 @@ class SynapRuntime:
         # Process additions and modifications
         registry = CodeParserRegistry()
         parsed_results = []
-        for rel_path in filtered_added_or_modified:
-            self.logger.info("reindexing_file", path=rel_path)
-            p = self.settings.repository_path / rel_path
 
-            try:
-                content = p.read_text(encoding="utf-8", errors="replace")
-            except Exception as e:
-                self.logger.warning("failed_to_read_file", path=rel_path, error=str(e))
-                continue
+        import contextlib
 
-            import hashlib
-
-            content_hash = hashlib.sha256(content.encode("utf-8")).hexdigest()
-            file_id_hash = hashlib.sha256((rel_path + content_hash).encode("utf-8")).hexdigest()
-
-            parse_result = registry.parse(p, relative_path=rel_path, text=content)
-            symbols_list = [
-                {
-                    "symbol_id": sym.stable_id,
-                    "name": sym.name,
-                    "kind": sym.kind,
-                    "start_line": sym.start_line,
-                    "end_line": sym.end_line,
-                    "ast_hash": sym.ast_hash,
-                    "metadata": sym.metadata,
-                }
-                for sym in parse_result.symbols
-            ]
-
-            self.store.upsert_file_and_symbols(
-                file_id=file_id_hash,
-                path=rel_path,
-                git_oid=git_oids.get(rel_path, ""),
-                content_hash=content_hash,
-                language=parse_result.language,
-                symbols=symbols_list,
-            )
-            self._schedule_embedding(file_id_hash, symbols_list, content_hash)
+        from rich.console import Console
 
-            self.store.set_wiki_status(rel_path, None, "stale")
-            self.store.enqueue_wiki(rel_path)
+        console = Console(stderr=True)
+        show_progress = (
+            self.settings.logging_mode.name == "HUMAN" and len(filtered_added_or_modified) > 0
+        )
 
-            with self.store.connect() as conn:
-                conn.execute(
-                    "DELETE FROM edges WHERE source_symbol IN (SELECT symbol_id FROM symbols WHERE file_id = ?)",
-                    (file_id_hash,),
+        with (
+            console.status(
+                "[yellow]Parsing incrementally changed files...[/yellow]", spinner="dots"
+            )
+            if show_progress
+            else contextlib.nullcontext()
+        ) as status_ctx:
+            for idx, rel_path in enumerate(filtered_added_or_modified, 1):
+                if show_progress and hasattr(status_ctx, "update"):
+                    status_ctx.update(  # type: ignore[union-attr]
+                        f"[yellow]Parsing incrementally changed files ([white]{idx}/{len(filtered_added_or_modified)}[/white])...[/yellow]"
+                    )
+
+                self.logger.info("reindexing_file", path=rel_path)
+                p = self.settings.repository_path / rel_path
+
+                try:
+                    content = p.read_text(encoding="utf-8", errors="replace")
+                except Exception as e:
+                    self.logger.warning("failed_to_read_file", path=rel_path, error=str(e))
+                    continue
+
+                import hashlib
+
+                content_hash = hashlib.sha256(content.encode("utf-8")).hexdigest()
+                file_id_hash = hashlib.sha256((rel_path + content_hash).encode("utf-8")).hexdigest()
+
+                parse_result = registry.parse(p, relative_path=rel_path, text=content)
+                symbols_list = [
+                    {
+                        "symbol_id": sym.stable_id,
+                        "name": sym.name,
+                        "kind": sym.kind,
+                        "start_line": sym.start_line,
+                        "end_line": sym.end_line,
+                        "ast_hash": sym.ast_hash,
+                        "metadata": sym.metadata,
+                    }
+                    for sym in parse_result.symbols
+                ]
+
+                self.store.upsert_file_and_symbols(
+                    file_id=file_id_hash,
+                    path=rel_path,
+                    git_oid=git_oids.get(rel_path, ""),
+                    content_hash=content_hash,
+                    language=parse_result.language,
+                    symbols=symbols_list,
                 )
+                self._schedule_embedding(file_id_hash, symbols_list, content_hash)
+
+                self.store.set_wiki_status(rel_path, None, "stale")
+                self.store.enqueue_wiki(rel_path)
+
+                with self.store.connect() as conn:
+                    conn.execute(
+                        "DELETE FROM edges WHERE source_symbol IN (SELECT symbol_id FROM symbols WHERE file_id = ?)",
+                        (file_id_hash,),
+                    )
 
-            parsed_results.append((file_id_hash, rel_path, list(parse_result.imports)))
+                parsed_results.append((file_id_hash, rel_path, list(parse_result.imports)))
 
         # Re-resolve edges for changed files
         if parsed_results: