standkit 0.12.3__tar.gz → 0.12.5__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 (150) hide show
  1. {standkit-0.12.3/standkit.egg-info → standkit-0.12.5}/PKG-INFO +1 -1
  2. {standkit-0.12.3 → standkit-0.12.5}/docs/CHANGELOG.md +95 -0
  3. {standkit-0.12.3 → standkit-0.12.5}/pyproject.toml +1 -1
  4. {standkit-0.12.3 → standkit-0.12.5/standkit.egg-info}/PKG-INFO +1 -1
  5. {standkit-0.12.3 → standkit-0.12.5}/standkit.egg-info/SOURCES.txt +2 -0
  6. standkit-0.12.5/standkit_companion/candidates.py +246 -0
  7. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/runner.py +32 -2
  8. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/state.py +17 -0
  9. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/web/app.js +79 -12
  10. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/web/index.html +64 -10
  11. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/web/style.css +136 -4
  12. standkit-0.12.5/tests/test_companion_candidates.py +255 -0
  13. {standkit-0.12.3 → standkit-0.12.5}/tests/test_companion_runner.py +11 -2
  14. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_pwa_and_compact.py +102 -0
  15. {standkit-0.12.3 → standkit-0.12.5}/LICENSE +0 -0
  16. {standkit-0.12.3 → standkit-0.12.5}/MANIFEST.in +0 -0
  17. {standkit-0.12.3 → standkit-0.12.5}/README.md +0 -0
  18. {standkit-0.12.3 → standkit-0.12.5}/SECURITY.md +0 -0
  19. {standkit-0.12.3 → standkit-0.12.5}/docs/ARCHITECTURE.md +0 -0
  20. {standkit-0.12.3 → standkit-0.12.5}/docs/BACKLOG.md +0 -0
  21. {standkit-0.12.3 → standkit-0.12.5}/docs/COOKBOOK_LINUX.md +0 -0
  22. {standkit-0.12.3 → standkit-0.12.5}/docs/GAPs/GAP-001-registry-fields-out-of-hub-form.md +0 -0
  23. {standkit-0.12.3 → standkit-0.12.5}/docs/GAPs/GAP-002-http-probe-down-not-explained.md +0 -0
  24. {standkit-0.12.3 → standkit-0.12.5}/docs/GAPs/GAP-003-redis-endpoint-in-extra.md +0 -0
  25. {standkit-0.12.3 → standkit-0.12.5}/docs/GAPs/GAP-004-cookbook-hub-register-form.md +0 -0
  26. {standkit-0.12.3 → standkit-0.12.5}/docs/GAPs/GAP-005-cookbook-hub-side-secrets.md +0 -0
  27. {standkit-0.12.3 → standkit-0.12.5}/docs/GAPs/GAP-006-log-dir-case-and-separator.md +0 -0
  28. {standkit-0.12.3 → standkit-0.12.5}/docs/GAPs/GAP-007-agent-paths-raw-traceback.md +0 -0
  29. {standkit-0.12.3 → standkit-0.12.5}/docs/GAPs/GAP-008-agent-cert-trust-on-hub.md +0 -0
  30. {standkit-0.12.3 → standkit-0.12.5}/docs/GAPs/README.md +0 -0
  31. {standkit-0.12.3 → standkit-0.12.5}/docs/HOSTING.md +0 -0
  32. {standkit-0.12.3 → standkit-0.12.5}/docs/README.md +0 -0
  33. {standkit-0.12.3 → standkit-0.12.5}/docs/REMOTE_STANDS.md +0 -0
  34. {standkit-0.12.3 → standkit-0.12.5}/docs/ROADMAP.md +0 -0
  35. {standkit-0.12.3 → standkit-0.12.5}/docs/adr/0001-hosting-backends.md +0 -0
  36. {standkit-0.12.3 → standkit-0.12.5}/docs/adr/0002-k8s-backend.md +0 -0
  37. {standkit-0.12.3 → standkit-0.12.5}/docs/adr/0003-remote-log-browsing.md +0 -0
  38. {standkit-0.12.3 → standkit-0.12.5}/docs/adr/0004-iis-site-scoped-lifecycle.md +0 -0
  39. {standkit-0.12.3 → standkit-0.12.5}/docs/adr/0005-companion-transport-in-mit-core.md +0 -0
  40. {standkit-0.12.3 → standkit-0.12.5}/docs/adr/0006-hub-elevated-restart.md +0 -0
  41. {standkit-0.12.3 → standkit-0.12.5}/docs/adr/0007-hub-exit-idle-and-plain-restart.md +0 -0
  42. {standkit-0.12.3 → standkit-0.12.5}/docs/research/companion-v2-cicd-thin-agent.md +0 -0
  43. {standkit-0.12.3 → standkit-0.12.5}/projects.sample.json +0 -0
  44. {standkit-0.12.3 → standkit-0.12.5}/setup.cfg +0 -0
  45. {standkit-0.12.3 → standkit-0.12.5}/standkit/__init__.py +0 -0
  46. {standkit-0.12.3 → standkit-0.12.5}/standkit/adopt.py +0 -0
  47. {standkit-0.12.3 → standkit-0.12.5}/standkit/cli_resolve.py +0 -0
  48. {standkit-0.12.3 → standkit-0.12.5}/standkit/health.py +0 -0
  49. {standkit-0.12.3 → standkit-0.12.5}/standkit/hosting.py +0 -0
  50. {standkit-0.12.3 → standkit-0.12.5}/standkit/lifecycle.py +0 -0
  51. {standkit-0.12.3 → standkit-0.12.5}/standkit/logs.py +0 -0
  52. {standkit-0.12.3 → standkit-0.12.5}/standkit/models.py +0 -0
  53. {standkit-0.12.3 → standkit-0.12.5}/standkit/platform.py +0 -0
  54. {standkit-0.12.3 → standkit-0.12.5}/standkit/registry.py +0 -0
  55. {standkit-0.12.3 → standkit-0.12.5}/standkit/secrets.py +0 -0
  56. {standkit-0.12.3 → standkit-0.12.5}/standkit.egg-info/dependency_links.txt +0 -0
  57. {standkit-0.12.3 → standkit-0.12.5}/standkit.egg-info/entry_points.txt +0 -0
  58. {standkit-0.12.3 → standkit-0.12.5}/standkit.egg-info/requires.txt +0 -0
  59. {standkit-0.12.3 → standkit-0.12.5}/standkit.egg-info/top_level.txt +0 -0
  60. {standkit-0.12.3 → standkit-0.12.5}/standkit_agent/__init__.py +0 -0
  61. {standkit-0.12.3 → standkit-0.12.5}/standkit_agent/__main__.py +0 -0
  62. {standkit-0.12.3 → standkit-0.12.5}/standkit_agent/audit.py +0 -0
  63. {standkit-0.12.3 → standkit-0.12.5}/standkit_agent/security.py +0 -0
  64. {standkit-0.12.3 → standkit-0.12.5}/standkit_agent/server.py +0 -0
  65. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/__init__.py +0 -0
  66. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/__main__.py +0 -0
  67. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/backend.py +0 -0
  68. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/context.py +0 -0
  69. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/cookbook.py +0 -0
  70. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/ed25519.py +0 -0
  71. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/errors.py +0 -0
  72. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/fsutil.py +0 -0
  73. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/mcp_mutex.py +0 -0
  74. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/patterns.py +0 -0
  75. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/releases.py +0 -0
  76. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/revocations.py +0 -0
  77. {standkit-0.12.3 → standkit-0.12.5}/standkit_companion/signature.py +0 -0
  78. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/__init__.py +0 -0
  79. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/__main__.py +0 -0
  80. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/agent_control.py +0 -0
  81. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/assets/bpmkit-icon.ico +0 -0
  82. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/assets/icon.png +0 -0
  83. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/client.py +0 -0
  84. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/config.py +0 -0
  85. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/consent_api.py +0 -0
  86. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/elevated_op.py +0 -0
  87. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/elevation.py +0 -0
  88. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/hub_logging.py +0 -0
  89. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/instance.py +0 -0
  90. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/license_api.py +0 -0
  91. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/logs_browser.py +0 -0
  92. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/mutex.py +0 -0
  93. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/pick_dialog.py +0 -0
  94. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/poller.py +0 -0
  95. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/redis_min.py +0 -0
  96. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/security.py +0 -0
  97. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/server.py +0 -0
  98. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/shortcut.py +0 -0
  99. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/web/bpmkit-logo-dark.svg +0 -0
  100. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/web/bpmkit-logo.svg +0 -0
  101. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/web/cookbook.html +0 -0
  102. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/web/favicon.png +0 -0
  103. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/web/favicon.svg +0 -0
  104. {standkit-0.12.3 → standkit-0.12.5}/standkit_hub/web/manifest.webmanifest +0 -0
  105. {standkit-0.12.3 → standkit-0.12.5}/tests/test_adopt.py +0 -0
  106. {standkit-0.12.3 → standkit-0.12.5}/tests/test_agent_security.py +0 -0
  107. {standkit-0.12.3 → standkit-0.12.5}/tests/test_agent_server_integration.py +0 -0
  108. {standkit-0.12.3 → standkit-0.12.5}/tests/test_agent_startup_preflight.py +0 -0
  109. {standkit-0.12.3 → standkit-0.12.5}/tests/test_companion_backend.py +0 -0
  110. {standkit-0.12.3 → standkit-0.12.5}/tests/test_companion_context.py +0 -0
  111. {standkit-0.12.3 → standkit-0.12.5}/tests/test_companion_cookbook.py +0 -0
  112. {standkit-0.12.3 → standkit-0.12.5}/tests/test_companion_fsutil.py +0 -0
  113. {standkit-0.12.3 → standkit-0.12.5}/tests/test_companion_mcp_mutex.py +0 -0
  114. {standkit-0.12.3 → standkit-0.12.5}/tests/test_companion_patterns.py +0 -0
  115. {standkit-0.12.3 → standkit-0.12.5}/tests/test_companion_releases.py +0 -0
  116. {standkit-0.12.3 → standkit-0.12.5}/tests/test_companion_revocations.py +0 -0
  117. {standkit-0.12.3 → standkit-0.12.5}/tests/test_companion_signature.py +0 -0
  118. {standkit-0.12.3 → standkit-0.12.5}/tests/test_health.py +0 -0
  119. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hosting.py +0 -0
  120. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_agent_control.py +0 -0
  121. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_client_tls.py +0 -0
  122. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_companion_api.py +0 -0
  123. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_config.py +0 -0
  124. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_consent_api.py +0 -0
  125. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_elevated_op.py +0 -0
  126. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_elevation.py +0 -0
  127. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_elevation_ui.py +0 -0
  128. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_exit_idle_restart.py +0 -0
  129. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_fast_paint.py +0 -0
  130. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_instance.py +0 -0
  131. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_license_api.py +0 -0
  132. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_logging.py +0 -0
  133. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_logs_browser.py +0 -0
  134. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_main_elevated.py +0 -0
  135. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_mutex.py +0 -0
  136. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_pick_dialog.py +0 -0
  137. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_redis_min.py +0 -0
  138. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_register.py +0 -0
  139. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_server.py +0 -0
  140. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_settings_field_help.py +0 -0
  141. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_shortcut.py +0 -0
  142. {standkit-0.12.3 → standkit-0.12.5}/tests/test_hub_single_instance.py +0 -0
  143. {standkit-0.12.3 → standkit-0.12.5}/tests/test_lifecycle.py +0 -0
  144. {standkit-0.12.3 → standkit-0.12.5}/tests/test_logs.py +0 -0
  145. {standkit-0.12.3 → standkit-0.12.5}/tests/test_models.py +0 -0
  146. {standkit-0.12.3 → standkit-0.12.5}/tests/test_no_window.py +0 -0
  147. {standkit-0.12.3 → standkit-0.12.5}/tests/test_platform_sid.py +0 -0
  148. {standkit-0.12.3 → standkit-0.12.5}/tests/test_registry.py +0 -0
  149. {standkit-0.12.3 → standkit-0.12.5}/tests/test_registry_resolver.py +0 -0
  150. {standkit-0.12.3 → standkit-0.12.5}/tests/test_secrets.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: standkit
