Tesserae v0.28.2 — verify_claim desde la shell, y una documentación que mentía al respecto

<!-- translations:start -->

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

<!-- translations:end -->

Released 2026-07-27 · PyPI · GitHub release · pip install --upgrade tesserae==0.28.2

Ambos puntos vinieron de un equipo que estaba construyendo sobre verify_claim desde otra base de código. Los dos son de esos que solo aparecen cuando uno pasa a ser consumidor.

tesserae verify-claim

verify_claim era una herramienta MCP y nada más. Eso lo volvía inalcanzable para cualquiera que hable con Tesserae por subproceso en vez de importarlo — y importarlo no sale gratis: arrastra todo el árbol a tu entorno virtual y acopla la versión de tu proyecto a la nuestra.

El mismo hueco que graph-map cerró en v0.25, y la misma solución.

tesserae verify-claim -s 'Flash Attention' -p uses -o 'Tiling'
# -> {verdict, reason, triple, citation, provenance, advisory}

Los extremos se resuelven por id exacto de nodo, nombre único en casefold o alias único. No hay entrada en lenguaje natural, por diseño: cualquier otra cosa es NOT_RESOLVABLE en lugar de una conjetura.

El código de salida es 0 para todo veredicto que sea una respuesta, incluido ABSENT («este grafo no lo afirma» es una respuesta real, no un error), y 2 para NOT_RESOLVABLE, de modo que un script pueda distinguir no se pudo comprobar de se comprobó, y este es el resultado. Ramifica según verdict junto con provenance.class; nunca según reason.

El re-anclaje (re-grounding) decide veredictos. La documentación decía que jamás podría.

La documentación del parámetro reground prometía que era «advisory only» y que «nunca puede cambiar el veredicto». La implementación discrepa desde que se escribió: document_backed exige regrounded is not False.

La implementación tenía razón. SUPPORTED afirma que la evidencia de una afirmación es un fragmento literal de un documento real, y en el grafo real de 15 284 aristas 198 de 2 088 veredictos SUPPORTED citaban texto que el archivo demostrablemente no contiene: fragmentos que el extractor había cosido a través de encabezados. La clase por sí sola no puede verlo, porque la clase sale de los metadatos y solo el re-anclaje lee el disco.

Así que se corrigió la documentación, no la compuerta:

• regrounded: false — leímos el archivo y el fragmento no estaba. Una evidencia refutada no puede ser SUPPORTED; el veredicto baja a PRESENT_UNEVIDENCED.
• regrounded: null — sin comprobar (--no-reground, o sin un source_path legible). No degrada nada. Refuta, no supongas.

El veredicto sigue siendo una función pura de los bytes del grafo para un reground fijo. El re-anclaje es el único eje por el que un mismo grafo puede responder distinto, porque es el único que lee un archivo que el grafo no posee — y solo puede mover un veredicto hacia abajo.

Si consumes verify_claim, esto cambia lo que deberías leer. Basarte en verdict siempre fue correcto. Tratar regrounded como adorno ignorable, no: es una entrada de verdict, no una decoración encima.

Además

El verbo de CLI ahora carga su grafo por la misma ruta que usa la herramienta MCP, así que la superposición de descubrimiento de conexiones se aplica en ambos. verify_claim es local al par, de modo que una arista descubierta exactamente entre los dos extremos bajo prueba caería en el conjunto de aristas de una superficie y no de la otra — la misma tripleta respondiendo distinto según cómo la llamaras.

tesserae --help listaba verify-claim dos veces.

Actualizar desde v0.28.1

Drop-in. Sin cambios de API; el contrato de siete veredictos de verify_claim y las claves de su payload siguen igual que en v0.27.0.