chore(scratch): очищен рабочий каталог перед слиянием

- Зачем: - рабочие задачи и handoff не должны попадать в итоговое состояние master. - Что: - удалены временные материалы разработки proxy-client. - добавлен .scratch/.gitkeep для сохранения пустого рабочего каталога. - Проверка: - git diff --cached --check. - find .scratch -mindepth 1 -print.
2026-07-21 11:21:37 -04:00
1 parent 9c2e134fc1
commit fb655f0dc8
@@ -1,100 +0,0 @@
-# Handoff: `proxy-client` переименован, Ubuntu-приёмка пройдена
-
-Обновлён: 2026-07-21 11:13 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 не воспроизвёлся.
-Это не заменяет длительное наблюдение под обычной нагрузкой.
-
-## Документация и установка
-
-Корневой README сокращён до обзора, а `proxy-client/README.md` перестроен по
-пути читателя: установка, выбор режима, настройка, ежедневная работа,
-диагностика и справочник. Установщик заранее создаёт настоящие `~/.local/bin` и
-`~/.config/proxy-client`, чтобы Stow не сворачивал изменяемые каталоги в ссылки
-на репозиторий. Это покрыто свежим HOME и посторонней ссылкой `~/.local`.
-
-## Следующий шаг
-
-Решить, обязательна ли ручная проверка на доступной системе из семейства РЕД ОС,
-Astra Linux или Alt Linux. Если нет, привести статус исходного дизайна и
-заявления о поддержке в соответствие с фактически пройденной Ubuntu-приёмкой.
-
-## Git
-
-Переименование зафиксировано коммитом `6e431d8`, успешная H3-приёмка —
-`bca90c1`. Не включать посторонние неотслеживаемые
-`agents/.agents/.skill-lock.json` и `scripts/setup-xray-proxy.sh`.
@@ -1,70 +0,0 @@
-# 01 — Внешний прокси и переносимый Bash-интерфейс
-
-**What to build:** Самостоятельный пользовательский пакет прокси, через который
-можно безопасно запускать команды с уже работающим внешним прокси, например
-Hiddify. Привычные Bash-команды переходят на единый CLI-контракт, но прежний
-сценарий без машинного конфига продолжает работать.
-
-**Blocked by:** None — can start immediately.
-
-**Status:** done
-
-Часть требований пересмотрена в 06 — см. 06-simplification-pass.md.
-
- [x] CLI работает на Python 3.8+ без сторонних библиотек, ничего не устанавливает
-  и не запускает без явной подкоманды и выдаёт понятную ошибку на более старом
-  Python.
- [x] Машинный INI явно различает типы `external` и `xray`, проверяет имя, адрес,
-  порт и добавку к `NO_PROXY`; отсутствие файла сохраняет внешний прокси
-  `hproxy.local:12334` без неявного переключения на другой тип.
- [x] Канонический машинный INI содержит единственную секцию `[proxy]` и ровно
-  по одному ключу `type`, `name`, `address`, `port`, `no_proxy_extra`:
-
-  ```ini
-  [proxy]
-  type = external
-  name = Hiddify
-  address = hproxy.local
-  port = 12334
-  no_proxy_extra = .example.internal,git.example.internal
-  ```
-
-  Все ключи обязательны при наличии файла; `no_proxy_extra` может быть пустым.
-  Неизвестные секции и ключи, повторы, пропуски, многострочные или содержащие
-  NUL значения, пустые имя или адрес и порт вне диапазона 1–65535 отклоняются.
-  Добавки к `NO_PROXY` задаются через запятую, окружающие пробелы удаляются,
-  пустые элементы отклоняются.
- [x] `address` принимает IPv4, IPv6 без квадратных скобок либо ASCII DNS-имя
-  из корректных непустых меток; схема URL, встроенный порт, скобки, zone ID,
-  пробелы, `/`, `@` и другие URL-разделители отклоняются. При формировании
-  proxy-URL CLI сам заключает IPv6-литерал в квадратные скобки.
- [x] Для типа `external` команды `status`, `env` и `run -- COMMAND ARG...`
-  проверяют только настроенный адрес и порт; недоступный прокси запрещает запуск
-  дочерней команды с понятным сообщением.
- [x] До реализации управляемого процесса конфиг с `type=xray` обрабатывается
-  безопасным отказом: `status`, `env`, `run` и `start` не считают один открытый
-  порт доказательством управляемого Xray и не запускают дочернюю команду.
- [x] `env` при успехе печатает только восемь разрешённых proxy-переменных в двух
-  регистрах, а при ошибке не печатает частичный результат; базовый `NO_PROXY`
-  включает loopback и узел прокси, затем дополняется машинной настройкой.
- [x] Документированный `PROXY_PREFLIGHT_TIMEOUT` сохраняется как положительное
-  число секунд с прежним значением по умолчанию `2` для проверок доступности из
-  `status`, `env` и `run`; ошибочное значение даёт понятный отказ.
- [x] `run` без искажений сохраняет аргументы и код возврата команды, передаёт
-  proxy-переменные только дочернему процессу и возвращает отдельную понятную
-  ошибку, если команда отсутствует в `PATH`.
- [x] Переносимый Bash-модуль становится единственным владельцем `proxy_on`,
-  `proxy_off`, `pclaude`, `pcodex`, `myip` и внутренних proxy-помощников;
-  WSL-функция обновления `hproxy.local` остаётся независимой.
- [x] Обычный запуск dotfiles подключает общий Bash-файл и переносимый
-  proxy-модуль независимо: после установки доступны все пять proxy-команд и
-  `update_hproxy`; подключение одного переносимого модуля без остальных
-  dotfiles также предоставляет все пять proxy-команд.
- [x] Bash-модуль принимает вывод `env` атомарно, проверяет белый список и
-  наличие каждого из восьми ключей ровно один раз, не использует `eval` и при
-  любом неверном выводе оставляет прежние восемь переменных без изменений;
-  `proxy_on` и `proxy_off` больше не делают автоматический запрос внешнего IP.
- [x] Автоматические тесты подтверждают прежний внешний Hiddify-сценарий,
-  fail-fast, оба регистра переменных, настраиваемый `NO_PROXY`, отсутствие
-  протечки окружения, обычное и самостоятельное подключение Bash-модуля,
-  безопасный отказ для `type=xray` и атомарный разбор полного вывода `env`.
@@ -1,74 +0,0 @@
-# 02 — Управляемый Xray: полный штатный путь
-
-**What to build:** Пользователь с уже установленным поддерживаемым Xray кладёт
-одну VLESS-ссылку в закрытый файл и получает полный штатный сценарий локального
-прокси: проверку профиля, запуск на переднем плане, диагностику, запуск команд
-через прокси и штатную остановку.
-
-**Blocked by:** 01 — Внешний прокси и переносимый Bash-интерфейс.
-
-**Status:** done
-
-Часть требований пересмотрена в 06 — см. 06-simplification-pass.md.
-
- [x] `start` разрешён только при явном типе `xray`, требует loopback-адрес и
-  согласованный локальный порт, никогда не скачивает бинарник и выбирает первый
-  `xray` из `PATH`. Один разрешённый путь используется для `version`,
-  `run -test` и основного процесса и показывается перед запуском.
- [x] Успешный `xray version` разбирается только по первой строке в форме
-  `Xray VERSION` с концом строки либо ASCII-пробелом после полного токена
-  версии. Принимаются только `25.12.8` и `26.3.27`; ведущий мусор, похожий
-  префикс вроде `26.3.270`, пустой, неверный или завершившийся ошибкой вывод
-  запрещает преобразование и запуск. Запрошенная или указанная в профиле версия
-  не подменяет фактическую версию выбранного бинарника.
- [x] Профиль берётся из предусмотренного файла по умолчанию либо из явно
-  переданного `-f`, содержит ровно одну VLESS-ссылку, а конечный файл после
-  разрешения симлинка недоступен группе и остальным пользователям.
- [x] Строгий преобразователь поддерживает TCP/RAW с REALITY и XHTTP с TLS,
-  сохраняет все предусмотренные спецификацией поля, отклоняет повторы,
-  любой неизвестный query-параметр, отсутствующие обязательные поля и
-  неподдерживаемые сочетания до запуска Xray.
- [x] Для Xray 26.3.27 корректно обрабатываются `pcs`/`vcn`, а устаревшие
-  `allowInsecure`/`insecure` не переносятся и дают предупреждение; для явно
-  выбранного Xray 25.12.8 сохраняется совместимое insecure-поведение, а новые
-  поля отклоняются без автоматического отката версии.
- [x] `allowInsecure` и `insecure` принимают только точные значения `true` или
-  `false`; при одновременном присутствии значения должны совпадать. Для
-  25.12.8 только согласованное истинное значение включает `allowInsecure` с
-  предупреждением, а для 26.3.27 поле никогда не попадает в JSON и истинное
-  значение предупреждает об обычной проверке сертификата.
- [x] Созданный клиентский JSON слушает только loopback, предоставляет HTTP и
-  SOCKS на одном порту, отключает журнал доступа и проходит `xray run -test`
-  до запуска основного процесса.
- [x] `start` остаётся на переднем плане как супервизор одного дочернего Xray;
-  после запуска процесс жив и порт принимает соединения, а сбой отдельной
-  проверки внешнего IP остаётся предупреждением.
- [x] Штатный `start` создаёт закрытое состояние с PID супервизора и дочернего
-  Xray, разрешённым путём к бинарнику, портом и безопасным отпечатком профиля.
-  `status`, `env`, `run` и `stop` требуют это состояние, живой супервизор,
-  ожидаемый дочерний процесс и настроенный порт; один чужой listener или PID
-  никогда не считается управляемым Xray и не затрагивается.
- [x] `status`, `env`, `run` и `stop` обеспечивают штатный путь управляемого
-  Xray; `run` никогда не запускает его скрыто, а `stop` может завершить
-  управляемый процесс после переключения машинного типа на `external`.
-  Успешный `stop` посылает сигнал супервизору, ограниченно ждёт завершения
-  супервизора и Xray, очищает штатное состояние и возвращает исходный
-  foreground-вызов `start` в терминал.
- [x] Диагностика внешнего IP действительно делает запрос через настроенный
-  локальный HTTP-прокси. Её сбой явно показан как предупреждение и не отменяет
-  уже успешные проверки процесса и порта.
- [x] Безопасная сводка показывает только полезные несекретные свойства
-  профиля; XHTTP `path` показывается только как скрытое значение с длиной, а
-  UUID, ключи, short ID и другие секреты — без фрагментов исходного значения.
-  Полная VLESS-ссылка и уникальные секреты отсутствуют в stdout, stderr и argv
-  дочерних процессов при успехе, любом отказе разбора и сбое `run -test`.
- [x] Модульные и интеграционные тесты покрывают обе семьи ссылок, варианты
-  ALPN, типичную ссылку Hiddify XHTTP/TLS, обе поддержанные версии Xray и
-  понятные отказы на неподдерживаемом вводе.
- [x] Чёрный ящик для каждой поддержанной версии доказывает полный порядок:
-  профиль по умолчанию и `-f`, `version`, успешный `run -test` до основного
-  запуска, живое управляемое состояние и порт, `status`, `env`, дочернюю
-  команду через `run`, проксированную IP-диагностику, `stop` и ограниченное
-  завершение исходного `start`. Через один настроенный локальный порт реально
-  завершаются отдельный HTTP-proxy-запрос и отдельный SOCKS-proxy-запрос.
-  Подмена порта или состояния чужим процессом даёт безопасный отказ.
@@ -1,132 +0,0 @@
-# 03 — Безопасный жизненный цикл управляемого процесса
-
-**What to build:** Управляемый Xray предсказуемо переживает повторные команды,
-сигналы, устаревшее состояние и аварийное исчезновение супервизора, не
-затрагивая чужие процессы и не оставляя секретных данных вне закрытого
-служебного каталога.
-
-**Blocked by:** 02 — Управляемый Xray: полный штатный путь; 06 — Упрощение.
-
-**Status:** done
-
-**Резолюция (2026-07-20):** реализовано и принято. Дельта: CLI 976→1235,
-тесты 437→521 + 799→1112; сьюты: 49 unittest OK + 8 shell PASS (baseline
-34/8). Конвейер: spec-ревью постановки (NEEDS_REWORK, 7 MAJOR + 3 MINOR —
-постановка переписана до реализации) → реализация на medium → саморевью
-(3 находки, починены) → слепые ревью: TASK 1 MINOR + 2 NIT, CODE 4 MAJOR +
-1 MINOR (гонки идентичности/очистки) → триаж: FIXED 8, REJECTED 0 → обе
-перепроверки FIXES_CONFIRMED.
-
-## Модель идентичности процессов
-
-Идентичность определяется отдельно для ребёнка-Xray и для супервизора;
-«обход argv в поисках любого совпадения» (`verify_managed_state`) заменяется
-этим механизмом.
-
- **Общее для обоих:** PID + время старта. Время старта — поле 22
-  (`starttime`) из `/proc/PID/stat`, целое число тиков с момента загрузки;
-  хранится в state как есть и сравнивается на точное равенство. Парсер
-  обязан сначала изолировать поле `comm` по последней `)` (comm может
-  содержать пробелы и скобки) и только потом индексировать поля; любая
-  ошибка чтения/разбора трактуется как несовпадение (fail-closed).
- **Ребёнок Xray:** канонический путь `/proc/PID/exe` (realpath) совпадает
-  с сохранённым `xray_path`.
- **Супервизор:** его exe — интерпретатор Python, поэтому проверяется
-  иначе: в state сохраняется канонический путь скрипта CLI
-  (`supervisor_path`, realpath на момент старта); при проверке операнд
-  скрипта из `/proc/PID/cmdline` резолвится (относительные пути — через
-  `/proc/PID/cwd`) и сравнивается с `supervisor_path`. Поддерживаемые формы
-  запуска (относительный путь, PATH, симлинк) не ломаются — сравнение
-  идёт по realpath.
- **Границы загрузки:** в state сохраняется `boot_id`
-  (`/proc/sys/kernel/random/boot_id`). Несовпадение с текущим означает
-  устаревшее состояние: записанные PID трактуются как мёртвые, сигналы не
-  посылаются.
- **Гонка check-then-kill:** непосредственно перед каждым `os.kill`
-  идентичность перечитывается заново; несовпадение — отказ без сигнала.
-  Остаточная гонка «процесс умер между перечиткой и kill» принята как риск
-  модели доверенных пользователей (pidfd не используем: Python 3.8+,
-  переносимость).
-
-## Чекбоксы
-
- [x] Взаимное исключение: супервизор на всё время жизни держит
-  неблокирующий эксклюзивный `fcntl.flock` на lock-файле в служебном
-  каталоге. Второй одновременный `start` завершается понятным отказом, не
-  запуская процессов и не трогая чужие state/конфиг. `state.json` остаётся
-  данными для восстановления после сбоя, а не механизмом блокировки.
-  Последовательные повторный `start` и смена профиля при живом экземпляре
-  по-прежнему отвергаются.
- [x] Схема state (права 0600, каталоги 0700) — ровно эти ключи:
-  `supervisor_pid`, `xray_pid`, `xray_path`, `config_path`, `address`,
-  `port` (существующие) + `supervisor_path`, `supervisor_starttime`,
-  `xray_starttime`, `boot_id` (новые). Ссылка VLESS и её секреты в state
-  не попадают.
- [x] `status` и `stop` применяют модель идентичности выше; чужой,
-  устаревший или переиспользованный PID не признаётся управляемым
-  процессом (в пределах принятой остаточной гонки).
- [x] Три исхода проверки состояния, у каждого — своё поведение:
-  1. **Здоровая пара** (супервизор и ребёнок живы, идентичность
-     подтверждена): `stop` сигналит супервизору, как сейчас.
-  2. **Сирота** (супервизор исчез, ребёнок жив и подтверждён по
-     PID + starttime + boot_id + exe): `stop` сигналит ребёнку напрямую и
-     удаляет state и сгенерированный конфиг; доступность порта для этого
-     НЕ требуется. `status` — отдельная ненулевая диагностика «сирота»;
-     `env` и `run` — отказ.
-  3. **Непроверяемое/устаревшее состояние:** если записанный PID жив, но
-     идентичность не подтверждена — никаких сигналов, state сохраняется,
-     диагностика с инструкцией ручного удаления; если записанные PID
-     мертвы (или boot_id не совпал) — безопасная очистка устаревших
-     файлов разрешена.
- [x] Конфликт локального порта: `start` при уже занятом порте завершается
-  ненулевым кодом, диагностика называет порт занятым/недоступным, чужой
-  слушатель не затронут, свои сгенерированные файлы убраны. Инспекция
-  владения слушателем (/proc/net/tcp) запрещена.
- [x] Секреты: полная VLESS-ссылка никуда не персистится; UUID, ключи,
-  секретоподобные значения отсутствуют в stdout, stderr, argv,
-  `state.json` и lock-файле. Единственное допустимое место — `client.json`
-  с правами 0600 внутри каталога 0700; он удаляется при штатном завершении
-  и при `stop` сироты.
- [x] Автоматические тесты (без root, на обычной dev-машине):
-  - блокировка: удержанный извне flock → `start` отказывает, ничего не
-    запустив и не изменив;
-  - переиспользованный PID моделируется правкой сохранённого `starttime`
-    у живого процесса (реальную гонку PID не воспроизводим); отдельно —
-    мёртвый PID, неверный исполняемый файл, несовпавший `boot_id`;
-  - SIGKILL супервизора → `stop` добивает подтверждённого сироту и чистит
-    state/конфиг;
-  - занятый порт (заранее открытый сокет) → контракт из чекбокса выше;
-  - юнит-тест парсера `/proc/PID/stat` на синтетических `comm` с
-    пробелами и `)`;
-  - фикстура фейкового Xray адаптирована под проверку `/proc/PID/exe`
-    (ребёнок должен быть настоящим исполняемым файлом — например,
-    `sys.executable` как «бинарник xray» со скриптами-операндами; детали
-    на усмотрение исполнителя);
-  - все сохраняемые ниже поведения остаются зелёными.
-
-## Сохранить, не переписывать
-
-Уже реализовано и покрыто тестами в 02/06 — не переделывать, только не
-сломать: проброс SIGINT/SIGTERM/SIGHUP ребёнку; очистка state и конфига при
-штатном завершении; права 0600/0700; последовательные отказы (повторный
-start, смена профиля, несовпадение машинного адреса/порта со state);
-loopback-only; секреты вне stdout/stderr/argv; foreground-супервизор;
-fail-fast `pclaude`/`pcodex`; внешний путь без машинного конфига.
-
-Запрещено восстанавливать срезанное в 06: владение слушателем через
-`/proc/net/tcp`, `profile_fingerprint`, инспекцию zombie-состояний,
-SIGALRM-машинерию, поддержку второй версии Xray.
-
-## Не трогать
-
- `bash/.bash_functions`, установщик, README — вне объёма.
- Никаких коммитов.
-
-## Отчёт исполнителя
-
-1. Изменённые файлы со строкой «зачем» на каждый.
-2. Команды тестов и счётчики (`python3 -m unittest discover -s tests`,
-   `bash tests/test_proxy_launchers.sh`; baseline: 34 OK / 8 PASS — новых
-   станет больше, указать числа).
-3. Чекбоксы: закрыт / не закрыт и почему.
-4. Принятые по ходу решения и сомнения, если есть.
@@ -1,144 +0,0 @@
-# 04 — Проверяемая пользовательская установка Xray
-
-**What to build:** Пользователь без root устанавливает официальный Xray
-одной явной командой `install` и получает проверенный бинарник
-зафиксированной версии, без скрытой замены существующей установки, без
-записи за пределами пользовательских каталогов и без риска для живого
-managed-экземпляра.
-
-**Prerequisites:** 01, 03, 06 — все done. Наследуемые решения: одна
-поддержанная версия Xray 26.3.27 (06); идентичность managed-процессов по
-`/proc/PID/exe` и start-lock (03); Python 3.8+ stdlib-only, переносимость
-Ubuntu / РЕД ОС / Astra / Alt.
-
-**Status:** done
-
-## Зафиксированный протокол установки
-
- **Только версия 26.3.27** — та же, что принимает `VERSION_LINE`.
-  Никакого параметра версии: будущий апгрейд — отдельный тикет, меняющий
-  пин скачивания, ворота рантайма, фикстуры и документацию вместе.
- **Источник:** `https://github.com/XTLS/Xray-core/releases/download/v26.3.27/`.
-  Маппинг архитектур (чистая функция, по `platform.machine()`):
-  `x86_64`/`amd64` → `Xray-linux-64.zip`; `aarch64`/`arm64` →
-  `Xray-linux-arm64-v8a.zip`; прочее — понятный отказ.
- **Проверка:** скачивается `<архив>.dgst`. Фактический формат официальных
-  файлов — четыре записи `MD5=`, `SHA1=`, `SHA2-256=`, `SHA2-512=`
-  (исправлено 2026-07-20 по находке CODE-ревью: однострочного `SHA256=`
-  в релизах нет). Принимается ровно одна запись `SHA2-256= <64 hex в
-  нижнем регистре>`; дубликаты, uppercase, отсутствие записи или мусор —
-  отказ. Хэш архива считается `hashlib.sha256`; несовпадение или
-  неожиданный формат — отказ до распаковки, установленный бинарник не
-  тронут.
- **Границы размеров:** скачивание и распаковка ограничены
-  зафиксированными лимитами (архив, `.dgst`, извлекаемый бинарник);
-  фактически прочитанные байты считаются с limit+1; несоответствие
-  объявленному `Content-Length` или превышение лимита — отказ без
-  исчерпания диска/памяти.
- **Инструменты:** `urllib.request` для скачивания, `zipfile` для
-  извлечения члена `xray`. Явно исключены: tar, GPG-подписи, curl, wget,
-  пакетные менеджеры, sudo, systemd, системные каталоги.
- **Атомарность:** приватный staging-каталог создаётся ВНУТРИ
-  `~/.local/bin` (одна файловая система — `os.replace` без EXDEV);
-  скачивание и распаковка туда; кандидату ставится режим 0755; кандидат
-  проходит проверку `version` (те же ворота 26.3.27); затем один
-  `os.replace` в `~/.local/bin/xray`. До этого вызова существующий файл
-  назначения не изменяется. Staging убирается при любой ошибке и
-  прерывании (best-effort); fsync/power-loss-гарантии не требуются.
-
-## Чекбоксы
-
- [x] Команда `install [--replace]` добавлена в парсер и диспетчеризуется
-  ДО `load_config()`: установка не требует машинного конфига и
-  VLESS-профиля. `start` и запуск без подкоманды по-прежнему никогда не
-  начинают скачивание.
- [x] Защита managed-режима: до любого скачивания и изменения назначения
-  `install` берёт существующий start-lock и держит его до конца
-  `os.replace`. Lock занят — немедленный отказ с подсказкой «сначала
-  stop». При взятом lock допускаются только отсутствующий state или
-  доказуемо устаревший (по классификации 03 — stale); живой, сиротский
-  или непроверяемый state — отказ.
- [x] Поведение при существующем назначении `~/.local/bin/xray`:
-  - отсутствует → установка;
-  - обычный исполняемый файл, отвечающий `26.3.27` → no-op без сети
-    (успех, сообщение «уже установлено»);
-  - `--replace` → принудительная переустановка с полной проверкой;
-  - иной файл (не отвечает 26.3.27, неисполняемый, битый) или симлинк →
-    отказ без `--replace`; с `--replace` заменяется сам путь, симлинк не
-    разыменовывается;
-  - каталог → всегда понятный отказ.
- [x] После установки: проверка `shutil.which("xray")` — резолвится ли в
-  установленный `~/.local/bin/xray`. Нет — ненулевой код с подсказкой
-  добавить `~/.local/bin` в начало `PATH`; готовая установка при этом НЕ
-  откатывается.
- [x] Тестовый шов: чистая функция «архитектура → имя ассета» и
-  подменяемый загрузчик (callable), который тесты заменяют in-process.
-  Пользовательского оверрайда базового URL нет.
- [x] Автоматические тесты (без root, без сети; временные HOME/PATH/state):
-  - маппинг обеих архитектур (patch значения архитектуры) и отказ на
-    неподдержанной;
-  - корректный `.dgst` → установка; повреждённый хэш и неожиданный формат
-    `.dgst` → отказ до распаковки, назначение не тронуто;
-  - фикстуры: локальный ZIP с фейковым исполняемым, печатающим
-    `Xray 26.3.27 ...`, и парные валидный/битый `.dgst`;
-  - существующая корректная установка → no-op без обращения к загрузчику;
-    `--replace` → переустановка; симлинк/каталог/битый файл — по таблице
-    выше;
-  - атомарность: инъецированная ошибка после скачивания / при распаковке /
-    при проверке `version` → назначение не изменено, staging убран;
-  - запись только в пределах staging/назначения и lock-файла: сверка
-    полного дерева временной ФС до/после;
-  - защита managed: при живом managed-экземпляре (реальная фикстура 03)
-    `install --replace` отказывает с подсказкой «сначала stop», бинарник
-    и state не тронуты;
-  - `shutil.which`-проверка: отсутствие каталога в PATH и конкурирующий
-    более ранний `xray` в PATH.
- [x] `proxy-client/README.md` обновлён: одна поддержанная версия 26.3.27
-  (упоминания 25.12.8 удалены), использование `install [--replace]`,
-  маппинг x86_64/aarch64, SHA-256-проверка, поведение PATH, отказ при
-  живом managed-экземпляре.
-
-## Сохранить, не трогать
-
- Существующее поведение `resolve_xray`, ворот `VERSION_LINE`,
-  managed-режима и всех 49 зелёных тестов + 8 shell-проверок.
- Секреты: install не касается профилей и не выводит их; общее правило
-  «VLESS/UUID/ключи никогда в stdout/stderr/argv» остаётся.
- `bash/.bash_functions`, установщик dotfiles — вне объёма.
- Никаких коммитов.
-
-## Отчёт исполнителя
-
-1. Изменённые файлы со строкой «зачем» на каждый.
-2. Команды тестов и счётчики (baseline: 49 OK / 8 PASS — новых станет
-   больше, указать числа).
-3. Чекбоксы: закрыт / не закрыт и почему.
-4. Принятые по ходу решения и сомнения, если есть.
-
-## Резолюция (2026-07-20)
-
-Конвейер пройден целиком: постановка → Codex spec-review (high, 5 MAJOR +
-3 MINOR + 1 NIT, переписана) → реализация (Codex, medium — эксперимент) →
-саморевью (found 6, fixed 6) → два слепых ревью (CODE: 2 MAJOR + 2 MINOR;
-TASK: 3 NIT) → триаж (FIXED 7, REJECTED 0) → узкие перепроверки
-(оба FIXES_CONFIRMED) → приёмка оркестратором.
-
-Ключевое:
-
- Команда `install [--replace]`: пин 26.3.27, маппинг архитектур чистой
-  функцией, `urllib.request` + `zipfile`, staging внутри `~/.local/bin`,
-  один `os.replace`, `version`-ворота кандидата, guard по start-lock.
- CODE-1 (MAJOR) оказался дефектом постановки: spec-review зафиксировал
-  несуществующий однострочный формат `SHA256=`; реальные `.dgst` — четыре
-  записи. Протокол в тикете исправлен (см. выше), парсер строгий: ровно
-  одна `SHA2-256= <64 hex в нижнем регистре>`.
- Границы размеров: 64 MiB архив/бинарник, 4 KiB `.dgst`, счёт limit+1,
-  сверка Content-Length; offline-покрытие реального `download_file` через
-  подмену `urllib.request.urlopen`.
- `StartLockBusyError` вместо парсинга текста ошибки; снапшоты дерева ФС
-  в тестах отказных путей; PATH-тест конкурирующего бинарника.
- README дополнён (по просьбе пользователя): последняя версия с
-  `allowInsecure` — 25.12.8, опция удалена в 26.2.6; CLI их не ставит.
-
-Тесты: 79 OK (baseline 49, +30) + 8 PASS shell-проверок. Затраты — в
-`.scratch/proxy-client/token-ledger.md`.
@@ -1,143 +0,0 @@
-# 05 — Доставка пакета и итоговая приёмка
-
-**What to build:** Поставка `proxy-client` проверена целиком: корневой обзор
-соответствует готовым возможностям, автоматические проверки воспроизводимы, а
-ручная приёмка на доступных системах подготовлена для пользователя.
-
-**Blocked by:** 03 — безопасный жизненный цикл; 04 — проверяемая установка.
-
-**Status:** ready-for-human
-
-## Границы задачи
-
-Тикеты 03/04/06 уже доставили CLI, Bash-модуль, установку и жизненный цикл.
-Задача 05 их проверяет, но не переписывает. Источники истины:
-
- [`proxy-client/README.md`](../../../proxy-client/README.md) — пользовательские
-  команды, настройка и ограничения;
- [исходный дизайн](../../../docs/specs/2026-07-15-proxy-client-design.md)
-  — границы и принятые решения.
-
- [x] Корневой `README.md` кратко описывает внешний Hiddify и управляемый Xray,
-  показывает `stow proxy-client` и ссылается на полную инструкцию.
- [x] Пакет подключается через stow, ручные ссылки или копирование; общий
-  установщик использует тот же пакет.
- [x] Инструкция покрывает две семьи VLESS, Xray 26.3.27, отсутствие systemd,
-  автозапуска и автоматического перехода между прокси.
- [x] Тест
-  `ManagedXrayCliTest.test_exact_boolean_version_alpn_and_extra_branches`
-  подтверждает, что устаревшие `allowInsecure`/`insecure` не попадают в
-  TLS-конфиг, а истинное значение даёт предупреждение.
-
-## Секретные данные
-
- [x] В отслеживаемых файлах, тестовых данных, аргументах, выводе и отчёте нет
-  настоящих VLESS-ссылок, UUID, ключей, `shortId` и `path`. Автоматические тесты
-  используют только вымышленные контрольные значения. Настоящий профиль и
-  сгенерированный JSON остаются в закрытых пользовательских файлах и не
-  копируются в отчёт.
-
-## Автоматическая проверка
-
- [x] `tests/test_proxy_client_full.sh` запускает весь Python-набор под системным
-  `python3` и CPython 3.8 через `uv`, затем Bash-тесты и проверку установки.
- [x] Тестовый Xray остаётся отдельным исполняемым файлом и получает доступ к
-  библиотекам исходного Python. Это устраняет ложные падения переносимой сборки
-  `uv`, не ослабляя проверки личности процесса.
- [x] `tests/test_install.sh` собирает небольшие тестовые деревья только из
-  отслеживаемых Git-файлов и удаляет общий временный каталог при выходе.
-
-## Приёмка пользователем
-
-Исполнитель готовит команды и останавливается. Результат отмечает пользователь;
-недоступная система остаётся неподтверждённой.
-
- [x] Ubuntu 26.04 с системным Python 3.14: установка, жизненный цикл,
-  `xray run -test`, HTTP и SOCKS через один локальный вход Xray 26.3.27.
-  Минимальный CPython 3.8 отдельно покрыт автоматическим прогоном через `uv`.
- [ ] РЕД ОС, Astra Linux или Alt Linux по доступности: тот же сценарий после
-  проверки фактической версии Python.
-
-## После приёмки
-
- [ ] Статус исходного дизайна и заявления о поддержке приведены в соответствие
-  только с фактически выполненными прогонами.
-
-## Comments
-
-### 2026-07-21 — автоматическая проверка
-
-`bash tests/test_proxy_client_full.sh` завершился с кодом 0:
-
- системный Python 3.14: 79 тестов, `OK`, 61,034 с;
- Bash-интеграция: 8 проверок, `PASS`; `shellcheck` отсутствует и явно пропущен;
- установка: `All install tests passed`; в `/tmp` не осталось каталогов
-  `dotfiles-install-test.*`;
- CPython 3.8 через `uv`: 79 тестов, `OK`, 52,446 с.
-
-### 2026-07-21 — команды ручной приёмки
-
-В первой панели tmux, после подготовки закрытого `default.url` и машинного
-конфига с `type = xray`:
-
-```bash
-python3 --version
-cd ~/dotfiles
-stow proxy-client
-source ~/.config/proxy-client/shell.bash
-proxy-client install
-proxy-client start
-```
-
-Во второй панели, пока `start` работает:
-
-```bash
-proxy-client status
-xray run -test -c "${XDG_STATE_HOME:-$HOME/.local/state}/proxy-client/client.json"
-curl --proxy http://127.0.0.1:12334 https://api.ipify.org
-curl --proxy socks5h://127.0.0.1:12334 https://api.ipify.org
-proxy-client stop
-```
-
-Если настроен другой локальный адрес или порт, те же значения подставляются в
-обе команды `curl`. В отчёт записываются только версии, коды возврата и итог
-проверки HTTP/SOCKS.
-
-### 2026-07-21 — переименование и частичная ручная приёмка
-
-Публичный интерфейс переименован в `proxy-client`, а машинный конфиг и закрытый
-профиль объединены в `~/.config/proxy-client/`. В ходе разработки текущий HOME
-приведён к новой структуре; старые пользовательские пути отсутствуют, права
-файлов `600` сохранены. Поддержка прежнего имени в установщик не добавлялась,
-поскольку выпуск ещё не состоялся.
-
-Xray 26.3.27 установился и запустился, `status` подтвердил процесс на
-`127.0.0.1:12334`, а `xray run -test` завершился сообщением
-`Configuration OK`. HTTP и SOCKS5h через локальный вход не прошли: оба запроса
-`curl` завершились кодом 35 с неожиданным закрытием TLS-соединения во время
-рукопожатия. После проверки Xray штатно остановлен. Пункты ручной приёмки пока
-не отмечены.
-
-### 2026-07-21 — успешная приёмка на Ubuntu
-
-Первая строка оказалась нерабочей и в исходном клиенте. После замены на
-подтверждённо рабочий профиль XHTTP/TLS с ALPN `h3` тот же Xray 26.3.27 прошёл
-полный сценарий на Ubuntu 26.04 с системным Python 3.14: встроенная проверка
-внешнего IP, `status`, `xray run -test`, HTTP CONNECT и SOCKS5h. Оба запроса
-`curl` получили HTTP 200. Содержимое профиля в журнал и Git не попадало.
-
-Диагностическое понижение до Xray 25.12.8 не исправляло старый профиль, поэтому
-поддержка второй версии не нужна. Ошибка была связана с прежней строкой или её
-удалённой стороной, а не с преобразованием `proxy-client`.
-
-Короткая проверка стабильности H3 на Xray 26.3.27 также прошла:
-
- 120 циклов, в каждом новое HTTP CONNECT- и SOCKS5h-соединение: 240 запросов,
-  0 ошибок;
- две одновременные загрузки по 10 МБ через HTTP и SOCKS завершились полностью;
- после 45 секунд без трафика оба новых запроса получили HTTP 200.
-
-Таким образом, не воспроизвёлся сбой из
-[XTLS/Xray-core#3673](https://github.com/XTLS/Xray-core/issues/3673), при котором
-H3 переставал принимать новые соединения уже после первых запросов. Этот
-короткий прогон не заменяет длительное наблюдение под обычной нагрузкой.
@@ -1,180 +0,0 @@
-# 06 — Упрощение: срез accidental-сложности спеки и кода
-
-**What to build:** Один проход упрощения по готовым issue 01–02 и спеке:
-убрать поддержку второй версии Xray, избыточные защитные проверки вне
-принятой модели угроз («доверенные пользователи машины», единственный
-пользователь редактирует свои файлы сам) и церемонии, не нужные личному
-foreground-инструменту. Поведенческие контракты из раздела «Не трогать»
-сохраняются без изменений.
-
-**Blocked by:** 02 — Управляемый Xray: полный штатный путь.
-
-**Status:** done
-
-**Резолюция (2026-07-20):** реализовано и принято. Дельта: CLI 1123→976,
-shell.bash 116→91, тесты 1357→1236 строк; сьюты: 34 unittest OK + 8 shell
-PASS. Ревью: 1 MAJOR (scoped IPv6 в упрощённом валидаторе — починен с
-регрессионным тестом под Python 3.8), 1 NIT отклонён аргументированно.
-Non-gating замечания ревью приняты как риски модели угроз.
-
-**Сначала прочитать:**
-
-1. Этот файл целиком, затем `/tmp/xray-simplify-Zeo5/06-simplify/sweep.md` —
-   там точный line-level blast radius каждого пункта (секция 2 — срезы A/B,
-   секция 3 — SIMP-N). Номера строк — ориентир, сверяй с фактическим кодом.
-2. `docs/specs/2026-07-15-proxy-client-design.md` — исходная спека.
-3. `proxy-client/.local/bin/proxy-client`, `proxy-client/.config/proxy-client/shell.bash`,
-   `tests/test_proxy_client.py`, `tests/test_proxy_client_managed.py`.
-
-Команды проверки (обе обязательны):
-
- `python3 -m unittest discover -s tests` — baseline до изменений: 38
-  тестов, OK, ~60 с;
- `bash tests/test_proxy_launchers.sh` — baseline: 9 проверок PASS.
-
-После изменений тестов станет меньше (удаляются тесты срезанных фич); все
-оставшиеся зелёные, новые счётчики указать в отчёте.
-
-## A. Срез dual-version: остаётся только Xray 26.3.27
-
- [x] `VERSION_LINE` принимает только `26.3.27`; параметр `version` убран из
-  сигнатур `parse_vless`, `build_xray_config`, `safe_summary`, `warn_legacy`
-  и их вызовов; `xray_version` остаётся воротами «поддержанная версия или
-  отказ» и по-прежнему показывает фактическую версию в сводке.
- [x] Ветка эмиссии `allowInsecure` для 25.12.8 и запрет `pcs`/`vcn` для
-  25.12.8 удалены. `parse_boolean_fields` (валидация точных `true`/`false`,
-  требование согласованности обоих полей, предупреждение при истинном
-  значении) сохраняется; `allowInsecure` никогда не попадает в JSON.
- [x] Тестовая ось версий схлопнута: lifecycle-тест гоняет один прогон
-  26.3.27 (обе локации профиля — default и `-f` — сохраняются);
-  `test_old_version_preserves_explicit_legacy_insecure` и все
-  25.12.8-строки табличных тестов удалены.
-
-## B. Срез проверки владения сокетом через /proc/net/tcp
-
- [x] `process_owns_listener`, `process_socket_inodes`, `decode_proc_address`
-  и их вызовы (в `verify_managed_state` и readiness-цикле `command_start`)
-  удалены. Сохраняются: сверка PID/идентичности процесса, сверка
-  адрес/порт машинного конфига со state и `check_endpoint`-проверка
-  доступности порта.
- [x] `test_verified_child_must_own_configured_listener` удалён вместе с
-  веткой `FAKE_XRAY_LISTEN_PORT` в фейковом xray;
-  `test_substituted_machine_port_fails_closed...` сохраняется и зелёный.
- [x] Диагностические сообщения, упоминающие проверку владения слушателем
-  (в `verify_managed_state` и readiness-цикле `command_start`), обновлены:
-  после среза они описывают фактические проверки (идентичность процесса,
-  сверка адрес/порт, доступность порта), а не владение сокетом.
-
-## C. Диета входной валидации (файлы пишет сам пользователь)
-
- [x] `validate_address`: сначала `ipaddress.ip_address`, иначе минимальная
-  проверка «непустое ASCII-имя без пробелов, схемы `://`, `@`, `/` и
-  квадратных скобок». RFC-строгость по меткам DNS, лимит 253 и
-  сопутствующие тесты удалены. Оборачивание IPv6 в `[]` при сборке URL
-  сохраняется.
- [x] `load_config`: сохраняется отказ на неизвестной секции/ключе и на
-  отсутствии обязательного ключа (ловит реальные опечатки) и диапазон
-  порта. Удалены: скан NUL, guard UTF-8-декодирования, отдельный запрет
-  `[DEFAULT]`, запрет CR/многострочных значений, case-sensitive
-  `optionxform`; соответствующие подкейсы тестов удалены.
- [x] `read_profile`: сохраняются разрешение симлинка, проверка прав
-  (group/other → ошибка с подсказкой `chmod 600`) и правило «ровно одна
-  непустая строка». Удалены скан NUL и guard UTF-8.
- [x] `parse_query`: сохраняются отказ на неизвестном и на повторном
-  query-параметре. Удалены regex на сырые `%`-последовательности и
-  посимвольный запрет управляющих символов.
-
-## D. Диета церемоний
-
- [x] `write_private_json`: простая запись файла с правами 0600 внутри
-  уже-0700 каталога; O_EXCL/fsync/`os.replace`/PID-суффиксы удалены.
- [x] Валидация `PROXY_PREFLIGHT_TIMEOUT` и `PROXY_CLIENT_STOP_TIMEOUT` — один
-  guard «`float()` успешен и > 0, иначе понятная ошибка»; `math` не
-  импортируется; тесты экстремальных значений (nan/inf/1e-7/1e308)
-  удалены. Для `PROXY_PREFLIGHT_TIMEOUT` оставить один тест «плохое
-  значение → понятный отказ»; для `PROXY_CLIENT_STOP_TIMEOUT` отдельного
-  теста нет и добавлять его не нужно — достаточно guard'а.
- [x] `check_reachable` использует `socket.create_connection(timeout=...)`
-  без SIGALRM/setitimer-машинерии. Принятый риск (записан здесь):
-  зависший DNS-резолв на external-пути не ограничен таймаутом — для
-  личного инструмента пользователь прерывает вручную.
- [x] `extra` и `alpn` разбираются один раз в `parse_vless`, результат
-  сохраняется в профиле и переиспользуется в `build_xray_config` без
-  повторного разбора. `parse_json_object` сохраняет оба отказа —
-  на повторах ключей и на JSON-константах (`reject_constant` остаётся):
-  существующий тест требует отказ на уровне разбора с диагностикой про
-  `extra` и без запуска `run -test`, и это дешевле, чем переносить
-  ответственность на сериализацию.
- [x] `process_alive` — только `os.kill(pid, 0)`; чтение
-  `/proc/PID/stat` ради zombie-состояния удалено.
- [x] Отпечаток профиля (`profile_fingerprint`) удалён из state и кода:
-  он не участвует ни в одном решении. Смена профиля по-прежнему
-  блокируется существованием state. Вместе с ним обновлены `STATE_KEYS` и
-  все тестовые фикстуры state (включая точную сверку набора ключей в
-  managed-тестах): устаревший ключ в фикстуре не должен ронять сверку
-  ключей раньше, чем тест дойдёт до проверяемой идентичности процесса.
-
-## E. shell.bash: средняя форма приёма `env`
-
- [x] `_proxy_apply_env_file`: при ненулевом коде возврата CLI окружение не
-  меняется вовсе; успешный вывод разбирается построчно по первому `=`;
-  применяются (через `printf -v`, без `eval`) только восемь известных
-  ключей, прочие строки — ошибка без частичного экспорта. Удалены сканы
-  NUL/CR, отдельный детектор повторов и проверка «ровно восемь строк».
-  Свойство «нет частичного изменения окружения при ошибке» сохраняется и
-  остаётся покрыто тестом.
- [x] `tests/test_proxy_launchers.sh` приведён к средней форме: проверки
-  повторов/CR/NUL/счётчика строк, соответствующие удалённой машинерии,
-  убраны или переписаны; проверки «ненулевой код возврата CLI → окружение
-  не тронуто», «неизвестная строка → ошибка без частичного экспорта» и
-  владения функциями остаются зелёными.
-
-## F. Спека и соседние issue приведены к новому объёму
-
- [x] Из спеки удалены: ветка 25.12.8 (все места из секции 2 sweep-файла),
-  флаги `-v`/`--debug` (не реализованы), упоминание отпечатка профиля в
-  state; описания валидации/атомарности смягчены до фактического
-  поведения после этого issue. Формулировка идентичности процессов
-  («PID + время старта + исполняемый файл») в спеке не меняется.
- [x] Issue 03: добавлен явный мандат «идентичность = PID + время старта
-  (`/proc/PID/stat`) + исполняемый файл ребёнка / путь скрипта
-  супервизора; текущий argv-обход заменить этим механизмом»; убраны
-  унаследованные упоминания срезанных фич, если есть; строка Blocked by
-  дополнена: «06 — Упрощение».
- [x] Issue 05: приёмка сведена к одной версии Xray 26.3.27; упоминания
-  25.12.8 удалены. Пункты про РЕД ОС сохранены (решение пользователя
-  2026-07-20: целевые системы шире Ubuntu — РЕД ОС, возможно Astra Linux
-  и Alt Linux; инструмент могут использовать коллеги).
- [x] В спеке в раздел ручной проверки добавлены Astra Linux и Alt Linux
-  как кандидаты «по мере доступности» с тем же правилом, что для РЕД ОС:
-  недоступная среда явно записывается как неподтверждённая, поддержка не
-  заявляется без фактической проверки версии Python и прогона.
- [x] В issue 01 и 02 добавлена одна строка после Status: «Часть
-  требований пересмотрена в 06 — см. 06-simplification-pass.md»; чекбоксы
-  01 и 02 не редактируются (issue 01 описывает строгую приёмку `env`,
-  которую этот issue смягчает, — без пометки он противоречил бы коду).
-
-## G. Не трогать (границы)
-
- Строгий отказ на неизвестном/повторном query-параметре VLESS.
- Точечный `stop` только по проверенному PID; никакого pkill.
- Foreground-супервизор, проброс сигналов, очистка state.
- Изоляция окружения `run` (proxy-переменные только у ребёнка), сохранение
-  argv и кода возврата, `--`-разделитель.
- Fail-fast `pclaude`/`pcodex`, обратная совместимость: без машинного
-  конфига — внешний `hproxy.local:12334`.
- Проверка прав файла профиля (chmod 600) и loopback-only вход.
- Авто-диагностика внешнего IP на старте (несмертельная) — остаётся.
- Секреты: полная VLESS-ссылка, UUID, ключи не появляются в stdout/stderr/
-  argv — все существующие тесты на это остаются зелёными.
- `bash/.bash_functions`, установщик, README — не входят в этот issue.
- Никаких коммитов.
-
-## Отчёт исполнителя
-
-1. Изменённые файлы со строкой «зачем» на каждый.
-2. Команда тестов и счётчик (все зелёные, указать новое число).
-3. Чекбоксы: закрыт / не закрыт и почему.
-4. Итоговая дельта `wc -l` по CLI, shell.bash и обоим тест-файлам
-   против baseline (1123 / 116 / 467 / 890).
-5. Сомнения, если есть.
@@ -1,99 +0,0 @@
-# Токен-леджер проекта proxy-client
-
-Затраты по этапам конвейера, для калибровки эффорта и планирования лимитов
-(5-часовые / недельные окна подписок). Прямое сравнение корректно внутри
-провайдера; между Claude и Codex метрики разные (у Claude-субагентов
-харнесс даёт один суммарный счётчик, у Codex — раздельные input/cached/
-output/reasoning), кросс-сравнение — ориентировочное.
-
-## Задача 06 — упрощение (baseline: реализация на HIGH)
-
-| Этап | Агент / модель | Effort | Токены | Прочее |
-|---|---|---|---|---|
-| KISS-обход спеки и кода | Claude Opus (субагент) | default | 100 025 суммарно | 14 tool uses, 4.5 мин |
-| Ревью постановки | Codex gpt-5.6-sol | high | in 1 263 557 (кэш 1 174 784 → свежих ~89k), out 16 862 (reasoning 12 817) | 82 команды |
-| Реализация | Codex gpt-5.6-sol | high | in 6 680 053 (кэш 6 492 928 → свежих ~187k), out 29 064 (reasoning 8 280) | 84 команды, −331 строка |
-| Саморевью | Codex (resume) | medium | инкремент: свежих in ~155k, out ~4.5k | 8 команд, found 2 fixed 2 |
-| Слепое ревью «по задаче» | Claude Opus (субагент) | default | 75 216 суммарно | 26 tool uses, 4.3 мин; 1 NIT |
-| Слепое ревью «по коду» | Codex gpt-5.6-sol (свежий тред) | high | in 2 336 162 (кэш 2 106 112 → свежих ~230k), out 12 434 (reasoning 7 033) | 48 команд; 1 MAJOR |
-| Триаж/починка | Codex (resume) | medium | инкремент: свежих in ~26k, out ~7.3k | 18 команд; FIXED 1, REJECTED 1 |
-| Перепроверка CODE-1 | Codex-ревьюер (resume) | medium | инкремент: свежих in ~137k (вкл. оборванный первый заход), out ~1.8k | FIXES_CONFIRMED |
-
-Итог 06 (high-baseline): свежий input ~735k + output ~97k на весь конвейер
-(обход, ревью постановки, реализация, саморевью, 2 слепых ревью, триаж,
-перепроверка); Claude-доля — 175k суммарно (обход 100k + ревью 75k).
-
-## Задача 03 / 04 (эксперимент: реализация на MEDIUM)
-
-_Заполняется по ходу; сравнивать построчно с 06._
-
-| Этап | Агент / модель | Effort | Токены | Прочее |
-|---|---|---|---|---|
-| 03: ревью постановки | Codex gpt-5.6-sol | high | in 1 126 384 (кэш 1 044 480 → свежих ~82k), out 15 830 (reasoning 9 567) | NEEDS_REWORK: 7 MAJOR + 3 MINOR |
-| 03: реализация | Codex gpt-5.6-sol | **medium** | in 5 925 714 (кэш 5 678 080 → свежих ~248k), out 29 512 (reasoning 11 251)* | 88+6 команд; +657/−89; 44 OK + 8 PASS; процесс убит рестартом сессии перед отчётом, дописан через resume |
-
-| 03: саморевью | Codex (resume) | medium | инкремент: свежих in ~53k, out ~11.6k (reasoning ~7k) | 38 команд; found 3 fixed 3; 45 OK + 8 PASS |
-| 03: слепое ревью «по задаче» | Claude Opus (субагент) | default | 73 131 суммарно | 21 tool uses, 6.3 мин; 1 MINOR + 2 NIT |
-| 03: слепое ревью «по коду» | Codex gpt-5.6-sol (свежий тред) | high | in 1 103 725 (кэш 1 019 136 → свежих ~85k), out 12 797 (reasoning 8 908) | 28 команд; 4 MAJOR + 1 MINOR |
-| 03: триаж/починка | Codex (resume) | medium | инкремент: свежих in ~55.5k, out ~16.9k (reasoning ~7.8k) | 46 команд; FIXED 8, REJECTED 0; 49 OK + 8 PASS |
-| 03: перепроверка TASK-1..3 | Claude Opus (резюм субагента) | default | инкремент ~7.4k (суммарно 80 560) | 8 tool uses, 1.7 мин; FIXES_CONFIRMED |
-| 03: перепроверка CODE-1..5 | Codex-ревьюер (resume) | medium | инкремент: свежих in ~112k, out ~3.2k | 20 команд; FIXES_CONFIRMED |
-
-| 04: ревью постановки | Codex gpt-5.6-sol | high | in 2 469 937 (кэш 2 352 896 → свежих ~117k), out 17 051 (reasoning 10 128) | 54 команды; NEEDS_REWORK: 5 MAJOR + 3 MINOR + 1 NIT |
-| 04: реализация | Codex gpt-5.6-sol | **medium** | in 2 941 682 (кэш 2 828 288 → свежих ~113k), out 18 521 (reasoning 5 278) | 50 команд; +~600 строк; 63 OK (+14) + 8 PASS |
-| 04: саморевью | Codex (resume) | medium | инкремент: свежих in ~50k, out ~17.2k (reasoning ~9.2k) | 38 команд; found 6 fixed 6; 72 OK + 8 PASS |
-| 04: слепое ревью «по задаче» | Claude Opus (субагент) | default | 53 463 суммарно | 18 tool uses, 5.7 мин; 3 NIT |
-| 04: слепое ревью «по коду» | Codex gpt-5.6-sol (свежий тред) | high | in 1 774 005 (кэш 1 676 288 → свежих ~98k), out 10 402 (reasoning 5 481) | 46 команд; 2 MAJOR + 2 MINOR (CODE-1 — дефект постановки: реальный формат .dgst) |
-| 04: триаж/починка | Codex (resume) | medium | инкремент: свежих in ~237k, out ~58.9k (reasoning ~24k) | FIXED 7, REJECTED 0; 79 OK (+30 к baseline) + 8 PASS |
-| 04: перепроверка TASK-1..3 | Claude Opus (резюм субагента) | default | инкремент ~7.7k (суммарно 61 135) | 6 tool uses, 1.7 мин; FIXES_CONFIRMED |
-| 04: перепроверка CODE-1..4 | Codex-ревьюер (resume) | medium | инкремент: свежих in ~207k, out ~12.5k (reasoning ~6.3k) | FIXES_CONFIRMED |
-
-Итог 03 (реализация на MEDIUM): Codex — свежий input ~636k + output ~77k
-(ревью постановки 82k/16k, реализация ~248k/29.5k, саморевью 53k/11.6k,
-CODE-ревью 85k/12.8k, триаж 55.5k/16.9k, перепроверка 112k/3.2k);
-Claude-доля — 80.5k суммарно (TASK-ревью + перепроверка). Против 06
-(high-baseline: ~735k + 97k Codex, 175k Claude) — дешевле, но качество
-ниже: слепые ревью нашли 4 MAJOR (у 06 — 1), все — гонки
-конкурентности/восстановления; конвейер их выловил и починил.
-
-\* usage первого (убитого) хода не был зафиксирован (нет `turn.completed`); цифры — из resume-хода, по масштабу покрывают весь тред.
-
-Итог 04 (реализация на MEDIUM): Codex — свежий input ~822k + output ~135k
-(ревью постановки 117k/17k, реализация 113k/18.5k, саморевью 50k/17.2k,
-CODE-ревью 98k/10.4k, триаж 237k/58.9k, перепроверка 207k/12.5k);
-Claude-доля — 61k суммарно (TASK-ревью + перепроверка). Слепые ревью
-нашли 2 MAJOR + 2 MINOR + 3 NIT, причём CODE-1 (MAJOR) — дефект
-постановки (spec-review на high выдумал однострочный `SHA256=`), т.е.
-на счету реализации-medium фактически 1 MAJOR (границы размеров).
-Примечательно: 04-medium вышла ДОРОЖЕ 06-high по свежим токенам
-(~822k+135k против ~735k+97k) — экономию реализации съели дорогой триаж
-(7 находок, включая переделку под исправленный протокол) и перепроверки.
-
-Сводка эксперимента (свежий input + output Codex; MAJOR от слепых ревью):
-
-| Задача | Effort реализации | Codex токены | Claude | MAJOR |
-|---|---|---|---|---|
-| 06 | high (baseline) | ~735k + 97k | 175k | 1 |
-| 03 | medium | ~636k + 77k | 80.5k | 4 (гонки) |
-| 04 | medium | ~822k + 135k | 61k | 2 (1 — вина постановки) |
-
-## Задача 05 — доставка пакета и приёмка
-
-| Этап | Агент / модель | Effort | Токены | Прочее |
-|---|---|---|---|---|
-| 05: ревью постановки, попытки 1–2 (убиты) | Codex gpt-5.6-sol | high | расход токенов потерян (нет `turn.completed`) | обе умерли на `Quota exceeded (os error 122)`: набор `test_install.sh` заполнял `/tmp` тестовыми деревьями по ~1,8 ГБ; потеряно ~2 и ~10 мин работы, сеансы невосстановимы из-за сбоя журнала |
-
-## Наблюдения
-
- Кэш у Codex покрывает ~93% входа ревью-этапа: длинные треды с большим
-  контекстом дешевле по лимитам, чем кажется по сырому input.
- Сравнивать этапы честнее по «свежий input + output (включая reasoning)»,
-  а не по валовому input.
- Итог эксперимента (решение пользователя 2026-07-21, детали — в
-  claude-subagent-playbook): реализация по отревьюированному тикету →
-  medium допустима, но экономию считать по конвейеру целиком (04-medium
-  дороже 06-high из-за триажа); Claude-субагентам effort задавать явно —
-  xhigh постановки/планы, high слепое ревью (ниже не опускать), medium
-  перепроверки; высокий effort не страхует от выдумки внешних фактов
-  (казус формата `.dgst`); смена effort у Codex при resume кэш не
-  сбрасывает (~93% кэша при high→medium).