synap-git 2.1.5__tar.gz → 2.1.7__tar.gz

{synap_git-2.1.5 → synap_git-2.1.7}/.gitignore

@@ -25,3 +25,7 @@ build/
 .synapse/
 .synapse/*-wal
 .synapse/*-shm
+config.json
+status.json
+fix_exc.py
+test_embed.py

{synap_git-2.1.5 → synap_git-2.1.7}/CHANGELOG.md

@@ -5,7 +5,28 @@ 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.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
+
+### Added
+- **Universal Language Expansion**: Expanded tree-sitter AST parsing support from 4 hardcoded languages to dynamically supporting over ~50 languages using `tree-sitter-languages`. Also added dynamic shebang detection (`#!`) to parse extensionless scripts as python, ruby, node, and bash scripts.
+- **API Rate Limiting**: Implemented a global `RateLimitedProvider` to throttle LLM and embedding calls to 3 requests per second to mitigate resource exhaustion on the diagnostic API.
+
+### Fixed
+- **Broad Exception Handling**: Eradicated remaining `except Exception:` blocks across diagnostics, daemon execution, indexer scanning, and module resolution, and replaced them with `OSError`, `sqlite3.Error`, and specific errors to prevent silent data corruption.
+- **Async Sleep Compatibility**: Fixed thread-blocking `time.sleep()` in LLM retries by delegating to `anyio.from_thread.run(anyio.sleep)` if invoked inside FastMCP worker threads.
+- **Edge Resolution & Source Paths**: Added support for resolving Javascript, Java, C++, Ruby, and more during import/edge resolution.
+- **Module Path Trimming**: Improved module path mapping by trimming `internal/`, `source/`, `packages/`, `main/`, `java/`, `kotlin/`, `scala/` from module keys.
+- **Wipe Confirmation**: Added a `--yes` confirmation bypass flag for `synap wipe` and enforced safety confirmation in non-interactive terminals.
+- **Metadata Fixes**: Corrected repository URLs in `pyproject.toml` to correctly point to `synapse` instead of `synap-git`.
 
 ### Refactored
 - **Daemon Teardown**: Refactored the forceful SIGTERM daemon teardown logic to safely toggle via `force_exit=True` rather than a blanket catch-all. Makes programmatic `daemon.stop()` safer without blocking terminal UI interactions.

{synap_git-2.1.5 → synap_git-2.1.7}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: synap-git
-Version: 2.1.5
+Version: 2.1.7
 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
-Project-URL: Issues, https://github.com/saahilpal/synap-git/issues
-Project-URL: Changelog, https://github.com/saahilpal/synap-git/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://github.com/saahilpal/synapse
+Project-URL: Repository, https://github.com/saahilpal/synapse
+Project-URL: Issues, https://github.com/saahilpal/synapse/issues
+Project-URL: Changelog, https://github.com/saahilpal/synapse/blob/main/CHANGELOG.md
 Author: Synap contributors
 License: Apache-2.0
 License-File: LICENSE.md
@@ -339,8 +339,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 +372,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 +431,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"]
     }
   }
 }
@@ -443,15 +441,19 @@ synap mcp config .
 
 ## Supported Languages
 
-Synap processes syntax for the following formats:
+Synap now processes syntax dynamically for **over 50 programming languages** via `tree-sitter-languages`, including:
+
 * **Python** (`.py`)
-* **JavaScript / JSX** (`.js`, `.jsx`)
-* **TypeScript / TSX** (`.ts`, `.tsx`)
-* **Go** (`.go`)
-* **Rust** (`.rs`)
-* **Java** (`.java`)
-* **C / C++** (`.cpp`, `.cc`, `.cxx`, `.hpp`, `.h`)
-* **Ruby** (`.rb`)
+* **JavaScript / TypeScript** (`.js`, `.jsx`, `.ts`, `.tsx`)
+* **C / C++ / C#** (`.c`, `.cpp`, `.h`, `.hpp`, `.cs`)
+* **Java / Kotlin / Scala** (`.java`, `.kt`, `.kts`, `.scala`)
+* **Go / Rust / Swift** (`.go`, `.rs`, `.swift`)
+* **Ruby / PHP / Perl** (`.rb`, `.php`, `.pl`)
+* **Shell Scripts** (`.sh`, `.bash`, or via `#!` shebang detection)
+* **Data / Config** (`.sql`, `.json`, `.yaml`, `.toml`, `.xml`)
+* **Web** (`.html`, `.css`, `.scss`)
+
+Even extensionless scripts are gracefully detected via shebang parsing. Missing grammars automatically degrade gracefully to plaintext indexing.
 
 ---
 

{synap_git-2.1.5 → synap_git-2.1.7}/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"]
     }
   }
 }
@@ -393,15 +391,19 @@ synap mcp config .
 
 ## Supported Languages
 
-Synap processes syntax for the following formats:
+Synap now processes syntax dynamically for **over 50 programming languages** via `tree-sitter-languages`, including:
+
 * **Python** (`.py`)
-* **JavaScript / JSX** (`.js`, `.jsx`)
-* **TypeScript / TSX** (`.ts`, `.tsx`)
-* **Go** (`.go`)
-* **Rust** (`.rs`)
-* **Java** (`.java`)
-* **C / C++** (`.cpp`, `.cc`, `.cxx`, `.hpp`, `.h`)
-* **Ruby** (`.rb`)
+* **JavaScript / TypeScript** (`.js`, `.jsx`, `.ts`, `.tsx`)
+* **C / C++ / C#** (`.c`, `.cpp`, `.h`, `.hpp`, `.cs`)
+* **Java / Kotlin / Scala** (`.java`, `.kt`, `.kts`, `.scala`)
+* **Go / Rust / Swift** (`.go`, `.rs`, `.swift`)
+* **Ruby / PHP / Perl** (`.rb`, `.php`, `.pl`)
+* **Shell Scripts** (`.sh`, `.bash`, or via `#!` shebang detection)
+* **Data / Config** (`.sql`, `.json`, `.yaml`, `.toml`, `.xml`)
+* **Web** (`.html`, `.css`, `.scss`)
+
+Even extensionless scripts are gracefully detected via shebang parsing. Missing grammars automatically degrade gracefully to plaintext indexing.
 
 ---
 

{synap_git-2.1.5 → synap_git-2.1.7}/pyproject.toml

@@ -40,10 +40,10 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/saahilpal/synap-git"
-Repository = "https://github.com/saahilpal/synap-git"
-Issues = "https://github.com/saahilpal/synap-git/issues"
-Changelog = "https://github.com/saahilpal/synap-git/blob/main/CHANGELOG.md"
+Homepage = "https://github.com/saahilpal/synapse"
+Repository = "https://github.com/saahilpal/synapse"
+Issues = "https://github.com/saahilpal/synapse/issues"
+Changelog = "https://github.com/saahilpal/synapse/blob/main/CHANGELOG.md"
 
 
 [project.optional-dependencies]

{synap_git-2.1.5 → synap_git-2.1.7}/src/synap_git/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "2.1.5"
+__version__ = "2.1.7"

{synap_git-2.1.5 → synap_git-2.1.7}/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", error=str(e), 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.7/src/synap_git/cli/checkpoint.py

@@ -0,0 +1,125 @@
+from __future__ import annotations
+
+import json
+import uuid
+from datetime import datetime
+from typing import Annotated
+
+import typer
+from rich.table import Table
+
+from synap_git.cli.main import (
+    _settings,
+    console,
+)
+from synap_git.indexer.engine import SynapRuntime
+
+app = typer.Typer(help="Checkpoint commands.", no_args_is_help=True)
+
+
+@app.command("create")
+def checkpoint_create(
+    path: Annotated[str, typer.Argument(help="Repository path.")] = ".",
+    doing: Annotated[
+        str, typer.Option(help="What the agent is currently doing.")
+    ] = "Manual snapshot",
+    files: Annotated[str, typer.Option(help="Comma-separated list of changed files.")] = "",
+    next_step: Annotated[str, typer.Option(help="The next step to be taken.")] = "",
+    blockers: Annotated[str, typer.Option(help="Current blockers or obstacles.")] = "",
+) -> None:
+    """Create a new context checkpoint."""
+    runtime = SynapRuntime(_settings(path))
+
+    checkpoint_id = str(uuid.uuid4())
+    status = runtime.status()
+    branch = status.branch
+    commit = status.git_commit or "unknown"
+
+    file_list = [f.strip() for f in files.split(",") if f.strip()]
+
+    runtime.store.put_checkpoint(
+        checkpoint_id=checkpoint_id,
+        branch=branch,
+        commit_hash=commit,
+        doing=doing,
+        changed_files=json.dumps(file_list),
+        next_step=next_step,
+        blockers=blockers,
+    )
+    console.print(f"[green]✓ Checkpoint {checkpoint_id} created for branch '{branch}'.[/green]")
+
+
+@app.command("list")
+def checkpoint_list(
+    path: Annotated[str, typer.Argument(help="Repository path.")] = ".",
+) -> None:
+    """List checkpoints for the active branch."""
+    runtime = SynapRuntime(_settings(path))
+    status = runtime.status()
+    branch = status.branch
+    cps = runtime.store.get_checkpoints(branch)
+
+    if not cps:
+        console.print(f"[yellow]No checkpoints found for branch '{branch}'.[/yellow]")
+        return
+
+    table = Table(
+        title=f"Checkpoints for branch '{branch}'", show_header=True, header_style="bold cyan"
+    )
+    table.add_column("Checkpoint ID")
+    table.add_column("Commit Hash")
+    table.add_column("Doing")
+    table.add_column("Changed Files")
+    table.add_column("Created At")
+
+    for cp in cps:
+        created = datetime.fromtimestamp(cp["created_at"]).isoformat()
+        try:
+            ch_files = ", ".join(json.loads(cp["changed_files"]))
+        except Exception:
+            ch_files = cp["changed_files"]
+        table.add_row(
+            cp["checkpoint_id"][:16] + "…",
+            cp["commit_hash"][:7],
+            cp["doing"],
+            ch_files if ch_files else "None",
+            created,
+        )
+    console.print(table)
+
+
+@app.command("restore")
+def checkpoint_restore(
+    checkpoint_id: Annotated[
+        str, typer.Argument(help="The ID of the checkpoint to restore (defaults to latest).")
+    ] = "latest",
+    path: Annotated[str, typer.Argument(help="Repository path.")] = ".",
+) -> None:
+    """Restore and show details of a checkpoint."""
+    runtime = SynapRuntime(_settings(path))
+    status = runtime.status()
+    branch = status.branch
+
+    if checkpoint_id == "latest":
+        cp = runtime.store.get_latest_checkpoint(branch)
+    else:
+        cp = runtime.store.get_checkpoint(checkpoint_id)
+
+    if not cp:
+        console.print(f"[red]✗ Checkpoint '{checkpoint_id}' not found.[/red]")
+        raise typer.Exit(1)
+
+    console.print(f"[bold green]✓ Checkpoint '{cp['checkpoint_id']}' details:[/bold green]")
+    console.print(f"  [bold]Branch:[/bold] {cp['branch']}")
+    console.print(f"  [bold]Commit:[/bold] {cp['commit_hash']}")
+    console.print(f"  [bold]Doing:[/bold] {cp['doing']}")
+    try:
+        ch_files = ", ".join(json.loads(cp["changed_files"]))
+    except Exception:
+        ch_files = cp["changed_files"]
+    console.print(f"  [bold]Changed Files:[/bold] {ch_files if ch_files else 'None'}")
+    console.print(f"  [bold]Next Step:[/bold] {cp['next_step'] or 'None'}")
+    console.print(f"  [bold]Blockers:[/bold] {cp['blockers'] or 'None'}")
+    console.print(
+        f"  [bold]Created At:[/bold] {datetime.fromtimestamp(cp['created_at']).isoformat()}"
+    )

synap_git-2.1.7/src/synap_git/cli/lessons.py

@@ -0,0 +1,132 @@
+from __future__ import annotations
+
+from typing import Annotated
+
+import questionary
+import typer
+from rich.panel import Panel
+
+from synap_git.cli.main import (
+    _settings,
+    console,
+)
+from synap_git.indexer.engine import SynapRuntime
+
+app = typer.Typer(help="Lessons commands.", no_args_is_help=True)
+
+
+@app.command("approve")
+def lessons_approve(
+    lesson_id: Annotated[str, typer.Argument(help="The ID of the lesson to approve.")],
+    path: Annotated[str, typer.Argument(help="Repository path.")] = ".",
+) -> None:
+    """Approve a pending lesson."""
+    runtime = SynapRuntime(_settings(path))
+    # Fetch to ensure it exists and is pending
+    pending = runtime.store.get_lessons("pending")
+    target = next((lesson for lesson in pending if lesson["lesson_id"] == lesson_id), None)
+
+    if not target:
+        console.print(f"[red]✗ Pending lesson {lesson_id} not found.[/red]")
+        raise typer.Exit(1)
+
+    runtime.store.update_lesson(lesson_id, target["why_failed"], "approved", actor="cli_user")
+    console.print(f"[green]✓ Lesson {lesson_id} approved. Memory updated.[/green]")
+
+
+@app.command("review")
+def lessons_review(
+    path: Annotated[str, typer.Argument(help="Repository path.")] = ".",
+) -> None:
+    """Interactively review and manage pending lessons."""
+
+    runtime = SynapRuntime(_settings(path))
+    pending = runtime.store.get_lessons("pending")
+
+    if not pending:
+        console.print("[yellow]No pending lessons to review.[/yellow]")
+        return
+
+    console.print(f"[bold cyan]Reviewing {len(pending)} pending lessons...[/bold cyan]\n")
+
+    approved_count = 0
+    rejected_count = 0
+    skipped_count = 0
+
+    for lesson in pending:
+        lesson_id = lesson["lesson_id"]
+
+        # Build detail view
+        details = (
+            f"[bold]Revert Commit:[/bold] {lesson['revert_commit'][:8]}\n"
+            f"[bold]Reverted From:[/bold] {lesson['reverted_from'][:8]}\n"
+            f"[bold]Files Affected:[/bold] {lesson['files_affected']}\n"
+            f"[bold]What Failed:[/bold] {lesson['what_failed']}\n"
+            f"[bold]Proposed Lesson:[/bold] {lesson['why_failed']}"
+        )
+
+        console.print(Panel(details, title=f"Lesson {lesson_id[:8]}", expand=False))
+
+        choice = questionary.select(
+            "Action:",
+            choices=[
+                questionary.Choice("Approve", value="approve"),
+                questionary.Choice("Edit & Approve", value="edit"),
+                questionary.Choice("Reject", value="reject"),
+                questionary.Choice("Skip", value="skip"),
+            ],
+        ).ask()
+
+        if choice == "approve":
+            runtime.store.update_lesson(
+                lesson_id, lesson["why_failed"], "approved", actor="cli_user"
+            )
+            console.print("[green]✓ Approved.[/green]\n")
+            approved_count += 1
+        elif choice == "edit":
+            edited = questionary.text("Edit lesson text:", default=lesson["why_failed"]).ask()
+            if edited:
+                runtime.store.update_lesson(lesson_id, edited, "approved", actor="cli_user")
+                console.print("[green]✓ Edited and Approved.[/green]\n")
+                approved_count += 1
+            else:
+                console.print("[yellow]Skipping edit.[/yellow]\n")
+                skipped_count += 1
+        elif choice == "reject":
+            runtime.store.update_lesson(
+                lesson_id, lesson["why_failed"], "rejected", actor="cli_user"
+            )
+            console.print("[red]✗ Rejected.[/red]\n")
+            rejected_count += 1
+        elif choice == "skip":
+            console.print("[yellow]Skipped.[/yellow]\n")
+            skipped_count += 1
+        else:
+            console.print("[yellow]Aborting review.[/yellow]")
+            break
+
+    console.print("[bold cyan]Review Summary:[/bold cyan]")
+    console.print(f"  [green]Approved:[/green] {approved_count}")
+    console.print(f"  [red]Rejected:[/red] {rejected_count}")
+    console.print(f"  [yellow]Skipped:[/yellow]  {skipped_count}")
+
+
+@app.command("reject")
+def lessons_reject(
+    lesson_id: Annotated[str, typer.Argument(help="The ID of the lesson to reject.")],
+    path: Annotated[str, typer.Argument(help="Repository path.")] = ".",
+) -> None:
+    """Reject a pending or approved lesson."""
+    runtime = SynapRuntime(_settings(path))
+    pending = runtime.store.get_lessons("pending")
+    approved = runtime.store.get_lessons("approved")
+    target = next(
+        (lesson for lesson in pending + approved if lesson["lesson_id"] == lesson_id), None
+    )
+
+    if not target:
+        console.print(f"[red]✗ Lesson {lesson_id} not found in pending or approved queues.[/red]")
+        raise typer.Exit(1)
+
+    runtime.store.update_lesson(lesson_id, target["why_failed"], "rejected", actor="cli_user")
+    console.print(f"[yellow]✓ Lesson {lesson_id} rejected. Memory updated.[/yellow]")