Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Схема Aggrega Workspace Config

Згенерований довідник. Не редагуйте вручну — згенеруйте повторно з опублікованої JSON Schema.

Ідентифікатор схеми: https://aggrega.ai/schemas/aggrega-config-v1beta1.schema.json

Файл конфігурації робочого простору, який використовує CLI aggrega. Розташований у .aggrega-config.yaml. Блок workspace є маркером кореня: його наявність позначає корінь робочого простору, і він містить лише каталоги каталогу. Кожен інший ключ є налаштуванням і розташований на верхньому рівні, у таких класах: звідки вміст отримується, як він закріплюється та кешується (вибір реєстру, офлайн-режим, поведінка автоматичного завантаження та закріплення, розташування кешів артефактів і скомпільованих модулів та обмеження їхнього розміру), як встановлюється довіра до вмісту (підписування та поведінка перевірки підписів), наскільки суворо оцінюється авторство (налаштування лінтера для окремих правил, суворість щодо застарілих елементів і підказка щодо релізу авторства), які Wasm-плагіни підключено до всього робочого простору (прив’язки governance, linter, importer і рендерингу провайдерів для окремих цілей) та як працює CLI (паралельність, обслуговування та обмеження витіснення з кешу розбору демона). Наведені нижче властивості є повним і авторитетним переліком; цей огляд називає класи, а не ключі, тож додавання ключа не може зробити його хибним. Пласка структура верхнього рівня, без обгортки apiVersion/kind, відмінна від вмісту каталогу. Дисципліна еволюції схеми: додавання нового ключа верхнього рівня є підвищенням SemVer-MINOR (адитивним); вилучення або переміщення ключа чи посилення обмеження є порушенням сумісності SemVer-MAJOR.

Тип верхнього рівня: object

Властивості

ВластивістьТипОбов’язковаОпис
workspaceobjectніМаркер кореня робочого простору. Сама його наявність позначає каталог як корінь робочого простору; він містить лише каталоги каталогів сутностей, що визначають корінь, — власні каталоги робочого простору та ті, які сутності Release надано як її власні. Кожне налаштування, що не визначає корінь, розміщується на верхньому рівні, а не тут. Напишіть workspace: {}, щоб позначити корінь без вендорованих каталогів сутностей.
default_registrystringніТиповий OCI-реєстр, до якого публікуються сутності й з якого розв’язуються залежності, коли сутність явно не називає реєстр: aggrega push публікує туди, а aggrega pull завантажує звідти. Типово hub.aggrega.ai. Напишіть name запису з registries, який тоді означає host цього запису; сам хост; або хост, за яким іде / і шлях репозиторію, як-от ghcr.io/acme чи harbor.example.com/platform. Спершу зіставляється ім’я: значення, що є name одного запису, означає хост цього запису, навіть якщо воно також записане як хост, тож публікація, завантаження, перевірка підпису й кожне налаштування довіри для окремого реєстру використовують саме цей хост; значення, яким названо два записи, відхиляється як неоднозначне, а ім’я, за яким іде шлях, відхиляється, бо ім’я означає хост запису, а не розташування під ним. Будь-яке інше значення має бути хостом, записаним у тому написанні, під яким зберігається його політика довіри: ім’я хоста малими літерами, що містить крапку (registry.example.com), localhost, одне ім’я з портом (registry:5000), адреса IPv4 або адреса IPv6 у квадратних дужках ([::1]), кожне з необов’язковим :port і без схеми, облікових даних, пробілів чи великих літер, — за яким необов’язково йде шлях репозиторію: один або кілька сегментів з малих літер і цифр, з’єднаних через /, які всередині сегмента можуть розділятися символами ., _, __ або дефісами, без тегу, дайджесту чи кінцевого /. Шлях визначає, де публікується й звідки завантажується вміст: кожна сутність, опублікована через типовий реєстр, публікується під <host>/<path>/, і кожна сутність, розв’язана через нього, завантажується звідти, тож те, що публікує одна сторона, знаходить інша. Шлях ніколи не впливає на довіру до реєстру: запис registries, чия політика застосовується, вхід, вимога підпису та довірені ідентичності визначаються лише за хостом. Порт 443 на хості, до якого звертаються через HTTPS, є типовим портом цього хоста, і його зазначення відхиляється з указанням написання без нього; до localhost та інших loopback-адрес звертаються через звичайний HTTP, тож там 443 — звичайний порт, і він зберігається. Порожнє значення не задає типового реєстру. Значення перевіряється під час завантаження конфігурації, а не цією схемою, бо запис, на який посилається ім’я, може бути оголошено в іншому файлі конфігурації: його зчитують після всіх файлів конфігурації та змінної середовища AGGREGA_DEFAULT_REGISTRY і відхиляють тими самими словами, хоч би яке з джерел його задало, із зазначенням цього файлу чи змінної. Прапорець --registry, що задає місце призначення публікації для одного виклику, зіставляється з іменами записів так само; будь-яке інше його значення може бути посиланням, і хост, який називає це посилання, підлягає тим самим вимогам до написання й є місцем, куди потрапляє публікація, без шляху репозиторію. Хост оцінюється лише за написанням: чи розв’язується ім’я та чи відповідає там реєстр, не перевіряється. Типово: "hub.aggrega.ai"
offlineбулеваніЯкщо true, збірка не звертається до жодного реєстру; використовуються лише кешовані артефакти та вендорований вміст каталогів. Типово false. Типово: false
auto_pullбулеваніЯкщо false (типово), aggrega build працює лише на читання: вона ніколи не записує закріплення джерел, а відсутній чи неповний lockfile окремого релізу явно зупиняє збірку з діагностикою, що спершу слід виконати aggrega pull --release <release>. Якщо true, aggrega build перед збіркою виконує крок завантаження в тому самому процесі — розв’язує залежності сутності Release у lockfile і кеш, — тож перша збірка для сутності Release не потребує явного кроку завантаження. Той самий дозвіл для однієї збірки доступний у командному рядку як aggrega build --auto-pull; pull залишається єдиним, хто записує lockfile. offline: true не вимикає крок завантаження: він працює з тим, що вже є на машині, — кешем і локальними каталогами сутностей — без звернення до реєстру, а посилання, якого немає ні там, ні там, зупиняє збірку власною відмовою завантаження із зазначенням цього посилання. Типово: false
pin_sources_at_pullбулеваніЯкщо false (типово), завантаження не записує закріплень поруч із сутністю: для сутності Recipe чи FeatureRecipe в одному з каталогів сутностей цього робочого простору, яку збирає сутність Release, воно зупиняється, коли entity.lock поруч із сутністю не містить закріплення для кожного вхідного елемента, який читає сутність, — віддаленого source:, координати якого записано повністю, файлу, який імпортує запис artifacts, або кожного файлу локального source: поруч із сутністю, — із зазначенням сутності, кожного вхідного елемента та його класу, а також aggrega pin як кроку, що їх записує. Закріплення — це крок автора сутності, тож сутність, яку ніхто не закріпив, ще не готова до використання. Якщо true, кожне завантаження в цьому робочому просторі натомість виконує цей крок для тих самих сутностей, записуючи ті самі байти entity.lock, що й aggrega pin; так робочий простір, який використовує сутності, не закріплені кимось іншим, один раз записує їхні закріплення замість зупинки. Збірка, яка заповнює власний lockfile, є завантаженням і дотримується цього налаштування. aggrega pull --pin-sources закріплює для одного виклику, а --pin-sources=false зупиняє для одного виклику, незалежно від цього налаштування. Сутність, розв’язана з кешу, а не з каталогу сутностей, не має куди записати lock і ніколи не закріплюється й не зупиняється завантаженням. Типово: false
pin_sources_at_pushбулеваніЯкщо true, кожен aggrega push у цьому робочому просторі перед пакуванням виконує крок закріплення автора сутності для сутності, яку публікує, тож entity.lock, що його цей крок записує поруч із сутністю, входить до опублікованого; якщо false (типово), push не виконує кроку закріплення й відхиляє сутність Recipe чи FeatureRecipe, чий entity.lock не містить усіх закріплень, які записав би цей крок, із зазначенням aggrega pin. Крок записує поруч із сутністю, тож виконується лише там, де сутність має доступне для запису розташування, яке push має завжди: він публікує сутність, названу її документом. aggrega push --pin-sources закріплює для одного виклику, а --pin-sources=false — ні, незалежно від цього налаштування. Це той самий крок, що виконує aggrega pin, і він записує ті самі байти. Типово: false
artifact_cache_dirstringніЛокальний каталог кешу артефактів і вмісту (завантаження з реєстрів, OCI-маніфести, скомпільовані фікстури). Типово .aggrega/cache. За домовленістю його слід додати до gitignore. Шлях тлумачиться відносно кореня робочого простору, звідки б не запускалася команда; абсолютне значення відхиляється під час завантаження конфігурації, бо кожен, хто читає це налаштування, розв’язує його відносно цього кореня, а абсолютний шлях вказував би на розташування, до якого вони ніколи не дістаються. Кеш може міститися всередині каталогу сутностей — типове значення саме таке, бо каталог сутностей зазвичай і є коренем робочого простору, — але не може САМ бути ним: сканування каталогу оминає кеш, тож значення, що вказує на каталог сутностей, виключає зі сканування весь вміст цього каталогу. Значення, що вказує на сам корінь робочого простору (. або будь-яке написання, що зводиться до нього), відхиляється під час завантаження конфігурації саме з цієї причини. Значення, що вказує на будь-який інший каталог сутностей, не відхиляється: воно завантажується без помилок, а сканування потім нічого не знаходить у цьому каталозі, тож перевіряти, щоб кеш не потрапляв до каталогів, перелічених у workspace.catalog_dirs, маєте ви. Відрізняється від parse_cache, що обмежує кеш розбору в пам’яті демона, і від compiled_module_cache, що обмежує загальномашинне сховище скомпільованих модулів. Типово: ".aggrega/cache"
skip_signature_verificationбулеваніГлобальна, гучна відмова від перевірки підписів. Якщо true, перевірку підписів вимкнено для всіх реєстрів, зокрема для обов’язкового базового рівня hub. Призначено для аварійних сценаріїв і розробки; це ніколи не відбувається непомітно — скрізь, де отримання перевірило б підпис, воно попереджає, що перевірку глобально вимкнено. Типово false. Типове значення: false
buildobjectніПеремикачі суворості під час збирання та підказки для авторів. authoring_release надає LSP підказку current Release для вбудованої діагностики; halt_on_deprecated_severity визначає, як збирання реагує на використання застарілих сутностей; yaml_indent задає ширину відступу для кожного згенерованого YAML-артефакту.
pluginsobjectніПід’єднання Wasm-плагінів на рівні робочого простору. Кожне гніздо (governance, linter, importer) приймає масив посилань на плагіни; збирання викликає задокументовану вхідну функцію кожного плагіна згідно з контрактом його гнізда. Список providers прив’язує можливості до плагінів рендерингу провайдерів, які їх обслуговують.
lintobjectніНалаштування суворості для окремих правил.
parse_cacheobjectніОбмеження витіснення для кешу розбору демона. Обидва обмеження діють одночасно — цикл витіснення LRU запускається після кожного додавання до кешу й вилучає найдавніше використані записи, доки і кількість записів, і загальний обсяг у байтах не вкладуться в межі. Нуль у будь-якому з них означає unbounded on that axis, що корисно для сценаріїв CI, де кеш існує лише протягом одного виклику. Відрізняється від artifact_cache_dir, який є дисковим кешем вмісту.
compiled_module_cacheobjectніОбмеження розміру дискового кешу скомпільованих модулів — сховища машинного коду, яке компілятор повторно використовує, щоб Wasm-плагін компілювався один раз на машину, а не один раз на збирання. Він спільний для всіх робочих просторів на машині, тому цей ключ варто розміщувати в глобальному файлі конфігурації, коли потрібне одне значення для всієї машини. Обмеження застосовується один раз за виклик, до завантаження будь-якого плагіна, шляхом вилучення цілих записів, починаючи з найдавніше скомпільованих, доки решта не вкладеться в межі, — і ніколи під час компіляції збирання. Вилучення запису коштує лише пізнішої повторної компіляції, тому обмеження можна безпечно зменшувати. aggrega cache status повідомляє поточний розмір сховища, а aggrega cache evict --max-size скорочує його на вимогу до обмеження, заданого в командному рядку. Відрізняється від artifact_cache_dir (отриманий вміст реєстрів) і від parse_cache (кеш розбору демона в пам’яті).
concurrencyobjectніНалаштування паралельності диспетчеризації запитів демона. Демон читає запити з єдиного потоку stdin і виконує кожен через пул робітників, що вибирає запити з обмеженої черги; відповіді видаються в порядку надходження запитів незалежно від порядку їх завершення.
serveobjectніНалаштування поведінки демона (aggrega serve) — компілятора як сервісу, яким користуються інтеграції з IDE.
mcpobjectніНалаштування сервера Model Context Protocol (aggrega mcp). transport визначає, як до сервера звертаються — через стандартні введення й виведення процесу або через HTTP, — і читається за будь-якого вибору. announce_tools також читається для обох транспортів, оскільки те, які інструменти пропонуються клієнту, є властивістю сервера, а не способу, яким клієнт до нього звернувся. Кожен інший ключ налаштовує слухача, якого запускає транспорт HTTP, і не використовується, поки сервер працює через стандартні введення й виведення, — зокрема й listen, який там читається лише для того, щоб сервер міг одним рядком у своєму потоці помилок повідомити, що адреса не використовується. Для кожного ключа нижче зазначено, до якої групи він належить. Відрізняється від serve, який налаштовує демон-бекенд для редактора.
registriesRegistryConfig[]ніНалаштування для окремих реєстрів і політика довіри до підписів, з ключем за хостом реєстру. Реєстр, не вказаний тут, використовує типові значення: наявний підпис перевіряється, а відсутній допускається, за винятком hub.aggrega.ai, чий вбудований базовий рівень вимагає перевіреного підпису навіть без явного запису. Явний запис для хоста перевизначає базовий рівень цього хоста. Типове значення: []
signingSigningConfigніБлок підписування верхнього рівня, що застосовується до всіх реєстрів: URL-адреси сервісів безключового підписування, необов’язковий шлях до ключа для підписування ключем і позиція довіри для всіх реєстрів (required і kinds). Блок signing для окремого реєстру перевизначає типові кінцеві точки для цього хоста й містить ту саму позицію required/kinds, обмежену цим хостом, — одна назва, одне завдання, область дії визначається розміщенням. Політика required/kinds верхнього рівня монотонно поєднується в каскаді конфігурацій. Безпека: цей блок не містить секретних даних — токен ідентичності OIDC ніколи не є полем конфігурації (він надається під час виконання через прапорець або навколишнє середовище OIDC), а key_path — це шлях до файлу ключа, а не вбудовані байти ключа.

Додаткові властивості не дозволені.

aggrega-config.workspace

Маркер кореня робочого простору. Сама його наявність позначає каталог як корінь робочого простору; він містить лише каталоги каталогів сутностей, що визначають корінь, — власні каталоги робочого простору та ті, які сутності Release надано як її власні. Кожне налаштування, що не визначає корінь, розміщується на верхньому рівні, а не тут. Напишіть workspace: {}, щоб позначити корінь без вендорованих каталогів сутностей.

ВластивістьТипОбов’язковаОпис
catalog_dirsstring[]ніНеобов’язкові каталоги, з яких цей робочий простір читає локальні сутності, перш ніж звернутися до реєстру. Кожен запис — це шлях у файловій системі, що визначається відносно файлу, який його оголошує. Список є впорядкованим стеком пошуку, де перемагає перший збіг: каталог, указаний найраніше, який оголошує ідентичність, володіє нею, а та сама ідентичність у пізнішому каталозі затіняється. Каталог catalog у корені робочого простору також читається — після всіх указаних записів і лише тоді, коли він існує, — якщо тільки якийсь указаний запис уже не містить його, і тоді він читається як частина цього запису; отже, зазначення каталогу додає до того, що робочий простір уже читав, а не замінює це. Пропущений ключ і ключ, записаний як порожній список, означають різне: якщо ключ пропущено, робочий простір усе одно читає catalog; якщо записано [], він не читає жодного локального каталогу, і саме так робочий простір повідомляє, що каталогу в нього немає. Сутність Release, якій надано власні каталоги в releases, читає їх замість цього списку. Область — корінь: локальні каталоги належать цьому кореню робочого простору, тому вони розміщуються на маркері кореня, а не на верхньому рівні.
catalog_dirs_appendstring[]ніНеобов’язкове доповнення, що лише додається, до ефективного списку catalog_dirs. На кожному рівні пріоритету записи звідси приєднуються до визначеного базового списку, що дає змогу конфігураціям робочого простору та глобальним конфігураціям поєднувати каталоги, а не затіняти їх. Взаємодія в межах одного рівня: коли на одному рівні задано і catalog_dirs, і catalog_dirs_append, визначене значення на цьому рівні — це базовий список, за яким іде список доповнення. Типове значення: []
releasesmap of ReleaseCatalogConfigніНеобов’язкові власні каталоги сутності Release — для робочого простору, який зберігає кілька варіантів каталогу поруч і збирає кожну сутність Release з одним із них. Кожен ключ — це файл сутності Release, записаний як шлях відносно файлу, що його оголошує; кожне значення містить catalog_dirs і catalog_dirs_append з тим самим значенням, що й у цьому блоці, але з областю дії лише цієї однієї сутності Release. Сутність Release, названа тут, читає власний catalog_dirs замість списку цього блоку, а після нього — власний catalog_dirs_append; запис, у якому пропущено catalog_dirs, зберігає список цього блоку й додає після нього свій catalog_dirs_append. Порядок пошуку, каталог catalog у корені робочого простору та значення порожнього списку такі самі, як і для власного списку цього блоку, а сутність Release, не названа в цій мапі, читає список цього блоку точно так, як і раніше. Сутність Release читає ці каталоги незалежно від способу збирання — у терміналі, з редактора через aggrega serve або через aggrega mcp, — а каталог --catalog для одного виклику, як і раніше, переглядається раніше за них. Запис, що називає неіснуючий файл, відхиляється під час завантаження конфігурації із зазначенням запису та файлу, тож перейменування сутності Release не може непомітно змінити каталог, з яким вона збирається. У різних файлах конфігурації запис кожної сутності Release поєднується так само, як власні ключі цього блоку: catalog_dirs ближчого файлу для цієї сутності Release замінює значення дальшого файлу, а catalog_dirs_append кожного файлу для неї додається в порядку каскаду. AGGREGA_CATALOG_DIRS задає список цього блоку й не впливає на жоден запис тут. Операція, що не стосується жодної окремої сутності Release, — перевірка лінтером або валідація всього каталогу, пошук сутності за назвою чи перелік сутностей робочого простору в редакторі — читає список цього блоку, а не ці каталоги.

Додаткові властивості не дозволені.

aggrega-config.build

Перемикачі суворості під час збирання та підказки для авторів. authoring_release надає LSP підказку current Release для вбудованої діагностики; halt_on_deprecated_severity визначає, як збирання реагує на використання застарілих сутностей; yaml_indent задає ширину відступу для кожного згенерованого YAML-артефакту.

ВластивістьТипОбов’язковаОпис
authoring_releasestringніШлях до YAML-файлу сутності Release, який LSP використовує як контекст current Release для вбудованої діагностики. Необов’язковий.
yaml_indentintegerніШирина відступу (у пробілах) для кожного згенерованого YAML-артефакту — файлів docker-compose, шаблонів і значень чартів Helm та маніфестів Kubernetes. Типово 2 — загальноприйнята ширина для цих форматів. Мінімум: 2. Максимум: 9. Типове значення: 2
halt_on_deprecated_severitystring (enum)ніРівень серйозності у впорядкованому наборі warning < error < retracted, на якому або вище якого записаний маркер застарілості зупиняє збирання. Він керує обома місцями, де записується маркер: lock-файлом — для всього, що збирання відтворює байт у байт, — і записом довіри до плагінів поруч із ним — для плагіна, підключеного в ролі, що повертає вердикт «прийняти або відхилити»: підключення plugins.governance на ir-verdict або render-verdict і кожне підключення plugins.linter. Один регулятор, одне правило, обидва сховища. Типово не задано, а незадане значення означає, що жоден записаний маркер не зупиняє збирання: маркер записується щодо версії, яку ви вже закріпили, тож збирання, що одного разу вдалося, і далі вдається. Сповіщення та розв’язання — дві окремі осі, і жодна з них не є цим регулятором. Кожна поверхня, що читає будь-який із записів, повідомляє про кожне закріплене нею застаріле посилання та кожен довірений плагін із маркером — на будь-якому рівні серйозності, — називаючи його, його рівень серйозності та повідомлення: aggrega build, aggrega validate --release, aggrega lint --release, демон для редакторів і AI-нативні інструменти build, describe та validate. Тож підвищення цього порогу ніколи не зменшує того, що вам повідомляють. Цей регулятор керує лише збиранням: він зупиняє aggrega build (і AI-нативний інструмент build, що є тією самою операцією), тоді як поверхні звітування називають маркер і продовжують роботу. Лише маркер retracted впливає на те, до якої версії розв’язується посилання, і робить це, коли aggrega pull обирає версію, а не під час збирання. Допустимі значення: "warning", "error", "retracted"

Додаткові властивості не дозволені.

aggrega-config.plugins

