serpentine-parser 0.3.2__tar.gz → 0.4.0__tar.gz

serpentine_parser-0.3.2/README.md → serpentine_parser-0.4.0/PKG-INFO

@@ -1,3 +1,40 @@
+Metadata-Version: 2.4
+Name: serpentine-parser
+Version: 0.4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Utilities
+Requires-Dist: watchdog>=6.0.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: starlette>=1.3.1
+Requires-Dist: uvicorn[standard]>=0.30.0
+Requires-Dist: websockets>=12.0
+Requires-Dist: pygit2>=1.15 ; extra == 'git'
+Provides-Extra: git
+Provides-Extra: hg
+Provides-Extra: svn
+License-File: LICENSE
+Summary: Fast dependency graph analysis and visualization for Python, JavaScript/TypeScript, Rust, and Terraform projects
+Keywords: dependency-graph,visualization,static-analysis,python,javascript,rust,terraform,tree-sitter
+Author: Christopher Garretty
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/serpentine-parser/serpentine
+Project-URL: Issues, https://github.com/serpentine-parser/serpentine/issues
+Project-URL: Repository, https://github.com/serpentine-parser/serpentine
+
 <p align="center">
   <img src="frontend/public/logo.svg" alt="Serpentine" width="64" />
 </p>
@@ -18,6 +55,7 @@ Serpentine builds a **code reference graph** for Python, JavaScript/TypeScript,
 - **Full reference resolution**: Traces calls, type annotations, assignments, and inheritance — not just import edges
 - **Interactive graph**: Expandable nodes, search, pan/zoom, collapsible modules
 - **Real-time updates**: File watcher pushes changes via WebSocket
+- **VCS integration**: Compare any two git refs and see added, modified, and deleted nodes highlighted on the graph
 - **Agent-ready CLI**: Structured JSON output with selectors for use in AI agent workflows
 
 ### What counts as a code reference?
@@ -307,6 +345,52 @@ Each edge has a `from` and `to` field with node IDs, and a `type` field:
 
 ---
 
+## VCS Integration
+
+When Serpentine is run inside a git repository, it automatically detects available refs (branches, tags, and recent commits) and enables the **compare** toolbar in the UI.
+
+### Comparing refs
+
+Click the compare toolbar to select a baseline ref and a target ref. Serpentine analyzes the graph at each ref and overlays change status on every node:
+
+| Status | Meaning |
+|---|---|
+| `modified` | Node exists in both refs but its dependencies changed |
+| `added` | Node exists in the target ref but not the baseline |
+| `deleted` | Node existed in the baseline ref but was removed |
+
+Unchanged nodes remain visible for context.
+
+### Filtering by state
+
+Use the `state:` selector method in the search bar to filter the graph to only changed nodes:
+
+```
+state:modified
+state:added
+state:deleted
+```
+
+Selectors compose with all graph operators:
+
+```
+# All nodes modified on the current branch, plus their upstream dependencies
++state:modified
+
+# Full connected component of every added node
+@state:added
+```
+
+### Checkpoints
+
+The **checkpoint** button marks the current live graph state as the comparison baseline. This is useful when you want to track changes made during a session rather than comparing against a git ref.
+
+### Configuration
+
+Files excluded via `.serpentine.yml` (`exclude_dirs`, `exclude_patterns`) are excluded from VCS snapshot analysis as well — ensuring consistent results between live analysis and historical comparison.
+
+---
+
 ## Configuration
 
 Serpentine looks for `.serpentine.yml` or `serpentine.yml` in the project root. All settings are optional.
@@ -448,3 +532,4 @@ These three events are the minimum required for the graph builder to resolve all
 ## License
 
 [Apache 2.0](LICENSE)
+

serpentine_parser-0.3.2/PKG-INFO → serpentine_parser-0.4.0/README.md

