Дебаты Astra × Fable09-tools-and-adapters
9. Инструменты и минимальная реализация
Выбор по потребности
Не требуется заранее выбирать единую платформу для всех задач. Сначала выясняется стек проекта и существующие возможности, затем проверяются контракты адаптеров. Ниже — категории, а не обязательные новые зависимости.
| Потребность | Начальный вариант | Когда усложнять |
|---|---|---|
| Знания и review | Markdown/YAML в Git, обычный просмотрщик | Много репозиториев/типов связей — общий реестр |
| Поиск и impact | Поиск символов, импорты, регистрации, индексы | Измеренные пропуски/масштаб — AST/LSP/graph; semantic search для кандидатов |
| Извлечение runtime | Изолированное Django introspection и тестовая трассировка | Динамика требует покрыть больше конфигураций/процессов |
| Тесты | Существующий runner, Django tests/pytest по факту проекта | Свойства/состояния — property testing; критичные слабые проверки — mutation |
| Исполнение ранбуков | Небольшой runner, долговечный журнал, subprocess/API adapters | Долгие ожидания, concurrency, распределённость — workflow engine |
| Приёмка | Доверенная CI-конфигурация, отдельный gate/identity | Платформа не даёт нужные права/условные операции — отдельный сервис |
| Доказательства | CI artifacts + экспорт важных manifest | Долгий аудит/смена платформы — независимое объектное хранилище |
| Работа моделей | CLI/SDK с зафиксированными моделями и правами | Оркестрация нескольких ролей, оценка и учёт затрат |
Точные версии и доступность функций проверяются по официальной документации фактического окружения. В универсальном гайде нельзя обещать единую готовую команду Django для экспорта абсолютно всех бизнес-связей, сигналов и динамики — такой результат требует нескольких методов и явной оценки неполноты.
Контракты четырёх обязательных адаптеров
Policy / approval
Вход: субъект, действие, объект/кандидат, контекст, версия действующей политики. Выход: allow/deny/waiting_decision, основания, область и версия GRANT, момент допуска и audit event. Источник решения и политики защищён.
Проверки: поддельное/чужое решение, истёкший/отозванный grant, саморазрешение в PR, несоответствие роли, публикация политики без активации. Отзыв и допуск упорядочены по документированному протоколу. Недоступность обязательного источника не превращается в allow.
CI / evidence
Вход: candidate core и доверенный verification plan. Выход: manifest фактических запусков, результатов, попыток и артефактов с происхождением. Runner исполняет кандидат изолированно; привилегированный сборщик не доверяет произвольному JSON, который записал этот же кандидат.
Проверки: чужой candidate ID, ложный producer, неправильный hash, неполный набор, пустые tests, skipped, потеря артефакта, прерванный запуск. Состав/смысл тестов важнее только счётчика: один нерелевантный тест не заменяет удалённый обязательный набор.
Merge / release
Вход: принятый кандидат, ожидаемые head/base/result и актуальный допуск. Выход: конкретный внешний ID/commit/artifact, подтверждённое содержимое, время и результат действия. Право записи принадлежит отдельному исполнителю.
Проверки: сдвиг head/base, другая merge strategy, подмена workflow, отзыв до точки допуска, повтор операции, потерянное подтверждение. Одна кнопка человека не компенсирует отсутствие правильного технического барьера. Если enforcement не прошёл проверку, соответствующая автоматическая операция не допускается.
Resume / reconciliation
Вход: run ID, журнал, закреплённые версии, известные объекты и workspace. Выход: восстановленное состояние либо конкретный unknown/blocked. Сохраняются tracked, untracked и чужие правки. Побочные эффекты сверяются по идентичности; отсутствие ответа не равно отсутствию операции.
Проверки: crash в каждой границе до/после эффекта, два параллельных resume, посторонняя правка, конфликт PR, отозванный ранбук, недоступный provider. Для параллельного исполнения нужен lease/lock с документированной семантикой, чтобы два runner не выполнили одно действие независимо.
Истёкший lease не останавливает старый процесс физически. Передача владения использует проверяемое поколение владельца (fencing token), сериализованный посредник или иной испытанный механизм, который отвергает поздний вызов прежнего владельца. Проверка включает паузу старого runner, передачу lease и его последующее пробуждение перед внешним эффектом.
Порядок сборки MVP
- Зафиксировать схемы CHG, RB, candidate, EV, DEC/GRANT.
- Реализовать чтение/валидацию и построение manifest без побочных эффектов.
- Подключить проверенный запуск существующих тестов и запись evidence.
- Подключить операции Git/PR с устойчивыми ID и reconciliation.
- Подключить доверенный policy/approval и отдельную приёмку.
- Прогнать положительные и отрицательные испытания адаптеров.
- Разрешить узкий класс внешних действий и пройти пилот.
До подключения рабочего policy-адаптера внешние операции выполняются в учебной среде с ограниченными credentials либо в пределах технически обеспеченного начального мандата. Порядок списка не разрешает сначала действовать без права, а затем добавлять контроль.
| Шаг | Критерий выхода |
|---|---|
| 1. Схемы | Обязательные поля, статусы, связи и версии определены; примеры валидны |
| 2. Чтение | Один и тот же снимок даёт воспроизводимый manifest; missing/конфликт не скрыт |
| 3. Тесты | Подтверждены фактический набор, входы и producer; пустой/чужой отчёт отвергается |
| 4. Git/PR | Подтверждён внешний объект; тайм-аут и повтор не создают дубликат и не теряют файлы |
| 5. Политика | Чужое, истёкшее и отозванное право отвергается; кандидат не активирует своё разрешение |
| 6. Испытания | Каждый внедрённый сбой остановлен ожидаемым механизмом, результат сохранён |
| 7. Пилот | Заданные критерии класса выполнены на контрольных задачах; ограничения и область допуска приняты |
Названия операций в примерах гайда — проектируемые интерфейсы; файлы руководства сами их не устанавливают. Конкретный код адаптеров и CI создаётся на этапе живого репозитория.
Сопровождение и пропущенные аспекты
Нужны владельцы процесса и доменов, журнал версий инструментов/моделей, доступы и секреты, ограничение расходов, резервирование журнала, проверка восстановления, observability, лицензии зависимостей и политика данных. Документация и правила самих агентов обновляются через тот же контролируемый процесс; инструкции в issue, логах и внешних материалах не выдают новых прав.
Release evidence должен переживать удаление ветки. Экспорт содержит контрольные суммы и происхождение записей, а восстановление проверяется на отдельном экземпляре. Переезд на другой provider требует перепроверки семантики API, прав и статусов, а не только замены URL.