feat: add Nivora CLI and msvc-go-wine

docs/packages/nivora-cli.md

@@ -0,0 +1,112 @@
+# Nivora CLI
+
+Nivora CLI — компактная многоязычная оболочка для Stapler. Она упрощает
+установку, удаление, обновление и поиск пакетов, управление репозиториями и
+диагностику системы.
+
+```bash
+sudo stplr install nivora/nivora-cli
+```
+
+## Интерактивный режим
+
+Команда `nv` без аргументов открывает компактное меню:
+
+```text
+╭─ NIVORA ─────────────────────────────╮
+│ Простое управление пакетами Stapler  │
+╰──────────────────────────────────────╯
+
+  Пакеты
+  [i] Установить          nvi
+  [e] Удалить             nve
+  [u] Обновить            nvu
+  [s] Найти               nvs
+  [q] Информация          nvqi
+  [a] Все пакеты          nvqa
+
+  Система
+  [r] Обновить репозитории nvr
+  [l] Репозитории         nvrl
+  [f] Исправить           nvf
+  [d] Диагностика         nvd
+```
+
+В конвейере или другом неинтерактивном окружении `nv` выводит обычную справку.
+
+## Короткие команды
+
+| Команда | Операция Stapler |
+|:--|:--|
+| `nvi package` | установить `nivora/package` |
+| `nve package` | удалить `nivora/package` |
+| `nvu` | обновить установленные пакеты |
+| `nvs query` | найти пакет |
+| `nvqi package` | показать информацию о пакете |
+| `nvqa` | показать каталог пакетов |
+| `nvr` | обновить индексы репозиториев |
+| `nvrl` | показать подключённые репозитории |
+| `nvf` | исправить состояние Stapler |
+| `nvd` | проверить окружение |
+| `nvc` | показать или изменить конфигурацию Stapler |
+
+Основная команда принимает и полные названия операций:
+
+```bash
+nv install codex
+nv search editor
+nv info codex
+nv repo list
+```
+
+## Репозитории
+
+Короткое имя автоматически получает префикс `nivora`:
+
+```bash
+nvi codex                  # stplr install nivora/codex
+nvi other/package          # stplr install other/package
+```
+
+Репозиторий можно изменить или отключить:
+
+```bash
+nvi --repo other package
+nvi --repo none package
+NIVORA_REPO=other nvi package
+```
+
+Локальные пути и файлы пакетов никогда не получают префикс.
+
+## Язык и оформление
+
+Русский или английский язык выбирается по системной локали. Явное
+переопределение:
+
+```bash
+nv --lang en help
+NIVORA_LANG=ru nvd
+```
+
+Цветной вывод включается только для терминала. Его можно отключить стандартной
+переменной `NO_COLOR`, параметром `--no-color` или значением
+`NIVORA_COLOR=never`.
+
+## Безопасность
+
+Изменяющие систему операции запускаются через `sudo`. Другую команду повышения
+привилегий можно задать в `NIVORA_SUDO`. Аргументы передаются массивом без
+вычисления shell-строк. Параметр `--dry-run` показывает итоговую команду без её
+выполнения.
+
+| Переменная | Назначение |
+|:--|:--|
+| `NIVORA_LANG` | язык интерфейса: `ru` или `en` |
+| `NIVORA_REPO` | репозиторий коротких имён |
+| `NIVORA_SUDO` | команда повышения привилегий |
+| `NIVORA_COLOR` | режим цвета; `never` отключает цвет |
+| `NIVORA_QUIET=1` | не печатать запускаемую команду |
+| `NO_COLOR` | стандартное отключение цвета |
+
+Автодополнение для Bash, Fish или Zsh генерируется командой
+`nv completion <shell>`.