standkit 0.7.0__tar.gz → 0.8.0__tar.gz

{standkit-0.7.0/standkit.egg-info → standkit-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: standkit
-Version: 0.7.0
+Version: 0.8.0
 Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
 Author: standkit contributors
 License-Expression: MIT
@@ -120,8 +120,9 @@ TLS, TLS 1.2+/mTLS, скоупы control/readonly, lockout по IP, аудит.
 pip install standkit
 ```
 
-Обновление — `pip install -U standkit`. Свежий `main` до релиза (если нужна ещё не выпущенная
-правка) — `pip install --force-reinstall "git+https://github.com/thinkquattro/BPMkitStand.git"`.
+Обновление — `pip install -U standkit`. Конкретная версия (в том числе откат) —
+`pip install "standkit==0.6.1"`; полный список выпусков — на
+[PyPI](https://pypi.org/project/standkit/).
 
 Запуск дашборда:
 
@@ -146,14 +147,18 @@ BPMkitStand использует тот же реестр, что и MCP BPMkit
 
 ## Документация проекта
 
-- [standkit_hub/web/cookbook.html](standkit_hub/web/cookbook.html) — **кукбук**: обзор, установка (отдельно Windows и Linux), обновление, дашборд, реестр стендов, виды хостинга, удалённые стенды и агент-демон, безопасность, траблшутинг. Один standalone-файл: в работающем диспетчере открывается кнопкой «?» в шапке, без него — прямо с диска в браузере.
-- [docs/ROADMAP.md](docs/ROADMAP.md) — дорожная карта приложения (что сделано / ближайшее / бэклог).
-- [docs/CHANGELOG.md](docs/CHANGELOG.md) — история изменений по версиям.
-- [docs/BACKLOG.md](docs/BACKLOG.md) — честный список «упомянуто в коде, но не реализовано» (заделы/заглушки) со ссылками на код.
-- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) · [docs/HOSTING.md](docs/HOSTING.md) · [docs/REMOTE_STANDS.md](docs/REMOTE_STANDS.md) · [SECURITY.md](SECURITY.md)
-- Решения (ADR): [0001 — hosting backends](docs/adr/0001-hosting-backends.md) · [0002 — k8s backend](docs/adr/0002-k8s-backend.md) · [0003 — браузинг логов удалённых стендов (предложено)](docs/adr/0003-remote-log-browsing.md) · [0004 — IIS: жизненный цикл по Site](docs/adr/0004-iis-site-scoped-lifecycle.md)
+**Карта всех документов — [docs/README.md](docs/README.md)**: кому, о чём и когда открывать.
+Коротко:
 
-> Статус: `standkit` — молодой проект (0.5.x). Ядро/агент/хаб работоспособны, но
+| Документ | Для кого |
+|---|---|
+| [**Кукбук**](standkit_hub/web/cookbook.html) — обзор, установка, дашборд, реестр, хостинг, агент, безопасность, траблшутинг. Один standalone-файл: в работающем диспетчере открывается кнопкой «?» в шапке, без него — прямо с диска в браузере | оператор |
+| [docs/COOKBOOK_LINUX.md](docs/COOKBOOK_LINUX.md) — пошаговое развёртывание агента на Linux: pipx/venv, реестр, секреты, systemd, TLS/mTLS, разбор типичных ошибок с реальными сообщениями | администратор |
+| [docs/REMOTE_STANDS.md](docs/REMOTE_STANDS.md) · [docs/HOSTING.md](docs/HOSTING.md) · [SECURITY.md](SECURITY.md) | оператор / администратор |
+| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) · [docs/adr/](docs/adr/) · [docs/CHANGELOG.md](docs/CHANGELOG.md) | разработчик |
+| [docs/ROADMAP.md](docs/ROADMAP.md) — крупные работы · [docs/BACKLOG.md](docs/BACKLOG.md) — заглушки и заделы в коде · [docs/GAPs/](docs/GAPs/README.md) — код прав, а сценарий оператора ломается | планирование |
+
+> Статус: `standkit` — молодой проект (0.8.x). Ядро/агент/хаб работоспособны, но
 > ряд возможностей — это **каркас/заделы** (например, глубокие пробы БД/Redis,
 > транспорты ssh/winrm, живая приёмка Docker/k8s/IIS). Что именно ещё не
 > дописано — прозрачно перечислено в [docs/BACKLOG.md](docs/BACKLOG.md).

{standkit-0.7.0 → standkit-0.8.0}/README.md

@@ -96,8 +96,9 @@ TLS, TLS 1.2+/mTLS, скоупы control/readonly, lockout по IP, аудит.
 pip install standkit
 ```
 
-Обновление — `pip install -U standkit`. Свежий `main` до релиза (если нужна ещё не выпущенная
-правка) — `pip install --force-reinstall "git+https://github.com/thinkquattro/BPMkitStand.git"`.
+Обновление — `pip install -U standkit`. Конкретная версия (в том числе откат) —
+`pip install "standkit==0.6.1"`; полный список выпусков — на
+[PyPI](https://pypi.org/project/standkit/).
 
 Запуск дашборда:
 
@@ -122,14 +123,18 @@ BPMkitStand использует тот же реестр, что и MCP BPMkit
 
 ## Документация проекта
 
-- [standkit_hub/web/cookbook.html](standkit_hub/web/cookbook.html) — **кукбук**: обзор, установка (отдельно Windows и Linux), обновление, дашборд, реестр стендов, виды хостинга, удалённые стенды и агент-демон, безопасность, траблшутинг. Один standalone-файл: в работающем диспетчере открывается кнопкой «?» в шапке, без него — прямо с диска в браузере.
-- [docs/ROADMAP.md](docs/ROADMAP.md) — дорожная карта приложения (что сделано / ближайшее / бэклог).
-- [docs/CHANGELOG.md](docs/CHANGELOG.md) — история изменений по версиям.
-- [docs/BACKLOG.md](docs/BACKLOG.md) — честный список «упомянуто в коде, но не реализовано» (заделы/заглушки) со ссылками на код.
-- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) · [docs/HOSTING.md](docs/HOSTING.md) · [docs/REMOTE_STANDS.md](docs/REMOTE_STANDS.md) · [SECURITY.md](SECURITY.md)
-- Решения (ADR): [0001 — hosting backends](docs/adr/0001-hosting-backends.md) · [0002 — k8s backend](docs/adr/0002-k8s-backend.md) · [0003 — браузинг логов удалённых стендов (предложено)](docs/adr/0003-remote-log-browsing.md) · [0004 — IIS: жизненный цикл по Site](docs/adr/0004-iis-site-scoped-lifecycle.md)
+**Карта всех документов — [docs/README.md](docs/README.md)**: кому, о чём и когда открывать.
+Коротко:
 
-> Статус: `standkit` — молодой проект (0.5.x). Ядро/агент/хаб работоспособны, но
+| Документ | Для кого |
+|---|---|
+| [**Кукбук**](standkit_hub/web/cookbook.html) — обзор, установка, дашборд, реестр, хостинг, агент, безопасность, траблшутинг. Один standalone-файл: в работающем диспетчере открывается кнопкой «?» в шапке, без него — прямо с диска в браузере | оператор |
+| [docs/COOKBOOK_LINUX.md](docs/COOKBOOK_LINUX.md) — пошаговое развёртывание агента на Linux: pipx/venv, реестр, секреты, systemd, TLS/mTLS, разбор типичных ошибок с реальными сообщениями | администратор |
+| [docs/REMOTE_STANDS.md](docs/REMOTE_STANDS.md) · [docs/HOSTING.md](docs/HOSTING.md) · [SECURITY.md](SECURITY.md) | оператор / администратор |
+| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) · [docs/adr/](docs/adr/) · [docs/CHANGELOG.md](docs/CHANGELOG.md) | разработчик |
+| [docs/ROADMAP.md](docs/ROADMAP.md) — крупные работы · [docs/BACKLOG.md](docs/BACKLOG.md) — заглушки и заделы в коде · [docs/GAPs/](docs/GAPs/README.md) — код прав, а сценарий оператора ломается | планирование |
+
+> Статус: `standkit` — молодой проект (0.8.x). Ядро/агент/хаб работоспособны, но
 > ряд возможностей — это **каркас/заделы** (например, глубокие пробы БД/Redis,
 > транспорты ssh/winrm, живая приёмка Docker/k8s/IIS). Что именно ещё не
 > дописано — прозрачно перечислено в [docs/BACKLOG.md](docs/BACKLOG.md).

