Build Code Knowledge Graph
Build or update the .gauntlet/graph.db knowledge graph for the current codebase.
Steps
- Detect target: Use the current working directory
or a user-specified path.
- Check for existing graph: If
.gauntlet/graph.db
exists, run an incremental update. Otherwise, run a full build.
- Run the build script:
For full build: ``bash python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_build.py <dir> ``
For incremental update: ``bash python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_build.py <dir> --incremental ``
- Report results: Show the JSON output including
files parsed, nodes created, edges created, and duration.
- Suggest next steps: Recommend searching the graph
or running blast radius analysis.
When To Use
- At the start of a session to build structural awareness
- After significant code changes to update the graph
- Before running blast radius analysis or flow tracing
- When the user asks about codebase structure
What Gets Parsed
The graph extracts nodes (File, Class, Function, Type, Test) and edges (CALLS, IMPORTS_FROM, INHERITS, CONTAINS, IMPLEMENTS, TESTED_BY) from 20+ languages including Python, JavaScript, TypeScript, Go, Rust, Java, C/C++, Ruby, and PHP.
Storage
- Database:
.gauntlet/graph.db(SQLite with WAL mode) - Auto-creates
.gauntlet/.gitignoreto prevent commits - Incremental updates use SHA-256 hashing to skip
unchanged files