Під’єднання Wasm-плагінів на рівні робочого простору. Кожне гніздо (governance, linter, importer) приймає масив посилань на плагіни; збирання викликає задокументовану вхідну функцію кожного плагіна згідно з контрактом його гнізда. Список providers прив’язує можливості до плагінів рендерингу провайдерів, які їх обслуговують.

ВластивістьТипОбов’язковаОпис
governancePluginRef[]ніПлагіни сокета governance. Кожен запис називає role конвеєра, у якій його під’єднано (annotation-transform, label-transform, ir-verdict або render-verdict); роль визначає і те, що плагін може виводити, і його типову функцію входу (annotation-transform → transform_annotations; label-transform → mutate; ir-verdict → verdict_ir; render-verdict → verdict_render). Типово: []
governance_appendPluginRef[]ніДоповнення лише для додавання до ефективного списку governance. Записи тут дописуються до розв’язаного базового списку на кожному рівні пріоритету, що дає змогу конфігураціям робочого простору та глобальним конфігураціям поєднувати під’єднання governance, а не затіняти їх. Типово: []
linterPluginRef[]ніПлагіни сокета linter. Типова функція входу: lint_rules. Експорти плагіна-лінтера мають починатися з lint_, тож function: в одному з цих записів називає експорт із цим префіксом. Типово: []
linter_appendPluginRef[]ніДоповнення лише для додавання до ефективного списку linter. Та сама семантика «поєднувати, а не затіняти», що й у governance_append. Типово: []
importerFixedEntryPluginRef[]ніПлагіни сокета importer. Сокет викликає функцію входу import; під’єднання її не називає. Типово: []
importer_appendFixedEntryPluginRef[]ніДоповнення лише для додавання до ефективного списку importer. Та сама семантика «поєднувати, а не затіняти», що й у governance_append. Типово: []
providersFixedEntryPluginRef[]ніВибір провайдера для кожної можливості. Кожен запис прив’язує одну можливість провайдера (голу назву можливості, яку Recipe прив’язує через spec.capability, напр. helm або compose) до голої ідентичності плагіна рендерингу провайдера, що її обслуговує (ідентичність сутності Plugin — її metadata.pluginType і metadata.name, з’єднані скісною рискою, напр. provider/helm), з необов’язковим кінцевим :version у тих самих трьох формах, що й закріплення версії (гола, точна :1.0.0 або діапазон, сумісний за мажорною версією, :^1.0.0). Це поверхня для усунення неоднозначності та перевизначення у федеративному каталозі, де ту саму можливість обслуговує більше ніж один плагін провайдера: прив’язка вибирає, плагін якого видавця рендерить цю можливість. Коли можливість обслуговує рівно один плагін провайдера, запис не потрібен. У поєднаному списку дозволено рівно один запис на можливість; дубльована можливість гучно зупиняє розв’язання. Розв’язання відбувається під час pull: pull записує розв’язану прив’язку в lockfile окремого Release, а збірка читає lockfile — зміна тут після pull не застосовується до наступного pull, тож вихід збірки від неї не залежить (детермінований вихід). Кожна збірка та кожна валідація Release також перевіряє кожен запис тут, незалежно від того, чи запитує якийсь Recipe його можливість: запис, що називає плагін, який є у збірки, але не обслуговує можливість запису, зупиняє збірку, називаючи, що обслуговує цей плагін, і написання на відстані одного редагування, якщо таке є; запис, що називає можливість без плагіна, коли жоден плагін провайдера, який читає збірка, не обслуговує цю можливість, повідомляється як попередження, а не зупиняє, бо плагін, що її обслуговує, може читати лише інший Release; а запис для можливості, яку обслуговує плагін, але цей Release ніколи не запитує, є допустимим і нічого не повідомляє, оскільки записи пишуться для всього робочого простору, а збірка стосується одного Release. capability, що містить двокрапку, відхиляється під час завантаження конфігурації: spec.capability сутності Recipe читається як можливість до останньої двокрапки і закріплення версії після неї, тож жоден Recipe не зміг би досягти такого запису. Відсутній запис для однозначно обслуговуваної можливості не є помилкою; відсутній запис для неоднозначно обслуговуваної можливості гучно зупиняє pull, перелічуючи плагіни-кандидати. Співіснування версій зберігається: прив’язка вибирає репозиторій плагіна для кожної можливості, а власне закріплення версії в spec.capability кожного Recipe вибирає версію в цьому репозиторії, тож два Recipes, що закріплюють різні версії одного провайдера, усе одно співіснують. Типово: []
providers_appendFixedEntryPluginRef[]ніДоповнення лише для додавання до ефективного списку providers. Записи тут дописуються до розв’язаного базового списку на кожному рівні пріоритету, що дає змогу конфігураціям робочого простору та глобальним конфігураціям поєднувати прив’язки провайдерів, а не затіняти їх. Та сама семантика «поєднувати, а не затіняти», що й у governance_append. Правило одного запису на можливість застосовується до поєднаного списку, тож доданий запис, що називає можливість, уже прив’язану нижчим рівнем, гучно зупиняє розв’язання. Типово: []
cliCLIPluginRef[]ніПлагіни-розширення CLI, встановлені як команди верхнього рівня aggrega. Кожен запис закріплює один плагін CLI за його розв’язаним посиланням на артефакт із закріпленою версією та дайджестом вмісту гостьових байтів, до яких це посилання розв’язалося під час встановлення. На відміну від чотирьох наскрізних списків сокетів, базовий список яких повністю замінюється в каскаді конфігурацій, список CLI поєднується: плагін CLI в глобальній конфігурації реєструє свої команди в кожному робочому просторі, плагін у конфігурації робочого простору реєструється лише в цьому проєкті, а обидва реєструються разом — тож йому не потрібен супутній _append. Назви команд і довідка, які додає кожен плагін, беруться з власного самоопису плагіна, прочитаного з дискового кешу описів із ключем digest (запасним варіантом за холодного кешу є завантаження гостя); список містить лише закріплення. Під час виклику команди розв’язані байти хешуються повторно й порівнюються з digest; невідповідність гучно зупиняє команду та вимагає повторного закріплення, тож плагін, байти якого змінилися після закріплення, ніколи не запускається непомітно. Типово: []

Додаткові властивості не дозволені.

aggrega-config.lint

Налаштування суворості для окремих правил.

ВластивістьТипОбов’язковаОпис
publishing_disciplineobjectніШлюзи для набору правил лінтера публікації на рівні всього робочого простору. Прапорці allow_* послаблюють окремі перевірки небажаних практик. Незмінність артефактів тут не налаштовується: aggrega push безумовно відмовляється перезаписувати опубліковану версію.

Додаткові властивості не дозволені.

aggrega-config.lint.publishing_discipline

Шлюзи для набору правил лінтера публікації на рівні всього робочого простору. Прапорці allow_* послаблюють окремі перевірки небажаних практик. Незмінність артефактів тут не налаштовується: aggrega push безумовно відмовляється перезаписувати опубліковану версію.

ВластивістьТипОбов’язковаОпис
allow_dynamic_refsбулеваніЯкщо true, лінтер публікації приймає конструкції JSON Schema $dynamicRef / $dynamicAnchor у вмісті каталогу. За замовчуванням false; ці конструкції не рекомендовані, бо роблять композицію схем під час компіляції нелокальною. За замовчуванням: false
allow_id_overridesбулеваніЯкщо true, лінтер публікації приймає перевизначення $id у підсхемах у вмісті схеми сутності. За замовчуванням false; перевизначення $id порушують домовленість «один канонічний ідентифікатор на схему», на яку спираються і резолвер, і валідатор JSON Schema. За замовчуванням: false
allow_direct_x_aggrega_extensionsбулеваніЯкщо true, перевірка небажаних конструкцій під час збирання приймає ключові слова x-aggrega-selector і x-aggrega-inject, написані безпосередньо у вмісті схеми. За замовчуванням false; рекомендований шлях написання — usesSchema (для сокетів залежностей) або featuresSchema (для прив’язок облікових даних), які компілятор складає в ці ключові слова. За замовчуванням: false
allow_aggrega_ai_prefixбулеваніЯкщо true, лінтер публікації приймає ключі анотацій, що використовують зарезервовані простори імен aggrega.ai/ і feature.aggrega.ai/ поза їхніми канонічними контекстами. Правило зарезервованих префіксів контролює metadata.annotations сутностей каталогу: голий префікс aggrega.ai/ є власним для платформи (добре відомі ключі анотацій звільнені незалежно від цього прапорця); префікс feature.aggrega.ai/ є канонічним лише для типу Feature. За замовчуванням false. Оператори встановлюють його, коли корпоративним інструментам обґрунтовано потрібно використовувати зарезервований префікс; прапорець послаблює обидва префікси разом. За замовчуванням: false
allow_nonstandard_namesбулеваніЯкщо true, лінтер публікації приймає імена сутностей каталогу, що не відповідають задокументованим домовленостям проєкту щодо іменування. За замовчуванням false; узгоджене іменування є суттєвим для резолвера, вибору за мітками та зручності рецензентів. За замовчуванням: false
allow_category_mismatchesбулеваніЯкщо true, лінтер публікації вимикає правило category-matches-directory. Домовленість стандартного каталогу вимагає, щоб Components у core// оголошували component.aggrega.ai/category={category}, що відповідає сегменту каталогу, де {category} — одне зі значень закритого набору (як-от ai-agent, ai-model, ai-tool, datastore, gateway, compute, …). Робочі простори з обґрунтованими постійними винятками відмовляються від нього тут. Типово false. Типове значення: false
allow_undeclared_recipe_providesбулеваніЯкщо true, лінтер публікації вимикає правило provides-declared-by-component. Це правило повідомляє про кожен ключ, який Recipe публікує в spec.provides, але який сутність Component, названа в її spec.implements, не оголошує в стовпі provides свого spec.schema. Це дві окремі поверхні: те, що публікує Recipe, — це значення, яке отримує споживач, а те, що оголошує Component, — це вихідний контракт, з яким перевіряється посилання inject from:, тож ключ, опублікований без оголошення, змушує таке посилання зупинитися. Інакше Recipe, що публікує більше, ніж оголошує її Component, приймається під час збирання, тому знахідка є рекомендаційною, а не відмовою в публікації. За замовчуванням false. За замовчуванням: false
allow_connection_credential_mismatchesбулеваніЯкщо true, лінтер публікації вимикає правило connection-credential-matches-target-key, яке aggrega lint --release запускає для названої сутності Release: самої Release, сутності Aggregate, яку вона розгортає, і Components, які використовують екземпляри цієї Aggregate. Для кожного з’єднання, ціль якого оголошує ключ, що вимагається від викликачів, правило порівнює, на що посилаються обидва кінці: облікові дані, які подає з’єднання, і ключ, який ціль зберігає у власному слоті. Воно повідомляє про кінці, що називають різні секрети, і про ключ, оголошений лише на одному кінці, і ніколи не цитує жодного з них. Жоден кінець не бачить прикріплень іншого, тож вони узгоджуються лише завдяки дисципліні написання — зазвичай один параметр живить обидва, — а збирання приймає їх у будь-якому разі, тому знахідка є рекомендаційною. Робочий простір, у якому кінці свідомо відрізняються, відмовляється від правила тут. За замовчуванням false. За замовчуванням: false

