Files
dotfiles/.scratch/proxy-client-installer/issues/01-standalone-install.md
T
ddadmin 43404d374f docs(proxy-client): добавлен тикет самостоятельной установки
- Зачем:
  - согласованный дизайн нужно передать агенту одной готовой вертикальной задачей.
- Что:
  - опубликован тикет самостоятельного установщика без блокирующих зависимостей.
  - зафиксированы критерии безопасности, совместимости, проверки и документации.
- Проверка:
  - git diff --cached --check.
2026-07-21 21:57:13 +03:00

43 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
- [ ] При наличии stow установщик использует его, а без stow создаёт напрямую
тот же набор симлинков и явно сообщает выбранный способ.
- [ ] Управляются только CLI, Bash-модуль и шаблоны; машинный конфиг и закрытый
профиль не создаются, не заменяются и не связываются даже при наличии в
исходном каталоге.
- [ ] Домашние каталоги остаются обычными каталогами; пакетные README и
установщик не раскладываются в домашний каталог.
- [ ] До любых изменений проверяется весь набор назначений. Любой чужой файл,
каталог или симлинк приводит к отказу без частичной установки и без
автоматической замены или резервной копии; пользователю показывается полный
список конфликтующих путей.
- [ ] Повторный запуск для уже правильных ссылок ничего не меняет и завершается
успешно, а исходный каталог может находиться в произвольном пути, включая
путь с пробелами.
- [ ] По умолчанию установщик идемпотентно подключает Bash-модуль и при
необходимости добавляет пользовательский каталог исполняемых файлов в
`PATH`, не дублируя подключение из полного dotfiles.
- [ ] Параметр `--no-shell-setup` полностью отключает изменение настроек Bash.
- [ ] После раскладки проверяется только локальная исправность CLI и
Bash-модуля; установка не выбирает режим, не устанавливает Xray, не читает
VLESS, не проверяет сеть и не требует существующего корректного конфига.
- [ ] Финальный вывод кратко объясняет, как применить изменения в текущей
shell-сессии, предупреждает о постоянном пути исходного каталога и направляет
к настройке режимов в основной инструкции, не дублируя её.
- [ ] Автоматические проверки покрывают оба способа создания ссылок, повторный
запуск, все виды конфликтов, защиту машинных файлов, настройку Bash и режим
без её изменения.
- [ ] Инструкция пакета описывает новый установщик, зависимость симлинков от
постоянного пути исходного каталога и дальнейшую ручную настройку; общий
установщик dotfiles продолжает работать по прежнему контракту.