Met a jour la documentation apres la refonte CLI et engines

Aligne l'ensemble de la documentation utilisateur et contributeur sur l'etat actuel du projet.

Met a jour le README pour presenter la CLI structuree autour des groupes gui, engine, workspace, doctor et scaffold, avec les exemples de commandes headless reelles et la note sur le bootstrap Qt desactive pour les chemins non GUI.

Actualise la documentation d'architecture pour refleter les nouveaux modules CLI runtime, lazy_ops et headless_ops, ainsi que leur role dans le decouplage entre GUI et commandes scriptables.

Met a jour le guide de contribution avec les nouveaux smoke checks CLI, le point d'entree des operations headless et les attentes de maintenance documentaire lorsque la hierarchie de commandes ou les sorties JSON evoluent.

Clarifie la documentation de la CLI dediee en distinguant le flux recommande via la CLI top-level, l'alias legacy --ide-gui, les commandes engines et les usages interactifs versus automation.

Revoit la documentation du mode IDE-like pour documenter le point d'entree recommande gui main --ide, la compatibilite legacy, la reutilisation du cablage classique, les affordances specifiques IDE et les ajustements de layout.

Met a jour la documentation de creation d'engine pour recommander une structure UI par QGroupBox, des hints compacts et des attributs widgets stables vis-a-vis de la persistance et de la compilation.

Actualise la checklist de smoke release afin d'utiliser les commandes CLI reelles en mode headless et les nouveaux points d'entree GUI explicites.

Author: raidos23

README.md

@@ -4,7 +4,7 @@
 
 # **PyCompiler ARK**
 
-A Qt-based workshop to compile Python projects with a pre-compilation plugin pipeline (BCASL) and a multi-engine system.
+A Python project build workshop with a Qt GUI, a headless-friendly CLI, a BCASL pre-compilation pipeline, and a multi-engine system.
 
 ---
 
@@ -20,6 +20,7 @@ Build Python apps with a predictable workflow, a configurable pre-compile pipeli
 - **Auto-detection for tricky dependencies**: engine-specific auto-args based on requirements or import scanning.
 - **Workspace-first UI**: filter files, manage exclusions, and follow progress and logs in one place.
 - **Venv-aware execution**: engines can use the project virtual environment automatically.
+- **Structured CLI**: explicit `gui`, `engine`, `workspace`, `doctor`, and `scaffold` commands, with JSON output on key headless paths.
 - **Standalone tools**: dedicated BCASL and Engines managers, plus CLI entry points and dry-run support.
 - **Extensible SDKs**: create new engines and BCASL plugins with the provided SDKs.
 - **Customizable**: theming and translations out of the box.
@@ -82,36 +83,60 @@ python pycompiler_ark.py --help-all
 python pycompiler_ark.py --version
 python pycompiler_ark.py --info
 python pycompiler_ark.py --cli
-python pycompiler_ark.py --ide-gui
-python pycompiler_ark.py --classic-gui
-python pycompiler_ark.py --no-splash
-python pycompiler_ark.py --unload
-python pycompiler_ark.py bcasl
-python pycompiler_ark.py engines --dry-run
+python pycompiler_ark.py gui main --ide
+python pycompiler_ark.py gui main --classic --no-splash
+python pycompiler_ark.py gui bcasl /path/to/workspace
+python pycompiler_ark.py gui engines /path/to/workspace
+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 scaffold engine demo_engine --json
+python pycompiler_ark.py unload --json
 ```
 
+### CLI groups
+
+- `gui`: launch graphical entrypoints explicitly
+- `engine`: inspect engines, run compatibility checks, dry-run or compile
+- `bcasl`: BCASL GUI or delegated headless actions
+- `workspace`: inspect the current workspace and resolved entrypoint
+- `doctor`: global diagnostics snapshot
+- `scaffold`: generate starter templates for engines and plugins
+
+### Headless note
+
+The CLI bootstrap no longer forces Qt for purely headless commands 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.
+
 ### Dedicated CLI quick commands
 
 ```text
 ark-cli> main
 ark-cli> main --ide-gui
 ark-cli> bcasl run ~/my_workspace --timeout 30
 ark-cli> engine dry-run pyinstaller src/main.py
+ark-cli> engine list
+ark-cli> unload
 ```
 
-### BCASL standalone (GUI)
-
-```bash
-python pycompiler_ark.py bcasl
-python pycompiler_ark.py bcasl /path/to/workspace
-```
-
-### Engines standalone (GUI)
+### GUI entrypoints
 
 ```bash
