amenbo 2.0.0 — плагіни: ваша програма запускається, коли завдання рухається

Із цього випуску написана вами програма може запускатися, коли із завданням щось стається. Змінилося й одне в тому, як викликають CLI, — команди, які працювали раніше, тепер отримають відмову. Прочитайте «Про оновлення», перш ніж оновлюватися.

Плагіни

• Події завдання викликають вашу програму — плагін запускається, коли завдання завершено, коли змінюється його стан, коли додано коментар. Запустити його самому теж можна: amenbo plugin run <name>.
• Встановлення з екрана «Ринок» або з командного рядка — виберіть щось з офіційного каталогу на екрані «Ринок» у графічному інтерфейсі або виконайте amenbo plugin install <name>. Сьогодні там один запис: worktree, який нарізає окремий git worktree на кожне завдання.
• Встановити — не означає ввімкнути — вмикання це окремий крок, amenbo plugin enable <name>. Чи цей перемикач діє на проєкт, чи на машину — вирішує автор плагіна.
• Підпис і контрольну суму перевіряють, перш ніж щось приземлиться — те, що не вдається перевірити, не встановлюється.
• Плагін — це просто виконуваний файл — пишіть якою завгодно мовою. amenbo запускає його як дочірній процес і подає йому JSON на стандартний вхід. Дивіться Як написати плагін.

Що можна прочитати, налаштувати й перевірити

• Відкрийте рядок і побачте, що саме берете — у подробицях написано, які події викликають плагін і що вам доведеться налаштувати, коли він стане, — ще до встановлення.
• Налаштування — це форма — поля, які автор оголошує в маніфесті, стають формою. Таємні поля приховані, а проєкт може перекрити ті значення, які йому потрібні.
• amenbo plugin log — недавні запуски з їхнім виводом і кодами виходу. Сюди варто зазирнути, коли плагін зробив не те, чого ви чекали.

Роздавайте плагіни з власного каталогу

• Зареєструйте каталог — і його плагіни стануть поруч з офіційними — amenbo plugin catalog add <URL of catalog.json> --name "Team catalog", і вони з’являться в тому самому списку, готові до встановлення. Внутрішні плагіни можна роздавати, не проходячи через офіційний каталог.
• Каталог — це три статичні файли — жодного серверного процесу. Дивіться Як тримати каталог.
• Ключ підпису закріплюється під час реєстрації — під час реєстрації вам показують відбиток ключа, який публікує каталог, і згода закріплює його. Плагіни, встановлені з того каталогу, відтоді перевіряються цим ключем. Каталог, у якого ключ підмінили, отримує відмову; каталог, що не публікує ключа, можна лише переглядати.
• Кожен рядок несе назву свого каталогу — а список можна відфільтрувати за джерелом. Позначку «офіційний» дають лише записам з офіційного каталогу: сторонній каталог, який припише її собі, її не отримає.
• Встановлений плагін пам’ятає, звідки прийшов — оновлення тягнуться з того самого каталогу, тож та сама назва в іншому каталозі ніколи не підхопиться помилково.

Ще в цьому випуску

• Відхиляйте запис рішення в графічному інтерфейсі — напишіть причину і відхиліть його тут-таки. Перемикатися на CLI заради цього не треба.
• Два налаштування, які ні на що не впливали, тепер впливають — default_view, вигляд, який відкривається під час запуску, і date_locale, як записуються дати.
• Класифікуйте завдання просто під час створення — amenbo task add --dim <axis>=<value>. amenbo task show теж друкує класифікацію завдання.

Про оновлення

• --actor тепер обов’язковий у кожній команді CLI, яка чіпає сховище — раніше він підставлявся зі змінної середовища AMENBO_ACTOR або з умовчання, коли ви не писали нічого. Із цього випуску ви пишете його щоразу: --actor human, коли набираєте ви, --actor ai, коли це ШІ. Наприклад, amenbo task list --actor human. Якщо ви задавали його через змінну середовища, перенесіть його в самі команди. AGENTS.md і CLAUDE.md, які кладе amenbo, тепер теж прямо прописують --actor ai. У графічному інтерфейсі не змінюється нічого.
• Формат збережених даних піднімається — перший запуск цієї версії його переносить, а резервна копія стану до перенесення зберігається автоматично. Після перенесення раніша версія вже не зможе його відкрити. Графічний інтерфейс і CLI оновлює той самий інсталятор разом, тож не лишайте щось одне на старій версії.

Де взяти

Відкрийте інсталятор для своєї системи з найновішого випуску. Графічний інтерфейс і CLI приходять разом, права адміністратора не потрібні.

• macOS — .pkg, окремо для Apple silicon і для Intel (під час першого запуску з’явиться вікно Gatekeeper: клацніть правою кнопкою → «Відкрити»)
• Windows — setup .exe
• Linux — .deb / .rpm

Щоб оновитися: у графічному інтерфейсі банер «є новіша версія» тепер застосовує оновлення на місці. Якщо ви встановили лише CLI, замінює його amenbo update --apply.

Уперше тут? Дивіться Почати.