standkit 0.12.5__tar.gz → 0.12.8__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 (156) hide show
  1. {standkit-0.12.5/standkit.egg-info → standkit-0.12.8}/PKG-INFO +1 -1
  2. {standkit-0.12.5 → standkit-0.12.8}/docs/CHANGELOG.md +149 -0
  3. {standkit-0.12.5 → standkit-0.12.8}/pyproject.toml +1 -1
  4. {standkit-0.12.5 → standkit-0.12.8}/standkit/__init__.py +1 -1
  5. {standkit-0.12.5 → standkit-0.12.8/standkit.egg-info}/PKG-INFO +1 -1
  6. {standkit-0.12.5 → standkit-0.12.8}/standkit.egg-info/SOURCES.txt +5 -0
  7. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/backend.py +54 -3
  8. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/candidates.py +54 -17
  9. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/cookbook.py +145 -22
  10. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/releases.py +24 -0
  11. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/runner.py +40 -2
  12. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/__main__.py +15 -1
  13. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/client.py +8 -9
  14. standkit-0.12.8/standkit_hub/hub_logging.py +287 -0
  15. standkit-0.12.8/standkit_hub/preload.py +78 -0
  16. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/server.py +212 -7
  17. {standkit-0.12.5 → standkit-0.12.8}/tests/test_companion_cookbook.py +14 -5
  18. standkit-0.12.8/tests/test_conftest_state_barrier.py +96 -0
  19. standkit-0.12.8/tests/test_gap411_412_415_idle_preload.py +654 -0
  20. standkit-0.12.8/tests/test_gap413_414_companion_consent_logs.py +510 -0
  21. standkit-0.12.8/tests/test_gap429_cookbook_installed_version.py +176 -0
  22. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_exit_idle_restart.py +9 -2
  23. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_logging.py +5 -1
  24. standkit-0.12.5/standkit_hub/hub_logging.py +0 -153
  25. {standkit-0.12.5 → standkit-0.12.8}/LICENSE +0 -0
  26. {standkit-0.12.5 → standkit-0.12.8}/MANIFEST.in +0 -0
  27. {standkit-0.12.5 → standkit-0.12.8}/README.md +0 -0
  28. {standkit-0.12.5 → standkit-0.12.8}/SECURITY.md +0 -0
  29. {standkit-0.12.5 → standkit-0.12.8}/docs/ARCHITECTURE.md +0 -0
  30. {standkit-0.12.5 → standkit-0.12.8}/docs/BACKLOG.md +0 -0
  31. {standkit-0.12.5 → standkit-0.12.8}/docs/COOKBOOK_LINUX.md +0 -0
  32. {standkit-0.12.5 → standkit-0.12.8}/docs/GAPs/GAP-001-registry-fields-out-of-hub-form.md +0 -0
  33. {standkit-0.12.5 → standkit-0.12.8}/docs/GAPs/GAP-002-http-probe-down-not-explained.md +0 -0
  34. {standkit-0.12.5 → standkit-0.12.8}/docs/GAPs/GAP-003-redis-endpoint-in-extra.md +0 -0
  35. {standkit-0.12.5 → standkit-0.12.8}/docs/GAPs/GAP-004-cookbook-hub-register-form.md +0 -0
  36. {standkit-0.12.5 → standkit-0.12.8}/docs/GAPs/GAP-005-cookbook-hub-side-secrets.md +0 -0
  37. {standkit-0.12.5 → standkit-0.12.8}/docs/GAPs/GAP-006-log-dir-case-and-separator.md +0 -0
  38. {standkit-0.12.5 → standkit-0.12.8}/docs/GAPs/GAP-007-agent-paths-raw-traceback.md +0 -0
  39. {standkit-0.12.5 → standkit-0.12.8}/docs/GAPs/GAP-008-agent-cert-trust-on-hub.md +0 -0
  40. {standkit-0.12.5 → standkit-0.12.8}/docs/GAPs/README.md +0 -0
  41. {standkit-0.12.5 → standkit-0.12.8}/docs/HOSTING.md +0 -0
  42. {standkit-0.12.5 → standkit-0.12.8}/docs/README.md +0 -0
  43. {standkit-0.12.5 → standkit-0.12.8}/docs/REMOTE_STANDS.md +0 -0
  44. {standkit-0.12.5 → standkit-0.12.8}/docs/ROADMAP.md +0 -0
  45. {standkit-0.12.5 → standkit-0.12.8}/docs/adr/0001-hosting-backends.md +0 -0
  46. {standkit-0.12.5 → standkit-0.12.8}/docs/adr/0002-k8s-backend.md +0 -0
  47. {standkit-0.12.5 → standkit-0.12.8}/docs/adr/0003-remote-log-browsing.md +0 -0
  48. {standkit-0.12.5 → standkit-0.12.8}/docs/adr/0004-iis-site-scoped-lifecycle.md +0 -0
  49. {standkit-0.12.5 → standkit-0.12.8}/docs/adr/0005-companion-transport-in-mit-core.md +0 -0
  50. {standkit-0.12.5 → standkit-0.12.8}/docs/adr/0006-hub-elevated-restart.md +0 -0
  51. {standkit-0.12.5 → standkit-0.12.8}/docs/adr/0007-hub-exit-idle-and-plain-restart.md +0 -0
  52. {standkit-0.12.5 → standkit-0.12.8}/docs/research/companion-v2-cicd-thin-agent.md +0 -0
  53. {standkit-0.12.5 → standkit-0.12.8}/projects.sample.json +0 -0
  54. {standkit-0.12.5 → standkit-0.12.8}/setup.cfg +0 -0
  55. {standkit-0.12.5 → standkit-0.12.8}/standkit/adopt.py +0 -0
  56. {standkit-0.12.5 → standkit-0.12.8}/standkit/cli_resolve.py +0 -0
  57. {standkit-0.12.5 → standkit-0.12.8}/standkit/health.py +0 -0
  58. {standkit-0.12.5 → standkit-0.12.8}/standkit/hosting.py +0 -0
  59. {standkit-0.12.5 → standkit-0.12.8}/standkit/lifecycle.py +0 -0
  60. {standkit-0.12.5 → standkit-0.12.8}/standkit/logs.py +0 -0
  61. {standkit-0.12.5 → standkit-0.12.8}/standkit/models.py +0 -0
  62. {standkit-0.12.5 → standkit-0.12.8}/standkit/platform.py +0 -0
  63. {standkit-0.12.5 → standkit-0.12.8}/standkit/registry.py +0 -0
  64. {standkit-0.12.5 → standkit-0.12.8}/standkit/secrets.py +0 -0
  65. {standkit-0.12.5 → standkit-0.12.8}/standkit.egg-info/dependency_links.txt +0 -0
  66. {standkit-0.12.5 → standkit-0.12.8}/standkit.egg-info/entry_points.txt +0 -0
  67. {standkit-0.12.5 → standkit-0.12.8}/standkit.egg-info/requires.txt +0 -0
  68. {standkit-0.12.5 → standkit-0.12.8}/standkit.egg-info/top_level.txt +0 -0
  69. {standkit-0.12.5 → standkit-0.12.8}/standkit_agent/__init__.py +0 -0
  70. {standkit-0.12.5 → standkit-0.12.8}/standkit_agent/__main__.py +0 -0
  71. {standkit-0.12.5 → standkit-0.12.8}/standkit_agent/audit.py +0 -0
  72. {standkit-0.12.5 → standkit-0.12.8}/standkit_agent/security.py +0 -0
  73. {standkit-0.12.5 → standkit-0.12.8}/standkit_agent/server.py +0 -0
  74. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/__init__.py +0 -0
  75. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/__main__.py +0 -0
  76. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/context.py +0 -0
  77. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/ed25519.py +0 -0
  78. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/errors.py +0 -0
  79. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/fsutil.py +0 -0
  80. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/mcp_mutex.py +0 -0
  81. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/patterns.py +0 -0
  82. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/revocations.py +0 -0
  83. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/signature.py +0 -0
  84. {standkit-0.12.5 → standkit-0.12.8}/standkit_companion/state.py +0 -0
  85. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/__init__.py +0 -0
  86. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/agent_control.py +0 -0
  87. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/assets/bpmkit-icon.ico +0 -0
  88. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/assets/icon.png +0 -0
  89. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/config.py +0 -0
  90. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/consent_api.py +0 -0
  91. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/elevated_op.py +0 -0
  92. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/elevation.py +0 -0
  93. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/instance.py +0 -0
  94. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/license_api.py +0 -0
  95. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/logs_browser.py +0 -0
  96. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/mutex.py +0 -0
  97. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/pick_dialog.py +0 -0
  98. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/poller.py +0 -0
  99. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/redis_min.py +0 -0
  100. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/security.py +0 -0
  101. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/shortcut.py +0 -0
  102. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/web/app.js +0 -0
  103. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/web/bpmkit-logo-dark.svg +0 -0
  104. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/web/bpmkit-logo.svg +0 -0
  105. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/web/cookbook.html +0 -0
  106. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/web/favicon.png +0 -0
  107. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/web/favicon.svg +0 -0
  108. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/web/index.html +0 -0
  109. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/web/manifest.webmanifest +0 -0
  110. {standkit-0.12.5 → standkit-0.12.8}/standkit_hub/web/style.css +0 -0
  111. {standkit-0.12.5 → standkit-0.12.8}/tests/test_adopt.py +0 -0
  112. {standkit-0.12.5 → standkit-0.12.8}/tests/test_agent_security.py +0 -0
  113. {standkit-0.12.5 → standkit-0.12.8}/tests/test_agent_server_integration.py +0 -0
  114. {standkit-0.12.5 → standkit-0.12.8}/tests/test_agent_startup_preflight.py +0 -0
  115. {standkit-0.12.5 → standkit-0.12.8}/tests/test_companion_backend.py +0 -0
  116. {standkit-0.12.5 → standkit-0.12.8}/tests/test_companion_candidates.py +0 -0
  117. {standkit-0.12.5 → standkit-0.12.8}/tests/test_companion_context.py +0 -0
  118. {standkit-0.12.5 → standkit-0.12.8}/tests/test_companion_fsutil.py +0 -0
  119. {standkit-0.12.5 → standkit-0.12.8}/tests/test_companion_mcp_mutex.py +0 -0
  120. {standkit-0.12.5 → standkit-0.12.8}/tests/test_companion_patterns.py +0 -0
  121. {standkit-0.12.5 → standkit-0.12.8}/tests/test_companion_releases.py +0 -0
  122. {standkit-0.12.5 → standkit-0.12.8}/tests/test_companion_revocations.py +0 -0
  123. {standkit-0.12.5 → standkit-0.12.8}/tests/test_companion_runner.py +0 -0
  124. {standkit-0.12.5 → standkit-0.12.8}/tests/test_companion_signature.py +0 -0
  125. {standkit-0.12.5 → standkit-0.12.8}/tests/test_health.py +0 -0
  126. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hosting.py +0 -0
  127. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_agent_control.py +0 -0
  128. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_client_tls.py +0 -0
  129. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_companion_api.py +0 -0
  130. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_config.py +0 -0
  131. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_consent_api.py +0 -0
  132. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_elevated_op.py +0 -0
  133. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_elevation.py +0 -0
  134. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_elevation_ui.py +0 -0
  135. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_fast_paint.py +0 -0
  136. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_instance.py +0 -0
  137. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_license_api.py +0 -0
  138. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_logs_browser.py +0 -0
  139. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_main_elevated.py +0 -0
  140. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_mutex.py +0 -0
  141. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_pick_dialog.py +0 -0
  142. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_pwa_and_compact.py +0 -0
  143. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_redis_min.py +0 -0
  144. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_register.py +0 -0
  145. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_server.py +0 -0
  146. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_settings_field_help.py +0 -0
  147. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_shortcut.py +0 -0
  148. {standkit-0.12.5 → standkit-0.12.8}/tests/test_hub_single_instance.py +0 -0
  149. {standkit-0.12.5 → standkit-0.12.8}/tests/test_lifecycle.py +0 -0
  150. {standkit-0.12.5 → standkit-0.12.8}/tests/test_logs.py +0 -0
  151. {standkit-0.12.5 → standkit-0.12.8}/tests/test_models.py +0 -0
  152. {standkit-0.12.5 → standkit-0.12.8}/tests/test_no_window.py +0 -0
  153. {standkit-0.12.5 → standkit-0.12.8}/tests/test_platform_sid.py +0 -0
  154. {standkit-0.12.5 → standkit-0.12.8}/tests/test_registry.py +0 -0
  155. {standkit-0.12.5 → standkit-0.12.8}/tests/test_registry_resolver.py +0 -0
  156. {standkit-0.12.5 → standkit-0.12.8}/tests/test_secrets.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: standkit
