codegraphy 0.1.0__tar.gz → 1.0.0__tar.gz

{codegraphy-0.1.0 → codegraphy-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegraphy
-Version: 0.1.0
+Version: 1.0.0
 Summary: SQLite/PostgreSQL codebase knowledge graph and MCP server for Claude Code
 Author: Charan Kulal
 License-Expression: MIT
@@ -42,6 +42,8 @@ Dynamic: license-file
 
 Standalone Python package that parses a codebase into a knowledge graph (PostgreSQL or SQLite) and exposes it as an [MCP](https://modelcontextprotocol.io/) server for Claude Code. Claude calls graph tools instead of `Read` + `Bash(grep)` — cuts exploration token cost by 5–10×.
 
+**PyPI:** https://pypi.org/project/codegraphy/
+
 **Python:** 3.10+  
 **License:** MIT
 
@@ -78,6 +80,37 @@ The base PyPI package keeps SQLite support in the standard library path, so Post
 
 ---
 
+## PostgreSQL
+
+Install PostgreSQL support:
+
+```bash
+pip install 'codegraphy[postgres]'
+```
+
+Initialize with a PostgreSQL URL:
+
+```bash
+codegraphy init --db postgresql://USER:PASSWORD@HOST:PORT/DBNAME
+```
+
+Example:
+
+```bash
+codegraphy init --db postgresql://postgres:postgres@localhost:5432/codegraphy
+```
+
+Or set `DATABASE_URL` once and reuse it:
+
+```bash
+export DATABASE_URL=postgresql://postgres:postgres@localhost:5432/codegraphy
+codegraphy init
+codegraphy index .
+codegraphy serve
+```
+
+---
+
 ## Quickstart
 
 ```bash
@@ -136,9 +169,9 @@ Priority: CLI flag → environment variable → `codegraphy.toml` → defaults.
 ### Environment Variables
 
 ```bash
-DATABASE_URL=sqlite:///codegraphy.db    # or postgresql://localhost/codegraphy
-REPOLENS_ROOT=.                        # project root for grep fallback
-REPOLENS_PLUGINS=repolens.plugins.django
+DATABASE_URL=sqlite:///codegraphy.db      # or postgresql://localhost/codegraphy
+CODEGRAPHY_ROOT=.                         # project root for grep fallback
+CODEGRAPHY_PLUGINS=codegraphy.plugins.django
 ```
 
 ### Config File (optional)
@@ -148,7 +181,7 @@ REPOLENS_PLUGINS=repolens.plugins.django
 database_url = "postgresql://localhost/codegraphy"
 root = "."
 exclude = ["migrations", "node_modules", ".venv", "__pycache__"]
-plugins = ["repolens.plugins.django"]
+plugins = ["codegraphy.plugins.django"]
 ```
 
 ---
@@ -191,9 +224,9 @@ plugins = ["repolens.plugins.django"]
 ## Architecture
 
 ```
-repolens/
+codegraphy/
 ├── cli.py              # Click CLI entry points
-├── config.py           # DATABASE_URL, REPOLENS_ROOT, plugin list
+├── config.py           # DATABASE_URL, CODEGRAPHY_ROOT, plugin list
 ├── db/
 │   ├── schema.py       # CREATE TABLE statements (PG + SQLite)
 │   └── store.py        # upsert_symbol, upsert_edge, query helpers
@@ -250,7 +283,7 @@ Detects Django patterns by file naming convention:
 
 Enable via environment variable:
 ```bash
-REPOLENS_PLUGINS=repolens.plugins.django
+CODEGRAPHY_PLUGINS=codegraphy.plugins.django
 ```
 
 ---

{codegraphy-0.1.0 → codegraphy-1.0.0}/README.md

@@ -2,6 +2,8 @@
 
 Standalone Python package that parses a codebase into a knowledge graph (PostgreSQL or SQLite) and exposes it as an [MCP](https://modelcontextprotocol.io/) server for Claude Code. Claude calls graph tools instead of `Read` + `Bash(grep)` — cuts exploration token cost by 5–10×.
 
+**PyPI:** https://pypi.org/project/codegraphy/
+
 **Python:** 3.10+  
 **License:** MIT
 
@@ -38,6 +40,37 @@ The base PyPI package keeps SQLite support in the standard library path, so Post
 
 ---
 
+## PostgreSQL
+
+Install PostgreSQL support:
+
+```bash
+pip install 'codegraphy[postgres]'
+```
+
+Initialize with a PostgreSQL URL:
+
+```bash
+codegraphy init --db postgresql://USER:PASSWORD@HOST:PORT/DBNAME
+```
+
+Example:
+
+```bash
+codegraphy init --db postgresql://postgres:postgres@localhost:5432/codegraphy
+```
+
+Or set `DATABASE_URL` once and reuse it:
+
+```bash
+export DATABASE_URL=postgresql://postgres:postgres@localhost:5432/codegraphy
+codegraphy init
+codegraphy index .
+codegraphy serve
+```
+
+---
+
 ## Quickstart
 
 ```bash
@@ -96,9 +129,9 @@ Priority: CLI flag → environment variable → `codegraphy.toml` → defaults.
 ### Environment Variables
 
 ```bash
-DATABASE_URL=sqlite:///codegraphy.db    # or postgresql://localhost/codegraphy
-REPOLENS_ROOT=.                        # project root for grep fallback
-REPOLENS_PLUGINS=repolens.plugins.django
+DATABASE_URL=sqlite:///codegraphy.db      # or postgresql://localhost/codegraphy
+CODEGRAPHY_ROOT=.                         # project root for grep fallback
+CODEGRAPHY_PLUGINS=codegraphy.plugins.django
 ```
 
 ### Config File (optional)
@@ -108,7 +141,7 @@ REPOLENS_PLUGINS=repolens.plugins.django
 database_url = "postgresql://localhost/codegraphy"
 root = "."
 exclude = ["migrations", "node_modules", ".venv", "__pycache__"]
-plugins = ["repolens.plugins.django"]
+plugins = ["codegraphy.plugins.django"]
 ```
 
 ---
@@ -151,9 +184,9 @@ plugins = ["repolens.plugins.django"]
 ## Architecture
 
 ```
-repolens/
+codegraphy/
 ├── cli.py              # Click CLI entry points
-├── config.py           # DATABASE_URL, REPOLENS_ROOT, plugin list
+├── config.py           # DATABASE_URL, CODEGRAPHY_ROOT, plugin list
 ├── db/
 │   ├── schema.py       # CREATE TABLE statements (PG + SQLite)
 │   └── store.py        # upsert_symbol, upsert_edge, query helpers
@@ -210,7 +243,7 @@ Detects Django patterns by file naming convention:
 
 Enable via environment variable:
 ```bash
-REPOLENS_PLUGINS=repolens.plugins.django
+CODEGRAPHY_PLUGINS=codegraphy.plugins.django
 ```
 
 ---

{codegraphy-0.1.0/repolens → codegraphy-1.0.0/codegraphy}/__init__.py

@@ -2,4 +2,4 @@
 codegraphy: Parses a codebase into a Postgres/SQLite knowledge graph and exposes it as an MCP server.
 """
 
-__version__ = "0.1.0"
+__version__ = "1.0.0"

{codegraphy-0.1.0/repolens → codegraphy-1.0.0/codegraphy}/cli.py

@@ -10,8 +10,8 @@ def cli():
 @click.option('--db', help='Database URL (e.g. postgresql://localhost/codegraphy)')
 def init(db):
     """Initialize the database schema."""
-    import repolens.config as config
-    from repolens.db.store import Store
+    import codegraphy.config as config
+    from codegraphy.db.store import Store
     
     db_url = db or config.DATABASE_URL
     click.echo(f"Initializing schema for {db_url}...")
@@ -24,16 +24,16 @@ def init(db):
 @click.option('--exclude', help='Comma-separated list of directories to exclude')
 def index(path, exclude):
     """Index a directory into the graph."""
-    import repolens.config as config
-    from repolens.db.store import Store
-    from repolens.indexer.walker import index_path
+    import codegraphy.config as config
+    from codegraphy.db.store import Store
+    from codegraphy.indexer.walker import index_path
     
     click.echo(f"Indexing {path}...")
     store = Store(config.DATABASE_URL)
     exclude_list = exclude.split(',') if exclude else None
     
     # Load plugins
-    plugins = [] # TODO: instantiate from config.REPOLENS_PLUGINS
+    plugins = [] # TODO: instantiate from config.CODEGRAPHY_PLUGINS
     
     count = index_path(path, store, plugins, exclude_list)
     click.echo(f"Indexed {count} files.")
@@ -42,9 +42,8 @@ def index(path, exclude):
 def update():
     """Update index incrementally based on git diff."""
     import subprocess
-    import repolens.config as config
-    from repolens.db.store import Store
-    from repolens.indexer.walker import index_path
+    import codegraphy.config as config
+    from codegraphy.db.store import Store
     
     click.echo("Updating index...")
     try:
@@ -63,7 +62,7 @@ def update():
         # Re-using index_path is tricky since it takes a root.
         # We can just write a small loop here for the changed files.
         import os
-        from repolens.indexer.walker import INDEXERS, sha256
+        from codegraphy.indexer.walker import INDEXERS, sha256
         
         path = os.path.abspath(file_path)
         if not os.path.exists(path):
@@ -97,7 +96,7 @@ def update():
 @cli.command()
 def serve():
     """Start the MCP server over stdio."""
-    from repolens.mcp.server import start_server
+    from codegraphy.mcp.server import start_server
     click.echo("Starting MCP server...", err=True)
     start_server()
 
@@ -105,7 +104,7 @@ def serve():
 @click.argument('name')
 def search(name):
     """Search for a symbol in the graph."""
-    from repolens.mcp.server import search_symbol
+    from codegraphy.mcp.server import search_symbol
     results = search_symbol(name)
     for res in results:
         click.echo(f"[{res['source']}] {res.get('qualified_name') or res.get('file_path')} - {res.get('kind', 'grep')} @ {res['line_start']}")
@@ -114,7 +113,7 @@ def search(name):
 @click.argument('name')
 def usages(name):
     """Find usages of a symbol."""
-    from repolens.mcp.server import find_usages
+    from codegraphy.mcp.server import find_usages
     results = find_usages(name)
     for res in results:
         click.echo(f"[{res['source']}] {res.get('from_qualified') or res.get('file_path')} - {res.get('relation', 'grep')} @ {res['line_start']}")
@@ -122,8 +121,8 @@ def usages(name):
 @cli.command()
 def stats():
     """Show graph statistics."""
-    from repolens.db.store import Store
-    import repolens.config as config
+    from codegraphy.db.store import Store
+    import codegraphy.config as config
     store = Store(config.DATABASE_URL)
     with store.get_connection() as conn:
         cursor = conn.cursor()

{codegraphy-0.1.0/repolens → codegraphy-1.0.0/codegraphy}/config.py

@@ -2,11 +2,11 @@ import os
 
 # Default configuration
 DATABASE_URL = os.environ.get("DATABASE_URL", "sqlite:///codegraphy.db")
-REPOLENS_ROOT = os.environ.get("REPOLENS_ROOT", ".")
+CODEGRAPHY_ROOT = os.environ.get("CODEGRAPHY_ROOT", ".")
 
 # Plugin list can be derived from env vars or TOML
-_plugins_env = os.environ.get("REPOLENS_PLUGINS", "")
-REPOLENS_PLUGINS = [p.strip() for p in _plugins_env.split(",")] if _plugins_env else []
+_plugins_env = os.environ.get("CODEGRAPHY_PLUGINS", "")
+CODEGRAPHY_PLUGINS = [p.strip() for p in _plugins_env.split(",")] if _plugins_env else []
 
 def load_config():
     # Placeholder for loading from codegraphy.toml if needed

{codegraphy-0.1.0/repolens → codegraphy-1.0.0/codegraphy}/db/store.py

@@ -73,10 +73,21 @@ class Store:
             row = cursor.fetchone()
             return row[0] if row else None
 
+    def _dedupe_symbols(self, symbols: list) -> list:
+        deduped = []
+        seen = set()
+        for symbol in symbols:
+            if symbol.qualified_name in seen:
+                continue
+            seen.add(symbol.qualified_name)
+            deduped.append(symbol)
+        return deduped
+
     def upsert_file(self, file_path: str, git_hash: str, symbols: list, edges: list):
         """
         Replace symbols and edges for a file.
         """
+        symbols = self._dedupe_symbols(symbols)
         with self.get_connection() as conn:
             cursor = conn.cursor()
             

{codegraphy-0.1.0/repolens → codegraphy-1.0.0/codegraphy}/indexer/python.py

@@ -44,6 +44,14 @@ class PythonIndexer(BaseIndexer):
                     return f"{module_path}.{name}" if module_path else name
                 return f"{module_path}.{'.'.join(self.current_scope)}.{name}"
 
+            def get_import_qualname(self, node, imported_name, source_module):
+                scope = ".".join(self.current_scope)
+                parts = [module_path] if module_path else []
+                if scope:
+                    parts.append(scope)
+                parts.extend(["__import__", str(node.lineno), str(node.col_offset), source_module, imported_name])
+                return ".".join(parts)
+
             def visit_ClassDef(self, node):
                 qualname = self.get_qualname(node.name)
                 summary = ast.get_docstring(node) or ""
@@ -108,7 +116,7 @@ class PythonIndexer(BaseIndexer):
                 for alias in node.names:
                     # module level import
                     # e.g., import os
-                    qualname = self.get_qualname(alias.asname or alias.name)
+                    qualname = self.get_import_qualname(node, alias.asname or alias.name, alias.name)
                     symbols.append(Symbol(
                         name=alias.asname or alias.name,
                         qualified_name=qualname,
@@ -129,7 +137,7 @@ class PythonIndexer(BaseIndexer):
                 if node.module:
                     for alias in node.names:
                         name = alias.asname or alias.name
-                        qualname = self.get_qualname(name)
+                        qualname = self.get_import_qualname(node, name, node.module)
                         symbols.append(Symbol(
                             name=name,
                             qualified_name=qualname,

{codegraphy-0.1.0/repolens → codegraphy-1.0.0/codegraphy}/mcp/server.py

@@ -1,6 +1,6 @@
 from mcp.server.fastmcp import FastMCP
 from ..db.store import Store
-from ..config import DATABASE_URL, REPOLENS_ROOT
+from ..config import DATABASE_URL, CODEGRAPHY_ROOT
 import subprocess
 
 mcp = FastMCP("codegraphy")
@@ -53,7 +53,7 @@ def search_symbol(name: str, kind: str = None, limit: int = 10, fallback_grep: b
     if not results and fallback_grep:
         try:
             # We use subprocess to run grep
-            grep_cmd = ['grep', '-rn', '--include=*.py', '--include=*.js', '--include=*.ts', '--include=*.html', name, REPOLENS_ROOT]
+            grep_cmd = ['grep', '-rn', '--include=*.py', '--include=*.js', '--include=*.ts', '--include=*.html', name, CODEGRAPHY_ROOT]
             res = subprocess.run(grep_cmd, capture_output=True, text=True)
             if res.stdout:
                 for line in res.stdout.splitlines()[:limit]:
@@ -145,7 +145,7 @@ def find_usages(qualified_name: str, limit: int = 20, fallback_grep: bool = True
     if not results and fallback_grep:
         short_name = qualified_name.split('.')[-1]
         try:
-            grep_cmd = ['grep', '-rn', short_name, REPOLENS_ROOT]
+            grep_cmd = ['grep', '-rn', short_name, CODEGRAPHY_ROOT]
             res = subprocess.run(grep_cmd, capture_output=True, text=True)
             if res.stdout:
                 for line in res.stdout.splitlines()[:limit]:
@@ -276,7 +276,7 @@ def grep_search(pattern: str, include: list[str] = None, exclude: list[str] = No
         for exc in exclude:
             cmd.append(f'--exclude-dir={exc}')
             
-    cmd.extend([pattern, REPOLENS_ROOT])
+    cmd.extend([pattern, CODEGRAPHY_ROOT])
     
     results = []
     try:

{codegraphy-0.1.0 → codegraphy-1.0.0}/codegraphy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegraphy
-Version: 0.1.0
+Version: 1.0.0
 Summary: SQLite/PostgreSQL codebase knowledge graph and MCP server for Claude Code
 Author: Charan Kulal
 License-Expression: MIT
@@ -42,6 +42,8 @@ Dynamic: license-file
 
 Standalone Python package that parses a codebase into a knowledge graph (PostgreSQL or SQLite) and exposes it as an [MCP](https://modelcontextprotocol.io/) server for Claude Code. Claude calls graph tools instead of `Read` + `Bash(grep)` — cuts exploration token cost by 5–10×.
 
+**PyPI:** https://pypi.org/project/codegraphy/
+
 **Python:** 3.10+  
 **License:** MIT
 
@@ -78,6 +80,37 @@ The base PyPI package keeps SQLite support in the standard library path, so Post
 
 ---
 
+## PostgreSQL
+
+Install PostgreSQL support:
+
+```bash
+pip install 'codegraphy[postgres]'
+```
+
+Initialize with a PostgreSQL URL:
+
+```bash
+codegraphy init --db postgresql://USER:PASSWORD@HOST:PORT/DBNAME
+```
+
+Example:
+
+```bash
+codegraphy init --db postgresql://postgres:postgres@localhost:5432/codegraphy
+```
+
+Or set `DATABASE_URL` once and reuse it:
+
+```bash
+export DATABASE_URL=postgresql://postgres:postgres@localhost:5432/codegraphy
+codegraphy init
+codegraphy index .
+codegraphy serve
+```
+
+---
+
 ## Quickstart
 
 ```bash
@@ -136,9 +169,9 @@ Priority: CLI flag → environment variable → `codegraphy.toml` → defaults.
 ### Environment Variables
 
 ```bash
-DATABASE_URL=sqlite:///codegraphy.db    # or postgresql://localhost/codegraphy
-REPOLENS_ROOT=.                        # project root for grep fallback
-REPOLENS_PLUGINS=repolens.plugins.django
+DATABASE_URL=sqlite:///codegraphy.db      # or postgresql://localhost/codegraphy
+CODEGRAPHY_ROOT=.                         # project root for grep fallback
+CODEGRAPHY_PLUGINS=codegraphy.plugins.django
 ```
 
 ### Config File (optional)
@@ -148,7 +181,7 @@ REPOLENS_PLUGINS=repolens.plugins.django
 database_url = "postgresql://localhost/codegraphy"
 root = "."
 exclude = ["migrations", "node_modules", ".venv", "__pycache__"]
-plugins = ["repolens.plugins.django"]
+plugins = ["codegraphy.plugins.django"]
 ```
 
 ---
@@ -191,9 +224,9 @@ plugins = ["repolens.plugins.django"]
 ## Architecture
 
 ```
-repolens/
+codegraphy/
 ├── cli.py              # Click CLI entry points
-├── config.py           # DATABASE_URL, REPOLENS_ROOT, plugin list
+├── config.py           # DATABASE_URL, CODEGRAPHY_ROOT, plugin list
 ├── db/
 │   ├── schema.py       # CREATE TABLE statements (PG + SQLite)
 │   └── store.py        # upsert_symbol, upsert_edge, query helpers
@@ -250,7 +283,7 @@ Detects Django patterns by file naming convention:
 
 Enable via environment variable:
 ```bash
-REPOLENS_PLUGINS=repolens.plugins.django
+CODEGRAPHY_PLUGINS=codegraphy.plugins.django
 ```
 
 ---

codegraphy-1.0.0/codegraphy.egg-info/SOURCES.txt

@@ -0,0 +1,24 @@
+LICENSE
+README.md
+pyproject.toml
+codegraphy/__init__.py
+codegraphy/cli.py
+codegraphy/config.py
+codegraphy.egg-info/PKG-INFO
+codegraphy.egg-info/SOURCES.txt
+codegraphy.egg-info/dependency_links.txt
+codegraphy.egg-info/entry_points.txt
+codegraphy.egg-info/requires.txt
+codegraphy.egg-info/top_level.txt
+codegraphy/db/__init__.py
+codegraphy/db/schema.py
+codegraphy/db/store.py
+codegraphy/indexer/__init__.py
+codegraphy/indexer/base.py
+codegraphy/indexer/python.py
+codegraphy/indexer/walker.py
+codegraphy/mcp/__init__.py
+codegraphy/mcp/server.py
+codegraphy/plugins/__init__.py
+codegraphy/plugins/base.py
+codegraphy/plugins/django.py

codegraphy-1.0.0/codegraphy.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+codegraphy = codegraphy.cli:cli

codegraphy-1.0.0/codegraphy.egg-info/top_level.txt

@@ -0,0 +1 @@
+codegraphy

{codegraphy-0.1.0 → codegraphy-1.0.0}/pyproject.toml

@@ -37,10 +37,10 @@ html = ["tree-sitter", "tree-sitter-html"]
 all = ["psycopg2-binary", "pgvector", "tree-sitter", "tree-sitter-javascript", "tree-sitter-typescript", "tree-sitter-html"]
 
 [project.scripts]
-codegraphy = "repolens.cli:cli"
+codegraphy = "codegraphy.cli:cli"
 
 [tool.setuptools.dynamic]
-version = { attr = "repolens.__version__" }
+version = { attr = "codegraphy.__version__" }
 
 [tool.setuptools.packages.find]
-include = ["repolens*"]
+include = ["codegraphy*"]

codegraphy-0.1.0/codegraphy.egg-info/SOURCES.txt

@@ -1,24 +0,0 @@
-LICENSE
-README.md
-pyproject.toml
-codegraphy.egg-info/PKG-INFO
-codegraphy.egg-info/SOURCES.txt
-codegraphy.egg-info/dependency_links.txt
-codegraphy.egg-info/entry_points.txt
-codegraphy.egg-info/requires.txt
-codegraphy.egg-info/top_level.txt
-repolens/__init__.py
-repolens/cli.py
-repolens/config.py
-repolens/db/__init__.py
-repolens/db/schema.py
-repolens/db/store.py
-repolens/indexer/__init__.py
-repolens/indexer/base.py
-repolens/indexer/python.py
-repolens/indexer/walker.py
-repolens/mcp/__init__.py
-repolens/mcp/server.py
-repolens/plugins/__init__.py
-repolens/plugins/base.py
-repolens/plugins/django.py

codegraphy-0.1.0/codegraphy.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-codegraphy = repolens.cli:cli

codegraphy-0.1.0/codegraphy.egg-info/top_level.txt

@@ -1 +0,0 @@
-repolens