Higiene del repositorio

El control de versiones de DispatchAtlas contiene fuente, pruebas, configuración, documentación, y metadatos reproducibles escritos a mano. Los productos de ejecución local permanecen fuera de Git a menos que una política los promueva explícitamente a fuente.

🧹 Política de salida generada

Los datos de experimento generados, puntos de control, paquetes de resultados, informes de cobertura, salida de compilación de docs, artefactos de paquete, y candidatos de lanzamiento se ignoran por defecto. Se regeneran desde la fuente y se registran mediante procedencia cuando gates posteriores los promueven.

Los archivos generados rastreados requieren:

Un dueño de fuente.
Un comando de regeneración.
Una justificación de retención.
Una ruta de revisión para salida obsoleta.

🗃️ Política de caché

Las cachés locales de Python, Ruff, mypy, pytest, cobertura, compilaciones de documentación, y entornos virtuales se ignoran. CI puede cachear dependencias, pero las claves de caché deben derivarse de lockfiles y entradas de flujo de trabajo.

🔬 Política de salida de experimento local

Las ejecuciones de experimento local escriben a las capas de salida ignoradas del espacio de trabajo de experimentos — resultados de ejecución, registros, puntos de control, y paquetes de evidencia, según están dispuestas en el README del propio espacio de trabajo — junto a otras ubicaciones de scratch ignoradas como outputs/ o artifacts/. La evidencia de investigación final se produce mediante comandos validados de campaña y análisis antes de cualquier uso público.

📋 Reglas de retención de artefactos

Clase de artefacto	Ubicación por defecto	Estado en Git	Retención
Compilaciones de paquete	`dist/`	Ignorado	Recompilar bajo demanda.
Compilación de docs	`site/out/`	Ignorado	Recompilar bajo demanda.
Cobertura	`htmlcov/`, `.coverage*`	Ignorado	Recompilar durante las comprobaciones de calidad.
Salidas de prueba	`outputs/`	Ignorado	Mantener localmente solo al depurar.
Resultados de campaña	las capas de resultados y puntos de control del espacio de trabajo de experimentos	Ignorado	Promover solo mediante exportaciones con gate de procedencia.
Evidencia de lanzamiento	`artifacts/`	Ignorado hasta aprobación	Retener según la política de candidato de lanzamiento.