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

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

@@ -5,6 +5,17 @@ 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.4] - 2026-06-11
+
+### Fixed
+- **Graceful Shutdown Hang**: Fixed an edge case where `synap stop` would time out and forcefully terminate due to `concurrent.futures` threads preventing immediate python process exit when handling embeddings. The CLI now safely flushes databases and exits instantly.
+
+## [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

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

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

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

{synap_git-2.1.2 → synap_git-2.1.4}/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(
@@ -710,6 +718,9 @@ def daemon_run(
     daemon = RuntimeDaemon(settings)
     asyncio.run(daemon.start())
 
+    # Forceful process exit to prevent atexit thread-join blocking
+    os._exit(0)
+
 
 @app.command()
 def stop(
@@ -766,11 +777,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 +1249,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 +1312,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.2 → synap_git-2.1.4}/src/synap_git/indexer/daemon.py

@@ -100,14 +100,10 @@ class RuntimeDaemon:
             self._running = False
             self.logger.info("daemon_shutting_down")
             self._ui_server.should_exit = True
-
-            from synap_git.config import RuntimeProfile
-
-            if self.settings.profile == RuntimeProfile.TEST:
-                self._ui_server.force_exit = True
+            self._ui_server.force_exit = True  # Always force exit since daemon is terminating
 
             # Allow uvicorn and wiki worker to shut down gracefully
-            timeout = self.settings.shutdown_timeout_seconds
+            timeout = 0.5
             self.logger.info("daemon_waiting_for_tasks", timeout=timeout)
 
             tasks = [server_task, wiki_worker_task]
@@ -132,6 +128,17 @@ class RuntimeDaemon:
             self.logger.info("daemon_stop_requested")
             self._stop_event.set()
 
+            # Force immediate cleanup and exit to avoid thread-join blocking
+            try:
+                self.runtime.shutdown()
+                self._delete_heartbeat()
+            except Exception:
+                pass
+
+            import os
+
+            os._exit(0)
+
     def health(self) -> DaemonHealth:
         status = self.runtime.status()
         return DaemonHealth(

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

@@ -601,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: