Plugins first-party — principios
Cortex HIVE ensambla dominios de negocio mediante plugins pip instalables. El framework descubre paquetes por entry points (cortex.plugins, cortex.panels) y activa un subconjunto en runtime; no conoce reglas de negocio de ningún plugin concreto.
¿No conoces una sigla? Consulta el Glosario.
Esta pestaña es para autores de plugins. Si mantienes la plataforma (core/ + framework/), ve a Ingeniería.
Ingeniería de plugins
Handbook completo para construir cualquier plugin: Ingeniería de plugins (SPI, hooks, CUS, persistencia).
Principios de ingeniería
| Principio | En HIVE |
| Modularidad | Un dominio por plugin; wheel pip independiente; PluginDescriptor con requires / provides |
| Interoperabilidad | Solo HTTP (/api/v1/{namespace}) y events nombrados; capabilities en /control/capabilities; sin imports cortex_plugin_* cruzados |
| Rendimiento | stateless: true cuando no hay PG; activación en caliente; MCP tools reutilizan servicios REST del plugin |
| Aislamiento del framework | Discovery por entry points; el loader no lista plugins de dominio; tests de plataforma usan enabled_plugins genérico |
Directorio de plugins integrados
Documentación canónica en docs/plugins/<id>/ (fuente única en este sitio). Los namespaces de panel (operations, admin, control, …) no son plugins de dominio; ver Namespaces y paneles.
Fundación
Operaciones
Finanzas
Integración
Muestras
Documentación canónica
| Capa | Ubicación |
| Cómo construir (SPI, hooks) | Handbook |
| Principios y directorio (esta sección) | docs/plugins/ |
| Comportamiento de dominio | docs/plugins/<id>/ |
| Composición de un vertical | Casos de uso |
| Decisiones de plataforma | ADRs |
Arquitectura y requisitos