standkit 0.12.1__tar.gz → 0.12.3__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.1/standkit.egg-info → standkit-0.12.3}/PKG-INFO +1 -1
- {standkit-0.12.1 → standkit-0.12.3}/docs/CHANGELOG.md +103 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/adr/0007-hub-exit-idle-and-plain-restart.md +77 -6
- {standkit-0.12.1 → standkit-0.12.3}/pyproject.toml +1 -1
- {standkit-0.12.1 → standkit-0.12.3}/standkit/__init__.py +1 -1
- {standkit-0.12.1 → standkit-0.12.3}/standkit/health.py +15 -1
- {standkit-0.12.1 → standkit-0.12.3}/standkit/models.py +64 -1
- {standkit-0.12.1 → standkit-0.12.3/standkit.egg-info}/PKG-INFO +1 -1
- {standkit-0.12.1 → standkit-0.12.3}/standkit.egg-info/SOURCES.txt +2 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/__main__.py +51 -28
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/client.py +34 -14
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/config.py +6 -1
- standkit-0.12.3/standkit_hub/hub_logging.py +153 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/poller.py +13 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/server.py +139 -13
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/web/app.js +66 -10
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/web/index.html +12 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/web/style.css +12 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_health.py +121 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_exit_idle_restart.py +218 -4
- standkit-0.12.3/tests/test_hub_logging.py +198 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_main_elevated.py +18 -11
- {standkit-0.12.1 → standkit-0.12.3}/LICENSE +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/MANIFEST.in +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/README.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/SECURITY.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/ARCHITECTURE.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/BACKLOG.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/COOKBOOK_LINUX.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/GAPs/GAP-001-registry-fields-out-of-hub-form.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/GAPs/GAP-002-http-probe-down-not-explained.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/GAPs/GAP-003-redis-endpoint-in-extra.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/GAPs/GAP-004-cookbook-hub-register-form.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/GAPs/GAP-005-cookbook-hub-side-secrets.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/GAPs/GAP-006-log-dir-case-and-separator.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/GAPs/GAP-007-agent-paths-raw-traceback.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/GAPs/GAP-008-agent-cert-trust-on-hub.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/GAPs/README.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/HOSTING.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/README.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/REMOTE_STANDS.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/ROADMAP.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/adr/0001-hosting-backends.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/adr/0002-k8s-backend.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/adr/0003-remote-log-browsing.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/adr/0004-iis-site-scoped-lifecycle.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/adr/0005-companion-transport-in-mit-core.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/adr/0006-hub-elevated-restart.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/docs/research/companion-v2-cicd-thin-agent.md +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/projects.sample.json +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/setup.cfg +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit/adopt.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit/cli_resolve.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit/hosting.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit/lifecycle.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit/logs.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit/platform.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit/registry.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit/secrets.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit.egg-info/dependency_links.txt +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit.egg-info/entry_points.txt +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit.egg-info/requires.txt +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit.egg-info/top_level.txt +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_agent/__init__.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_agent/__main__.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_agent/audit.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_agent/security.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_agent/server.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/__init__.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/__main__.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/backend.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/context.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/cookbook.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/ed25519.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/errors.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/fsutil.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/mcp_mutex.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/patterns.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/releases.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/revocations.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/runner.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/signature.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_companion/state.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/__init__.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/agent_control.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/assets/bpmkit-icon.ico +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/assets/icon.png +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/consent_api.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/elevated_op.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/elevation.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/instance.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/license_api.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/logs_browser.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/mutex.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/pick_dialog.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/redis_min.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/security.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/shortcut.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/web/bpmkit-logo-dark.svg +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/web/bpmkit-logo.svg +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/web/cookbook.html +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/web/favicon.png +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/web/favicon.svg +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/standkit_hub/web/manifest.webmanifest +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_adopt.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_agent_security.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_agent_server_integration.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_agent_startup_preflight.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_companion_backend.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_companion_context.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_companion_cookbook.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_companion_fsutil.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_companion_mcp_mutex.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_companion_patterns.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_companion_releases.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_companion_revocations.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_companion_runner.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_companion_signature.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hosting.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_agent_control.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_client_tls.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_companion_api.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_config.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_consent_api.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_elevated_op.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_elevation.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_elevation_ui.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_fast_paint.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_instance.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_license_api.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_logs_browser.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_mutex.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_pick_dialog.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_pwa_and_compact.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_redis_min.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_register.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_server.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_settings_field_help.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_shortcut.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_hub_single_instance.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_lifecycle.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_logs.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_models.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_no_window.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_platform_sid.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_registry.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/tests/test_registry_resolver.py +0 -0
- {standkit-0.12.1 → standkit-0.12.3}/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.3
|
|
4
4
|
Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
|
|
5
5
|
Author: standkit contributors
|
|
6
6
|
License-Expression: MIT
|
|
@@ -5,6 +5,109 @@
|
|
|
5
5
|
|
|
6
6
|
## [Unreleased]
|
|
7
7
|
|
|
8
|
+
## [0.12.3] — 2026-09-19
|
|
9
|
+
|
|
10
|
+
### Добавлено
|
|
11
|
+
|
|
12
|
+
- **Транспорт `http` — удалённый стенд без агента (GAP-277).** Кейс владельца
|
|
13
|
+
11.09.2026: стенд, к которому есть только веб-адрес и пароль (`survey9`,
|
|
14
|
+
`https://…:443`), регистрировался как `agent`, потому что других значений в
|
|
15
|
+
`Transport` не было. Хаб опрашивал несуществующего агента, строка висела
|
|
16
|
+
«агент · unknown» с активными кнопками пуск/стоп/рестарт и именем базы,
|
|
17
|
+
состояние которой никто не проверял, — отличить «агент упал» от «агента нет
|
|
18
|
+
и не будет» было невозможно.
|
|
19
|
+
|
|
20
|
+
Значение `http` при этом УЖЕ принимал валидатор `stand_register` на стороне
|
|
21
|
+
MCP (GAP-267 W0), и комментарий там обещал, что оно «зеркалит
|
|
22
|
+
`standkit.models.Transport`». Обещание было ложным: запись создавалась, а
|
|
23
|
+
диспетчер падал на ней в `NotImplementedError`. Теперь зеркало настоящее.
|
|
24
|
+
|
|
25
|
+
- `Transport.HTTP` в модели; `Stand.validate()` не требует у такой записи
|
|
26
|
+
`stand_dir` (его нет по построению — GAP-267 W0 прямо его запрещает) и
|
|
27
|
+
отвергает локальный `stand_host`: у удалённого стенда `127.0.0.1` означает
|
|
28
|
+
«адрес не задан».
|
|
29
|
+
- **Состояние — по честной HTTP-пробе** того же `health.check_stand`, что у
|
|
30
|
+
локальных стендов (`up`/`down` + причина с URL), вместо вечного `unknown`.
|
|
31
|
+
- Пробы процесса, БД и Redis помечаются `SKIPPED` с объяснением «не
|
|
32
|
+
проверяется без агента», а не `UNKNOWN`: `unknown` читается оператором как
|
|
33
|
+
«не смогли узнать, возможно что-то сломалось», и ровно этой подменой
|
|
34
|
+
смысла гэп и был заведён.
|
|
35
|
+
- Кнопки пуск/стоп/рестарт/очистка Redis **выключены** с подсказкой «без
|
|
36
|
+
агента управление процессом недоступно»; тот же текст отдаёт и API вместо
|
|
37
|
+
прежнего «транспорт пока не реализован (TODO)» — управлять процессом
|
|
38
|
+
удалённого стенда, о котором известен только адрес, нечем в принципе, а не
|
|
39
|
+
«пока».
|
|
40
|
+
- Колонка «Транспорт» — «удалённый · http · <хост>»; колонки БД и Redis —
|
|
41
|
+
«—» с той же подсказкой (имя базы из реестра больше не выдаётся за
|
|
42
|
+
проверенный факт).
|
|
43
|
+
- Форма «Зарегистрировать стенд» получила вариант «http — удалённый, без
|
|
44
|
+
агента» с пояснением, чего у такого стенда не будет.
|
|
45
|
+
|
|
46
|
+
### Изменено
|
|
47
|
+
|
|
48
|
+
- **Обратная совместимость записей `agent` без `agent_url` (GAP-277, п.1
|
|
49
|
+
плана).** Такая запись появилась до того, как у диспетчера был транспорт
|
|
50
|
+
`http`, — так регистрировали именно «удалённый стенд, к которому есть только
|
|
51
|
+
адрес», и она давала вечный `unknown`. Теперь она трактуется как `http`
|
|
52
|
+
(`Stand.effective_transport`) и получает честную пробу, а в строке
|
|
53
|
+
показывается предупреждение «запись agent без адреса». Поле реестра при этом
|
|
54
|
+
**не переписывается молча** — интерпретация живёт в рантайме, и оператор
|
|
55
|
+
видит, почему состояние выведено, а не взято буквально.
|
|
56
|
+
|
|
57
|
+
## [0.12.2] — 2026-09-19
|
|
58
|
+
|
|
59
|
+
### Исправлено
|
|
60
|
+
|
|
61
|
+
- **Диспетчер выходил по простою при ЖИВЫХ стендах (GAP-383).** Живой инцидент
|
|
62
|
+
владельца 18.09.2026 20:56: хаб завершился штатно (`request_self_shutdown`),
|
|
63
|
+
три работающих стенда остались без управления, на экране была только ошибка
|
|
64
|
+
связи. Предикат простоя `_IdleShutdownWatcher.has_running_stands()` сравнивал
|
|
65
|
+
`process.state` со строкой `"running"`, **которой в `ProbeState` нет вообще**
|
|
66
|
+
(`ok`/`down`/`unknown`/`skipped`) — то есть на любом реальном снапшоте он
|
|
67
|
+
отвечал «стендов нет», и 30-минутный таймер срабатывал независимо от того,
|
|
68
|
+
сколько стендов работает. Набор тестов оставался зелёным, потому что его
|
|
69
|
+
двойник снапшота подставлял то самое выдуманное `"running"`; теперь двойник
|
|
70
|
+
повторяет поля настоящего `StatusSnapshot`, а отдельный тест-сторож следит,
|
|
71
|
+
что значения `"running"` в `ProbeState` по-прежнему нет.
|
|
72
|
+
Тем же гэпом закрыты два способа принять незнание за пустоту: снапшот-ОТКАЗ
|
|
73
|
+
поллера (`_safe_build`: `stands=[]`, `probed=False`, `error=...`) и
|
|
74
|
+
непробованный слепок реестра (`probed=False`, состояния `pending`) теперь
|
|
75
|
+
трактуются как «стенды есть» — ровно как обещали докстринг предиката и
|
|
76
|
+
ADR-0007 («незнание = остаёмся»).
|
|
77
|
+
- **Автовыход при заменённых под живым процессом файлах пакета (GAP-383).**
|
|
78
|
+
`pip install standkit` поверх работающего диспетчера (владелец сделал это за
|
|
79
|
+
два часа до инцидента) оставляет на диске новый код, а в памяти старый.
|
|
80
|
+
Детект рассинхрона у хаба был (ADR-0007 §4), но автовыход про него не знал.
|
|
81
|
+
Теперь при расхождении версии «с диска» и «из памяти» диспетчер **не
|
|
82
|
+
выходит** по простою: перезапуск остаётся действием человека
|
|
83
|
+
(`POST /api/hub/restart` с открытой страницы), молчаливого самоперезапуска
|
|
84
|
+
фонового процесса не вводится. Ошибка чтения версии — тихий фолбэк, она не
|
|
85
|
+
объявляет рассинхрон и не запрещает автовыход навсегда.
|
|
86
|
+
- **Усыновлённые и поднятые мимо диспетчера стенды считаются живыми
|
|
87
|
+
(GAP-385).** Условие простоя теперь «нет НИ ОДНОГО стенда, живого ПО ФАКТУ
|
|
88
|
+
пробы (`ProbeState.OK`, то есть по порту/pid)», а не «нет запущенных нами».
|
|
89
|
+
Стенд с мёртвым родителем (`standkit.adopt`, бейдж `process.external`) —
|
|
90
|
+
такой же повод остаться: потерять управление им ничуть не лучше, чем своим.
|
|
91
|
+
|
|
92
|
+
### Добавлено
|
|
93
|
+
|
|
94
|
+
- **Лог диспетчера в файл (GAP-384).** Новый модуль `standkit_hub/hub_logging.py`:
|
|
95
|
+
`resolve_log_dir()` (`%LOCALAPPDATA%\BPMkit\logs\hub.log`, на POSIX —
|
|
96
|
+
`$XDG_STATE_HOME`/`~/.local/state`) и ротация 2 МБ × 5. Причина слепоты при
|
|
97
|
+
разборе инцидента была структурной: ярлык запускает диспетчер через
|
|
98
|
+
`pythonw.exe`, у которого `sys.stderr` не подключён никуда (и может быть
|
|
99
|
+
`None`), а все объяснения — «простой N минут», «стоп-запрос», «перехват
|
|
100
|
+
порта» — писались через `print(..., file=sys.stderr)` и существовали ровно
|
|
101
|
+
на время своего вывода. Теперь в файл пишутся: старт и версия, запрос
|
|
102
|
+
штатного выхода, стоп-запрос (включая протухший) и **факты, по которым
|
|
103
|
+
принято решение об автовыходе** — `sse_client_count`, `has_running_stands`,
|
|
104
|
+
`snapshot_probed`, `snapshot_error`; отказ фонового опроса
|
|
105
|
+
(`poller._safe_build`) логируется с трейсбеком; необработанное исключение
|
|
106
|
+
процесса уходит в лог через `sys.excepthook`. Все 16 `print(..., file=sys.stderr)`
|
|
107
|
+
в `standkit_hub/__main__.py` переведены на `logging`. Неудача настройки лога
|
|
108
|
+
старт НЕ прерывает: диспетчер без лога хуже, но несравнимо лучше
|
|
109
|
+
незапустившегося.
|
|
110
|
+
|
|
8
111
|
## [0.12.1] — 2026-09-17
|
|
9
112
|
|
|
10
113
|
### Добавлено
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
# ADR-0007 — Выход из диспетчера, автовыход по простою и перезапуск без повышения прав
|
|
2
2
|
|
|
3
3
|
- Статус: **Принято / реализовано** (v0.12.0, 17.09.2026; постановка владельца Д-3 и
|
|
4
|
-
GAP-276 dev-репо BPMkit).
|
|
4
|
+
GAP-276 dev-репо BPMkit). **Уточнено v0.12.2 (19.09.2026) по живому инциденту
|
|
5
|
+
18.09.2026 20:56** — GAP-383/384/385, см. раздел «Уточнение 19.09.2026» ниже.
|
|
5
6
|
- Контекст-владелец: Владимир Терновский
|
|
6
7
|
- Связано: [ADR-0006](0006-hub-elevated-restart.md) (перезапуск через UAC — вся машинерия
|
|
7
8
|
перезапуска переиспользуется здесь), GAP-229/GAP-284 (именованный мьютекс для
|
|
@@ -61,8 +62,8 @@
|
|
|
61
62
|
|
|
62
63
|
| | вкладка открыта | вкладка закрыта |
|
|
63
64
|
|---|---|---|
|
|
64
|
-
| **есть
|
|
65
|
-
| **нет
|
|
65
|
+
| **есть живые стенды** (`ProbeState.OK` по порту/pid) | работаем | работаем |
|
|
66
|
+
| **нет живых стендов** | работаем | **простой** |
|
|
66
67
|
|
|
67
68
|
Почему И, а не ИЛИ. Закрытая вкладка при живых стендах — штатная работа: стенды подняли
|
|
68
69
|
через диспетчер и ушли ими пользоваться; выйти сейчас значит потерять над ними управление
|
|
@@ -74,9 +75,11 @@
|
|
|
74
75
|
время последнего запроса: SSE держится ровно пока страница открыта, и это единственный
|
|
75
76
|
сигнал, который не приходится угадывать по таймерам опроса.
|
|
76
77
|
|
|
77
|
-
**Незнание трактуется в пользу «остаться»**: поллера
|
|
78
|
-
снапшот
|
|
79
|
-
|
|
78
|
+
**Незнание трактуется в пользу «остаться»**: поллера нет; он ещё не отдал первый снапшот;
|
|
79
|
+
снапшот пришёл с `error` (отказ `_safe_build`); снапшот непробованный (`probed=False`);
|
|
80
|
+
запись стенда не разобралась — во всех этих случаях считаем, что стенды есть. Ошибочно
|
|
81
|
+
оставшийся процесс человек закроет кнопкой; ошибочно закрывшийся уносит с собой
|
|
82
|
+
управление живыми стендами. (Полный перечень и его цена — «Уточнение 19.09.2026».)
|
|
80
83
|
|
|
81
84
|
**`--desktop` — особый случай**: вкладки нет вовсе, окно и есть процесс, SSE-поток может
|
|
82
85
|
пересоздаваться при перерисовке. Признак «никто не смотрит» там недостоверен, поэтому
|
|
@@ -135,6 +138,74 @@ elevated-перезапуск МЕНЯЕТ права процесса и пот
|
|
|
135
138
|
«Основные», `0` выключает.
|
|
136
139
|
- Деинсталляция после «Выхода» проверяется на VM (exe-поставка), а не на хосте издателя.
|
|
137
140
|
|
|
141
|
+
|
|
142
|
+
## Уточнение 19.09.2026 (v0.12.2) — чего этому ADR не хватило в бою
|
|
143
|
+
|
|
144
|
+
Живой инцидент владельца **18.09.2026 20:56**: диспетчер вышел по простою, три работающих
|
|
145
|
+
стенда остались без управления, на экране была только ошибка связи. Решения этого ADR были
|
|
146
|
+
верны; сломалось то, что ниже.
|
|
147
|
+
|
|
148
|
+
### 1. Предикат простоя был тождественно ложным (GAP-383)
|
|
149
|
+
|
|
150
|
+
`has_running_stands()` сравнивал `process.state` со строкой `"running"`, **которой в
|
|
151
|
+
`ProbeState` нет вообще** (`ok`/`down`/`unknown`/`skipped`). На любом реальном снапшоте
|
|
152
|
+
предикат отвечал «стендов нет», и конъюнкция из §2 вырождалась в одно слагаемое: таймер
|
|
153
|
+
срабатывал ровно через 30 минут после закрытия вкладки, сколько бы стендов ни работало.
|
|
154
|
+
|
|
155
|
+
Почему это пережило тесты: двойник снапшота в наборе сам подставлял то же выдуманное
|
|
156
|
+
`"running"`. **Двойник, который беднее оригинала, проверяет не тот объект, что работает у
|
|
157
|
+
пользователя** — теперь `_FakeSnapshot` повторяет поля настоящего `StatusSnapshot`
|
|
158
|
+
(`probed`, `error`), а тест-сторож `test_probe_state_has_no_running_value` следит, чтобы
|
|
159
|
+
значение `"running"` не «вернулось» в код вместе с чьей-нибудь правкой.
|
|
160
|
+
|
|
161
|
+
### 2. Снапшот-отказ читался как пустота (GAP-383)
|
|
162
|
+
|
|
163
|
+
`poller._safe_build` при любом сбое опроса честно возвращает `StatusSnapshot(stands=[],
|
|
164
|
+
probed=False, error=...)`. Формально это «я не знаю», фактически — пустой список, который
|
|
165
|
+
предикат принимал за «стендов нет». Декларация «незнание = остаёмся» в §2 существовала, но
|
|
166
|
+
в коде покрывала только `poller is None` и `snapshot is None`.
|
|
167
|
+
|
|
168
|
+
Теперь она покрывает весь перечень (см. таблицу выше). Цена ошибки несимметрична, и это
|
|
169
|
+
единственный аргумент, который здесь имеет значение: лишний живой процесс закрывается
|
|
170
|
+
кнопкой, лишнее завершение уносит управление стендами и объяснить себя не может.
|
|
171
|
+
|
|
172
|
+
### 3. Автовыход не знал про подмену файлов под живым процессом (GAP-383)
|
|
173
|
+
|
|
174
|
+
За два часа до инцидента владелец сделал `pip install standkit` поверх работающего
|
|
175
|
+
диспетчера. Детект рассинхрона у хаба уже был (§4), но касался только страницы. Автовыход
|
|
176
|
+
шёл прежним путём.
|
|
177
|
+
|
|
178
|
+
**Решение: при рассинхроне версий (диск новее памяти) по простою НЕ выходить.** Плашка
|
|
179
|
+
«перезапустите» и `POST /api/hub/restart` остаются действием ЧЕЛОВЕКА. Молчаливый
|
|
180
|
+
самоперезапуск фонового процесса отвергнут: он относится к тому же классу действий,
|
|
181
|
+
что и разбираемый инцидент — процесс без окна принимает за пользователя решение,
|
|
182
|
+
последствия которого тот увидит как «всё пропало».
|
|
183
|
+
|
|
184
|
+
### 4. Усыновлённые стенды не считались живыми (GAP-385)
|
|
185
|
+
|
|
186
|
+
Условие простоя теперь — «нет НИ ОДНОГО стенда, живого **по факту пробы** (порт/pid)», а не
|
|
187
|
+
«нет запущенных нами». Стенд с мёртвым родителем (`standkit.adopt`, бейдж
|
|
188
|
+
`process.external`) — такой же повод остаться: он работает, и потерять управление им ничуть
|
|
189
|
+
не лучше, чем своим. Это прямое следствие обещания §1 «детей не трогаем»: если выход
|
|
190
|
+
штатно оставляет стенды сиротами, то сироты обязаны удерживать следующий выход.
|
|
191
|
+
|
|
192
|
+
### 5. Причины завершения не доживали до разбора (GAP-384)
|
|
193
|
+
|
|
194
|
+
Диспетчер живёт под `pythonw.exe`, у которого `sys.stderr` не подключён никуда (и бывает
|
|
195
|
+
`None`), а все объяснения этого ADR писались через `print(..., file=sys.stderr)`. Самое
|
|
196
|
+
громкое решение продукта — завершение процесса — было событием, о котором назавтра нельзя
|
|
197
|
+
узнать ничего.
|
|
198
|
+
|
|
199
|
+
Теперь есть `standkit_hub/hub_logging.py` (`%LOCALAPPDATA%\BPMkit\logs\hub.log`, ротация
|
|
200
|
+
2 МБ × 5), и в него пишутся старт с версией, запрос штатного выхода, стоп-запрос, отказ
|
|
201
|
+
фонового опроса с трейсбеком, необработанное исключение — и, главное, **факты, по которым
|
|
202
|
+
принято решение об автовыходе** (`sse_client_count`, `has_running_stands`,
|
|
203
|
+
`snapshot_probed`, `snapshot_error`), а не только сам факт выхода. Решение, записавшее свои
|
|
204
|
+
основания, опровергается за минуту; решение, записавшее вывод, разбирается сутки.
|
|
205
|
+
|
|
206
|
+
Настройка лога не имеет права уронить старт: любая беда — тихий отказ, логгер остаётся
|
|
207
|
+
рабочим объектом.
|
|
208
|
+
|
|
138
209
|
## Отвергнутые варианты
|
|
139
210
|
|
|
140
211
|
- **Иконка в трее с пунктом «Выход».** Отвергнута владельцем ранее и не пересматривалась:
|
|
@@ -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.3"
|
|
8
8
|
description = "Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit."
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
license = "MIT"
|
|
@@ -36,7 +36,7 @@ from dataclasses import dataclass
|
|
|
36
36
|
from pathlib import Path
|
|
37
37
|
from typing import Optional
|
|
38
38
|
|
|
39
|
-
from standkit.models import HostKind, ProbeState, Stand, StandStatus
|
|
39
|
+
from standkit.models import Transport, HostKind, ProbeState, Stand, StandStatus
|
|
40
40
|
|
|
41
41
|
# --- таймауты проб ---------------------------------------------------------
|
|
42
42
|
#
|
|
@@ -431,6 +431,16 @@ def check_stand(
|
|
|
431
431
|
status = StandStatus(name=stand.name)
|
|
432
432
|
|
|
433
433
|
def _probe_process() -> tuple[ProbeState, Optional[str]]:
|
|
434
|
+
# Транспорт http — удалённый стенд БЕЗ агента (GAP-277): процессом
|
|
435
|
+
# управлять нечем и проверять его нечем. Это SKIPPED («проба сознательно
|
|
436
|
+
# не выполнялась»), а не UNKNOWN: UNKNOWN читается оператором как «не
|
|
437
|
+
# смогли узнать, возможно что-то сломалось», и ровно этой подменой
|
|
438
|
+
# смысла гэп и был заведён.
|
|
439
|
+
if stand.effective_transport == Transport.HTTP:
|
|
440
|
+
return ProbeState.SKIPPED, (
|
|
441
|
+
"без агента управление процессом недоступно: у стенда на транспорте "
|
|
442
|
+
"http известен только веб-адрес"
|
|
443
|
+
)
|
|
434
444
|
if stand.host_kind in (HostKind.IIS, HostKind.DOCKER, HostKind.K8S):
|
|
435
445
|
# Проба «процесс» для iis/docker/k8s консультируется с бэкендом
|
|
436
446
|
# хостинга (состояние App Pool / контейнера / деплоймента), а не с
|
|
@@ -499,6 +509,8 @@ def check_stand(
|
|
|
499
509
|
def _probe_db() -> tuple[ProbeState, Optional[str]]:
|
|
500
510
|
# У БД-пробы объяснять пока нечего: адрес есть — проверяем порт, нет —
|
|
501
511
|
# UNKNOWN. Пару возвращает ради единого протокола сборки деталей.
|
|
512
|
+
if stand.effective_transport == Transport.HTTP:
|
|
513
|
+
return ProbeState.SKIPPED, "не проверяется без агента"
|
|
502
514
|
if not (stand.db_host and stand.db_port):
|
|
503
515
|
return ProbeState.UNKNOWN, None
|
|
504
516
|
if deep_db:
|
|
@@ -510,6 +522,8 @@ def check_stand(
|
|
|
510
522
|
# Поля модели в приоритете, ``extra`` — фолбэк: до 0.8.0 адрес Redis
|
|
511
523
|
# жил только в нетипизированном extra, и реестры, заполненные раньше,
|
|
512
524
|
# обязаны продолжать работать без правок (GAP-003).
|
|
525
|
+
if stand.effective_transport == Transport.HTTP:
|
|
526
|
+
return ProbeState.SKIPPED, "не проверяется без агента"
|
|
513
527
|
redis_host = str(stand.redis_host or stand.extra.get("redis_host") or "").strip()
|
|
514
528
|
raw_port = stand.redis_port or stand.extra.get("redis_port") or 0
|
|
515
529
|
try:
|
|
@@ -10,6 +10,10 @@ projects.sample.json в корне репозитория) плюс универ
|
|
|
10
10
|
- "agent" — стенд управляется через удалённый standkit_agent по HTTP
|
|
11
11
|
(используются agent_url / agent_secret_ref, а для TLS-канала до агента —
|
|
12
12
|
agent_ca / agent_verify_tls);
|
|
13
|
+
- "http" — удалённый стенд БЕЗ агента: известен только веб-адрес стенда и
|
|
14
|
+
учётная запись администратора (кейс владельца «нужно работать с удалённым
|
|
15
|
+
стендом, имея только пароль», GAP-267 W0 / GAP-277). Управлять процессом
|
|
16
|
+
такого стенда нечем — доступна только HTTP-проба самого стенда;
|
|
13
17
|
- "ssh" / "winrm" — зарезервировано под будущие транспорты, СХЕМОЙ допускается,
|
|
14
18
|
логика НЕ реализована (бэклог, см. docs/ARCHITECTURE.md).
|
|
15
19
|
"""
|
|
@@ -26,6 +30,13 @@ class Transport(str, Enum):
|
|
|
26
30
|
|
|
27
31
|
LOCAL = "local"
|
|
28
32
|
AGENT = "agent"
|
|
33
|
+
# Удалённый стенд без агента: только веб-адрес + учётка (GAP-277).
|
|
34
|
+
# Значение УЖЕ принимает валидатор stand_register на стороне MCP
|
|
35
|
+
# (BPMkit/server/bpmkit/tools/projects.py, GAP-267 W0) и комментарий там
|
|
36
|
+
# обещает, что оно «зеркалит standkit.models.Transport» — до этой правки
|
|
37
|
+
# обещание было ложным: запись создавалась, а диспетчер падал на ней в
|
|
38
|
+
# NotImplementedError и показывал «агент · unknown».
|
|
39
|
+
HTTP = "http"
|
|
29
40
|
# Задел на будущее — схема допускает значения, реализации пока нет.
|
|
30
41
|
SSH = "ssh"
|
|
31
42
|
WINRM = "winrm"
|
|
@@ -214,6 +225,36 @@ class Stand:
|
|
|
214
225
|
result.update(self.extra)
|
|
215
226
|
return result
|
|
216
227
|
|
|
228
|
+
@property
|
|
229
|
+
def effective_transport(self) -> Transport:
|
|
230
|
+
"""
|
|
231
|
+
Транспорт, по которому НА САМОМ ДЕЛЕ можно дотянуться до стенда.
|
|
232
|
+
|
|
233
|
+
Единственное отличие от поля ``transport`` — обратная совместимость
|
|
234
|
+
(GAP-277, п.1 плана): запись ``transport=agent`` БЕЗ ``agent_url``
|
|
235
|
+
появилась до того, как у диспетчера был транспорт ``http``, — так
|
|
236
|
+
регистрировали именно «удалённый стенд, к которому есть только адрес».
|
|
237
|
+
Агента по такой записи не существует, поэтому опрос уходил в никуда и
|
|
238
|
+
строка висела «агент · unknown». Трактуем её как ``http``: это
|
|
239
|
+
возвращает честную HTTP-пробу вместо вечного unknown.
|
|
240
|
+
|
|
241
|
+
Поле реестра при этом НЕ переписывается молча — интерпретация живёт в
|
|
242
|
+
рантайме, а UI показывает предупреждение (см. ``transport_warning``).
|
|
243
|
+
"""
|
|
244
|
+
if self.transport == Transport.AGENT and not (self.agent_url or "").strip():
|
|
245
|
+
return Transport.HTTP
|
|
246
|
+
return self.transport
|
|
247
|
+
|
|
248
|
+
@property
|
|
249
|
+
def transport_warning(self) -> Optional[str]:
|
|
250
|
+
"""Текст предупреждения для UI, когда запись трактуется не буквально."""
|
|
251
|
+
if self.transport == Transport.AGENT and not (self.agent_url or "").strip():
|
|
252
|
+
return (
|
|
253
|
+
"в реестре указан transport=agent, но адрес агента (agent_url) не задан — "
|
|
254
|
+
"запись читается как удалённый стенд без агента (http)"
|
|
255
|
+
)
|
|
256
|
+
return None
|
|
257
|
+
|
|
217
258
|
def validate(self) -> list[str]:
|
|
218
259
|
"""
|
|
219
260
|
Минимальная валидация записи. Возвращает список текстов ошибок
|
|
@@ -223,7 +264,29 @@ class Stand:
|
|
|
223
264
|
errors: list[str] = []
|
|
224
265
|
if not self.name:
|
|
225
266
|
errors.append("name не может быть пустым")
|
|
226
|
-
|
|
267
|
+
# У стенда на транспорте http локальной папки нет ПО ПОСТРОЕНИЮ
|
|
268
|
+
# (GAP-267 W0 прямо запрещает stand_dir у такой записи), поэтому
|
|
269
|
+
# требовать её здесь значило бы объявить невалидной каждую корректную
|
|
270
|
+
# запись «только адрес и пароль».
|
|
271
|
+
if self.effective_transport == Transport.HTTP and self.transport == Transport.HTTP:
|
|
272
|
+
if self.stand_dir:
|
|
273
|
+
errors.append(
|
|
274
|
+
"transport=http несовместим с stand_dir: у стенда, доступного "
|
|
275
|
+
"только по HTTP-API, нет локальной папки"
|
|
276
|
+
)
|
|
277
|
+
# stand_host/stand_port НЕ проверяются на «заполненность»: у них
|
|
278
|
+
# есть дефолты (127.0.0.1:5000), поэтому пустыми они не бывают и
|
|
279
|
+
# проверка была бы декоративной. Осмысленность адреса для
|
|
280
|
+
# УДАЛЁННОГО стенда ловится на входе — валидатором stand_register
|
|
281
|
+
# (GAP-267 W0), который видит, задал ли адрес человек, — и самой
|
|
282
|
+
# HTTP-пробой, которая честно покажет down.
|
|
283
|
+
if str(self.stand_host).strip() in ("127.0.0.1", "localhost"):
|
|
284
|
+
errors.append(
|
|
285
|
+
"transport=http со stand_host=127.0.0.1/localhost: у удалённого "
|
|
286
|
+
"стенда без агента адрес обязан быть внешним — локальный означает, "
|
|
287
|
+
"что адрес не задан"
|
|
288
|
+
)
|
|
289
|
+
elif not self.stand_dir:
|
|
227
290
|
errors.append("stand_dir не может быть пустым")
|
|
228
291
|
if str(self.stand_scheme).lower() not in ("http", "https"):
|
|
229
292
|
errors.append("stand_scheme должен быть http или https")
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: standkit
|
|
3
|
-
Version: 0.12.
|
|
3
|
+
Version: 0.12.3
|
|
4
4
|
Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
|
|
5
5
|
Author: standkit contributors
|
|
6
6
|
License-Expression: MIT
|
|
@@ -74,6 +74,7 @@ standkit_hub/config.py
|
|
|
74
74
|
standkit_hub/consent_api.py
|
|
75
75
|
standkit_hub/elevated_op.py
|
|
76
76
|
standkit_hub/elevation.py
|
|
77
|
+
standkit_hub/hub_logging.py
|
|
77
78
|
standkit_hub/instance.py
|
|
78
79
|
standkit_hub/license_api.py
|
|
79
80
|
standkit_hub/logs_browser.py
|
|
@@ -123,6 +124,7 @@ tests/test_hub_exit_idle_restart.py
|
|
|
123
124
|
tests/test_hub_fast_paint.py
|
|
124
125
|
tests/test_hub_instance.py
|
|
125
126
|
tests/test_hub_license_api.py
|
|
127
|
+
tests/test_hub_logging.py
|
|
126
128
|
tests/test_hub_logs_browser.py
|
|
127
129
|
tests/test_hub_main_elevated.py
|
|
128
130
|
tests/test_hub_mutex.py
|