Додаткові властивості не дозволені.

aggrega-config.parse_cache

Обмеження витіснення для кешу розбору демона. Обидва обмеження діють одночасно — цикл витіснення LRU запускається після кожного додавання до кешу й вилучає найдавніше використані записи, доки і кількість записів, і загальний обсяг у байтах не вкладуться в межі. Нуль у будь-якому з них означає unbounded on that axis, що корисно для сценаріїв CI, де кеш існує лише протягом одного виклику. Відрізняється від artifact_cache_dir, який є дисковим кешем вмісту.

ВластивістьТипОбов’язковаОпис
max_entriesintegerніОбмеження кількості кешованих результатів розбору. За замовчуванням 1000. 0 вимикає вісь кількості записів (витіснення за кількістю записів не запускається). Мінімум: 0. За замовчуванням: 1000
max_bytesintegerніОбмеження сукупного розміру в байтах документів, які зберігає кеш. За замовчуванням 100000000 (100 МБ). 0 вимикає вісь байтів (витіснення за загальним обсягом байтів не запускається). Мінімум: 0. За замовчуванням: 100000000

Додаткові властивості не дозволені.

aggrega-config.compiled_module_cache

Обмеження розміру дискового кешу скомпільованих модулів — сховища машинного коду, яке компілятор повторно використовує, щоб Wasm-плагін компілювався один раз на машину, а не один раз на збирання. Він спільний для всіх робочих просторів на машині, тому цей ключ варто розміщувати в глобальному файлі конфігурації, коли потрібне одне значення для всієї машини. Обмеження застосовується один раз за виклик, до завантаження будь-якого плагіна, шляхом вилучення цілих записів, починаючи з найдавніше скомпільованих, доки решта не вкладеться в межі, — і ніколи під час компіляції збирання. Вилучення запису коштує лише пізнішої повторної компіляції, тому обмеження можна безпечно зменшувати. aggrega cache status повідомляє поточний розмір сховища, а aggrega cache evict --max-size скорочує його на вимогу до обмеження, заданого в командному рядку. Відрізняється від artifact_cache_dir (отриманий вміст реєстрів) і від parse_cache (кеш розбору демона в пам’яті).

ВластивістьТипОбов’язковаОпис
max_bytesintegerніОбмеження обсягу байтів, які кеш скомпільованих модулів займає на диску. За замовчуванням 53687091200 (50 ГіБ) — стеля, що зупиняє необмежене зростання, а не бюджет, який мало б бути відчутно: один скомпільований плагін сягає сотень мегабайтів, тож машина, що збирає багато версій плагінів, накопичує гігабайти. Встановлюйте його вище за те, що компілює одне збирання: обмеження застосовується до того, як збирання щось скомпілює, тож обмеження, нижче за робочий набір одного збирання, змушує кожне збирання відкидати й повторно компілювати ті самі модулі, і сховище перестає щось заощаджувати. Оскільки обмеження застосовується першим, а збирання потім записує скомпільоване, сховище між збираннями може перевищувати обмеження; на початку наступного його знову обрізають. 0 вимикає обмеження (сховище росте необмежено, і нічого ніколи не видаляється автоматично). Оскільки сховище — це один каталог, спільний для всіх робочих просторів, це обмеження не діє на рівні проєкту, навіть якщо його містить власний файл проєкту: значення визначається так само, як і для будь-якого іншого ключа, із перевагою ближчого файлу, але розмір сховища все одно один. Чинним є обмеження з найостаннішого збирання, тож два проєкти з різними обмеженнями діють по черзі, і низьке обмеження в одному відкидає машинний код, скомпільований іншим. Саме одноразове встановлення в глобальному файлі конфігурації дає всій машині одну відповідь. aggrega config show --origin називає файл, з якого походить чинне значення кожного параметра. Мінімум: 0. За замовчуванням: 53687091200

Додаткові властивості не дозволені.

aggrega-config.concurrency

Налаштування паралельності диспетчеризації запитів демона. Демон читає запити з єдиного потоку stdin і виконує кожен через пул робітників, що вибирає запити з обмеженої черги; відповіді видаються в порядку надходження запитів незалежно від порядку їх завершення.

ВластивістьТипОбов’язковаОпис
pool_sizeintegerніКількість воркерів, що обслуговують чергу запитів. Типово 4, тобто одночасно обробляється до чотирьох запитів; задайте 1, щоб виконувати запити послідовно в порядку надходження. Значення, менше за 1, під час запуску демона підвищується до 1. Мінімум: 1. Типове значення: 4

Додаткові властивості не дозволені.

aggrega-config.serve

Налаштування поведінки демона (aggrega serve) — компілятора як сервісу, яким користуються інтеграції з IDE.

ВластивістьТипОбов’язковаОпис
build_on_inspectбулеваніЧи виконує демон етап рендерингу артефактів під час інспектування графа IR, щоб попередження, які aggrega build видає під час рендерингу, також з’являлися як проблеми в редакторі. Це не додає жодної з перевірок, на яких збірка зупиняється. На диск у будь-якому разі нічого не записується — ні відрендерених артефактів, ні вихідного каталогу, ні lock-файлу, — а етап рендерингу ніколи не змінює граф, тож там, де інспектування відповідає графом, це той самий граф в обох випадках. Типово false, як і в aggrega inspect: термінальна команда під час інспектування графа не доходить до етапу рендерингу, тож теж не видає таких попереджень, і інспектування в редакторі, яке їх не видає, показує вам те саме, що й термінал. Задайте true, щоб запросити в редактора цей додатковий рівень. Типове значення: false
lint_on_validateбулеваніЧи виконує демон перевірку домовленостей публікації під час валідації сутності каталогу, щоб зауваження, які aggrega lint повідомляє щодо цієї сутності, також з’являлися як проблеми в редакторі. Зауваження мають рекомендаційний характер: документ, щодо якого вони є, все одно проходить валідацію, а його сутність Release все одно розв’язується й рендериться. Виконується лише перевірка, що читає локальний вміст, — реєстр не опитується, нічого не завантажується й нічого не записується, — і вона виконується щодо буфера, який містить редактор, а не файлу на диску, тож назва, яку ви виправили, перестає позначатися ще до збереження. Типово false: сеанс редактора повідомляє, чи документ коректний, і нічого не каже про те, чи придатна сутність до публікації, доки ви не запросите цей другий рівень. Задайте true, щоб запросити його. Незалежно від цього ключа редактор завжди може запросити перевірку безпосередньо; саме так виконується й порівняння перед публікацією з попередньо опублікованою версією. Типове значення: false

Додаткові властивості не дозволені.

aggrega-config.mcp

Налаштування сервера Model Context Protocol (aggrega mcp). transport визначає, як до сервера звертаються — через стандартні введення й виведення процесу або через HTTP, — і читається за будь-якого вибору. announce_tools також читається для обох транспортів, оскільки те, які інструменти пропонуються клієнту, є властивістю сервера, а не способу, яким клієнт до нього звернувся. Кожен інший ключ налаштовує слухача, якого запускає транспорт HTTP, і не використовується, поки сервер працює через стандартні введення й виведення, — зокрема й listen, який там читається лише для того, щоб сервер міг одним рядком у своєму потоці помилок повідомити, що адреса не використовується. Для кожного ключа нижче зазначено, до якої групи він належить. Відрізняється від serve, який налаштовує демон-бекенд для редактора.

