forgeplan scan

forgeplan scan обходит дерево проекта и составляет перечень исходных модулей. Он учитывает .gitignore, группирует файлы по крейтам / пакетам / директориям и записывает полученный список в рабочее пространство, чтобы coverage и drift могли сопоставлять его с разделами Affected Files в артефактах.

Представьте, что scan - это шаг «прочитай свой собственный репозиторий». Он не затрагивает артефакты напрямую - он просто делает граф модулей доступным для запросов другими командами контроля качества.

Когда использовать

При первом запуске coverage/drift в рабочем пространстве - scan должен предшествовать им.
После крупного рефакторинга, который добавляет/удаляет модули - повторно сканируйте, чтобы обновить перечень.
В CI: повторно сканируйте перед любой проверкой coverage, чтобы просроченные списки модулей не приводили к ложным срабатываниям.
Перед онбордингом нового члена команды - повторно сканируйте, чтобы coverage показывал реальную картину.

Когда НЕ использовать

Просто для чтения файлов - используйте вашу оболочку. scan учитывает рабочее пространство, а не является универсальным списком файлов.
Если coverage/drift уже запускались, а ваш код не изменился - scan идемпотентен, но расточителен.

Использование

forgeplan scan [OPTIONS]

Опции

      --path <PATH>  Путь к корню проекта (по умолчанию: текущая директория)
  -h, --help         Вывести справку
  -V, --version      Вывести версию

Примеры

Сканирование текущего проекта

forgeplan scan

Вывод:

Scanning /Users/me/forgeplan...
  crates/forgeplan-core      14 modules
  crates/forgeplan-cli        8 modules
  crates/forgeplan-mcp        5 modules
  website/src                12 modules

39 modules indexed in .forgeplan/modules.json

Сканирование соседнего репозитория

forgeplan scan --path ../other-project

Полезно при управлении несколькими проектами из одного рабочего пространства .forgeplan/ (продвинутый сценарий).

Полный конвейер coverage

forgeplan scan && forgeplan coverage && forgeplan drift

Каноническая последовательность сверки кодовой базы: обновление модулей, вычисление coverage, проверка drift. Запускайте её ежемесячно или после крупных рефакторингов.

Интерпретация вывода

Строка	Значение
Строка для каждого крейта	сколько исходных модулей было найдено в каждой директории верхнего уровня
Всего	проиндексированных модулей - это становится знаменателем для coverage

Сканирование не зависит от языка, но настроено для макетов Rust/TypeScript/Python. Пустые директории и модули, предназначенные только для тестирования, исключаются по умолчанию.

Как это вписывается в рабочий процесс

scan → coverage (modules ↔ artifacts) → drift (artifacts ↔ git history) → remediate

scan - это шаг 0 цикла сверки качества. Без него у coverage и drift нет графа модулей, с которым можно было бы работать.

См. также

forgeplan coverage - покрытие решений по модулям
forgeplan drift - решения, чей код был перемещён
forgeplan scan-import - перестроение индекса LanceDB из markdown
forgeplan health - агрегирует coverage в дашборд
Обзор CLI