ctxgraph-code 0.3.0__tar.gz → 0.4.1__tar.gz

{ctxgraph_code-0.3.0/src/ctxgraph_code.egg-info → ctxgraph_code-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxgraph-code
-Version: 0.3.0
+Version: 0.4.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
@@ -23,7 +23,7 @@ Requires-Dist: pytest>=7.0; extra == "dev"
 
 # ctxgraph-code
 
-**Code knowledge graph for Claude Code.** Build a relationship graph of your Python codebase so Claude Code understands imports, class hierarchies, function calls, and cross-file dependencies without reading every file.
+**Code knowledge graph for Claude Code.** Build a relationship graph of your codebase (Python, JavaScript, TypeScript, C, Go, Rust, and more) so Claude Code understands imports, class hierarchies, function calls, and cross-file dependencies without reading every file.
 
 ```bash
 pip install ctxgraph-code
@@ -215,6 +215,37 @@ ctxgraph-code build-status
 
 Check whether a background build (`ctxgraph-code setup --background` or `ctxgraph-code build`) completed, failed, or is still running. Shows PID and start time for in-progress builds.
 
+### `probe`
+
+```bash
+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.
+
+- `--max` / `-m` — max files to probe (default: 5)
+- `--context` / `-c` — lines of context around matches (default: 3)
+
+### `install-hooks`
+
+```bash
+ctxgraph-code install-hooks
+ctxgraph-code install-hooks --local
+```
+
+Installs a **PreToolUse hook** in `.claude/settings.json` (global) or `.claude/settings.local.json` (project-local). On every `Bash|Glob|Grep` tool call, Claude Code automatically runs `ctxgraph-code hook-check` and injects graph context into the conversation — letting it know the graph exists, key files, and whether anything is stale.
+
+Also prompted during `ctxgraph-code setup`.
+
+### `uninstall-hooks`
+
+```bash
+ctxgraph-code uninstall-hooks
+```
+
+Removes the PreToolUse hooks installed by `install-hooks`.
+
 ---
 
 ## How It Works
@@ -225,7 +256,7 @@ Python files  ──AST──>  Import/Symbol/Call analysis  ──>  SQLite gra
 Claude Code  ──/ctxgraph-code──>  CLI query/deps/overview  <───┘
 ```
 
-1. **Build phase**: `ctxgraph-code build` parses every `.py` file with Python's `ast` module. It extracts imports, class/function definitions, function calls, and docstrings. The result is a graph of **nodes** (files, classes, functions) and **edges** (imports, defines, extends, calls) stored in SQLite.
+1. **Build phase**: `ctxgraph-code build` scans every matching file. Python files are analyzed with Python's `ast` module (fast, rich analysis with docstrings). All other languages (C, C++, JavaScript, TypeScript, Go, Rust, Java, Ruby, and more) are analyzed with **tree-sitter** via `tree-sitter-language-pack`. The result is a graph of **nodes** (files, functions, classes, structs, imports, calls) and **edges** (imports, defines, calls) stored in SQLite.
 
 2. **Query phase**: In Claude Code, the `/ctxgraph-code` slash command injects instructions into the conversation. Claude then runs `ctxgraph-code` commands as shell commands to query the graph. Claude reads the text output and reasons about it alongside its own file-reading capabilities.
 
@@ -234,8 +265,13 @@ Claude Code  ──/ctxgraph-code──>  CLI query/deps/overview  <───┘
 | Node type | Example ID | Stored |
 |-----------|-----------|--------|
 | `file` | `file:src/api/routes.py` | Name, path, size, summary |
-| `class` | `class:src/api/routes.py::UserAPI` | Name, path, parent file, docstring, line number |
-| `function` | `func:src/models.py::get_user` | Name, path, parent, docstring, line number |
+| `function` | `func:src/models.py::get_user` | Name, path, parent, summary, line number |
+| `class` | `class:src/api/routes.py::UserAPI` | Name, path, parent file, summary, line number |
+| `struct` | `struct:src/types.c::Point` | Name, path, parent file, line number |
+| `interface` | `interface:src/types.ts::IUser` | Name, path, parent file, line number |
+| `trait` | `trait:src/main.rs::Drawable` | Name, path, parent file, line number |
+| `import` | `import:src/main.c::stdio.h` | Import path, parent file |
+| `call` | `call:src/index.js::parse` | Function name, parent file, line number |
 
 | Edge relation | Meaning |
 |--------------|---------|
@@ -243,8 +279,19 @@ Claude Code  ──/ctxgraph-code──>  CLI query/deps/overview  <───┘
 | `defines` | A file/class defines a class/function |
 | `extends` | Class A extends class B |
 | `calls` | Function A calls function B |
+| `includes` | C/C++ file includes a header |
+
+Edge weights: `imports=1.0`, `defines=1.0`, `extends=0.8`, `calls=0.7`, `includes=0.6`
+
+### Tamper Detection
+
+Every build stores **SHA256 content hashes** for every analyzed file in the graph metadata. On every query, `ctxgraph-code` re-reads the file content, recomputes the hash, and compares:
+
+- **No match → tamper warning** shown at the bottom of every command output
+- PreToolUse hook also warns inside Claude Code before any search/grep tool runs
+- Use `ctxgraph-code build --incremental` to refresh only tampered files
 
-Edge weights: `imports=1.0`, `defines=1.0`, `extends=0.8`, `calls=0.7`
+This catches the common case where you edit a file after building the graph and Claude would otherwise see stale data.
 
 ### Query relevance scoring
 
@@ -262,6 +309,7 @@ Edge weights: `imports=1.0`, `defines=1.0`, `extends=0.8`, `calls=0.7`
 
 | Optimization | Details |
 |---|---|
+| **Multi-language** | Uses Python `ast` for `.py` (fast + docstrings) and **tree-sitter** for 25+ languages (C, C++, JS, TS, Go, Rust, Java, Ruby, Kotlin, Swift, and more) |
 | **Parallel builds** | Per-directory graphs build concurrently via `ThreadPoolExecutor` |
 | **Multiprocessing** | Combined graphs split files across CPU cores via `multiprocessing.Pool` |
 | **`--jobs`** | Control parallelism level (default: CPU count) |
@@ -271,6 +319,8 @@ Edge weights: `imports=1.0`, `defines=1.0`, `extends=0.8`, `calls=0.7`
 | **Batch SQLite inserts** | `executemany` instead of per-row `INSERT` statements |
 | **`--no-summary`** | Skips docstring extraction (fastest rebuilds) |
 | **`--background`** | Detach build process and continue working immediately |
+| **Tamper detection** | SHA256 content hashes per file; warns on tampered data in every command output |
+| **PreToolUse hook** | Claude Code auto-injects graph context before Bash/Glob/Grep, saving 1-3 exploratory tool calls |
 
 ---
 
@@ -287,6 +337,7 @@ After `ctxgraph-code setup`, the `/ctxgraph-code` slash command is installed glo
 
 **Commands:**
 - `ctxgraph-code query "terms"` -- Find relevant files, classes, and functions
+- `ctxgraph-code probe "question"` -- Search graph and read matching source inline
 - `ctxgraph-code deps <path>` -- Show what a file imports and what calls it
 - `ctxgraph-code usedby <path>` -- Show what depends on a file
 - `ctxgraph-code overview --dir <name>` -- Show project structure for a specific graph
@@ -335,7 +386,7 @@ Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.
 
 | Feature | ctxgraph | ctxgraph-code |
 |---------|----------|---------------|
-| CLI commands | 9+ | 12 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info, install-slash, build-status) |
+| CLI commands | 9+ | 16 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info, install-slash, build-status, probe, install-hooks, uninstall-hooks) |
 | 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) |