{standkit-0.7.0 → standkit-0.8.0}/docs/BACKLOG.md

@@ -9,7 +9,9 @@
 поведения за ним нет (или оно возвращает заглушку).
 
 Порядок дорожной карты — см. [ROADMAP.md](ROADMAP.md). Остаточная безопасность
-агента — `SECURITY.md` §6.
+агента — `SECURITY.md` §6. Отдельный список **гэпов** (код работает как задумано,
+но сценарий оператора всё равно ломается: настройка недоступна, отказ не объяснён,
+рецепт не описан) — [GAPs/](GAPs/README.md).
 
 ## Транспорты подключения к стенду
 
@@ -28,11 +30,19 @@
 |------|--------|-----------------|
 | Глубокая проба БД (`SELECT 1` через psycopg2/pyodbc) | заглушка, всегда `SKIPPED`; флаг `deep_db` из хаба не передаётся | `standkit/health.py::db_deep_check`, параметр `check_stand(deep_db=…)` |
 | Глубокая проба Redis (`PING` через redis-py) | заглушка, всегда `SKIPPED` | `standkit/health.py::redis_deep_check`, `check_stand(deep_redis=…)` |
-| `stand_scheme` / `verify_tls` в форме регистрации дашборда | поля есть в реестре и в пробе, но форма регистрации построена по фиксированному белому списку полей — задать схему можно только правкой `projects.json` | `standkit_hub/server.py::_REGISTER_ALLOWED_FIELDS`, `standkit_hub/web/app.js::_REGISTER_FIELD_NAMES` |
 | `last_deploy` (состояние последнего деплоя) | всегда `UNKNOWN`, источник данных не определён, в UI не выводится | `standkit/health.py::check_stand` (комментарий `last_deploy`), `standkit/models.py::StandStatus.last_deploy` |
 
 Рабочие пробы (без заглушек): процесс (pid/бэкенд), HTTP, БД/Redis по **открытому