ВластивістьТипОбов’язковаОпис
transportstring (enum)ніСпосіб доступу до сервера: stdio обслуговує протокол через стандартні ввід і вивід процесу — так до нього звертається клієнт, що запускає команду як підпроцес; http обслуговує його через HTTP за адресою, яку вказує listen, і через HTTPS, якщо tls вказує сертифікат і ключ. aggrega mcp --transport stdio|http перевизначає цей ключ для одного виклику. Типово stdio, тож робочий простір, який ніколи не вказує транспорт, обслуговується через стандартні ввід і вивід, хоч би що ще містив цей блок, — слухач запускається лише там, де вибрано http, тут або в командному рядку. Будь-яке інше значення відхиляється під час завантаження конфігурації. Задайте http у конфігурації сервера, до якого звертаються через мережу, і залиште ключ незаданим, якщо клієнт сам запускає сервер: коли вибрано stdio, адреса в listen не використовується, і сервер повідомляє про це одним рядком у своєму потоці помилок. Допустимі значення: "stdio", "http" Типове значення: "stdio"
listenstringніАдреса, до якої прив’язується слухач, коли вибрано транспорт HTTP. Вона вказує, де слухати, і нічого не вибирає: транспорт вибирає transport, а коли вибрано stdio, цей ключ не використовується. Приймаються дві форми: host:port для адреси TCP і unix:, за яким іде шлях у файловій системі, для Unix-сокета. aggrega mcp --listen <address> перевизначає цей ключ для одного виклику. Типово порожнє, а транспорту HTTP потрібна адреса з одного чи іншого джерела: без жодної запуск, що його вибирає, відхиляється ще до будь-якої прив’язки. Адреса без шифрування — та, до якої звертаються без сертифіката й ключа в tls, — приймається лише на loopback (127.0.0.1, ::1 або localhost, що розв’язується в одну з них) чи на Unix-сокеті; таку конфігурацію використовує сервер, коли TLS завершує проксі перед ним. Будь-яка інша адреса відхиляється ще до будь-якої прив’язки з посиланням на mcp.tls.cert_file і mcp.tls.key_file. Ті самі дві форми є єдиними допустимими, із сертифікатом чи без, коли задано authorization.trusted_proxy, бо заголовку можна довіряти як облікових даних лише там, де його не може задати ніхто, крім проксі. Типове значення: ""
tlsobjectніСертифікат і ключ для завершення TLS усередині процесу, що обслуговує запити. Задайте обидва, щоб обслуговувати HTTPS безпосередньо зі слухача, який вказує listen. Залиште обидва незаданими, щоб обслуговувати без шифрування; тоді listen обмежується loopback або Unix-сокетом — таку конфігурацію слід використовувати, коли сертифікат тримає проксі перед ним. Обидва ключі — шляхи до файлів на диску; жоден не містить ключового матеріалу безпосередньо.
allowed_originsstring[]ніДжерела (origins), що приймаються в заголовку Origin запиту. Запит, чий заголовок Origin вказує джерело, якого немає в цьому списку, відхиляється з 403; запит, що вказує джерело зі списку або взагалі не містить заголовка Origin, обслуговується. Запис порівнюється із заголовком точно, тож кожен записується так, як браузер надсилає джерело: схема в нижньому регістрі, ://, хост у нижньому регістрі — ім’я, адреса IPv4 або адреса IPv6 у квадратних дужках — і : з портом, якщо він не типовий для схеми, і нічого після цього. Наприклад, https://app.example.com або http://localhost:3000. Запис будь-якої іншої форми ніколи не збігся б із тим, що надсилає браузер, тому він відхиляється під час завантаження файлу конфігурації із зазначенням файлу й запису: запис із кінцевим / або шляхом (https://app.example.com/), запис без схеми (app.example.com) і запис, що містить велику літеру чи пробіл. Типово порожній, тож жодне джерело не приймається, і обслуговується лише клієнт, що не надсилає заголовка Origin. Тому клієнту в браузері потрібно, щоб його джерело було вказане тут; клієнт, що не є браузером, такого заголовка не надсилає й запису не потребує. Кожен запис відповідає шаблону ^[a-z][a-z0-9+.-]*://(?:[a-z0-9._-]+|\[[0-9a-f:.]+\])(?::[0-9]{1,5})?$. Типове значення: []
limitsobjectніОбмеження, які слухач HTTP застосовує до трафіку, що приймає, щоб один клієнт не міг вичерпати ресурси процесу, який обслуговує запити. Вони обмежують, наскільки великим може бути окремий запит, скільки запитів виконується одночасно і як швидко може надсилати один клієнт. Жодне з них не можна вимкнути.
authorizationobjectніЩо цей сервер оголошує про bearer-токени, які пред’являють його клієнти: який сервер авторизації їх видає, адресу, яку цей сервер публікує для себе як ресурс, для якого їх видано, за потреби файл, з якого читати ключі перевірки того сервера, і за потреби заголовки, які встановлює проксі попереду, коли токени перевіряє цей проксі. issuer і resource обов’язкові, щойно вибрано транспорт HTTP, і без них запуск слухача відхиляється ще до прив’язування будь-чого; сервер, що працює через стандартні введення й виведення, не читає жодного з них. Обидва публікуються в документі метаданих захищеного ресурсу OAuth, який віддає слухач; це єдина відповідь, яку клієнт HTTP отримує без запиту облікових даних, бо клієнт читає її, щоб дізнатися, де отримати токен. Цей блок не містить секретних даних: токен пред’являє клієнт у своєму запиті, і він ніколи не є полем конфігурації, а jwks_file вказує на відкриті ключі перевірки, а не на щось, що підписує.
deny_reachstring (enum)[]ніВиди досяжності, яких цей сервер не має, хоч би що казав токен клієнта. Кожна операція оголошує, як далеко сягають її власні наслідки: none — для тієї, що читає або рендерить і нічого по собі не лишає, workspace — для тієї, що записує в робочий простір, який обслуговує цей процес, registry — для тієї, що публікує, підписує або відкликає, і machine — для тієї, що змінює спільне для всіх робочих просторів на хості; зазначення виду тут вилучає з цього сервера всі інструменти цього виду. Вилучений інструмент відсутній у списку інструментів і у відповіді describe-capabilities для кожного клієнта, а виклик його попри це відхиляється з посиланням на цей параметр, бо жодна область доступу не могла б його допустити. За замовчуванням порожньо, тож сервер має все, що допускають області доступу його клієнтів. Це межа, яку сервер встановлює собі сам, понад межу для кожного клієнта, що її встановлюють області доступу: сервер, який обслуговує лише читання, зазначає тут три види із записом і тоді не може публікувати навіть для клієнта, токен якого має всі області доступу. Зазначення machine приймається і нічого не змінює: жоден інструмент цього виду взагалі не пропонується через HTTP, і це властивість транспорту, а не параметр. Читається під час запуску слухача: значення поза цими чотирма відхиляється під час завантаження конфігурації, а його зміна потребує перезапуску. Зовсім не читається, коли сервер працює через стандартні введення й виведення, де клієнтом є людина, яка запустила процес. Дозволені значення для кожного запису: "none", "workspace", "registry", "machine". За замовчуванням: []
announce_toolsstring[]ніІнструменти, які оголошує цей сервер, названі точно так, як їх подає список інструментів. Якщо ключ пропустити, оголошуються всі інструменти цього сервера, чого й очікує клієнт, що дотримується протоколу: він отримує весь список інструментів і сам вирішує, скільки з нього показати моделі. Якщо записати список, оголошуються саме ці інструменти: пропущений відсутній у списку інструментів, відсутній у відповіді describe-capabilities і відхиляється під час виклику за назвою з посиланням на цей параметр. Якщо записати порожній список, не оголошується нічого. Задавайте його там, де клієнт на іншому боці обмежує кількість інструментів, які він зареєструє (деякі клієнти застосовують це обмеження до всіх серверів, до яких підключені одночасно), і вказуйте інструменти, потрібні цьому клієнтові. Він лише звужує те, що оголошується, і нічого більше: він не може розширити ні deny_reach, що повністю вилучає можливість, ні області доступу, які має токен клієнта. Названий тут інструмент виду, який вилучає deny_reach, лишається поза списком інструментів і відхиляється під час виклику з посиланням на той параметр; названий тут інструмент, якого не допускають області доступу клієнта, усе одно є в списку, а виклик його відхиляється з посиланням на область доступу, що допустила б його. Кожна назва має бути з тих, що є в цьому бінарному файлі: назва, якій не відповідає жоден інструмент, відхиляється під час запуску сервера, бо інакше той, хто просив вужчий набір, отримав би інший без жодного повідомлення про це. Назва з родини cli-, що запускає команду aggrega в окремому процесі, приймається на обох транспортах і нічого не оголошує через HTTP, де жоден такий інструмент не пропонується жодному клієнтові. Читається на обох транспортах під час запуску сервера, тож оголошений набір незмінний протягом життя процесу, а його зміна потребує перезапуску.
healthobjectніДе супервізор запитує, чи цей процес живий і чи готовий відповісти на виклик. На обидві перевірки відповідають на власній адресі й ніколи на адресі, яку вказує listen: кожен запит до кінцевої точки містить bearer-токен, тож перевірка, на яку відповідали б там, давала б будь-кому, хто може досягти кінцевої точки, неавтентифіковані відомості про процес разом із вільним способом змусити його працювати. Кінцева точка відповідає на /healthz і /readyz тим самим 404, що й на кожен шлях, який вона не обслуговує, однаково з токеном і без нього.

Додаткові властивості не дозволені.

aggrega-config.mcp.tls

Сертифікат і ключ для завершення TLS усередині процесу, що обслуговує запити. Задайте обидва, щоб обслуговувати HTTPS безпосередньо зі слухача, який вказує listen. Залиште обидва незаданими, щоб обслуговувати без шифрування; тоді listen обмежується loopback або Unix-сокетом — таку конфігурацію слід використовувати, коли сертифікат тримає проксі перед ним. Обидва ключі — шляхи до файлів на диску; жоден не містить ключового матеріалу безпосередньо.

ВластивістьТипОбов’язковаОпис
cert_filestringніШлях до ланцюжка сертифікатів PEM, який пред’являє слухач; читається під час запуску процесу. Задається разом із key_file. За замовчуванням порожньо, тож слухач обслуговує відкритий текст, а listen обмежено loopback або сокетом Unix. За замовчуванням: ""
key_filestringніШлях до закритого ключа PEM для сертифіката в cert_file; читається під час запуску процесу. Задається разом із ним. Шлях до файлу, ніколи не вбудовані дані ключа. За замовчуванням порожньо, тож слухач обслуговує відкритий текст, а listen обмежено loopback або сокетом Unix. За замовчуванням: ""

Додаткові властивості не дозволені.

aggrega-config.mcp.limits

Обмеження, які слухач HTTP застосовує до трафіку, що приймає, щоб один клієнт не міг вичерпати ресурси процесу, який обслуговує запити. Вони обмежують, наскільки великим може бути окремий запит, скільки запитів виконується одночасно і як швидко може надсилати один клієнт. Жодне з них не можна вимкнути.

ВластивістьТипОбов’язковаОпис
max_body_bytesintegerніНайбільше тіло запиту, яке приймає слухач, у байтах. Запит, тіло якого перевищує його, відхиляється з 413, і тіло не читається далі межі. За замовчуванням 4194304 (4 MiB), що значно більше за виклик інструмента з цілим авторським документом і значно менше за те, що дало б одному клієнтові змогу зайняти значну частку пам’яті процесу. Мінімум — 1, тож немає значення, яке вимикає обмеження; збільшуйте його там, де клієнти обґрунтовано надсилають більші документи. Мінімум: 1. За замовчуванням: 4194304
max_concurrent_requestsintegerніСкільки запитів слухач виконує одночасно. Запит, що надходить, коли стільки вже виконується, відхиляється з 503, а не стає в чергу, тож клієнтові кажуть повторити спробу, замість чекати за роботою, якої він не бачить. За замовчуванням 16, що лишає місце для кількох одночасних викликів інструментів, зберігаючи чутливість невеликого хоста; на більшому хості збільшуйте його. Мінімум — 1, тож немає значення, яке вимикає обмеження. Мінімум: 1. За замовчуванням: 16
requests_per_minuteintegerніСкільки запитів один клієнт може надіслати за хвилину. Лічиться для кожного клієнта, а не для сервера (за суб’єктом, якого називає токен клієнта, або за ідентичністю, яку засвідчив довірений проксі), тож один зайнятий клієнт не може витратити ліміт іншого. Клієнт може надіслати стільки запитів одним пакетом; потім ліміт рівномірно поповнюється, на один запит кожні 60 / requests_per_minute секунд, а запит, що надходить, коли ліміт вичерпано, відхиляється з 429. За замовчуванням 120, тобто два на секунду тривало: набагато більше, ніж надсилає асистент, що працює з робочим простором, і все ж межа для клієнта, що зациклився. Мінімум — 1, тож немає значення, яке вимикає обмеження. Мінімум: 1. За замовчуванням: 120

Додаткові властивості не дозволені.

aggrega-config.mcp.authorization

Що цей сервер оголошує про bearer-токени, які пред’являють його клієнти: який сервер авторизації їх видає, адресу, яку цей сервер публікує для себе як ресурс, для якого їх видано, за потреби файл, з якого читати ключі перевірки того сервера, і за потреби заголовки, які встановлює проксі попереду, коли токени перевіряє цей проксі. issuer і resource обов’язкові, щойно вибрано транспорт HTTP, і без них запуск слухача відхиляється ще до прив’язування будь-чого; сервер, що працює через стандартні введення й виведення, не читає жодного з них. Обидва публікуються в документі метаданих захищеного ресурсу OAuth, який віддає слухач; це єдина відповідь, яку клієнт HTTP отримує без запиту облікових даних, бо клієнт читає її, щоб дізнатися, де отримати токен. Цей блок не містить секретних даних: токен пред’являє клієнт у своєму запиті, і він ніколи не є полем конфігурації, а jwks_file вказує на відкриті ключі перевірки, а не на щось, що підписує.

