standkit 0.12.8__tar.gz → 0.12.10__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (162) hide show
  1. {standkit-0.12.8/standkit.egg-info → standkit-0.12.10}/PKG-INFO +1 -1
  2. {standkit-0.12.8 → standkit-0.12.10}/docs/CHANGELOG.md +93 -0
  3. {standkit-0.12.8 → standkit-0.12.10}/docs/ROADMAP.md +1 -1
  4. {standkit-0.12.8 → standkit-0.12.10}/pyproject.toml +1 -1
  5. {standkit-0.12.8 → standkit-0.12.10}/standkit/__init__.py +1 -1
  6. {standkit-0.12.8 → standkit-0.12.10}/standkit/platform.py +59 -0
  7. {standkit-0.12.8 → standkit-0.12.10/standkit.egg-info}/PKG-INFO +1 -1
  8. {standkit-0.12.8 → standkit-0.12.10}/standkit.egg-info/SOURCES.txt +7 -0
  9. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/errors.py +28 -0
  10. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/patterns.py +34 -2
  11. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/releases.py +782 -7
  12. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/runner.py +101 -5
  13. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/signature.py +19 -1
  14. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/state.py +44 -0
  15. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/__main__.py +41 -0
  16. standkit-0.12.10/standkit_hub/bpmkit_cookbook.py +144 -0
  17. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/instance.py +25 -1
  18. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/server.py +83 -2
  19. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/web/app.js +643 -22
  20. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/web/index.html +71 -9
  21. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/web/style.css +114 -0
  22. standkit-0.12.10/tests/test_companion_installer_channel.py +267 -0
  23. standkit-0.12.10/tests/test_gap279_hub_install.py +399 -0
  24. standkit-0.12.10/tests/test_gap445_hub_session_detect.py +284 -0
  25. standkit-0.12.10/tests/test_gap447_437_442_hub_truth.py +370 -0
  26. standkit-0.12.10/tests/test_gap463_requires_installer.py +435 -0
  27. standkit-0.12.10/tests/test_gap522_hub_help_menu.py +203 -0
  28. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_companion_api.py +3 -0
  29. {standkit-0.12.8 → standkit-0.12.10}/LICENSE +0 -0
  30. {standkit-0.12.8 → standkit-0.12.10}/MANIFEST.in +0 -0
  31. {standkit-0.12.8 → standkit-0.12.10}/README.md +0 -0
  32. {standkit-0.12.8 → standkit-0.12.10}/SECURITY.md +0 -0
  33. {standkit-0.12.8 → standkit-0.12.10}/docs/ARCHITECTURE.md +0 -0
  34. {standkit-0.12.8 → standkit-0.12.10}/docs/BACKLOG.md +0 -0
  35. {standkit-0.12.8 → standkit-0.12.10}/docs/COOKBOOK_LINUX.md +0 -0
  36. {standkit-0.12.8 → standkit-0.12.10}/docs/GAPs/GAP-001-registry-fields-out-of-hub-form.md +0 -0
  37. {standkit-0.12.8 → standkit-0.12.10}/docs/GAPs/GAP-002-http-probe-down-not-explained.md +0 -0
  38. {standkit-0.12.8 → standkit-0.12.10}/docs/GAPs/GAP-003-redis-endpoint-in-extra.md +0 -0
  39. {standkit-0.12.8 → standkit-0.12.10}/docs/GAPs/GAP-004-cookbook-hub-register-form.md +0 -0
  40. {standkit-0.12.8 → standkit-0.12.10}/docs/GAPs/GAP-005-cookbook-hub-side-secrets.md +0 -0
  41. {standkit-0.12.8 → standkit-0.12.10}/docs/GAPs/GAP-006-log-dir-case-and-separator.md +0 -0
  42. {standkit-0.12.8 → standkit-0.12.10}/docs/GAPs/GAP-007-agent-paths-raw-traceback.md +0 -0
  43. {standkit-0.12.8 → standkit-0.12.10}/docs/GAPs/GAP-008-agent-cert-trust-on-hub.md +0 -0
  44. {standkit-0.12.8 → standkit-0.12.10}/docs/GAPs/README.md +0 -0
  45. {standkit-0.12.8 → standkit-0.12.10}/docs/HOSTING.md +0 -0
  46. {standkit-0.12.8 → standkit-0.12.10}/docs/README.md +0 -0
  47. {standkit-0.12.8 → standkit-0.12.10}/docs/REMOTE_STANDS.md +0 -0
  48. {standkit-0.12.8 → standkit-0.12.10}/docs/adr/0001-hosting-backends.md +0 -0
  49. {standkit-0.12.8 → standkit-0.12.10}/docs/adr/0002-k8s-backend.md +0 -0
  50. {standkit-0.12.8 → standkit-0.12.10}/docs/adr/0003-remote-log-browsing.md +0 -0
  51. {standkit-0.12.8 → standkit-0.12.10}/docs/adr/0004-iis-site-scoped-lifecycle.md +0 -0
  52. {standkit-0.12.8 → standkit-0.12.10}/docs/adr/0005-companion-transport-in-mit-core.md +0 -0
  53. {standkit-0.12.8 → standkit-0.12.10}/docs/adr/0006-hub-elevated-restart.md +0 -0
  54. {standkit-0.12.8 → standkit-0.12.10}/docs/adr/0007-hub-exit-idle-and-plain-restart.md +0 -0
  55. {standkit-0.12.8 → standkit-0.12.10}/docs/research/companion-v2-cicd-thin-agent.md +0 -0
  56. {standkit-0.12.8 → standkit-0.12.10}/projects.sample.json +0 -0
  57. {standkit-0.12.8 → standkit-0.12.10}/setup.cfg +0 -0
  58. {standkit-0.12.8 → standkit-0.12.10}/standkit/adopt.py +0 -0
  59. {standkit-0.12.8 → standkit-0.12.10}/standkit/cli_resolve.py +0 -0
  60. {standkit-0.12.8 → standkit-0.12.10}/standkit/health.py +0 -0
  61. {standkit-0.12.8 → standkit-0.12.10}/standkit/hosting.py +0 -0
  62. {standkit-0.12.8 → standkit-0.12.10}/standkit/lifecycle.py +0 -0
  63. {standkit-0.12.8 → standkit-0.12.10}/standkit/logs.py +0 -0
  64. {standkit-0.12.8 → standkit-0.12.10}/standkit/models.py +0 -0
  65. {standkit-0.12.8 → standkit-0.12.10}/standkit/registry.py +0 -0
  66. {standkit-0.12.8 → standkit-0.12.10}/standkit/secrets.py +0 -0
  67. {standkit-0.12.8 → standkit-0.12.10}/standkit.egg-info/dependency_links.txt +0 -0
  68. {standkit-0.12.8 → standkit-0.12.10}/standkit.egg-info/entry_points.txt +0 -0
  69. {standkit-0.12.8 → standkit-0.12.10}/standkit.egg-info/requires.txt +0 -0
  70. {standkit-0.12.8 → standkit-0.12.10}/standkit.egg-info/top_level.txt +0 -0
  71. {standkit-0.12.8 → standkit-0.12.10}/standkit_agent/__init__.py +0 -0
  72. {standkit-0.12.8 → standkit-0.12.10}/standkit_agent/__main__.py +0 -0
  73. {standkit-0.12.8 → standkit-0.12.10}/standkit_agent/audit.py +0 -0
  74. {standkit-0.12.8 → standkit-0.12.10}/standkit_agent/security.py +0 -0
  75. {standkit-0.12.8 → standkit-0.12.10}/standkit_agent/server.py +0 -0
  76. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/__init__.py +0 -0
  77. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/__main__.py +0 -0
  78. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/backend.py +0 -0
  79. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/candidates.py +0 -0
  80. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/context.py +0 -0
  81. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/cookbook.py +0 -0
  82. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/ed25519.py +0 -0
  83. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/fsutil.py +0 -0
  84. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/mcp_mutex.py +0 -0
  85. {standkit-0.12.8 → standkit-0.12.10}/standkit_companion/revocations.py +0 -0
  86. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/__init__.py +0 -0
  87. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/agent_control.py +0 -0
  88. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/assets/bpmkit-icon.ico +0 -0
  89. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/assets/icon.png +0 -0
  90. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/client.py +0 -0
  91. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/config.py +0 -0
  92. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/consent_api.py +0 -0
  93. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/elevated_op.py +0 -0
  94. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/elevation.py +0 -0
  95. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/hub_logging.py +0 -0
  96. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/license_api.py +0 -0
  97. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/logs_browser.py +0 -0
  98. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/mutex.py +0 -0
  99. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/pick_dialog.py +0 -0
  100. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/poller.py +0 -0
  101. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/preload.py +0 -0
  102. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/redis_min.py +0 -0
  103. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/security.py +0 -0
  104. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/shortcut.py +0 -0
  105. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/web/bpmkit-logo-dark.svg +0 -0
  106. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/web/bpmkit-logo.svg +0 -0
  107. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/web/cookbook.html +0 -0
  108. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/web/favicon.png +0 -0
  109. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/web/favicon.svg +0 -0
  110. {standkit-0.12.8 → standkit-0.12.10}/standkit_hub/web/manifest.webmanifest +0 -0
  111. {standkit-0.12.8 → standkit-0.12.10}/tests/test_adopt.py +0 -0
  112. {standkit-0.12.8 → standkit-0.12.10}/tests/test_agent_security.py +0 -0
  113. {standkit-0.12.8 → standkit-0.12.10}/tests/test_agent_server_integration.py +0 -0
  114. {standkit-0.12.8 → standkit-0.12.10}/tests/test_agent_startup_preflight.py +0 -0
  115. {standkit-0.12.8 → standkit-0.12.10}/tests/test_companion_backend.py +0 -0
  116. {standkit-0.12.8 → standkit-0.12.10}/tests/test_companion_candidates.py +0 -0
  117. {standkit-0.12.8 → standkit-0.12.10}/tests/test_companion_context.py +0 -0
  118. {standkit-0.12.8 → standkit-0.12.10}/tests/test_companion_cookbook.py +0 -0
  119. {standkit-0.12.8 → standkit-0.12.10}/tests/test_companion_fsutil.py +0 -0
  120. {standkit-0.12.8 → standkit-0.12.10}/tests/test_companion_mcp_mutex.py +0 -0
  121. {standkit-0.12.8 → standkit-0.12.10}/tests/test_companion_patterns.py +0 -0
  122. {standkit-0.12.8 → standkit-0.12.10}/tests/test_companion_releases.py +0 -0
  123. {standkit-0.12.8 → standkit-0.12.10}/tests/test_companion_revocations.py +0 -0
  124. {standkit-0.12.8 → standkit-0.12.10}/tests/test_companion_runner.py +0 -0
  125. {standkit-0.12.8 → standkit-0.12.10}/tests/test_companion_signature.py +0 -0
  126. {standkit-0.12.8 → standkit-0.12.10}/tests/test_conftest_state_barrier.py +0 -0
  127. {standkit-0.12.8 → standkit-0.12.10}/tests/test_gap411_412_415_idle_preload.py +0 -0
  128. {standkit-0.12.8 → standkit-0.12.10}/tests/test_gap413_414_companion_consent_logs.py +0 -0
  129. {standkit-0.12.8 → standkit-0.12.10}/tests/test_gap429_cookbook_installed_version.py +0 -0
  130. {standkit-0.12.8 → standkit-0.12.10}/tests/test_health.py +0 -0
  131. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hosting.py +0 -0
  132. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_agent_control.py +0 -0
  133. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_client_tls.py +0 -0
  134. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_config.py +0 -0
  135. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_consent_api.py +0 -0
  136. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_elevated_op.py +0 -0
  137. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_elevation.py +0 -0
  138. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_elevation_ui.py +0 -0
  139. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_exit_idle_restart.py +0 -0
  140. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_fast_paint.py +0 -0
  141. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_instance.py +0 -0
  142. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_license_api.py +0 -0
  143. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_logging.py +0 -0
  144. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_logs_browser.py +0 -0
  145. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_main_elevated.py +0 -0
  146. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_mutex.py +0 -0
  147. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_pick_dialog.py +0 -0
  148. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_pwa_and_compact.py +0 -0
  149. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_redis_min.py +0 -0
  150. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_register.py +0 -0
  151. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_server.py +0 -0
  152. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_settings_field_help.py +0 -0
  153. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_shortcut.py +0 -0
  154. {standkit-0.12.8 → standkit-0.12.10}/tests/test_hub_single_instance.py +0 -0
  155. {standkit-0.12.8 → standkit-0.12.10}/tests/test_lifecycle.py +0 -0
  156. {standkit-0.12.8 → standkit-0.12.10}/tests/test_logs.py +0 -0
  157. {standkit-0.12.8 → standkit-0.12.10}/tests/test_models.py +0 -0
  158. {standkit-0.12.8 → standkit-0.12.10}/tests/test_no_window.py +0 -0
  159. {standkit-0.12.8 → standkit-0.12.10}/tests/test_platform_sid.py +0 -0
  160. {standkit-0.12.8 → standkit-0.12.10}/tests/test_registry.py +0 -0
  161. {standkit-0.12.8 → standkit-0.12.10}/tests/test_registry_resolver.py +0 -0
  162. {standkit-0.12.8 → standkit-0.12.10}/tests/test_secrets.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: standkit
