auto-coder 3.0.42__tar.gz → 3.0.44__tar.gz

{auto_coder-3.0.42/src/auto_coder.egg-info → auto_coder-3.0.44}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: auto-coder
-Version: 3.0.42
+Version: 3.0.44
 Summary: AutoCoder: AutoCoder
 Author: allwefantasy
 Author-email: allwefantasy <allwefantasy@gmail.com>

{auto_coder-3.0.42 → auto_coder-3.0.44}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "auto-coder"
-version = "3.0.42"
+version = "3.0.44"
 description = "AutoCoder: AutoCoder"
 authors = [
     {name = "allwefantasy", email = "allwefantasy@gmail.com"}

{auto_coder-3.0.42 → auto_coder-3.0.44/src/auto_coder.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: auto-coder
-Version: 3.0.42
+Version: 3.0.44
 Summary: AutoCoder: AutoCoder
 Author: allwefantasy
 Author-email: allwefantasy <allwefantasy@gmail.com>

{auto_coder-3.0.42 → auto_coder-3.0.44}/src/auto_coder.egg-info/SOURCES.txt

@@ -807,6 +807,7 @@ src/autocoder/terminal/utils/shell.py
 src/autocoder/terminal_core/__init__.py
 src/autocoder/terminal_core/cloud_bridge.py
 src/autocoder/terminal_core/cloud_command_dispatcher.py
+src/autocoder/terminal_core/cloud_config.py
 src/autocoder/terminal_core/command_registry.py
 src/autocoder/terminal_core/execution_broker.py
 src/autocoder/terminal_core/forward_input.py
@@ -814,12 +815,14 @@ src/autocoder/terminal_core/lifecycle.py
 src/autocoder/terminal_core/output.py
 src/autocoder/terminal_core/status.py
 src/autocoder/terminal_core/task_runtime.py
+src/autocoder/terminal_core/tunnel_worker.py
 src/autocoder/terminal_v3/__init__.py
 src/autocoder/terminal_v3/app.py
 src/autocoder/terminal_v3/handlers/__init__.py
 src/autocoder/terminal_v3/handlers/command_handler.py
 src/autocoder/terminal_v3/models/__init__.py
 src/autocoder/terminal_v3/models/conversation_buffer.py
+src/autocoder/terminal_v3/models/markdown_render.py
 src/autocoder/terminal_v3/models/message.py
 src/autocoder/terminal_v3/models/tool_display.py
 src/autocoder/terminal_v3/ui/__init__.py
@@ -866,4 +869,5 @@ src/autocoder/workflow_agents/tests/test_utils.py
 tests/test_args_parser.py
 tests/test_command_consistency.py
 tests/test_conf_completions.py
-tests/test_conf_global_shorthand.py
+tests/test_conf_global_shorthand.py
+tests/test_plugin_manager.py

{auto_coder-3.0.42 → auto_coder-3.0.44}/src/autocoder/auto_coder_terminal_v3.py

@@ -50,6 +50,7 @@ V3_COMMANDS = [
     "/new",
     "/rules",
     "/status",
+    "/tunnel",
     "/workflow",
 ]
 from autocoder.common.core_config import (
@@ -92,64 +93,51 @@ def parse_arguments():
     parser.add_argument("--lite", action="store_true", help="Lite mode")
     parser.add_argument("--pro", action="store_true", help="Pro mode")
 
+    from autocoder.terminal_core.cloud_config import (
+        DEFAULT_BASE_URL,
+        ENV_API_KEY,
+        ENV_BASE_URL,
+        ENV_INSTANCE_NAME,
+        load_cloud_config,
+        save_cloud_config,
+    )
+
     cloud = parser.add_argument_group("cloud", "Cloud integration options")
     cloud.add_argument(
         "--cloud-api-key",
         type=str,
         default=None,
-        help="API key for cloud registration (env: AUTO_CODER_CLOUD_API_KEY)",
+        help=f"API key for cloud registration (env: {ENV_API_KEY})",
     )
     cloud.add_argument(
         "--cloud-base-url",
         type=str,
-        default="https://auto-coder.chat",
-        help="Base URL of the auto-coder.chat server (env: AUTO_CODER_CLOUD_BASE_URL)",
+        default=DEFAULT_BASE_URL,
+        help=f"Base URL of the auto-coder.chat server (env: {ENV_BASE_URL})",
     )
     cloud.add_argument(
         "--instance-name",
         type=str,
         default=None,
-        help="Display name for this instance (env: AUTO_CODER_INSTANCE_NAME, default: current directory name)",
+        help=(
+            f"Display name for this instance (env: {ENV_INSTANCE_NAME}, "
+            "default: current directory name)"
+        ),
     )
 
     args = parser.parse_args()
 
-    import json
-    import os
-
-    cloud_config_path = Path.home() / ".auto-coder" / "cloud" / "config.json"
-    saved_cloud: dict = {}
-    if cloud_config_path.exists():
-        try:
-            saved_cloud = json.loads(cloud_config_path.read_text(encoding="utf-8"))
-        except Exception:
-            pass
-
-    if not args.cloud_api_key:
-        args.cloud_api_key = os.environ.get("AUTO_CODER_CLOUD_API_KEY") or saved_cloud.get("api_key")
-    if args.cloud_base_url == "https://auto-coder.chat":
-        args.cloud_base_url = (
-            os.environ.get("AUTO_CODER_CLOUD_BASE_URL")
-            or saved_cloud.get("base_url")
-            or "https://auto-coder.chat"
-        )
-    if not args.instance_name:
-        args.instance_name = (
-            os.environ.get("AUTO_CODER_INSTANCE_NAME")
-            or Path.cwd().name
-        )
+    cloud_cfg = load_cloud_config(
+        cli_api_key=args.cloud_api_key,
+        cli_base_url=args.cloud_base_url,
+        cli_instance_name=args.instance_name,
+    )
+    args.cloud_api_key = cloud_cfg.api_key or None
+    args.cloud_base_url = cloud_cfg.base_url
+    args.instance_name = cloud_cfg.instance_name
+    args.cloud_connection = cloud_cfg
 
-    if args.cloud_api_key:
-        new_cloud = {
-            "api_key": args.cloud_api_key,
-            "base_url": args.cloud_base_url,
-        }
-        if new_cloud != saved_cloud:
-            cloud_config_path.parent.mkdir(parents=True, exist_ok=True)
-            cloud_config_path.write_text(
-                json.dumps(new_cloud, indent=2, ensure_ascii=False),
-                encoding="utf-8",
-            )
+    save_cloud_config(cloud_cfg)
 
     return args
 
@@ -227,12 +215,16 @@ async def async_main():
         buf = io.StringIO()
         with redirect_stdout(buf), redirect_stderr(buf):
             plugin_manager.load_global_plugin_dirs()
-            plugins_dir = Path(__file__).parent.parent / "plugins"
-            plugin_manager.add_plugin_directory(str(plugins_dir))
+            plugins_dir = Path(__file__).resolve().parent / "plugins"
+            _, add_plugins_dir_message = plugin_manager.add_plugin_directory(
+                str(plugins_dir)
+            )
             plugin_manager.load_runtime_cfg()
             load_builtin_plugins(plugin_manager)
 
         raw_logs = buf.getvalue().strip()
+        if add_plugins_dir_message.startswith("Invalid directory:"):
+            startup_logs.append(add_plugins_dir_message)
         if raw_logs:
             for line in raw_logs.splitlines():
                 cleaned = line.strip()
@@ -272,16 +264,13 @@ async def async_main():
         )
 
     cloud_bridge = None
-    if args.cloud_api_key and args.cloud_base_url:
+    if args.cloud_connection.is_complete:
         from autocoder.terminal_core.cloud_bridge import CloudBridge, CloudConfig
         from autocoder.terminal_core.execution_broker import ExecutionBroker
 
         broker = ExecutionBroker(configure_func=configure)
-        cloud_config = CloudConfig(
-            api_key=args.cloud_api_key,
-            base_url=args.cloud_base_url,
-            instance_name=args.instance_name,
-            project_path=str(Path.cwd()),
+        cloud_config = CloudConfig.from_connection(
+            args.cloud_connection, project_path=str(Path.cwd())
         )
         cloud_bridge = CloudBridge(config=cloud_config, broker=broker)
         ok = await cloud_bridge.start()

{auto_coder-3.0.42 → auto_coder-3.0.44}/src/autocoder/common/__init__.py

@@ -293,6 +293,8 @@ class AutoCoderArgs(pydantic.BaseModel):
 
     enable_forward_input_to_running_conversation: bool = False
 
+    enable_rich_render: bool = True
+
     paste_image_mode: str = "direct"
 
     agentic_max_rounds: int = 10000

{auto_coder-3.0.42 → auto_coder-3.0.44}/src/autocoder/common/conf_validator.py

@@ -144,6 +144,11 @@ class ConfigValidator:
             "allowed": ["direct", "tool"],
             "default": "direct",
             "description": "粘贴图片模式(direct: <_image_>标签直接识别 / tool: @路径工具读取)"
+        },
+        "enable_rich_render": {
+            "type": bool,
+            "default": True,
+            "description": "V3 终端是否用 rich 美化输出(Markdown 结果 / shell 命令头等),关闭则回退纯文本"
         }
     }
 

{auto_coder-3.0.42 → auto_coder-3.0.44}/src/autocoder/common/file_handler/commit_handler.py

@@ -5,6 +5,7 @@ from typing import Optional
 from autocoder.common.international import get_message
 from autocoder.common.ac_style_command_parser import create_config, parse_typed_query
 from autocoder.common.printer import Printer
+from autocoder.common.core_config import get_memory_manager
 from autocoder.auto_coder_runner import (
     get_current_memory,
     get_current_files,
@@ -65,7 +66,27 @@ class CommitHandler:
         """处理提交逻辑"""
         memory = get_current_memory()
         conf = memory.get("conf", {})
-        product_mode = conf.get("product_mode", "lite")
+
+        memory_manager = get_memory_manager()
+        merged_conf = memory_manager.get_all_config(source="merged")
+        product_mode = merged_conf.get("product_mode", "lite")
+
+        target_model = (
+            merged_conf.get("commit_model") or merged_conf.get("model")
+        )
+        if not target_model or not str(target_model).strip():
+            self.printer.print_in_terminal(
+                "commit_failed",
+                style="red",
+                model_name="(not configured)",
+                error=(
+                    "未配置 commit 所用的模型。请先设置 `commit_model` 或 `model`，"
+                    "例如：`/conf /global commit_model:<已注册的模型名>`，"
+                    "或 `/conf commit_model:<已注册的模型名>`。"
+                ),
+            )
+            return None
+        target_model = str(target_model).strip()
 
         def prepare_commit_yaml():
             auto_coder_main(["next", "chat_action"])
@@ -99,7 +120,6 @@ class CommitHandler:
                     if os.path.exists(temp_yaml):
                         os.remove(temp_yaml)
 
-                target_model = args.commit_model or args.model
                 llm = get_single_llm(target_model, product_mode)
                 self.printer.print_in_terminal(
                     "commit_generating", style="yellow", model_name=target_model

{auto_coder-3.0.42 → auto_coder-3.0.44}/src/autocoder/common/shell_commands/command_executor.py

@@ -82,6 +82,7 @@ class CommandExecutor:
         text: bool = True,
         encoding: str = 'utf-8',
         shell: Optional[bool] = None,
+        prefer_shell: Optional[str] = None,
         **kwargs
     ) -> Tuple[int, str]:
         """
@@ -96,6 +97,10 @@ class CommandExecutor:
             text: Whether to use text mode
             encoding: Text encoding
             shell: Whether to use shell
+            prefer_shell: Optional explicit Windows shell hint
+                (``"powershell"`` / ``"pwsh"`` / ``"cmd"`` / ``"auto"``).
+                Ignored on non-Windows. When provided, overrides the
+                parent-process based shell auto-detection.
             **kwargs: Additional arguments for subprocess.Popen
             
         Returns:
@@ -122,7 +127,8 @@ class CommandExecutor:
         try:
             # Execute command with subprocess
             exit_code, output = self._execute_with_subprocess(
-                command, timeout, cwd, env, capture_output, text, encoding, shell, **kwargs
+                command, timeout, cwd, env, capture_output, text, encoding, shell,
+                prefer_shell=prefer_shell, **kwargs
             )
             
             # Log completion
@@ -152,6 +158,7 @@ class CommandExecutor:
         text: bool,
         encoding: str,
         shell: bool,
+        prefer_shell: Optional[str] = None,
         **kwargs
     ) -> Tuple[int, str]:
         """
@@ -181,6 +188,7 @@ class CommandExecutor:
             capture_output=capture_output,
             text=text,
             encoding=encoding,
+            prefer_shell=prefer_shell,
             **kwargs
         )
         
@@ -257,6 +265,7 @@ class CommandExecutor:
         cwd: Optional[str] = None,
         env: Optional[Dict[str, str]] = None,
         encoding: str = 'utf-8',
+        prefer_shell: Optional[str] = None,
         **kwargs
     ) -> Generator[str, None, int]:
         """
@@ -268,6 +277,9 @@ class CommandExecutor:
             cwd: Working directory
             env: Environment variables
             encoding: Text encoding
+            prefer_shell: Optional explicit Windows shell hint
+                (``"powershell"`` / ``"pwsh"`` / ``"cmd"`` / ``"auto"``).
+                Ignored on non-Windows.
             **kwargs: Additional subprocess arguments
             
         Yields:
@@ -301,6 +313,7 @@ class CommandExecutor:
                 capture_output=True,
                 text=True,
                 encoding=encoding,
+                prefer_shell=prefer_shell,
                 **kwargs
             )
             
@@ -514,6 +527,7 @@ class CommandExecutor:
         text: bool = True,
         encoding: str = 'utf-8',
         shell: Optional[bool] = None,
+        prefer_shell: Optional[str] = None,
         **kwargs
     ) -> List[Dict[str, Any]]:
         """
