docs(release): figer le changelog et le processus de publication v1.0.0

Author: raidos23

CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on Keep a Changelog and the project follows Semantic Versioning for release tags.
+
+## [1.0.0] - 2026-04-08
+
+### Added
+- Structured CLI groups for GUI, engines, workspace, diagnostics, scaffolding, and CI precheck flows.
+- Workspace bootstrap commands (`init`, `config-auto` / `cfg-auto`, `ws` alias) designed for headless and CI usage.
+- Dedicated `prog-engine` GUI flow with workspace-aware config editing.
+- ARK self-build (dogfooding) workflow in GitHub Actions using ARK CLI + Nuitka.
+- Release pipeline workflow producing artifacts and checksums from version tags (`v*.*.*`).
+
+### Changed
+- CLI orchestration aligned with Core logic to reduce duplication and improve behavior parity.
+- CI/CD path hardened around fail-fast behavior for precheck and BCASL steps.
+- JSON-oriented CLI outputs standardized for machine parsing in automation contexts.
+- Documentation consolidated around CI/CD usage and reproducible workspace behavior (`.ark/` + config files).
+
+### Fixed
+- Cancellation and process-termination handling strengthened across compilation and plugin execution paths.
+- Multiple GUI/runtime integration regressions fixed (engine loading, workspace propagation, UI sync cases).
+- Headless/system dependency handling made safer for non-interactive environments.
+- Test suite reliability improved with temporary-directory based isolation where required.
+
+### Documentation
+- Broad documentation refresh for CLI, CI/CD flow, IDE-like GUI behavior, and contribution guidance.
+- Docstring normalization to English across major modules while preserving concise French inline comments where requested.
+
+### Notes
+- This is the first stable public release candidate baseline for tag `v1.0.0`.
+- Release artifacts are generated by `.github/workflows/release.yml`.
+

README.md

@@ -176,6 +176,9 @@ python -m OnlyMod.EngineOnlyMod --engine nuitka -f script.py --dry-run
 
 ## Documentation
 
+- [Changelog](CHANGELOG.md)
+- [Release process](docs/release_process.md)
+- [Release notes v1.0.0](docs/releases/v1.0.0.md)
 - [Architecture overview](docs/architecture.md)
 - [Contributing guide](docs/contributing.md)
 - [CI/CD with ARK CLI](docs/ci_cd_ark_cli.md)

docs/contributing.md

@@ -55,6 +55,7 @@ For reliable prechecks, point `check --strict` at a workspace that already
 defines an entrypoint in `ARK_Main_Config.yml`.
 
 Release-oriented checks should follow the CLI examples in this guide and the README.
+For publishing steps, follow [`docs/release_process.md`](./release_process.md).
 
 ## Where to make changes
 
@@ -93,6 +94,7 @@ Contributors should update documentation when they modify:
 
 ## Good first doc touchpoints
 
+- [Release process](./release_process.md)
 - [Architecture overview](./architecture.md)
 - [Dependency analyzer](./dependency_analyzer.md)
 - [Dedicated CLI](./dedicated_cli.md)

docs/release_process.md

@@ -0,0 +1,66 @@
+# Release Process
+
+This document is the release source of truth for PyCompiler ARK.
+
+## Scope
+
+Use this process for all public tags, starting with `v1.0.0`.
+
+## 1. Freeze
+
+1. Ensure `main` is green on CI (`lint`, `tests`, `smoke`).
+2. Stop feature merges; accept only release blockers.
+3. Confirm `CHANGELOG.md` is updated for the target version.
+4. Confirm docs impacted by behavior changes are updated (`README.md`, `docs/ci_cd_ark_cli.md`, feature docs).
+
+## 2. Local validation
+
+Run at minimum:
+
+```bash
+ruff check .
+black --check .
+pytest -q tests
+python -m compileall -q Core OnlyMod bcasl Plugins_SDK EngineLoader cli engine_sdk Plugins pycompiler_ark.py
+python -m pycompiler_ark --help
+python -m pycompiler_ark --version
+python -m pycompiler_ark doctor --json
+```
+
+Optional but recommended:
+
+```bash
+python -m pycompiler_ark check /path/to/workspace --json --strict
+python -m pycompiler_ark engine list --json
+```
+
+## 3. Tag and publish
+
+1. Create and push a semantic tag:
+
+```bash
+git checkout main
+git pull --ff-only
+git tag -a v1.0.0 -m "PyCompiler ARK v1.0.0"
+git push origin v1.0.0
+```
+
+2. GitHub Actions `release.yml` triggers on the tag and publishes:
+- platform artifacts
+- per-file checksums
+- combined checksums
+
+## 4. Post-release checks
+
+1. Verify the GitHub Release exists and is not missing assets.
+2. Validate checksums file is present.
+3. Add follow-up issues for any deferred fixes.
+
+## 5. Rollback guidance
+
+If a critical release blocker is found after tagging:
+
+1. Create a hotfix commit on `main`.
+2. Tag next patch (`vX.Y.Z+1`) instead of reusing the previous tag.
+3. Publish release notes describing the fix delta.
+

docs/releases/v1.0.0.md

@@ -0,0 +1,30 @@
+# PyCompiler ARK v1.0.0
+
+First stable public baseline release of PyCompiler ARK.
+
+## Highlights
+
+- CLI and Core behavior parity improved for headless and CI/CD scenarios.
+- Workspace bootstrap and auto-config flows stabilized (`init`, `cfg-auto`, `check`).
+- BCASL and compilation orchestration hardened with stricter fail-fast expectations.
+- Dedicated GUI paths (`main`, `engines`, `bcasl`, `prog-engine`) refined for workspace-driven workflows.
+- CI automation includes ARK self-build dogfooding and tag-based release artifact publishing.
+
+## Compatibility notes
+
+- Recommended Python versions in CI: 3.12 and 3.13.
+- Release artifacts are produced by GitHub Actions from semantic tags (`v*.*.*`).
+
+## Reproducibility notes
+
+- Commit workspace configuration files needed for deterministic runs:
+  - `ARK_Main_Config.yml`
+  - `bcasl.yml` (if BCASL is used)
+  - `.ark/` content when engine/runtime preferences are required by your workflow
+
+## Checks run before freeze
+
+- Lint, tests, and smoke workflows on CI.
+- Local compile sanity:
+  - `python -m compileall -q Core OnlyMod bcasl Plugins_SDK EngineLoader cli engine_sdk Plugins pycompiler_ark.py`
+