3
- Version: 0.12.8
3
+ Version: 0.12.10
4
4
  Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
5
5
  Author: standkit contributors
6
6
  License-Expression: MIT
@@ -5,6 +5,98 @@
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [0.12.10] — 2026-09-24
9
+
10
+ На PyPI выпуск 0.12.9 отдельно не выкладывался — изменения 0.12.9 (ниже) доезжают до
11
+ пользователей в составе 0.12.10.
12
+
13
+ ### Добавлено
14
+
15
+ - **Меню «Справка» в шапке дашборда: кукбук BPMkit и кукбук BPMkitStand (GAP-522).**
16
+ Кнопка «?» раньше вела только в кукбук самого диспетчера — инструкцию пользователя
17
+ BPMkit (что умеет MCP-агент, кейсы, FAQ, харнессы) из диспетчера было не открыть. Теперь
18
+ по кнопке раскрывается меню из двух пунктов, оба открываются в новой вкладке. Кукбук BPMkit
19
+ хаб отдаёт новым маршрутом `GET /bpmkit-cookbook` из локальной установки BPMkit — из профиля
20
+ (`%APPDATA%\BPMkit\docs\cookbook.html`, туда его кладут установщик и канал обновлений) или из
21
+ папки установки MCP (её хаб узнаёт по маркеру `mcp_runtime.json` запущенного сервера);
22
+ из двух копий берётся более новая по версии документа — те же правила, что у канала
23
+ обновлений (GAP-429). Нет ни одной копии — понятная страница с объяснением, где документ
24
+ ищется, вместо ошибки. Модуль поиска (`standkit_hub/bpmkit_cookbook.py`) stdlib-only и не
25
+ зависит от `standkit_companion` — меню работает и в свободной редакции. В окне
26
+ «О программе» подпись ссылки исправлена на «кукбук BPMkitStand», рядом — ссылка на
27
+ кукбук BPMkit.
28
+
29
+ ## [0.12.9] — 2026-09-24
30
+
31
+ ### Добавлено
32
+
33
+ - **«Установить обновление» ставит подписанный установщик целиком — MCP, диспетчер,
34
+ скиллы и документацию (GAP-279, ADR-0048).** В окне «Обновления» появилась кнопка
35
+ «Установить обновление X»: предпросмотр «MCP A→B, диспетчер C→D» и напоминание закрыть
36
+ Claude Desktop, подтверждение, затем тихий запуск установщика (`/VERYSILENT`, журнал Inno
37
+ Setup — `/LOG=<рабочий каталог канала>\installer_setup.log`) через новый
38
+ маршрут хаба `POST /api/companion/apply-installer` (действие канала `apply_installer`,
39
+ перепроверка подписи и `kind="installer"` перед запуском). Установщик сам останавливает
40
+ диспетчер и поднимает его заново; страница ждёт новый процесс, переподключается и
41
+ показывает новую версию (таймаут 10 минут, понятное сообщение и путь журнала установки,
42
+ если установщик завершился, не перезапустив диспетчер). Для версии с `requires_installer`
43
+ «Проверить обновления» сразу готовит установщик этой версии, есть и отдельная кнопка
44
+ «Скачать установщик» (`POST /api/companion/stage-installer`). Хаб без прав
45
+ администратора при установке «для всех пользователей» получает понятный отказ
46
+ `elevation_required` вместо «локальной ошибки».
47
+ - **Уведомления браузера об обновлениях (GAP-279).** Переключатель в «Настройки →
48
+ Обновления»: разрешение браузера спрашивается только по его нажатию; уведомление
49
+ приходит один раз на событие — «найдено обновление X» и «X скачано, готово к установке».
50
+ Без разрешения работают бейдж на кнопке «Обновления» и заголовок вкладки «(1) …»;
51
+ статус канала опрашивается в фоне раз в 5 минут.
52
+ - **Обновление, которое каналом доставить нельзя, честно говорит об этом (GAP-463).**
53
+ Канал обновлений подменяет ровно один файл — бинарь сервера; релиз, меняющий блок
54
+ запуска, требования рантайма или состав поставки вне бинаря, тихой подменой доставлен
55
+ быть не может. Издатель теперь может объявить это явно: `GET /v1/version/latest`
56
+ (тот же попутный запрос, что уже несёт `release_notes`/`known_issues`, GAP-442) отдаёт
57
+ булево `requires_installer` для версии `latest`; отсутствие поля, отсутствие записи и
58
+ мусор в значении — везде `false` (обратная совместимость со старым бэкендом). Пока флаг
59
+ поднят, канал НЕ стейджит эту версию — ни по расписанию, ни по кнопке «Проверить
60
+ обновления» — и НЕ подменяет ею бинарь: явная команда («Подготовить»/«Установить»)
61
+ получает typed-отказ `ChannelError(kind="requires_installer")`, того же класса, что у
62
+ `artifact_type_mismatch`/`signature_invalid`. Уже подготовленный ранее файл (гонка: флаг
63
+ поднялся уже ПОСЛЕ стейджинга) не отзывается — подпись доказана, данные целы, — но кнопка
64
+ «Установить» гаснет штатным механизмом `available_actions`, если флагована именно эта
65
+ подготовленная версия. Карточка «MCP-сервер BPMkit» в диспетчере вместо «доступна X»
66
+ показывает, что обновление ставится установщиком, и объясняет причину недоступности
67
+ кнопки в подсказке; свёрнутый спойлер «Что нового» по-прежнему показывает состав
68
+ флагованной версии.
69
+
70
+ ### Исправлено
71
+
72
+ - **Мьютекс диспетчера сеансовый (решение владельца 21.09.2026 -- НЕ переводить в `Global\\`), а порт 8770 второй сеанс всё равно видит занятым (GAP-445).** Файл состояния диспетчера (`standkit-hub.json`) теперь хранит `session_id` -- номер сеанса служб терминалов (WinAPI `ProcessIdToSessionId`, `standkit.platform.current_session_id`) процесса, записавшего файл -- ВТОРОЙ, независимый от именованного мьютекса источник «в каком сеансе живёт диспетчер». Установщик (репозиторий `bpmsoft-mcp`) сверяет мьютекс СВОЕГО сеанса с занятостью порта 8770 и этим полем: расхождение «порт занят, мьютекс не виден» -- диспетчер работает в другом сеансе, установка/деинсталляция честно отказывает и называет сеанс/учётку, вместо того чтобы молча посчитать путь свободным. Новый CLI `standkit-hub --hub-stop` останавливает диспетчер этого профиля штатно (без убийства дерева процессов) и печатает `HUB_SESSION=<id>` ПЕРЕД остановкой -- человек, получивший от установщика сообщение про чужой сеанс, узнаёт номер сеанса, где диспетчер работал.
73
+ - **Плашка «Перезапустите Claude Desktop» висела вечно (GAP-447).** `restart_required`
74
+ выставлялся подменой файла (`apply_staged`/`rollback`) и не снимался НИГДЕ — плашка
75
+ оставалась даже после честного перезапуска. Обращение клиента 21.09.2026
76
+ (LIC-2026-1B9C9123) добавило и второй симптом: сам MCP-процесс мог реально работать на
77
+ СТАРОЙ версии (`product_version` не совпадал с версией установленного бинаря), а UI
78
+ этого не показывал. Канал теперь читает маркер работающего процесса
79
+ (`mcp_runtime.json`, пишет `BPMkit/server`) на каждом тике проверки релиза и снимает
80
+ флаг, когда маркер СВЕЖЕЕ момента подмены И версия совпадает с установленной; окно
81
+ «Обновления» при известном расхождении версий называет ОБЕ версии прямо в тексте
82
+ плашки, а не только «новая версия».
83
+ - **Строка канала паттернов сводила четыре разных состояния к одному («ещё не
84
+ синхронизировались») (GAP-437).** Пустая, но УСПЕШНАЯ дельта (у издателя нет новых
85
+ паттернов) выглядела так же, как «канал ни разу не отрабатывал», а причина остановки
86
+ была видна только в двух случаях из четырёх. Состояния разведены: первая
87
+ синхронизация ещё не проходила / отработал, новых нет / отработал, дельта применена /
88
+ остановлен или ошибка — причина видна во всех случаях. Счётчик паттернов теперь
89
+ отражает фактически доступную базу (поставочная + применённая дельта), а не только
90
+ дельту последнего тика; размер поставочной базы, который раньше нигде не считался, —
91
+ честная оценка по числу файлов override-корня, без выдуманного нуля, если посчитать
92
+ не удалось.
93
+ - **Окно обновлений не говорило, что нового в обновлении (GAP-442).** Бэкенд уже отдаёт
94
+ состав релиза (`GET /v1/version/latest`, поля `release_notes`/`known_issues`), но
95
+ канал за ними не ходил. Теперь попутно проверке релиза (best-effort, недоступность
96
+ эндпоинта не роняет саму проверку) состав и известные проблемы подтягиваются в
97
+ состояние, а карточка «MCP-сервер BPMkit» показывает свёрнутый по умолчанию спойлер
98
+ «Что нового в X.Y.Z».
99
+
8
100
  ## [0.12.8] — 2026-09-20
