Skip to content

Eniggman/termux-lab / auto-updater

auto-updater

Verified

Универсальная безопасная проверка и обновление приложений и пакетов в Termux по стандартам termux-fix-path. Claude Code намеренно исключён.

FileKindSize
SKILL.mdskill md17.5 KB
scripts/hook_check.pyexecutablescript4.6 KB
scripts/update_all.shexecutablescript14.0 KB
---
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

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: 472kUpdated Claude CodeCodexUnverifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall