[Epic][Parity] Alcanzar 100% de paridad funcional con Hermes Agent CLI/TUI/Desktop

[0bkevin]

Objetivo

Alcanzar paridad funcional verificable entre Brio y las superficies oficiales Hermes Agent CLI, TUI y Desktop, sin reimplementar el core del agente en React Native.

Baseline auditado

• Upstream: NousResearch/hermes-agent@69ae247cf3dba34a37ab4af8484b96d3559a4fcf
• Fecha: 11-08-2026
• Documentación inventariada: 393 páginas; 50 feature docs; 35 docs de mensajería; 191 docs de skills bundled/optional.
• Fuentes principales: Features Overview, CLI reference, TUI, Desktop y Architecture.

Qué ya existe en Brio

Hay una base útil, pero parcial:

• Pairing QR/manual, conexión directa y Relay, múltiples environments.
• Lista/búsqueda/historial de sesiones.
• Runs persistentes, cancelación y aprobación básica.
• Explorador/editor de archivos de texto.
• Edición cruda de MEMORY.md, USER.md y config.yaml.
• Lista read-only de skills; toggle básico y hardcodeado de toolsets CLI.
• Lista/run/pause/resume/delete de cron.
• Tail básico de logs, health/capabilities y restart del gateway.

Definición de 100% parity

1. Toda capacidad user-facing documentada puede invocarse, observarse y administrarse desde Brio, o tiene un equivalente móvil explícito.
2. Las funciones del core se ejecutan en Hermes; Brio consume contratos oficiales y no crea una segunda implementación.
3. Las diferencias inevitables de OS se marcan platform-adapted con criterio verificable, no simplemente omitidas.
4. Ningún callback interactivo puede dejar un run bloqueado.
5. El estado compartido se refleja entre Brio, CLI, TUI y Desktop.
6. Paridad incluye seguridad, perfiles, configuración, operaciones y recovery, no solo chat.
7. [Parity][P0] Crear contrato vivo de capacidades y pruebas contra upstream Hermes #4 mantiene la matriz y CI contra upstream para que 100% siga siendo medible.

Cobertura de la documentación

Área Hermes	Issue(s)
Transporte Desktop/tui_gateway, streaming y remote backend	#3 #5 #8
Chat input, slash/quick/skill commands, context refs, vision	#6
Approvals, clarify, sudo, secrets, YOLO	#7
Sessions, resume/search/branch/archive/export	#12
Model picker, usage, context/compression	#10
Voice, STT, TTS, wake word	#9
Files, previews, deliverables, document extraction, artifacts	#11
Terminal y procesos	#14
Projects, Git review, worktrees, checkpoints/rollback	#13
Goals, heartbeat, background, delegation, Agents/Command Center	#15
Providers, auth, OAuth, custom endpoints, secrets	#23
Defaults/auxiliares, fallback, routing, credential pools, MoA	#17
Config, context files, security, managed scope, terminal settings	#16
Skills, bundles, Hub y Curator; catálogo bundled/optional	#22
MCP	#19
Plugins, built-ins, hooks y extension SDK	#21
Tools/toolsets, browser, web/X search, image/video, computer use, code execution, Tool Gateway, Spotify	#24
Memory built-in/externa, Honcho, Journey y SOUL/personality	#18
Profiles, distributions y multi-profile routing	#20
Kanban y worker lanes	#25
Gateway, adapters de mensajería, pairing, send y handoff	#26
Cron y automation blueprints	#27
Webhooks, agent email y A2A	#28
Skins/themes, pets, quick entry, notifications, shortcuts y multipane	#29
Status/logs/doctor/security/backup/import/migrate/update/uninstall/insights	#30
API server/dashboard, ACP, batch, proxy, egress, LSP, Codex runtime, Portal	#31
Drift, versionado y criterios por feature	#4

Orden de ejecución

P0: contrato y seguridad

• [Parity][P0] Adoptar el gateway JSON-RPC/WebSocket de Hermes como transporte en tiempo real #3
• [Parity][P0] Crear contrato vivo de capacidades y pruebas contra upstream Hermes #4
• [Parity][P0] Endurecer autenticación remota, Relay y gestión de dispositivos para producción #5
• [Parity][P0] Añadir perfiles Hermes reales y routing multi-profile #20
• [Parity][P0] Gestionar providers, OAuth, API keys, custom endpoints y secret sources #23

P0/P1: experiencia de agente

• [Parity][P0] Completar composer: adjuntos, referencias @, slash commands, cola y redirección #6
• [Parity][P0] Soportar todos los prompts interactivos y políticas de aprobación #7
• [Parity][P0] Implementar transcript en streaming con eventos y renderizado rico #8
• [Parity][P1] Añadir selector de modelo por sesión, contexto y analítica de uso #10
• [Parity][P1] Completar el ciclo de vida de sesiones y la concurrencia #12
• [Parity][P1] Exponer goals, heartbeat, background tasks, subagentes y Command Center #15

P1: superficies de trabajo y administración

• [Parity][P1] Implementar voz, STT, TTS y wake word con comportamiento móvil #9
• [Parity][P1] Crear Artifacts y previews ricos; completar el explorador de archivos #11
• [Parity][P1] Integrar Projects, Git review, worktrees y checkpoints/rollback #13
• [Parity][P1] Añadir terminal remoto persistente y gestión de procesos #14
• [Parity][P1] Sustituir el editor YAML como UX principal por Settings tipados y seguros #16
• [Parity][P1] Administrar defaults, modelos auxiliares, fallbacks, routing y Mixture of Agents #17
• [Parity][P1] Completar memoria, providers externos, Learning Journey y personalidad #18
• [Parity][P1] Añadir gestión completa de MCP y OAuth #19
• [Parity][P1] Gestionar plugins y hooks; definir extensibilidad de UI para Brio #21
• [Parity][P1] Completar Skills Hub, bundles y Curator #22
• [Parity][P1] Descubrir y configurar toolsets, backends y tool search dinámicamente #24
• [Parity][P1] Implementar Kanban multi-profile y worker lanes #25
• [Parity][P1] Administrar Messaging Gateway, pairing, handoff y todos los adapters #26
• [Parity][P1] Completar Scheduled Jobs: creación, edición, historial, delivery y blueprints #27
• [Parity][P1] Añadir webhooks, event automation, agent email y A2A #28
• [Parity][P1] Crear Operations Center: status, logs, doctor, seguridad, backup, update e insights #30

P2: equivalentes nativos y runtimes especializados

• [Parity][P2] Adaptar shell de Desktop a móvil: quick entry, notificaciones, commands, temas y pets #29
• [Parity][P2] Administrar runtimes avanzados: API server, ACP, batch, proxy, egress y Codex runtime #31

Definition of done del epic

• La matriz de [Parity][P0] Crear contrato vivo de capacidades y pruebas contra upstream Hermes #4 marca 100% de filas como complete o platform-adapted aprobado.
• Contract tests pasan contra la versión mínima soportada y el commit upstream fijado más reciente.
• Flujos críticos pasan E2E directo y Relay: chat, reconexión, approvals, files, profiles, cron, messaging y recovery.
• Security review cubre Companion/Relay/Mobile y no quedan modos dev habilitados por defecto.
• No quedan catálogos Hermes hardcodeados ni lecturas directas de schemas internos como state.db.
• La documentación de Brio explica compatibilidad, diferencias por plataforma y procedimiento para auditar una nueva versión de Hermes.