graph-build

name	graph-build
description	Builds or updates the code knowledge graph via tree-sitter AST and SQLite. Use when setting up the graph before search or blast-radius analysis.
model_hint	standard

Build Code Knowledge Graph

Build or update the .gauntlet/graph.db knowledge graph for the current codebase.

Steps

1. Detect target: Use the current working directory or a user-specified path.

2. Check for existing graph: If .gauntlet/graph.db exists, run an incremental update. Otherwise, run a full build.

3. Run the build script:

   For full build:

   python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_build.py <dir>
   

   For incremental update:

   python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_build.py <dir> --incremental
   

4. Report results: Show the JSON output including files parsed, nodes created, edges created, and duration.

5. 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