rai graph

Construye, consulta y gestiona el knowledge graph. El grafo es un índice unificado de todas las fuentes de contexto: gobernanza, memoria (patrones, calibración, sesiones), skills, seguimiento de trabajo y componentes descubiertos.

rai graph build

Construye el índice del grafo desde todas las fuentes. Por defecto, calcula las diferencias respecto a la construcción anterior y guarda el diff en .raise/rai/personal/last-diff.json.

Flag	Corta	Descripción
--output	-o	Ruta para guardar el JSON del índice
--no-diff		Omite el cálculo de diferencias

# Construir el índice en la ubicación por defecto
rai graph build

# Construir sin diff
rai graph build --no-diff

# Guardar en una ubicación personalizada
rai graph build --output custom_index.json

Códigos de salida: 0 éxito.

---

rai graph query

Busca en el knowledge graph conceptos relevantes.

Argumento	Descripción
QUERY_STR	Cadena de consulta — palabras clave o ID de concepto (requerido)

Flag	Corta	Descripción
--format	-f	Formato de salida: human, json. Por defecto: human
--output	-o	Ruta del archivo de salida (por defecto: stdout)
--strategy	-s	Estrategia de consulta: keyword_search, concept_lookup
--types	-t	Filtrar por tipos (separados por comas: pattern, calibration, principle, etc.)
--edge-types		Filtrar por tipos de arista (separados por comas: constrained_by, depends_on, etc.)
--limit	-l	Número máximo de resultados. Por defecto: 10
--index	-i	Ruta del índice del grafo

# Buscar por palabras clave
rai graph query "planning estimation"

# Filtrar solo patrones
rai graph query "testing" --types pattern,calibration

# Buscar un concepto específico por ID
rai graph query "PAT-001" --strategy concept_lookup

# Salida JSON compacta
rai graph query "velocity" --format json

---

rai graph context

Muestra el contexto arquitectónico completo de un módulo. Devuelve el contexto acotado (dominio), la capa arquitectónica, las restricciones y las dependencias.

Argumento	Descripción
MODULE_ID	ID del módulo, ej. mod-memory (requerido)

Flag	Corta	Descripción
--format	-f	Formato de salida: human, json. Por defecto: human
--index	-i	Ruta del índice del grafo

# Mostrar contexto para el módulo de memoria
rai graph context mod-memory

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

---

rai graph validate

Valida la estructura e integridad del índice del grafo. Verifica ciclos en las relaciones depends_on, tipos de relación válidos y que todos los destinos de aristas existan como nodos.

Flag	Corta	Descripción
--index	-i	Ruta al archivo JSON del índice

# Validar el índice por defecto
rai graph validate

# Validar un archivo de índice específico
rai graph validate --index custom_index.json

Códigos de salida: 0 válido, 1 se encontraron errores de validación.

---

rai graph extract

Extrae conceptos desde archivos markdown de gobernanza. Sin argumentos, extrae desde todas las ubicaciones de gobernanza estándar (governance/prd.md, governance/vision.md, framework/reference/constitution.md).

Argumento	Descripción
FILE_PATH	Ruta al archivo de gobernanza (opcional — extrae de todos si se omite)

Flag	Corta	Descripción
--format	-f	Formato de salida: human, json. Por defecto: human

# Extraer de todos los archivos de gobernanza
rai graph extract

# Extraer de un archivo específico
rai graph extract governance/prd.md

---

rai graph list

Lista los conceptos en el knowledge graph.

Flag	Corta	Descripción
--format	-f	Formato de salida: human, json, table. Por defecto: table
--output	-o	Ruta del archivo de salida (por defecto: stdout)
--index	-i	Ruta del índice del grafo
--memory-only / --all		Muestra solo tipos de memoria (pattern, calibration, session) o todos. Por defecto: --all

# Mostrar tabla de resumen
rai graph list

# Mostrar solo patterns/calibrations/sessions
rai graph list --memory-only

# Exportar como JSON
rai graph list --format json --output graph.json

---

rai graph viz

Genera una visualización HTML interactiva del knowledge graph. Crea un archivo HTML autocontenido con un grafo de fuerzas D3.js. Los nodos tienen código de colores por tipo, son filtrables, ampliables y buscables.

Flag	Corta	Descripción
--output	-o	Ruta del archivo HTML de salida
--index	-i	Ruta del índice del grafo
--open / --no-open		Abre en el navegador tras generar. Por defecto: --open

# Generar y abrir en el navegador
rai graph viz

# Generar en una ruta específica
rai graph viz --output graph.html

# Generar sin abrir
rai graph viz --no-open

Ver también: rai graph build, rai pattern