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

BACH v3 - ФУНКЦИИ
====================

Обзор всех реализованных функций и их статуса.

АРХИТЕКТУРА v2.0 (НОВИНКА)
----------------------
Система обработчиков на основе реестра с автоматическим обнаружением:
- 109+ обработчиков в хабе/обнаруживаются автоматически
— Библиотечный API (bach_api.py) для программного доступа.
- Двойной обработчик инициализации (поддержка пути + приложения)
- Файлы с несколькими обработчиками (time.py, tuev.py)
- Интегрированы когнитивные инжекторы 

Два пути доступа:
1. CLI: задача python bach.py добавить "..." --priority P4
2. API библиотеки: из задачи импорта bach_api; Task.add("...", "--priority", "P4")

КОМАНДЫ CLI (ядро)
------------------
bach --startup              Начать сеанс (с DirScan, GUI)
bach --shutdown             Завершить сеанс (архивная память)
bach --status               Показать состояние системы
bach --help [thema]         Справка (более 60 тем)

УПРАВЛЕНИЕ ЗАДАЧАМИ
---------------
bach task add "..."         Создать новую задачу
bach task list              Показать задачи
bach task done T001         Завершить задачу
bach task edit T001 "..."   Редактировать задачу

ПАМЯТЬ СИСТЕМА
-------------
bach mem write "..."        Запись в память
bach mem read               Чтение памяти
bach mem context            Показать контекст
bach mem archive            Архивировать сеанс

СООБЩЕНИЯ
-----------
bach msg send "..."         Отправить сообщение
bach msg list               Просмотреть сообщения
bach msg read M001          Прочитать сообщение
bach msg unread             Показать непрочитанные

СКАНЕР
-------
bach scan run               Инструменты сканирования
bach scan status            Статус сканирования
bach scan tasks             Показать отсканированные задачи

ОБСЛУЖИВАНИЕ (планировщик, ранее демон)
-------------------------------------
bach scheduler jobs            Показать задания
bach scheduler run J001        Выполнить job
bach scheduler status          Показать статус планировщика
(Псевдоним: bach daemon ... продолжает работать)

GUI и REST API
--------------
bach gui start              Запустить веб-панель (порт 8000)
bach gui start-bg           Запустить в фоновом режиме
bach gui status             Состояние сервера

REST API (безголовый сервер):
  python gui/api/headless.py --port 8001
  Конечные точки:
    GET /api/v1/tasks Список задач
    POST /api/v1/tasks Создать задачу
    ПОЛУЧИТЬ /api/v1/memory/facts Получить факты
    POST /api/v1/messages/send Поставить сообщение в очередь
    GET /api/v1/messages/inbox Прочитать входящие
    GET /api/v1/status Состояние системы
  Документы Swagger: http://localhost:8001/api/docs

ИНЖЕКТОРЫ
----------
bach --inject status        Состояние инжектора
bach --inject toggle X      Инжектор вкл./выкл.
bach --inject task 5        Задача бюджета времени

РЕЗЕРВНОЕ КОПИРОВАНИЕ
------
bach backup create          Создать резервную копию
bach backup list            Просмотреть резервные копии
bach backup restore X       Восстановить резервную копию

БАЗА ДАННЫХ
---------
bach --db status            Состояние базы данных
bach --db query "SQL"       Запустить SQL

CONNECTOR SYSTEM v2.0 (НОВАЯ)
---------------------------
Надежное сообщение доставка с очередью, повтор/откат, автоматический выключатель.
Адаптер времени выполнения: Telegram, Discord, HomeAssistant

bach connector list         Показать коннекторы
bach connector status       Состояние активных коннекторов
bach connector add <type>   Зарегистрировать новый коннектор
bach connector messages     Показать сообщения
bach connector poll <name>  Опросить один раз (получить сообщения)
bach connector dispatch     Очередь обработки (отправить сообщения)
bach connector queue-status Queue-Statistiken (pending/failed/dead)
bach connector retry [id]   Сбросить недоставленное сообщение

Интеграция с демоном:
  poll_and_route (каждые 2 минуты) — пыльца + маршрутизация
  отправка (каждую 1 минуту) - очередь обработки

Особенности:
- Повторить попытку с экспоненциальной задержкой (от 30 до 480 с)
- Автоматический выключатель (перезарядка 5 минут после 5 ошибок)
- Очередь недоставленных сообщений для ошибочных сообщений.
- Контекстные триггеры для инжекторов во время маршрутизации 

ГОЛОСОВОЙ СЕРВИС (НОВЫЙ)
-------------------
STT (преобразование речи в текст): Whisper (онлайн), Vosk (оффлайн)
TTS (преобразование текста в речь): pyttsx3 (Windows SAPI5/espeak)
Слово пробуждения: openwakeword (необязательно), резервная клавиатура 

