From b3393abf429cf036d4c6feff49892f824ac51658 Mon Sep 17 00:00:00 2001 From: Tsvetan Stoychev Date: Thu, 12 Nov 2026 13:26:52 +0100 Subject: [PATCH] Prepare Composer release 0.1.2 --- .github/workflows/native.yml | 2 +- CHANGELOG.md | 22 +++++++++++++++++++++- README.md | 4 ++-- docs/PHASE-1-PARITY-COMPLETION.md | 2 +- package-lock.json | 4 ++-- package.json | 2 +- tests/integration/README.md | 10 +++++----- tests/integration/release-gate.sh | 4 ++-- tests/php/run.php | 14 +++++++------- 9 files changed, 42 insertions(+), 22 deletions(-) diff --git a/.github/workflows/native.yml b/.github/workflows/native.yml index a8b90b0..1bc399f 100644 --- a/.github/workflows/native.yml +++ b/.github/workflows/native.yml @@ -16,7 +16,7 @@ jobs: run: | docker compose -f tests/integration/docker/compose.yaml exec -T -w /module php sh tests/integration/build-artifact.sh docker compose -f tests/integration/docker/compose.yaml exec -T php sh /module/tests/integration/docker/install-artifact.sh - docker compose -f tests/integration/docker/compose.yaml exec -T -w /module -e BASICRUM_RELEASE_TAG=0.1.1 php sh tests/integration/release-gate.sh + docker compose -f tests/integration/docker/compose.yaml exec -T -w /module -e BASICRUM_RELEASE_TAG=0.1.2 php sh tests/integration/release-gate.sh - name: Stop only this disposable stack if: always() run: docker compose -f tests/integration/docker/compose.yaml down diff --git a/CHANGELOG.md b/CHANGELOG.md index 0c1ccb5..65d4f0c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,11 +4,31 @@ Notable changes to Basicrum Analytics are recorded here. ## [Unreleased] +## [0.1.2] - 2026-11-12 + ### Changed - Allow PHP 8.5 (`~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0`). CI runs the focused PHP checks, PHPStan level 8 and the Magento coding standard on PHP 8.5 as - well. The native release gate stays on Magento 2.4.7-p10 / PHP 8.3. + well. Native Magento/PHP 8.5 certification remains outside this release's + validation scope. +- Move the native test baseline to Magento Open Source 2.4.8-p5 / PHP 8.3, + with MariaDB 11.4, OpenSearch 3.4, and nginx 1.30. Fresh installations resolve + patched Flysystem 3 without disabling Composer security checks. Separate + Compose volumes preserve the previous 2.4.7 test installation. +- Update the release gate, CI invocation, and installation instructions for + `0.1.2`, retaining immutable versions derived from Git tags. + +### Fixed + +- Clamp configured wait delays before converting to integers, avoiding PHP 8.5 + warnings for large floats. Non-finite floats normalize to zero. Regression + checks cover the save backend and runtime configuration, including when the + delay is disabled. + +### Added + +- Acknowledge Magento community contributors in the README. ## [0.1.1] - 2026-09-24 diff --git a/README.md b/README.md index 4b514b1..5c56678 100644 --- a/README.md +++ b/README.md @@ -32,10 +32,10 @@ Install Basicrum Analytics from the Composer package: ```sh -composer require 'basicrum/basicrum-magento-2:^0.1.1' +composer require 'basicrum/basicrum-magento-2:^0.1.2' ``` -The constraint selects `0.1.1` or a newer `0.1.x` release. +The constraint selects `0.1.2` or a newer `0.1.x` release. Alternatively, for a manual source installation, place this module at the exact path below. The casing is required on case-sensitive filesystems: diff --git a/docs/PHASE-1-PARITY-COMPLETION.md b/docs/PHASE-1-PARITY-COMPLETION.md index ffeb8a9..005fcd8 100644 --- a/docs/PHASE-1-PARITY-COMPLETION.md +++ b/docs/PHASE-1-PARITY-COMPLETION.md @@ -5,7 +5,7 @@ shared parity ledger and both reference plugins were intentionally left unchanged. This is the original Phase 1 completion snapshot. The current release target -is `0.1.1`; `0.1.0` was withdrawn and cannot be reused on Packagist. Follow the +is `0.1.2`; `0.1.0` was withdrawn and cannot be reused on Packagist. Follow the [current release gate](../tests/integration/README.md#required-pre-release-native-gate) instead of the historical release references below. diff --git a/package-lock.json b/package-lock.json index 01e5d16..2838db3 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "basicrum-magento-2-tests", - "version": "0.1.1", + "version": "0.1.2", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "basicrum-magento-2-tests", - "version": "0.1.1", + "version": "0.1.2", "devDependencies": { "@playwright/test": "1.62.1", "uglify-js": "3.19.3" diff --git a/package.json b/package.json index 0617b4c..7f8ee47 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "basicrum-magento-2-tests", - "version": "0.1.1", + "version": "0.1.2", "private": true, "description": "Automated verification for the Basicrum Magento 2 module", "engines": { diff --git a/tests/integration/README.md b/tests/integration/README.md index 6398333..82649ef 100644 --- a/tests/integration/README.md +++ b/tests/integration/README.md @@ -55,7 +55,7 @@ From a clean committed checkout with the containers running: docker compose -f tests/integration/docker/compose.yaml exec -T -w /module php sh tests/integration/build-artifact.sh docker compose -f tests/integration/docker/compose.yaml exec -T -w /module php php tests/integration/test-artifact.php docker compose -f tests/integration/docker/compose.yaml exec -T php sh /module/tests/integration/docker/install-artifact.sh -docker compose -f tests/integration/docker/compose.yaml exec -T -w /module -e BASICRUM_RELEASE_TAG=0.1.1 php sh tests/integration/release-gate.sh +docker compose -f tests/integration/docker/compose.yaml exec -T -w /module -e BASICRUM_RELEASE_TAG=0.1.2 php sh tests/integration/release-gate.sh docker compose -f tests/integration/docker/compose.yaml down ``` @@ -287,9 +287,9 @@ fixture is not evidence of end-to-end verification for that page. ## Required pre-release native gate -The release candidate is `0.1.1`, and the guarded release script accepts only -`0.1.1` (with an optional `v` tag prefix). The withdrawn `0.1.0` and earlier -published versions must not be reused. Packagist permanently locks a stable +The release candidate is `0.1.2`, and the guarded release script accepts only +`0.1.2` (with an optional `v` tag prefix). Published versions, including `0.1.1` +and the withdrawn `0.1.0`, must not be reused. Packagist permanently locks a stable version's source and distribution references, even after a maintainer deletes the version; see its [version immutability policy](https://packagist.org/about/version-immutability). Change the explicit gate policy, regression tests, and CI invocation together @@ -301,7 +301,7 @@ following against the pinned disposable Magento baseline: ```sh BASICRUM_DISPOSABLE_MAGENTO=1 \ -BASICRUM_RELEASE_TAG=0.1.1 \ +BASICRUM_RELEASE_TAG=0.1.2 \ MAGENTO_ROOT=/absolute/path/to/disposable-magento \ MAGENTO_STOREFRONT_URL=https://magento.test/ \ MAGENTO_ADMIN_URL=https://magento.test/admin/ \ diff --git a/tests/integration/release-gate.sh b/tests/integration/release-gate.sh index 71e5135..891797b 100755 --- a/tests/integration/release-gate.sh +++ b/tests/integration/release-gate.sh @@ -6,8 +6,8 @@ if [ "${BASICRUM_DISPOSABLE_MAGENTO:-}" != "1" ]; then exit 1 fi -if [ "${BASICRUM_RELEASE_TAG:-}" != "0.1.1" ] && [ "${BASICRUM_RELEASE_TAG:-}" != "v0.1.1" ]; then - echo "BASICRUM_RELEASE_TAG must be 0.1.1 (or v0.1.1); published versions, including withdrawn 0.1.0, must not be reused." >&2 +if [ "${BASICRUM_RELEASE_TAG:-}" != "0.1.2" ] && [ "${BASICRUM_RELEASE_TAG:-}" != "v0.1.2" ]; then + echo "BASICRUM_RELEASE_TAG must be 0.1.2 (or v0.1.2); published versions, including withdrawn 0.1.0, must not be reused." >&2 exit 1 fi diff --git a/tests/php/run.php b/tests/php/run.php index b6cbc28..3347276 100644 --- a/tests/php/run.php +++ b/tests/php/run.php @@ -415,15 +415,15 @@ function () use ($runDisposableGuard): void { basicrum_assert_not_contains('configuration mutation', $missingRunner['stderr'], 'no mutation without the runner'); }; -$tests['native release gate accepts only the new 0.1.1 tag identity'] = function () use ($runReleaseGateGuard): void { - foreach (['', '0.0.2', '0.1.0', 'v0.1.0', '0.1.2', '0.1.1-rc1', 'not-a-version'] as $tag) { +$tests['native release gate accepts only the new 0.1.2 tag identity'] = function () use ($runReleaseGateGuard): void { + foreach (['', '0.0.2', '0.1.0', 'v0.1.0', '0.1.1', 'v0.1.1', '0.1.3', '0.1.2-rc1', 'not-a-version'] as $tag) { $rejected = $runReleaseGateGuard($tag); basicrum_assert_same(1, $rejected['status'], 'unsupported release tag must fail: ' . $tag); - basicrum_assert_contains('must be 0.1.1 (or v0.1.1)', $rejected['stderr'], 'actionable tag error'); + basicrum_assert_contains('must be 0.1.2 (or v0.1.2)', $rejected['stderr'], 'actionable tag error'); basicrum_assert_not_contains('MAGENTO_ROOT', $rejected['stderr'], 'tag fails before native work'); } - foreach (['0.1.1', 'v0.1.1'] as $tag) { + foreach (['0.1.2', 'v0.1.2'] as $tag) { $accepted = $runReleaseGateGuard($tag); basicrum_assert_same(1, $accepted['status'], 'missing Magento root must still fail closed'); basicrum_assert_contains('MAGENTO_ROOT must point', $accepted['stderr'], $tag . ' passes the tag guard'); @@ -476,15 +476,15 @@ function () use ($runDisposableGuard): void { 'MAGENTO_ADMIN_USERNAME' => 'synthetic', 'MAGENTO_ADMIN_PASSWORD' => 'synthetic', ]; - $artifactMismatch = $runReleaseGateGuard('0.1.1', $environment + ['BASICRUM_FAKE_ARTIFACT_MISMATCH' => '1']); + $artifactMismatch = $runReleaseGateGuard('0.1.2', $environment + ['BASICRUM_FAKE_ARTIFACT_MISMATCH' => '1']); basicrum_assert_same(67, $artifactMismatch['status'], 'artifact mismatch propagates'); basicrum_assert_not_contains('unexpected Magento mutation', $artifactMismatch['stderr'], 'no mutation on artifact mismatch'); - $mismatched = $runReleaseGateGuard('0.1.1', $environment + ['BASICRUM_FAKE_SOURCE_MISMATCH' => '1']); + $mismatched = $runReleaseGateGuard('0.1.2', $environment + ['BASICRUM_FAKE_SOURCE_MISMATCH' => '1']); basicrum_assert_same(68, $mismatched['status'], 'installed candidate mismatch propagates'); basicrum_assert_contains('installed candidate mismatch', $mismatched['stderr'], 'installed identity was checked'); basicrum_assert_not_contains('baseline rejected', $mismatched['stderr'], 'identity fails before native baseline bootstrap'); basicrum_assert_not_contains('unexpected Magento mutation', $mismatched['stderr'], 'no mutation on identity mismatch'); - $result = $runReleaseGateGuard('0.1.1', $environment); + $result = $runReleaseGateGuard('0.1.2', $environment); basicrum_assert_same(69, $result['status'], 'baseline failure propagates'); basicrum_assert_contains('check-baseline.php', $result['stderr'], 'baseline check was executed'); basicrum_assert_not_contains('unexpected Magento mutation', $result['stderr'], 'no native mutation ran');