view /ru/docs/plugin-protocol
Protocol v1 и Result v1
Protocol v1 и Result v1
Заголовок раздела «Protocol v1 и Result v1»Executable plugin реализует три verb:
plugin-file manifest --protocol=1plugin-file plan --protocol=1plugin-file execute --protocol=1manifest описывает CLI paths, typed arguments и flags, category и safety
properties. Operational и runbook commands поддерживают plan. execute
получает подтверждённый plan digest и возвращает canonical Result v1 JSON.
Host проверяет command collisions, reserved flags, argument layout, timeout, output bounds, protocol identity, Result status и exit mapping.
Result v1
Заголовок раздела «Result v1»JSON всегда содержит обязательные поля:
{ "schema_version": "1.0", "command": "system.info", "status": "pass", "checks": [], "data": {}, "changes": [], "errors": []}Пустые checks, changes и errors всё равно обязательны. С --json stdout
содержит только этот документ.