Merge main into JS support branch and rewrite analyzer

Resolve merge conflicts with main branch which restructured the
analyzer pattern. Rewrite JavaScriptAnalyzer to follow the new
AbstractAnalyzer interface with get_entity_label, get_entity_name,
get_entity_docstring, get_entity_types, add_symbols, resolve_symbol,
and other required abstract methods.

Address PR review comments:
- Replace wildcard imports with explicit imports (CodeRabbit)
- Move JS-specific utils out of shared utils.py (swilly22)
- Remove redundant file re-parsing in second pass (swilly22)
- Replace assert with proper error handling pattern (copilot-reviewer)
- Improve docstrings to be more specific (swilly22)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: gkorland

.github/dependabot.yml

@@ -4,4 +4,4 @@ updates:
     directory: "/" # Location of package manifests
     schedule:
       interval: "daily"
-    target-branch: "staging"      
+    target-branch: "staging"

.github/workflows/python-app.yml

@@ -5,9 +5,9 @@ name: Python application
 
 on:
   push:
-    branches: [ "main" ]
+    branches: [ "main", "staging" ]
   pull_request:
-    branches: [ "main" ]
+    branches: [ "main", "staging" ]
 
 permissions:
   contents: read
@@ -19,15 +19,16 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
-    - name: Set up Python 3.10
-      uses: actions/setup-python@v3
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+    - name: Set up Python 3.12
+      uses: actions/setup-python@v5
       with:
-        python-version: "3.10"
+        python-version: "3.12"
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip
-        pip install flake8 pytest
-        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+        uv pip install --system flake8 pytest
+        uv pip install --system .
     - name: Lint with flake8
       run: |
         # stop the build if there are Python syntax errors or undefined names

.github/workflows/release-image.yml

@@ -0,0 +1,37 @@
+name: Release image to DockerHub
+
+on:
+  workflow_dispatch:
+  push:
+    tags: ["v*.*.*"]
+    branches:
+      - main
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set tags
+        run: |
+          if ${{ github.event_name == 'push' && startsWith(github.ref, 'refs/tags') }}; then
+            echo "TAGS=falkordb/code-graph-backend:latest,falkordb/code-graph-backend:${{ github.ref_name }}" >> $GITHUB_ENV
+          else
+            echo "TAGS=falkordb/code-graph-backend:edge" >> $GITHUB_ENV
+          fi
+
+      - name: Login to DockerHub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+  
+      - name: Build image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./Dockerfile
+          push: true
+          tags: ${{ env.TAGS }}

README.md

@@ -22,9 +22,17 @@ docker run -p 6379:6379 -p 3000:3000 -it --rm falkordb/falkordb:latest
 
 Create your own `.env` file from the `.env.template` file
 
+### Install dependencies
+
+Install project dependencies:
+
+```bash
+uv sync
+```
+
 Start the server:
 ```bash
-flask --app api/index.py run --debug
+uv run flask --app api/index.py run --debug
 ```
 
 ### Creating a graph
@@ -48,7 +56,7 @@ a graph representation of your source code, the graph name should be the same as
 the name of the folder you've requested to analyze, for the example above a graph named:
 "GraphRAG-SDK".
 
-At the moment only the Python and C languages are supported, we do intend to support additional languages.
+At the moment Python, Java, and C# languages are supported, we do intend to support additional languages.
 
 At this point you can explore and query your source code using various tools
 Here are several options:

api/__init__.py

@@ -1,7 +1,9 @@
 from .info import *
 from .llm import ask
 from .graph import *
+from .project import *
 from .entities import *
+from .git_utils import *
 from .code_coverage import *
 from .analyzers.source_analyzer import *
 from .auto_complete import prefix_search

api/analyzers/analyzer.py

@@ -1,28 +1,144 @@
-import io
 from pathlib import Path
+from typing import Optional
+
+from tree_sitter import Language, Node, Parser, Point
+from api.entities.entity import Entity
+from api.entities.file import File
 from abc import ABC, abstractmethod
+from multilspy import SyncLanguageServer
 
 class AbstractAnalyzer(ABC):