@@ -1,36 +1,3 @@
-Metadata-Version: 2.4
-Name: serpentine-parser
-Version: 0.3.2
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Environment :: Web Environment
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Rust
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: Utilities
-Requires-Dist: watchdog>=6.0.0
-Requires-Dist: click>=8.1.0
-Requires-Dist: starlette>=0.38.0
-Requires-Dist: uvicorn[standard]>=0.30.0
-Requires-Dist: websockets>=12.0
-License-File: LICENSE
-Summary: Fast dependency graph analysis and visualization for Python, JavaScript/TypeScript, Rust, and Terraform projects
-Keywords: dependency-graph,visualization,static-analysis,python,javascript,rust,terraform,tree-sitter
-Author: Christopher Garretty
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-Project-URL: Homepage, https://github.com/serpentine-parser/serpentine
-Project-URL: Issues, https://github.com/serpentine-parser/serpentine/issues
-Project-URL: Repository, https://github.com/serpentine-parser/serpentine
-
 <p align="center">
   <img src="frontend/public/logo.svg" alt="Serpentine" width="64" />
 </p>
@@ -51,6 +18,7 @@ Serpentine builds a **code reference graph** for Python, JavaScript/TypeScript,
 - **Full reference resolution**: Traces calls, type annotations, assignments, and inheritance — not just import edges
 - **Interactive graph**: Expandable nodes, search, pan/zoom, collapsible modules
 - **Real-time updates**: File watcher pushes changes via WebSocket
+- **VCS integration**: Compare any two git refs and see added, modified, and deleted nodes highlighted on the graph
 - **Agent-ready CLI**: Structured JSON output with selectors for use in AI agent workflows
 
 ### What counts as a code reference?
@@ -340,6 +308,52 @@ Each edge has a `from` and `to` field with node IDs, and a `type` field:
 
 ---
 
+## VCS Integration
+
+When Serpentine is run inside a git repository, it automatically detects available refs (branches, tags, and recent commits) and enables the **compare** toolbar in the UI.
+
+### Comparing refs
+
+Click the compare toolbar to select a baseline ref and a target ref. Serpentine analyzes the graph at each ref and overlays change status on every node:
+
+| Status | Meaning |
+|---|---|
+| `modified` | Node exists in both refs but its dependencies changed |
+| `added` | Node exists in the target ref but not the baseline |
+| `deleted` | Node existed in the baseline ref but was removed |
+
+Unchanged nodes remain visible for context.
+
+### Filtering by state
+
+Use the `state:` selector method in the search bar to filter the graph to only changed nodes:
+
+```
+state:modified
+state:added
+state:deleted
+```
+
+Selectors compose with all graph operators:
+
+```
+# All nodes modified on the current branch, plus their upstream dependencies
++state:modified
+
+# Full connected component of every added node
+@state:added
+```
+
+### Checkpoints
+
+The **checkpoint** button marks the current live graph state as the comparison baseline. This is useful when you want to track changes made during a session rather than comparing against a git ref.
+
+### Configuration
+
+Files excluded via `.serpentine.yml` (`exclude_dirs`, `exclude_patterns`) are excluded from VCS snapshot analysis as well — ensuring consistent results between live analysis and historical comparison.
+
+---
+
 ## Configuration
 
 Serpentine looks for `.serpentine.yml` or `serpentine.yml` in the project root. All settings are optional.
@@ -481,4 +495,3 @@ These three events are the minimum required for the graph builder to resolve all
 ## License
 
 [Apache 2.0](LICENSE)
-

