CLI & CI gate
Un solo comando senza dipendenze avvia una suite, attende il verdetto ed esce con un codice che la tua pipeline capisce. PASS rilascia; FAIL blocca; INCONCLUSIVE decidi tu.
Installazione
La CLI è un singolo script Node 22 senza dipendenze, quindi gira direttamente dal repository o da npm:
npx @colvo/cli run --project <project id> --waitConfigurazione
| Opzione / env | Significato |
|---|---|
| COLVO_API_KEY | Chiave backend (cak_…). Obbligatoria. |
| COLVO_API_URL | Predefinito https://colvo.app. |
| --project | Id del progetto. Obbligatorio. |
| --build | Id della build dell’agente; predefinita quella del progetto. |
| --scenarios | Chiavi dei modelli separate da virgola; predefinito: tutta la libreria. |
| --repeats | 1–5, predefinito 3. |
| --label | Testo libero mostrato nella console (ad es. il commit). |
| --wait / --no-wait | Attende il verdetto (predefinito) o si limita ad avviare. |
| --timeout | Minuti di attesa, predefinito 15. |
| --inconclusive-exit | Codice di uscita per INCONCLUSIVE: 0, 1 o 2 (predefinito). |
Codici di uscita
| Codice | Significato |
|---|---|
| 0 | PASS |
| 1 | FAIL — un difetto dimostrato; non rilasciare |
| 2 | INCONCLUSIVE — non è un difetto dimostrato, ma non rilasciare alla cieca (configurabile) |
| 3 | Errore di utilizzo, di API o di timeout (incluso il limite di piano 402) |
GitHub Actions
name: colvo-gate
on: [push]
jobs:
suite:
runs-on: ubuntu-latest
steps:
- uses: actions/setup-node@v4
with: { node-version: 22 }
- name: Run the COLVO suite
env:
COLVO_API_KEY: ${{ secrets.COLVO_API_KEY }}
run: npx @colvo/cli run --project ${{ vars.COLVO_PROJECT_ID }} --label "${{ github.sha }}" --waitPunta la build a un deployment di staging del tuo agente (una build il cui endpoint è l’URL di anteprima) e il gate gira a ogni push. GitLab CI, CircleCI e una semplice shell funzionano allo stesso modo; conta solo il codice di uscita.