3
- Version: 0.12.3
3
+ Version: 0.12.5
4
4
  Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
5
5
  Author: standkit contributors
6
6
  License-Expression: MIT
@@ -5,6 +5,101 @@
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [0.12.5] — 2026-09-19
9
+
10
+ ### Добавлено
11
+
12
+ - **Обратный проход канала: находки уезжают вендору сами (GAP-260, GAP-248 п.2).**
13
+ Канал Companion работал только НА ПРИЁМ (паттерны, релизы, отзывы, кукбук).
14
+ Локально накопленные находки — очередь `~/.bpmkit/outbox/`, которую пополняют
15
+ `session_note` и `pattern_submit(submit=True)`, — не уезжали НИКОГДА, пока
16
+ пользователь не вызывал `feedback_flush(confirm=True)` руками. Очередь
17
+ сабмишенов у издателя пуста не потому, что нечего слать, а потому что путь
18
+ непроходим для обычного пользователя; при этом ежедневный триаж рассчитан на
19
+ эту очередь как на источник.
20
+
21
+ Новый модуль `standkit_companion/candidates.py` едет **попутчиком** обычного
22
+ тика — ровно как кукбук (GAP-361) и по той же причине: у очереди нет
23
+ собственного расписания, отдельный цикл означал бы ещё один тик, ещё одну
24
+ строку в UI и ещё один повод разбудить машину ради очереди, которая чаще
25
+ всего пуста. Свой слот состояния `state.candidates` и своя строка исхода:
26
+ мешать его в `patterns` значило бы объявлять неудачей синхронизацию
27
+ паттернов из-за того, что находки не уехали.
28
+
29
+ **Очередь читается не отсюда.** Каталог известен и формат JSON, но у очереди
30
+ есть правила, которые пришлось бы повторить: два подкаталога с разными
31
+ капами, счётчик `attempts` с атомарной перезаписью, перенос в `dead/` после
32
+ N отказов, маскирование улик, гейты согласия и генерализации. Вторая копия
33
+ этой логики в другом репозитории разъехалась бы на первом изменении формата
34
+ — и разъехалась бы молча, теряя или дублируя находки. Поэтому Companion
35
+ просит разгрузить очередь ту поставку, которой она принадлежит:
36
+ `bpmkit setup outbox-flush` (новая подкоманда MCP), ровно так же, как зовёт
37
+ `companion-context`.
38
+
39
+ **Офлайн, квота и отсутствие лицензии — не ошибка по построению** (дословное
40
+ требование строки GAP-260): системный отказ транспорта (`offline`,
41
+ `rate_limited`, `no_license`, `feature_disabled`, `insecure_transport`)
42
+ помечается как `skipped`, а не `error`. Красный цикл, который чинится сам
43
+ при следующем тике, обесценивает индикацию. Отправленное до остановки при
44
+ этом считается отправленным и попадает в отчёт.
45
+
46
+ **Согласие не спрашивается здесь и не может быть обойдено отсюда.** Флаги
47
+ `analytics` / `pattern_submission` / `candidate_submission` независимы
48
+ (ADR-0024) и проверяются транспортом на стороне MCP; Companion о них не
49
+ знает и не вправе знать.
50
+
51
+ Парная половина — подкоманда `setup outbox-flush` в поставке MCP
52
+ (dev-репо): она и есть тот триггер, которого не хватало GAP-248 п.2.
53
+
54
+ ## [0.12.4] — 2026-09-19
55
+
56
+ ### Изменено
57
+
58
+ - **Визуальные дефекты диспетчера (GAP-278).** Замечания владельца 11.09.2026
59
+ по скриншотам 0.10.0.
60
+
61
+ - **Шапка (п.1).** Стоял `favicon.svg` — значок «k» 28×28, тот же файл, что
62
+ во вкладке браузера: продукт представлялся обрезанным значком. Теперь
63
+ полный логотип `bpmkit-logo.svg` / `bpmkit-logo-dark.svg`, переключение по
64
+ теме — теми же CSS-правилами, что у логотипа в «О программе» (`.about-logo-*`),
65
+ без скрипта: при смене темы не должно быть кадра со «старой» картинкой.
66
+ Между брендом и названием раздела — тонкий разделитель: «BPMkit» это
67
+ продукт, «Диспетчер стендов» — его раздел, и раньше они читались одной
68
+ слипшейся строкой. В компактном окне логотип уменьшается, а не подменяется
69
+ значком.
70
+ - **Кнопки над таблицей (п.2).** «Обновить» и «Зарегистрировать стенд» были
71
+ отдельной строкой над таблицей и ни с чем не связаны, а «Обновить»
72
+ создавала впечатление, что список сам не обновляется (хотя поллер работает
73
+ по `refresh_interval_sec`). Теперь это **строка заголовка таблицы**: слева
74
+ «Стенды · N», справа — возраст данных, ручное обновление иконкой ↻ и
75
+ основная кнопка «+ Стенд». Возраст снапшота показывается **всегда**
76
+ («обновлено N назад»), а не только при устаревании вдвое: именно отсутствие
77
+ любого признака автообновления и делало кнопку «Обновить» единственным
78
+ видимым способом получить свежие данные. Ручное обновление при этом
79
+ осталось — дождаться следующего тика не всегда приемлемо.
80
+ - **Пустой реестр (п.2).** Показывалась пустая таблица с шапкой колонок —
81
+ экран, на котором нечего делать и непонятно, что делать дальше. Теперь
82
+ крупное «+ Зарегистрировать первый стенд» с объяснением, что диспетчер
83
+ подключает уже установленные стенды, а не создаёт их.
84
+ - **«О программе» (п.3).** Строка «Редакция: с каналом обновлений» — прямой
85
+ перевод внутреннего `edition=companion`, который пользователю ничего не
86
+ говорит. Заменена на «Обновления: подключены / не подключены — <причина>»
87
+ со ссылкой в раздел «Лицензия», когда причина в ней. Текст собирается из
88
+ ДВУХ источников (`/api/version` знает редакцию сборки, `/api/license` —
89
+ состояние лицензии), которые приходят в разное время, поэтому функция
90
+ зовётся из обоих мест и каждый раз берёт то, что уже известно — иначе более
91
+ поздний ответ затирал бы более точный текст более общим.
92
+
93
+ Вторая половина п.3 (версия MCP вместо заглушки «как в поставке») закрыта
94
+ раньше работой GAP-311: `renderMcpVersion` берёт версию из CLI поставки и при
95
+ неудаче честно говорит «неизвестна», в том числе с уточнением «не найден CLI
96
+ BPMkit». Здесь не дублируется.
97
+
98
+ Приёмка гэпа визуальная (скриншоты в светлой и тёмной теме, компактное окно и
99
+ ноутбучный экран) — её тестом не заменить; но элементы, отсутствие которых и
100
+ было жалобой, закреплены статическими проверками разметки, чтобы правка не
101
+ откатилась молча (`tests/test_hub_pwa_and_compact.py`).
102
+
8
103
  ## [0.12.3] — 2026-09-19