9
101
 
10
102
  ### Исправлено
@@ -1348,6 +1440,7 @@
1348
1440
  - Первый публичный релиз ядра `standkit` + агента `standkit_agent` + веб-дашборда
1349
1441
  `standkit_hub` на PyPI; фронт-README, `docs/REMOTE_STANDS.md`, скриншоты.
1350
1442
 
1443
+ [0.12.10]: https://pypi.org/project/standkit/0.12.10/
1351
1444
  [0.11.5]: https://pypi.org/project/standkit/0.11.5/
1352
1445
  [0.11.4]: https://pypi.org/project/standkit/0.11.4/
1353
1446
  [0.11.3]: https://pypi.org/project/standkit/0.11.3/
@@ -5,7 +5,7 @@
5
5
  ссылками на код — [BACKLOG.md](BACKLOG.md). Архитектура — [ARCHITECTURE.md](ARCHITECTURE.md).
6
6
  Решения — [adr/](adr/). История изменений — [CHANGELOG.md](CHANGELOG.md).
7
7
 
8
- Текущая версия на PyPI: **0.10.0** ([все выпуски](https://pypi.org/project/standkit/)).
8
+ Текущая версия на PyPI: **0.12.10** ([все выпуски](https://pypi.org/project/standkit/)).
9
9
  Python ≥ 3.10, ядро и агент — stdlib-only. Карта документации — [README.md](README.md).
10
10
 
11
11
  ## ✅ Сделано
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "standkit"
7
- version = "0.12.8"
7
+ version = "0.12.10"
8
8
  description = "Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit."
9
9
  readme = "README.md"
10
10
  license = "MIT"
@@ -6,6 +6,6 @@ standkit — свободное (MIT) ядро управления жизнен
6
6
  и docs/ARCHITECTURE.md в корне репозитория.
7
7
  """
8
8
 
9
- __version__ = "0.12.8"
9
+ __version__ = "0.12.10"
10
10
 
11
11
  __all__ = ["__version__"]
@@ -309,6 +309,65 @@ def current_user_name() -> Optional[str]:
309
309
  return None
310
310
 
311
311
 
312
+ def _configure_session_id_winapi(kernel32) -> None:
313
+ """``argtypes``/``restype`` для ``ProcessIdToSessionId`` (GAP-445) --
314
+ вынесена отдельно для тестируемости на Linux заглушками, тем же приёмом,
315
+ что ``_configure_sid_winapi``/``_configure_process_time_winapi``."""
316
+ from ctypes import wintypes
317
+
318
+ kernel32.ProcessIdToSessionId.argtypes = [wintypes.DWORD, wintypes.PDWORD]
319
+ kernel32.ProcessIdToSessionId.restype = wintypes.BOOL
320
+
321
+
322
+ def current_session_id(pid: Optional[int] = None) -> Optional[int]:
323
+ """
324
+ Номер сеанса служб терминалов (Terminal Services session id) процесса
325
+ ``pid`` (по умолчанию -- ТЕКУЩЕГО процесса), через WinAPI
326
+ ``ProcessIdToSessionId`` (GAP-445).
327
+
328
+ ЗАЧЕМ. Именованный мьютекс диспетчера (``standkit_hub.mutex.HUB_MUTEX_NAME``)
329
+ и Windows SID (``current_user_sid`` выше) отвечают на РАЗНЫЕ вопросы:
330
+ мьютекс -- «есть ли диспетчер В ЭТОМ сеансе рабочего стола», SID -- «под
331
+ какой учётной записью». Ни один не отвечает на «в КАКОМ сеансе (RDP,
332
+ сеанс 0, вторая учётка на той же машине) работает диспетчер, которого я
333
+ вижу занимающим порт 8770, но чей мьютекс я НЕ вижу» -- установщик
334
+ (``bpmkit_installer.iss``, ``CheckForMutexes``/``HubMutexRunning``)
335
+ опрашивает мьютекс ТОЛЬКО в своём сеансе (без ``Global\\``-префикса,
336
+ решение владельца 21.09.2026 -- сеансовая модель мьютекса остаётся), и
337
+ расхождение «порт занят, мьютекс не виден» означает ровно это: диспетчер
338
+ жив, но в ДРУГОМ сеансе. ``ProcessIdToSessionId`` -- единственный публичный
339
+ WinAPI-вызов, который называет сеанс ЛЮБОГО живого pid на машине без
340
+ открытия хендла процесса (в отличие от ``OpenProcess``/токена выше) --
341
+ работает даже для процесса другого пользователя, если у вызывающего есть
342
+ право видеть сам pid (``tasklist``/``netstat -ano`` его уже показали).
343
+
344
+ ``standkit_hub.instance.HubInstanceState.session_id`` хранит РЕЗУЛЬТАТ
345
+ этого вызова для СВОЕГО процесса -- второй, независимый от мьютекса
346
+ источник «в каком сеансе я живу», который устанавливающий читает из
347
+ файла состояния хаба (``standkit-hub.json``) рядом с ``pid``.
348
+
349
+ ``None`` -- не Windows либо ЛЮБОЙ сбой (WinAPI недоступен, чужой pid не
350
+ виден и т.п.): честное «не знаю», а не 0 (сеанс 0 -- РЕАЛЬНЫЙ, отличимый
351
+ результат: служба/RDP-сессия без интерактивного рабочего стола).
352
+ """
353
+ if sys.platform != "win32":
354
+ return None
355
+ target_pid = int(pid) if pid is not None else os.getpid()
356
+ try:
357
+ import ctypes
358
+ from ctypes import wintypes
359
+
360
+ kernel32 = ctypes.WinDLL("kernel32", use_last_error=True)
361
+ _configure_session_id_winapi(kernel32)
362
+
363
+ session_id = wintypes.DWORD(0)
364
+ if not kernel32.ProcessIdToSessionId(wintypes.DWORD(target_pid), ctypes.byref(session_id)):
365
+ return None
366
+ return int(session_id.value)
367
+ except Exception:
368
+ return None
369
+
370
+
312
371
  def _configure_process_time_winapi(kernel32) -> None:
313
372
  """
314
373
  ``argtypes``/``restype`` для ``OpenProcess``/``GetProcessTimes``/
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: standkit
3
- Version: 0.12.8
3
+ Version: 0.12.10
4
4
  Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
5
5
  Author: standkit contributors
6
6
  License-Expression: MIT
@@ -70,6 +70,7 @@ standkit_companion/state.py
70
70
  standkit_hub/__init__.py
71
71
  standkit_hub/__main__.py
72
72
  standkit_hub/agent_control.py
73
+ standkit_hub/bpmkit_cookbook.py
73
74
  standkit_hub/client.py
74
75
  standkit_hub/config.py
75
76
  standkit_hub/consent_api.py
@@ -107,6 +108,7 @@ tests/test_companion_candidates.py
107
108
  tests/test_companion_context.py
108
109
  tests/test_companion_cookbook.py
109
110
  tests/test_companion_fsutil.py
111
+ tests/test_companion_installer_channel.py
110
112
  tests/test_companion_mcp_mutex.py
111
113
  tests/test_companion_patterns.py
112
114
  tests/test_companion_releases.py
@@ -114,9 +116,14 @@ tests/test_companion_revocations.py
114
116
  tests/test_companion_runner.py
115
117
  tests/test_companion_signature.py
116
118
  tests/test_conftest_state_barrier.py
119
+ tests/test_gap279_hub_install.py
117
120
  tests/test_gap411_412_415_idle_preload.py
118
121
  tests/test_gap413_414_companion_consent_logs.py
119
122
  tests/test_gap429_cookbook_installed_version.py
123
+ tests/test_gap445_hub_session_detect.py
124
+ tests/test_gap447_437_442_hub_truth.py
125
+ tests/test_gap463_requires_installer.py
126
+ tests/test_gap522_hub_help_menu.py
120
127
  tests/test_health.py
121
128
  tests/test_hosting.py
122
129
  tests/test_hub_agent_control.py
@@ -76,6 +76,34 @@ KIND_TITLES = {
76
76
  # скачает ровно тот же файл; чинится только на стороне издателя.
77
77
  "artifact_type_mismatch": ("Издатель выложил артефакт не того типа — обновление не "
78
78
  "применяется", False, True),
79
+ # GAP-463: издатель объявил версию поставленной ТОЛЬКО через установщик
80
+ # (`requires_installer` в `GET /v1/version/latest`). Канал доставляет РОВНО ОДИН
81
+ # файл — бинарь сервера; релиз, меняющий блок запуска, требования рантайма или
82
+ # состав поставки вне бинаря, тихой подменой файла доставлен быть не может. Не
83
+ # retriable: следующий тик найдёт ТОТ ЖЕ флаг у той же версии, повтор ничего не
84
+ # изменит — установщик может запустить только человек.
85
+ "requires_installer": ("Обновление ставится установщиком — тихая доставка "
86
+ "невозможна", False, True),
87
+ # ADR-0048/GAP-279: сайдкар подписи установщика несёт "kind", НЕ совпадающий с
88
+ # тем, что ожидает ЭТОТ поток (например, поток установщика получил сайдкар с
89
+ # kind="server", или наоборот). Тот же принцип, что у artifact_type_mismatch
90
+ # выше (подпись доказывает подлинность, не роль), но отдельный kind: причина
91
+ # ИНАЯ (перепутанный/подменённый канал публикации, не сборка не того типа
92
+ # файла) и заслуживает своего текста в UI/логе. Не retriable — следующий тик
93
+ # найдёт тот же сайдкар, чинится только переизданием на стороне издателя.
94
+ "artifact_kind_mismatch": ("Артефакт подписан для другой роли — не тот, что "
95
+ "ожидался этим потоком", False, True),
96
+ # ADR-0048/GAP-279: канал установщика не сконфигурирован на бэкенде ЛИБО для
97
+ # запрошенной версии установщик не опубликован (`404 installer not
98
+ # configured`). Штатный молчаливый пропуск тика — симметрично `release not
99
+ # configured` (см. докстринг модуля выше), не ошибка.
100
+ "installer_not_available": ("Установщик для этой версии не опубликован издателем",
101
+ True, False),
102
+ # GAP-279: хаб без прав администратора не может запустить установщик, которому
103
+ # они нужны (установка «для всех пользователей», WinError 740). Не retriable:
104
+ # повтор из того же процесса упрётся в то же самое; чинит человек — перезапуском
105
+ # диспетчера с правами или ручным запуском установщика.
106
+ "elevation_required": ("Установщику нужны права администратора", False, True),
79
107
  # --- транспорт ------------------------------------------------------------------
80
108
  # Адрес издателя не по `https` (и это не локальный бэкенд) — запрос НЕ уходил.
81
109
  # Не retriable: следующий тик пойдёт по тому же адресу и упрётся в то же самое,
@@ -321,6 +321,26 @@ def _write_if_changed(path: Path, text: str) -> bool:
321
321
  # --------------------------------------------------------------------------------------
322
322
  # Seed: перенос поставочного дерева в override-корень
323
323
  # --------------------------------------------------------------------------------------
324
+ def _count_shipped_patterns(shipped_root: Any) -> Optional[int]:
325
+ """Сколько файлов лежит в поставочной базе паттернов (GAP-437) — честный, но
326
+ ПРИБЛИЖЁННЫЙ счётчик: считает файлы дерева, а не «паттерны» по строгому определению
327
+ читателя (обычно это одно и то же, но не гарантия — среди файлов есть и служебные,
328
+ вроде самого индекса). `None` — корень не задан или не читается: счётчик тогда просто
329
+ НЕ показывается (см. `state.py::CompanionState.summary`), а не врёт нулём — ноль
330
+ читался бы как «поставочная база пуста», а не как «не смогли посчитать».
331
+ """
332
+ text = str(shipped_root or "").strip()
333
+ if not text:
334
+ return None
335
+ src = Path(text)
336
+ if not src.is_dir():
337
+ return None
338
+ try:
339
+ return sum(1 for item in src.rglob("*") if item.is_file())
340
+ except OSError:
341
+ return None
342
+
343
+
324
344
  def seed_override_root(shipped_root: Any, override_root: Any, *,
325
345
  force: bool = False) -> dict:
326
346
  """Скопировать поставочную базу паттернов в override-корень.
@@ -335,11 +355,18 @@ def seed_override_root(shipped_root: Any, override_root: Any, *,
335
355
  `dev/patterns_index.md`. Если он есть, повторный seed НЕ выполняется: файлы могли быть
336
356
  правлены руками, и затирать их каждым тиком нельзя. `force=True` — осознанное
337
357
  восстановление из поставки.
358
+
359
+ Ключ `shipped_count` результата (GAP-437) — размер поставочной базы, посчитанный ЗДЕСЬ
360
+ и ВСЕГДА, независимо от `skipped`: пропуск seed'а (обычный тик, индекс уже валиден) не
361
+ должен означать «размер неизвестен» — иначе состояние канала теряло бы счётчик на
362
+ каждом тике, кроме самого первого.
338
363
  """
339
364
  override = Path(override_root)
340
365
  index = override / DEV_SUBDIR / INDEX_NAME
366
+ shipped_count = _count_shipped_patterns(shipped_root)
341
367
  if index.is_file() and not force:
342
- return {"copied": 0, "skipped": True, "root": str(override)}
368
+ return {"copied": 0, "skipped": True, "root": str(override),
369
+ "shipped_count": shipped_count}
343
370
 
344
371
  copied = 0
345
372
  src = Path(shipped_root) if str(shipped_root or "").strip() else None
@@ -372,7 +399,8 @@ def seed_override_root(shipped_root: Any, override_root: Any, *,
372
399
  if not index.is_file():
373
400
  _write_text(index, _EMPTY_INDEX)
374
401
 
375
- return {"copied": copied, "skipped": False, "root": str(override)}
402
+ return {"copied": copied, "skipped": False, "root": str(override),
403
+ "shipped_count": shipped_count}
376
404
 
377
405
 
378
406
  # --------------------------------------------------------------------------------------
@@ -663,6 +691,10 @@ def sync(client: "BackendClient", state: "CompanionState", ctx: "LicenseContext"
663
691
  require_signature = bool(getattr(settings, "require_pattern_signature", False))
664
692
 
665
693
  seed = seed_override_root(shipped_root, override_root)
694
+ # GAP-437: сохраняем размер поставочной базы, только если он посчитан честно —
695
+ # `None` (корень не задан/не читается) не должен затирать ранее известное значение.
696
+ if seed.get("shipped_count") is not None:
697
+ block["shipped_count"] = seed["shipped_count"]
666
698
 
667
699
  # Курсор берём из состояния и двигаем ЛОКАЛЬНО: в состояние он попадёт только после
668
700
  # успешного прохода — иначе отброшенная по целостности страница «съела» бы дельту.