standkit 0.12.4__tar.gz → 0.12.5__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 (150) hide show
  1. {standkit-0.12.4/standkit.egg-info → standkit-0.12.5}/PKG-INFO +1 -1
  2. {standkit-0.12.4 → standkit-0.12.5}/docs/CHANGELOG.md +46 -0
  3. {standkit-0.12.4 → standkit-0.12.5}/pyproject.toml +1 -1
  4. {standkit-0.12.4 → standkit-0.12.5/standkit.egg-info}/PKG-INFO +1 -1
  5. {standkit-0.12.4 → standkit-0.12.5}/standkit.egg-info/SOURCES.txt +2 -0
  6. standkit-0.12.5/standkit_companion/candidates.py +246 -0
  7. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/runner.py +32 -2
  8. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/state.py +17 -0
  9. standkit-0.12.5/tests/test_companion_candidates.py +255 -0
  10. {standkit-0.12.4 → standkit-0.12.5}/tests/test_companion_runner.py +11 -2
  11. {standkit-0.12.4 → standkit-0.12.5}/LICENSE +0 -0
  12. {standkit-0.12.4 → standkit-0.12.5}/MANIFEST.in +0 -0
  13. {standkit-0.12.4 → standkit-0.12.5}/README.md +0 -0
  14. {standkit-0.12.4 → standkit-0.12.5}/SECURITY.md +0 -0
  15. {standkit-0.12.4 → standkit-0.12.5}/docs/ARCHITECTURE.md +0 -0
  16. {standkit-0.12.4 → standkit-0.12.5}/docs/BACKLOG.md +0 -0
  17. {standkit-0.12.4 → standkit-0.12.5}/docs/COOKBOOK_LINUX.md +0 -0
  18. {standkit-0.12.4 → standkit-0.12.5}/docs/GAPs/GAP-001-registry-fields-out-of-hub-form.md +0 -0
  19. {standkit-0.12.4 → standkit-0.12.5}/docs/GAPs/GAP-002-http-probe-down-not-explained.md +0 -0
  20. {standkit-0.12.4 → standkit-0.12.5}/docs/GAPs/GAP-003-redis-endpoint-in-extra.md +0 -0
  21. {standkit-0.12.4 → standkit-0.12.5}/docs/GAPs/GAP-004-cookbook-hub-register-form.md +0 -0
  22. {standkit-0.12.4 → standkit-0.12.5}/docs/GAPs/GAP-005-cookbook-hub-side-secrets.md +0 -0
  23. {standkit-0.12.4 → standkit-0.12.5}/docs/GAPs/GAP-006-log-dir-case-and-separator.md +0 -0
  24. {standkit-0.12.4 → standkit-0.12.5}/docs/GAPs/GAP-007-agent-paths-raw-traceback.md +0 -0
  25. {standkit-0.12.4 → standkit-0.12.5}/docs/GAPs/GAP-008-agent-cert-trust-on-hub.md +0 -0
  26. {standkit-0.12.4 → standkit-0.12.5}/docs/GAPs/README.md +0 -0
  27. {standkit-0.12.4 → standkit-0.12.5}/docs/HOSTING.md +0 -0
  28. {standkit-0.12.4 → standkit-0.12.5}/docs/README.md +0 -0
  29. {standkit-0.12.4 → standkit-0.12.5}/docs/REMOTE_STANDS.md +0 -0
  30. {standkit-0.12.4 → standkit-0.12.5}/docs/ROADMAP.md +0 -0
  31. {standkit-0.12.4 → standkit-0.12.5}/docs/adr/0001-hosting-backends.md +0 -0
  32. {standkit-0.12.4 → standkit-0.12.5}/docs/adr/0002-k8s-backend.md +0 -0
  33. {standkit-0.12.4 → standkit-0.12.5}/docs/adr/0003-remote-log-browsing.md +0 -0
  34. {standkit-0.12.4 → standkit-0.12.5}/docs/adr/0004-iis-site-scoped-lifecycle.md +0 -0
  35. {standkit-0.12.4 → standkit-0.12.5}/docs/adr/0005-companion-transport-in-mit-core.md +0 -0
  36. {standkit-0.12.4 → standkit-0.12.5}/docs/adr/0006-hub-elevated-restart.md +0 -0
  37. {standkit-0.12.4 → standkit-0.12.5}/docs/adr/0007-hub-exit-idle-and-plain-restart.md +0 -0
  38. {standkit-0.12.4 → standkit-0.12.5}/docs/research/companion-v2-cicd-thin-agent.md +0 -0
  39. {standkit-0.12.4 → standkit-0.12.5}/projects.sample.json +0 -0
  40. {standkit-0.12.4 → standkit-0.12.5}/setup.cfg +0 -0
  41. {standkit-0.12.4 → standkit-0.12.5}/standkit/__init__.py +0 -0
  42. {standkit-0.12.4 → standkit-0.12.5}/standkit/adopt.py +0 -0
  43. {standkit-0.12.4 → standkit-0.12.5}/standkit/cli_resolve.py +0 -0
  44. {standkit-0.12.4 → standkit-0.12.5}/standkit/health.py +0 -0
  45. {standkit-0.12.4 → standkit-0.12.5}/standkit/hosting.py +0 -0
  46. {standkit-0.12.4 → standkit-0.12.5}/standkit/lifecycle.py +0 -0
  47. {standkit-0.12.4 → standkit-0.12.5}/standkit/logs.py +0 -0
  48. {standkit-0.12.4 → standkit-0.12.5}/standkit/models.py +0 -0
  49. {standkit-0.12.4 → standkit-0.12.5}/standkit/platform.py +0 -0
  50. {standkit-0.12.4 → standkit-0.12.5}/standkit/registry.py +0 -0
  51. {standkit-0.12.4 → standkit-0.12.5}/standkit/secrets.py +0 -0
  52. {standkit-0.12.4 → standkit-0.12.5}/standkit.egg-info/dependency_links.txt +0 -0
  53. {standkit-0.12.4 → standkit-0.12.5}/standkit.egg-info/entry_points.txt +0 -0
  54. {standkit-0.12.4 → standkit-0.12.5}/standkit.egg-info/requires.txt +0 -0
  55. {standkit-0.12.4 → standkit-0.12.5}/standkit.egg-info/top_level.txt +0 -0
  56. {standkit-0.12.4 → standkit-0.12.5}/standkit_agent/__init__.py +0 -0
  57. {standkit-0.12.4 → standkit-0.12.5}/standkit_agent/__main__.py +0 -0
  58. {standkit-0.12.4 → standkit-0.12.5}/standkit_agent/audit.py +0 -0
  59. {standkit-0.12.4 → standkit-0.12.5}/standkit_agent/security.py +0 -0
  60. {standkit-0.12.4 → standkit-0.12.5}/standkit_agent/server.py +0 -0
  61. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/__init__.py +0 -0
  62. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/__main__.py +0 -0
  63. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/backend.py +0 -0
  64. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/context.py +0 -0
  65. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/cookbook.py +0 -0
  66. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/ed25519.py +0 -0
  67. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/errors.py +0 -0
  68. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/fsutil.py +0 -0
  69. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/mcp_mutex.py +0 -0
  70. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/patterns.py +0 -0
  71. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/releases.py +0 -0
  72. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/revocations.py +0 -0
  73. {standkit-0.12.4 → standkit-0.12.5}/standkit_companion/signature.py +0 -0
  74. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/__init__.py +0 -0
  75. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/__main__.py +0 -0
  76. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/agent_control.py +0 -0
  77. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/assets/bpmkit-icon.ico +0 -0
  78. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/assets/icon.png +0 -0
  79. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/client.py +0 -0
  80. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/config.py +0 -0
  81. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/consent_api.py +0 -0
  82. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/elevated_op.py +0 -0
  83. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/elevation.py +0 -0
  84. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/hub_logging.py +0 -0
  85. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/instance.py +0 -0
  86. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/license_api.py +0 -0
  87. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/logs_browser.py +0 -0
  88. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/mutex.py +0 -0
  89. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/pick_dialog.py +0 -0
  90. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/poller.py +0 -0
  91. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/redis_min.py +0 -0
  92. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/security.py +0 -0
  93. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/server.py +0 -0
  94. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/shortcut.py +0 -0
  95. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/web/app.js +0 -0
  96. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/web/bpmkit-logo-dark.svg +0 -0
  97. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/web/bpmkit-logo.svg +0 -0
  98. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/web/cookbook.html +0 -0
  99. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/web/favicon.png +0 -0
  100. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/web/favicon.svg +0 -0
  101. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/web/index.html +0 -0
  102. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/web/manifest.webmanifest +0 -0
  103. {standkit-0.12.4 → standkit-0.12.5}/standkit_hub/web/style.css +0 -0
  104. {standkit-0.12.4 → standkit-0.12.5}/tests/test_adopt.py +0 -0
  105. {standkit-0.12.4 → standkit-0.12.5}/tests/test_agent_security.py +0 -0
  106. {standkit-0.12.4 → standkit-0.12.5}/tests/test_agent_server_integration.py +0 -0
  107. {standkit-0.12.4 → standkit-0.12.5}/tests/test_agent_startup_preflight.py +0 -0
  108. {standkit-0.12.4 → standkit-0.12.5}/tests/test_companion_backend.py +0 -0
  109. {standkit-0.12.4 → standkit-0.12.5}/tests/test_companion_context.py +0 -0
  110. {standkit-0.12.4 → standkit-0.12.5}/tests/test_companion_cookbook.py +0 -0
  111. {standkit-0.12.4 → standkit-0.12.5}/tests/test_companion_fsutil.py +0 -0
  112. {standkit-0.12.4 → standkit-0.12.5}/tests/test_companion_mcp_mutex.py +0 -0
  113. {standkit-0.12.4 → standkit-0.12.5}/tests/test_companion_patterns.py +0 -0
  114. {standkit-0.12.4 → standkit-0.12.5}/tests/test_companion_releases.py +0 -0
  115. {standkit-0.12.4 → standkit-0.12.5}/tests/test_companion_revocations.py +0 -0
  116. {standkit-0.12.4 → standkit-0.12.5}/tests/test_companion_signature.py +0 -0
  117. {standkit-0.12.4 → standkit-0.12.5}/tests/test_health.py +0 -0
  118. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hosting.py +0 -0
  119. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_agent_control.py +0 -0
  120. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_client_tls.py +0 -0
  121. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_companion_api.py +0 -0
  122. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_config.py +0 -0
  123. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_consent_api.py +0 -0
  124. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_elevated_op.py +0 -0
  125. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_elevation.py +0 -0
  126. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_elevation_ui.py +0 -0
  127. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_exit_idle_restart.py +0 -0
  128. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_fast_paint.py +0 -0
  129. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_instance.py +0 -0
  130. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_license_api.py +0 -0
  131. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_logging.py +0 -0
  132. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_logs_browser.py +0 -0
  133. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_main_elevated.py +0 -0
  134. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_mutex.py +0 -0
  135. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_pick_dialog.py +0 -0
  136. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_pwa_and_compact.py +0 -0
  137. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_redis_min.py +0 -0
  138. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_register.py +0 -0
  139. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_server.py +0 -0
  140. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_settings_field_help.py +0 -0
  141. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_shortcut.py +0 -0
  142. {standkit-0.12.4 → standkit-0.12.5}/tests/test_hub_single_instance.py +0 -0
  143. {standkit-0.12.4 → standkit-0.12.5}/tests/test_lifecycle.py +0 -0
  144. {standkit-0.12.4 → standkit-0.12.5}/tests/test_logs.py +0 -0
  145. {standkit-0.12.4 → standkit-0.12.5}/tests/test_models.py +0 -0
  146. {standkit-0.12.4 → standkit-0.12.5}/tests/test_no_window.py +0 -0
  147. {standkit-0.12.4 → standkit-0.12.5}/tests/test_platform_sid.py +0 -0
  148. {standkit-0.12.4 → standkit-0.12.5}/tests/test_registry.py +0 -0
  149. {standkit-0.12.4 → standkit-0.12.5}/tests/test_registry_resolver.py +0 -0
  150. {standkit-0.12.4 → standkit-0.12.5}/tests/test_secrets.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: standkit
