# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

ОБРАБОТЧИК ОБНОВЛЕНИЙ
--------------

ИМЯ ОБРАБОТЧИКА
------------
bach update - Versions- und Update-Verwaltung


ОПИСАНИЕ
------------
Управляет обновлениями, управлением версиями и целостностью системы. Проверяет наличие доступных
Обновления из Git, их импорт с помощью автоматического резервного копирования и переноса данных.
функций и проверяет целостность системы после каждого обновления. Также поддерживает
Откат к резервным копиям перед обновлением.


ОПЕРАЦИИ
-----------

ПРОВЕРКА
Проверьте наличие обновлений (на основе Git). Сравнивает локальные коммиты с восходящей веткой
и отображает ожидающие изменения. Работает только в репозиториях Git.

STATUS (или без параметров)
Показывает текущую версию, версию схемы, метку времени обновления и проверку.
статус. Перечисляет примененные миграции и информацию о Git.

APPLY [--dry-run]
Установленное обновление с 5-этапным рабочим процессом: (1) Создайте резервную копию перед обновлением,
(2) Запустите Git pull --rebase, (3) Запустите миграцию, (4) Система
проверить, (5) обновить версию.json. С --dry-run только предварительный просмотр.

ROLLBACK [--dry-run]
Откат к последней резервной копии перед обновлением. Находит последний файл pre_update_*.zip.
и восстанавливает bach.db. Сохраняет текущую базу данных как .db.pre_rollback.

VERIFY
Проверяет целостность системы: импортируемый обработчик, доступная версия.json, bach.db
читабельность, согласованность миграции, критические каталоги (концентратор, ядро, данные, навыки)
доступен. Показывает сведения об ошибках и обновлениях last_verified.

MIGRATIONS [list|run]
список (по умолчанию): показывает все доступные миграции со статусом (применено/ожидает).
run: запускает ожидающие миграции (.py или .sql), обновляет версию_схемы.


ПРИМЕРЫ
---------

bach update check
  Проверяет наличие доступных обновлений из исходной версии Git.

bach update status
  Показывает версию 1.2.3, последнее обновление, статус проверки и
  прикладные миграции.

bach update apply --dry-run
  Показывает 5-фазный процесс без изменений.

bach update apply
  Установил полное обновление с резервным копированием, извлечением, миграцией и проверкой.

bach update verify
  Проверяет все 6 пунктов: обработчики, version.json, bach.db, миграции, каталоги.

bach update rollback --dry-run
  Показывает последнюю резервную копию (имя файла, размер, дату) без каких-либо действий.

bach update rollback
  Восстанавливает bach.db из последнего pre_update_*.zip.

bach update migrations
  Перечисляет доступные и ожидающие миграции с количеством.

bach update migrations run
  Выполняет все ожидающие миграции, отслеживает обновления.


ФАЙЛЫ
-------
data/version.json
  Центральный файл версии. Содержит: версию, версию_схемы, обновленную_ат,
  последний_проверенный, статус_проверки, миграция_применена[].

data/bach.db
  База данных SQLite. Резервное копирование выполняется перед каждым обновлением и во время откатов.
  восстановлено.

_backups/
  Резервные копии перед обновлением в формате pre_update_X.Y.Z_YYYYMMdd_HHmm.zip. Включено
  bach.db, version.json, все JSON-файлы конфигурации из data/.

data/migrations/
  Каталог для файлов миграции (.py или .sql). Версия.json отслеживается
  migrations_applied[].

hub/, ядро/, данные/, навыки/
  Критические каталоги. Проверка проверяет наличие всех 4.


СМ. ТАКЖЕ
----------
core      - Обработчик ядра BACH
verify    - Подробности проверки
backup    - Стратегии резервного копирования
git       - Интеграция с Git
