aggrega version
aggrega version выводит версию CLI aggrega.
Вывод
По умолчанию aggrega version выводит строку с версией в удобочитаемом виде.
С -o json команда выдаёт машиночитаемый объект с отступом в два пробела, в той же структуре, которую каждая
команда aggrega использует для вывода JSON. Читайте его парсером JSON; потребитель, который вместо этого сопоставляет
текст, должен удалять пробельные символы перед сопоставлением, поскольку контрактом являются имена полей,
а окружающее форматирование — нет.
{ "version": "1.2.3", "committed": "2026-07-09T18:07:57Z", "commit": "a1b2c3d", "abiVersion": "v1beta1", "goVersion": "go1.23.0", "platform": "linux/amd64"}Поля берутся из метаданных сборки, встроенных в исполняемый файл. committed — это временная метка коммита, и
она присутствует, только если сборка её записала. abiVersion — это версия ABI плагинов, которую поддерживает исполняемый
файл; конвейер может прочитать её, чтобы проверить совместимость плагинов, не загружая плагин.
Отладочная сборка без встроенной версии сообщает значение-маркер (например, (devel)),
а не завершается с ошибкой.
Когда использовать -o json
- Расширение редактора сравнивает версию, которую сообщает демон, с версией, для которой оно было собрано, чтобы обнаружить несовместимый исполняемый файл
aggrega serveдо начала работы с ним. - Инструменты CI и отслеживания происхождения записывают точную сборку компилятора, которая создала артефакт.
См. также
- ./aggrega-serve.md — демон, версию которого клиент проверяет на совместимость.
Синтаксис
aggrega version [flags]Описание
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.Флаги
| Флаг | По умолчанию | Описание |
|---|---|---|
--output, -o | text | Формат вывода: text|json. |
--verbose | false | включить в вывод набор встроенных плагинов |