9
104
 
10
105
  ### Добавлено
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "standkit"
7
- version = "0.12.3"
7
+ version = "0.12.5"
8
8
  description = "Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit."
9
9
  readme = "README.md"
10
10
  license = "MIT"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: standkit
3
- Version: 0.12.3
3
+ Version: 0.12.5
4
4
  Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
5
5
  Author: standkit contributors
6
6
  License-Expression: MIT
@@ -54,6 +54,7 @@ standkit_agent/server.py
54
54
  standkit_companion/__init__.py
55
55
  standkit_companion/__main__.py
56
56
  standkit_companion/backend.py
57
+ standkit_companion/candidates.py
57
58
  standkit_companion/context.py
58
59
  standkit_companion/cookbook.py
59
60
  standkit_companion/ed25519.py
@@ -101,6 +102,7 @@ tests/test_agent_security.py
101
102
  tests/test_agent_server_integration.py
102
103
  tests/test_agent_startup_preflight.py
103
104
  tests/test_companion_backend.py
105
+ tests/test_companion_candidates.py
104
106
  tests/test_companion_context.py
105
107
  tests/test_companion_cookbook.py
106
108
  tests/test_companion_fsutil.py
@@ -0,0 +1,246 @@
1
+ # -*- coding: utf-8 -*-
2
+ """Обратный проход канала: разгрузка локальной очереди находок вендору
3
+ (GAP-260, GAP-248 п.2) — попутчик обычного тика, рядом с кукбуком.
4
+
5
+ **Что здесь чинится.** Канал Companion до сих пор работал только НА ПРИЁМ:
6
+ тянул паттерны, релизы, отзывы и кукбук. Локально накопленные находки
7
+ (`~/.bpmkit/outbox/` — письма обратной связи и кандидаты паттернов, которые
8
+ пишут `session_note`/`pattern_submit(submit=True)`) не уезжали НИКОГДА, пока
9
+ пользователь не вызывал `feedback_flush(confirm=True)` руками. Очередь на
10
+ бэкенде пуста не потому, что нечего слать, а потому что путь непроходим для
11
+ обычного пользователя (GAP-248) — при этом ежедневный триаж издателя
12
+ рассчитан на эту очередь как на источник.
13
+
14
+ **Почему мы НЕ читаем `~/.bpmkit/outbox/` сами.** Соблазн очевиден: каталог
15
+ известен, формат — JSON. Но очередь принадлежит MCP, и у неё есть правила,
16
+ которые здесь пришлось бы повторить: два подкаталога с разными капами,
17
+ счётчик `attempts` с атомарной перезаписью, перенос в `dead/` после N
18
+ отказов, маскирование улик, гейты согласия и генерализации, формат письма.
19
+ Вторая копия этой логики в другом репозитории разъедется на первом же
20
+ изменении формата, и разъедется молча — находки начнут теряться или
21
+ дублироваться. Поэтому Companion зовёт ту же поставку, которой очередь и
22
+ принадлежит: `bpmkit setup outbox-flush`, ровно так же, как зовёт
23
+ `companion-context`. Транспорт (`feedback.flush_outbox`) уже существует,
24
+ отлажен и НИКОГДА не теряет файл — ему нужен был только тот, кто его
25
+ запускает.
26
+
27
+ **Офлайн, квота и отсутствие лицензии — не ошибка по построению.** Требование
28
+ строки GAP-260 дословно. `flush_outbox` возвращает системный отказ полем
29
+ `stopped_reason` (`offline` / `rate_limited` / `no_license` /
30
+ `feature_disabled` / `insecure_transport`) и не бросает исключений: «сейчас не
31
+ уехало» — штатный исход фонового прохода. Такой исход помечается в состоянии
32
+ как `skipped`, а не `error`: красный цикл, который чинится сам при следующем
33
+ тике, обесценивает индикацию.
34
+
35
+ **Согласие не спрашивается здесь и не может быть обойдено отсюда.** Флаги
36
+ (`analytics` / `pattern_submission` / `candidate_submission`) независимы
37
+ (ADR-0024) и проверяются транспортом на стороне MCP. Companion не знает о них
38
+ ничего и не вправе знать: единственный способ отправить что-либо отсюда —
39
+ попросить поставку разгрузить очередь, а она откажет сама, если согласия нет.
40
+ """
41
+ from __future__ import annotations
42
+
43
+ import json
44
+ from typing import Callable, Optional
45
+
46
+ from standkit.platform import run_console
47
+
48
+ from .context import find_cli
49
+ from .errors import ChannelError
50
+ from .state import utc_now_iso
51
+
52
+ __all__ = [
53
+ "FLUSH_ARGV_TAIL",
54
+ "SYSTEM_STOP_REASONS",
55
+ "flush",
56
+ ]
57
+
58
+ #: Хвост командной строки поставки. Тот же приём, что `CONTEXT_ARGV_TAIL` у
59
+ #: лицензионного контекста: подкоманда фиксирована здесь, а не собирается по
60
+ #: месту вызова.
61
+ FLUSH_ARGV_TAIL = ("setup", "outbox-flush", "--json")
62
+
63
+ #: Системные причины остановки прохода — это «сейчас не уехало», а не поломка.
64
+ #: Список ДОСЛОВНО повторяет контракт `feedback._flush_pass`; незнакомое
65
+ #: значение сюда не попадает и честно трактуется как ошибка.
66
+ SYSTEM_STOP_REASONS = frozenset({
67
+ "offline",
68
+ "rate_limited",
69
+ "no_license",
70
+ "feature_disabled",
71
+ "insecure_transport",
72
+ })
73
+
74
+ #: Потолок ожидания. Проход идёт по письмам ПО ОДНОМУ с коротким сетевым
75
+ #: таймаутом на каждое, поэтому здесь не «сколько угодно»: попутчик не имеет
76
+ #: права держать тик канала дольше, чем несущая операция.
77
+ FLUSH_TIMEOUT_S = 120
78
+
79
+ #: Максимум записей за проход КАЖДОГО типа. Ограничение осознанное: фоновый
80
+ #: проход не должен превращаться в многоминутную выгрузку накопленного за
81
+ #: месяц — остаток уедет следующим тиком, очередь никуда не денется.
82
+ DEFAULT_LIMIT = 25
83
+
84
+ _DETAIL_LIMIT = 400
85
+
86
+
87
+ def _clip(text: str, limit: int = _DETAIL_LIMIT) -> str:
88
+ text = str(text or "").strip()
89
+ return text if len(text) <= limit else text[: limit - 1] + "…"
90
+
91
+
92
+ def _default_run(argv: list) -> tuple:
93
+ """Запуск поставки через ЕДИНУЮ точку `standkit.platform.run_console` —
94
+ той же формы, что `context._default_run`.
95
+
96
+ Прямой `subprocess.run` здесь ЗАПРЕЩЁН (GAP-138): канал тикает из процесса
97
+ без своей консоли, и каждый тик мигал бы чёрным окном — ровно тот дефект,
98
+ из-за которого у владельца раз в ~12 с всплывали окна поллера. Любое
99
+ исключение (нет файла, таймаут, отказ в доступе) превращается в `rc=-1`:
100
+ вызывающий разбирает ОДИН вид отказа, а не зоопарк исключений
101
+ `subprocess`.
102
+ """
103
+ try:
104
+ proc = run_console(list(argv), capture_output=True, text=True,
105
+ encoding="utf-8", errors="replace",
106
+ timeout=FLUSH_TIMEOUT_S)
107
+ except Exception as exc: # noqa: BLE001 - см. докстринг: один вид отказа наружу
108
+ return -1, "", str(exc)
109
+ rc = proc.returncode if proc.returncode is not None else -1
110
+ return int(rc), proc.stdout or "", proc.stderr or ""
111
+
112
+
113
+ def _parse_stdout(stdout: str) -> dict:
114
+ """Единственная строка JSON из вывода подкоманды.
115
+
116
+ Читается ПОСЛЕДНЯЯ непустая строка, а не весь вывод: поставка может
117
+ напечатать перед ответом предупреждение (например, о нерезолвнутом
118
+ корне пакета), и жёсткий `json.loads(stdout)` ломался бы об него.
119
+ """
120
+ for line in reversed([ln for ln in (stdout or "").splitlines() if ln.strip()]):
121
+ try:
122
+ payload = json.loads(line)
123
+ except ValueError:
124
+ continue
125
+ if isinstance(payload, dict):
126
+ return payload
127
+ raise ChannelError(
128
+ "Ответ подкоманды разгрузки очереди не разобран как JSON — очередь не тронута",
129
+ kind="bad_response",
130
+ detail=_clip(stdout),
131
+ )
132
+
133
+
134
+ def flush(state, settings, *, run: Optional[Callable] = None,
135
+ limit: Optional[int] = DEFAULT_LIMIT) -> dict:
136
+ """Один обратный проход: попросить поставку разгрузить очередь.
137
+
138
+ Возвращает словарь исхода (в состояние он же и оседает); исключение
139
+ наружу не поднимается НИКОГДА, кроме неразобранного ответа — вызывающий
140
+ (`runner._sync_candidates`) ловит и это, но попутчик обязан быть
141
+ безопасным сам по себе.
142
+ """
143
+ block = state.data.setdefault("candidates", {})
144
+ runner = run or _default_run
145
+
146
+ cli = find_cli(settings)
147
+ if not cli:
148
+ # CLI поставки не найден — это НЕ отказ канала: точно так же
149
+ # ведёт себя лицензионный контекст (GAP-273), и чинит это человек
150
+ # в настройках хаба.
151
+ block["last_sync_at"] = utc_now_iso()
152
+ state.mark("candidates", "skipped",
153
+ "CLI BPMkit не найден — очередь находок не разгружалась")
154
+ state.save()
155
+ return {"flushed": False, "reason": "cli_not_found",
156
+ "sent": 0, "failed": 0, "remaining": None}
157
+
158
+ argv = list(cli) + list(FLUSH_ARGV_TAIL)
159
+ if limit is not None:
160
+ argv += ["--limit", str(int(limit))]
161
+
162
+ # `_default_run` не выпускает исключений наружу (таймаут/нет файла → rc=-1),
163
+ # но двойник в тестах вправе бросить — попутчик обязан пережить и это.
164
+ try:
165
+ rc, stdout, stderr = runner(argv)
166
+ except Exception as exc: # noqa: BLE001
167
+ block["last_sync_at"] = utc_now_iso()
168
+ state.mark("candidates", "error", f"CLI BPMkit не запустился: {_clip(str(exc))}")
169
+ state.save()
170
+ return {"flushed": False, "reason": "spawn_error",
171
+ "sent": 0, "failed": 0, "remaining": None}
172
+
173
+ if rc != 0:
174
+ block["last_sync_at"] = utc_now_iso()
175
+ detail = _clip(stderr) or f"код возврата {rc}"
176
+ state.mark("candidates", "error", f"разгрузка очереди отказала: {detail}")
177
+ state.save()
178
+ return {"flushed": False, "reason": "cli_error", "detail": detail,
179
+ "sent": 0, "failed": 0, "remaining": None}
180
+
181
+ payload = _parse_stdout(stdout)
182
+
183
+ if not payload.get("ok"):
184
+ block["last_sync_at"] = utc_now_iso()
185
+ detail = _clip(payload.get("detail") or payload.get("reason") or "без пояснений")
186
+ state.mark("candidates", "error", f"очередь не разгружена: {detail}")
187
+ state.save()
188
+ return {"flushed": False, "reason": payload.get("reason") or "refused",
189
+ "detail": detail, "sent": 0, "failed": 0, "remaining": None}
190
+
191
+ sent = int(payload.get("sent") or 0)
192
+ failed = int(payload.get("failed") or 0)
193
+ remaining = payload.get("remaining")
194
+ stopped = payload.get("stopped_reason") or None
195
+
196
+ block["last_sync_at"] = utc_now_iso()
197
+ block["last_sent"] = sent
198
+ block["last_remaining"] = remaining
199
+
200
+ if stopped in SYSTEM_STOP_REASONS:
201
+ # Ровно требование строки GAP-260: офлайн/квота/нет лицензии не
202
+ # должны быть ошибкой ПО ПОСТРОЕНИЮ. Отправленное до остановки при
203
+ # этом отправлено — об этом и говорим.
204
+ state.mark("candidates", "skipped", _stop_text(stopped, sent, remaining))
205
+ state.save()
206
+ return {"flushed": sent > 0, "reason": stopped, "sent": sent,
207
+ "failed": failed, "remaining": remaining}
208
+
209
+ if stopped:
210
+ state.mark("candidates", "error",
211
+ f"проход очереди остановлен: {_clip(stopped)}")
212
+ state.save()
213
+ return {"flushed": sent > 0, "reason": stopped, "sent": sent,
214
+ "failed": failed, "remaining": remaining}
215
+
216
+ state.mark("candidates", "ok", _ok_text(sent, failed, remaining))
217
+ state.save()
218
+ return {"flushed": sent > 0, "reason": "flushed", "sent": sent,
219
+ "failed": failed, "remaining": remaining}
220
+
221
+
222
+ def _stop_text(reason: str, sent: int, remaining) -> str:
223
+ """Человеческий текст системного отказа — его увидит пользователь в UI."""
224
+ texts = {
225
+ "offline": "нет связи с сервисом издателя",
226
+ "rate_limited": "суточная квота приёмника исчерпана",
227
+ "no_license": "нет лицензии — отправка не выполняется",
228
+ "feature_disabled": "издатель временно не принимает этот тип находок",
229
+ "insecure_transport": "адрес сервиса издателя запрещён политикой транспорта",
230
+ }
231
+ head = texts.get(reason, reason)
232
+ if sent:
233
+ return f"Отправлено находок: {sent}; дальше — {head}"
234
+ left = f", в очереди {remaining}" if isinstance(remaining, int) and remaining else ""
235
+ return f"Находки не отправлены: {head}{left}"
236
+
237
+
238
+ def _ok_text(sent: int, failed: int, remaining) -> str:
239
+ if not sent and not failed:
240
+ return "Очередь находок пуста — отправлять нечего"
241
+ parts = [f"Отправлено находок: {sent}"]
242
+ if failed:
243
+ parts.append(f"отклонено: {failed}")
244
+ if isinstance(remaining, int) and remaining:
245
+ parts.append(f"в очереди: {remaining}")
246
+ return "; ".join(parts)
@@ -54,7 +54,7 @@ from dataclasses import dataclass
54
54
  from pathlib import Path
