Tesserae v0.26.0 — compilaciones que terminan y dicen lo que hicieron

<!-- translations:start -->

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

<!-- translations:end -->

Released 2026-07-26 · PyPI · GitHub release · pip install --upgrade tesserae==0.26.0

v0.25.1 detuvo que las compilaciones se atascaran. Este lanzamiento las hace rápidas, las hace honestas sobre lo que cubrieron, y detiene la ingesta de basura.

Más rápido

• Extracción paralela. El bucle de lotes generaba un subproceso CLI y lo bloqueaba, un documento a la vez — el tiempo de pared era la suma literal de cada viaje de ida y vuelta del modelo, medido en aproximadamente 2 horas 40 minutos para 161 documentos. La extracción ahora ejecuta 4 documentos concurrentemente de forma predeterminada (TESSERAE_EXTRACT_CONCURRENCY=1 restaura la ejecución secuencial).

La concurrencia cambia la velocidad, nunca la salida: la lista de trabajo se fija en el orden de rutas y los resultados se recopilan por índice. merge_graphs resuelve ID de nodos duplicados posicionalmente, por lo que la recopilación por orden de finalización generaría silenciosamente un gráfico diferente — fijado por una prueba cuyo extractor termina en orden de ruta inverso.

• El caché de respuesta realmente almacena en caché. complete_json siempre ha tomado cache_key, y ambos clientes CLI lo aceptaban y lo desechaban — solo el cliente Anthropic lo ha usado. El contenido idéntico volvía a pagar el precio completo en cada compilación. Ambos ahora leen y escriben un caché de direcciones de contenido bajo ~/.tesserae/llm_cache, con clave en contenido más modelo y esfuerzo de razonamiento, por lo que cambiar de modelos vuelve a preguntar en lugar de servir las respuestas del modelo anterior. Solo se almacenan respuestas analizables. TESSERAE_LLM_CACHE=0 desactiva.

Honesto

• Los errores de extracción se nombran, no se tragan. Una taxonomía de fallos distingue los fallos transitorios (reintentos) de los reales, --limit ya no renuncia a la cobertura del gráfico, y el alcance de autenticación por hogar detiene una mala entrada contaminando una ejecución.
• Marcadores de integridad graphed. Una fila de manifiesto se marca solo después de que su contenido llega realmente a graph.json — por lo que una compilación que muere a mitad de camino ya no puede dejar filas afirmando cobertura que el gráfico no tiene. Los documentos eliminados y renombrados se marcan con lápida en lugar de permanecer para siempre.
• Alcance de --retry-fallbacks ahora vuelve a intentar exactamente los documentos cuya extracción tipificada falló, y nada más.

Más limpio

• Los directorios de basura permanecen fuera del corpus. Los tmpdirs de pytest (pytest-of-<user>/pytest-N/) y los directorios temporales de pip caen dentro de una raíz de origen configurada cuando TMPDIR se resuelve en el repositorio, plantando miles de archivos de accesorios desechables que cambian en cada ejecución de prueba — por lo que el conjunto de candidatos nunca se repite y --changed-only nunca puede no hacer nada. Un manifiesto de proyecto real tenía 25,269 entradas de las cuales 16,110 (63%) apuntaban a archivos que ya no existen.

El caminante ahora salta estas familias durante el descenso recursivo. Es una regla de directorio: docs/pip-install-guide.md es un documento ordinario y permanece indexado — el slugificador de concepto propio de Tesserae acuña exactamente esa forma de nombre de archivo desde cualquier encabezado "pip install x".

También

• El modelo Codex predeterminado es gpt-5.6-luna.
• Nueva referencia de ajuste documentando las 29 variables de entorno TESSERAE_* — valores predeterminados, qué controla cada una y cuándo cambiar. Varios, incluido el tiempo de espera de extracción enviado en v0.25.1, no tenían documentación en absoluto.

Actualización desde v0.25.1

Instalación directa. Dos cosas que vale la pena saber:

La extracción ahora se ejecuta 4 anchos. Si su cuenta de proveedor tiene un límite de velocidad estricto, establezca TESSERAE_EXTRACT_CONCURRENCY=1.

La primera compilación después de la actualización puede hacer más trabajo de lo habitual — los marcadores graphed no existen en manifiestos antiguos, por lo que las filas que los preceden se tratan como no comprobadas y se remarcan. Esta es una recompilación correctiva, no un costo permanente.