@@ -575,12 +589,14 @@ class CommandExecutor:
             if parallel:
                 results = self._execute_batch_parallel(
                     commands, timeout, per_command_timeout, cwd, env,
-                    capture_output, text, encoding, shell, **kwargs
+                    capture_output, text, encoding, shell,
+                    prefer_shell=prefer_shell, **kwargs
                 )
             else:
                 results = self._execute_batch_serial(
                     commands, timeout, per_command_timeout, cwd, env,
-                    capture_output, text, encoding, shell, **kwargs
+                    capture_output, text, encoding, shell,
+                    prefer_shell=prefer_shell, **kwargs
                 )
             
             # Log batch completion
@@ -646,6 +662,7 @@ class CommandExecutor:
         text: bool,
         encoding: str,
         shell: bool,
+        prefer_shell: Optional[str] = None,
         **kwargs
     ) -> List[Dict[str, Any]]:
         """Execute commands serially."""
@@ -686,7 +703,7 @@ class CommandExecutor:
                 exit_code, output = self.execute(
                     command, timeout=cmd_timeout, cwd=cwd, env=env,
                     capture_output=capture_output, text=text, encoding=encoding,
-                    shell=shell, **kwargs
+                    shell=shell, prefer_shell=prefer_shell, **kwargs
                 )
                 end_time = time.time()
                 
@@ -741,6 +758,7 @@ class CommandExecutor:
         text: bool,
         encoding: str,
         shell: bool,
+        prefer_shell: Optional[str] = None,
         **kwargs
     ) -> List[Dict[str, Any]]:
         """Execute commands in parallel."""
@@ -757,7 +775,7 @@ class CommandExecutor:
                 exit_code, output = self.execute(
                     cmd, timeout=per_command_timeout, cwd=cwd, env=env,
                     capture_output=capture_output, text=text, encoding=encoding,
-                    shell=shell, **kwargs
+                    shell=shell, prefer_shell=prefer_shell, **kwargs
                 )
                 end_time = time.time()
                 
@@ -874,6 +892,7 @@ def execute_command(
     timeout: Optional[float] = None,
     cwd: Optional[str] = None,
     verbose: bool = False,
+    prefer_shell: Optional[str] = None,
     **kwargs
 ) -> Tuple[int, str]:
     """
@@ -884,6 +903,8 @@ def execute_command(
         timeout: Timeout in seconds
         cwd: Working directory
         verbose: Whether to enable verbose logging
+        prefer_shell: Optional explicit Windows shell hint (``"powershell"`` /
+            ``"pwsh"`` / ``"cmd"`` / ``"auto"``). Ignored on non-Windows.
         **kwargs: Additional arguments
         
     Returns:
@@ -896,7 +917,9 @@ def execute_command(
     
     executor = CommandExecutor(config=config, verbose=verbose)
     try:
-        return executor.execute(command, timeout, cwd, **kwargs)
+        return executor.execute(
+            command, timeout, cwd, prefer_shell=prefer_shell, **kwargs
+        )
     finally:
         executor.cleanup()
 
@@ -906,6 +929,7 @@ def execute_command_generator(
     timeout: Optional[float] = None,
     cwd: Optional[str] = None,
     verbose: bool = False,
+    prefer_shell: Optional[str] = None,
     **kwargs
 ) -> Generator[str, None, int]:
     """
@@ -916,6 +940,8 @@ def execute_command_generator(
         timeout: Timeout in seconds
         cwd: Working directory
         verbose: Whether to enable verbose logging
+        prefer_shell: Optional explicit Windows shell hint (``"powershell"`` /
+            ``"pwsh"`` / ``"cmd"`` / ``"auto"``). Ignored on non-Windows.
         **kwargs: Additional arguments
         
     Yields:
@@ -925,13 +951,16 @@ def execute_command_generator(
         Final exit code
     """
     executor = CommandExecutor(verbose=verbose)
-    return executor.execute_generator(command, timeout, cwd, **kwargs)
+    return executor.execute_generator(
+        command, timeout, cwd, prefer_shell=prefer_shell, **kwargs
+    )
 
 
 def execute_command_background(
     command: Union[str, List[str]],
     cwd: Optional[str] = None,
     verbose: bool = False,
+    prefer_shell: Optional[str] = None,
     **kwargs
 ) -> Dict[str, Any]:
     """
@@ -941,6 +970,8 @@ def execute_command_background(
         command: Command to execute
         cwd: Working directory
         verbose: Whether to enable verbose logging
+        prefer_shell: Optional explicit Windows shell hint (``"powershell"`` /
+            ``"pwsh"`` / ``"cmd"`` / ``"auto"``). Ignored on non-Windows.
         **kwargs: Additional arguments
         
     Returns:
@@ -963,6 +994,7 @@ def execute_command_background(
             command=command,
             cwd=cwd,
             process_uniq_id=process_uniq_id,
+            prefer_shell=prefer_shell,
             **kwargs
         )
         
@@ -1051,6 +1083,7 @@ def execute_commands(
     cwd: Optional[str] = None,
     env: Optional[Dict[str, str]] = None,
     verbose: bool = False,
+    prefer_shell: Optional[str] = None,
     **kwargs
 ) -> List[Dict[str, Any]]:
     """
@@ -1067,6 +1100,8 @@ def execute_commands(
         cwd: Working directory
         env: Environment variables
         verbose: Whether to enable verbose logging
+        prefer_shell: Optional explicit Windows shell hint (``"powershell"`` /
+            ``"pwsh"`` / ``"cmd"`` / ``"auto"``). Ignored on non-Windows.
         **kwargs: Additional arguments for subprocess.Popen
         
     Returns:
@@ -1119,6 +1154,7 @@ def execute_commands(
             parallel=parallel,
             cwd=cwd,
             env=env,
+            prefer_shell=prefer_shell,
             **kwargs
         )
         return results

{auto_coder-3.0.42 → auto_coder-3.0.44}/src/autocoder/common/shell_commands/process_manager.py

@@ -75,6 +75,7 @@ class ProcessManager:
         capture_output: bool = True,
         text: bool = True,
         encoding: str = "utf-8",
+        prefer_shell: Optional[str] = None,
         **kwargs,
     ) -> subprocess.Popen:
         """
@@ -89,6 +90,10 @@ class ProcessManager:
             capture_output: Whether to capture stdout/stderr
             text: Whether to use text mode
             encoding: Text encoding
+            prefer_shell: Optional explicit Windows shell hint passed through to
+                ``prepare_windows_command``. Accepts ``"powershell"`` /
+                ``"pwsh"`` / ``"cmd"`` / ``"auto"`` (or ``None`` for auto).
+                Ignored on non-Windows platforms.
             **kwargs: Additional arguments for subprocess.Popen
 
         Returns:
@@ -103,7 +108,9 @@ class ProcessManager:
 
             # On Windows, wrap the command to use the correct shell and encoding
             if platform.system() == "Windows":
-                command, shell, encoding = prepare_windows_command(command, encoding)
+                command, shell, encoding = prepare_windows_command(
+                    command, encoding, prefer_shell=prefer_shell
+                )
 
             # Prepare process arguments
             popen_args = {
@@ -347,6 +354,7 @@ class ProcessManager:
         env: Optional[Dict[str, str]] = None,
         shell: bool = True,
         process_uniq_id: Optional[str] = None,
+        prefer_shell: Optional[str] = None,
         **kwargs,
     ) -> subprocess.Popen:
         """
@@ -357,6 +365,10 @@ class ProcessManager:
             cwd: Working directory
             env: Environment variables
             shell: Whether to use shell
+            prefer_shell: Optional explicit Windows shell hint passed through to
+                ``prepare_windows_command``. Accepts ``"powershell"`` /
+                ``"pwsh"`` / ``"cmd"`` / ``"auto"`` (or ``None`` for auto).
+                Ignored on non-Windows platforms.
             **kwargs: Additional arguments for subprocess.Popen
 
         Returns:
@@ -367,7 +379,7 @@ class ProcessManager:
             bg_encoding = "utf-8"
             if platform.system() == "Windows":
                 command, shell, bg_encoding = prepare_windows_command(
-                    command, bg_encoding
+                    command, bg_encoding, prefer_shell=prefer_shell
                 )
 
             # Prepare process arguments for background execution

{auto_coder-3.0.42 → auto_coder-3.0.44}/src/autocoder/common/shell_commands/tests/test_windows_support.py

@@ -174,11 +174,24 @@ class TestWrapPowershell:
 
 class TestWrapCmd:
     def test_basic_wrap(self):
-        argv = _wrap_cmd("dir")
-        assert argv[0] == "cmd.exe"
-        assert argv[1] == "/c"
-        assert "chcp 65001" in argv[2]
-        assert "dir" in argv[2]
+        # _wrap_cmd now returns a single command-line *string* (see its
+        # docstring for why); callers feed it directly to subprocess.Popen
+        # with shell=False so that internal double-quotes survive.
+        cmdline = _wrap_cmd("dir")
+        assert isinstance(cmdline, str)
+        assert cmdline.startswith("cmd.exe /s /c \"")
+        assert cmdline.endswith("\"")
+        assert "chcp 65001" in cmdline
+        assert "dir" in cmdline
+
+    def test_quotes_preserved(self):
+        """Inner double-quotes in the user command must be kept verbatim
+        (not turned into ``\\"``) so cmd.exe can parse them.
+        """
+        cmdline = _wrap_cmd('cd /d "F:\\proj" && echo done')
+        assert '"F:\\proj"' in cmdline
+        # No backslash-escaped quotes in cmd-mode payload
+        assert '\\"' not in cmdline
 
 
 # ---------------------------------------------------------------------------
@@ -217,8 +230,46 @@ class TestPrepareWindowsCommand:
             cmd, shell, enc = prepare_windows_command("dir /b")
         assert shell is False
         assert enc == "utf-8"
-        assert cmd[0] == "cmd.exe"
-        assert "chcp 65001" in cmd[2]
+        # cmd branch now returns a single command-line *string* so that
+        # subprocess.list2cmdline does not corrupt embedded double quotes.
+        assert isinstance(cmd, str)
+        assert cmd.startswith("cmd.exe /s /c \"")
+        assert "chcp 65001" in cmd
+        assert "dir /b" in cmd
+
+    def test_explicit_prefer_shell_overrides_detection(self):
+        """``prefer_shell`` must win over the parent-shell auto-detect."""
+        with patch(
+            "autocoder.common.shell_commands.windows_support._detect_parent_shell",
+            return_value="powershell",
+        ):
+            cmd, shell, enc = prepare_windows_command(
+                "dir /b", prefer_shell="cmd"
+            )
+        assert shell is False
+        assert enc == "utf-8"
+        assert isinstance(cmd, str)
+        assert cmd.startswith("cmd.exe /s /c \"")
+
+        with patch(
+            "autocoder.common.shell_commands.windows_support._detect_parent_shell",
+            return_value="cmd",
+        ):
+            cmd, shell, enc = prepare_windows_command(
+                "Get-Process", prefer_shell="powershell"
+            )
+        assert isinstance(cmd, list)
+        assert cmd[0] == "powershell.exe"
+
+    def test_prefer_shell_auto_falls_back(self):
+        """``prefer_shell='auto'`` must be equivalent to no hint at all."""
+        with patch(
+            "autocoder.common.shell_commands.windows_support._detect_parent_shell",
+            return_value="cmd",
+        ):
+            cmd_auto, _, _ = prepare_windows_command("dir", prefer_shell="auto")
+            cmd_none, _, _ = prepare_windows_command("dir", prefer_shell=None)
+        assert cmd_auto == cmd_none
 
     def test_list_command_passthrough(self):
         """List commands should not be re-wrapped."""