Validate documentation: dar de alta robosoft en la raíz y regenerar el inventario - #88
Merged
Merged
Conversation
…cumental `Validate documentation` seguia en rojo despues de arreglar el registro de gaps, porque tenia TRES causas y no una. El job encadena sus pasos con `bash -e`, asi que cada fallo tapaba al siguiente: solo se veia el primero. 1. `Validate root cleanliness` rechazaba `robosoft/`. El directorio entro con GT-604 (`65820f9`) sin darse de alta en la allowlist de la raiz, y como este paso corre ANTES que los inventarios, abortaba el job entero. El fallo se leia como «documentacion invalida» cuando lo que pasaba era que la taxonomia de la raiz se habia quedado atras respecto al repositorio — el mismo caso que motivo la entrada de `evolith.yaml` el 2026-07-18. Se da de alta en vez de reubicarlo: los robots son consumidores EXTERNOS del despliegue —hablan con el tracker-api por HTTP como lo haria un cliente, sin compartir codigo ni configuracion con lo que prueban— y `local-test.sh` los invoca como `node "$ROOT/robosoft/run.mjs"`, con $ROOT en la raiz. 2. `doc-inventory --check` acusaba deriva real: la insignia decia 54 ADRs y hay 55, y el README de robosoft decia 12 robots y hay 13 — falta el `core-evidence-ingest` que llego con GT-604. Regenerado con `--write`, que es la via que el propio guardian indica. Los bloques se DERIVAN del codigo; escribirlos a mano es como se produjo la deriva. Verificado como lo haria el runner y no en el arbol de trabajo: se extrajo el arbol commiteado a un directorio limpio —sin `.codex/` ni `.worktrees/`, que son locales y en CI no existen— y se ejecutaron LOS SEIS pasos del job, no solo el que fallaba. Los seis en verde. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Validate documentationseguía en rojo después de arreglar el registro de gaps (#86), porque tenía tres causas y no una. El job encadena sus pasos conbash -e, así que cada fallo tapaba al siguiente: sólo se veía el primero.1 ·
Validate root cleanlinessrechazabarobosoft/El directorio entró con GT-604 (
65820f9) sin darse de alta en la allowlist de la raíz. Como este paso corre antes que los inventarios, abortaba el job entero — y el fallo se leía como «documentación inválida» cuando lo que pasaba era que la taxonomía de la raíz se había quedado atrás respecto al repositorio. Es el mismo caso que motivó la entrada deevolith.yamlel 2026-07-18.Se da de alta en vez de reubicarlo, y la razón está en el comentario: los robots son consumidores externos del despliegue —hablan con el tracker-api por HTTP como lo haría un cliente, sin compartir código ni configuración con lo que prueban— y
local-test.shlos invoca comonode "$ROOT/robosoft/run.mjs", con$ROOTen la raíz del repositorio.2 ·
doc-inventory --checkacusaba deriva realcore-evidence-ingest, que llegó con GT-604.Regenerado con
--write, que es la vía que el propio guardián indica. Esos bloques se derivan del código; escribirlos a mano es exactamente cómo se produjo la deriva.Verificación
No basta con que pase en el árbol de trabajo:
.codex/y.worktrees/son directorios locales que en CI no existen y que enmascaran el resultado del validador de raíz en ambos sentidos. Así que se extrajo el árbol commiteado a un directorio limpio y se ejecutaron los seis pasos del job, no sólo el que fallaba:validate-docscheck-bilingual-parityvalidate-root-cleanlinessdoc-inventory --checkcoverage-dashboardbilingual-coverage🤖 Generated with Claude Code