-python pycompiler_ark.py engines
-python pycompiler_ark.py engines /path/to/workspace
-python pycompiler_ark.py engines --dry-run
+python pycompiler_ark.py gui main --ide
+python pycompiler_ark.py gui bcasl
+python pycompiler_ark.py gui engines
 ```
 
 ### Standalone modules
@@ -137,7 +162,7 @@ python -m OnlyMod.EngineOnlyMod --engine nuitka -f script.py --dry-run
 - [How to create an engine](docs/how_to_create_an_engine.md)
 - [How to create a BC plugin](docs/how_to_create_a_bc_plugin.md)
 - [Dedicated interactive CLI (`--cli`)](docs/dedicated_cli.md)
-- [IDE-like main GUI (`--ide-gui`)](docs/ide_like_gui.md)
+- [IDE-like main GUI (`gui main --ide`)](docs/ide_like_gui.md)
 - [IDE/classic parity matrix](docs/ide_classic_parity.md)
 - [Release smoke checklist](docs/release_smoke_checklist.md)
 
@@ -152,6 +177,7 @@ python -m OnlyMod.EngineOnlyMod --engine nuitka -f script.py --dry-run
 
 ## Project layout
 
+- `cli/` — CLI entrypoints, headless operations, fallback mode, and dedicated shell.
 - `Core/` — main UI logic.
 - `Core/IdeLikeGui/` — wiring layer for the IDE-like main GUI.
 - `ENGINES/` — built-in engines.
@@ -175,6 +201,9 @@ ruff check .
 black --check .
 pytest -q tests
 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
 ```
 
 Quality status:

docs/architecture.md

@@ -13,13 +13,18 @@ Main entrypoints:
 - `cli/click_app.py`
 - `cli/fallback.py`
 - `cli/dedicated.py`
+- `cli/runtime.py`
+- `cli/lazy_ops.py`
+- `cli/headless_ops.py`
 
 Responsibilities:
 
 - parse top-level CLI options
 - choose between Click-based CLI and fallback mode
+- avoid bootstrapping Qt on purely headless command paths
 - launch the main GUI, BCASL standalone, or Engines standalone
 - expose the dedicated interactive CLI
+- provide scriptable headless commands such as `engine`, `workspace`, `doctor`, and `scaffold`
 
 ### 2. Main GUI and UI wiring
 
@@ -71,6 +76,7 @@ Responsibilities:
 - build compile commands
 - execute compilation processes
 - report logs, progress, and statistics
+- propagate engine i18n and UI tab wiring safely
 
 ### 5. BCASL pre-compilation pipeline
 
@@ -108,6 +114,8 @@ There are two main UI variants:
 
 Shared behavior should stay in reusable helpers when possible. The IDE-like UI should extend the classic behavior rather than fork it. See [IDE/classic parity matrix](./ide_classic_parity.md).
 
+The IDE-like layout now reuses the classic signal wiring, keeps explicit IDE-only affordances (`...` menu, dependencies activity button, engine icon actions), and applies its own layout tuning for header/panels/log space without forking the core workflow.
+
 ## Design guideline
 
 When changing behavior:

docs/contributing.md

@@ -44,7 +44,9 @@ Useful smoke commands:
 python -m pycompiler_ark --help
 python -m pycompiler_ark --version
 python -m pycompiler_ark --info
-python -m pycompiler_ark engines --dry-run
+python -m pycompiler_ark engine list --json
+python -m pycompiler_ark workspace inspect . --json
+python -m pycompiler_ark doctor --json
 python -m pycompiler_ark --cli
 ```
 
@@ -53,6 +55,7 @@ Release-oriented checks are documented in [Release smoke checklist](./release_sm
 ## Where to make changes
 
 - CLI behavior: `cli/`
+- headless CLI operations and JSON payloads: `cli/headless_ops.py`
 - classic GUI wiring: `Core/UiConnection.py`
 - IDE-like GUI wiring: `Core/IdeLikeGui/`
 - compilation logic: `Core/Compiler/`
@@ -68,6 +71,7 @@ Release-oriented checks are documented in [Release smoke checklist](./release_sm
 - Keep engine-specific behavior inside engines.
 - Add or update tests when changing heuristics, parsing, or orchestration behavior.
 - If you change CLI flags, commands, or docs-linked behavior, update the README.
+- If you change the command hierarchy (`gui`, `engine`, `workspace`, `doctor`, `scaffold`) or JSON outputs, update the CLI docs and smoke checklist.
 - If you change IDE/classic behavior, update the parity matrix when appropriate.
 
 ## Documentation expectations

docs/dedicated_cli.md

@@ -8,14 +8,25 @@ python pycompiler_ark.py --cli
 python -m pycompiler_ark --cli
 ```
 
-Alternative main GUI launch (outside dedicated CLI):
+Preferred main GUI launch from the top-level CLI:
+
+```bash
+python pycompiler_ark.py gui main --ide
+```
+
+Legacy compatibility alias outside dedicated CLI:
 
 ```bash
 python pycompiler_ark.py --ide-gui
 ```
 
 This mode is designed as a lightweight control shell for common launcher actions.
 
+The dedicated shell is complementary to the structured top-level CLI. Use:
+
+- top-level Click commands for scripting and CI
+- `--cli` for interactive operator workflows
+
 ## What It Does
 
 - Opens a persistent prompt (`ark-cli`).