3
- Version: 0.12.5
3
+ Version: 0.12.8
4
4
  Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
5
5
  Author: standkit contributors
6
6
  License-Expression: MIT
@@ -5,6 +5,155 @@
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [0.12.8] — 2026-09-20
9
+
10
+ ### Исправлено
11
+
12
+ - **`cookbook.installed_version` брала профильную копию БЕЗУСЛОВНО (GAP-429).**
13
+ Порядок поиска был «профиль, затем поставка», и ПЕРВАЯ найденная копия
14
+ объявлялась установленной. После установки НОВОЙ поставки в `{app}\docs`
15
+ ложится свежий документ, а в профиле остаётся редакция, доставленная каналом
16
+ раньше — и канал считал установленной СТАРУЮ: сравнивал бэкенд не с тем, что
17
+ есть на машине, и называл пользователю версию, которой у него уже нет. Тот же
18
+ дефект чинил PR #837 в `_cookbook_report` dev-репо.
19
+ Теперь сравниваются ОБЕ копии: по числовому префиксу версии ВНУТРИ файла
20
+ (`<поставка>-<sha8>`, посегментно ЦЕЛЫМИ числами — строковое сравнение дало бы
21
+ `1.1.9 > 1.1.149`, сравнение по последнему числу — класс GAP-400), при равном
22
+ номере поставки — по времени файла; побеждает НОВЕЙШАЯ. Порядок поиска остаётся
23
+ тай-брейком, поэтому согласованность с ярлыком и `self_check` (GAP-361) при
24
+ равных версиях сохраняется.
25
+ Новое публичное `cookbook.installed_copies()` — обе копии с версиями для
26
+ диагностики. `check()` дополнительно печатает `[WARN]`, если свежая копия лежит
27
+ в ПОСТАВКЕ, а ярлык открывает профильную (иначе отчёт и документ перед глазами
28
+ пользователя снова расходятся), и возвращает это в поле `stale_profile_copy`.
29
+ Класс инцидента — «проверка, неприменимая/не нашедшая предмета, рапортует успех
30
+ вместо честного ответа» (`docs/lessons.md` dev-репо, класс 67).
31
+
32
+ ## [0.12.7] — 2026-09-20
33
+
34
+ ### Исправлено
35
+
36
+ - **Тесты больше не пишут в БОЕВОЙ `hub.log` (GAP-414).** В
37
+ `%LOCALAPPDATA%\BPMkit\logs\hub.log` владельца из 255 строк 226 были написаны
38
+ ПРОГОНОМ ТЕСТОВ (следы `pytest-of-…` внутри самих записей). Механизм тот же, что
39
+ у `projects.json`/`secretstore`/лицензии в dev-репо: тест, поднимающий диспетчер,
40
+ зовёт `hub_logging.setup_logging()` без явного каталога, а тот честно резолвит
41
+ `%LOCALAPPDATA%`. Это не только грязь в чужом файле — прогон РОТИРУЕТ его, унося
42
+ настоящие записи о работе диспетчера за край `.5`. Барьеры состояния машины
43
+ подняты в `tests/conftest.py` НА УРОВНЕ ИМПОРТА и взводятся самым ранним
44
+ conftest: `LOCALAPPDATA`, `APPDATA`, `HOME`/`USERPROFILE`, `XDG_*`, реестр стендов
45
+ (`BPMSOFT_PROJECTS_FILE`), хранилище секретов (`standkit.secrets` → двойник в
46
+ памяти), лицензия (`BPMKIT_CLI` и `STANDKIT_SECRET__*` снимаются). На барьер —
47
+ мета-тест `tests/test_conftest_state_barrier.py`. Проверено живьём: полный набор
48
+ (1494 теста) не добавил в боевой `hub.log` ни одного байта.
49
+ - **Ротация лога под двумя процессами не падает молча (GAP-414).** При перезапуске
50
+ диспетчера с повышением прав файл `hub.log` держат ДВА процесса;
51
+ `RotatingFileHandler.doRollover()` не может переименовать занятый файл, а
52
+ `logging` глушит отказ обработчика в `handleError` — под `pythonw.exe` (stderr
53
+ нет) это полная тишина, и файл растёт без предела, то есть отказывает ровно та
54
+ гарантия, ради которой ротация заводилась. Новый `GuardedRotatingFileHandler`
55
+ считает отказ (`hub_logging.rotation_state()`) и переводит ЭТОТ процесс на
56
+ собственный файл `hub.<pid>.log` — pid в имени снимает саму причину конфликта;
57
+ причина переключения пишется первой строкой в новый файл.
58
+ - **`MAX_COOKBOOK_BYTES` применяется (GAP-414).** Константа-потолок документа была
59
+ объявлена и не использована ни разу: `client.download` о ней не знал. Теперь кап
60
+ проверяется ДВАЖДЫ и fail-closed — по обещанному в `/meta` размеру (скачивания не
61
+ происходит вовсе) и по фактически прочитанному (`download(max_bytes=…)`, потому
62
+ что заголовку сервера верить нельзя). Скачивание перенесено ВНУТРЬ блока уборки:
63
+ до этого любой отказ транспорта оставлял `cookbook.html.part` в профиле
64
+ пользователя навсегда.
65
+ - **Инициатор стоп-запроса назван в логе (GAP-413).** Читатель спрашивал у
66
+ файла-запроса поля `by`/`source`, которых писатель (`instance.write_stop_request`)
67
+ не кладёт НИКОГДА: он пишет `requester_pid`. В логе стояло «инициатор=не указан»
68
+ при ЛЮБОМ перехвате. Теперь печатается pid И имя процесса (`tasklist` на Windows,
69
+ `/proc/<pid>/comm` на POSIX, best-effort и без единого исключения наружу).
70
+ - **Очередь находок разгружается ОДИН раз за пробуждение (GAP-413).** Обратный
71
+ проход — попутчик, и он висел сразу на двух несущих циклах (`patterns` и
72
+ `releases`); когда сроки обоих наступают в одну секунду (после старта диспетчера
73
+ это ровно так), поставку просили разгрузить очередь дважды — два запуска внешнего
74
+ процесса и две серии сетевых попыток по одним и тем же письмам. Второй вызов в
75
+ пределах пробуждения возвращает исход первого с пометкой `reused`.
76
+
77
+ ### Изменено
78
+
79
+ - **Задержанные согласием письма видны в UI (GAP-413, парная половина в dev-репо).**
80
+ Поставка после GAP-413 проверяет флаги согласия ПЕРЕД КАЖДЫМ письмом и печатает
81
+ число задержанных полем `held_no_consent`; канал читает его и называет в тексте
82
+ исхода («задержано без согласия: N»). Докстринг `candidates.py` приведён к факту:
83
+ прежняя фраза «она откажет сама, если согласия нет» была неверной — согласие
84
+ проверялось только при постановке письма в очередь.
85
+
86
+ ## [0.12.6] — 2026-09-20
87
+
88
+ ### Исправлено
89
+
90
+ - **Сторож простоя теперь можно разобрать (GAP-411).** Живой прогон на VM 20.09
91
+ (поставка 1.1.116, `idle_shutdown_min=1`, ПУСТОЙ реестр): через четыре минуты
92
+ диспетчер жив, а в `hub.log` — две строки «старт standkit-hub» и больше ничего.
93
+ Из этого факта одинаково следовали четыре взаимоисключающих вывода: сторож не
94
+ запустился; конфиг не прочитан; стенды считаются живыми; дашборд открыт в
95
+ браузере (exe без `--no-browser` открывает его сам, а открытая страница держит
96
+ `/api/events` — и это ШТАТНАЯ причина не выходить). Воспроизведение сторожа на
97
+ текущем коде показало, что сам предикат исправен: чинить надо было не решение,
98
+ а невозможность узнать, каким оно было. Теперь сторож представляется при старте
99
+ (INFO: таймаут, путь конфига, desktop-режим, период проверки — и отдельно
100
+ «ВЫКЛЮЧЕН», если `idle_shutdown_min=0`) и пишет DEBUG-строку на КАЖДОМ тике со
101
+ всеми входами решения: `sse_client_count`, `has_running_stands`,
102
+ `version_desynced`, признаки и ВОЗРАСТ снапшота, накопленный простой. При
103
+ выключенном DEBUG тик не собирает факты вовсе и стоит столько же, сколько стоил.
104
+ Уровень лога поднимается переменной окружения `STANDKIT_HUB_LOG_LEVEL=DEBUG` — иначе
105
+ DEBUG-строки существовали бы только в тестах, а у человека, который наблюдает проблему
106
+ на своей машине, не было бы способа их увидеть. Строка старта теперь называет
107
+ действующий уровень и значение переменной.
108
+
109
+ - **Снапшот произвольной давности больше не считается знанием (GAP-412).**
110
+ `has_running_stands` смотрел на `probed`/`error`, но не на `generated_at`:
111
+ зависший поллер или уснувшая машина оставляли последний успешный снапшот как
112
+ есть, и пустой список трёхминутной давности читался как «стендов нет». Снапшот
113
+ старше `3 × refresh_interval_sec` — теперь незнание («остаёмся») с однократным
114
+ WARN в лог. Порог считается от НАСТРОЙКИ, а не от константы; снапшот без даты
115
+ тоже протухший.
116
+
117
+ - **Нечитаемая версия ПОСЛЕ прочитанной считается рассинхроном (GAP-412).**
118
+ `pip install` снимает `standkit/__init__.py` и кладёт новый не атомарно; попасть
119
+ тиком сторожа в это окно — вопрос времени, а цена прежняя: выход с живыми
120
+ стендами посреди обновления. Версия, которую ни разу не удалось прочитать
121
+ (frozen-сборка), по-прежнему НЕ рассинхрон — иначе exe-диспетчер запретил бы
122
+ себе автовыход навсегда.
123
+
124
+ - **Все модули пакетов загружаются при старте (GAP-412).** Новый
125
+ `standkit_hub/preload.py`: диспетчер один раз проходит по модулям `standkit`,
126
+ `standkit_hub` и `standkit_companion` и импортирует их. `pip install -U` под
127
+ живым процессом заменяет файлы на диске, и ленивый `import` внутри функции
128
+ подтянул бы НОВЫЙ модуль в СТАРЫЙ процесс — после preload такой импорт
129
+ становится поиском в `sys.modules`. Ленивые импорты самих пакетов закрыты
130
+ гейт-тестом с allowlist, где у каждой записи есть причина (циклы
131
+ `lifecycle` ↔ `hosting`, мягкий импорт канала, отдельный процесс агента).
132
+
133
+ - **Три метода клиента читали транспорт буквально (GAP-415).** `adopt`,
134
+ `_dispatch_action` (start/stop/restart) и `logs` сравнивали `stand.transport`
135
+ с `Transport.AGENT`, а не `effective_transport`. Запись «удалённый стенд»
136
+ старого образца (`transport=agent` БЕЗ `agent_url`, GAP-277) уходила к агенту,
137
+ которого нет, и отвечала «не задан agent_url» вместо честного «без агента
138
+ управление процессом недоступно». Добавлен тест-сторож на отсутствие
139
+ буквальных сравнений в `client.py`.
140
+
141
+ - **Канал обновлений не применит УСТАНОВЩИК вместо бинаря (GAP-415).**
142
+ `bpmkit-setup-*.exe` проходил обе прежние проверки `_ensure_artifact_applicable`
143
+ (расширение `.exe`, PE-заголовок `MZ`) и подпись издателя — и лёг бы на место
144
+ `bpmkit.exe`, превратив запуск MCP в мастер установки. Клиентский гард
145
+ отказывается применять артефакт с таким именем до реализации ADR-0048
146
+ (установщик отдельным типом артефакта). Гард именно клиентский: канал обязан
147
+ быть безопасен против ОШИБКИ ИЗДАТЕЛЯ, а не только против подделки.
148
+
149
+ - **`standkit/__init__.__version__` разъехался с `pyproject` (GAP-415).** Релизы
150
+ 0.12.3/0.12.4/0.12.5 бампали только `pyproject.toml`, и пакет продолжал
151
+ сообщать «0.12.2». Из-за этого exe 1.1.116 честно печатал в `hub.log`
152
+ «версия=0.12.2» при указателе сабмодуля на 0.12.5, и аудит прочёл это как
153
+ «сборка унесла старый диспетчер». Старым был не диспетчер, а строка версии.
154
+ Обе версии сведены к 0.12.6, расхождение закрыто тестом (и гейтом сборки на
155
+ стороне поставки BPMkit).
156
+
8
157
  ## [0.12.5] — 2026-09-19
