standkit 0.12.2__tar.gz → 0.12.4__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 (148) hide show
  1. {standkit-0.12.2/standkit.egg-info → standkit-0.12.4}/PKG-INFO +1 -1
  2. {standkit-0.12.2 → standkit-0.12.4}/docs/CHANGELOG.md +98 -0
  3. {standkit-0.12.2 → standkit-0.12.4}/pyproject.toml +1 -1
  4. {standkit-0.12.2 → standkit-0.12.4}/standkit/health.py +15 -1
  5. {standkit-0.12.2 → standkit-0.12.4}/standkit/models.py +64 -1
  6. {standkit-0.12.2 → standkit-0.12.4/standkit.egg-info}/PKG-INFO +1 -1
  7. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/client.py +34 -14
  8. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/server.py +10 -0
  9. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/web/app.js +145 -22
  10. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/web/index.html +76 -10
  11. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/web/style.css +148 -4
  12. {standkit-0.12.2 → standkit-0.12.4}/tests/test_health.py +121 -0
  13. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_pwa_and_compact.py +102 -0
  14. {standkit-0.12.2 → standkit-0.12.4}/LICENSE +0 -0
  15. {standkit-0.12.2 → standkit-0.12.4}/MANIFEST.in +0 -0
  16. {standkit-0.12.2 → standkit-0.12.4}/README.md +0 -0
  17. {standkit-0.12.2 → standkit-0.12.4}/SECURITY.md +0 -0
  18. {standkit-0.12.2 → standkit-0.12.4}/docs/ARCHITECTURE.md +0 -0
  19. {standkit-0.12.2 → standkit-0.12.4}/docs/BACKLOG.md +0 -0
  20. {standkit-0.12.2 → standkit-0.12.4}/docs/COOKBOOK_LINUX.md +0 -0
  21. {standkit-0.12.2 → standkit-0.12.4}/docs/GAPs/GAP-001-registry-fields-out-of-hub-form.md +0 -0
  22. {standkit-0.12.2 → standkit-0.12.4}/docs/GAPs/GAP-002-http-probe-down-not-explained.md +0 -0
  23. {standkit-0.12.2 → standkit-0.12.4}/docs/GAPs/GAP-003-redis-endpoint-in-extra.md +0 -0
  24. {standkit-0.12.2 → standkit-0.12.4}/docs/GAPs/GAP-004-cookbook-hub-register-form.md +0 -0
  25. {standkit-0.12.2 → standkit-0.12.4}/docs/GAPs/GAP-005-cookbook-hub-side-secrets.md +0 -0
  26. {standkit-0.12.2 → standkit-0.12.4}/docs/GAPs/GAP-006-log-dir-case-and-separator.md +0 -0
  27. {standkit-0.12.2 → standkit-0.12.4}/docs/GAPs/GAP-007-agent-paths-raw-traceback.md +0 -0
  28. {standkit-0.12.2 → standkit-0.12.4}/docs/GAPs/GAP-008-agent-cert-trust-on-hub.md +0 -0
  29. {standkit-0.12.2 → standkit-0.12.4}/docs/GAPs/README.md +0 -0
  30. {standkit-0.12.2 → standkit-0.12.4}/docs/HOSTING.md +0 -0
  31. {standkit-0.12.2 → standkit-0.12.4}/docs/README.md +0 -0
  32. {standkit-0.12.2 → standkit-0.12.4}/docs/REMOTE_STANDS.md +0 -0
  33. {standkit-0.12.2 → standkit-0.12.4}/docs/ROADMAP.md +0 -0
  34. {standkit-0.12.2 → standkit-0.12.4}/docs/adr/0001-hosting-backends.md +0 -0
  35. {standkit-0.12.2 → standkit-0.12.4}/docs/adr/0002-k8s-backend.md +0 -0
  36. {standkit-0.12.2 → standkit-0.12.4}/docs/adr/0003-remote-log-browsing.md +0 -0
  37. {standkit-0.12.2 → standkit-0.12.4}/docs/adr/0004-iis-site-scoped-lifecycle.md +0 -0
  38. {standkit-0.12.2 → standkit-0.12.4}/docs/adr/0005-companion-transport-in-mit-core.md +0 -0
  39. {standkit-0.12.2 → standkit-0.12.4}/docs/adr/0006-hub-elevated-restart.md +0 -0
  40. {standkit-0.12.2 → standkit-0.12.4}/docs/adr/0007-hub-exit-idle-and-plain-restart.md +0 -0
  41. {standkit-0.12.2 → standkit-0.12.4}/docs/research/companion-v2-cicd-thin-agent.md +0 -0
  42. {standkit-0.12.2 → standkit-0.12.4}/projects.sample.json +0 -0
  43. {standkit-0.12.2 → standkit-0.12.4}/setup.cfg +0 -0
  44. {standkit-0.12.2 → standkit-0.12.4}/standkit/__init__.py +0 -0
  45. {standkit-0.12.2 → standkit-0.12.4}/standkit/adopt.py +0 -0
  46. {standkit-0.12.2 → standkit-0.12.4}/standkit/cli_resolve.py +0 -0
  47. {standkit-0.12.2 → standkit-0.12.4}/standkit/hosting.py +0 -0
  48. {standkit-0.12.2 → standkit-0.12.4}/standkit/lifecycle.py +0 -0
  49. {standkit-0.12.2 → standkit-0.12.4}/standkit/logs.py +0 -0
  50. {standkit-0.12.2 → standkit-0.12.4}/standkit/platform.py +0 -0
  51. {standkit-0.12.2 → standkit-0.12.4}/standkit/registry.py +0 -0
  52. {standkit-0.12.2 → standkit-0.12.4}/standkit/secrets.py +0 -0
  53. {standkit-0.12.2 → standkit-0.12.4}/standkit.egg-info/SOURCES.txt +0 -0
  54. {standkit-0.12.2 → standkit-0.12.4}/standkit.egg-info/dependency_links.txt +0 -0
  55. {standkit-0.12.2 → standkit-0.12.4}/standkit.egg-info/entry_points.txt +0 -0
  56. {standkit-0.12.2 → standkit-0.12.4}/standkit.egg-info/requires.txt +0 -0
  57. {standkit-0.12.2 → standkit-0.12.4}/standkit.egg-info/top_level.txt +0 -0
  58. {standkit-0.12.2 → standkit-0.12.4}/standkit_agent/__init__.py +0 -0
  59. {standkit-0.12.2 → standkit-0.12.4}/standkit_agent/__main__.py +0 -0
  60. {standkit-0.12.2 → standkit-0.12.4}/standkit_agent/audit.py +0 -0
  61. {standkit-0.12.2 → standkit-0.12.4}/standkit_agent/security.py +0 -0
  62. {standkit-0.12.2 → standkit-0.12.4}/standkit_agent/server.py +0 -0
  63. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/__init__.py +0 -0
  64. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/__main__.py +0 -0
  65. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/backend.py +0 -0
  66. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/context.py +0 -0
  67. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/cookbook.py +0 -0
  68. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/ed25519.py +0 -0
  69. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/errors.py +0 -0
  70. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/fsutil.py +0 -0
  71. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/mcp_mutex.py +0 -0
  72. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/patterns.py +0 -0
  73. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/releases.py +0 -0
  74. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/revocations.py +0 -0
  75. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/runner.py +0 -0
  76. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/signature.py +0 -0
  77. {standkit-0.12.2 → standkit-0.12.4}/standkit_companion/state.py +0 -0
  78. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/__init__.py +0 -0
  79. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/__main__.py +0 -0
  80. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/agent_control.py +0 -0
  81. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/assets/bpmkit-icon.ico +0 -0
  82. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/assets/icon.png +0 -0
  83. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/config.py +0 -0
  84. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/consent_api.py +0 -0
  85. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/elevated_op.py +0 -0
  86. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/elevation.py +0 -0
  87. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/hub_logging.py +0 -0
  88. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/instance.py +0 -0
  89. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/license_api.py +0 -0
  90. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/logs_browser.py +0 -0
  91. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/mutex.py +0 -0
  92. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/pick_dialog.py +0 -0
  93. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/poller.py +0 -0
  94. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/redis_min.py +0 -0
  95. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/security.py +0 -0
  96. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/shortcut.py +0 -0
  97. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/web/bpmkit-logo-dark.svg +0 -0
  98. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/web/bpmkit-logo.svg +0 -0
  99. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/web/cookbook.html +0 -0
  100. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/web/favicon.png +0 -0
  101. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/web/favicon.svg +0 -0
  102. {standkit-0.12.2 → standkit-0.12.4}/standkit_hub/web/manifest.webmanifest +0 -0
  103. {standkit-0.12.2 → standkit-0.12.4}/tests/test_adopt.py +0 -0
  104. {standkit-0.12.2 → standkit-0.12.4}/tests/test_agent_security.py +0 -0
  105. {standkit-0.12.2 → standkit-0.12.4}/tests/test_agent_server_integration.py +0 -0
  106. {standkit-0.12.2 → standkit-0.12.4}/tests/test_agent_startup_preflight.py +0 -0
  107. {standkit-0.12.2 → standkit-0.12.4}/tests/test_companion_backend.py +0 -0
  108. {standkit-0.12.2 → standkit-0.12.4}/tests/test_companion_context.py +0 -0
  109. {standkit-0.12.2 → standkit-0.12.4}/tests/test_companion_cookbook.py +0 -0
  110. {standkit-0.12.2 → standkit-0.12.4}/tests/test_companion_fsutil.py +0 -0
  111. {standkit-0.12.2 → standkit-0.12.4}/tests/test_companion_mcp_mutex.py +0 -0
  112. {standkit-0.12.2 → standkit-0.12.4}/tests/test_companion_patterns.py +0 -0
  113. {standkit-0.12.2 → standkit-0.12.4}/tests/test_companion_releases.py +0 -0
  114. {standkit-0.12.2 → standkit-0.12.4}/tests/test_companion_revocations.py +0 -0
  115. {standkit-0.12.2 → standkit-0.12.4}/tests/test_companion_runner.py +0 -0
  116. {standkit-0.12.2 → standkit-0.12.4}/tests/test_companion_signature.py +0 -0
  117. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hosting.py +0 -0
  118. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_agent_control.py +0 -0
  119. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_client_tls.py +0 -0
  120. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_companion_api.py +0 -0
  121. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_config.py +0 -0
  122. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_consent_api.py +0 -0
  123. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_elevated_op.py +0 -0
  124. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_elevation.py +0 -0
  125. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_elevation_ui.py +0 -0
  126. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_exit_idle_restart.py +0 -0
  127. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_fast_paint.py +0 -0
  128. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_instance.py +0 -0
  129. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_license_api.py +0 -0
  130. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_logging.py +0 -0
  131. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_logs_browser.py +0 -0
  132. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_main_elevated.py +0 -0
  133. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_mutex.py +0 -0
  134. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_pick_dialog.py +0 -0
  135. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_redis_min.py +0 -0
  136. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_register.py +0 -0
  137. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_server.py +0 -0
  138. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_settings_field_help.py +0 -0
  139. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_shortcut.py +0 -0
  140. {standkit-0.12.2 → standkit-0.12.4}/tests/test_hub_single_instance.py +0 -0
  141. {standkit-0.12.2 → standkit-0.12.4}/tests/test_lifecycle.py +0 -0
  142. {standkit-0.12.2 → standkit-0.12.4}/tests/test_logs.py +0 -0
  143. {standkit-0.12.2 → standkit-0.12.4}/tests/test_models.py +0 -0
  144. {standkit-0.12.2 → standkit-0.12.4}/tests/test_no_window.py +0 -0
  145. {standkit-0.12.2 → standkit-0.12.4}/tests/test_platform_sid.py +0 -0
  146. {standkit-0.12.2 → standkit-0.12.4}/tests/test_registry.py +0 -0
  147. {standkit-0.12.2 → standkit-0.12.4}/tests/test_registry_resolver.py +0 -0
  148. {standkit-0.12.2 → standkit-0.12.4}/tests/test_secrets.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: standkit
3
- Version: 0.12.2
3
+ Version: 0.12.4
4
4
  Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
5
5
  Author: standkit contributors
6
6
  License-Expression: MIT
@@ -5,6 +5,104 @@
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [0.12.4] — 2026-09-19
9
+
10
+ ### Изменено
11
+
12
+ - **Визуальные дефекты диспетчера (GAP-278).** Замечания владельца 11.09.2026
13
+ по скриншотам 0.10.0.
14
+
15
+ - **Шапка (п.1).** Стоял `favicon.svg` — значок «k» 28×28, тот же файл, что
16
+ во вкладке браузера: продукт представлялся обрезанным значком. Теперь
17
+ полный логотип `bpmkit-logo.svg` / `bpmkit-logo-dark.svg`, переключение по
18
+ теме — теми же CSS-правилами, что у логотипа в «О программе» (`.about-logo-*`),
19
+ без скрипта: при смене темы не должно быть кадра со «старой» картинкой.
20
+ Между брендом и названием раздела — тонкий разделитель: «BPMkit» это
21
+ продукт, «Диспетчер стендов» — его раздел, и раньше они читались одной
22
+ слипшейся строкой. В компактном окне логотип уменьшается, а не подменяется
23
+ значком.
24
+ - **Кнопки над таблицей (п.2).** «Обновить» и «Зарегистрировать стенд» были
25
+ отдельной строкой над таблицей и ни с чем не связаны, а «Обновить»
26
+ создавала впечатление, что список сам не обновляется (хотя поллер работает
27
+ по `refresh_interval_sec`). Теперь это **строка заголовка таблицы**: слева
28
+ «Стенды · N», справа — возраст данных, ручное обновление иконкой ↻ и
29
+ основная кнопка «+ Стенд». Возраст снапшота показывается **всегда**
30
+ («обновлено N назад»), а не только при устаревании вдвое: именно отсутствие
31
+ любого признака автообновления и делало кнопку «Обновить» единственным
32
+ видимым способом получить свежие данные. Ручное обновление при этом
33
+ осталось — дождаться следующего тика не всегда приемлемо.
34
+ - **Пустой реестр (п.2).** Показывалась пустая таблица с шапкой колонок —
35
+ экран, на котором нечего делать и непонятно, что делать дальше. Теперь
36
+ крупное «+ Зарегистрировать первый стенд» с объяснением, что диспетчер
37
+ подключает уже установленные стенды, а не создаёт их.
38
+ - **«О программе» (п.3).** Строка «Редакция: с каналом обновлений» — прямой
39
+ перевод внутреннего `edition=companion`, который пользователю ничего не
40
+ говорит. Заменена на «Обновления: подключены / не подключены — <причина>»
41
+ со ссылкой в раздел «Лицензия», когда причина в ней. Текст собирается из
42
+ ДВУХ источников (`/api/version` знает редакцию сборки, `/api/license` —
43
+ состояние лицензии), которые приходят в разное время, поэтому функция
44
+ зовётся из обоих мест и каждый раз берёт то, что уже известно — иначе более
45
+ поздний ответ затирал бы более точный текст более общим.
46
+
47
+ Вторая половина п.3 (версия MCP вместо заглушки «как в поставке») закрыта
48
+ раньше работой GAP-311: `renderMcpVersion` берёт версию из CLI поставки и при
49
+ неудаче честно говорит «неизвестна», в том числе с уточнением «не найден CLI
50
+ BPMkit». Здесь не дублируется.
51
+
52
+ Приёмка гэпа визуальная (скриншоты в светлой и тёмной теме, компактное окно и
53
+ ноутбучный экран) — её тестом не заменить; но элементы, отсутствие которых и
54
+ было жалобой, закреплены статическими проверками разметки, чтобы правка не
55
+ откатилась молча (`tests/test_hub_pwa_and_compact.py`).
56
+
57
+ ## [0.12.3] — 2026-09-19
58
+
59
+ ### Добавлено
60
+
61
+ - **Транспорт `http` — удалённый стенд без агента (GAP-277).** Кейс владельца
62
+ 11.09.2026: стенд, к которому есть только веб-адрес и пароль (`survey9`,
63
+ `https://…:443`), регистрировался как `agent`, потому что других значений в
64
+ `Transport` не было. Хаб опрашивал несуществующего агента, строка висела
65
+ «агент · unknown» с активными кнопками пуск/стоп/рестарт и именем базы,
66
+ состояние которой никто не проверял, — отличить «агент упал» от «агента нет
67
+ и не будет» было невозможно.
68
+
69
+ Значение `http` при этом УЖЕ принимал валидатор `stand_register` на стороне
70
+ MCP (GAP-267 W0), и комментарий там обещал, что оно «зеркалит
71
+ `standkit.models.Transport`». Обещание было ложным: запись создавалась, а
72
+ диспетчер падал на ней в `NotImplementedError`. Теперь зеркало настоящее.
73
+
74
+ - `Transport.HTTP` в модели; `Stand.validate()` не требует у такой записи
75
+ `stand_dir` (его нет по построению — GAP-267 W0 прямо его запрещает) и
76
+ отвергает локальный `stand_host`: у удалённого стенда `127.0.0.1` означает
77
+ «адрес не задан».
78
+ - **Состояние — по честной HTTP-пробе** того же `health.check_stand`, что у
79
+ локальных стендов (`up`/`down` + причина с URL), вместо вечного `unknown`.
80
+ - Пробы процесса, БД и Redis помечаются `SKIPPED` с объяснением «не
81
+ проверяется без агента», а не `UNKNOWN`: `unknown` читается оператором как
82
+ «не смогли узнать, возможно что-то сломалось», и ровно этой подменой
83
+ смысла гэп и был заведён.
84
+ - Кнопки пуск/стоп/рестарт/очистка Redis **выключены** с подсказкой «без
85
+ агента управление процессом недоступно»; тот же текст отдаёт и API вместо
86
+ прежнего «транспорт пока не реализован (TODO)» — управлять процессом
87
+ удалённого стенда, о котором известен только адрес, нечем в принципе, а не
88
+ «пока».
89
+ - Колонка «Транспорт» — «удалённый · http · <хост>»; колонки БД и Redis —
90
+ «—» с той же подсказкой (имя базы из реестра больше не выдаётся за
91
+ проверенный факт).
92
+ - Форма «Зарегистрировать стенд» получила вариант «http — удалённый, без
93
+ агента» с пояснением, чего у такого стенда не будет.
94
+
95
+ ### Изменено
96
+
97
+ - **Обратная совместимость записей `agent` без `agent_url` (GAP-277, п.1
98
+ плана).** Такая запись появилась до того, как у диспетчера был транспорт
99
+ `http`, — так регистрировали именно «удалённый стенд, к которому есть только
100
+ адрес», и она давала вечный `unknown`. Теперь она трактуется как `http`
101
+ (`Stand.effective_transport`) и получает честную пробу, а в строке
102
+ показывается предупреждение «запись agent без адреса». Поле реестра при этом
103
+ **не переписывается молча** — интерпретация живёт в рантайме, и оператор
104
+ видит, почему состояние выведено, а не взято буквально.
105
+
8
106
  ## [0.12.2] — 2026-09-19
9
107
 
10
108
  ### Исправлено
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "standkit"
7
- version = "0.12.2"
7
+ version = "0.12.4"
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
- if not self.stand_dir:
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.2
3
+ Version: 0.12.4
4
4
  Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
5
5
  Author: standkit contributors
6
6
  License-Expression: MIT
@@ -25,7 +25,7 @@ import urllib.error
25
25
  import urllib.request
26
26
  from concurrent.futures import ThreadPoolExecutor
27
27
  from dataclasses import dataclass
28
- from typing import Optional
28
+ from typing import NoReturn, Optional
29
29
 
30
30
  from standkit import health, lifecycle
31
31
  from standkit.models import Stand, StandStatus, Transport
@@ -239,6 +239,26 @@ def _agent_request(
239
239
  STATUS_ALL_MAX_WORKERS = 8
240
240
 
241
241
 
242
+ def _raise_unsupported(stand: Stand, name: str) -> NoReturn:
243
+ """
244
+ Отказ по операции, которой у этого транспорта нет.
245
+
246
+ Для ``http`` (удалённый стенд без агента, GAP-277) это НЕ «пока не
247
+ реализовано»: управлять процессом удалённого стенда, о котором известен
248
+ только веб-адрес, нечем в принципе, и обещание «TODO» вводило в
249
+ заблуждение. Текст отказа совпадает с подсказкой у выключенных кнопок
250
+ диспетчера, чтобы ответ был один и тот же, откуда бы его ни получили.
251
+ """
252
+ if stand.effective_transport == Transport.HTTP:
253
+ raise NotImplementedError(
254
+ f"стенд '{name}': без агента управление процессом недоступно "
255
+ "(транспорт http — известен только веб-адрес стенда)"
256
+ )
257
+ raise NotImplementedError(
258
+ f"Транспорт {stand.transport.value!r} для стенда '{name}' пока не реализован (TODO)"
259
+ )
260
+
261
+
242
262
  class FederatedClient:
243
263
  """
244
264
  Единая точка входа для хаба: даёт список стендов реестра со статусами,
@@ -262,7 +282,15 @@ class FederatedClient:
262
282
  pf = lifecycle.pidfile_path(stand)
263
283
  return health.check_stand(stand, pidfile=pf)
264
284
 
265
- if stand.transport == Transport.AGENT:
285
+ # Транспорт http — удалённый стенд без агента (GAP-277): опрашиваем
286
+ # его РОВНО тем же health.check_stand, что и локальные, — проба HTTP
287
+ # там уже умеет ходить по stand_host/stand_port/stand_scheme, а
288
+ # process/db/redis сама вернёт SKIPPED. Никакого pidfile: локального
289
+ # процесса у такого стенда нет.
290
+ if stand.effective_transport == Transport.HTTP:
291
+ return health.check_stand(stand)
292
+
293
+ if stand.effective_transport == Transport.AGENT:
266
294
  if not stand.agent_url or not stand.agent_secret_ref:
267
295
  raise RemoteCallError(stand.agent_url or "?", "не задан agent_url/agent_secret_ref")
268
296
  token = get_secret(stand.agent_secret_ref)
@@ -271,9 +299,7 @@ class FederatedClient:
271
299
  )
272
300
  return StandStatus.from_dict(data)
273
301
 
274
- raise NotImplementedError(
275
- f"Транспорт {stand.transport.value!r} для стенда '{name}' пока не реализован (TODO)"
276
- )
302
+ _raise_unsupported(stand, name)
277
303
 
278
304
  def _status_or_error(self, name: str) -> StandStatus:
279
305
  """
@@ -343,9 +369,7 @@ class FederatedClient:
343
369
  candidate = data.get("candidate") if isinstance(data, dict) else None
344
370
  return candidate if isinstance(candidate, dict) else None
345
371
 
346
- raise NotImplementedError(
347
- f"Транспорт {stand.transport.value!r} для стенда '{name}' пока не реализован (TODO)"
348
- )
372
+ _raise_unsupported(stand, name)
349
373
 
350
374
  def _agent_action(self, stand: Stand, name: str, action: str, *, query: str = "") -> dict:
351
375
  """POST к агенту стенда с резолвом токена из secretstore (секрет наружу не отдаётся)."""
@@ -385,9 +409,7 @@ class FederatedClient:
385
409
  data = self._agent_action(stand, name, action, query=query)
386
410
  return data.get("pid") if isinstance(data, dict) else None
387
411
 
388
- raise NotImplementedError(
389
- f"Транспорт {stand.transport.value!r} для стенда '{name}' пока не реализован (TODO)"
390
- )
412
+ _raise_unsupported(stand, name)
391
413
 
392
414
  def logs(self, name: str, n: int = 100) -> list[str]:
393
415
  stand = self.registry.get(name)
@@ -406,6 +428,4 @@ class FederatedClient:
406
428
  )
407
429
  return list(data.get("lines", []))
408
430
 
409
- raise NotImplementedError(
410
- f"Транспорт {stand.transport.value!r} для стенда '{name}' пока не реализован (TODO)"
411
- )
431
+ _raise_unsupported(stand, name)
@@ -584,6 +584,16 @@ def _stand_entry(name: str, stand: Stand, status) -> dict:
584
584
  # НА КАКУЮ машину уходит управление. У локальных стендов поля нет (``None``),
585
585
  # а не пустая строка — «не применимо» и «не заполнено» это разные вещи.
586
586
  "agent": (stand.agent_url or None) if stand.transport == Transport.AGENT else None,
587
+ # Хост удалённого стенда без агента (GAP-277) — для колонки
588
+ # «удалённый · http · <хост>». У прочих транспортов ключа нет.
589
+ "remote_host": (
590
+ (stand.stand_host or None)
591
+ if stand.effective_transport == Transport.HTTP
592
+ else None
593
+ ),
594
+ # Предупреждение по записи, которую диспетчер трактует не буквально
595
+ # (legacy agent без agent_url → http, GAP-277). None — трактовка прямая.
596
+ "transport_warning": stand.transport_warning,
587
597
  "status": status_dict,
588
598
  # ``reason`` у http/redis — тот же приём, что у process.reason: без него
589
599
  # наружу уходил голый "down"/"—", и оператор не мог отличить закрытый