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