Objetivos

Section titled “Objetivos”
  1. Indexar la codebase del runtime AI-LAB localmente via GitNexus
  2. Construir un grafo de dependencias determinista mediante AST scanning
  3. Calcular el blast radius para cada módulo mediante BFS
  4. Mapear módulos a dominios operacionales de ownership
  5. Detectar riesgos estructurales (high coupling, reverse coupling, wide blast)
  6. Generar un structural health score reproducible (0-100)
  7. Integrar con governance, validation, incidents y reporting

Arquitectura

Section titled “Arquitectura”
Runtime source (/opt/ai-lab/runtime/)
         │
         ▼
    AST Scanner (_parse_imports)
         │
         ▼
    Import Graph (_build_import_graph)
         │
         ▼
    Ownership Mapping (_path_to_domain)
         │
         ▼
    Blast Radius BFS (_build_blast_radius)
         │
         ▼
    Structural Risk Detection (_detect_structural_risks)
         │
         ▼
    Health Score (_compute_score)
         │
         ▼
    8 Gateway Endpoints + 6 Prometheus Metrics + 4 Invariants

Resultados

Section titled “Resultados”

Índice

Section titled “Índice”
  • Índice local GitNexus v1.6.5: 460 archivos, 10,145 nodos, 15,369 edges
  • Módulos del runtime descubiertos: 62
  • Edges de dependencia: ~274
  • Dominios de ownership: 24

Rango de Score

Section titled “Rango de Score”
  • Típico: 20-80 (depende de la densidad de coupling)
  • Fórmula: 100 - high_risks*5 - medium_risks*2 - edge_density_penalty
  • Determinista: misma codebase → mismo score

Hallazgos Clave

Section titled “Hallazgos Clave”
  1. El módulo gateway tiene el reverse coupling más alto (15 dependientes) — los cambios aquí tienen el blast radius más amplio
  2. governance, authority y validation forman una tríada de alto coupling
  3. Los edges cross-domain revelan que los dominios operacionales están más acoplados de lo esperado
  4. El escaneo solo con AST es suficiente para cognición estructural — no se necesita análisis semántico completo

Estado

Section titled “Estado”
  • Indexación: COMPLETADA
  • Grafo de dependencias: COMPLETADO
  • Blast radius: COMPLETADO
  • Ownership mapping: COMPLETADO
  • Detección de riesgos estructurales: COMPLETADA
  • Gateway endpoints (8): COMPLETADOS
  • Prometheus metrics (6): COMPLETADAS
  • Integración con governance: COMPLETADA
  • Invariantes de validación (4): COMPLETADOS
  • Incident intelligence: COMPLETADO
  • Cognitive compression: COMPLETADO
  • Integración con reporting: COMPLETADA
  • Tests (31): PASSING

Veredicto

Section titled “Veredicto”

La integración de memoria estructural GitNexus proporciona a AI-LAB cognición de codebase determinista, grounded y operacional sin dependencias externas ni análisis basado en LLM.

Nota Operacional (UI)

Section titled “Nota Operacional (UI)”

Si la UI de GitNexus se queda en “Waiting for server to start” desde un PC remoto, el problema suele ser el default backend URL (http://localhost:4747).

Ver:

  • runbooks/gitnexus-local-ui-backend-url.md