rai graph

Build, query, and manage the knowledge graph. The graph is a unified index of all context sources: governance, memory (patterns, calibration, sessions), skills, work tracking, and discovered components.

By default, Community CLI graph data is stored in the shared SQLite database ($RAI_HOME/raise.db, normally ~/.rai/raise.db) and isolated by project ID. Legacy JSON indexes are still supported when explicitly provided with --index, and can be imported into SQLite with rai graph import.

`rai graph build`¶

Build the graph index from all sources. By default, diffs against the previous build and saves the diff to .raise/rai/personal/last-diff.json.

Flag	Short	Description
`--output`	`-o`	Path to save index JSON
`--no-diff`		Skip diff computation
`--strict`		Fail on duplicate node IDs (for CI)
`--depth`		Symbol scan depth: `none`, `classes`, `functions`, `full`. Default: `functions`

# Build index to default location
rai graph build

# Build without diff
rai graph build --no-diff

# Save to custom location
rai graph build --output custom_index.json

Exit codes: 0 success.

`rai graph import`¶

Explicitly import legacy graph storage into the canonical SQLite graph tables. This command is user-invoked; normal graph commands do not run hidden backfills.

Flag	Description
`--from`	Import source: `legacy-json` or `kuzu`
`--path`	Path to the source graph storage

# Import a legacy JSON graph into $RAI_HOME/raise.db
rai graph import --from legacy-json --path .raise/rai/memory/index.json

# Import an optional Kuzu graph when the Kuzu dependency is installed
rai graph import --from kuzu --path ~/.rai/graph_abcd1234.kuzu

Exit codes: 0 success, non-zero if the source is missing, corrupt, or requires an optional dependency that is not installed.

`rai graph query`¶

Search the knowledge graph for relevant concepts.

Argument	Description
`QUERY_STR`	Query string — keywords or concept ID (required)

Flag	Short	Description
`--format`	`-f`	Output format: `human`, `json`. Default: `human`
`--output`	`-o`	Output file path (default: stdout)
`--strategy`	`-s`	Query strategy: `keyword_search`, `concept_lookup`
`--types`	`-t`	Filter by types (comma-separated: `pattern`, `calibration`, `principle`, etc.)
`--subtypes`		Filter by pattern subtypes (comma-separated: `approach`, `risk`, `codebase`, etc.)
`--edge-types`		Filter by edge types (comma-separated: `constrained_by`, `depends_on`, etc.)
`--limit`	`-l`	Maximum number of results. Default: `10`
`--mission`		Filter results to patterns linked to this mission
`--module`		Filter symbols by module ID (e.g., `mod-discovery`)
`--file`		Filter symbols by source file (substring match)
`--callers`		Reverse lookup — return callers of matched symbols
`--no-mission-boost`		Disable automatic mission-based score boosting
`--index`	`-i`	Graph index path

# Search by keywords
rai graph query "planning estimation"

# Filter to patterns only
rai graph query "testing" --types pattern,calibration

# Lookup specific concept by ID
rai graph query "PAT-001" --strategy concept_lookup

# JSON output
rai graph query "velocity" --format json

# Filter to patterns learned during a mission
rai graph query "patterns" --mission marketplace-v1

# Filter symbols by module
rai graph query "scanner" --module mod-discovery

# Find callers of a function
rai graph query "scan_directory" --callers --types symbol

`rai graph context`¶

Show full architectural context for a module. Returns bounded context (domain), architectural layer, guardrails, and dependencies.

Argument	Description
`MODULE_ID`	Module ID, e.g. `mod-memory` (required)

Flag	Short	Description
`--format`	`-f`	Output format: `human`, `json`. Default: `human`
`--index`	`-i`	Graph index path

# Show context for memory module
rai graph context mod-memory

# JSON output
rai graph context mod-memory --format json

`rai graph validate`¶

Validate graph index structure and relationships. Checks for cycles in depends_on relationships, valid relationship types, and that all edge targets exist as nodes.

Flag	Short	Description
`--index`	`-i`	Path to index JSON file

# Validate default index
rai graph validate

# Validate specific index file
rai graph validate --index custom_index.json

Exit codes: 0 valid, 1 validation errors found.

`rai graph extract`¶

Extract concepts from governance markdown files. Without arguments, extracts from all standard governance locations (governance/prd.md, governance/vision.md, framework/reference/constitution.md).

Argument	Description
`FILE_PATH`	Path to governance file (optional — extracts all if omitted)

Flag	Short	Description
`--format`	`-f`	Output format: `human`, `json`. Default: `human`

# Extract from all governance files
rai graph extract

# Extract from specific file
rai graph extract governance/prd.md

`rai graph list`¶

List concepts in the knowledge graph.

Flag	Short	Description
`--format`	`-f`	Output format: `human`, `json`, `table`. Default: `table`
`--output`	`-o`	Output file path (default: stdout)
`--index`	`-i`	Graph index path
`--memory-only` / `--all`		Show only memory types (pattern, calibration, session) or all. Default: `--all`

# Show summary table
rai graph list

# Show only patterns/calibrations/sessions
rai graph list --memory-only

# Export as JSON
rai graph list --format json --output graph.json

`rai graph viz`¶

Generate an interactive HTML visualization of the knowledge graph. Creates a self-contained HTML file with a D3.js force-directed graph. Nodes are color-coded by type, filterable, zoomable, and searchable.

Flag	Short	Description
`--output`	`-o`	Output HTML file path
`--index`	`-i`	Graph index path
`--open` / `--no-open`		Open in browser after generating. Default: `--open`

# Generate and open in browser
rai graph viz

# Generate to specific path
rai graph viz --output graph.html

# Generate without opening
rai graph viz --no-open

`rai graph ego`¶

Compute ego subgraph for a node without loading the full graph.

Argument	Description
`NODE_ID`	Node ID (e.g., `PAT-001`, `mod-memory`) (required)

rai graph ego PAT-001

`rai graph neighbors`¶

List direct neighbors of a node.

Argument	Description
`NODE_ID`	Node ID (required)

rai graph neighbors mod-memory

`rai graph path`¶

Find directed path between two nodes.

Argument	Description
`SOURCE`	Source node ID (required)
`TARGET`	Target node ID (required)

rai graph path PAT-001 mod-session

`rai graph metrics`¶

Compute Lanza-Marinescu structural health metrics for a module.

Argument	Description
`MODULE_ID`	Module ID (e.g., `mod-memory`) (required)

rai graph metrics mod-memory

See also: rai graph build, rai pattern

rai graph

rai graph build¶

rai graph import¶

rai graph query¶

rai graph context¶

rai graph validate¶

rai graph extract¶

rai graph list¶

rai graph viz¶

rai graph ego¶

rai graph neighbors¶

rai graph path¶

rai graph metrics¶