Repository navigation
v1.4.0
Alexandria deja de ser "Claude Code + MCP para el resto": la captura automática y la inyección de contexto llegan a los arneses más usados, la bóveda se limpia sola sin perder conocimiento y todas las dependencias quedan al día.
Added
- Hooks en Codex CLI, Gemini CLI, Cursor y OpenCode. Los mismos 3 scripts de siempre, ahora con
--harness=<id>: un adaptador (src/hooks/adapters.ts) normaliza el payload de cada arnés (Cursor mandaconversation_id/workspace_roots, Codexlast_assistant_message, Geminiprompt_response…) y traduce la salida al formato que cada uno espera (hookSpecificOutput.additionalContext,additional_context, o system prompt).ale agents <ids>registra MCP y hooks (--no-hookspara solo MCP). Probado en real: OpenCode 1.18 respondió con el contexto inyectado sin usar herramientas; Codex requiere aprobar los hooks una vez con/hooks.- Codex:
.codex/hooks.json(SessionStart · UserPromptSubmit · Stop · PreCompact). También MCP por proyecto en.codex/config.toml. - Gemini CLI:
hooksensettings.json(SessionStart · BeforeAgent · AfterAgent · PreCompress; timeouts en ms). - Cursor:
.cursor/hooks.json(sessionStart inyecta; beforeSubmitPrompt solo captura porque Cursor no permite inyectar ahí; afterAgentResponse guarda la sesión). - OpenCode: plugin
.opencode/plugins/alexandria.jsque inyecta víaexperimental.chat.system.transformy captura conchat.message/session.idle.
- Codex:
ale clean— limpieza segura. Prompts viejos sin reuso → un archivo por proyecto-mes enarchive/con el texto íntegro (verificado antes de borrar cada original), fuera del índice semántico y del grafo; prompts que en realidad inyectó el arnés (<task-notification>,<system-reminder>…) se descartan; temporales y modelos viejos en caché se purgan;stats.jsonlse rota sin cambiar los totales. Nunca toca lecciones, planes, mapas, verificaciones, notas ni sesiones. Vista previa por defecto,--yesaplica,--backuprespalda. Medido en una bóveda real de 3042 notas: 1489 prompts compactados en 48 archivos, 158 de ruido descartados, índice 17.3 → 10.5 MB, disco 34 → 19 MB, 642/642 notas de conocimiento idénticas byte a byte.- Limpieza automática semanal (toggle
clean.auto, en segundo plano al cerrar sesión, nunca dentro del presupuesto del hook). ale search --archivey respaldo automático devault_searchal archivo cuando el índice no encuentra nada.- Bloque de uso en
AGENTS.mdademás deCLAUDE.md(Codex, OpenCode, Cursor, Devin lo leen). SiCLAUDE.mdya importa@AGENTS.md, solo se escribe enAGENTS.md. - Plugins: el repo público es marketplace de Claude Code (
.claude-plugin/) y trae manifiesto de plugin de Codex (.codex-plugin/). Nuevoale hook <evento>para que los plugins no dependan de rutas absolutas.
Fixed
- Planes duplicados en el digest (
Plan - X · Plan - X):notesByTagcontaba dos veces una nota con tipo y tag iguales; también inflaba los conteos deale audit. Plan - Plan - X:plan_createya no duplica el prefijo cuando el agente lo incluye;task_verifyencuentra el plan con o sin prefijo.- El digest de inicio muestra solo planes y sesiones del proyecto actual (antes: de todos los proyectos, archivados incluidos, y la lista crecía para siempre). Los planes nuevos llevan el tag del proyecto;
findMapprefiere el mapa del proyecto actual. - Notificaciones del arnés guardadas como prompts del usuario: ~5% de la bóveda real era
<task-notification>de subagentes, y además se reinyectaba como "contexto relevante". Ya no se capturan. - Fechas
"Sun Jul 12 2026 …": gray-matter convierte timestamps YAML enDatey se guardaban conString(date), rompiendo el orden por fecha. Ahora todo es ISO (y los índices viejos se normalizan al cargar). grafo.html(MB en bóvedas grandes) ya no se reescribe en cada prompt desde los hooks.ale uninstalles simétrico: quita MCP, hooks y bloques de instrucciones de todos los agentes, no solo de Claude Code.
Changed
- Dependencias:
@modelcontextprotocol/sdk1.32,zod4,commander15,@huggingface/transformers4 (mismos vectores que v3 — coseno 0.998 — así que no hace falta reindexar),vitest5,tsup9.npm audit: 0 vulnerabilidades (override desharpa ^0.35.5). - Servidor MCP migrado de
server.tool()(deprecado) aregisterTool(). ale consolidatepasa a ser alias deale clean --prompts-only.- Tests 75 → 88.
Install
npm install -g @ureck/alexandria