multi: оркестрация мультирепозиториев при разработке с ИИ-агентами

Стремительное внедрение автономных ИИ-агентов (Coding Agents, Claude Code, Cursor) обнажило скрытую проблему микромодульной архитектуры. Когда кодовая база разбита на десятки независимых репозиториев — отдельные библиотеки утилит, контракты схем данных, логгеры и микросервисы — скорость генерации правок машиной вступает в конфликт с возможностями человеческого восприятия.

Агент вносит изменение в интерфейс базовой библиотеки, что каскадно ломает тесты в двух зависимых микросервисах и шлюзе. Разработчик оказывается погребен под десятками открытых терминальных окон: нужно вручную переходить между директориями, проверять git status, запускать линтеры и вылавливать расхождения. Инструмент multi, представленный Тимуром Шемсединовым и сообществом Metarhia, предлагает специализированный консольный командный центр (TUI) для управления связанными полирепозиториями.

Когнитивный парадокс полирепозиториев

Монорепозитории с инструментами вроде Nx или Turborepo решают проблему связности ценой утяжеления тулчейна и потери независимости версионирования. Команды, выбирающие физическое разделение репозиториев (polyrepo), получают чистые границы модулей, но расплачиваются колоссальными накладными расходами на переключение контекста.

Появление ИИ-помощников обострило эту проблему: если человек пишет код последовательно, то агент может модифицировать файлы в четырех репозиториях параллельно за считаные секунды. Отсутствие общего дашборда приводит к тому, что незакоммиченные диффы теряются, а несогласованные версии зависимостей вызывают скрытые баги в рантайме.

Архитектура командного центра multi

Программа multi написана на Node.js и представляет собой легковесный полноэкранный интерфейс для терминала. Экран разбит на функциональные зоны, обновляющиеся в реальном времени:

• Монитор статуса репозиториев: единая матрица отображает текущую ветку, число коммитов до апстрима и наличие несохраненных изменений в каждом модуле.
• Параллельный раннер проверок: фоновые процессы запускают тесты (node --test), проверку типов TypeScript и линтеры, отображая прогресс компактными таймерами.
• Агрегатор диффов и задач: позволяет просматривать суммарный дифф по всем проектам и переключать экраны (files, diffs, tasks, npm) быстрыми горячими клавишами.

Декларативная конфигурация и координация тестов

Рабочее пространство описывается простым JSON-манифестом, фиксирующим пути к директориям модулей и команды запуска проверок:

{
  "name": "metarhia-workspace",
  "root": "~/projects/metarhia",
  "repositories": [
    { "name": "metautil", "path": "./metautil", "testCmd": "node --test" },
    { "name": "metaschema", "path": "./metaschema", "testCmd": "node --test" },
    { "name": "metalog", "path": "./metalog", "testCmd": "npm test" },
    { "name": "impress", "path": "./impress", "testCmd": "node --test test/all.js" }
  ],
  "tasks": {
    "lint": "eslint . --cache",
    "typecheck": "tsc --noEmit"
  }
}

Управление средой оптимизировано для терминальной работы и скриптов автоматизации:

# Запуск интерактивного TUI-дашборда
npx multi

# Параллельный прогон тестов во всей группе репозиториев
multi run test --parallel --concurrency=4

# Сводный аудит незакоммиченных изменений после работы ИИ-агентов
multi diffs --summary

Контроль над агентами без перерасхода памяти

Использование специализированного TUI вместо открытия десятка экземпляров тяжелых графических редакторов дает очевидные выгоды:

1. Экономия системных ресурсов: консольный монитор потребляет десятки мегабайт оперативной памяти вместо гигабайтов, оставляя процессорные мощности компиляторам и локальным моделям.
2. Синхронизация зависимостей: экран npm мгновенно подсвечивает расхождения версий общих библиотек, предотвращая рассинхронизацию контрактов.
3. Безопасность генерации: архитектор видит полную картину изменений во всех модулях перед фиксацией коммитов, превращая хаотичную работу агентов в контролируемый процесс.

Инструмент multi демонстрирует, как прагматичный подход к терминальным интерфейсам снимает инфраструктурное трение в эпоху искусственного интеллекта.