Understand-Anything — Knowledge Graphs para Savia

Plugin externo Understand-Anything (MIT, TypeScript/pnpm) que analiza codebases via pipeline multi-agente y genera knowledge-graph.json con tres capas:

• Grafo estructural: archivos, funciones, clases, dependencias
• Grafo de dominio: procesos de negocio, flujos, steps
• Grafo de conocimiento: entidades, claims, relaciones (Karpathy-pattern)

Compatible con 13 lenguajes. Dashboard interactivo React con force-directed layout, búsqueda semántica y tours guiados.

Bridge

Savia accede a UA exclusivamente via scripts/ua-bridge.sh:

bash scripts/ua-bridge.sh check          # UA instalado?
bash scripts/ua-bridge.sh analyze [path] # generar knowledge-graph.json
bash scripts/ua-bridge.sh diff --count   # nodos afectados por cambios staged
bash scripts/ua-bridge.sh domain [path]  # extraer conceptos de negocio
bash scripts/ua-bridge.sh dashboard      # lanzar dashboard interactivo
bash scripts/ua-bridge.sh onboard [path] # guía de onboarding

Comandos Savia

Comando	Función
/ua-analyze [path]	Analizar codebase y generar knowledge-graph.json
/ua-domain [path]	Extraer dominios de negocio
/ua-diff	Impacto de cambios no commiteados
/ua-chat {query}	Preguntas sobre el grafo
/ua-dashboard	Lanzar dashboard interactivo
/ua-onboard [path]	Generar guía de onboarding
/ua-install	Instalar o actualizar UA plugin

Activación

UA no se instala con Savia. Es opt-in:

# 1. Instalar
bash scripts/ua-install.sh

# 2. Verificar
bash scripts/ua-bridge.sh check

Si check retorna exit 1, todos los comandos degradan gracefully:

• diff --count → retorna 0
• analyze → reporta "UA not installed", exit 0
• no hay crashes

Integración con sistemas Savia

Memory Feed

knowledge-graph.json → memory-agent
  DOMAIN_ENTITY edges → memoria episódica
  DEPENDS_ON edges    → dependencias técnicas
  IMPLEMENTS edges    → funciones → specs/requisitos

CI Gate G16 (WARN, no-blocking)

ua_diff_count=$(bash scripts/ua-bridge.sh diff --count)
[[ $ua_diff_count -gt 50 ]] && echo "WARN: diff impact >50 nodes affected"

Fallback

Si UA no está disponible, usar scripts/knowledge-graph.py:

python3 scripts/knowledge-graph.py .

Produce un grafo reducido compatible con la capa de memoria de Savia.

Cuándo usar

• Onboarding de proyecto nuevo (>500 ficheros)
• Análisis de impacto antes de refactoring mayor
• Extracción de dominio de negocio de codebase legacy
• Gate de CI para estimar scope de un PR

Cuándo NO usar

• Proyectos N4b (PM-Only) — el grafo mezcla código y no puede viajar al repo
• Proyectos pequeños (<100 ficheros) — overhead supera el beneficio
• Sesiones one-shot sin instalación previa de UA

Referencias

• Upstream: https://github.com/Lum1104/Understand-Anything (MIT)
• Bridge: scripts/ua-bridge.sh
• Spec: docs/specs/SPEC-SE-088-UA-ADOPT.spec.md
• Skills relacionadas: knowledge-graph, codegraph, agent-code-map