elsabro 2.3.0 → 3.8.0

package/references/SYSTEM_INDEX.md

@@ -108,6 +108,323 @@
 - Lazy loading
 - Wave execution
 
+### 8. `checkpointing.md` (v3.0)
+**Propósito**: Sistema de checkpointing persistente
+**Contiene**:
+- Lifecycle de checkpoints (INIT → ACTIVE → PAUSED → DONE)
+- Tipos: auto, manual, interrupt
+- API de CheckpointManager
+- Comandos: save, list, restore, diff
+
+### 9. `memory-system.md` (v3.0)
+**Propósito**: Sistema de memoria multi-nivel
+**Contiene**:
+- 4 niveles: short-term, long-term, entity, contextual
+- API de MemoryManager
+- Integración con agentes
+- Triggers de auto-learning
+
+### 10. `flow-orchestration.md` (v3.0)
+**Propósito**: Orquestación basada en grafos
+**Contiene**:
+- 10 tipos de nodos
+- Parallel branches y subflows
+- API de FlowEngine
+- Flows predefinidos
+
+### 11. `error-contracts-v2.md` (v3.0)
+**Propósito**: Contratos de resiliencia expandidos
+**Contiene**:
+- ContractCircuitBreaker
+- ContractBulkhead
+- ContractFallback
+- Integración de los 10 contratos
+
+### 12. `interrupt-system.md` (v3.0)
+**Propósito**: Sistema de interrupts para intervención humana
+**Contiene**:
+- 6 tipos de interrupt
+- API de InterruptManager
+- Integración con flows
+- Configuración de auto-interrupts
+
+### 13. `observability.md` (v3.1)
+**Propósito**: Sistema de observabilidad con OpenTelemetry
+**Contiene**:
+- Distributed tracing (spans por agente)
+- Métricas (counters, gauges, histograms)
+- Logging estructurado
+- Dashboard ASCII
+- Exporters (console, file, Jaeger, Langtrace)
+
+### 14. `streaming.md` (v3.1)
+**Propósito**: Sistema de streaming de progreso en tiempo real
+**Contiene**:
+- 3 modos: values, updates, messages
+- Progress bar ASCII
+- Throttling y buffering
+- Integración con Flow Engine
+
+### 15. `output-schemas.md` (v3.1)
+**Propósito**: Validación de outputs de agentes
+**Contiene**:
+- 5 schemas predefinidos
+- JSON Schema validation
+- Coerción de tipos
+- Retry con hints
+- Type-safe agent communication
+
+### 16. `time-travel.md` (v3.2)
+**Propósito**: Sistema de Time-Travel Debugging
+**Contiene**:
+- TimelineManager para navegación temporal
+- ReplayEngine para reproducción paso a paso
+- WhatIfAnalyzer para análisis de escenarios
+- Branching para timelines alternativos
+- Comandos: /elsabro:timeline, /elsabro:replay, /elsabro:whatif
+
+### 17. `agent-protocol.md` (v3.2)
+**Propósito**: API REST estándar para interoperabilidad
+**Contiene**:
+- OpenAPI 3.1 spec completa
+- Endpoints: /tasks, /steps, /artifacts, /agent
+- TaskMapper y StepMapper
+- ArtifactStore para archivos
+- WebSocket streaming extension
+
+### 18. `sandbox-execution.md` (v3.2)
+**Propósito**: Ejecución aislada de código
+**Contiene**:
+- SandboxManager con múltiples providers
+- DockerProvider, E2BProvider, ProcessProvider
+- Resource limits (CPU, memory, disk, PIDs)
+- Network policies
+- Interactive sessions (REPL)
+
+### 19. `event-driven.md` (v3.2)
+**Propósito**: Arquitectura orientada a eventos
+**Contiene**:
+- EventBus con pub/sub
+- EventStore para event sourcing
+- WebhookManager para integraciones externas
+- Event types predefinidos
+- Retry y dead letter queue
+
+### 20. `cost-tracking.md` (v3.3)
+**Propósito**: Sistema de tracking de costos y optimización
+**Contiene**:
+- TokenTracker para metering por request
+- BudgetManager con alertas (80%, 95%, 100%)
+- ModelOptimizer para selección inteligente de modelos
+- Dashboard de costos ASCII
+- Comandos: /elsabro:cost summary|budget|optimize
+
+### 21. `tool-registry.md` (v3.3)
+**Propósito**: Registro dinámico de herramientas
+**Contiene**:
+- ToolRegistry con registro y versionado
+- ToolDiscovery para búsqueda inteligente
+- CapabilityMatcher para matching de requisitos
+- Built-in tool definitions
+- Comandos: /elsabro:tools list|search|register
+
+### 22. `collaboration-patterns.md` (v3.3)
+**Propósito**: Patrones de colaboración entre agentes
+**Contiene**:
+- 6 patrones: supervisor, hierarchical, consensus, debate, round-robin, swarm
+- CollaborationManager con auto-selección
+- Blackboard communication para swarm
+- Configuración por patrón
+
+### 23. `prompt-management.md` (v3.3)
+**Propósito**: Gestión de prompts con A/B testing
+**Contiene**:
+- PromptRegistry con versionado
+- TemplateEngine tipo Handlebars
+- PromptOptimizer para A/B testing
+- Templates predefinidos (explore, implement, review)
+- Comandos: /elsabro:prompt list|test|experiment
+
+### 24. `testing-framework.md` (v3.4)
+**Propósito**: Framework completo de testing para agentes
+**Contiene**:
+- AgentTestRunner con suites y retries
+- MockProvider para LLM y herramientas
+- SimulationEngine para escenarios multi-agente
+- AssertionEngine con 12+ tipos (behavioral, property, semantic)
+- Comandos: /elsabro:test run|watch|coverage|mock
+
+### 25. `security-system.md` (v3.4)
+**Propósito**: Sistema de seguridad enterprise
+**Contiene**:
+- RBACManager con herencia de roles
+- SecretsVault con AES-256-GCM
+- AuditLogger con alertas automáticas
+- PolicyEngine con conditions (time, IP, rate_limit)
+- Built-in roles: admin, agent:explore, agent:implement, agent:review
+
+### 26. `configuration-management.md` (v3.4)
+**Propósito**: Gestión avanzada de configuración
+**Contiene**:
+- ConfigManager con múltiples fuentes (file, env, remote)
+- FeatureFlags con targeting y porcentaje rollout
+- EnvResolver con herencia y secretos
+- ConfigValidator con JSON Schema
+- RemoteConfigSync con polling y fallback
+
+### 27. `plugin-system.md` (v3.4)
+**Propósito**: Sistema de plugins extensible
+**Contiene**:
+- PluginLoader con discovery y validación
+- PluginRegistry con contribuciones (agents, tools, commands, hooks)
+- PluginManager con lifecycle y hot-reload
+- HookSystem con middleware chain
+- Sandbox y permissions para seguridad
+
+### 28. `flow-visualization.md` (v3.5)
+**Propósito**: Visualización y edición visual de flows
+**Contiene**:
+- FlowVisualizer con múltiples renderers (ASCII, SVG, HTML)
+- GraphRenderer con layout algorithms (dagre, elk, force, tree)
+- NodeEditor para configuración de nodos
+- ConnectionManager con validación y auto-routing
+- Comandos: /elsabro:flow visualize|edit
+
+### 29. `multi-project-memory.md` (v3.5)
+**Propósito**: Memoria compartida entre proyectos
+**Contiene**:
+- SharedMemoryHub con namespaces y versionado
+- ProjectLinker para relaciones entre proyectos
+- KnowledgeSync con manejo de conflictos
+- CrossProjectSearch con búsqueda semántica
+- KnowledgeExtractor para auto-extracción de patrones
+
+### 30. `collaborative-sessions.md` (v3.5)
+**Propósito**: Sesiones colaborativas en tiempo real
+**Contiene**:
+- SessionManager con lifecycle y permisos
+- RealtimeSync con WebSocket y reconexión
+- ConflictResolver con OT/CRDT
+- PresenceTracker para cursores y actividad
+- Comandos: /elsabro:collab create|join|leave
+
+### 31. `performance-profiler.md` (v3.5)
+**Propósito**: Profiling y optimización de rendimiento
+**Contiene**:
+- Profiler con sampling y tracing
+- BottleneckDetector con root cause analysis
+- MemoryAnalyzer para detección de leaks
+- LatencyTracker con percentiles (P50/P95/P99)
+- Dashboard ASCII con recomendaciones
+
+### 32. `kubernetes-deployment.md` (v3.6)
+**Propósito**: Sistema completo de deployment en Kubernetes
+**Contiene**:
+- K8sDeployer para gestión de deployments, namespaces, ConfigMaps, Secrets
+- HelmChartGenerator para creación de charts con values por environment
+- ResourceScaler con HPA, VPA y custom metrics (queue_length, active_agents)
+- HealthMonitor con liveness/readiness/startup probes y Prometheus metrics
+- Infrastructure components (Redis, PostgreSQL, RabbitMQ)
+- Docker multi-stage build optimizado
+- Comandos: /elsabro:k8s deploy|scale|status|logs|rollout
+
+### 33. `multi-llm-providers.md` (v3.6)
+**Propósito**: Soporte multi-proveedor de LLM
+**Contiene**:
+- ProviderRegistry para registro y gestión de proveedores
+- ClaudeProvider, OpenAIProvider, GeminiProvider, LocalProvider (Ollama), AzureProvider
+- ModelRouter para selección inteligente basada en costo/latencia/capacidad
+- ProviderHealthChecker con circuit breaker y failover automático
+- CostOptimizer para minimización de costos manteniendo calidad
+- StreamingAdapter para normalización de respuestas streaming
+- Comandos: /elsabro:llm providers|route|costs|health
+
+### 34. `enterprise-sso.md` (v3.6)
+**Propósito**: Single Sign-On enterprise
+**Contiene**:
+- SSOManager para gestión unificada de autenticación
+- SAMLProvider para SAML 2.0 con metadata automático
+- OIDCProvider para OpenID Connect con PKCE
+- SCIM 2.0 para provisioning y deprovisioning automático
+- TokenService con cifrado y rotación
+- Integración con Okta, Azure AD, Google Workspace, Auth0, Keycloak
+- Comandos: /elsabro:sso configure|test|users|audit
+
+### 35. `agent-marketplace.md` (v3.6)
+**Propósito**: Marketplace de agentes reutilizables
+**Contiene**:
+- MarketplaceRegistry para descubrimiento y listado de agentes
+- AgentPackager para empaquetado con firma criptográfica
+- PublishingPipeline para review y publicación
+- ReviewSystem con ratings, reviews y reportes
+- InstallationManager con sandboxing y permisos
+- Versionado semántico y actualizaciones automáticas
+- Comandos: /elsabro:marketplace search|install|publish|rate
+
+### 36. `mobile-companion.md` (v3.7)
+**Propósito**: App móvil companion para ELSABRO
+**Contiene**:
+- MobileAppArchitecture con Expo SDK 52+, expo-router, Zustand, React Query
+- SessionSync con WebSocket para sincronización en tiempo real
+- PushNotificationManager con expo-notifications
+- VoiceInputHandler con @react-native-voice/voice y expo-speech
+- OfflineMode con AsyncStorage y queue de acciones pendientes
+- BiometricAuth con expo-local-authentication
+- Widget Support para iOS WidgetKit y Android App Widgets
+- Comandos: /elsabro:mobile setup|sync|notify|voice
+
+### 37. `voice-commands.md` (v3.7)
+**Propósito**: Sistema de comandos de voz y dictado
+**Contiene**:
+- VoiceCommandEngine con pipeline audio -> VAD -> ASR -> NLU -> action
+- DictationTranscriber con puntuación automática y formato de código
+- IntentClassifier para comandos ELSABRO con fallback a LLM
+- MultiLanguageSupport para español, inglés, portugués
+- WakeWordDetector con Porcupine/Picovoice on-device
+- AudioFeedback con TTS multi-proveedor
+- NoiseReduction con WebRTC VAD y cancelación de eco
+- Comandos: /elsabro:voice start|stop|language|calibrate
+
+### 38. `ai-code-suggestions.md` (v3.7)
+**Propósito**: Sugerencias de código AI-powered
+**Contiene**:
+- CodeSuggestionEngine con context gathering y embedding cache
+- CompletionProvider con autocompletado inline y ghost text
+- RefactoringAdvisor para extract function/variable/rename
+- PatternDetector para anti-patterns y SOLID violations
+- DocumentationGenerator para JSDoc/TSDoc/README/API docs
+- TestSuggester para unit tests y edge cases
+- SecurityScanner para OWASP Top 10 y secrets
+- PerformanceAdvisor para N+1 queries y memory leaks
+- Comandos: /elsabro:suggest enable|disable|settings|stats
+
+### 39. `ide-integrations.md` (v3.7)
+**Propósito**: Integraciones con IDEs populares
+**Contiene**:
+- VSCodeExtension completa con WebView y contributes
+- JetBrainsPlugin para IntelliJ/WebStorm/PyCharm
+- LSPServer para cualquier editor compatible
+- SidebarPanel con TreeView de tareas y agentes
+- InlineAnnotations con CodeLens y decorations
+- QuickActions con code actions y refactoring
+- StatusBarIntegration con estado y progreso
+- KeybindingManager con atajos personalizables
+- Comandos: /elsabro:ide install|configure|shortcuts|sync
+
+### 40. `skill-marketplace-integration.md` (v3.8)
+**Propósito**: Integración automática con skills.sh ecosystem
+**Contiene**:
+- SkillDiscoveryEngine con keyword extraction y scoring algorithm
+- SkillInstallManager para instalación/actualización con semver
+- SkillCacheManager con TTL (searches: 1h, versions: 6h)
+- AutoSkillResolver con resolución de dependencias topológica
+- FlowIntegration con pre-command hooks
+- 25 keyword mappings (auth→clerk, payments→stripe, etc.)
+- 16 categorías de skills organizadas
+- Registry file: `~/.agents/.skill-lock.json`
+- API endpoint: `https://add-skill.vercel.sh/check-updates`
+- Comandos: /elsabro:skills search|install|update|list|config
+
 ---
 
 ## ESTADO UNIFICADO
@@ -229,13 +546,91 @@ Para verificar que el sistema está correctamente configurado:
 
 ## REGLAS DE ORO
 
+### Tareas y Estado
 1. **TaskCreate ANTES de cualquier acción**
 2. **TaskUpdate(in_progress) ANTES de Task()**
 3. **Tasks API como backend único** (NO duplicar con sistemas custom)
 4. **Metadata schema consistente** para type, priority, category
 5. **TaskList para sincronización** (NO archivos .md separados)
-6. **Mínimo 3 agentes HAIKU para exploración**
-7. **OPUS para implementación y verificación**
-8. **Context7 ANTES de escribir código con librerías**
-9. **Paralelismo OBLIGATORIO cuando las tareas son independientes**
-10. **Pasar contexto via Task metadata** al siguiente comando
+
+### Agentes y Modelos
+6. **4 agentes HAIKU para exploración** (Explore, Plan, code-explorer, general-purpose)
+7. **2 agentes OPUS para implementación** (executor, qa)
+8. **3 agentes OPUS para code review** (code-reviewer, silent-failure-hunter, staff)
+9. **Context7 ANTES de escribir código con librerías**
+10. **Paralelismo OBLIGATORIO cuando las tareas son independientes**
+
+### Resiliencia (v3.0)
+11. **Checkpoint automático** en cada fase/wave
+12. **Circuit Breaker** después de 5 fallos consecutivos
+13. **Bulkhead** para aislar particiones (exploration: 4, implementation: 4, verification: 2)
+14. **Fallback** con alternativas cuando operaciones fallan
+15. **Interrupts** para approval gates y error recovery
+
+### Memoria (v3.0)
+16. **Short-term** para contexto de sesión
+17. **Long-term** para patterns y mistakes
+18. **Entity** para conocimiento del codebase
+19. **Contextual** para RAG semántico
+20. **Auto-learn** de correcciones del usuario
+
+### Interoperabilidad (v3.2)
+21. **Agent Protocol** para comunicación con otros frameworks
+22. **Sandbox Execution** para código no confiable
+23. **Event-Driven** para desacoplamiento de componentes
+24. **Time-Travel** para debugging y análisis what-if
+25. **Webhooks** para integraciones externas
+
+### Optimización (v3.3)
+26. **Cost Tracking** con presupuestos y alertas automáticas
+27. **Tool Registry** para descubrimiento dinámico de herramientas
+28. **Collaboration Patterns** para orquestación multi-agente avanzada
+29. **Prompt Management** con templates y A/B testing
+30. **Model Optimizer** para selección inteligente de modelo por tarea
+
+### Enterprise (v3.4)
+31. **Testing Framework** para validación de agentes con mocks y simulación
+32. **RBAC** para control de acceso basado en roles con herencia
+33. **Secrets Vault** con cifrado AES-256-GCM y rotación
+34. **Audit Logging** con alertas automáticas y retención configurable
+35. **Plugin System** para extensibilidad con hot-reload y sandboxing
+36. **Feature Flags** para rollout gradual y A/B testing de features
+37. **Remote Config** para actualización de configuración sin re-deploy
+
+### Colaboración & UX (v3.5)
+38. **Flow Visualization** para edición visual de workflows con graph editor
+39. **Multi-Project Memory** para compartir conocimiento entre proyectos
+40. **Collaborative Sessions** para trabajo simultáneo en tiempo real
+41. **Performance Profiler** para identificar y optimizar bottlenecks
+42. **Presence Tracking** para ver cursores y actividad de colaboradores
+43. **Conflict Resolution** con OT para edición concurrente
+
+### Kubernetes & DevOps (v3.6)
+44. **K8sDeployer** para deployment automatizado en Kubernetes
+45. **HelmChartGenerator** para generación de charts con múltiples environments
+46. **ResourceScaler** con HPA/VPA y custom metrics para auto-scaling
+47. **HealthMonitor** con probes, métricas Prometheus y alertas
+48. **Infrastructure as Code** con Redis, PostgreSQL, RabbitMQ
+49. **Docker Multi-Stage** build optimizado para producción
+50. **GitOps Ready** con configuración declarativa completa
+
+### Multi-Provider & Enterprise (v3.6)
+51. **Multi-LLM Providers** con routing inteligente entre Claude/OpenAI/Gemini/Local
+52. **Model Router** para selección basada en costo/latencia/capacidad
+53. **Enterprise SSO** con SAML 2.0, OIDC y SCIM 2.0
+54. **Agent Marketplace** para descubrimiento e instalación de agentes
+55. **Provider Health** con circuit breaker y failover automático
+
+### Mobile & IDE (v3.7)
+56. **Mobile Companion** app con Expo SDK 52+ y sync en tiempo real
+57. **Voice Commands** con wake word detection y multi-idioma
+58. **AI Code Suggestions** con completions, refactoring y security scanning
+59. **IDE Integrations** para VSCode y JetBrains con LSP
+60. **Offline Mode** con cache local y sync automático
+
+### Skill Marketplace (v3.8)
+61. **SkillDiscoveryEngine** para descubrimiento automático de skills por keywords
+62. **SkillInstallManager** con instalación/actualización automática y semver
+63. **AutoSkillResolver** para resolución de dependencias y ordenamiento topológico
+64. **FlowIntegration** con pre-command hooks para auto-discovery
+65. **SkillCacheManager** con cache multi-nivel para búsquedas y versiones