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

ВЫКЛЮЧЕНИЕ - Завершить сеанс
--------------------------

ОПИСАНИЕ
Протокол выключения завершает сеанс BACH и сохраняет его.
Отчет о сеансе и обновление состояния каталога.

КОМАНДЫ
-------
bach --shutdown              Полное завершение работы (по умолчанию)
bach --shutdown "Summary"    Со сводкой сеанса
bach --shutdown quick        Быстро без сканирования каталога
bach --shutdown emergency    Аварийная ситуация – только сохранение состояния
bach --shutdown --partner=NAME  Завершение работы для конкретного партнера (v1.1.71)

ТИПЫ ВЫКЛЮЧЕНИЯ
--------------
ПОЛНЫЙ (по умолчанию):
- Обновление сканирования каталога
- Автоматический снимок при >= 3 изменениях
- Сохранить сессию в БД
- Подсчет статистики задач

БЫСТРО:
- Нет обновления сканирования каталога
- Сохраняет короткую заметку
- На перерывы, если сеанс вскоре продолжится

ЭКСТРЕННО:
- Сохраняйте только экстренные заметки (приоритет 10)
- Использовать в случае отмены/тайм-аута
- Минимальный бэкап состояния

ПОЛНЫЙ ПРОЦЕСС (v1.1.17)
-------------------------
1. [СКАНИРОВАНИЕ КАТАЛОКА]
   - Обновление статуса ЦЕЛИ
   - Изменения в документах

2. [АВТО-МОНИТ] ***НОВИНКА v1.1.17***
   - Если >= 3 изменений: автоматический снимок.
   - Имя: auto_YYYYMMDD_HHMMSS
   - Продолжение: загрузка снимка Баха

3. [СОХРАНИТЬ СЕАНС]
   - Завершить сеанс в Memory_sessions.
   - Резюме сохранено.
   - Автоматический возврат памяти (v1.1.15):
     Если сводка не указана -> сгенерируйте из Autolog

4. [СТАТУС ПАМЯТИ]
   - Показывает счетчик рабочих/фактов/сессий

5. [СТАТИСТИКА ЗАДАЧ] *** v1.1.14 ***
   - Подсчитывает созданные/выполненные задачи
   - Сохраняет в Memory_sessions

ПРИМЕЧАНИЕ ВЫВОДА
---------------
-------------------------------------------------------
          ПОЛНОЕ ВЫКЛЮЧЕНИЕ
-------------------------------------------------------
 Время: 22.01.2026, 13:15
-------------------------------------------------------

[СКАНИРОВАНИЕ СПРАВОЧНИКА]
 Состояние ЦЕЛИ обновлено (5 изменений)

[AUTO-SNAPSHOT]
 [ОК] Создан автоматический снимок (5 изменений)

[СОХРАНИТЬ СЕАНС]
 [ОК] Сеанс session_20260122_1300 завершен

[СТАТУС ПАМЯТИ]
 Работает: 3 | Факты: 5 | Сессий: 12

[СТАТИСТИКА ЗАДАЧ]
 +2 создано, 1 выполнено (этот сеанс)

-------------------------------------------------------
 Сеанс ЗАВЕРШЕН
-------------------------------------------------------

СОХРАНИТЬ ОТЧЕТ О СЕАНСЕ
-------------------------
Сохраните отчет о сеансе ПЕРЕД завершением работы:

  bach --memory session "THEMA: Was gemacht. NAECHSTE: Was kommt."

Или укажите сводку непосредственно во время завершения работы:

  bach --shutdown "Help-Dateien aktualisiert. NEXT: memory.txt pruefen"

ВАЖНО: отчеты о сеансе относятся к памяти_сессий (БД),
         НЕ в файлах памяти/архива/*.md!

AUTO-MEMORY FALLBACK (v1.1.15)
------------------------------
Если Клод не укажет сводку, она будет создана автоматически
генерируется из автолога. Формат:

  [AUTO-FALLBACK] Команд: 15 (8 уникальных) || список задач, чтение памяти, ...

Это защитная сетка - лучше составить сводку вручную!

КОГДА ОТКЛЮЧЕНИЕ
---------------------
| Ситуация | команда | причина |
|-----------|--------|-------|
| Задача выполнена | --выключение | Полная документация |
| Короткий перерыв | --быстрое выключение | Быстрее, иди скорее |
| Тайм-аут/Прерывание | --аварийное отключение | Минимальное резервное копирование

|ИСТОЧНИКИ ДАННЫХ
-------------
- Memory_sessions: отчеты о сеансах, счетчики задач
- Memory_working: Экстренные заметки
- session_snapshots: автоматические снимки

HANDLER
-------
hub/shutdown.py Обработчик завершения работы (на базе БД)

PARTNER SHUTDOWN (v1.1.71)
--------------------------
Для партнерских сеансов партнер автоматически отключается:

  bach --shutdown --partner=claude   Claude clock out
  bach --shutdown --partner=gemini   Gemini clock out

Карточка штампа (таблица partner_presence) обновляется:
  - статус: онлайн -> оффлайн
  - clocked_out: установка временной метки

Без --partner, «пользователь» считается партнером.

PROSYNC (при выходе)
------------------
Если ProSync активирован (настройка bach prosync --multi-system),
В конце сеанса в транзитный хаб записывается резервная копия БД:
  - Нажмите: экспортируйте локальную базу данных как резервную копию .bachdb.
  — Цель: OneDrive/.SYNC/bach_db_transit/.
ProSync запускается через перехватчик atexit в bach.py, а не в обработчике завершения работы.
Подробности: bach --help db_sync

ИСТОРИЯ ВЕРСИЙ
----------------
v1.1.0 Базовое завершение работы со сканированием каталога
v1.1.14 + статистика задач
v1.1.15 + Автоматический возврат памяти из Autolog
v1.1.17 + Автоматический снимок при >= 3 изменениях
v1.1.71 + Partner Clock-Out (карточка с маркой)

СМОТРИ ТАКЖЕ
----------
bach --help startup        Начать сеанс
bach --help memory         Система памяти (сеанс, факты)
bach --help snapshot       Управление снимками
bach --help tasks          Управление задачами
bach --help db_sync        ProSync: синхронизация мультисистемной базы данных
