docs: enchainement rapide README + architecture + contribution + deps

- Met a jour README avec les options CLI reelles et les nouveaux liens docs.

- Ajoute la doc detaillee du dependency analyzer (classification, heuristiques, limites).

- Ajoute une vue d'architecture Core/Engine/UI et un guide contributeur operable.

- Met a jour TODO Phase 7 en marquant les taches documentation/contribution comme completees.

Author: raidos23

CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Contributing Guide
+
+## Branch model
+
+- `develop`: integration branch for ongoing work.
+- `main`: stable release branch.
+
+## Commit style
+
+- Keep commits focused by topic.
+- Use clear messages (French or English) with technical intent.
+- Prefer multiple small commits over a single mixed commit.
+
+## Minimal local checks before push
+
+Run from repository root:
+
+```bash
+./venv/bin/ruff check Core/deps_analyser/analyser.py Core/IdeLikeGui/connections.py EngineLoader/base.py tests/test_engine_install_flow.py tests/test_deps_analyser_heuristics.py
+./venv/bin/black --check Core/deps_analyser/analyser.py Core/IdeLikeGui/connections.py EngineLoader/base.py tests/test_engine_install_flow.py tests/test_deps_analyser_heuristics.py
+./venv/bin/mypy --ignore-missing-imports --follow-imports skip --disable-error-code attr-defined --disable-error-code import-untyped EngineLoader/base.py Core/deps_analyser/analyser.py Core/IdeLikeGui/connections.py tests/test_engine_install_flow.py tests/test_deps_analyser_heuristics.py
+pytest -q tests/test_engine_install_flow.py tests/test_deps_analyser_heuristics.py
+```
+
+## Pull request expectations
+
+- Explain what changed and why.
+- Mention risk areas and tested paths.
+- Update docs when behavior changes (CLI options, release flow, architecture).
+
+## Release preparation
+
+Follow:
+
+- `docs/release_smoke_checklist.md`
+- `docs/versioning_and_release.md`

README.md

@@ -78,10 +78,13 @@ Compilation (PyInstaller / Nuitka / cx_Freeze)
 
 ```bash
 python pycompiler_ark.py --help
+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 --unload
 ```
 
 ### Dedicated CLI quick commands
@@ -131,6 +134,9 @@ python -m OnlyMod.EngineOnlyMod --engine nuitka -f script.py --dry-run
 - [Release smoke checklist](docs/release_smoke_checklist.md)
 - [IDE GUI parity matrix](docs/ide_gui_parity_matrix.md)
 - [Versioning and release flow](docs/versioning_and_release.md)
+- [Dependency analyzer details](docs/deps_analyzer.md)
+- [Architecture overview](docs/architecture_overview.md)
+- [Contributing guide](CONTRIBUTING.md)
 
 ---
 

TODO.md

@@ -38,10 +38,10 @@
 - [x] Mettre en place versioning + changelog de release.
 
 ### Phase 7 - Documentation et contribution (P2)
-- [ ] Mettre a jour README (mode IDE par defaut, options CLI, completion).
-- [ ] Mettre a jour la doc deps analyser (classification interne/externe).
-- [ ] Ajouter une doc architecture Core/Engine/UI.
-- [ ] Ajouter un guide contributeur (branches, commits, release flow).
+- [x] Mettre a jour README (mode IDE par defaut, options CLI, completion).
+- [x] Mettre a jour la doc deps analyser (classification interne/externe).
+- [x] Ajouter une doc architecture Core/Engine/UI.
+- [x] Ajouter un guide contributeur (branches, commits, release flow).
 
 ### Backlog historique
 - [ ] Doc engines: preciser que la scroll area n'est pas necessaire en UI monolithique (gestion auto par l'UI).

docs/architecture_overview.md

@@ -0,0 +1,34 @@
+# Architecture Overview
+
+## Main modules
+
+- `Core/`: main GUI behaviors, orchestration, UI bindings, workspace flow.
+- `Core/IdeLikeGui/`: IDE-like UI mapping layer, wired to existing Core handlers.
+- `EngineLoader/`: engine contracts, discovery, registry, compatibility checks.
+- `ENGINES/`: built-in compilation engines (PyInstaller, Nuitka, cx_Freeze).
+- `bcasl/`: pre-compilation pipeline, plugin loading, execution and validation.
+- `Plugins/`: BCASL plugins.
+- `Plugins_SDK/` and `engine_sdk/`: extension SDKs.
+- `cli/`: command-line entrypoints, launchers, fallback mode.
+- `OnlyMod/`: standalone BCASL and Engines tools.
+
+## Runtime flow (high level)
+
+1. User selects workspace and files.
+1. BCASL pipeline prepares source and plugin transforms.
+1. EngineLoader resolves active engine and validates dependencies.
+1. Compilation process starts with progress/log feedback.
+1. Output artifacts and stats are reported in GUI/CLI.
+
+## UI variants
+
+- Classic GUI: default full layout.
+- IDE-like GUI: alternate layout reusing the same Core actions/signals.
+
+## Design principle
+
+Prefer wiring reuse over duplicate logic:
+
+- UI layers map widgets to existing Core functions.
+- Engine and plugin systems stay decoupled through contracts (SDK/base classes).
+- CI and tests secure critical paths first, then expand progressively.

docs/deps_analyzer.md

@@ -0,0 +1,47 @@
+# Dependency Analyzer
+
+## Goal
+
+The dependency analyzer scans selected Python files, extracts imports, and suggests missing external packages to install.
+
+## Classification model
+
+Each import root is classified into:
+
+- `stdlib`: Python standard library modules.
+- `internal`: modules that belong to the current workspace.
+- `third_party`: modules resolved from `site-packages` / environment libraries.
+- `unknown`: unresolved imports (kept for manual review).
+
+Only `third_party` and `unknown` are proposed as install candidates.
+
+## Internal module detection strategy
+
+The analyzer combines multiple signals:
+
+1. Package chains with `__init__.py`.
+1. Common source layouts (`src/`, `lib/`, `python/`).
+1. Top-level package directories in workspace.
+1. Project metadata (`pyproject.toml`, `setup.cfg`) names converted to module roots.
+
+## Import extraction coverage
+
+- Standard imports: `import x`, `from x import y`
+- Relative imports: `from .x import y`, `from ..x import y`
+- Dynamic imports:
+  - `__import__("pkg.mod")`
+  - `importlib.import_module("pkg.mod")`
+
+## File filtering
+
+The analyzer excludes non-relevant paths:
+
+- virtual environments (`venv`, `.venv`, `env`, `.env`)
+- caches/build artifacts (`__pycache__`, `.pytest_cache`, `.mypy_cache`, `build`, `dist`)
+- VCS folders (`.git`, `.svn`, `.hg`)
+- binary artifacts (`.pyc`, `.pyo`, `.pyd`, `*.egg-info`)
+
+## Notes
+
+- `unknown` imports are intentionally conservative to avoid false negatives.
+- Dynamic runtime-only imports may still require manual validation.