# Portability: SYSTEM
# Last validated: 2026-05-17
# Next review: 2027-05-17
# Ресурсы: [hub/chain.py,toolchains, Scheduler_jobs]

CHAIN — связанные команды инструментов и цепочки LLM
================================================

Статус: 2026-02-28

Система цепочек позволяет объединять команды BACH (цепочки инструментов)
и управление цепочками агентов LLM через MarbleRun/llmauto.

Ссылка: SYS_002, SQ074

ДВА ТИПА ЦЕПИ
----------------

1. ИНСТРУМЕНТАЛЬНЫЕ ЦЕПИ (база данных)
   Последовательные инструкции BACH без LLM. Хранится в bach.db.
   Подходит для автоматизированных рабочих процессов.

2. LLMAUTO ЦЕПИ (файлы JSON)
   Цепочки агентов LLM через MarbleRun (llmauto). Запустить как
   Фоновые процессы.

КОМАНДЫ CLI - ИНСТРУМЕНТАЛЬНЫЕ ЦЕПИ (БД)
-----------------------------

  list Показать все цепочки (toolchains + llmauto)
  run <id> Запустить цепочку инструментов
  добавить "JSON" Создать новую цепочку инструментов
  show <id> Посмотреть подробности
  delete <id> Удалить цепочку инструментов
  log <id> Просмотр журналов цепочки инструментов

КОМАНДЫ CLI - LLMAUTO CHAINS (JSON)
-------------------------------------

  create <имя> Создать новую цепочку llmauto
  start <имя> стартовая цепочка (фоновый процесс)
  стоп <имя> Остановить цепочку
  status [имя] Показать статус (вся или определенная цепочка)
  сброс <имя> Сбросить состояние цепочки

ВАРИАНТЫ ДЛЯ СОЗДАНИЯ
---------------------

  --mode Once|режим выполнения цикла (по умолчанию: один раз)
  --skill PATH SKILL.md путь для агента
  --model МОДЕЛЬ Модель ИИ (сонет, опус, хайку)

ПРИМЕРЫ
---------

  # Список инструментов 
  bach chain list

  # Запускаем набор инструментов
  bach chain run 1

  # Создать цепочку инструментов (формат JSON)
  bach chain add '{"name":"taeglich","steps":["bach backup create","bach scan run"]}'

  # Подробности о наборе инструментов
  bach chain show 1

  # Просмотр журналов
  bach chain log 1

  # создаем цепочку llmauto
  bach chain create mein-workflow
  bach chain create analyse --mode once --model opus

  # управление цепочкой llmauto
  bach chain start mein-workflow
  bach chain status
  bach chain status mein-workflow
  bach chain stop mein-workflow
  bach chain reset mein-workflow

TOOLCHAIN ​​JSON FORMAT
---------------------

  {
    "name": "Название сети",
    "description": "Описание",
    "шаги": [
      "список задач Баха",
      "создать резервную копию Баха",
      "запуск сканирования Баха"
    ]
  }

  Каждый шаг представляет собой полную команду Баха.
  Шаги выполняются последовательно.

LLMAUTO CHAINS
--------------

Цепочки llmauto выполняются как независимые процессы кода Claude.
на заднем плане. Они используют MarbleRun для оркестровки.

  data/chains/<имя>/ Каталог цепочки
    Конфигурация цепочки config.json
    state.json Текущее состояние
    Заявление агента SKILL.md

БАЗА ДАННЫХ
---------

  цепочки инструментов:
    идентификатор, имя, описание, шаги_json, созданный_at, обновленный_at

  инструментальная цепочка_runs:
    идентификатор, идентификатор_цепи, статус, начало_в, завершение_в, журнал

ФАЙЛЫ
-------
  реализация обработчика Hub/chain.py
  данные/цепочки/конфигурации цепочки llmauto

СМОТРИТЕ ТАКЖЕ
----------
  bach --help scheduler    Система планировщика (задания)
  bach --help agent        Панель запуска агентов
  bach --help tasks        Система задач
