Files
dotfiles/.scratch/proxy-client-installer/issues/01-standalone-install.md
T
ddadmin 623ed8f871 fix(proxy-client): согласованы инструкции самостоятельной установки
- Зачем:
  - README смешивал пакетный и корневой установщики и оставлял неполные шаги для отдельных сценариев.
- Что:
  - выстроен цельный путь установки и настройки для standalone и полного dotfiles.
  - дополнена подсказка --no-shell-setup и добавлена регрессионная проверка.
  - закрыты критерии приёмки тикета и указана дата завершения.
- Проверка:
  - bash tests/test_proxy_client_install.sh.
  - bash tests/test_install.sh.
2026-07-21 22:45:28 +03:00

45 lines
4.2 KiB
Markdown

# 01 — Самостоятельная установка proxy-client из отдельного каталога
**What to build:** пользователь может отдельно скопировать каталог
`proxy-client`, запустить пакетный `install.sh` без общего dotfiles и получить
готовые симлинки, подключённый Bash-модуль и краткую подсказку о дальнейшей
настройке. Установка даёт одинаковый результат со stow и без него, безопасно
повторяется, не трогает машинные файлы и не требует доступной сети или прокси.
**Blocked by:** None — can start immediately.
**Status:** ready-for-agent
**Completed:** 2026-07-21
- [x] При наличии stow установщик использует его, а без stow создаёт напрямую
тот же набор симлинков и явно сообщает выбранный способ.
- [x] Управляются только CLI, Bash-модуль и шаблоны; машинный конфиг и закрытый
профиль не создаются, не заменяются и не связываются даже при наличии в
исходном каталоге.
- [x] Домашние каталоги остаются обычными каталогами; пакетные README и
установщик не раскладываются в домашний каталог.
- [x] До любых изменений проверяется весь набор назначений. Любой чужой файл,
каталог или симлинк приводит к отказу без частичной установки и без
автоматической замены или резервной копии; пользователю показывается полный
список конфликтующих путей.
- [x] Повторный запуск для уже правильных ссылок ничего не меняет и завершается
успешно, а исходный каталог может находиться в произвольном пути, включая
путь с пробелами.
- [x] По умолчанию установщик идемпотентно подключает Bash-модуль и при
необходимости добавляет пользовательский каталог исполняемых файлов в
`PATH`, не дублируя подключение из полного dotfiles.
- [x] Параметр `--no-shell-setup` полностью отключает изменение настроек Bash.
- [x] После раскладки проверяется только локальная исправность CLI и
Bash-модуля; установка не выбирает режим, не устанавливает Xray, не читает
VLESS, не проверяет сеть и не требует существующего корректного конфига.
- [x] Финальный вывод кратко объясняет, как применить изменения в текущей
shell-сессии, предупреждает о постоянном пути исходного каталога и направляет
к настройке режимов в основной инструкции, не дублируя её.
- [x] Автоматические проверки покрывают оба способа создания ссылок, повторный
запуск, все виды конфликтов, защиту машинных файлов, настройку Bash и режим
без её изменения.
- [x] Инструкция пакета описывает новый установщик, зависимость симлинков от
постоянного пути исходного каталога и дальнейшую ручную настройку; общий
установщик dotfiles продолжает работать по прежнему контракту.