Гигиена репозитория

Контроль версий DispatchAtlas содержит написанные вручную исходники, тесты, конфигурацию, документацию, и воспроизводимые метаданные. Продукты локального выполнения остаются вне Git, если только политика явно не повышает их до исходников.

🧹 Политика сгенерированного вывода

Сгенерированные данные экспериментов, контрольные точки, пакеты результатов, отчёты о покрытии, вывод сборки docs, артефакты пакетов, и кандидаты выпуска игнорируются по умолчанию. Они регенерируются из исходников и записываются через происхождение, когда последующие gates их повышают.

Отслеживаемые сгенерированные файлы требуют:

Владельца исходника.
Команды регенерации.
Обоснования удержания.
Пути проверки для устаревшего вывода.

🗃️ Политика кэша

Локальные кэши от Python, Ruff, mypy, pytest, покрытия, сборок документации, и виртуальных окружений игнорируются. CI может кэшировать зависимости, но ключи кэша должны выводиться из lockfile и входов рабочего процесса.

🔬 Политика вывода локальных экспериментов

Локальные прогоны экспериментов пишут в игнорируемые выходные слои рабочего пространства экспериментов — результаты прогонов, журналы, контрольные точки, и пакеты доказательств, как изложено в README самого рабочего пространства — наряду с другими игнорируемыми scratch-местами, такими как outputs/ или artifacts/. Окончательные исследовательские доказательства производятся через валидированные команды кампаний и анализа до любого публичного использования.

📋 Правила удержания артефактов

Класс артефакта	Место по умолчанию	Статус Git	Удержание
Сборки пакетов	`dist/`	Игнорируется	Пересобрать по требованию.
Сборка docs	`site/out/`	Игнорируется	Пересобрать по требованию.
Покрытие	`htmlcov/`, `.coverage*`	Игнорируется	Пересобрать во время проверок качества.
Smoke-выводы	`outputs/`	Игнорируется	Хранить локально только при отладке.
Результаты кампаний	слои результатов и контрольных точек рабочего пространства экспериментов	Игнорируется	Повышать только через экспорты с gate происхождения.
Доказательства выпуска	`artifacts/`	Игнорируется до одобрения	Удерживать по политике кандидата выпуска.