Tesserae v0.17.0 — la ruta de compilación aprende de sus pares

<!-- translations:start -->

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

<!-- translations:end -->

Lanzado 2026-07-09 · PyPI · GitHub release · pip install --upgrade tesserae==0.17.0

Esta versión incorpora las mejores ideas de una comparación profunda contra dos proyectos hermanos de wiki-LLM — alfadur7/llm-wiki-newsroom y langchain-ai/openwiki — cada una verificada contra lo que Tesserae ya tenía antes de ser adoptada. El tema: lo que los agentes consumen ahora es correcto, fresco y descubrible por construcción.

El contexto compilado deja de citar perdedores

compile_context ahora excluye nodos superados y perdedores de arbitraje por defecto (include_superseded=True los restaura). Una afirmación que perdió arbitraje de LLM fue previamente citada idénticamente a su ganadora; el ayudante compartido superseded_ids() ahora suprime o marca estos consistentemente entre search_nodes, fresh_insights, y node_context también. Las páginas de síntesis verifican adicionalmente cada cita contra los ids de nodo de entrada reales — un id fabricado ahora falla la validación y se replega al cuerpo determinista.

Una puerta de publicación de dos lados

Las ejecuciones de lint se ejecutan de forma segura frente a bloqueos al final de cada compilación, por lo que lint-report.md siempre está fresco. tesserae compile --strict convierte los hallazgos en una salida diferente de cero para CI — y falla cerrado si lint mismo se bloquea. Un lint --verify-claims opcional va más allá: verifica por LLM si los nodos citados realmente apoyan la oración que cita (limitado, muestreado de forma determinista, nunca un bloqueador de compilación).

La puerta de snapshot de salida

Después de cada compilación, Tesserae calcula un hash de los artefactos compilados e informa Output: changed/unchanged. Bajo --strict, el estado sospechoso — entradas sin cambios pero salida cambiada — falla la compilación: un trampa permanente para la clase de bugs de byte-idempotencia. Un flujo de trabajo de actualización de CI listo para copiar vive en docs/integrations/ci-refresh.md.

Los agentes encuentran la base de conocimiento por su cuenta

tesserae setup ahora instala un bloque de puntero de Tesserae delimitado por marcadores en el AGENTS.md/CLAUDE.md del repositorio destino (idempotente; se detiene sin cambios en marcadores malformados o duplicados; coexiste con otros bloques gestionados). El index.md de la raíz wiki fue reescrito como el punto de entrada del agente: orientación, una sección "cómo consultar" centrada en MCP, la tabla de tipos, y comunidades principales. Las páginas de comunidades ganan un pie ## Sources determinista enumerando archivos de fuente de miembros.

La compilación es más barata y la obsolescencia es visible

La capa del gráfico de código ahora mantiene un caché de extracción de capa completa (.tesserae/code-graph-cache.json): cuando el manifiesto de estadísticas del árbol de fuentes es sin cambios, el gráfico en caché se rehidrata byte-idénticamente en lugar de pagar una caminata de re-extracción completa (decenas de segundos en repositorios grandes). El CLI reporta reused o +added ~changed -removed conteos delta. El historial de compilación registra el HEAD de git en el momento de la compilación, y lint emite hallazgos de información para nodos del gráfico de código cuyos archivos de fuente han cambiado desde — además una página wiki contradictions.md ahora rastrea conflictos de afirmaciones abiertos/resueltos/obsoletos, y graph_ppr gana exclude_direct_neighbors para descubrimiento de conexiones inesperadas estilo Memex.

Los cachés de resumen de comunidad también se invalidan en digests de contenido de miembros (no solo membresía), por lo que una descripción cambiada re-resume en lugar de servir una narrativa obsoleta para siempre.

Notas de actualización

• La primera compilación después de actualizar reporta Output: changed una vez (las páginas de comunidades ganan secciones Sources, index.md se convierte en el punto de entrada); las compilaciones subsecuentes son byte-estables.
• tesserae setup (incluyendo --yes) instala el puntero del agente por defecto; establece install_agent_pointer=false en el plan para rechazarlo.