aggrega version
aggrega version stampa la versione della CLI aggrega.
Output
Per impostazione predefinita aggrega version stampa una riga di versione leggibile.
Con -o json emette un oggetto leggibile dalle macchine, indentato di due spazi, nella stessa forma che ogni comando aggrega usa per il proprio output JSON. Leggilo con un parser JSON; un consumer che invece fa corrispondenze sul testo dovrebbe rimuovere gli spazi bianchi prima del confronto, perché i nomi dei campi sono il contratto e la disposizione circostante no.
{ "version": "1.2.3", "committed": "2026-07-09T18:07:57Z", "commit": "a1b2c3d", "abiVersion": "v1beta1", "goVersion": "go1.23.0", "platform": "linux/amd64"}I campi provengono dai metadati di build incorporati nel binario. committed è il timestamp del commit, ed è presente solo quando la build ne ha registrato uno. abiVersion è la versione dell’ABI dei plugin parlata dal binario, che una pipeline può leggere per verificare la compatibilità dei plugin senza caricare alcun plugin. Una build di sviluppo che non contiene alcuna versione incorporata riporta un valore sentinella (come (devel)) anziché fallire.
Quando usare -o json
- Un’estensione dell’editor confronta la versione riportata dal daemon con quella per cui è stata compilata, per rilevare un binario
aggrega serveincompatibile prima di pilotarlo. - Gli strumenti di CI e di provenienza registrano l’esatta build del compilatore che ha prodotto un artefatto.
Vedi anche
- ./aggrega-serve.md — il daemon di cui un client verifica la versione per la compatibilità.
Sinossi
aggrega version [flags]Descrizione
Print the aggrega CLI's build identity.
By default the output is a single human-readable line followed by aone-line pointer to the plugins compiled into the binary. With-o json, the output is a structured JSON object suitable forprogrammatic consumption (the VS Code extension uses this form toread the binary's version at activation time), in the same indentedshape every aggrega command's JSON output uses.
With --verbose, the output replaces the pointer line with a table ofthe embedded plugins — type, name, served capabilities, and commit —under a header naming the count and their shared version. With--verbose -o json, the JSON object gains an embeddedPlugins arraycarrying the same detail.
Version strings are v-less (1.0.0, not v1.0.0), homogeneous with theversion form catalog entities use. Tagged release builds report therelease version, a build stamped with a version reports that version,and a build carrying no version stamp reports the literal "(devel)",which marks an unreleased build.Flag
| Flag | Predefinito | Descrizione |
|---|---|---|
--output, -o | text | Formato di output: text|json. |
--verbose | false | include nell’output l’insieme dei plugin incorporati |