# Portability: SYSTEM
# Last validated: 2026-05-17
# Next review: 2027-05-17
# Ресурсы: [таблица session_snapshots,hub/snapshot.py]

СИСТЕМА СНИМОК BACH
--------------------

Статус: 2026-02-08

Снимки сеанса обеспечивают точное «состояние ума» сеанса ИИ.
Это позволяет загрузить контекст в новый экземпляр или
возобновление работы после сбоя/выключения.

КОМАНДЫ
-------
  bach --snapshot create [name]  Сохранить текущий статус.
  bach --snapshot list           Доступные снимки (авто и вручную).
  bach --snapshot load [ID]      Восстанавливает рабочую память и задачи.
  bach --snapshot delete <ID>    Удаляет старые снимки.

КОНЦЕПЦИЯ: ДЕРЕВО СОСТОЯНИЙ
-----------------------
Снимок в BACH состоит из следующих компонентов:
1. ИДЕНТИФИКАТОР СЕССИИ: контекст текущего сеанса.
2. ОТКРЫТЫЕ ЗАДАЧИ: Какие задачи были активными/открытыми (до 10)
3. ПОСЛЕДНЯЯ ПАМЯТЬ: последние записи рабочей памяти (последние 5).
4. МЕТАДАННЫЕ СЪЕМКИ: отметка времени, тип (авто/ручной), имя

ОТЛИЧИЕ ОТ ДРУГИХ СИСТЕМ
-------------------------------
- ПАМЯТЬ: важные знания (долгосрочные).
- ЖУРНАЛЫ: Что было сделано (исторически).
- СНИМОК: Где мы сейчас находимся (в работе).

АВТОМАТИЧЕСКИЙ
---------
Снимки могут создаваться автоматически или вручную. тип_снимка
различает «вручную» (через --snapshot create) и «авто» (потенциально
через --shutdown). Реализация поддерживает оба типа.

БАЗА ДАННЫХ
---------
Таблица: `session_snapshots` (system/db/schema.sql, строки 226-239).
Поля:
  - id, session_id, snapshot_type, имя
  - snapshot_data (JSON: содержит open_tasks, недавнюю_память, созданную_ат)
  - рабочая_память, открытые_задачи, активные_файлы (отдельные поля JSON, необязательно)
  - token_usage, context_hash, примечания
  - создано_at (временная метка)

ПРИМЕРЫ
---------
  bach --snapshot create "Vor Grossumbau"  # Резервное копирование вручную
  bach --snapshot list                     # Проверить статус
  bach --snapshot load 42                  # Восстановить идентификатор 42
  bach --snapshot delete 42                # Удалить снимок 42

СМОТРИТЕ ТАКЖЕ
----------
  docs/help/memory.txt Консолидация памяти
  docs/help/maintain.txt Проверка целостности
  bach --help startup  Начало сеанса
