Skip to content

v1.6.0

Choose a tag to compare

@UreckChan UreckChan released this 28 Oct 16:00
· 4 commits to main since this release

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 con ale run show <id> --grep/--lines o la tool MCP run_output.
    • Claude Code: hook PostToolUse sobre Bash con updatedToolOutput (toggle run.fold). El comando corre con el flujo de permisos normal; solo cambia lo que el agente lee. Los comandos que fallan disparan PostToolUseFailure, 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 de CLAUDE.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.
  • 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 PreCompact se 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 en SessionStart con source: 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) y ale 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 stats suma 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

📖 Documentation / Documentación