Manual DR (foundation): metadata DB loss and recovery direction

Этот документ описывает «ручной» DR для случаев потери agent.db. Полноценный metadata rebuild — отдельная будущая команда (зарезервирована в 0.17-fix.60). Состояние foundation после 0.17-fix.80 зафиксировано в docs/architecture/metadata.md, docs/architecture/bbolt-storage-layout.md и docs/internal/roadmap/status-matrix.md (Known gaps).

1) Перед аварией: что нужно бэкапить

• agent.db (metadata DB).
• identity/agent.identity (стабильный agent_id).
• (опционально) exports/metadata.json (sanitized export для поддержки/аудита).

2) Сценарий: agent.db повреждён/потерян, но есть backup DB

1. Остановить агент.
2. Заменить agent.db на последний backup.
3. Запустить iobackupctl metadata check.
4. Стартовать агент.

3) Сценарий: agent.db потерян, но artifacts + sidecar manifests существуют

В 0.17-fix.60 автоматический rebuild не реализован. Направление:

• sidecar manifests (role=manifest) являются основой восстановления истории;
• будущая команда iobackupctl metadata rebuild --from-destination ... сможет восстановить runs/tasks/manifests индексами и связями.

4) Сценарий: identity/agent.identity потерян

Если agent_id важен для continuity:

• восстановите identity/agent.identity из backup;
• иначе агент создаст новый agent_id при старте.