Skip to content

chore(deps): require stable z-engine releases instead of dev branches - #30

Merged
lisachenko merged 1 commit into
mainfrom
claude/z-engine-stable-updates-00g5v4
Aug 18, 2026
Merged

chore(deps): require stable z-engine releases instead of dev branches#30
lisachenko merged 1 commit into
mainfrom
claude/z-engine-stable-updates-00g5v4

Conversation

@lisachenko

Copy link
Copy Markdown
Owner

What

z-engine now ships stable tags for both supported PHP minors — 8.4.2 on the 8.4 line and 8.5.0 on the 8.5 line — so this package no longer has to consume development branches.

  • "lisachenko/z-engine": "8.4.x-dev || 8.5.x-dev""~8.4.2 || ~8.5.0"
  • root "minimum-stability": "dev" / "prefer-stable": true dropped
  • the repositories VCS entry pointing at the z-engine GitHub repo dropped — it existed to reach the development branches directly, and every version this package now accepts is on Packagist (verified by installing with the entry removed on both minors)

Why the tilde and not a caret

One z-engine release line per supported PHP minor: ~8.4.2 admits patch releases inside the 8.4 line but never the 8.5 line, and ~8.5.0 does the same for 8.5. A caret would span both lines and any future one, so a z-engine built for PHP 8.6 could be installed here before this package claims to support 8.6.

Resolution stays automatic: each z-engine tag declares its own platform requirement (~8.4.0 for 8.4.x, ~8.5.0 for 8.5.x), so only one line can satisfy a given runtime, and Core::init() still enforces the exact match at boot.

Downstream note

native-php-coroutines consumes this package as dev-main and cannot reach a stable z-engine until this lands: its own ~8.4.2 || ~8.5.0 constraint is currently intersected with the dev-only requirement published here, which forces dev-master. Once this is merged, the coroutines PR resolves the real tags with no further change (verified locally against this branch through a path repository).

Testing

The full suite on both minors, including the forked IPC, arena and registry tests:

PHP z-engine resolved Result
8.4.19 8.4.2 190/190 pass
8.5.9 8.5.0 190/190 pass

No segfaults, bus errors or hung children on either minor.

Note: PHPUnit itself could not be installed in the environment this was prepared in (egress is restricted to the lisachenko/* repositories, so Packagist dist archives for dev dependencies are unreachable). The suite was executed through a small stand-in that provides the TestCase assertion surface these tests use — assertSame/assertTrue/expectException/expectExceptionMessageMatches/DataProvider/RequiresPhpExtension and friends — driving the real test classes and the real tests/bootstrap.php. It does not implement PHPUnit's risky-test detection or failOnWarning, so CI's vendor/bin/phpunit remains the authoritative run.


Generated by Claude Code

z-engine now ships stable tags for both supported PHP minors (8.4.2 on the
8.4 line, 8.5.0 on the 8.5 line), so the development-branch constraint is no
longer needed.

- require "lisachenko/z-engine": "~8.4.2 || ~8.5.0" — one stable release line
  per supported PHP minor. The tilde admits patch releases inside a line but
  never the next minor line, which would be built for a PHP this package does
  not claim to support; each z-engine tag also declares its own ~8.4.0/~8.5.0
  platform requirement, so only one line can ever satisfy a given runtime.
- drop the root "minimum-stability": "dev" / "prefer-stable": true pair —
  nothing in require is a development branch any more.
- drop the "repositories" VCS entry for z-engine: it was there to reach the
  development branches directly, and every version this package accepts is
  published on Packagist.
- README and AGENTS.md updated to describe release lines rather than branches.

Verified on both minors: PHP 8.4.19 resolves z-engine 8.4.2 and PHP 8.5.9
resolves 8.5.0, 190/190 tests pass on each (including the forked IPC, arena
and registry suites).

Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013foRd1XwLwqjUSkSWeWrMe
@lisachenko
lisachenko marked this pull request as ready for review August 18, 2026 13:22
@lisachenko
lisachenko merged commit 45a7844 into main Aug 18, 2026
8 checks passed
@lisachenko
lisachenko deleted the claude/z-engine-stable-updates-00g5v4 branch August 18, 2026 13:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant