Skip to content

v1.4.0

Choose a tag to compare

@UreckChan UreckChan released this 27 Oct 21:30
· 6 commits to main since this release

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 manda conversation_id/workspace_roots, Codex last_assistant_message, Gemini prompt_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-hooks para 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: hooks en settings.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.js que inyecta vía experimental.chat.system.transform y captura con chat.message / session.idle.
  • ale clean — limpieza segura. Prompts viejos sin reuso → un archivo por proyecto-mes en archive/ 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.jsonl se rota sin cambiar los totales. Nunca toca lecciones, planes, mapas, verificaciones, notas ni sesiones. Vista previa por defecto, --yes aplica, --backup respalda. 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 --archive y respaldo automático de vault_search al archivo cuando el índice no encuentra nada.
  • Bloque de uso en AGENTS.md además de CLAUDE.md (Codex, OpenCode, Cursor, Devin lo leen). Si CLAUDE.md ya importa @AGENTS.md, solo se escribe en AGENTS.md.
  • Plugins: el repo público es marketplace de Claude Code (.claude-plugin/) y trae manifiesto de plugin de Codex (.codex-plugin/). Nuevo ale hook <evento> para que los plugins no dependan de rutas absolutas.

Fixed

  • Planes duplicados en el digest (Plan - X · Plan - X): notesByTag contaba dos veces una nota con tipo y tag iguales; también inflaba los conteos de ale audit.
  • Plan - Plan - X: plan_create ya no duplica el prefijo cuando el agente lo incluye; task_verify encuentra 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; findMap prefiere 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 en Date y se guardaban con String(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 uninstall es simétrico: quita MCP, hooks y bloques de instrucciones de todos los agentes, no solo de Claude Code.

Changed

  • Dependencias: @modelcontextprotocol/sdk 1.32, zod 4, commander 15, @huggingface/transformers 4 (mismos vectores que v3 — coseno 0.998 — así que no hace falta reindexar), vitest 5, tsup 9. npm audit: 0 vulnerabilidades (override de sharp a ^0.35.5).
  • Servidor MCP migrado de server.tool() (deprecado) a registerTool().
  • ale consolidate pasa a ser alias de ale clean --prompts-only.
  • Tests 75 → 88.

Install

npm install -g @ureck/alexandria

📖 Documentation / Documentación