standkit 0.7.0__tar.gz → 0.9.0__tar.gz

{standkit-0.7.0 → standkit-0.9.0}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 standkit contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 standkit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{standkit-0.7.0 → standkit-0.9.0}/MANIFEST.in

@@ -1,5 +1,5 @@
-include projects.sample.json
-include README.md
-include LICENSE
-include SECURITY.md
-recursive-include docs *.md
+include projects.sample.json
+include README.md
+include LICENSE
+include SECURITY.md
+recursive-include docs *.md

{standkit-0.7.0/standkit.egg-info → standkit-0.9.0}/PKG-INFO

@@ -1,175 +1,222 @@
-Metadata-Version: 2.4
-Name: standkit
-Version: 0.7.0
-Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
-Author: standkit contributors
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/thinkquattro/BPMkitStand
-Project-URL: Экосистема BPMkit, https://bpmkit.pro
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Operating System :: OS Independent
-Classifier: Intended Audience :: System Administrators
-Classifier: Topic :: System :: Systems Administration
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Provides-Extra: secrets
-Requires-Dist: keyring>=24; extra == "secrets"
-Provides-Extra: desktop
-Requires-Dist: pywebview>=5; extra == "desktop"
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Dynamic: license-file
-
-<div align="center">
-
-<img src="https://raw.githubusercontent.com/thinkquattro/BPMkitStand/main/standkit_hub/web/bpmkit-logo.svg" alt="BPMkit" width="300"/>
-
-# BPMkitStand
-
-**Свободный диспетчер стендов BPMSoft.**
-Локальный веб-дашборд для запуска, остановки и мониторинга ваших стендов — в один клик, без консоли.
-
-[![License: MIT](https://img.shields.io/badge/License-MIT-f9763d.svg)](LICENSE)
-[![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](https://www.python.org/)
-[![Platform](https://img.shields.io/badge/OS-Windows%20%7C%20Linux-lightgrey.svg)]()
-
-[Сайт](https://bpmkit.pro) · [Telegram](https://t.me/quattrolife) · [Companion-версия](https://bpmkit.pro)
-
-</div>
-
----
-
-## Что это
-
-**BPMkitStand** — бесплатный инструмент экосистемы [BPMkit](https://bpmkit.pro) для управления
-локальными и удалёнными стендами BPMSoft. Открывает лёгкий локальный веб-дашборд в браузере:
-видно состояние каждого стенда, его можно запустить/остановить/перезапустить, посмотреть логи
-текущей сессии и очистить Redis — всё без ручных команд в PowerShell.
-
-Ядро (`standkit`) написано на чистой стандартной библиотеке Python — без тяжёлых зависимостей,
-работает на Windows и Linux.
-
-## Возможности
-
-- **Дашборд стендов** — список из общего реестра BPMkit (`projects.json`), состояние в реальном времени.
-- **Жизненный цикл** — старт / стоп / рестарт стенда с честной обратной связью (спиннер до готовности, без ложных «не поднялся» на прогреве).
-- **Логи** — просмотр логов текущей сессии стенда, открытие папки логов стенда и папки BPMkit-проекта.
-- **Redis** — очистка кэша стенда (номер БД берётся из конфигурации стенда).
-- **Тёмная и светлая тема** с переключателем.
-- **Встроенная справка** — кнопка «?» в шапке открывает кукбук: установка, работа с дашбордом, удалённые агенты, траблшутинг. Один самодостаточный файл, работает офлайн.
-- **Безопасность по умолчанию** — дашборд слушает только `127.0.0.1`, сессионный токен, защита мутаций (CSRF + проверка Origin).
-- **Удалённые стенды** *(в развитии)* — через лёгкие кроссплатформенные headless-агенты с TLS/mTLS.
-
-## Скриншоты
-
-| Дашборд (светлая тема) | Дашборд (тёмная тема) |
-|---|---|
-| ![Дашборд, светлая тема](https://raw.githubusercontent.com/thinkquattro/BPMkitStand/main/docs/img/dashboard-light.png) | ![Дашборд, тёмная тема](https://raw.githubusercontent.com/thinkquattro/BPMkitStand/main/docs/img/dashboard-dark.png) |
-
-<div align="center">
-  <img src="https://raw.githubusercontent.com/thinkquattro/BPMkitStand/main/docs/img/about.png" alt="Модальное окно «О программе»" width="360"/>
-</div>
-
-## Как это работает
-
-BPMkitStand состоит из **ядра и двух оболочек**:
-
-- **`standkit`** — ядро (MIT) на чистой стандартной библиотеке Python: движок жизненного цикла
-  над реестром `projects.json` (старт/стоп/рестарт процесса стенда), health-пробы (процесс / HTTP
-  / порт БД / порт Redis), tail лога, Secret-first доступ к секретам. Без веб-слоя и сетевых
-  зависимостей — можно использовать и как библиотеку/CLI.
-- **`standkit_hub`** — локальный веб-дашборд (то, что видно на скриншотах). Сам себя отдаёт по
-  HTTP через `stdlib http.server` (vanilla JS/CSS, без CDN и сборки) и открывается в системном
-  браузере; опционально — в нативном окне (`standkit[desktop]`, `--desktop`). Устанавливается
-  только на машину оператора.
-- **`standkit_agent`** — лёгкий headless-демон на хосте удалённого стенда (см. ниже).
-
-Дашборд — **федеративный клиент**: он собирает в один список и локальные стенды (управляет ими
-напрямую через ядро), и удалённые (ходит к их агентам по HTTP). В таблице колонка «Транспорт»
-показывает, как дашборд дотягивается до стенда: `local` или `agent`.
-
-Реестр стендов — **единый с MCP BPMkit**: один `projects.json` (стенды под ключом `projects`),
-путь резолвится через `BPMSOFT_PROJECTS_FILE` → `%APPDATA%\BPMkit\projects.json`
-(`~/.config/BPMkit/...` на Linux) → `./projects.json`. Секреты (пароли БД, токены агентов) в
-реестре не хранятся — только ссылки на них (Secret-first).
-
-Запуск стенда честный: дашборд поднимает `dotnet <stand_dll>` и держит спиннер до реального
-ответа web-хоста по HTTP, а не рапортует «запущено» по факту создания процесса.
-
-Виды хостинга (kestrel/iis/docker) — см. [docs/HOSTING.md](docs/HOSTING.md).
-
-## Удалённые стенды
-
-Стенды на других хостах (виртуалки, серверы, контуры заказчика) управляются через **федерацию
-лёгких кроссплатформенных агентов** (`standkit_agent`, Windows/Linux, только stdlib). На хосте
-стенда поднимается агент, дашборд оператора ходит к нему по HTTPS с Bearer-токеном; стенд
-объявляется удалённым одним полем `transport: "agent"` в реестре. Агент — RCE-поверхность по
-дизайну, поэтому защищён secure-defaults: loopback по умолчанию, fail-closed на non-loopback без
-TLS, TLS 1.2+/mTLS, скоупы control/readonly, lockout по IP, аудит.
-
-**Полное описание, установка агента, TLS/mTLS, служба и траблшутинг — в
-[docs/REMOTE_STANDS.md](docs/REMOTE_STANDS.md).**
-
-## Установка
-
-Нужен Python 3.10+.
-
-```bash
-pip install standkit
-```
-
-Обновление — `pip install -U standkit`. Свежий `main` до релиза (если нужна ещё не выпущенная
-правка) — `pip install --force-reinstall "git+https://github.com/thinkquattro/BPMkitStand.git"`.
-
-Запуск дашборда:
-
-```bash
-standkit-hub
-```
-
-Откроется браузер с локальным дашбордом. Реестр стендов берётся из
-`%APPDATA%\BPMkit\projects.json` (или из переменной окружения `BPMSOFT_PROJECTS_FILE`).
-
-## Реестр стендов
-
-BPMkitStand использует тот же реестр, что и MCP BPMkit — единый `projects.json`.
-Образец формата — [`projects.sample.json`](projects.sample.json). Стенд можно
-зарегистрировать прямо из дашборда (кнопка «Зарегистрировать стенд»).
-
-## Безопасность
-
-Дашборд и агент проектировались с расчётом на прод-контур. Модель угроз, харденинг и чек-лист —
-в [SECURITY.md](SECURITY.md). Кратко: fail-closed bind на loopback, TLS 1.2+/mTLS для агента,
-скоупы токена, per-IP lockout, аудит без утечки секретов.
-
-## Документация проекта
-
-- [standkit_hub/web/cookbook.html](standkit_hub/web/cookbook.html) — **кукбук**: обзор, установка (отдельно Windows и Linux), обновление, дашборд, реестр стендов, виды хостинга, удалённые стенды и агент-демон, безопасность, траблшутинг. Один standalone-файл: в работающем диспетчере открывается кнопкой «?» в шапке, без него — прямо с диска в браузере.
-- [docs/ROADMAP.md](docs/ROADMAP.md) — дорожная карта приложения (что сделано / ближайшее / бэклог).
-- [docs/CHANGELOG.md](docs/CHANGELOG.md) — история изменений по версиям.
-- [docs/BACKLOG.md](docs/BACKLOG.md) — честный список «упомянуто в коде, но не реализовано» (заделы/заглушки) со ссылками на код.
-- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) · [docs/HOSTING.md](docs/HOSTING.md) · [docs/REMOTE_STANDS.md](docs/REMOTE_STANDS.md) · [SECURITY.md](SECURITY.md)
-- Решения (ADR): [0001 — hosting backends](docs/adr/0001-hosting-backends.md) · [0002 — k8s backend](docs/adr/0002-k8s-backend.md) · [0003 — браузинг логов удалённых стендов (предложено)](docs/adr/0003-remote-log-browsing.md) · [0004 — IIS: жизненный цикл по Site](docs/adr/0004-iis-site-scoped-lifecycle.md)
-
-> Статус: `standkit` — молодой проект (0.5.x). Ядро/агент/хаб работоспособны, но
-> ряд возможностей — это **каркас/заделы** (например, глубокие пробы БД/Redis,
-> транспорты ssh/winrm, живая приёмка Docker/k8s/IIS). Что именно ещё не
-> дописано — прозрачно перечислено в [docs/BACKLOG.md](docs/BACKLOG.md).
-
-## BPMkitStand и Companion
-
-Бесплатная версия — полноценный диспетчер стендов. **Companion-версия** дополнительно даёт
-автообновление MCP BPMkit и контроль лицензии; поставляется в составе установщика MCP-клиента.
-Подробнее — на [bpmkit.pro](https://bpmkit.pro).
-
-## Лицензия
-
-[MIT](LICENSE) © Владимир Терновский
-
----
-
-<div align="center">
-<sub>Часть экосистемы <a href="https://bpmkit.pro">BPMkit</a> — AI-ассистента для разработки на BPMSoft.</sub>
-</div>
+Metadata-Version: 2.4
+Name: standkit
+Version: 0.9.0
+Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
+Author: standkit contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/thinkquattro/BPMkitStand
+Project-URL: Экосистема BPMkit, https://bpmkit.pro
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: System Administrators
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: secrets
+Requires-Dist: keyring>=24; extra == "secrets"
+Provides-Extra: desktop
+Requires-Dist: pywebview>=5; extra == "desktop"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/thinkquattro/BPMkitStand/main/standkit_hub/web/bpmkit-logo.svg" alt="BPMkit" width="300"/>
+
+# BPMkitStand
+
+**Свободный диспетчер стендов BPMSoft.**
+Локальный веб-дашборд для запуска, остановки и мониторинга ваших стендов — в один клик, без консоли.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-f9763d.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](https://www.python.org/)
+[![Platform](https://img.shields.io/badge/OS-Windows%20%7C%20Linux-lightgrey.svg)]()
+
+[Сайт](https://bpmkit.pro) · [Telegram](https://t.me/quattrolife) · [Companion-версия](https://bpmkit.pro)
+
+</div>
+
+---
+
+## Что это
+
+**BPMkitStand** — бесплатный инструмент экосистемы [BPMkit](https://bpmkit.pro) для управления
+локальными и удалёнными стендами BPMSoft. Открывает лёгкий локальный веб-дашборд в браузере:
+видно состояние каждого стенда, его можно запустить/остановить/перезапустить, посмотреть логи
+текущей сессии и очистить Redis — всё без ручных команд в PowerShell.
+
+Ядро (`standkit`) написано на чистой стандартной библиотеке Python — без тяжёлых зависимостей,
+работает на Windows и Linux.
+
+## Возможности
+
+- **Дашборд стендов** — список из общего реестра BPMkit (`projects.json`), состояние в реальном времени.
+- **Жизненный цикл** — старт / стоп / рестарт стенда с честной обратной связью (спиннер до готовности, без ложных «не поднялся» на прогреве).
+- **Логи** — просмотр логов текущей сессии стенда, открытие папки логов стенда и папки BPMkit-проекта.
+- **Redis** — очистка кэша стенда (номер БД берётся из конфигурации стенда).
+- **Тёмная и светлая тема** с переключателем.
+- **Встроенная справка** — кнопка «?» в шапке открывает кукбук: установка, работа с дашбордом, удалённые агенты, траблшутинг. Один самодостаточный файл, работает офлайн.
+- **Безопасность по умолчанию** — дашборд слушает только `127.0.0.1`, сессионный токен, защита мутаций (CSRF + проверка Origin).
+- **Удалённые стенды** *(в развитии)* — через лёгкие кроссплатформенные headless-агенты с TLS/mTLS.
+- **Канал обновлений** *(редакция Companion)* — вкладка «Обновления»: паттерны разработки, обновление MCP с проверкой подписи и откатом, список отзыва лицензий.
+
+## Скриншоты
+
+| Дашборд (светлая тема) | Дашборд (тёмная тема) |
+|---|---|
+| ![Дашборд, светлая тема](https://raw.githubusercontent.com/thinkquattro/BPMkitStand/main/docs/img/dashboard-light.png) | ![Дашборд, тёмная тема](https://raw.githubusercontent.com/thinkquattro/BPMkitStand/main/docs/img/dashboard-dark.png) |
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/thinkquattro/BPMkitStand/main/docs/img/about.png" alt="Модальное окно «О программе»" width="360"/>
+</div>
+
+## Как это работает
+
+BPMkitStand состоит из **ядра, двух оболочек и канала обновлений**:
+
+- **`standkit`** — ядро (MIT) на чистой стандартной библиотеке Python: движок жизненного цикла
+  над реестром `projects.json` (старт/стоп/рестарт процесса стенда), health-пробы (процесс / HTTP
+  / порт БД / порт Redis), tail лога, Secret-first доступ к секретам. Без веб-слоя и сетевых
+  зависимостей — можно использовать и как библиотеку/CLI.
+- **`standkit_hub`** — локальный веб-дашборд (то, что видно на скриншотах). Сам себя отдаёт по
+  HTTP через `stdlib http.server` (vanilla JS/CSS, без CDN и сборки) и открывается в системном
+  браузере; опционально — в нативном окне (`standkit[desktop]`, `--desktop`). Устанавливается
+  только на машину оператора.
+- **`standkit_agent`** — лёгкий headless-демон на хосте удалённого стенда (см. ниже).
+- **`standkit_companion`** — транспорт канала обновлений издателя (см. ниже). Хаб импортирует
+  его мягко: пакета нет — дашборд работает как обычно, в свободной редакции.
+
+Дашборд — **федеративный клиент**: он собирает в один список и локальные стенды (управляет ими
+напрямую через ядро), и удалённые (ходит к их агентам по HTTP). В таблице колонка «Транспорт»
+показывает, как дашборд дотягивается до стенда: `local` или `agent`.
+
+Реестр стендов — **единый с MCP BPMkit**: один `projects.json` (стенды под ключом `projects`),
+путь резолвится через `BPMSOFT_PROJECTS_FILE` → `%APPDATA%\BPMkit\projects.json`
+(`~/.config/BPMkit/...` на Linux) → `./projects.json`. Секреты (пароли БД, токены агентов) в
+реестре не хранятся — только ссылки на них (Secret-first).
+
+Запуск стенда честный: дашборд поднимает `dotnet <stand_dll>` и держит спиннер до реального
+ответа web-хоста по HTTP, а не рапортует «запущено» по факту создания процесса.
+
+Виды хостинга (kestrel/iis/docker) — см. [docs/HOSTING.md](docs/HOSTING.md).
+
+## Удалённые стенды
+
+Стенды на других хостах (виртуалки, серверы, контуры заказчика) управляются через **федерацию
+лёгких кроссплатформенных агентов** (`standkit_agent`, Windows/Linux, только stdlib). На хосте
+стенда поднимается агент, дашборд оператора ходит к нему по HTTPS с Bearer-токеном; стенд
+объявляется удалённым одним полем `transport: "agent"` в реестре. Агент — RCE-поверхность по
+дизайну, поэтому защищён secure-defaults: loopback по умолчанию, fail-closed на non-loopback без
+TLS, TLS 1.2+/mTLS, скоупы control/readonly, lockout по IP, аудит.
+
+**Полное описание, установка агента, TLS/mTLS, служба и траблшутинг — в
+[docs/REMOTE_STANDS.md](docs/REMOTE_STANDS.md).**
+
+## Установка
+
+Нужен Python 3.10+.
+
+```bash
+pip install standkit
+```
+
+Обновление — `pip install -U standkit`. Конкретная версия (в том числе откат) —
+`pip install "standkit==0.6.1"`; полный список выпусков — на
+[PyPI](https://pypi.org/project/standkit/).
+
+Запуск дашборда:
+
+```bash
+standkit-hub
+```
+
+Откроется браузер с локальным дашбордом. Реестр стендов берётся из
+`%APPDATA%\BPMkit\projects.json` (или из переменной окружения `BPMSOFT_PROJECTS_FILE`).
+
+## Реестр стендов
+
+BPMkitStand использует тот же реестр, что и MCP BPMkit — единый `projects.json`.
+Образец формата — [`projects.sample.json`](projects.sample.json). Стенд можно
+зарегистрировать прямо из дашборда (кнопка «Зарегистрировать стенд»).
+
+## Канал обновлений
+
+Вкладка **«Обновления»** в дашборде — канал доставки от издателя BPMkit: паттерны
+разработки, обновления самого MCP и список отозванных лицензий. В репозитории живёт
+**транспорт** (пакет `standkit_companion`, stdlib-only: HTTP-клиент, планировщик трёх
+циклов, проверка целостности и подписи Ed25519, раскладка файлов, откат). Лицензия,
+содержимое паттернов и подписанные бинари — на стороне издателя, поэтому без
+лицензионного ключа канал ничего не делает и честно об этом сообщает.
+
+Редакция определяется наличием пакета: нет `standkit_companion` рядом — вкладка говорит
+«свободная редакция», управление стендами работает как работало. Главный рубильник —
+`companion.enabled` в настройках диспетчера; интервалы и циклы включаются там же
+(«Настройки» → «Канал обновлений»).
+
+Два правила, которые канал не нарушает: **бинарь MCP не подменяется без вашей команды**
+(автоматика доходит максимум до скачивания в отдельный каталог) и **обновление не
+применяется без подтверждённой подписи** — это не отключается настройкой.
+
+То же самое из консоли, когда дашборд под рукой не нужен:
+
+```bash
+python -m standkit_companion status          # состояние канала (плюс --json)
+python -m standkit_companion sync            # синхронизировать паттерны
+python -m standkit_companion check-update    # проверить обновление MCP (не качая файл)
+python -m standkit_companion stage-update    # скачать и проверить, не применяя
+python -m standkit_companion apply-update    # применить подготовленное
+python -m standkit_companion rollback        # вернуть предыдущую версию
+```
+
+Подробности — в [кукбуке](standkit_hub/web/cookbook.html), раздел «Канал обновлений»
+(что приезжает, чем различаются три цикла, где лежат файлы, таблица диагностик).
+Почему транспорт живёт в MIT-ядре и чего модуль не делает никогда —
+[docs/adr/0005-companion-transport-in-mit-core.md](docs/adr/0005-companion-transport-in-mit-core.md).
+
+## Безопасность
+
+Дашборд и агент проектировались с расчётом на прод-контур. Модель угроз, харденинг и чек-лист —
+в [SECURITY.md](SECURITY.md). Кратко: fail-closed bind на loopback, TLS 1.2+/mTLS для агента,
+скоупы токена, per-IP lockout, аудит без утечки секретов. Канал обновлений разобран там же
+отдельным разделом (§4.2): fail-closed подпись исполняемого артефакта, публичный ключ из
+поставки, запись только в пользовательские каталоги.
+
+## Документация проекта
+
+**Карта всех документов — [docs/README.md](docs/README.md)**: кому, о чём и когда открывать.
+Коротко:
+
+| Документ | Для кого |
+|---|---|
+| [**Кукбук**](standkit_hub/web/cookbook.html) — обзор, установка, дашборд, реестр, хостинг, агент, безопасность, траблшутинг. Один standalone-файл: в работающем диспетчере открывается кнопкой «?» в шапке, без него — прямо с диска в браузере | оператор |
+| [docs/COOKBOOK_LINUX.md](docs/COOKBOOK_LINUX.md) — пошаговое развёртывание агента на Linux: pipx/venv, реестр, секреты, systemd, TLS/mTLS, разбор типичных ошибок с реальными сообщениями | администратор |
+| [docs/REMOTE_STANDS.md](docs/REMOTE_STANDS.md) · [docs/HOSTING.md](docs/HOSTING.md) · [SECURITY.md](SECURITY.md) | оператор / администратор |
+| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) · [docs/adr/](docs/adr/) · [docs/CHANGELOG.md](docs/CHANGELOG.md) | разработчик |
+| [docs/ROADMAP.md](docs/ROADMAP.md) — крупные работы · [docs/BACKLOG.md](docs/BACKLOG.md) — заглушки и заделы в коде · [docs/GAPs/](docs/GAPs/README.md) — код прав, а сценарий оператора ломается | планирование |
+
+> Статус: `standkit` — молодой проект (0.9.x). Ядро/агент/хаб работоспособны, но
+> ряд возможностей — это **каркас/заделы** (например, глубокие пробы БД/Redis,
+> транспорты ssh/winrm, живая приёмка Docker/k8s/IIS). Что именно ещё не
+> дописано — прозрачно перечислено в [docs/BACKLOG.md](docs/BACKLOG.md).
+
+## BPMkitStand и Companion
+
+Бесплатная версия — полноценный диспетчер стендов. **Companion-версия** дополнительно даёт
+канал обновлений: паттерны разработки, автообновление MCP BPMkit и контроль лицензии;
+поставляется в составе установщика MCP-клиента. Код транспорта канала лежит в этом
+репозитории под MIT (см. раздел «Канал обновлений» выше) — платное здесь то, что канал
+доставляет: лицензия, содержимое паттернов и подписанные бинари.
+Подробнее — на [bpmkit.pro](https://bpmkit.pro).
+
+## Лицензия
+
+[MIT](LICENSE) © Владимир Терновский
+
+---
+
+<div align="center">
+<sub>Часть экосистемы <a href="https://bpmkit.pro">BPMkit</a> — AI-ассистента для разработки на BPMSoft.</sub>
+</div>