{serpentine_parser-0.3.2 → serpentine_parser-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "serpentine-parser"
-version = "0.3.2"
+version = "0.4.0"
 description = "Fast dependency graph analysis and visualization for Python, JavaScript/TypeScript, Rust, and Terraform projects"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -30,11 +30,16 @@ classifiers = [
 dependencies = [
     "watchdog>=6.0.0",
     "click>=8.1.0",
-    "starlette>=0.38.0",
+    "starlette>=1.3.1",
     "uvicorn[standard]>=0.30.0",
     "websockets>=12.0",
 ]
 
+[project.optional-dependencies]
+git = ["pygit2>=1.15"]
+hg  = []
+svn = []
+
 [project.urls]
 Homepage = "https://github.com/serpentine-parser/serpentine"
 Repository = "https://github.com/serpentine-parser/serpentine"

{serpentine_parser-0.3.2 → serpentine_parser-0.4.0}/rust/Cargo.lock

@@ -184,9 +184,9 @@ dependencies = [
 
 [[package]]
 name = "quote"
-version = "1.0.45"
+version = "1.0.46"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+checksum = "dfbc457d0c7a0759a614551b11a6409e5951f6c7537be1f1b7682b9ae9230368"
 dependencies = [
  "proc-macro2",
 ]
@@ -286,7 +286,7 @@ dependencies = [
 
 [[package]]
 name = "serpentine"
-version = "0.3.2"
+version = "0.4.0"
 dependencies = [
  "indexmap",
  "pyo3",

{serpentine_parser-0.3.2 → serpentine_parser-0.4.0}/rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "serpentine"
-version = "0.3.2"
+version = "0.4.0"
 edition = "2021"
 license = "Apache-2.0"
 

{serpentine_parser-0.3.2 → serpentine_parser-0.4.0}/src/serpentine/__init__.py

@@ -22,7 +22,7 @@ Or programmatically:
     app = create_app(state)
 """
 
-__version__ = "0.3.2"
+__version__ = "0.4.0"
 
 from serpentine.server import create_app
 from serpentine.state import GraphStateManager

{serpentine_parser-0.3.2 → serpentine_parser-0.4.0}/src/serpentine/cache.py

@@ -180,3 +180,76 @@ class PerFileCacheManager:
             entry.write_text(results_json, encoding="utf-8")
         except Exception as e:
             logger.debug(f"Per-file cache save failed for {file_path}: {e}")
+
+
+REFS_CACHE_SUBDIR = "refs"
+# Bump when VCS ref cache format changes in a breaking way.
+VCS_REF_CACHE_VERSION = 1
+
+
+class VcsRefCacheManager:
+    """
+    Cache for graphs computed from historical VCS commits.
+
+    Stored under .serpentine/refs/<key>.json, keyed by
+    sha256(commit_hash + ":" + config_fingerprint)[:24].
+
+    Historical commits are immutable so entries never expire — only
+    invalidated when the analyzer binary changes (same sentinel pattern
+    as PerFileCacheManager).
+    """
+
+    def __init__(self, project_path: Path) -> None:
+        self._cache_dir = project_path / CACHE_DIR / REFS_CACHE_SUBDIR
+        self._ensure_version()
+
+    def _version_tag(self) -> str:
+        package_dir = Path(__file__).parent
+        binary = _find_analyzer_binary(package_dir)
+        binary_mtime: int = 0
+        if binary:
+            try:
+                binary_mtime = binary.stat().st_mtime_ns
+            except OSError:
+                pass
+        return f"{VCS_REF_CACHE_VERSION}:{binary_mtime}"
+
+    def _ensure_version(self) -> None:
+        version_file = self._cache_dir / ".version"
+        expected = self._version_tag()
+        try:
+            if version_file.exists() and version_file.read_text(encoding="utf-8").strip() == expected:
+                return
+        except Exception:
+            pass
+        try:
+            if self._cache_dir.exists():
+                shutil.rmtree(self._cache_dir)
+        except Exception as e:
+            logger.debug(f"VCS ref cache clear failed: {e}")
+        try:
+            self._cache_dir.mkdir(parents=True, exist_ok=True)
+            version_file.write_text(expected + "\n", encoding="utf-8")
+        except Exception as e:
+            logger.debug(f"VCS ref cache version write failed: {e}")
+
+    def _entry_path(self, commit_hash: str, config_fp: str) -> Path:
+        key = hashlib.sha256(f"{commit_hash}:{config_fp}".encode()).hexdigest()[:24]
+        return self._cache_dir / f"{key}.json"
+
+    def get(self, commit_hash: str, config_fp: str) -> str | None:
+        try:
+            entry = self._entry_path(commit_hash, config_fp)
+            if entry.exists():
+                return entry.read_text(encoding="utf-8")
+        except Exception as e:
+            logger.debug(f"VCS ref cache load failed: {e}")
+        return None
+
+    def put(self, commit_hash: str, config_fp: str, graph_json: str) -> None:
+        try:
+            self._cache_dir.mkdir(parents=True, exist_ok=True)
+            entry = self._entry_path(commit_hash, config_fp)
+            entry.write_text(graph_json, encoding="utf-8")
+        except Exception as e:
+            logger.debug(f"VCS ref cache save failed: {e}")

{serpentine_parser-0.3.2 → serpentine_parser-0.4.0}/src/serpentine/cli.py

@@ -23,9 +23,12 @@ import click
 import uvicorn
 
 from serpentine import __version__
+from serpentine.cache import VcsRefCacheManager
 from serpentine.selector import GraphSelector, filter_by_state
 from serpentine.server import create_app
 from serpentine.state import GraphStateManager
+from serpentine.vcs.backend import detect_backend
+from serpentine.vcs.manager import VcsManager
 from serpentine.watcher import FileWatcher
 
 _DEFAULT_CONFIG_YAML = """\
@@ -135,8 +138,15 @@ def serve(
         f"✅ Found {state_manager.node_count} nodes, {state_manager.edge_count} edges"
     )
 
+    # Set up VCS manager if a backend is available
+    vcs_manager: VcsManager | None = None
+    backend = detect_backend(project_path)
+    if backend is not None:
+        vcs_manager = VcsManager(backend, VcsRefCacheManager(project_path), state_manager.config)
+        click.echo("🔀 VCS integration enabled")
+
     # Create the web application
-    app = create_app(state_manager, static_dir=_get_static_dir())
+    app = create_app(state_manager, static_dir=_get_static_dir(), vcs_manager=vcs_manager)
 
     # Set up file watcher if enabled
     watcher: FileWatcher | None = None
@@ -255,6 +265,13 @@ def serve(
     default=False,
     help="Include assignment nodes in text output (default: excluded, only with --format text)",
 )
+@click.option(
+    "--compare",
+    "compare_ref",
+    type=str,
+    default=None,
+    help="VCS ref to compare against (branch, tag, or commit hash). Shows added/removed/modified nodes.",
+)
 def analyze(
     path: str,
     output: str | None,
@@ -270,6 +287,7 @@ def analyze(
     fmt: str,
     source: bool,
     include_assignments: bool,
+    compare_ref: str | None,
 ) -> None:
     """Analyze a project and output the code reference graph.
 
@@ -287,6 +305,20 @@ def analyze(
     state_manager = GraphStateManager(project_path)
     state_manager.analyze_project(project_path, force_fresh=source)
 
+    if compare_ref is not None:
+        backend = detect_backend(project_path)
+        if backend is None:
+            raise click.ClickException(
+                "No VCS backend found. Is this a git repo? "
+                "Install git support with: pip install serpentine[git]"
+            )
+        try:
+            vcs_manager = VcsManager(backend, VcsRefCacheManager(project_path), state_manager.config)
+            from_graph_json = vcs_manager.get_graph_at(compare_ref)
+        except Exception as e:
+            raise click.ClickException(f"Could not resolve ref '{compare_ref}': {e}") from e
+        state_manager.set_vcs_comparison(from_graph_json, to_graph_json=None)
+
     # Get the graph data as a dict for post-processing
     graph_data = state_manager.get_graph_data()
 
@@ -421,6 +453,13 @@ def analyze(
     default="text",
     help="Output format: text (default) or json",
 )
+@click.option(
+    "--compare",
+    "compare_ref",
+    type=str,
+    default=None,
+    help="VCS ref to compare against (branch, tag, or commit hash). Shows added/removed/modified nodes.",
+)
 def catalog(
     path: str,
     filters: tuple[str, ...],
@@ -431,6 +470,7 @@ def catalog(
     pretty: bool,
     state: str | None,
     fmt: str,
+    compare_ref: str | None,
 ) -> None:
     """Flat list of all nodes for agent discovery.
 
@@ -448,6 +488,20 @@ def catalog(
     state_manager = GraphStateManager(project_path)
     state_manager.analyze_project(project_path)
 
+    if compare_ref is not None:
+        backend = detect_backend(project_path)
+        if backend is None:
+            raise click.ClickException(
+                "No VCS backend found. Is this a git repo? "
+                "Install git support with: pip install serpentine[git]"
+            )
+        try:
+            vcs_manager = VcsManager(backend, VcsRefCacheManager(project_path), state_manager.config)
+            from_graph_json = vcs_manager.get_graph_at(compare_ref)
+        except Exception as e:
+            raise click.ClickException(f"Could not resolve ref '{compare_ref}': {e}") from e
+        state_manager.set_vcs_comparison(from_graph_json, to_graph_json=None)
+
     graph_data = state_manager.get_graph_data()
 
     if fmt == "text":

{serpentine_parser-0.3.2 → serpentine_parser-0.4.0}/src/serpentine/selector.py

@@ -173,8 +173,12 @@ class GraphSelector:
 
             if at_op:
                 # @pattern — full connected component
-                matched = self._match_pattern(base_pattern)
-                selected.update(self._expand_component(matched))
+                matched = self._match_state(base_pattern[len("state:"):]) if base_pattern.startswith("state:") else self._match_pattern(base_pattern)
+                roots: Set[str] = set()
+                for node_id in matched:
+                    roots.add(node_id)
+                    roots.update(self._get_all_descendants(node_id))
+                selected.update(self._expand_component(roots))
                 continue
 
             # left_n/right_n are None when the +/N+ prefix/suffix is absent entirely.
@@ -185,7 +189,7 @@ class GraphSelector:
             up_depth = int(left_n) if left_n else None    # None = unlimited
             down_depth = int(right_n) if right_n else None  # None = unlimited
 
-            matched = self._match_pattern(base_pattern)
+            matched = self._match_state(base_pattern[len("state:"):]) if base_pattern.startswith("state:") else self._match_pattern(base_pattern)
             expanded = matched.copy()
 
             for node_id in matched:
@@ -222,6 +226,14 @@ class GraphSelector:
                     queue.append((neighbor, depth + 1))
         return visited
 
+    def _match_state(self, value: str) -> Set[str]:
+        """Match nodes by change_status value."""
+        return {
+            node_id
+            for node_id, node in self.flat_nodes.items()
+            if node.get("change_status") == value
+        }
+
     def _match_pattern(self, pattern: str) -> Set[str]:
         """Match pattern against flat node ids using glob matching."""
         # Normalize ** to * — in dotted IDs, * already matches dots

{serpentine_parser-0.3.2 → serpentine_parser-0.4.0}/src/serpentine/server/app.py

@@ -28,6 +28,7 @@ from starlette.staticfiles import StaticFiles
 
 from serpentine.server.routes import create_routes
 from serpentine.server.websocket import ConnectionManager, set_connection_manager
+from serpentine.vcs.manager import VcsManager
 
 if TYPE_CHECKING:
     from serpentine.state import GraphStateManager
@@ -42,6 +43,7 @@ def create_app(
     state_manager: "GraphStateManager",
     static_dir: Path | None = None,
     debug: bool = False,
+    vcs_manager: VcsManager | None = None,
 ) -> Starlette:
     """
     Create and configure the Starlette application.
@@ -91,7 +93,7 @@ def create_app(
         _event_loop = None
 
     # Create API routes
-    routes = create_routes(state_manager, connection_manager)
+    routes = create_routes(state_manager, connection_manager, vcs_manager)
 
     # Add static file serving if directory has a built frontend
     if static_dir and (static_dir / "index.html").exists():

{serpentine_parser-0.3.2 → serpentine_parser-0.4.0}/src/serpentine/server/routes.py

@@ -22,6 +22,7 @@ from starlette.websockets import WebSocket, WebSocketDisconnect
 
 from serpentine.selector import GraphSelector, filter_by_state
 from serpentine.server.websocket import ConnectionManager
+from serpentine.vcs.manager import VcsManager
 
 if TYPE_CHECKING:
     from serpentine.state import GraphStateManager
@@ -32,6 +33,7 @@ logger = logging.getLogger(__name__)
 def create_routes(
     state_manager: "GraphStateManager",
     connection_manager: ConnectionManager,
+    vcs_manager: VcsManager | None = None,
 ) -> list[Route | WebSocketRoute]:
     """
     Create all HTTP and WebSocket routes for the application.
@@ -178,6 +180,19 @@ def create_routes(
             yield node
             yield from _count_nodes(node.get("children", []))
 
+    async def get_vcs_refs(request: Request) -> Response:
+        """Return available VCS refs for the ref picker."""
+        if vcs_manager is None:
+            return Response(
+                content=json.dumps({"available": False, "refs": []}),
+                media_type="application/json",
+            )
+        refs = [{"id": r.id, "display": r.display, "kind": r.kind} for r in vcs_manager.list_refs()]
+        return Response(
+            content=json.dumps({"available": True, "refs": refs}),
+            media_type="application/json",
+        )
+
     async def websocket_endpoint(websocket: WebSocket) -> None:
         """
         WebSocket endpoint for real-time graph updates.
@@ -231,6 +246,54 @@ def create_routes(
                         "type": "node_code",
                         "data": {"qualname": qualname, "code": code},
                     })
+                elif data.get("action") == "set_vcs_comparison":
+                    action_data = data.get("data", {})
+                    from_ref: str = action_data.get("from", "@start")
+                    to_ref: str = action_data.get("to", "@current")
+
+                    try:
+                        # Resolve from_graph_json
+                        if from_ref == "@current":
+                            from_graph_json = json.dumps(state_manager._graph_data)
+                        elif from_ref == "@start":
+                            from_graph_json = json.dumps(state_manager._start_graph_data)
+                        elif vcs_manager is None:
+                            await websocket.send_json({"type": "error", "data": {"message": "VCS not available"}})
+                            continue
+                        else:
+                            valid_ids = {r.id for r in vcs_manager.list_refs()}
+                            if from_ref not in valid_ids:
+                                await websocket.send_json({"type": "error", "data": {"message": f"Unknown ref: {from_ref}"}})
+                                continue
+                            from_graph_json = vcs_manager.get_graph_at(from_ref)
+
+                        # Resolve to_graph_json
+                        to_graph_json: str | None
+                        if to_ref == "@current":
+                            to_graph_json = None
+                        elif to_ref == "@start":
+                            to_graph_json = json.dumps(state_manager._start_graph_data)
+                        elif vcs_manager is None:
+                            await websocket.send_json({"type": "error", "data": {"message": "VCS not available"}})
+                            continue
+                        else:
+                            valid_ids = {r.id for r in vcs_manager.list_refs()}
+                            if to_ref not in valid_ids:
+                                await websocket.send_json({"type": "error", "data": {"message": f"Unknown ref: {to_ref}"}})
+                                continue
+                            to_graph_json = vcs_manager.get_graph_at(to_ref)
+
+                        state_manager.set_vcs_comparison(from_graph_json, to_graph_json)
+                        await connection_manager.send_graph_update(state_manager.get_graph_json())
+                    except Exception as e:
+                        logger.error(f"[vcs] set_vcs_comparison failed: {e}", exc_info=True)
+                        await websocket.send_json({"type": "error", "data": {"message": f"Comparison failed: {e}"}})
+                elif data.get("action") == "clear_vcs_comparison":
+                    state_manager.clear_vcs_comparison()
+                    await connection_manager.send_graph_update(state_manager.get_graph_json())
+                elif data.get("action") == "update_start":
+                    state_manager.update_start()
+                    await connection_manager.send_graph_update(state_manager.get_graph_json())
                 else:
                     logger.debug(f"Unknown message type: {data.get('type')}")
 
@@ -244,5 +307,6 @@ def create_routes(
         Route("/api/health", health, methods=["GET"]),
         Route("/api/graph", get_graph, methods=["GET"]),
         Route("/api/catalog", get_catalog, methods=["GET"]),
+        Route("/api/vcs/refs", get_vcs_refs, methods=["GET"]),
         WebSocketRoute("/ws", websocket_endpoint),
     ]