-TCP-порту** — их достаточно для дашборда.
+TCP-порту** — их достаточно для дашборда. Причина отказа HTTP-пробы и состояние
+Redis теперь объясняются словами (`details['http_reason']` / `['redis_reason']`),
+а не только цветом.
+
+**Снято отсюда в 0.8.0** (было в этом разделе, закрыто — см. [GAPs/](GAPs/README.md)):
+`stand_scheme`/`verify_tls` и `redis_host`/`redis_port` в форме регистрации
+([GAP-001](GAPs/GAP-001-registry-fields-out-of-hub-form.md),
+[GAP-003](GAPs/GAP-003-redis-endpoint-in-extra.md)), причина отказа HTTP-пробы
+([GAP-002](GAPs/GAP-002-http-probe-down-not-explained.md)), регистр имени
+каталога логов ([GAP-006](GAPs/GAP-006-log-dir-case-and-separator.md)).
 
 ## Жизненный цикл (kestrel)
 
@@ -77,7 +87,7 @@ TCP-порту** — их достаточно для дашборда.
 
 | Пункт | Статус |
 |------|--------|
-| **Агент на Linux** | **первая живая установка 18.08.2026** — Ubuntu 24.04 (`BPM-docker-test`), стенд `survey9` в Docker: установка через pipx, регистрация стенда из Python (`Registry.add_existing`), секреты через `STANDKIT_SECRET__*`, служба systemd, проверка API токеном. Вскрыла: жёсткую схему `http://` в HTTP-пробе (строка выше), отсутствие CLI регистрации (строка выше) и набор типовых ошибок оператора (PEP 668, забытый префикс секрета, владелец `agent.env`, `stand_host=0.0.0.0`, чтение реестра только при старте) — всё разобрано в кукбуке |
+| **Агент на Linux** | **первая живая установка 18.08.2026** — Ubuntu 24.04, стенд в Docker за self-signed HTTPS: установка через pipx, регистрация стенда из Python (`Registry.add_existing`), секреты через `STANDKIT_SECRET__*`, служба systemd, проверка API токеном. Вскрыла: жёсткую схему `http://` в HTTP-пробе (строка выше), отсутствие CLI регистрации (строка выше) и набор типовых ошибок оператора (PEP 668, забытый префикс секрета, владелец `agent.env`, `stand_host=0.0.0.0`, чтение реестра только при старте) — всё разобрано в кукбуке |
 | **Docker** бэкенд (одиночный контейнер + compose) | **живая приёмка проведена 17.08.2026** на Docker Engine 29.6.1: 50 проверок основного цикла (start/stop/restart по фактическому `State.StartedAt`, логи, health, идемпотентность, негативы, работа без `docker` в PATH) + 6 проверок граничных состояний (paused, crash-loop, exited, подстрочные имена сервисов, кириллица в логах). Вскрыла два ложных «стенд жив» — исправлены в этой же ветке (см. CHANGELOG) |
 | **k8s** бэкенд | **живая приёмка проведена 17.08.2026** на кластере k3s 1.30 (k3d): 28 проверок — scale/rollout restart с проверкой пересоздания подов, `readyReplicas`, `k8s_replicas`, логи, NodePort-проба, негативы по деплойменту/namespace/контексту/PATH. Вскрыла ложное «жив» при нуле реплик — исправлено |
 | **IIS** бэкенд | **живая приёмка проведена 17.08.2026** на настоящем стенде BPMSoft 1.9.1.2 (.NET Framework + PostgreSQL) в IIS 10 / .NET Framework 4.8: сайт `iis19` (порт 5081) + вложенное приложение `/0` + сайт-сосед на ТОМ ЖЕ пуле; 66 живых проверок (окружение и автодетект 13, жизненный цикл site-scoped 17, `w3wp` 7, логи 4, отсутствие elevation 10 + 4 кросс-платформенных, ручки хаба 6, граничные состояния канала управления 5). Вскрыла 4 дефекта (пул при автодетекте, `state:Unknown`, ложный диагноз «нет прав», логи в подпапках-датах) — исправлены в этой же ветке, см. CHANGELOG |