9
158
 
10
159
  ### Добавлено
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "standkit"
7
- version = "0.12.5"
7
+ version = "0.12.8"
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.2"
9
+ __version__ = "0.12.8"
10
10
 
11
11
  __all__ = ["__version__"]
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: standkit
3
- Version: 0.12.5
3
+ Version: 0.12.8
4
4
  Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
5
5
  Author: standkit contributors
6
6
  License-Expression: MIT
@@ -82,6 +82,7 @@ standkit_hub/logs_browser.py
82
82
  standkit_hub/mutex.py
83
83
  standkit_hub/pick_dialog.py
84
84
  standkit_hub/poller.py
85
+ standkit_hub/preload.py
85
86
  standkit_hub/redis_min.py
86
87
  standkit_hub/security.py
87
88
  standkit_hub/server.py
@@ -112,6 +113,10 @@ tests/test_companion_releases.py
112
113
  tests/test_companion_revocations.py
113
114
  tests/test_companion_runner.py
114
115
  tests/test_companion_signature.py
116
+ tests/test_conftest_state_barrier.py
117
+ tests/test_gap411_412_415_idle_preload.py
118
+ tests/test_gap413_414_companion_consent_logs.py
119
+ tests/test_gap429_cookbook_installed_version.py
115
120
  tests/test_health.py
