chore: require PHP 8.4

Author: hafung

.github/workflows/ci.yml

@@ -13,13 +13,12 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest]
-        php: ['8.2', '8.4']
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v5
       - uses: shivammathur/setup-php@v2
         with:
-          php-version: ${{ matrix.php }}
+          php-version: '8.4'
           coverage: none
       - run: composer validate --strict
       - run: composer install --no-interaction --no-progress

AGENTS.md

@@ -26,6 +26,8 @@ belongs in `docs/`.
 
 ## TypePHP AOT constraints
 
+- PHP 8.4 is the minimum supported version for the compiler, generated
+  programs, Zend verification and Composer consumers.
 - AOT calls global `main()`; Zend does not. Each example therefore keeps an AOT
   `main.php` and a small Zend `run-zend.php` adapter.
 - AOT sources are explicitly listed in `project.yml`. Do not rely on runtime

CHANGELOG.md

@@ -4,6 +4,7 @@ All notable changes to this project will be documented in this file.
 
 ## 0.1.0-alpha.1
 
+- Require PHP 8.4 or newer to match the TypePHP toolchain and generated programs.
 - Introduce the AOT-first Application and Module lifecycle.
 - Add explicit services, configuration, events, logging and cancellation.
 - Add Console, foreground Daemon and Windows Desktop Host adapters.

README.md

@@ -3,7 +3,7 @@
 [English](README.md) | [简体中文](README.zh-CN.md)
 
 [![CI](https://github.com/typephp-org/native-core/actions/workflows/ci.yml/badge.svg)](https://github.com/typephp-org/native-core/actions/workflows/ci.yml)
-[![PHP](https://img.shields.io/badge/PHP-%3E%3D%208.2-777BB4.svg)](composer.json)
+[![PHP](https://img.shields.io/badge/PHP-%3E%3D%208.4-777BB4.svg)](composer.json)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
 An AOT-first, host-neutral application core for building CLI tools, workers,
@@ -45,7 +45,8 @@ The result is a practical split:
 - AOT-friendly APIs: named callback objects, concrete types, explicit sources,
   and no runtime code generation.
 - Console, foreground Daemon, and reusable Windows Desktop host contracts.
-- Zero runtime Composer dependencies beyond PHP `>=8.2`.
+- PHP `>=8.4`, matching the minimum required by the current TypePHP compiler
+  and generated programs, with no other runtime Composer dependencies.
 
 Dependency direction is always:
 

README.zh-CN.md

@@ -3,7 +3,7 @@
 [English](README.md) | [简体中文](README.zh-CN.md)
 
 [![CI](https://github.com/typephp-org/native-core/actions/workflows/ci.yml/badge.svg)](https://github.com/typephp-org/native-core/actions/workflows/ci.yml)
-[![PHP](https://img.shields.io/badge/PHP-%3E%3D%208.2-777BB4.svg)](composer.json)
+[![PHP](https://img.shields.io/badge/PHP-%3E%3D%208.4-777BB4.svg)](composer.json)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
 一个面向 TypePHP 与 Zend PHP 的 AOT-first、Host-neutral 应用内核，用于构建
@@ -36,7 +36,8 @@ Native Core 提供应用生命周期和可移植的服务契约，Host 负责进
   Channel 等小型可替换端口。
 - AOT-friendly API：具名回调对象、具体类型、显式 source，不做运行时代码生成。
 - Console、前台 Daemon 和可复用的 Windows Desktop Host 契约。
-- 除 PHP `>=8.2` 外没有 Composer 运行时依赖。
+- 要求 PHP `>=8.4`，与当前 TypePHP 编译器及生成程序的最低要求一致；没有
+  其他 Composer 运行时依赖。
 
 依赖方向始终是：
 

composer.json

@@ -10,7 +10,7 @@
     "source": "https://github.com/typephp-org/native-core"
   },
   "require": {
-    "php": ">=8.2"
+    "php": ">=8.4"
   },
   "autoload": {
     "psr-4": {

docs/capability-matrix.md

@@ -6,7 +6,7 @@ not release promises.
 
 | Capability | Status | Evidence / boundary |
 |---|---|---|
-| Zend PHP lint/tests | confirmed on Windows | PHP 8.4.24, 38 assertions |
+| Zend PHP 8.4 lint/tests | confirmed on Windows and CI-configured on Linux | PHP 8.4.24 locally, 38 assertions |
 | Composer PSR-4 autoload | confirmed | Core and Windows Host load from `vendor/autoload.php` |
 | Hello Console on Zend | confirmed | structured log, exit 0 |
 | Worker cancellation | confirmed | 3 ticks, exit 0 |

docs/releasing.md

@@ -10,12 +10,13 @@ Native Core uses Semantic Versioning.
 
 A release must pass:
 
-1. Zend lint and tests on Windows/Linux.
+1. Zend PHP 8.4 lint and tests on Windows/Linux.
 2. TypePHP Windows Core build and AOT integration run.
 3. Desktop Spike compile and smoke close.
 4. Dependency and license inventory review.
 5. Package generation and SHA-256 manifest verification.
-6. `CHANGELOG.md` and public documentation review.
+6. `composer.json` still requires PHP 8.4 or newer, matching TypePHP.
+7. `CHANGELOG.md` and public documentation review.
 
 Create the optional project source archive with an explicit version matching
 the immutable Git tag:
@@ -35,13 +36,16 @@ the release gate is green:
 ```bash
 git tag -a v0.1.0-alpha.1 -m "TypePHP Native Core v0.1.0-alpha.1"
 git push origin v0.1.0-alpha.1
-gh release create v0.1.0-alpha.1 --verify-tag --generate-notes --prerelease
 ```
 
-GitHub automatically exposes source ZIP and tar.gz archives for the tag. A
-GitHub Actions workflow may run the final `gh release create` step on tag pushes
-with `contents: write`; it does not need the TypePHP compiler unless that same
-workflow is also expected to rebuild or test native artifacts.
+For the current source-only alpha, an annotated tag plus `CHANGELOG.md` is the
+release record. Packagist consumes the tag directly, and GitHub exposes source
+ZIP and tar.gz archives for tags without requiring a GitHub Release.
+
+Do not maintain a separate GitHub Release yet. Add one when the project begins
+shipping native binary assets, needs a dedicated human-facing announcement, or
+reaches a milestone such as beta or 1.0. It can then be generated from an
+existing tag without changing the Composer package.
 
 For this source-only Composer package, TypePHP AOT validation remains a separate
 manual workflow on the pre-provisioned self-hosted Windows runner. Do not commit

docs/status.md

@@ -12,7 +12,7 @@
 - Minimal Zend examples and real TypePHP/Windows Console, Daemon, lifecycle and
   Win32 Desktop smokes.
 - Composer PSR-4 package metadata, native app template, public API docs and
-  Windows/Linux Zend plus self-hosted TypePHP workflow definitions.
+  Windows/Linux Zend PHP 8.4 plus self-hosted TypePHP workflow definitions.
 
 ## Not declared complete
 

docs/typephp-toolchain.md

@@ -31,6 +31,8 @@ Build scripts honor `TYPEPHP_HOME`, `PHP_HOME`, `PHPX_HOME` and
 
 ## Dual-runtime rules
 
+- The current TypePHP compiler and generated programs require PHP 8.4 or newer.
+  Native Core uses the same minimum for Zend development and Composer installs.
 - TypePHP AOT calls global `main()`; Zend does not. Zend adapters call it
   explicitly.
 - AOT consumes every PHP source listed in `project.yml`; it must not depend on