ВластивістьТипОбов’язковаОпис
issuerstringніАдреса сервера авторизації, що видає токени, які приймає цей слухач, записана так, як цей сервер подає власний ідентифікатор видавця, наприклад https://login.example.com. Вона публікується в списку authorization_servers документа метаданих захищеного ресурсу; саме так клієнт дізнається, де отримати токен для цього слухача. За замовчуванням порожньо, що не є придатним значенням: запуск слухача відхиляється ще до прив’язування будь-чого, якщо тут немає повної адреси разом зі схемою та хостом. Це адреса https, якщо сервер авторизації не працює на цій машині: звичайний http приймається лише для loopback-хоста, як-от localhost, 127.0.0.1 або ::1, а звичайний видавець http на будь-якому іншому хості відхиляється ще до прив’язування будь-чого з посиланням на цей ключ і вимогою адреси https. Це діє незалежно від того, чи ключі читаються від видавця, з jwks_file, чи токени перевіряє trusted_proxy попереду, бо кожного клієнта спрямовують до видавця по токен. За замовчуванням: ""
resourcestringніАдреса, яку цей сервер публікує для себе, такою, якою її досягає клієнт, наприклад https://mcp.example.com/mcp. Записуйте адресу, яку клієнти справді використовують, включно з хостом, який подає проксі попереду, бо це ідентифікатор, який клієнт передає серверу авторизації, коли запитує токен для цього сервера, і він публікується без змін як поле resource документа метаданих захищеного ресурсу. Місце, де віддається цей документ, виводиться з неї вставленням /.well-known/oauth-protected-resource між хостом і шляхом: сервер, опублікований як https://mcp.example.com/mcp, віддає його за адресою https://mcp.example.com/.well-known/oauth-protected-resource/mcp, а також за цим well-known шляхом без нічого після нього, де клієнт шукає вдруге. Токен приймається лише тоді, коли ця адреса є серед аудиторій, які він називає. За замовчуванням порожньо, що не є придатним значенням: запуск слухача відхиляється ще до прив’язування будь-чого, якщо тут немає повної адреси разом зі схемою та хостом. За замовчуванням: ""
jwks_filestringніШлях до файлу з набором JSON Web Key Set, за яким перевіряються токени, що їх приймає цей сервер; читається під час запуску процесу. За замовчуванням порожньо, і це звичайний випадок: ключі читаються від самого сервера авторизації — у issuer запитують, де він їх публікує, і отримують їх за вказаною адресою, а повторно вони читаються один раз, коли надходить токен, підписаний ключем з ідентифікатором, якого немає в наявному наборі. Задавайте це там, де робочий простір працює офлайн; у такому разі без нього запуск слухача відхиляється ще до прив’язування будь-чого, бо офлайн-робочий простір не робить мережевих запитів і іншого способу отримати ключі немає; тоді файл містить єдині прийнятні ключі, а до сервера авторизації ніколи не звертаються. Файл містить відкриті ключі перевірки й ніколи нічого, що підписує. Відносний шлях розв’язується відносно каталогу конфігураційного файлу, який його оголосив. За замовчуванням: ""
trusted_proxyobjectніВизначати, хто клієнт, за заголовками, які встановлює проксі попереду, замість перевіряти bearer-токен тут. Задавайте це лише тоді, коли виконано обидві умови: проксі попереду сам перевіряє токени, і ніщо, крім цього проксі, не може досягти слухача; коли це задано, listen має бути loopback або Unix-сокетом, а будь-яка інша адреса відхиляється ще до прив’язування будь-чого з посиланням на обидва параметри. Заголовок вартий довіри рівно настільки, наскільки вартий довіри набір клієнтів, які можуть його встановити, а на адресі, досяжній з мережі, кожен клієнт може встановити будь-який заголовок, тож слухач у цьому режимі на такій адресі дозволив би кожному клієнтові видавати себе за будь-кого. Коли це задано, жоден токен не читається взагалі — ні із заголовка Authorization, ні звідкись іще, і жоден набір ключів не отримується; ідентичністю клієнта є значення principal_header, на запит без цього заголовка відповідають 401, а два названі тут заголовки — єдині, що читаються. Якщо це пропустити (за замовчуванням), цей сервер сам перевіряє bearer-токени.

Додаткові властивості не дозволені.

aggrega-config.mcp.authorization.trusted_proxy

Визначати, хто клієнт, за заголовками, які встановлює проксі попереду, замість перевіряти bearer-токен тут. Задавайте це лише тоді, коли виконано обидві умови: проксі попереду сам перевіряє токени, і ніщо, крім цього проксі, не може досягти слухача; коли це задано, listen має бути loopback або Unix-сокетом, а будь-яка інша адреса відхиляється ще до прив’язування будь-чого з посиланням на обидва параметри. Заголовок вартий довіри рівно настільки, наскільки вартий довіри набір клієнтів, які можуть його встановити, а на адресі, досяжній з мережі, кожен клієнт може встановити будь-який заголовок, тож слухач у цьому режимі на такій адресі дозволив би кожному клієнтові видавати себе за будь-кого. Коли це задано, жоден токен не читається взагалі — ні із заголовка Authorization, ні звідкись іще, і жоден набір ключів не отримується; ідентичністю клієнта є значення principal_header, на запит без цього заголовка відповідають 401, а два названі тут заголовки — єдині, що читаються. Якщо це пропустити (за замовчуванням), цей сервер сам перевіряє bearer-токени.

