chimera-run-the-projects-own-gate-command

Stai per eseguire il gate di qualità del progetto — lint, type check, test — e riportarne l'esito come prova che una modifica è sicura. La tentazione è restringerlo ("ho toccato solo chimera/") oppure irrigidirlo ("--strict è sicuramente meglio").

Non si applica all'esplorazione. Eseguire pytest tests/test_governed_surfaces.py -x mentre itera su un singolo file è la cosa giusta da fare; la regola riguarda ciò che poi puoi chiamare il gate. Un'esecuzione ristretta è un ausilio al debug, mai la verifica.

1. Trova dove il comando è scritto, e designa UNA fonte come canonica. In Chimera è il target check nel Makefile — make check — perché un target è eseguibile e una riga di prosa ne è una copia. I tre controlli che esegue sono ruff check ., mypy chimera e pytest -q.
2. Esegui la forma canonica byte per byte. Nessun argomento di percorso aggiunto, nessun flag aggiunto, nessun runner sostituito. Attenzione: una copia in prosa può differire in modi che sembrano cosmetici e non lo sono: Makefile:21 la avvolge come uv run --no-sync, CONTRIBUTING.md:105 come uv run --extra dev --extra desktop. Stesso strumento, ambienti diversi — che è esattamente il motivo per cui una delle due deve essere la fonte.
3. Se due fonti sono in disaccordo, considera autorevole il workflow di CI, esegui quello, e correggi il documento obsoleto nella stessa PR — CONTRIBUTING.md ha portato per un po' una riga mypy --strict sbagliata, e un'istruzione obsoleta si propaga a chiunque la legga.
4. Se il comando canonico non può essere eseguito nel tuo ambiente, di' che il gate non è stato eseguito. Su Windows il .venv locale è rotto (litellm vuole Rust/MSVC), quindi il gate gira in WSL — spostare la shell è consentito, modificare il comando no.
5. Riporta il comando e il suo output alla lettera, non un riassunto di come è andata.

Il comando canonico è di solito il più lento, e una regola che vieta la variante rapida spinge verso il non eseguire proprio nulla. È un esito peggiore di un'esecuzione ristretta etichettata onestamente.

Misura il costo prima di decidere che la regola è economica, e rimisuralo man mano che la suite cresce. La prima stesura di questa card diceva che la suite completa di Chimera durava "circa quindici secondi" — un numero vero una volta e che, al momento in cui la card è stata scritta, era slittato a circa 100 secondi su quattro esecuzioni misurate. Una card sul non improvvisare comandi è un pessimo posto in cui pubblicare una cifra che non sopravvive all'esecuzione del comando.

E la recipe stessa può essere sbagliata. Seguirla alla lettera significa ereditarne i punti ciechi: make check non ti dirà che un test legge un bench/local_lift/results/paired.json ignorato da git che un clone fresco non ha. La soluzione per un gate cattivo è cambiare la recipe in una PR, non eseguire di nascosto una versione privata migliore — un miglioramento privato protegge esattamente una persona e lascia la CI, e tutti gli altri, sul vecchio comando.