116
121
  tests/test_hosting.py
117
122
  tests/test_hub_agent_control.py
@@ -467,9 +467,27 @@ class BackendClient:
467
467
  def download(self, path: str, dest, *, authorized: bool = True,
468
468
  resume_from: int = 0, etag: Optional[str] = None,
469
469
  expected_size: Optional[int] = None,
470
- chunk_size: int = 1024 * 1024) -> dict:
470
+ chunk_size: int = 1024 * 1024,
471
+ max_bytes: Optional[int] = None) -> dict:
471
472
  """Скачать файл в `dest` потоком, при необходимости — с докачкой.
472
473
 
474
+ `max_bytes` — потолок артефакта, fail-closed (GAP-414). `None` (по
475
+ умолчанию) — потолка нет, прежнее поведение. Когда он задан, проверок
476
+ ДВЕ, и обе обязательны:
477
+
478
+ * по ОБЪЯВЛЕННОЙ длине — отказ ДО открытия приёмника: тянуть на
479
+ пользовательский канал файл, который мы всё равно отвергнем, незачем,
480
+ а уже лежащий рядом рабочий файл не имеет права пострадать от чужого
481
+ превышения;
482
+ * по ФАКТИЧЕСКИ прочитанному — потому что заголовку верить нельзя:
483
+ `Content-Length` может отсутствовать (chunked), быть занижен или
484
+ солгать. Проверка только по заголовку — это кап, который снимается
485
+ одной строкой на стороне сервера.
486
+
487
+ Превышение в потоке — не «почти скачали»: огрызок удаляется, иначе он
488
+ останется на диске пользователя и (в режиме докачки) будет вечно
489
+ продолжаться до того же превышения.
490
+
473
491
  Три решения, каждое из-за конкретного способа испортить файл:
474
492
 
475
493
  1. **дописываем только на честный `206`.** Сервер, ответивший `200` на запрос с
@@ -520,8 +538,28 @@ class BackendClient:
520
538
  detail=f"Content-Length: 0, ожидалось {expected} байт",
521
539
  )
522
540
 
541
+ cap = _int_or_none(max_bytes)
542
+ if cap is not None:
543
+ promised = declared if declared is not None else expected
544
+ already = resume_from if resumed else 0
545
+ if promised is not None and (already + promised) > cap:
546
+ raise ChannelError(
547
+ "Файл больше разрешённого потолка — он не скачивается",
548
+ kind="too_large",
549
+ http_status=status,
550
+ detail=f"объявлено {already + promised} байт, потолок {cap}",
551
+ )
552
+
523
553
  mode = "ab" if resumed else "wb"
524
- written = _stream_to_file(resp, dest, mode=mode, chunk_size=chunk_size)
554
+ try:
555
+ written = _stream_to_file(resp, dest, mode=mode, chunk_size=chunk_size,
556
+ max_bytes=cap, already=resume_from if resumed else 0)
557
+ except ChannelError as exc:
558
+ if exc.kind == "too_large":
559
+ # Огрызок сверх потолка на диске не остаётся: докачивать его
560
+ # некуда, а место он займёт (см. докстринг).
561
+ _unlink_quietly(dest)
562
+ raise
525
563
  finally:
526
564
  try:
527
565
  resp.close()
@@ -611,13 +649,19 @@ def _unlink_quietly(path: Path) -> None:
611
649
  pass
612
650
 
613
651
 
614
- def _stream_to_file(resp, dest: Path, *, mode: str, chunk_size: int) -> int:
652
+ def _stream_to_file(resp, dest: Path, *, mode: str, chunk_size: int,
653
+ max_bytes: Optional[int] = None, already: int = 0) -> int:
615
654
  """Переливание тела ответа в файл кусками. Возвращает число ЗАПИСАННЫХ байт.
