Elocore Hub — extensión VS Code / Cursor

Extensión oficial para vincular tu carpeta de trabajo con un proyecto en Elocore y enviar telemetría mínima al Hub.

Qué hace

• Vincular proyecto al Hub: crea o actualiza .elocore/project.json con el projectId (UUID) del proyecto en la web. Puedes elegir un proyecto existente o crear uno nuevo (elige mesa y título); también existe el comando dedicado Crear proyecto en el Hub desde esta carpeta.
• Cuentas distintas (p. ej. varios perfiles de Chrome / usuarios del Hub): el elocore.pairingToken lo generas en el Hub con la sesión que tengas iniciada en ese momento; ese token queda ligado a ese usuario de Supabase. Para usar otra cuenta, inicia sesión en el Hub con esa cuenta, genera un nuevo token y pégalo en los ajustes de la extensión del perfil de VS Code/Cursor que corresponda.
• Heartbeat de sesión (automático y manual): envía al servidor:
  • nombre de la carpeta del workspace (no rutas completas);
  • segundos de actividad con la ventana enfocada (aproximado);
  • nombres de archivo editados, solo basename con extensión (p. ej. auth_service.ts);
  • commits recientes: hash y mensaje (vía git log), sin diff ni contenido;
  • cada ~15 min (con proyecto vinculado e identificación): árbol de carpetas y nombres de archivo en el workspace (sin contenido), para el tablero de arquitectura en Elocore.

Identificador en el marketplace

ID de extensión: aibux-dev.elocore-hub (publicador Microsoft: aibux-dev / Aibux).

Guía rápida: conectar tu carpeta con Elocore

Pasos cortos (sin asumir que programas):

1. Instala la extensión Elocore Hub en Cursor o VS Code (marketplace).
2. Inicia sesión en Elocore en el navegador (la misma cuenta que usarás en el IDE).
3. Abre los ajustes de la extensión: en Cursor/VS Code, Ctrl+, (o Cmd+, en Mac) → busca Elocore → o abre el JSON de ajustes del usuario.
4. Rellena tres campos (todos hacen falta para que funcione la conexión y el envío de datos):

• Dirección del Hub (elocore.apiBaseUrl): pega la dirección que usa tu equipo (por ejemplo, el dominio oficial de Elocore o http://localhost:3000 si estás en local).
• Token de telemetría (elocore.telemetryToken): lo entrega quien administra Elocore (es el mismo valor que el servidor tiene configurado). Sin este token, el servidor no acepta los envíos.
• Token de emparejamiento (elocore.pairingToken): lo generas tú en Elocore (mesa de trabajo / flujo de “subir proyecto”). Empieza por elo_ y es solo tuyo; identifica tu usuario al vincular la carpeta.

5. Vincula la carpeta: comando de la paleta “Vincular proyecto al Hub” y sigue lo que te pida (elegir proyecto o crear uno).

Por qué no basta con un solo token: la dirección dice a qué servidor hablar; el token de telemetría demuestra que el cliente es legítimo para ese servidor; el token de emparejamiento demuestra quién eres en Elocore. Son tres piezas distintas.

Si solo quieres pegar un token: hoy hace falta también la dirección y el token de telemetría. El token de telemetría puede incorporarse en una versión de la extensión preparada por tu equipo al publicarla (así el usuario solo pega el elo_…), pero ese valor no puede considerarse “secreto imposible de ver”: quien descargue la extensión podría extraerlo. Para muchos equipos es aceptable si el servidor valida también el emparejamiento y limita abusos.

¿Van encriptados los tokens en settings.json? No: lo que guardas en ajustes en texto plano queda en un archivo de configuración en tu PC. No es cifrado extra. El token elo_… es revocable en el Hub si se filtra. Para el futuro, la extensión podría guardar el emparejamiento en el almacén secreto del editor en lugar del JSON; el token de telemetría compartido seguiría siendo un “candado del cliente” típico, no cifrado mágico.

Configuración (referencia)

En Ajustes (JSON o UI), clave elocore:

Privacidad (obligatorio)

• No se envía contenido de archivos, diffs, snippets ni credenciales.
• No se envían rutas completas del disco; solo el nombre de la carpeta raíz del workspace, el nombre de archivo (con extensión) de los documentos editados y, para el árbol, nombres relativos de carpetas/archivos (sin contenido; se omiten node_modules, .git, etc.).
• Los commits se limitan a hash y mensaje público del historial de Git; nunca el diff.
• Requiere git en el PATH para listar commits; si no hay repositorio Git, simplemente no se envían commits.

Si tienes duda sobre si un dato es seguro, no lo envíes: abre un issue en el repositorio del producto.

Problemas frecuentes

• command 'elocore.sendHeartbeat' not found: lo muestra el propio editor antes de que nuestra extensión arranque; desde el código no podemos cambiar ese mensaje. Suele bastar con Developer: Reload Window y volver a ejecutar el comando. Si pasa al abrir otro repo, recarga tras cambiar de ventana o instala la última versión de la extensión.
• «Enviar heartbeat de sesión» y no pasa nada: si no hay error, el envío puede ser correcto pero silencioso; a partir de la 0.1.6 verás un aviso de confirmación al terminar. Si la telemetría está en pausa (elocore.telemetryPaused: true), verás un aviso explicándolo.

Desarrollo e instalación local

cd packages/extension
npm install
npm run compile 

En VS Code / Cursor: Run → Start Debugging con la configuración “Extension” (o abre esta carpeta como workspace y usa Run Extension).

Para generar un .vsix (opcional): instala @vscode/vsce globalmente o como devDependency y ejecuta vsce package.

Archivo local .elocore/project.json

Ejemplo:

{
  "projectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

El UUID debe coincidir con un proyecto existente en tu instancia de Elocore (Supabase).