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

MAINTAIN - Инструменты обслуживания BACH
==============================

ОБЗОР
----------
Сборник инструментов обслуживания и анализа для BACH.
Все инструменты доступны через CLI через bach --maintain

КОМАНДЫ (16)
------------
  bach --maintain docs          Проверка обновлений документации
  bach --maintain duplicates    Информация об обнаружении дубликатов
  bach --maintain generate      Генератор навыков/агентов
  bach --maintain export        Инструменты экспорта
  bach --maintain pattern       Короткий шаблон имени файла
  bach --maintain scan          Система сканирования для инструментов CLI
  bach --maintain clean         Удаление файлов по возрасту/шаблону
  bach --maintain json          Восстановление файлов JSON
  bach --maintain heal          Исправление пути и самовосстановление
  bach --maintain registry      Проверить реестр согласованность
  bach --maintain skills        Проверить работоспособность навыков
  bach --maintain sync          Синхронизировать навыки с базой данных
  bach --maintain headers       Создать/проверить YAML-заголовки SKILL.md
  bach --maintain skill-help    Создать файлы справки из SKILL.md
  bach --maintain workflows     Проверить формат рабочего процесса
  bach --maintain nul           Удалить файлы Windows NUL
  bach --maintain list          Показать все инструменты

ПРОВЕРКА ДОКУМЕНТАЦИИ
--------------------
  bach --maintain docs [--dry-run]

  Обнаруживает устаревшую документацию:
  - Старше 60 дней
  - Неверные пути
  - Отсутствуют ссылки

ГЕНЕРАТОР НАВЫКОВ
---------------
  bach --maintain generate <n> [profil] [zielordner]

  Профили:
    МИКРО — только файлы
    СВЕТ - Минимальный (SKILL.md + конфиг + данные)
    СТАНДАРТ - Стандарт с памятью
    РАСШИРЕННЫЙ - Комплекс с микронавыками

  Примеры:
    bach --maintain generate mein-skill STANDARD skills/
    bach --maintain generate analyse MICRO skills/workflows/

ИНСТРУМЕНТЫ ЭКСПОРТА
------------
  bach --maintain export skill <n> --from-os <path>
  bach --maintain export agent <n> --from-os <path>
  bach --maintain export os-fresh <path> --output <zip>
  bach --maintain export os-reset <path> --backup

ИНСТРУМЕНТ ШАБЛОНА
------------
  bach --maintain pattern <ordner> [optionen]

  Опции:
    --dry-run Только показывать (по умолчанию)
    --execute Выполнить переименование
    --prefix-only Только шаблоны префиксов
    --suffix-only Только шаблоны суффиксов
    -m <n> Минимальная длина шаблона

ИНСТРУМЕНТАЛЬНЫЙ СКАНЕР
------------
  bach --maintain scan [--json]
  bach --maintain scan compare

  Находит установленные инструменты CLI и сравнивает их с реестром.

FILE CLEANER
------------
  bach --maintain clean <ordner> [optionen]

  Опции:
    --age <дней> Файлы старше X дней
    --keep <n> Оставлять только N новейших
    --pattern <p> Шаблон файла (например, «*.log»)
    -r Поиск рекурсивно
    --execute Фактически удалить

  Примеры:
    bach --maintain clean ./logs --age 30
    bach --maintain clean ./backups --keep 5 --execute

JSON FIXER
----------
  bach --maintain json <datei/ordner> [optionen]

  Опции:
    --dry-run Только проверка (по умолчанию)
    --execute Фактически восстановить
    --backup Резервное копирование перед изменением

  Отремонтировано:
    - Спецификация UTF-8
    - Завершающие запятые
    - Одинарные кавычки
    - PowerShell Newlines

PATH HEALER (НОВЫЙ)
-----------------
  bach --maintain heal [optionen]

  Исправляет устаревшие пути в файлах BACH.

  Опции:
    --dry-run Просто проверить, ничего не менять (по умолчанию)
    --execute На самом деле правильно
    --target <p> Проверить только определенный файл
    --report Создать подробный отчет

  Исправлено:
    - Старые пути recludOS -> BACH
    - Старые пути навыков
    - Пути концентратора/обработчика
    - Справочники по инструментам

  Примеры:
    bach --maintain heal                   # Пробный прогон для всех
    bach --maintain heal --execute         # Исправить все
    bach --maintain heal --target config.py

  На основе: RecludOS Unified Path Healer v2.3.0

REGISTRY WATCHER (НОВЫЙ)
----------------------
  bach --maintain registry [optionen]

  Отслеживает и проверяет все реестры BACH.

  Опции:
    check Полная проверка (по умолчанию)
    check --db Проверить только базу данных
    check --json Проверять только конфигурации JSON
    Партнеры Проверка реестра партнеров (НОВИНКА)
    отчет Подробный отчет

  Проверки:
    - Наличие таблиц БД, соответствующих реестру (инструменты, навыки, агенты, партнеры)
    - Файлы конфигурации JSON (только обоснованные исключения)
    - Перекрестные ссылки между таблицами
    - партнерское_распознавание + согласованность_правил делегирования

  Примечание. Partner_registry.json УСТАРЕВШИЙ (см. docs/help/formats.txt)

  Примеры:
    bach --maintain registry               # Быстрая проверка
    bach --maintain registry report        # Подробный отчет
    bach --maintain registry check --db    # Только база данных

  Примечание. Запускается автоматически при --startup (быстрая проверка)

SKILL HEALTH MONITOR (НОВИНКА)
--------------------------
  bach --maintain skills [optionen]

  Отслеживает и проверяет все навыки и агенты BACH.

  Опции:
    check Полная проверка (по умолчанию)
    check --skills Проверять только навыки
    check --agents Проверять только агентов
    отчет Подробный отчет

  Проверки:
    - Каталоги навыков (_агенты, _эксперты, _услуги)
    - Полнота SKILL.md (название, версия, описание)
    - Проверка определений агентов
    - Найдите потерянные или сломанные навыки 

  Примеры:
    bach --maintain skills                 # Быстрая проверка
    bach --maintain skills report          # Подробный отчет
    bach --maintain skills check --agents  # Только для агентов

  Примечание. Запускается автоматически с помощью --startup (быстрая проверка)

SYNC ИНСТРУМЕНТ (НОВЫЙ)
---------------
  bach --maintain sync [optionen]

  Синхронизирует навыки/файлы с базой данных.

  Опции:
    --dry-run Только показывать, ничего не менять (по умолчанию)
    --verbose Подробный вывод
    -v Сокращение от --verbose

  Синхронизировано:
    - Метаданные SKILL.md (название, версия, описание)
    - Статус навыка и зависимости
    - Определения агентов

  Примеры:
    bach --maintain sync               # Пробный прогон
    bach --maintain sync --verbose     # С подробностями
    bach --maintain sync --dry-run -v  # Подробный пробный прогон

ИНСТРУМЕНТ ЗАГОЛОВКОВ (НОВЫЙ)
------------------
  bach --maintain headers [optionen]

  Создает и проверяет заголовки YAML для файлов SKILL.md.

Опции:
    --all Сканировать все каталоги навыков (по умолчанию)
    --path <p> Сканировать конкретный каталог
    --file <f> Обработать отдельный SKILL.md
    --dry-run Только показывать (по умолчанию)
    --исправить изменения записи
    --update-db Обновить версии БД из заголовков YAML
    -v Подробно

  Сканированные каталоги:
    - агенты/*/SKILL.md
    - агенты/_experts/*/SKILL.md
    - хаб/_services/*/SKILL.md
    - партнеры/*/SKILL.md

  Примеры:
    bach --maintain headers                      # Пробный прогон
    bach --maintain headers --fix                # Нормализовать все заголовки
    bach --maintain headers --fix --update-db    # Обновить заголовок + БД
    bach --maintain headers --path agents -v