{standkit-0.7.0 → standkit-0.8.0}/docs/CHANGELOG.md

@@ -3,6 +3,163 @@
 Формат — [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/); версии —
 [SemVer](https://semver.org/lang/ru/). Даты — 2026 год.
 
+## [0.8.0] — 2026-08-18
+
+> ⚙️ **Требуется действие оператора.** Ничего не ломается при обновлении, но
+> часть улучшений включается полями реестра: `agent_ca` (доверие сертификату
+> агента), `logs_dir` (нестандартный каталог логов), `redis_host`/`redis_port`
+> (адрес Redis). Все они теперь задаются из формы «Зарегистрировать стенд» —
+> править `projects.json` руками не нужно.
+
+### Добавлено
+
+- **Форма «Зарегистрировать стенд» перестала быть уже модели.** В белые списки
+  полей (`standkit_hub/web/app.js::_REGISTER_FIELD_NAMES` и
+  `standkit_hub/server.py::_REGISTER_ALLOWED_FIELDS`) и в разметку добавлены
+  `stand_scheme`, `verify_tls`, `redis_host`, `redis_port`, `logs_dir`,
+  `agent_ca`, `agent_verify_tls`. Чекбокс «Проверять сертификат» виден только
+  при схеме `https`; поля скрытого условного блока на сервер не уходят вовсе, а
+  булев чекбокс отправляется настоящим `true`/`false` — раньше «выключено»
+  приезжало как отсутствующее поле и молча давало дефолт `true`
+  ([GAP-001](GAPs/GAP-001-registry-fields-out-of-hub-form.md)).
+- **Причина отказа HTTP-пробы.** `standkit/health.py` получил `http_probe()` и
+  `HttpProbeResult`; распознаются отказ соединения, таймаут, DNS, ошибка
+  TLS-рукопожатия, непрошедший проверку сертификат, 5xx и «ответ не по
+  протоколу HTTP». Диагноз с фактическим URL кладётся в
+  `StandStatus.details["http_reason"]` — по образцу `process_reason` — и
+  показывается подсказкой к ячейке HTTP в дашборде (пунктирное подчёркивание =
+  причина есть). Для самого частого случая выдаётся рецепт: «похоже, стенд за
+  TLS: задайте `stand_scheme=https` (и `verify_tls=false` для self-signed)».
+  Автодетект схемы сознательно не делался — разбор в
+  [GAP-002](GAPs/GAP-002-http-probe-down-not-explained.md).
+- **`redis_host` / `redis_port` — поля модели `Stand`**, а не нетипизированные
+  ключи `extra`. Пара валидируется целиком (половина пары — явная ошибка, а не
+  молчаливый `unknown`), поля есть в форме и в `projects.sample.json`. В
+  дашборде различаются «адрес Redis не задан в реестре» и «Redis не отвечает на
+  …» ([GAP-003](GAPs/GAP-003-redis-endpoint-in-extra.md)).
+- **`agent_ca` / `agent_verify_tls` — доверие сертификату агента со стороны
+  хаба.** `standkit_hub/client.py` строит SSL-контекст явно
+  (`ssl.create_default_context(cafile=…)`), снятие проверки действует только
+  для `https://`-адресов. Самоподписанный сертификат агента больше не требует
+  `SSL_CERT_FILE`, заданной до старта хаба
+  ([GAP-008](GAPs/GAP-008-agent-cert-trust-on-hub.md)).
+- **`logs_dir`** — явное указание каталога логов стенда в реестре, для
+  нестандартной раскладки ([GAP-006](GAPs/GAP-006-log-dir-case-and-separator.md)).
+- **Preflight путей у агента.** `standkit_agent` проверяет доступность
+  `run_dir`, `log_dir` и файла аудита **до** печати «слушаю …» и до открытия
+  сокета. Шаблон `standkit-agent.service` задаёт все три пути явно и объясняет
+  комментарием, почему это обязательно для сервисного аккаунта, созданного с
+  `--no-create-home` ([GAP-007](GAPs/GAP-007-agent-paths-raw-traceback.md)).
+- **[docs/README.md](README.md) — карта документации:** кому какой документ, чем
+  различаются ROADMAP / BACKLOG / GAPs и куда заводить новую находку.
+- **`docs/COOKBOOK_LINUX.md` — кукбук развёртывания агента на Linux.** Пошагово:
+  PEP 668 и установка через pipx / venv в `/opt`, реестр по явному пути,
+  секреты в файле окружения, первый запуск, проверка API, служба systemd с
+  выделенным сервисным аккаунтом, TLS и mTLS, сетевой периметр, эксплуатация
+  (ротация токена, lockout, смена порта контейнера, аудит). Все команды и все
+  сообщения об ошибках сняты с живого прогона на Ubuntu 24.04, а не составлены
+  по памяти. Отдельные разделы — таблица типичных проблем, клиент на Windows
+  (`curl.exe` / `Invoke-RestMethod`) и чек-лист приёмки.
+- **Кукбук дополнен разделом «Подключение из дашборда оператора»** по итогам
+  живой проверки контура между машинами (дашборд на Windows ↔ агент на Linux):
+  запись реестра оператора с `transport=agent`, токен на стороне оператора,
+  доверие сертификату агента и подтверждённая обратная совместимость хаба 0.6.1
+  с агентом 0.7.0.
+- **`docs/research/companion-v2-cicd-thin-agent.md` — заявка на трек
+  исследования** «CI/CD через тонкого агента»: что уже даёт текущий контракт
+  агента, три варианта границы бесплатного и платного слоя, список того, что
+  придётся спроектировать (долгие операции, идемпотентность, доставка
+  артефакта, версия стенда, откат, права), риски и порядок дешёвых проверок.
+  Решения не приняты — документ фиксирует развилки.
+- **`docs/GAPs/` — реестр гэпов.** Отдельный от бэклога список случаев, где код
+  работает по спецификации, а сценарий оператора всё равно ломается: настройку
+  негде задать, отказ не объяснён, рецепт не описан. Заведены восемь пунктов по
+  итогам живой приёмки 18.08.2026 — и **все восемь закрыты в этом же выпуске**;
+  файлы оставлены с разделом «Как закрыт».
+
+### Исправлено
+
+- **Каталог логов не находился на Linux.** Имя подкаталога искалось жёсткой
+  строкой `"logs"`, а BPMSoft раскладывает логи в `Logs`; на Windows это годами
+  прощала регистронезависимая ФС. Резолв вынесен в
+  `standkit/logs.py::find_logs_subdir` / `stand_logs_dir`: сравнение по
+  `casefold()` через `os.scandir`, точное совпадение регистра в приоритете,
+  никакой жёсткой замены `"logs"` → `"Logs"`. Общей функцией пользуются и хаб,
+  и `IisBackend.read_logs`. Фиксы Windows/IIS — подпапки-даты,
+  `iis_stdout_log_dir`, рекурсивный обход — не тронуты
+  ([GAP-006](GAPs/GAP-006-log-dir-case-and-separator.md)).
+- **Пути POSIX-стендов больше не показываются с обратными слэшами.** Путь
+  удалённого стенда собирался `pathlib.Path` на Windows-хабе, и в сообщение
+  уезжало `\mnt\composers\…` — теперь для POSIX-путей используется
+  `PurePosixPath`.
+- **Для `transport=agent` хаб не врёт «каталог не найден».** Каталог логов
+  живёт на файловой системе хоста стенда, локальная проверка о нём ничего не
+  знает — сообщение говорит это прямо (`logs_unavailable_reason`).
+- **`BadStatusLine` больше не вылетает из HTTP-пробы наружу.** В перехват
+  добавлен `http.client.HTTPException`: он не наследуется от `OSError` и мимо
+  прежнего `except` проходил насквозь.
+- **Агент не падает сырым traceback на служебном запуске.** `PermissionError`
+  на каталоге логов/аудита, отсутствующий `$HOME` у сервисного аккаунта и
+  занятый порт превращаются в одну понятную строку с путём, пользователем и
+  нужным флагом, код возврата `1`. Строка «слушаю …» больше не печатается
+  раньше фактического старта
+  ([GAP-007](GAPs/GAP-007-agent-paths-raw-traceback.md)).
+- **`CERTIFICATE_VERIFY_FAILED` больше не показывается как «агент недоступен».**
+  Различаются недоверенный CA, несовпадение имени с CN/SAN сертификата и
+  ненайденный файл `agent_ca` — у каждого свой рецепт
+  ([GAP-008](GAPs/GAP-008-agent-cert-trust-on-hub.md)).
+- **«слушаю …» печатается после фактической привязки сокета.** `run_server`
+  получил колбэк `on_ready`, который зовётся после bind/listen (и после
+  `wrap_socket` при TLS). Раньше на занятом порту оператор видел «слушаю …»,
+  а следом отказ — журнал читался как «стартовал и сразу упал».
+- **Каталог логов находится и там, где нет права листинга.** Резолв сначала
+  пробует прямой путь (достаточно права прохода `--x`, как было до 0.8.0) и
+  только потом идёт в `os.scandir` за регистронезависимым поиском: каталог
+  стенда с правами `0711` перестал давать ложное «каталог не найден».
+  Отсутствие прав отличается от отсутствия каталога и в тексте сообщения.
+- **Путь Windows-стенда на Linux-хабе** больше не собирается в смесь
+  разделителей (`C:\BPMSoft\stand/logs`) — зеркальный случай к фиксу выше.
+- **IPv6-адрес в тексте причины HTTP-пробы** сохраняет скобки: URL из подсказки
+  снова можно скопировать в браузер.
+- **Windows: агент больше не занимает уже слушаемый порт.** У
+  `ThreadingHTTPServer` включён `SO_REUSEADDR`, и на Windows это разрешает
+  второму процессу занять УЖЕ слушаемый порт — bind проходит, `EADDRINUSE` не
+  возникает, два агента оказываются на одном порту, а входящие соединения
+  распределяются между ними непредсказуемо. Для агента, который по этому порту
+  запускает и останавливает процессы, тихое раздвоение недопустимо. Перед
+  bind'ом на Windows выполняется проба «кто-то уже слушает?», и занятый порт
+  даёт тот же понятный отказ, что и на Linux. `SO_REUSEADDR` при этом не
+  отключается — иначе на Windows ломался бы быстрый перезапуск службы
+  (соединения в TIME_WAIT). Та же грабля для дашборда была разобрана раньше,
+  см. `standkit_hub.server.probe_hub_instance`.
+
+### Изменено
+
+- **Кукбук — вёрстка и читабельность.** Таблица траблшутинга больше не
+  обрезается на десктопе (третья колонка — та, ради которой её читают — была не
+  видна ни в одной строке); липкая шапка перестала прятать навигацию и заголовки
+  разделов на узких экранах; сетки `g2`/`g3`/`g4` дают заявленное число колонок;
+  раскрытая плитка не растягивает соседей в пустые коробки; длинные `<code>` и
+  команды не вылезают за плитку и не вызывают горизонтальный скролл страницы;
+  контраст доведён до WCAG AA в обеих темах без потери фирменных цветов.
+  Сплошные абзацы разобраны на плитки, таблицы и шаги: блоков длиннее пяти
+  строк подряд в одну колонку не осталось.
+- **Кукбук — версия 1.3.** Разбор формы регистрации поле за полем, врезка про
+  то, что при `transport=agent` пробы и старт/стоп делает агент по своей записи
+  реестра, раздел «Токен агента живёт в двух местах» (сторона хаба, формула
+  имени переменной, грабля «переменная задаётся до старта хаба»), подсказки
+  причин в колонках HTTP и Redis, каталог логов и регистр имени, Redis как поля
+  реестра, шесть новых строк в таблице траблшутинга и три новых разбора
+  (отказы старта агента под systemd, недоверенный сертификат агента,
+  «`http: down`, а стенд живой»).
+- **Установка и обновление — только PyPI.** Из README, `docs/REMOTE_STANDS.md`
+  и кукбука убраны команды вида `pip install "git+https://…"`: пакет
+  опубликован на [PyPI](https://pypi.org/project/standkit/), конкретная версия
+  и откат ставятся `pip install "standkit==<версия>"`.
+- Примеры в кукбуке анонимизированы: реальное имя стенда заказчика заменено на
+  `stand-a` во всех вхождениях, включая производные ссылки на секреты и имена
+  переменных окружения. Репозиторий публичный, это правило для новых примеров.
+
 ## [0.7.0] — 2026-08-18
 
 ### Добавлено
@@ -335,6 +492,7 @@
 - Первый публичный релиз ядра `standkit` + агента `standkit_agent` + веб-дашборда
   `standkit_hub` на PyPI; фронт-README, `docs/REMOTE_STANDS.md`, скриншоты.
 
+[0.8.0]: https://pypi.org/project/standkit/0.8.0/
 [0.7.0]: https://pypi.org/project/standkit/0.7.0/
 [0.6.1]: https://pypi.org/project/standkit/0.6.1/
 [0.6.0]: https://pypi.org/project/standkit/0.6.0/