55
55
  from typing import Callable, Optional
56
56
 
57
- from . import __version__, context, cookbook, patterns, releases, revocations
57
+ from . import __version__, candidates, context, cookbook, patterns, releases, revocations
58
58
  from .backend import BackendClient
59
59
  from .errors import ChannelError, CompanionError, ContextUnavailable, NotModified
60
60
  from .state import STATE_FILE_NAME, CompanionState
@@ -438,10 +438,39 @@ class CompanionRunner:
438
438
  self._state.save()
439
439
  return {"applied": False, "reason": "error", "detail": str(exc)}
440
440
 
441
+ def _sync_candidates(self, settings) -> Optional[dict]:
442
+ """Обратный проход: разгрузка локальной очереди находок вендору
443
+ (GAP-260, GAP-248 п.2 «автоматический flush очереди сабмишенов»).
444
+
445
+ Тем же попутчиком, что кукбук, и по той же причине: у очереди нет
446
+ собственного расписания, она едет на уже состоявшемся пробуждении
447
+ канала. Отдельный цикл означал бы ещё один тик, ещё одну строку в UI и
448
+ ещё один повод разбудить машину — ради очереди, которая чаще всего
449
+ пуста.
450
+
451
+ Направление при этом ПРОТИВОПОЛОЖНОЕ всему остальному каналу, и это
452
+ единственное место, где Companion что-то ОТПРАВЛЯЕТ. Сеть трогает не
453
+ он: он просит поставку (`bpmkit setup outbox-flush`) разгрузить
454
+ очередь, которой она владеет, — см. докстринг `candidates.py`, почему
455
+ читать `~/.bpmkit/outbox/` отсюда своими руками нельзя.
456
+
457
+ Отказ здесь НЕ роняет несущую операцию — ровно как у кукбука: не
458
+ уехали находки — не повод объявить неудачей синхронизацию паттернов
459
+ или проверку релиза, которые уже отработали.
460
+ """
461
+ try:
462
+ return candidates.flush(self._state, settings)
463
+ except Exception as exc: # noqa: BLE001
464
+ # Широко и сознательно, по той же причине, что в `_sync_cookbook`.
465
+ self._state.mark("candidates", "error", str(exc))
466
+ self._save_state()
467
+ return {"flushed": False, "reason": "error", "detail": str(exc)}
468
+
441
469
  def _run_patterns(self, session, settings) -> dict:
