Импорт проекта в CodeGraph

Импорт локального или удалённого source, проверка job и явный project scope. Страница объясняет назначение, порядок применения и проверку результата.

РуководстваОбновлено: 2026-08-24

Импорт создаёт или обновляет именованный проект из локального checkout либо Git-репозитория. Запускайте его из source checkout CodeGraph в tenant/group scope, одобренном администратором.

Проверьте текущий parser

python -m src.cli import --help

Обязателен ровно один source selector: --path или --repo. Допустимые режимы показаны в help как --mode {full,selective,incremental}.

Импорт локального checkout

python -m src.cli import --path <source-directory> --mode full

Задавайте --language, только если автоматическое определение ошиблось. С помощью --include и --exclude ограничивайте source surface; проверяйте эти фильтры до утверждений о полноте.

Импорт удалённого репозитория

python -m src.cli import --repo <repository-url> --branch <branch> --mode full

Не включайте credentials в URL. Используйте одобренный заказчиком Git credential mechanism. Для воспроизводимости фиксируйте branch, tag или commit во внешней release procedure.

Наблюдение и проверка

python -m src.cli jobs
python -m src.cli projects list
python -m src.cli projects info <project-name>

Критичный анализ начинайте после завершения import job и проверки актуального project/CPG freshness. Завершённый импорт подтверждается созданной project row и успешным graph build.

Явный project scope

Tenant/group default меняет только уполномоченный оператор:

python -m src.cli projects set-default <project-name>

Для персонального выбора предназначен subcommand projects preference; перед мутацией откройте его help. Неоднозначный scope диагностируйте через projects info и projects resolve-scope.

Обновление и восстановление

incremental применим, только когда текущие project state и source lineage корректны.
full нужен для полной пересборки выбранной source surface.
При failed job сохраните статус и ошибку, исправьте source/access/configuration cause и повторите тот же явный selector.
Не удаляйте и не переименовывайте проект как способ диагностики: это отдельные разрешаемые lifecycle changes.

Результат импорта поддерживает профессиональный анализ. Product acceptance оформляется отдельным решением по требованиям и evidence.

Источники контракта

src/cli/__main__.py — регистрация root commands;
src/cli/core_commands/import_commands.py — import parser;
src/cli/core_commands/projects_commands.py — операции project scope;
src/cli/import_runtime_commands.py — execution routing импорта.

См. также: CLI · Быстрый старт