standkit 0.12.4__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.4/standkit.egg-info → standkit-0.12.8}/PKG-INFO +1 -1
  2. {standkit-0.12.4 → standkit-0.12.8}/docs/CHANGELOG.md +195 -0
  3. {standkit-0.12.4 → standkit-0.12.8}/pyproject.toml +1 -1
  4. {standkit-0.12.4 → standkit-0.12.8}/standkit/__init__.py +1 -1
  5. {standkit-0.12.4 → standkit-0.12.8/standkit.egg-info}/PKG-INFO +1 -1
  6. {standkit-0.12.4 → standkit-0.12.8}/standkit.egg-info/SOURCES.txt +7 -0
  7. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/backend.py +54 -3
  8. standkit-0.12.8/standkit_companion/candidates.py +283 -0
  9. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/cookbook.py +145 -22
  10. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/releases.py +24 -0
  11. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/runner.py +70 -2
  12. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/state.py +17 -0
  13. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/__main__.py +15 -1
  14. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/client.py +8 -9
  15. standkit-0.12.8/standkit_hub/hub_logging.py +287 -0
  16. standkit-0.12.8/standkit_hub/preload.py +78 -0
  17. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/server.py +212 -7
  18. standkit-0.12.8/tests/test_companion_candidates.py +255 -0
  19. {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_cookbook.py +14 -5
  20. {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_runner.py +11 -2
  21. standkit-0.12.8/tests/test_conftest_state_barrier.py +96 -0
  22. standkit-0.12.8/tests/test_gap411_412_415_idle_preload.py +654 -0
  23. standkit-0.12.8/tests/test_gap413_414_companion_consent_logs.py +510 -0
  24. standkit-0.12.8/tests/test_gap429_cookbook_installed_version.py +176 -0
  25. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_exit_idle_restart.py +9 -2
  26. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_logging.py +5 -1
  27. standkit-0.12.4/standkit_hub/hub_logging.py +0 -153
  28. {standkit-0.12.4 → standkit-0.12.8}/LICENSE +0 -0
  29. {standkit-0.12.4 → standkit-0.12.8}/MANIFEST.in +0 -0
  30. {standkit-0.12.4 → standkit-0.12.8}/README.md +0 -0
  31. {standkit-0.12.4 → standkit-0.12.8}/SECURITY.md +0 -0
  32. {standkit-0.12.4 → standkit-0.12.8}/docs/ARCHITECTURE.md +0 -0
  33. {standkit-0.12.4 → standkit-0.12.8}/docs/BACKLOG.md +0 -0
  34. {standkit-0.12.4 → standkit-0.12.8}/docs/COOKBOOK_LINUX.md +0 -0
  35. {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-001-registry-fields-out-of-hub-form.md +0 -0
  36. {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-002-http-probe-down-not-explained.md +0 -0
  37. {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-003-redis-endpoint-in-extra.md +0 -0
  38. {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-004-cookbook-hub-register-form.md +0 -0
  39. {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-005-cookbook-hub-side-secrets.md +0 -0
  40. {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-006-log-dir-case-and-separator.md +0 -0
  41. {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-007-agent-paths-raw-traceback.md +0 -0
  42. {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-008-agent-cert-trust-on-hub.md +0 -0
  43. {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/README.md +0 -0
  44. {standkit-0.12.4 → standkit-0.12.8}/docs/HOSTING.md +0 -0
  45. {standkit-0.12.4 → standkit-0.12.8}/docs/README.md +0 -0
  46. {standkit-0.12.4 → standkit-0.12.8}/docs/REMOTE_STANDS.md +0 -0
  47. {standkit-0.12.4 → standkit-0.12.8}/docs/ROADMAP.md +0 -0
  48. {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0001-hosting-backends.md +0 -0
  49. {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0002-k8s-backend.md +0 -0
  50. {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0003-remote-log-browsing.md +0 -0
  51. {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0004-iis-site-scoped-lifecycle.md +0 -0
  52. {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0005-companion-transport-in-mit-core.md +0 -0
  53. {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0006-hub-elevated-restart.md +0 -0
  54. {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0007-hub-exit-idle-and-plain-restart.md +0 -0
  55. {standkit-0.12.4 → standkit-0.12.8}/docs/research/companion-v2-cicd-thin-agent.md +0 -0
  56. {standkit-0.12.4 → standkit-0.12.8}/projects.sample.json +0 -0
  57. {standkit-0.12.4 → standkit-0.12.8}/setup.cfg +0 -0
  58. {standkit-0.12.4 → standkit-0.12.8}/standkit/adopt.py +0 -0
  59. {standkit-0.12.4 → standkit-0.12.8}/standkit/cli_resolve.py +0 -0
  60. {standkit-0.12.4 → standkit-0.12.8}/standkit/health.py +0 -0
  61. {standkit-0.12.4 → standkit-0.12.8}/standkit/hosting.py +0 -0
  62. {standkit-0.12.4 → standkit-0.12.8}/standkit/lifecycle.py +0 -0
  63. {standkit-0.12.4 → standkit-0.12.8}/standkit/logs.py +0 -0
  64. {standkit-0.12.4 → standkit-0.12.8}/standkit/models.py +0 -0
  65. {standkit-0.12.4 → standkit-0.12.8}/standkit/platform.py +0 -0
  66. {standkit-0.12.4 → standkit-0.12.8}/standkit/registry.py +0 -0
  67. {standkit-0.12.4 → standkit-0.12.8}/standkit/secrets.py +0 -0
  68. {standkit-0.12.4 → standkit-0.12.8}/standkit.egg-info/dependency_links.txt +0 -0
  69. {standkit-0.12.4 → standkit-0.12.8}/standkit.egg-info/entry_points.txt +0 -0
  70. {standkit-0.12.4 → standkit-0.12.8}/standkit.egg-info/requires.txt +0 -0
  71. {standkit-0.12.4 → standkit-0.12.8}/standkit.egg-info/top_level.txt +0 -0
  72. {standkit-0.12.4 → standkit-0.12.8}/standkit_agent/__init__.py +0 -0
  73. {standkit-0.12.4 → standkit-0.12.8}/standkit_agent/__main__.py +0 -0
  74. {standkit-0.12.4 → standkit-0.12.8}/standkit_agent/audit.py +0 -0
  75. {standkit-0.12.4 → standkit-0.12.8}/standkit_agent/security.py +0 -0
  76. {standkit-0.12.4 → standkit-0.12.8}/standkit_agent/server.py +0 -0
  77. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/__init__.py +0 -0
  78. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/__main__.py +0 -0
  79. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/context.py +0 -0
  80. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/ed25519.py +0 -0
  81. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/errors.py +0 -0
  82. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/fsutil.py +0 -0
  83. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/mcp_mutex.py +0 -0
  84. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/patterns.py +0 -0
  85. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/revocations.py +0 -0
  86. {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/signature.py +0 -0
  87. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/__init__.py +0 -0
  88. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/agent_control.py +0 -0
  89. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/assets/bpmkit-icon.ico +0 -0
  90. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/assets/icon.png +0 -0
  91. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/config.py +0 -0
  92. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/consent_api.py +0 -0
  93. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/elevated_op.py +0 -0
  94. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/elevation.py +0 -0
  95. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/instance.py +0 -0
  96. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/license_api.py +0 -0
  97. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/logs_browser.py +0 -0
  98. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/mutex.py +0 -0
  99. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/pick_dialog.py +0 -0
  100. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/poller.py +0 -0
  101. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/redis_min.py +0 -0
  102. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/security.py +0 -0
  103. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/shortcut.py +0 -0
  104. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/app.js +0 -0
  105. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/bpmkit-logo-dark.svg +0 -0
  106. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/bpmkit-logo.svg +0 -0
  107. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/cookbook.html +0 -0
  108. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/favicon.png +0 -0
  109. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/favicon.svg +0 -0
  110. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/index.html +0 -0
  111. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/manifest.webmanifest +0 -0
  112. {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/style.css +0 -0
  113. {standkit-0.12.4 → standkit-0.12.8}/tests/test_adopt.py +0 -0
  114. {standkit-0.12.4 → standkit-0.12.8}/tests/test_agent_security.py +0 -0
  115. {standkit-0.12.4 → standkit-0.12.8}/tests/test_agent_server_integration.py +0 -0
  116. {standkit-0.12.4 → standkit-0.12.8}/tests/test_agent_startup_preflight.py +0 -0
  117. {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_backend.py +0 -0
  118. {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_context.py +0 -0
  119. {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_fsutil.py +0 -0
  120. {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_mcp_mutex.py +0 -0
  121. {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_patterns.py +0 -0
  122. {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_releases.py +0 -0
  123. {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_revocations.py +0 -0
  124. {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_signature.py +0 -0
  125. {standkit-0.12.4 → standkit-0.12.8}/tests/test_health.py +0 -0
  126. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hosting.py +0 -0
  127. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_agent_control.py +0 -0
  128. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_client_tls.py +0 -0
  129. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_companion_api.py +0 -0
  130. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_config.py +0 -0
  131. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_consent_api.py +0 -0
  132. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_elevated_op.py +0 -0
  133. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_elevation.py +0 -0
  134. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_elevation_ui.py +0 -0
  135. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_fast_paint.py +0 -0
  136. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_instance.py +0 -0
  137. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_license_api.py +0 -0
  138. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_logs_browser.py +0 -0
  139. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_main_elevated.py +0 -0
  140. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_mutex.py +0 -0
  141. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_pick_dialog.py +0 -0
  142. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_pwa_and_compact.py +0 -0
  143. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_redis_min.py +0 -0
  144. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_register.py +0 -0
  145. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_server.py +0 -0
  146. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_settings_field_help.py +0 -0
  147. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_shortcut.py +0 -0
  148. {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_single_instance.py +0 -0
  149. {standkit-0.12.4 → standkit-0.12.8}/tests/test_lifecycle.py +0 -0
  150. {standkit-0.12.4 → standkit-0.12.8}/tests/test_logs.py +0 -0
  151. {standkit-0.12.4 → standkit-0.12.8}/tests/test_models.py +0 -0
  152. {standkit-0.12.4 → standkit-0.12.8}/tests/test_no_window.py +0 -0
  153. {standkit-0.12.4 → standkit-0.12.8}/tests/test_platform_sid.py +0 -0
  154. {standkit-0.12.4 → standkit-0.12.8}/tests/test_registry.py +0 -0
  155. {standkit-0.12.4 → standkit-0.12.8}/tests/test_registry_resolver.py +0 -0
  156. {standkit-0.12.4 → 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.4
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,201 @@
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
+
157
+ ## [0.12.5] — 2026-09-19
158
+
159
+ ### Добавлено
160
+
161
+ - **Обратный проход канала: находки уезжают вендору сами (GAP-260, GAP-248 п.2).**
162
+ Канал Companion работал только НА ПРИЁМ (паттерны, релизы, отзывы, кукбук).
163
+ Локально накопленные находки — очередь `~/.bpmkit/outbox/`, которую пополняют
164
+ `session_note` и `pattern_submit(submit=True)`, — не уезжали НИКОГДА, пока
165
+ пользователь не вызывал `feedback_flush(confirm=True)` руками. Очередь
166
+ сабмишенов у издателя пуста не потому, что нечего слать, а потому что путь
167
+ непроходим для обычного пользователя; при этом ежедневный триаж рассчитан на
168
+ эту очередь как на источник.
169
+
170
+ Новый модуль `standkit_companion/candidates.py` едет **попутчиком** обычного
171
+ тика — ровно как кукбук (GAP-361) и по той же причине: у очереди нет
172
+ собственного расписания, отдельный цикл означал бы ещё один тик, ещё одну
173
+ строку в UI и ещё один повод разбудить машину ради очереди, которая чаще
174
+ всего пуста. Свой слот состояния `state.candidates` и своя строка исхода:
175
+ мешать его в `patterns` значило бы объявлять неудачей синхронизацию
176
+ паттернов из-за того, что находки не уехали.
177
+
178
+ **Очередь читается не отсюда.** Каталог известен и формат JSON, но у очереди
179
+ есть правила, которые пришлось бы повторить: два подкаталога с разными
180
+ капами, счётчик `attempts` с атомарной перезаписью, перенос в `dead/` после
181
+ N отказов, маскирование улик, гейты согласия и генерализации. Вторая копия
182
+ этой логики в другом репозитории разъехалась бы на первом изменении формата
183
+ — и разъехалась бы молча, теряя или дублируя находки. Поэтому Companion
184
+ просит разгрузить очередь ту поставку, которой она принадлежит:
185
+ `bpmkit setup outbox-flush` (новая подкоманда MCP), ровно так же, как зовёт
186
+ `companion-context`.
187
+
188
+ **Офлайн, квота и отсутствие лицензии — не ошибка по построению** (дословное
189
+ требование строки GAP-260): системный отказ транспорта (`offline`,
190
+ `rate_limited`, `no_license`, `feature_disabled`, `insecure_transport`)
191
+ помечается как `skipped`, а не `error`. Красный цикл, который чинится сам
192
+ при следующем тике, обесценивает индикацию. Отправленное до остановки при
193
+ этом считается отправленным и попадает в отчёт.
194
+
195
+ **Согласие не спрашивается здесь и не может быть обойдено отсюда.** Флаги
196
+ `analytics` / `pattern_submission` / `candidate_submission` независимы
197
+ (ADR-0024) и проверяются транспортом на стороне MCP; Companion о них не
198
+ знает и не вправе знать.
199
+
200
+ Парная половина — подкоманда `setup outbox-flush` в поставке MCP
201
+ (dev-репо): она и есть тот триггер, которого не хватало GAP-248 п.2.
202
+
8
203
  ## [0.12.4] — 2026-09-19
9
204
 
10
205
  ### Изменено
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "standkit"
7
- version = "0.12.4"
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.4
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
@@ -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
@@ -81,6 +82,7 @@ standkit_hub/logs_browser.py
81
82
  standkit_hub/mutex.py
82
83
  standkit_hub/pick_dialog.py
83
84
  standkit_hub/poller.py
85
+ standkit_hub/preload.py
84
86
  standkit_hub/redis_min.py
85
87
  standkit_hub/security.py
86
88
  standkit_hub/server.py
@@ -101,6 +103,7 @@ tests/test_agent_security.py
101
103
  tests/test_agent_server_integration.py
102
104
  tests/test_agent_startup_preflight.py
103
105
  tests/test_companion_backend.py
106
+ tests/test_companion_candidates.py
104
107
  tests/test_companion_context.py
105
108
  tests/test_companion_cookbook.py
106
109
  tests/test_companion_fsutil.py
@@ -110,6 +113,10 @@ tests/test_companion_releases.py
110
113
  tests/test_companion_revocations.py
111
114
  tests/test_companion_runner.py
112
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
113
120
  tests/test_health.py
114
121
  tests/test_hosting.py
115
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: