analyze
Запускает свежий скан проекта и отдаёт полный результат как JSON-конверт.
Синопсис
archora analyze [path] [options]path — корень проекта (директория с package.json). По умолчанию — текущая рабочая директория.
Опции
| Опция | Тип | По умолчанию | Значение |
|---|---|---|---|
--output, -o <file> | строка | — | Запись JSON в файл вместо stdout. |
--quiet | булев | false | Глушит progress-сообщения в stderr. |
--help, -h | флаг | — | Показать справку. |
Вывод
Команда отдаёт JSON-конверт ScanResult: метаданные проекта, модули, рёбра, циклы, метрики, нарушения слоёв, рекомендации, archDebt grade и предупреждения. Точная схема — та же, что потребляет десктоп: см. packages/core/src/analyzer/types.ts как источник истины.
В stdout уходит только JSON. Прогресс и summary-строки (Scanning …, Done: N modules…) пишутся в stderr, поэтому пайпинг безопасен:
bash
archora analyze . > scan.json # в scan.json — чистый JSON
archora analyze . | jq '.cycles | length'Примеры
bash
# Быстрый скан текущей директории
archora analyze . > scan.json
# Скан внешнего пути, запись в файл, тихий режим
archora analyze ../my-app --quiet -o scan.json
# Просто число циклов
archora analyze . --quiet | jq '.cycles | length'Exit-коды
0 при успехе, ненулевой — при ошибке скана (плохой путь, падение парсера). Для result-driven гейтов используйте check.
См. Exit-коды для полной таблицы.