ctxgraph-code 0.5.0__tar.gz → 0.5.1__tar.gz

{ctxgraph_code-0.5.0 → ctxgraph_code-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxgraph-code
-Version: 0.5.0
+Version: 0.5.1
 Summary: Code knowledge graph for Claude Code. Build a relationship graph of your Python codebase and query it during coding sessions.
 Author: ctxgraph-code contributors
 License: MIT
@@ -30,6 +30,8 @@ Requires-Dist: pytest>=7.0; extra == "dev"
 
 ```bash
 pip install ctxgraph-code
+# For multi-language support (C, Go, Rust, JS, TS, Java, etc.):
+pip install 'ctxgraph-code[full]'
 cd my-project
 ctxgraph-code setup
 ```
@@ -52,10 +54,10 @@ These questions require running multiple `grep` commands or reading dependency c
 ## Quick Start
 
 ```bash
-# Install
-pip install ctxgraph-code
+# Install (add [full] for multi-language support)
+pip install 'ctxgraph-code[full]'
 
-# Navigate to your Python project
+# Navigate to your project
 cd my-project
 
 # One-command setup: init + build + configure Claude Code
@@ -80,7 +82,14 @@ Interactive walkthrough — prompts for:
 Does everything in one step:
 1. Creates `.ctxgraph/config.toml` with your chosen extensions and excludes
 2. Installs the `/ctxgraph-code` slash command globally (works in every Claude Code session)
-3. Builds the knowledge graph from all matching files
+3. Builds the knowledge graph from all matching files — shows live per-graph progress:
+   ```
+   Building 5 graphs with 8 workers...
+     ✔ src/ (42 files, 156 nodes, 34 edges, 0.8s)
+     ✔ api/ (18 files, 73 nodes, 12 edges, 0.4s)
+     ✔ tests/ (31 files, 89 nodes, 0 edges, 0.6s)
+   Built all 5 graphs in 2.1s
+   ```
 
 Non-interactive mode:
 ```bash
@@ -122,6 +131,15 @@ Scans all matching files in the project, runs AST analysis. Extensions are read
 - `--verbose` / `-v` — show per-file progress
 - `--no-summary` — skip docstring extraction for faster builds
 
+Shows live per-graph progress as each completes:
+```
+Building 5 graphs with 8 workers...
+  ✔ src/ (42 files, 156 nodes, 34 edges, 0.8s)
+  ✔ api/ (18 files, 73 nodes, 12 edges, 0.4s)
+  ✔ tests/ (31 files, 89 nodes, 0 edges, 0.6s)
+Built all 5 graphs in 2.1s
+```
+
 Stores graphs in `.ctxgraph/graphs/<dir>.db` (per-directory) or `.ctxgraph/graph.db` (combined).
 
 > The graph is a **static snapshot**. If code changes, run `ctxgraph-code build` again to refresh. Use `--incremental` to only reprocess changed files.
@@ -225,10 +243,10 @@ ctxgraph-code probe "database connection pool"
 ctxgraph-code probe "user authentication" --max 3
 ```
 
-Searches the graph for relevant nodes **and reads the actual source code** inline. Claude gets paths + source in one command, saving 1–2 tool calls. Shows the first 40 lines of matched files with syntax highlighting.
+Searches the graph for relevant nodes **and reads the actual source code** inline. Claude gets paths + source in one command, saving 1–2 tool calls. Shows the first N lines of matched files with automatic syntax highlighting per language.
 
 - `--max` / `-m` — max files to probe (default: 5)
-- `--context` / `-c` — lines of context around matches (default: 3)
+- `--context` / `-c` — lines to show per file (default: 40, use 0 for full file)
 
 ### `install-hooks`
 
@@ -317,7 +335,10 @@ This catches the common case where you edit a file after building the graph and
 | **Multiprocessing** | Combined graphs split files across CPU cores via `multiprocessing.Pool` |
 | **`--jobs`** | Control parallelism level (default: CPU count) |
 | **Incremental builds** | `--incremental` caches file mtimes, only reprocesses changed files |
-| **Trivial file skip** | `_quick_scan()` pre-checks before AST parse for files with no imports/classes/functions |
+| **Trivial file skip** | `_quick_scan()` pre-checks all files (Python and non-Python) — skips full parse for files with no code |
+| **`follow_symlinks` config** | Respects `follow_symlinks = false` setting to avoid duplicate/broken symlinks |
+| **`max_file_size_mb` config** | Skips files exceeding the configured size limit before reading |
+| **Live build progress** | Per-graph status + timing as each completes during parallel builds |
 | **Cached excludes** | `lru_cache` on `should_exclude()` during `os.walk` |
 | **Batch SQLite inserts** | `executemany` instead of per-row `INSERT` statements |
 | **`--no-summary`** | Skips docstring extraction (fastest rebuilds) |
@@ -389,7 +410,7 @@ Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.
 
 | Feature | ctxgraph | ctxgraph-code |
 |---------|----------|---------------|
-| CLI commands | 9+ | 16 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info, install-slash, build-status, probe, install-hooks, uninstall-hooks) |
+| CLI commands | 9+ | 17 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info, install-slash, build-status, probe, install-hooks, uninstall-hooks, version) |
 | LLM integration | Built-in (Ollama, Claude, OpenAI, Azure) | None (delegates to Claude Code) |
 | Chat sessions | Yes | No |
 | Visualizer | D3.js HTML + SVG | D3.js HTML (`view` opens in browser, `--tree` for text) |
@@ -404,6 +425,7 @@ Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.
 
 - Python 3.10+
 - A Claude Code subscription (for the `/ctxgraph-code` slash command — the graph itself works standalone)
+- For multi-language analysis (C, Go, Rust, JS, TS, Java, etc.): `pip install 'ctxgraph-code[full]'` to install tree-sitter support
 
 ---
 

{ctxgraph_code-0.5.0 → ctxgraph_code-0.5.1}/README.md

@@ -4,6 +4,8 @@
 
 ```bash
 pip install ctxgraph-code
+# For multi-language support (C, Go, Rust, JS, TS, Java, etc.):
+pip install 'ctxgraph-code[full]'
 cd my-project
 ctxgraph-code setup
 ```
@@ -26,10 +28,10 @@ These questions require running multiple `grep` commands or reading dependency c
 ## Quick Start
 
 ```bash
-# Install
-pip install ctxgraph-code
+# Install (add [full] for multi-language support)
+pip install 'ctxgraph-code[full]'
 
-# Navigate to your Python project
+# Navigate to your project
 cd my-project
 
 # One-command setup: init + build + configure Claude Code
@@ -54,7 +56,14 @@ Interactive walkthrough — prompts for:
 Does everything in one step:
 1. Creates `.ctxgraph/config.toml` with your chosen extensions and excludes
 2. Installs the `/ctxgraph-code` slash command globally (works in every Claude Code session)
-3. Builds the knowledge graph from all matching files
+3. Builds the knowledge graph from all matching files — shows live per-graph progress:
+   ```
+   Building 5 graphs with 8 workers...
+     ✔ src/ (42 files, 156 nodes, 34 edges, 0.8s)
+     ✔ api/ (18 files, 73 nodes, 12 edges, 0.4s)
+     ✔ tests/ (31 files, 89 nodes, 0 edges, 0.6s)
+   Built all 5 graphs in 2.1s
+   ```
 
 Non-interactive mode:
 ```bash
@@ -96,6 +105,15 @@ Scans all matching files in the project, runs AST analysis. Extensions are read
 - `--verbose` / `-v` — show per-file progress
 - `--no-summary` — skip docstring extraction for faster builds
 
+Shows live per-graph progress as each completes:
+```
+Building 5 graphs with 8 workers...
+  ✔ src/ (42 files, 156 nodes, 34 edges, 0.8s)
+  ✔ api/ (18 files, 73 nodes, 12 edges, 0.4s)
+  ✔ tests/ (31 files, 89 nodes, 0 edges, 0.6s)
+Built all 5 graphs in 2.1s
+```
+
 Stores graphs in `.ctxgraph/graphs/<dir>.db` (per-directory) or `.ctxgraph/graph.db` (combined).
 
 > The graph is a **static snapshot**. If code changes, run `ctxgraph-code build` again to refresh. Use `--incremental` to only reprocess changed files.
@@ -199,10 +217,10 @@ ctxgraph-code probe "database connection pool"
 ctxgraph-code probe "user authentication" --max 3
 ```
 
-Searches the graph for relevant nodes **and reads the actual source code** inline. Claude gets paths + source in one command, saving 1–2 tool calls. Shows the first 40 lines of matched files with syntax highlighting.
+Searches the graph for relevant nodes **and reads the actual source code** inline. Claude gets paths + source in one command, saving 1–2 tool calls. Shows the first N lines of matched files with automatic syntax highlighting per language.
 
 - `--max` / `-m` — max files to probe (default: 5)
-- `--context` / `-c` — lines of context around matches (default: 3)
+- `--context` / `-c` — lines to show per file (default: 40, use 0 for full file)
 
 ### `install-hooks`
 
@@ -291,7 +309,10 @@ This catches the common case where you edit a file after building the graph and
 | **Multiprocessing** | Combined graphs split files across CPU cores via `multiprocessing.Pool` |
 | **`--jobs`** | Control parallelism level (default: CPU count) |
 | **Incremental builds** | `--incremental` caches file mtimes, only reprocesses changed files |
-| **Trivial file skip** | `_quick_scan()` pre-checks before AST parse for files with no imports/classes/functions |
+| **Trivial file skip** | `_quick_scan()` pre-checks all files (Python and non-Python) — skips full parse for files with no code |
+| **`follow_symlinks` config** | Respects `follow_symlinks = false` setting to avoid duplicate/broken symlinks |
+| **`max_file_size_mb` config** | Skips files exceeding the configured size limit before reading |
+| **Live build progress** | Per-graph status + timing as each completes during parallel builds |
 | **Cached excludes** | `lru_cache` on `should_exclude()` during `os.walk` |
 | **Batch SQLite inserts** | `executemany` instead of per-row `INSERT` statements |
 | **`--no-summary`** | Skips docstring extraction (fastest rebuilds) |
@@ -363,7 +384,7 @@ Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.
 
 | Feature | ctxgraph | ctxgraph-code |
 |---------|----------|---------------|
-| CLI commands | 9+ | 16 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info, install-slash, build-status, probe, install-hooks, uninstall-hooks) |
+| CLI commands | 9+ | 17 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info, install-slash, build-status, probe, install-hooks, uninstall-hooks, version) |
 | LLM integration | Built-in (Ollama, Claude, OpenAI, Azure) | None (delegates to Claude Code) |
 | Chat sessions | Yes | No |
 | Visualizer | D3.js HTML + SVG | D3.js HTML (`view` opens in browser, `--tree` for text) |
