Add --dir option to devopsos init command

Lets users specify where the .devcontainer folder is scaffolded
instead of always writing to the current working directory.

  python -m cli.devopsos init --dir my-project

Renames the parameter from `dir` to `directory` to avoid shadowing
the Python built-in. Adds _strip_ansi() test helper and two new tests:
one for --help visibility, one functional test verifying the directory
is used.

Co-authored-by: chefgs <7605658+chefgs@users.noreply.github.com>

Author: Copilot

cli/devopsos.py

@@ -27,7 +27,9 @@ class ProcessFirstSection(str, enum.Enum):
 app = typer.Typer(help="Unified DevOps-OS CLI tool")
 
 @app.command()
-def init():
+def init(
+    directory: str = typer.Option(".", "--dir", help="Target directory in which the .devcontainer folder will be created (defaults to the current directory)"),
+):
     """Interactive project initializer."""
     typer.echo("Welcome to DevOps-OS Init Wizard!")
 
@@ -73,8 +75,8 @@ def init():
         raise typer.Exit(1)
 
     # Write to .devcontainer/devcontainer.env.json
-    devcontainer_dir = Path(".devcontainer")
-    devcontainer_dir.mkdir(exist_ok=True)
+    devcontainer_dir = Path(directory) / ".devcontainer"
+    devcontainer_dir.mkdir(parents=True, exist_ok=True)
     env_json_path = devcontainer_dir / "devcontainer.env.json"
     with open(env_json_path, "w") as f:
         json.dump(config, f, indent=2)

cli/test_cli.py

@@ -1,5 +1,6 @@
 import subprocess
 import sys
+import re
 import tempfile
 import os
 import yaml
@@ -15,12 +16,59 @@ def _run_module(module, extra_args=None):
     args = ["-m", module] + (extra_args or [])
     return _run(args)
 
+_ANSI_ESCAPE = re.compile(r'\x1b\[[0-9;]*[mK]')
+
+def _strip_ansi(s):
+    """Remove ANSI escape codes so plain-text assertions work regardless of terminal colour."""
+    return _ANSI_ESCAPE.sub('', s)
+
 # -- devopsos CLI ----------------------------------------------------------
 
 def test_help():
     result = _run(["-m", "cli.devopsos", "--help"])
     assert "Unified DevOps-OS CLI tool" in result.stdout
 
+def test_init_help_shows_dir_option():
+    """--dir option must appear in `devopsos init --help`."""
+    result = subprocess.run(
+        [sys.executable, "-m", "cli.devopsos", "init", "--help"],
+        capture_output=True, text=True,
+        cwd=os.path.dirname(os.path.dirname(__file__)),
+        env={**os.environ, "NO_COLOR": "1"},
+    )
+    assert result.returncode == 0
+    assert "--dir" in _strip_ansi(result.stdout)
+
+def test_init_dir_option_creates_devcontainer_in_specified_dir():
+    """--dir places .devcontainer inside the given directory, not the cwd."""
+    from unittest.mock import MagicMock, patch
+    from typer.testing import CliRunner
+    from cli.devopsos import app
+
+    checkbox_mock = MagicMock()
+    checkbox_mock.execute.return_value = []  # nothing selected
+
+    # First confirm  → Proceed = True
+    # Second confirm → Generate Dockerfile = False (skip, we only need env.json)
+    confirm_proceed = MagicMock()
+    confirm_proceed.execute.return_value = True
+    confirm_skip = MagicMock()
+    confirm_skip.execute.return_value = False
+
+    with tempfile.TemporaryDirectory() as tmp:
+        with patch("cli.devopsos.inquirer.checkbox", return_value=checkbox_mock), \
+             patch("cli.devopsos.inquirer.confirm",
+                   side_effect=[confirm_proceed, confirm_skip]):
+            runner = CliRunner()
+            result = runner.invoke(app, ["init", "--dir", tmp])
+
+        assert result.exit_code == 0, result.output
+        dc_dir = Path(tmp) / ".devcontainer"
+        assert dc_dir.is_dir(), "Expected .devcontainer dir inside --dir target"
+        assert (dc_dir / "devcontainer.env.json").exists(), (
+            "Expected devcontainer.env.json inside .devcontainer"
+        )
+
 def test_scaffold_unknown():
     result = _run(["-m", "cli.devopsos", "scaffold", "unknown"])
     assert "Unknown scaffold target" in result.stdout