rai discover

Comandos de descubrimiento y análisis del codebase. Extrae símbolos de código, analiza la arquitectura, construye el knowledge graph y detecta drift.

rai discover scan

Escanea un directorio y extrae símbolos de código (clases, funciones, métodos, interfaces, docstrings de módulos). Soporta Python, TypeScript, JavaScript, PHP, Svelte y C#.

Argumento	Descripción
PATH	Directorio a escanear. Por defecto: .

Flag	Corta	Descripción
--language	-l	Lenguaje: python, typescript, javascript, php, svelte, csharp (detección automática si no se especifica)
--output	-o	Formato de salida: human, json, summary. Por defecto: human
--pattern	-p	Patrón glob para los archivos
--exclude	-e	Patrones a excluir (repetible)

# Escanear el directorio actual (detección automática de lenguajes)
rai discover scan

# Escanear solo archivos Python
rai discover scan src/ --language python

# Salida JSON para encadenar comandos
rai discover scan src/ -l python -o json

# Excluir tests
rai discover scan . --exclude "**/test_*" --exclude "**/__tests__/**"

---

rai discover analyze

Analiza resultados de escaneo con puntuación de confianza y agrupación de módulos. Todo el análisis es determinístico — no requiere inferencia de IA.

Flag	Corta	Descripción
--input	-i	Ruta al JSON de resultados de escaneo (lee stdin si no se especifica)
--output	-o	Formato de salida: human, json, summary. Por defecto: human
--category-map	-c	Archivo YAML con mapeos personalizados de ruta a categoría

# Analizar desde un archivo
rai discover analyze --input scan-result.json

# Encadenar con escaneo
rai discover scan src/ -l python -o json | rai discover analyze

# Solo resumen
rai discover analyze --input scan-result.json --output summary

---

rai discover build

Construye el grafo unificado con los componentes descubiertos. Integra los componentes validados en el knowledge graph.

Flag	Corta	Descripción
--input	-i	Ruta al JSON de componentes validados
--project-root	-r	Directorio raíz del proyecto. Por defecto: .
--output	-o	Formato de salida: human, json, summary. Por defecto: human

# Construir con entrada por defecto
rai discover build

# Construir con entrada personalizada
rai discover build --input my-components.json

---

rai discover drift

Verifica el drift arquitectónico contra los componentes de referencia. Compara el código escaneado contra la referencia validada para detectar archivos en ubicaciones incorrectas, violaciones de nomenclatura y documentación faltante.

Argumento	Descripción
PATH	Directorio a escanear en busca de drift. Por defecto: src/

Flag	Corta	Descripción
--project-root	-r	Directorio raíz del proyecto. Por defecto: .
--output	-o	Formato de salida: human, json, summary. Por defecto: human

# Verificar todo el proyecto
rai discover drift

# Verificar un directorio específico
rai discover drift src/new_module/

# Salida JSON
rai discover drift --output json

Códigos de salida: 0 sin drift, 1 se encontraron advertencias de drift.

Ver también: rai graph build