roampal-core

El bucle principal es idéntico — ambas plataformas inyectan contexto, capturan intercambios y puntúan resultados. El mecanismo de entrega difiere:

Claude Code solicita al LLM principal puntuar cada intercambio vía la herramienta score_memories. OpenCode nunca se autopuntúa — un sidecar independiente (una llamada API separada) revisa cada intercambio como tercero, eliminando el sesgo de autoevaluación. La herramienta score_memories no está registrada en OpenCode. La puntuación está deshabilitada por defecto hasta que la configures explícitamente vía roampal sidecar setup. Durante la configuración, Roampal detecta modelos locales (Ollama, LM Studio, etc.) y te permite elegir un modelo de puntuación. Los modelos gratuitos de Zen están disponibles como opción explícita de aceptación para usuarios sin modelo local o clave API — se enrutan a través del proxy de OpenCode que puede registrar datos. Un modelo barato o local funciona muy bien — la puntuación no necesita un modelo potente.

v0.6.0: Ciclo de vida del servidor + vinculación de perfil por directorio + red de seguridad de deduplicación. El monolito roampal/cli.py de 4,700 líneas ahora es un paquete roampal/cli/ dividido en módulos por dominio, protegido por instantáneas de salida doradas, invariantes de tabla de despacho y una suite de equivalencia byte-idéntica. Cambios visibles para el usuario además: enrutamiento de perfil por solicitud (los hooks/MCP/plugin siempre nombran su perfil; un nombre no registrado ahora falla explícitamente con un 404 "Créalo primero" en lugar de escribir silenciosamente en el almacén predeterminado); roampal profile switch ya no mata el servidor en ejecución (cada sesión recoge el nuevo perfil en su próximo intercambio); los servidores generados se ejecutan con aislamiento -E [-P] y un cwd neutral (un proyecto que contiene un directorio local roampal/ ya no puede ocultar la instalación — y las instalaciones de sitio de usuario, p. ej., Microsoft Store Python, funcionan de nuevo — un borrador anterior de este endurecimiento de generación usaba la bandera aislada -I, que también oculta el directorio de paquetes de sitio del usuario); status reporta un puerto colgado como detenido, no como error; los servidores compartidos se retiran solos después de 30 minutos inactivos (un roampal start en primer plano está exento); y roampal start --profile X sobrevive al reinicio por inactividad mediante un pin de lanzamiento persistido. Los nuevos roampal profile bind <name> / unbind fijan un directorio (y sus subdirectorios) a un perfil — "este proyecto siempre usa el perfil X" es un comando en lugar de editar manualmente el JSON de entorno. Una prueba de guardia de regresión de deduplicación (3 hechos distintos a través de la ruta real store_memory_bank, más vectores de modelo real grabados y un control negativo que recrea el régimen roto de v0.5.9 en ambas direcciones) hace que cualquier cambio futuro de incrustador o constante de distancia falle la suite al primer contacto en lugar de colapsar silenciosamente las escrituras. Corrección de privacidad (OpenCode): desde v0.3.7 el plugin de OpenCode enviaba texto de intercambio a Zen (opencode.ai) cuando no se elegía ningún modelo de puntuación — incluso después de "Omitir" y roampal sidecar disable — rompiendo la regla de v0.5.3 de "nada sale de tu máquina sin una elección explícita", que solo se había aplicado en el lado del servidor. v0.6.0 lo aplica en el plugin: Zen solo después de una aceptación explícita, y sin llamadas de puntuación hasta que se elija un modelo. Si usas OpenCode y nunca elegiste un modelo de puntuación, la puntuación ahora está desactivada hasta que ejecutes roampal sidecar setup (o --list para elegir sin el menú). Sin cambio de RAM — la huella de v0.5.9 y el estado del modelo se mantienen sin cambios.

v0.5.9: Corrección de huella de memoria + actualización de incrustador/reordenador + observabilidad de fallos — provocado por un fallo de MemoryError rastreado al arena de memoria de CPU de ONNX Runtime que nunca liberaba buffers de scratch por forma, agravado por archivos de modelo FP16 que se convertían a FP32 al cargar. Deshabilita el arena y la caché de patrón de memoria en ambos modelos, cambia el incrustador a su propia exportación INT8 medida (el mismo modelo mpnet — la actualización planificada a e5-base se retuvo para v0.6.0 después de que una puerta de precisión detectara una regresión en la guardia de casi-duplicados) y el cross-encoder a su propia exportación INT8, y comparte una sesión de cross-encoder entre todos los perfiles en lugar de una por perfil. La huella de proceso medida cae de ~2,355MB a ~484MB en aislamiento (~5x), y la búsqueda es más rápida tanto en las rutas de incrustación como de reordenamiento en lugar de intercambiar memoria por latencia. Una re-incrustación de fondo por colección migra automáticamente los vectores existentes al nuevo incrustador en el primer inicio — nunca bloquea al cliente MCP, nunca mezcla familias de modelos dentro de una colección. También añade registro basado en archivos, manejo de MemoryError/ExceptionGroup, un latido RSS y un endpoint /api/status para que el próximo incidente como este deje un rastro, y los estados degradados (incrustador caído, reordenador caído, migración en progreso) se muestran al usuario en lugar de devolver silenciosamente un resultado vacío.

v0.5.8: Lanzamiento de resiliencia a fallos — habilita SQLite WAL + durabilidad FULL en el catálogo ChromaDB para que las terminaciones bruscas (conflictos de puerto en Windows, muertes de procesos externos, pérdida de energía) ya no corrompan o vacíen la base de datos. Reescribe SessionManager.mark_scored() para realizar un reemplazo atómico de archivo temporal, garantizando que la transcripción JSONL sobreviva a un fallo a mitad de escritura. También incluye 16 nuevas pruebas automatizadas que cubren ambas correcciones, corrige la deuda de pruebas preexistente que dejaba la suite completa en rojo en Windows, y añade herramientas de desarrollo (pytest-timeout, pytest-forked, build, twine). No se requiere migración de datos; WAL se aplica en el próximo inicio del servidor.

