Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/native.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
22 changes: 21 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
2 changes: 1 addition & 1 deletion docs/PHASE-1-PARITY-COMPLETION.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -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": {
Expand Down
10 changes: 5 additions & 5 deletions tests/integration/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
```

Expand Down Expand Up @@ -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
Expand All @@ -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/ \
Expand Down
4 changes: 2 additions & 2 deletions tests/integration/release-gate.sh
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
14 changes: 7 additions & 7 deletions tests/php/run.php
Original file line number Diff line number Diff line change
Expand Up @@ -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');
Expand Down Expand Up @@ -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');
Expand Down
Loading