Docs/Fix: mise à jour des spécifications de locking (Git) et correction de la dépréciation datetime

Author: raidos23

Core/Locking/__init__.py

@@ -134,7 +134,8 @@ def get_git_commit_hash(workspace: Path) -> str | None:
 
 
 def next_build_id(lock_dir: Path) -> str:
-    today = datetime.utcnow().strftime("%Y_%m_%d")
+    from datetime import UTC
+    today = datetime.now(UTC).strftime("%Y_%m_%d")
     prefix = f"ARK_{today}_"
     seq = 1
     if lock_dir.exists():

docs/dev_docs/ARK_Locking_v1.0.md

@@ -43,6 +43,7 @@ project:
   name: MyApp              # Copied from project.name
   version: 1.0.0           # Copied from project.version
   entry: src/main.py       # Copied from project.entry
+  git_commit: sha256:abc123... # Snapshot of current git commit
 
 workspace:
   exclude_patterns:        # Copied from build.exclude (legacy support)

docs/how_to_create_an_engine.md

@@ -51,7 +51,7 @@ class MyEngine(CompilerEngine):
 2. `@engine_register` adds the class to the registry.
 3. The GUI calls `create_tab` if present to create a tab.
 4. When compile is triggered, the engine provides the command via `build_command`.
-5. The process runs the command and calls `on_success` on success.
+5. The process runs the command and calls `on_success` on success. **Note**: ARK automatically opens the output directory (from `BuildContext.output_dir`) before calling this hook.
 
 ### **Workspace Entrypoint**
 
@@ -78,7 +78,7 @@ Core methods.
 - `program_and_args(self, context: BuildContext) -> (program, args) | None`: override if needed.
 - `preflight(self, gui, file) -> bool`: checks before compile, return False to abort.
 - `environment(self) -> dict[str, str] | None`: env vars to inject.
-- `on_success(self, gui, file) -> None`: post‑build hook.
+- `on_success(self, gui, file) -> None`: post‑build hook. Use this for specific cleanup or custom notifications. (The output directory is already opened by ARK).
 
 UI and i18n.