ВластивістьТипОбов’язковаОпис
principal_headerstringтакЗаголовок, у який проксі попереду записує ідентичність клієнта, наприклад X-Forwarded-User. Він записується як назва заголовка HTTP: літери, цифри й дефіси та інші символи, які може містити назва заголовка (!#$%&'*+.^_|~ і зворотний апостроф), без пробілів, двокрапки чи інших роздільників. Назва будь-якої іншої форми відхиляється під час завантаження конфігураційного файлу з посиланням на файл і ключ, бо жоден запит не може містити такого заголовка. Порожня теж відхиляється: вона змусила б цей сервер самому перевіряти токени, тоді як блок каже, що це робить проксі попереду. Щоб вимкнути цей режим, пропустіть trusted_proxy. Значення заголовка береться точно так, як записане, і ні з чим не порівнюється — так само, як записується й ні з чим не порівнюється суб’єкт токена, який цей сервер перевіряє сам. У цьому режимі це вся облікова інформація, тож воно обов’язкове, щойно задано trusted_proxy, а на запит без нього відповідають 401. Шаблон: ^[!#$%&'*+.^_`|~0-9A-Za-z-]+$.
scopes_headerstringніЗаголовок, у який проксі попереду записує надані клієнтові області доступу, розділені пробілами, наприклад X-Forwarded-Scopes. Він записується як назва заголовка HTTP у тій самій формі, що й principal_header, або лишається порожнім. Назва будь-якої іншої форми відхиляється під час завантаження конфігураційного файлу з посиланням на файл і ключ, бо жоден запит не може містити такого заголовка і жодному клієнтові ніколи не було б надано області доступу. За замовчуванням порожньо, що не засвідчує жодних областей доступу для жодного клієнта. Хоч би як він називався, жоден заголовок, крім цього і principal_header, не читається. Шаблон: ^[!#$%&'*+.^_`|~0-9A-Za-z-]*$. За замовчуванням: ""

Додаткові властивості не дозволені.

aggrega-config.mcp.health

Де супервізор запитує, чи цей процес живий і чи готовий відповісти на виклик. На обидві перевірки відповідають на власній адресі й ніколи на адресі, яку вказує listen: кожен запит до кінцевої точки містить bearer-токен, тож перевірка, на яку відповідали б там, давала б будь-кому, хто може досягти кінцевої точки, неавтентифіковані відомості про процес разом із вільним способом змусити його працювати. Кінцева точка відповідає на /healthz і /readyz тим самим 404, що й на кожен шлях, який вона не обслуговує, однаково з токеном і без нього.

ВластивістьТипОбов’язковаОпис
listenstringніАдреса, на якій відповідають на перевірки живучості й готовності, у тих самих двох формах, що й listen: host:port або unix:, за яким іде шлях у файловій системі. Типово порожня, тож другий слухач не запускається і на жодну з перевірок ніде не відповідають. Якщо адресу задано, на GET /healthz відповідають 200 з моменту, коли процес працює, а на GET /readyz відповідають 503, доки робочий простір не розв’язано і кінцеву точку не прив’язано, і 200 відтоді — саме цю відмінність потребує супервізор, адже процес, що запущений, ще не є процесом, який може відповісти на виклик. Кожна відповідь — це код стану з порожнім тілом, токен не запитується і жоден заголовок не читається; будь-який інший шлях на цій адресі дає 404, а будь-який інший метод на цих двох — 405. На відміну від listen, ця адреса не обмежена loopback чи сокетом Unix і жодна адреса для неї не відхиляється: спрямуйте її на одну з них, для чого вона й призначена, і зважте, що все, що може досягти вибраної вами адреси, може прочитати ці дві відповіді. Типово: ""

Додаткові властивості не дозволені.

Визначення

ReleaseCatalogConfig

Власні каталоги однієї сутності Release: ті самі два ключі, що їх містить блок workspace, з областю дії в межах цієї сутності Release.

ВластивістьТипОбов’язковаОпис
catalog_dirsstring[]ніКаталоги, з яких ця сутність Release читає локальні сутності замість catalog_dirs робочого простору; кожен визначається відносно файлу, що його оголошує. Той самий упорядкований стек пошуку «перший виграє», що й список робочого простору, причому каталог catalog у корені робочого простору читається після нього, якщо цей каталог існує і жоден наведений запис уже не містить його. Якщо ключ пропущено, Release зберігає список робочого простору; якщо записано [], локальний каталог не читається взагалі.
catalog_dirs_appendstring[]ніКаталоги, що додаються після списку цієї сутності Release — її власного catalog_dirs, якщо запис його вказує, інакше списку робочого простору; кожен визначається відносно файлу, що його оголошує. Типово: []

Додаткові властивості не дозволені.

RegistryConfig

Налаштування та політика довіри до підписів з областю дії в межах одного хоста реєстру OCI.

ВластивістьТипОбов’язковаОпис
hoststringтакХост реєстру, до якого застосовуються ці налаштування (наприклад, hub.aggrega.ai). Порівнюється з хостом реєстру цілі push/pull, тому записується в тому написанні, в якому виконується порівняння: ім’я хоста малими літерами з крапкою, localhost, одне ім’я з портом (registry:5000), адреса IPv4 або адреса IPv6 у квадратних дужках, кожне з необов’язковим :port — без схеми, шляху, облікових даних, пробілів і великих літер. Порт 443 на хості, до якого звертаються через HTTPS, є типовим портом цього хоста, і його запис відхиляється під час завантаження конфігурації з повідомленням, що хост слід записати без нього, бо запис у такому написанні ніколи не було б знайдено; до localhost та інших адрес loopback звертаються через звичайний HTTP, тож там 443 — звичайний порт, і його збережено. aggrega registry add і aggrega config init --registry створюють запис під хостом, який вказує їхній аргумент, і відхиляють хост, записаний інакше. Хост оцінюється лише за написанням: чи розв’язується ім’я та чи відповідає там реєстр, не перевіряється. Шаблон: ^(?:(?:(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z](?:[a-z0-9-]{0,61}[a-z0-9])?|localhost|(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])(?:\.(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])){3}|\[(?:(?:[0-9a-f]{1,4}:){7}[0-9a-f]{1,4}|(?:[0-9a-f]{1,4}:){1,7}:|(?:[0-9a-f]{1,4}:){1,6}:[0-9a-f]{1,4}|(?:[0-9a-f]{1,4}:){1,5}(?::[0-9a-f]{1,4}){1,2}|(?:[0-9a-f]{1,4}:){1,4}(?::[0-9a-f]{1,4}){1,3}|(?:[0-9a-f]{1,4}:){1,3}(?::[0-9a-f]{1,4}){1,4}|(?:[0-9a-f]{1,4}:){1,2}(?::[0-9a-f]{1,4}){1,5}|[0-9a-f]{1,4}:(?::[0-9a-f]{1,4}){1,6}|:(?:(?::[0-9a-f]{1,4}){1,7}|:))\])(?::(?:[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?|[a-z](?:[a-z0-9-]{0,61}[a-z0-9])?:(?:[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))$.
namestringніНеобов’язковий зручний псевдонім для цього реєстру. Ідентичністю є хост; name — зручний селектор, який розв’язується в хост цього запису скрізь, де називають реєстр (наприклад, --registry або default_registry). Псевдонім має бути унікальним серед записів.
trusted_identitiesTrustedIdentity[]ніOR-множина безключових ідентичностей підписування, прийнятних для артефактів, отриманих із цього реєстру. Підпис проходить перевірку, якщо його сертифікат відповідає будь-якому одному запису. Використовується шляхом безключової перевірки. Типово: []
trusted_deprecation_identitiesTrustedIdentity[]ніOR-множина безключових ідентичностей, додатково прийнятних для підписування ретроактивної позначки застарівання артефакту, отриманого з цього реєстру. Позначка застарівання враховується, якщо її підпис відповідає підписувачу оригінального артефакту АБО будь-якому запису тут — тож власник реєстру чи команда безпеки може відкликати артефакт, до якого оригінальний видавець уже не має доступу, без довіри на підписування самих артефактів. Використовується лише шляхом виявлення застарівання; ніколи не розширює множину довіри для підписів артефактів. Типово: []
public_keystringніЗакріплений сумісний із cosign відкритий ключ для реєстру в режимі з ключем, записаний безпосередньо як блок PEM: текст від рядка -----BEGIN PUBLIC KEY----- (або -----BEGIN RSA PUBLIC KEY-----) до відповідного рядка -----END, як його копіює з файлу ключа aggrega registry add --key. Якщо задано, підписи з цього реєстру перевіряються офлайн за цим ключем, а не за безключовими ідентичностями. Значення без рядка -----BEGIN … PUBLIC KEY----- відхиляється під час завантаження файлу конфігурації з зазначенням файлу та запису; так само відхиляється приватний ключ, вставлений сюди помилково. Рядок може стояти будь-де в значенні, бо ключ читається з блоку PEM, який містить значення, а будь-який текст перед цим блоком ігнорується. Тут перевіряється лише цей рядок: чи містить блок ключ, що декодується, з’ясовується, коли за ним перевіряють підпис із цього реєстру. Значення оголошено чутливим (x-aggrega-sensitive), тож відхилене значення — передусім помилково вибраний приватний ключ — ніколи не цитується: у відмові зазначено файл, запис і обмеження, якого значення не дотрималося, — шаблон вище або тип string, — а на місці значення показано <redacted>. Відкритий ключ, що завантажився, читається і показується так, як записаний. Шаблон: -----BEGIN [A-Z ]*PUBLIC KEY-----.
trusted_rootstringніНеобов’язковий шлях до закріпленого пакета кореня довіри Sigstore для безключової перевірки в ізольованому середовищі. Якщо задано, безключовий якір довіри завантажується з цього файлу без мережі; якщо порожньо, публічний корінь довіри завантажується і кешується.
advisoryбулеваніЯкщо true, помилка перевірки підпису для цього реєстру знижується до попередження замість зупинки pull. Перевірка все одно виконується, і про помилку повідомляється; pull продовжується. Типово false. Типово: false
skip_signature_verificationбулеваніАварійна відмова від перевірки підписів для окремого хоста — той самий перемикач skip_signature_verification, що й глобальний, з областю дії за розміщенням у межах цього хоста. Він не скасовує політику верхнього рівня signing.required: підпис, обов’язковий для організації, на цьому хості все одно перевіряється незалежно від цього перемикача; вимкнути це може лише глобальний перемикач. Задання цього разом із signing.required окремого реєстру на тому самому хості дозволене й поєднує обов’язковий підпис під час push із пропущеною перевіркою під час pull: на боці перевірки перемагає пропуск, бо позиція обов’язковості окремого хоста (на відміну від верхнього рівня) не захищена від пропуску окремого хоста. Типово false. Типово: false
signingSigningConfigніБлок підписування цього реєстру: URL безключових сервісів, необов’язковий шлях до ключа для режиму з ключем і позиція довіри для окремого хоста. Поля кінцевих точок перевизначають глобальний блок signing для push на цей хост; прапорець CLI перевизначає обидва. required і kinds визначають область за розміщенням — у записі реєстру вони обмежують єдину позицію довіри цим хостом (публікацію непідписаного артефакту в області відхиляють, і споживання непідписаного теж відхиляють); це та сама концепція, яку блок верхнього рівня signing несе для всіх реєстрів.

Додаткові властивості не дозволені.

SigningConfig

Блок підписування: URL-адреси служб безключового підписування, необов’язковий вказівник на файл ключа для підписування з ключем і позиція довіри (required і kinds). Розміщений на верхньому рівні, він застосовується до всіх реєстрів; розміщений у записі registries[], він застосовується до цього хоста — кожне поле визначає свою область дії з розміщення. required — це одна позиція довіри, що охоплює обидва напрямки (непідписане надсилання в межах області відхиляється, і непідписане отримання в межах області відхиляється). Безпека: блок не містить секретних даних — токен ідентичності OIDC ніколи не є полем конфігурації (він короткочасний і надається під час виконання), а key_path — це шлях до файлу ключа, ніколи не вбудовані байти ключа. Це віддзеркалює асиметрію сторони перевірки: там дозволено вбудований public_key, але сторона підписування містить лише шлях до ключа. Сервер aggrega mcp, до якого звертаються через HTTP, не використовує key_path у жодному з розміщень, тож підписування з ключем через такий слухач недоступне: виклик, на який він відповідає, підписується лише токеном ідентичності, який несе цей виклик.

ВластивістьТипОбов’язковаОпис
fulcio_urlstringніURL-адреса центру сертифікації Fulcio для безключового підписування. Якщо не задано, використовується загальнодоступний екземпляр Fulcio. Записується як абсолютна URL-адреса https: https://, хост і, за бажанням, порт і шлях, без пробілів — наприклад, https://fulcio.sigstore.dev. Значення будь-якої іншої форми, як-от без схеми (fulcio.example.com) або таке, що починається з http://, відхиляється під час завантаження файлу конфігурації із зазначенням файлу та ключа. Файл перевіряється до того, як поверх нього застосовується будь-що інше, тож та сама кінцева точка, задана через AGGREGA_SIGNING_FULCIO_URL, прапорцем --fulcio-url або в запиті на публікацію від редактора чи асистента, не мусить відповідати цій формі. Шаблон: ^https://[^\s/?#]+(?:[/?#]\S*)?$.
rekor_urlstringніURL-адреса журналу прозорості Rekor для безключового підписування. Якщо не задано, використовується загальнодоступний екземпляр Rekor. Записується як абсолютна URL-адреса https: https://, хост і, за бажанням, порт і шлях, без пробілів — наприклад, https://rekor.sigstore.dev. Значення будь-якої іншої форми, як-от без схеми (rekor.example.com) або таке, що починається з http://, відхиляється під час завантаження файлу конфігурації із зазначенням файлу та ключа. Файл перевіряється до того, як поверх нього застосовується будь-що інше, тож та сама кінцева точка, задана через AGGREGA_SIGNING_REKOR_URL, прапорцем --rekor-url або в запиті на публікацію від редактора чи асистента, не мусить відповідати цій формі. Шаблон: ^https://[^\s/?#]+(?:[/?#]\S*)?$.
timestamp_urlstringніURL-адреса центру позначок часу RFC3161 для безключового підписування. Значення за замовчуванням немає: якщо не задано, жоден центр позначок часу не залучається, а довірений час безключового підпису береться з його запису в журналі прозорості. Записується як абсолютна URL-адреса https: https://, хост і, за бажанням, порт і шлях, без пробілів — наприклад, https://tsa.example.com/api/v1/timestamp. Значення будь-якої іншої форми, як-от без схеми (tsa.example.com) або таке, що починається з http://, відхиляється під час завантаження файлу конфігурації із зазначенням файлу та ключа. Файл перевіряється до того, як поверх нього застосовується будь-що інше, тож та сама кінцева точка, задана через AGGREGA_SIGNING_TIMESTAMP_URL, прапорцем --timestamp-url або в запиті на публікацію від редактора чи асистента, не мусить відповідати цій формі. Шаблон: ^https://[^\s/?#]+(?:[/?#]\S*)?$.
key_pathstringніШлях до наявного PEM-файлу приватного ключа ECDSA P-256 для офлайн-підписування з ключем. Шлях до файлу, ніколи не вбудовані дані ключа. Якщо не задано, використовується безключовий шлях. Сервер aggrega mcp, до якого звертаються через HTTP, ніколи не використовує цей ключ, де б його не було задано — у блоці signing верхнього рівня, у блоці запису реєстру чи через AGGREGA_SIGNING_KEY_PATH: виклик, на який відповідає такий слухач, підписується лише токеном ідентичності, який несе сам виклик, або відхиляється. Сервер, до якого звертаються через стандартні введення й виведення, підписує цим ключем так само, як термінал.
requiredбулеваніЄдина позиція довіри для області дії цього блоку: якщо true, публікація типу артефакту в межах області потребує підпису (непідписане надсилання в межах області відхиляється), і його використання потребує підпису (непідписане отримання в межах області відхиляється). Область дії визначається розміщенням — у блоці signing верхнього рівня вона охоплює кожен реєстр; у блоці signing запису registries[] вона охоплює цей один хост. Одна назва, одне завдання, обидві області. Політика верхнього рівня поєднується монотонно в каскаді конфігурації — будь-який шар, що встановлює її в true, робить її фактично true, і жоден шар із нижчим пріоритетом не може знову її вимкнути — тож її неможливо прибрати звичайним редагуванням конфігурації. За замовчуванням false. Значення за замовчуванням: false
kindsstring[]ніОбмежує required певними типами артефактів. Порожній список або єдиний запис all означає кожен тип, який можна підписати; інакше позиція застосовується саме до перелічених типів, що відповідають значенню kind: сутності (наприклад, Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, Aggregate, Plugin). У блоці signing верхнього рівня поєднується як об’єднання в каскаді — шар може розширити область, але ніколи не звузити її. Область дії визначається розміщенням, так само як для required. Значення за замовчуванням: []

Додаткові властивості не дозволені.

TrustedIdentity

Одна прийнятна ідентичність безключового підписування: суб’єкт сертифіката (ідентичність OIDC) у парі з видавцем OIDC, який її засвідчив.

ВластивістьТипОбов’язковаОпис
identitystringніТочне альтернативне ім’я суб’єкта сертифіката — ідентичність OIDC, прив’язана до короткочасного сертифіката підписування (наприклад, електронна адреса супровідника або URI робочого процесу CI).
identity_regexpstringніРегулярний вираз, що зіставляється із суб’єктом сертифіката і використовується замість точного identity (наприклад, щоб приймати будь-який робочий процес в організації).
issuerstringтакURL-адреса видавця OIDC, який видав токен ідентичності (наприклад, https://accounts.google.com або https://token.actions.githubusercontent.com).

Додаткові властивості не дозволені.

PluginRef

Посилання на Wasm-плагін, підключений до сокета, вхідну функцію якого може назвати підключення, — списки governance і linter. Сокети з фіксованою точкою входу натомість використовують FixedEntryPluginRef, що містить ті самі поля без function. uri і capability разом обирають плагін: лише uri — це пряме підключення (плагін із цією ідентичністю підключається дослівно — шлях наскрізних сокетів, оскільки їхні плагіни не оголошують жодних обслуговуваних можливостей); лише capability визначає плагін, що обслуговує цю можливість (просту назву можливості, яку Recipe прив’язує через spec.capability, напр. helm); обидва разом усувають неоднозначність — capability називає, що визначити, а uri обирає, плагін якого видавця її обслуговує, за простою ідентичністю цього плагіна, у федеративному каталозі, де цю можливість обслуговує більше одного плагіна. function перевизначає типову вхідну функцію сокета; якщо її пропущено, застосовується задокументоване типове значення сокета — для запису governance це значення випливає з role. role називає роль підключення governance і зчитується лише для запису governance. with містить необов’язкові вхідні дані часу підключення, які зчитує плагін.

ВластивістьТипОбов’язковаОпис
uristringніІдентифікатор плагіна: проста ідентичність сутності Plugin — шлях <pluginType>/<name>, напр. governance/redact або provider/helm, — локальний шлях у файловій системі або псевдонім реєстру. Необов’язковий: запис може натомість обрати плагін за capability. Необов’язковий кінцевий :version закріплює версію в тих самих трьох формах, що й будь-яке закріплення версії (без версії, точна :1.0.0 або діапазон, сумісний за основною версією, :^1.0.0).
rolestring (enum)ніРоль конвеєра, до якої прив’язано підключення governance; зчитується лише для запису governance: annotation-transform додає анотації до визначених компонентів перед розгортанням анотацій, тож прив’язані додавання стають підключеннями Feature; label-transform автоматично позначає мітки вузлів графа топології під час побудови топології; ir-verdict виносить вердикт «прийняти/відхилити» щодо графа IR під час статичного аналізу; render-verdict виносить вердикт щодо відрендерених артефактів під час рендерингу. Саме роль, а не оголошений тип плагіна, визначає, що плагін може видавати: вивід ролі вердикту можна прочитати лише як вердикт і ніколи не застосувати як зміну; вивід ролі перетворення хост обмежує її аспектом (анотаціями або мітками). Вона також обирає типову вхідну функцію (annotation-transform → transform_annotations; label-transform → mutate; ir-verdict → verdict_ir; render-verdict → verdict_render). Допустимі значення: "annotation-transform", "label-transform", "ir-verdict", "render-verdict"
capabilitystringніМожливість провайдера, для якої цей запис обирає плагін, — проста назва можливості, яку Recipe прив’язує через spec.capability (напр. helm, compose). Необов’язкова: запис може натомість підключити плагін напряму за uri. Прив’язки провайдерів використовують її, щоб обрати, плагін якого видавця обслуговує можливість у федеративному каталозі; наскрізні сокети залишають її порожньою й підключають за uri.
functionstringніНеобов’язкове перевизначення типової вхідної функції сокета. Якщо його пропущено, застосовується задокументоване типове значення сокета (governance annotation-transform → transform_annotations, governance label-transform → mutate, governance ir-verdict → verdict_ir, governance render-verdict → verdict_render, linter → lint_rules). Перевизначення може назвати будь-який експорт, який оголошує плагін, і названий експорт має повертати вивід тієї форми, яку зчитує сокет: збірка зупиняється, коли цей вивід містить поле верхнього рівня, якого форма не оголошує, із зазначенням викликаного експорту й неочікуваного поля. Перевірка зчитує, які назви полів верхнього рівня присутні, а не які відсутні чи що вкладено під ними, тож це не повна валідація виводу.
withPluginRefWithніНеобов’язкові вхідні дані часу підключення, які зчитує плагін. Обидва члени необов’язкові й не залежать від сокета, тож будь-який сокет може повторно використати цю поверхню.

Додаткові властивості не дозволені.

FixedEntryPluginRef

Посилання на Wasm-плагін, підключений до сокета, точка входу якого фіксована, а не названа підключенням, — список importer і прив’язки providers. Воно містить ті самі поля, що й PluginRef, без function: сокет імпортера викликає одну вхідну функцію, яку називає контракт його сокета, а провайдер керує фіксованим набором експортів, прив’язаних до фаз, а не однією обираною точкою входу, тож у жодному з цих списків немає точки входу, яку могла б назвати function, і цей ключ там не приймається. uri і capability разом обирають плагін: лише uri — це пряме підключення (плагін із цією ідентичністю підключається дослівно — шлях сокета імпортера, оскільки його плагіни не оголошують жодних обслуговуваних можливостей); лише capability визначає плагін, що обслуговує цю можливість (просту назву можливості, яку Recipe прив’язує через spec.capability, напр. helm); обидва разом усувають неоднозначність — capability називає, що визначити, а uri обирає, плагін якого видавця її обслуговує, за простою ідентичністю цього плагіна, у федеративному каталозі, де цю можливість обслуговує більше одного плагіна. role тут приймається, але не зчитується в жодному зі списків, які обслуговує ця форма: названа ним роль підключення governance зчитується для запису governance, який використовує PluginRef, тож роль, задана в одному з цих записів, не має жодного ефекту. with містить необов’язкові вхідні дані часу підключення, які зчитує плагін; прив’язка провайдера натомість бере свою конфігурацію рендерингу з Recipe, тож with: у ній відхиляється під час завантаження.

ВластивістьТипОбов’язковаОпис
uristringніІдентифікатор плагіна: проста ідентичність сутності Plugin — шлях <pluginType>/<name>, напр. governance/redact або provider/helm, — локальний шлях у файловій системі або псевдонім реєстру. Необов’язковий: запис може натомість обрати плагін за capability. Необов’язковий кінцевий :version закріплює версію в тих самих трьох формах, що й будь-яке закріплення версії (без версії, точна :1.0.0 або діапазон, сумісний за основною версією, :^1.0.0).
rolestring (enum)ніРоль підключення governance. Жоден зі списків, що використовують цю форму, її не зчитує — роль зчитується для запису governance, а ці записи використовують PluginRef, — тож роль, задана тут, приймається й не має жодного ефекту. Допустимі значення — чотири ролі governance, а значення кожної з них описано в PluginRef. Допустимі значення: "annotation-transform", "label-transform", "ir-verdict", "render-verdict"
capabilitystringніМожливість провайдера, для якої цей запис обирає плагін, — проста назва можливості, яку Recipe прив’язує через spec.capability (напр. helm, compose). Необов’язкова: запис може натомість підключити плагін напряму за uri. Прив’язки провайдерів використовують її, щоб обрати, плагін якого видавця обслуговує можливість у федеративному каталозі; наскрізні сокети залишають її порожньою й підключають за uri.
withPluginRefWithніНеобов’язкові вхідні дані часу підключення, які зчитує плагін. Обидва члени необов’язкові й не залежать від сокета, тож будь-який сокет може повторно використати цю поверхню.

Додаткові властивості не дозволені.

CLIPluginRef

Закріплений плагін-розширення CLI, встановлений як команда верхнього рівня aggrega: розв’язане посилання на артефакт із закріпленою версією, яке команда розв’язує та запускає, і дайджест вмісту гостьових байтів, на які це посилання розв’язалося під час встановлення. Разом вони точно закріплюють, які байти виконує команда; дайджест також слугує ключем кешу опису, який надає імена та довідку команди без завантаження гостьового модуля.

ВластивістьТипОбов’язковаОпис
uristringтакРозв’язане посилання на артефакт із закріпленою версією, яке команда розв’язує та запускає, наприклад oci://hub.aggrega.ai/plugin/cli/<name>:1.2.0, закріплене під час встановлення.
digeststringтакДайджест вмісту гостьових байтів .wasm, на які посилання розв’язалося під час встановлення, записаний як sha256:, за яким ідуть 64 шістнадцяткові цифри в нижньому регістрі хешу SHA-256 цих байтів — написання, яке записує aggrega plugin add cli, і написання, у якому порівнюються розв’язані байти. Дайджест в будь-якому іншому написанні — голі шістнадцяткові цифри без префікса sha256:, великі літери чи інша довжина — ніколи не зможе з ним збігтися, тому його відхиляють під час завантаження файлу конфігурації із зазначенням файлу та запису. Він закріплює точні байти, які запускає команда — пізніше розв’язання, байти якого мають інший хеш, зупиняє команду, — і є ключем до кешу опису, який відображає довідку команди без завантаження гостьового модуля. Шаблон: ^sha256:[0-9a-f]{64}$.

Додаткові властивості не дозволені.

PluginRefWith

Необов’язкові вхідні дані часу підключення, які читає плагін. Обидва члени необов’язкові, а сама поверхня загальна, тож її може повторно використати будь-який сокет.

ВластивістьТипОбов’язковаОпис
sourcesstring[]ніШляхи до файлів визначень, які хост читає під час компіляції та передає плагіну. Кожен запис — це шлях файлової системи, що розв’язується відносно каталогу файлу конфігурації, у якому його оголошено.
settingsobjectніОб’єкт довільних налаштувань, що передається плагіну без змін. Хост не інтерпретує його структуру; плагін сам визначає ключі, які читає.

Додаткові властивості не дозволені.