+    def __init__(self, language: Language) -> None:
+        self.language = language
+        self.parser = Parser(language)
+
+    def find_parent(self, node: Node, parent_types: list) -> Node:
+        while node and node.type not in parent_types:
+            node = node.parent
+        return node
+    
+    @abstractmethod
+    def is_dependency(self, file_path: str) -> bool:
+        """
+        Check if the file is a dependency.
+
+        Args:
+            file_path (str): The file path.
+
+        Returns:
+            bool: True if the file is a dependency, False otherwise.
+        """
+
+        pass
+    
+    @abstractmethod
+    def resolve_path(self, file_path: str, path: Path) -> str:
+        """
+        Resolve the path of the file.
+
+        Args:
+            file_path (str): The file path.
+            path (Path): The path to the folder.
+
+        Returns:
+            str: The resolved path.
+        """
+
+        pass
+
+    def resolve(self, files: dict[Path, File], lsp: SyncLanguageServer, file_path: Path, path: Path, node: Node) -> list[tuple[File, Node]]:
+        try:
+            locations = lsp.request_definition(str(file_path), node.start_point.row, node.start_point.column)
+            return [(files[Path(self.resolve_path(location['absolutePath'], path))], files[Path(self.resolve_path(location['absolutePath'], path))].tree.root_node.descendant_for_point_range(Point(location['range']['start']['line'], location['range']['start']['character']), Point(location['range']['end']['line'], location['range']['end']['character']))) for location in locations if location and Path(self.resolve_path(location['absolutePath'], path)) in files]
+        except Exception as e:
+            return []
+        
     @abstractmethod
-    def first_pass(self, path: Path, f: io.TextIOWrapper) -> None:
+    def add_dependencies(self, path: Path, files: list[Path]):
         """
-        Perform the first pass of analysis on the given file.
+        Add dependencies to the files.
 
         Args:
-            path (Path): The path to the file being processed.
-            f (io.TextIOWrapper): The file object.
+            path (Path): The path to the folder.
+            files (dict[Path, File]): The files.
+        """
+
+        pass
+    
+    @abstractmethod
+    def get_entity_label(self, node: Node) -> str:
         """
+        Get the entity label from the node.
 
+        Args:
+            node (Node): The node.
+        
+        Returns:
+            str: The entity label.
+        """
         pass
 
     @abstractmethod
-    def second_pass(self, path: Path, f: io.TextIOWrapper) -> None:
+    def get_entity_name(self, node: Node) -> str:
         """
-        Perform a second pass analysis on the given source file.
+        Get the entity name from the node.
 
         Args:
+            node (Node): The node.
+        
+        Returns:
+            str: The entity name.
+        """
+        pass
+
+    @abstractmethod
+    def get_entity_docstring(self, node: Node) -> Optional[str]:
+        """
+        Get the entity docstring from the node.
+
+        Args:
+            node (Node): The node.
+
+        Returns:
+            Optional[str]: The entity docstring.
+        """
+        pass
+    
+    @abstractmethod
+    def get_entity_types(self) -> list[str]:
+        """
+        Get the top level entity types for the language.
+
+        Returns:
+            list[str]: The list of top level entity types.
+        """
+
+        pass
+
+    @abstractmethod
+    def add_symbols(self, entity: Entity) -> None:
+        """
+        Add symbols to the entity.
+
+        Args:
+            entity (Entity): The entity to add symbols to.
+        """
+
+        pass
+
+    @abstractmethod
+    def resolve_symbol(self, files: dict[Path, File], lsp: SyncLanguageServer, file_path: Path, path: Path, key: str, symbol: Node) -> list[Entity]:
+        """
+        Resolve a symbol to an entity.
+
+        Args:
+            lsp (SyncLanguageServer): The language server.
             path (Path): The path to the file.
-            f (io.TextIOWrapper): The file handle of the file to be processed.
+            key (str): The symbol key.
+            symbol (Node): The symbol node.
+
+        Returns:
+            list[Entity]: The resolved entities.
         """
 
         pass