From 43404d374ff4d9cff44b2932013cd3d23d113d6b Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Tue, 21 Jul 2026 21:57:13 +0300 Subject: [PATCH] =?UTF-8?q?docs(proxy-client):=20=D0=B4=D0=BE=D0=B1=D0=B0?= =?UTF-8?q?=D0=B2=D0=BB=D0=B5=D0=BD=20=D1=82=D0=B8=D0=BA=D0=B5=D1=82=20?= =?UTF-8?q?=D1=81=D0=B0=D0=BC=D0=BE=D1=81=D1=82=D0=BE=D1=8F=D1=82=D0=B5?= =?UTF-8?q?=D0=BB=D1=8C=D0=BD=D0=BE=D0=B9=20=D1=83=D1=81=D1=82=D0=B0=D0=BD?= =?UTF-8?q?=D0=BE=D0=B2=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - согласованный дизайн нужно передать агенту одной готовой вертикальной задачей. - Что: - опубликован тикет самостоятельного установщика без блокирующих зависимостей. - зафиксированы критерии безопасности, совместимости, проверки и документации. - Проверка: - git diff --cached --check. --- .../issues/01-standalone-install.md | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 .scratch/proxy-client-installer/issues/01-standalone-install.md diff --git a/.scratch/proxy-client-installer/issues/01-standalone-install.md b/.scratch/proxy-client-installer/issues/01-standalone-install.md new file mode 100644 index 0000000..2f5c191 --- /dev/null +++ b/.scratch/proxy-client-installer/issues/01-standalone-install.md @@ -0,0 +1,42 @@ +# 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 продолжает работать по прежнему контракту.