@@ -378,6 +399,7 @@ Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.
 
 - Python 3.10+
 - A Claude Code subscription (for the `/ctxgraph-code` slash command — the graph itself works standalone)
+- For multi-language analysis (C, Go, Rust, JS, TS, Java, etc.): `pip install 'ctxgraph-code[full]'` to install tree-sitter support
 
 ---
 

{ctxgraph_code-0.5.0 → ctxgraph_code-0.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ctxgraph-code"
-version = "0.5.0"
+version = "0.5.1"
 description = "Code knowledge graph for Claude Code. Build a relationship graph of your Python codebase and query it during coding sessions."
 readme = "README.md"
 license = {text = "MIT"}

{ctxgraph_code-0.5.0 → ctxgraph_code-0.5.1}/src/ctxgraph_code/cli.py

@@ -1105,7 +1105,7 @@ def version():
     try:
         ver = _v("ctxgraph-code")
     except Exception:
-        ver = "0.3.0"
+        ver = "0.5.0"
     console.print(f"ctxgraph-code version [bold]{ver}[/bold]")
 
 

{ctxgraph_code-0.5.0 → ctxgraph_code-0.5.1}/src/ctxgraph_code.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxgraph-code
-Version: 0.5.0
+Version: 0.5.1
 Summary: Code knowledge graph for Claude Code. Build a relationship graph of your Python codebase and query it during coding sessions.
 Author: ctxgraph-code contributors
 License: MIT
@@ -30,6 +30,8 @@ Requires-Dist: pytest>=7.0; extra == "dev"
 
 ```bash
 pip install ctxgraph-code
+# For multi-language support (C, Go, Rust, JS, TS, Java, etc.):
+pip install 'ctxgraph-code[full]'
 cd my-project
 ctxgraph-code setup
 ```
@@ -52,10 +54,10 @@ These questions require running multiple `grep` commands or reading dependency c
 ## Quick Start
 
 ```bash
-# Install
-pip install ctxgraph-code
+# Install (add [full] for multi-language support)
+pip install 'ctxgraph-code[full]'
 
-# Navigate to your Python project
+# Navigate to your project
 cd my-project
 
 # One-command setup: init + build + configure Claude Code
@@ -80,7 +82,14 @@ Interactive walkthrough — prompts for:
 Does everything in one step:
 1. Creates `.ctxgraph/config.toml` with your chosen extensions and excludes
 2. Installs the `/ctxgraph-code` slash command globally (works in every Claude Code session)
-3. Builds the knowledge graph from all matching files
+3. Builds the knowledge graph from all matching files — shows live per-graph progress:
+   ```
+   Building 5 graphs with 8 workers...
+     ✔ src/ (42 files, 156 nodes, 34 edges, 0.8s)
+     ✔ api/ (18 files, 73 nodes, 12 edges, 0.4s)
+     ✔ tests/ (31 files, 89 nodes, 0 edges, 0.6s)
+   Built all 5 graphs in 2.1s
+   ```
 
 Non-interactive mode:
 ```bash
@@ -122,6 +131,15 @@ Scans all matching files in the project, runs AST analysis. Extensions are read
 - `--verbose` / `-v` — show per-file progress
 - `--no-summary` — skip docstring extraction for faster builds
 
+Shows live per-graph progress as each completes:
+```
+Building 5 graphs with 8 workers...
+  ✔ src/ (42 files, 156 nodes, 34 edges, 0.8s)
+  ✔ api/ (18 files, 73 nodes, 12 edges, 0.4s)
+  ✔ tests/ (31 files, 89 nodes, 0 edges, 0.6s)
+Built all 5 graphs in 2.1s
+```
+
 Stores graphs in `.ctxgraph/graphs/<dir>.db` (per-directory) or `.ctxgraph/graph.db` (combined).
 
 > The graph is a **static snapshot**. If code changes, run `ctxgraph-code build` again to refresh. Use `--incremental` to only reprocess changed files.
@@ -225,10 +243,10 @@ ctxgraph-code probe "database connection pool"
 ctxgraph-code probe "user authentication" --max 3
 ```
 
-Searches the graph for relevant nodes **and reads the actual source code** inline. Claude gets paths + source in one command, saving 1–2 tool calls. Shows the first 40 lines of matched files with syntax highlighting.
+Searches the graph for relevant nodes **and reads the actual source code** inline. Claude gets paths + source in one command, saving 1–2 tool calls. Shows the first N lines of matched files with automatic syntax highlighting per language.
 
 - `--max` / `-m` — max files to probe (default: 5)
-- `--context` / `-c` — lines of context around matches (default: 3)
+- `--context` / `-c` — lines to show per file (default: 40, use 0 for full file)
 
 ### `install-hooks`
 
@@ -317,7 +335,10 @@ This catches the common case where you edit a file after building the graph and
 | **Multiprocessing** | Combined graphs split files across CPU cores via `multiprocessing.Pool` |
 | **`--jobs`** | Control parallelism level (default: CPU count) |
 | **Incremental builds** | `--incremental` caches file mtimes, only reprocesses changed files |
-| **Trivial file skip** | `_quick_scan()` pre-checks before AST parse for files with no imports/classes/functions |
+| **Trivial file skip** | `_quick_scan()` pre-checks all files (Python and non-Python) — skips full parse for files with no code |
+| **`follow_symlinks` config** | Respects `follow_symlinks = false` setting to avoid duplicate/broken symlinks |
+| **`max_file_size_mb` config** | Skips files exceeding the configured size limit before reading |
+| **Live build progress** | Per-graph status + timing as each completes during parallel builds |
 | **Cached excludes** | `lru_cache` on `should_exclude()` during `os.walk` |
 | **Batch SQLite inserts** | `executemany` instead of per-row `INSERT` statements |
 | **`--no-summary`** | Skips docstring extraction (fastest rebuilds) |
@@ -389,7 +410,7 @@ Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.
 
 | Feature | ctxgraph | ctxgraph-code |
 |---------|----------|---------------|
-| CLI commands | 9+ | 16 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info, install-slash, build-status, probe, install-hooks, uninstall-hooks) |
+| CLI commands | 9+ | 17 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info, install-slash, build-status, probe, install-hooks, uninstall-hooks, version) |
 | LLM integration | Built-in (Ollama, Claude, OpenAI, Azure) | None (delegates to Claude Code) |
 | Chat sessions | Yes | No |
 | Visualizer | D3.js HTML + SVG | D3.js HTML (`view` opens in browser, `--tree` for text) |
@@ -404,6 +425,7 @@ Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.
 
 - Python 3.10+
 - A Claude Code subscription (for the `/ctxgraph-code` slash command — the graph itself works standalone)
+- For multi-language analysis (C, Go, Rust, JS, TS, Java, etc.): `pip install 'ctxgraph-code[full]'` to install tree-sitter support
 
 ---