feat(cli): amélioration de la commande scaffold avec prompt interactif et gestion intelligente des chemins

Author: raidos23

docs/Cli.md

@@ -177,3 +177,15 @@ Executes the pre-compilation pipeline manually.
 
 ---
 *End of Specification v1.0.0*
+
+#### **`pycompiler_ark scaffold engine <name> [--path <dir>]`**
+#### **`pycompiler_ark scaffold plugin-bcasl <name> [--path <dir>]`**
+
+Generates starter templates for engines or plugins.
+
+- **Path Resolution**: 
+    1. If `--path` is provided, it is used as the base directory.
+    2. If a developer directory is explicitly configured (via `set dev-engine-dir` or `set dev-plugin-dir`), the template is created directly inside that folder.
+    3. Otherwise, the CLI will interactively prompt for a destination path.
+- **Interactive Prompt**: The command will wait for user input unless in a non-interactive environment or bypassed with a path/config.
+- **Structure**: Templates are created with the correct directory structure (`engines/<name>` or `Plugins/<name>`) unless created inside a `dev` directory, where they are placed at the root of that directory.

pycompiler_ark/Ui/Cli/discovery.py

@@ -232,10 +232,16 @@ def bcasl_doctor_payload(workspace: str | None = None) -> dict[str, Any]:
     }
 
 
-def scaffold_engine(target_name: str, root_dir: str | None = None) -> dict[str, Any]:
+def scaffold_engine(
+    target_name: str, root_dir: str | None = None, is_dev: bool = False
+) -> dict[str, Any]:
     safe = str(target_name).strip().replace("-", "_").replace(" ", "_").lower()
     base_root = Path(root_dir or Path.cwd())
-    engine_dir = base_root / "engines" / safe
+    if is_dev:
+        engine_dir = base_root / safe
+    else:
+        engine_dir = base_root / "engines" / safe
+
     lang_dir = engine_dir / "languages"
     created: list[str] = []
     if engine_dir.exists():
@@ -277,10 +283,16 @@ def scaffold_engine(target_name: str, root_dir: str | None = None) -> dict[str,
     return {"created": True, "path": str(engine_dir)}
 
 
-def scaffold_plugin(target_name: str, root_dir: str | None = None) -> dict[str, Any]:
+def scaffold_plugin(
+    target_name: str, root_dir: str | None = None, is_dev: bool = False
+) -> dict[str, Any]:
     safe = str(target_name).strip().replace("-", "_").replace(" ", "_")
     base_root = Path(root_dir or Path.cwd())
-    plugin_dir = base_root / "Plugins" / safe
+    if is_dev:
+        plugin_dir = base_root / safe
+    else:
+        plugin_dir = base_root / "Plugins" / safe
+
     lang_dir = plugin_dir / "languages"
     if plugin_dir.exists():
         return {"created": False, "path": str(plugin_dir), "reason": "already exists"}

pycompiler_ark/Ui/Cli/helpers.py

@@ -603,11 +603,46 @@ def list_plugins_payload() -> dict[str, Any]:
 
 
 def scaffold_engine_payload(name: str, root_dir: str | None = None) -> dict[str, Any]:
-    return scaffold_engine(name, root_dir=root_dir)
+    from pycompiler_ark.Core.Configs import config_file_for, resolve_config_value
+    from pycompiler_ark.Ui.Cli.interactive import ask_path
+
+    is_dev = False
+    if not root_dir:
+        # Check if user DEFINED a custom dir (explicitly set via 'set')
+        conf_path = config_file_for("dev-engine-dir", create_root=False)
+        if conf_path.exists():
+            root_dir = resolve_config_value("dev-engine-dir", create_default=False)
+            is_dev = True
+
+    if not root_dir:
+        # Prompt user
+        root_dir = ask_path("Path for the new engine")
+        if not root_dir:
+            return {"created": False, "reason": "No destination path provided"}
+
+    # We need to tell scaffold_engine if we are in a dev dir to avoid nesting
+    return scaffold_engine(name, root_dir=root_dir, is_dev=is_dev)
 
 
 def scaffold_plugin_payload(name: str, root_dir: str | None = None) -> dict[str, Any]:
-    return scaffold_plugin(name, root_dir=root_dir)
+    from pycompiler_ark.Core.Configs import config_file_for, resolve_config_value
+    from pycompiler_ark.Ui.Cli.interactive import ask_path
+
+    is_dev = False
+    if not root_dir:
+        # Check if user DEFINED a custom dir
+        conf_path = config_file_for("dev-plugin-dir", create_root=False)
+        if conf_path.exists():
+            root_dir = resolve_config_value("dev-plugin-dir", create_default=False)
+            is_dev = True
+
+    if not root_dir:
+        # Prompt user
+        root_dir = ask_path("Path for the new plugin")
+        if not root_dir:
+            return {"created": False, "reason": "No destination path provided"}
+
+    return scaffold_plugin(name, root_dir=root_dir, is_dev=is_dev)
 
 
 def run_bcasl_before_compile_sync(

pycompiler_ark/Ui/Cli/interactive.py

@@ -118,6 +118,47 @@ def ask_yes_no(prompt: str, *, default_yes: bool = True) -> bool:
                 pass
 
 
+def ask_path(prompt: str, default: Optional[str] = None) -> str | None:
+    """Prompt the user for a directory path."""
+    if os.environ.get("PYCOMPILER_YES") == "1":
+        return default or os.getcwd()
+
+    stream, close_stream = _open_tty_stream()
+    if stream is None:
+        if _is_noninteractive_env():
+            return default
+        return None
+
+    try:
+        out = _REAL_STDOUT
+        default_label = f" ({default})" if default else ""
+        while True:
+            out.write(f"{prompt}{default_label}: ")
+            out.flush()
+            line = stream.readline()
+            if line == "":
+                out.write("\n")
+                out.flush()
+                return None
+            answer = line.strip()
+            if answer == "":
+                out.write("\n")
+                out.flush()
+                return default or os.getcwd()
+
+            # Normalize and return
+            path = os.path.abspath(os.path.expanduser(answer))
+            out.write("\n")
+            out.flush()
+            return path
+    finally:
+        if close_stream and stream is not None:
+            try:
+                stream.close()
+            except Exception:
+                pass
+
+
 def register_cli_status(status: Any) -> None:
     """Register a Rich status spinner that must pause during user prompts."""
     if status is not None and status not in _active_statuses: