Как попробовать инструмент
Сначала — важное различие
Публичный preview CLI и текущий каталог 022 — не один уровень готовности. Подтверждённый маршрут отдельного правила в интеграционном тесте ещё не означает, что весь каталог доступен одной CLI-командой. Общая интеграция портфеля остаётся отдельной задачей.
Сборка preview
Документированный профиль preview: macOS 26.x, arm64, Xcode 26.6 и Apple Swift 6.3.3 (swiftlang-6.3.3.1.3). Точная матрица находится в docs/toolchains/phase-zero-profile.md; поддержка другого окружения не предполагается автоматически.
Из корня репозитория:
swift build -c release --disable-automatic-resolution --product swift-analyzer
.build/release/swift-analyzer --help
Если зависимости ещё не получены, сначала следуй docs/preview/installation.md и сохрани зафиксированный Package.resolved. Пока другой агент собирает или тестирует этот checkout, дождись завершения его SwiftPM-процесса.
Для анализа нужен подготовленный manifest
Preview потребляет уже подготовленные данные сборки. Передать только путь к произвольному проекту недостаточно. Для точной процедуры подготовки смотри openspec/specs/001-phase-zero-reachability/quickstart.md.
Когда manifest уже готов:
.build/release/swift-analyzer doctor --manifest /path/to/manifest.json --format human
.build/release/swift-analyzer stats --manifest /path/to/manifest.json --format human
.build/release/swift-analyzer scan --manifest /path/to/manifest.json --format json
/path/to/manifest.json — пример пути, а не файл из репозитория. Эти команды иллюстрируют preview; они не включают автоматически все правила 022.
| Команда | Зачем нужна |
|---|---|
doctor | Проверить входные данные и готовность возможностей |
stats | Посмотреть наблюдаемую статистику |
scan | Получить результаты запрошенного анализа |
why | Разобраться в объяснении конкретного результата |
Для автоматизации используй JSON и сохраняй код возврата. Например, exit 3 означает неполный результат, а не успешную проверку без проблем. Полная грамматика — в docs/preview/cli.md.
Запуск этого сайта
Сайт независим от сборки Swift-анализатора. Требуется Node.js 20 или новее.
cd website
npm ci
npm start
Локальный адрес выводит команда запуска. Статическая сборка: npm run build;
просмотр собранного сайта: npm run serve. Эти development-команды не являются
публичными URL продукта.