Release v2.2.1: composer.lock sync and CI Symfony 8 var-exporter fix.

Author: HecFranco

docs/CHANGELOG.md

@@ -9,6 +9,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.2.1] - 2026-06-11
+
+### Fixed
+
+- **composer.lock:** `platform.php` and `content-hash` synced with `composer.json` (`>=8.2`); fixes `composer validate --strict` in CI.
+- **CI:** Symfony **8.0** / **8.1** matrix cells use matching `symfony/var-exporter` (`^8.0` / `^8.1`) instead of `^7.4`, which blocked dependency resolution.
+
+No application changes required. See [UPGRADING.md](UPGRADING.md#upgrading-to-221).
+
+---
+
 ## [2.2.0] - 2026-06-01
 
 ### Fixed

docs/RELEASE.md

@@ -25,13 +25,23 @@
 
 5. **Packagist** (if the package is registered) will pick up the new tag; users can then `composer require nowo-tech/doctrine-encrypt-bundle`.
 
+**Important:** Never move or force-push a tag that Packagist already published. Stable versions are immutable; publish fixes as a **new patch tag** (e.g. `v2.2.1`) and restore the old tag to its original commit if it was moved by mistake.
+
 ## After releasing
 
 - Keep `## [Unreleased]` at the top of [CHANGELOG.md](CHANGELOG.md) for the next version; add new changes there.
 - Optionally bump a dev version in `composer.json` for development.
 
 ---
 
+## v2.2.1 (2026-06-11)
+
+- **Scope:** Fix `composer.lock` platform PHP 8.2 sync; CI `symfony/var-exporter` for Symfony 8.x matrix.
+- **Packagist:** `v2.2.0` must stay on commit `6cde672` (immutable). Tag `v2.2.1` on the release-notes commit; restore `v2.2.0` with `git tag -f v2.2.0 6cde672 && git push origin v2.2.0 --force` if it was moved.
+- **Checklist:** CHANGELOG and UPGRADING updated; `make test`; `composer validate --strict`; commit; tag `v2.2.1`; push branch and tag.
+
+---
+
 ## v2.2.0 (2026-06-01)
 
 - **Scope:** Align with Nowo bundle specs (**REQ-SF-001/002**): PHP **8.2+**; `symfony/*` **^7.0 \|\| ^8.0** (drop `^6.0` from `composer.json`); CI matrix Symfony **7.4**, **8.0**, **8.1** on PHP 8.2–8.5; docs (README, INSTALLATION, ROADMAP, UPGRADING); Rector `php82`.

docs/UPGRADING.md

@@ -29,6 +29,22 @@ This guide explains how to upgrade the Doctrine Encrypt Bundle between versions.
 
 ---
 
+## Upgrading to 2.2.1
+
+No breaking changes. Patch release only (`composer.lock` sync + CI matrix fix). Recommended if you installed **2.2.0** and hit CI/`composer validate` issues, or want the Symfony **8.0** / **8.1** CI fix from upstream.
+
+```bash
+composer update nowo-tech/doctrine-encrypt-bundle
+```
+
+Or pin explicitly:
+
+```bash
+composer require nowo-tech/doctrine-encrypt-bundle:^2.2.1
+```
+
+---
+
 ## Upgrading to 2.2.0
 
 **Breaking changes for legacy environments:**