Repository navigation
v1.6.0
Manejo de contexto: la mayoría de los tokens no se van en el prompt sino en la salida de las herramientas y en releer. Alexandria recorta ambos, local, sin proxy y sin reescribir el historial (resumir el historial rompe el caché del proveedor y pierde hechos: lo que sí rinde es recortar la salida a un tamaño estable).
Added
- Salida de comandos plegada. Tests/builds/installs/logs largos → errores (con la línea de stack/ubicación), resumen de tests y final; la salida completa queda en
~/.cache/alexandria/runs(se rota) y se pide por partes conale run show <id> --grep/--lineso la tool MCPrun_output.- Claude Code: hook
PostToolUsesobreBashconupdatedToolOutput(togglerun.fold). El comando corre con el flujo de permisos normal; solo cambia lo que el agente lee. Los comandos que fallan disparanPostToolUseFailure, que no permite reemplazar la salida — para esos estáale run. - OpenCode: el plugin pliega en
tool.execute.after(incluye fallos). - Todos:
ale run -- <cmd>(mismo código de salida), indicado en el bloque deCLAUDE.md/AGENTS.md. - Nunca se pliega lo que el agente pidió LEER (
cat,git diff,grep,ls…); los ruidosos conocidos desde 2 KB, cualquier otro solo si pasa de 40 KB. - Medido: test suite de este repo 12.1 KB → 1.4 KB; corrida fallida de 12.6 KB → 561 B conservando el test que falla, la aserción y
archivo:línea.
- Claude Code: hook
- Mapa de código (
code_outline/code_symbol,ale code outline|symbol): firmas con rango de líneas (clases → métodos, constantes de primer nivel) y el cuerpo de un solo símbolo (Clase.metodo). Heurístico, sin dependencias nativas: strings/comentarios enmascarados, cuerpo por llaves (ignorando tipos objeto en la firma) o indentación en Python. JS/TS, Python, PHP, Go, Java, C#, Kotlin, Rust. Medido:src/cli.ts~13,600 tokens → outline ~253. Probado en OpenCode real (de ahí salió agregar las constantes: el agente no podía pedir un regex de primer nivel). - No reinyectar lo ya inyectado (toggle
context.dedupe): una nota que ya se mandó en esta sesión va como referencia de una línea. - Cápsula anti-compactación: en
PreCompactse arma, sin LLM, una cápsula (objetivo, último pedido, archivos editados/leídos, comandos, lo guardado en la bóveda, planes abiertos; ~600 tokens) y se reinyecta enSessionStartconsource: compact/resume. Filtra mensajes del arnés y rutas temporales. Medido con un transcript real de 8.4 MB → ~576 tokens. - Hechos que caducan:
vault_save(..., supersedes)yale supersede. Lo reemplazado queda marcado y enlazado, rankea ×0.3 y deja de inyectarse — nunca se borra. - Duplicados en
ale clean: sugiere notas/lecciones casi idénticas (coseno ≥ 0.96); se aplican solo con--dedupe, nunca en la limpieza automática. Con 0.95 aparecían lecciones distintas de temas cercanos en una bóveda real; con 0.96 desaparecieron. - Medidor de contexto (
ale context): por sesión — inyecciones, tokens, notas, no-reinyección y plegado.ale statssuma ambos ahorros. - Documentación por URL en
doc_ingest/ale ingest: una página, se baja una vez y se reutiliza 7 días. Es el único acceso a red de Alexandria y solo cuando se pide.
Fixed
- Los mensajes que el arnés escribe como si fueran del usuario ("Your response above was cut off…", "Tool loaded.", "This session is being continued…") ya no se guardan como prompts.
- Búsqueda de secciones de documentos insensible a acentos ("paginacion" encuentra "Paginación"); el
<title>del HTML ya no aparece como sección.
Install
npm install -g @ureck/alexandria