616
655
 
617
656
  Файл открывается лениво — на первом непустом куске (см. п.2 докстринга `download`).
618
657
  Если данных не пришло вовсе, приёмник НЕ трогается здесь вообще: решение «это пустой
619
658
  файл» или «это отказ отдачи» принимает `download`, у которого есть `expected_size`.
620
659
  Создать пустышку тут же значило бы обнулить рабочий бинарь ещё до проверки.
660
+
661
+ `max_bytes` — потолок, считаемый по ФАКТИЧЕСКИ прочитанному (`already` —
662
+ сколько уже лежит от прошлой докачки). Превышение обрывает чтение СРАЗУ,
663
+ на первом же куске за чертой: дочитывать тело, которое мы всё равно
664
+ отвергнем, значит платить за отказ трафиком пользователя.
621
665
  """
622
666
  handle = None
623
667
  written = 0
@@ -644,6 +688,13 @@ def _stream_to_file(resp, dest: Path, *, mode: str, chunk_size: int) -> int:
644
688
  detail=_clip(str(exc)),
645
689
  ) from None
646
690
  written += len(chunk)
691
+ if max_bytes is not None and (already + written) > int(max_bytes):
692
+ raise ChannelError(
693
+ "Файл больше разрешённого потолка — скачивание прервано",
694
+ kind="too_large",
695
+ detail=f"прочитано не меньше {already + written} байт, "
696
+ f"потолок {int(max_bytes)}",
697
+ )
647
698
  finally:
648
699
  if handle is not None:
649
700
  try:
@@ -33,10 +33,26 @@
33
33
  тике, обесценивает индикацию.
34
34
 
35
35
  **Согласие не спрашивается здесь и не может быть обойдено отсюда.** Флаги
36
- (`analytics` / `pattern_submission` / `candidate_submission`) независимы
37
- (ADR-0024) и проверяются транспортом на стороне MCP. Companion не знает о них
38
- ничего и не вправе знать: единственный способ отправить что-либо отсюда —
39
- попросить поставку разгрузить очередь, а она откажет сама, если согласия нет.
36
+ (`analytics` / `attach_logs` / `pattern_submission` / `candidate_submission`)
37
+ независимы (ADR-0024) и проверяются транспортом на стороне MCP. Companion не
38
+ знает о них ничего и не вправе знать: единственный способ отправить что-либо
39
+ отсюда — попросить поставку разгрузить очередь.
40
+
41
+ **Как именно отказывает поставка (по факту, GAP-413).** До 20.09.2026 фраза
42
+ «она откажет сама» была неточной: согласие проверялось только в момент, когда
43
+ письмо КЛАДЁТСЯ в очередь, а `feedback._transport_send` отправлял уже стоящее
44
+ без единой проверки — отзыв согласия очередь не останавливал (строка L-31
45
+ `docs/legal_backlog.md`, 152-ФЗ). Теперь гейт стоит ПЕРЕД КАЖДЫМ письмом: при
46
+ снятом флаге письмо получает статус `no_consent`, НЕ отправляется, остаётся в
47
+ очереди нетронутым и считается отдельно — поставка печатает их число полем
48
+ `held_no_consent`. Для канала это не отказ и не системная остановка: проход
49
+ идёт дальше по остальным письмам, а число задержанных попадает в состояние и в
50
+ текст для пользователя. Молчать о них нельзя — иначе снявший галку человек
51
+ видит «очередь пуста» и не понимает, почему находки не уезжают.
52
+
53
+ Поле может отсутствовать: Companion и MCP обновляются РАЗНЫМИ артефактами и
54
+ разными каналами, поэтому старая поставка его не печатает — это норма, а не
55
+ повод объявить проход неудачным (читается через `int(... or 0)`).
40
56
  """
41
57
  from __future__ import annotations
42
58
 
@@ -153,7 +169,7 @@ def flush(state, settings, *, run: Optional[Callable] = None,
153
169
  "CLI BPMkit не найден — очередь находок не разгружалась")
154
170
  state.save()
155
171
  return {"flushed": False, "reason": "cli_not_found",
156
- "sent": 0, "failed": 0, "remaining": None}
172
+ "sent": 0, "failed": 0, "held_no_consent": 0, "remaining": None}
157
173
 
158
174
  argv = list(cli) + list(FLUSH_ARGV_TAIL)
159
175
  if limit is not None:
@@ -168,7 +184,7 @@ def flush(state, settings, *, run: Optional[Callable] = None,
168
184
  state.mark("candidates", "error", f"CLI BPMkit не запустился: {_clip(str(exc))}")
169
185
  state.save()
170
186
  return {"flushed": False, "reason": "spawn_error",
171
- "sent": 0, "failed": 0, "remaining": None}
187
+ "sent": 0, "failed": 0, "held_no_consent": 0, "remaining": None}
172
188
 
173
189
  if rc != 0:
174
190
  block["last_sync_at"] = utc_now_iso()
@@ -176,7 +192,7 @@ def flush(state, settings, *, run: Optional[Callable] = None,
176
192
  state.mark("candidates", "error", f"разгрузка очереди отказала: {detail}")
177
193
  state.save()
178
194
  return {"flushed": False, "reason": "cli_error", "detail": detail,
179
- "sent": 0, "failed": 0, "remaining": None}
195
+ "sent": 0, "failed": 0, "held_no_consent": 0, "remaining": None}
180
196
 
