docs: mise à jour de la documentation et du README pour ark.yml et BCASL

Author: raidos23

README.md

@@ -93,13 +93,10 @@ python3 pycompiler_ark.py build --lock latest.lock   # Rebuild from lock file
 # Execution
 python3 pycompiler_ark.py run bcasl                  # Execute BCASL pipeline
 python3 pycompiler_ark.py run bcasl --list-plugins   # List active plugins
-```
 
 # GUI
-
 python3 pycompiler_ark.py gui                        # Launch modern IDE-like GUI
 python3 pycompiler_ark.py gui --legacy               # Launch classic GUI
-
 ```
 
 ### Developer Commands
@@ -129,7 +126,7 @@ python3 pycompiler_ark.py init --entry main.py --json
 
 ---
 
-## How it works
+## Documentation
 
 - [Contributing guide](docs/contributing.md)
 - [How to create an engine](docs/how_to_create_an_engine.md)
@@ -139,8 +136,8 @@ python3 pycompiler_ark.py init --entry main.py --json
 
 ## Configuration
 
-- **`ark.yml`**: workspace/build exclusion patterns, build entrypoint, and a few workspace-level defaults consumed by BCASL bootstrap.
-- **`bcasl.yml`**: plugin enable/disable, order, and timeouts.
+- **`ark.yml`**: Project metadata, build entrypoint, build/workspace exclusions, and global BCASL activation.
+- **`bcasl.yml`**: Detailed BCASL pipeline configuration, plugin settings, and execution order.
 
 ---
 

docs/ark_main_config.md

@@ -26,6 +26,9 @@ build:
   data:
     - source: assets/
       destination: assets/
+
+plugins:
+  bcasl_enabled: true
 ```
 
 ## Build Entrypoint
@@ -57,7 +60,7 @@ The fields in `ark.yml` are mapped directly to the `BuildContext` data structure
 | `build.data` | `data_mappings` |
 | `build.icon` | `icon` |
 
-> **Note**: `workspace.exclude` is exclusive to the GUI workspace view filtering. `build.exclude` is what determines which files are ignored during the actual compilation and BCASL phases.
+> **Note**: `workspace.exclude` is exclusive to the GUI workspace view filtering (file explorer). `build.exclude` is what determines which files are ignored during the actual compilation (engine) and BCASL phases.
 
 ## Plugins Configuration
 

docs/dev_docs/ARK_BuildContext_v1.0.md

@@ -57,7 +57,7 @@ Each dictionary in `data_mappings` follows this structure:
 | `project_name` | `project.name` | `project.name` |
 | `entry_point` | `project.entry` | `project.entry` |
 | `output_dir` | `build.output` | `build.output` |
-| `exclude_patterns` | `workspace.exclude` | `workspace.exclude_patterns` |
+| `exclude_patterns` | `build.exclude` | `build.exclude` (or `workspace.exclude_patterns` fallback) |
 | `data_mappings` | `build.data` | `build.data` |
 | `icon` | `build.icon` | `build.icon` |
 

docs/dev_docs/ARK_Cli_v1.1.md

@@ -116,16 +116,20 @@ project:
 
 workspace:
   exclude:
-    - "tests/**/*"
     - "**/__pycache__/**" 
 
 build:
   engine: nuitka
   output: dist/
+  exclude:
+    - "tests/**/*"
   data:
     - source: plugins/
       destination: plugins/
   icon: assets/icon.ico
+
+plugins:
+  bcasl_enabled: true
 ```
 
 ---

docs/dev_docs/ARK_Locking_v1.0.md

@@ -45,12 +45,15 @@ project:
   entry: src/main.py       # Copied from project.entry
 
 workspace:
-  exclude_patterns:        # Copied from workspace.exclude
+  exclude_patterns:        # Copied from build.exclude (legacy support)
     - tests/**/*
     - "**/__pycache__/**"
 
 build:
   output: dist/            # Copied from build.output
+  exclude:                 # Copied from build.exclude
+    - tests/**/*
+    - "**/__pycache__/**"
   data:                    # Copied from build.data
     - source: assets/
       destination: assets/