Путь к инструменту: system/hub/_services/voice/voice_stt.py
Интеграция: Может быть интегрирован в систему разъемов

МАТРИЦА ФУНКЦИЙ
--------------

| Площадь | Следует | Есть | Статус |
|-------------------|------|------|--------|
| Команды CLI | 20 | 60+ | ОК |
| Разделы помощи | 21 | 60+ | ОК |
| Обработчик (Реестр)| 12 | 109+ | ОК |
| Навыки (Файл) | 30 | 50+ | ОК |
| Навыки (JSON) | 50 | 0 | JSON* |
| Инструменты (Файл) | 30 | 90+ | ОК |
| Инструменты (Реестр) | 60 | 85 | ОК |
| Конечные точки графического интерфейса | 30 | 80+ | ОК |
| Конечные точки REST API | 10 | 12 | ОК |
| Таблицы БД | 25 | 138 | ОК |
| Разъемы | 3 | 3+ | ОК 

|*) Навыки и эксперты в основном управляются черезkill_hierarchy.json.

Handler (автоматическое обнаружение в хабе/):
  або, агенты, ати, резервное копирование, отчет, календарь, цепочка, соединения,
  соединитель, консолидация, контакт, контекст, резюме, демон (=планировщик), data_anaанализ,
  БД, расст, документ, документы, расширения, фс, здоровье, графический интерфейс, домашнее хозяйство, здоровье,
  помощь, входящие, вставка, язык, урок, журналы, ведение, память, сообщения,
  монтировать, multi_llm_protocol, уведомлять, обсидиан, оллама, партнер, путь,
  профиль, профилировщик, повторяющийся, отражение, рутина, сканирование, сеанс,
  выключение, навыки, умный дом, снимок, источники, запуск, статус,
  налог, синхронизация, задача, тест, время, жетоны, инструменты, мусор, туев, обновление,
  страхование, вики

РЕАЛИЗОВАННЫЕ ГРАФИЧЕСКИЕ ПАНЕЛИ
-----------------------------
- Домашняя страница (Обзор, Токены, Входящие)
- Доска навыков (агенты, эксперты, навыки, инструменты)
- Доска памяти (Работа, Факты, Уроки, Сеансы)
- Финансовый (Финансовый помощник/Страхование)
- Планировщик финансирования (клиентский конвейер)
- Здоровье (Помощник по здоровью - Бета)
- ATI (разработка концепции)

ПЛАНИРУЕМЫЕ ФУНКЦИИ
-----------------
- Skill-Sync Автоматическая синхронизация файлов <-> Иерархия
- Общий контекст Multi-LLM Истинный общий контекст для разных моделей.
- Агенты в автономном режиме могут выполнять задачи независимо (цикл)
- Voice Full-Stack Полная интеграция голосового интерфейса (STT/TTS/Wake)
- Система удлинительных разъемов Signal Connector, включающая в себя сигнальный мессенджер
- Система соединителей расширения WhatsApp Connector для WhatsApp

CHANGELOG v2.0 (с 06 февраля 2026 г. по 08 февраля 2026 г.)
-------------------------------------------
[v2.0.0 - 08 февраля 2026 г.] На основе реестра + Connector v2.0 + Voice
+ Система обработчиков на основе реестра (автоматическое обнаружение, более 64 обработчиков)
+ Библиотечный API (bach_api.py) для программного доступа
+ Система коннекторов v2.0: очередь, повторная попытка/откат, автоматический выключатель
+ Адаптер времени выполнения: Telegram, Discord, HomeAssistant
+ Голосовая служба: STT (шепот/воск), TTS (pyttsx3), Wake Word
+ Безголовый сервер REST API (порт 8001, 12 конечных точек)
+ Интеграция с демоном (poll_and_route + отправка заданий)
+ Миграция схемы с отслеживанием повторных попыток и автоматическим выключателем
+ Схема БД: более 210 таблиц (единый источник достоверной информации)
+ 50 тестов (test_core + test_smoke) - все зеленые
+ Объединены пути журналов (только система/данные/журналы/)
+ Объединенная папка _partners (только system/partners/)

СМОТРИ ТАКЖЕ
----------
bach --help gui         Подробности веб-панели
bach --help tasks       Управление задачами
bach --help wartung     Обслуживание (задания/демон)
bach --help dirscan     Система сканирования
bach --help connector   Сведения о системе коннектора

ДРУГИЕ РЕСУРСЫ
------------------
- Документация по архитектуре: docs/con3_ANFORDERUNGSANALYSE.md
- Журнал изменений: Memory/MEMORY.md (раздел bach.py v2.0)
- Тесты: system/tests/ (test_core.py, test_smoke.py)
- REST API Swagger: http://localhost:8001/api/docs (если сервер запущен)
— Примеры библиотечного API: system/bach_api.py (строка документации).
