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

ИМЯ ОБРАБОТЧИКА
============
интеграция

ОПИСАНИЕ
============
Интеграция партнера LLM и синхронизация контекста BACH. Управляет подключением к
внешние системы искусственного интеллекта (Claude, Gemini, Ollama) через структурированные файловые блоки Markdown
с четкими маркерами. Основа: управляемый уровень 2 (CLAUDE.md/GEMINI.md/OLLAMA.md Push).

Часть SQ038: интеграция кода Claude и партнерский мост LLM.

OPERATIONS
===========
status Показать текущий статус интеграции (по умолчанию)
                  Источники: system_config, проверка маркера CLAUDE.md.
                  Вывод: конфигурация, состояние файла, модель этапа 

push-claude отправит блок BACH в CLAUDE.md (управляемый этап 2)
                  Требуется: инструменты/claude_md_sync.py + родительский каталог.
                  Эффект: Создает или обновляет BACH:START...BACH:END

push-gemini Перемещает блок BACH в GEMINI.md (управляемый уровень 2).
                  Идентичен push-claude, партнер: GEMINI

push-ollama Отправить блок BACH на OLLAMA.md (Управление 2-го уровня)
                  То же, что push-claude, партнер: OLLAMA

pull-claude [ЕЩЕ НЕ РЕАЛИЗОВАНО - Уровень 3]
                  Планируется: содержимое вручную из CLAUDE.md обратно в БД 

config. Показать текущую конфигурацию интеграции из system_config.
                  Фильтр: Все ключи с префиксом «интеграция.*».
                  Отображение: ключ, значение, необязательно. Описание

set <партнер> Установить уровень интеграции для каждого партнера.
<уровень> Партнеры: Клод, Близнецы, Оллама, Клод-код, ...
                  Уровень: выключен | синхронизировать | управляемый | полный
                  Местоположение: system_config (БД)
                  выкл = нет вмешательства BACH
                  sync=MEMORY.md из БД (SQ065)
                  управляемый = блок CLAUDE.md BACH (доступен на данный момент)
                  полный = перехватчики + внедрение контекста (планируется)

ПРИМЕРЫ
=========
1. Проверьте статус интеграции:
   bach integration status

2. Обновите блок BACH в CLAUDE.md:
   bach integration push-claude

3. Активируйте интеграцию Claude на уровне 2:
   bach integration set claude-code managed

4. Показать текущую конфигурацию:
   bach integration config

5. Отключить интеграцию:
   bach integration set claude-code off

FILES
=======
hub/integration.py реализация обработчика (класс IntegrationHandler)
инструменты/claude_md_sync.py ClaudeMdSync — синхронизация и управление блоками BACH
Таблица data/bach.db system_config: уровень интеграции для каждого партнера
                            Формат ключа: интеграция.<партнер>.уровень

СМОТРИ ТАКЖЕ
==========
-hub/base.py Класс BaseHandler (наследование)
- docs/HANDLER.md Архитектура обработчика
- Спецификация BACH_Dev/BACH_Memory_Architecture_Concept.md SQ038
