# Handoff: `proxy-client` переименован, Ubuntu-приёмка пройдена

Обновлён: 2026-07-21 10:08 EDT.

## Состояние задачи 05

Автоматическая часть готова. Публичное имя изменено с `xray-proxy` на
`proxy-client`. Ручная приёмка на Ubuntu 26.04 с системным Python 3.14 пройдена
на подтверждённо рабочем профиле XHTTP/TLS с ALPN `h3`. Статус тикета остаётся
`ready-for-human`, пока не решено, нужна ли проверка на РЕД ОС, Astra Linux или
Alt Linux.

Тикет: `.scratch/proxy-client/issues/05-package-delivery-and-acceptance.md`.

## Переименование

- stow-пакет: `proxy-client/`;
- CLI: `~/.local/bin/proxy-client`;
- единый пользовательский каталог: `~/.config/proxy-client/`;
- служебный каталог: `~/.local/state/proxy-client/`;
- машинный конфиг и закрытый профиль теперь лежат рядом как `config` и
  `default.url`;
- примеры называются `config.external` и `config.xray`;
- имена тестов, спецификации, задач, README и Bash-модуля приведены к
  `proxy-client`;
- `Xray`, бинарник `xray` и значение `type = xray` сохранены как названия
  конкретного движка.

Поддержка старой раскладки в `install.sh` намеренно не добавлена: публичное имя
изменено до завершения разработки и выпуска. Текущий HOME уже приведён к новой
структуре. Свежая установка заранее создаёт настоящий
`~/.config/proxy-client`, поэтому Stow не может свернуть его в ссылку на
репозиторий.

## Автоматическая проверка

`bash tests/test_proxy_client_full.sh` завершился с кодом 0 после
переименования:

- системный Python 3.14: 79 тестов, `OK`, 61,034 с;
- Bash-интеграция: 8 проверок, `PASS`; `shellcheck` не установлен;
- установка и миграция: `All install tests passed`;
- CPython 3.8 через `uv`: 79 тестов, `OK`, 52,446 с.

Дополнительно прошли синтаксическая проверка shell-файлов и `git diff --check`.

## Текущий HOME

Во время разработки текущий HOME приведён к новой структуре:

- `~/.config/proxy-client` — настоящий каталог;
- `config` и `default.url` — обычные файлы с правами `600`;
- профиль содержит одну непустую строку, его содержимое не выводилось;
- `shell.bash`, `examples` и CLI указывают в новый stow-пакет;
- старые `~/.config/xray-proxy`, `~/.config/proxy/config`,
  `~/.local/bin/xray-proxy` и `~/.local/state/xray-proxy` отсутствуют.

## Ручная приёмка

Подтверждено:

- установлен Xray 26.3.27;
- `proxy-client start` успешно проверяет версию, строит JSON и запускает Xray;
- `proxy-client status` видит управляемый процесс на `127.0.0.1:12334`;
- `xray run -test` сообщает `Configuration OK`;
- встроенное определение внешнего IP работает;
- HTTP CONNECT и SOCKS5h через `127.0.0.1:12334` получают HTTP 200;
- после проверки процесс штатно остановлен командой `proxy-client stop`.

Первый профиль не работал и в исходном клиенте. Его дополнительная диагностика
на Xray 26.3.27 и 25.12.8 не выявила расхождений преобразования; оба клиента
получали от удалённой стороны неверный VLESS-ответ. Понижение версии не помогло.
После замены строки на рабочую H3-профиль сразу прошёл полный сценарий на
26.3.27. Содержимое профилей в Git не попадало, временные копии удалены.

Короткая проверка стабильности H3 также прошла: 120 циклов дали 240 новых HTTP
CONNECT- и SOCKS5h-соединений без ошибок; две одновременные загрузки по 10 МБ
завершились полностью; после 45 секунд простоя оба способа снова получили HTTP
200. Известный сбой первых соединений из XTLS/Xray-core#3673 не воспроизвёлся.
Это не заменяет длительное наблюдение под обычной нагрузкой.

## Следующий шаг

Решить, обязательна ли ручная проверка на доступной системе из семейства РЕД ОС,
Astra Linux или Alt Linux. Если нет, привести статус исходного дизайна и
заявления о поддержке в соответствие с фактически пройденной Ubuntu-приёмкой.

## Git

Переименование зафиксировано коммитом `6e431d8`. Обновления тикета и handoff после
успешной H3-приёмки ещё не закоммичены. Не включать посторонние неотслеживаемые
`agents/.agents/.skill-lock.json` и `scripts/setup-xray-proxy.sh`.