v0.5.7: Recolección de basura al inicio para el _completion_state.json del hook MCP. El archivo acumulaba una entrada por cada conversation_id visto sin limpieza, impulsando amplificación de E/S en cada escritura y dejando banderas scored_this_turn=True atascadas que podían envenenar el respaldo de puntuación entre sesiones. El nuevo pase _cleanup_completion_state elimina entradas de más de 30 días o sin transcripción coincidente, aplica un límite máximo de 500 entradas y escribe atómicamente. El TTL de transcripción JSONL se aumentó de 7 a 30 días para mantenerse en sintonía con el TTL del archivo de estado. Se envía junto con Roampal Desktop v0.3.3.

v0.5.6: Lanzamiento de endurecimiento — cierra las brechas de cobertura restantes de la auditoría de verificación v0.5.5.x. Barrido fantasma después de la limpieza archivada, limpieza automática bajo presión de capacidad, observabilidad de deduplicación, permisos de eliminación endurecidos, pruebas de ciclo archivar-luego-añadir, alineación del prompt del sidecar con el benchmark, cola de puntuación asíncrona (reintento diferido por sesión), reescritura de calidad de definición de herramientas MCP (TDQS), autodetección de OpenCode Go en el asistente de configuración del sidecar y corrección de extracción de nombre de usuario.

v0.5.5.2: Hotfix — la instalación del plugin en Windows ahora verifica que la copia tuvo éxito (verificación de tamaño posterior a la copia + respaldo manual de lectura/escritura para interferencia de OneDrive/antivirus). También instala en %APPDATA%\opencode\plugins como respaldo ya que algunas aplicaciones Electron resuelven rutas de configuración de manera diferente en Windows. Corrige los casos restantes del problema #11 donde roampal init --force reportaba éxito pero el plugin estaba vacío o en el directorio incorrecto.

v0.5.5.1: Hotfix — OpenCode Desktop ahora cambia correctamente de perfil cuando cambias de proyecto en la interfaz (problema #10). El plugin lee el directory de la sesión activa vía client.session.get() en lugar de almacenar en caché el perfil en la carga del módulo, por lo que un plugin singleton en un espacio de trabajo multiproyecto sigue alcanzando el perfil correcto por mensaje. También: roampal init --force ahora sobrescribe el archivo del plugin de OpenCode (problema #11), con errores más claros cuando Desktop mantiene un bloqueo de archivo.

v0.5.5: Eliminación suave para memory_bank — la eliminación dura de ChromaDB no elimina realmente los vectores de HNSW, causando coincidencias fantasma de deduplicación que bloquean nuevas memorias después de la eliminación por GUI. Reemplazado con actualización de metadatos status=archived más filtro de estado en todas las rutas de consulta/deduplicación. También: mutex de puntuación → cola asíncrona (elimina solicitudes descartadas), corrección de contaminación de resumen del sidecar (delimitación con separadores).

v0.5.4: La vinculación de perfil ahora es por solicitud, no por proceso. Cada cliente (servidor MCP, plugin de OpenCode, hooks de Python para Claude Code / Cursor) envía un encabezado X-Roampal-Profile para que un solo servidor FastAPI pueda servir limpiamente múltiples perfiles simultáneamente. Corrige el problema #7 donde el ROAMPAL_PROFILE por proyecto de OpenCode Desktop en opencode.json se ignoraba porque el FastAPI singleton vinculaba el perfil una vez al inicio.

v0.5.3: La puntuación del sidecar ahora requiere configuración explícita (sin respaldo automático a Zen o localhost). Los modelos locales pequeños (qwen2.5:3b, etc.) que devuelven matrices JSON simples en lugar de respuestas con forma de OpenAI se manejan de manera transparente mediante tolerancia de forma en el lado del servidor.

┌─────────────────────────────────────────────────────────┐
│  pip install roampal && roampal init                    │
│    Claude Code: hooks + MCP → ~/.claude/                │
│    OpenCode:    plugin + MCP → ~/.config/opencode/      │
└─────────────────────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│  HTTP Hook Server (port 27182)                          │
│    Auto-started on first use, self-heals on failure     │
│    Manual control: roampal start / roampal stop         │
└─────────────────────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│  User types message                                     │
│    → Hook/plugin calls HTTP server for context          │
│    → AI sees relevant memories, responds                │
│    → Exchange stored, scored (hooks or sidecar)         │
└─────────────────────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│  Single-Writer Backend                                  │
│    FastAPI → UnifiedMemorySystem → ChromaDB             │
│    All clients share one server, isolated by session    │
└─────────────────────────────────────────────────────────┘

Consulta dev/docs/ para detalles técnicos completos.

• Reinicia Claude Code (los hooks se cargan al inicio)
• Verifica el servidor HTTP: curl http://127.0.0.1:27182/api/health

• Verifica que ~/.claude.json tenga la entrada MCP roampal-core con la ruta correcta de Python
• Revisa el panel de salida de Claude Code para errores de MCP

• Asegúrate de haber ejecutado roampal init --opencode
• Verifica que el servidor se haya iniciado automáticamente: curl http://127.0.0.1:27182/api/health
• Si no, inícialo manualmente: roampal start

Esto es esperado. Roampal tiene auto-reparación — si el servidor HTTP deja de responder, se reinicia automáticamente y se reintenta.