Об этом проекте

Assura — это инструмент командной строки для валидации программных проектов, написанный на Rust и распространяемый под двойной лицензией MIT / Apache-2.0. Его заявленная цель — выявлять отклонения в проекте, пока исправления еще не требуют больших усилий. Инструмент предлагает единый быстрый локальный уровень сигналов для проверки структуры репозитория, именования, ограничений файлов и разделов, Markdown, ссылок, нагрузки на ветки и рабочие деревья (worktree), а также специфических политик проекта. Проект описывает свой рабочий процесс как «Onboard once. Review while working. Explain when needed. Check before merge», разделяя Review (описываемый как радар) и Check (описываемый как шлюз). Возможности, описанные в README, включают: валидацию на уровне проекта (именование, размещение, обязательные или запрещенные пути, лимиты файлов, Markdown, ссылки и границы генерируемого вывода) в рамках одной локальной политики; компактный обзор проекта с отображением настроенных проверок, неактивных функций, изменений веток/worktree, «горячих» директорий и ранжированных действий; вывод в форматах text, JSON, YAML, advice, status и agent с контекстом конкретных правил; готовую для агентов адаптацию (onboarding), устанавливающую базовый уровень и локальные руководства; многоразовые слои политик, которые начинаются как независимые от языка и дополняются правилами для конкретных языков или доменов; миграцию конфигураций LS-Lint 2.3; показатели производительности («холодный» и «горячий» запуск); а также непрерывную локальную валидацию, которая поддерживает политику в актуальном состоянии, объединяет всплески правок и сообщает об охвате проверок. Установка предлагается через публичный скрипт для оболочки, готовые архивы релизов для Linux, macOS и Windows (каждый содержит assura и внутренний компонент assura-full, которые должны находиться в одной директории) или сборку из исходного кода через cargo. Типичный запуск для агентов выглядит как agent onboard, review, explain, watch, check; минимальный запуск только для проверки структуры — init, а затем check. Конфигурация хранится в .assura/config.yml с YAML-блоками для соглашений об именовании файлов и директорий, а также шаблонов исключений (globs). В README указано, что проект находится на стадии до версии 1.0: v0.3.0 — последний опубликованный релиз, в то время как Review, Explain, onboarding, обратная связь по событиям и контракты активации на управляемых хостах отнесены к кандидату v0.4.0, который станет доступен для публичной установки только после прохождения тегом шлюза релиза. Таблица поддержки отмечает check и его форматы вывода, init/status/migrate/hooks и отчеты о производительности как поддерживаемые в v0.3.0 и кандидате v0.4.0. Функции review, doctor, explain, agent onboard, agent nudge, команды жизненного цикла интеграции агентов, проверки Markdown/ссылок/руководств с локальными пакетами контента/запросов/контекста, а также watch/cache/daemon/sessions отмечены как части кандидата v0.4.0. Команда assura info, безопасные исправления Markdown и семейства политик расширений от разработчиков остаются экспериментальными. Облачные панели мониторинга, автоматическое широкое исправление, удаленная загрузка плагинов, маркетплейсы плагинов и движки валидации для отдельных агентов явно указаны как неподдерживаемые. Релизы управляются тегами: обновляются версия и примечания, проходятся шлюзы кандидатов в релиз, пушится аннотированный тег v*, после чего рабочий процесс сборки создает архивы для Linux, macOS и Windows с контрольными суммами. Разработка использует многоуровневые команды cargo xtask (fast, pr, release-size, release-smoke, release-live, full), а показатели производительности отслеживаются через cargo benchmarks, включая сравнение с LS-Lint. Ссылки в документации охватывают начало работы, конфигурацию, справочник CLI/API, политику поддержки, примечания к релизам, участие в разработке и безопасность.