442
470
  result = patterns.sync(session.client, self._state, session.ctx, settings)
443
471
  if isinstance(result, dict):
444
472
  result["cookbook"] = self._sync_cookbook(session)
473
+ result["candidates"] = self._sync_candidates(settings)
445
474
  return result
446
475
 
447
476
  def _run_releases(self, session, settings) -> dict:
@@ -460,7 +489,8 @@ class CompanionRunner:
460
489
  staged = releases.stage(session.client, self._state, session.ctx,
461
490
  check.get("target") or "latest")
462
491
  return {"check": check, "staged": staged,
463
- "cookbook": self._sync_cookbook(session)}
492
+ "cookbook": self._sync_cookbook(session),
493
+ "candidates": self._sync_candidates(settings)}
464
494
 
465
495
  def _run_revocations(self, session, settings) -> dict:
466
496
  return revocations.refresh(session.client, self._state, session.ctx)
@@ -94,6 +94,19 @@ def _default_state() -> dict:
94
94
  "last_sync_at": None,
95
95
  "installed": None,
96
96
  },
97
+ # Обратный проход канала (GAP-260/GAP-248 п.2): единственный поток,
98
+ # который не ПРИНИМАЕТ, а ОТДАЁТ. Свой слот по той же причине, что у
99
+ # кукбука: у него свой исход («офлайн» здесь — норма, а не ошибка) и
100
+ # своя строка в UI; мешать его в `patterns` значило бы объявлять
101
+ # неудачей синхронизацию паттернов из-за того, что очередь не уехала.
102
+ "candidates": {
103
+ "last_check_at": None,
104
+ "last_status": "never",
105
+ "last_detail": "",
106
+ "last_sync_at": None,
107
+ "last_sent": None,
108
+ "last_remaining": None,
109
+ },
97
110
  "revocations": {
98
111
  "last_check_at": None,
99
112
  "last_status": "never",
@@ -189,6 +202,10 @@ class CompanionState:
189
202
  def cookbook(self) -> dict:
190
203
  return self.data["cookbook"]
191
204
 
205
+ @property
206
+ def candidates(self) -> dict:
207
+ return self.data["candidates"]
208
+
192
209
  def mark(self, section: str, status: str, detail: str = "") -> None:
193
210
  """Единая точка записи исхода тика. `status` — `ok`/`skipped`/`error`/`never`."""
194
211
  block = self.data[section]
@@ -373,11 +373,12 @@
373
373
  const data = await apiGet("/api/version");
374
374
  hubVersion = data.version || "";
375
375
  el.textContent = hubVersion ? `BPMkitStand ${hubVersion}` : "н/д";
376
- const edition = document.getElementById("about-edition");
377
- if (edition) {
378
- edition.textContent =
379
- data.edition === "companion" ? "с каналом обновлений" : "свободная";
380
- }
376
+ // GAP-278 п.3: «Редакция: с каналом обновлений» — перевод внутреннего
377
+ // edition=companion. Пользователь спрашивает не про редакцию, а про то,
378
+ // будут ли приходить обновления и что делать, если нет; ссылка ведёт
379
+ // ровно туда, где это чинится. Настоящий статус канала (лицензия
380
+ // истекла/отозвана) приходит отдельным снимком — см. renderAboutUpdates.
381
+ renderAboutUpdates(data.edition);
381
382
  checkVersionSkew(hubVersion);
382
383
  } catch (e) {
383
384
  el.textContent = `ошибка: ${describeApiError(e)}`;
@@ -595,6 +596,17 @@
595
596
  document.getElementById("iis-detect-btn").addEventListener("click", () => detectIisSite(form));
596
597
 
597
598
  document.getElementById("register-stand-btn").addEventListener("click", openRegisterModal);
599
+ // Та же форма, что и по «+ Стенд»: приглашение на пустом реестре —
600
+ // второй вход в то же действие, а не отдельный сценарий (GAP-278 п.2).
601
+ const firstStandBtn = document.getElementById("register-first-stand-btn");
602
+ if (firstStandBtn) firstStandBtn.addEventListener("click", openRegisterModal);
603
+ const aboutLicenseLink = document.getElementById("about-license-link");
604
+ if (aboutLicenseLink) {
605
+ aboutLicenseLink.addEventListener("click", (evt) => {
606
+ evt.preventDefault();
607
+ selectSettingsPane("license");
608
+ });
609
+ }
598
610
  document.getElementById("register-modal-close-btn").addEventListener("click", closeRegisterModal);
599
611
  document.getElementById("register-modal-cancel-btn").addEventListener("click", closeRegisterModal);
600
612
  bindOverlayDismiss(overlay, closeRegisterModal);
@@ -1177,19 +1189,18 @@
1177
1189
  async function refreshStandsWithFeedback() {
1178
1190
  const btn = document.getElementById("refresh-stands-btn");
1179
1191
  if (btn.disabled) return;
1180
- const orig = btn.dataset.label || btn.textContent;
1181
- btn.dataset.label = orig;
1192
+ // Кнопка стала иконочной (GAP-278 п.2), поэтому занятость показывается
1193
+ // классом-вращением, а не подменой текста: писать «Обновление…» внутри
1194
+ // кнопки 28×28 некуда.
1182
1195
  const startedAt = Date.now();
1183
1196
  btn.disabled = true;
1184
1197
  btn.classList.add("is-busy");
1185
- btn.textContent = "Обновление…";
1186
1198
  let ok = false;
1187
1199
  try {
1188
1200
  ok = await refreshStands();
1189
1201
  } finally {
1190
1202
  const elapsed = Date.now() - startedAt;
1191
1203
  if (elapsed < MIN_BUSY_MS) await sleep(MIN_BUSY_MS - elapsed);
1192
- btn.textContent = orig;
1193
1204
  btn.classList.remove("is-busy");
1194
1205
  btn.disabled = false;
1195
1206
  }
@@ -1204,6 +1215,15 @@
1204
1215
  function renderStands(stands) {
1205
1216
  const tbody = document.getElementById("stands-tbody");
1206
1217
  tbody.innerHTML = "";
1218
+
1219
+ // GAP-278 п.2: счётчик в заголовке таблицы и крупное приглашение вместо
1220
+ // пустой таблицы с шапкой колонок.
1221
+ const count = document.getElementById("stands-count");
1222
+ if (count) count.textContent = stands.length ? ` · ${stands.length}` : "";
1223
+ const empty = document.getElementById("stands-empty");
1224
+ const table = document.querySelector(".stands-table");
1225
+ if (empty) empty.hidden = stands.length > 0;
1226
+ if (table) table.hidden = stands.length === 0;
1207
1227
  stands.forEach((s) => {
1208
1228
  const http = s.http || {};
1209
1229
  const redis = s.redis || {};
@@ -1579,13 +1599,22 @@
1579
1599
  return;
1580
1600
  }
1581
1601
  const age = data ? Number(data.age_sec) : NaN;
1582
- if (!Number.isFinite(age) || age <= (refreshIntervalMs / 1000) * 2) {
1602
+ if (!Number.isFinite(age)) {
1583
1603
  el.textContent = "";
1584
1604
  el.title = "";
1605
+ el.classList.remove("stands-age-stale");
1585
1606
  return;
1586
1607
  }
1587
- el.textContent = `данные от ${formatAge(age)} назад`;
1588
- el.title = "Фоновый опрос давно не обновлял снапшот состояния стендов";
1608
+ // GAP-278 п.2: раньше строка молчала, пока данные не устареют вдвое, и
1609
+ // пользователь не видел НИКАКОГО признака, что список обновляется сам, —
1610
+ // отсюда и впечатление, что без кнопки «Обновить» таблица мёртвая.
1611
+ // Теперь возраст показывается всегда; «устарело» лишь подсвечивается.
1612
+ const stale = age > (refreshIntervalMs / 1000) * 2;
1613
+ el.textContent = `обновлено ${formatAge(age)} назад`;
1614
+ el.title = stale
1615
+ ? "Фоновый опрос давно не обновлял снапшот состояния стендов"
1616
+ : "Список обновляется автоматически";
1617
+ el.classList.toggle("stands-age-stale", stale);
1589
1618
  }
1590
1619
 
1591
1620
  // --- поток обновлений (SSE) ---
@@ -2788,6 +2817,43 @@
2788
2817
  : "Сейчас: CLI не найден";
2789
2818
  }
2790
2819
 
2820
+ // «Обновления: подключены / не подключены — нет лицензии» (GAP-278 п.3).
2821
+ //
2822
+ // Источников два, и они приходят В РАЗНОЕ ВРЕМЯ: /api/version знает редакцию
2823
+ // сборки, /api/license — состояние лицензии. Поэтому функция зовётся из
2824
+ // обоих мест и каждый раз берёт то, что уже известно: иначе более поздний
2825
+ // ответ затирал бы более точный текст более общим.
2826
+ let lastEdition = null;
2827
+
2828
+ function renderAboutUpdates(edition) {
2829
+ if (edition !== undefined && edition !== null) lastEdition = edition;
2830
+ const el = byId("about-edition");
2831
+ const link = byId("about-license-link");
2832
+ if (!el) return;
2833
+
2834
+ if (lastEdition === null) {
2835
+ el.textContent = "—";
2836
+ if (link) link.hidden = true;
2837
+ return;
2838
+ }
2839
+ if (lastEdition !== "companion") {
2840
+ // Сборка без канала обновлений: лицензия тут ни при чём, и ссылка на
2841
+ // неё была бы ложным следом.
2842
+ el.textContent = "не подключены — сборка без канала обновлений";
2843
+ if (link) link.hidden = true;
2844
+ return;
2845
+ }
2846
+ const lic = lastLicense || {};
2847
+ const connected =
2848
+ LICENSE_CHANNEL_STATUSES.indexOf(lic.status) >= 0;
2849
+ el.textContent = connected
2850
+ ? "подключены"
2851
+ : lic.status
2852
+ ? `не подключены — лицензия ${(LICENSE_STATE_LABELS[lic.status] || [lic.status])[0]}`
2853
+ : "не подключены — нет лицензии";
2854
+ if (link) link.hidden = connected;
2855
+ }
2856
+
2791
2857
  // Единственный источник правды для фактической версии MCP — читают и экран
2792
2858
  // лицензии (renderMcpRow не звонит до первого ответа канала обновлений, а
2793
2859
  // /api/license отвечает и в свободной редакции), и статус канала. Приоритет
@@ -2841,6 +2907,7 @@
2841
2907
  renderLicenseStatusline(snapshot);
2842
2908
  renderCliHint(snapshot);
2843
2909
  renderMcpVersion();
2910
+ renderAboutUpdates();
2844
2911
  maybeShowLicenseCritModal(snapshot);
2845
2912
  }
2846
2913