pluginkit (s-pluginkit)

Кит ПЛАГИНОВ платформы китов: один владелец группы точек входа, общий механизм видов, реестр объявленного, доставка навыков и манифест их состава.

Родился волной 6 (Atlas #2717) выделением из шлюза gateway и из двух китов-контрактов (socialkit, aichatkit).

Зачем

Состав

• pluginkit.groups — PLUGIN_GROUP, COMMAND_GROUP.
• pluginkit.kinds — capability_id, service_of, identity_methods, method_of, resolve_method, uniformity_problems.
• pluginkit.registry — чтение реестра объявленного (метаданные, без импорта тел).
• pluginkit.discovery — поиск пакетов-навыков на диске по их pyproject.toml.
• pluginkit.delivery — доставка навыков в окружение, добор спутников.
• pluginkit.manifest — состав на диске + план автодоустановки.
• pluginkit.commands — команды CLI из точек входа.
• pluginkit.roster — разбор кандидатов с причинами исключения.

Закон слоёв

pluginkit не импортирует НИ ОДИН другой кит экосистемы (включая corekit): socialkit, aichatkit и adapterkit берут отсюда имя группы и механизм видов, поэтому обратная зависимость завела бы цикл. Единственная внешняя зависимость — packaging (канон имён дистрибутивов, PEP 503/508).

Манифест состава

from pluginkit import manifest
from pluginkit.discovery import discover_plugin_packages

manifest.record(discover_plugin_packages([Path("~/PROJECT/_storage").expanduser()]))
# ... переустановка продукта уносит окружение ...
пакеты, исчезли, беда = manifest.autoheal_plan()

Файл лежит ВНЕ окружения инструмента (%LOCALAPPDATA%/skillery/plugins.json или $XDG_DATA_HOME/skillery/plugins.json); путь переопределяется переменной PLUGINKIT_MANIFEST.