fix: preserve *.starter.json files during clean build of explorer database

Agent-Logs-Url: https://github.com/open-telemetry/opentelemetry-ecosystem-explorer/sessions/f308c7e8-4bb4-4611-b711-7274dc017716

Co-authored-by: jaydeluca <7630696+jaydeluca@users.noreply.github.com>

Author: Copilot

ecosystem-automation/explorer-db-builder/src/explorer_db_builder/configuration_builder.py

@@ -53,9 +53,26 @@ def run_configuration_builder(
         output_path = Path(output_dir)
 
         if clean and output_path.exists():
+            # Preserve hand-crafted starter files before wiping generated output
+            starter_files: dict[Path, str] = {}
+            for f in output_path.rglob("*.starter.json"):
+                try:
+                    starter_files[f.relative_to(output_path)] = f.read_text(encoding="utf-8")
+                except OSError as e:
+                    logger.warning(f"Could not back up starter file {f}: {e}")
+
             shutil.rmtree(output_path)
             logger.info(f"Cleaned {output_path}")
 
+            for relative_path, content in starter_files.items():
+                try:
+                    restored = output_path / relative_path
+                    restored.parent.mkdir(parents=True, exist_ok=True)
+                    restored.write_text(content, encoding="utf-8")
+                    logger.info(f"Restored starter file: {relative_path}")
+                except OSError as e:
+                    logger.warning(f"Could not restore starter file {relative_path}: {e}")
+
         inventory = BaseInventoryManager(registry_dir)
         versions = inventory.list_release_versions()
 

ecosystem-automation/explorer-db-builder/tests/test_configuration_builder.py

@@ -144,6 +144,24 @@ def test_multiple_versions_latest_flag(self, config_registry, output_dir):
             else:
                 assert entry["is_latest"] is False
 
+    def test_clean_preserves_starter_files(self, config_registry, output_dir):
+        run_configuration_builder(
+            registry_dir=str(config_registry),
+            output_dir=str(output_dir),
+        )
+        starter_file = output_dir / "versions" / "1.0.0.starter.json"
+        starter_content = '{"enabledSections": {}, "values": {}}'
+        starter_file.write_text(starter_content)
+
+        run_configuration_builder(
+            registry_dir=str(config_registry),
+            output_dir=str(output_dir),
+            clean=True,
+        )
+
+        assert starter_file.exists()
+        assert starter_file.read_text() == starter_content
+
     def test_clean_removes_output_dir(self, config_registry, output_dir):
         run_configuration_builder(
             registry_dir=str(config_registry),