synap-git 2.1.6__tar.gz → 2.2.0__tar.gz

{synap_git-2.1.6 → synap_git-2.2.0}/.gitignore

@@ -25,3 +25,10 @@ build/
 .synapse/
 .synapse/*-wal
 .synapse/*-shm
+config.json
+status.json
+fix_exc.py
+test_embed.py
+.vscode/
+.idea/
+*.log

{synap_git-2.1.6 → synap_git-2.2.0}/CHANGELOG.md

@@ -5,7 +5,30 @@ 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.5] - 2026-06-11
+## [2.2.0] - 2026-08-03
+
+### Added
+- **AST Symbol Parser Expansion (AUD-02)**: Implemented Tree-sitter AST symbol extraction handlers for C#, PHP, Kotlin, Scala, and C.
+- **Event-Driven File Watcher (AUD-03)**: Replaced continuous 2s subprocess polling with `watchdog` filesystem event tracking, reducing idle CPU usage to near-zero.
+- **Daemon REST API Diagnostic Checks (AUD-06)**: Added daemon port availability and REST API endpoint status checks to `synap doctor`.
+- **Wiki Task Requeue Subcommand (AUD-08)**: Added `synap wiki retry` CLI subcommand and `retry_failed_wiki_queue` storage method to requeue permanently failed wiki tasks back to pending state.
+
+### Changed
+- **CLI `synap start` Control Flow (AUD-01)**: Fixed `synap start` so it exits cleanly when a daemon is already running unless `--foreground` is explicitly passed.
+- **SQLite WAL Performance Rationale (AUD-07)**: Documented `PRAGMA synchronous=NORMAL` in WAL mode as an intentional architectural tradeoff balancing write throughput and self-healing index recovery.
+
+### Fixed
+- **Graceful Embedding Provider Fallback (AUD-04)**: Configured Anthropic and OpenRouter providers to log a warning and return empty embedding vectors instead of raising unhandled `NotImplementedError`.
+- **Symbol Preservation on File Renames (AUD-05)**: Added `-M` rename detection to `git diff-tree` in incremental indexing to preserve file symbol history and edges across renames.
+
+## [2.1.7] - 2026-07-29
+
+### Added
+- **AI Engineer Rules**: Created standardized agent rulesets across `AGENTS.md`, `.cursorrules`, `.windsurfrules`, and `.github/copilot-instructions.md`.
+
+### Fixed
+- **Daemon Branch Switching Test Stability**: Resolved timing race condition in daemon branch checkout verification.
+- **CLI Setup Connectivity**: Fixed setup connectivity verification and non-TTY prompt fallback handling.
 
 ## [2.1.6] - 2026-06-29
 

{synap_git-2.1.6 → synap_git-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: synap-git
-Version: 2.1.6
+Version: 2.2.0
 Summary: Persistent structural context infrastructure for AI coding agents.
 Project-URL: Homepage, https://github.com/saahilpal/synapse
 Project-URL: Repository, https://github.com/saahilpal/synapse
@@ -37,6 +37,7 @@ Requires-Dist: tree-sitter-languages==1.10.2
 Requires-Dist: tree-sitter==0.20.4
 Requires-Dist: typer==0.15.1
 Requires-Dist: uvicorn==0.34.0
+Requires-Dist: watchdog>=6.0.0
 Provides-Extra: dev
 Requires-Dist: bandit==1.8.3; extra == 'dev'
 Requires-Dist: mypy==1.15.0; extra == 'dev'
@@ -339,8 +340,8 @@ Initialize the local SQLite database index:
 synap init .
 ```
 
-### 3. Detach Watcher Daemon
-Start background monitoring:
+### 3. Connect IDE / Start MCP
+Launch the unified background daemon and MCP stdio server:
 ```bash
 synap start .
 ```
@@ -372,7 +373,6 @@ All commands support target path arguments:
 * `synap doctor [PATH]` — Verifies database integrity and parsers.
 * `synap run [PATH]` — Runs daemon in foreground.
 * `synap ui [PATH]` — Launches HTML dashboard.
-* `synap mcp start [PATH]` — Hosts MCP stdio server.
 * `synap mcp config [PATH]` — Outputs Cursor connection blocks.
 * `synap mcp verify [PATH]` — Asserts MCP server stability.
 * `synap memory status [PATH]` — Lists lesson counts.
@@ -432,8 +432,7 @@ synap mcp config .
   "mcpServers": {
     "synap": {
       "command": "/usr/local/bin/python",
-      "args": ["-m", "synap_git.cli", "mcp", "start", "/Users/username/repo"],
-      "autoConnect": true
+      "args": ["-m", "synap_git.cli", "start", "/Users/username/repo"]
     }
   }
 }

{synap_git-2.1.6 → synap_git-2.2.0}/README.md

@@ -289,8 +289,8 @@ Initialize the local SQLite database index:
 synap init .
 ```
 
-### 3. Detach Watcher Daemon
-Start background monitoring:
+### 3. Connect IDE / Start MCP
+Launch the unified background daemon and MCP stdio server:
 ```bash
 synap start .
 ```
@@ -322,7 +322,6 @@ All commands support target path arguments:
 * `synap doctor [PATH]` — Verifies database integrity and parsers.
 * `synap run [PATH]` — Runs daemon in foreground.
 * `synap ui [PATH]` — Launches HTML dashboard.
-* `synap mcp start [PATH]` — Hosts MCP stdio server.
 * `synap mcp config [PATH]` — Outputs Cursor connection blocks.
 * `synap mcp verify [PATH]` — Asserts MCP server stability.
 * `synap memory status [PATH]` — Lists lesson counts.
@@ -382,8 +381,7 @@ synap mcp config .
   "mcpServers": {
     "synap": {
       "command": "/usr/local/bin/python",
-      "args": ["-m", "synap_git.cli", "mcp", "start", "/Users/username/repo"],
-      "autoConnect": true
+      "args": ["-m", "synap_git.cli", "start", "/Users/username/repo"]
     }
   }
 }

{synap_git-2.1.6 → synap_git-2.2.0}/pyproject.toml

@@ -37,6 +37,7 @@ dependencies = [
   "tree-sitter-languages==1.10.2",
   "typer==0.15.1",
   "uvicorn==0.34.0",
+  "watchdog>=6.0.0",
 ]
 
 [project.urls]

{synap_git-2.1.6 → synap_git-2.2.0}/src/synap_git/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "2.1.6"
+__version__ = "2.2.0"

{synap_git-2.1.6 → synap_git-2.2.0}/src/synap_git/api/app.py

@@ -104,7 +104,7 @@ def create_app(runtime: SynapRuntime) -> FastAPI:
         except Exception as e:
             import structlog
 
-            structlog.get_logger().error("suppressed_error_caught", exc_info=True)
+            structlog.get_logger().error("suppressed_error_caught", error=str(e))
 
         wiki_path = runtime.wiki.wiki_dir / f"{target}.md"
         exists = await asyncio.to_thread(wiki_path.exists)

{synap_git-2.1.6 → synap_git-2.2.0}/src/synap_git/cli/main.py

@@ -57,7 +57,7 @@ def _custom_call(*args: Any, **kwargs: Any) -> Any:
 app.__call__ = _custom_call  # type: ignore[method-assign]
 
 JSON_OPTION = typer.Option("--json", help="Emit machine-readable JSON.")
-console = Console()
+console = Console(stderr=True)
 
 
 def _settings(
@@ -88,9 +88,19 @@ def _settings(
     return settings
 
 
+def _verify_is_git(path: str) -> None:
+    from synap_git.git.state import GitRepository
+
+    if not GitRepository(Path(path)).state().is_repository:
+        console.print(f"[bold red]Error:[/bold red] '{path}' is not a valid Git repository.")
+        raise typer.Exit(1)
+
+
 def _emit(value: Any, *, json_output: bool) -> None:
     if json_output:
-        console.print(json.dumps(_jsonable(value), indent=2, sort_keys=True))
+        import sys
+
+        print(json.dumps(_jsonable(value), indent=2, sort_keys=True), file=sys.stdout)
         return
     if isinstance(value, str):
         console.print(value)
@@ -529,6 +539,7 @@ def init(
         synap init
         synap init --force --skip-llm
     """
+    _verify_is_git(path)
     settings = _settings(path, json_output=json_output)
     if skip_llm:
         settings.llm_provider = None
@@ -537,12 +548,9 @@ def init(
 
     runtime = SynapRuntime(settings)
     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)
+        console.print("[yellow]Initializing Synap runtime and scanning repository...[/yellow]")
+
+    commit = runtime.bootstrap(force=force)
 
     if json_output:
         _emit({"active_commit": commit, "state": "initialized"}, json_output=True)
@@ -644,16 +652,27 @@ def _detect_install_method() -> str:
 @app.command()
 def start(
     path: Annotated[str, typer.Argument(help="Repository path to watch.")] = ".",
+    foreground: Annotated[
+        bool,
+        typer.Option(
+            "--foreground", help="Run FastMCP stdio server in foreground after starting daemon."
+        ),
+    ] = False,
 ) -> None:
     """Start the Synap daemon in the background."""
+    _verify_is_git(path)
+    import asyncio
+    import os
     import subprocess
     import sys
     import time
 
+    from synap_git.mcp.server import SynapMCPServer
+
     abs_path = Path(path).resolve()
     pid_file = abs_path / ".synap" / "daemon.pid"
 
-    # 1. Check if daemon is already running for the repository
+    is_running = False
     if pid_file.exists():
         try:
             pid = int(pid_file.read_text(encoding="utf-8").strip())
@@ -662,59 +681,83 @@ def start(
                 hb = _read_daemon_heartbeat(abs_path)
                 if hb and "port" in hb:
                     console.print(f"[green]✓ UI available at http://127.0.0.1:{hb['port']}[/green]")
-                return
+                is_running = True
+                if not foreground:
+                    return
             else:
                 pid_file.unlink()
         except Exception as e:
             import structlog
 
-            structlog.get_logger().error("suppressed_error_caught", exc_info=True)
+            structlog.get_logger().error("suppressed_error_caught", error=str(e))
 
-    # 2. Spawn detached daemon process
-    cmd = [sys.executable, "-m", "synap_git.cli", "daemon-run", abs_path.as_posix()]
-    try:
-        if sys.platform == "win32":
-            subprocess.Popen(
-                cmd,
-                stdout=subprocess.DEVNULL,
-                stderr=subprocess.DEVNULL,
-                stdin=subprocess.DEVNULL,
-                creationflags=0x00000008,  # DETACHED_PROCESS
-            )
-        else:
-            subprocess.Popen(
-                cmd,
-                stdout=subprocess.DEVNULL,
-                stderr=subprocess.DEVNULL,
-                stdin=subprocess.DEVNULL,
-                start_new_session=True,
+    if not is_running:
+        # 2. Spawn detached daemon process
+        cmd = [sys.executable, "-m", "synap_git.cli", "daemon-run", abs_path.as_posix()]
+        try:
+            if sys.platform == "win32":
+                subprocess.Popen(
+                    cmd,
+                    stdout=subprocess.DEVNULL,
+                    stderr=subprocess.DEVNULL,
+                    stdin=subprocess.DEVNULL,
+                    creationflags=0x00000008,  # DETACHED_PROCESS
+                )
+            else:
+                subprocess.Popen(
+                    cmd,
+                    stdout=subprocess.DEVNULL,
+                    stderr=subprocess.DEVNULL,
+                    stdin=subprocess.DEVNULL,
+                    start_new_session=True,
+                )
+        except Exception as e:
+            console.print(f"[bold red]✗ Failed to start daemon:[/bold red] {e}")
+            raise typer.Exit(1)
+
+        success = False
+        with console.status(
+            "[yellow]Starting Synap daemon and awaiting health check...[/yellow]", spinner="dots"
+        ):
+            for _ in range(25):  # wait up to 5 seconds for initial heartbeat
+                time.sleep(0.2)
+                if pid_file.exists():
+                    hb = _read_daemon_heartbeat(abs_path)
+                    if hb:
+                        status = hb.get("status")
+                        if status in ("healthy", "degraded", "starting"):
+                            success = True
+                            port = hb.get("port", 9876)
+                            pid = int(hb.get("pid", 0))
+                            console.print(f"[green]✓ Synap daemon started (PID {pid})[/green]")
+                            if status == "starting":
+                                console.print(
+                                    "[yellow]ℹ Daemon is currently indexing in the background...[/yellow]"
+                                )
+                            else:
+                                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(
+                "[red]✗ Daemon started but did not report healthy status. Check logs in ~/.config/synap/logs/[/red]"
             )
-    except Exception as e:
-        console.print(f"[bold red]✗ Failed to start daemon:[/bold red] {e}")
-        raise typer.Exit(1)
+            raise typer.Exit(1)
 
-    success = False
-    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 foreground:
+            return
 
-    if not success:
-        console.print(
-            "[red]✗ Daemon started but did not report healthy status. Check logs in ~/.config/synap/logs/[/red]"
-        )
-        raise typer.Exit(1)
+    # 3. Start MCP Server in the foreground if --foreground flag passed
+    settings = _settings(path, json_output=True)
+    runtime = SynapRuntime(settings)
+    server = SynapMCPServer(runtime)
+    try:
+        asyncio.run(server.run())
+    except KeyboardInterrupt:
+        os._exit(0)
 
 
 @app.command("daemon-run", hidden=True)
@@ -820,7 +863,7 @@ def stop(
         except Exception as e:
             import structlog
 
-            structlog.get_logger().error("suppressed_error_caught", exc_info=True)
+            structlog.get_logger().error("suppressed_error_caught", error=str(e))
         success = not _is_process_running(pid)
 
     # Clean up lockfiles
@@ -1271,7 +1314,7 @@ def rollback(
     except Exception as e:
         import structlog
 
-        structlog.get_logger().error("suppressed_error_caught", exc_info=True)
+        structlog.get_logger().error("suppressed_error_caught", error=str(e))
 
     with console.status(
         f"[yellow]Reindexing repository to match {selected_commit}...[/yellow]", spinner="dots"
@@ -1346,7 +1389,7 @@ def repair(
         except Exception as e:
             import structlog
 
-            structlog.get_logger().error("suppressed_error_caught", exc_info=True)
+            structlog.get_logger().error("suppressed_error_caught", error=str(e))
 
     status_info = runtime.status()
     console.print(f"\n[green]✓ Recovery complete. {status_info.files} files restored.[/green]")
@@ -1464,34 +1507,52 @@ def doctor(
                 task_prov, completed=1, description=f"[red]✗ Unexpected error: {e}[/red]"
             )
 
-        task_daemon = progress.add_task("Checking Daemon Status...", total=1)
+        task_daemon = progress.add_task("Checking Daemon & REST API Status...", total=1)
         try:
+            import socket
+
+            import httpx
+
             daemon_info = _read_daemon_heartbeat(settings.repository_path)
-            if daemon_info:
-                status_str = daemon_info["status"].upper()
-                if status_str == "HEALTHY":
-                    progress.update(
-                        task_daemon,
-                        completed=1,
-                        description=f"[green]✓ Daemon active and healthy (PID {daemon_info['pid']}, uptime {daemon_info['uptime_seconds']}s)[/green]",
-                    )
-                elif status_str == "STALE":
-                    progress.update(
-                        task_daemon,
-                        completed=1,
-                        description="[yellow]⚠ Daemon heartbeat file exists but is stale (not running?)[/yellow]",
-                    )
-                else:
+            port = daemon_info.get("port", 9876) if daemon_info else 9876
+
+            # Test port availability
+            with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+                s.settimeout(0.5)
+                port_in_use = s.connect_ex(("127.0.0.1", port)) == 0
+
+            if daemon_info and port_in_use:
+                try:
+                    r = httpx.get(f"http://127.0.0.1:{port}/api/status", timeout=2.0)
+                    if r.status_code == 200:
+                        progress.update(
+                            task_daemon,
+                            completed=1,
+                            description=f"[green]✓ Daemon active & REST API healthy (PID {daemon_info['pid']}, port {port})[/green]",
+                        )
+                    else:
+                        progress.update(
+                            task_daemon,
+                            completed=1,
+                            description=f"[yellow]⚠ Daemon running on port {port} but REST API returned HTTP {r.status_code}[/yellow]",
+                        )
+                except Exception as ex:
                     progress.update(
                         task_daemon,
                         completed=1,
-                        description=f"[red]✗ Daemon degraded: {daemon_info.get('last_error')}[/red]",
+                        description=f"[yellow]⚠ Daemon running on port {port} but API check failed: {ex}[/yellow]",
                     )
+            elif daemon_info:
+                progress.update(
+                    task_daemon,
+                    completed=1,
+                    description=f"[yellow]⚠ Heartbeat found for PID {daemon_info['pid']} but port {port} is not listening[/yellow]",
+                )
             else:
                 progress.update(
                     task_daemon,
                     completed=1,
-                    description="[yellow]⚠ Daemon inactive (not running). Start it using `synap start`[/yellow]",
+                    description=f"[yellow]⚠ Daemon inactive (port {port} available). Start using `synap start`[/yellow]",
                 )
         except Exception as e:
             progress.update(
@@ -1509,21 +1570,6 @@ def run(
     start(path)
 
 
-@mcp_app.command("start")
-def mcp_start(
-    path: Annotated[str, typer.Argument(help="Repository path.")] = ".",
-) -> None:
-    """Start the MCP server."""
-    settings = _settings(path, json_output=True)
-    runtime = SynapRuntime(settings)
-    runtime.bootstrap()
-
-    from synap_git.mcp.server import SynapMCPServer
-
-    server = SynapMCPServer(runtime)
-    asyncio.run(server.run())
-
-
 @mcp_app.command("config")
 def mcp_config(
     path: Annotated[str, typer.Argument(help="Repository path.")] = ".",
@@ -1534,11 +1580,7 @@ def mcp_config(
 
     config = {
         "mcpServers": {
-            "synap": {
-                "command": sys.executable,
-                "args": ["-m", "synap_git.cli", "mcp", "start", abs_path],
-                "autoConnect": True,
-            }
+            "synap": {"command": sys.executable, "args": ["-m", "synap_git.cli", "start", abs_path]}
         }
     }
     typer.echo(json.dumps(config, indent=2))
@@ -2154,3 +2196,16 @@ def wiki_show(
 
     content = wiki_path.read_text(encoding="utf-8")
     console.print(Markdown(content))
+
+
+@wiki_app.command("retry")
+def wiki_retry(
+    path: Annotated[str, typer.Argument(help="Repository path.")] = ".",
+) -> None:
+    """Requeue all permanently failed wiki tasks back to pending state."""
+    runtime = SynapRuntime(_settings(path))
+    count = runtime.store.retry_failed_wiki_queue()
+    if count > 0:
+        console.print(f"[green]✓ Requeued {count} failed wiki tasks to pending state.[/green]")
+    else:
+        console.print("[yellow]No failed wiki tasks found in queue.[/yellow]")

{synap_git-2.1.6 → synap_git-2.2.0}/src/synap_git/config.py

@@ -50,7 +50,6 @@ class SynapSettings(BaseSettings):
     repository_path: Path = Field(default=Path(), description="Repository root.")
     state_path: Path = Field(default=Path(".synap"), description="Local runtime state.")
     sqlite_path: Path | None = None
-    object_path: Path | None = None
     log_path: Path | None = None
 
     logging_mode: LoggingMode = LoggingMode.HUMAN
@@ -150,7 +149,6 @@ class SynapSettings(BaseSettings):
         self.repository_path = repository_path
         self.state_path = state_path.resolve()
         self.sqlite_path = self._resolve_optional_path(self.sqlite_path, "synap.db")
-        self.object_path = self._resolve_optional_path(self.object_path, "objects")
         self.log_path = self._resolve_optional_path(self.log_path, "logs")
 
         if self.profile is RuntimeProfile.TEST:
@@ -166,10 +164,6 @@ class SynapSettings(BaseSettings):
 
     def ensure_directories(self) -> None:
         self.state_path.mkdir(parents=True, exist_ok=True)
-        if self.object_path:
-            self.object_path.mkdir(parents=True, exist_ok=True)
-        if self.log_path:
-            self.log_path.mkdir(parents=True, exist_ok=True)
 
     def validate_configuration(self) -> list[str]:
         errors = []

{synap_git-2.1.6 → synap_git-2.2.0}/src/synap_git/diagnostics/logger.py

@@ -56,6 +56,10 @@ def configure_logging(settings: SynapSettings) -> None:
     # Set up stream handler (stderr)
     stream_handler = logging.StreamHandler(sys.stderr)
     stream_handler.setFormatter(logging.Formatter("%(message)s"))
+    if settings.log_level.upper() == "DEBUG":
+        stream_handler.setLevel(logging.DEBUG)
+    else:
+        stream_handler.setLevel(logging.WARNING)
     root_logger.addHandler(stream_handler)
 
     root_logger.setLevel(getattr(logging, settings.log_level.upper(), logging.INFO))

{synap_git-2.1.6 → synap_git-2.2.0}/src/synap_git/git/state.py

@@ -131,7 +131,7 @@ class GitRepository:
             except Exception as e:
                 import structlog
 
-                structlog.get_logger().error("suppressed_error_caught", exc_info=True)
+                structlog.get_logger().error("suppressed_error_caught", error=str(e))
 
             if len(current.commit_parent_hashes) > 1:
                 return GitChange(kind=GitChangeKind.MERGE, previous=previous, current=current)