@@ -42,6 +53,7 @@ This mode is designed as a lightweight control shell for common launcher actions
 - `engine info <engine_id>`: print engine metadata and compatibility.
 - `engine dry-run <engine_id> <file.py>`: build and print the compile command.
 - `engine compile <engine_id> <file.py>`: execute compilation from the dedicated CLI.
+- `engine ... --workspace <path>`: explicit workspace override when needed.
 - `engine ... -w <workspace>`: optional workspace override for engine commands.
 - `unload`: unload all registered engines.
 - `exit` or `quit`: close the dedicated CLI.
@@ -71,3 +83,4 @@ ark-cli> exit
 - When a GUI command is executed (`main`, `bcasl`, `engines`), control returns to the prompt after the GUI is closed.
 - If Rich is installed, output is colorized. If not, the CLI still works in plain mode.
 - `engine compile` validates the target file path before running the engine command.
+- For automation, prefer the top-level commands documented in the README (`engine`, `workspace`, `doctor`, `scaffold`, `gui`).

docs/how_to_create_an_engine.md

@@ -88,6 +88,8 @@ Tools and dependencies.
 - Wire signals locally and use `gui.log.append(...)` for logs.
 - No need to wrap your tab in a scroll area: the UI handles large tabs automatically when needed.
 - Prefer shared UI helpers from the SDK for common patterns (icon selector, output dir, checkbox rows).
+- Prefer grouping options with `QGroupBox` sections and compact hints, following the built-in engines layout style.
+- Keep widget attribute names stable once they are used by config persistence or compilation logic.
 
 ### **Engine Config (get_config / set_config)**
 ARK can persist engine UI options per workspace in:

docs/ide_like_gui.md

@@ -1,13 +1,14 @@
-## IDE-like Main GUI (`--ide-gui`)
+## IDE-like Main GUI (`gui main --ide`)
 
 PyCompiler ARK can launch an alternative main interface layout inspired by IDE tools.
+The preferred entrypoint is the grouped CLI form `gui main --ide`.
 
 Use:
 
 ```bash
-python pycompiler_ark.py --ide-gui
+python pycompiler_ark.py gui main --ide
 # or
-python -m pycompiler_ark --ide-gui
+python -m pycompiler_ark gui main --ide
 ```
 
 From the dedicated CLI:
@@ -16,13 +17,25 @@ From the dedicated CLI:
 ark-cli> main --ide-gui
 ```
 
+Legacy compatibility alias:
+
+```bash
+python -m pycompiler_ark --ide-gui
+```
+
 ## What It Changes
 
 - Loads `ui/ui_ide_design2.ui` as the main window layout.
 - Keeps existing Core logic (workspace, compilation, cancellation, etc.).
+- Reuses the classic shared signal wiring and policies instead of duplicating them.
 - Uses a wiring layer only (no duplicated business logic) through:
   - `Core/IdeLikeGui/__init__.py`
   - `Core/IdeLikeGui/connections.py`
+- Keeps IDE-specific affordances:
+  - `...` activity-bar menu
+  - dependencies activity button
+  - explicit icon buttons for engines
+- Tunes the loaded layout at runtime to reduce label compression in the header, center panel, and logs area.
 
 ## Runtime Switch
 
@@ -43,3 +56,5 @@ The IDE-like wiring currently connects these existing actions:
 - Select workspace (`select_workspace`)
 
 Additional controls can be mapped incrementally to existing Core methods.
+
+For parity details and remaining checks, see [IDE/classic parity matrix](./ide_classic_parity.md).

docs/release_smoke_checklist.md

@@ -20,7 +20,9 @@ Run these commands from a clean environment:
 python -m pycompiler_ark --help
 python -m pycompiler_ark --version
 python -m pycompiler_ark --info
-python -m pycompiler_ark engines --dry-run
+python -m pycompiler_ark engine list --json
+python -m pycompiler_ark workspace inspect . --json
+python -m pycompiler_ark doctor --json
 python -m py_compile pycompiler_ark.py
 ```
 
@@ -29,7 +31,9 @@ Expected outcome:
 - Help renders without traceback.
 - Version prints the resolved app version.
 - System info returns successfully.
-- `engines --dry-run` lists engines without opening the GUI.
+- `engine list --json` returns a valid engine inventory without opening the GUI.
+- `workspace inspect . --json` returns workspace data without loading the GUI stack.
+- `doctor --json` returns a diagnostic snapshot successfully.
 - Source compilation check succeeds.
 
 ## GUI Parity
@@ -44,8 +48,8 @@ Expected outcome:
 - Launch the classic GUI.
 - Launch the IDE-like GUI.
 - Open the dedicated CLI with `python -m pycompiler_ark --cli`.
-- Open BCASL standalone with `python -m pycompiler_ark bcasl`.
-- Open Engines standalone with `python -m pycompiler_ark engines`.
+- Open BCASL standalone with `python -m pycompiler_ark gui bcasl`.
+- Open Engines standalone with `python -m pycompiler_ark gui engines`.
 
 ## Release Artifacts