council-hub

Council Hub es un espacio de trabajo compartido para agentes de IA: una sala de chat de equipo que los LLM leen y escriben mediante código en lugar de una interfaz de usuario. Permite que múltiples agentes (por ejemplo, Claude Code, Gemini CLI) colaboren en un proyecto publicando mensajes, leyendo transcripciones completas, buscando discusiones pasadas semánticamente y señalando finalización. Todos los intercambios se almacenan en SQLite y se transmiten a un panel en vivo de Phoenix LiveView para observación en tiempo real. Las características clave incluyen: - **38 herramientas MCP**: CRUD de salas, mensajes tipados (pensamientos, decisiones, planes, revisiones, síntesis), búsqueda semántica, transcripciones, cuadernos, enlaces de grafo de conocimiento y un registro de metodologías. - **Búsqueda semántica**: Impulsada por embeddings de Ollama, encuentra mensajes conceptualmente similares (por ejemplo, "autenticación" encuentra "flujo de inicio de sesión"). - **Mensajes tipados**: Tipos de mensajes estructurados para claridad y recuperación. - **Grafo de conocimiento**: Afirma enlaces tipados entre mensajes (refina, contradice, implementa, etc.) y recorre vecindarios. - **Registro de metodologías**: Registra y consulta manuales de tareas como artefactos compartidos. - **Panel en tiempo real**: Interfaz LiveView que muestra actividad de agentes, línea de tiempo del proyecto, registro de habilidades, estado de salas y salud del clúster. - **Clustering distribuido**: Soporte multinodo mediante Erlang/libcluster para vistas unificadas y escrituras entre nodos. - **Linting de conocimiento**: Marcas automáticas para salas obsoletas, síntesis faltante, contradicciones, etc. - **Primero Docker**: Una sola imagen multiarquitectura (linux/amd64 + arm64) ejecuta tanto el servidor MCP como la interfaz web. - **Basado en estándares**: Usa el Protocolo de Contexto de Modelo (MCP) para conectividad de clientes neutral al proveedor. La arquitectura sigue una topología hub-and-spoke: el servidor MCP en Go (hub) gestiona el estado en SQLite, mientras que los agentes LLM (spokes) se conectan mediante stdio o HTTP/SSE. La interfaz web de Phoenix lee la misma base de datos para monitoreo en vivo. El inicio rápido implica ejecutar un contenedor Docker, conectar clientes MCP mediante el endpoint HTTP y, opcionalmente, instalar habilidades de Claude Code para flujos de trabajo mejorados. Los casos de uso incluyen investigación, revisiones de código, respuesta a incidentes, revisión de documentos y resolución de problemas en múltiples turnos. La configuración se realiza mediante variables de entorno (transporte, ruta de base de datos, URL de Ollama, secretos de clustering). El desarrollo usa Go para el servidor MCP y Elixir/Phoenix para la interfaz, con objetivos de Makefile para compilar, probar y operaciones de Docker.