181
197
  payload = _parse_stdout(stdout)
182
198
 
@@ -186,37 +202,42 @@ def flush(state, settings, *, run: Optional[Callable] = None,
186
202
  state.mark("candidates", "error", f"очередь не разгружена: {detail}")
187
203
  state.save()
188
204
  return {"flushed": False, "reason": payload.get("reason") or "refused",
189
- "detail": detail, "sent": 0, "failed": 0, "remaining": None}
205
+ "detail": detail, "sent": 0, "failed": 0, "held_no_consent": 0, "remaining": None}
190
206
 
191
207
  sent = int(payload.get("sent") or 0)
192
208
  failed = int(payload.get("failed") or 0)
209
+ # Письма, задержанные гейтом согласия (GAP-413). Старая поставка поля не
210
+ # печатает — см. докстринг модуля, это обратная совместимость, а не ошибка.
211
+ held = int(payload.get("held_no_consent") or 0)
193
212
  remaining = payload.get("remaining")
194
213
  stopped = payload.get("stopped_reason") or None
195
214
 
196
215
  block["last_sync_at"] = utc_now_iso()
197
216
  block["last_sent"] = sent
217
+ block["last_held_no_consent"] = held
198
218
  block["last_remaining"] = remaining
199
219
 
200
220
  if stopped in SYSTEM_STOP_REASONS:
201
221
  # Ровно требование строки GAP-260: офлайн/квота/нет лицензии не
202
222
  # должны быть ошибкой ПО ПОСТРОЕНИЮ. Отправленное до остановки при
203
223
  # этом отправлено — об этом и говорим.
204
- state.mark("candidates", "skipped", _stop_text(stopped, sent, remaining))
224
+ state.mark("candidates", "skipped",
225
+ _with_held(_stop_text(stopped, sent, remaining), held))
205
226
  state.save()
206
227
  return {"flushed": sent > 0, "reason": stopped, "sent": sent,
207
- "failed": failed, "remaining": remaining}
228
+ "failed": failed, "held_no_consent": held, "remaining": remaining}
208
229
 
209
230
  if stopped:
210
231
  state.mark("candidates", "error",
211
- f"проход очереди остановлен: {_clip(stopped)}")
232
+ _with_held(f"проход очереди остановлен: {_clip(stopped)}", held))
212
233
  state.save()
213
234
  return {"flushed": sent > 0, "reason": stopped, "sent": sent,
214
- "failed": failed, "remaining": remaining}
235
+ "failed": failed, "held_no_consent": held, "remaining": remaining}
215
236
 
216
- state.mark("candidates", "ok", _ok_text(sent, failed, remaining))
237
+ state.mark("candidates", "ok", _ok_text(sent, failed, remaining, held))
217
238
  state.save()
218
239
  return {"flushed": sent > 0, "reason": "flushed", "sent": sent,
219
- "failed": failed, "remaining": remaining}
240
+ "failed": failed, "held_no_consent": held, "remaining": remaining}
220
241
 
221
242
 
222
243
  def _stop_text(reason: str, sent: int, remaining) -> str:
@@ -235,12 +256,28 @@ def _stop_text(reason: str, sent: int, remaining) -> str:
235
256
  return f"Находки не отправлены: {head}{left}"
236
257
 
237
258
 
238
- def _ok_text(sent: int, failed: int, remaining) -> str:
239
- if not sent and not failed:
259
+ def _with_held(text: str, held: int) -> str:
260
+ """Дописывает к тексту исхода число писем, задержанных гейтом согласия.
261
+
262
+ Отдельной строкой, а не заменой текста: «отправлено 3, задержано 2» и
263
+ «задержано 2» — разные сообщения, и первое не имеет права потеряться.
264
+ """
265
+ if not held:
266
+ return text
267
+ return f"{text}; задержано без согласия: {held} (проверьте флаги в «Данные и телеметрия»)"
268
+
269
+
270
+ def _ok_text(sent: int, failed: int, remaining, held: int = 0) -> str:
271
+ if not sent and not failed and not held:
240
272
  return "Очередь находок пуста — отправлять нечего"
273
+ if not sent and not failed and held:
274
+ # Очередь НЕ пуста, но ничего не уехало и уехать не могло: писать
275
+ # «пуста» здесь значило бы соврать ровно тому, кто снял галку.
276
+ return _with_held(f"Находки не отправлены: согласие снято, писем в очереди {held}",
277
+ 0)
241
278
  parts = [f"Отправлено находок: {sent}"]
242
279
  if failed:
243
280
  parts.append(f"отклонено: {failed}")
244
281
  if isinstance(remaining, int) and remaining:
245
282
  parts.append(f"в очереди: {remaining}")
246
- return "; ".join(parts)
283
+ return _with_held("; ".join(parts), held)