src/config(fix[loader]): retain ordered duplicate workspace items

why: Provide structured metadata so writers can replay duplicate workspace roots without loss.
what:
- extend DuplicateAwareConfigReader to capture ordered top-level items
- propagate new load_with_duplicates return signature through CLI/config callers

Author: tony

src/vcspull/_internal/config_reader.py

@@ -228,6 +228,7 @@ def __init__(self, stream: str) -> None:
         super().__init__(stream)
         self.top_level_key_values: dict[t.Any, list[t.Any]] = {}
         self._mapping_depth = 0
+        self.top_level_items: list[tuple[t.Any, t.Any]] = []
 
 
 def _duplicate_tracking_construct_mapping(
@@ -248,7 +249,9 @@ def _duplicate_tracking_construct_mapping(
         value = construct(value_node)
 
         if loader._mapping_depth == 1:
-            loader.top_level_key_values.setdefault(key, []).append(copy.deepcopy(value))
+            duplicated_value = copy.deepcopy(value)
+            loader.top_level_key_values.setdefault(key, []).append(duplicated_value)
+            loader.top_level_items.append((copy.deepcopy(key), duplicated_value))
 
         mapping[key] = value
 
@@ -270,20 +273,27 @@ def __init__(
         content: RawConfigData,
         *,
         duplicate_sections: dict[str, list[t.Any]] | None = None,
+        top_level_items: list[tuple[str, t.Any]] | None = None,
     ) -> None:
         super().__init__(content)
         self._duplicate_sections = duplicate_sections or {}
+        self._top_level_items = top_level_items or []
 
     @property
     def duplicate_sections(self) -> dict[str, list[t.Any]]:
         """Mapping of top-level keys to the list of duplicated values."""
         return self._duplicate_sections
 
+    @property
+    def top_level_items(self) -> list[tuple[str, t.Any]]:
+        """Ordered list of top-level items, including duplicates."""
+        return copy.deepcopy(self._top_level_items)
+
     @classmethod
     def _load_yaml_with_duplicates(
         cls,
         content: str,
-    ) -> tuple[dict[str, t.Any], dict[str, list[t.Any]]]:
+    ) -> tuple[dict[str, t.Any], dict[str, list[t.Any]], list[tuple[str, t.Any]]]:
         loader = _DuplicateTrackingSafeLoader(content)
 
         try:
@@ -306,33 +316,42 @@ def _load_yaml_with_duplicates(
             if len(values) > 1
         }
 
-        return loaded, duplicate_sections
+        top_level_items = [
+            (t.cast("str", key), copy.deepcopy(value))
+            for key, value in loader.top_level_items
+        ]
+
+        return loaded, duplicate_sections, top_level_items
 
     @classmethod
     def _load_from_path(
         cls,
         path: pathlib.Path,
-    ) -> tuple[dict[str, t.Any], dict[str, list[t.Any]]]:
+    ) -> tuple[dict[str, t.Any], dict[str, list[t.Any]], list[tuple[str, t.Any]]]:
         if path.suffix.lower() in {".yaml", ".yml"}:
             content = path.read_text(encoding="utf-8")
             return cls._load_yaml_with_duplicates(content)
 
-        return ConfigReader._from_file(path), {}
+        return ConfigReader._from_file(path), {}, []
 
     @classmethod
     def from_file(cls, path: pathlib.Path) -> DuplicateAwareConfigReader:
-        content, duplicate_sections = cls._load_from_path(path)
-        return cls(content, duplicate_sections=duplicate_sections)
+        content, duplicate_sections, top_level_items = cls._load_from_path(path)
+        return cls(
+            content,
+            duplicate_sections=duplicate_sections,
+            top_level_items=top_level_items,
+        )
 
     @classmethod
     def _from_file(cls, path: pathlib.Path) -> dict[str, t.Any]:
-        content, _ = cls._load_from_path(path)
+        content, _, _ = cls._load_from_path(path)
         return content
 
     @classmethod
     def load_with_duplicates(
         cls,
         path: pathlib.Path,
-    ) -> tuple[dict[str, t.Any], dict[str, list[t.Any]]]:
+    ) -> tuple[dict[str, t.Any], dict[str, list[t.Any]], list[tuple[str, t.Any]]]:
         reader = cls.from_file(path)
-        return reader.content, reader.duplicate_sections
+        return reader.content, reader.duplicate_sections, reader.top_level_items

src/vcspull/cli/add.py

@@ -342,6 +342,7 @@ def add_repo(
             (
                 raw_config,
                 duplicate_root_occurrences,
+                _top_level_items,
             ) = DuplicateAwareConfigReader.load_with_duplicates(config_file_path)
         except TypeError:
             log.exception(

src/vcspull/cli/discover.py

@@ -203,6 +203,7 @@ def discover_repos(
             (
                 raw_config,
                 duplicate_root_occurrences,
+                _top_level_items,
             ) = DuplicateAwareConfigReader.load_with_duplicates(config_file_path)
         except TypeError:
             log.exception(

src/vcspull/cli/fmt.py

@@ -172,7 +172,7 @@ def format_single_config(
 
     # Load existing config
     try:
-        raw_config, duplicate_root_occurrences = (
+        raw_config, duplicate_root_occurrences, _top_level_items = (
             DuplicateAwareConfigReader.load_with_duplicates(config_file_path)
         )
     except TypeError:

src/vcspull/config.py

@@ -271,7 +271,7 @@ def load_configs(
             file = pathlib.Path(file)
         assert isinstance(file, pathlib.Path)
 
-        config_content, duplicate_roots = (
+        config_content, duplicate_roots, _top_level_items = (
             DuplicateAwareConfigReader.load_with_duplicates(file)
         )