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

КОНВЕНЦИИ CLI (на основе реестра версии 2.0)
=======================================

АРХИТЕКТУРА:
----------------------------------------
BACH использует автоматическое обнаружение через core/registry.py:
— Обработчики в Hub/*.py находятся автоматически.
- Больше нет статической карты обработчиков (как в v1.x)
- Порядок маршрутизации: --handler → Встроенные команды → экспорт навыков →
  восстановить резервную копию → Реестр → Резервный инструмент 

 СТАНДАРТНЫЙ ШАБЛОН (например, git, npm, docker):
  bach SUBCOMMAND [args]     Выполнить действие
  bach --HANDLER [args]      Обработчик с префиксом --

ДВА ПУТИ ДОСТУПА:
----------------------------------------
1. CLI (для людей):
   Список задач python bach.py

2. Библиотечный API (для LLM/Scripts – ПРЕДПОЧТИТЕЛЬНО):
   из задачи импорта bach_api
   Task.list()

ОСНОВНЫЕ ПОДКОМАНДЫ (управление):
----------------------------------------
  управление задачами (добавление, список, выполнено, блокирование, следующее)
  mem Рабочая память (запись, чтение, статус, архив)
  память Обработчик расширенной памяти (факты, уроки, архив)
  система обмена сообщениями msg (отправка, список, чтение, пинг)
  Урок Извлеченные уроки (добавление, список, поиск, архив)
  резервное копирование Резервное копирование баз данных
  восстановить Восстановить из резервной копии
  дистрибутивы и управление выпусками
  партнерская сеть партнеров (координация Клод/Близнецы/Оллама)
  сессия Управление сессией и резюме

АГЕНТЫ И ЭКСПЕРТЫ (специальности):
----------------------------------------
  налоговый эксперт по налогам (налоговая инспекция, сроки, квитанции)
  ati Агент ATI (разработка концепции)
  або абонентское обслуживание (отмены, контракты)
  генератор отчетов отчетов (отчеты о финансировании ICF)
  помощник по здоровью
  управление семейным бюджетом
  страхование Страхование Менеджмент

УСЛУГИ И ИНФРАСТРУКТУРА:
----------------------------------------
  управление приборной панелью с графическим интерфейсом (запуск, остановка, статус)
  фоновая служба планировщика для обслуживания (ранее: демон)
  сканировать входной сканер (Входящие, OCR)
  соединитель Управление соединителями (опрос, отправка, демон настройки)
  mount Монтирование внешних ресурсов
  цепной инструментарий (автоматизация)
  рутинное рутинное управление (утро/вечер/старт проекта)
  повторяющиеся Повторяющиеся задачи

САМОРАСШИРЕНИЕ И КРЮКИ:
----------------------------------------
  навыки create <имя> --type <тип> Создайте новую способность
                                       Типы: инструмент, агент, эксперт, обработчик, сервис.
  перезагрузка навыков Горячая перезагрузка (Реестр + Инструменты + Навыки)
  статус перехватчиков Статус всех перехватчиков и слушателей
  перехватывает события Список всех событий
  журнал перехватов Последние выполненные перехваты
  перехватчики test <событие> Выдать тестовое событие
  список плагинов Показать загруженные плагины
  плагины load <путь> Загрузить плагин из плагина.json
  плагины выгружают <имя> Выгрузить плагин
  плагины создают манифест плагина <name> Scaffold
  инструменты плагинов Показать все инструменты плагинов

СИСТЕМНЫЕ ИНСТРУМЕНТЫ:
----------------------------------------
  вики-база знаний (wiki/)
  инструменты управления внутренними скриптами
  система валидации и тестирования туев
  тестовые примеры usecase (часть tuev)
  система времени (теперь, формат, анализ)
  таймер Таймер запуска/остановки
  обратный отсчет Создать обратный отсчет
  бить Единое отображение времени (часы, таймер, обратный отсчет, между)
  между временем между двумя моментами времени
  поддерживать функции обслуживания (оптимизация базы данных, очистка журналов)
  тест-раннер тестов (дым, интеграция, полный)

ОБРАБОТЧИК С -- (расширенные функции):
----------------------------------------
  --startup начать сеанс (инициализация, --смотреть опрос)
  --shutdown Завершить сеанс (очистка)
  --status Общее состояние системы
  --help [тема] Показать справку по темам/модулям.
  --memory Подробный обработчик памяти (факты, уроки)
  --db анализ базы данных (схема/статистика bach.db)
  --tokens Контроль стоимости токенов
  --инжекторная система для инструментов
  --context Загрузчик контекста для сессий
  --logs анализ системного журнала (данные/журналы/)
  --docs проверка целостности документации
  --snapshot Заморозить состояние системы
  --trash мусор и восстановление
  --fs защита файловой системы (проверка, лечение, статус)
  --connections Соединения и модель актеров

ВСТРОЕННЫЕ КОМАНДЫ (на основе инструментов, без обработчика):
----------------------------------------
защита файловой системы fs (проверка, лечение, классификация, сканирование)
  файловый файловый менеджер (чтение, запись, копирование, перемещение, удаление)
  ocr Механизм оптического распознавания символов (идентификатор документа или путь к PDF-файлу)
  llm Протокол Multi-LLM (--partner=<имя>)
  граф вызова карты/сопоставитель зависимостей

СПЕЦИАЛЬНЫЕ СЛУЧАИ:
----------------------------------------
  Экспорт навыков Экспорт навыков с разрешением зависимостей
  восстановить резервную копию <файл> восстановить резервную копию

ОБА ВАРИАНТА ПРИНЯТЫ:
----------------------------------------
По историческим причинам они часто работают гибридно:
  bach partner list     = bach --partner list
  bach gui start        = bach --gui start

DID-YOU-MEAN (нечеткое совпадение):
----------------------------------------
При наличии опечаток BACH предлагает аналогичные команды (Левенштейн ≤2):
  $ bach список партнеров → "Вы имели в виду: партнер?"
  $ bach taks add → «Вы имели в виду: задача?»

TOOL FALLBACK:
----------------------------------------
Если обработчик не найден, BACH пробует инструмент из Tools/:
  bach skill_export  → Tools/skill_export.py
  bach backup_manager → tools/backup_manager.py

ЗАРЕГИСТРИРОВАННЫЕ ОБРАБОТЧИКИ (по состоянию на 04.03.2026):
----------------------------------------
109+ обработчиков посредством автоматического обнаружения (hub/*.py):
або, агенты, ати, резервное копирование, удар, отчет, между, календарь, цепочка, часы,
связи, соединитель, консолидация, контакт, контекст, обратный отсчет, резюме,
демон (=планировщик), данные, БД, дист, документ, документы, электронная почта, расширения, фс, здоровье, графический интерфейс,
домашнее хозяйство, проверка здоровья, помощь, крючки, вводить, длинный, урок, журналы, поддерживать,
мем, память, монтирование, сообщение, уведомление, обсидиан, оллама, партнер, путь, профиль,
профилировщик, повторяющийся, отражение, рутина, сканирование, сеанс, выключение, навык,
навыки, умный дом, снимок, источники, запуск, статус, налог, синхронизация, задача,
тест, таймер, жетоны, инструмент, инструменты, мусор, туев, обновление, вариант использования,
страхование, вики

СМОТРИТЕ ТАКЖЕ:
----------------------------------------
  указатель правил справочной практики
  помогите определиться с правилами именования
  Помогите кодировать Стандарты кодирования
  помочь актерам Модель актеров (Соединения)
  помощь партнерам профили партнеров
  помогите перехватывать структуру перехвата (14 событий)
  помочь саморасширению системы саморасширения
