Tesserae v0.18.0 — ask responde, el motor recuerda, doctor sana

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Français · Deutsch

<!-- translations:end -->

Lanzado 2026-07-10 · PyPI · GitHub release · pip install --upgrade tesserae==0.18.0

Una revisión completa de la superficie de comandos, impulsada por una observación: tesserae ask "what happened recently?" solía devolver páginas de conceptos estáticas y un honesto encogimiento de hombros. El tema: los comandos ahora hacen lo que sus nombres prometen.

ask planifica su recuperación — y responde por defecto

tesserae ask ya no necesita --llm: el modelo lee primero tu pregunta, planifica qué primitivas del grafo de conocimiento pueden responderla (línea de tiempo, sesiones recientes, resumen de actividad, hechos temporales, páginas wiki), ejecuta ese plan, y sintetiza una respuesta con citas. Las preguntas temporales obtienen evidencia fechada en lugar de sopa de páginas de conceptos. --no-llm fuerza solo-búsqueda; TESSERAE_QUERY_DRY_RUN y la ruta clásica BM25 siguen siendo el repliegue determinista ante cualquier fallo. La recuperación cruda — resultados BM25, búsqueda semántica, y los backends explícitos raganything/cognee — ahora vive en tesserae query.

Chunks de sesión diarios: recuperación por rango de tiempo 20× más rápida

El tailer de sesiones del motor ahora escribe cada turno observado en un almacén de chunks diarios (.tesserae/session_chunks.db), y refresh lo rellena incrementalmente bajo un bloqueo de omitir-si-retenido. Las lecturas por ventana (summary, decisions, la recuperación de actividad de ask, MCP) sirven los días cubiertos desde chunks — medido 2.3s vs 48.8s en un proyecto de 45k nodos — con un repliegue de escaneo crudo con paridad garantizada, por lo que un chunk db faltante o corrupto nunca puede cambiar los resultados, solo la velocidad. tesserae sessions chunk-backfill [--since] construye el historial bajo demanda.

tesserae doctor

Veinte comprobaciones de salud en unos dos segundos: análisis de init/grafo/config, consistencia del registro, obsolescencia, bloqueos activos, estado de login, higiene. --fix aplica solo las reparaciones demostrablemente seguras (pidfiles obsoletos, logs de hooks sobredimensionados, poda del registro, reconstrucciones del sitio) y nunca toca un bloqueo de compilación activo. Los informes persisten en .tesserae/doctor-report.{md,json} y se sirven por MCP como doctor_report.

init es la instalación completa

tesserae init detecta los CLIs de LLM en tu máquina, comprueba que realmente tengan sesión iniciada, y te deja elegir — incluyendo un endpoint personalizado compatible con claude (--llm-provider custom --llm-base-url … --llm-api-key … --llm-model …). Las claves se resuelven env → proyecto → global (ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL, TESSERAE_LLM_MODEL); una clave persistida en texto plano advierte una vez. Re-init fusiona tu configuración en lugar de aplastarla.

Backends más ligeros, flags honestos

cognee ahora está desactivado por defecto, silenciado cuando se usa, instalable como tesserae[cognee], y el modo codex_cognify desapareció (−556 LOC). understand-anything ya no se auto-adopta ante la presencia de artefactos. Y una pasada adversarial sobre los 26 comandos renombró o eliminó cada flag mentiroso — summary --project→--name (con validación estricta de nombre), context --synthesize→--llm, refresh --skip-sessions→--no-sessions, vault --poll-interval→--interval, ingest --exact→--full, flags muertos eliminados — cada grafía antigua imprime un puntero de una línea a la nueva y sale con 2. Correcciones de comportamiento acompañan: un sessions import vacío ya no puede borrar el almacén, ingest --dry-run es verdaderamente seco, serve --dry-run se ejecuta antes de las builds, y el servidor MCP finalmente reporta su versión real.

Cambios incompatibles

Cada flag/comando eliminado o renombrado imprime su reemplazo y sale con 2 — nada falla en silencio. La tabla completa: ask --llm|--wiki|--backend|--cognee-*, query --llm|--no-llm|--model, summary|decisions --project, context --synthesize, refresh --skip-sessions, vault sync --poll-interval, vault export --vault, ingest --exact, research --no-web, compile --claude-timeout, config setup, wiki|projects activate.