SKILL-HELP Tool (НОВЫЙ)
---------------------
  bach --maintain skill-help [optionen]

  Генерирует файлы docs/help/*.txt из SKILL.md.

  Опции:
    <имя> Имя отдельного навыка
    --all Обработать все навыки
    -сокращение от --all
    --dry-run Только отображение, ничего не писать
    -n Сокращение от --dry-run

  Примеры:
    bach --maintain skill-help ati              # Справка для агента ATI
    bach --maintain skill-help --all            # Все навыки
    bach --maintain skill-help --all --dry-run  # Пробный запуск

ИНСТРУМЕНТ РАБОЧИХ ПРОЦЕССОВ (НОВЫЙ)
--------------------
  bach --maintain workflows [optionen]

  Проверяет файлы рабочего процесса на предмет единообразия формата.

  Проверки:
    - Доступен заголовок H1
    - Описание (> Цитата, **Цель:**, ## Обзор)
    - Этапы/фазовая структура
    - Информация о версии (необязательно)

  Ожидается в: навыки/рабочие процессы/*.md

  Примеры:
    bach --maintain workflows        # Проверка всех рабочих процессов
    bach --maintain workflows help   # Показать справку

NUL-CLEANER (НОВИНКА)
-----------------
  bach --maintain nul [optionen]

  Удаляет файлы Windows NUL (зарезервированное имя файла).

  Опции:
    сканирование Выводить список только NUL-файлов (по умолчанию)
    удалить Удалить файлы NUL
    очистить/удалить псевдоним для удаления
    <путь> Сканировать конкретный каталог

  Примеры:
    bach --maintain nul                        # Сканировать каталог BACH
    bach --maintain nul scan                   # Только сканирование
    bach --maintain nul delete                 # Сканировать и удалить
    bach --maintain nul delete C:\Pfad         # Определенный каталог

  Примечание. Файлы NUL создаются в Windows случайно.
           записывается после 'NUL' (имя устройства Windows).

TOOLS
-----
  инструменты/doc_update_checker.py Средство проверки документации
  инструменты/duulate_detector.py Обнаружение дубликатов
  инструменты/генераторы/скрипты-генераторы
    Skill_generator.py структуры навыков
    экспортные функции Exporter.py
  инструменты/pattern_tool.py Распознавание образов
  инструменты/tool_scanner.py Обнаружение инструментов CLI
  инструменты/file_cleaner.py Очистка файла
  инструменты/json_fixer.py Восстановление JSON
  инструменты/c_path_healer.py Исправление пути (ВАЖНО: c_path_healer!)
  инструменты/nulcleaner.py Удалить файлы NUL
  Tools/skill_header_gen.py Генератор заголовков YAML
  Tools/skill_help_gen.py Генератор справки + валидатор рабочего процесса
  инструменты/обслуживание/
    Registry_watcher.py Согласованность реестра
    kill_health_monitor.py Здоровье навыков
    sync_skills.py Синхронизация базы данных навыков

АВТОМАТИЧЕСКИЕ ПРОВЕРКИ ПРИ --startup
---------------------------------
Следующие проверки обслуживания запускаются автоматически при запуске сеанса:

  1. Сканирование каталога — изменения с момента последнего сеанса.
  2. Path Healer — коррекция траектории «сухого» хода.
  3. Registry Watcher — быстрая проверка согласованности БД/JSON
  4. Состояние навыков — быстрая проверка навыков/агентов

Для получения подробных отчетов: bach --maintain <tool> report

ТЕКУЩИЙ ОБЗОР ИНСТРУМЕНТА (16 команд)
-------------------------------------
1.  docs — проверка обновления документации
2. дубликаты — информация об обнаружении дубликатов.
3. генерировать — Генератор навыков/агентов.
4. экспорт - инструменты экспорта
5. шаблон — шаблон сокращения имени файла.
6. сканирование — система сканирования инструментов CLI.
7. Очистить - удалить файлы по возрасту/шаблону.
8. json — восстановление файлов JSON.
9. исцеление – исправление пути и самоисцеление.
10. реестр — проверьте целостность реестра.
11. навыки - проверка здоровья навыков.
12. sync - синхронизировать навыки с базой данных.
13. заголовки — SKILL.md генерирует/проверяет заголовки YAML.
14. навык-помощь - Создание файлов помощи из SKILL.md.
15. рабочие процессы — проверка формата рабочего процесса.
16. nul — удаление файлов Windows NUL

СМОТРИТЕ ТАКЖЕ
----------
  docs/help/backup.txt система резервного копирования
  docs/help/test.txt Тестовая система
  docs/help/tools.txt Инвентаризация инструментов
  docs/help/formats.txt Форматы базы данных
