feat(gix): discover untracked files natively

Use GixPython's directory walk for `Repo.untracked_files`, preserving raw names, nested-repository directory markers and sorting. Keep extra status options, unsupported index storage and non-root command working directories on the existing CLI path.

The staged version passes Ruff and Python syntax checks. Its SHA-1/SHA-256 native smoke and focused pytest selection pass: 28 passed in 7.17s.

Author: codex

git/_backend.py

@@ -244,6 +244,53 @@ def describe(local: Any) -> List[bytes]:
     return b"".join(records)
 
 
+def _worktree_root(command: Any, repo: Any) -> str:
+    root = repo.workdir()
+    if (
+        root is None
+        or repo.prefix() is not None
+        or os.path.realpath(command.working_dir or os.getcwd()) != os.path.realpath(root)
+    ):
+        raise _Unsupported("worktree or command working directory")
+    return os.fspath(root)
+
+
+def untracked_files(command: Any, args: Tuple[Any, ...], options: Dict[str, Any]) -> Any:
+    if gix is None:
+        return NotImplemented
+    method = "Repo.untracked_files"
+    command._require_version()
+    try:
+        if options.keys() - {"ignore_submodules"}:
+            raise _Unsupported("status options")
+        repo = _repository(command, {})
+        _worktree_root(command, repo)
+        if not hasattr(repo, "dirwalk_iter"):
+            raise _Unsupported("dirwalk feature disabled")
+        index = _index(repo, {"env": command.environment()})
+        patterns = command._unpack_args([arg for arg in args if arg is not None])
+        if any("\0" in path for path in patterns):
+            raise _Unsupported("invalid pathspec")
+        walk_options = repo.dirwalk_options().emit_untracked("matching").emit_tracked(False)
+        result = []
+        with repo.dirwalk_iter(index, patterns, walk_options) as entries:
+            for item in entries:
+                entry = item.entry
+                if entry.status == "Untracked":
+                    path = entry.rela_path
+                    if entry.disk_kind in ("Directory", "Repository"):
+                        path += b"/"
+                    result.append(path)
+        result.sort()
+    except _Unsupported as exc:
+        return _fallback(method, str(exc))
+    except gix.Error as exc:
+        _logger.debug("untracked_files native read: %s", exc)
+        return _fallback(method, "native read diagnostics")
+    record(method, "native")
+    return [safe_decode(path) for path in result]
+
+
 def _merge_base(repo: Any, args: List[str], kwargs: Dict[str, Any]) -> bytes:
     if not hasattr(repo, "merge_base"):
         raise _Unsupported("revision feature disabled")

git/repo/base.py

@@ -22,6 +22,7 @@
 from gitdb.db.loose import LooseObjectDB
 from gitdb.exc import BadObject
 
+from git import _backend
 from git.cmd import Git, handle_process_output
 from git.compat import defenc, safe_decode
 from git.config import GitConfigParser
@@ -1136,6 +1137,9 @@ def untracked_files(self) -> List[str]:
         return self._get_untracked_files()
 
     def _get_untracked_files(self, *args: Any, **kwargs: Any) -> List[str]:
+        native = _backend.untracked_files(self.git, args, kwargs)
+        if native is not NotImplemented:
+            return native
         # NUL records preserve arbitrary filenames, including newlines and quotes.
         output = self.git._call_process_safe(
             "status", "--porcelain=v1", "-z", "--untracked-files=all", "--", *args, stdout_as_string=False, **kwargs