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.
- {standkit-0.12.4/standkit.egg-info → standkit-0.12.8}/PKG-INFO +1 -1
- {standkit-0.12.4 → standkit-0.12.8}/docs/CHANGELOG.md +195 -0
- {standkit-0.12.4 → standkit-0.12.8}/pyproject.toml +1 -1
- {standkit-0.12.4 → standkit-0.12.8}/standkit/__init__.py +1 -1
- {standkit-0.12.4 → standkit-0.12.8/standkit.egg-info}/PKG-INFO +1 -1
- {standkit-0.12.4 → standkit-0.12.8}/standkit.egg-info/SOURCES.txt +7 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/backend.py +54 -3
- standkit-0.12.8/standkit_companion/candidates.py +283 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/cookbook.py +145 -22
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/releases.py +24 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/runner.py +70 -2
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/state.py +17 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/__main__.py +15 -1
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/client.py +8 -9
- standkit-0.12.8/standkit_hub/hub_logging.py +287 -0
- standkit-0.12.8/standkit_hub/preload.py +78 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/server.py +212 -7
- standkit-0.12.8/tests/test_companion_candidates.py +255 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_cookbook.py +14 -5
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_runner.py +11 -2
- standkit-0.12.8/tests/test_conftest_state_barrier.py +96 -0
- standkit-0.12.8/tests/test_gap411_412_415_idle_preload.py +654 -0
- standkit-0.12.8/tests/test_gap413_414_companion_consent_logs.py +510 -0
- standkit-0.12.8/tests/test_gap429_cookbook_installed_version.py +176 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_exit_idle_restart.py +9 -2
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_logging.py +5 -1
- standkit-0.12.4/standkit_hub/hub_logging.py +0 -153
- {standkit-0.12.4 → standkit-0.12.8}/LICENSE +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/MANIFEST.in +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/README.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/SECURITY.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/ARCHITECTURE.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/BACKLOG.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/COOKBOOK_LINUX.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-001-registry-fields-out-of-hub-form.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-002-http-probe-down-not-explained.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-003-redis-endpoint-in-extra.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-004-cookbook-hub-register-form.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-005-cookbook-hub-side-secrets.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-006-log-dir-case-and-separator.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-007-agent-paths-raw-traceback.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/GAP-008-agent-cert-trust-on-hub.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/GAPs/README.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/HOSTING.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/README.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/REMOTE_STANDS.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/ROADMAP.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0001-hosting-backends.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0002-k8s-backend.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0003-remote-log-browsing.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0004-iis-site-scoped-lifecycle.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0005-companion-transport-in-mit-core.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0006-hub-elevated-restart.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/adr/0007-hub-exit-idle-and-plain-restart.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/docs/research/companion-v2-cicd-thin-agent.md +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/projects.sample.json +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/setup.cfg +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit/adopt.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit/cli_resolve.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit/health.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit/hosting.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit/lifecycle.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit/logs.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit/models.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit/platform.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit/registry.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit/secrets.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit.egg-info/dependency_links.txt +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit.egg-info/entry_points.txt +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit.egg-info/requires.txt +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit.egg-info/top_level.txt +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_agent/__init__.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_agent/__main__.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_agent/audit.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_agent/security.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_agent/server.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/__init__.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/__main__.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/context.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/ed25519.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/errors.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/fsutil.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/mcp_mutex.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/patterns.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/revocations.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_companion/signature.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/__init__.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/agent_control.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/assets/bpmkit-icon.ico +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/assets/icon.png +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/config.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/consent_api.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/elevated_op.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/elevation.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/instance.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/license_api.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/logs_browser.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/mutex.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/pick_dialog.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/poller.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/redis_min.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/security.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/shortcut.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/app.js +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/bpmkit-logo-dark.svg +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/bpmkit-logo.svg +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/cookbook.html +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/favicon.png +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/favicon.svg +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/index.html +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/manifest.webmanifest +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/standkit_hub/web/style.css +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_adopt.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_agent_security.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_agent_server_integration.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_agent_startup_preflight.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_backend.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_context.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_fsutil.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_mcp_mutex.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_patterns.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_releases.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_revocations.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_companion_signature.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_health.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hosting.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_agent_control.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_client_tls.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_companion_api.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_config.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_consent_api.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_elevated_op.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_elevation.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_elevation_ui.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_fast_paint.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_instance.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_license_api.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_logs_browser.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_main_elevated.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_mutex.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_pick_dialog.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_pwa_and_compact.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_redis_min.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_register.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_server.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_settings_field_help.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_shortcut.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_hub_single_instance.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_lifecycle.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_logs.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_models.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_no_window.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_platform_sid.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_registry.py +0 -0
- {standkit-0.12.4 → standkit-0.12.8}/tests/test_registry_resolver.py +0 -0
- {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.
|
|
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.
|
|
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"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: standkit
|
|
3
|
-
Version: 0.12.
|
|
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
|
|
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
|
-
|
|
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
|
|
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:
|