3
- Version: 0.12.4
3
+ Version: 0.12.5
4
4
  Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
5
5
  Author: standkit contributors
6
6
  License-Expression: MIT
@@ -5,6 +5,52 @@
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [0.12.5] — 2026-09-19
9
+
10
+ ### Добавлено
11
+
12
+ - **Обратный проход канала: находки уезжают вендору сами (GAP-260, GAP-248 п.2).**
13
+ Канал Companion работал только НА ПРИЁМ (паттерны, релизы, отзывы, кукбук).
14
+ Локально накопленные находки — очередь `~/.bpmkit/outbox/`, которую пополняют
15
+ `session_note` и `pattern_submit(submit=True)`, — не уезжали НИКОГДА, пока
16
+ пользователь не вызывал `feedback_flush(confirm=True)` руками. Очередь
17
+ сабмишенов у издателя пуста не потому, что нечего слать, а потому что путь
18
+ непроходим для обычного пользователя; при этом ежедневный триаж рассчитан на
19
+ эту очередь как на источник.
20
+
21
+ Новый модуль `standkit_companion/candidates.py` едет **попутчиком** обычного
22
+ тика — ровно как кукбук (GAP-361) и по той же причине: у очереди нет
23
+ собственного расписания, отдельный цикл означал бы ещё один тик, ещё одну
24
+ строку в UI и ещё один повод разбудить машину ради очереди, которая чаще
25
+ всего пуста. Свой слот состояния `state.candidates` и своя строка исхода:
26
+ мешать его в `patterns` значило бы объявлять неудачей синхронизацию
27
+ паттернов из-за того, что находки не уехали.
28
+
29
+ **Очередь читается не отсюда.** Каталог известен и формат JSON, но у очереди
30
+ есть правила, которые пришлось бы повторить: два подкаталога с разными
31
+ капами, счётчик `attempts` с атомарной перезаписью, перенос в `dead/` после
32
+ N отказов, маскирование улик, гейты согласия и генерализации. Вторая копия
33
+ этой логики в другом репозитории разъехалась бы на первом изменении формата
34
+ — и разъехалась бы молча, теряя или дублируя находки. Поэтому Companion
35
+ просит разгрузить очередь ту поставку, которой она принадлежит:
36
+ `bpmkit setup outbox-flush` (новая подкоманда MCP), ровно так же, как зовёт
37
+ `companion-context`.
38
+
39
+ **Офлайн, квота и отсутствие лицензии — не ошибка по построению** (дословное
40
+ требование строки GAP-260): системный отказ транспорта (`offline`,
41
+ `rate_limited`, `no_license`, `feature_disabled`, `insecure_transport`)
42
+ помечается как `skipped`, а не `error`. Красный цикл, который чинится сам
43
+ при следующем тике, обесценивает индикацию. Отправленное до остановки при
44
+ этом считается отправленным и попадает в отчёт.
45
+
46
+ **Согласие не спрашивается здесь и не может быть обойдено отсюда.** Флаги
47
+ `analytics` / `pattern_submission` / `candidate_submission` независимы
48
+ (ADR-0024) и проверяются транспортом на стороне MCP; Companion о них не
49
+ знает и не вправе знать.
50
+
51
+ Парная половина — подкоманда `setup outbox-flush` в поставке MCP
52
+ (dev-репо): она и есть тот триггер, которого не хватало GAP-248 п.2.
53
+
8
54
  ## [0.12.4] — 2026-09-19
9
55
 
10
56
  ### Изменено
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "standkit"
7
- version = "0.12.4"
7
+ version = "0.12.5"
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.4
3
+ Version: 0.12.5
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
@@ -101,6 +102,7 @@ tests/test_agent_security.py
101
102
  tests/test_agent_server_integration.py
102
103
  tests/test_agent_startup_preflight.py
103
104
  tests/test_companion_backend.py
105
+ tests/test_companion_candidates.py
104
106
  tests/test_companion_context.py
105
107
  tests/test_companion_cookbook.py
106
108
  tests/test_companion_fsutil.py
@@ -0,0 +1,246 @@
1
+ # -*- coding: utf-8 -*-
2
+ """Обратный проход канала: разгрузка локальной очереди находок вендору
3
+ (GAP-260, GAP-248 п.2) — попутчик обычного тика, рядом с кукбуком.
4
+
5
+ **Что здесь чинится.** Канал Companion до сих пор работал только НА ПРИЁМ:
6
+ тянул паттерны, релизы, отзывы и кукбук. Локально накопленные находки
7
+ (`~/.bpmkit/outbox/` — письма обратной связи и кандидаты паттернов, которые
8
+ пишут `session_note`/`pattern_submit(submit=True)`) не уезжали НИКОГДА, пока
9
+ пользователь не вызывал `feedback_flush(confirm=True)` руками. Очередь на
10
+ бэкенде пуста не потому, что нечего слать, а потому что путь непроходим для
11
+ обычного пользователя (GAP-248) — при этом ежедневный триаж издателя
12
+ рассчитан на эту очередь как на источник.
13
+
14
+ **Почему мы НЕ читаем `~/.bpmkit/outbox/` сами.** Соблазн очевиден: каталог
15
+ известен, формат — JSON. Но очередь принадлежит MCP, и у неё есть правила,
16
+ которые здесь пришлось бы повторить: два подкаталога с разными капами,
17
+ счётчик `attempts` с атомарной перезаписью, перенос в `dead/` после N
18
+ отказов, маскирование улик, гейты согласия и генерализации, формат письма.
19
+ Вторая копия этой логики в другом репозитории разъедется на первом же
20
+ изменении формата, и разъедется молча — находки начнут теряться или
21
+ дублироваться. Поэтому Companion зовёт ту же поставку, которой очередь и
22
+ принадлежит: `bpmkit setup outbox-flush`, ровно так же, как зовёт
23
+ `companion-context`. Транспорт (`feedback.flush_outbox`) уже существует,
24
+ отлажен и НИКОГДА не теряет файл — ему нужен был только тот, кто его
25
+ запускает.
26
+
27
+ **Офлайн, квота и отсутствие лицензии — не ошибка по построению.** Требование
28
+ строки GAP-260 дословно. `flush_outbox` возвращает системный отказ полем
29
+ `stopped_reason` (`offline` / `rate_limited` / `no_license` /
30
+ `feature_disabled` / `insecure_transport`) и не бросает исключений: «сейчас не
31
+ уехало» — штатный исход фонового прохода. Такой исход помечается в состоянии
32
+ как `skipped`, а не `error`: красный цикл, который чинится сам при следующем
33
+ тике, обесценивает индикацию.
34
+
35
+ **Согласие не спрашивается здесь и не может быть обойдено отсюда.** Флаги
36
+ (`analytics` / `pattern_submission` / `candidate_submission`) независимы
37
+ (ADR-0024) и проверяются транспортом на стороне MCP. Companion не знает о них
38
+ ничего и не вправе знать: единственный способ отправить что-либо отсюда —
39
+ попросить поставку разгрузить очередь, а она откажет сама, если согласия нет.
40
+ """
41
+ from __future__ import annotations
42
+
43
+ import json
44
+ from typing import Callable, Optional
45
+
46
+ from standkit.platform import run_console
47
+
48
+ from .context import find_cli
49
+ from .errors import ChannelError
50
+ from .state import utc_now_iso
51
+
52
+ __all__ = [
53
+ "FLUSH_ARGV_TAIL",
54
+ "SYSTEM_STOP_REASONS",
55
+ "flush",
56
+ ]
57
+
58
+ #: Хвост командной строки поставки. Тот же приём, что `CONTEXT_ARGV_TAIL` у
59
+ #: лицензионного контекста: подкоманда фиксирована здесь, а не собирается по
60
+ #: месту вызова.
61
+ FLUSH_ARGV_TAIL = ("setup", "outbox-flush", "--json")
62
+
63
+ #: Системные причины остановки прохода — это «сейчас не уехало», а не поломка.
64
+ #: Список ДОСЛОВНО повторяет контракт `feedback._flush_pass`; незнакомое
65
+ #: значение сюда не попадает и честно трактуется как ошибка.
66
+ SYSTEM_STOP_REASONS = frozenset({
67
+ "offline",
68
+ "rate_limited",
69
+ "no_license",
70
+ "feature_disabled",
71
+ "insecure_transport",
72
+ })
73
+
74
+ #: Потолок ожидания. Проход идёт по письмам ПО ОДНОМУ с коротким сетевым
75
+ #: таймаутом на каждое, поэтому здесь не «сколько угодно»: попутчик не имеет
76
+ #: права держать тик канала дольше, чем несущая операция.
77
+ FLUSH_TIMEOUT_S = 120
78
+
79
+ #: Максимум записей за проход КАЖДОГО типа. Ограничение осознанное: фоновый
80
+ #: проход не должен превращаться в многоминутную выгрузку накопленного за
81
+ #: месяц — остаток уедет следующим тиком, очередь никуда не денется.
82
+ DEFAULT_LIMIT = 25
83
+
84
+ _DETAIL_LIMIT = 400
85
+
86
+
87
+ def _clip(text: str, limit: int = _DETAIL_LIMIT) -> str:
88
+ text = str(text or "").strip()
89
+ return text if len(text) <= limit else text[: limit - 1] + "…"
90
+
91
+
92
+ def _default_run(argv: list) -> tuple:
93
+ """Запуск поставки через ЕДИНУЮ точку `standkit.platform.run_console` —
94
+ той же формы, что `context._default_run`.
95
+
96
+ Прямой `subprocess.run` здесь ЗАПРЕЩЁН (GAP-138): канал тикает из процесса
97
+ без своей консоли, и каждый тик мигал бы чёрным окном — ровно тот дефект,
98
+ из-за которого у владельца раз в ~12 с всплывали окна поллера. Любое
99
+ исключение (нет файла, таймаут, отказ в доступе) превращается в `rc=-1`:
100
+ вызывающий разбирает ОДИН вид отказа, а не зоопарк исключений
101
+ `subprocess`.
102
+ """
103
+ try:
104
+ proc = run_console(list(argv), capture_output=True, text=True,
105
+ encoding="utf-8", errors="replace",
106
+ timeout=FLUSH_TIMEOUT_S)
107
+ except Exception as exc: # noqa: BLE001 - см. докстринг: один вид отказа наружу
108
+ return -1, "", str(exc)
109
+ rc = proc.returncode if proc.returncode is not None else -1
110
+ return int(rc), proc.stdout or "", proc.stderr or ""
111
+
112
+
113
+ def _parse_stdout(stdout: str) -> dict:
114
+ """Единственная строка JSON из вывода подкоманды.
115
+
116
+ Читается ПОСЛЕДНЯЯ непустая строка, а не весь вывод: поставка может
117
+ напечатать перед ответом предупреждение (например, о нерезолвнутом
118
+ корне пакета), и жёсткий `json.loads(stdout)` ломался бы об него.
119
+ """
120
+ for line in reversed([ln for ln in (stdout or "").splitlines() if ln.strip()]):
121
+ try:
122
+ payload = json.loads(line)
123
+ except ValueError:
124
+ continue
125
+ if isinstance(payload, dict):
126
+ return payload
127
+ raise ChannelError(
128
+ "Ответ подкоманды разгрузки очереди не разобран как JSON — очередь не тронута",
129
+ kind="bad_response",
130
+ detail=_clip(stdout),
131
+ )
132
+
133
+
134
+ def flush(state, settings, *, run: Optional[Callable] = None,
135
+ limit: Optional[int] = DEFAULT_LIMIT) -> dict:
136
+ """Один обратный проход: попросить поставку разгрузить очередь.
137
+
138
+ Возвращает словарь исхода (в состояние он же и оседает); исключение
139
+ наружу не поднимается НИКОГДА, кроме неразобранного ответа — вызывающий
140
+ (`runner._sync_candidates`) ловит и это, но попутчик обязан быть
141
+ безопасным сам по себе.
142
+ """
143
+ block = state.data.setdefault("candidates", {})
144
+ runner = run or _default_run
145
+
146
+ cli = find_cli(settings)
147
+ if not cli:
148
+ # CLI поставки не найден — это НЕ отказ канала: точно так же
149
+ # ведёт себя лицензионный контекст (GAP-273), и чинит это человек
150
+ # в настройках хаба.
151
+ block["last_sync_at"] = utc_now_iso()
152
+ state.mark("candidates", "skipped",
153
+ "CLI BPMkit не найден — очередь находок не разгружалась")
154
+ state.save()
155
+ return {"flushed": False, "reason": "cli_not_found",
156
+ "sent": 0, "failed": 0, "remaining": None}
157
+
158
+ argv = list(cli) + list(FLUSH_ARGV_TAIL)
159
+ if limit is not None:
160
+ argv += ["--limit", str(int(limit))]
161
+
162
+ # `_default_run` не выпускает исключений наружу (таймаут/нет файла → rc=-1),
163
+ # но двойник в тестах вправе бросить — попутчик обязан пережить и это.
164
+ try:
165
+ rc, stdout, stderr = runner(argv)
166
+ except Exception as exc: # noqa: BLE001
167
+ block["last_sync_at"] = utc_now_iso()
168
+ state.mark("candidates", "error", f"CLI BPMkit не запустился: {_clip(str(exc))}")
169
+ state.save()
170
+ return {"flushed": False, "reason": "spawn_error",
171
+ "sent": 0, "failed": 0, "remaining": None}
172
+
173
+ if rc != 0:
174
+ block["last_sync_at"] = utc_now_iso()
175
+ detail = _clip(stderr) or f"код возврата {rc}"
176
+ state.mark("candidates", "error", f"разгрузка очереди отказала: {detail}")
177
+ state.save()
178
+ return {"flushed": False, "reason": "cli_error", "detail": detail,
179
+ "sent": 0, "failed": 0, "remaining": None}
180
+
181
+ payload = _parse_stdout(stdout)
182
+
183
+ if not payload.get("ok"):
184
+ block["last_sync_at"] = utc_now_iso()
185
+ detail = _clip(payload.get("detail") or payload.get("reason") or "без пояснений")
186
+ state.mark("candidates", "error", f"очередь не разгружена: {detail}")
187
+ state.save()
188
+ return {"flushed": False, "reason": payload.get("reason") or "refused",
189
+ "detail": detail, "sent": 0, "failed": 0, "remaining": None}
190
+
191
+ sent = int(payload.get("sent") or 0)
192
+ failed = int(payload.get("failed") or 0)
193
+ remaining = payload.get("remaining")
194
+ stopped = payload.get("stopped_reason") or None
195
+
196
+ block["last_sync_at"] = utc_now_iso()
197
+ block["last_sent"] = sent
198
+ block["last_remaining"] = remaining
199
+
200
+ if stopped in SYSTEM_STOP_REASONS:
201
+ # Ровно требование строки GAP-260: офлайн/квота/нет лицензии не
202
+ # должны быть ошибкой ПО ПОСТРОЕНИЮ. Отправленное до остановки при
203
+ # этом отправлено — об этом и говорим.
204
+ state.mark("candidates", "skipped", _stop_text(stopped, sent, remaining))
205
+ state.save()
206
+ return {"flushed": sent > 0, "reason": stopped, "sent": sent,
207
+ "failed": failed, "remaining": remaining}
208
+
209
+ if stopped:
210
+ state.mark("candidates", "error",
211
+ f"проход очереди остановлен: {_clip(stopped)}")
212
+ state.save()
213
+ return {"flushed": sent > 0, "reason": stopped, "sent": sent,
214
+ "failed": failed, "remaining": remaining}
215
+
216
+ state.mark("candidates", "ok", _ok_text(sent, failed, remaining))
217
+ state.save()
218
+ return {"flushed": sent > 0, "reason": "flushed", "sent": sent,
219
+ "failed": failed, "remaining": remaining}
220
+
221
+
222
+ def _stop_text(reason: str, sent: int, remaining) -> str:
223
+ """Человеческий текст системного отказа — его увидит пользователь в UI."""
224
+ texts = {
225
+ "offline": "нет связи с сервисом издателя",
226
+ "rate_limited": "суточная квота приёмника исчерпана",
227
+ "no_license": "нет лицензии — отправка не выполняется",
228
+ "feature_disabled": "издатель временно не принимает этот тип находок",
229
+ "insecure_transport": "адрес сервиса издателя запрещён политикой транспорта",
230
+ }
231
+ head = texts.get(reason, reason)
232
+ if sent:
233
+ return f"Отправлено находок: {sent}; дальше — {head}"
234
+ left = f", в очереди {remaining}" if isinstance(remaining, int) and remaining else ""
235
+ return f"Находки не отправлены: {head}{left}"
236
+
237
+
238
+ def _ok_text(sent: int, failed: int, remaining) -> str:
239
+ if not sent and not failed:
240
+ return "Очередь находок пуста — отправлять нечего"
241
+ parts = [f"Отправлено находок: {sent}"]
242
+ if failed:
243
+ parts.append(f"отклонено: {failed}")
244
+ if isinstance(remaining, int) and remaining:
245
+ parts.append(f"в очереди: {remaining}")
246
+ return "; ".join(parts)
@@ -54,7 +54,7 @@ from dataclasses import dataclass
54
54
  from pathlib import Path
55
55
  from typing import Callable, Optional
56
56
 
57
- from . import __version__, context, cookbook, patterns, releases, revocations
57
+ from . import __version__, candidates, context, cookbook, patterns, releases, revocations
58
58
  from .backend import BackendClient
59
59
  from .errors import ChannelError, CompanionError, ContextUnavailable, NotModified
60
60
  from .state import STATE_FILE_NAME, CompanionState
@@ -438,10 +438,39 @@ class CompanionRunner:
438
438
  self._state.save()
439
439
  return {"applied": False, "reason": "error", "detail": str(exc)}
440
440
 
441
+ def _sync_candidates(self, settings) -> Optional[dict]:
442
+ """Обратный проход: разгрузка локальной очереди находок вендору
443
+ (GAP-260, GAP-248 п.2 «автоматический flush очереди сабмишенов»).
444
+
445
+ Тем же попутчиком, что кукбук, и по той же причине: у очереди нет
446
+ собственного расписания, она едет на уже состоявшемся пробуждении
447
+ канала. Отдельный цикл означал бы ещё один тик, ещё одну строку в UI и
448
+ ещё один повод разбудить машину — ради очереди, которая чаще всего
449
+ пуста.
450
+
451
+ Направление при этом ПРОТИВОПОЛОЖНОЕ всему остальному каналу, и это
452
+ единственное место, где Companion что-то ОТПРАВЛЯЕТ. Сеть трогает не
453
+ он: он просит поставку (`bpmkit setup outbox-flush`) разгрузить
454
+ очередь, которой она владеет, — см. докстринг `candidates.py`, почему
455
+ читать `~/.bpmkit/outbox/` отсюда своими руками нельзя.
456
+
457
+ Отказ здесь НЕ роняет несущую операцию — ровно как у кукбука: не
458
+ уехали находки — не повод объявить неудачей синхронизацию паттернов
459
+ или проверку релиза, которые уже отработали.
460
+ """
461
+ try:
462
+ return candidates.flush(self._state, settings)
463
+ except Exception as exc: # noqa: BLE001
464
+ # Широко и сознательно, по той же причине, что в `_sync_cookbook`.
465
+ self._state.mark("candidates", "error", str(exc))
466
+ self._save_state()
467
+ return {"flushed": False, "reason": "error", "detail": str(exc)}
468
+
441
469
  def _run_patterns(self, session, settings) -> dict:
442
470
  result = patterns.sync(session.client, self._state, session.ctx, settings)
443
471
  if isinstance(result, dict):
444
472
  result["cookbook"] = self._sync_cookbook(session)
473
+ result["candidates"] = self._sync_candidates(settings)
445
474
  return result
446
475
 
447
476
  def _run_releases(self, session, settings) -> dict:
@@ -460,7 +489,8 @@ class CompanionRunner:
460
489
  staged = releases.stage(session.client, self._state, session.ctx,
461
490
  check.get("target") or "latest")
462
491
  return {"check": check, "staged": staged,
463
- "cookbook": self._sync_cookbook(session)}
492
+ "cookbook": self._sync_cookbook(session),
493
+ "candidates": self._sync_candidates(settings)}
464
494
 
465
495
  def _run_revocations(self, session, settings) -> dict:
466
496
  return revocations.refresh(session.client, self._state, session.ctx)
@@ -94,6 +94,19 @@ def _default_state() -> dict:
94
94
  "last_sync_at": None,
95
95
  "installed": None,
96
96
  },
97
+ # Обратный проход канала (GAP-260/GAP-248 п.2): единственный поток,
98
+ # который не ПРИНИМАЕТ, а ОТДАЁТ. Свой слот по той же причине, что у
99
+ # кукбука: у него свой исход («офлайн» здесь — норма, а не ошибка) и
100
+ # своя строка в UI; мешать его в `patterns` значило бы объявлять
101
+ # неудачей синхронизацию паттернов из-за того, что очередь не уехала.
102
+ "candidates": {
103
+ "last_check_at": None,
104
+ "last_status": "never",
105
+ "last_detail": "",
106
+ "last_sync_at": None,
107
+ "last_sent": None,
108
+ "last_remaining": None,
109
+ },
97
110
  "revocations": {
98
111
  "last_check_at": None,
99
112
  "last_status": "never",
@@ -189,6 +202,10 @@ class CompanionState:
189
202
  def cookbook(self) -> dict:
190
203
  return self.data["cookbook"]
191
204
 
205
+ @property
206
+ def candidates(self) -> dict:
207
+ return self.data["candidates"]
208
+
192
209
  def mark(self, section: str, status: str, detail: str = "") -> None:
193
210
  """Единая точка записи исхода тика. `status` — `ok`/`skipped`/`error`/`never`."""
194
211
  block = self.data[section]