Corrige le mode headless et nettoie la documentation

Author: raidos23

EngineLoader/__init__.py

@@ -21,24 +21,58 @@
 
 from . import registry as registry  # re-export registry module
 from .base import CompilerEngine  # re-export base type
-from .registry import unload_all  # re-export unload_all function
-from .registry import get_engine  # re-export get_engine function
-from .registry import available_engines  # re-export available_engines function
-from .registry import create  # re-export create function
+from .registry import unload_all as _registry_unload_all
+from .registry import get_engine as _registry_get_engine
+from .registry import available_engines as _registry_available_engines
+from .registry import create as _registry_create
 
 __version__ = "1.0.0"
 
+_DISCOVERY_DONE = False
 
-# Perform discovery at import-time so engines are ready for UI/compile usage (packages under ENGINES/ only)
-try:
-    if str(os.environ.get("ARK_ENGINES_AUTO_DISCOVER", "1")).lower() not in (
-        "0",
-        "false",
-        "no",
-    ):
-        _auto_discover()
-except Exception:
-    pass
+
+def _ensure_discovered() -> None:
+    """Load project engines on first real registry access.
+
+    Keeping discovery lazy avoids importing every engine package during harmless
+    module imports such as CLI headless bootstrap or SDK helper loading.
+    """
+    global _DISCOVERY_DONE
+    if _DISCOVERY_DONE:
+        return
+    try:
+        if str(os.environ.get("ARK_ENGINES_AUTO_DISCOVER", "1")).lower() not in (
+            "0",
+            "false",
+            "no",
+        ):
+            _auto_discover()
+    except Exception:
+        pass
+    finally:
+        _DISCOVERY_DONE = True
+
+
+def get_engine(eid: str):
+    _ensure_discovered()
+    return _registry_get_engine(eid)
+
+
+def available_engines() -> list[str]:
+    _ensure_discovered()
+    return _registry_available_engines()
+
+
+def create(eid: str):
+    _ensure_discovered()
+    return _registry_create(eid)
+
+
+def unload_all():
+    global _DISCOVERY_DONE
+    result = _registry_unload_all()
+    _DISCOVERY_DONE = False
+    return result
 
 __all__ = [
     "CompilerEngine",

README.md

@@ -8,7 +8,7 @@ A Python project build workshop with a Qt GUI, a headless-friendly CLI, a BCASL
 
 ---
 
-## Why this app ?
+## Why this app?
 
 Build Python apps with a predictable workflow, a configurable pre-compile pipeline, and the freedom to choose your build engine.
 
@@ -90,7 +90,7 @@ python pycompiler_ark.py engine list --json
 python pycompiler_ark.py engine doctor nuitka src/main.py --json
 python pycompiler_ark.py workspace inspect . --json
 python pycompiler_ark.py doctor --json
-python pycompiler_ark.py ci smoke . --json --strict --require-entrypoint
+python pycompiler_ark.py ci smoke /path/to/workspace --json --strict --require-entrypoint
 python pycompiler_ark.py scaffold engine demo_engine --json
 python pycompiler_ark.py unload --json
 ```
@@ -107,19 +107,20 @@ python pycompiler_ark.py unload --json
 
 ### Headless note
 
-The CLI bootstrap no longer forces Qt for purely headless commands such as:
+The CLI router no longer bootstraps the main Qt application for headless paths such as:
 
 - `--help`
 - `--version`
 - `--info`
 - `--cli`
 - `unload`
-- `engine ...`
 - `workspace ...`
-- `doctor`
-- `scaffold ...`
 
-This makes scripting and CI friendlier on machines where the GUI stack is unavailable or intentionally not used.
+Structured command groups such as `engine`, `bcasl`, `doctor`, `ci`, and `scaffold`
+also avoid launching the main GUI entrypoint.
+
+This keeps scripting and CI workflows friendly on machines where no GUI window
+should be opened.
 
 ### CI-friendly exit codes
 
@@ -180,7 +181,7 @@ python -m OnlyMod.EngineOnlyMod --engine nuitka -f script.py --dry-run
 
 ## Configuration
 
-- **`ARK_Main_Config.yml`**: inclusion and exclusion patterns, BCASL options.
+- **`ARK_Main_Config.yml`**: inclusion/exclusion patterns, build entrypoint, and a few workspace-level defaults consumed by BCASL bootstrap.
 - **`bcasl.yml`**: plugin enable/disable, order, and timeouts.
 
 ---
@@ -214,7 +215,7 @@ python -m py_compile pycompiler_ark.py
 python -m pycompiler_ark --help
 python -m pycompiler_ark workspace inspect . --json
 python -m pycompiler_ark engine list --json
-python -m pycompiler_ark ci smoke . --json --strict --require-entrypoint
+python -m pycompiler_ark ci smoke /path/to/workspace --json --strict --require-entrypoint
 ```
 
 Quality status:

cli/entrypoint.py

@@ -37,8 +37,8 @@ def main(argv: list[str] | None = None) -> int:
     if has_click():
         try:
             cli = build_cli(app_version)
-            cli.main(args=args, prog_name="pycompiler_ark", standalone_mode=False)
-            return 0
+            result = cli.main(args=args, prog_name="pycompiler_ark", standalone_mode=False)
+            return int(result) if isinstance(result, int) else 0
         except SystemExit as exc:
             return int(exc.code) if isinstance(exc.code, int) else 0
         except Exception: