Eniggman/termux-lab / auto-updater
auto-updater
VerifiedУниверсальная безопасная проверка и обновление приложений и пакетов в Termux по стандартам termux-fix-path. Claude Code намеренно исключён.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 17.5 KB |
| scripts/hook_check.pyexecutable | script | 4.6 KB |
| scripts/update_all.shexecutable | script | 14.0 KB |
SKILL.md
View on GitHub---
name: auto-updater
description: Универсальная безопасная проверка и обновление приложений и пакетов в Termux по стандартам termux-fix-path. Claude Code намеренно исключён.
---
# Auto Updater
Если приложение не удаётся классифицировать или после обновления нужен ремонт
окружения, используй `termux-fix-path`. Скилл `auto-updater` отвечает за
обнаружение доступных обновлений и инициацию процесса, но при выполнении обновлений
и после них ОБЯЗАН строго следовать стандартам `termux-fix-path` (цепочка:
launcher → runtime → ELF → shebang → glibc-runner → очистка устаревших обёрток
в `~/.local/bin/` → валидация запуска).
Этот скилл содержит скрипт и инструкции для безопасного обновления приложений и пакетов именно в Termux/Android.
Скилл не должен запускаться как обычный Linux-скрипт: Termux использует Android/Bionic, а не стандартный Linux/glibc.
## Обязательный порядок
1. Определить, что текущая среда — Termux (`$PREFIX`, `pkg`, `apt-get`). В другой среде завершить работу.
2. Найти доступные обновления через поддерживаемые менеджеры и показать пользователю список.
3. Показать Termux-рекомендации и риски.
4. Запросить явное разрешение. Без интерактивного подтверждения ничего не обновлять.
5. Для найденных pip-пакетов запросить отдельное подтверждение: pip может перезаписать пакеты, которыми управляет `pkg`.
6. Выполнить согласованные обновления пакетов и менеджеров.
7. После обновления строго следовать регламенту `termux-fix-path`:
- Проверить наличие перехватывающих обёрток в `~/.local/bin/` для обновленных системных пакетов из `$PREFIX/bin` (Модуль 7 `termux-fix-path`), деактивировать их с архивацией в `~/.local/state/backups/` и сбросить кэш `hash -r`;
- Восстановить Termux shebang (`termux-fix-shebang`) для всех глобальных CLI в `$(npm prefix -g)/bin` (только для текстовых скриптов, никогда для ELF);
- Проверить цепочку launcher → runtime → ELF → glibc-runner;
- Проверить валидацию запуска (`--version` / `--help`) доверенных CLI;
- При сбоях — следовать регламенту безопасного восстановления по Модулю 9 `termux-fix-path`;
- Только при полном отсутствии ошибок (`ERRORS == 0`) записать timestamp успешного запуска.
## Поддерживаемые источники обновлений
Скилл не привязан к фиксированному набору приложений: он сначала обнаруживает
доступные менеджеры и применяет только подходящий для найденного источника.
1. **Termux `pkg`/`apt`**: системные и установленные из репозиториев Termux-пакеты.
2. **Глобальный NPM**: глобальные Node.js-приложения и модули, включая Codex CLI.
3. **Python/pip**: устаревшие Python-пакеты, если `pip` установлен.
4. **uv**: установленные через `uv tool` приложения и утилиты агентов (включая утилиту аудита безопасности `skillspector` / NVIDIA SkillSpector).
5. **Self-updater приложения**: поддержанные отдельные обновляторы, например `agy update`.
Приложения, установленные standalone-архивом, Linux-бинарником, APK или неизвестным
установщиком, не обновляются угадыванием. Скилл показывает предупреждение и требует
отдельного адаптера/команды. Это сохраняет универсальность без опасного
`update-everything`.
## Что обновляется:
1. **Пакеты Termux**: После подтверждения выполняются `apt-get update` и `apt-get upgrade` в неинтерактивном режиме с сохранением существующих конфигов.
2. **NPM модули и Codex CLI**: обновляются глобальные NPM-пакеты, включая `@mmmbuto/codex-cli-termux`.
3. **Python/pip и uv tools**: обновляются только обнаруженные устаревшие пакеты/инструменты; pip требует отдельного подтверждения из-за риска конфликта с `pkg`. Для uv tools используется изолированное обновление через `uv tool upgrade --all` или точечный вызов для конкретного инструмента.
4. **Claude Code**: пакет `@anthropic-ai/claude-code` исключается из `npm update -g` и не переустанавливается.
5. **Antigravity CLI**: после общего разрешения запускается `agy update`; сам `agy` дополнительно проверяет доступность новой версии и спрашивает перед применением.
6. **SkillSpector (NVIDIA SkillSpector)**: утилита аудита безопасности AI-навыков, установленная в изолированном окружении uv (`uv tool`). Проверяется наличие (`uv tool list` или `command -v skillspector`) и обновляется безопасной командой `uv tool upgrade skillspector` (или в общем потоке `uv tool upgrade --all`). Поскольку инструмент изолирован в собственном виртуальном окружении uv, процедура не затрагивает системный Python Termux и библиотеки `$PREFIX`.
## Termux-совместимость
- Нативные Termux-пакеты устанавливаются через `pkg`/`apt`, а не через Linux-установщики.
- Обычные glibc-бинарники Android напрямую не запускает. Для них нужен `glibc-runner`; наличие runner’а проверяется до обновления.
- Если приложению нужен glibc, рекомендуемый Termux-путь: подключить `glibc-repo`, установить `glibc`, затем запускать бинарник через `glibc-runner`. Это отдельная операция и не выполняется автоматически.
- В Termux нет `/usr/bin/env` в обычном Linux-смысле. После обновления NPM CLI скилл запускает `termux-fix-shebang` для всех установленных глобальных CLI в `$(npm prefix -g)/bin` (только для текстовых скриптов, никогда для ELF).
- Если `agy` падает после обновления, скилл только показывает рекомендацию `pkg reinstall -y glibc`; сам ремонт без отдельного подтверждения не выполняется.
- Инструменты `uv tool` (включая `skillspector`) изолированы в `~/.local/share/uv/tools/` с точками входа в `~/.local/bin/`. Обновление через `uv tool upgrade skillspector` безопасно для системного Python и не ломает Bionic-окружение Termux.
- Переустановка пакетов, исправление shebang’ов и обновление приложений — разные действия; согласие на одно не следует молча распространять на другие.
## Регламент интеграции с termux-fix-path
`auto-updater` отвечает за обнаружение доступных обновлений и инициацию процесса, но при выполнении обновлений и после них ОБЯЗАН строго следовать стандартам `termux-fix-path`:
1. **Цепочка проверки:** `launcher` → `runtime` → `ELF` → `shebang` → `glibc-runner` → `очистка устаревших обёрток в ~/.local/bin/` → `валидация запуска`.
2. **Очистка устаревших обёрток (Модуль 7 `termux-fix-path`):**
- При обновлении пакетов через `pkg`/`apt` проверить системный `PATH`: доступна ли нативная версия в `$PREFIX/bin/$APP`.
- Если в `~/.local/bin/$APP` находится старый launcher/wrapper, он может перехватывать вызов из-за приоритета `~/.local/bin` в `$PATH`.
- Проверить прямой запуск `$PREFIX/bin/$APP --version` (или `--help`). Если нативная версия работает штатно, деактивировать устаревшую обёртку перемещением в `~/.local/state/backups/` и сбросить кэш оболочки `hash -r`.
3. **Изолированное хранение бэкапов:**
- Все резервные копии и старые лаунчеры сохранять строго в `~/.local/state/backups/`.
- Категорически запрещено оставлять бэкапы или архивы прямо в `~/.local/bin/` или других папках из `$PATH`.
4. **Обработка shebang (Модуль 2 `termux-fix-path`):**
- Обрабатывать все текстовые скрипты-лаунчеры в `$(npm prefix -g)/bin` и внутренние бинарники модулей.
- Никогда не применять `termux-fix-shebang` к ELF-бинарникам.
5. **Валидация запуска:**
- Проверять запуск (`--version` / `--help`) только у доверенных установленных программ (`codex`, `agy`, `skillspector`).
## Безопасное восстановление при сбоях (Модуль 9 termux-fix-path)
Если после обновления CLI или пакет перестает запускаться:
- **Категорический запрет:** не запускать повторное массовое обновление «вслепую», не удалять `$PREFIX` и не переустанавливать среду Termux.
- **Порядок восстановления по Модулю 9:**
1. Зафиксировать ошибку из лога (`/tmp/auto_update_*.log`), вывод `command -v`, `file`, `readlink -f` и `readelf -l` (`PT_INTERP`).
2. Определить, какой файл обновился и какому менеджеру/пакету он принадлежит.
3. Восстановить файл из проверенного бэкапа в `~/.local/state/backups/` либо через штатную переустановку пакета (`pkg reinstall <пакет>`).
4. Для текстовых launcher применить `termux-fix-shebang`.
5. Для glibc приложений (например, `agy`) проверить доступность `glibc-runner` и предложить переустановку glibc (`pkg reinstall -y glibc`).
6. Провести проверку запуска доверенного CLI (`--version` / `--help`).
7. Сообщить пользователю путь к бэкапу, результат восстановления и остаточные ограничения.
## Скрипт
`~/.agents/skills/auto-updater/scripts/update_all.sh`
Скрипт проверяет файл `last_update.timestamp` в папке скилла. Если с момента последнего успешного обновления прошло менее 24 часов (86400 сек), скрипт досрочно завершается со статусом `UPDATE_SKIPPED`, чтобы не выполнять лишние операции.
Если обновление запускается, скрипт собирает логи в `/tmp/auto_update_<дата>.log` и возвращает `UPDATE_SUCCESS` (перезаписывая timestamp) или `UPDATE_FAILED`.
## Автоматизация и Режимы работы
### Интерактивный режим (по запросу)
Пользователь может вручную вызвать скилл `auto-updater` или скрипт `update_all.sh`. При ручном запуске запрашивается явное подтверждение каждого шага.
### Автоматический фоновый режим (Вариант 3 — выбор пользователя)
Настроен автоматический ежедневный цикл через PreInvocation хук Antigravity CLI (`.agents/hooks.json` -> `scripts/hook_check.py`):
1. **Триггер:** При первом сообщении сессии (`invocationNum == 1`), если с момента последнего обновления и последнего напоминания прошло более 24 часов (86400 сек), хук генерирует эфемерную инструкцию для Оркестратора и фиксирует `last_prompt.timestamp`.
2. **Оркестрация:** Оркестратор немедленно делегирует задачу Модулю/субагенту (`invoke_subagent` с типом `self` в фоновом режиме), а Пользователю в основном диалоге кратко сообщает, что запущен фоновый автоапдейт, не прерывая беседу.
3. **Безопасное выполнение:** Субагент выполняет обновление через `scripts/update_all.sh --auto` (или последовательные команды):
- Обновление системных пакетов Termux (`apt-get update && apt-get upgrade`);
- Проверка и архивация перехватывающих обёрток в `~/.local/bin/` (Модуль 7 `termux-fix-path`);
- Обновление глобальных NPM пакетов с исключением Claude Code и восстановлением Termux shebang (`termux-fix-shebang`);
- Обновление инструментов uv (`uv tool upgrade --all` / `skillspector`);
- Обновление `agy` (`agy update`);
- Пакеты Python/pip в авто-режиме пропускаются по умолчанию во избежание конфликтов с `pkg`.
4. **Конфликты и вопросы:** Если при обновлении возникают конфликты версий, ошибки зависимостей или неоднозначности — субагент запрашивает решение у пользователя.
5. **Таймстемпы и защита от спама:**
- При срабатывании хука фиксируется `last_prompt.timestamp`, что блокирует повторный вызов на 24 часа даже при падении или отмене.
- При успешном завершении (`ERRORS == 0`) обновляется `last_update.timestamp` как локально (`~/.agents/skills/auto-updater/`), так и во внешней памяти (`/sdcard/.EasyCode/skills/auto-updater/`).
6. **Отчёт:** По завершении субагент возвращает сжатый отчёт по стандарту:
📌 Изменения | 📁 Затронутые файлы | ⚠️ Риски | 🔗 Ссылки.
## Связанные статьи Wiki
- [[termux-fix-path]] — единый регламент установки, обновления и ремонта CLI в Termux
- [[запуск-linux-приложений]] — Bionic, glibc и `glibc-runner`
- [[agy-glibc-after-update]] — восстановление `agy` после сбоя glibc
- [[codex-shebang-fix]] — исправление shebang Codex CLI в Termux
- [[пакеты]] — репозитории и установка пакетов Termux
- [[checker-skill-nvidia]] — аудит безопасности AI-навыков (NVIDIA SkillSpector)
## Ссылки
- Antigravity CLI (Termux port): https://github.com/wallentx/antigravity-cli-termux
- NVIDIA SkillSpector: https://github.com/NVIDIA/SkillSpector
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |