diff --git a/README.md b/README.md
index fc02616..8f11656 100644
--- a/README.md
+++ b/README.md
@@ -16,13 +16,13 @@
 
 ## 📖 简介
 
-`tinywan/webman-typephp` 是面向 Webman 2.x 的 [TypePHP AOT](https://swoole.com/aot/zh) 构建插件。它会从现有 Webman 项目生成 AOT 入口和 Linux 编译配置，再交给固定版本的 Docker builder 完成编译，最后整理出可以复制到目标服务器的 `dist/` 目录。
+`tinywan/webman-typephp` 是面向 Webman 2.x 的 [TypePHP AOT](https://swoole.com/aot/zh) 构建插件。它会从现有 Webman 项目生成 AOT 入口和编译配置，可交给固定版本的 Docker builder 生成 Linux portable-dir，也可直接调用宿主机 TypePHP 工具链生成当前平台原生程序。
 
-宿主机只需要 PHP、Composer 和 Docker，不需要安装 C++、Clang 或 TypePHP 编译工具链。
+Linux portable-dir 模式下，宿主机只需要 PHP、Composer 和 Docker。原生模式不使用 Docker，但需要匹配 ABI 的 PHP embed SDK、PHPX、TypePHP 和 C++17 编译器。
 
 ## 🌟 核心特性
 
-- ⚡ **一键构建**：自动生成 `main.php` 与 `project.linux.yml`，统一调度 Docker 编译环境。
+- ⚡ **两种构建路径**：`typephp:package` 使用 Docker 生成 Linux portable-dir；`typephp:compile` 直接调用宿主机 TypePHP、PHPX 与 C++ 编译器生成当前平台程序。
 - 🧩 **全版本 Webman 兼容**：自动把 `webman-framework` 的 `helpers.php` 与 `fast-route` 的 `functions.php` 平铺为 AOT 专用版本（`.typephp/build/`），规避新版框架顶层 `if` 守卫触发的 `Unsupported statement: Stmt_If` 编译错误或静默跳过，同时保证 `base_path()`、`config()`、`FastRoute\simpleDispatcher()` 等全局函数完整编译进二进制。
 - 🩹 **协程静态属性补丁**：自动把 `workerman/coroutine` 的 `Context`/`WaitGroup`/`Barrier` 中未初始化的标量静态属性补成可空并默认 `null`（`.typephp/build/`），规避 TypePHP 编译产物把未初始化标量静态读作零值导致 `??=` 守卫失效、进而触发 `Invalid callback ::destroy` 崩溃循环的问题。
 - 🔧 **可变参数闭包补丁**：自动把 `Worker`/`TcpConnection`/`AsyncTcpConnection`/`Select`/webman `File` 中签名不足的错误处理与信号闭包补成可变参数形态（`.typephp/build/`），规避 TypePHP 编译产物对闭包调用强制精确参数个数（PHP 语义允许多传忽略）导致每次 accept 抛 `ArgumentCountError`、worker 崩溃循环的问题。
@@ -52,12 +52,21 @@ composer require tinywan/webman-typephp --dev
 php webman typephp:doctor
 ```
 
+检查不使用 Docker 的宿主机原生工具链：
+
+```bash
+php webman typephp:doctor --target=native
+```
+
 ### 3. 编译打包
 
 ```bash
 # 默认输出到 dist/
 php webman typephp:package
 
+# SaiAdmin：自动发现核心、app、support 与已安装插件服务端业务代码
+php webman typephp:package --profile=saiadmin
+
 # dist/ 已存在时，显式确认覆盖
 php webman typephp:package --force
 
@@ -67,6 +76,22 @@ php webman typephp:package --refresh-main
 
 默认 builder 为 `tinywan/typephp-webman-builder:v0.1.3`。编译在 Docker 中完成，宿主机不需要 C++、Clang 或 TypePHP 编译器。
 
+直接调用宿主机 TypePHP 和 clang 编译当前平台程序：
+
+```bash
+php webman typephp:doctor --target=native
+php webman typephp:compile --profile=saiadmin
+```
+
+原生模式输出 `build/webman-server` 及
+`.typephp/build/native-build-manifest.json`。它不会启动 Docker，也不会把当前平台程序包装成 Linux
+portable-dir；macOS 构建结果是 Mach-O，只能在 ABI 兼容的 macOS 环境运行。
+如果项目中已经存在旧版本插件生成的 `main.php`，升级后首次重建应增加
+`--refresh-main`；命令会先保留 `main.php.bak`。
+
+SaiAdmin 的支持矩阵、开发规范、存量迁移、配置样例、验收脚本和实跑证据见
+[`docs/saiadmin-aot/`](docs/saiadmin-aot/README.md)。
+
 ### 4. 启动产物
 
 将 `dist/` 复制到兼容的 Linux x86_64/glibc 服务器，在目录内启动：
@@ -106,6 +131,7 @@ dist/
 ├── lib/                    # 随包发布的底层系统与扩展动态依赖库 (ldd 完整收集)
 ├── runtime/                # 运行时缓存与日志目录 (logs, views)
 ├── build-manifest.json     # 输入、镜像与时间等构建元数据
+├── source-coverage.json    # SaiAdmin profile 的逐业务文件 AOT 覆盖清单
 ├── config/                 # 项目运行时配置（若存在）
 ├── public/                 # 静态资源（若存在）
 └── app/view/               # 视图模板（若存在）
@@ -118,10 +144,13 @@ dist/
 | 命令 | 说明 |
 | --- | --- |
 | `php webman typephp:package` | 使用默认 builder 构建 Linux portable-dir |
+| `php webman typephp:package --profile=saiadmin` | 使用锁版本、失败关闭的 SaiAdmin 自动发现与兼容规则构建 |
+| `php webman typephp:compile --profile=saiadmin` | 不使用 Docker，调用本机 TypePHP 工具链编译当前平台原生程序 |
 | `php webman typephp:package --force` | 覆盖已有输出，并保留旧目录备份 |
 | `php webman typephp:package --refresh-main` | 强制从最新官方 stub 刷新 `main.php`（旧文件自动备份） |
 | `php webman typephp:package --image=...` | 使用指定且经过验证的 Docker 镜像 |
 | `php webman typephp:doctor` | 检查 PHP、Docker 和构建前置条件 |
+| `php webman typephp:doctor --target=native` | 检查 PHP embed、PHPX、TypePHP 和本机 C++ 编译器 |
 | `php webman typephp:init-ci` | 生成 Linux amd64 GitHub Actions 工作流 |
 
 ## ⚙️ 配置
@@ -135,6 +164,13 @@ return [
         'enabled' => true,
         'image' => 'tinywan/typephp-webman-builder:v0.1.3',
     ],
+    'native' => [
+        'tpc' => null,
+        'php' => null,
+        'php_home' => null,
+        'phpx_home' => null,
+        'cxx' => null,
+    ],
     'build' => [
         'output_name' => 'webman-server',
         'dist_dir' => 'dist',
@@ -145,6 +181,27 @@ return [
 
 `--image` 的优先级最高；未指定时使用上述 `docker.image`，配置缺失时才回退至 `tinywan/typephp-webman-builder:v0.1.3`。
 
+原生工具链默认按环境变量和常见 Composer/Homebrew 路径发现。自动发现不适用时，可通过
+`native.*`、`PHP_HOME`、`PHPX_HOME`、`TYPEPHP_TPC`、`CXX`，或
+`typephp:compile` 的同名命令选项显式指定。PHP 可执行文件、`php-config`、头文件、
+`libphp` 和 `libphpx` 必须来自同一 PHP 8.4/8.5 ABI；发现版本混用时命令会在编译前失败。
+
+### SaiAdmin profile
+
+`--profile=saiadmin` 要求存在 `plugin/saiadmin` 和有效的 `composer.lock`。profile
+沿用本插件 Composer 对 Webman 的版本约束，不再额外设置 Webman、Workerman 或
+SaiAdmin 版本白名单。安全边界由 Composer 可安装约束、SaiAdmin 安装源码一致性、
+兼容规则预期命中数和完整编译共同保证；源码结构漂移会失败关闭。当前仍会精确校验
+ThinkORM `v3.0.34` 和 Carbon `3.13.2`，因为相关兼容规则尚未完成跨版本验证。
+
+已验证版本分层如下：SaiAdmin `6.1.1` 与 `6.1.5` 均已完成 Linux amd64
+编译、打包和隔离 MySQL 业务验收。`6.1.5` 的普通 PHP 8.4 对照中，验证码、
+登录和用户信息通过；权限异常路径仍受上游隐式 nullable deprecation 影响，具体
+证据边界见 [支持矩阵](docs/saiadmin-aot/docs/compatibility-matrix.md) 与
+[验证证据](docs/saiadmin-aot/docs/verification-evidence.md)。
+
+profile 会自动发现根 `app/`、`support/`、SaiAdmin 核心和每个 `plugin/*/app/`，并编译完整 Composer 依赖树。兼容副本只写入 `.typephp/build/`，普通 PHP 源码不变。构建输出中的 `source-coverage.json` 逐项记录业务 PHP 是直接编译还是由哪个 AOT 副本替代；业务文件未分类、被排除却没有等价副本，或漂移到未知依赖版本时都会终止构建。
+
 ## 🎯 可信 MVP 边界
 
 当前第一阶段只承诺已经验证的组合：
diff --git a/docker/AssignOpTrait.php b/docker/AssignOpTrait.php
index 7edaefa..e619052 100644
--- a/docker/AssignOpTrait.php
+++ b/docker/AssignOpTrait.php
@@ -287,20 +287,18 @@ protected function parseAssignToList(Expr $left, Expr $right): string
                 continue;
             }
             if ($item instanceof ArrayItem) {
-                $key = $item->key ? $this->parseArrayKey($item->key) : (string) $k;
+                $value = new Expr\ArrayDimFetch(
+                    new Variable($tmpVar),
+                    $item->key ?? new Node\Scalar\Int_($k),
+                );
                 if ($item->value instanceof Expr\List_) {
-                    $nestedTmp = $this->genTmpVarName();
-                    $this->addLocalVar($nestedTmp, Type::ARRAY);
-                    $code .= $this->getIndent() . "{$nestedTmp} = {$tmpVar}.item({$key});" . PHP_EOL;
                     $code .= $this->getIndent()
-                        . $this->parseAssignToList($item->value, new Variable($nestedTmp))
+                        . $this->parseAssignToList($item->value, $value)
                         . PHP_EOL;
                 } else {
-                    $var = $this->parseWritableIdentifier($item->value);
-                    if ($this->isVarExpr($item->value) and !$this->hasVar($var)) {
-                        $this->addLocalVar($var, Type::VAR);
-                    }
-                    $code .= $this->getIndent() . "{$var} = {$tmpVar}.item({$key});" . PHP_EOL;
+                    $code .= $this->getIndent()
+                        . $this->parseAssignFinally($item->value, $value)
+                        . ';' . PHP_EOL;
                 }
             } else {
                 $this->unsupportedSyntax($item);
@@ -885,7 +883,7 @@ protected function parseAssignOp(Expr\AssignOp $node, string $op): string
             return $pythonOperator;
         }
         $propertyWriteTarget = $this->preparePropertyWriteTarget($node->var);
-        $this->guardLiteralDivisionByZero($node->expr, $op);
+        $this->guardLiteralDivisionByZero($node->var, $node->expr, $op);
 
         // A compound division/modulo on a NATIVE scalar slot with a proven
         // zero divisor cannot fall through to the raw C++ operator (SIGFPE
@@ -894,7 +892,7 @@ protected function parseAssignOp(Expr\AssignOp $node, string $op): string
         // lower the whole expression to the PHP-semantics binary operation
         // and leave the target untouched.
         if (($op === '/=' || $op === '%=')
-            && !$this->nativeTypes
+            && $this->varIntTypes
             && $this->isZeroLiteral($node->expr)
             && $this->isVarExpr($node->var)
             && $this->hasVar((string) $this->parseIdentifier($node->var))
@@ -903,7 +901,7 @@ protected function parseAssignOp(Expr\AssignOp $node, string $op): string
             // std::int()/std::float() values are an explicit opt-in to native
             // C++ arithmetic; changing them to PHP semantics here would be as
             // wrong as the undefined raw operation. Keep the compile-time
-            // rejection native_types mode uses.
+            // rejection varint_types mode uses.
             if ($this->isExplicitNativeArithmeticExpr($node->var)) {
                 $this->fatalError($node->expr, 'Cannot divide or modulo by zero');
             }
@@ -1201,7 +1199,7 @@ protected function parseNativePropertyAssignOp(Expr\AssignOp $node, string $op):
         // A direct zend_long reference would bypass that behavior completely.
         // Native objects cannot cross the Variant boundary and retain their
         // native C++ property access path.
-        if (!$this->nativeTypes
+        if ($this->varIntTypes
             && $def->type === Type::INT
             && !$this->isNativeObjectClass($this->detectClassOfExpr($node->var->var))
             && in_array($op, ['+=', '-=', '*=', '/=', '%=', '**=', '<<=', '>>=', '&=', '|=', '^='], true)
diff --git a/docker/CompilerBase.php b/docker/CompilerBase.php
index de45868..15f0820 100644
--- a/docker/CompilerBase.php
+++ b/docker/CompilerBase.php
@@ -153,6 +153,83 @@ class CompilerBase implements PropertyAccessContext
     use LoopVarOptimizer;
     use SsaPropOptimizer;
 
+    /**
+     * Dynamic reference slots can contain Throwable objects. Defer their
+     * validation to throwValue(), just like ordinary dynamic variables.
+     */
+    protected function parseThrow(mixed $expr): string
+    {
+        if ($this->method === '__destruct') {
+            $this->warning($expr, "Throwing exception in {$this->getFullClassName()}::__destruct() may cause memory leak");
+        }
+        $class = $this->detectDeclaredClassOfExpr($expr->expr);
+        if ($this->isNativeObjectClass($class)) {
+            $this->fatalError($expr, 'Native objects cannot be thrown as Zend exceptions');
+        }
+        $type = $this->detectTypeOfExpr($expr->expr);
+        if ($this->isNewExpr($expr->expr)) {
+            $ex = $this->parseExpr($expr->expr);
+            return 'php::throwException(' . $ex . ')';
+        }
+        if ($this->isVarExpr($expr->expr)) {
+            $ex = $this->parseIdentifier($expr->expr);
+            if ($type === Type::OBJECT) {
+                return 'php::throwException(' . $ex . ')';
+            }
+        } else {
+            $ex = $this->parseExpr($expr->expr);
+        }
+        if (!in_array($type, [Type::VAR, Type::REF, Type::OBJECT], true) && $class === '') {
+            $this->fatalError($expr, 'Can only throw objects');
+        }
+        return 'php::throwValue(' . $ex . ')';
+    }
+
+    /**
+     * Parameterized toArray() methods on ordinary PHP classes are application
+     * APIs, not TypePHP conversion hooks (for example JsonResource::toArray(Request)).
+     */
+    protected function assertKeywordConversionMethodSignature(
+        NodeAbstract $node,
+        string $class,
+        string $method,
+        FunctionDef $function,
+        string $expectedType,
+        bool $nativeClass,
+    ): void {
+        $kind = $nativeClass ? 'Native conversion method' : 'Conversion method';
+        if ($function->argInfoList !== []) {
+            if (!$nativeClass && strtolower($method) === 'toarray') {
+                return;
+            }
+            $this->fatalError($node, "{$kind} `{$class}::{$method}()` must not accept arguments");
+        }
+        $hasExactReturnType = $function->returnType === $expectedType;
+        if ($expectedType === Type::VAR) {
+            $hasExactReturnType = in_array(strtolower($function->returnTypeStr), ['mixed', 'any'], true);
+        }
+        if ($function->returnsByRef || $function->returnNullable || !$hasExactReturnType) {
+            $expectedTypeName = match ($expectedType) {
+                Type::INT => 'int',
+                Type::FLOAT => 'float',
+                Type::STR => 'string',
+                Type::BOOL => 'bool',
+                Type::ARRAY => 'array',
+                Type::STREAM => 'Stream',
+                Type::BIGINT => 'BigInt',
+                Type::BIGFLOAT => 'BigFloat',
+                Type::DECIMAL => 'Decimal',
+                Type::OBJECT => 'object',
+                Type::VAR => 'mixed` or `any',
+                default => $expectedType,
+            };
+            $this->fatalError(
+                $node,
+                "{$kind} `{$class}::{$method}()` must return exactly `{$expectedTypeName}`",
+            );
+        }
+    }
+
     public const string DEFAULT_PHP_VERSION = '8.5';
     protected const string NATIVE_PROPERTY_VALUE_VAR = 'var';
     protected const string NATIVE_PROPERTY_VALUE_DYNAMIC = 'dynamic';
@@ -490,7 +567,7 @@ protected function getBoolValue(Expr\ConstFetch $expr): string
     protected array $nativeClassDeclarations = [];
     /** @var array<string, true> Request-reset initialization flags for Native static locals. */
     protected array $nativeStaticInitializers = [];
-    protected bool $nativeTypes = false;
+    protected bool $varIntTypes = false;
     protected bool $decimalTypes = false;
     protected bool $bigintTypes = false;
     protected string $rootPath;
@@ -997,7 +1074,7 @@ protected function removeCommonPrefix(string $short, string $long): string
         return $this->getPlatform()->removeCommonPrefix($short, $long);
     }
 
-    protected function getVarType(string $name): string
+    protected function getRawVarType(string $name): string
     {
         if ($this->hasLocalVar($name)) {
             return $this->context->localVars[$name];
@@ -1009,6 +1086,16 @@ protected function getVarType(string $name): string
         return Type::VAR;
     }
 
+    /**
+     * Return the value type visible to expressions. A native C++ reference has
+     * the same operators and assignment rules as its referenced value; only
+     * ABI/binding code should inspect getRawVarType().
+     */
+    protected function getVarType(string $name): string
+    {
+        return Type::getReferencedType($this->getRawVarType($name));
+    }
+
     /**
      * Resolve the ClassDef for an object expression (variable or $this).
      */
@@ -1071,7 +1158,7 @@ protected function resetClass(): void
     protected function resetFile(): void
     {
         $this->indentLevel = 0;
-        $this->nativeTypes = false;
+        $this->varIntTypes = false;
         $this->decimalTypes = false;
         $this->bigintTypes = false;
         $this->classesDefineInFile = [];
@@ -1348,6 +1435,21 @@ protected function getFunctionCallCache(): string
         return 'typephp_get_function_call_cache(FunctionCallCacheId{' . $id . '})';
     }
 
+    /** Return the function-local late-static-bound class entry. */
+    protected function getCalledCeExpr(): string
+    {
+        $this->context->needsCalledCe = true;
+        return '_typephp_called_ce';
+    }
+
+    /** Return the function-local late-static-bound class name. */
+    protected function getCalledClassExpr(): string
+    {
+        $this->context->needsCalledCe = true;
+        $this->context->needsCalledClass = true;
+        return '_typephp_called_class';
+    }
+
     protected function getClassEntryPtr(string $className): string
     {
         $id = $this->getClassId($className);
@@ -2499,9 +2601,9 @@ protected function parseReturn(Node\Stmt\Return_ $v): string
         // runtime overflow promotes the result to float. Keep the Variant
         // representation through the return boundary so a declared scalar
         // return type observes and rejects that float exactly as PHP does.
-        // `use native_types` intentionally opts into native C++ arithmetic
+        // `use varint_types` intentionally opts into native C++ arithmetic
         // semantics and is therefore excluded from this check.
-        if (!$this->nativeTypes && $type === Type::INT && $this->exprCanOverflowInt($v->expr)) {
+        if ($this->varIntTypes && $type === Type::INT && $this->exprCanOverflowInt($v->expr)) {
             $type = Type::VAR;
         }
         $nativeExpressionClass = $this->detectClassOfExpr($v->expr);
@@ -2831,9 +2933,21 @@ protected function getNativeMethod(CallLike $expr, string $class, string $method
                 }
                 if (!$this->hasClass($classDef->extends)) {
                     if ($classDef->inheritedFromInternalClass) {
-                        if (!Reflection::hasMethod($classDef->extends, $method) and !Reflection::hasMethod($classDef->extends, $method . '__call')) {
+                        $lateStaticCall = $expr instanceof Expr\StaticCall
+                            && $this->isNameExpr($expr->class)
+                            && strtolower($expr->class->toString()) === 'static';
+                        if ($lateStaticCall && !$this->isCurrentClassFinal()) {
+                            return false;
+                        }
+                        $magicMethod = $expr instanceof Expr\StaticCall ? '__callStatic' : '__call';
+                        if ($classDef->hasMethod($magicMethod)) {
+                            return false;
+                        }
+                        if (!Reflection::hasMethod($classDef->extends, $method)
+                            && !Reflection::hasMethod($classDef->extends, $magicMethod)
+                        ) {
                             $this->fatalError($expr, 'Class `' . $classDef->getNamespacedName() . '` inherits from a internal class, but the class `' .
-                                $classDef->extends . '` does not have a `' . $method . '` method or a `__call` magic method');
+                                $classDef->extends . '` does not have a `' . $method . '` method or a `' . $magicMethod . '` magic method');
                         } else {
                             $this->climate->cyan('Dynamically calling internal class method `' . $classDef->extends . '::' . $method . '()`');
                             throw new DynamicCall();
@@ -3015,7 +3129,7 @@ protected function detectTypeOfExpr($expr): string
             case 'Expr_UnaryPlus':
                 $innerType = $this->detectTypeOfExpr($expr->expr);
                 if (
-                    !$this->nativeTypes
+                    $this->varIntTypes
                     && $exprType === 'Expr_UnaryMinus'
                     && $innerType === Type::INT
                     && $this->constantIntValue($expr->expr) === PHP_INT_MIN
@@ -3103,7 +3217,7 @@ protected function detectTypeOfExpr($expr): string
                 if ($leftType === Type::FLOAT || $rightType === Type::FLOAT) {
                     return Type::FLOAT;
                 }
-                if (!$this->nativeTypes && $leftType === Type::INT && $rightType === Type::INT) {
+                if ($this->varIntTypes && $leftType === Type::INT && $rightType === Type::INT) {
                     $op = match ($exprType) {
                         'Expr_BinaryOp_Plus' => '+',
                         'Expr_BinaryOp_Minus' => '-',
@@ -3936,7 +4050,7 @@ protected function parseNew(Expr\New_ $expr): string
                     if ($this->classDef?->nativeObject) {
                         $this->fatalError($expr, 'Native classes do not support `new static()`');
                     }
-                    $cePtr = Symbol::getCalledCe();
+                    $cePtr = $this->getCalledCeExpr();
                 } else {
                     if ($className === 'self') {
                         $className = $this->getFullClassName();
@@ -4134,7 +4248,7 @@ protected function resolveInstanceofClassPtr(NodeAbstract $class): string
             if (!$this->classDef) {
                 $this->fatalError($class, 'Cannot use "static" outside a class');
             }
-            return Symbol::getCalledCe();
+            return $this->getCalledCeExpr();
         } else {
             $className = $this->getNamespacedClassName($className);
         }
@@ -5217,6 +5331,16 @@ protected function genLocalVarDecl(array $localVars): string
     protected function genScopeVarDecl(): string
     {
         $code = '';
+        if ($this->context->needsCalledCe) {
+            $code .= $this->getIndent()
+                . 'zend_class_entry *const _typephp_called_ce = typephp_get_called_ce(this_);'
+                . PHP_EOL;
+        }
+        if ($this->context->needsCalledClass) {
+            $code .= $this->getIndent()
+                . 'php::Str const _typephp_called_class = typephp_get_called_class(_typephp_called_ce);'
+                . PHP_EOL;
+        }
         if ($this->context->hasMultiLevelBreak) {
             $code .= $this->getIndent() . 'int _brk_flag = 0;' . PHP_EOL;
         }
@@ -5276,13 +5400,11 @@ protected function genScopeVarDecl(): string
                 $code .= $this->getIndent() . $info['type'] . ' &' . $name . ' = ' . $zvalMacro . '(' . $info['getter'] . '.unwrap_ptr());' . PHP_EOL;
             }
         }
-        foreach ($this->context->staticPropRefs as $name => $info) {
-            $getter = Symbol::getStaticProperty() . '(' . $info['classPtr'] . ', ' . $info['offsetExpr'] . ')';
-            if (($info['kind'] ?? 'zval') === 'var') {
-                $code .= $this->getIndent() . Type::VAR . ' ' . $name . ' = ' . $getter . ';' . PHP_EOL;
-            } else {
-                $code .= $this->getIndent() . 'zval *' . $name . ' = ' . $getter . '.unwrap_ptr();' . PHP_EOL;
-            }
+        foreach ($this->context->staticPropRefs as $info) {
+            $code .= $this->getIndent() . 'zval *' . $info['name'] . ' = nullptr;' . PHP_EOL;
+            $code .= $this->getIndent() . 'const auto ' . $info['accessorName'] . ' = [&]() {'
+                . ' return typephp_get_static_property_cached(' . $info['name'] . ', [&]() {'
+                . ' return ' . $info['resolver'] . '; }); };' . PHP_EOL;
         }
         return $code;
     }
diff --git a/docker/Dockerfile b/docker/Dockerfile
index ea6cb37..04fa504 100644
--- a/docker/Dockerfile
+++ b/docker/Dockerfile
@@ -10,6 +10,10 @@ COPY CompilerDiagnosticTrait.php /opt/typephp/vendor/swoole/typephp/src/Diagnost
 COPY gen_stub.php /opt/typephp/vendor/swoole/typephp/src/gen_stub.php
 COPY SwitchTrait.php /opt/typephp/vendor/swoole/typephp/src/Parser/SwitchTrait.php
 COPY CompilerBase.php /opt/typephp/vendor/swoole/typephp/src/CompilerBase.php
+COPY patch_native_type_compatibility_trait.php /tmp/patch_native_type_compatibility_trait.php
+RUN php /tmp/patch_native_type_compatibility_trait.php && rm /tmp/patch_native_type_compatibility_trait.php
+COPY patch_method_call_trait.php /tmp/patch_method_call_trait.php
+RUN php /tmp/patch_method_call_trait.php && rm /tmp/patch_method_call_trait.php
 COPY ArrayExpressionTrait.php /opt/typephp/vendor/swoole/typephp/src/Parser/ArrayExpressionTrait.php
 COPY FuncCallOptimizer.php /opt/typephp/vendor/swoole/typephp/src/Optimizer/FuncCallOptimizer.php
 COPY AssignOpTrait.php /opt/typephp/vendor/swoole/typephp/src/Parser/AssignOpTrait.php
diff --git a/docker/FuncCallOptimizer.php b/docker/FuncCallOptimizer.php
index 7e5cf83..d563724 100644
--- a/docker/FuncCallOptimizer.php
+++ b/docker/FuncCallOptimizer.php
@@ -1202,7 +1202,8 @@ protected function genCompact(string $name, Node\Expr\FuncCall $expr, array $con
                 $this->fatalError($expr, 'The argument of compact function can only be literal string');
             }
             $var = $arg->value->value;
-            if (!$this->hasVar($var) && $var !== 'this') {
+            $cVar = $this->escapeVarName($var);
+            if (!$this->hasVar($cVar) && $var !== 'this') {
                 $this->fatalError($arg->value, "Undefined variable `{$var}` in compact()");
             }
             if ($this->isSuperGlobal($var)) {
@@ -1215,7 +1216,6 @@ protected function genCompact(string $name, Node\Expr\FuncCall $expr, array $con
                     $this->fatalError($expr, 'Cannot use compact("this") outside of class method');
                 }
             }
-            $cVar = $this->escapeVarName($var);
             $list[] = '{' . $key . '.str(), php::Var(' . $cVar . ')}';
         }
 
diff --git a/docker/Translator.php b/docker/Translator.php
index 1183dbe..05cca88 100644
--- a/docker/Translator.php
+++ b/docker/Translator.php
@@ -55,6 +55,7 @@
 use PhpParser\Modifiers;
 use PhpParser\Node;
 use PhpParser\NodeAbstract;
+use PhpParser\NodeFinder;
 use PhpParser\NodeTraverser;
 use PhpParser\NodeVisitor\NameResolver;
 use PhpParser\NodeVisitor\CloningVisitor;
@@ -85,6 +86,15 @@ class Translator extends Preprocessor
     protected array $argInfoHeaderFiles = [];
     protected array $registerSymbols = [];
 
+    protected function genArgumentDeclaration(ArgInfo $argInfo): string
+    {
+        if ($argInfo->byRef) {
+            return Type::REF . ' ' . $argInfo->name;
+        }
+
+        return parent::genArgumentDeclaration($argInfo);
+    }
+
     /** Generated per-file teardown functions for persistent AST class constants. */
     protected array $releaseAstConstantFns = [];
 
@@ -1770,11 +1780,19 @@ protected function getSourceCompileCommandOptions(string $sourceFile, ?string $l
             return $this->getProjectRuntimeEntryCompileCommandOptions();
         }
 
-        return match ($language) {
+        $options = match ($language) {
             null => $this->getCompileCommandOptions(),
             'c' => $this->getCCompileCommandOptions(),
             default => $this->getNativeCompileCommandOptions($language),
         };
+
+        // The generated registration unit is enormous but not a business hot path.
+        // Compiling it at -O0 bounds GCC memory without weakening user source optimization.
+        if (str_starts_with(basename($sourceFile), 'extension-')) {
+            return $options->with('optimize', 0);
+        }
+
+        return $options;
     }
 
     protected function buildCompileFileCommand(string $sourceFile, string $objectFile): string
@@ -1810,12 +1828,24 @@ public function compile(array $sourceFiles): array
         // Windows: compile the resource file (icon, version info, etc.)
         $this->compileResourceFile();
 
+        $serialObjects = [];
+        if ($this->getPlatform()->supportsPcntlParallelCompile() && $job > 1) {
+            foreach ($sourceFiles as $index => $sourceFile) {
+                if (str_starts_with(basename($sourceFile), 'extension-')) {
+                    $this->climate->lightBlue('Compiling generated extension unit serially to bound peak memory');
+                    $serialObjects = $this->compileSourceFile([$sourceFile]);
+                    unset($sourceFiles[$index]);
+                }
+            }
+            $sourceFiles = array_values($sourceFiles);
+        }
+
         if (!$this->getPlatform()->supportsPcntlParallelCompile() or $job <= 1) {
             return $this->compileSourceFile($sourceFiles);
         }
 
         // Unix/Linux/macOS compile in parallel using pcntl
-        return $this->compileWithPcntl($sourceFiles, $job);
+        return array_merge($serialObjects, $this->compileWithPcntl($sourceFiles, $job));
     }
 
     protected function preparePhpXPrecompiledHeader(): void
@@ -4791,9 +4821,13 @@ protected function genWrapperFunctionArgs(
                         $argExpr = 'php::getCallArg(' . $k . ')';
                     }
                 }
-                $cppType = $this->getDefaultArgumentType($argInfo);
+                $cppType = $argInfo->byRef
+                    ? Type::REF
+                    : $this->getDefaultArgumentType($argInfo);
                 $declaredClass = $argInfo->declaredClass ?: $argInfo->class;
-                if ($this->isStrictScalarType($argInfo->type)) {
+                if ($argInfo->byRef) {
+                    $expr = $argExpr;
+                } elseif ($this->isStrictScalarType($argInfo->type)) {
                     $rawVar = 'raw_' . $var;
                     $cppCode .= $this->getIndent() . Type::VAR . ' ' . $rawVar . ' = ' . $argExpr . ';' . PHP_EOL;
                     $cppCode .= $this->genStrictScalarParamCheck(
@@ -4957,6 +4991,33 @@ protected function genClassWrapper(ClassDef|InterfaceDef $classDef): string
     /**
      * @throws \Exception
      */
+    /**
+     * PHP closure references are dynamic Zend reference slots even when their
+     * current value is scalar or array. Mark them before statement generation
+     * so an earlier assignment is not narrowed to incompatible C++ storage.
+     *
+     * @param list<Node\Stmt> $stmts
+     */
+    private function markClosureReferenceVariables(array $stmts): void
+    {
+        $finder = new NodeFinder();
+        /** @var list<Node\Expr\Closure> $closures */
+        $closures = $finder->findInstanceOf($stmts, Node\Expr\Closure::class);
+        foreach ($closures as $closure) {
+            foreach ($closure->uses as $useItem) {
+                if (
+                    !$useItem->byRef
+                    || !$useItem->var instanceof Node\Expr\Variable
+                    || !is_string($useItem->var->name)
+                ) {
+                    continue;
+                }
+                $name = $this->parseIdentifier($useItem->var);
+                $this->context->localVars[$name] = Type::REF;
+            }
+        }
+    }
+
     protected function parseFunction(Node\Stmt\Function_|Node\Stmt\ClassMethod $v): string
     {
         $this->resetFunction();
@@ -4991,9 +5052,11 @@ protected function parseFunction(Node\Stmt\Function_|Node\Stmt\ClassMethod $v):
             }
         }
         foreach ($this->functionDef->argInfoList as $argInfo) {
-            $argumentType = $argInfo->variadic
+            $argumentType = $argInfo->byRef
+                ? Type::REF
+                : ($argInfo->variadic
                 ? Type::ARRAY
-                : ($this->getNativeObjectArgumentType($argInfo) ?? $argInfo->type);
+                : ($this->getNativeObjectArgumentType($argInfo) ?? $argInfo->type));
             $this->addArgument($argInfo->name, $argumentType);
             if (!$argInfo->variadic and $argInfo->declaredClass) {
                 $this->addObject($argInfo->name, $argInfo->declaredClass);
@@ -5007,6 +5070,9 @@ protected function parseFunction(Node\Stmt\Function_|Node\Stmt\ClassMethod $v):
             }
         }
         $this->initializeImmutableFunctionContext();
+        if ($v->stmts) {
+            $this->markClosureReferenceVariables($v->stmts);
+        }
 
         if ($this->functionDef->generator) {
             try {
@@ -5029,10 +5095,10 @@ protected function parseFunction(Node\Stmt\Function_|Node\Stmt\ClassMethod $v):
             $this->context->ssaBuilder = $ssaBuilder;
             $this->analyzeStableObjects($ssaBuilder);
             // Range-proven loop counters are safe to narrow even without
-            // `use native_types`: the optimizer rejects counters whose PHP
+            // `use varint_types`: the optimizer rejects counters whose PHP
             // integer semantics could widen to float or otherwise escape.
             $optimizedLoopVars = $this->optimizeLoopVars($ssaBuilder);
-            if ($this->nativeTypes) {
+            if ($this->varIntTypes) {
                 // Narrow local variable types based on SSA analysis.
                 $this->optimizeVarTypes($ssaBuilder);
                 // Narrow native property accesses.
@@ -5049,7 +5115,6 @@ protected function parseFunction(Node\Stmt\Function_|Node\Stmt\ClassMethod $v):
                 $this->context->localVars[$varName] = $type;
             }
         }
-
         $stmts = '';
         $this->indentLevel++;
         try {
diff --git a/docker/entrypoint.sh b/docker/entrypoint.sh
index 7dc8f30..e698480 100644
--- a/docker/entrypoint.sh
+++ b/docker/entrypoint.sh
@@ -114,9 +114,13 @@ fi
 
 # Parallelize the C++ codegen/compile phase across available cores. job:1 makes
 # the ~371-file g++ phase take 40+ minutes (exceeding the command timeout);
-# cap at 8 to bound peak memory since each PHPX-template g++ job can be large.
-jobs="$(nproc 2>/dev/null || echo 2)"
-[[ "$jobs" -gt 8 ]] && jobs=8
+# cap at 4 to bound peak memory since each PHPX-template g++ job can be large.
+jobs="${TYPEPHP_JOBS:-$(nproc 2>/dev/null || echo 2)}"
+if [[ ! "$jobs" =~ ^[1-9][0-9]*$ ]]; then
+    echo '[ERROR] TYPEPHP_JOBS must be a positive integer.' >&2
+    exit 2
+fi
+[[ "$jobs" -gt 4 ]] && jobs=4
 [[ "$jobs" -lt 1 ]] && jobs=1
 sed -i "s/^job:.*/job: ${jobs}/" "$project_file"
 
@@ -279,8 +283,26 @@ for resource in config public; do
 done
 mkdir -p "$stage_dir/runtime/logs" "$stage_dir/runtime/views"
 if [[ -d app/view ]]; then mkdir -p "$stage_dir/app"; cp -a app/view "$stage_dir/app/"; fi
-if [[ -f app/functions.php ]]; then copy_file app/functions.php "$stage_dir/app/functions.php"; fi
+if [[ -f app/functions.php && ! -f "$build_dir/source-coverage.json" ]]; then
+    copy_file app/functions.php "$stage_dir/app/functions.php"
+fi
+runtime_resources_file="$build_dir/runtime-resources.list"
+if [[ -f "$runtime_resources_file" ]]; then
+    while IFS= read -r resource || [[ -n "$resource" ]]; do
+        [[ -z "$resource" ]] && continue
+        if ! validate_relative_path "$resource"; then
+            echo "[ERROR] Unsafe runtime resource path in manifest: $resource" >&2
+            exit 2
+        fi
+        if [[ -e "$workspace/$resource" ]]; then
+            mkdir -p "$stage_dir/$(dirname -- "$resource")"
+            cp -a "$workspace/$resource" "$stage_dir/$resource"
+        fi
+    done < "$runtime_resources_file"
+    copy_file "$runtime_resources_file" "$stage_dir/runtime-resources.list"
+fi
 [[ -f "$build_dir/build-manifest.json" ]] && copy_file "$build_dir/build-manifest.json" "$stage_dir/build-manifest.json"
+[[ -f "$build_dir/source-coverage.json" ]] && copy_file "$build_dir/source-coverage.json" "$stage_dir/source-coverage.json"
 
 readonly final_dir="$real_workspace/$output_dir"
 if [[ -e "$final_dir" ]]; then
@@ -288,6 +310,7 @@ if [[ -e "$final_dir" ]]; then
         echo "[ERROR] Output '$output_dir' exists; use --force to replace it." >&2
         exit 1
     fi
+    mkdir -p "$real_workspace/.typephp"
     mv "$final_dir" "$real_workspace/.typephp/previous-$build_id"
 fi
 # stage_dir is on native storage while final_dir is on the 9P bind mount, so this
diff --git a/docker/gen_stub.php b/docker/gen_stub.php
index c4962c1..bdb31e2 100644
--- a/docker/gen_stub.php
+++ b/docker/gen_stub.php
@@ -58,6 +58,11 @@
     PHP_85_VERSION_ID,
 ];
 
+function &refval(mixed &$value): mixed
+{
+    return $value;
+}
+
 // file_put_contents() but with a success message printed after saving
 function reportFilePutContents(string $filename, string $content): void {
     getTranslator()->writeFile($filename, $content);
diff --git a/docker/patch_method_call_trait.php b/docker/patch_method_call_trait.php
new file mode 100644
index 0000000..3411e4f
--- /dev/null
+++ b/docker/patch_method_call_trait.php
@@ -0,0 +1,94 @@
+<?php
+
+declare(strict_types=1);
+
+$path = '/opt/typephp/vendor/swoole/typephp/src/Parser/MethodCallTrait.php';
+$source = file_get_contents($path);
+if ($source === false) {
+    throw new RuntimeException("Unable to read {$path}");
+}
+
+$before = <<<'PHP'
+                if (!isset(self::KEYWORD_METHOD_WITH_ARGUMENTS[$methodName]) && $expr->args !== []) {
+                    $this->fatalError($expr, "The {$methodName} method does not accept parameters");
+                }
+                if ($methodName === 'toObject') {
+                    return $this->genToObjectCall($expr, $object);
+                }
+                if ($methodName === 'toRef') {
+                    return $this->genToRefCall($expr);
+                }
+                $receiverClass = $class;
+                if ($receiverClass === '' && !$this->isVarExpr($expr->var)) {
+                    $receiverClass = $this->detectClassOfExpr($expr->var);
+                }
+                // A declared conversion method is called directly. Otherwise
+                // php::toArray() applies the PHP-compatible object-property
+                // fallback (and invokes a real toArray() method when present).
+                $useDeclaredToArray = $methodName === 'toArray'
+                    && $receiverClass !== ''
+                    && $this->objectTypeDeclaresMethod($receiverClass, $methodName);
+                if (!$useDeclaredToArray) {
+                    return $this->genToConvertCall($object, $methodName, $receiverType);
+                }
+PHP;
+
+$after = <<<'PHP'
+                $receiverClass = $class;
+                if ($receiverClass === '' && !$this->isVarExpr($expr->var)) {
+                    $receiverClass = $this->detectClassOfExpr($expr->var);
+                }
+                // A declared toArray(...) API is an ordinary PHP method, not
+                // the argument-free TypePHP conversion keyword.
+                $useDeclaredToArray = $methodName === 'toArray'
+                    && $receiverClass !== ''
+                    && $this->objectTypeDeclaresMethod($receiverClass, $methodName);
+                $useDynamicToArray = $methodName === 'toArray'
+                    && ($receiverClass === ''
+                        || $receiverType === Type::VAR
+                        || $this->objectTypeDeclaresMethod($receiverClass, '__call'));
+                $useObjectToArray = $useDeclaredToArray || $useDynamicToArray;
+                if (!isset(self::KEYWORD_METHOD_WITH_ARGUMENTS[$methodName])
+                    && $expr->args !== []
+                    && !$useObjectToArray
+                ) {
+                    $this->fatalError($expr, "The {$methodName} method does not accept parameters");
+                }
+                if ($methodName === 'toObject') {
+                    return $this->genToObjectCall($expr, $object);
+                }
+                if ($methodName === 'toRef') {
+                    return $this->genToRefCall($expr);
+                }
+                if (!$useObjectToArray) {
+                    return $this->genToConvertCall($object, $methodName, $receiverType);
+                }
+PHP;
+
+if (substr_count($source, $before) !== 1) {
+    throw new RuntimeException('Unexpected MethodCallTrait keyword-dispatch source');
+}
+
+$patched = str_replace($before, $after, $source);
+
+$lateStaticBefore = <<<'PHP'
+    ): ?string {
+        if ($expr->args !== [] || !$this->classDef || !$this->methodDef) {
+PHP;
+$lateStaticAfter = <<<'PHP'
+    ): ?string {
+        // SaiAdmin overlay: preserve dynamic late-static dispatch.
+        return null;
+
+        if ($expr->args !== [] || !$this->classDef || !$this->methodDef) {
+PHP;
+if (str_contains($patched, 'private function parseExactLateStaticCall(')) {
+    if (substr_count($patched, $lateStaticBefore) !== 1) {
+        throw new RuntimeException('Unexpected MethodCallTrait late-static optimization source');
+    }
+    $patched = str_replace($lateStaticBefore, $lateStaticAfter, $patched);
+}
+
+if (file_put_contents($path, $patched) === false) {
+    throw new RuntimeException("Unable to write {$path}");
+}
diff --git a/docker/patch_native_type_compatibility_trait.php b/docker/patch_native_type_compatibility_trait.php
new file mode 100644
index 0000000..7b90e91
--- /dev/null
+++ b/docker/patch_native_type_compatibility_trait.php
@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+$path = '/opt/typephp/vendor/swoole/typephp/src/TypeSystem/NativeTypeCompatibilityTrait.php';
+$source = file_get_contents($path);
+if ($source === false) {
+    throw new RuntimeException('Unable to read NativeTypeCompatibilityTrait.php');
+}
+
+$before = 'return $internal && is_subclass_of($class, $expected);';
+$after = 'return $internal && (strcasecmp($class, $expected) === 0'
+    . ' || is_subclass_of($class, $expected));';
+if (substr_count($source, $before) !== 1) {
+    throw new RuntimeException('Unexpected native inheritance boundary in NativeTypeCompatibilityTrait.php');
+}
+
+$typedDirect = <<<'PHP'
+                    if ($actualType === $expectedType
+                        && ($rawType === $expectedType || $rawType === $argInfo->type)
+                    ) {
+                        return $var;
+                    }
+PHP;
+$typedProxy = <<<'PHP'
+                $reference = $this->addTmpVar(Type::REF);
+                $wrapper = $this->genTmpVarName();
+                $this->context->beforeStmtLines[] = $reference . ' = ' . $this->convertToRef($arg->value) . ';';
+                $this->context->beforeStmtLines[] = 'php::RefWrap<' . $expectedType . '> '
+                    . $wrapper . '(' . $reference . ');';
+                $this->context->afterStmtLines[] = $wrapper . '.commit();';
+                return $wrapper . '.typed()';
+PHP;
+foreach ([$typedDirect, $typedProxy] as $typedRefBoundary) {
+    if (substr_count($source, $typedRefBoundary) !== 1) {
+        throw new RuntimeException('Unexpected typed reference ABI boundary in NativeTypeCompatibilityTrait.php');
+    }
+    $source = str_replace($typedRefBoundary, '', $source);
+}
+
+$patched = str_replace($before, $after, $source);
+if (file_put_contents($path, $patched) === false) {
+    throw new RuntimeException('Unable to patch NativeTypeCompatibilityTrait.php');
+}
diff --git a/docs/saiadmin-aot/README.md b/docs/saiadmin-aot/README.md
new file mode 100644
index 0000000..ef1f8db
--- /dev/null
+++ b/docs/saiadmin-aot/README.md
@@ -0,0 +1,30 @@
+# Webman TypePHP AOT 配套
+
+本目录是 `tinywan/webman-typephp` 的使用规范、迁移指南、配置样例和验收脚本，不包含另一套编译器或打包插件。
+
+推荐流程：
+
+1. 安装并锁定 `tinywan/webman-typephp`、builder、PHP、Webman 和 Composer 依赖。
+2. 按 [开发规范](docs/development-standard.md) 约束新代码。
+3. 对照 [支持矩阵](docs/compatibility-matrix.md)，存量项目按 [迁移指南](docs/migration-guide.md) 只处理真实编译错误。
+4. Linux portable-dir 使用 `php webman typephp:doctor` 和
+   `php webman typephp:package --profile=saiadmin`；宿主机原生编译使用
+   `php webman typephp:doctor --target=native` 和
+   `php webman typephp:compile --profile=saiadmin`。
+5. 用 `scripts/verify-package.sh` 检查产物契约。
+6. 仅在隔离环境中，用 `scripts/accept-linux.sh` 完成验证码、登录、用户信息和权限拒绝验收。
+
+本 PR 的 Linux amd64 完整编译、产物检查、启动和业务验收记录见
+[验证证据](docs/verification-evidence.md)。
+
+边界：
+
+- 业务 PHP 必须进入 AOT 编译，不得借 `ignore` 静默回退解释执行。
+- 配置、模板、静态数据和明确登记的第三方动态资源可以随包。
+- AOT 专用兼容改写只生成到 `.typephp/build/`；普通 PHP源码和执行路径保持不变。
+- 不因 AOT 适配修改 Webman；SaiAdmin 只修复已复现、无法由生成副本解决的问题。
+- 构建成功不等于运行成功，静态检查不等于业务验收。
+- `typephp:compile` 生成当前宿主平台程序，不等同于 Linux portable-dir；macOS 产物不能作为
+  Linux 发布物。
+
+本目录不含任何业务仓库源码、数据、凭据、内网地址或构建产物。
diff --git a/docs/saiadmin-aot/config/typephp-aot.example.php b/docs/saiadmin-aot/config/typephp-aot.example.php
new file mode 100644
index 0000000..2ac08aa
--- /dev/null
+++ b/docs/saiadmin-aot/config/typephp-aot.example.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+return [
+    'enable' => true,
+    'docker' => [
+        // 发布使用时可进一步固定为 registry tag@sha256:digest。
+        'image' => 'tinywan/typephp-webman-builder:v0.1.3',
+    ],
+    'build' => [
+        'output_name' => 'webman-server',
+        'dist_dir' => 'dist',
+        'clean_build' => true,
+    ],
+    'runtime_resources' => [
+        'config',
+        'public',
+        'app/view',
+        // 只增加模板、静态数据或经登记的第三方动态资源。
+    ],
+    'ignore' => [
+        'config',
+        'public',
+        'runtime',
+        'app/view',
+        // 不得增加自有业务 PHP 目录。
+    ],
+];
diff --git a/docs/saiadmin-aot/docs/compatibility-matrix.md b/docs/saiadmin-aot/docs/compatibility-matrix.md
new file mode 100644
index 0000000..b9608d6
--- /dev/null
+++ b/docs/saiadmin-aot/docs/compatibility-matrix.md
@@ -0,0 +1,63 @@
+# SaiAdmin AOT 支持矩阵
+
+发布型 portable-dir 首版只验收 Linux amd64；宿主机原生模式另已验证 macOS arm64。
+profile 不对 Webman、Workerman 或 SaiAdmin 增加版本白名单；依赖是否可安装由 Composer
+约束决定。表中的版本是已验证记录，不代表未列出版本自动兼容；源码结构、安装副本或
+锁定依赖漂移仍会失败关闭。
+
+| 组件 | 支持/锁定版本 |
+| --- | --- |
+| PHP | 8.4.25 |
+| TypePHP Linux builder | `tinywan/typephp-linux-x64:v0.8.0@sha256:f18cac640edf52126acc1ad781f220f9fe547f7c8db925dcc38d4854f9436f90` |
+| SaiAdmin | profile 无额外版本门禁；已验证 `6.1.1`、`6.1.5` |
+| ThinkORM | v3.0.34 |
+| Carbon | 3.13.2 |
+| Webman framework | 沿用插件 Composer 约束 `^1.5.4 \|\| ^2.0 \|\| dev-master`；已验证 `v2.2.4` 和记录中的 `dev-master` |
+| Workerman | profile 无额外版本门禁；已验证 `v5.2.2` 和记录中的 `dev-master` |
+
+## 非 Docker 原生模式
+
+| 宿主平台 | PHP embed / TypePHP | SaiAdmin | 编译 | 启动与 HTTP | 结论 |
+| --- | --- | --- | --- | --- | --- |
+| macOS arm64 | PHP ZTS 8.5.10 / TypePHP 0.9.0 | 6.1.5 | 2,056 / 2,056，通过 | 验证码和未登录权限拒绝通过 | 当前宿主原生验证通过 |
+
+原生模式要求 PHP 可执行文件、embed 头文件与 `libphp`、PHPX 来自同一 ABI。它生成
+当前宿主平台程序，不是跨平台编译：macOS 产物是 Mach-O，不能作为 Linux 发布物。
+
+## 已验证版本
+
+| SaiAdmin | Linux amd64 编译/打包 | 隔离数据库业务验收 | 结论 |
+| --- | --- | --- | --- |
+| 6.1.1 | 通过 | 验证码、登录、用户信息、权限拒绝、普通 PHP 对照均通过 | 完整验证 |
+| 6.1.5 | 通过 | MySQL 下验证码、登录、用户信息、权限拒绝通过 | AOT 业务验证完成；普通 PHP 8.4 权限异常路径仍受上游隐式 nullable deprecation 影响 |
+
+SaiAdmin 6.1.5 的最小变更依赖组合新增 CakePHP Chronos `3.5.1`，
+CakePHP Core/Database/Datasource/Event/Utility `5.4.2`、League Container
+`5.2.0`、Phinx `0.16.12`、Symfony Config `8.1.5` 和 Symfony Filesystem
+`8.1.6`，并将 PHPMailer 升至 `7.1.1`、IP2Region 升至 `3.0.15`。升级时应使用 Composer
+`--minimal-changes`，避免无关依赖整体漂移。
+
+## 已验证的兼容规则
+
+| 归属 | 问题类别 | AOT 处理 |
+| --- | --- | --- |
+| Webman / Workerman | 顶层守卫与初始化、固定参数回调、引用捕获、switch 落空、运行期清理 | 生成锁定结构的副本，并在入口补回等价初始化 |
+| Workerman Coroutine | Fiber 上下文与连接池对空 `ArrayObject`/`WeakMap` 的维度写入被 TypePHP 错译为读取 | 在 AOT 副本中使用等价的 `offsetSet()`，并保留缺失、重复及结构漂移失败 |
+| ThinkORM | 参数与局部变量类型漂移、动态解析调用参数数目、结果集跨类型、运行期连接状态清理、Collection 回调少声明键参数 | 生成类型稳定且调用参数显式的副本，并声明集合回调的值与键参数 |
+| Carbon | 变量变量、魔术单位调用、继承常量、DatePeriod 声明顺序和类型漂移 | 生成显式方法、常量和稳定局部变量副本 |
+| SaiAdmin | 验证码颜色/字体、编译类 protected 默认属性反射缺失、零参控制器无法接收 Webman 请求参数、缓存标签变量跨类型、异常原因隐式可空 | 使用随包字体；从当前源码静态提取登录与安装匿名动作；生成显式 `Request` 参数、类型稳定缓存分支和显式 nullable 异常副本 |
+| SaiAdmin 6.1.5 第三方依赖 | CakePHP/Phinx/League Container 的安装与迁移工具依赖 TypePHP v0.8 无法有界表示的动态写法 | 作为明确登记的第三方动态运行资源随包；SaiAdmin 核心、登录、权限、模型及自有业务不得进入该清单 |
+| IP2Region / Nelexa | v3 整数槽跨类型、PSR Stream 签名不一致 | 生成返回分支和接口签名明确的 AOT 副本 |
+
+规则匹配已记录的源码结构。`plugin/saiadmin` 的安装副本还必须与
+`vendor/saithink/saiadmin/src/plugin/saiadmin` 内容一致。未知源码结构、零命中、重复命中、
+安装副本漂移或无法证明等价的写法必须终止构建；不得改成运行时解释业务代码。
+
+## 未承诺范围
+
+- Windows 可执行文件和 DLL。
+- 将 macOS 原生产物当作 Linux portable-dir 发布。
+- 未来 SaiAdmin 或依赖版本的自动兼容。
+- 未经完整编译和业务验收的第三方插件。
+- PostgreSQL 业务运行尚未验收；当前完整数据库业务证据使用 MySQL 8.4。
+- 依赖动态 `include`、`eval`、闭包 rebinding 或不稳定魔术调用且无法静态等价转换的业务功能。
diff --git a/docs/saiadmin-aot/docs/development-standard.md b/docs/saiadmin-aot/docs/development-standard.md
new file mode 100644
index 0000000..279aaef
--- /dev/null
+++ b/docs/saiadmin-aot/docs/development-standard.md
@@ -0,0 +1,40 @@
+# AOT 开发规范
+
+## 依赖与构建
+
+- `composer.lock`、builder 镜像标签及 digest、PHP 小版本、Webman/Workerman 提交和扩展集合必须作为一次验收组合记录。
+- 使用项目内 `tinywan/webman-typephp` 命令生成入口、编译配置和 portable-dir，不复制其编译与打包逻辑。
+- Linux amd64 构建显式使用 `--platform linux/amd64`；发布前在目标 glibc 基线或更旧基线上验收。
+
+## 代码边界
+
+- 业务控制器、Logic、Service、Model、中间件、命令和进程代码必须编译。
+- `ignore` 只允许配置、模板、静态数据、安装器/测试夹具以及明确登记的第三方动态资源。
+- 被 `ignore` 的 PHP 声明必须由插件生成等价 `.typephp/build/*.php` 并参与编译，或被列为非业务运行时动态代码并说明原因、所有者和验收方式。
+- 不用“功能未调用”掩盖编译失败。未支持能力应在 AOT 路径显式失败，并保留普通 PHP 行为。
+- PHP 文件顶层只允许声明；禁止在顶层执行函数调用、条件分支或初始化语句。
+- 禁止变量变量和无法静态确定目标的魔术静态调用；业务代码禁止动态 `include`、`require` 和 `eval`。
+- 一个局部变量不得在同一作用域跨不兼容类型重复赋值；需要不同类型时拆成具有明确含义的变量。
+- `switch` 的每个非空分支必须显式 `break`、`return` 或 `throw`，禁止依赖 fall-through。
+- 调用参数必须符合声明；允许接收额外参数的回调应显式声明可变参数。
+- 动态调用不得依赖参数的隐式引用语义；引用参数必须在声明和调用处明确并能被 TypePHP 静态分析。
+- 禁止业务代码使用 `Closure::bind()`、`Closure::bindTo()` 或 `Closure::call()` 改写闭包作用域。
+- 上述规则若能安全且等价转换，可以只在 `.typephp/build/` 生成 AOT 副本；不能证明等价时必须报告文件、行号、规则和迁移建议，并终止出包。
+
+## 修改原则
+
+- 先保留失败日志和最小复现，再增加针对性 fixture。
+- 优先修改插件生成的 AOT 副本；不直接修改 vendor。
+- 每个替换必须锁定输入字面量或结构，版本漂移时失败或由测试暴露。
+- 同一阻碍两轮没有新证据即停止扩张，记录编译器限制或上游缺口。
+
+## 验收分层
+
+1. 插件测试和 PHP 语法检查。
+2. Linux amd64 全量编译成功。
+3. portable-dir 文件、ELF 架构、动态库、配置和运行资源检查。
+4. 隔离环境启动成功。
+5. 登录成功及至少一条权限拒绝路径成功。
+6. 相同改动的普通 PHP 回归。
+
+任何上一层通过都不能替代下一层。
diff --git a/docs/saiadmin-aot/docs/migration-guide.md b/docs/saiadmin-aot/docs/migration-guide.md
new file mode 100644
index 0000000..2e23e86
--- /dev/null
+++ b/docs/saiadmin-aot/docs/migration-guide.md
@@ -0,0 +1,72 @@
+# 存量项目迁移指南
+
+## 1. 建立基线
+
+记录当前提交和工作树状态，PHP、Composer、Docker、Webman、Workerman、TypePHP、builder 与扩展版本，以及普通 PHP 回归和原始编译 Fatal。不要运行安装器或数据库初始化。
+
+profile 不额外限制 Webman、Workerman 或 SaiAdmin 版本，不要为了通过 profile 检查
+切换项目依赖。先保留项目现有 Composer 锁定组合；若兼容规则因源码结构变化失败，
+再以实际编译错误扩展规则并补充验证记录。
+
+旧版配置中排除 `app/model`、`support` 等业务源码目录的规则会由 SaiAdmin profile
+自动移除；这些 PHP 即使暂未被引用也必须进入 AOT，不应通过删除文件绕过覆盖检查。
+
+## 2. 划分输入
+
+- 必须编译：所有自有业务 PHP。
+- 随包资源：配置、模板、静态文件和语言/数据文件。
+- 明确登记的第三方动态代码：仅在编译器当前不能表示、且运行时加载方案已经验收时使用。
+
+逐项检查生成的 `project.linux.yml`。业务文件被 `ignore` 时，必须能对应到参与编译的 `.typephp/build` 等价副本；否则迁移失败。
+
+## 3. 逐个处理真实错误
+
+每轮只处理日志中的首个阻碍：确认失败文件和锁定版本，判断责任层，在现有插件增加最小 AOT 生成改写及 fixture，然后重新全量编译。只有出现新失败位置才算取得新证据；禁止排除整块业务目录来“先出包”。
+
+升级了插件的 `main.php.stub` 后，存量项目必须显式使用 `--refresh-main` 重建入口并审查备份，不能只更新依赖后沿用旧入口。
+
+升级 SaiAdmin 时使用 Composer `--minimal-changes`，并确认
+`plugin/saiadmin` 已与 `vendor/saithink/saiadmin/src/plugin/saiadmin` 同步。
+profile 会拒绝版本号已升级但安装目录仍保留旧源码的项目。
+
+TypePHP 会拒绝同一局部变量跨不兼容类型赋值，也可能拒绝业务代码直接读取模型的
+protected 属性。前者应拆成不同变量或分支内直接返回；后者应改用公开 accessor、
+`getAttr()` 或显式 DTO。未知自有业务写法必须修复后重新编译，不能登记为动态资源。
+
+若第三方代码依赖 TypePHP 当前不能表示的运行时反射或动态行为，必须同时：
+
+1. 在 `runtime_resources` 中以最小文件或包目录登记；
+2. 在 `ignore` 中使用相同路径；
+3. 通过 Webman `autoload.files` 在使用前加载；
+4. 证明自有业务 PHP 没有进入该清单。
+
+## 4. 产物和运行验收
+
+编译完成后：
+
+```bash
+AOT_DIST=/absolute/path/to/dist ./scripts/verify-package.sh
+```
+
+准备隔离数据库、测试账号和未授权接口后：
+
+```bash
+AOT_ACCEPT_ISOLATED=YES \
+AOT_DIST=/absolute/path/to/dist \
+AOT_BASE_URL=http://127.0.0.1:8787 \
+AOT_CAPTCHA_PATH=/core/captcha \
+AOT_LOGIN_PATH=/core/login \
+AOT_LOGIN_BODY_FILE=/absolute/path/to/login.json \
+AOT_TOKEN_PATH=data.access_token \
+AOT_USER_INFO_PATH=/core/system/user \
+AOT_DENIED_PATH=/core/post/index \
+AOT_DENIED_EXPECT_STATUS=200 \
+AOT_DENIED_EXPECT_CODE=400 \
+./scripts/accept-linux.sh
+```
+
+`AOT_TOKEN_PATH` 是登录 JSON 中 Bearer token 的点分路径。脚本会验证验证码响应含 UUID 和图片、登录 token、登录后用户信息，以及权限拒绝的 HTTP 状态和业务码。登录请求文件应由隔离环境夹具写入有效且尚未消费的验证码；脚本不会创建或迁移数据库，凭据只从本地文件读取且不会输出。宿主特有路径和响应断言不得进入公开仓库。
+
+## 5. 回归与发布
+
+重新运行普通 PHP 基线。提交、推送、镜像发布和部署均是独立授权动作；发布必须重建完整 portable-dir 后重新验收。
diff --git a/docs/saiadmin-aot/docs/verification-evidence.md b/docs/saiadmin-aot/docs/verification-evidence.md
new file mode 100644
index 0000000..990af77
--- /dev/null
+++ b/docs/saiadmin-aot/docs/verification-evidence.md
@@ -0,0 +1,301 @@
+# SaiAdmin AOT 验证证据
+
+验收编号：`AOT-SAIADMIN-LINUX-01`
+
+本记录对应 `feat/saiadmin-aot-profile` 的首版候选。SaiAdmin 6.1.1 的完整业务
+验收于 2026-09-14 在 Mac 上的隔离 Linux amd64 容器环境完成；SaiAdmin 6.1.5
+的构建验收于 2026-09-18 完成。原始日志包含本地路径和一次性测试账号，因此不提交
+原始文件；下文保留版本、数量、哈希、返回码和可复现命令。
+
+## SaiAdmin 6.1.1 完整验收
+
+## 验证结论
+
+- Linux amd64 AOT 完整编译、链接和 portable-dir 打包成功。
+- 所有已发现的自有业务 PHP 和已安装插件业务 PHP 均进入 AOT 覆盖清单。
+- AOT 产物成功启动，并通过验证码、登录、登录后用户信息、权限拒绝和中立插件路由。
+- 相同业务路径在普通 PHP 下通过，AOT 适配没有改变普通运行方式。
+- 一次性测试账号、数据库卷、运行容器和隔离网络已在验收后销毁。
+
+## 固定组合
+
+| 项目 | 验证值 |
+| --- | --- |
+| 目标 | Linux amd64 / glibc portable-dir |
+| builder PHP | 8.4.25 |
+| TypePHP | `swoole/typephp v0.8.0` |
+| builder 基线 | `tinywan/typephp-linux-x64:v0.8.0@sha256:f18cac640edf52126acc1ad781f220f9fe547f7c8db925dcc38d4854f9436f90` |
+| 候选镜像 ID | `sha256:bf2dc10f8470bac08b958bf2f457969d43eb6b6a77d123c66dc7b9864f363922` |
+| SaiAdmin | 6.1.1 |
+| ThinkORM | v3.0.34 |
+| Carbon | 3.13.2 |
+| Webman framework | `fa352016aac4c9e21c8781cc127afd25ee144795` |
+| Workerman | `69bfc7765fff55bc3792560c715ae3ca8eadccb5` |
+
+## 环境与自动化测试
+
+`php webman typephp:doctor` 的关键结果：
+
+```text
+PHP 8.4.25: OK
+Docker CLI 29.1.3 and daemon: OK
+Host Clang: optional
+```
+
+插件测试和静态检查：
+
+```text
+Pest: 128 passed, 1,369 assertions
+Existing fixture warning: 1
+PHP 8.4 syntax: passed
+Shell syntax: passed
+git diff --check: passed
+```
+
+## 完整编译
+
+执行命令：
+
+```bash
+php webman typephp:doctor
+php webman typephp:package --profile=saiadmin
+```
+
+最终构建记录：
+
+```text
+Source roots scanned: 200
+PHP inputs generated and prechecked: 2,279
+Native objects compiled and linked: 2,283 / 2,283
+Build exit code: 0
+portable-dir size: 230 MB
+Runtime resources recorded: 74
+```
+
+中立插件 `plugin/aot_probe/app/controller/ProbeController.php` 由 profile 自动发现并
+直接编译，没有在 profile 中手工登记。
+
+## 产物完整性
+
+保留产物于 2026-09-15 再次运行 `scripts/verify-package.sh`，结果：
+
+```text
+ELF 64-bit LSB pie executable, x86-64
+Portable-dir contract OK
+profile=saiadmin
+compiled=131
+generated=11
+covered files=142
+runtime resources=74
+business PHP leaked into portable-dir=0
+unresolved ldd dependency=0
+```
+
+产物身份：
+
+| 文件 | SHA-256 |
+| --- | --- |
+| `webman-server.bin` | `a248c3fdd7fe7e95dfacf6d0557e320bfb19f7a5d9053ac5605329b696aee2ff` |
+| `build-manifest.json` | `379a8d19fcd1d76af463efe567cd83d51ee9414a4b0f173096a5c2ac9315e862` |
+| `source-coverage.json` | `5fd8bd86bed3987cc43fd97dd0c7f8047664b235a0b2b3bb571ea9ed785d2d77` |
+
+## 启动与业务路径
+
+portable-dir 在隔离 Linux amd64 容器中启动，Workerman 记录：
+
+```text
+Workerman[main.php] start in DEBUG mode
+40 workers [OK]
+```
+
+业务验收结果：
+
+| 路径 | HTTP | JSON 业务码 | 验证内容 |
+| --- | ---: | ---: | --- |
+| 验证码 | 200 | 200 | 返回非空 UUID 和 `data:image/` 图片 |
+| 登录 | 200 | 200 | 返回非空 Bearer access token |
+| 登录后用户信息 | 200 | 200 | 返回当前隔离用户数据 |
+| 权限拒绝 | 200 | 400 | 无权限用户被拒绝访问受保护资源 |
+| 中立插件 `/aot-probe` | 200 | 200 | 返回 `data.aot=true` |
+
+`scripts/accept-linux.sh` 的完成结果：
+
+```text
+Portable-dir contract OK
+Isolated captcha, login, user-info, and permission-denial acceptance passed.
+```
+
+普通 PHP 使用同一依赖组合、隔离数据库和业务请求执行对照：
+
+```text
+captcha: HTTP 200 / JSON 200
+login: HTTP 200 / JSON 200
+user-info: HTTP 200 / JSON 200
+permission denial: HTTP 200 / JSON 400
+```
+
+## 复现
+
+维护者可以在一次性、处于支持范围的 SaiAdmin 测试项目中执行：
+
+```bash
+php webman typephp:doctor
+php webman typephp:package --profile=saiadmin
+
+AOT_DIST=/absolute/path/to/dist \
+  ./vendor/tinywan/webman-typephp/docs/saiadmin-aot/scripts/verify-package.sh
+```
+
+业务验收需要由调用方提供隔离环境的 URL、接口路径和临时登录请求文件。必填变量及
+安全开关记录在 `scripts/accept-linux.sh` 中。脚本拒绝在未显式设置
+`AOT_ACCEPT_ISOLATED=YES` 时启动。
+
+## SaiAdmin 6.1.5 构建验收
+
+2026-09-18 使用官方 SaiAdmin `6.1.5` 源码和 Composer `--minimal-changes`
+依赖组合执行完整 Linux amd64 构建。构建前验证安装目录与 Composer 包源码一致；
+自有项目代码和非 SaiAdmin 插件不属于本证据输入。
+
+```text
+TypePHP precheck and C++ generation: 2,275 / 2,275
+Build exit code: 0
+Portable-dir contract: OK
+ELF: 64-bit LSB pie executable, x86-64
+portable-dir size: 224 MB
+runtime resources: 74
+Pest: 133 passed, 1,410 assertions
+Existing fixture warning: 1
+SaiAdmin business PHP: 120
+directly compiled: 109
+generated AOT copies: 11
+unclassified SaiAdmin business PHP: 0
+business PHP leaked into portable-dir: 0
+```
+
+第三方安装与迁移工具 `vendor/cakephp`、`vendor/league/container` 和
+`vendor/robmorgan/phinx` 明确登记为动态运行资源；SaiAdmin 核心、登录、权限、
+模型与缓存业务代码均未借此绕过 AOT。
+
+本次产物身份：
+
+| 文件 | SHA-256 |
+| --- | --- |
+| `webman-server.bin` | `6f6fe803153c9bf84b8be3a4a1f9c4fe1493703df77a401ba5cdcf774baf5c7e` |
+| `build-manifest.json` | `6aa936c82bdb5549ef2302bf5feb24d34d7ece0191a6e1da143251ce12785836` |
+| `source-coverage.json` | `d7cf4d22f4388d830496fbcdb5bb6114ee7d7de3a998ca601e75dd8d3afeb5b5` |
+
+本次构建镜像身份为
+`webman-typephp-saiadmin@sha256:5f4065b17fafc6eb86f6478f10a060211b5e9c396e8f64fa93f164b727195c5b`。
+它是本地验证候选，不替代发布时应固定的公开 builder digest。
+
+以上是 2026-09-18 的构建证据；后续数据库业务验收见下一节。
+
+## SaiAdmin 6.1.5 Linux amd64 MySQL 业务验收
+
+2026-09-19 使用 SaiAdmin `6.1.5`、Webman `v2.2.4`、Workerman `v5.2.2`、
+ThinkORM `v3.0.34` 和 Carbon `3.13.2` 重建 Linux amd64 portable-dir。builder
+为本地 PR 候选，镜像身份
+`sha256:c67c0d2635646a4c7122b7c6872d89a6e0e2495fa9211bca1a6769e87d601729`。
+
+```text
+TypePHP source generation: 2,231 / 2,231
+C++ compilation: 2,235 / 2,235
+Build and link exit code: 0
+Portable-dir contract: OK
+ELF: 64-bit LSB pie executable, x86-64
+first-party coverage: 151
+directly compiled: 134
+generated AOT copies: 17
+unclassified first-party PHP: 0
+business PHP leaked into portable-dir: 0
+Pest: 166 passed, 1,599 assertions
+Existing fixture warning: 1
+```
+
+本次产物身份：
+
+| 文件 | SHA-256 |
+| --- | --- |
+| `webman-server.bin` | `3305279e7c58791af36965ca6156fffcbb325dd0fd2eb0c32b1e31711c9a38b6` |
+| `build-manifest.json` | `483873bebb95694e0538e36b0df58c247abf52ce4412aca7632b9c59ba8dde9c` |
+| `source-coverage.json` | `8d9a6676322aff1bbecaa9c7525d7dc3ebac84c487d2f2690221d2253a54c76c` |
+
+运行环境使用无宿主 HTTP 端口映射的一次性容器网络和 MySQL 8.4。数据库由项目自带
+Phinx 迁移与 `PureSeeder` 初始化，并创建一个不绑定角色的临时账号。AOT 结果：
+
+| 路径 | HTTP | JSON 业务码 | 结果 |
+| --- | ---: | ---: | --- |
+| `GET /core/captcha` | 200 | 200 | UUID、图片和会话均生成 |
+| `POST /core/login`（管理员） | 200 | 200 | 返回 Bearer token |
+| `GET /core/system/user` | 200 | 200 | 返回管理员、角色和按钮 |
+| `POST /core/login`（无角色账号） | 200 | 200 | 返回 Bearer token |
+| `GET /core/user/index`（无角色账号） | 200 | 400 | 返回“权限不足” |
+
+普通 PHP 使用同一隔离 MySQL 对照：验证码、管理员登录和用户信息均返回业务码 200。
+权限拒绝路径在进入既有 `SystemException` 时，被 PHP 8.4 的隐式 nullable deprecation
+升级为 500。该异常类的 AOT 副本使用显式 nullable，AOT 权限拒绝已通过；普通 PHP
+源码未被 profile 修改。此项是 SaiAdmin 6.1.5 普通 PHP 8.4 基线缺口，不应误记为
+AOT 回归通过。验收结束后必须销毁临时账号、数据库和容器。
+
+## macOS arm64 非 Docker 原生验收
+
+2026-09-19 使用 SaiAdmin 6.1.5 的锁定项目组合执行宿主机原生编译。此路径没有调用
+Docker，也没有生成或冒充 Linux portable-dir。
+
+固定组合：
+
+| 项目 | 验证值 |
+| --- | --- |
+| 宿主目标 | macOS arm64 / Mach-O |
+| PHP embed | PHP ZTS 8.5.10 |
+| TypePHP | 0.9.0 |
+| C++ 编译器 | Apple Clang (`/usr/bin/clang++`) |
+| SaiAdmin | 6.1.5 |
+| Webman framework | v2.2.4 |
+| Workerman | v5.2.2 |
+| ThinkORM | v3.0.34 |
+| Carbon | 3.13.2 |
+
+执行命令：
+
+```bash
+php webman typephp:doctor --target=native
+php webman typephp:compile --profile=saiadmin
+```
+
+doctor 对 PHP embed、TypePHP、PHPX 和 C++ 编译器全部返回 `[OK]`。完整编译记录：
+
+```text
+Native toolchain ready (Docker will not be used).
+PHP 8.5 | TypePHP 0.9.0 | clang++
+Successfully compiled 2056 files
+Build successful: build/webman-server
+```
+
+产物为 82,796,672 字节的 `Mach-O 64-bit executable arm64`，SHA-256：
+
+```text
+d44177577a346bd76f2a5d96048634fb9c2c94b5ac97f668560f0584028899c0
+```
+
+动态依赖包括 `libphpx.dylib`、PHP ZTS `libphp.dylib`、GMP、MPFR、libc++ 和
+系统库；相同信息已写入 `.typephp/build/native-build-manifest.json`。
+
+为避免对外监听，运行验收使用一次性配置副本，将 HTTP 地址限制为
+`127.0.0.1:8787`、worker 数限制为 1。AOT 可执行文件启动结果为 `[OK]`，随后：
+
+| 路径 | HTTP | JSON 业务码 | 结果 |
+| --- | ---: | ---: | --- |
+| `GET /core/captcha` | 200 | 200 | `data.result=1`，UUID 与图片非空 |
+| `GET /core/system/user`（无 token） | 200 | 401 | 正确拒绝未登录请求 |
+
+普通 PHP 8.4.18 在同一份一次性运行配置下执行相同两条路径，HTTP 与业务码完全一致。
+本次没有使用登录账号或连接隔离数据库，因此不宣称登录和登录后用户信息已经在 macOS
+原生模式验收。
+
+## 证据边界
+
+- 本文件是脱敏后的本地隔离验收记录，不是公开托管的二进制或完整原始日志。
+- 哈希只能标识本次保留产物，不能替代维护者在自己的锁定环境中重建。
+- GitHub 当前没有为该分支返回 CI checks；合并前建议维护者重跑插件测试和完整构建。
+- Windows exe/DLL 未验证，不属于本次支持范围。
diff --git a/docs/saiadmin-aot/examples/plugin/aot_probe/README.md b/docs/saiadmin-aot/examples/plugin/aot_probe/README.md
new file mode 100644
index 0000000..69e7267
--- /dev/null
+++ b/docs/saiadmin-aot/examples/plugin/aot_probe/README.md
@@ -0,0 +1,9 @@
+# 中立插件自动发现样例
+
+将 `aot_probe` 目录复制到 SaiAdmin 项目的 `plugin/` 后，再执行：
+
+```bash
+php webman typephp:package --profile=saiadmin
+```
+
+覆盖清单必须新增 `plugin/aot_probe/app/controller/ProbeController.php`，产物中不得保留该业务 PHP。该样例只用于验证插件自动发现，不需要在 TypePHP 配置中手工登记。
diff --git a/docs/saiadmin-aot/examples/plugin/aot_probe/app/controller/ProbeController.php b/docs/saiadmin-aot/examples/plugin/aot_probe/app/controller/ProbeController.php
new file mode 100644
index 0000000..0f86358
--- /dev/null
+++ b/docs/saiadmin-aot/examples/plugin/aot_probe/app/controller/ProbeController.php
@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace plugin\aot_probe\app\controller;
+
+use support\Request;
+use support\Response;
+
+final class ProbeController
+{
+    public function index(Request $request): Response
+    {
+        return json(['code' => 200, 'data' => ['aot' => true]]);
+    }
+}
diff --git a/docs/saiadmin-aot/examples/plugin/aot_probe/config/route.php b/docs/saiadmin-aot/examples/plugin/aot_probe/config/route.php
new file mode 100644
index 0000000..0e98eb3
--- /dev/null
+++ b/docs/saiadmin-aot/examples/plugin/aot_probe/config/route.php
@@ -0,0 +1,8 @@
+<?php
+
+declare(strict_types=1);
+
+use plugin\aot_probe\app\controller\ProbeController;
+use Webman\Route;
+
+Route::get('/aot-probe', [ProbeController::class, 'index']);
diff --git a/docs/saiadmin-aot/scripts/accept-linux.sh b/docs/saiadmin-aot/scripts/accept-linux.sh
new file mode 100755
index 0000000..eb1dca9
--- /dev/null
+++ b/docs/saiadmin-aot/scripts/accept-linux.sh
@@ -0,0 +1,135 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ ${AOT_ACCEPT_ISOLATED:-} != YES ]]; then
+  echo "Refusing to start: set AOT_ACCEPT_ISOLATED=YES only for an isolated test environment." >&2
+  exit 64
+fi
+
+dist_dir=${AOT_DIST:-}
+base_url=${AOT_BASE_URL:-}
+captcha_path=${AOT_CAPTCHA_PATH:-}
+login_path=${AOT_LOGIN_PATH:-}
+login_body_file=${AOT_LOGIN_BODY_FILE:-}
+login_status=${AOT_LOGIN_EXPECT_STATUS:-200}
+token_path=${AOT_TOKEN_PATH:-data.access_token}
+user_info_path=${AOT_USER_INFO_PATH:-}
+user_info_status=${AOT_USER_INFO_EXPECT_STATUS:-200}
+denied_path=${AOT_DENIED_PATH:-}
+denied_status=${AOT_DENIED_EXPECT_STATUS:-200}
+denied_code=${AOT_DENIED_EXPECT_CODE:-400}
+
+for required_value in "$dist_dir" "$base_url" "$captcha_path" "$login_path" "$login_body_file" "$user_info_path" "$denied_path"; do
+  [[ -n "$required_value" ]] || {
+    echo "Missing required AOT acceptance environment variable." >&2
+    exit 64
+  }
+done
+
+if [[ "$dist_dir" != /* || "$login_body_file" != /* || ! -f "$login_body_file" ]]; then
+  echo "AOT_DIST and AOT_LOGIN_BODY_FILE must be valid absolute paths." >&2
+  exit 64
+fi
+
+script_dir=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)
+AOT_DIST="$dist_dir" "$script_dir/verify-package.sh"
+
+response_dir=$(mktemp -d)
+cleanup() {
+  "$dist_dir/start.sh" stop >/dev/null 2>&1 || true
+  rm -rf -- "$response_dir"
+}
+trap cleanup EXIT INT TERM
+
+(cd "$dist_dir" && ./start.sh start)
+
+ready=0
+for _ in {1..30}; do
+  if curl --fail --silent --show-error "$base_url" >/dev/null 2>&1; then
+    ready=1
+    break
+  fi
+  sleep 1
+done
+[[ $ready -eq 1 ]] || {
+  echo "Service did not become ready within 30 seconds." >&2
+  exit 70
+}
+
+actual_captcha_status=$(curl --silent --show-error --output "$response_dir/captcha.json" \
+  --write-out '%{http_code}' "$base_url$captcha_path")
+[[ "$actual_captcha_status" == 200 ]] || {
+  echo "Captcha status mismatch: expected 200, got $actual_captcha_status." >&2
+  exit 71
+}
+php -r '
+  $value = json_decode(file_get_contents($argv[1]), true, 512, JSON_THROW_ON_ERROR);
+  $uuid = $value["data"]["uuid"] ?? null;
+  $image = $value["data"]["image"] ?? null;
+  if (($value["code"] ?? null) !== 200 || !is_string($uuid) || $uuid === ""
+      || !is_string($image) || !str_starts_with($image, "data:image/")) {
+      exit(2);
+  }
+' "$response_dir/captcha.json" || {
+  echo "Captcha response contract failed." >&2
+  exit 71
+}
+
+actual_login_status=$(curl --silent --show-error --output "$response_dir/login.json" \
+  --write-out '%{http_code}' --header 'Content-Type: application/json' \
+  --data-binary "@$login_body_file" "$base_url$login_path")
+[[ "$actual_login_status" == "$login_status" ]] || {
+  echo "Login status mismatch: expected $login_status, got $actual_login_status." >&2
+  exit 71
+}
+
+token=$(php -r '
+  $value = json_decode(file_get_contents($argv[1]), true, 512, JSON_THROW_ON_ERROR);
+  foreach (explode(".", $argv[2]) as $key) {
+      if (!is_array($value) || !array_key_exists($key, $value)) {
+          exit(2);
+      }
+      $value = $value[$key];
+  }
+  if (!is_string($value) || $value === "") {
+      exit(3);
+  }
+  echo $value;
+' "$response_dir/login.json" "$token_path") || {
+  echo "Login token not found at JSON path: $token_path." >&2
+  exit 71
+}
+
+actual_user_info_status=$(curl --silent --show-error --output "$response_dir/user-info.json" \
+  --write-out '%{http_code}' --header "Authorization: Bearer $token" "$base_url$user_info_path")
+[[ "$actual_user_info_status" == "$user_info_status" ]] || {
+  echo "User-info status mismatch: expected $user_info_status, got $actual_user_info_status." >&2
+  exit 72
+}
+php -r '
+  $value = json_decode(file_get_contents($argv[1]), true, 512, JSON_THROW_ON_ERROR);
+  if (($value["code"] ?? null) !== 200 || !is_array($value["data"] ?? null)) {
+      exit(2);
+  }
+' "$response_dir/user-info.json" || {
+  echo "User-info response contract failed." >&2
+  exit 72
+}
+
+actual_denied_status=$(curl --silent --show-error --output "$response_dir/denied.json" \
+  --write-out '%{http_code}' --header "Authorization: Bearer $token" "$base_url$denied_path")
+[[ "$actual_denied_status" == "$denied_status" ]] || {
+    echo "Permission denial mismatch: expected $denied_status, got $actual_denied_status." >&2
+    exit 72
+}
+php -r '
+  $value = json_decode(file_get_contents($argv[1]), true, 512, JSON_THROW_ON_ERROR);
+  if (($value["code"] ?? null) !== (int) $argv[2]) {
+      exit(2);
+  }
+' "$response_dir/denied.json" "$denied_code" || {
+  echo "Permission denial JSON code mismatch: expected $denied_code." >&2
+  exit 72
+}
+
+echo "Isolated captcha, login, user-info, and permission-denial acceptance passed."
diff --git a/docs/saiadmin-aot/scripts/verify-package.sh b/docs/saiadmin-aot/scripts/verify-package.sh
new file mode 100755
index 0000000..731c46c
--- /dev/null
+++ b/docs/saiadmin-aot/scripts/verify-package.sh
@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+dist_dir=${AOT_DIST:-}
+binary_name=${AOT_BINARY_NAME:-webman-server.bin}
+
+if [[ -z "$dist_dir" || "$dist_dir" != /* ]]; then
+  echo "AOT_DIST must be an absolute portable-dir path." >&2
+  exit 64
+fi
+
+required=("$binary_name" webman-server start.sh libphp.so libphpx.so php.ini build-manifest.json)
+for relative_path in "${required[@]}"; do
+  [[ -e "$dist_dir/$relative_path" ]] || {
+    echo "Missing required artifact: $relative_path" >&2
+    exit 65
+  }
+done
+
+if [[ ! -d "$dist_dir/ext" || ! -d "$dist_dir/lib" || ! -d "$dist_dir/runtime" ]]; then
+  echo "Missing ext/, lib/, or runtime/ directory." >&2
+  exit 65
+fi
+
+file "$dist_dir/$binary_name" | grep -Eq 'ELF 64-bit.*x86-64' || {
+  echo "Native binary is not Linux amd64 ELF." >&2
+  exit 66
+}
+
+php -r '
+  $manifest = json_decode(file_get_contents($argv[1]), true, 512, JSON_THROW_ON_ERROR);
+  foreach (["output_name", "builder_image", "built_at"] as $key) {
+      if (!isset($manifest[$key]) || $manifest[$key] === "") {
+          throw new RuntimeException("Missing manifest key: ".$key);
+      }
+  }
+  if (!isset($manifest["runtime_resources"]) || !is_array($manifest["runtime_resources"])) {
+      throw new RuntimeException("Missing manifest runtime_resources.");
+  }
+  $dist = $argv[2];
+  if (($manifest["profile"] ?? null) === "saiadmin") {
+      $coverageFile = $dist."/source-coverage.json";
+      if (!is_file($coverageFile)) {
+          throw new RuntimeException("Missing SaiAdmin source coverage manifest.");
+      }
+      $coverage = json_decode(file_get_contents($coverageFile), true, 512, JSON_THROW_ON_ERROR);
+      if (($coverage["profile"] ?? null) !== "saiadmin" || !is_array($coverage["files"] ?? null)) {
+          throw new RuntimeException("Invalid SaiAdmin source coverage manifest.");
+      }
+      $counts = $coverage["counts"] ?? [];
+      if (($counts["compiled"] ?? -1) + ($counts["generated"] ?? -1) !== count($coverage["files"])) {
+          throw new RuntimeException("SaiAdmin source coverage counts do not match its file list.");
+      }
+      if (($manifest["inputs"]["source_coverage_hash"] ?? "") !== sha1_file($coverageFile)) {
+          throw new RuntimeException("SaiAdmin source coverage hash mismatch.");
+      }
+      foreach ($coverage["files"] as $file) {
+          if (!is_array($file) || !in_array($file["mode"] ?? null, ["compiled", "generated"], true)) {
+              throw new RuntimeException("Invalid SaiAdmin source coverage entry.");
+          }
+          $path = $file["path"] ?? "";
+          if (!is_string($path) || $path === "" || str_starts_with($path, "/") || str_contains($path, "..")) {
+              throw new RuntimeException("Unsafe SaiAdmin business source path.");
+          }
+          if (file_exists($dist."/".$path)) {
+              throw new RuntimeException("Business PHP leaked into portable-dir: ".$path);
+          }
+      }
+  }
+  foreach ($manifest["runtime_resources"] as $resource) {
+      if (!is_string($resource) || $resource === "" || str_starts_with($resource, "/") || str_contains($resource, "..")) {
+          throw new RuntimeException("Unsafe runtime resource path.");
+      }
+      if (!file_exists($dist."/".$resource)) {
+          throw new RuntimeException("Missing runtime resource: ".$resource);
+      }
+  }
+' "$dist_dir/build-manifest.json" "$dist_dir"
+
+echo "Portable-dir contract OK: $dist_dir"
diff --git a/src/Commands/DoctorCommand.php b/src/Commands/DoctorCommand.php
index 70de777..3c424f4 100644
--- a/src/Commands/DoctorCommand.php
+++ b/src/Commands/DoctorCommand.php
@@ -11,9 +11,12 @@
 
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Output\OutputInterface;
 use Symfony\Component\Process\Process;
+use Tinywan\Typephp\Compiler\NativeToolchain;
 
+// @mago-ignore lint:cyclomatic-complexity -- Docker and native diagnostics are independent explicit checks.
 class DoctorCommand extends Command
 {
     protected static $defaultName = 'typephp:doctor';
@@ -21,13 +24,27 @@ class DoctorCommand extends Command
 
     protected function configure(): void
     {
-        $this->setName('typephp:doctor')->setDescription('Check local system environment for TypePHP compilation');
+        $this
+            ->setName('typephp:doctor')
+            ->setDescription('Check local system environment for TypePHP compilation')
+            ->addOption(
+                'target',
+                null,
+                InputOption::VALUE_REQUIRED,
+                'Toolchain to check: docker, native, or all',
+                'docker',
+            );
     }
 
     protected function execute(InputInterface $input, OutputInterface $output): int
     {
         $output->writeln('<info>=== TypePHP Environment Diagnostic Tool ===</info>');
         $allPassed = true;
+        $target = (string) $input->getOption('target');
+        if (!in_array($target, ['docker', 'native', 'all'], true)) {
+            $output->writeln("<error>[FAIL] Unknown doctor target: {$target}</error>");
+            return Command::FAILURE;
+        }
 
         // 1. PHP Version
         $phpVer = PHP_VERSION;
@@ -39,29 +56,54 @@ protected function execute(InputInterface $input, OutputInterface $output): int
             $allPassed = false;
         }
 
-        // 2. Docker Check (必须可用)
-        $dockerProcess = new Process(['docker', '--version']);
-        $dockerProcess->run();
-        if ($dockerProcess->isSuccessful()) {
-            $output->writeln(
-                '• Docker: ' . trim($dockerProcess->getOutput()) . ' <info>[OK - Required for Phase 1]</info>',
-            );
-        } else {
-            $output->writeln(
-                '• Docker: Not found or not running <error>[FAIL - Docker is required for portable-dir build]</error>',
-            );
-            $allPassed = false;
+        if ($target === 'docker' || $target === 'all') {
+            $dockerProcess = new Process(['docker', '--version']);
+            $dockerProcess->run();
+            if ($dockerProcess->isSuccessful()) {
+                $output->writeln(
+                    '• Docker: ' . trim($dockerProcess->getOutput()) . ' <info>[OK - Required for portable-dir]</info>',
+                );
+            } else {
+                $output->writeln(
+                    '• Docker: Not found or not running <error>[FAIL - Required for portable-dir build]</error>',
+                );
+                $allPassed = false;
+            }
         }
 
-        // 3. Clang (宿主机非必需提示)
-        $clangProcess = new Process(['clang', '--version']);
-        $clangProcess->run();
-        if ($clangProcess->isSuccessful()) {
-            $output->writeln(
-                '• Host Clang Compiler: Installed <comment>[Optional - Containerized build bypasses host compiler]</comment>',
-            );
-        } else {
-            $output->writeln('• Host Clang Compiler: Not installed <info>[OK - Handled inside Docker builder]</info>');
+        if ($target === 'native' || $target === 'all') {
+            $pluginConfig = require dirname(__DIR__) . '/config/plugin/tinywan/typephp/app.php';
+            $nativeConfig = is_array($pluginConfig) && is_array($pluginConfig['native'] ?? null)
+                ? $pluginConfig['native']
+                : [];
+            if (function_exists('config')) {
+                $configured = config('plugin.tinywan.typephp.app.native', []);
+                if (is_array($configured)) {
+                    $nativeConfig = array_replace($nativeConfig, $configured);
+                }
+            }
+            try {
+                $toolchain = new NativeToolchain()->resolve($nativeConfig);
+                $output->writeln("• Native PHP embed: {$toolchain['php_version']} <info>[OK]</info>");
+                $output->writeln("• TypePHP: {$toolchain['tpc_version']} <info>[OK]</info>");
+                $output->writeln('• PHPX runtime: ' . $toolchain['phpx_home'] . ' <info>[OK]</info>');
+                $output->writeln('• C++ compiler: ' . $toolchain['cxx'] . ' <info>[OK]</info>');
+            } catch (\RuntimeException $exception) {
+                $output->writeln('<error>• Native toolchain: [FAIL] ' . $exception->getMessage() . '</error>');
+                $allPassed = false;
+            }
+        } elseif ($target === 'docker') {
+            $clangProcess = new Process(['clang', '--version']);
+            $clangProcess->run();
+            if ($clangProcess->isSuccessful()) {
+                $output->writeln(
+                    '• Host Clang Compiler: Installed <comment>[Optional - Docker build bypasses host compiler]</comment>',
+                );
+            } else {
+                $output->writeln(
+                    '• Host Clang Compiler: Not installed <info>[OK - Handled inside Docker builder]</info>',
+                );
+            }
         }
 
         return $allPassed ? Command::SUCCESS : Command::FAILURE;
diff --git a/src/Commands/NativeCompileCommand.php b/src/Commands/NativeCompileCommand.php
new file mode 100644
index 0000000..89b0c82
--- /dev/null
+++ b/src/Commands/NativeCompileCommand.php
@@ -0,0 +1,269 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tinywan\Typephp\Commands;
+
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Process\Process;
+use Tinywan\Typephp\Compiler\NativeCompilerOverlay;
+use Tinywan\Typephp\Compiler\NativeToolchain;
+use Tinywan\Typephp\Compiler\ProjectGenerator;
+
+// @mago-ignore lint:cyclomatic-complexity -- The command coordinates validation, AOT preparation, and native compilation.
+// @mago-ignore lint:kan-defect -- Each failure branch reports the exact native build gate that failed.
+final class NativeCompileCommand extends Command
+{
+    protected static $defaultName = 'typephp:compile';
+    protected static $defaultDescription = 'Compile Webman for the current host using a local TypePHP toolchain.';
+
+    protected function configure(): void
+    {
+        $this
+            ->setName('typephp:compile')
+            ->setDescription('Compile Webman for the current host without Docker')
+            ->addOption('profile', null, InputOption::VALUE_REQUIRED, 'Compatibility profile (supported: saiadmin)')
+            ->addOption('output-name', null, InputOption::VALUE_REQUIRED, 'Native executable name', 'webman-server')
+            ->addOption('tpc', null, InputOption::VALUE_REQUIRED, 'Path to tpc or tpc.php')
+            ->addOption('php', null, InputOption::VALUE_REQUIRED, 'PHP executable matching the embed SDK')
+            ->addOption('php-home', null, InputOption::VALUE_REQUIRED, 'PHP embed SDK prefix')
+            ->addOption('phpx-home', null, InputOption::VALUE_REQUIRED, 'Built PHPX prefix or checkout')
+            ->addOption('cxx', null, InputOption::VALUE_REQUIRED, 'C++ compiler executable')
+            ->addOption(
+                'build-dir',
+                null,
+                InputOption::VALUE_REQUIRED,
+                'Project-relative compiler cache',
+                '.typephp/native-cache',
+            )
+            ->addOption('force', 'f', InputOption::VALUE_NONE, 'Force a clean TypePHP rebuild')
+            ->addOption('refresh-main', null, InputOption::VALUE_NONE, 'Refresh main.php from the packaged stub');
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        $outputName = (string) $input->getOption('output-name');
+        $buildDir = trim((string) $input->getOption('build-dir'), '/\\');
+        if (!preg_match('/^[A-Za-z0-9._-]+$/', $outputName)) {
+            $output->writeln("<error>[ERROR] Invalid output-name: '{$outputName}'.</error>");
+            return Command::FAILURE;
+        }
+        if (!$this->isSafeRelativePath($buildDir)) {
+            $output->writeln("<error>[ERROR] Invalid build-dir: '{$buildDir}'.</error>");
+            return Command::FAILURE;
+        }
+
+        $pluginConfig = $this->pluginConfig();
+        $jobs = $pluginConfig['build']['jobs'] ?? 4;
+        if (!is_int($jobs) || $jobs < 1 || $jobs > 4) {
+            $output->writeln('<error>[ERROR] build.jobs must be an integer between 1 and 4.</error>');
+            return Command::FAILURE;
+        }
+        $nativeConfig = is_array($pluginConfig['native'] ?? null) ? $pluginConfig['native'] : [];
+        foreach (['tpc', 'php', 'php_home', 'phpx_home', 'cxx'] as $key) {
+            $option = str_replace('_', '-', $key);
+            $value = $input->getOption($option);
+            if (is_string($value) && $value !== '') {
+                $nativeConfig[$key] = $value;
+            }
+        }
+
+        try {
+            $toolchain = new NativeToolchain()->resolve($nativeConfig);
+        } catch (\RuntimeException $exception) {
+            $output->writeln('<error>[ERROR] Native toolchain check failed: ' . $exception->getMessage() . '</error>');
+            $output->writeln('<comment>Run: php webman typephp:doctor --target=native</comment>');
+            return Command::FAILURE;
+        }
+
+        $basePath = (string) (function_exists('base_path') ? base_path() : getcwd());
+        $profile = $input->getOption('profile');
+        $profileName = is_string($profile) && $profile !== '' ? $profile : null;
+        $generator = new ProjectGenerator($basePath);
+        $skipGuardedSources = [];
+        $nativeIgnores = [];
+        if (version_compare($toolchain['php_version'], '8.5', '>=')) {
+            foreach (array_keys(ProjectGenerator::GUARDED_SOURCES) as $source) {
+                if (str_starts_with($source, 'vendor/symfony/polyfill-php85/')) {
+                    $skipGuardedSources[] = $source;
+                }
+            }
+            $nativeIgnores[] = 'vendor/symfony/polyfill-php85';
+        }
+        if ($toolchain['intl_loaded'] === '1') {
+            $skipGuardedSources = [
+                ...$skipGuardedSources,
+                'vendor/symfony/polyfill-intl-grapheme/bootstrap80.php',
+                'vendor/symfony/polyfill-intl-idn/bootstrap80.php',
+                'vendor/symfony/polyfill-intl-normalizer/bootstrap80.php',
+            ];
+            $nativeIgnores = [
+                ...$nativeIgnores,
+                'vendor/symfony/polyfill-intl-grapheme',
+                'vendor/symfony/polyfill-intl-idn',
+                'vendor/symfony/polyfill-intl-normalizer',
+            ];
+        }
+
+        try {
+            $configuredIgnores = is_array($pluginConfig['ignore'] ?? null) ? $pluginConfig['ignore'] : [];
+            $generator->generateMain(null, (bool) $input->getOption('refresh-main'));
+            $projectFile = $generator->generateProjectYml(array_replace_recursive($pluginConfig, [
+                'profile' => $profileName,
+                'ignore' => array_values(array_unique([...$configuredIgnores, ...$nativeIgnores])),
+                'build' => [
+                    'output_name' => $outputName,
+                    'jobs' => $jobs,
+                    'skip_guarded_sources' => array_values(array_unique($skipGuardedSources)),
+                ],
+            ]), 'project.native.yml');
+        } catch (\RuntimeException $exception) {
+            $output->writeln('<error>[ERROR] ' . $exception->getMessage() . '</error>');
+            return Command::FAILURE;
+        }
+
+        $absoluteBuildDir = $basePath . DIRECTORY_SEPARATOR . str_replace('/', DIRECTORY_SEPARATOR, $buildDir);
+        $outputDirectory = $basePath . DIRECTORY_SEPARATOR . 'build';
+        if (
+            !is_dir($absoluteBuildDir) && !mkdir($absoluteBuildDir, 0777, true) && !is_dir($absoluteBuildDir)
+            || !is_dir($outputDirectory) && !mkdir($outputDirectory, 0777, true) && !is_dir($outputDirectory)
+        ) {
+            $output->writeln('<error>[ERROR] Unable to create native build directories.</error>');
+            return Command::FAILURE;
+        }
+
+        try {
+            $compilerEntry = $profileName === 'saiadmin'
+                ? new NativeCompilerOverlay()->prepare($toolchain, $basePath . '/.typephp/native-compiler')
+                : $toolchain['tpc'];
+        } catch (\RuntimeException $exception) {
+            $output->writeln('<error>[ERROR] Native compiler overlay failed: ' . $exception->getMessage() . '</error>');
+            return Command::FAILURE;
+        }
+        $compilerToolchain = $toolchain;
+        $compilerToolchain['tpc'] = $compilerEntry;
+        $command = new NativeToolchain()->command($compilerToolchain);
+        $command = [
+            ...$command,
+            $projectFile,
+            '--php-version',
+            $toolchain['php_version'],
+            '--compiler',
+            $toolchain['cxx'],
+            '--build-dir',
+            $absoluteBuildDir,
+            '--no-progress',
+        ];
+        if ((bool) $input->getOption('force')) {
+            $command[] = '--force';
+        }
+
+        $output->writeln('<info>[TypePHP] Native toolchain ready (Docker will not be used).</info>');
+        $output->writeln(
+            "<comment>PHP {$toolchain['php_version']} | TypePHP {$toolchain['tpc_version']} | "
+            . basename($toolchain['cxx'])
+            . '</comment>',
+        );
+        $process = new Process(
+            $command,
+            $basePath,
+            [
+                'PHP_HOME' => $toolchain['php_home'],
+                'PHPX_HOME' => $toolchain['phpx_home'],
+            ],
+            null,
+            1800,
+        );
+        $process->run(static function (string $type, string $buffer) use ($output): void {
+            $output->write($buffer);
+        });
+        if (!$process->isSuccessful()) {
+            $exitCode = $process->getExitCode();
+            $output->writeln(
+                '<error>[ERROR] Native TypePHP build failed with exit code '
+                . ($exitCode === null ? 'unknown' : (string) $exitCode)
+                . '</error>',
+            );
+            return Command::FAILURE;
+        }
+
+        $compiled = $this->findCompiledExecutable($outputDirectory, $outputName);
+        if ($compiled === null) {
+            $output->writeln("<error>[ERROR] Compiled executable build/{$outputName} was not found.</error>");
+            return Command::FAILURE;
+        }
+        $this->writeManifest($basePath, $compiled, $profileName, $toolchain);
+        $relative = ltrim(str_replace($basePath, '', $compiled), DIRECTORY_SEPARATOR);
+        $output->writeln("<info>Successfully built native executable: {$relative}</info>");
+        $output->writeln("<info>Run command: ./{$relative} start</info>");
+        return Command::SUCCESS;
+    }
+
+    /**
+     * @return array<array-key, mixed>
+     */
+    private function pluginConfig(): array
+    {
+        $defaults = require dirname(__DIR__) . '/config/plugin/tinywan/typephp/app.php';
+        if (!is_array($defaults) || !function_exists('config')) {
+            return is_array($defaults) ? $defaults : [];
+        }
+        $configured = config('plugin.tinywan.typephp.app', []);
+        if (!is_array($configured)) {
+            return $defaults;
+        }
+        $merged = array_replace_recursive($defaults, $configured);
+        foreach (['ignore', 'runtime_resources'] as $key) {
+            if (is_array($defaults[$key] ?? null) && is_array($configured[$key] ?? null)) {
+                $merged[$key] = array_values(array_unique(array_merge($defaults[$key], $configured[$key])));
+            }
+        }
+        return $merged;
+    }
+
+    private function isSafeRelativePath(string $path): bool
+    {
+        return (
+            $path !== ''
+            && !str_starts_with($path, '/')
+            && !preg_match('/^[A-Za-z]:[\\\\\\/]/', $path)
+            && !in_array('..', preg_split('#[\\\\/]#', $path) ?: [], true)
+        );
+    }
+
+    private function findCompiledExecutable(string $outputDirectory, string $outputName): ?string
+    {
+        foreach ([$outputName, str_replace('-', '_', $outputName)] as $name) {
+            $candidate = $outputDirectory . DIRECTORY_SEPARATOR . $name;
+            if (is_file($candidate) && is_executable($candidate)) {
+                return $candidate;
+            }
+        }
+        return null;
+    }
+
+    /**
+     * @param array<string, string> $toolchain
+     */
+    private function writeManifest(string $basePath, string $compiled, ?string $profile, array $toolchain): void
+    {
+        $manifest = [
+            'target' => strtolower(PHP_OS_FAMILY) . '-' . php_uname('m') . '-native',
+            'mode' => 'native',
+            'profile' => $profile,
+            'php_version' => $toolchain['php_version'],
+            'typephp_version' => $toolchain['tpc_version'],
+            'cxx' => basename($toolchain['cxx']),
+            'output' => ltrim(str_replace($basePath, '', $compiled), DIRECTORY_SEPARATOR),
+            'output_sha256' => (string) hash_file('sha256', $compiled),
+            'built_at' => gmdate('Y-m-d\TH:i:s\Z'),
+        ];
+        file_put_contents(
+            $basePath . '/.typephp/build/native-build-manifest.json',
+            json_encode($manifest, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) . "\n",
+        );
+    }
+}
diff --git a/src/Commands/PackageCommand.php b/src/Commands/PackageCommand.php
index fe18465..3260151 100644
--- a/src/Commands/PackageCommand.php
+++ b/src/Commands/PackageCommand.php
@@ -30,6 +30,13 @@ protected function configure(): void
             ->setName('typephp:package')
             ->setDescription('Build Webman project into a Linux x86_64 portable-dir using TypePHP Docker builder')
             ->addOption('image', null, InputOption::VALUE_REQUIRED, 'Docker builder image reference', null)
+            ->addOption(
+                'profile',
+                null,
+                InputOption::VALUE_REQUIRED,
+                'Optional compatibility profile (supported: saiadmin)',
+                null,
+            )
             ->addOption(
                 'output-dir',
                 null,
@@ -54,11 +61,16 @@ protected function configure(): void
 
     protected function execute(InputInterface $input, OutputInterface $output): int
     {
-        $pluginConfig = [];
+        $defaultPluginConfig = require dirname(__DIR__) . '/config/plugin/tinywan/typephp/app.php';
+        if (!is_array($defaultPluginConfig)) {
+            $output->writeln('<error>[ERROR] The packaged TypePHP configuration is invalid.</error>');
+            return Command::FAILURE;
+        }
+        $pluginConfig = $defaultPluginConfig;
         if (function_exists('config')) {
             $configuredPluginConfig = config('plugin.tinywan.typephp.app', []);
             if (is_array($configuredPluginConfig)) {
-                $pluginConfig = $configuredPluginConfig;
+                $pluginConfig = $this->mergePluginConfig($defaultPluginConfig, $configuredPluginConfig);
             }
         }
 
@@ -67,6 +79,13 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         $outputDir = trim((string) $input->getOption('output-dir'), '/\\');
         $outputName = (string) $input->getOption('output-name');
         $force = (bool) $input->getOption('force');
+        $profile = $input->getOption('profile');
+        $jobs = $pluginConfig['build']['jobs'] ?? 4;
+
+        if (!is_int($jobs) || $jobs < 1 || $jobs > 4) {
+            $output->writeln('<error>[ERROR] build.jobs must be an integer between 1 and 4.</error>');
+            return Command::FAILURE;
+        }
 
         // 1. 严格参数校验，防止任何路径穿越或格式错误
         if (!preg_match('/^[A-Za-z0-9._-]+$/', $outputName)) {
@@ -107,7 +126,14 @@ protected function execute(InputInterface $input, OutputInterface $output): int
             return Command::FAILURE;
         }
 
-        // 3. 检查 Docker 环境
+        // 3. 执行与 doctor 相同的强制环境门禁；不允许用源码改写掩盖宿主环境问题。
+        if (version_compare(PHP_VERSION, '8.4', '<') || version_compare(PHP_VERSION, '8.6', '>=')) {
+            $output->writeln(
+                '<error>[ERROR] Environment check failed: PHP >= 8.4 and < 8.6 is required. Run typephp:doctor.</error>',
+            );
+            return Command::FAILURE;
+        }
+
         $dockerCheck = new Process(['docker', '--version']);
         $dockerCheck->run();
         if (!$dockerCheck->isSuccessful()) {
@@ -141,6 +167,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
             // 动态合并配置并生成 project.linux.yml
             $extraConfig = [
+                'profile' => is_string($profile) && $profile !== '' ? $profile : null,
                 'build' => [
                     'output_name' => $outputName,
                 ],
@@ -158,7 +185,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         // 汇总各类 AOT 生成源的输入摘要：标签用于终端提示，同名 <label>_hashes 键写入 manifest
         $generatedSourceGroups = [
-            'flattened' => ProjectGenerator::GUARDED_SOURCES,
+            'flattened' => array_merge(ProjectGenerator::GUARDED_SOURCES, $generator->discoverProjectGuardedSources()),
             'nullable-static' => ProjectGenerator::NULLABLE_STATIC_SOURCES,
             'stray-bootstrap' => ProjectGenerator::STRAY_BOOTSTRAP_SOURCES,
             'variadic-handler' => ProjectGenerator::VARIADIC_HANDLER_SOURCES,
@@ -179,10 +206,20 @@ protected function execute(InputInterface $input, OutputInterface $output): int
             'builder_image' => $image,
             'output_name' => $outputName,
             'output_dir' => $outputDir,
+            'profile' => is_string($profile) && $profile !== '' ? $profile : null,
             'built_at' => gmdate('Y-m-d\TH:i:s\Z'),
+            'runtime_resources' => is_file($stageBuildDir . '/runtime-resources.list')
+                ? file($stageBuildDir . '/runtime-resources.list', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES)
+                : [],
             'inputs' => [
                 'main_hash' => file_exists($basePath . '/main.php') ? sha1_file($basePath . '/main.php') : '',
                 'config_hash' => sha1_file($projectYmlPath),
+                'runtime_resources_hash' => is_file($stageBuildDir . '/runtime-resources.list')
+                    ? sha1_file($stageBuildDir . '/runtime-resources.list')
+                    : '',
+                'source_coverage_hash' => is_file($stageBuildDir . '/source-coverage.json')
+                    ? sha1_file($stageBuildDir . '/source-coverage.json')
+                    : '',
                 ...$generatedHashes,
             ],
         ];
@@ -210,6 +247,8 @@ protected function execute(InputInterface $input, OutputInterface $output): int
             'TYPEPHP_OUTPUT_NAME=' . $outputName,
             '-e',
             'TYPEPHP_FORCE=' . ($force ? '1' : '0'),
+            '-e',
+            'TYPEPHP_JOBS=' . $jobs,
             $image,
         ];
 
@@ -247,6 +286,28 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         return Command::FAILURE;
     }
 
+    /**
+     * Keep newly shipped list defaults when a project's published configuration
+     * predates them, while allowing scalar and associative settings to override.
+     *
+     * @param array<string, mixed> $defaults
+     * @param array<string, mixed> $configured
+     * @return array<string, mixed>
+     */
+    private function mergePluginConfig(array $defaults, array $configured): array
+    {
+        $merged = array_replace_recursive($defaults, $configured);
+        foreach (['ignore', 'runtime_resources'] as $key) {
+            $defaultList = $defaults[$key] ?? [];
+            $configuredList = $configured[$key] ?? [];
+            if (!is_array($defaultList) || !is_array($configuredList)) {
+                continue;
+            }
+            $merged[$key] = array_values(array_unique(array_merge($defaultList, $configuredList)));
+        }
+        return $merged;
+    }
+
     /**
      * @param array<string, string> $targets 生成目标相对路径 => 哈希
      * @return array<string, string>
diff --git a/src/Compiler/DistConfigSanitizer.php b/src/Compiler/DistConfigSanitizer.php
index 5d364cc..3986004 100644
--- a/src/Compiler/DistConfigSanitizer.php
+++ b/src/Compiler/DistConfigSanitizer.php
@@ -49,9 +49,10 @@ public function sanitizeDirectory(string $configDir): array
         if (!is_dir($configDir)) {
             return $changedFiles;
         }
-        $iterator = new \RecursiveIteratorIterator(
-            new \RecursiveDirectoryIterator($configDir, \FilesystemIterator::SKIP_DOTS),
-        );
+        $iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator(
+            $configDir,
+            \FilesystemIterator::SKIP_DOTS,
+        ));
         foreach ($iterator as $fileInfo) {
             if (!$fileInfo->isFile()) {
                 continue;
@@ -158,12 +159,16 @@ private function hasNamePrefix(array $tokens, int $index): bool
             // 单字符 token：仅 '\'（T_NS_SEPARATOR）需要再往前看一级
             return $previous === '\\' && $this->isNameToken($tokens, $index - 2);
         }
-        return in_array($previous[0], [
-            T_STRING,
-            T_NAME_FULLY_QUALIFIED,
-            T_NAME_QUALIFIED,
-            T_NAME_RELATIVE,
-        ], true);
+        return in_array(
+            $previous[0],
+            [
+                T_STRING,
+                T_NAME_FULLY_QUALIFIED,
+                T_NAME_QUALIFIED,
+                T_NAME_RELATIVE,
+            ],
+            true,
+        );
     }
 
     /**
@@ -178,12 +183,16 @@ private function isNameToken(array $tokens, int $index): bool
         if (!is_array($token)) {
             return $token === '\\';
         }
-        return in_array($token[0], [
-            T_STRING,
-            T_NAME_FULLY_QUALIFIED,
-            T_NAME_QUALIFIED,
-            T_NAME_RELATIVE,
-            T_NS_SEPARATOR,
-        ], true);
+        return in_array(
+            $token[0],
+            [
+                T_STRING,
+                T_NAME_FULLY_QUALIFIED,
+                T_NAME_QUALIFIED,
+                T_NAME_RELATIVE,
+                T_NS_SEPARATOR,
+            ],
+            true,
+        );
     }
 }
diff --git a/src/Compiler/NativeCompilerOverlay.php b/src/Compiler/NativeCompilerOverlay.php
new file mode 100644
index 0000000..cc246f9
--- /dev/null
+++ b/src/Compiler/NativeCompilerOverlay.php
@@ -0,0 +1,300 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tinywan\Typephp\Compiler;
+
+/**
+ * Builds a project-local TypePHP bootstrap with bounded compiler compatibility
+ * fixes. The installed compiler is never modified.
+ */
+final class NativeCompilerOverlay
+{
+    /**
+     * @param array<string, string> $toolchain
+     */
+    public function prepare(array $toolchain, string $directory): string
+    {
+        $typephpHome = $toolchain['typephp_home'] ?? '';
+        if ($typephpHome === '' || !is_file($typephpHome . '/bin/bootstrap.php')) {
+            throw new \RuntimeException(
+                'SaiAdmin native compilation requires a source-based tpc.php installation so bounded compiler '
+                . 'compatibility overlays can be applied without modifying the installed compiler.',
+            );
+        }
+        $autoload = $this->resolveAutoload($toolchain, $typephpHome);
+        if (!is_dir($directory) && !mkdir($directory, 0o777, true) && !is_dir($directory)) {
+            throw new \RuntimeException("Unable to create native compiler overlay: {$directory}");
+        }
+
+        $nativeTrait = $this->patchNativeClassSupportTrait($this->read($typephpHome
+        . '/src/NativeClass/NativeClassSupportTrait.php'));
+        $methodTrait = $this->patchMethodCallTrait($this->read($typephpHome . '/src/Parser/MethodCallTrait.php'));
+        $typeTrait = $this->patchNativeTypeCompatibilityTrait($this->read($typephpHome
+        . '/src/TypeSystem/NativeTypeCompatibilityTrait.php'));
+        $preprocessor = $this->patchPreprocessor($this->read($typephpHome . '/src/Preprocessor.php'));
+        $nativeTarget = $directory . '/NativeClassSupportTrait.php';
+        $methodTarget = $directory . '/MethodCallTrait.php';
+        $typeTarget = $directory . '/NativeTypeCompatibilityTrait.php';
+        $preprocessorTarget = $directory . '/Preprocessor.php';
+        $runner = $directory . '/tpc.php';
+        $this->write($nativeTarget, $nativeTrait);
+        $this->write($methodTarget, $methodTrait);
+        $this->write($typeTarget, $typeTrait);
+        $this->write($preprocessorTarget, $preprocessor);
+
+        $bootstrap = var_export($typephpHome . '/bin/bootstrap.php', true);
+        $autoload = var_export($autoload, true);
+        $root = var_export($typephpHome, true);
+        $runnerSource = <<<PHP
+            <?php
+
+            declare(strict_types=1);
+
+            \$GLOBALS['_composer_autoload_path'] = {$autoload};
+            require {$bootstrap};
+            require __DIR__ . '/NativeClassSupportTrait.php';
+            require __DIR__ . '/MethodCallTrait.php';
+            require __DIR__ . '/NativeTypeCompatibilityTrait.php';
+            require __DIR__ . '/Preprocessor.php';
+            require {$root} . '/src/polyfills.php';
+            require {$root} . '/src/gen_stub.php';
+            require {$root} . '/src/compiler.php';
+
+            const TYPEPHP_PHP_SCRIPT_ENTRY = true;
+            main(\$argc, \$argv);
+            PHP;
+        $this->write($runner, $runnerSource . "\n");
+        return $runner;
+    }
+
+    /**
+     * @param array<string, string> $toolchain
+     */
+    private function resolveAutoload(array $toolchain, string $typephpHome): string
+    {
+        $tpc = $toolchain['tpc'] ?? '';
+        foreach ([dirname(dirname($tpc)) . '/autoload.php', $typephpHome . '/vendor/autoload.php'] as $candidate) {
+            if (is_file($candidate)) {
+                return $candidate;
+            }
+        }
+        throw new \RuntimeException('Unable to locate the Composer autoloader used by TypePHP.');
+    }
+
+    private function patchNativeClassSupportTrait(string $source): string
+    {
+        $before = <<<'PHP'
+            $kind = $nativeClass ? 'Native conversion method' : 'Conversion method';
+                    if ($function->argInfoList !== []) {
+                        $this->fatalError($node, "{$kind} `{$class}::{$method}()` must not accept arguments");
+                    }
+            PHP;
+        $after = <<<'PHP'
+            $kind = $nativeClass ? 'Native conversion method' : 'Conversion method';
+                    if ($function->argInfoList !== []) {
+                        if (!$nativeClass && strtolower($method) === 'toarray') {
+                            return;
+                        }
+                        $this->fatalError($node, "{$kind} `{$class}::{$method}()` must not accept arguments");
+                    }
+            PHP;
+        if (str_contains($source, $after)) {
+            return $source;
+        }
+        if (substr_count($source, $before) !== 1) {
+            throw new \RuntimeException('Unsupported TypePHP NativeClassSupportTrait structure.');
+        }
+        return str_replace($before, $after, $source);
+    }
+
+    private function patchMethodCallTrait(string $source): string
+    {
+        $nativeLookupBefore = <<<'PHP'
+                    $nativeFunc = $this->getNativeMethod($expr, $class, $method);
+                    // A Native class exists but the method was not found; this may be a dynamic call
+            PHP;
+        $nativeLookupAfter = <<<'PHP'
+                    // Do not descend into an internal parent when a compiled class
+                    // provides __call(): PHP dispatches the missing method to that magic
+                    // method. This is used by Carbon's addDays-style unit API.
+                    if ($this->hasClass($class)) {
+                        $lookupClass = $class;
+                        $hasMagicCall = false;
+                        while ($this->hasClass($lookupClass)) {
+                            $lookupDef = $this->getClass($lookupClass);
+                            if ($lookupDef->hasMethod($method)) {
+                                $hasMagicCall = false;
+                                break;
+                            }
+                            $hasMagicCall = $hasMagicCall || $lookupDef->hasMethod('__call');
+                            if ($lookupDef->extends === '' || !$this->hasClass($lookupDef->extends)) {
+                                break;
+                            }
+                            $lookupClass = $lookupDef->extends;
+                        }
+                        if ($hasMagicCall) {
+                            throw new DynamicCall();
+                        }
+                    }
+
+                    $nativeFunc = $this->getNativeMethod($expr, $class, $method);
+                    // A Native class exists but the method was not found; this may be a dynamic call
+            PHP;
+        if (!str_contains($source, "Carbon's addDays-style unit API")) {
+            if (substr_count($source, $nativeLookupBefore) !== 1) {
+                throw new \RuntimeException('Unsupported TypePHP native method lookup structure.');
+            }
+            $source = str_replace($nativeLookupBefore, $nativeLookupAfter, $source);
+        }
+
+        $before = <<<'PHP'
+            if (!isset(self::KEYWORD_METHOD_WITH_ARGUMENTS[$methodName]) && $expr->args !== []) {
+                                $this->fatalError($expr, "The {$methodName} method does not accept parameters");
+                            }
+                            if ($methodName === 'toObject') {
+                                return $this->genToObjectCall($expr, $object);
+                            }
+                            if ($methodName === 'toRef') {
+                                return $this->genToRefCall($expr);
+                            }
+                            $receiverClass = $class;
+                            if ($receiverClass === '' && !$this->isVarExpr($expr->var)) {
+                                $receiverClass = $this->detectClassOfExpr($expr->var);
+                            }
+                            // A declared conversion method is called directly. Otherwise
+                            // php::toArray() applies the PHP-compatible object-property
+                            // fallback (and invokes a real toArray() method when present).
+                            $useDeclaredToArray = $methodName === 'toArray'
+                                && $receiverClass !== ''
+                                && $this->objectTypeDeclaresMethod($receiverClass, $methodName);
+                            if (!$useDeclaredToArray) {
+                                return $this->genToConvertCall($object, $methodName, $receiverType);
+                            }
+            PHP;
+        $after = <<<'PHP'
+            $receiverClass = $class;
+                            if ($receiverClass === '' && !$this->isVarExpr($expr->var)) {
+                                $receiverClass = $this->detectClassOfExpr($expr->var);
+                            }
+                            // A declared toArray(...) API is an ordinary PHP method, not
+                            // the argument-free TypePHP conversion keyword.
+                            $useDeclaredToArray = $methodName === 'toArray'
+                                && $receiverClass !== ''
+                                && $this->objectTypeDeclaresMethod($receiverClass, $methodName);
+                            $useDynamicToArray = $methodName === 'toArray'
+                                && ($receiverClass === ''
+                                    || $receiverType === Type::VAR
+                                    || $this->objectTypeDeclaresMethod($receiverClass, '__call'));
+                            $useObjectToArray = $useDeclaredToArray || $useDynamicToArray;
+                            if (!isset(self::KEYWORD_METHOD_WITH_ARGUMENTS[$methodName])
+                                && $expr->args !== []
+                                && !$useObjectToArray
+                            ) {
+                                $this->fatalError($expr, "The {$methodName} method does not accept parameters");
+                            }
+                            if ($methodName === 'toObject') {
+                                return $this->genToObjectCall($expr, $object);
+                            }
+                            if ($methodName === 'toRef') {
+                                return $this->genToRefCall($expr);
+                            }
+                            if (!$useObjectToArray) {
+                                return $this->genToConvertCall($object, $methodName, $receiverType);
+                            }
+            PHP;
+        if (!str_contains($source, '$useDynamicToArray =')) {
+            if (substr_count($source, $before) !== 1) {
+                throw new \RuntimeException('Unsupported TypePHP MethodCallTrait structure.');
+            }
+            $source = str_replace($before, $after, $source);
+        }
+
+        $lateStaticMarker = '// SaiAdmin overlay: preserve dynamic late-static dispatch.';
+        if (
+            str_contains($source, 'private function parseExactLateStaticCall(')
+            && !str_contains($source, $lateStaticMarker)
+        ) {
+            $needle = <<<'PHP'
+                    ): ?string {
+                        if ($expr->args !== [] || !$this->classDef || !$this->methodDef) {
+                PHP;
+            $replacement = <<<'PHP'
+                    ): ?string {
+                        // SaiAdmin overlay: preserve dynamic late-static dispatch.
+                        return null;
+
+                        if ($expr->args !== [] || !$this->classDef || !$this->methodDef) {
+                PHP;
+            if (substr_count($source, $needle) !== 1) {
+                throw new \RuntimeException('Unsupported TypePHP late-static optimization structure.');
+            }
+            $source = str_replace($needle, $replacement, $source);
+        }
+        return $source;
+    }
+
+    private function patchNativeTypeCompatibilityTrait(string $source): string
+    {
+        $before = 'return $internal && is_subclass_of($class, $expected);';
+        $after = 'return $internal && (strcasecmp($class, $expected) === 0 || is_subclass_of($class, $expected));';
+        if (str_contains($source, $after)) {
+            return $source;
+        }
+        if (substr_count($source, $before) !== 1) {
+            throw new \RuntimeException('Unsupported TypePHP native inheritance structure.');
+        }
+        return str_replace($before, $after, $source);
+    }
+
+    private function patchPreprocessor(string $source): string
+    {
+        $before = <<<'PHP'
+                        if (!$this->isInternalFunction($funcName)) {
+                            $this->symbolCallInFile[$this->file][] = $this->getFunctionDependencySymbol($funcName);
+                        }
+            PHP;
+        $after = <<<'PHP'
+                        if (!$this->isInternalFunction($funcName)) {
+                            $this->symbolCallInFile[$this->file][] = $this->getFunctionDependencySymbol($funcName);
+                        }
+                        // PHP resolves an unqualified function in the current namespace
+                        // before falling back to the global function. The converter uses
+                        // that fallback when it finds a compiled global helper, so its
+                        // declaration header must be part of the same dependency set.
+                        $sourceName = $node->name->toString();
+                        $unqualified = !str_contains($sourceName, '\\');
+                        $imported = $unqualified && isset($this->useFunctions[strtolower($sourceName)]);
+                        if ($this->namespace !== ''
+                            && !$node->name instanceof Node\Name\FullyQualified
+                            && $unqualified
+                            && !$imported
+                        ) {
+                            $this->symbolCallInFile[$this->file][] = $this->getFunctionDependencySymbol($sourceName);
+                        }
+            PHP;
+        if (str_contains($source, 'The converter uses' . PHP_EOL . '            // that fallback')) {
+            return $source;
+        }
+        if (substr_count($source, $before) !== 1) {
+            throw new \RuntimeException('Unsupported TypePHP Preprocessor function dependency structure.');
+        }
+        return str_replace($before, $after, $source);
+    }
+
+    private function read(string $path): string
+    {
+        $content = file_get_contents($path);
+        if ($content === false) {
+            throw new \RuntimeException("Unable to read TypePHP compiler source: {$path}");
+        }
+        return $content;
+    }
+
+    private function write(string $path, string $content): void
+    {
+        if (file_put_contents($path, $content) === false) {
+            throw new \RuntimeException("Unable to write native compiler overlay: {$path}");
+        }
+    }
+}
diff --git a/src/Compiler/NativeToolchain.php b/src/Compiler/NativeToolchain.php
new file mode 100644
index 0000000..a1a5047
--- /dev/null
+++ b/src/Compiler/NativeToolchain.php
@@ -0,0 +1,273 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tinywan\Typephp\Compiler;
+
+use Symfony\Component\Process\ExecutableFinder;
+use Symfony\Component\Process\Process;
+
+// @mago-ignore lint:cyclomatic-complexity -- Toolchain discovery validates several independent host fallbacks.
+// @mago-ignore lint:kan-defect -- Fail-closed ABI and path checks intentionally keep each fallback explicit.
+// @mago-ignore lint:too-many-methods -- Each small resolver owns one native toolchain prerequisite.
+final class NativeToolchain
+{
+    /**
+     * @param array<array-key, mixed> $config
+     * @return array{php:string,php_home:string,phpx_home:string,tpc:string,typephp_home:string,cxx:string,php_version:string,tpc_version:string,intl_loaded:string}
+     */
+    public function resolve(array $config = []): array
+    {
+        $phpHome = $this->resolvePhpHome($config);
+        $php = $this->resolveExecutable(
+            $config['php'] ?? null,
+            [
+                $phpHome . '/bin/php',
+                PHP_BINARY,
+            ],
+            'PHP executable',
+        );
+        $phpVersion = $this->capture([$php, '-r', 'echo PHP_MAJOR_VERSION.".".PHP_MINOR_VERSION;']);
+        $intlLoaded = $this->capture([$php, '-r', 'echo extension_loaded("intl") ? "1" : "0";']);
+        if (!in_array($phpVersion, ['8.4', '8.5'], true)) {
+            throw new \RuntimeException("Native TypePHP requires PHP 8.4 or 8.5; {$php} reports {$phpVersion}.");
+        }
+
+        $phpConfig = $phpHome . '/bin/php-config';
+        if (!is_executable($phpConfig)) {
+            throw new \RuntimeException("PHP_HOME does not provide bin/php-config: {$phpHome}");
+        }
+        $configuredVersion = $this->capture([$phpConfig, '--version']);
+        if (!str_starts_with($configuredVersion, $phpVersion . '.')) {
+            throw new \RuntimeException(
+                "PHP ABI mismatch: {$php} reports {$phpVersion}, but {$phpConfig} reports {$configuredVersion}.",
+            );
+        }
+        $this->assertPhpEmbed($phpHome);
+
+        $tpc = $this->resolveTpc($config);
+        $typephpHome = $this->resolveTypephpHome($tpc);
+        $phpxHome = $this->resolvePhpxHome($config, $tpc);
+        $this->assertPhpxLibrary($phpxHome);
+        $cxx = $this->resolveCxx($config);
+
+        $versionCommand = str_ends_with($tpc, '.php') ? [$php, $tpc, '--version'] : [$tpc, '--version'];
+        $tpcVersion = $this->capture($versionCommand, [
+            'PHP_HOME' => $phpHome,
+            'PHPX_HOME' => $phpxHome,
+        ]);
+        $match = [];
+        if (!preg_match('/TypePHP Compiler \(AOT\) v(\d+\.\d+\.\d+)/', $tpcVersion, $match)) {
+            throw new \RuntimeException("Unable to determine TypePHP version from: {$tpc}");
+        }
+
+        return [
+            'php' => $php,
+            'php_home' => $phpHome,
+            'phpx_home' => $phpxHome,
+            'tpc' => $tpc,
+            'typephp_home' => $typephpHome,
+            'cxx' => $cxx,
+            'php_version' => $phpVersion,
+            'tpc_version' => $match[1],
+            'intl_loaded' => $intlLoaded,
+        ];
+    }
+
+    /**
+     * @param array<string, string> $toolchain
+     * @return list<string>
+     */
+    public function command(array $toolchain): array
+    {
+        return str_ends_with($toolchain['tpc'], '.php') ? [$toolchain['php'], $toolchain['tpc']] : [$toolchain['tpc']];
+    }
+
+    /**
+     * @param array<array-key, mixed> $config
+     */
+    private function resolvePhpHome(array $config): string
+    {
+        $configured = $this->stringValue($config['php_home'] ?? null) ?? $this->stringValue(getenv('PHP_HOME'));
+        $candidates = array_filter([
+            $configured,
+            PHP_OS_FAMILY === 'Darwin' ? '/opt/homebrew/opt/php-zts' : null,
+            PHP_OS_FAMILY === 'Darwin' ? '/usr/local/opt/php-zts' : null,
+            dirname(dirname((string) (realpath(PHP_BINARY) ?: PHP_BINARY))),
+        ]);
+        foreach ($candidates as $candidate) {
+            $path = (string) (realpath($candidate) ?: $candidate);
+            if (is_dir($path) && is_executable($path . '/bin/php-config') && $this->hasPhpEmbed($path)) {
+                return rtrim($path, '/\\');
+            }
+        }
+        throw new \RuntimeException(
+            'Native PHP embed SDK was not found. Set native.php_home or PHP_HOME to a PHP 8.4/8.5 '
+            . 'installation containing bin/php-config, sapi/embed/php_embed.h, and libphp.',
+        );
+    }
+
+    /**
+     * @param array<array-key, mixed> $config
+     */
+    private function resolveTpc(array $config): string
+    {
+        $configured = $this->stringValue($config['tpc'] ?? null) ?? $this->stringValue(getenv('TYPEPHP_TPC'));
+        $home = $this->stringValue(getenv('HOME'));
+        $cwd = getcwd();
+        $cwd = $cwd === false ? '.' : $cwd;
+        $candidates = array_filter([
+            $configured,
+            $cwd . '/vendor/bin/tpc.php',
+            $home === null ? null : $home . '/.composer/vendor/bin/tpc.php',
+            $home === null ? null : $home . '/.config/composer/vendor/bin/tpc.php',
+            new ExecutableFinder()->find('tpc'),
+            new ExecutableFinder()->find('tpc.php'),
+        ]);
+        foreach ($candidates as $candidate) {
+            $path = (string) (realpath($candidate) ?: $candidate);
+            if (is_file($path) && (str_ends_with($path, '.php') || is_executable($path))) {
+                return $path;
+            }
+        }
+        throw new \RuntimeException(
+            'TypePHP compiler was not found. Install swoole/typephp globally or set native.tpc/TYPEPHP_TPC.',
+        );
+    }
+
+    /**
+     * @param array<array-key, mixed> $config
+     */
+    private function resolvePhpxHome(array $config, string $tpc): string
+    {
+        $configured = $this->stringValue($config['phpx_home'] ?? null) ?? $this->stringValue(getenv('PHPX_HOME'));
+        $home = $this->stringValue(getenv('HOME'));
+        $vendorDir = dirname(dirname($tpc));
+        $cwd = getcwd();
+        $cwd = $cwd === false ? '.' : $cwd;
+        $candidates = array_filter([
+            $configured,
+            $cwd . '/vendor/swoole/phpx',
+            $vendorDir . '/swoole/phpx',
+            $home === null ? null : $home . '/.composer/vendor/swoole/phpx',
+            $home === null ? null : $home . '/.config/composer/vendor/swoole/phpx',
+        ]);
+        foreach ($candidates as $candidate) {
+            $path = (string) (realpath($candidate) ?: $candidate);
+            if (is_dir($path) && $this->hasPhpxLibrary($path)) {
+                return rtrim($path, '/\\');
+            }
+        }
+        throw new \RuntimeException(
+            'A built PHPX runtime was not found. Set native.phpx_home or PHPX_HOME to a matching PHPX '
+            . 'installation containing libphpx.',
+        );
+    }
+
+    private function resolveTypephpHome(string $tpc): string
+    {
+        foreach ([dirname(dirname($tpc)), dirname(dirname($tpc)) . '/swoole/typephp'] as $candidate) {
+            $path = (string) (realpath($candidate) ?: $candidate);
+            if (is_file($path . '/bin/bootstrap.php') && is_file($path . '/src/compiler.php')) {
+                return $path;
+            }
+        }
+        return '';
+    }
+
+    /**
+     * @param array<array-key, mixed> $config
+     */
+    private function resolveCxx(array $config): string
+    {
+        $configured = $this->stringValue($config['cxx'] ?? null) ?? $this->stringValue(getenv('CXX'));
+        $finder = new ExecutableFinder();
+        $candidates = array_filter([
+            $configured,
+            $finder->find('clang++'),
+            $finder->find('g++'),
+        ]);
+        foreach ($candidates as $candidate) {
+            $path = (string) (realpath($candidate) ?: $candidate);
+            if (is_executable($path)) {
+                return $path;
+            }
+        }
+        throw new \RuntimeException('A C++17 compiler was not found. Set native.cxx or CXX.');
+    }
+
+    /**
+     * @param list<string> $fallbacks
+     */
+    private function resolveExecutable(mixed $configured, array $fallbacks, string $label): string
+    {
+        $candidates = array_filter([$this->stringValue($configured), ...$fallbacks]);
+        foreach ($candidates as $candidate) {
+            $path = (string) (realpath($candidate) ?: $candidate);
+            if (is_executable($path)) {
+                return $path;
+            }
+        }
+        throw new \RuntimeException("{$label} was not found.");
+    }
+
+    private function assertPhpEmbed(string $phpHome): void
+    {
+        if (!$this->hasPhpEmbed($phpHome)) {
+            throw new \RuntimeException(
+                "PHP embed SDK is incomplete: {$phpHome}. Expected sapi/embed/php_embed.h and libphp.",
+            );
+        }
+    }
+
+    private function hasPhpEmbed(string $phpHome): bool
+    {
+        $header = $phpHome . '/include/php/sapi/embed/php_embed.h';
+        if (!is_file($header)) {
+            return false;
+        }
+        foreach (['libphp.dylib', 'libphp.so', 'libphp.a'] as $library) {
+            if (is_file($phpHome . '/lib/' . $library)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private function assertPhpxLibrary(string $phpxHome): void
+    {
+        if (!$this->hasPhpxLibrary($phpxHome)) {
+            throw new \RuntimeException("PHPX runtime library is missing from: {$phpxHome}");
+        }
+    }
+
+    private function hasPhpxLibrary(string $phpxHome): bool
+    {
+        foreach (['libphpx.dylib', 'libphpx.so', 'libphpx.a'] as $library) {
+            if (is_file($phpxHome . '/lib/' . $library)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * @param list<string> $command
+     * @param array<string, string> $environment
+     */
+    private function capture(array $command, array $environment = []): string
+    {
+        $process = new Process($command, null, $environment, null, 15);
+        $process->run();
+        if (!$process->isSuccessful()) {
+            $message = trim($process->getErrorOutput() . "\n" . $process->getOutput());
+            throw new \RuntimeException($message === '' ? 'Native toolchain command failed.' : $message);
+        }
+        return trim($process->getOutput());
+    }
+
+    private function stringValue(mixed $value): ?string
+    {
+        return is_string($value) && trim($value) !== '' ? trim($value) : null;
+    }
+}
diff --git a/src/Compiler/Profile/SaiAdminProfile.php b/src/Compiler/Profile/SaiAdminProfile.php
new file mode 100644
index 0000000..f997241
--- /dev/null
+++ b/src/Compiler/Profile/SaiAdminProfile.php
@@ -0,0 +1,363 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tinywan\Typephp\Compiler\Profile;
+
+final class SaiAdminProfile
+{
+    public const NAME = 'saiadmin';
+
+    private const REQUIRED_COMPILED_DEPENDENCIES = [
+        'vendor/workerman/coroutine/src/Pool.php',
+        'vendor/workerman/coroutine/src/Utils/DestructionWatcher.php',
+    ];
+
+    private const SUPPORTED_EXACT_VERSIONS = [
+        'topthink/think-orm' => ['v3.0.34'],
+        'nesbot/carbon' => ['3.13.2'],
+    ];
+
+    public function __construct(
+        private readonly string $basePath,
+    ) {}
+
+    /**
+     * @return array<string, string>
+     */
+    public function assertSupported(): array
+    {
+        if (!is_dir($this->absolute('plugin/saiadmin'))) {
+            throw new \RuntimeException('The saiadmin profile requires plugin/saiadmin.');
+        }
+
+        $lockFile = $this->absolute('composer.lock');
+        $contents = is_file($lockFile) ? file_get_contents($lockFile) : false;
+        $lock = $contents === false ? null : json_decode($contents, true);
+        if (!is_array($lock)) {
+            throw new \RuntimeException('The saiadmin profile requires a valid composer.lock.');
+        }
+
+        $installed = [];
+        foreach (array_merge($lock['packages'] ?? [], $lock['packages-dev'] ?? []) as $package) {
+            if (is_array($package) && is_string($package['name'] ?? null) && is_string($package['version'] ?? null)) {
+                $installed[$package['name']] = $package['version'];
+            }
+        }
+
+        $saiAdminVersion = $installed['saithink/saiadmin'] ?? null;
+        if ($saiAdminVersion === null) {
+            throw new \RuntimeException('The saiadmin profile requires saithink/saiadmin.');
+        }
+        $this->assertInstalledSaiAdminMatchesPackage();
+
+        foreach (self::SUPPORTED_EXACT_VERSIONS as $package => $versions) {
+            $version = $installed[$package] ?? null;
+            if ($version === null) {
+                throw new \RuntimeException("The saiadmin profile requires {$package}.");
+            }
+            if (!in_array($version, $versions, true)) {
+                throw new \RuntimeException(
+                    "Unsupported {$package} version {$version}; supported: " . implode(', ', $versions) . '.',
+                );
+            }
+        }
+        return array_intersect_key($installed, ['saithink/saiadmin' => true]
+        + array_fill_keys(array_keys(self::SUPPORTED_EXACT_VERSIONS), true));
+    }
+
+    /**
+     * @return list<string>
+     */
+    public function sources(): array
+    {
+        $sources = [];
+        foreach (['app', 'support', 'plugin/saiadmin'] as $source) {
+            if (is_dir($this->absolute($source))) {
+                $sources[] = $source;
+            }
+        }
+        foreach (glob($this->absolute('plugin/*/app'), GLOB_ONLYDIR) ?: [] as $directory) {
+            $plugin = basename(dirname($directory));
+            if ($plugin !== 'saiadmin' && preg_match('/^[A-Za-z0-9_-]+$/', $plugin)) {
+                $sources[] = "plugin/{$plugin}/app";
+            }
+        }
+        $sources = array_values(array_unique($sources));
+        sort($sources);
+        return $sources;
+    }
+
+    /**
+     * Dependency declarations required by generated compatibility copies.
+     *
+     * @return list<string>
+     */
+    public function dependencySources(): array
+    {
+        if (!is_dir($this->absolute('vendor'))) {
+            throw new \RuntimeException('SaiAdmin profile dependency source was not found: vendor.');
+        }
+
+        return ['vendor'];
+    }
+
+    /**
+     * @param list<string> $sources
+     * @return list<string>
+     */
+    public function mergeCompilerSources(array $sources): array
+    {
+        $merged = array_merge($sources, $this->sources(), $this->dependencySources());
+        if (in_array('vendor', $merged, true)) {
+            $merged = array_values(array_filter(
+                $merged,
+                static fn(string $source): bool => $source === 'vendor' || !str_starts_with($source, 'vendor/'),
+            ));
+        }
+
+        return array_values(array_unique($merged));
+    }
+
+    /**
+     * @return list<string>
+     */
+    public function runtimeResources(): array
+    {
+        $resources = [];
+        foreach (glob($this->absolute('plugin/*'), GLOB_ONLYDIR) ?: [] as $pluginDirectory) {
+            $plugin = basename($pluginDirectory);
+            foreach (['config', 'public', 'app/view'] as $suffix) {
+                $resource = "plugin/{$plugin}/{$suffix}";
+                if (is_dir($this->absolute($resource))) {
+                    $resources[] = $resource;
+                }
+            }
+        }
+        foreach (['plugin/saiadmin/db', 'plugin/saiadmin/utils/code/stub'] as $resource) {
+            if (is_dir($this->absolute($resource))) {
+                $resources[] = $resource;
+            }
+        }
+        $resources = array_values(array_unique($resources));
+        sort($resources);
+        return $resources;
+    }
+
+    /**
+     * @return list<string>
+     */
+    public function resourceIgnores(): array
+    {
+        return $this->runtimeResources();
+    }
+
+    /**
+     * @param list<mixed> $ignores
+     * @return list<mixed>
+     */
+    public function filterUserIgnores(array $ignores): array
+    {
+        $businessFiles = $this->businessFiles();
+        return array_values(array_filter($ignores, function (mixed $ignore) use ($businessFiles): bool {
+            if (!is_string($ignore)) {
+                return true;
+            }
+            foreach (self::REQUIRED_COMPILED_DEPENDENCIES as $file) {
+                if ($this->matchesAny($file, [$ignore])) {
+                    return false;
+                }
+            }
+            foreach ($businessFiles as $file) {
+                if ($this->matchesAny($file, [$ignore])) {
+                    return false;
+                }
+            }
+            return true;
+        }));
+    }
+
+    /**
+     * @param list<mixed> $resources
+     * @return list<mixed>
+     */
+    public function filterRuntimeResources(array $resources): array
+    {
+        return array_values(array_filter($resources, function (mixed $resource): bool {
+            if (!is_string($resource)) {
+                return true;
+            }
+            foreach (self::REQUIRED_COMPILED_DEPENDENCIES as $file) {
+                if ($this->matchesAny($file, [$resource])) {
+                    return false;
+                }
+            }
+            return true;
+        }));
+    }
+
+    /**
+     * @param list<string> $sources
+     * @param list<string> $ignores
+     * @param array<string, string> $generatedSources
+     * @return array{profile: string, packages: array<string, string>, counts: array<string, int>, files: list<array<string, string>>}
+     */
+    public function writeCoverageManifest(array $sources, array $ignores, array $generatedSources): array
+    {
+        $packages = $this->assertSupported();
+        $files = [];
+        $counts = ['compiled' => 0, 'generated' => 0];
+
+        foreach ($this->businessFiles() as $file) {
+            $ignored = $this->matchesAny($file, $ignores);
+            $generated = $generatedSources[$file] ?? null;
+            if ($ignored && ($generated === null || !$this->matchesAny($generated, $sources))) {
+                throw new \RuntimeException(
+                    "SaiAdmin business PHP is excluded without a compiled AOT replacement: {$file}.",
+                );
+            }
+            if (!$ignored && !$this->matchesAny($file, $sources)) {
+                throw new \RuntimeException("SaiAdmin business PHP is missing from compiler sources: {$file}.");
+            }
+
+            if ($ignored) {
+                $files[] = ['path' => $file, 'mode' => 'generated', 'compiled_path' => (string) $generated];
+                ++$counts['generated'];
+            } else {
+                $files[] = ['path' => $file, 'mode' => 'compiled', 'compiled_path' => $file];
+                ++$counts['compiled'];
+            }
+        }
+
+        $manifest = [
+            'profile' => self::NAME,
+            'packages' => $packages,
+            'counts' => $counts,
+            'files' => $files,
+        ];
+        $target = $this->absolute('.typephp/build/source-coverage.json');
+        if (!is_dir(dirname($target)) && !mkdir(dirname($target), 0777, true) && !is_dir(dirname($target))) {
+            throw new \RuntimeException('Unable to create the TypePHP build directory.');
+        }
+        $json = json_encode($manifest, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+        if (!is_string($json) || file_put_contents($target, $json . "\n") === false) {
+            throw new \RuntimeException('Unable to write the SaiAdmin source coverage manifest.');
+        }
+        return $manifest;
+    }
+
+    /**
+     * @return list<string>
+     */
+    private function businessFiles(): array
+    {
+        $files = [];
+        foreach ($this->sources() as $source) {
+            $iterator = new \RecursiveIteratorIterator(
+                new \RecursiveDirectoryIterator(
+                    $this->absolute($source),
+                    \FilesystemIterator::SKIP_DOTS | \FilesystemIterator::FOLLOW_SYMLINKS,
+                ),
+            );
+            foreach ($iterator as $file) {
+                if (!$file->isFile() || strtolower($file->getExtension()) !== 'php') {
+                    continue;
+                }
+                $relative = $this->relative($file->getPathname());
+                if ($this->isNonBusinessPhp($relative)) {
+                    continue;
+                }
+                $files[] = $relative;
+            }
+        }
+        $files = array_values(array_unique($files));
+        sort($files);
+        return $files;
+    }
+
+    private function isNonBusinessPhp(string $path): bool
+    {
+        return (
+            $path === 'support/bootstrap.php'
+            || str_contains($path, '/config/')
+            || str_contains($path, '/app/view/')
+            || str_starts_with($path, 'plugin/saiadmin/db/')
+            || str_starts_with($path, 'plugin/saiadmin/utils/code/stub/')
+        );
+    }
+
+    private function assertInstalledSaiAdminMatchesPackage(): void
+    {
+        $installed = $this->saiAdminBusinessSourceMap($this->absolute('plugin/saiadmin'));
+        $package = $this->saiAdminBusinessSourceMap($this->absolute('vendor/saithink/saiadmin/src/plugin/saiadmin'));
+        if ($installed === $package) {
+            return;
+        }
+
+        $paths = array_values(array_unique(array_merge(array_keys($installed), array_keys($package))));
+        sort($paths);
+        foreach ($paths as $path) {
+            if (($installed[$path] ?? null) !== ($package[$path] ?? null)) {
+                throw new \RuntimeException(
+                    "Installed SaiAdmin source does not match composer.lock package: plugin/saiadmin/{$path}.",
+                );
+            }
+        }
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    private function saiAdminBusinessSourceMap(string $root): array
+    {
+        if (!is_dir($root)) {
+            throw new \RuntimeException('SaiAdmin package source was not found for installed-source verification.');
+        }
+
+        $files = [];
+        $iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator(
+            $root,
+            \FilesystemIterator::SKIP_DOTS,
+        ));
+        foreach ($iterator as $file) {
+            if (!$file->isFile() || strtolower($file->getExtension()) !== 'php') {
+                continue;
+            }
+            $relative = str_replace('\\', '/', substr($file->getPathname(), strlen($root) + 1));
+            if ($this->isNonBusinessPhp('plugin/saiadmin/' . $relative)) {
+                continue;
+            }
+            $hash = hash_file('sha256', $file->getPathname());
+            if (!is_string($hash)) {
+                throw new \RuntimeException("Unable to hash SaiAdmin package source: {$relative}.");
+            }
+            $files[$relative] = $hash;
+        }
+        ksort($files);
+        return $files;
+    }
+
+    /**
+     * @param list<string> $paths
+     */
+    private function matchesAny(string $file, array $paths): bool
+    {
+        foreach ($paths as $path) {
+            $path = trim(str_replace('\\', '/', $path), '/');
+            if ($path !== '' && ($file === $path || str_starts_with($file, $path . '/'))) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private function absolute(string $path): string
+    {
+        return rtrim($this->basePath, '/\\') . DIRECTORY_SEPARATOR . str_replace('/', DIRECTORY_SEPARATOR, $path);
+    }
+
+    private function relative(string $path): string
+    {
+        return str_replace('\\', '/', substr($path, strlen(rtrim($this->basePath, '/\\')) + 1));
+    }
+}
diff --git a/src/Compiler/ProjectGenerator.php b/src/Compiler/ProjectGenerator.php
index bb49d2a..6dd5015 100644
--- a/src/Compiler/ProjectGenerator.php
+++ b/src/Compiler/ProjectGenerator.php
@@ -9,11 +9,18 @@
 
 namespace Tinywan\Typephp\Compiler;
 
+use Tinywan\Typephp\Compiler\Profile\SaiAdminProfile;
+
 // @mago-ignore lint:cyclomatic-complexity -- The explicit compatibility matrix is intentionally kept together for review.
 // @mago-ignore lint:kan-defect -- The tokenizer-based helpers flattener is an inherently control-flow dense state machine.
 // @mago-ignore lint:too-many-methods -- Generation, flattening, and static-patching transformations belong to one coherent pipeline.
 class ProjectGenerator
 {
+    /**
+     * @var array<string, string>
+     */
+    private array $guardedSources = self::GUARDED_SOURCES;
+
     /**
      * 需要平铺的守卫源文件映射：vendor 原文件 => AOT 专用平铺文件（相对项目根目录）。
      * 新版 webman-framework 的 helpers.php 与 fast-route 的 functions.php 顶层包含
@@ -24,6 +31,125 @@ class ProjectGenerator
     public const GUARDED_SOURCES = [
         'vendor/workerman/webman-framework/src/support/helpers.php' => '.typephp/build/helpers.php',
         'vendor/nikic/fast-route/src/functions.php' => '.typephp/build/fast-route-functions.php',
+        'vendor/illuminate/collections/helpers.php' => '.typephp/build/illuminate-collections-helpers.php',
+        'vendor/illuminate/collections/functions.php' => '.typephp/build/illuminate-collections-functions.php',
+        'vendor/illuminate/events/functions.php' => '.typephp/build/illuminate-events-functions.php',
+        'vendor/illuminate/filesystem/functions.php' => '.typephp/build/illuminate-filesystem-functions.php',
+        'vendor/illuminate/reflection/helpers.php' => '.typephp/build/illuminate-reflection-helpers.php',
+        'vendor/illuminate/support/helpers.php' => '.typephp/build/illuminate-support-helpers.php',
+        'vendor/illuminate/support/functions.php' => '.typephp/build/illuminate-support-functions.php',
+        'vendor/cakephp/core/functions.php' => '.typephp/build/cakephp-core-functions.php',
+        'vendor/ralouphie/getallheaders/src/getallheaders.php' => '.typephp/build/getallheaders.php',
+        'vendor/symfony/deprecation-contracts/function.php' => '.typephp/build/symfony-trigger-deprecation.php',
+        'vendor/symfony/polyfill-intl-grapheme/bootstrap80.php' => '.typephp/build/symfony-grapheme-functions.php',
+        'vendor/symfony/polyfill-intl-idn/bootstrap80.php' => '.typephp/build/symfony-idn-functions.php',
+        'vendor/symfony/polyfill-intl-normalizer/bootstrap80.php' => '.typephp/build/symfony-normalizer-functions.php',
+        'vendor/symfony/var-dumper/Resources/functions/dump.php' => '.typephp/build/symfony-var-dumper-functions.php',
+        'vendor/topthink/think-validate/src/helper.php' => '.typephp/build/think-validate-functions.php',
+        'vendor/zoujingli/ip2region/Ip2Region.php' => '.typephp/build/ip2region-class.php',
+        'vendor/zoujingli/ip2region/function.php' => '.typephp/build/ip2region-functions.php',
+        'vendor/zoujingli/ip2region/src/common.php' => '.typephp/build/ip2region-v3-functions.php',
+        'vendor/symfony/polyfill-php85/bootstrap.php' => '.typephp/build/symfony-php85-functions.php',
+        'vendor/symfony/polyfill-php85/Resources/stubs/DelayedTargetValidation.php' => '.typephp/build/php85-delayed-target-validation.php',
+        'vendor/symfony/polyfill-php85/Resources/stubs/NoDiscard.php' => '.typephp/build/php85-no-discard.php',
+        'vendor/symfony/polyfill-php85/Resources/stubs/Filter/FilterException.php' => '.typephp/build/php85-filter-exception.php',
+        'vendor/symfony/polyfill-php85/Resources/stubs/Filter/FilterFailedException.php' => '.typephp/build/php85-filter-failed-exception.php',
+        'vendor/symfony/cache/Traits/Redis61ProxyTrait.php' => '.typephp/build/symfony-cache-redis61-proxy-trait.php',
+        'vendor/symfony/cache/Traits/Redis62ProxyTrait.php' => '.typephp/build/symfony-cache-redis62-proxy-trait.php',
+        'vendor/symfony/cache/Traits/Redis63ProxyTrait.php' => '.typephp/build/symfony-cache-redis63-proxy-trait.php',
+        'vendor/symfony/cache/Traits/RedisCluster61ProxyTrait.php' => '.typephp/build/symfony-cache-redis-cluster61-proxy-trait.php',
+        'vendor/symfony/cache/Traits/RedisCluster62ProxyTrait.php' => '.typephp/build/symfony-cache-redis-cluster62-proxy-trait.php',
+        'vendor/symfony/cache/Traits/RedisCluster63ProxyTrait.php' => '.typephp/build/symfony-cache-redis-cluster63-proxy-trait.php',
+    ];
+
+    /**
+     * 仅负责动态加载、而真实声明位于静态目标文件的已知 Composer files wrapper。
+     *
+     * wrapper 不可直接平铺：guard 主体是 require，不是声明。生成配置时严格校验
+     * wrapper 形态、显式加入声明源并忽略 wrapper，未知或变形内容立即失败。
+     */
+    public const STATIC_LOADER_SOURCES = [
+        'vendor/guzzlehttp/guzzle/src/functions_include.php' => 'vendor/guzzlehttp/guzzle/src/functions.php',
+    ];
+
+    /**
+     * 明确登记为运行时解释执行的第三方动态源码。
+     *
+     * laravel/serializable-closure 依赖 extract、动态 stream include 与 Closure::bindTo；
+     * symfony/cache 的适配器、标签与 Redis trait 广泛依赖 Closure::bind() 访问 CacheItem
+     * 内部槽。二者均为第三方动态实现，不能静态转换，随包保留 Composer 相对路径。
+     */
+    public const REGISTERED_DYNAMIC_SOURCES = [
+        // These third-party units rely on runtime-only PHP behavior:
+        // FnStream dispatches dynamically stored callables, while PHPMailer
+        // passes stream arguments by reference through internal functions.
+        'vendor/guzzlehttp/psr7/src/FnStream.php',
+        'vendor/laravel/serializable-closure',
+        'vendor/monolog/monolog/src/Monolog/Handler/Slack/SlackRecord.php',
+        'vendor/phpmailer/phpmailer/get_oauth_token.php',
+        'vendor/phpmailer/phpmailer/src/POP3.php',
+        'vendor/phpmailer/phpmailer/src/SMTP.php',
+        // SaiAdmin 6.1.5 uses Phinx for install-time migrations. Its CakePHP
+        // and League Container stack relies on dynamic PHP patterns outside
+        // TypePHP v0.8's bounded type system, so keep this third-party tooling
+        // explicit and inspectable instead of silently dropping its features.
+        'vendor/cakephp',
+        'vendor/league/container',
+        'vendor/robmorgan/phinx',
+        'vendor/symfony/cache',
+        'vendor/symfony/clock/Resources',
+        'vendor/symfony/config',
+        'vendor/symfony/console/Attribute',
+        'vendor/symfony/console/Command/InvokableCommand.php',
+        'vendor/symfony/console/Command/TraceableCommand.php',
+        'vendor/symfony/console/Completion',
+        'vendor/symfony/console/DataCollector',
+        'vendor/symfony/error-handler',
+        'vendor/symfony/finder',
+        'vendor/symfony/http-foundation/Session/Storage/Handler/IdentityMarshaller.php',
+        'vendor/symfony/http-foundation/Session/Storage/Handler/MigratingSessionHandler.php',
+        'vendor/symfony/http-kernel/DataCollector',
+        'vendor/symfony/http-kernel/EventListener/DebugHandlersListener.php',
+        'vendor/symfony/http-kernel/Fragment/InlineFragmentRenderer.php',
+        'vendor/symfony/http-kernel/Kernel.php',
+        'vendor/symfony/mime/Crypto',
+        'vendor/symfony/mime/Part',
+        'vendor/symfony/polyfill-mbstring',
+        'vendor/symfony/polyfill-intl-normalizer',
+        'vendor/symfony/polyfill-php83',
+        'vendor/symfony/polyfill-php84',
+        'vendor/symfony/polyfill-php85',
+        'vendor/symfony/process',
+        'vendor/symfony/string',
+        'vendor/symfony/translation/Command',
+        'vendor/symfony/translation/Util/ArrayConverter.php',
+        'vendor/symfony/var-dumper',
+        'vendor/symfony/var-exporter',
+        'vendor/symfony/translation/DataCollector',
+        'vendor/openspout/openspout',
+        'vendor/twig/twig',
+        'vendor/tinywan/storage',
+        // Composer loads this guarded wrapper before ThinkORM classes. Keep
+        // the wrapper path in the package, while compiling Exception.php.
+        // Facade.php is only a fallback and duplicates think-container here.
+        'vendor/topthink/think-orm/stubs/load_stubs.php',
+        // ThinkORM ships MongoDB as an optional ext-mongodb driver. Keep the
+        // coherent driver unit available at runtime without forcing its
+        // reference-heavy query builder through the static compiler.
+        'vendor/topthink/think-orm/src/db/Mongo.php',
+        'vendor/topthink/think-orm/src/db/builder/Mongo.php',
+        'vendor/topthink/think-orm/src/db/connector/Mongo.php',
+        'vendor/topthink/think-orm/src/db/builder/Oracle.php',
+        'vendor/topthink/think-orm/src/db/builder/Pgsql.php',
+        'vendor/topthink/think-orm/src/db/builder/Sqlite.php',
+        'vendor/topthink/think-orm/src/db/builder/Sqlsrv.php',
+        'vendor/voku/portable-ascii',
+        'vendor/webman/channel',
+        'vendor/webman/console/src/Commands',
+        'vendor/webman/console/src/Messages.php',
+        'vendor/webman/console/src/Util.php',
+        'vendor/webman/database/src/support/MongoModel.php',
+        'vendor/workerman/channel',
     ];
 
     /**
@@ -43,6 +169,8 @@ class ProjectGenerator
         'vendor/workerman/coroutine/src/Context.php' => '.typephp/build/coroutine-context.php',
         'vendor/workerman/coroutine/src/WaitGroup.php' => '.typephp/build/coroutine-wait-group.php',
         'vendor/workerman/coroutine/src/Barrier.php' => '.typephp/build/coroutine-barrier.php',
+        'vendor/workerman/coroutine/src/Barrier/BarrierInterface.php' => '.typephp/build/coroutine-barrier-interface.php',
+        'vendor/workerman/coroutine/src/Barrier/Swoole.php' => '.typephp/build/coroutine-barrier-swoole.php',
     ];
 
     /**
@@ -60,6 +188,52 @@ class ProjectGenerator
         'vendor/workerman/coroutine/src/Coroutine.php' => '.typephp/build/coroutine-coroutine.php',
     ];
 
+    /**
+     * Symfony/Twig opcache preload hints are top-level class_exists() calls.
+     * They help PHP preload discover symbols but have no runtime semantics that
+     * must be compiled into an AOT executable.
+     */
+    public const PRELOAD_HINT_SOURCES = [
+        'vendor/symfony/http-kernel/HttpKernel.php' => ['.typephp/build/symfony-http-kernel.php', 9],
+        'vendor/symfony/http-kernel/HttpClientKernel.php' => ['.typephp/build/symfony-http-client-kernel.php', 1],
+        'vendor/symfony/cache-contracts/CacheTrait.php' => [
+            '.typephp/build/symfony-cache-contracts-cache-trait.php',
+            1,
+        ],
+        'vendor/symfony/translation/Translator.php' => ['.typephp/build/symfony-translation-translator.php', 1],
+        'vendor/symfony/translation/Formatter/MessageFormatter.php' => [
+            '.typephp/build/symfony-message-formatter.php',
+            1,
+        ],
+        'vendor/symfony/http-foundation/Session/SessionFactory.php' => [
+            '.typephp/build/symfony-session-factory.php',
+            1,
+        ],
+        'vendor/symfony/http-foundation/Session/Storage/PhpBridgeSessionStorageFactory.php' => [
+            '.typephp/build/symfony-php-bridge-session-storage-factory.php',
+            1,
+        ],
+        'vendor/symfony/http-foundation/Session/Storage/NativeSessionStorageFactory.php' => [
+            '.typephp/build/symfony-native-session-storage-factory.php',
+            1,
+        ],
+        'vendor/symfony/http-foundation/Session/Storage/MockFileSessionStorageFactory.php' => [
+            '.typephp/build/symfony-mock-file-session-storage-factory.php',
+            1,
+        ],
+        'vendor/symfony/http-foundation/Session/Storage/NativeSessionStorage.php' => [
+            '.typephp/build/symfony-native-session-storage.php',
+            3,
+        ],
+        'vendor/symfony/http-foundation/AcceptHeader.php' => ['.typephp/build/symfony-accept-header.php', 1],
+        'vendor/symfony/http-foundation/Response.php' => ['.typephp/build/symfony-response.php', 1],
+        'vendor/symfony/http-foundation/Session/Session.php' => ['.typephp/build/symfony-session.php', 3],
+        'vendor/symfony/service-contracts/ServiceLocatorTrait.php' => [
+            '.typephp/build/symfony-service-locator-trait.php',
+            2,
+        ],
+    ];
+
     /**
      * 需要可变参数闭包补丁的源文件映射：vendor 原文件 => AOT 专用补丁文件。
      * TypePHP 编译产物对用户态闭包调用强制精确参数个数，而 PHP 语义允许调用时
@@ -77,6 +251,7 @@ class ProjectGenerator
      */
     public const VARIADIC_HANDLER_SOURCES = [
         'vendor/workerman/workerman/src/Worker.php' => '.typephp/build/workerman-worker.php',
+        'vendor/workerman/workerman/src/Timer.php' => '.typephp/build/workerman-timer.php',
         'vendor/workerman/workerman/src/Connection/TcpConnection.php' => '.typephp/build/workerman-tcp-connection.php',
         'vendor/workerman/workerman/src/Connection/AsyncTcpConnection.php' => '.typephp/build/workerman-async-tcp-connection.php',
         'vendor/workerman/workerman/src/Events/Select.php' => '.typephp/build/workerman-select.php',
@@ -97,18 +272,27 @@ class ProjectGenerator
      */
     protected const RESET_STD_STREAM_CLOSE_BLOCK =
         "\n"
-        . '        if (is_resource(STDOUT)) {' . "\n"
-        . '            fclose(STDOUT);' . "\n"
-        . '        }' . "\n"
-        . "\n"
-        . '        if (is_resource(STDERR)) {' . "\n"
-        . '            fclose(STDERR);' . "\n"
-        . '        }' . "\n"
-        . "\n"
-        . '        if (is_resource(static::$outputStream)) {' . "\n"
-        . '            fclose(static::$outputStream);' . "\n"
-        . '        }' . "\n"
-        . "\n";
+            . '        if (is_resource(STDOUT)) {'
+            . "\n"
+            . '            fclose(STDOUT);'
+            . "\n"
+            . '        }'
+            . "\n"
+            . "\n"
+            . '        if (is_resource(STDERR)) {'
+            . "\n"
+            . '            fclose(STDERR);'
+            . "\n"
+            . '        }'
+            . "\n"
+            . "\n"
+            . '        if (is_resource(static::$outputStream)) {'
+            . "\n"
+            . '            fclose(static::$outputStream);'
+            . "\n"
+            . '        }'
+            . "\n"
+            . "\n";
 
     /**
      * 需要 switch 终结语句补丁的源文件映射：vendor 原文件 => AOT 专用补丁文件。
@@ -119,8 +303,171 @@ class ProjectGenerator
      * 终结形态（object 直接 return、default 补 break、级联展开为各 case 独立连乘）。
      */
     public const SWITCH_TERMINAL_SOURCES = [
+        'app/process/Monitor.php' => '.typephp/build/app-process-monitor.php',
+        'vendor/godruoyi/php-snowflake/src/Snowflake.php' => '.typephp/build/godruoyi-snowflake.php',
+        'vendor/godruoyi/php-snowflake/src/Sonyflake.php' => '.typephp/build/godruoyi-sonyflake.php',
+        'vendor/guzzlehttp/guzzle/src/Handler/CurlMultiHandler.php' => '.typephp/build/guzzle-curl-multi-handler.php',
+        'vendor/workerman/coroutine/src/Pool.php' => '.typephp/build/workerman-coroutine-pool.php',
+        'vendor/workerman/workerman/src/Protocols/Websocket.php' => '.typephp/build/workerman-websocket.php',
+        'vendor/zoujingli/ip2region/XdbSearcher.php' => '.typephp/build/ip2region-xdb-searcher.php',
+        'vendor/zoujingli/ip2region/src/ip2region/xdb/Util.php' => '.typephp/build/ip2region-v3-util.php',
         'vendor/workerman/webman-framework/src/App.php' => '.typephp/build/webman-app.php',
+        'vendor/workerman/webman-framework/src/Config.php' => '.typephp/build/webman-config.php',
+        'vendor/webman/captcha/src/CaptchaBuilder.php' => '.typephp/build/webman-captcha-builder.php',
         'vendor/monolog/monolog/src/Monolog/Utils.php' => '.typephp/build/monolog-utils.php',
+        'vendor/monolog/monolog/src/Monolog/Handler/BrowserConsoleHandler.php' => '.typephp/build/monolog-browser-console-handler.php',
+        'vendor/symfony/service-contracts/ServiceSubscriberTrait.php' => '.typephp/build/symfony-service-subscriber-trait.php',
+        'vendor/webman/console/src/Application.php' => '.typephp/build/webman-console-application.php',
+        'vendor/nelexa/zip/src/IO/Filter/Cipher/Pkware/PKCryptContext.php' => '.typephp/build/nelexa-pkcrypt-context.php',
+        'vendor/nelexa/zip/src/Model/ZipEntry.php' => '.typephp/build/nelexa-zip-entry.php',
+        'vendor/nelexa/zip/src/ZipFile.php' => '.typephp/build/nelexa-zip-file.php',
+        'vendor/nelexa/zip/src/Util/FilesUtil.php' => '.typephp/build/nelexa-files-util.php',
+        'vendor/nelexa/zip/src/IO/Stream/ResponseStream.php' => '.typephp/build/nelexa-response-stream.php',
+        'vendor/nesbot/carbon/src/Carbon/CarbonInterval.php' => '.typephp/build/carbon-interval.php',
+        'vendor/nesbot/carbon/src/Carbon/CarbonTimeZone.php' => '.typephp/build/carbon-time-zone.php',
+        'vendor/nesbot/carbon/lazy/Carbon/MessageFormatter/MessageFormatterMapperStrongType.php' => '.typephp/build/carbon-message-formatter-strong.php',
+        'vendor/nesbot/carbon/lazy/Carbon/TranslatorStrongType.php' => '.typephp/build/carbon-translator-strong.php',
+        'vendor/nesbot/carbon/src/Carbon/MessageFormatter/MessageFormatterMapper.php' => '.typephp/build/carbon-message-formatter.php',
+        'vendor/nesbot/carbon/src/Carbon/Translator.php' => '.typephp/build/carbon-translator.php',
+        'vendor/phpmailer/phpmailer/src/PHPMailer.php' => '.typephp/build/phpmailer.php',
+        'plugin/saiadmin/utils/Captcha.php' => '.typephp/build/saiadmin-captcha.php',
+        'plugin/saiadmin/utils/code/CodeEngine.php' => '.typephp/build/saiadmin-code-engine.php',
+        'plugin/saiadmin/app/controller/LoginController.php' => '.typephp/build/saiadmin-login-controller.php',
+        'plugin/saiadmin/app/controller/InstallController.php' => '.typephp/build/saiadmin-install-controller.php',
+        'plugin/saiadmin/app/controller/SystemController.php' => '.typephp/build/saiadmin-system-controller.php',
+        'plugin/saiadmin/app/controller/system/SystemPostController.php' => '.typephp/build/saiadmin-system-post-controller.php',
+        'plugin/saiadmin/app/controller/system/DataBaseController.php' => '.typephp/build/saiadmin-database-controller.php',
+        'plugin/saiadmin/app/cache/ReflectionCache.php' => '.typephp/build/saiadmin-reflection-cache.php',
+        'plugin/saiadmin/app/cache/UserAuthCache.php' => '.typephp/build/saiadmin-user-auth-cache.php',
+        'plugin/saiadmin/app/cache/UserInfoCache.php' => '.typephp/build/saiadmin-user-info-cache.php',
+        'plugin/saiadmin/app/logic/tool/CrontabLogic.php' => '.typephp/build/saiadmin-crontab-logic.php',
+        'plugin/saiadmin/exception/SystemException.php' => '.typephp/build/saiadmin-system-exception.php',
+        'vendor/ramsey/collection/src/DoubleEndedQueue.php' => '.typephp/build/ramsey-double-ended-queue.php',
+        'vendor/ramsey/uuid/src/Converter/Time/PhpTimeConverter.php' => '.typephp/build/ramsey-php-time-converter.php',
+        'vendor/firebase/php-jwt/src/JWT.php' => '.typephp/build/firebase-jwt.php',
+        'vendor/vlucas/phpdotenv/src/Repository/RepositoryBuilder.php' => '.typephp/build/phpdotenv-repository-builder.php',
+        'vendor/vlucas/phpdotenv/src/Parser/EntryParser.php' => '.typephp/build/phpdotenv-entry-parser.php',
+        'vendor/topthink/think-orm/src/model/Collection.php' => '.typephp/build/think-orm-model-collection.php',
+        'vendor/saithink/saipackage/src/service/Filesystem.php' => '.typephp/build/saipackage-filesystem.php',
+        'vendor/saithink/saipackage/src/service/Terminal.php' => '.typephp/build/saipackage-terminal.php',
+        'vendor/saithink/saipackage/src/service/Version.php' => '.typephp/build/saipackage-version.php',
+        'vendor/symfony/console/Attribute/AsCommand.php' => '.typephp/build/symfony-console-as-command.php',
+        'vendor/symfony/console/Application.php' => '.typephp/build/symfony-console-application.php',
+        'vendor/symfony/console/Formatter/OutputFormatter.php' => '.typephp/build/symfony-console-output-formatter.php',
+        'vendor/symfony/console/Helper/ProgressIndicator.php' => '.typephp/build/symfony-console-progress-indicator.php',
+        'vendor/symfony/console/Helper/QuestionHelper.php' => '.typephp/build/symfony-console-question-helper.php',
+        'vendor/symfony/console/Helper/SymfonyQuestionHelper.php' => '.typephp/build/symfony-console-symfony-question-helper.php',
+        'vendor/symfony/console/Output/AnsiColorMode.php' => '.typephp/build/symfony-console-ansi-color-mode.php',
+        'vendor/symfony/console/Output/ConsoleSectionOutput.php' => '.typephp/build/symfony-console-section-output.php',
+        'vendor/symfony/console/Style/SymfonyStyle.php' => '.typephp/build/symfony-console-symfony-style.php',
+        'vendor/symfony/event-dispatcher/EventDispatcherInterface.php' => '.typephp/build/symfony-event-dispatcher-interface.php',
+        'vendor/symfony/event-dispatcher/EventDispatcher.php' => '.typephp/build/symfony-event-dispatcher.php',
+        'vendor/symfony/http-foundation/AcceptHeaderItem.php' => '.typephp/build/symfony-http-foundation-accept-header-item.php',
+        'vendor/symfony/http-foundation/BinaryFileResponse.php' => '.typephp/build/symfony-http-foundation-binary-file-response.php',
+        'vendor/symfony/http-foundation/HeaderUtils.php' => '.typephp/build/symfony-http-foundation-header-utils.php',
+        'vendor/symfony/http-foundation/IpUtils.php' => '.typephp/build/symfony-http-foundation-ip-utils.php',
+        'vendor/symfony/http-foundation/RequestStack.php' => '.typephp/build/symfony-http-foundation-request-stack.php',
+        'vendor/symfony/http-foundation/ResponseHeaderBag.php' => '.typephp/build/symfony-http-foundation-response-header-bag.php',
+        'vendor/symfony/http-foundation/Session/Storage/Handler/PdoSessionHandler.php' => '.typephp/build/symfony-http-foundation-pdo-session-handler.php',
+        'vendor/symfony/http-foundation/Session/Storage/Handler/SessionHandlerFactory.php' => '.typephp/build/symfony-session-handler-factory.php',
+        'vendor/symfony/http-foundation/Session/Attribute/AttributeBag.php' => '.typephp/build/symfony-session-attribute-bag.php',
+        'vendor/symfony/http-foundation/Session/Flash/FlashBag.php' => '.typephp/build/symfony-session-flash-bag.php',
+        'vendor/symfony/http-foundation/Session/Flash/AutoExpireFlashBag.php' => '.typephp/build/symfony-session-auto-expire-flash-bag.php',
+        'vendor/symfony/http-foundation/Session/SessionBagProxy.php' => '.typephp/build/symfony-session-bag-proxy.php',
+        'vendor/symfony/http-foundation/UriSigner.php' => '.typephp/build/symfony-http-foundation-uri-signer.php',
+        'vendor/symfony/http-kernel/Controller/ControllerResolver.php' => '.typephp/build/symfony-http-kernel-controller-resolver.php',
+        'vendor/symfony/http-kernel/Exception/ControllerDoesNotReturnResponseException.php' => '.typephp/build/symfony-http-kernel-controller-no-response.php',
+        'vendor/symfony/http-kernel/EventListener/ErrorListener.php' => '.typephp/build/symfony-http-kernel-error-listener.php',
+        'vendor/symfony/http-kernel/EventListener/SessionListener.php' => '.typephp/build/symfony-http-kernel-session-listener.php',
+        'vendor/symfony/http-kernel/HttpKernelInterface.php' => '.typephp/build/symfony-http-kernel-interface.php',
+        'vendor/symfony/http-kernel/Log/Logger.php' => '.typephp/build/symfony-http-kernel-logger.php',
+        'vendor/symfony/mime/Header/AbstractHeader.php' => '.typephp/build/symfony-mime-abstract-header.php',
+        'vendor/symfony/mime/Header/ParameterizedHeader.php' => '.typephp/build/symfony-mime-parameterized-header.php',
+        'vendor/symfony/polyfill-php80/Php80.php' => '.typephp/build/symfony-php80.php',
+        'vendor/symfony/polyfill-intl-grapheme/Grapheme.php' => '.typephp/build/symfony-grapheme.php',
+        'vendor/symfony/translation/PseudoLocalizationTranslator.php' => '.typephp/build/symfony-pseudo-localization-translator.php',
+        'vendor/illuminate/bus/Batch.php' => '.typephp/build/illuminate-bus-batch.php',
+        'vendor/illuminate/collections/Enumerable.php' => '.typephp/build/illuminate-collections-enumerable.php',
+        'vendor/illuminate/collections/Traits/EnumeratesValues.php' => '.typephp/build/illuminate-collections-enumerates-values.php',
+        'vendor/illuminate/contracts/Support/Arrayable.php' => '.typephp/build/illuminate-contracts-arrayable.php',
+        'vendor/illuminate/database/Connectors/PostgresConnector.php' => '.typephp/build/illuminate-database-postgres-connector.php',
+        'vendor/illuminate/database/Concerns/BuildsWhereDateClauses.php' => '.typephp/build/illuminate-database-builds-where-date-clauses.php',
+        'vendor/illuminate/database/Query/Builder.php' => '.typephp/build/illuminate-database-query-builder.php',
+        'vendor/illuminate/database/Query/Grammars/PostgresGrammar.php' => '.typephp/build/illuminate-database-postgres-grammar.php',
+        'vendor/illuminate/database/Schema/Blueprint.php' => '.typephp/build/illuminate-database-schema-blueprint.php',
+        'vendor/illuminate/database/Eloquent/Casts/ArrayObject.php' => '.typephp/build/illuminate-eloquent-array-object.php',
+        'vendor/illuminate/database/Eloquent/Relations/Concerns/CanBeOneOfMany.php' => '.typephp/build/illuminate-eloquent-can-be-one-of-many.php',
+        'vendor/illuminate/filesystem/Filesystem.php' => '.typephp/build/illuminate-filesystem.php',
+        'vendor/illuminate/http/Client/Response.php' => '.typephp/build/illuminate-http-client-response.php',
+        'vendor/illuminate/http/Resources/Json/JsonResource.php' => '.typephp/build/illuminate-json-resource.php',
+        'vendor/illuminate/http/Resources/Json/ResourceCollection.php' => '.typephp/build/illuminate-resource-collection.php',
+        'vendor/illuminate/http/Resources/JsonApi/JsonApiResource.php' => '.typephp/build/illuminate-json-api-resource.php',
+        'vendor/symfony/http-foundation/Request.php' => '.typephp/build/symfony-http-foundation-request.php',
+        'vendor/symfony/http-foundation/File/UploadedFile.php' => '.typephp/build/symfony-http-foundation-uploaded-file.php',
+        'vendor/illuminate/redis/RedisManager.php' => '.typephp/build/illuminate-redis-manager.php',
+        'vendor/illuminate/support/Facades/Password.php' => '.typephp/build/illuminate-support-password-facade.php',
+        'vendor/illuminate/support/MultipleInstanceManager.php' => '.typephp/build/illuminate-support-multiple-instance-manager.php',
+        'vendor/illuminate/support/Sleep.php' => '.typephp/build/illuminate-support-sleep.php',
+        'vendor/illuminate/support/Str.php' => '.typephp/build/illuminate-support-str.php',
+        'vendor/nesbot/carbon/src/Carbon/CarbonInterface.php' => '.typephp/build/carbon-interface.php',
+        'vendor/nesbot/carbon/src/Carbon/Traits/Creator.php' => '.typephp/build/carbon-traits-creator.php',
+        'vendor/nesbot/carbon/src/Carbon/Traits/Date.php' => '.typephp/build/carbon-traits-date.php',
+        'vendor/nesbot/carbon/src/Carbon/Traits/Boundaries.php' => '.typephp/build/carbon-traits-boundaries.php',
+        'vendor/nesbot/carbon/src/Carbon/Traits/Comparison.php' => '.typephp/build/carbon-traits-comparison.php',
+        'vendor/nesbot/carbon/src/Carbon/Traits/Converter.php' => '.typephp/build/carbon-traits-converter.php',
+        'vendor/nesbot/carbon/src/Carbon/Traits/Difference.php' => '.typephp/build/carbon-traits-difference.php',
+        'vendor/nesbot/carbon/src/Carbon/Traits/Mixin.php' => '.typephp/build/carbon-traits-mixin.php',
+        'vendor/nesbot/carbon/src/Carbon/Traits/Options.php' => '.typephp/build/carbon-traits-options.php',
+        'vendor/nesbot/carbon/src/Carbon/Traits/Localization.php' => '.typephp/build/carbon-traits-localization.php',
+        'vendor/nesbot/carbon/src/Carbon/Traits/Rounding.php' => '.typephp/build/carbon-traits-rounding.php',
+        'vendor/nesbot/carbon/lazy/Carbon/UnprotectedDatePeriod.php' => '.typephp/build/carbon-date-period-base.php',
+        'vendor/nesbot/carbon/src/Carbon/CarbonPeriod.php' => '.typephp/build/carbon-period.php',
+        'vendor/illuminate/database/Eloquent/Concerns/HasAttributes.php' => '.typephp/build/illuminate-eloquent-has-attributes.php',
+        'vendor/illuminate/database/Eloquent/Concerns/QueriesRelationships.php' => '.typephp/build/illuminate-eloquent-queries-relationships.php',
+        'vendor/illuminate/database/Eloquent/Relations/HasOne.php' => '.typephp/build/illuminate-eloquent-has-one.php',
+        'vendor/illuminate/database/Eloquent/Relations/MorphOne.php' => '.typephp/build/illuminate-eloquent-morph-one.php',
+        'vendor/illuminate/database/Eloquent/Model.php' => '.typephp/build/illuminate-eloquent-model.php',
+        'vendor/illuminate/database/Connection.php' => '.typephp/build/illuminate-database-connection.php',
+        'vendor/illuminate/pagination/Cursor.php' => '.typephp/build/illuminate-pagination-cursor.php',
+        'vendor/illuminate/pagination/CursorPaginator.php' => '.typephp/build/illuminate-pagination-cursor-paginator.php',
+        'vendor/illuminate/pagination/LengthAwarePaginator.php' => '.typephp/build/illuminate-pagination-length-aware-paginator.php',
+        'vendor/illuminate/pagination/Paginator.php' => '.typephp/build/illuminate-pagination-paginator.php',
+        'vendor/illuminate/support/DefaultProviders.php' => '.typephp/build/illuminate-support-default-providers.php',
+        'vendor/illuminate/support/Fluent.php' => '.typephp/build/illuminate-support-fluent.php',
+        'vendor/illuminate/support/InteractsWithTime.php' => '.typephp/build/illuminate-support-interacts-with-time.php',
+        'vendor/illuminate/support/MessageBag.php' => '.typephp/build/illuminate-support-message-bag.php',
+        'vendor/illuminate/support/UriQueryString.php' => '.typephp/build/illuminate-support-uri-query-string.php',
+        'vendor/illuminate/support/ValidatedInput.php' => '.typephp/build/illuminate-support-validated-input.php',
+        'vendor/symfony/cache/Traits/AbstractAdapterTrait.php' => '.typephp/build/symfony-cache-abstract-adapter-trait.php',
+        'vendor/symfony/cache/Traits/ValueWrapper.php' => '.typephp/build/symfony-cache-value-wrapper.php',
+        'vendor/symfony/cache/CacheItem.php' => '.typephp/build/symfony-cache-item.php',
+        'vendor/webman/database/src/support/Model.php' => '.typephp/build/webman-database-model.php',
+        'vendor/webman/database/src/support/Db.php' => '.typephp/build/webman-database-db.php',
+        'vendor/webman/database/src/Initializer.php' => '.typephp/build/webman-database-initializer.php',
+        'vendor/webman/database/src/DatabaseManager.php' => '.typephp/build/webman-database-manager.php',
+        'vendor/webman/think-orm/src/Initializer.php' => '.typephp/build/webman-think-orm-initializer.php',
+        'vendor/webman/think-orm/src/DbManager.php' => '.typephp/build/webman-think-orm-db-manager.php',
+        'vendor/topthink/think-orm/src/Model.php' => '.typephp/build/think-orm-model.php',
+        'vendor/topthink/think-orm/src/model/concern/Attribute.php' => '.typephp/build/think-orm-attribute.php',
+        'vendor/topthink/think-orm/src/model/concern/Conversion.php' => '.typephp/build/think-orm-conversion.php',
+        'vendor/topthink/think-orm/src/model/concern/RelationShip.php' => '.typephp/build/think-orm-relation-ship.php',
+        'vendor/topthink/think-orm/src/model/concern/TimeStamp.php' => '.typephp/build/think-orm-time-stamp.php',
+        'vendor/topthink/think-validate/src/Validate.php' => '.typephp/build/think-validate.php',
+        'vendor/topthink/think-orm/src/db/BaseQuery.php' => '.typephp/build/think-orm-base-query.php',
+        'vendor/topthink/think-orm/src/db/BaseBuilder.php' => '.typephp/build/think-orm-base-builder.php',
+        'vendor/topthink/think-orm/src/db/Builder.php' => '.typephp/build/think-orm-builder.php',
+        'vendor/topthink/think-orm/src/db/builder/Mysql.php' => '.typephp/build/think-orm-mysql-builder.php',
+        'vendor/topthink/think-orm/src/db/concern/WhereQuery.php' => '.typephp/build/think-orm-where-query.php',
+        'vendor/topthink/think-orm/src/db/Connection.php' => '.typephp/build/think-orm-connection.php',
+        'vendor/topthink/think-orm/src/db/concern/ModelRelationQuery.php' => '.typephp/build/think-orm-model-relation-query.php',
+        'vendor/topthink/think-orm/src/db/concern/ResultOperation.php' => '.typephp/build/think-orm-result-operation.php',
+        'vendor/topthink/think-orm/src/db/Fetch.php' => '.typephp/build/think-orm-fetch.php',
+        'vendor/topthink/think-orm/src/db/PDOConnection.php' => '.typephp/build/think-orm-pdo-connection.php',
+        'vendor/brick/math/src/BigInteger.php' => '.typephp/build/brick-math-big-integer.php',
+        'vendor/brick/math/src/Internal/Calculator.php' => '.typephp/build/brick-math-calculator.php',
+        'vendor/brick/math/src/Internal/Calculator/NativeCalculator.php' => '.typephp/build/brick-math-native-calculator.php',
+        'vendor/guzzlehttp/psr7/src/Query.php' => '.typephp/build/guzzle-psr7-query.php',
+        'vendor/guzzlehttp/psr7/src/StreamWrapper.php' => '.typephp/build/guzzle-psr7-stream-wrapper.php',
     ];
 
     /**
@@ -135,7 +482,17 @@ class ProjectGenerator
     public const REF_CAPTURE_SOURCES = [
         'vendor/workerman/webman-framework/src/Route/Route.php' => '.typephp/build/webman-route.php',
         'vendor/workerman/coroutine/src/Barrier/Fiber.php' => '.typephp/build/coroutine-barrier-fiber.php',
+        'vendor/workerman/coroutine/src/Parallel.php' => '.typephp/build/coroutine-parallel.php',
         'vendor/workerman/coroutine/src/Channel/Fiber.php' => '.typephp/build/coroutine-channel-fiber.php',
+        'vendor/guzzlehttp/guzzle/src/Handler/CurlFactory.php' => '.typephp/build/guzzle-curl-factory.php',
+        'vendor/guzzlehttp/guzzle/src/Handler/StreamHandler.php' => '.typephp/build/guzzle-stream-handler.php',
+        'vendor/guzzlehttp/guzzle/src/MessageFormatter.php' => '.typephp/build/guzzle-message-formatter.php',
+        'vendor/guzzlehttp/guzzle/src/Pool.php' => '.typephp/build/guzzle-pool.php',
+        'vendor/guzzlehttp/promises/src/Utils.php' => '.typephp/build/guzzle-promises-utils.php',
+        'vendor/illuminate/collections/Arr.php' => '.typephp/build/illuminate-collections-arr.php',
+        'vendor/illuminate/collections/Collection.php' => '.typephp/build/illuminate-collections-collection.php',
+        'vendor/illuminate/collections/LazyCollection.php' => '.typephp/build/illuminate-collections-lazy-collection.php',
+        'vendor/symfony/http-foundation/Session/Storage/MetadataBag.php' => '.typephp/build/symfony-session-metadata-bag.php',
     ];
 
     /**
@@ -148,66 +505,175 @@ class ProjectGenerator
         // 回调消耗已用参数。改为按值捕获 $parameters + 按引用捕获未初始化的
         // $remaining（首次回调内拷贝，回调未执行时回退为完整参数表拼查询串）。
         'vendor/workerman/webman-framework/src/Route/Route.php' => [
-            '        $path = preg_replace_callback(\'/\\{(.*?)(?:\\:[^\\}]*?)*?\\}/\', function ($matches) use (&$parameters) {' . "\r\n"
-            . '            if (!$parameters) {' . "\r\n"
-            . '                return $matches[0];' . "\r\n"
-            . '            }' . "\r\n"
-            . '            if (isset($parameters[$matches[1]])) {' . "\r\n"
-            . '                $value = $parameters[$matches[1]];' . "\r\n"
-            . '                unset($parameters[$matches[1]]);' . "\r\n"
-            . '                return $value;' . "\r\n"
-            . '            }' . "\r\n"
-            . '            $key = key($parameters);' . "\r\n"
-            . '            if (is_int($key)) {' . "\r\n"
-            . '                $value = $parameters[$key];' . "\r\n"
-            . '                unset($parameters[$key]);' . "\r\n"
-            . '                return $value;' . "\r\n"
-            . '            }' . "\r\n"
-            . '            return $matches[0];' . "\r\n"
-            . '        }, $path);' . "\r\n"
-            . '        return count($parameters) > 0 ? $path . \'?\' . http_build_query($parameters) : $path;'
-            => '        $path = preg_replace_callback(\'/\\{(.*?)(?:\\:[^\\}]*?)*?\\}/\', function ($matches) use ($parameters, &$remaining) {' . "\r\n"
-                . '            if ($remaining === null) {' . "\r\n"
-                . '                $remaining = $parameters;' . "\r\n"
-                . '            }' . "\r\n"
-                . '            if (!$remaining) {' . "\r\n"
-                . '                return $matches[0];' . "\r\n"
-                . '            }' . "\r\n"
-                . '            if (isset($remaining[$matches[1]])) {' . "\r\n"
-                . '                $value = $remaining[$matches[1]];' . "\r\n"
-                . '                unset($remaining[$matches[1]]);' . "\r\n"
-                . '                return $value;' . "\r\n"
-                . '            }' . "\r\n"
-                . '            $key = key($remaining);' . "\r\n"
-                . '            if (is_int($key)) {' . "\r\n"
-                . '                $value = $remaining[$key];' . "\r\n"
-                . '                unset($remaining[$key]);' . "\r\n"
-                . '                return $value;' . "\r\n"
-                . '            }' . "\r\n"
-                . '            return $matches[0];' . "\r\n"
-                . '        }, $path);' . "\r\n"
-                . '        if ($remaining === null) {' . "\r\n"
-                . '            $remaining = $parameters;' . "\r\n"
-                . '        }' . "\r\n"
-                . '        return count($remaining) > 0 ? $path . \'?\' . http_build_query($remaining) : $path;',
+            '        $path = preg_replace_callback(\'/\\{(.*?)(?:\\:[^\\}]*?)*?\\}/\', function ($matches) use (&$parameters) {'
+                . "\r\n"
+                . '            if (!$parameters) {'
+                . "\r\n"
+                . '                return $matches[0];'
+                . "\r\n"
+                . '            }'
+                . "\r\n"
+                . '            if (isset($parameters[$matches[1]])) {'
+                . "\r\n"
+                . '                $value = $parameters[$matches[1]];'
+                . "\r\n"
+                . '                unset($parameters[$matches[1]]);'
+                . "\r\n"
+                . '                return $value;'
+                . "\r\n"
+                . '            }'
+                . "\r\n"
+                . '            $key = key($parameters);'
+                . "\r\n"
+                . '            if (is_int($key)) {'
+                . "\r\n"
+                . '                $value = $parameters[$key];'
+                . "\r\n"
+                . '                unset($parameters[$key]);'
+                . "\r\n"
+                . '                return $value;'
+                . "\r\n"
+                . '            }'
+                . "\r\n"
+                . '            return $matches[0];'
+                . "\r\n"
+                . '        }, $path);'
+                . "\r\n"
+                . '        return count($parameters) > 0 ? $path . \'?\' . http_build_query($parameters) : $path;' =>
+                '        $path = preg_replace_callback(\'/\\{(.*?)(?:\\:[^\\}]*?)*?\\}/\', function ($matches) use ($parameters, &$remaining) {'
+                    . "\r\n"
+                    . '            if ($remaining === null) {'
+                    . "\r\n"
+                    . '                $remaining = $parameters;'
+                    . "\r\n"
+                    . '            }'
+                    . "\r\n"
+                    . '            if (!$remaining) {'
+                    . "\r\n"
+                    . '                return $matches[0];'
+                    . "\r\n"
+                    . '            }'
+                    . "\r\n"
+                    . '            if (isset($remaining[$matches[1]])) {'
+                    . "\r\n"
+                    . '                $value = $remaining[$matches[1]];'
+                    . "\r\n"
+                    . '                unset($remaining[$matches[1]]);'
+                    . "\r\n"
+                    . '                return $value;'
+                    . "\r\n"
+                    . '            }'
+                    . "\r\n"
+                    . '            $key = key($remaining);'
+                    . "\r\n"
+                    . '            if (is_int($key)) {'
+                    . "\r\n"
+                    . '                $value = $remaining[$key];'
+                    . "\r\n"
+                    . '                unset($remaining[$key]);'
+                    . "\r\n"
+                    . '                return $value;'
+                    . "\r\n"
+                    . '            }'
+                    . "\r\n"
+                    . '            return $matches[0];'
+                    . "\r\n"
+                    . '        }, $path);'
+                    . "\r\n"
+                    . '        if ($remaining === null) {'
+                    . "\r\n"
+                    . '            $remaining = $parameters;'
+                    . "\r\n"
+                    . '        }'
+                    . "\r\n"
+                    . '        return count($remaining) > 0 ? $path . \'?\' . http_build_query($remaining) : $path;',
         ],
         // Barrier/Fiber::wait() 的 &$resumed 无外层赋值 → 捕获为 REF 槽，删除
         // `$resumed = false;` 即可。$timerId 则先被 `Timer::delay()` 返回值定型为
         // Int 再被引用捕获（v0.8 禁止），而闭包内只读不写——改为按值捕获（捕获点
         // 即赋值后，值恒等），并保留 `$timerId = null;` 保证未启动计时器时变量已定义。
         'vendor/workerman/coroutine/src/Barrier/Fiber.php' => [
-            '        $resumed = false;' . "\r\n"
-            . '        $timerId = null;' . "\r\n"
-            => '        $timerId = null;' . "\r\n",
-            'function() use ($coroutine, &$resumed, &$timerId) {'
-            => 'function() use ($coroutine, &$resumed, $timerId) {',
+            'public static function wait(object &$barrier, int $timeout = -1): void' => 'public static function wait(mixed &$barrier, int $timeout = -1): void',
+            '        $resumed = false;' . "\r\n" . '        $timerId = null;' . "\r\n" =>
+                '        $timerId = null;' . "\r\n",
+            'function() use ($coroutine, &$resumed, &$timerId) {' => 'function() use ($coroutine, &$resumed, $timerId) {',
+        ],
+        'vendor/workerman/coroutine/src/Parallel.php' => [
+            '        $barrier = Barrier::create();' =>
+                '        $barrierState = new \stdClass();' . "\n" . '        $barrierState->value = Barrier::create();',
+            '            $barrierRef->value = $barrier;' => '            $barrierRef->value = $barrierState->value;',
+            '        Barrier::wait($barrier);' => '        Barrier::wait($barrierState->value);',
         ],
         // Channel/Fiber 的 push()/pop()：&$timedOut 无外层赋值，删除初始化即为
         // REF 槽；$timerId 无引用捕获、且需保证条件赋值路径上已定义，保留 null 初始化。
         'vendor/workerman/coroutine/src/Channel/Fiber.php' => [
-            '            $timedOut = false;' . "\r\n"
-            . '            $timerId = null;' . "\r\n"
-            => '            $timerId = null;' . "\r\n",
+            '            $timedOut = false;' . "\r\n" . '            $timerId = null;' . "\r\n" =>
+                '            $timerId = null;' . "\r\n",
+        ],
+        'vendor/guzzlehttp/guzzle/src/Handler/CurlFactory.php' => [
+            "        \$startingResponse = false;\n        \$collectingTrailers = false;\n" => '',
+            "        static \$options = null;\n\n        if (\$options !== null) {\n            return \$options;\n        }\n\n" => '',
+        ],
+        'vendor/guzzlehttp/guzzle/src/Handler/StreamHandler.php' => [
+            "        \$errors = [];\n        \\set_error_handler" => '        \set_error_handler',
+            "            \\restore_error_handler();\n        }\n\n        if (!\$resource) {" =>
+                "            \\restore_error_handler();\n        }\n\n"
+                    . "        if (!isset(\$errors)) {\n            \$errors = [];\n        }\n\n"
+                    . "        if (!\$resource) {",
+        ],
+        'vendor/guzzlehttp/guzzle/src/MessageFormatter.php' => [
+            "        \$cache = [];\n\n        \$result = \\preg_replace_callback(" => '        $result = \preg_replace_callback(',
+            "                                : 'NULL';\n                        }\n                }" => "                                : 'NULL';\n                        }\n\n                        break;\n                }",
+        ],
+        'vendor/guzzlehttp/guzzle/src/Pool.php' => [
+            'private static function cmpCallback(array &$options, string $name, array &$results): void' => 'private static function cmpCallback(array &$options, string $name, mixed &$results): void',
+        ],
+        'vendor/guzzlehttp/promises/src/Utils.php' => [
+            "        \$results = [];\n        \$promise = Each::of(" => '        $promise = Each::of(',
+            "        \$results = [];\n        \$rejections = [];\n\n        return Each::of(" => '        return Each::of(',
+            "        \$results = [];\n\n        return Each::of(" => '        return Each::of(',
+            "        )->then(function () use (&\$results) {\n            ksort(\$results);" =>
+                "        )->then(function () use (&\$results) {\n"
+                    . "            if (!isset(\$results)) {\n                \$results = [];\n            }\n"
+                    . '            ksort($results);',
+            "            function () use (&\$results, &\$rejections, \$count) {\n"
+                . "                if (count(\$results) !== \$count) {" =>
+                "            function () use (&\$results, &\$rejections, \$count) {\n"
+                    . "                if (!isset(\$results)) {\n                    \$results = [];\n                }\n"
+                    . "                if (!isset(\$rejections)) {\n                    \$rejections = [];\n                }\n"
+                    . "                if (count(\$results) !== \$count) {",
+            'use ($recursive, &$promises)' => 'use ($recursive, $promises)',
+        ],
+        'vendor/symfony/http-foundation/Session/Storage/MetadataBag.php' => [
+            'public function initialize(array &$array): void' => 'public function initialize(mixed &$array): void',
+        ],
+        'vendor/illuminate/collections/Arr.php' => [
+            "        \$results = [];\n\n        \$flatten = function" => '        $flatten = function',
+            '        $flatten = function ($data, $prefix, $currentDepth) use (&$results, &$flatten, $depth): void {' => '        $flatten = function ($data, $prefix, $currentDepth, $recurse) use (&$results, $depth): void {',
+            "                    \$flatten(\$value, \$newKey.'.', \$currentDepth + 1);" => "                    \$recurse(\$value, \$newKey.'.', \$currentDepth + 1, \$recurse);",
+            '        $flatten($array, $prepend, 0);' => '        $flatten($array, $prepend, 0, $flatten);',
+            "        \$flatten = null;\n\n        return \$results;" =>
+                "        unset(\$flatten);\n\n"
+                    . "        if (!isset(\$results)) {\n            \$results = [];\n        }\n\n"
+                    . '        return $results;',
+        ],
+        'vendor/illuminate/collections/Collection.php' => [
+            "        \$exists = [];\n\n        return \$this->reject(" => '        return $this->reject(',
+            'fn () => new static(func_get_args())' => 'fn (...$values) => new static($values)',
+        ],
+        // sliding() 的生成器内部再创建闭包并按引用捕获 $chunk。tap() 会同步
+        // 执行回调并返回原集合，故可等价展开为保存窗口、切片、再 yield。
+        'vendor/illuminate/collections/LazyCollection.php' => [
+            '                    yield (new static($chunk))->tap(function () use (&$chunk, $step) {'
+                . "\n"
+                . '                        $chunk = array_slice($chunk, $step, null, true);'
+                . "\n"
+                . '                    });' =>
+                '                    $window = new static($chunk);'
+                    . "\n"
+                    . '                    $chunk = array_slice($chunk, $step, null, true);'
+                    . "\n"
+                    . '                    yield $window;',
         ],
     ];
 
@@ -216,218 +682,2726 @@ class ProjectGenerator
      * 搜索串为 vendor 源码中的精确字面量；未匹配时静默跳过（版本差异容忍）。
      */
     protected const SWITCH_TERMINAL_REPLACEMENTS = [
+        'vendor/symfony/service-contracts/ServiceSubscriberTrait.php' => [
+            'trigger_deprecation(\'symfony/contracts\', \'v3.5\', \'"%s" is deprecated, use "ServiceMethodsSubscriberTrait" instead.\', ServiceSubscriberTrait::class);' => '',
+        ],
+        'vendor/webman/console/src/Application.php' => [
+            "ini_set('display_errors', 'on');" => '',
+            'error_reporting(E_ALL);' => '',
+        ],
+        'app/process/Monitor.php' => [
+            '$iterator = [new SplFileInfo($monitorDir)];' => '$iterator = new \IteratorIterator(new \ArrayIterator([new SplFileInfo($monitorDir)]));',
+            '$iterator = new RecursiveIteratorIterator($dirIterator);' => '$iterator = new \IteratorIterator(new RecursiveIteratorIterator($dirIterator));',
+            '$this->ppid = function_exists(\'posix_getppid\') ? posix_getppid() : 0;' => '$this->ppid = function_exists(\'posix_getppid\') ? (int) posix_getppid() : 0;',
+        ],
+        'vendor/godruoyi/php-snowflake/src/Snowflake.php' => [
+            'return floor(microtime(true) * 1000) | 0;' => 'return (int) floor(microtime(true) * 1000);',
+        ],
+        'vendor/godruoyi/php-snowflake/src/Sonyflake.php' => [
+            '$elapsedTime = floor(($this->getCurrentMillisecond() - $millisecond) / 10) | 0;' => '$elapsedTime = (int) floor(($this->getCurrentMillisecond() - $millisecond) / 10);',
+            'return floor(($this->getCurrentMillisecond() - $this->getStartTimeStamp()) / 10) | 0;' => 'return (int) floor(($this->getCurrentMillisecond() - $this->getStartTimeStamp()) / 10);',
+        ],
+        'vendor/guzzlehttp/guzzle/src/Handler/CurlMultiHandler.php' => [
+            '        static $options = null;'
+                . "\n\n"
+                . '        if ($options !== null) {'
+                . "\n"
+                . '            return $options;'
+                . "\n"
+                . '        }'
+                . "\n\n"
+                . '        $options = [];' => '        $options = [];',
+        ],
+        'vendor/workerman/coroutine/src/Pool.php' => [
+            '        $placeholder = new stdClass;' =>
+                '        if (!Coroutine::isCoroutine()) {'
+                    . "\n"
+                    . '            $connection = ($this->connectionCreateHandler)();'
+                    . "\n"
+                    . '            if (!$this->isValidConnection($connection)) {'
+                    . "\n"
+                    . "                throw new PoolException('CreateConnection failed, expected a connection object, but got ' . gettype(\$connection) . '.');"
+                    . "\n"
+                    . '            }'
+                    . "\n"
+                    . '            $timestamp = time();'
+                    . "\n"
+                    . '            $this->connections->offsetSet($connection, $timestamp);'
+                    . "\n"
+                    . '            $this->lastUsedTimes->offsetSet($connection, $timestamp);'
+                    . "\n"
+                    . '            $this->lastHeartbeatTimes->offsetSet($connection, $timestamp);'
+                    . "\n"
+                    . '            return $connection;'
+                    . "\n"
+                    . '        }'
+                    . "\n"
+                    . '        $placeholder = new stdClass;',
+            '        $this->connections[$connection] = $this->lastUsedTimes[$connection] = $this->lastHeartbeatTimes[$connection] = time();' =>
+                '        $timestamp = time();'
+                    . "\n"
+                    . '        $this->connections->offsetSet($connection, $timestamp);'
+                    . "\n"
+                    . '        $this->lastUsedTimes->offsetSet($connection, $timestamp);'
+                    . "\n"
+                    . '        $this->lastHeartbeatTimes->offsetSet($connection, $timestamp);',
+        ],
+        'vendor/workerman/workerman/src/Protocols/Websocket.php' => [
+            'foreach ($connection->headers as $header) {' => 'foreach ($connection->headers as $responseHeader) {',
+            'strpbrk($header, "\r\n")' => 'strpbrk($responseHeader, "\r\n")',
+            "stripos(\$header, 'Sec-WebSocket-Extensions:')" => "stripos(\$responseHeader, 'Sec-WebSocket-Extensions:')",
+            "stripos(\$header, 'permessage-deflate')" => "stripos(\$responseHeader, 'permessage-deflate')",
+            '$handshakeMessage .= "$header\r\n";' => '$handshakeMessage .= "$responseHeader\r\n";',
+        ],
+        'vendor/zoujingli/ip2region/XdbSearcher.php' => [
+            '            $val = sprintf("%u", $val);' => '            return sprintf("%u", $val);',
+        ],
         'vendor/workerman/webman-framework/src/App.php' => [
+            // PHP 允许向用户闭包传入额外参数；TypePHP 生成的闭包严格校验参数数量。
+            // Webman 会统一将 Request（部分错误路径还会带 status）传给缓存 callback。
+            '        return static function () use ($allowHeader) {' => '        return static function (...$arguments) use ($allowHeader) {',
+            '        return Route::getFallback($plugin, $status) ?: function () {' => '        return Route::getFallback($plugin, $status) ?: function (...$arguments) {',
+            '            static::collectCallbacks($key, [function () use ($file) {' => '            static::collectCallbacks($key, [function (...$arguments) use ($file) {',
             // getReflector() 同一变量 `$reflector` 在两个分支分别 new ReflectionFunction /
             // ReflectionMethod，TypePHP 的类型化对象局部变量禁止跨类重赋值。改为分支内
             // 独立变量 + 提前 return，缓存写入逻辑随分支各带一份，语义不变。
-            '        if ($call instanceof Closure || is_string($call)) {' . "\n"
-            . '            $reflector = new ReflectionFunction($call);' . "\n"
-            . '        } else {' . "\n"
-            . '            $reflector = new ReflectionMethod($call[0], $call[1]);' . "\n"
-            . '        }' . "\n"
-            . "\n"
-            . '        if ($cacheKey !== null) {' . "\n"
-            . '            static::$reflectorCache[$cacheKey] = $reflector;' . "\n"
-            . '            if (count(static::$reflectorCache) > 1024) {' . "\n"
-            . '                unset(static::$reflectorCache[key(static::$reflectorCache)]);' . "\n"
-            . '            }' . "\n"
-            . '        }' . "\n"
-            . "\n"
-            . '        return $reflector;'
-            => '        if ($call instanceof Closure || is_string($call)) {' . "\n"
-                . '            $reflectorFunction = new ReflectionFunction($call);' . "\n"
-                . '            if ($cacheKey !== null) {' . "\n"
-                . '                static::$reflectorCache[$cacheKey] = $reflectorFunction;' . "\n"
-                . '                if (count(static::$reflectorCache) > 1024) {' . "\n"
-                . '                    unset(static::$reflectorCache[key(static::$reflectorCache)]);' . "\n"
-                . '                }' . "\n"
-                . '            }' . "\n"
-                . '            return $reflectorFunction;' . "\n"
-                . '        }' . "\n"
-                . "\n"
-                . '        $reflectorMethod = new ReflectionMethod($call[0], $call[1]);' . "\n"
-                . '        if ($cacheKey !== null) {' . "\n"
-                . '            static::$reflectorCache[$cacheKey] = $reflectorMethod;' . "\n"
-                . '            if (count(static::$reflectorCache) > 1024) {' . "\n"
-                . '                unset(static::$reflectorCache[key(static::$reflectorCache)]);' . "\n"
-                . '            }' . "\n"
-                . '        }' . "\n"
-                . '        return $reflectorMethod;',
+            '        if ($call instanceof Closure || is_string($call)) {'
+                . "\n"
+                . '            $reflector = new ReflectionFunction($call);'
+                . "\n"
+                . '        } else {'
+                . "\n"
+                . '            $reflector = new ReflectionMethod($call[0], $call[1]);'
+                . "\n"
+                . '        }'
+                . "\n"
+                . "\n"
+                . '        if ($cacheKey !== null) {'
+                . "\n"
+                . '            static::$reflectorCache[$cacheKey] = $reflector;'
+                . "\n"
+                . '            if (count(static::$reflectorCache) > 1024) {'
+                . "\n"
+                . '                unset(static::$reflectorCache[key(static::$reflectorCache)]);'
+                . "\n"
+                . '            }'
+                . "\n"
+                . '        }'
+                . "\n"
+                . "\n"
+                . '        return $reflector;' =>
+                '        if ($call instanceof Closure || is_string($call)) {'
+                    . "\n"
+                    . '            $reflectorFunction = new ReflectionFunction($call);'
+                    . "\n"
+                    . '            if ($cacheKey !== null) {'
+                    . "\n"
+                    . '                static::$reflectorCache[$cacheKey] = $reflectorFunction;'
+                    . "\n"
+                    . '                if (count(static::$reflectorCache) > 1024) {'
+                    . "\n"
+                    . '                    unset(static::$reflectorCache[key(static::$reflectorCache)]);'
+                    . "\n"
+                    . '                }'
+                    . "\n"
+                    . '            }'
+                    . "\n"
+                    . '            return $reflectorFunction;'
+                    . "\n"
+                    . '        }'
+                    . "\n"
+                    . "\n"
+                    . '        $reflectorMethod = new ReflectionMethod($call[0], $call[1]);'
+                    . "\n"
+                    . '        if ($cacheKey !== null) {'
+                    . "\n"
+                    . '            static::$reflectorCache[$cacheKey] = $reflectorMethod;'
+                    . "\n"
+                    . '            if (count(static::$reflectorCache) > 1024) {'
+                    . "\n"
+                    . '                unset(static::$reflectorCache[key(static::$reflectorCache)]);'
+                    . "\n"
+                    . '            }'
+                    . "\n"
+                    . '        }'
+                    . "\n"
+                    . '        return $reflectorMethod;',
             '                if (!method_exists($data, \'__toString\')) {'
-            . "\n"
-            . '                    return \'Object\';'
-            . "\n"
-            . '                }'
-            . "\n"
-            . '            default:'
-            => '                if (!method_exists($data, \'__toString\')) {'
                 . "\n"
                 . '                    return \'Object\';'
                 . "\n"
                 . '                }'
                 . "\n"
-                . '                return (string)$data;'
-                . "\n"
-                . '            default:',
+                . '            default:' =>
+                '                if (!method_exists($data, \'__toString\')) {'
+                    . "\n"
+                    . '                    return \'Object\';'
+                    . "\n"
+                    . '                }'
+                    . "\n"
+                    . '                return (string)$data;'
+                    . "\n"
+                    . '            default:',
+        ],
+        'vendor/workerman/webman-framework/src/Config.php' => [
+            'if (is_dir($file) ||' => 'if ($file->isDir() ||',
+            'substr($file, 0, -4)' => 'substr((string) $file, 0, -4)',
+            '$config = include $file;' => '$config = include (string) $file;',
         ],
         'vendor/monolog/monolog/src/Monolog/Utils.php' => [
-            '                $msg = \'Unknown error\';'
-            . "\n"
-            . '        }'
-            => '                $msg = \'Unknown error\';'
-                . "\n"
-                . '                break;'
-                . "\n"
-                . '        }',
+            '                $msg = \'Unknown error\';' . "\n" . '        }' =>
+                '                $msg = \'Unknown error\';' . "\n" . '                break;' . "\n" . '        }',
             '            case \'g\':'
-            . "\n"
-            . '                $val *= 1024;'
-            . "\n"
-            . '            case \'m\':'
-            . "\n"
-            . '                $val *= 1024;'
-            . "\n"
-            . '            case \'k\':'
-            . "\n"
-            . '                $val *= 1024;'
-            . "\n"
-            . '        }'
-            => '            case \'g\':'
                 . "\n"
                 . '                $val *= 1024;'
                 . "\n"
+                . '            case \'m\':'
+                . "\n"
                 . '                $val *= 1024;'
                 . "\n"
+                . '            case \'k\':'
+                . "\n"
                 . '                $val *= 1024;'
                 . "\n"
-                . '                break;'
+                . '        }' =>
+                '            case \'g\':'
+                    . "\n"
+                    . '                $val *= 1024;'
+                    . "\n"
+                    . '                $val *= 1024;'
+                    . "\n"
+                    . '                $val *= 1024;'
+                    . "\n"
+                    . '                break;'
+                    . "\n"
+                    . '            case \'m\':'
+                    . "\n"
+                    . '                $val *= 1024;'
+                    . "\n"
+                    . '                $val *= 1024;'
+                    . "\n"
+                    . '                break;'
+                    . "\n"
+                    . '            case \'k\':'
+                    . "\n"
+                    . '                $val *= 1024;'
+                    . "\n"
+                    . '                break;'
+                    . "\n"
+                    . '        }',
+        ],
+        'vendor/monolog/monolog/src/Monolog/Handler/BrowserConsoleHandler.php' => [
+            '    protected static $records = [];' =>
+                '    protected static $records = [];'
+                    . "\n"
+                    . '    private static array $aotColors = [\'blue\', \'green\', \'red\', \'magenta\', \'orange\', \'black\', \'grey\'];'
+                    . "\n"
+                    . '    private static array $aotLabels = [];',
+            '        static $colors = [\'blue\', \'green\', \'red\', \'magenta\', \'orange\', \'black\', \'grey\'];'
                 . "\n"
-                . '            case \'m\':'
+                . '        static $labels = [];' => '',
+            'function (array $m) use ($string, &$colors, &$labels)' => 'function (array $m) use ($string)',
+            '$labels[$string] = $colors[count($labels) % count($colors)];' => 'self::$aotLabels[$string] = self::$aotColors[count(self::$aotLabels) % count(self::$aotColors)];',
+            '$color = $labels[$string];' => '$color = self::$aotLabels[$string];',
+            '!isset($labels[$string])' => '!isset(self::$aotLabels[$string])',
+        ],
+        'vendor/nelexa/zip/src/IO/Filter/Cipher/Pkware/PKCryptContext.php' => [
+            '        $byte = 0;'
+                . "\n\n"
+                . '        foreach (unpack(\'C*\', $header) as $byte) {'
                 . "\n"
-                . '                $val *= 1024;'
+                . '            $byte = ($byte ^ $this->decryptByte()) & 0xFF;'
                 . "\n"
-                . '                $val *= 1024;'
+                . '            $this->updateKeys($byte);'
+                . "\n"
+                . '        }'
+                . "\n\n"
+                . '        if ($byte !== $checkByte) {' =>
+                '        $lastByte = 0;'
+                    . "\n\n"
+                    . '        foreach (unpack(\'C*\', $header) as $encryptedByte) {'
+                    . "\n"
+                    . '            $lastByte = ($encryptedByte ^ $this->decryptByte()) & 0xFF;'
+                    . "\n"
+                    . '            $this->updateKeys($lastByte);'
+                    . "\n"
+                    . '        }'
+                    . "\n\n"
+                    . '        if ($lastByte !== $checkByte) {',
+        ],
+        'vendor/nelexa/zip/src/Model/ZipEntry.php' => [
+            'ZipCompressionLevel::SUPER_FAST' => '1',
+            'ZipCompressionLevel::FAST' => '2',
+            'ZipCompressionLevel::NORMAL' => '5',
+            'ZipCompressionLevel::MAXIMUM' => '9',
+            'ZipCompressionLevel::LEVEL_MIN' => '1',
+            'ZipCompressionLevel::LEVEL_MAX' => '9',
+        ],
+        'vendor/nelexa/zip/src/ZipFile.php' => [
+            'ZipCompressionLevel::NORMAL' => '5',
+            'foreach ($lastModDirs as $dir => $lastMod) {' . "\n" . '            touch($dir, $lastMod);' =>
+                'foreach ($lastModDirs as $lastModDir => $lastMod) {'
+                    . "\n"
+                    . '            touch($lastModDir, $lastMod);',
+        ],
+        'vendor/nelexa/zip/src/Util/FilesUtil.php' => [
+            "                default:\n"
+                . "                    \$escaping = false;\n"
+                . '                    $regexPattern .= $currentChar;' =>
+                "                default:\n"
+                    . "                    \$escaping = false;\n"
+                    . "                    \$regexPattern .= \$currentChar;\n"
+                    . '                    break;',
+            "        if (\$recursive) {\n"
+                . "            \$directoryIterator = new \\RecursiveDirectoryIterator(\$inputDir);\n\n"
+                . "            if (!empty(\$ignoreFiles)) {\n"
+                . "                \$directoryIterator = new IgnoreFilesRecursiveFilterIterator(\$directoryIterator, \$ignoreFiles);\n"
+                . "            }\n"
+                . "            \$iterator = new \\RecursiveIteratorIterator(\$directoryIterator);\n"
+                . "        } else {\n"
+                . "            \$directoryIterator = new \\DirectoryIterator(\$inputDir);\n\n"
+                . "            if (!empty(\$ignoreFiles)) {\n"
+                . "                \$directoryIterator = new IgnoreFilesFilterIterator(\$directoryIterator, \$ignoreFiles);\n"
+                . "            }\n"
+                . "            \$iterator = new \\IteratorIterator(\$directoryIterator);\n"
+                . '        }' =>
+                "        if (\$recursive) {\n"
+                    . "            \$recursiveDirectory = new \\RecursiveDirectoryIterator(\$inputDir);\n\n"
+                    . "            if (!empty(\$ignoreFiles)) {\n"
+                    . "                \$iterator = new \\IteratorIterator(new \\RecursiveIteratorIterator(\n"
+                    . "                    new IgnoreFilesRecursiveFilterIterator(\$recursiveDirectory, \$ignoreFiles),\n"
+                    . "                ));\n"
+                    . "            } else {\n"
+                    . "                \$iterator = new \\IteratorIterator(new \\RecursiveIteratorIterator(\$recursiveDirectory));\n"
+                    . "            }\n"
+                    . "        } else {\n"
+                    . "            \$flatDirectory = new \\DirectoryIterator(\$inputDir);\n\n"
+                    . "            if (!empty(\$ignoreFiles)) {\n"
+                    . "                \$iterator = new \\IteratorIterator(new IgnoreFilesFilterIterator(\$flatDirectory, \$ignoreFiles));\n"
+                    . "            } else {\n"
+                    . "                \$iterator = new \\IteratorIterator(\$flatDirectory);\n"
+                    . "            }\n"
+                    . '        }',
+            '        if ($recursive) {'
                 . "\n"
-                . '                break;'
+                . '            $directoryIterator = new \RecursiveDirectoryIterator($folder);'
                 . "\n"
-                . '            case \'k\':'
+                . '            $iterator = new \RecursiveIteratorIterator($directoryIterator);'
                 . "\n"
-                . '                $val *= 1024;'
+                . '        } else {'
+                . "\n"
+                . '            $directoryIterator = new \DirectoryIterator($folder);'
                 . "\n"
-                . '                break;'
+                . '            $iterator = new \IteratorIterator($directoryIterator);'
                 . "\n"
-                . '        }',
+                . '        }'
+                . "\n\n"
+                . '        $regexIterator = new \RegexIterator($iterator, $pattern, \RegexIterator::MATCH);' =>
+                '        if ($recursive) {'
+                    . "\n"
+                    . '            $recursiveDirectory = new \RecursiveDirectoryIterator($folder);'
+                    . "\n"
+                    . '            $recursiveIterator = new \RecursiveIteratorIterator($recursiveDirectory);'
+                    . "\n"
+                    . '            $regexIterator = new \RegexIterator($recursiveIterator, $pattern, \RegexIterator::MATCH);'
+                    . "\n"
+                    . '        } else {'
+                    . "\n"
+                    . '            $flatDirectory = new \DirectoryIterator($folder);'
+                    . "\n"
+                    . '            $flatIterator = new \IteratorIterator($flatDirectory);'
+                    . "\n"
+                    . '            $regexIterator = new \RegexIterator($flatIterator, $pattern, \RegexIterator::MATCH);'
+                    . "\n"
+                    . '        }',
         ],
-    ];
-
-    /**
-     * 可变参数闭包补丁的字面替换规则：源文件 => [搜索串 => 替换串]。
-     * 搜索串为 vendor 源码中的精确字面量；未匹配时静默跳过（版本差异容忍）。
-     */
-    protected const VARIADIC_HANDLER_REPLACEMENTS = [
-        'vendor/workerman/workerman/src/Worker.php' => [
-            'set_error_handler(static fn (): bool => true);' => 'set_error_handler(static fn (...$__err): bool => true);',
-            'set_error_handler(function ($code, $msg) {' => 'set_error_handler(function ($code, $msg, ...$__err) {',
-            // 优雅停机/信号路径：array_walk 实传 2 参(value,key)、pcntl_signal 实传 2 参(signo,siginfo)，
-            // 补丁成可变参数避免停机/重载时抛 ArgumentCountError。
-            'array_walk($workers, static fn (Worker $worker) => $worker->stop(false));' => 'array_walk($workers, static fn (Worker $worker, ...$__walk) => $worker->stop(false));',
-            'array_walk($workerPidArray, static fn ($pid) => posix_kill($pid, $sig));' => 'array_walk($workerPidArray, static fn ($pid, ...$__walk) => posix_kill($pid, $sig));',
-            'pcntl_signal($signal, static::signalHandler(...), false);' => 'pcntl_signal($signal, static fn (...$__sig) => static::signalHandler($__sig[0]), false);',
-            // daemon 模式 resetStd()：TypePHP 嵌入式运行时把标准流标记 NO_CLOSE、禁止手动关闭，三处
-            // fclose 必抛 TypeError 令守护进程崩溃。日志重定向不依赖关闭它们——其下 fopen(stdoutFile)
-            // 已把 outputStream 重指向目标文件，故整段删除关闭段（保留一个空行）。
-            self::RESET_STD_STREAM_CLOSE_BLOCK => "\n",
-            // parseCommand 的 `case 'status'` 以 while(1) 死循环结尾后落空到 `case 'connections'`，
-            // 编译器要求 case 以终结语句收尾。循环仅经内部 exit(0) 退出，落空本为不可达死代码，
-            // 补一个不可达的 exit(0) 即满足约束且不改变行为。
-            '                    static::safeEcho("\nPress Ctrl+C to quit.\n\n");' . "\n"
-            . '                }' . "\n"
-            . '            case \'connections\':'
-            => '                    static::safeEcho("\nPress Ctrl+C to quit.\n\n");' . "\n"
-                . '                }' . "\n"
-                . '                exit(0);' . "\n"
-                . '            case \'connections\':',
+        'vendor/nesbot/carbon/src/Carbon/CarbonInterval.php' => [
+            'CarbonInterface::ONE_DAY_WORDS' => '04',
+            'CarbonInterface::TWO_DAY_WORDS' => '010',
+            'foreach ($interval as $index => &$item) {'
+                . "\n"
+                . '            $item = $transChoice($item[0], $item[1], $index, $actualParts);' =>
+                'foreach ($interval as $partIndex => &$item) {'
+                    . "\n"
+                    . '            $item = $transChoice($item[0], $item[1], $partIndex, $actualParts);',
+            'foreach ($diffIntervalArray as $index => &$unitData) {' => 'foreach ($diffIntervalArray as $skipIndex => &$unitData) {',
+            '$nextIndex = $index + 1;' => '$nextIndex = $skipIndex + 1;',
+            '        $optionalSpace = \' \';'
+                . "\n"
+                . '        $default = $this->getTranslationMessage(\'list.0\') ?? $this->getTranslationMessage(\'list\') ?? \' \';'
+                . "\n"
+                . '        /** @var bool|string $join */'
+                . "\n"
+                . '        $join = $default === \'\' ? \'\' : \' \';'
+                . "\n"
+                . '        /** @var bool|array|string $altNumbers */'
+                . "\n"
+                . '        $altNumbers = false;'
+                . "\n"
+                . '        $aUnit = false;'
+                . "\n"
+                . '        $minimumUnit = \'s\';'
+                . "\n"
+                . '        $skip = [];'
+                . "\n"
+                . '        extract($this->getForHumansInitialVariables($syntax, $short));' =>
+                '        $humanOptions = $this->getForHumansInitialVariables($syntax, $short);'
+                    . "\n"
+                    . '        $optionalSpace = \' \';'
+                    . "\n"
+                    . '        $default = $this->getTranslationMessage(\'list.0\') ?? $this->getTranslationMessage(\'list\') ?? \' \';'
+                    . "\n"
+                    . '        $join = $humanOptions[\'join\'] ?? ($default === \'\' ? \'\' : \' \');'
+                    . "\n"
+                    . '        $altNumbers = $humanOptions[\'altNumbers\'] ?? false;'
+                    . "\n"
+                    . '        $aUnit = $humanOptions[\'aUnit\'] ?? false;'
+                    . "\n"
+                    . '        $minimumUnit = $humanOptions[\'minimumUnit\'] ?? \'s\';'
+                    . "\n"
+                    . '        $skip = $humanOptions[\'skip\'] ?? [];'
+                    . "\n"
+                    . '        $syntax = $humanOptions[\'syntax\'] ?? $syntax;'
+                    . "\n"
+                    . '        $short = $humanOptions[\'short\'] ?? $short;'
+                    . "\n"
+                    . '        $parts = $humanOptions[\'parts\'] ?? $parts;'
+                    . "\n"
+                    . '        $options = $humanOptions[\'options\'] ?? $options;'
+                    . "\n"
+                    . '        $locale = $humanOptions[\'locale\'] ?? null;'
+                    . "\n"
+                    . '        $translator = $humanOptions[\'translator\'] ?? null;',
+            '        while ([$part, $value, $unit] = array_shift($parts)) {' =>
+                '        while ($partValues = array_shift($parts)) {'
+                    . "\n"
+                    . '            $part = $partValues[0];'
+                    . "\n"
+                    . '            $value = $partValues[1];'
+                    . "\n"
+                    . '            $unit = $partValues[2];',
+            'foreach ([\'years\', \'months\', \'weeks\', \'days\', \'hours\', \'minutes\', \'seconds\'] as $unit) {'
+                . "\n"
+                . '            $value = $$unit;' =>
+                'foreach ([\'years\' => $years, \'months\' => $months, \'weeks\' => $weeks, \'days\' => $days,'
+                    . ' \'hours\' => $hours, \'minutes\' => $minutes, \'seconds\' => $seconds] as $unit => $value) {',
+            '            foreach ([\'source\', \'target\'] as $key) {'
+                . "\n"
+                . '                if ($$key === \'dayz\') {'
+                . "\n"
+                . '                    $$key = \'daysExcludeWeeks\';'
+                . "\n"
+                . '                }'
+                . "\n"
+                . '            }' =>
+                '            if ($source === \'dayz\') {'
+                    . "\n"
+                    . '                $source = \'daysExcludeWeeks\';'
+                    . "\n"
+                    . '            }'
+                    . "\n"
+                    . '            if ($target === \'dayz\') {'
+                    . "\n"
+                    . '                $target = \'daysExcludeWeeks\';'
+                    . "\n"
+                    . '            }',
+            '$this->$key = $value;' => '$this->$key = $value;' . "\n\n" . '                    break;',
+            '$instance->$unit = $value;' => '$instance->$unit = $value;' . "\n\n" . '                break;',
         ],
-        'vendor/workerman/workerman/src/Connection/TcpConnection.php' => [
-            'set_error_handler(static function (int $code, string $msg): bool {' => 'set_error_handler(static function (int $code, string $msg, ...$__err): bool {',
+        'vendor/nesbot/carbon/src/Carbon/CarbonTimeZone.php' => [
+            '        return Carbon::now($this);' => '        return Carbon::now($this->getName());',
         ],
-        'vendor/workerman/workerman/src/Connection/AsyncTcpConnection.php' => [
-            'set_error_handler(fn() => false);' => 'set_error_handler(fn(...$__err) => false);',
+        'vendor/nesbot/carbon/lazy/Carbon/MessageFormatter/MessageFormatterMapperStrongType.php' => [
+            'if (!class_exists(LazyMessageFormatter::class, false)) {'
+                . "\n"
+                . '    abstract class LazyMessageFormatter implements MessageFormatterInterface' => 'abstract class LazyMessageFormatter implements MessageFormatterInterface',
+            "        }\n    }\n}" => "        }\n}",
         ],
-        'vendor/workerman/workerman/src/Events/Select.php' => [
-            'pcntl_signal($signal, fn () => $this->safeCall($this->signalEvents[$signal], [$signal]));' => 'pcntl_signal($signal, fn (...$__sig) => $this->safeCall($this->signalEvents[$signal], [$signal]));',
+        'vendor/nesbot/carbon/lazy/Carbon/TranslatorStrongType.php' => [
+            'if (!class_exists(LazyTranslator::class, false)) {'
+                . "\n"
+                . '    class LazyTranslator extends AbstractTranslator implements TranslatorStrongTypeInterface' => 'class LazyTranslator extends AbstractTranslator implements TranslatorStrongTypeInterface',
+            "        }\n    }\n}" => "        }\n}",
         ],
-        'vendor/workerman/webman-framework/src/File.php' => [
-            'set_error_handler(function ($type, $msg) use (&$error) {' => 'set_error_handler(function ($type, $msg, ...$__err) use (&$error) {',
+        'vendor/nesbot/carbon/src/Carbon/MessageFormatter/MessageFormatterMapper.php' => [
+            '// @codeCoverageIgnoreStart'
+                . "\n"
+                . '$transMethod = new ReflectionMethod(MessageFormatterInterface::class, \'format\');'
+                . "\n\n"
+                . 'require $transMethod->getParameters()[0]->hasType()'
+                . "\n"
+                . '    ? __DIR__.\'/../../../lazy/Carbon/MessageFormatter/MessageFormatterMapperStrongType.php\''
+                . "\n"
+                . '    : __DIR__.\'/../../../lazy/Carbon/MessageFormatter/MessageFormatterMapperWeakType.php\';'
+                . "\n"
+                . '// @codeCoverageIgnoreEnd' => '',
         ],
-    ];
+        'vendor/nesbot/carbon/src/Carbon/Translator.php' => [
+            '$transMethod = new ReflectionMethod('
+                . "\n"
+                . '    class_exists(TranslatorInterface::class)'
+                . "\n"
+                . '        ? TranslatorInterface::class'
+                . "\n"
+                . '        : Translation\Translator::class,'
+                . "\n"
+                . '    \'trans\','
+                . "\n"
+                . ');'
+                . "\n\n"
+                . 'require $transMethod->hasReturnType()'
+                . "\n"
+                . '    ? __DIR__.\'/../../lazy/Carbon/TranslatorStrongType.php\''
+                . "\n"
+                . '    : __DIR__.\'/../../lazy/Carbon/TranslatorWeakType.php\';' => '',
+        ],
+        'vendor/phpmailer/phpmailer/src/PHPMailer.php' => [
+            '            $encoding = false;' => '            $encoding = \'\';',
+            '        if ($this->has8bitChars(substr($address, ++$pos))) {' => '        if ($this->has8bitChars(substr($address, $pos + 1))) {',
+            '            /* @noinspection PhpMissingBreakStatementInspection */'
+                . "\n"
+                . '            case \'comment\':'
+                . "\n"
+                . '                $matchcount = preg_match_all(\'/[()"]/\', $str, $matches);'
+                . "\n"
+                . '            //fallthrough'
+                . "\n"
+                . '            case \'text\':'
+                . "\n"
+                . '            default:'
+                . "\n"
+                . '                $matchcount += preg_match_all(\'/[\000-\010\013\014\016-\037\177-\377]/\', $str, $matches);'
+                . "\n"
+                . '                break;' =>
+                '            case \'comment\':'
+                    . "\n"
+                    . '                $matchcount = preg_match_all(\'/[()"]/\', $str, $matches);'
+                    . "\n"
+                    . '                $matchcount += preg_match_all(\'/[\000-\010\013\014\016-\037\177-\377]/\', $str, $matches);'
+                    . "\n"
+                    . '                break;'
+                    . "\n"
+                    . '            case \'text\':'
+                    . "\n"
+                    . '            default:'
+                    . "\n"
+                    . '                $matchcount += preg_match_all(\'/[\000-\010\013\014\016-\037\177-\377]/\', $str, $matches);'
+                    . "\n"
+                    . '                break;',
+            '            /* @noinspection PhpMissingBreakStatementInspection */'
+                . "\n"
+                . '            case \'comment\':'
+                . "\n"
+                . '                $pattern = \'\\(\\)"\';'
+                . "\n"
+                . '            /* Intentional fall through */'
+                . "\n"
+                . '            case \'text\':'
+                . "\n"
+                . '            default:'
+                . "\n"
+                . '                //RFC 2047 section 5.1'
+                . "\n"
+                . '                //Replace every high ascii, control, =, ? and _ characters'
+                . "\n"
+                . '                $pattern = \'\\000-\\011\\013\\014\\016-\\037\\075\\077\\137\\177-\\377\' . $pattern;'
+                . "\n"
+                . '                break;' =>
+                '            case \'comment\':'
+                    . "\n"
+                    . '                $pattern = \'\\000-\\011\\013\\014\\016-\\037\\075\\077\\137\\177-\\377\\(\\)"\';'
+                    . "\n"
+                    . '                break;'
+                    . "\n"
+                    . '            case \'text\':'
+                    . "\n"
+                    . '            default:'
+                    . "\n"
+                    . '                //RFC 2047 section 5.1'
+                    . "\n"
+                    . '                //Replace every high ascii, control, =, ? and _ characters'
+                    . "\n"
+                    . '                $pattern = \'\\000-\\011\\013\\014\\016-\\037\\075\\077\\137\\177-\\377\' . $pattern;'
+                    . "\n"
+                    . '                break;',
+            '                "\n";' . "\n" . '        }' =>
+                '                "\n";' . "\n" . '                break;' . "\n" . '        }',
+        ],
+        'vendor/phpmailer/phpmailer/src/SMTP.php' => [
+            '                if (!$n) {'
+                . "\n"
+                . '                    $name = $type;'
+                . "\n"
+                . '                    $fields = $fields[0];'
+                . "\n"
+                . '                } else {'
+                . "\n"
+                . '                    $name = array_shift($fields);'
+                . "\n"
+                . '                    switch ($name) {'
+                . "\n"
+                . '                        case \'SIZE\':'
+                . "\n"
+                . '                            $fields = ($fields ? $fields[0] : 0);'
+                . "\n"
+                . '                            break;'
+                . "\n"
+                . '                        case \'AUTH\':'
+                . "\n"
+                . '                            if (!is_array($fields)) {'
+                . "\n"
+                . '                                $fields = [];'
+                . "\n"
+                . '                            }'
+                . "\n"
+                . '                            break;'
+                . "\n"
+                . '                        default:'
+                . "\n"
+                . '                            $fields = true;'
+                . "\n"
+                . '                    }'
+                . "\n"
+                . '                }'
+                . "\n"
+                . '                $this->server_caps[$name] = $fields;' =>
+                '                if (!$n) {'
+                    . "\n"
+                    . '                    $this->server_caps[$type] = $fields[0];'
+                    . "\n"
+                    . '                    continue;'
+                    . "\n"
+                    . '                }'
+                    . "\n"
+                    . '                $name = array_shift($fields);'
+                    . "\n"
+                    . '                switch ($name) {'
+                    . "\n"
+                    . '                    case \'SIZE\':'
+                    . "\n"
+                    . '                        $this->server_caps[$name] = ($fields ? $fields[0] : 0);'
+                    . "\n"
+                    . '                        break;'
+                    . "\n"
+                    . '                    case \'AUTH\':'
+                    . "\n"
+                    . '                        $this->server_caps[$name] = $fields;'
+                    . "\n"
+                    . '                        break;'
+                    . "\n"
+                    . '                    default:'
+                    . "\n"
+                    . '                        $this->server_caps[$name] = true;'
+                    . "\n"
+                    . '                }',
+        ],
+        'vendor/ramsey/collection/src/DoubleEndedQueue.php' => [
+            '    public function __construct(private readonly string $queueType, array $data = [])' => '    public function __construct(string $queueType, array $data = [])',
+            '        parent::__construct($this->queueType, $data);' => '        parent::__construct($queueType, $data);',
+        ],
+        'vendor/ramsey/uuid/src/Converter/Time/PhpTimeConverter.php' => [
+            '        $seconds = new IntegerObject($seconds);' => '        $secondsValue = new IntegerObject($seconds);',
+            '        $microseconds = new IntegerObject($microseconds);' => '        $microsecondsValue = new IntegerObject($microseconds);',
+            '$seconds->toString()' => '$secondsValue->toString()',
+            '$microseconds->toString()' => '$microsecondsValue->toString()',
+        ],
+        'vendor/topthink/think-orm/src/model/Collection.php' => [
+            'function (Model $model)' => 'function (Model $model, int|string $key)',
+        ],
+        'vendor/topthink/think-orm/src/db/BaseBuilder.php' => [
+            '        $fields = [];' . "\n" . '        $values = [];' =>
+                '        $fields = [];'
+                    . "\n"
+                    . '        $values = [];'
+                    . "\n"
+                    . '        $insertFields = [];'
+                    . "\n"
+                    . '        $hasInsertFields = false;',
+            '            if (!isset($insertFields)) {'
+                . "\n"
+                . '                $insertFields = array_keys($data);'
+                . "\n"
+                . '            }' =>
+                '            if (!$hasInsertFields) {'
+                    . "\n"
+                    . '                $insertFields = array_keys($data);'
+                    . "\n"
+                    . '                $hasInsertFields = true;'
+                    . "\n"
+                    . '            }',
+        ],
+        'vendor/topthink/think-orm/src/db/builder/Mysql.php' => [
+            '        $fields = [];' . "\n" . '        $values = [];' =>
+                '        $fields = [];'
+                    . "\n"
+                    . '        $values = [];'
+                    . "\n"
+                    . '        $insertFields = [];'
+                    . "\n"
+                    . '        $hasInsertFields = false;',
+            '            if (!isset($insertFields)) {'
+                . "\n"
+                . '                $insertFields = array_keys($data);'
+                . "\n"
+                . '            }' =>
+                '            if (!$hasInsertFields) {'
+                    . "\n"
+                    . '                $insertFields = array_keys($data);'
+                    . "\n"
+                    . '                $hasInsertFields = true;'
+                    . "\n"
+                    . '            }',
+        ],
+        'plugin/saiadmin/utils/Captcha.php' => [
+            '        $captcha->setBackgroundColor(242, 243, 245);' =>
+                '        $captcha->setBackgroundColor(242, 243, 245);'
+                    . "\n"
+                    . '        $captcha->setLineColor(180, 180, 180);',
+            '        $captcha->build(120, 36);' => '        $captcha->build(120, 36, base_path(\'vendor/webman/captcha/src/Font/captcha0.ttf\'));',
+        ],
+        'plugin/saiadmin/app/controller/LoginController.php' => [
+            '    public function captcha() : Response' => '    public function captcha(Request $request) : Response',
+        ],
+        'plugin/saiadmin/app/controller/InstallController.php' => [
+            '    public function index()' => '    public function index(Request $request)',
+        ],
+        'plugin/saiadmin/app/controller/SystemController.php' => [
+            '    public function userInfo(): Response' => '    public function userInfo(Request $request): Response',
+            '    public function dictAll(): Response' => '    public function dictAll(Request $request): Response',
+            '    public function menu(): Response' => '    public function menu(Request $request): Response',
+            '    public function getLoginLogList(): Response' => '    public function getLoginLogList(Request $request): Response',
+            '    public function getOperationLogList(): Response' => '    public function getOperationLogList(Request $request): Response',
+            '    public function clearAllCache(): Response' => '    public function clearAllCache(Request $request): Response',
+            '    public function statistics(): Response' => '    public function statistics(Request $request): Response',
+            '    public function loginChart(): Response' => '    public function loginChart(Request $request): Response',
+            '    public function loginBarChart(): Response' => '    public function loginBarChart(Request $request): Response',
+        ],
+        'plugin/saiadmin/app/controller/system/SystemPostController.php' => [
+            '    public function downloadTemplate(): Response' => '    public function downloadTemplate(Request $request): Response',
+        ],
+        'plugin/saiadmin/app/controller/system/DataBaseController.php' => [
+            '    public function source(): Response' => '    public function source(Request $request): Response',
+        ],
+        'plugin/saiadmin/app/cache/ReflectionCache.php' => [
+            '        // 反射逻辑'
+                . "\n"
+                . '        if (class_exists($controller)) {'
+                . "\n"
+                . '            $ref = new ReflectionClass($controller);'
+                . "\n"
+                . '            $data = $ref->getDefaultProperties()[\'noNeedLogin\'] ?? [];'
+                . "\n"
+                . '        } else {'
+                . "\n"
+                . '            $data = [];'
+                . "\n"
+                . '        }' =>
+                '        // TypePHP v0.8 cannot expose compiled protected defaults through ReflectionClass.'
+                    . "\n"
+                    . '        if ($controller === \plugin\saiadmin\app\controller\LoginController::class) {'
+                    . "\n"
+                    . '            $data = __SAIADMIN_LOGIN_NO_NEED_LOGIN__;'
+                    . "\n"
+                    . '        } elseif ($controller === \plugin\saiadmin\app\controller\InstallController::class) {'
+                    . "\n"
+                    . '            $data = __SAIADMIN_INSTALL_NO_NEED_LOGIN__;'
+                    . "\n"
+                    . '        } elseif (class_exists($controller)) {'
+                    . "\n"
+                    . '            $ref = new ReflectionClass($controller);'
+                    . "\n"
+                    . '            $data = $ref->getDefaultProperties()[\'noNeedLogin\'] ?? [];'
+                    . "\n"
+                    . '        } else {'
+                    . "\n"
+                    . '            $data = [];'
+                    . "\n"
+                    . '        }',
+        ],
+        'plugin/saiadmin/app/cache/UserAuthCache.php' => [
+            '        if (is_array($role_id)) {'
+                . "\n"
+                . '            $tags = [];'
+                . "\n"
+                . '            foreach ($role_id as $id) {'
+                . "\n"
+                . '                $tags[] = $cache[\'role\'] . $id;'
+                . "\n"
+                . '            }'
+                . "\n"
+                . '        } else {'
+                . "\n"
+                . '            $tags = $cache[\'role\'] . $role_id;'
+                . "\n"
+                . '        }'
+                . "\n"
+                . '        return Cache::tag($tags)->clear();' =>
+                '        if (is_array($role_id)) {'
+                    . "\n"
+                    . '            $tags = [];'
+                    . "\n"
+                    . '            foreach ($role_id as $id) {'
+                    . "\n"
+                    . '                $tags[] = $cache[\'role\'] . $id;'
+                    . "\n"
+                    . '            }'
+                    . "\n"
+                    . '            return Cache::tag($tags)->clear();'
+                    . "\n"
+                    . '        }'
+                    . "\n"
+                    . '        $tag = $cache[\'role\'] . $role_id;'
+                    . "\n"
+                    . '        return Cache::tag($tag)->clear();',
+        ],
+        'plugin/saiadmin/app/logic/tool/CrontabLogic.php' => [
+            '                }' . "\n" . '            case 2:' =>
+                '                }' . "\n" . '                break;' . "\n" . '            case 2:',
+            '                }' . "\n" . '            case 3:' =>
+                '                }' . "\n" . '                break;' . "\n" . '            case 3:',
+            '                }' . "\n" . '            default:' =>
+                '                }' . "\n" . '                break;' . "\n" . '            default:',
+        ],
+        'plugin/saiadmin/exception/SystemException.php' => [
+            ', Throwable $previous = null)' => ', ?Throwable $previous = null)',
+        ],
+        'vendor/nelexa/zip/src/IO/Stream/ResponseStream.php' => [
+            '    public function getMetadata($key = null)' . "\n" . '    {' =>
+                '    public function getMetadata(?string $key = null)' . "\n" . '    {',
+            '    public function tell()' . "\n" . '    {' => '    public function tell(): int' . "\n" . '    {',
+            '        return $this->stream ? ftell($this->stream) : false;' => '        return (int) ($this->stream ? ftell($this->stream) : false);',
+            '    public function seek($offset, $whence = \SEEK_SET): void' => '    public function seek(int $offset, int $whence = \SEEK_SET): void',
+            '    public function write($string)' . "\n" . '    {' =>
+                '    public function write(string $string): int' . "\n" . '    {',
+            '        return $this->stream !== null && $this->writable ? fwrite($this->stream, $string) : false;' => '        return (int) ($this->stream !== null && $this->writable ? fwrite($this->stream, $string) : false);',
+            '    public function read($length): string' => '    public function read(int $length): string',
+        ],
+        'vendor/zoujingli/ip2region/src/ip2region/xdb/Util.php' => [
+            '        if ($val < 0 && PHP_INT_SIZE == 4) {'
+                . "\n"
+                . '            $val = sprintf("%u", $val);'
+                . "\n"
+                . '        }' =>
+                '        if ($val < 0 && PHP_INT_SIZE == 4) {'
+                    . "\n"
+                    . '            return sprintf("%u", $val);'
+                    . "\n"
+                    . '        }',
+        ],
+        'vendor/webman/captcha/src/CaptchaBuilder.php' => [
+            'return imagecolorat($image, $x, $y);' => 'return imagecolorat($image, (int) $x, (int) $y);',
+        ],
+        'vendor/saithink/saipackage/src/service/Filesystem.php' => [
+            '        $path = array_filter(explode(DIRECTORY_SEPARATOR, $path));' => '        $pathParts = array_filter(explode(DIRECTORY_SEPARATOR, $path));',
+            'for ($i = count($path) - 1;' => 'for ($i = count($pathParts) - 1;',
+            'implode(DIRECTORY_SEPARATOR, $path)' => 'implode(DIRECTORY_SEPARATOR, $pathParts)',
+            'unset($path[$i]);' => 'unset($pathParts[$i]);',
+        ],
+        'vendor/saithink/saipackage/src/service/Terminal.php' => [
+            '        $data = ['
+                . "\n"
+                . '            \'data\'   => $data,'
+                . "\n"
+                . '            \'uuid\'   => $this->uuid,'
+                . "\n"
+                . '            \'extend\' => $this->extend,'
+                . "\n"
+                . '            \'key\'    => $this->commandKey,'
+                . "\n"
+                . '        ];'
+                . "\n"
+                . '        $data = json_encode($data, JSON_UNESCAPED_UNICODE);'
+                . "\n"
+                . '        if ($data === false) {'
+                . "\n"
+                . '            $data = json_encode([\'error\' => \'JSON encode error\'], JSON_UNESCAPED_UNICODE);'
+                . "\n"
+                . '        }'
+                . "\n"
+                . '        return $data;' =>
+                '        $payload = ['
+                    . "\n"
+                    . '            \'data\'   => $data,'
+                    . "\n"
+                    . '            \'uuid\'   => $this->uuid,'
+                    . "\n"
+                    . '            \'extend\' => $this->extend,'
+                    . "\n"
+                    . '            \'key\'    => $this->commandKey,'
+                    . "\n"
+                    . '        ];'
+                    . "\n"
+                    . '        $encoded = json_encode($payload, JSON_UNESCAPED_UNICODE);'
+                    . "\n"
+                    . '        if ($encoded === false) {'
+                    . "\n"
+                    . '            return \'{"error":"JSON encode error"}\';'
+                    . "\n"
+                    . '        }'
+                    . "\n"
+                    . '        return $encoded;',
+        ],
+        'vendor/saithink/saipackage/src/service/Version.php' => [
+            '        $v1 = explode(\'.\', $v1);' . "\n" . '        $v2 = explode(\'.\', $v2);' =>
+                '        $v1Parts = explode(\'.\', $v1);' . "\n" . '        $v2Parts = explode(\'.\', $v2);',
+            'count($v1)' => 'count($v1Parts)',
+            'count($v2)' => 'count($v2Parts)',
+            '$v1[$i]' => '$v1Parts[$i]',
+            '$v2[$i]' => '$v2Parts[$i]',
+        ],
+        'vendor/symfony/console/Attribute/AsCommand.php' => [
+            '        $name = explode(\'|\', $name);' . "\n" . '        $name = array_merge($name, $aliases);' =>
+                '        $commandNames = explode(\'|\', $name);'
+                    . "\n"
+                    . '        $commandNames = array_merge($commandNames, $aliases);',
+            '$name[0]' => '$commandNames[0]',
+            'array_unshift($name,' => 'array_unshift($commandNames,',
+            'implode(\'|\', $name)' => 'implode(\'|\', $commandNames)',
+        ],
+        'vendor/symfony/console/Application.php' => [
+            '        $event = new ConsoleCommandEvent($command, $input, $output);'
+                . "\n"
+                . '        $e = null;'
+                . "\n\n"
+                . '        try {'
+                . "\n"
+                . '            $this->dispatcher->dispatch($event, ConsoleEvents::COMMAND);'
+                . "\n\n"
+                . '            if ($event->commandShouldRun()) {' =>
+                '        $commandEvent = new ConsoleCommandEvent($command, $input, $output);'
+                    . "\n"
+                    . '        $e = null;'
+                    . "\n\n"
+                    . '        try {'
+                    . "\n"
+                    . '            $this->dispatcher->dispatch($commandEvent, ConsoleEvents::COMMAND);'
+                    . "\n\n"
+                    . '            if ($commandEvent->commandShouldRun()) {',
+            '            $event = new ConsoleErrorEvent($input, $output, $e, $command);'
+                . "\n"
+                . '            $this->dispatcher->dispatch($event, ConsoleEvents::ERROR);'
+                . "\n"
+                . '            $e = $event->getError();'
+                . "\n\n"
+                . '            if (0 === $exitCode = $event->getExitCode()) {' =>
+                '            $errorEvent = new ConsoleErrorEvent($input, $output, $e, $command);'
+                    . "\n"
+                    . '            $this->dispatcher->dispatch($errorEvent, ConsoleEvents::ERROR);'
+                    . "\n"
+                    . '            $e = $errorEvent->getError();'
+                    . "\n\n"
+                    . '            if (0 === $exitCode = $errorEvent->getExitCode()) {',
+            '        $event = new ConsoleTerminateEvent($command, $input, $output, $exitCode);'
+                . "\n"
+                . '        $this->dispatcher->dispatch($event, ConsoleEvents::TERMINATE);'
+                . "\n\n"
+                . '        if (null !== $e) {'
+                . "\n"
+                . '            throw $e;'
+                . "\n"
+                . '        }'
+                . "\n\n"
+                . '        return $event->getExitCode();' =>
+                '        $terminateEvent = new ConsoleTerminateEvent($command, $input, $output, $exitCode);'
+                    . "\n"
+                    . '        $this->dispatcher->dispatch($terminateEvent, ConsoleEvents::TERMINATE);'
+                    . "\n\n"
+                    . '        if (null !== $e) {'
+                    . "\n"
+                    . '            throw $e;'
+                    . "\n"
+                    . '        }'
+                    . "\n\n"
+                    . '        return $terminateEvent->getExitCode();',
+        ],
+        'vendor/symfony/console/Formatter/OutputFormatter.php' => [
+            '$i = $width - $currentLineLength' => '$chunkWidth = $width - $currentLineLength',
+            'Helper::substr($lines[0], $i);' => 'Helper::substr($lines[0], $chunkWidth);',
+        ],
+        'vendor/symfony/console/Helper/ProgressIndicator.php' => [
+            '    public function finish(string $message/* , ?string $finishedIndicator = null */): void' => '    public function finish(string $message, ?string $finishedIndicator = null): void',
+            '        $finishedIndicator = 1 < \func_num_args() ? func_get_arg(1) : null;'
+                . "\n"
+                . '        if (null !== $finishedIndicator && !\is_string($finishedIndicator)) {'
+                . "\n"
+                . '            throw new \TypeError(\sprintf(\'Argument 2 passed to "%s()" must be of the type string or null, "%s" given.\', __METHOD__, get_debug_type($finishedIndicator)));'
+                . "\n"
+                . '        }'
+                . "\n" => '',
+        ],
+        'vendor/symfony/console/Helper/QuestionHelper.php' => [
+            '            $ret = false;' => "            \$ret = '';\n            \$hasAnswer = false;",
+            '                    $ret = $question->isTrimmable() ? trim($hiddenResponse) : $hiddenResponse;' =>
+                '                    $ret = $question->isTrimmable() ? trim($hiddenResponse) : $hiddenResponse;'
+                    . "\n"
+                    . '                    $hasAnswer = true;',
+            '            if (false === $ret) {' => '            if (!$hasAnswer) {',
+            '                $ret = $this->readInput($inputStream, $question);' => '                $inputAnswer = $this->readInput($inputStream, $question);',
+            '                if (false === $ret) {' => '                if (false === $inputAnswer) {',
+            '                if ($question->isTrimmable()) {' => "                \$ret = \$inputAnswer;\n                if (\$question->isTrimmable()) {",
+            '        $ret = \strlen($ret) > 0 ? $ret : $question->getDefault();'
+                . "\n"
+                . "\n"
+                . '        if ($normalizer = $question->getNormalizer()) {'
+                . "\n"
+                . '            return $normalizer($ret);'
+                . "\n"
+                . '        }'
+                . "\n"
+                . "\n"
+                . '        return $ret;' =>
+                '        $answer = \strlen($ret) > 0 ? $ret : $question->getDefault();'
+                    . "\n"
+                    . "\n"
+                    . '        if ($normalizer = $question->getNormalizer()) {'
+                    . "\n"
+                    . '            return $normalizer($answer);'
+                    . "\n"
+                    . '        }'
+                    . "\n"
+                    . "\n"
+                    . '        return $answer;',
+            'mb_strlen($fullChoice, $encoding)' => '(int) mb_strlen($fullChoice, $encoding)',
+        ],
+        'vendor/symfony/console/Helper/SymfonyQuestionHelper.php' => [
+            '            default:'
+                . "\n"
+                . '                $text = \sprintf(\' <info>%s</info> [<comment>%s</comment>]:\', $text, OutputFormatter::escape($default));' =>
+                '            default:'
+                    . "\n"
+                    . '                $text = \sprintf(\' <info>%s</info> [<comment>%s</comment>]:\', $text, OutputFormatter::escape($default));'
+                    . "\n"
+                    . '                break;',
+        ],
+        'vendor/symfony/console/Output/AnsiColorMode.php' => [
+            'return round($b / 255) << 2 | (round($g / 255) << 1) | round($r / 255);' => 'return (int) round($b / 255) << 2 | ((int) round($g / 255) << 1) | (int) round($r / 255);',
+        ],
+        'vendor/symfony/console/Output/ConsoleSectionOutput.php' => [
+            'array &$sections' => 'mixed &$sections',
+            '$this->lines -= (int) ceil($this->getDisplayLength($lastLine) / $width) ?: 1;' =>
+                '$previousLineCount = max(1, (int) ceil($this->getDisplayLength($lastLine) / $width));'
+                    . "\n"
+                    . '                $this->lines -= $previousLineCount;',
+        ],
+        'vendor/symfony/console/Style/SymfonyStyle.php' => [
+            '    private TrimmedBufferOutput $bufferedOutput;' => "    private TrimmedBufferOutput \$bufferedOutput;\n    private OutputInterface \$styleOutput;",
+            '        private OutputInterface $output,' => '        OutputInterface $output,',
+            '    ) {' . "\n" . '        $this->bufferedOutput = new TrimmedBufferOutput' =>
+                '    ) {'
+                    . "\n"
+                    . '        $this->styleOutput = $output;'
+                    . "\n"
+                    . '        $this->bufferedOutput = new TrimmedBufferOutput',
+            '$this->output' => '$this->styleOutput',
+            '        $question = new Question($question, $default);'
+                . "\n"
+                . '        $question->setValidator($validator);'
+                . "\n"
+                . "\n"
+                . '        return $this->askQuestion($question);' =>
+                '        $questionObject = new Question($question, $default);'
+                    . "\n"
+                    . '        $questionObject->setValidator($validator);'
+                    . "\n"
+                    . "\n"
+                    . '        return $this->askQuestion($questionObject);',
+            '        $question = new Question($question);'
+                . "\n"
+                . "\n"
+                . '        $question->setHidden(true);'
+                . "\n"
+                . '        $question->setValidator($validator);'
+                . "\n"
+                . "\n"
+                . '        return $this->askQuestion($question);' =>
+                '        $questionObject = new Question($question);'
+                    . "\n"
+                    . "\n"
+                    . '        $questionObject->setHidden(true);'
+                    . "\n"
+                    . '        $questionObject->setValidator($validator);'
+                    . "\n"
+                    . "\n"
+                    . '        return $this->askQuestion($questionObject);',
+        ],
+        'vendor/symfony/event-dispatcher/EventDispatcher.php' => [
+            '                $closure = &$this->optimized[$eventName][];'
+                . "\n"
+                . '                if (\is_array($listener) && isset($listener[0]) && $listener[0] instanceof \Closure && 2 >= \count($listener)) {'
+                . "\n"
+                . '                    $closure = static function (...$args) use (&$listener, &$closure) {'
+                . "\n"
+                . '                        if ($listener[0] instanceof \Closure) {'
+                . "\n"
+                . '                            $listener[0] = $listener[0]();'
+                . "\n"
+                . '                            $listener[1] ??= \'__invoke\';'
+                . "\n"
+                . '                        }'
+                . "\n"
+                . '                        ($closure = $listener(...))(...$args);'
+                . "\n"
+                . '                    };'
+                . "\n"
+                . '                } else {'
+                . "\n"
+                . '                    $closure = $listener instanceof WrappedListener ? $listener : $listener(...);'
+                . "\n"
+                . '                }' =>
+                '                if (\is_array($listener) && isset($listener[0]) && $listener[0] instanceof \Closure && 2 >= \count($listener)) {'
+                    . "\n"
+                    . '                    $closure = static function (...$args) use (&$listener) {'
+                    . "\n"
+                    . '                        if ($listener[0] instanceof \Closure) {'
+                    . "\n"
+                    . '                            $listener[0] = $listener[0]();'
+                    . "\n"
+                    . '                            $listener[1] ??= \'__invoke\';'
+                    . "\n"
+                    . '                        }'
+                    . "\n"
+                    . '                        $listener(...$args);'
+                    . "\n"
+                    . '                    };'
+                    . "\n"
+                    . '                } else {'
+                    . "\n"
+                    . '                    $closure = $listener instanceof WrappedListener ? $listener : $listener(...);'
+                    . "\n"
+                    . '                }'
+                    . "\n"
+                    . '                $this->optimized[$eventName][] = $closure;',
+        ],
+        'vendor/symfony/event-dispatcher/EventDispatcherInterface.php' => [
+            'public function addListener(string $eventName, callable $listener,' => 'public function addListener(string $eventName, callable|array $listener,',
+            'public function removeListener(string $eventName, callable $listener)' => 'public function removeListener(string $eventName, callable|array $listener)',
+            'public function getListenerPriority(string $eventName, callable $listener)' => 'public function getListenerPriority(string $eventName, callable|array $listener)',
+        ],
+        'vendor/symfony/http-foundation/AcceptHeaderItem.php' => [
+            '        foreach ($attributes as $name => $value) {'
+                . "\n"
+                . '            $this->setAttribute($name, $value);' =>
+                '        foreach ($attributes as $name => $attributeValue) {'
+                    . "\n"
+                    . '            $this->setAttribute($name, $attributeValue);',
+        ],
+        'vendor/symfony/http-foundation/BinaryFileResponse.php' => [
+            '$this->maxlen = $end < $fileSize ? $end - $start + 1 : -1;' => '$this->maxlen = $end < $fileSize ? (int) ($end - $start + 1) : -1;',
+            '$read = $length > $this->chunkSize || 0 > $length ? $this->chunkSize : $length;' => '$read = $length > (int) $this->chunkSize || 0 > $length ? (int) $this->chunkSize : $length;',
+        ],
+        'vendor/symfony/http-foundation/HeaderUtils.php' => [
+            '        $query = [];' . "\n" . "\n" . '        foreach ($q as $k => $v) {' =>
+                '        $parsedQuery = [];' . "\n" . "\n" . '        foreach ($q as $encodedKey => $v) {',
+            '            if (false !== $i = strpos($k, \'_\')) {' => '            if (false !== $i = strpos($encodedKey, \'_\')) {',
+            '                $query[substr_replace($k, hex2bin(substr($k, 0, $i)).\'[\', 0, 1 + $i)] = $v;' => '                $parsedQuery[substr_replace($encodedKey, hex2bin(substr($encodedKey, 0, $i)).\'[\', 0, 1 + $i)] = $v;',
+            '                $query[hex2bin($k)] = $v;' => '                $parsedQuery[hex2bin($encodedKey)] = $v;',
+            '        return $query;' . "\n" . '    }' . "\n" . "\n" . '    private static function groupParts' =>
+                '        return $parsedQuery;'
+                    . "\n"
+                    . '    }'
+                    . "\n"
+                    . "\n"
+                    . '    private static function groupParts',
+            '        foreach ($partMatches as $matches) {'
+                . "\n"
+                . '            if (\'\' === $separators && \'\' !== $unquoted = self::unquote($matches[0][0])) {'
+                . "\n"
+                . '                $parts[] = $unquoted;'
+                . "\n"
+                . '            } elseif ($groupedParts = self::groupParts($matches, $separators, false)) {' =>
+                '        foreach ($partMatches as $groupMatches) {'
+                    . "\n"
+                    . '            if (\'\' === $separators && \'\' !== $unquoted = self::unquote($groupMatches[0][0])) {'
+                    . "\n"
+                    . '                $parts[] = $unquoted;'
+                    . "\n"
+                    . '            } elseif ($groupedParts = self::groupParts($groupMatches, $separators, false)) {',
+        ],
+        'vendor/symfony/http-foundation/IpUtils.php' => [
+            '    public static function anonymize(string $ip/* , int $v4Bytes = 1, int $v6Bytes = 8 */): string' => '    public static function anonymize(string $ip, int $v4Bytes = 1, int $v6Bytes = 8): string',
+            '        $v4Bytes = 1 < \func_num_args() ? func_get_arg(1) : 1;'
+                . "\n"
+                . '        $v6Bytes = 2 < \func_num_args() ? func_get_arg(2) : 8;'
+                . "\n"
+                . "\n" => '',
+        ],
+        'vendor/symfony/http-foundation/RequestStack.php' => [
+            '        static $resetRequestFormats;'
+                . "\n"
+                . '        $resetRequestFormats ??= \Closure::bind(static fn () => self::$formats = null, null, Request::class);'
+                . "\n"
+                . '        $resetRequestFormats();' => '        Request::resetFormatsForAot();',
+        ],
+        'vendor/symfony/http-foundation/ResponseHeaderBag.php' => [
+            '    public function clearCookie(string $name, ?string $path = \'/\', ?string $domain = null, bool $secure = false, bool $httpOnly = true, ?string $sameSite = null /* , bool $partitioned = false */): void' => '    public function clearCookie(string $name, ?string $path = \'/\', ?string $domain = null, bool $secure = false, bool $httpOnly = true, ?string $sameSite = null, bool $partitioned = false): void',
+            '        $partitioned = 6 < \func_num_args() ? func_get_arg(6) : false;' => '',
+        ],
+        'vendor/symfony/http-foundation/Session/Storage/Handler/PdoSessionHandler.php' => [
+            '    private function getInsertStatement(#[\SensitiveParameter] string $sessionId, string $sessionData, int $maxlifetime): \PDOStatement'
+                . "\n"
+                . '    {' =>
+                '    private function getInsertStatement(#[\SensitiveParameter] string $sessionId, string $sessionData, int $maxlifetime): \PDOStatement'
+                    . "\n"
+                    . '    {'
+                    . "\n"
+                    . '        $dataHolder = new \stdClass();',
+            '    private function getUpdateStatement(#[\SensitiveParameter] string $sessionId, string $sessionData, int $maxlifetime): \PDOStatement'
+                . "\n"
+                . '    {' =>
+                '    private function getUpdateStatement(#[\SensitiveParameter] string $sessionId, string $sessionData, int $maxlifetime): \PDOStatement'
+                    . "\n"
+                    . '    {'
+                    . "\n"
+                    . '        $dataHolder = new \stdClass();',
+            '                $data = fopen(\'php://memory\', \'r+\');' => '                $dataHolder->value = fopen(\'php://memory\', \'r+\');',
+            '                fwrite($data, $sessionData);' => '                fwrite($dataHolder->value, $sessionData);',
+            '                rewind($data);' => '                rewind($dataHolder->value);',
+            '                $data = $sessionData;' => '                $dataHolder->value = $sessionData;',
+            '        $stmt->bindParam(\':data\', $data, \PDO::PARAM_LOB);' => '        $stmt->bindParam(\':data\', $dataHolder->value, \PDO::PARAM_LOB);',
+            '                // If "unix_socket" is not in the query, we continue with the same process as pgsql'
+                . "\n"
+                . '                // no break'
+                . "\n"
+                . '            case \'pgsql\':' =>
+                '                if (isset($params[\'host\']) && \'\' !== $params[\'host\']) {'
+                    . "\n"
+                    . '                    $dsn .= \'host=\'.$params[\'host\'].\';\';'
+                    . "\n"
+                    . '                }'
+                    . "\n\n"
+                    . '                if (isset($params[\'port\']) && \'\' !== $params[\'port\']) {'
+                    . "\n"
+                    . '                    $dsn .= \'port=\'.$params[\'port\'].\';\';'
+                    . "\n"
+                    . '                }'
+                    . "\n\n"
+                    . '                if (isset($params[\'path\'])) {'
+                    . "\n"
+                    . '                    $dbName = substr($params[\'path\'], 1);'
+                    . "\n"
+                    . '                    $dsn .= \'dbname=\'.$dbName.\';\';'
+                    . "\n"
+                    . '                }'
+                    . "\n\n"
+                    . '                return $dsn;'
+                    . "\n\n"
+                    . '            case \'pgsql\':',
+        ],
+        'vendor/symfony/http-foundation/Session/Storage/Handler/SessionHandlerFactory.php' => [
+            '                $connection = DriverManager::getConnection($params, $config)->getNativeConnection();'
+                . "\n"
+                . '                // no break;' =>
+                '                $connection = DriverManager::getConnection($params, $config)->getNativeConnection();'
+                    . "\n\n"
+                    . '                return new PdoSessionHandler($connection, $options);',
+        ],
+        'vendor/symfony/http-foundation/Session/Attribute/AttributeBag.php' => [
+            '    public function initialize(array &$attributes): void' => '    public function initialize(mixed &$attributes): void',
+        ],
+        'vendor/symfony/http-foundation/Session/Flash/FlashBag.php' => [
+            '    public function initialize(array &$flashes): void' => '    public function initialize(mixed &$flashes): void',
+        ],
+        'vendor/symfony/http-foundation/Session/Flash/AutoExpireFlashBag.php' => [
+            '    public function initialize(array &$flashes): void' => '    public function initialize(mixed &$flashes): void',
+        ],
+        'vendor/symfony/http-foundation/Session/SessionBagProxy.php' => [
+            '        array &$data,' => '        mixed &$data,',
+            '        ?int &$usageIndex,' => '        mixed &$usageIndex,',
+            '    public function initialize(array &$array): void' => '    public function initialize(mixed &$array): void',
+        ],
+        'vendor/symfony/mime/Header/AbstractHeader.php' => [
+            '                        $token = substr($token, 1);' . "\n" . '                }' =>
+                '                        $token = substr($token, 1);'
+                    . "\n"
+                    . '                        break;'
+                    . "\n"
+                    . '                }',
+        ],
+        'vendor/symfony/http-kernel/Log/Logger.php' => [
+            '                ++$this->errorCount[$key];' . "\n" . '        }' =>
+                '                ++$this->errorCount[$key];' . "\n" . '                break;' . "\n" . '        }',
+        ],
+        'vendor/symfony/http-foundation/UriSigner.php' => [
+            '    public function sign(string $uri/* , \DateTimeInterface|\DateInterval|int|null $expiration = null */): string' => '    public function sign(string $uri, \DateTimeInterface|\DateInterval|int|null $expiration = null): string',
+            '        $expiration = null;'
+                . "\n"
+                . "\n"
+                . '        if (1 < \func_num_args()) {'
+                . "\n"
+                . '            $expiration = func_get_arg(1);'
+                . "\n"
+                . '        }'
+                . "\n"
+                . "\n" => '',
+        ],
+        'vendor/symfony/http-kernel/Controller/ControllerResolver.php' => [
+            '            $controller = $this->instantiateController($controller);' => '            $controllerInstance = $this->instantiateController($controller);',
+            '            if (!\is_callable($controller)) {'
+                . "\n"
+                . '                throw new \InvalidArgumentException($this->getControllerError($controller));'
+                . "\n"
+                . '            }'
+                . "\n"
+                . "\n"
+                . '            return $controller;' =>
+                '            if (!\is_callable($controllerInstance)) {'
+                    . "\n"
+                    . '                throw new \InvalidArgumentException($this->getControllerError($controllerInstance));'
+                    . "\n"
+                    . '            }'
+                    . "\n"
+                    . "\n"
+                    . '            return $controllerInstance;',
+            '            $controller = [$this->instantiateController($class), $method];' => '            $controllerCallable = [$this->instantiateController($class), $method];',
+            '        if (!\is_callable($controller)) {'
+                . "\n"
+                . '            throw new \InvalidArgumentException($this->getControllerError($controller));'
+                . "\n"
+                . '        }'
+                . "\n"
+                . "\n"
+                . '        return $controller;' =>
+                '        if (!\is_callable($controllerCallable)) {'
+                    . "\n"
+                    . '            throw new \InvalidArgumentException($this->getControllerError($controllerCallable));'
+                    . "\n"
+                    . '        }'
+                    . "\n"
+                    . "\n"
+                    . '        return $controllerCallable;',
+        ],
+        'vendor/symfony/http-kernel/Exception/ControllerDoesNotReturnResponseException.php' => [
+            "                \$r = new \\ReflectionMethod(\$controller[0], \$controller[1]);\n\n"
+                . "                return [\n"
+                . "                    'file' => \$r->getFileName(),\n"
+                . "                    'line' => \$r->getEndLine(),\n"
+                . '                ];' =>
+                "                \$methodReflection = new \\ReflectionMethod(\$controller[0], \$controller[1]);\n\n"
+                    . "                return [\n"
+                    . "                    'file' => \$methodReflection->getFileName(),\n"
+                    . "                    'line' => \$methodReflection->getEndLine(),\n"
+                    . '                ];',
+            "            \$r = new \\ReflectionFunction(\$controller);\n\n"
+                . "            return [\n"
+                . "                'file' => \$r->getFileName(),\n"
+                . "                'line' => \$r->getEndLine(),\n"
+                . '            ];' =>
+                "            \$functionReflection = new \\ReflectionFunction(\$controller);\n\n"
+                    . "            return [\n"
+                    . "                'file' => \$functionReflection->getFileName(),\n"
+                    . "                'line' => \$functionReflection->getEndLine(),\n"
+                    . '            ];',
+            "            \$r = new \\ReflectionClass(\$controller);\n\n"
+                . "            try {\n"
+                . "                \$line = \$r->getMethod('__invoke')->getEndLine();\n"
+                . "            } catch (\\ReflectionException) {\n"
+                . "                \$line = \$r->getEndLine();\n"
+                . "            }\n\n"
+                . "            return [\n"
+                . "                'file' => \$r->getFileName()," =>
+                "            \$classReflection = new \\ReflectionClass(\$controller);\n\n"
+                    . "            try {\n"
+                    . "                \$line = \$classReflection->getMethod('__invoke')->getEndLine();\n"
+                    . "            } catch (\\ReflectionException) {\n"
+                    . "                \$line = \$classReflection->getEndLine();\n"
+                    . "            }\n\n"
+                    . "            return [\n"
+                    . "                'file' => \$classReflection->getFileName(),",
+        ],
+        'vendor/symfony/http-kernel/EventListener/ErrorListener.php' => [
+            '    protected function logException(\Throwable $exception, string $message, ?string $logLevel = null/* , ?string $logChannel = null */): void' => '    protected function logException(\Throwable $exception, string $message, ?string $logLevel = null, ?string $logChannel = null): void',
+            '        $logChannel = (3 < \func_num_args() ? func_get_arg(3) : null) ?? $this->resolveLogChannel($exception);' => '        $logChannel ??= $this->resolveLogChannel($exception);',
+            '        $class = new \ReflectionClass($class);' => '        $reflectionClass = new \ReflectionClass($class);',
+            '$class->getAttributes($attribute, \ReflectionAttribute::IS_INSTANCEOF)' => '$reflectionClass->getAttributes($attribute, \ReflectionAttribute::IS_INSTANCEOF)',
+            'class_implements($class->name)' => 'class_implements($reflectionClass->name)',
+            '        } while ($class = $class->getParentClass());' => '        } while ($reflectionClass = $reflectionClass->getParentClass());',
+            '                $class = new \ReflectionClass($interface);' => '                $interfaceReflection = new \ReflectionClass($interface);',
+            '                if ($attributes = $reflectionClass->getAttributes' => '                if ($attributes = $interfaceReflection->getAttributes',
+        ],
+        'vendor/symfony/http-kernel/EventListener/SessionListener.php' => [
+            '        private ?ContainerInterface $container = null,' => '        private ?ContainerInterface $sessionContainer = null,',
+            '        parent::__construct($container, $debug, $sessionOptions);' => '        parent::__construct($sessionContainer, $debug, $sessionOptions);',
+            '$this->container->' => '$this->sessionContainer->',
+        ],
+        'vendor/symfony/http-kernel/HttpKernelInterface.php' => [
+            'int $type = self::MAIN_REQUEST' => 'int $type = 1',
+        ],
+        'vendor/symfony/mime/Header/ParameterizedHeader.php' => [
+            'private ?Rfc2231Encoder $encoder' => 'private ?Rfc2231Encoder $parameterEncoder',
+            '$this->encoder' => '$this->parameterEncoder',
+        ],
+        'vendor/symfony/polyfill-php80/Php80.php' => [
+            'switch (preg_last_error()) {' => 'switch ((int) preg_last_error()) {',
+        ],
+        'vendor/symfony/polyfill-intl-grapheme/Grapheme.php' => [
+            "\\define('SYMFONY_GRAPHEME_CLUSTER_RX', ((float) \\PCRE_VERSION >= 10.44) ? '\\X' : Grapheme::GRAPHEME_CLUSTER_RX);" => 'const SYMFONY_GRAPHEME_CLUSTER_RX = Grapheme::GRAPHEME_CLUSTER_RX;',
+        ],
+        'vendor/symfony/translation/PseudoLocalizationTranslator.php' => [
+            'mb_strlen($s, $encoding)' => '(int) mb_strlen($s, $encoding)',
+        ],
+        'vendor/illuminate/bus/Batch.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+            '        $count = 0;' => "        \$countState = new \\stdClass();\n        \$countState->value = 0;",
+            'map(function ($job) use (&$count) {' => 'map(function ($job) use ($countState) {',
+            '$count += count($job);' => '$countState->value = $countState->value + count($job);',
+            '$count++;' => '$countState->value = $countState->value + 1;',
+            "        });\n\n        \$this->repository->transaction(function () use (\$jobs, \$count) {" =>
+                "        });\n\n        \$count = \$countState->value;\n\n"
+                    . '        $this->repository->transaction(function () use ($jobs, $count) {',
+        ],
+        'vendor/illuminate/collections/Enumerable.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+            '    public function unless($value, callable $callback, ?callable $default = null);' => '    public function unless($value = null, ?callable $callback = null, ?callable $default = null);',
+        ],
+        'vendor/illuminate/collections/Traits/EnumeratesValues.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/contracts/Support/Arrayable.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/database/Connectors/PostgresConnector.php' => [
+            "        extract(\$config, EXTR_SKIP);\n\n" => '',
+            '        $host = isset($host) ? "host={$host};" : \'\';' => '        $host = isset($config[\'host\']) ? "host={$config[\'host\']};" : \'\';',
+            '        $database = $connect_via_database ?? $database ?? null;' => '        $database = $config[\'connect_via_database\'] ?? $config[\'database\'] ?? null;',
+            '        $port = $connect_via_port ?? $port ?? null;' => '        $port = $config[\'connect_via_port\'] ?? $config[\'port\'] ?? null;',
+            '        if (isset($charset)) {' => '        if (isset($config[\'charset\'])) {',
+            '            $dsn .= ";client_encoding=\'{$charset}\'";' => '            $dsn .= ";client_encoding=\'{$config[\'charset\']}\'";',
+            '        if (isset($application_name)) {' => '        if (isset($config[\'application_name\'])) {',
+            '            $dsn .= ";application_name=\'".str_replace("\'", "\\\'", $application_name)."\'";' => '            $dsn .= ";application_name=\'".str_replace("\'", "\\\'", $config[\'application_name\'])."\'";',
+        ],
+        'vendor/illuminate/database/Query/Grammars/PostgresGrammar.php' => [
+            '    protected function wrapJsonPathAttributes($path)'
+                . "\n"
+                . '    {'
+                . "\n"
+                . '        $quote = func_num_args() === 2 ? func_get_arg(1) : "\'";' =>
+                '    protected function wrapJsonPathAttributes($path, $quote = "\'")' . "\n" . '    {',
+        ],
+        'vendor/illuminate/database/Concerns/BuildsWhereDateClauses.php' => [
+            "compact('type', 'column', 'boolean', 'operator', 'value')" =>
+                "['type' => \$type, 'column' => \$column, 'boolean' => \$boolean, "
+                    . "'operator' => \$operator, 'value' => \$value]",
+        ],
+        'vendor/illuminate/database/Schema/Blueprint.php' => [
+            '    public function dropColumn($columns)' => '    public function dropColumn($columns, ...$additionalColumns)',
+            '        $columns = is_array($columns) ? $columns : func_get_args();' => '        $columns = is_array($columns) ? $columns : array_merge([$columns], $additionalColumns);',
+            "compact('autoIncrement', 'unsigned')" => "['autoIncrement' => \$autoIncrement, 'unsigned' => \$unsigned]",
+        ],
+        'vendor/illuminate/database/Eloquent/Relations/Concerns/CanBeOneOfMany.php' => [
+            "        if (\$aggregate instanceof Closure) {\n"
+                . "            \$closure = \$aggregate;\n"
+                . "        }\n\n"
+                . '        foreach ($columns as $column => $aggregate) {' =>
+                "        \$previous = [];\n\n" . '        foreach ($columns as $column => $aggregate) {',
+            "            if (isset(\$previous)) {" => "            if (\$previous !== []) {",
+            "            if (isset(\$closure)) {\n" . "                \$closure(\$subQuery);\n" . '            }' =>
+                "            if (\$aggregate instanceof Closure) {\n"
+                    . "                \$aggregate(\$subQuery);\n"
+                    . '            }',
+            "            if (! isset(\$previous)) {" => "            if (\$previous === []) {",
+        ],
+        'vendor/illuminate/filesystem/Filesystem.php' => [
+            '                extract($__data, EXTR_SKIP);' =>
+                '                if ($__data !== []) {'
+                    . "\n"
+                    . '                    throw new RuntimeException(\'AOT dynamic require does not support injected variables.\');'
+                    . "\n"
+                    . '                }',
+        ],
+        'vendor/illuminate/http/Client/Response.php' => [
+            '    public function throw()' => '    public function throw($callback = null)',
+            '        $callback = func_get_args()[0] ?? null;' . "\n\n" => '',
+            '    public function throwIf($condition)' => '    public function throwIf($condition, $callback = null)',
+            'return value($condition, $this) ? $this->throw(func_get_args()[1] ?? null) : $this;' => 'return value($condition, $this) ? $this->throw($callback) : $this;',
+        ],
+        'vendor/illuminate/http/Resources/Json/JsonResource.php' => [
+            '        return $this->toArray($request);' => '        return $this->toResourceArray($request);',
+            '    public function toArray(Request $request)' =>
+                "    public function toArray(): array\n"
+                    . "    {\n"
+                    . "        return \$this->resolve(\$this->resolveRequestFromContainer());\n"
+                    . "    }\n\n"
+                    . '    public function toResourceArray(Request $request)',
+        ],
+        'vendor/illuminate/http/Resources/Json/ResourceCollection.php' => [
+            '    public function toArray(Request $request)' => '    public function toResourceArray(Request $request)',
+        ],
+        'vendor/illuminate/http/Resources/JsonApi/JsonApiResource.php' => [
+            '        return $this->toArray($request);' => '        return $this->toResourceArray($request);',
+        ],
+        'vendor/symfony/http-foundation/Request.php' => [
+            '        if ($this->isFromTrustedProxy() && $host = $this->getTrustedValues(self::HEADER_X_FORWARDED_HOST)) {'
+                . "\n"
+                . '            $host = $host[0];' =>
+                '        if ($this->isFromTrustedProxy() && $forwardedHosts = $this->getTrustedValues(self::HEADER_X_FORWARDED_HOST)) {'
+                    . "\n"
+                    . '            $host = $forwardedHosts[0];',
+            '    public function getFormat(?string $mimeType/* , bool $subtypeFallback = false */): ?string'
+                . "\n"
+                . '    {'
+                . "\n"
+                . '        $subtypeFallback = 2 <= \func_num_args() ? func_get_arg(1) : false;' =>
+                '    public function getFormat(?string $mimeType, bool $subtypeFallback = false): ?string'
+                    . "\n"
+                    . '    {',
+            '    /**' . "\n" . '     * Associates a format with mime types.' =>
+                '    public static function resetFormatsForAot(): void'
+                    . "\n"
+                    . '    {'
+                    . "\n"
+                    . '        self::$formats = null;'
+                    . "\n"
+                    . '    }'
+                    . "\n"
+                    . "\n"
+                    . '    /**'
+                    . "\n"
+                    . '     * Associates a format with mime types.',
+            '        $_REQUEST = [[]];'
+                . "\n\n"
+                . '        foreach (str_split($requestOrder) as $order) {'
+                . "\n"
+                . '            $_REQUEST[] = $request[$order];'
+                . "\n"
+                . '        }'
+                . "\n\n"
+                . '        $_REQUEST = array_merge(...$_REQUEST);' =>
+                '        $requestParts = [[]];'
+                    . "\n\n"
+                    . '        foreach (str_split($requestOrder) as $order) {'
+                    . "\n"
+                    . '            $requestParts[] = $request[$order];'
+                    . "\n"
+                    . '        }'
+                    . "\n\n"
+                    . '        $_REQUEST = array_merge(...$requestParts);',
+            "                // no break\n            case 'PATCH':" =>
+                "                \$request = \$parameters;\n"
+                    . "                \$query = [];\n"
+                    . "                break;\n"
+                    . "            case 'PATCH':",
+        ],
+        'vendor/symfony/http-foundation/File/UploadedFile.php' => [
+            '        switch ($this->error) {' => '        switch ((int) $this->error) {',
+            '        $max = ltrim($size, \'+\');'
+                . "\n"
+                . '        if (str_starts_with($max, \'0x\')) {'
+                . "\n"
+                . '            $max = \intval($max, 16);'
+                . "\n"
+                . '        } elseif (str_starts_with($max, \'0\')) {'
+                . "\n"
+                . '            $max = \intval($max, 8);'
+                . "\n"
+                . '        } else {'
+                . "\n"
+                . '            $max = (int) $max;' =>
+                '        $maxString = ltrim($size, \'+\');'
+                    . "\n"
+                    . '        if (str_starts_with($maxString, \'0x\')) {'
+                    . "\n"
+                    . '            $max = \intval($maxString, 16);'
+                    . "\n"
+                    . '        } elseif (str_starts_with($maxString, \'0\')) {'
+                    . "\n"
+                    . '            $max = \intval($maxString, 8);'
+                    . "\n"
+                    . '        } else {'
+                    . "\n"
+                    . '            $max = (int) $maxString;',
+            '            case \'t\': $max *= 1024;'
+                . "\n"
+                . '                // no break'
+                . "\n"
+                . '            case \'g\': $max *= 1024;'
+                . "\n"
+                . '                // no break'
+                . "\n"
+                . '            case \'m\': $max *= 1024;'
+                . "\n"
+                . '                // no break'
+                . "\n"
+                . '            case \'k\': $max *= 1024;' =>
+                '            case \'t\': $max *= 1024 * 1024 * 1024 * 1024; break;'
+                    . "\n"
+                    . '            case \'g\': $max *= 1024 * 1024 * 1024; break;'
+                    . "\n"
+                    . '            case \'m\': $max *= 1024 * 1024; break;'
+                    . "\n"
+                    . '            case \'k\': $max *= 1024; break;',
+        ],
+        'vendor/illuminate/redis/RedisManager.php' => [
+            '        $this->customCreators[$driver] = $callback->bindTo($this, $this);' => '        throw new \RuntimeException(\'AOT Redis custom driver closure binding is not supported.\');',
+        ],
+        'vendor/illuminate/support/Facades/Password.php' => [
+            'PasswordBroker::RESET_LINK_SENT' => '\'passwords.sent\'',
+            'PasswordBroker::PASSWORD_RESET' => '\'passwords.reset\'',
+            'PasswordBroker::INVALID_USER' => '\'passwords.user\'',
+            'PasswordBroker::INVALID_TOKEN' => '\'passwords.token\'',
+            'PasswordBroker::RESET_THROTTLED' => '\'passwords.throttled\'',
+        ],
+        'vendor/illuminate/support/MultipleInstanceManager.php' => [
+            '        $this->customCreators[$name] = $callback->bindTo($this, $this);' => '        throw new \RuntimeException(\'AOT custom instance creator closure binding is not supported.\');',
+        ],
+        'vendor/illuminate/support/Sleep.php' => [
+            '            static $return = [true, false];' =>
+                '            static $return;'
+                    . "\n"
+                    . '            if ($return === null) {'
+                    . "\n"
+                    . '                $return = [true, false];'
+                    . "\n"
+                    . '            }',
+            'CarbonInterval::seconds(0)' => 'new CarbonInterval(0, 0, 0, 0, 0, 0, 0)',
+            'CarbonInterval::microsecond(0)' => 'new CarbonInterval(0, 0, 0, 0, 0, 0, 0, 0)',
+        ],
+        'vendor/illuminate/support/Str.php' => [
+            'return implode(array_reverse(mb_str_split($value)));' => 'return implode(\'\', array_reverse(mb_str_split($value)));',
+            'return static::$studlyCache[$key] = implode($studlyWords);' => 'return static::$studlyCache[$key] = implode(\'\', $studlyWords);',
+            '        $start = ltrim($matches[1]);' => '        $startText = ltrim($matches[1]);',
+            '        $start = Str::of(mb_substr($start, max(mb_strlen($start, \'UTF-8\') - $radius, 0), $radius, \'UTF-8\'))->ltrim()->unless(' => '        $start = Str::of(mb_substr($startText, max(mb_strlen($startText, \'UTF-8\') - $radius, 0), $radius, \'UTF-8\'))->ltrim()->unless(',
+            '            fn ($startWithRadius) => $startWithRadius->exactly($start),' => '            fn ($startWithRadius) => $startWithRadius->exactly($startText),',
+            '        $end = rtrim($matches[3]);' => '        $endText = rtrim($matches[3]);',
+            '        $end = Str::of(mb_substr($end, 0, $radius, \'UTF-8\'))->rtrim()->unless(' => '        $end = Str::of(mb_substr($endText, 0, $radius, \'UTF-8\'))->rtrim()->unless(',
+            '            fn ($endWithRadius) => $endWithRadius->exactly($end),' => '            fn ($endWithRadius) => $endWithRadius->exactly($endText),',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/CarbonInterface.php' => [
+            'int $mode = self::TRANSLATE_ALL' => 'int $mode = TranslationOptions::TRANSLATE_ALL',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/Traits/Creator.php' => [
+            '        $fields = static::getRangesByUnit();' =>
+                '        $fields = static::getRangesByUnit();'
+                    . "\n"
+                    . '        $fieldValues = ['
+                    . "\n"
+                    . '            \'year\' => $year, \'month\' => $month, \'day\' => $day,'
+                    . "\n"
+                    . '            \'hour\' => $hour, \'minute\' => $minute, \'second\' => $second,'
+                    . "\n"
+                    . '        ];',
+            '$$field' => '$fieldValues[$field]',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/Traits/Date.php' => [
+            '                $result->$name = $value;' => "                \$result->\$name = \$value;\n\n                break;",
+            "                } catch (UnknownUnitException) {\n"
+                . "                    // default to macro\n"
+                . "                }\n\n"
+                . "            default:\n"
+                . "                \$macro = \$this->getLocalMacro('get'.ucfirst(\$name));" =>
+                "                } catch (UnknownUnitException) {\n"
+                    . "                    // default to macro\n"
+                    . "                }\n\n"
+                    . "                \$fallbackMacro = \$this->getLocalMacro('get'.ucfirst(\$name));\n"
+                    . "                if (\$fallbackMacro) {\n"
+                    . "                    return \$this->executeCallableWithContext(\$fallbackMacro);\n"
+                    . "                }\n"
+                    . "                throw new UnknownGetterException(\$name);\n\n"
+                    . "            default:\n"
+                    . "                \$macro = \$this->getLocalMacro('get'.ucfirst(\$name));",
+            '                    $value = $operator === \'Of\'' => '                    $unitValue = $operator === \'Of\'',
+            '                    return (int) $value;' => '                    return (int) $unitValue;',
+            '$result = $result->subSecond();' => '$result = $result->addUnit(\'second\', -1);',
+            '$result = $result->addSecond();' => '$result = $result->addUnit(\'second\', 1);',
+            '$result = $result->addDays($value - $this->dayOfYear);' => '$result = $result->addUnit(\'day\', $value - $this->dayOfYear);',
+            '$result = $result->addDays($value - $this->dayOfWeek);' => '$result = $result->addUnit(\'day\', $value - $this->dayOfWeek);',
+            '$result = $result->addDays($value - $this->dayOfWeekIso);' => '$result = $result->addUnit(\'day\', $value - $this->dayOfWeekIso);',
+            '$this->addDays(' => '$this->addUnit(\'day\', ',
+            '            $boundMacro = @$macro->bindTo($this, static::class) ?: @$macro->bindTo(null, static::class);' => '            throw new \RuntimeException(\'AOT Carbon closure macro binding is not supported.\');',
+            '                $boundMacro = @Closure::bind($macro, null, static::class);' => '                throw new \RuntimeException(\'AOT Carbon static closure macro binding is not supported.\');',
+            'return \call_user_func_array($boundMacro ?: $macro, $parameters);' => 'return \call_user_func_array($macro, $parameters);',
+            '                $$name = self::monthToInt($value, $name);' =>
+                '                $normalizedValue = self::monthToInt($value, $name);'
+                    . "\n"
+                    . '                switch ($name) {'
+                    . "\n"
+                    . '                    case \'year\': $year = $normalizedValue; break;'
+                    . "\n"
+                    . '                    case \'month\': $month = $normalizedValue; break;'
+                    . "\n"
+                    . '                    case \'day\': $day = $normalizedValue; break;'
+                    . "\n"
+                    . '                    case \'hour\': $hour = $normalizedValue; break;'
+                    . "\n"
+                    . '                    case \'minute\': $minute = $normalizedValue; break;'
+                    . "\n"
+                    . '                    case \'second\': $second = $normalizedValue; break;'
+                    . "\n"
+                    . '                }',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/Traits/Boundaries.php' => [
+            '->addMonths(' => '->addUnit(\'month\', ',
+            '->addDays(' => '->addUnit(\'day\', ',
+            '            ->subDays('
+                . "\n"
+                . '                (static::DAYS_PER_WEEK + $this->dayOfWeek - (WeekDay::int($weekStartsAt) ?? $this->firstWeekDay)) %'
+                . "\n"
+                . '                static::DAYS_PER_WEEK,'
+                . "\n"
+                . '            )' =>
+                '            ->addUnit(\'day\', -('
+                    . "\n"
+                    . '                (static::DAYS_PER_WEEK + $this->dayOfWeek - (WeekDay::int($weekStartsAt) ?? $this->firstWeekDay)) %'
+                    . "\n"
+                    . '                static::DAYS_PER_WEEK'
+                    . "\n"
+                    . '            ))',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/Traits/Comparison.php' => [
+            'return $this->{\'isSame\'.ucfirst($unit)}(\'now\');' => 'return $this->isSameUnit($unit, \'now\');',
+            '$this->isSameYear($date)' => '$this->isSameUnit(\'year\', $date)',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/Traits/Converter.php' => [
+            '!$this->isValid()' => '$this->year === 0',
+            'CarbonInterval::day()' => 'new CarbonInterval(0, 0, 0, 1)',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/Traits/Difference.php' => [
+            'CarbonInterval::hour()' => 'new CarbonInterval(0, 0, 0, 0, 1)',
+            'CarbonInterval::day()' => 'new CarbonInterval(0, 0, 0, 1)',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/Traits/Mixin.php' => [
+            '                    $downContext->copyProperties($result);'
+                . "\n"
+                . '                    self::copyStep($downContext, $result);'
+                . "\n"
+                . '                    self::copyNegativeUnits($downContext, $result);' =>
+                '                    throw new \RuntimeException('
+                    . "\n"
+                    . '                        \'AOT Carbon interval trait mixin result copying is not supported.\','
+                    . "\n"
+                    . '                    );',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/Traits/Options.php' => [
+            '$infos[\'date\'] ??= $this->format(CarbonInterface::MOCK_DATETIME_FORMAT);' => '$infos[\'date\'] ??= \call_user_func([$this, \'format\'], CarbonInterface::MOCK_DATETIME_FORMAT);',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/Traits/Localization.php' => [
+            '            $language = $$key;' => '            $language = $key === \'from\' ? $from : $to;',
+            '                        foreach ($$variable as $index => &$name) {'
+                . "\n"
+                . '                            $name .= \'|\'.$list[$index];'
+                . "\n"
+                . '                        }' =>
+                '                        if ($variable === \'months\') {'
+                    . "\n"
+                    . '                            foreach ($months as $index => $name) {'
+                    . "\n"
+                    . '                                $months[$index] = $name.\'|\'.$list[$index];'
+                    . "\n"
+                    . '                            }'
+                    . "\n"
+                    . '                        } else {'
+                    . "\n"
+                    . '                            foreach ($weekdays as $index => $name) {'
+                    . "\n"
+                    . '                                $weekdays[$index] = $name.\'|\'.$list[$index];'
+                    . "\n"
+                    . '                            }'
+                    . "\n"
+                    . '                        }',
+            '            $$translationKey = array_merge(' => '            $translatedWords = array_merge(',
+            '            );' . "\n" . '        }' . "\n" . "\n" . '        // Make all dots optional' =>
+                '            );'
+                    . "\n"
+                    . '            if ($key === \'from\') {'
+                    . "\n"
+                    . '                $fromTranslations = $translatedWords;'
+                    . "\n"
+                    . '            } else {'
+                    . "\n"
+                    . '                $toTranslations = $translatedWords;'
+                    . "\n"
+                    . '            }'
+                    . "\n"
+                    . '        }'
+                    . "\n"
+                    . "\n"
+                    . '        // Make all dots optional',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/Traits/Rounding.php' => [
+            '        foreach ($ranges as $unit => [$minimum, $maximum]) {' => '        foreach ($ranges as $rangeUnit => [$minimum, $maximum]) {',
+            '            if ($normalizedUnit === $unit) {' => '            if ($normalizedUnit === $rangeUnit) {',
+            '                $arguments = [$this->$unit, $minimum];' => '                $arguments = [$this->$rangeUnit, $minimum];',
+            '                $initialValue = $this->$unit;' => '                $initialValue = $this->$rangeUnit;',
+            '                $inc = ($this->$unit - $minimum) * $factor;' => '                $inc = ($this->$rangeUnit - $minimum) * $factor;',
+            '                $changes[$unit] = round(' => '                $changes[$rangeUnit] = round(',
+            '                    $minimum + ($fraction ? $fraction * $function(($this->$unit - $minimum) / $fraction) : 0),' => '                    $minimum + ($fraction ? $fraction * $function(($this->$rangeUnit - $minimum) / $fraction) : 0),',
+            '                while ($changes[$unit] >= $delta) {' => '                while ($changes[$rangeUnit] >= $delta) {',
+            '                    $changes[$unit] -= $delta;' => '                    $changes[$rangeUnit] -= $delta;',
+            '        foreach ($changes as $unit => $value) {' => '        foreach ($changes as $changeUnit => $value) {',
+            '            $result = $result->$unit($value);' => '            $result = $result->$changeUnit($value);',
+        ],
+        'vendor/nesbot/carbon/lazy/Carbon/UnprotectedDatePeriod.php' => [
+            'if (!class_exists(DatePeriodBase::class, false)) {'
+                . "\n"
+                . '    class DatePeriodBase extends DatePeriod'
+                . "\n"
+                . '    {'
+                . "\n"
+                . '    }'
+                . "\n"
+                . '}' =>
+                'class DatePeriodBase extends DatePeriod' . "\n" . '{' . "\n" . '}',
+        ],
+        'vendor/nesbot/carbon/src/Carbon/CarbonPeriod.php' => [
+            'require PHP_VERSION < 8.2'
+                . "\n"
+                . '    ? __DIR__.\'/../../lazy/Carbon/ProtectedDatePeriod.php\''
+                . "\n"
+                . '    : __DIR__.\'/../../lazy/Carbon/UnprotectedDatePeriod.php\';' => '',
+            '\Carbon\CarbonInterval::day()' => 'new \Carbon\CarbonInterval(0, 0, 0, 1)',
+            'CarbonInterval::day()' => 'new CarbonInterval(0, 0, 0, 1)',
+            'CarbonInterval::month()' => 'new CarbonInterval(0, 1)',
+            '$dateClass::make($part)' => '\call_user_func([$dateClass, \'make\'], $part)',
+            '$dateClass::make(static::addMissingParts($start ?? \'\', $part))' => '\call_user_func([$dateClass, \'make\'], static::addMissingParts($start ?? \'\', $part))',
+            '$dateClass::now()' => '\call_user_func([$dateClass, \'now\'])',
+            '$dateClass::isStrictModeEnabled()' => '\call_user_func([$dateClass, \'isStrictModeEnabled\'])',
+            '$dateClass::parse($value, $this->timezoneSetting)' => '\call_user_func([$dateClass, \'parse\'], $value, $this->timezoneSetting)',
+        ],
+        'vendor/illuminate/database/Eloquent/Casts/ArrayObject.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/database/Eloquent/Concerns/HasAttributes.php' => [
+            '        foreach ($this->getArrayableRelations() as $key => $value) {' =>
+                "        foreach (\$this->getArrayableRelations() as \$key => \$value) {\n"
+                    . '            $relationSet = false;',
+            '                $relation = $value->toArray();' => "                \$relation = \$value->toArray();\n                \$relationSet = true;",
+            '                $relation = $value;' => "                \$relation = \$value;\n                \$relationSet = true;",
+            "            if (array_key_exists('relation', get_defined_vars())) { // check if \$relation is in scope (could be null)" => '            if ($relationSet) {',
+        ],
+        'vendor/illuminate/database/Eloquent/Concerns/QueriesRelationships.php' => [
+            '            unset($alias);' => '            $alias = null;',
+        ],
+        'vendor/illuminate/database/Eloquent/Relations/HasOne.php' => [
+            "class HasOne extends HasOneOrMany implements SupportsPartialRelations\n{" =>
+                "class HasOne extends HasOneOrMany implements SupportsPartialRelations\n{\n"
+                    . "    public function getParentKey()\n"
+                    . "    {\n"
+                    . "        return parent::getParentKey();\n"
+                    . "    }\n",
+        ],
+        'vendor/illuminate/database/Eloquent/Relations/MorphOne.php' => [
+            "class MorphOne extends MorphOneOrMany implements SupportsPartialRelations\n{" =>
+                "class MorphOne extends MorphOneOrMany implements SupportsPartialRelations\n{\n"
+                    . "    public function getParentKey()\n"
+                    . "    {\n"
+                    . "        return parent::getParentKey();\n"
+                    . "    }\n",
+        ],
+        'vendor/illuminate/database/Eloquent/Model.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+            '        $class = $class ?: static::class;' =>
+                '        if (!$class) {' . "\n" . '            $class = static::class;' . "\n" . '        }',
+        ],
+        'vendor/illuminate/pagination/Cursor.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/pagination/CursorPaginator.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/pagination/LengthAwarePaginator.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/pagination/Paginator.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/support/DefaultProviders.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/support/Fluent.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/support/InteractsWithTime.php' => [
+            'CarbonInterval::milliseconds($runTime)' => 'new CarbonInterval(0, 0, 0, 0, 0, 0, 0, $runTime * 1000)',
+        ],
+        'vendor/illuminate/support/MessageBag.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/support/UriQueryString.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/support/ValidatedInput.php' => [
+            '    public function toArray()' => '    public function toArray(): array',
+        ],
+        'vendor/illuminate/database/Connection.php' => [
+            '    public function setQueryGrammar(Query\Grammars\Grammar $grammar)' => '    public function setQueryGrammar(?Query\Grammars\Grammar $grammar)',
+        ],
+        'vendor/symfony/cache/Traits/AbstractAdapterTrait.php' => [
+            '    private function generateItems(iterable $items, array &$keys): \Generator' => '    private function generateItems(iterable $items, array $keys): \Generator',
+        ],
+        'vendor/symfony/cache/Traits/ValueWrapper.php' => [
+            "class \xA9" => 'class TypephpSymfonyCacheValueWrapper',
+        ],
+        'vendor/symfony/cache/CacheItem.php' => [
+            '    private const VALUE_WRAPPER = "\xA9";' => "    private const VALUE_WRAPPER = 'TypephpSymfonyCacheValueWrapper';",
+        ],
+        'vendor/webman/database/src/support/Model.php' => [
+            "require_once __DIR__ . '/../Initializer.php';\n" => '',
+        ],
+        'vendor/webman/database/src/support/Db.php' => [
+            "require_once __DIR__ . '/../Initializer.php';\n" => '',
+        ],
+        'vendor/webman/database/src/Initializer.php' => [
+            "\nInitializer::init(config('database', []));\n" => "\n",
+        ],
+        'vendor/webman/database/src/DatabaseManager.php' => [
+            '        $clearProperties = function () {'
+                . "\n"
+                . '            $this->queryGrammar = null;'
+                . "\n"
+                . '        };'
+                . "\n"
+                . '        $clearProperties->call($connection);' => '        $connection->setQueryGrammar(null);',
+        ],
+        'vendor/webman/think-orm/src/Initializer.php' => [
+            "\nInitializer::init();\n" => "\n",
+        ],
+        'vendor/webman/think-orm/src/DbManager.php' => [
+            '        $clearProperties = function () {'
+                . "\n"
+                . '            $this->db = null;'
+                . "\n"
+                . '            $this->cache = null;'
+                . "\n"
+                . '            $this->builder = null;'
+                . "\n"
+                . '        };'
+                . "\n"
+                . '        $clearProperties->call($connection);' => '        $connection->clearRuntimeStateForAot();',
+        ],
+        'vendor/topthink/think-orm/src/model/concern/Conversion.php' => [
+            '            foreach ($append as $key => $attr) {'
+                . "\n"
+                . '                $key = is_numeric($key) ? $attr : $key;' =>
+                '            foreach ($append as $key => $appendAttr) {'
+                    . "\n"
+                    . '                $key = is_numeric($key) ? $appendAttr : $key;',
+            '$this->data[$key] = $model->getAttr($attr);' => '$this->data[$key] = $model->getAttr($appendAttr);',
+        ],
+        'vendor/topthink/think-orm/src/model/concern/RelationShip.php' => [
+            '    private $parent;' => '    protected $parent;',
+        ],
+        'vendor/topthink/think-orm/src/model/concern/Attribute.php' => [
+            '            $relation = false;' . "\n" => '',
+            '            $relation = $this->isRelationAttr($name);'
+                . "\n"
+                . '            $value    = null;' => '            return $this->getValue($name, null, $this->isRelationAttr($name));',
+            '        return $this->getValue($name, $value, $relation);' => '        return $this->getValue($name, $value, false);',
+        ],
+        'vendor/topthink/think-orm/src/model/concern/TimeStamp.php' => [
+            '$value = $this->formatDateTime(\'Y-m-d H:i:s.u\');' => 'return $this->formatDateTime(\'Y-m-d H:i:s.u\');',
+            '$value = $obj->__toString();' => 'return $obj->__toString();',
+            "                    }\n" . "                }\n" . '        }' =>
+                "                    }\n" . "                }\n" . "                break;\n" . '        }',
+        ],
+        'vendor/topthink/think-orm/src/Model.php' => [
+            '    public static function query(): Query' =>
+                '    public static function where(...$args)'
+                    . "\n"
+                    . '    {'
+                    . "\n"
+                    . '        return static::__callStatic(\'where\', $args);'
+                    . "\n"
+                    . '    }'
+                    . "\n"
+                    . "\n"
+                    . '    public static function query(): Query',
+            '$db->transaction(function () use ($data, $allowFields, $db) {' => '$db->transaction(function ($connection) use ($data, $allowFields, $db) {',
+            '$db->transaction(function () use ($data, $sequence, $allowFields, $db) {' => '$db->transaction(function ($connection) use ($data, $sequence, $allowFields, $db) {',
+            '$result = $db->transaction(function () use ($replace, $dataSet) {' => '$result = $db->transaction(function ($connection) use ($replace, $dataSet) {',
+            '$db->transaction(function () use ($where, $db) {' => '$db->transaction(function ($connection) use ($where, $db) {',
+        ],
+        'vendor/vlucas/phpdotenv/src/Repository/RepositoryBuilder.php' => [
+            "        \$reader = new MultiReader(\$this->readers);\n"
+                . "        \$writer = new MultiWriter(\$this->writers);\n\n"
+                . "        if (\$this->immutable) {\n"
+                . "            \$writer = new ImmutableWriter(\$writer, \$reader);\n"
+                . "        }\n\n"
+                . "        if (\$this->allowList !== null) {\n"
+                . "            \$writer = new GuardedWriter(\$writer, \$this->allowList);\n"
+                . "        }\n\n"
+                . '        return new AdapterRepository($reader, $writer);' =>
+                "        \$reader = new MultiReader(\$this->readers);\n"
+                    . "        \$writer = new MultiWriter(\$this->writers);\n\n"
+                    . "        if (\$this->immutable && \$this->allowList !== null) {\n"
+                    . "            return new AdapterRepository(\n"
+                    . "                \$reader,\n"
+                    . "                new GuardedWriter(new ImmutableWriter(\$writer, \$reader), \$this->allowList),\n"
+                    . "            );\n"
+                    . "        }\n\n"
+                    . "        if (\$this->immutable) {\n"
+                    . "            return new AdapterRepository(\$reader, new ImmutableWriter(\$writer, \$reader));\n"
+                    . "        }\n\n"
+                    . "        if (\$this->allowList !== null) {\n"
+                    . "            return new AdapterRepository(\$reader, new GuardedWriter(\$writer, \$this->allowList));\n"
+                    . "        }\n\n"
+                    . '        return new AdapterRepository($reader, $writer);',
+        ],
+        'vendor/vlucas/phpdotenv/src/Parser/EntryParser.php' => [
+            "                }\n" . '            case self::' =>
+                "                }\n"
+                    . "                throw new \\Error('Unreachable parser state.');\n"
+                    . '            case self::',
+        ],
+        'vendor/firebase/php-jwt/src/JWT.php' => [
+            "            \$ex = new BeforeValidException(\n"
+                . "                'Cannot handle token with nbf prior to ' . \\date(DateTime::ATOM, (int) floor(\$payload->nbf))\n"
+                . "            );\n"
+                . "            \$ex->setPayload(\$payload);\n"
+                . '            throw $ex;' =>
+                "            \$beforeValidNbf = new BeforeValidException(\n"
+                    . "                'Cannot handle token with nbf prior to ' . \\date(DateTime::ATOM, (int) floor(\$payload->nbf))\n"
+                    . "            );\n"
+                    . "            \$beforeValidNbf->setPayload(\$payload);\n"
+                    . '            throw $beforeValidNbf;',
+            "            \$ex = new BeforeValidException(\n"
+                . "                'Cannot handle token with iat prior to ' . \\date(DateTime::ATOM, (int) floor(\$payload->iat))\n"
+                . "            );\n"
+                . "            \$ex->setPayload(\$payload);\n"
+                . '            throw $ex;' =>
+                "            \$beforeValidIat = new BeforeValidException(\n"
+                    . "                'Cannot handle token with iat prior to ' . \\date(DateTime::ATOM, (int) floor(\$payload->iat))\n"
+                    . "            );\n"
+                    . "            \$beforeValidIat->setPayload(\$payload);\n"
+                    . '            throw $beforeValidIat;',
+            "            \$ex = new ExpiredException('Expired token');\n"
+                . "            \$ex->setPayload(\$payload);\n"
+                . "            \$ex->setTimestamp(\$timestamp);\n"
+                . '            throw $ex;' =>
+                "            \$expired = new ExpiredException('Expired token');\n"
+                    . "            \$expired->setPayload(\$payload);\n"
+                    . "            \$expired->setTimestamp(\$timestamp);\n"
+                    . '            throw $expired;',
+            "                } catch (Exception \$e) {\n"
+                . "                    throw new DomainException(\$e->getMessage(), 0, \$e);\n"
+                . '                }' =>
+                "                } catch (Exception \$e) {\n"
+                    . "                    throw new DomainException(\$e->getMessage(), 0, \$e);\n"
+                    . "                }\n"
+                    . "                throw new DomainException('Unreachable sodium operation.');",
+        ],
+        'vendor/topthink/think-validate/src/Validate.php' => [
+            '        foreach ($keys as $key) {' . "\n" . '            if (!isset($data[$key])) {' =>
+                '        foreach ($keys as $segment) {' . "\n" . '            if (!isset($data[$segment])) {',
+            '$value = $data = $data[$key];' => '$value = $data = $data[$segment];',
+            'protected function parseErrorMsg(string $msg, $rule, string $title)' => 'protected function parseErrorMsg(mixed $msg, $rule, string $title)',
+        ],
+        'vendor/topthink/think-orm/src/db/BaseQuery.php' => [
+            '        if (empty($this->options[\'where\']) && empty($this->options[\'scope\']) && empty($this->options[\'order\']) && empty($this->options[\'sort\'])) {' =>
+                '        $resultState = new \stdClass();'
+                    . "\n"
+                    . '        if (empty($this->options[\'where\']) && empty($this->options[\'scope\']) && empty($this->options[\'order\']) && empty($this->options[\'sort\'])) {',
+            '            $result = [];' => '            $resultState->value = [];',
+            '            $result = $this->connection->find($this);' => '            $resultState->value = $this->connection->find($this);',
+            '        if (empty($result)) {' => '        if (empty($resultState->value)) {',
+            '            $this->resultToModel($result);' => '            $this->resultToModel($resultState->value);',
+            '            $this->result($result);' => '            $this->result($resultState->value);',
+            '        return $result;'
+                . "\n"
+                . '    }'
+                . "\n"
+                . "\n"
+                . '    /**'
+                . "\n"
+                . '     * 分析表达式（可用于查询或者写入操作）.' =>
+                '        return $resultState->value;'
+                    . "\n"
+                    . '    }'
+                    . "\n"
+                    . "\n"
+                    . '    /**'
+                    . "\n"
+                    . '     * 分析表达式（可用于查询或者写入操作）.',
+            '    protected function tableStr(string $table): array | string' . "\n" . '    {' =>
+                '    protected function tableStr(string $table): array | string'
+                    . "\n"
+                    . '    {'
+                    . "\n"
+                    . '        $tableState = new \stdClass();'
+                    . "\n"
+                    . '        $tableState->value = $table;',
+            '$table          = [];' => '$tableState->value = [];',
+            '$table  = [];' => '$tableState->value = [];',
+            '$table[$item]' => '$tableState->value[$item]',
+            '$table[]' => '$tableState->value[]',
+            '                $tableState->value[] = $val;' => '                $table[] = $val;',
+            '        return $table;'
+                . "\n"
+                . '    }'
+                . "\n"
+                . "\n"
+                . '    /**'
+                . "\n"
+                . '     * 指定多个数据表（数组格式）.' =>
+                '        return $tableState->value;'
+                    . "\n"
+                    . '    }'
+                    . "\n"
+                    . "\n"
+                    . '    /**'
+                    . "\n"
+                    . '     * 指定多个数据表（数组格式）.',
+        ],
+        'vendor/topthink/think-orm/src/db/Connection.php' => [
+            '    /**' . "\n" . '     * 析构方法.' . "\n" . '     */' . "\n" . '    public function __destruct()' =>
+                '    public function clearRuntimeStateForAot(): void'
+                    . "\n"
+                    . '    {'
+                    . "\n"
+                    . '        $this->db = null;'
+                    . "\n"
+                    . '        $this->cache = null;'
+                    . "\n"
+                    . '        $this->builder = null;'
+                    . "\n"
+                    . '    }'
+                    . "\n"
+                    . "\n"
+                    . '    /**'
+                    . "\n"
+                    . '     * 析构方法.'
+                    . "\n"
+                    . '     */'
+                    . "\n"
+                    . '    public function __destruct()',
+        ],
+        'vendor/topthink/think-orm/src/db/concern/ModelRelationQuery.php' => [
+            '    protected function resultToModel(array &$result): void' => '    protected function resultToModel(mixed &$result): void',
+        ],
+        'vendor/topthink/think-orm/src/db/concern/ResultOperation.php' => [
+            '    protected function resultSet(array &$resultSet, bool $toCollection = true): void' => '    protected function resultSet(mixed &$resultSet, bool $toCollection = true): void',
+        ],
+        'vendor/topthink/think-orm/src/db/Fetch.php' => [
+            '        $field = array_map(\'trim\', explode(\',\', $field));'
+                . "\n"
+                . "\n"
+                . '        $this->query->setOption(\'field\', $field);' =>
+                '        $columnFields = array_map(\'trim\', explode(\',\', $field));'
+                    . "\n"
+                    . "\n"
+                    . '        $this->query->setOption(\'field\', $columnFields);',
+        ],
+        'vendor/topthink/think-orm/src/db/concern/WhereQuery.php' => [
+            '        if ($field instanceof $this) {' =>
+                '        $queryClass = get_class($this);' . "\n" . '        if ($field instanceof $queryClass) {',
+        ],
+        'vendor/topthink/think-orm/src/db/Builder.php' => [
+            '                return $this->$fun($query, $key, $exp, $value, $field, $bindType, $val[2] ?? \'AND\');' =>
+                '                if ($fun === \'parseLike\') {'
+                    . "\n"
+                    . '                    return $this->$fun($query, $key, $exp, $value, $field, $bindType, $val[2] ?? \'AND\');'
+                    . "\n"
+                    . '                }'
+                    . "\n"
+                    . '                if (in_array($fun, [\'parseRegexp\', \'parseFindInSet\'], true)) {'
+                    . "\n"
+                    . '                    return $this->$fun($query, $key, $exp, $value, $field);'
+                    . "\n"
+                    . '                }'
+                    . "\n"
+                    . '                if (in_array($fun, [\'parseCompare\', \'parseBetween\', \'parseIn\', \'parseExp\', \'parseNull\', \'parseBetweenTime\', \'parseTime\', \'parseExists\', \'parseColumn\'], true)) {'
+                    . "\n"
+                    . '                    return $this->$fun($query, $key, $exp, $value, $field, $bindType);'
+                    . "\n"
+                    . '                }'
+                    . "\n"
+                    . '                return $this->$fun($query, $key, $exp, $value, $field, $bindType, $val[2] ?? \'AND\');',
+        ],
+        'vendor/topthink/think-orm/src/db/PDOConnection.php' => [
+            '    public function getTableInfo(array | string $tableName, string $fetch = \'\')' => '    public function getTableInfo(mixed $tableName, string $fetch = \'\')',
+            '    public function getFieldsType($tableName, ?string $field = null)' => '    public function getFieldsType(mixed $tableName, ?string $field = null)',
+            '            $pk          = count($pk) > 1 ? $pk : $pk[0];'
+                . "\n"
+                . '            $info[\'_pk\'] = $pk;' => '            $info[\'_pk\'] = count($pk) > 1 ? $pk : $pk[0];',
+            '    protected function autoInsIDType(BaseQuery $query, string $insertId)' . "\n" . '    {' =>
+                '    protected function autoInsIDType(BaseQuery $query, string $insertId)'
+                    . "\n"
+                    . '    {'
+                    . "\n"
+                    . '        $insertIdState = new \stdClass();'
+                    . "\n"
+                    . '        $insertIdState->value = $insertId;',
+            '$insertId = (int) $insertId;' => '$insertIdState->value = (int) $insertId;',
+            '$insertId = (float) $insertId;' => '$insertIdState->value = (float) $insertId;',
+            '        return $insertId;' => '        return $insertIdState->value;',
+            '        $dbMaster = false;' =>
+                '        $dbMasterState = new \stdClass();' . "\n" . '        $dbMasterState->value = false;',
+            '            $dbMaster = [];' => '            $dbMasterState->value = [];',
+            '                $dbMaster[$name] = $config[$name][$m] ?? $config[$name][0];' => '                $dbMasterState->value[$name] = $config[$name][$m] ?? $config[$name][0];',
+            '        return $this->connect($dbConfig, $r, $r == $m ? false : $dbMaster);' => '        return $this->connect($dbConfig, $r, $r == $m ? false : $dbMasterState->value);',
+        ],
+        'vendor/brick/math/src/BigInteger.php' => [
+            '                $value = ~$value;' =>
+                '                $complement = \'\';'
+                    . "\n"
+                    . '                for ($i = 0, $length = strlen($value); $i < $length; $i++) {'
+                    . "\n"
+                    . '                    $complement .= chr(255 - ord($value[$i]));'
+                    . "\n"
+                    . '                }'
+                    . "\n"
+                    . '                $value = $complement;',
+        ],
+        'vendor/brick/math/src/Internal/Calculator.php' => [
+            'toDecimal(' => 'typephpToDecimal(',
+        ],
+        'vendor/brick/math/src/Internal/Calculator/NativeCalculator.php' => [
+            '$na = $a * 1; // cast to number' => '$na = (float) $a; // AOT: force the overflow-safe string algorithm',
+            '$nb = $b * 1;' => '$nb = (float) $b;',
+            '                $q = intdiv($na, $nb);' => '                $intQ = intdiv($na, $nb);',
+            '                $r = $na % $nb;' => '                $intR = $na % $nb;',
+            '                    (string) $q,' => '                    (string) $intQ,',
+            '                    (string) $r,' => '                    (string) $intR,',
+            '            $sum = $blockA - $blockB - $carry;' => '            $sumValue = $blockA - $blockB - $carry;',
+            '            if ($sum < 0) {' => '            if ($sumValue < 0) {',
+            '                $sum += $complement;' => '                $sumValue += $complement;',
+            '            $sum = (string) $sum;' => '            $sum = (string) $sumValue;',
+            '                $value = $mul % $complement;' => '                $remainderValue = $mul % $complement;',
+            '                $carry = ($mul - $value) / $complement;' => '                $carry = ($mul - $remainderValue) / $complement;',
+            '                $value = (string) $value;' => '                $value = (string) $remainderValue;',
+            '            $r = (int) substr($a, 0, $z - 1);' => '            $intRemainder = (int) substr($a, 0, $z - 1);',
+            '                $n = $r * 10 + (int) $a[$i];' => '                $n = $intRemainder * 10 + (int) $a[$i];',
+            '                $r = $n % $nb;' => '                $intRemainder = $n % $nb;',
+            "            return [ltrim(\$q, '0') ?: '0', (string) \$r];" => "            return [ltrim(\$q, '0') ?: '0', (string) \$intRemainder];",
+        ],
+        'vendor/guzzlehttp/psr7/src/Query.php' => [
+            "            \$decoder = 'rawurldecode';" => '            $decoder = static fn($value) => rawurldecode((string) $value);',
+            "            \$decoder = 'urldecode';" => '            $decoder = static fn($value) => urldecode((string) $value);',
+            "            \$encoder = 'rawurlencode';" => '            $encoder = static fn(string $value): string => rawurlencode($value);',
+            "            \$encoder = 'urlencode';" => '            $encoder = static fn(string $value): string => urlencode($value);',
+        ],
+        'vendor/guzzlehttp/psr7/src/StreamWrapper.php' => [
+            '        $options = stream_context_get_options($this->context);' => '        $contextOptions = stream_context_get_options($this->context);',
+            "        if (!isset(\$options['guzzle']['stream'])) {" => "        if (!isset(\$contextOptions['guzzle']['stream'])) {",
+            "        \$this->stream = \$options['guzzle']['stream'];" => "        \$this->stream = \$contextOptions['guzzle']['stream'];",
+        ],
+    ];
+
+    /**
+     * 可变参数闭包补丁的字面替换规则：源文件 => [搜索串 => 替换串]。
+     * 搜索串为 vendor 源码中的精确字面量；未匹配时静默跳过（版本差异容忍）。
+     */
+    protected const VARIADIC_HANDLER_REPLACEMENTS = [
+        'vendor/workerman/workerman/src/Worker.php' => [
+            'set_error_handler(static fn (): bool => true);' => 'set_error_handler(static fn (...$__err): bool => true);',
+            'set_error_handler(function ($code, $msg) {' => 'set_error_handler(function ($code, $msg, ...$__err) {',
+            // 优雅停机/信号路径：array_walk 实传 2 参(value,key)、pcntl_signal 实传 2 参(signo,siginfo)，
+            // 补丁成可变参数避免停机/重载时抛 ArgumentCountError。
+            'array_walk($workers, static fn (Worker $worker) => $worker->stop(false));' => 'array_walk($workers, static fn (Worker $worker, ...$__walk) => $worker->stop(false));',
+            'array_walk($workerPidArray, static fn ($pid) => posix_kill($pid, $sig));' => 'array_walk($workerPidArray, static fn ($pid, ...$__walk) => posix_kill($pid, $sig));',
+            'pcntl_signal($signal, static::signalHandler(...), false);' => 'pcntl_signal($signal, static fn (...$__sig) => static::signalHandler($__sig[0]), false);',
+            // daemon 模式 resetStd()：TypePHP 嵌入式运行时把标准流标记 NO_CLOSE、禁止手动关闭，三处
+            // fclose 必抛 TypeError 令守护进程崩溃。日志重定向不依赖关闭它们——其下 fopen(stdoutFile)
+            // 已把 outputStream 重指向目标文件，故整段删除关闭段（保留一个空行）。
+            self::RESET_STD_STREAM_CLOSE_BLOCK => "\n",
+            // parseCommand 的 `case 'status'` 以 while(1) 死循环结尾后落空到 `case 'connections'`，
+            // 编译器要求 case 以终结语句收尾。循环仅经内部 exit(0) 退出，落空本为不可达死代码，
+            // 补一个不可达的 exit(0) 即满足约束且不改变行为。
+            '                    static::safeEcho("\nPress Ctrl+C to quit.\n\n");'
+                . "\n"
+                . '                }'
+                . "\n"
+                . '            case \'connections\':' =>
+                '                    static::safeEcho("\nPress Ctrl+C to quit.\n\n");'
+                    . "\n"
+                    . '                }'
+                    . "\n"
+                    . '                exit(0);'
+                    . "\n"
+                    . '            case \'connections\':',
+        ],
+        'vendor/workerman/workerman/src/Timer.php' => [
+            'pcntl_signal(SIGALRM, self::signalHandle(...), false);' => 'pcntl_signal(SIGALRM, static fn (...$__sig) => self::signalHandle(), false);',
+        ],
+        'vendor/workerman/workerman/src/Connection/TcpConnection.php' => [
+            'set_error_handler(static function (int $code, string $msg): bool {' => 'set_error_handler(static function (int $code, string $msg, ...$__err): bool {',
+            "        \$reason = '';\n"
+                . '        set_error_handler(static function (int $code, string $msg) use (&$reason): bool {' => '        set_error_handler(static function (int $code, string $msg, ...$__err) use (&$reason): bool {',
+            "        } finally {\n"
+                . "            restore_error_handler();\n"
+                . "        }\n"
+                . '        // Negotiation has failed.' =>
+                "        } finally {\n"
+                    . "            restore_error_handler();\n"
+                    . "        }\n"
+                    . "        if (\$reason === null) {\n"
+                    . "            \$reason = '';\n"
+                    . "        }\n"
+                    . '        // Negotiation has failed.',
+        ],
+        'vendor/workerman/workerman/src/Connection/AsyncTcpConnection.php' => [
+            'set_error_handler(fn() => false);' => 'set_error_handler(fn(...$__err) => false);',
+        ],
+        'vendor/workerman/workerman/src/Events/Select.php' => [
+            'pcntl_signal($signal, fn () => $this->safeCall($this->signalEvents[$signal], [$signal]));' => 'pcntl_signal($signal, fn (...$__sig) => $this->safeCall($this->signalEvents[$signal], [$signal]));',
+        ],
+        'vendor/workerman/webman-framework/src/File.php' => [
+            'set_error_handler(function ($type, $msg) use (&$error) {' => 'set_error_handler(function ($type, $msg, ...$__err) use (&$error) {',
+        ],
+    ];
+
+    protected string $basePath;
+
+    public function __construct(string $basePath)
+    {
+        $this->basePath = rtrim($basePath, DIRECTORY_SEPARATOR);
+    }
+
+    /**
+     * 生成或刷新 main.php AOT 入口
+     */
+    public function generateMain(?string $targetFile = null, bool $force = false): string
+    {
+        $targetFile = $targetFile ?: $this->basePath . DIRECTORY_SEPARATOR . 'main.php';
+        $stubPath = dirname(__DIR__) . '/Stubs/main.php.stub';
+        $content = file_get_contents($stubPath);
+        if ($content === false) {
+            throw new \RuntimeException('Unable to read the TypePHP main.php stub.');
+        }
+        // 彻底去除任何可能的 UTF-8 BOM 头 (EF BB BF)
+        $content = (string) preg_replace('/^\xEF\xBB\xBF/', '', $content);
+
+        if (!file_exists($targetFile)) {
+            file_put_contents($targetFile, $content);
+        } elseif ($force || str_contains((string) file_get_contents($targetFile), '$helpersFile = BASE_PATH')) {
+            // 当明确指定 force 或检测到旧版废弃动态加载逻辑时，先备份再更新
+            $backupFile = $targetFile . '.bak';
+            copy($targetFile, $backupFile);
+            file_put_contents($targetFile, $content);
+        }
+        return $targetFile;
+    }
+
+    /**
+     * 为所有守卫源文件生成 AOT 专用平铺版本
+     *
+     * 读取项目实际安装的守卫文件（webman helpers.php、fast-route functions.php 等），
+     * 剥离顶层 if 守卫后写入打包工作区。旧版（纯函数声明）文件会被原样保留；
+     * 新版（function_exists / BASE_PATH 守卫）文件会被平铺成顶层函数声明，保证任何
+     * Webman 版本均可编译。返回生成的平铺文件相对路径列表（不含未安装的源）。
+     *
+     * @return list<string>
+     */
+    public function generateFlattenedSources(): array
+    {
+        $generated = [];
+        foreach (array_merge(
+            $this->guardedSources,
+            $this->discoverProjectGuardedSources(),
+        ) as $sourceRel => $targetRel) {
+            $sourceFile = $this->basePath . '/' . $sourceRel;
+            if (!is_file($sourceFile)) {
+                continue;
+            }
+            $content = file_get_contents($sourceFile);
+            if ($content === false) {
+                throw new \RuntimeException('Unable to read the guarded source file: ' . $sourceFile);
+            }
+
+            $targetFile = $this->basePath . '/' . $targetRel;
+            $directory = dirname($targetFile);
+            if (!is_dir($directory) && !mkdir($directory, 0777, true) && !is_dir($directory)) {
+                throw new \RuntimeException('Unable to create the TypePHP build directory: ' . $directory);
+            }
+            $content = $this->prepareGuardedSource($sourceRel, $content);
+            if (file_put_contents($targetFile, $this->flattenGuardedSource($content)) === false) {
+                throw new \RuntimeException('Unable to write the AOT flattened source: ' . $targetFile);
+            }
+            $generated[] = $targetRel;
+        }
+        return $generated;
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function discoverProjectGuardedSources(): array
+    {
+        $sources = [];
+        if (is_file($this->basePath . '/app/functions.php')) {
+            $sources['app/functions.php'] = '.typephp/build/app-functions.php';
+        }
+        foreach (glob($this->basePath . '/plugin/*/app/functions.php') ?: [] as $sourceFile) {
+            $plugin = basename(dirname(dirname($sourceFile)));
+            if (!preg_match('/^[A-Za-z0-9_-]+$/', $plugin)) {
+                continue;
+            }
+            $sources["plugin/{$plugin}/app/functions.php"] = ".typephp/build/{$plugin}-functions.php";
+        }
+        ksort($sources);
+        return $sources;
+    }
+
+    /**
+     * Webman discovers plugin routes and bootstrap configuration from files in
+     * plugin/<name>/config at runtime. Keep those configuration directories in
+     * the portable package even when the application code itself is compiled.
+     *
+     * @return list<string>
+     */
+    public function discoverPluginConfigResources(): array
+    {
+        $resources = [];
+        foreach (glob($this->basePath . '/plugin/*/config', GLOB_ONLYDIR) ?: [] as $configDirectory) {
+            $plugin = basename(dirname($configDirectory));
+            if (!preg_match('/^[A-Za-z0-9_-]+$/', $plugin)) {
+                continue;
+            }
+            $resources[] = "plugin/{$plugin}/config";
+        }
+        sort($resources);
+        return $resources;
+    }
+
+    /**
+     * @return list<string>
+     */
+    public function discoverWebmanVendorPackagingSources(): array
+    {
+        $sources = [];
+        foreach (glob($this->basePath . '/vendor/webman/*/src') ?: [] as $sourceDirectory) {
+            $package = basename(dirname($sourceDirectory));
+            if (!preg_match('/^[A-Za-z0-9_-]+$/', $package)) {
+                continue;
+            }
+            if (is_file($sourceDirectory . '/Install.php')) {
+                $sources[] = "vendor/webman/{$package}/src/Install.php";
+            }
+            if (is_dir($sourceDirectory . '/config')) {
+                $sources[] = "vendor/webman/{$package}/src/config";
+            }
+            foreach (['demo', 'tests'] as $developmentDirectory) {
+                if (is_dir(dirname($sourceDirectory) . '/' . $developmentDirectory)) {
+                    $sources[] = "vendor/webman/{$package}/{$developmentDirectory}";
+                }
+            }
+        }
+        sort($sources);
+        return $sources;
+    }
+
+    /**
+     * IDE metadata is executable-looking PHP but is never loaded by Composer
+     * or the application runtime. It must not become an AOT compilation unit.
+     *
+     * @return list<string>
+     */
+    public function discoverVendorIdeMetadata(): array
+    {
+        $vendor = $this->basePath . '/vendor';
+        if (!is_dir($vendor)) {
+            return [];
+        }
+        $sources = [];
+        $iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator(
+            $vendor,
+            \FilesystemIterator::SKIP_DOTS,
+        ));
+        foreach ($iterator as $file) {
+            if ($file->isFile() && $file->getFilename() === '.phpstorm.meta.php') {
+                $sources[] = str_replace('\\', '/', substr($file->getPathname(), strlen($this->basePath) + 1));
+            }
+        }
+        sort($sources);
+        return $sources;
+    }
+
+    /**
+     * @return list<string>
+     */
+    public function discoverFrameworkSupportOverrides(): array
+    {
+        $overrides = [];
+        foreach (['Request.php', 'Response.php'] as $file) {
+            if (
+                is_file($this->basePath . '/support/' . $file)
+                && is_file($this->basePath . '/vendor/workerman/webman-framework/src/support/' . $file)
+            ) {
+                $overrides[] = 'vendor/workerman/webman-framework/src/support/' . $file;
+            }
+        }
+        return $overrides;
+    }
+
+    /**
+     * 固定 PHP 8.4、无 intl 的构建组合下，静态选择 grapheme polyfill 的 8.0+
+     * 声明分支，并把运行时 define 转为 TypePHP 可接受的顶层常量。
+     */
+    protected function prepareGuardedSource(string $sourceRel, string $content): string
+    {
+        if ($sourceRel === 'vendor/illuminate/support/functions.php') {
+            $replacements = [
+                'CarbonInterval::microseconds($microseconds)' => 'new CarbonInterval(0, 0, 0, 0, 0, 0, 0, $microseconds)',
+                'CarbonInterval::milliseconds($milliseconds)' => 'new CarbonInterval(0, 0, 0, 0, 0, 0, 0, $milliseconds * 1000)',
+                'CarbonInterval::seconds($seconds)' => 'new CarbonInterval(0, 0, 0, 0, 0, 0, $seconds)',
+                'CarbonInterval::minutes($minutes)' => 'new CarbonInterval(0, 0, 0, 0, 0, $minutes)',
+                'CarbonInterval::hours($hours)' => 'new CarbonInterval(0, 0, 0, 0, $hours)',
+                'CarbonInterval::days($days)' => 'new CarbonInterval(0, 0, 0, $days)',
+                'CarbonInterval::weeks($weeks)' => 'new CarbonInterval(0, 0, $weeks)',
+                'CarbonInterval::months($months)' => 'new CarbonInterval(0, $months)',
+                'CarbonInterval::years($years)' => 'new CarbonInterval($years)',
+            ];
+            foreach ($replacements as $search => $replacement) {
+                $content = str_replace($search, $replacement, $content, $count);
+                if ($count !== 1) {
+                    throw new \RuntimeException(
+                        "Illuminate support interval compatibility rule expected 1 match, found {$count}: {$search}.",
+                    );
+                }
+            }
+        }
+        if ($sourceRel === 'vendor/cakephp/core/functions.php') {
+            $constantBlocks = <<<'PHP'
+                if (!defined('DS')) {
+                    /**
+                     * Defines DS as short form of DIRECTORY_SEPARATOR.
+                     */
+                    define('DS', DIRECTORY_SEPARATOR);
+                }
+
+                if (!defined('CAKE_DATE_RFC7231')) {
+                    define('CAKE_DATE_RFC7231', 'D, d M Y H:i:s \G\M\T');
+                }
+                PHP;
+            $content = str_replace($constantBlocks, '', $content, $constantCount);
+            $content = $this->flattenGuardedSource($content);
+            $content = str_replace(
+                'namespace Cake\Core;',
+                "namespace {\nconst DS = DIRECTORY_SEPARATOR;\n"
+                . "const CAKE_DATE_RFC7231 = 'D, d M Y H:i:s \\\\G\\\\M\\\\T';\n}\n\nnamespace Cake\\Core {",
+                $content,
+                $namespaceCount,
+            );
+            if ($constantCount !== 1 || $namespaceCount !== 1) {
+                throw new \RuntimeException('The CakePHP core constants no longer match the pinned AOT transform.');
+            }
+            return $content . "\n}\n";
+        }
+        if ($sourceRel === 'vendor/nikic/fast-route/src/functions.php') {
+            $content = str_replace('$options += [', '$options = $options + [', $content, $count);
+            if ($count < 1 || str_contains($content, '$options += [')) {
+                throw new \RuntimeException('The FastRoute options union no longer matches the pinned AOT transform.');
+            }
+            return $content;
+        }
+        if ($sourceRel === 'vendor/illuminate/reflection/helpers.php') {
+            $search =
+                '$proxy = $reflectionClass->newLazyProxy(function () use ($callback, $eager, &$proxy) {'
+                . "\n"
+                . '            $instance = $callback($proxy, $eager);'
+                . "\n\n"
+                . '            return $instance;'
+                . "\n"
+                . '        }, $options);';
+            $replace =
+                '$proxyInitializer = function () use ($callback, $eager, &$proxy) {'
+                . "\n"
+                . '            $instance = $callback($proxy, $eager);'
+                . "\n\n"
+                . '            return $instance;'
+                . "\n"
+                . '        };'
+                . "\n\n"
+                . '        $proxy = $reflectionClass->newLazyProxy($proxyInitializer, $options);';
+            $content = str_replace($search, $replace, $content, $count);
+            if ($count !== 1) {
+                throw new \RuntimeException(
+                    'The Illuminate reflection proxy helper no longer matches the pinned AOT transform.',
+                );
+            }
+            return $content;
+        }
+        if ($sourceRel === 'vendor/illuminate/support/helpers.php') {
+            $search =
+                'return preg_replace_callback($pattern, function () use (&$replacements) {'
+                . "\n"
+                . '            return array_shift($replacements);'
+                . "\n"
+                . '        }, $subject);';
+            $replace =
+                'return preg_replace_callback($pattern, function () use ($replacements, &$remaining) {'
+                . "\n"
+                . '            if ($remaining === null) {'
+                . "\n"
+                . '                $remaining = $replacements;'
+                . "\n"
+                . '            }'
+                . "\n\n"
+                . '            return array_shift($remaining);'
+                . "\n"
+                . '        }, $subject);';
+            $content = str_replace($search, $replace, $content, $count);
+            if ($count !== 1) {
+                throw new \RuntimeException(
+                    'The Illuminate preg_replace_array helper no longer matches the pinned AOT transform.',
+                );
+            }
+            return $content;
+        }
+        if ($sourceRel === 'vendor/symfony/var-dumper/Resources/functions/dump.php') {
+            $content = str_replace(
+                "            VarDumper::dump(\$vars[0]);\n            \$k = 0;",
+                "            VarDumper::dump(\$vars[0]);",
+                $content,
+                $assignmentCount,
+            );
+            $content = str_replace('return $vars[$k];', 'return $vars[0];', $content, $returnCount);
+            if ($assignmentCount !== 1 || $returnCount !== 1) {
+                throw new \RuntimeException('The Symfony VarDumper helper no longer matches the pinned AOT transform.');
+            }
+            return $content;
+        }
+        if (preg_match('#^vendor/symfony/cache/Traits/Redis(?:Cluster)?6[123]ProxyTrait\.php$#', $sourceRel)) {
+            return $this->selectSymfonyRedis6ProxyTrait($content);
+        }
+        if ($sourceRel === 'vendor/symfony/polyfill-php85/bootstrap.php') {
+            return $this->selectPhp85BootstrapForPhp84($content);
+        }
+        if ($sourceRel === 'vendor/zoujingli/ip2region/function.php') {
+            $content = (string) preg_replace(
+                "/if \\(!class_exists\\('Ip2Region'\\)\\) \\{\\s*require_once __DIR__ \\. '\\/Ip2Region\\.php';\\s*\\}\\s*/",
+                '',
+                $content,
+                1,
+                $loaderCount,
+            );
+            if ($loaderCount !== 1) {
+                throw new \RuntimeException(
+                    'The IP2Region function loader no longer matches the pinned AOT transform.',
+                );
+            }
+            return $content;
+        }
+        if ($sourceRel === 'vendor/zoujingli/ip2region/src/common.php') {
+            $content = (string) preg_replace(
+                "/\\s*if \\(!class_exists\\('Ip2Region'\\)\\) \\{\\s*"
+                . "require_once __DIR__ \\. '\\/src\\/Ip2Region\\.php';\\s*\\}/",
+                '',
+                $content,
+                1,
+                $loaderCount,
+            );
+            if ($loaderCount !== 1) {
+                throw new \RuntimeException(
+                    'The IP2Region v3 class loader no longer matches the pinned AOT transform.',
+                );
+            }
+            return $content;
+        }
+        if (str_starts_with($sourceRel, 'vendor/symfony/polyfill-php85/Resources/stubs/')) {
+            $count = 0;
+            $content = (string) preg_replace(
+                '/if \(\\\\PHP_VERSION_ID < 80500\) \{\n([\s\S]*)\n\}\s*$/',
+                '$1',
+                $content,
+                1,
+                $count,
+            );
+            if ($count !== 1 || str_contains($content, 'PHP_VERSION_ID')) {
+                throw new \RuntimeException(
+                    'The Symfony PHP 8.5 stub structure no longer matches the pinned PHP 8.4 AOT transform.',
+                );
+            }
+            return $content;
+        }
 
-    protected string $basePath;
+        $intlBootstrapSources = [
+            'vendor/symfony/polyfill-intl-grapheme/bootstrap80.php',
+            'vendor/symfony/polyfill-intl-idn/bootstrap80.php',
+        ];
+        if (!in_array($sourceRel, $intlBootstrapSources, true)) {
+            return $content;
+        }
 
-    public function __construct(string $basePath)
-    {
-        $this->basePath = rtrim($basePath, DIRECTORY_SEPARATOR);
+        $constantGuard = "/if \\(!defined\\('([A-Z][A-Z0-9_]*)'\\)\\) \\{\\n    define\\('\\1', ([0-9]+)\\);\\n\\}\\n/";
+        $content = (string) preg_replace($constantGuard, "const $1 = $2;\n", $content);
+        if ($sourceRel === 'vendor/symfony/polyfill-intl-idn/bootstrap80.php') {
+            if (str_contains($content, '!defined(')) {
+                throw new \RuntimeException(
+                    'The Symfony IDN bootstrap structure no longer matches the pinned PHP 8.4 AOT transform.',
+                );
+            }
+            return $content;
+        }
+
+        $content = (string) preg_replace(
+            [
+                "/if \\(extension_loaded\\('intl'\\)\\) \\{\\n    return;\\n\\}\\n/",
+                "/if \\(\\\\PHP_VERSION_ID >= 80500\\) \\{\\n    return require __DIR__\\.'\\/bootstrap85\\.php';\\n\\}\\n/",
+            ],
+            ['', ''],
+            $content,
+        );
+        if (
+            str_contains($content, "extension_loaded('intl')")
+            || str_contains($content, 'PHP_VERSION_ID >= 80500')
+            || str_contains($content, "defined('GRAPHEME_EXTR_")
+        ) {
+            throw new \RuntimeException(
+                'The Symfony grapheme bootstrap structure no longer matches the pinned PHP 8.4 AOT transform.',
+            );
+        }
+        return $content;
     }
 
     /**
-     * 生成或刷新 main.php AOT 入口
+     * 构建镜像固定 phpredis 6.3，选择 Symfony Redis 6.1/6.2/6.3 trait 的新签名分支。
      */
-    public function generateMain(?string $targetFile = null, bool $force = false): string
+    protected function selectSymfonyRedis6ProxyTrait(string $content): string
     {
-        $targetFile = $targetFile ?: $this->basePath . DIRECTORY_SEPARATOR . 'main.php';
-        $stubPath = dirname(__DIR__) . '/Stubs/main.php.stub';
-        $content = file_get_contents($stubPath);
-        if ($content === false) {
-            throw new \RuntimeException('Unable to read the TypePHP main.php stub.');
-        }
-        // 彻底去除任何可能的 UTF-8 BOM 头 (EF BB BF)
-        $content = (string) preg_replace('/^\xEF\xBB\xBF/', '', $content);
-
-        if (!file_exists($targetFile)) {
-            file_put_contents($targetFile, $content);
-        } elseif ($force || str_contains((string) file_get_contents($targetFile), '$helpersFile = BASE_PATH')) {
-            // 当明确指定 force 或检测到旧版废弃动态加载逻辑时，先备份再更新
-            $backupFile = $targetFile . '.bak';
-            copy($targetFile, $backupFile);
-            file_put_contents($targetFile, $content);
+        $content = (string) preg_replace(
+            '/if \(version_compare\(phpversion\(\'redis\'\), \'6\.[123]\.[^\\\']*\', \'>=?\'\)\) \{\n'
+            . '([\s\S]*?)\n\} else \{\n[\s\S]*\n\}\s*$/',
+            '$1',
+            $content,
+            1,
+            $count,
+        );
+        if ($count !== 1 || str_contains($content, "phpversion('redis')")) {
+            throw new \RuntimeException(
+                'The Symfony Redis 6 proxy trait structure no longer matches the pinned phpredis 6.3 AOT transform.',
+            );
         }
-        return $targetFile;
+        return $content;
     }
 
     /**
-     * 为所有守卫源文件生成 AOT 专用平铺版本
-     *
-     * 读取项目实际安装的守卫文件（webman helpers.php、fast-route functions.php 等），
-     * 剥离顶层 if 守卫后写入打包工作区。旧版（纯函数声明）文件会被原样保留；
-     * 新版（function_exists / BASE_PATH 守卫）文件会被平铺成顶层函数声明，保证任何
-     * Webman 版本均可编译。返回生成的平铺文件相对路径列表（不含未安装的源）。
-     *
-     * @return list<string>
+     * PHP 8.4 需要 php85 的四个通用函数，但无 intl 时不应暴露 intl 分支。
      */
-    public function generateFlattenedSources(): array
+    protected function selectPhp85BootstrapForPhp84(string $content): string
     {
-        $generated = [];
-        foreach (self::GUARDED_SOURCES as $sourceRel => $targetRel) {
-            $sourceFile = $this->basePath . '/' . $sourceRel;
-            if (!is_file($sourceFile)) {
-                continue;
-            }
-            $content = file_get_contents($sourceFile);
-            if ($content === false) {
-                throw new \RuntimeException('Unable to read the guarded source file: ' . $sourceFile);
-            }
-
-            $targetFile = $this->basePath . '/' . $targetRel;
-            $directory = dirname($targetFile);
-            if (!is_dir($directory) && !mkdir($directory, 0777, true) && !is_dir($directory)) {
-                throw new \RuntimeException('Unable to create the TypePHP build directory: ' . $directory);
-            }
-            if (file_put_contents($targetFile, $this->flattenGuardedSource($content)) === false) {
-                throw new \RuntimeException('Unable to write the AOT flattened source: ' . $targetFile);
+        $content = (string) preg_replace(
+            '/if \(\\\\PHP_VERSION_ID >= 80500\) \{\s*return;\s*\}\s*/',
+            '',
+            $content,
+            1,
+            $versionCount,
+        );
+        if ($versionCount !== 1) {
+            throw new \RuntimeException(
+                'The Symfony PHP 8.5 bootstrap structure no longer matches the pinned PHP 8.4 AOT transform.',
+            );
+        }
+        $content = (string) preg_replace(
+            "/if \\(extension_loaded\\('intl'\\) && !function_exists\\('locale_is_right_to_left'\\)\\) \\{\\n"
+            . "    function locale_is_right_to_left\\([^\\n]+\\n"
+            . "\\}\\s*/",
+            '',
+            $content,
+            1,
+            $intlCount,
+        );
+        $legacyStart = strpos($content, "if (\\PHP_VERSION_ID >= 80000) {\n");
+        if ($intlCount !== 1 || $legacyStart === false) {
+            throw new \RuntimeException(
+                'The Symfony PHP 8.5 bootstrap branches no longer match the pinned PHP 8.4 AOT transform.',
+            );
+        }
+        $content = substr($content, 0, $legacyStart);
+        foreach (['get_error_handler', 'get_exception_handler', 'array_first', 'array_last'] as $function) {
+            if (!str_contains($content, "function {$function}(")) {
+                throw new \RuntimeException("The Symfony PHP 8.5 bootstrap is missing {$function}().");
             }
-            $generated[] = $targetRel;
         }
-        return $generated;
+        return $content;
     }
 
     /**
@@ -452,13 +3426,27 @@ public function generateNullableStaticSources(): array
             if ($content === false) {
                 throw new \RuntimeException('Unable to read the static-patch source file: ' . $sourceFile);
             }
+            if ($sourceRel === 'vendor/workerman/coroutine/src/Barrier/Swoole.php') {
+                $needle = 'public static function wait(object &$barrier, int $timeout = -1): void';
+                $count = substr_count($content, $needle);
+                if ($count !== 1) {
+                    throw new \RuntimeException(
+                        "Coroutine Swoole Barrier reference compatibility rule expected 1 match, found {$count}.",
+                    );
+                }
+            }
 
             $targetFile = $this->basePath . '/' . $targetRel;
             $directory = dirname($targetFile);
             if (!is_dir($directory) && !mkdir($directory, 0777, true) && !is_dir($directory)) {
                 throw new \RuntimeException('Unable to create the TypePHP build directory: ' . $directory);
             }
-            if (file_put_contents($targetFile, $this->stripStrayBootstrapCalls($this->patchUninitializedScalarStatics($content))) === false) {
+            if (
+                file_put_contents(
+                    $targetFile,
+                    $this->stripStrayBootstrapCalls($this->patchUninitializedScalarStatics($content)),
+                ) === false
+            ) {
                 throw new \RuntimeException('Unable to write the AOT static-patch source: ' . $targetFile);
             }
             $generated[] = $targetRel;
@@ -482,6 +3470,31 @@ protected function stripStrayBootstrapCalls(string $content): string
         );
     }
 
+    /**
+     * ArrayObject dimension writes are emitted by TypePHP as read-modify-write
+     * operations. Writing a previously absent context key then raises an
+     * undefined-key warning, which Webman's error handler promotes to an
+     * exception. Explicit offsetSet() preserves the PHP write semantics.
+     */
+    protected function patchCoroutineFiberContextWrites(string $content): string
+    {
+        $replacements = [
+            'static::$nonFiberContext[$name] = $value;' => 'static::$nonFiberContext->offsetSet($name, $value);',
+            'static::$contexts[$fiber][$name] = $value;' => 'static::$contexts[$fiber]->offsetSet($name, $value);',
+        ];
+        foreach ($replacements as $search => $replace) {
+            $count = substr_count($content, $search);
+            if ($count !== 1) {
+                throw new \RuntimeException(
+                    'Coroutine Fiber context-write compatibility rule expected 1 match, ' . "found {$count}: {$search}",
+                );
+            }
+            $content = str_replace($search, $replace, $content);
+        }
+
+        return $content;
+    }
+
     /**
      * 为含顶层引导调用的源文件生成剥离后的 AOT 专用版本
      *
@@ -510,7 +3523,11 @@ public function generateStrayBootstrapSources(): array
             if (!is_dir($directory) && !mkdir($directory, 0777, true) && !is_dir($directory)) {
                 throw new \RuntimeException('Unable to create the TypePHP build directory: ' . $directory);
             }
-            if (file_put_contents($targetFile, $this->stripStrayBootstrapCalls($content)) === false) {
+            $content = $this->stripStrayBootstrapCalls($content);
+            if ($sourceRel === 'vendor/workerman/coroutine/src/Context/Fiber.php') {
+                $content = $this->patchCoroutineFiberContextWrites($content);
+            }
+            if (file_put_contents($targetFile, $content) === false) {
                 throw new \RuntimeException('Unable to write the AOT stray-bootstrap source: ' . $targetFile);
             }
             $generated[] = $targetRel;
@@ -518,6 +3535,120 @@ public function generateStrayBootstrapSources(): array
         return $generated;
     }
 
+    /**
+     * @return list<string>
+     */
+    public function generatePreloadHintSources(): array
+    {
+        $generated = [];
+        foreach (self::PRELOAD_HINT_SOURCES as $sourceRel => [$targetRel, $expected]) {
+            $sourceFile = $this->basePath . '/' . $sourceRel;
+            if (!is_file($sourceFile)) {
+                continue;
+            }
+            $content = file_get_contents($sourceFile);
+            if ($content === false) {
+                throw new \RuntimeException('Unable to read preload-hint source: ' . $sourceFile);
+            }
+            $content = (string) preg_replace('/^class_exists\\([^;\\r\\n]+\\);[ \\t]*\\R/m', '', $content, -1, $count);
+            if ($count !== $expected) {
+                throw new \RuntimeException(
+                    "Preload hint compatibility rule expected {$expected} match(es), found {$count}: {$sourceRel}.",
+                );
+            }
+            if ($sourceRel === 'vendor/symfony/http-kernel/HttpKernel.php') {
+                $content = $this->patchSymfonyHttpKernelEvents($content);
+            }
+            if ($sourceRel === 'vendor/symfony/http-foundation/Session/Storage/NativeSessionStorage.php') {
+                $content = $this->patchSymfonyNativeSessionStorage($content);
+            }
+            $targetFile = $this->basePath . '/' . $targetRel;
+            $directory = dirname($targetFile);
+            if (!is_dir($directory) && !mkdir($directory, 0777, true) && !is_dir($directory)) {
+                throw new \RuntimeException('Unable to create the TypePHP build directory: ' . $directory);
+            }
+            if (file_put_contents($targetFile, $content) === false) {
+                throw new \RuntimeException('Unable to write preload-hint source: ' . $targetFile);
+            }
+            $generated[] = $targetRel;
+        }
+        return $generated;
+    }
+
+    protected function patchSymfonyNativeSessionStorage(string $content): string
+    {
+        $replacements = [
+            '    protected function loadSession(?array &$session = null): void' => '    protected function loadSession(mixed $session = null): void',
+            '            $session = &$_SESSION;' => '            $session = $_SESSION;',
+            "        \$this->started = true;\n" . '        $this->closed = false;' =>
+                "        \$_SESSION = \$session;\n\n"
+                    . "        \$this->started = true;\n"
+                    . '        $this->closed = false;',
+        ];
+        foreach ($replacements as $search => $replacement) {
+            $content = str_replace($search, $replacement, $content, $count);
+            if ($count !== 1) {
+                throw new \RuntimeException(
+                    "Symfony native session compatibility rule expected 1 match, found {$count}.",
+                );
+            }
+        }
+
+        return $content;
+    }
+
+    protected function patchSymfonyHttpKernelEvents(string $content): string
+    {
+        $replacements = [
+            "        \$event = new RequestEvent(\$this, \$request, \$type);\n"
+                . "        \$this->dispatcher->dispatch(\$event, KernelEvents::REQUEST);\n\n"
+                . "        if (\$event->hasResponse()) {\n"
+                . "            return \$this->filterResponse(\$event->getResponse(), \$request, \$type);\n"
+                . '        }' =>
+                "        \$requestEvent = new RequestEvent(\$this, \$request, \$type);\n"
+                    . "        \$this->dispatcher->dispatch(\$requestEvent, KernelEvents::REQUEST);\n\n"
+                    . "        if (\$requestEvent->hasResponse()) {\n"
+                    . "            return \$this->filterResponse(\$requestEvent->getResponse(), \$request, \$type);\n"
+                    . '        }',
+            "        \$event = new ControllerEvent(\$this, \$controller, \$request, \$type);\n"
+                . "        \$this->dispatcher->dispatch(\$event, KernelEvents::CONTROLLER);\n"
+                . "        \$controller = \$event->getController();\n\n"
+                . "        // controller arguments\n"
+                . "        \$arguments = \$this->argumentResolver->getArguments(\$request, \$controller, \$event->getControllerReflector());\n\n"
+                . "        \$event = new ControllerArgumentsEvent(\$this, \$event, \$arguments, \$request, \$type);\n"
+                . "        \$this->dispatcher->dispatch(\$event, KernelEvents::CONTROLLER_ARGUMENTS);\n"
+                . "        \$controller = \$event->getController();\n"
+                . '        $arguments = $event->getArguments();' =>
+                "        \$controllerEvent = new ControllerEvent(\$this, \$controller, \$request, \$type);\n"
+                    . "        \$this->dispatcher->dispatch(\$controllerEvent, KernelEvents::CONTROLLER);\n"
+                    . "        \$controller = \$controllerEvent->getController();\n\n"
+                    . "        // controller arguments\n"
+                    . "        \$arguments = \$this->argumentResolver->getArguments(\$request, \$controller, \$controllerEvent->getControllerReflector());\n\n"
+                    . "        \$controllerArgumentsEvent = new ControllerArgumentsEvent(\$this, \$controllerEvent, \$arguments, \$request, \$type);\n"
+                    . "        \$this->dispatcher->dispatch(\$controllerArgumentsEvent, KernelEvents::CONTROLLER_ARGUMENTS);\n"
+                    . "        \$controller = \$controllerArgumentsEvent->getController();\n"
+                    . '        $arguments = $controllerArgumentsEvent->getArguments();',
+            "            \$event = new ViewEvent(\$this, \$request, \$type, \$response, \$event);\n"
+                . "            \$this->dispatcher->dispatch(\$event, KernelEvents::VIEW);\n\n"
+                . "            if (\$event->hasResponse()) {\n"
+                . '                $response = $event->getResponse();' =>
+                "            \$viewEvent = new ViewEvent(\$this, \$request, \$type, \$response, \$controllerArgumentsEvent);\n"
+                    . "            \$this->dispatcher->dispatch(\$viewEvent, KernelEvents::VIEW);\n\n"
+                    . "            if (\$viewEvent->hasResponse()) {\n"
+                    . '                $response = $viewEvent->getResponse();',
+        ];
+        foreach ($replacements as $search => $replacement) {
+            $content = str_replace($search, $replacement, $content, $count);
+            if ($count !== 1) {
+                throw new \RuntimeException(
+                    "Symfony HttpKernel event compatibility rule expected 1 match, found {$count}.",
+                );
+            }
+        }
+
+        return $content;
+    }
+
     /**
      * 把未初始化的标量类型静态属性补成可空并显式默认 null
      *
@@ -527,11 +3658,16 @@ public function generateStrayBootstrapSources(): array
      */
     protected function patchUninitializedScalarStatics(string $content): string
     {
-        return (string) preg_replace(
+        $content = (string) preg_replace(
             '/(^|\n)([ \t]*(?:public|protected|private)[ \t]+static[ \t]+)(bool|int|float|string)([ \t]+\$[A-Za-z_][A-Za-z0-9_]*)[ \t]*;/',
             '$1$2?$3$4 = null;',
             $content,
         );
+        return str_replace(
+            'public static function wait(object &$barrier, int $timeout = -1): void',
+            'public static function wait(mixed &$barrier, int $timeout = -1): void',
+            $content,
+        );
     }
 
     /**
@@ -622,7 +3758,21 @@ public function generateRefCaptureSources(): array
     protected function patchRefCaptures(string $sourceRel, string $content): string
     {
         foreach (self::REF_CAPTURE_REPLACEMENTS[$sourceRel] ?? [] as $search => $replacement) {
-            $content = str_replace($search, $replacement, $content);
+            $content = str_replace((string) $search, $replacement, $content, $count);
+            if (
+                $sourceRel === 'vendor/guzzlehttp/guzzle/src/MessageFormatter.php'
+                && str_contains((string) $search, ": 'NULL';")
+                && $count !== 1
+            ) {
+                throw new \RuntimeException(
+                    "Guzzle MessageFormatter switch compatibility rule expected 1 match, found {$count}.",
+                );
+            }
+            if ($sourceRel === 'vendor/symfony/http-foundation/Session/Storage/MetadataBag.php' && $count !== 1) {
+                throw new \RuntimeException(
+                    "Symfony MetadataBag reference compatibility rule expected 1 match, found {$count}.",
+                );
+            }
         }
         return $content;
     }
@@ -667,12 +3817,322 @@ public function generateSwitchTerminalSources(): array
      */
     protected function patchSwitchTerminals(string $sourceRel, string $content): string
     {
+        if ($sourceRel === 'plugin/saiadmin/app/cache/UserInfoCache.php') {
+            return $this->patchSaiAdminUserInfoCache($content);
+        }
+        if ($sourceRel === 'vendor/illuminate/database/Query/Builder.php') {
+            $content = $this->expandIlluminateQueryBuilderCompactCalls($content);
+        }
+        if ($sourceRel === 'vendor/symfony/http-foundation/Request.php') {
+            $content = $this->stripSymfonyRequestPreloadHints($content);
+        }
+        if ($sourceRel === 'plugin/saiadmin/utils/code/CodeEngine.php') {
+            $content = str_replace(
+                "defined('DS') or define('DS', DIRECTORY_SEPARATOR);",
+                'const DS = DIRECTORY_SEPARATOR;',
+                $content,
+                $count,
+            );
+            if ($count !== 1) {
+                throw new \RuntimeException(
+                    "SaiAdmin CodeEngine directory separator compatibility rule expected 1 match, found {$count}: "
+                    . 'plugin/saiadmin/utils/code/CodeEngine.php.',
+                );
+            }
+        }
         foreach (self::SWITCH_TERMINAL_REPLACEMENTS[$sourceRel] ?? [] as $search => $replacement) {
+            if ($sourceRel === 'plugin/saiadmin/app/cache/ReflectionCache.php') {
+                $replacement = str_replace(
+                    ['__SAIADMIN_LOGIN_NO_NEED_LOGIN__', '__SAIADMIN_INSTALL_NO_NEED_LOGIN__'],
+                    [
+                        $this->readSaiAdminNoNeedLogin('LoginController.php'),
+                        $this->readSaiAdminNoNeedLogin('InstallController.php'),
+                    ],
+                    (string) $replacement,
+                );
+            }
+            $matches = substr_count($content, $search);
+            $expectedMatches = match (true) {
+                $sourceRel === 'vendor/topthink/think-orm/src/model/Collection.php' => 10,
+                $sourceRel === 'vendor/brick/math/src/Internal/Calculator/NativeCalculator.php'
+                    && $search === '$na = $a * 1; // cast to number'
+                    => 1,
+                $sourceRel === 'vendor/brick/math/src/Internal/Calculator/NativeCalculator.php'
+                    && $search === '$nb = $b * 1;'
+                    => 2,
+                $sourceRel === 'vendor/nesbot/carbon/src/Carbon/CarbonPeriod.php'
+                    && str_starts_with($search, '$dateClass::')
+                    => 1,
+                $sourceRel === 'vendor/nesbot/carbon/src/Carbon/Traits/Date.php'
+                    && (
+                        str_contains($search, 'default to macro')
+                        || $search === '                $result->$name = $value;'
+                    )
+                    => 1,
+                $sourceRel === 'vendor/nesbot/carbon/src/Carbon/Traits/Difference.php'
+                    && $search === 'CarbonInterval::hour()'
+                    => 1,
+                $sourceRel === 'vendor/nesbot/carbon/src/Carbon/CarbonInterval.php'
+                    && ($search === '$this->$key = $value;' || $search === '$instance->$unit = $value;')
+                    => 1,
+                $sourceRel === 'vendor/illuminate/support/Sleep.php'
+                    && ($search === 'CarbonInterval::seconds(0)' || $search === 'CarbonInterval::microsecond(0)')
+                    => 1,
+                $sourceRel === 'vendor/symfony/http-foundation/Request.php'
+                    && str_starts_with($search, '                // no break')
+                    => 1,
+                $sourceRel === 'vendor/symfony/http-foundation/BinaryFileResponse.php'
+                    && str_contains($content, 'class BinaryFileResponse extends Response')
+                    => 1,
+                $sourceRel === 'vendor/symfony/http-foundation/File/UploadedFile.php'
+                    && str_starts_with($search, '        switch ($this->error)')
+                    => 1,
+                $sourceRel === 'vendor/illuminate/database/Schema/Blueprint.php'
+                    && $search === "compact('autoIncrement', 'unsigned')"
+                    && str_contains($content, 'public function integer(')
+                    => 5,
+                $sourceRel === 'vendor/illuminate/database/Concerns/BuildsWhereDateClauses.php' => 1,
+                $sourceRel === 'vendor/illuminate/database/Eloquent/Relations/Concerns/CanBeOneOfMany.php' => 1,
+                $sourceRel === 'vendor/topthink/think-orm/src/model/concern/TimeStamp.php' => 1,
+                $sourceRel === 'vendor/vlucas/phpdotenv/src/Repository/RepositoryBuilder.php' => 1,
+                $sourceRel === 'vendor/vlucas/phpdotenv/src/Parser/EntryParser.php' => 6,
+                $sourceRel === 'vendor/firebase/php-jwt/src/JWT.php'
+                    && str_starts_with($search, '                } catch (Exception $e)')
+                    => 2,
+                $sourceRel === 'vendor/firebase/php-jwt/src/JWT.php' => 1,
+                $sourceRel === 'vendor/phpmailer/phpmailer/src/PHPMailer.php'
+                    && (
+                        str_starts_with($search, '                "\n";')
+                        && str_contains($content, 'switch ($this->Debugoutput)')
+                        || str_starts_with(
+                            $search,
+                            '            /* @noinspection PhpMissingBreakStatementInspection */',
+                        )
+                        && (
+                            str_contains($search, '$matchcount = preg_match_all')
+                            && str_contains($content, 'switch (strtolower($position))')
+                            || str_contains($search, '$pattern = \'\\(\\)"\';')
+                            && str_contains($content, 'public function encodeQ(')
+                        )
+                    )
+                    => 1,
+                $sourceRel === 'vendor/symfony/console/Output/ConsoleSectionOutput.php'
+                    && $search === 'array &$sections'
+                    && str_contains($content, 'class ConsoleSectionOutput extends StreamOutput')
+                    => 1,
+                $sourceRel === 'vendor/symfony/console/Helper/SymfonyQuestionHelper.php'
+                    && str_contains($content, 'class SymfonyQuestionHelper extends QuestionHelper')
+                    => 1,
+                $sourceRel === 'vendor/symfony/http-foundation/Session/Storage/Handler/PdoSessionHandler.php'
+                    && str_starts_with($search, '                // If "unix_socket"')
+                    && str_contains($content, 'switch ($driver)')
+                    => 1,
+                $sourceRel === 'vendor/symfony/http-foundation/Session/Storage/Handler/SessionHandlerFactory.php'
+                    && str_contains($content, 'class SessionHandlerFactory')
+                    => 1,
+                $sourceRel === 'vendor/symfony/mime/Header/AbstractHeader.php'
+                    && str_contains($content, 'switch ($firstChar)')
+                    => 1,
+                $sourceRel === 'vendor/symfony/http-kernel/Log/Logger.php' && str_contains($content, 'switch ($level)')
+                    => 1,
+                $sourceRel === 'vendor/topthink/think-orm/src/db/BaseBuilder.php'
+                    && str_contains($content, 'public function insertAll(')
+                    => 1,
+                $sourceRel === 'vendor/topthink/think-orm/src/db/builder/Mysql.php'
+                    && str_contains($content, 'public function insertAll(')
+                    => 1,
+                $sourceRel === 'plugin/saiadmin/app/logic/tool/CrontabLogic.php'
+                    && str_contains($content, 'public function run(')
+                    => 1,
+                $sourceRel === 'vendor/symfony/console/Application.php'
+                    && str_contains($content, 'protected function doRunCommand(')
+                    => 1,
+                $sourceRel === 'vendor/symfony/http-kernel/Exception/ControllerDoesNotReturnResponseException.php' => 1,
+                $sourceRel === 'vendor/symfony/polyfill-intl-grapheme/Grapheme.php' => 1,
+                in_array(
+                    $sourceRel,
+                    [
+                        'vendor/illuminate/http/Resources/Json/JsonResource.php',
+                        'vendor/illuminate/http/Resources/Json/ResourceCollection.php',
+                        'vendor/illuminate/http/Resources/JsonApi/JsonApiResource.php',
+                    ],
+                    true,
+                )
+                    => 1,
+                $sourceRel === 'app/process/Monitor.php' && str_contains($content, 'function checkFilesChange') => 1,
+                $sourceRel === 'vendor/nelexa/zip/src/Util/FilesUtil.php'
+                    && str_starts_with($search, '                default:')
+                    && str_contains($content, 'function convertGlobToRegEx')
+                    => 1,
+                $sourceRel === 'vendor/nelexa/zip/src/Util/FilesUtil.php'
+                    && str_contains($search, '$inputDir')
+                    && str_contains($content, 'function fileSearchWithIgnore')
+                    => 1,
+                in_array(
+                    $sourceRel,
+                    [
+                        'vendor/symfony/http-foundation/Session/Attribute/AttributeBag.php',
+                        'vendor/symfony/http-foundation/Session/Flash/FlashBag.php',
+                        'vendor/symfony/http-foundation/Session/Flash/AutoExpireFlashBag.php',
+                        'vendor/symfony/http-foundation/Session/SessionBagProxy.php',
+                    ],
+                    true,
+                )
+                    => 1,
+                $sourceRel === 'plugin/saiadmin/utils/Captcha.php',
+                str_starts_with($sourceRel, 'plugin/saiadmin/app/controller/'),
+                $sourceRel === 'plugin/saiadmin/app/cache/ReflectionCache.php',
+                $sourceRel === 'plugin/saiadmin/app/cache/UserAuthCache.php',
+                $sourceRel === 'plugin/saiadmin/exception/SystemException.php',
+                $sourceRel === 'vendor/workerman/coroutine/src/Pool.php',
+                $sourceRel === 'vendor/nelexa/zip/src/IO/Stream/ResponseStream.php',
+                $sourceRel === 'vendor/zoujingli/ip2region/src/ip2region/xdb/Util.php',
+                $sourceRel === 'vendor/symfony/service-contracts/ServiceSubscriberTrait.php',
+                $sourceRel === 'vendor/webman/console/src/Application.php',
+                    => 1,
+                default => null,
+            };
+            if ($expectedMatches !== null && $matches !== $expectedMatches) {
+                $rule = match (true) {
+                    $sourceRel === 'vendor/topthink/think-orm/src/model/Collection.php'
+                        => 'ThinkORM collection callback arity',
+                    str_starts_with($sourceRel, 'plugin/saiadmin/app/controller/') => 'controller request arity',
+                    $sourceRel === 'plugin/saiadmin/exception/SystemException.php' => 'system exception nullable cause',
+                    $sourceRel === 'vendor/workerman/coroutine/src/Pool.php'
+                        => 'Workerman coroutine pool placeholder identity',
+                    $sourceRel === 'vendor/nelexa/zip/src/IO/Stream/ResponseStream.php'
+                        => 'Nelexa PSR stream signature',
+                    $sourceRel === 'vendor/zoujingli/ip2region/src/ip2region/xdb/Util.php'
+                        => 'IP2Region v3 integer slot',
+                    default => 'reflection',
+                };
+                throw new \RuntimeException(
+                    "SaiAdmin {$rule} compatibility rule expected {$expectedMatches} match(es), "
+                    . "found {$matches}: {$sourceRel}.",
+                );
+            }
             $content = str_replace($search, $replacement, $content);
         }
         return $content;
     }
 
+    /**
+     * TypePHP 0.9 cannot reliably track compact() variables after tuple
+     * reassignment. Query Builder only uses literal compact keys, so its AOT
+     * copy can express the same arrays directly.
+     */
+    protected function expandIlluminateQueryBuilderCompactCalls(string $content): string
+    {
+        $pattern = "/compact\\(\\s*(?:'[A-Za-z_][A-Za-z0-9_]*'\\s*,?\\s*)+\\)/";
+        $expectedMatches = str_contains($content, 'class Builder implements BuilderContract') ? 31 : null;
+        $matches = preg_match_all($pattern, $content);
+        if ($matches === false || $matches === 0) {
+            throw new \RuntimeException(
+                'SaiAdmin Illuminate Query Builder compact compatibility rule expected at least 1 match, found 0: '
+                . 'vendor/illuminate/database/Query/Builder.php.',
+            );
+        }
+        if ($expectedMatches !== null && $matches !== $expectedMatches) {
+            throw new \RuntimeException(
+                "SaiAdmin Illuminate Query Builder compact compatibility rule expected {$expectedMatches} match(es), "
+                . "found {$matches}: vendor/illuminate/database/Query/Builder.php.",
+            );
+        }
+
+        return (string) preg_replace_callback(
+            $pattern,
+            static function (array $match): string {
+                preg_match_all("/'([A-Za-z_][A-Za-z0-9_]*)'/", $match[0], $keys);
+                $pairs = array_map(static fn(string $key): string => "'{$key}' => \${$key}", $keys[1]);
+
+                return '[' . implode(', ', $pairs) . ']';
+            },
+            $content,
+        );
+    }
+
+    private function stripSymfonyRequestPreloadHints(string $content): string
+    {
+        $preloadHints = <<<'PHP'
+            // Help opcache.preload discover always-needed symbols
+            class_exists(AcceptHeader::class);
+            class_exists(FileBag::class);
+            class_exists(HeaderBag::class);
+            class_exists(HeaderUtils::class);
+            class_exists(InputBag::class);
+            class_exists(ParameterBag::class);
+            class_exists(ServerBag::class);
+
+            PHP;
+        $content = str_replace($preloadHints, '', $content, $count);
+        if ($count !== 1) {
+            throw new \RuntimeException(
+                "Symfony Request preload hints compatibility rule expected 1 match, found {$count}: "
+                . 'vendor/symfony/http-foundation/Request.php.',
+            );
+        }
+        return $content;
+    }
+
+    private function patchSaiAdminUserInfoCache(string $content): string
+    {
+        $pattern =
+            '/        if \(is_array\(\$([a-z_]+)\)\) \{\n'
+            . '            \$tags = \[\];\n'
+            . '            foreach \(\$\1 as \$id\) \{\n'
+            . '                \$tags\[\] = \$cache\[\'([a-z]+)\'\] \. \$id;\n'
+            . '            \}\n'
+            . '        \} else \{\n'
+            . '            \$tags = \$cache\[\'\2\'\] \. \$\1;\n'
+            . '        \}\n'
+            . '        return Cache::tag\(\$tags\)->clear\(\);/';
+        $content = (string) preg_replace_callback(
+            $pattern,
+            static fn(array $matches): string => (
+                "        if (is_array(\${$matches[1]})) {\n"
+                . "            \$tags = [];\n"
+                . "            foreach (\${$matches[1]} as \$id) {\n"
+                . "                \$tags[] = \$cache['{$matches[2]}'] . \$id;\n"
+                . "            }\n"
+                . "            return Cache::tag(\$tags)->clear();\n"
+                . "        }\n"
+                . "        \$tag = \$cache['{$matches[2]}'] . \${$matches[1]};\n"
+                . '        return Cache::tag($tag)->clear();'
+            ),
+            $content,
+            -1,
+            $count,
+        );
+        if ($count !== 3) {
+            throw new \RuntimeException(
+                "SaiAdmin cache tag compatibility rule expected 3 matches, found {$count}: "
+                . 'plugin/saiadmin/app/cache/UserInfoCache.php.',
+            );
+        }
+        return $content;
+    }
+
+    private function readSaiAdminNoNeedLogin(string $controller): string
+    {
+        $relative = 'plugin/saiadmin/app/controller/' . $controller;
+        $content = file_get_contents($this->basePath . '/' . $relative);
+        if (
+            $content === false
+            || preg_match(
+                '/protected\s+array\s+\$noNeedLogin\s*=\s*'
+                . '(\[\s*(?:\'[A-Za-z_][A-Za-z0-9_]*\'\s*(?:,\s*\'[A-Za-z_][A-Za-z0-9_]*\'\s*)*)?\]);/',
+                $content,
+                $matches,
+            ) !== 1
+        ) {
+            throw new \RuntimeException(
+                "SaiAdmin reflection compatibility rule requires a static noNeedLogin list: {$relative}.",
+            );
+        }
+
+        return $matches[1];
+    }
+
     /**
      * 生成 AOT 专用 helpers.php（GUARDED_SOURCES 中 webman helpers 的快捷入口）
      */
@@ -731,7 +4191,9 @@ protected function flattenGuardedSource(string $content): string
                 $condition = trim($statement['condition']);
                 if (preg_match("/^!\s*defined\s*\(\s*(['\"])BASE_PATH\\1\s*\)$/", $condition) === 1) {
                     // BASE_PATH 由 main.php 在运行时定义，守卫连同前置注释一起丢弃
-                } elseif (preg_match("/^!\s*function_exists\s*\(\s*['\"][^'\"]+['\"]\s*\)$/", $condition) === 1) {
+                } elseif (
+                    preg_match("/^!\s*(?:function|class)_exists\s*\(\s*['\"][^'\"]+['\"]\s*\)$/", $condition) === 1
+                ) {
                     $output .= $trivia . $statement['body'];
                 } else {
                     throw new \RuntimeException(sprintf(
@@ -765,18 +4227,12 @@ protected function flattenGuardedSource(string $content): string
 
         $output .= $trivia;
 
-        // 新版 webman 的 worker_start 闭包会无条件 require support/bootstrap.php，而
-        // 便携产物不携带 support/ 目录（bootstrap 属于运行时动态加载内容）；参考旧版
-        // 行为改为 is_file 守卫，保证缺失时不致命
+        // support/bootstrap.php 会再次 include 已进入 AOT 的 Request、Response 与业务
+        // functions，导致 worker fork 后重复声明。改为调用 main.php 中的等价 AOT
+        // bootstrap；它保留配置、中间件、Bootstrap 与路由初始化，但跳过已编译文件。
         $output = (string) preg_replace(
             "/require_once\\s+base_path\(\s*(['\"])\/support\/bootstrap\.php\\1\s*\);/",
-            '$bootstrap = base_path($1/support/bootstrap.php$1);'
-            . "\n"
-            . '            if (is_file($bootstrap)) {'
-            . "\n"
-            . '                require_once $bootstrap;'
-            . "\n"
-            . '            }',
+            'typephp_worker_bootstrap($worker);',
             $output,
         );
 
@@ -925,11 +4381,146 @@ protected function assertAotCompatibleTopLevel(string $content): void
         }
     }
 
+    /**
+     * 校验并返回已知 Composer files wrapper 的静态声明源。
+     *
+     * @return list<string>
+     */
+    protected function resolveStaticLoaderSources(): array
+    {
+        $sources = [];
+        foreach (self::STATIC_LOADER_SOURCES as $loaderRel => $sourceRel) {
+            $loaderFile = $this->basePath . '/' . $loaderRel;
+            if (!is_file($loaderFile)) {
+                continue;
+            }
+            $sourceFile = $this->basePath . '/' . $sourceRel;
+            if (!is_file($sourceFile)) {
+                throw new \RuntimeException("Static loader target was not found: {$sourceRel}");
+            }
+
+            $content = file_get_contents($loaderFile);
+            if ($content === false) {
+                throw new \RuntimeException("Unable to read the static loader source: {$loaderRel}");
+            }
+            $compact = '';
+            foreach (token_get_all($content) as $token) {
+                if (
+                    is_array($token) && in_array($token[0], [T_OPEN_TAG, T_WHITESPACE, T_COMMENT, T_DOC_COMMENT], true)
+                ) {
+                    continue;
+                }
+                $compact .= is_array($token) ? $token[1] : $token;
+            }
+            if (!in_array(
+                $compact,
+                [
+                    "if(!\\function_exists('GuzzleHttp\\describe_type')){require__DIR__.'/functions.php';}",
+                    'if(!\\function_exists("GuzzleHttp\\describe_type")){require__DIR__."/functions.php";}',
+                ],
+                true,
+            )) {
+                throw new \RuntimeException(
+                    "Unsupported static loader wrapper: {$loaderRel}. Refusing to compile unknown top-level execution.",
+                );
+            }
+            $sources[] = $sourceRel;
+        }
+        return $sources;
+    }
+
+    /**
+     * @param list<mixed> $resources
+     */
+    public function generateRuntimeResourceList(array $resources): ?string
+    {
+        $targetRel = '.typephp/build/runtime-resources.list';
+        $targetFile = $this->basePath . '/' . $targetRel;
+        $resolved = [];
+        foreach ($resources as $resource) {
+            if (!is_string($resource)) {
+                throw new \RuntimeException('Runtime resource paths must be strings.');
+            }
+            $resource = str_replace('\\', '/', $resource);
+            $segments = explode('/', $resource);
+            if (
+                $resource === ''
+                || !preg_match('/^[A-Za-z0-9._\/-]+$/', $resource)
+                || str_starts_with($resource, '/')
+                || preg_match('/^[A-Za-z]:/', $resource)
+                || in_array('', $segments, true)
+                || in_array('.', $segments, true)
+                || in_array('..', $segments, true)
+                || $segments[0] === '.typephp'
+            ) {
+                throw new \RuntimeException('Unsafe runtime resource path: ' . $resource);
+            }
+            if (file_exists($this->basePath . '/' . $resource)) {
+                $resolved[] = $resource;
+            }
+        }
+        $resolved = array_values(array_unique($resolved));
+        if ($resolved === []) {
+            if (is_file($targetFile)) {
+                unlink($targetFile);
+            }
+            return null;
+        }
+        $directory = dirname($targetFile);
+        if (!is_dir($directory) && !mkdir($directory, 0777, true) && !is_dir($directory)) {
+            throw new \RuntimeException('Unable to create the TypePHP build directory: ' . $directory);
+        }
+        if (file_put_contents($targetFile, implode("\n", $resolved) . "\n") === false) {
+            throw new \RuntimeException('Unable to write the runtime resource list: ' . $targetFile);
+        }
+        return $targetRel;
+    }
+
     /**
      * 分析项目并生成 project.linux.yml
      */
-    public function generateProjectYml(array $extraConfig = []): string
+    public function generateProjectYml(array $extraConfig = [], string $filename = 'project.linux.yml'): string
     {
+        $this->guardedSources = self::GUARDED_SOURCES;
+        $skipGuardedSources = $extraConfig['build']['skip_guarded_sources'] ?? [];
+        if (!is_array($skipGuardedSources)) {
+            throw new \RuntimeException(
+                'build.skip_guarded_sources must be a list of registered guarded source paths.',
+            );
+        }
+        foreach ($skipGuardedSources as $source) {
+            if (!is_string($source) || !array_key_exists($source, self::GUARDED_SOURCES)) {
+                throw new \RuntimeException(
+                    'Unknown guarded source skip: ' . (is_scalar($source) ? (string) $source : gettype($source)),
+                );
+            }
+            unset($this->guardedSources[$source]);
+        }
+
+        $profile = null;
+        $profileName = $extraConfig['profile'] ?? null;
+        if ($profileName !== null) {
+            if ($profileName !== SaiAdminProfile::NAME) {
+                throw new \RuntimeException("Unknown TypePHP build profile: {$profileName}.");
+            }
+            $profile = new SaiAdminProfile($this->basePath);
+            $profile->assertSupported();
+        }
+
+        $runtimeResources = array_merge(
+            self::REGISTERED_DYNAMIC_SOURCES,
+            $this->discoverPluginConfigResources(),
+            $profile?->runtimeResources() ?? [],
+            $extraConfig['runtime_resources'] ?? [],
+        );
+        if (!is_array($runtimeResources)) {
+            throw new \RuntimeException('runtime_resources must be a list of project-relative paths.');
+        }
+        if ($profile !== null) {
+            $runtimeResources = $profile->filterRuntimeResources($runtimeResources);
+        }
+        $this->generateRuntimeResourceList(array_values($runtimeResources));
+
         $sources = [
             'main.php',
             'app',
@@ -955,10 +4546,27 @@ public function generateProjectYml(array $extraConfig = []): string
         } elseif (isset($extraConfig['sources']) && is_array($extraConfig['sources'])) {
             $sources = $extraConfig['sources'];
         }
+        if ($profile !== null) {
+            $sources = $profile->mergeCompilerSources($sources);
+        }
+        foreach ($this->resolveStaticLoaderSources() as $loaderTarget) {
+            $coveredByDirectory = false;
+            foreach ($sources as $source) {
+                if (
+                    is_dir($this->basePath . '/' . $source) && str_starts_with($loaderTarget, rtrim($source, '/') . '/')
+                ) {
+                    $coveredByDirectory = true;
+                    break;
+                }
+            }
+            if (!$coveredByDirectory) {
+                $sources[] = $loaderTarget;
+            }
+        }
 
         // 自动探测 monolog 与 webman-mcp 等常用库
         if (!isset($extraConfig['include']) && !isset($extraConfig['sources'])) {
-            if (is_dir($this->basePath . '/vendor/monolog/monolog/src')) {
+            if ($profile === null && is_dir($this->basePath . '/vendor/monolog/monolog/src')) {
                 $monologSources = [
                     'vendor/monolog/monolog/src/Monolog/Logger.php',
                     'vendor/monolog/monolog/src/Monolog/LogRecord.php',
@@ -1024,6 +4632,10 @@ public function generateProjectYml(array $extraConfig = []): string
             $this->generateStrayBootstrapSources(),
             static fn(string $target): bool => !in_array($target, $sources, true),
         ));
+        $preloadHintTargets = array_values(array_filter(
+            $this->generatePreloadHintSources(),
+            static fn(string $target): bool => !in_array($target, $sources, true),
+        ));
         // 生成 AOT 专用 switch 终结补丁源（webman App、monolog Utils），保证
         // 落空 case 不再触发 switch case must end with Fatal
         $switchTerminalTargets = array_values(array_filter(
@@ -1036,7 +4648,15 @@ public function generateProjectYml(array $extraConfig = []): string
             $this->generateRefCaptureSources(),
             static fn(string $target): bool => !in_array($target, $sources, true),
         ));
-        $aotGeneratedTargets = [...$flattenedTargets, ...$patchedTargets, ...$variadicTargets, ...$strayStrippedTargets, ...$switchTerminalTargets, ...$refCaptureTargets];
+        $aotGeneratedTargets = [
+            ...$flattenedTargets,
+            ...$patchedTargets,
+            ...$variadicTargets,
+            ...$strayStrippedTargets,
+            ...$preloadHintTargets,
+            ...$switchTerminalTargets,
+            ...$refCaptureTargets,
+        ];
         if ($aotGeneratedTargets !== []) {
             $position = array_search('main.php', $sources, true);
             if ($position === false) {
@@ -1052,18 +4672,23 @@ public function generateProjectYml(array $extraConfig = []): string
             'public',
             'runtime',
             'app/view',
-            'app/model',
-            'app/command',
-            'app/functions.php',
-            'app/process/Monitor.php',
-            'support',
+            'support/bootstrap.php',
             'vendor/workerman/webman-framework/src/support/view',
-            'vendor/workerman/webman-framework/src/support/helpers.php',
+            'vendor/autoload.php',
+            'vendor/bin',
+            'vendor/composer',
+            ...array_keys(self::STATIC_LOADER_SOURCES),
+            ...array_keys(self::GUARDED_SOURCES),
+            ...self::REGISTERED_DYNAMIC_SOURCES,
+            ...array_keys($this->discoverProjectGuardedSources()),
+            ...$this->discoverWebmanVendorPackagingSources(),
+            ...$this->discoverVendorIdeMetadata(),
+            ...$this->discoverFrameworkSupportOverrides(),
+            ...array_keys(self::PRELOAD_HINT_SOURCES),
             'vendor/workerman/webman-framework/src/support/bootstrap.php',
             'vendor/workerman/webman-framework/src/start.php',
             'vendor/workerman/webman-framework/src/windows.php',
             'vendor/workerman/webman-framework/src/Install.php',
-            'vendor/nikic/fast-route/src/functions.php',
             'vendor/nikic/fast-route/src/bootstrap.php',
             'vendor/nikic/fast-route/src/DataGenerator/CharCountBased.php',
             'vendor/nikic/fast-route/src/DataGenerator/GroupPosBased.php',
@@ -1071,25 +4696,113 @@ public function generateProjectYml(array $extraConfig = []): string
             'vendor/nikic/fast-route/src/Dispatcher/CharCountBased.php',
             'vendor/nikic/fast-route/src/Dispatcher/GroupPosBased.php',
             'vendor/nikic/fast-route/src/Dispatcher/MarkBased.php',
+            'vendor/phpmailer/phpmailer/language',
+            'vendor/illuminate/pagination/resources',
+            'vendor/illuminate/bus/ChainedBatch.php',
+            'vendor/illuminate/bus/DynamoBatchRepository.php',
+            'vendor/illuminate/database/Console',
+            'vendor/illuminate/database/Eloquent/BroadcastableModelEventOccurred.php',
+            'vendor/illuminate/database/Eloquent/BroadcastsEvents.php',
+            'vendor/illuminate/database/Eloquent/BroadcastsEventsAfterCommit.php',
+            'vendor/illuminate/events/CallQueuedListener.php',
+            'vendor/illuminate/session/Console',
+            'vendor/illuminate/support/Testing',
+            'vendor/nelexa/zip/.php-cs-fixer.php',
+            'vendor/nesbot/carbon/src/Carbon/Lang',
+            'vendor/nesbot/carbon/src/Carbon/List',
+            'vendor/nesbot/carbon/src/Carbon/PHPStan',
+            'vendor/nesbot/carbon/lazy/Carbon/MessageFormatter/MessageFormatterMapperWeakType.php',
+            'vendor/nesbot/carbon/lazy/Carbon/ProtectedDatePeriod.php',
+            'vendor/nesbot/carbon/lazy/Carbon/TranslatorWeakType.php',
+            'vendor/symfony/clock/Test',
+            'vendor/saithink/saiadmin/src/orm',
+            'vendor/saithink/saiadmin/src/plugin',
+            'vendor/saithink/saipackage/src/plugin',
+            'vendor/tinywan/jwt/src/config',
+            'vendor/tinywan/jwt/tests',
+            'vendor/tinywan/storage/.php-cs-fixer.php',
+            'vendor/tinywan/storage/src/config',
+            'vendor/tinywan/storage/tests',
+            'vendor/tinywan/webman-typephp',
+            'vendor/topthink/think-container/tests',
+            // These guarded helpers duplicate Illuminate's compiled helpers;
+            // the two remaining names are PHP 8.1/8.3 built-ins.
+            'vendor/topthink/think-helper/src/helper.php',
+            'vendor/topthink/think-helper/tests',
+            'vendor/topthink/think-orm/stubs/load_stubs.php',
+            'vendor/topthink/think-orm/stubs/Facade.php',
+            'vendor/symfony/error-handler/Resources',
+            'vendor/symfony/console/DependencyInjection',
+            'vendor/symfony/console/Tester',
+            'vendor/symfony/event-dispatcher/Debug',
+            'vendor/symfony/event-dispatcher/DependencyInjection',
+            'vendor/symfony/http-foundation/Test',
+            'vendor/symfony/http-kernel/Resources',
+            'vendor/symfony/http-kernel/Bundle',
+            'vendor/symfony/http-kernel/Config',
+            'vendor/symfony/http-kernel/Debug',
+            'vendor/symfony/http-kernel/DependencyInjection',
+            'vendor/symfony/http-kernel/EventListener/DumpListener.php',
+            'vendor/symfony/http-kernel/EventListener/ProfilerListener.php',
+            'vendor/symfony/http-kernel/HttpKernelBrowser.php',
+            'vendor/symfony/http-kernel/Profiler',
+            'vendor/symfony/mime/DependencyInjection',
+            'vendor/symfony/mime/Test',
+            'vendor/symfony/service-contracts/Test',
+            'vendor/symfony/translation-contracts/Test',
+            'vendor/symfony/translation/DependencyInjection',
+            'vendor/symfony/translation/Extractor',
+            'vendor/symfony/translation/Test',
+            'vendor/symfony/cache/Traits/Relay',
+            'vendor/symfony/cache/Traits/RelayProxy.php',
+            'vendor/symfony/cache/Traits/RelayClusterProxy.php',
+            'vendor/symfony/string/Resources',
+            'vendor/symfony/translation/Resources',
+            'vendor/symfony/var-dumper/Resources',
+            'vendor/symfony/polyfill-intl-idn/Resources',
+            'vendor/symfony/polyfill-intl-normalizer/Resources',
+            'vendor/symfony/polyfill-mbstring/Resources',
+            'vendor/symfony/polyfill-php80/Resources',
+            'vendor/symfony/polyfill-php83/Resources',
+            'vendor/symfony/polyfill-php84/Resources',
+            'vendor/voku/portable-ascii/src/voku/helper/data',
+            'vendor/symfony/polyfill-ctype/bootstrap.php',
+            'vendor/symfony/polyfill-ctype/bootstrap80.php',
+            'vendor/symfony/polyfill-intl-grapheme/bootstrap.php',
+            'vendor/symfony/polyfill-intl-grapheme/bootstrap85.php',
+            'vendor/symfony/polyfill-intl-idn/bootstrap.php',
+            'vendor/symfony/polyfill-intl-normalizer/bootstrap.php',
+            'vendor/symfony/polyfill-mbstring/bootstrap.php',
+            'vendor/symfony/polyfill-mbstring/bootstrap72.php',
+            'vendor/symfony/polyfill-mbstring/bootstrap80.php',
+            'vendor/symfony/polyfill-php80/bootstrap.php',
+            'vendor/symfony/polyfill-php83/bootstrap.php',
+            'vendor/symfony/polyfill-php83/bootstrap72.php',
+            'vendor/symfony/polyfill-php83/bootstrap81.php',
+            'vendor/symfony/polyfill-php84/bootstrap.php',
+            'vendor/symfony/polyfill-php84/bootstrap72.php',
+            'vendor/symfony/polyfill-php84/bootstrap82.php',
+            'vendor/symfony/polyfill-php85/bootstrap80.php',
             'vendor/workerman/coroutine/src/Context.php',
             'vendor/workerman/coroutine/src/WaitGroup.php',
             'vendor/workerman/coroutine/src/Barrier.php',
+            'vendor/workerman/coroutine/src/Barrier/BarrierInterface.php',
+            'vendor/workerman/coroutine/src/Barrier/Swoole.php',
             'vendor/workerman/workerman/src/Protocols/Http/Session.php',
             'vendor/workerman/workerman/src/Protocols/Http/Session/FileSessionHandler.php',
             'vendor/workerman/coroutine/src/Context/Fiber.php',
             'vendor/workerman/coroutine/src/Coroutine/Fiber.php',
             'vendor/workerman/coroutine/src/Coroutine.php',
-            'vendor/workerman/webman-framework/src/App.php',
-            'vendor/monolog/monolog/src/Monolog/Utils.php',
-            'vendor/workerman/webman-framework/src/Route/Route.php',
-            'vendor/workerman/coroutine/src/Barrier/Fiber.php',
-            'vendor/workerman/coroutine/src/Channel/Fiber.php',
+            ...array_keys(self::SWITCH_TERMINAL_SOURCES),
+            ...array_keys(self::REF_CAPTURE_SOURCES),
             'vendor/workerman/workerman/src/Worker.php',
+            'vendor/workerman/workerman/src/Timer.php',
             'vendor/workerman/workerman/src/Connection/TcpConnection.php',
             'vendor/workerman/workerman/src/Connection/AsyncTcpConnection.php',
             'vendor/workerman/workerman/src/Events/Select.php',
             'vendor/workerman/webman-framework/src/File.php',
             'vendor/workerman/coroutine/tests',
+            'vendor/workerman/channel/test',
             'vendor/workerman/coroutine/stubs',
             'vendor/workerman/coroutine/src/Barrier/Swow.php',
             'vendor/workerman/coroutine/src/Channel/Swow.php',
@@ -1097,8 +4810,13 @@ public function generateProjectYml(array $extraConfig = []): string
             'vendor/workerman/coroutine/src/Coroutine/Swow.php',
             'vendor/workerman/coroutine/src/WaitGroup/Swow.php',
             'vendor/workerman/workerman/src/Events/Swow.php',
-            'vendor/workerman/coroutine/src/Pool.php',
-            'vendor/workerman/coroutine/src/Utils/DestructionWatcher.php',
+            'vendor/cakephp/chronos/rector.php',
+            'vendor/cakephp/core/functions_global.php',
+            'vendor/league/container/examples',
+            'vendor/robmorgan/phinx/app',
+            'vendor/robmorgan/phinx/src/composer_autoloader.php',
+            'vendor/zoujingli/ip2region/_test.php',
+            'vendor/zoujingli/ip2region/tests',
             'vendor/monolog/monolog/src/Monolog/Test',
             'vendor/tinywan/webman-mcp/src/config',
             'vendor/tinywan/webman-mcp/src/Install.php',
@@ -1120,7 +4838,28 @@ public function generateProjectYml(array $extraConfig = []): string
         } elseif (isset($extraConfig['ignore']) && is_array($extraConfig['ignore'])) {
             $userIgnores = $extraConfig['ignore'];
         }
-        $ignores = array_unique(array_merge($mandatoryIgnores, $userIgnores));
+        if ($profile !== null) {
+            $userIgnores = $profile->filterUserIgnores($userIgnores);
+        }
+        $ignores = array_values(array_unique(array_merge(
+            $mandatoryIgnores,
+            $profile?->resourceIgnores() ?? [],
+            $userIgnores,
+        )));
+
+        if ($profile !== null) {
+            $generatedSources = array_merge(
+                $this->guardedSources,
+                $this->discoverProjectGuardedSources(),
+                self::NULLABLE_STATIC_SOURCES,
+                self::STRAY_BOOTSTRAP_SOURCES,
+                array_map(static fn(array $rule): string => $rule[0], self::PRELOAD_HINT_SOURCES),
+                self::VARIADIC_HANDLER_SOURCES,
+                self::SWITCH_TERMINAL_SOURCES,
+                self::REF_CAPTURE_SOURCES,
+            );
+            $profile->writeCoverageManifest(array_values(array_unique($sources)), $ignores, $generatedSources);
+        }
 
         $outputName = $extraConfig['build']['output_name'] ?? 'webman-server';
 
@@ -1138,12 +4877,14 @@ public function generateProjectYml(array $extraConfig = []): string
         $yaml .= "\noutput: build/{$outputName}\n";
         $yaml .= "mode: bin\n";
         $yaml .= "optimize: 2\n";
-        // The builder entrypoint raises this to the container's core count (nproc,
-        // capped) at compile time; 4 is a safe parallel default for direct tpc runs.
-        $yaml .= "job: 4\n";
+        $jobs = (int) ($extraConfig['build']['jobs'] ?? 4);
+        $yaml .= "job: {$jobs}\n";
         $yaml .= "debug: false\n";
 
-        $ymlPath = $this->basePath . DIRECTORY_SEPARATOR . 'project.linux.yml';
+        if (!preg_match('/^[A-Za-z0-9._-]+\.ya?ml$/', $filename)) {
+            throw new \RuntimeException("Invalid TypePHP project filename: {$filename}.");
+        }
+        $ymlPath = $this->basePath . DIRECTORY_SEPARATOR . $filename;
         file_put_contents($ymlPath, $yaml);
         return $ymlPath;
     }
diff --git a/src/Stubs/main.php.stub b/src/Stubs/main.php.stub
index ea0d905..e3e6cbd 100644
--- a/src/Stubs/main.php.stub
+++ b/src/Stubs/main.php.stub
@@ -2,6 +2,132 @@
 use support\App;
 use Workerman\Worker;
 
+function typephp_is_compiled_autoload_file(string $file): bool
+{
+    $basePath = str_replace('\\', '/', base_path());
+    $normalized = str_replace('\\', '/', $file);
+    if (!str_starts_with($normalized, $basePath . '/')) {
+        return false;
+    }
+    $relative = substr($normalized, strlen($basePath) + 1);
+    if (in_array($relative, ['app/functions.php', 'support/Request.php', 'support/Response.php'], true)) {
+        return true;
+    }
+    return preg_match('#^plugin/[^/]+/app/functions\.php$#', $relative) === 1;
+}
+
+function typephp_worker_bootstrap($worker): void
+{
+    if (empty(\Workerman\Worker::$eventLoopClass)) {
+        \Workerman\Worker::$eventLoopClass = \Workerman\Events\Select::class;
+    }
+
+    set_error_handler(function ($level, $message, $file = '', $line = 0) {
+        if (($level & (E_DEPRECATED | E_USER_DEPRECATED)) !== 0) {
+            return false;
+        }
+        if (error_reporting() & $level) {
+            throw new \ErrorException($message, 0, $level, $file, $line);
+        }
+        return false;
+    });
+
+    if ($worker) {
+        register_shutdown_function(function ($startTime) {
+            if (time() - $startTime <= 0.1) {
+                sleep(1);
+            }
+        }, time());
+    }
+
+    if (class_exists(\Dotenv\Dotenv::class) && file_exists(base_path(false) . '/.env')) {
+        if (method_exists(\Dotenv\Dotenv::class, 'createUnsafeMutable')) {
+            \Dotenv\Dotenv::createUnsafeMutable(base_path(false))->load();
+        } else {
+            \Dotenv\Dotenv::createMutable(base_path(false))->load();
+        }
+    }
+
+    \Webman\Config::clear();
+    \support\App::loadAllConfig(['route']);
+    if ($timezone = config('app.default_timezone')) {
+        date_default_timezone_set($timezone);
+    }
+
+    foreach (config('autoload.files', []) as $file) {
+        if (is_file($file) && !typephp_is_compiled_autoload_file($file)) {
+            include_once $file;
+        }
+    }
+    foreach (config('plugin', []) as $projects) {
+        if (!is_array($projects)) {
+            continue;
+        }
+        foreach ($projects as $project) {
+            if (!is_array($project)) {
+                continue;
+            }
+            foreach ($project['autoload']['files'] ?? [] as $file) {
+                if (is_file($file) && !typephp_is_compiled_autoload_file($file)) {
+                    include_once $file;
+                }
+            }
+        }
+        foreach ($projects['autoload']['files'] ?? [] as $file) {
+            if (is_file($file) && !typephp_is_compiled_autoload_file($file)) {
+                include_once $file;
+            }
+        }
+    }
+
+    \Webman\Middleware::load(config('middleware', []));
+    foreach (config('plugin', []) as $firm => $projects) {
+        if (!is_array($projects)) {
+            continue;
+        }
+        foreach ($projects as $name => $project) {
+            if (!is_array($project) || $name === 'static') {
+                continue;
+            }
+            \Webman\Middleware::load($project['middleware'] ?? []);
+        }
+        \Webman\Middleware::load($projects['middleware'] ?? [], (string) $firm);
+        if ($staticMiddlewares = config("plugin.$firm.static.middleware")) {
+            \Webman\Middleware::load(['__static__' => $staticMiddlewares], (string) $firm);
+        }
+    }
+    \Webman\Middleware::load(['__static__' => config('static.middleware', [])]);
+
+    foreach (config('bootstrap', []) as $className) {
+        if (class_exists($className)) {
+            call_user_func([$className, 'start'], $worker);
+        }
+    }
+    foreach (config('plugin', []) as $projects) {
+        if (!is_array($projects)) {
+            continue;
+        }
+        foreach ($projects as $project) {
+            if (!is_array($project)) {
+                continue;
+            }
+            foreach ($project['bootstrap'] ?? [] as $className) {
+                if (class_exists($className)) {
+                    call_user_func([$className, 'start'], $worker);
+                }
+            }
+        }
+        foreach ($projects['bootstrap'] ?? [] as $className) {
+            if (class_exists($className)) {
+                call_user_func([$className, 'start'], $worker);
+            }
+        }
+    }
+
+    // 路由已在父进程中加载。这里不能再次 Route::load()：它会先清空路由表，
+    // 随后的 require_once 又不会重复执行 route.php，最终导致插件路由全部丢失。
+}
+
 function main(): void
 {
     if (!defined('BASE_PATH')) {
@@ -32,10 +158,38 @@ function main(): void
     }
 
     // 1. 加载自定义辅助函数与配置（排除 route 延迟加载）
-    if (file_exists(base_path() . '/app/functions.php')) {
-        require_once base_path() . '/app/functions.php';
-    }
     \support\App::loadAllConfig(['route']);
+    foreach (config('autoload.files', []) as $file) {
+        if (is_file($file) && !typephp_is_compiled_autoload_file($file)) {
+            include_once $file;
+        }
+    }
+    foreach (config('plugin', []) as $projects) {
+        if (!is_array($projects)) {
+            continue;
+        }
+        foreach ($projects as $project) {
+            if (!is_array($project)) {
+                continue;
+            }
+            foreach ($project['autoload']['files'] ?? [] as $file) {
+                if (is_file($file) && !typephp_is_compiled_autoload_file($file)) {
+                    include_once $file;
+                }
+            }
+        }
+        foreach ($projects['autoload']['files'] ?? [] as $file) {
+            if (is_file($file) && !typephp_is_compiled_autoload_file($file)) {
+                include_once $file;
+            }
+        }
+    }
+    if (class_exists(\Webman\Database\Initializer::class)) {
+        \Webman\Database\Initializer::init(config('database', []));
+    }
+    if (class_exists(\Webman\ThinkOrm\Initializer::class)) {
+        \Webman\ThinkOrm\Initializer::init();
+    }
 
     $errorReporting = config('app.error_reporting');
     if (isset($errorReporting)) {
@@ -62,7 +216,21 @@ function main(): void
     // 4. 加载中间件与路由表
     \Webman\Middleware::load(config('middleware', []));
     \Webman\Middleware::load(['__static__' => config('static.middleware', [])]);
-    \Webman\Route::load([config_path()]);
+    foreach (config('plugin', []) as $pluginName => $pluginConfig) {
+        if (!is_array($pluginConfig)) {
+            continue;
+        }
+        \Webman\Middleware::load($pluginConfig['middleware'] ?? [], (string) $pluginName);
+        \Webman\Middleware::load(
+            ['__static__' => $pluginConfig['static']['middleware'] ?? []],
+            (string) $pluginName,
+        );
+    }
+    $routePaths = [config_path()];
+    foreach (glob(base_path() . '/plugin/*/config', GLOB_ONLYDIR) ?: [] as $pluginConfigPath) {
+        $routePaths[] = $pluginConfigPath;
+    }
+    \Webman\Route::load($routePaths);
 
     // 5. 启动 Webman HTTP 进程
     $process = config('process', []);
diff --git a/src/config/plugin/tinywan/typephp/app.php b/src/config/plugin/tinywan/typephp/app.php
index 1b52d89..b9c7825 100644
--- a/src/config/plugin/tinywan/typephp/app.php
+++ b/src/config/plugin/tinywan/typephp/app.php
@@ -14,11 +14,88 @@
         'enabled' => true,
         'image' => 'tinywan/typephp-webman-builder:v0.1.3',
     ],
+    // 宿主机原生编译配置；null 时按环境变量、常用 Composer/Homebrew 路径自动发现。
+    'native' => [
+        'tpc' => null,
+        'php' => null,
+        'php_home' => null,
+        'phpx_home' => null,
+        'cxx' => null,
+    ],
     // 默认输出配置
     'build' => [
         'output_name' => 'webman-server',
         'dist_dir' => 'dist',
         'clean_build' => true,
+        // Large projects may need 1 to cap the extension translation unit's memory peak.
+        'jobs' => 4,
+    ],
+    // 编译排除但运行时按原相对路径随包的动态数据、模板和静态资源。
+    'runtime_resources' => [
+        'vendor/laravel/serializable-closure',
+        'vendor/phpmailer/phpmailer/get_oauth_token.php',
+        'vendor/symfony/cache',
+        'vendor/symfony/clock/Resources',
+        'vendor/symfony/console/Attribute',
+        'vendor/symfony/console/Command/InvokableCommand.php',
+        'vendor/symfony/console/Command/TraceableCommand.php',
+        'vendor/symfony/console/Completion',
+        'vendor/symfony/console/DataCollector',
+        'vendor/symfony/console/Helper/Table.php',
+        'vendor/symfony/error-handler',
+        'vendor/symfony/finder',
+        'vendor/symfony/http-foundation/Session/Storage/Handler/IdentityMarshaller.php',
+        'vendor/symfony/http-foundation/Session/Storage/Handler/MigratingSessionHandler.php',
+        'vendor/symfony/http-kernel/DataCollector',
+        'vendor/symfony/http-kernel/Fragment/InlineFragmentRenderer.php',
+        'vendor/symfony/http-kernel/Kernel.php',
+        'vendor/symfony/mime/Crypto',
+        'vendor/symfony/mime/HtmlToTextConverter/LeagueHtmlToMarkdownConverter.php',
+        'vendor/symfony/mime/Part',
+        'vendor/symfony/polyfill-intl-normalizer',
+        'vendor/symfony/process',
+        'vendor/symfony/string',
+        'vendor/symfony/translation/Util/ArrayConverter.php',
+        'vendor/symfony/var-dumper',
+        'vendor/symfony/var-exporter',
+        'vendor/symfony/translation/DataCollector',
+        'vendor/openspout/openspout',
+        'vendor/twig/twig',
+        'vendor/tinywan/storage',
+        'vendor/topthink/think-orm/stubs/load_stubs.php',
+        'vendor/topthink/think-orm/src/db/Mongo.php',
+        'vendor/topthink/think-orm/src/db/builder/Mongo.php',
+        'vendor/topthink/think-orm/src/db/connector/Mongo.php',
+        'vendor/topthink/think-orm/src/db/builder/Oracle.php',
+        'vendor/topthink/think-orm/src/db/builder/Pgsql.php',
+        'vendor/topthink/think-orm/src/db/builder/Sqlite.php',
+        'vendor/topthink/think-orm/src/db/builder/Sqlsrv.php',
+        'vendor/voku/portable-ascii',
+        'vendor/webman/channel',
+        'vendor/webman/console/src/Commands',
+        'vendor/webman/console/src/Messages.php',
+        'vendor/webman/console/src/Util.php',
+        'vendor/webman/database/src/support/MongoModel.php',
+        'vendor/webman/captcha/src/Font',
+        'vendor/workerman/channel',
+        'plugin/saiadmin/app/view',
+        'plugin/saiadmin/public',
+        'plugin/saiadmin/utils/code/stub',
+        'vendor/illuminate/pagination/resources',
+        'vendor/nesbot/carbon/src/Carbon/Lang',
+        'vendor/nesbot/carbon/src/Carbon/List',
+        'vendor/nesbot/carbon/src/Carbon/PHPStan',
+        'vendor/symfony/error-handler/Resources',
+        'vendor/symfony/console/DependencyInjection',
+        'vendor/symfony/http-kernel/Resources',
+        'vendor/symfony/polyfill-intl-idn/Resources',
+        'vendor/symfony/polyfill-intl-normalizer/Resources',
+        'vendor/symfony/polyfill-mbstring/Resources',
+        'vendor/symfony/string/Resources',
+        'vendor/symfony/translation/Resources',
+        'vendor/symfony/var-dumper/Resources',
+        'vendor/voku/portable-ascii/src/voku/helper/data',
+        'vendor/zoujingli/ip2region/ip2region.xdb',
     ],
     // 编译排除项（动态文件与运行时资源；带 if 守卫的 helpers.php/functions.php 由
     // 打包命令自动平铺、coroutine 的 Context/WaitGroup/Barrier 由打包命令自动做
@@ -29,9 +106,11 @@
         'public',
         'runtime',
         'app/view',
-        'app/model',
-        'app/process/Monitor.php',
-        'support',
+        'support/bootstrap.php',
+        'vendor/autoload.php',
+        'vendor/bin',
+        'vendor/composer',
+        'vendor/guzzlehttp/guzzle/src/functions_include.php',
         'vendor/workerman/webman-framework/src/support/helpers.php',
         'vendor/nikic/fast-route/src/functions.php',
         'vendor/workerman/webman-framework/src/support/bootstrap.php',
@@ -45,15 +124,92 @@
         'vendor/nikic/fast-route/src/Dispatcher/CharCountBased.php',
         'vendor/nikic/fast-route/src/Dispatcher/GroupPosBased.php',
         'vendor/nikic/fast-route/src/Dispatcher/MarkBased.php',
+        // Carbon installs these Doctrine adapters even when doctrine/dbal is absent.
+        'vendor/carbonphp/carbon-doctrine-types',
+        'vendor/illuminate/pagination/resources',
+        'vendor/nelexa/zip/.php-cs-fixer.php',
+        'vendor/nesbot/carbon/src/Carbon/Lang',
+        'vendor/nesbot/carbon/src/Carbon/List',
+        'vendor/saithink/saiadmin/src/orm',
+        'vendor/saithink/saiadmin/src/plugin',
+        'vendor/saithink/saipackage/src/plugin',
+        'vendor/illuminate/bus/DynamoBatchRepository.php',
+        'vendor/tinywan/jwt/src/config',
+        'vendor/tinywan/jwt/tests',
+        'vendor/tinywan/storage/.php-cs-fixer.php',
+        'vendor/tinywan/storage/src/config',
+        'vendor/tinywan/storage/tests',
+        'vendor/tinywan/webman-typephp',
+        'vendor/topthink/think-container/tests',
+        'vendor/topthink/think-helper/tests',
+        'vendor/topthink/think-orm/stubs/Facade.php',
+        'vendor/symfony/error-handler/Resources',
+        'vendor/symfony/event-dispatcher/Debug',
+        'vendor/symfony/event-dispatcher/DependencyInjection',
+        'vendor/symfony/http-kernel/Resources',
+        'vendor/symfony/http-kernel/Bundle/BundleExtension.php',
+        'vendor/symfony/http-kernel/DependencyInjection',
+        'vendor/symfony/cache',
+        'vendor/symfony/clock/Test',
+        'vendor/symfony/console/Tester',
+        'vendor/symfony/console/Attribute',
+        'vendor/symfony/console/Command/InvokableCommand.php',
+        'vendor/symfony/console/Command/TraceableCommand.php',
+        'vendor/symfony/console/Completion',
+        'vendor/symfony/console/DataCollector',
+        'vendor/symfony/console/Helper/Table.php',
+        'vendor/symfony/http-kernel/DataCollector',
+        'vendor/symfony/http-kernel/Fragment/InlineFragmentRenderer.php',
+        'vendor/symfony/http-kernel/Kernel.php',
+        'vendor/symfony/mime/HtmlToTextConverter/LeagueHtmlToMarkdownConverter.php',
+        'vendor/symfony/translation/DataCollector',
+        'vendor/symfony/cache/Traits/Relay',
+        'vendor/symfony/cache/Traits/RelayProxy.php',
+        'vendor/symfony/cache/Traits/RelayClusterProxy.php',
+        'vendor/symfony/string/Resources',
+        'vendor/symfony/translation/Resources',
+        'vendor/symfony/var-dumper/Resources',
+        'vendor/symfony/polyfill-intl-idn/Resources',
+        'vendor/symfony/polyfill-intl-normalizer/Resources',
+        'vendor/symfony/polyfill-mbstring/Resources',
+        'vendor/symfony/polyfill-php80/Resources',
+        'vendor/symfony/polyfill-php83/Resources',
+        'vendor/symfony/polyfill-php84/Resources',
+        'vendor/voku/portable-ascii/src/voku/helper/data',
+        'vendor/symfony/polyfill-ctype/bootstrap.php',
+        'vendor/symfony/polyfill-ctype/bootstrap80.php',
+        'vendor/symfony/polyfill-intl-normalizer/bootstrap.php',
+        'vendor/symfony/polyfill-mbstring/bootstrap.php',
+        'vendor/symfony/polyfill-mbstring/bootstrap72.php',
+        'vendor/symfony/polyfill-mbstring/bootstrap80.php',
+        'vendor/symfony/polyfill-php80/bootstrap.php',
+        'vendor/symfony/polyfill-php83/bootstrap.php',
+        'vendor/symfony/polyfill-php83/bootstrap72.php',
+        'vendor/symfony/polyfill-php83/bootstrap81.php',
+        'vendor/symfony/polyfill-php84/bootstrap.php',
+        'vendor/symfony/polyfill-php84/bootstrap72.php',
+        'vendor/symfony/polyfill-php84/bootstrap82.php',
+        'vendor/symfony/polyfill-php85/bootstrap80.php',
         'vendor/workerman/coroutine/src/Context.php',
         'vendor/workerman/coroutine/src/WaitGroup.php',
         'vendor/workerman/coroutine/src/Barrier.php',
+        'vendor/workerman/coroutine/src/Barrier/BarrierInterface.php',
+        'vendor/illuminate/bus/Batch.php',
+        'vendor/illuminate/bus/ChainedBatch.php',
+        'vendor/illuminate/database/Console',
+        'vendor/illuminate/database/Eloquent/BroadcastableModelEventOccurred.php',
+        'vendor/illuminate/database/Eloquent/BroadcastsEvents.php',
+        'vendor/illuminate/database/Eloquent/BroadcastsEventsAfterCommit.php',
+        'vendor/illuminate/events/CallQueuedListener.php',
+        'vendor/illuminate/session/Console',
         'vendor/workerman/workerman/src/Worker.php',
         'vendor/workerman/workerman/src/Connection/TcpConnection.php',
         'vendor/workerman/workerman/src/Connection/AsyncTcpConnection.php',
         'vendor/workerman/workerman/src/Events/Select.php',
         'vendor/workerman/webman-framework/src/File.php',
         'vendor/workerman/coroutine/tests',
+        'vendor/workerman/channel/test',
+        'vendor/workerman/crontab/example',
         'vendor/workerman/coroutine/stubs',
         'vendor/workerman/coroutine/src/Barrier/Swow.php',
         'vendor/workerman/coroutine/src/Channel/Swow.php',
@@ -61,7 +217,12 @@
         'vendor/workerman/coroutine/src/Coroutine/Swow.php',
         'vendor/workerman/coroutine/src/WaitGroup/Swow.php',
         'vendor/workerman/workerman/src/Events/Swow.php',
-        'vendor/workerman/coroutine/src/Pool.php',
-        'vendor/workerman/coroutine/src/Utils/DestructionWatcher.php',
+        'vendor/workerman/coroutine/src/Barrier/Swoole.php',
+        'vendor/workerman/coroutine/src/Channel/Swoole.php',
+        'vendor/workerman/coroutine/src/Context/Swoole.php',
+        'vendor/workerman/coroutine/src/Coroutine/Swoole.php',
+        'vendor/workerman/coroutine/src/WaitGroup/Swoole.php',
+        'vendor/workerman/workerman/src/Events/Swoole.php',
+        'vendor/zoujingli/ip2region/_test.php',
     ],
 ];
diff --git a/src/config/plugin/tinywan/typephp/command.php b/src/config/plugin/tinywan/typephp/command.php
index a02d300..0b1598f 100644
--- a/src/config/plugin/tinywan/typephp/command.php
+++ b/src/config/plugin/tinywan/typephp/command.php
@@ -9,6 +9,7 @@
 
 return [
     Tinywan\Typephp\Commands\PackageCommand::class,
+    Tinywan\Typephp\Commands\NativeCompileCommand::class,
     Tinywan\Typephp\Commands\DoctorCommand::class,
     Tinywan\Typephp\Commands\InitCiCommand::class,
 ];
diff --git a/tests/Unit/CompilerBaseCompatibilityTest.php b/tests/Unit/CompilerBaseCompatibilityTest.php
index 3c76e0e..41dbf51 100644
--- a/tests/Unit/CompilerBaseCompatibilityTest.php
+++ b/tests/Unit/CompilerBaseCompatibilityTest.php
@@ -6,11 +6,32 @@
     $repositoryRoot = dirname(__DIR__, 2);
     $dockerfile = file_get_contents($repositoryRoot . '/docker/Dockerfile');
     $compilerBase = file_get_contents($repositoryRoot . '/docker/CompilerBase.php');
-    if ($dockerfile === false || $compilerBase === false) {
+    $translator = file_get_contents($repositoryRoot . '/docker/Translator.php');
+    $assignOpTrait = file_get_contents($repositoryRoot . '/docker/AssignOpTrait.php');
+    $funcCallOptimizer = file_get_contents($repositoryRoot . '/docker/FuncCallOptimizer.php');
+    $methodCallPatch = file_get_contents($repositoryRoot . '/docker/patch_method_call_trait.php');
+    $nativeTypePatch = file_get_contents($repositoryRoot . '/docker/patch_native_type_compatibility_trait.php');
+    $stubGenerator = file_get_contents($repositoryRoot . '/docker/gen_stub.php');
+    if (
+        $dockerfile === false
+        || $compilerBase === false
+        || $translator === false
+        || $assignOpTrait === false
+        || $funcCallOptimizer === false
+        || $methodCallPatch === false
+        || $nativeTypePatch === false
+        || $stubGenerator === false
+    ) {
         throw new RuntimeException('Unable to load CompilerBase Docker override files.');
     }
 
-    expect($dockerfile)->toContain('COPY CompilerBase.php /opt/typephp/vendor/swoole/typephp/src/CompilerBase.php');
+    expect($dockerfile)
+        ->toContain('COPY CompilerBase.php /opt/typephp/vendor/swoole/typephp/src/CompilerBase.php')
+        ->toContain('RUN php /tmp/patch_native_type_compatibility_trait.php')
+        ->toContain('RUN php /tmp/patch_method_call_trait.php')
+        ->toContain(
+            'COPY FuncCallOptimizer.php /opt/typephp/vendor/swoole/typephp/src/Optimizer/FuncCallOptimizer.php',
+        );
 
     foreach ([
         'use TypePhp\\Platform\\Ios;',
@@ -23,10 +44,77 @@
         'return $this->getIosSdkDir();',
         'if ($this->isAndroidTarget()) {',
         'return $this->getAndroidSdkDir();',
+        'protected function getRawVarType(string $name): string',
+        'return Type::getReferencedType($this->getRawVarType($name));',
+        'protected bool $varIntTypes = false;',
+        'protected function getCalledCeExpr(): string',
+        'protected function getCalledClassExpr(): string',
+        '$this->context->needsCalledClass = true;',
+        'zend_class_entry *const _typephp_called_ce = typephp_get_called_ce(this_);',
+        'php::Str const _typephp_called_class = typephp_get_called_class(_typephp_called_ce);',
+        'protected function parseThrow(mixed $expr): string',
+        '[Type::VAR, Type::REF, Type::OBJECT]',
+        "return 'php::throwValue(' . \$ex . ')';",
+        "\$lateStaticCall = \$expr instanceof Expr\\StaticCall",
+        "if (\$lateStaticCall && !\$this->isCurrentClassFinal()) {",
+        "\$magicMethod = \$expr instanceof Expr\\StaticCall ? '__callStatic' : '__call';",
+        'if ($classDef->hasMethod($magicMethod)) {',
+        'return false;',
+        "if (!\$nativeClass && strtolower(\$method) === 'toarray') {",
+        "zval *' . \$info['name'] . ' = nullptr;",
+        "typephp_get_static_property_cached(' . \$info['name']",
     ] as $required) {
         expect($compilerBase)->toContain($required);
     }
 
+    expect($compilerBase)->not->toContain('$nativeTypes');
+    expect($compilerBase)->not->toContain("\$info['classPtr']");
+    expect($compilerBase)->not->toContain('$method . \'__call\'');
+    expect($compilerBase)
+        ->not
+        ->toContain('Symbol::getCalledCe()')
+        ->toContain('$cePtr = $this->getCalledCeExpr();')
+        ->toContain('return $this->getCalledCeExpr();');
+    expect($stubGenerator)
+        ->toContain('function &refval(mixed &$value): mixed')
+        ->toContain('return $value;')
+        ->toContain('refval($declaredStrings)');
+    expect($translator)
+        ->toContain('protected function genArgumentDeclaration(ArgInfo $argInfo): string')
+        ->toContain("return Type::REF . ' ' . \$argInfo->name;")
+        ->toContain('$cppType = $argInfo->byRef')
+        ->toContain('$argumentType = $argInfo->byRef')
+        ->toContain("str_starts_with(basename(\$sourceFile), 'extension-')")
+        ->toContain("return \$options->with('optimize', 0);")
+        ->toContain('Compiling generated extension unit serially to bound peak memory')
+        ->toContain('array_merge($serialObjects, $this->compileWithPcntl($sourceFiles, $job))')
+        ->toContain('private function markClosureReferenceVariables(array $stmts): void')
+        ->toContain('findInstanceOf($stmts, Node\Expr\Closure::class)')
+        ->toContain('$this->context->localVars[$name] = Type::REF;')
+        ->toMatch('/markClosureReferenceVariables\\(\\$v->stmts\\);\\s*}\\s*'
+        . 'if \\(\\$this->functionDef->generator\\)/');
+    expect($funcCallOptimizer)
+        ->toContain('$cVar = $this->escapeVarName($var);')
+        ->toContain('if (!$this->hasVar($cVar) && $var !== \'this\')')
+        ->toContain('php::Var(\' . $cVar . \')');
+    expect($assignOpTrait)
+        ->toContain('$value = new Expr\ArrayDimFetch(')
+        ->toContain('$this->parseAssignFinally($item->value, $value)')
+        ->not->toContain('{$tmpVar}.item({$key})');
+    expect($methodCallPatch)
+        ->toContain('$useDeclaredToArray')
+        ->toContain("\$this->objectTypeDeclaresMethod(\$receiverClass, '__call')")
+        ->toContain('&& !$useObjectToArray')
+        ->toContain('SaiAdmin overlay: preserve dynamic late-static dispatch.')
+        ->toContain('Unexpected MethodCallTrait late-static optimization source')
+        ->toContain("substr_count(\$source, \$before) !== 1");
+    expect($nativeTypePatch)
+        ->toContain('strcasecmp($class, $expected) === 0')
+        ->toContain('$typedDirect')
+        ->toContain('$typedProxy')
+        ->toContain('Unexpected typed reference ABI boundary')
+        ->toContain('substr_count($source, $before) !== 1');
+
     expect($compilerBase)->toMatch(
         '/public function getPhpDir\(\): string\s*\{\s*if \(\$this->isIosTarget\(\)\) \{.*?'
         . 'return \$this->getIosSdkDir\(\);\s*}\s*if \(\$this->isAndroidTarget\(\)\) \{.*?'
diff --git a/tests/Unit/DistConfigSanitizerTest.php b/tests/Unit/DistConfigSanitizerTest.php
index 291f349..20cbb78 100644
--- a/tests/Unit/DistConfigSanitizerTest.php
+++ b/tests/Unit/DistConfigSanitizerTest.php
@@ -17,13 +17,13 @@ function writePhpFile(string $directory, string $relativePath, string $content):
 it('replaces unqualified Phar class constants with equivalent integer literals', function (): void {
     $sanitizer = new DistConfigSanitizer();
     $source = <<<'PHP'
-<?php
-return [
-    'phar_format' => Phar::PHAR, // Phar archive format: Phar::PHAR, Phar::TAR, Phar::ZIP
-    'phar_compression' => Phar::NONE, // Phar::NONE, Phar::GZ, Phar::BZ2
-    'signature_algorithm' => Phar::SHA256, // Phar::MD5, Phar::SHA1, Phar::SHA256
-];
-PHP;
+        <?php
+        return [
+            'phar_format' => Phar::PHAR, // Phar archive format: Phar::PHAR, Phar::TAR, Phar::ZIP
+            'phar_compression' => Phar::NONE, // Phar::NONE, Phar::GZ, Phar::BZ2
+            'signature_algorithm' => Phar::SHA256, // Phar::MD5, Phar::SHA1, Phar::SHA256
+        ];
+        PHP;
 
     $result = $sanitizer->sanitizePhpSource($source);
 
@@ -40,25 +40,23 @@ function writePhpFile(string $directory, string $relativePath, string $content):
 it('does not touch namespaced or non-mapped Phar references', function (): void {
     $sanitizer = new DistConfigSanitizer();
     $source = <<<'PHP'
-<?php
-return [
-    'app' => SomeVendor\Phar::DRIVER,
-    'ns' => \Phar::CUSTOM,
-    'plain' => 42,
-];
-PHP;
+        <?php
+        return [
+            'app' => SomeVendor\Phar::DRIVER,
+            'ns' => \Phar::CUSTOM,
+            'plain' => 42,
+        ];
+        PHP;
 
     $result = $sanitizer->sanitizePhpSource($source);
 
-    expect($result)
-        ->toContain('SomeVendor\Phar::DRIVER')
-        ->toContain('\\Phar::CUSTOM')
-        ->toContain("'plain' => 42,");
+    expect($result)->toContain('SomeVendor\Phar::DRIVER')->toContain('\\Phar::CUSTOM')->toContain("'plain' => 42,");
 });
 
 it('maps the full Phar constant set', function (): void {
     $sanitizer = new DistConfigSanitizer();
-    $source = "<?php return ['a' => Phar::PHAR, 'b' => Phar::TAR, 'c' => Phar::ZIP, "
+    $source =
+        "<?php return ['a' => Phar::PHAR, 'b' => Phar::TAR, 'c' => Phar::ZIP, "
         . "'d' => Phar::NONE, 'e' => Phar::GZ, 'f' => Phar::BZ2, "
         . "'g' => Phar::MD5, 'h' => Phar::SHA1, 'i' => Phar::SHA256, "
         . "'j' => Phar::SHA512, 'k' => Phar::OPENSSL];";
@@ -74,18 +72,18 @@ function writePhpFile(string $directory, string $relativePath, string $content):
     mkdir($directory, 0777, true);
     try {
         $console = writePhpFile($directory, 'plugin/webman/console/app.php', <<<'PHP'
-<?php
-return [
-    'enable' => true,
-    'phar_format' => Phar::PHAR,
-    'phar_compression' => Phar::NONE,
-    'signature_algorithm' => Phar::SHA256,
-];
-PHP);
+            <?php
+            return [
+                'enable' => true,
+                'phar_format' => Phar::PHAR,
+                'phar_compression' => Phar::NONE,
+                'signature_algorithm' => Phar::SHA256,
+            ];
+            PHP);
         $untouched = writePhpFile($directory, 'app.php', <<<'PHP'
-<?php
-return ['debug' => true];
-PHP);
+            <?php
+            return ['debug' => true];
+            PHP);
         $readme = writePhpFile($directory, 'notes.txt', 'Phar::PHAR should never be read as config');
 
         $sanitizer = new DistConfigSanitizer();
diff --git a/tests/Unit/DoctorCommandTest.php b/tests/Unit/DoctorCommandTest.php
index 719a819..97361af 100644
--- a/tests/Unit/DoctorCommandTest.php
+++ b/tests/Unit/DoctorCommandTest.php
@@ -17,3 +17,13 @@
     // 状态码应为 0 (成功) 或 1 (当缺少前置依赖时)
     expect($statusCode)->toBeIn([0, 1]);
 });
+
+it('supports an independent native toolchain target', function (): void {
+    $command = new DoctorCommand();
+    $tester = new CommandTester($command);
+
+    $statusCode = $tester->execute(['--target' => 'native']);
+
+    expect($tester->getDisplay())->toContain('TypePHP Environment Diagnostic Tool')->toContain('Native');
+    expect($statusCode)->toBeIn([0, 1]);
+});
diff --git a/tests/Unit/NativeCompileCommandTest.php b/tests/Unit/NativeCompileCommandTest.php
new file mode 100644
index 0000000..9d1e6a1
--- /dev/null
+++ b/tests/Unit/NativeCompileCommandTest.php
@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+use Tinywan\Typephp\Commands\NativeCompileCommand;
+
+it('exposes a Docker-free native compile command', function (): void {
+    $command = new NativeCompileCommand();
+
+    expect($command->getName())->toBe('typephp:compile');
+    expect($command->getDescription())->toContain('without Docker');
+    expect($command->getDefinition()->hasOption('profile'))->toBeTrue();
+    expect($command->getDefinition()->hasOption('output-name'))->toBeTrue();
+    expect($command->getDefinition()->hasOption('tpc'))->toBeTrue();
+    expect($command->getDefinition()->hasOption('php'))->toBeTrue();
+    expect($command->getDefinition()->hasOption('php-home'))->toBeTrue();
+    expect($command->getDefinition()->hasOption('phpx-home'))->toBeTrue();
+    expect($command->getDefinition()->hasOption('cxx'))->toBeTrue();
+    expect($command->getDefinition()->hasOption('build-dir'))->toBeTrue();
+    expect($command->getDefinition()->hasOption('force'))->toBeTrue();
+    expect($command->getDefinition()->hasOption('refresh-main'))->toBeTrue();
+});
+
+it('registers native compilation alongside the existing Docker package command', function (): void {
+    $commands = require dirname(__DIR__, 2) . '/src/config/plugin/tinywan/typephp/command.php';
+
+    expect($commands)
+        ->toContain(NativeCompileCommand::class)
+        ->toContain(\Tinywan\Typephp\Commands\PackageCommand::class);
+});
+
+it('ships host-neutral native toolchain configuration', function (): void {
+    $config = require dirname(__DIR__, 2) . '/src/config/plugin/tinywan/typephp/app.php';
+
+    expect($config['native'] ?? null)->toBe([
+        'tpc' => null,
+        'php' => null,
+        'php_home' => null,
+        'phpx_home' => null,
+        'cxx' => null,
+    ]);
+});
diff --git a/tests/Unit/NativeCompilerOverlayTest.php b/tests/Unit/NativeCompilerOverlayTest.php
new file mode 100644
index 0000000..46c2786
--- /dev/null
+++ b/tests/Unit/NativeCompilerOverlayTest.php
@@ -0,0 +1,109 @@
+<?php
+
+declare(strict_types=1);
+
+use Tinywan\Typephp\Compiler\NativeCompilerOverlay;
+
+it('creates a fail-closed local compiler overlay without modifying TypePHP', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-overlay-' . bin2hex(random_bytes(4));
+    $typephp = $directory . '/typephp';
+    $overlay = $directory . '/overlay';
+    mkdir($typephp . '/bin', 0777, true);
+    mkdir($typephp . '/src/NativeClass', 0777, true);
+    mkdir($typephp . '/src/Parser', 0777, true);
+    mkdir($typephp . '/src/TypeSystem', 0777, true);
+    file_put_contents($directory . '/autoload.php', "<?php\n");
+    file_put_contents($typephp . '/bin/bootstrap.php', "<?php\n");
+    file_put_contents($typephp . '/src/compiler.php', "<?php\n");
+
+    $nativeBlock = <<<'PHP'
+                $kind = $nativeClass ? 'Native conversion method' : 'Conversion method';
+                if ($function->argInfoList !== []) {
+                    $this->fatalError($node, "{$kind} `{$class}::{$method}()` must not accept arguments");
+                }
+        PHP;
+    $methodBlock = <<<'PHP'
+                $nativeFunc = $this->getNativeMethod($expr, $class, $method);
+                // A Native class exists but the method was not found; this may be a dynamic call
+
+                        if (!isset(self::KEYWORD_METHOD_WITH_ARGUMENTS[$methodName]) && $expr->args !== []) {
+                            $this->fatalError($expr, "The {$methodName} method does not accept parameters");
+                        }
+                        if ($methodName === 'toObject') {
+                            return $this->genToObjectCall($expr, $object);
+                        }
+                        if ($methodName === 'toRef') {
+                            return $this->genToRefCall($expr);
+                        }
+                        $receiverClass = $class;
+                        if ($receiverClass === '' && !$this->isVarExpr($expr->var)) {
+                            $receiverClass = $this->detectClassOfExpr($expr->var);
+                        }
+                        // A declared conversion method is called directly. Otherwise
+                        // php::toArray() applies the PHP-compatible object-property
+                        // fallback (and invokes a real toArray() method when present).
+                        $useDeclaredToArray = $methodName === 'toArray'
+                            && $receiverClass !== ''
+                            && $this->objectTypeDeclaresMethod($receiverClass, $methodName);
+                        if (!$useDeclaredToArray) {
+                            return $this->genToConvertCall($object, $methodName, $receiverType);
+                        }
+
+            private function parseExactLateStaticCall(
+                object $expr,
+                string $method,
+                string $methodPtr,
+            ): ?string {
+                if ($expr->args !== [] || !$this->classDef || !$this->methodDef) {
+                    return null;
+                }
+            }
+        PHP;
+    file_put_contents($typephp . '/src/NativeClass/NativeClassSupportTrait.php', "<?php\n{$nativeBlock}\n");
+    file_put_contents($typephp . '/src/Parser/MethodCallTrait.php', "<?php\n{$methodBlock}\n");
+    file_put_contents(
+        $typephp . '/src/TypeSystem/NativeTypeCompatibilityTrait.php',
+        "<?php\nreturn \$internal && is_subclass_of(\$class, \$expected);\n",
+    );
+    $preprocessorBlock = <<<'PHP'
+                    if (!$this->isInternalFunction($funcName)) {
+                        $this->symbolCallInFile[$this->file][] = $this->getFunctionDependencySymbol($funcName);
+                    }
+        PHP;
+    file_put_contents($typephp . '/src/Preprocessor.php', "<?php\n{$preprocessorBlock}\n");
+
+    try {
+        $runner = new NativeCompilerOverlay()->prepare([
+            'typephp_home' => $typephp,
+            'tpc' => $directory . '/bin/tpc.php',
+        ], $overlay);
+
+        expect($runner)->toBe($overlay . '/tpc.php');
+        expect(file_get_contents($typephp . '/src/NativeClass/NativeClassSupportTrait.php'))
+            ->not
+            ->toContain("strtolower(\$method) === 'toarray'");
+        expect(file_get_contents($overlay . '/NativeClassSupportTrait.php'))
+            ->toContain("strtolower(\$method) === 'toarray'");
+        expect(file_get_contents($overlay . '/MethodCallTrait.php'))
+            ->toContain('$useDynamicToArray =')
+            ->toContain("Carbon's addDays-style unit API")
+            ->toContain('SaiAdmin overlay: preserve dynamic late-static dispatch.');
+        expect(file_get_contents($overlay . '/NativeTypeCompatibilityTrait.php'))
+            ->toContain('strcasecmp($class, $expected) === 0');
+        expect(file_get_contents($overlay . '/Preprocessor.php'))
+            ->toContain('$unqualified =')
+            ->toContain('$this->getFunctionDependencySymbol($sourceName)');
+        expect(file_get_contents($runner))->toContain("require __DIR__ . '/Preprocessor.php';");
+    } finally {
+        if (is_dir($directory)) {
+            $iterator = new RecursiveIteratorIterator(
+                new RecursiveDirectoryIterator($directory, FilesystemIterator::SKIP_DOTS),
+                RecursiveIteratorIterator::CHILD_FIRST,
+            );
+            foreach ($iterator as $item) {
+                $item->isDir() ? rmdir($item->getPathname()) : unlink($item->getPathname());
+            }
+            rmdir($directory);
+        }
+    }
+});
diff --git a/tests/Unit/PackageCommandTest.php b/tests/Unit/PackageCommandTest.php
index 3367a4c..7b622e7 100644
--- a/tests/Unit/PackageCommandTest.php
+++ b/tests/Unit/PackageCommandTest.php
@@ -7,6 +7,7 @@
     expect($command->getName())->toBe('typephp:package');
     expect($command->getDefinition()->hasOption('force'))->toBeTrue();
     expect($command->getDefinition()->hasOption('image'))->toBeTrue();
+    expect($command->getDefinition()->hasOption('profile'))->toBeTrue();
     expect($command->getDefinition()->hasOption('output-dir'))->toBeTrue();
     expect($command->getDefinition()->hasOption('output-name'))->toBeTrue();
     expect($command->getDefinition()->hasOption('refresh-main'))->toBeTrue();
@@ -30,6 +31,68 @@
     }
 
     expect($dockerConfig['image'] ?? null)->toBe('tinywan/typephp-webman-builder:v0.1.3');
+    expect($pluginConfig['build']['jobs'] ?? null)->toBe(4);
+    expect($pluginConfig['runtime_resources'] ?? [])
+        ->toContain('vendor/laravel/serializable-closure')
+        ->toContain('vendor/phpmailer/phpmailer/get_oauth_token.php')
+        ->toContain('vendor/symfony/cache')
+        ->toContain('vendor/symfony/clock/Resources')
+        ->toContain('vendor/symfony/console/Attribute')
+        ->toContain('vendor/symfony/console/Command/InvokableCommand.php')
+        ->toContain('vendor/symfony/console/Command/TraceableCommand.php')
+        ->toContain('vendor/symfony/console/Completion')
+        ->toContain('vendor/symfony/console/DataCollector')
+        ->toContain('vendor/symfony/console/Helper/Table.php')
+        ->toContain('vendor/symfony/error-handler')
+        ->toContain('vendor/symfony/finder')
+        ->toContain('vendor/symfony/http-foundation/Session/Storage/Handler/IdentityMarshaller.php')
+        ->toContain('vendor/symfony/http-foundation/Session/Storage/Handler/MigratingSessionHandler.php')
+        ->toContain('vendor/symfony/http-kernel/DataCollector')
+        ->toContain('vendor/symfony/http-kernel/Fragment/InlineFragmentRenderer.php')
+        ->toContain('vendor/symfony/http-kernel/Kernel.php')
+        ->toContain('vendor/symfony/mime/Crypto')
+        ->toContain('vendor/symfony/mime/HtmlToTextConverter/LeagueHtmlToMarkdownConverter.php')
+        ->toContain('vendor/symfony/mime/Part')
+        ->toContain('vendor/symfony/polyfill-intl-normalizer')
+        ->toContain('vendor/symfony/process')
+        ->toContain('vendor/symfony/string')
+        ->toContain('vendor/symfony/translation/Util/ArrayConverter.php')
+        ->toContain('vendor/symfony/var-dumper')
+        ->toContain('vendor/symfony/var-exporter')
+        ->toContain('vendor/symfony/translation/DataCollector')
+        ->toContain('vendor/openspout/openspout')
+        ->toContain('vendor/twig/twig')
+        ->toContain('vendor/tinywan/storage')
+        ->toContain('vendor/topthink/think-orm/stubs/load_stubs.php')
+        ->toContain('vendor/topthink/think-orm/src/db/Mongo.php')
+        ->toContain('vendor/topthink/think-orm/src/db/builder/Mongo.php')
+        ->toContain('vendor/topthink/think-orm/src/db/connector/Mongo.php')
+        ->toContain('vendor/topthink/think-orm/src/db/builder/Oracle.php')
+        ->toContain('vendor/topthink/think-orm/src/db/builder/Pgsql.php')
+        ->toContain('vendor/topthink/think-orm/src/db/builder/Sqlite.php')
+        ->toContain('vendor/topthink/think-orm/src/db/builder/Sqlsrv.php')
+        ->toContain('vendor/voku/portable-ascii')
+        ->toContain('vendor/webman/channel')
+        ->toContain('vendor/webman/console/src/Commands')
+        ->toContain('vendor/webman/console/src/Messages.php')
+        ->toContain('vendor/webman/console/src/Util.php')
+        ->toContain('vendor/webman/database/src/support/MongoModel.php')
+        ->toContain('vendor/webman/captcha/src/Font')
+        ->toContain('vendor/workerman/channel')
+        ->not->toContain('vendor/workerman/coroutine/src/Pool.php')
+        ->not->toContain('vendor/workerman/coroutine/src/Utils/DestructionWatcher.php')->toContain(
+            'vendor/voku/portable-ascii/src/voku/helper/data',
+        )->toContain('vendor/zoujingli/ip2region/ip2region.xdb')->toContain('plugin/saiadmin/utils/code/stub');
+    expect($pluginConfig['ignore'] ?? [])
+        ->toContain('vendor/symfony/console/Helper/Table.php')
+        ->toContain('vendor/symfony/mime/HtmlToTextConverter/LeagueHtmlToMarkdownConverter.php')
+        ->toContain('vendor/workerman/crontab/example');
+    expect($pluginConfig['runtime_resources'] ?? [])
+        ->not->toContain('plugin/saiadmin/app/controller/LoginController.php')
+        ->not->toContain('plugin/saiadmin/app/controller/InstallController.php');
+    expect($pluginConfig['ignore'] ?? [])
+        ->not->toContain('plugin/saiadmin/app/controller/LoginController.php')
+        ->not->toContain('plugin/saiadmin/app/controller/InstallController.php');
 });
 
 it('resolves the builder image from the option, configuration, then fallback', function (): void {
@@ -46,3 +109,32 @@
 
     expect($method->invoke($command, null, []))->toBe('tinywan/typephp-webman-builder:v0.1.3');
 });
+
+it('keeps new packaged ignore defaults when a project has stale published configuration', function (): void {
+    $command = new \Tinywan\Typephp\Commands\PackageCommand();
+    $method = new ReflectionMethod($command, 'mergePluginConfig');
+
+    $merged = $method->invoke(
+        $command,
+        [
+            'docker' => ['image' => 'tinywan/typephp-webman-builder:v0.1.3'],
+            'ignore' => ['vendor/carbonphp/carbon-doctrine-types'],
+            'runtime_resources' => ['plugin/saiadmin/utils/code/stub'],
+        ],
+        [
+            'docker' => ['image' => 'tinywan/typephp-webman-builder:v0.2.1'],
+            'ignore' => ['app/model'],
+            'runtime_resources' => ['public'],
+        ],
+    );
+
+    expect($merged['docker']['image'])->toBe('tinywan/typephp-webman-builder:v0.2.1');
+    expect($merged['ignore'])->toBe([
+        'vendor/carbonphp/carbon-doctrine-types',
+        'app/model',
+    ]);
+    expect($merged['runtime_resources'])->toBe([
+        'plugin/saiadmin/utils/code/stub',
+        'public',
+    ]);
+});
diff --git a/tests/Unit/PortableArtifactContractTest.php b/tests/Unit/PortableArtifactContractTest.php
index 2610b6a..db468c9 100644
--- a/tests/Unit/PortableArtifactContractTest.php
+++ b/tests/Unit/PortableArtifactContractTest.php
@@ -39,10 +39,19 @@
         'libc.so*',
         'trap cleanup_stage_on_failure EXIT',
         'trap - EXIT',
+        'mkdir -p "$real_workspace/.typephp"',
         'install -m 0755 /dev/stdin "$stage_dir/start.sh"',
         'TYPEPHP_OUTPUT_DIR must be a safe project-relative path.',
+        'TYPEPHP_JOBS must be a positive integer.',
+        'jobs="${TYPEPHP_JOBS:-$(nproc 2>/dev/null || echo 2)}"',
+        '[[ "$jobs" -gt 4 ]] && jobs=4',
         'path="${path//\\\\//}"',
         "'..'",
+        'runtime-resources.list',
+        'validate_relative_path "$resource"',
+        'cp -a "$workspace/$resource" "$stage_dir/$resource"',
+        '[[ -f app/functions.php && ! -f "$build_dir/source-coverage.json" ]]',
+        'copy_file "$build_dir/source-coverage.json" "$stage_dir/source-coverage.json"',
     ] as $required) {
         expect($entrypoint)->toContain($required);
     }
@@ -51,3 +60,11 @@
         'tinywan/typephp-linux-x64:v0.8.0@sha256:f18cac640edf52126acc1ad781f220f9fe547f7c8db925dcc38d4854f9436f90',
     );
 });
+
+it('excludes unconfigured third-party adapters from the default compile set', function (): void {
+    $config = require dirname(__DIR__, 2) . '/src/config/plugin/tinywan/typephp/app.php';
+
+    expect($config['ignore'])
+        ->toContain('vendor/carbonphp/carbon-doctrine-types')
+        ->toContain('vendor/illuminate/bus/DynamoBatchRepository.php');
+});
diff --git a/tests/Unit/ProjectGeneratorTest.php b/tests/Unit/ProjectGeneratorTest.php
index 060a275..d282eb9 100644
--- a/tests/Unit/ProjectGeneratorTest.php
+++ b/tests/Unit/ProjectGeneratorTest.php
@@ -2,8 +2,72 @@
 
 declare(strict_types=1);
 
+use Tinywan\Typephp\Compiler\Profile\SaiAdminProfile;
 use Tinywan\Typephp\Compiler\ProjectGenerator;
 
+it('excludes optional non-Fiber coroutine backends from AOT', function (): void {
+    $config = require dirname(__DIR__, 2) . '/src/config/plugin/tinywan/typephp/app.php';
+    expect($config['ignore'])
+        ->not->toContain('vendor/workerman/coroutine/src/Pool.php')
+        ->not->toContain('vendor/workerman/coroutine/src/Utils/DestructionWatcher.php');
+    expect($config['runtime_resources'])
+        ->not->toContain('vendor/workerman/coroutine/src/Pool.php')
+        ->not->toContain('vendor/workerman/coroutine/src/Utils/DestructionWatcher.php');
+    foreach (['Swow', 'Swoole'] as $backend) {
+        foreach (['Barrier', 'Channel', 'Context', 'Coroutine', 'WaitGroup'] as $component) {
+            expect($config['ignore'])->toContain("vendor/workerman/coroutine/src/{$component}/{$backend}.php");
+        }
+        expect($config['ignore'])->toContain("vendor/workerman/workerman/src/Events/{$backend}.php");
+    }
+});
+
+it('does not let stale project config exclude required coroutine dependencies', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/plugin/saiadmin', 0777, true);
+
+    try {
+        $profile = new SaiAdminProfile($directory);
+        $stalePaths = [
+            'vendor/workerman/coroutine/src/Pool.php',
+            'vendor/workerman/coroutine/src/Utils/DestructionWatcher.php',
+        ];
+        expect($profile->filterUserIgnores($stalePaths))
+            ->toBe([])
+            ->and($profile->filterRuntimeResources($stalePaths))
+            ->toBe([]);
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('bypasses the Workerman pool WeakMap placeholder outside coroutines in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/workerman/coroutine/src', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/workerman/coroutine/src/Pool.php',
+        "<?php\nnamespace Workerman\\Coroutine;\nclass Pool {\n"
+        . "    public function createConnection(): object\n    {\n"
+        . "        \$placeholder = new stdClass;\n"
+        . "        \$connection = new stdClass;\n"
+        . "        \$this->connections[\$connection] = \$this->lastUsedTimes[\$connection] = \$this->lastHeartbeatTimes[\$connection] = time();\n"
+        . "        return \$placeholder;\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toContain('.typephp/build/workerman-coroutine-pool.php');
+        expect(file_get_contents($directory . '/.typephp/build/workerman-coroutine-pool.php'))
+            ->toContain('        if (!Coroutine::isCoroutine()) {')
+            ->toContain('            $this->connections->offsetSet($connection, $timestamp);')
+            ->toContain('        $this->connections->offsetSet($connection, $timestamp);')
+            ->not
+            ->toContain('$this->connections[$connection] = $this->lastUsedTimes[$connection]')
+            ->toContain('        $placeholder = new stdClass;');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
 function removeTypephpTestDirectory(string $directory): void
 {
     if (!is_dir($directory)) {
@@ -55,7 +119,23 @@ function createWebmanHelpersFixture(string $directory, string $content): string
 
         // 测试 generateMain 首次生成
         $mainPath = $generator->generateMain();
-        expect(file_exists($mainPath))->toBeTrue();
+        expect(file_exists($mainPath))
+            ->toBeTrue()
+            ->and(file_get_contents($mainPath))
+            ->toContain('\Webman\Database\Initializer::init(config(\'database\', []));')
+            ->toContain('\Webman\ThinkOrm\Initializer::init();')
+            ->toContain('function typephp_is_compiled_autoload_file(string $file): bool')
+            ->toContain('function typephp_worker_bootstrap($worker): void')
+            ->toContain('E_DEPRECATED | E_USER_DEPRECATED')
+            ->toContain("'support/Request.php', 'support/Response.php'")
+            ->toContain("preg_match('#^plugin/[^/]+/app/functions")
+            ->toContain("foreach (config('autoload.files', []) as \$file)")
+            ->toContain("foreach (\$projects['autoload']['files'] ?? [] as \$file)")
+            ->toContain('if (is_file($file) && !typephp_is_compiled_autoload_file($file))')
+            ->toContain('\Webman\Middleware::load($pluginConfig[\'middleware\'] ?? [], (string) $pluginName);')
+            ->toContain("glob(base_path() . '/plugin/*/config', GLOB_ONLYDIR)")
+            ->toContain('\Webman\Route::load($routePaths);');
+        expect(substr_count((string) file_get_contents($mainPath), '\Webman\Route::load($routePaths);'))->toBe(1);
 
         // 测试 generateMain 强制刷新生成备份
         file_put_contents($mainPath, '<?php // custom user code');
@@ -87,6 +167,61 @@ function createWebmanHelpersFixture(string $directory, string $content): string
     }
 });
 
+it('writes only existing safe runtime resources into the packaging manifest', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/example/data', 0777, true);
+    mkdir($directory . '/vendor/laravel/serializable-closure', 0777, true);
+    mkdir($directory . '/vendor/symfony/cache', 0777, true);
+    file_put_contents($directory . '/vendor/example/data/map.php', "<?php\nreturn [];\n");
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateRuntimeResourceList([
+            'vendor/example/data',
+            'vendor/example/missing',
+            'vendor/example/data',
+        ]))
+            ->toBe('.typephp/build/runtime-resources.list');
+        expect(file_get_contents($directory . '/.typephp/build/runtime-resources.list'))->toBe("vendor/example/data\n");
+        $generator->generateProjectYml(['include' => ['app']]);
+        expect(file_get_contents($directory . '/.typephp/build/runtime-resources.list'))
+            ->toBe("vendor/laravel/serializable-closure\nvendor/symfony/cache\n");
+        expect(file_get_contents($directory . '/project.linux.yml'))
+            ->toContain("\n  - vendor/laravel/serializable-closure\n")
+            ->toContain("\n  - vendor/symfony/cache\n");
+        expect(fn(): ?string => $generator->generateRuntimeResourceList(['../secret']))
+            ->toThrow(RuntimeException::class);
+        expect(fn(): ?string => $generator->generateRuntimeResourceList(['/absolute/path']))
+            ->toThrow(RuntimeException::class);
+        expect(fn(): ?string => $generator->generateRuntimeResourceList(['.typephp/build']))
+            ->toThrow(RuntimeException::class);
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Webman plugin configuration available for runtime discovery', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-plugin-config-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/plugin/saiadmin/config', 0777, true);
+    mkdir($directory . '/plugin/example/config', 0777, true);
+    file_put_contents($directory . '/plugin/saiadmin/config/route.php', "<?php\nreturn [];\n");
+    file_put_contents($directory . '/plugin/example/config/app.php', "<?php\nreturn ['enable' => true];\n");
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->discoverPluginConfigResources())->toBe([
+            'plugin/example/config',
+            'plugin/saiadmin/config',
+        ]);
+
+        $generator->generateProjectYml(['include' => ['app']]);
+        expect(file_get_contents($directory . '/.typephp/build/runtime-resources.list'))
+            ->toBe("plugin/example/config\nplugin/saiadmin/config\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
 it('flattens guarded webman helpers into an AOT-compatible source file', function (): void {
     $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
     mkdir($directory, 0777, true);
@@ -191,12 +326,9 @@ function worker_start($processName, $config)
             ->and(str_contains($flattened, 'Get the base path of the application'))
             ->toBeFalse();
 
-        // worker_start 中的 support/bootstrap.php require 改为 is_file 守卫
-        // （便携产物不携带 support/ 目录，缺失时不能致命）
-        expect($flattened)
-            ->toContain('$bootstrap = base_path(')
-            ->toContain('if (is_file($bootstrap)) {')
-            ->toContain('require_once $bootstrap;');
+        // worker_start 使用 AOT bootstrap，避免 support/bootstrap.php 再次 include
+        // 已编译的 Request、Response 与业务 functions。
+        expect($flattened)->toContain('typephp_worker_bootstrap($worker);');
         expect(str_contains($flattened, "require_once base_path('/support/bootstrap.php')"))->toBeFalse();
 
         // 顶层不允许出现任何 T_IF（TypePHP 会报 Unsupported statement: Stmt_If）
@@ -226,7 +358,184 @@ function worker_start($processName, $config)
         $yml = (string) file_get_contents($generator->generateProjectYml([]));
         expect($yml)
             ->toContain("sources:\n  - main.php\n  - .typephp/build/helpers.php\n")
-            ->toContain("\n  - vendor/workerman/webman-framework/src/support/helpers.php\n");
+            ->toContain("\n  - vendor/workerman/webman-framework/src/support/helpers.php\n")
+            ->toContain("\n  - vendor/illuminate/pagination/resources\n")
+            ->toContain("\n  - vendor/illuminate/bus/ChainedBatch.php\n")
+            ->toContain("\n  - vendor/illuminate/database/Console\n")
+            ->toContain("\n  - vendor/illuminate/database/Eloquent/BroadcastableModelEventOccurred.php\n")
+            ->toContain("\n  - vendor/illuminate/database/Eloquent/BroadcastsEvents.php\n")
+            ->toContain("\n  - vendor/illuminate/database/Eloquent/BroadcastsEventsAfterCommit.php\n")
+            ->toContain("\n  - vendor/illuminate/events/CallQueuedListener.php\n")
+            ->toContain("\n  - vendor/symfony/cache/Traits/Relay\n")
+            ->toContain("\n  - vendor/symfony/cache/Traits/RelayProxy.php\n")
+            ->toContain("\n  - vendor/symfony/cache/Traits/RelayClusterProxy.php\n")
+            ->toContain("\n  - vendor/symfony/http-kernel/Bundle\n")
+            ->toContain("\n  - vendor/symfony/http-kernel/Config\n")
+            ->toContain("\n  - vendor/symfony/http-kernel/Debug\n")
+            ->toContain("\n  - vendor/symfony/http-kernel/EventListener/DumpListener.php\n")
+            ->toContain("\n  - vendor/symfony/http-kernel/EventListener/ProfilerListener.php\n")
+            ->toContain("\n  - vendor/symfony/http-kernel/HttpKernelBrowser.php\n")
+            ->toContain("\n  - vendor/symfony/http-kernel/Profiler\n")
+            ->toContain("\n  - vendor/symfony/mime/DependencyInjection\n")
+            ->toContain("\n  - vendor/symfony/mime/Test\n")
+            ->toContain("\n  - vendor/symfony/service-contracts/Test\n")
+            ->toContain("\n  - vendor/symfony/translation-contracts/Test\n")
+            ->toContain("\n  - vendor/symfony/translation/DependencyInjection\n")
+            ->toContain("\n  - vendor/symfony/translation/Extractor\n")
+            ->toContain("\n  - vendor/symfony/translation/Test\n")
+            ->toContain("\n  - vendor/symfony/console/DependencyInjection\n")
+            ->toContain("\n  - vendor/symfony/console/Tester\n")
+            ->toContain("\n  - vendor/symfony/event-dispatcher/Debug\n")
+            ->toContain("\n  - vendor/symfony/event-dispatcher/DependencyInjection\n")
+            ->toContain("\n  - vendor/symfony/http-foundation/Test\n")
+            ->toContain("\n  - vendor/symfony/http-kernel/DependencyInjection\n")
+            ->toContain("\n  - vendor/illuminate/session/Console\n")
+            ->toContain("\n  - vendor/illuminate/support/Testing\n")
+            ->toContain("\n  - vendor/nelexa/zip/.php-cs-fixer.php\n")
+            ->toContain("\n  - vendor/nesbot/carbon/src/Carbon/Lang\n")
+            ->toContain("\n  - vendor/nesbot/carbon/src/Carbon/List\n")
+            ->toContain("\n  - vendor/nesbot/carbon/src/Carbon/PHPStan\n")
+            ->toContain("\n  - vendor/saithink/saiadmin/src/orm\n")
+            ->toContain("\n  - vendor/saithink/saiadmin/src/plugin\n")
+            ->toContain("\n  - vendor/saithink/saipackage/src/plugin\n")
+            ->toContain("\n  - vendor/tinywan/jwt/src/config\n")
+            ->toContain("\n  - vendor/tinywan/jwt/tests\n")
+            ->toContain("\n  - vendor/tinywan/storage/.php-cs-fixer.php\n")
+            ->toContain("\n  - vendor/tinywan/storage/src/config\n")
+            ->toContain("\n  - vendor/tinywan/storage/tests\n")
+            ->toContain("\n  - vendor/tinywan/webman-typephp\n")
+            ->toContain("\n  - vendor/topthink/think-container/tests\n")
+            ->toContain("\n  - vendor/topthink/think-helper/src/helper.php\n")
+            ->toContain("\n  - vendor/topthink/think-helper/tests\n")
+            ->toContain("\n  - vendor/topthink/think-orm/stubs/load_stubs.php\n")
+            ->toContain("\n  - vendor/topthink/think-orm/stubs/Facade.php\n")
+            ->not
+            ->toContain("\n  - vendor/topthink/think-orm/stubs\n")
+            ->toContain("\n  - vendor/workerman/channel/test\n")
+            ->toContain("\n  - vendor/symfony/error-handler/Resources\n")
+            ->toContain("\n  - vendor/symfony/http-kernel/Resources\n")
+            ->toContain("\n  - vendor/symfony/string/Resources\n")
+            ->toContain("\n  - vendor/symfony/translation/Resources\n")
+            ->toContain("\n  - vendor/symfony/var-dumper/Resources\n")
+            ->toContain("\n  - vendor/symfony/polyfill-intl-idn/Resources\n")
+            ->toContain("\n  - vendor/symfony/polyfill-intl-normalizer/Resources\n")
+            ->toContain("\n  - vendor/symfony/polyfill-mbstring/Resources\n")
+            ->toContain("\n  - vendor/symfony/polyfill-php80/Resources\n")
+            ->toContain("\n  - vendor/symfony/polyfill-php83/Resources\n")
+            ->toContain("\n  - vendor/symfony/polyfill-php84/Resources\n")
+            ->toContain("\n  - vendor/symfony/polyfill-ctype/bootstrap.php\n")
+            ->toContain("\n  - vendor/symfony/polyfill-ctype/bootstrap80.php\n");
+        expect(ProjectGenerator::GUARDED_SOURCES['vendor/illuminate/collections/helpers.php'])
+            ->toBe('.typephp/build/illuminate-collections-helpers.php');
+        expect(ProjectGenerator::GUARDED_SOURCES['vendor/illuminate/collections/functions.php'])
+            ->toBe('.typephp/build/illuminate-collections-functions.php');
+        expect(ProjectGenerator::GUARDED_SOURCES['vendor/illuminate/events/functions.php'])
+            ->toBe('.typephp/build/illuminate-events-functions.php');
+        expect(ProjectGenerator::GUARDED_SOURCES['vendor/illuminate/filesystem/functions.php'])
+            ->toBe('.typephp/build/illuminate-filesystem-functions.php');
+        expect(ProjectGenerator::GUARDED_SOURCES['vendor/illuminate/reflection/helpers.php'])
+            ->toBe('.typephp/build/illuminate-reflection-helpers.php');
+        expect(ProjectGenerator::GUARDED_SOURCES['vendor/illuminate/support/helpers.php'])
+            ->toBe('.typephp/build/illuminate-support-helpers.php');
+        expect(ProjectGenerator::GUARDED_SOURCES['vendor/illuminate/support/functions.php'])
+            ->toBe('.typephp/build/illuminate-support-functions.php');
+        expect(ProjectGenerator::GUARDED_SOURCES['vendor/ralouphie/getallheaders/src/getallheaders.php'])
+            ->toBe('.typephp/build/getallheaders.php');
+        expect(ProjectGenerator::GUARDED_SOURCES['vendor/symfony/deprecation-contracts/function.php'])
+            ->toBe('.typephp/build/symfony-trigger-deprecation.php');
+        expect(ProjectGenerator::GUARDED_SOURCES['vendor/symfony/var-dumper/Resources/functions/dump.php'])
+            ->toBe('.typephp/build/symfony-var-dumper-functions.php');
+        expect(ProjectGenerator::GUARDED_SOURCES['vendor/topthink/think-validate/src/helper.php'])
+            ->toBe('.typephp/build/think-validate-functions.php');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('expands Illuminate support CarbonInterval factories in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/illuminate/support';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/functions.php', <<<'PHP'
+        <?php
+        if (! function_exists('microseconds')) {
+            function microseconds(int|float $microseconds): CarbonInterval
+            {
+                return CarbonInterval::microseconds($microseconds);
+            }
+        }
+        if (! function_exists('milliseconds')) {
+            function milliseconds(int|float $milliseconds): CarbonInterval
+            {
+                return CarbonInterval::milliseconds($milliseconds);
+            }
+        }
+        if (! function_exists('seconds')) {
+            function seconds(int|float $seconds): CarbonInterval
+            {
+                return CarbonInterval::seconds($seconds);
+            }
+        }
+        if (! function_exists('minutes')) {
+            function minutes(int|float $minutes): CarbonInterval
+            {
+                return CarbonInterval::minutes($minutes);
+            }
+        }
+        if (! function_exists('hours')) {
+            function hours(int|float $hours): CarbonInterval
+            {
+                return CarbonInterval::hours($hours);
+            }
+        }
+        if (! function_exists('days')) {
+            function days(int|float $days): CarbonInterval
+            {
+                return CarbonInterval::days($days);
+            }
+        }
+        if (! function_exists('weeks')) {
+            function weeks(int $weeks): CarbonInterval
+            {
+                return CarbonInterval::weeks($weeks);
+            }
+        }
+        if (! function_exists('months')) {
+            function months(int $months): CarbonInterval
+            {
+                return CarbonInterval::months($months);
+            }
+        }
+        if (! function_exists('years')) {
+            function years(int $years): CarbonInterval
+            {
+                return CarbonInterval::years($years);
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateFlattenedSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/illuminate-support-functions.php');
+        expect($generated)
+            ->toContain('new CarbonInterval(0, 0, 0, 0, 0, 0, 0, $microseconds)')
+            ->toContain('new CarbonInterval(0, 0, 0, 0, 0, 0, 0, $milliseconds * 1000)')
+            ->toContain('new CarbonInterval(0, 0, 0, 0, 0, 0, $seconds)')
+            ->toContain('new CarbonInterval(0, 0, 0, 0, 0, $minutes)')
+            ->toContain('new CarbonInterval(0, 0, 0, 0, $hours)')
+            ->toContain('new CarbonInterval(0, 0, 0, $days)')
+            ->toContain('new CarbonInterval(0, 0, $weeks)')
+            ->toContain('new CarbonInterval(0, $months)')
+            ->toContain('new CarbonInterval($years)')
+            ->not->toContain('CarbonInterval::microseconds')
+            ->not->toContain('CarbonInterval::milliseconds')
+            ->not->toContain('CarbonInterval::seconds')
+            ->not->toContain('CarbonInterval::minutes')
+            ->not->toContain('CarbonInterval::hours')
+            ->not->toContain('CarbonInterval::days')
+            ->not->toContain('CarbonInterval::weeks')
+            ->not->toContain('CarbonInterval::months')
+            ->not->toContain('CarbonInterval::years');
     } finally {
         removeTypephpTestDirectory($directory);
     }
@@ -347,6 +656,9 @@ function cachedDispatcher(callable $routeDefinitionCallback, array $options = []
             ->toContain('namespace FastRoute;')
             ->toContain('function simpleDispatcher(callable $routeDefinitionCallback, array $options = [])')
             ->toContain('function cachedDispatcher(callable $routeDefinitionCallback, array $options = [])')
+            ->toContain('$options = $options + [')
+            ->not
+            ->toContain('$options += [')
             ->toContain("'FastRoute\\\\RouteParser\\\\Std'");
         expect(str_contains($flattened, 'function_exists'))->toBeFalse();
 
@@ -356,573 +668,6051 @@ function cachedDispatcher(callable $routeDefinitionCallback, array $options = []
             ->toContain(
                 "sources:\n  - main.php\n  - .typephp/build/helpers.php\n  - .typephp/build/fast-route-functions.php\n",
             )
-            ->toContain("\n  - vendor/nikic/fast-route/src/functions.php\n");
+            ->toContain("\n  - vendor/nikic/fast-route/src/functions.php\n")
+            ->toContain("\n  - vendor/cakephp/chronos/rector.php\n")
+            ->toContain("\n  - vendor/cakephp\n")
+            ->toContain("\n  - vendor/robmorgan/phinx\n");
     } finally {
         removeTypephpTestDirectory($directory);
     }
 });
 
-it('patches uninitialized scalar statics in coroutine sources into AOT sources', function (): void {
+it('flattens CakePHP function guards before converting its namespace', function (): void {
     $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
-    mkdir($directory, 0777, true);
-    createWebmanHelpersFixture(
-        $directory,
-        "<?php\nfunction base_path(\$path = ''): string\n{\n    return \$path;\n}\n",
-    );
-    $coroutineDirectory = $directory . DIRECTORY_SEPARATOR . 'vendor/workerman/coroutine/src';
-    mkdir($coroutineDirectory, 0777, true);
-    file_put_contents($coroutineDirectory . DIRECTORY_SEPARATOR . 'Context.php', <<<'PHP'
+    mkdir($directory . '/vendor/cakephp/core', 0777, true);
+    file_put_contents($directory . '/vendor/cakephp/core/functions.php', <<<'PHP'
         <?php
 
-        namespace Workerman\Coroutine;
+        if (!defined('DS')) {
+            /**
+             * Defines DS as short form of DIRECTORY_SEPARATOR.
+             */
+            define('DS', DIRECTORY_SEPARATOR);
+        }
 
-        use Workerman\Worker;
+        if (!defined('CAKE_DATE_RFC7231')) {
+            define('CAKE_DATE_RFC7231', 'D, d M Y H:i:s \G\M\T');
+        }
 
-        class Context implements ContextInterface
-        {
-            protected static string $driver;
+        namespace Cake\Core;
 
-            public static function initDriver(): void
+        if (!function_exists('Cake\Core\pathCombine')) {
+            function pathCombine(array $parts, ?bool $trailing = null): string
             {
-                static::$driver ??= match (Worker::$eventLoopClass) {
-                    default => Context\Fiber::class,
-                };
+                return implode(DS, $parts);
             }
         }
-        PHP);
-    file_put_contents($coroutineDirectory . DIRECTORY_SEPARATOR . 'WaitGroup.php', <<<'PHP'
-        <?php
-
-        namespace Workerman\Coroutine;
-
-        class WaitGroup
-        {
-            protected static string $driverClass;
 
-            public static function create(): void
+        if (!function_exists('Cake\Core\h')) {
+            function h(mixed $text): mixed
             {
-                static $id = 0;
-                static::$driverClass ??= 'Fiber';
+                return $text;
             }
         }
         PHP);
 
     try {
         $generator = new ProjectGenerator($directory);
-        $generated = $generator->generateNullableStaticSources();
-
-        expect($generated)->toBe(['.typephp/build/coroutine-context.php', '.typephp/build/coroutine-wait-group.php']);
-
-        // 未初始化标量静态属性补成可空 + 默认 null，??= 守卫主体保持原样
-        $context = (string) file_get_contents($directory . '/.typephp/build/coroutine-context.php');
-        expect($context)
-            ->toContain('protected static ?string $driver = null;')
-            ->toContain('static::$driver ??= match (Worker::$eventLoopClass)');
-        expect(str_contains($context, 'protected static string $driver;'))->toBeFalse();
+        $generated = $generator->generateFlattenedSources();
 
-        // 函数内局部 static 与已带默认值的属性不受补丁影响
-        $waitGroup = (string) file_get_contents($directory . '/.typephp/build/coroutine-wait-group.php');
-        expect($waitGroup)->toContain('protected static ?string $driverClass = null;')->toContain('static $id = 0;');
+        expect($generated)->toContain('.typephp/build/cakephp-core-functions.php');
 
-        // yml 在平铺源之后注入补丁源，并忽略 vendor 原版三个文件
-        $yml = (string) file_get_contents($generator->generateProjectYml([]));
-        expect($yml)
-            ->toContain(
-                "sources:\n  - main.php\n  - .typephp/build/helpers.php\n"
-                . "  - .typephp/build/coroutine-context.php\n  - .typephp/build/coroutine-wait-group.php\n",
-            )
-            ->toContain("\n  - vendor/workerman/coroutine/src/Context.php\n")
-            ->toContain("\n  - vendor/workerman/coroutine/src/WaitGroup.php\n")
-            ->toContain("\n  - vendor/workerman/coroutine/src/Barrier.php\n");
+        $flattened = (string) file_get_contents($directory . '/.typephp/build/cakephp-core-functions.php');
+        expect($flattened)
+            ->toContain("namespace {\nconst DS = DIRECTORY_SEPARATOR;")
+            ->toContain('namespace Cake\Core {')
+            ->toContain('function pathCombine(array $parts, ?bool $trailing = null): string')
+            ->toContain('function h(mixed $text): mixed')
+            ->not->toContain('function_exists');
     } finally {
         removeTypephpTestDirectory($directory);
     }
 });
 
-it('patches under-declared handler closures into variadic AOT sources', function (): void {
+it('discovers and flattens first-party plugin function guards', function (): void {
     $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
-    mkdir($directory, 0777, true);
-    createWebmanHelpersFixture(
-        $directory,
-        "<?php\nfunction base_path(\$path = ''): string\n{\n    return \$path;\n}\n",
-    );
-    $workermanSrc = $directory . '/vendor/workerman/workerman/src';
-    mkdir($workermanSrc . '/Connection', 0777, true);
-    mkdir($workermanSrc . '/Events', 0777, true);
-
-    $worker = <<<'PHP'
+    mkdir($directory . '/app', 0777, true);
+    mkdir($directory . '/plugin/example/app', 0777, true);
+    file_put_contents($directory . '/app/functions.php', <<<'PHP'
         <?php
-        namespace Workerman;
-        class Worker
-        {
-            protected function acceptTcpConnection($socket): void
-            {
-                set_error_handler(static fn (): bool => true);
-                $newSocket = stream_socket_accept($socket, 0, $remoteAddress);
-                restore_error_handler();
-            }
-            protected function listen(): void
+        if (!function_exists('application_id')) {
+            function application_id(): string
             {
-                set_error_handler(function ($code, $msg) {
-                    throw new RuntimeException($msg);
-                });
-                restore_error_handler();
-            }
-            public static function stopAll(): void
-            {
-                $workers = [];
-                array_walk($workers, static fn (Worker $worker) => $worker->stop(false));
-                $workerPidArray = [];
-                array_walk($workerPidArray, static fn ($pid) => posix_kill($pid, $sig));
-            }
-            protected static function installSignal(): void
-            {
-                $signal = 2;
-                pcntl_signal($signal, static::signalHandler(...), false);
-            }
-            public static function resetStd(): void
-            {
-                // 整块删除规则按字节匹配；下面关闭段的缩进与空行必须与真实 vendor Worker.php 一致，勿改
-                if (is_resource(STDOUT)) {
-                    fclose(STDOUT);
-                }
-
-                if (is_resource(STDERR)) {
-                    fclose(STDERR);
-                }
-
-                if (is_resource(static::$outputStream)) {
-                    fclose(static::$outputStream);
-                }
-
-                $stdOutStream = fopen(static::$stdoutFile, 'a');
+                return 'application';
             }
         }
-        PHP;
-    file_put_contents($workermanSrc . '/Worker.php', $worker);
-
-    $select = <<<'PHP'
+        PHP);
+    file_put_contents($directory . '/plugin/example/app/functions.php', <<<'PHP'
         <?php
-        namespace Workerman\Events;
-        class Select
-        {
-            public function onSignal(int $signal, callable $func): void
+        if (!function_exists('example_id')) {
+            function example_id(): string
             {
-                pcntl_signal($signal, fn () => $this->safeCall($this->signalEvents[$signal], [$signal]));
+                return 'example';
             }
         }
-        PHP;
-    file_put_contents($workermanSrc . '/Events/Select.php', $select);
+        PHP);
 
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->discoverProjectGuardedSources())->toBe([
+            'app/functions.php' => '.typephp/build/app-functions.php',
+            'plugin/example/app/functions.php' => '.typephp/build/example-functions.php',
+        ]);
+        expect($generator->generateFlattenedSources())->toBe([
+            '.typephp/build/app-functions.php',
+            '.typephp/build/example-functions.php',
+        ]);
+        expect(file_get_contents($directory . '/.typephp/build/app-functions.php'))
+            ->toContain('function application_id(): string')
+            ->not->toContain('function_exists');
+        expect(file_get_contents($directory . '/.typephp/build/example-functions.php'))
+            ->toContain('function example_id(): string')
+            ->not->toContain('function_exists');
+        expect(file_get_contents($generator->generateProjectYml(['include' => ['plugin/example/app']])))
+            ->toContain("  - .typephp/build/app-functions.php\n")
+            ->toContain("  - .typephp/build/example-functions.php\n")
+            ->toContain("  - app/functions.php\n")
+            ->toContain("  - plugin/example/app/functions.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('flattens IP2Region guards while keeping its database as a runtime resource', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/zoujingli/ip2region', 0777, true);
     file_put_contents(
-        $workermanSrc . '/Connection/TcpConnection.php',
-        "<?php\nnamespace Workerman\\Connection;\nclass TcpConnection\n{\n"
-        . "    public function enableSsl(): void\n    {\n"
-        . "        set_error_handler(static function (int \$code, string \$msg): bool {\n"
-        . "            return true;\n        });\n        restore_error_handler();\n    }\n}\n",
-    );
-    file_put_contents(
-        $workermanSrc . '/Connection/AsyncTcpConnection.php',
-        "<?php\nnamespace Workerman\\Connection;\nclass AsyncTcpConnection\n{\n"
-        . "    public function connect(): void\n    {\n"
-        . "        set_error_handler(fn() => false);\n"
-        . "        restore_error_handler();\n    }\n}\n",
+        $directory . '/vendor/zoujingli/ip2region/Ip2Region.php',
+        "<?php\nif (!class_exists('Ip2Region')) {\nclass Ip2Region {}\n}\n",
     );
     file_put_contents(
-        $directory . '/vendor/workerman/webman-framework/src/File.php',
-        "<?php\nnamespace Webman;\nclass File\n{\n"
-        . "    public function move(string \$destination): File\n    {\n"
-        . "        set_error_handler(function (\$type, \$msg) use (&\$error) {\n"
-        . "            \$error = \$msg;\n        });\n        restore_error_handler();\n        return \$this;\n    }\n}\n",
+        $directory . '/vendor/zoujingli/ip2region/function.php',
+        "<?php\nif (!class_exists('Ip2Region')) {\n"
+        . "    require_once __DIR__ . '/Ip2Region.php';\n}\n"
+        . "if (!function_exists('ip2region')) {\nfunction ip2region() { return new Ip2Region(); }\n}\n",
     );
+    file_put_contents($directory . '/vendor/zoujingli/ip2region/ip2region.xdb', 'xdb');
 
     try {
         $generator = new ProjectGenerator($directory);
-        $generated = $generator->generateVariadicHandlerSources();
+        $generated = $generator->generateFlattenedSources();
+        expect($generated)
+            ->toContain('.typephp/build/ip2region-class.php')
+            ->toContain('.typephp/build/ip2region-functions.php');
+        expect(file_get_contents($directory . '/.typephp/build/ip2region-class.php'))
+            ->toContain('class Ip2Region')
+            ->not->toContain('class_exists');
+        expect(file_get_contents($directory . '/.typephp/build/ip2region-functions.php'))
+            ->toContain('function ip2region()')
+            ->not->toContain('require_once')
+            ->not->toContain('function_exists');
+        expect($generator->generateRuntimeResourceList([
+            'vendor/zoujingli/ip2region/ip2region.xdb',
+        ]))
+            ->toBe('.typephp/build/runtime-resources.list');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
 
-        expect($generated)->toBe([
-            '.typephp/build/workerman-worker.php',
-            '.typephp/build/workerman-tcp-connection.php',
-            '.typephp/build/workerman-async-tcp-connection.php',
-            '.typephp/build/workerman-select.php',
-            '.typephp/build/webman-file.php',
+it('excludes installed Webman package installers and config templates', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/webman/cache/src/config', 0777, true);
+    mkdir($directory . '/vendor/webman/cache/demo', 0777, true);
+    mkdir($directory . '/vendor/webman/cache/tests', 0777, true);
+    file_put_contents($directory . '/vendor/webman/cache/src/Install.php', "<?php\nclass Install {}\n");
+    file_put_contents($directory . '/vendor/webman/cache/src/config/cache.php', "<?php\nreturn [];\n");
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->discoverWebmanVendorPackagingSources())->toBe([
+            'vendor/webman/cache/demo',
+            'vendor/webman/cache/src/Install.php',
+            'vendor/webman/cache/src/config',
+            'vendor/webman/cache/tests',
         ]);
+        expect(file_get_contents($generator->generateProjectYml(['include' => ['vendor']])))
+            ->toContain("  - vendor/webman/cache/src/Install.php\n")
+            ->toContain("  - vendor/webman/cache/src/config\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
 
-        // 零参/两参错误处理闭包与零参信号闭包均补成可变参数形态
-        $workerPatched = (string) file_get_contents($directory . '/.typephp/build/workerman-worker.php');
-        expect($workerPatched)
-            ->toContain('set_error_handler(static fn (...$__err): bool => true);')
-            ->toContain('set_error_handler(function ($code, $msg, ...$__err) {');
-        expect(str_contains($workerPatched, 'static fn (): bool => true'))->toBeFalse();
+it('excludes vendor IDE metadata from compilation', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/example/package/src', 0777, true);
+    file_put_contents($directory . '/vendor/example/package/.phpstorm.meta.php', "<?php\nnamespace PHPSTORM_META {}\n");
+    file_put_contents($directory . '/vendor/example/package/src/Runtime.php', "<?php\nclass Runtime {}\n");
 
-        // 停机/重载路径：array_walk 2 参(value,key)、master pcntl_signal 2 参(signo,siginfo) 均补成可变参数形态
-        expect($workerPatched)
-            ->toContain('array_walk($workers, static fn (Worker $worker, ...$__walk) => $worker->stop(false));')
-            ->toContain('array_walk($workerPidArray, static fn ($pid, ...$__walk) => posix_kill($pid, $sig));')
-            ->toContain('pcntl_signal($signal, static fn (...$__sig) => static::signalHandler($__sig[0]), false);');
-        expect(str_contains($workerPatched, 'array_walk($workers, static fn (Worker $worker) => $worker->stop(false));'))->toBeFalse();
-        expect(str_contains($workerPatched, 'pcntl_signal($signal, static::signalHandler(...), false);'))->toBeFalse();
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->discoverVendorIdeMetadata())->toBe([
+            'vendor/example/package/.phpstorm.meta.php',
+        ]);
+        expect(file_get_contents($generator->generateProjectYml(['include' => ['vendor']])))
+            ->toContain("  - vendor/example/package/.phpstorm.meta.php\n")
+            ->not->toContain("  - vendor/example/package/src/Runtime.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
 
-        // daemon 模式 resetStd()：TypePHP 标准流 NO_CLOSE 禁止关闭，三处 fclose 段被整块删除；
-        // 日志重定向（fopen stdoutFile → outputStream）保留，与 stock 行为一致
-        expect(str_contains($workerPatched, 'is_resource(STDOUT)'))->toBeFalse();
-        expect(str_contains($workerPatched, 'fclose(STDOUT);'))->toBeFalse();
-        expect(str_contains($workerPatched, 'is_resource(STDERR)'))->toBeFalse();
-        expect(str_contains($workerPatched, 'fclose(STDERR);'))->toBeFalse();
-        expect(str_contains($workerPatched, 'is_resource(static::$outputStream)'))->toBeFalse();
-        expect(str_contains($workerPatched, 'fclose(static::$outputStream);'))->toBeFalse();
-        expect($workerPatched)->toContain('$stdOutStream = fopen(static::$stdoutFile, \'a\');');
+it('replaces opcache preload hints with compiled AOT copies and rejects drift', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $source = $directory . '/vendor/symfony/cache-contracts/CacheTrait.php';
+    mkdir(dirname($source), 0777, true);
+    file_put_contents($source, "<?php\nclass_exists(InvalidArgumentException::class);\ntrait CacheTrait {}\n");
 
-        $selectPatched = (string) file_get_contents($directory . '/.typephp/build/workerman-select.php');
-        expect($selectPatched)->toContain('pcntl_signal($signal, fn (...$__sig) => $this->safeCall(');
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generatePreloadHintSources())->toBe([
+            '.typephp/build/symfony-cache-contracts-cache-trait.php',
+        ]);
+        expect(file_get_contents($directory . '/.typephp/build/symfony-cache-contracts-cache-trait.php'))
+            ->not
+            ->toContain('class_exists(')
+            ->toContain('trait CacheTrait');
 
-        $tcpPatched = (string) file_get_contents($directory . '/.typephp/build/workerman-tcp-connection.php');
-        expect($tcpPatched)->toContain('set_error_handler(static function (int $code, string $msg, ...$__err): bool {');
+        file_put_contents($source, "<?php\ntrait CacheTrait {}\n");
+        expect(fn() => $generator->generatePreloadHintSources())
+            ->toThrow(RuntimeException::class, 'expected 1 match(es), found 0');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
 
-        $asyncPatched = (string) file_get_contents($directory . '/.typephp/build/workerman-async-tcp-connection.php');
-        expect($asyncPatched)->toContain('set_error_handler(fn(...$__err) => false);');
+it('uses stable Symfony HttpKernel event variable types for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $source = $directory . '/vendor/symfony/http-kernel/HttpKernel.php';
+    mkdir(dirname($source), 0777, true);
+    $preloads = implode("\n", array_fill(0, 9, 'class_exists(PreloadedClass::class);'));
+    file_put_contents($source, "<?php\n{$preloads}\n" . <<<'PHP'
+        class HttpKernel
+        {
+            private function handleRaw($request, $type)
+            {
+                $event = new RequestEvent($this, $request, $type);
+                $this->dispatcher->dispatch($event, KernelEvents::REQUEST);
 
-        $filePatched = (string) file_get_contents($directory . '/.typephp/build/webman-file.php');
-        expect($filePatched)->toContain('set_error_handler(function ($type, $msg, ...$__err) use (&$error) {');
+                if ($event->hasResponse()) {
+                    return $this->filterResponse($event->getResponse(), $request, $type);
+                }
 
-        // yml 注入全部补丁源，并忽略 vendor 原版文件
-        $yml = (string) file_get_contents($generator->generateProjectYml([]));
-        expect($yml)
-            ->toContain('  - .typephp/build/workerman-worker.php' . "\n")
-            ->toContain('  - .typephp/build/workerman-select.php' . "\n")
-            ->toContain("\n  - vendor/workerman/workerman/src/Worker.php\n")
-            ->toContain("\n  - vendor/workerman/workerman/src/Events/Select.php\n")
-            ->toContain("\n  - vendor/workerman/webman-framework/src/File.php\n");
+                $event = new ControllerEvent($this, $controller, $request, $type);
+                $this->dispatcher->dispatch($event, KernelEvents::CONTROLLER);
+                $controller = $event->getController();
+
+                // controller arguments
+                $arguments = $this->argumentResolver->getArguments($request, $controller, $event->getControllerReflector());
+
+                $event = new ControllerArgumentsEvent($this, $event, $arguments, $request, $type);
+                $this->dispatcher->dispatch($event, KernelEvents::CONTROLLER_ARGUMENTS);
+                $controller = $event->getController();
+                $arguments = $event->getArguments();
+
+                if (!$response instanceof Response) {
+                    $event = new ViewEvent($this, $request, $type, $response, $event);
+                    $this->dispatcher->dispatch($event, KernelEvents::VIEW);
+
+                    if ($event->hasResponse()) {
+                        $response = $event->getResponse();
+                    }
+                }
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generatePreloadHintSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/symfony-http-kernel.php');
+        expect($generated)
+            ->toContain('$requestEvent = new RequestEvent')
+            ->toContain('$controllerEvent = new ControllerEvent')
+            ->toContain('$controllerArgumentsEvent = new ControllerArgumentsEvent')
+            ->toContain('$viewEvent = new ViewEvent')
+            ->not->toContain('$event =');
     } finally {
         removeTypephpTestDirectory($directory);
     }
 });
 
-it('strips stray top-level bootstrap calls into AOT sources', function (): void {
+it('bridges Symfony native session bags without referencing the session superglobal for AOT', function (): void {
     $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
-    mkdir($directory, 0777, true);
+    $source = $directory . '/vendor/symfony/http-foundation/Session/Storage/NativeSessionStorage.php';
+    mkdir(dirname($source), 0777, true);
+    file_put_contents($source, <<<'PHP'
+        <?php
+        class_exists(SessionBagInterface::class);
+        class_exists(MetadataBag::class);
+        class_exists(AbstractProxy::class);
+        class NativeSessionStorage
+        {
+            protected function loadSession(?array &$session = null): void
+            {
+                if (null === $session) {
+                    $session = &$_SESSION;
+                }
 
-    $httpDirectory = $directory . '/vendor/workerman/workerman/src/Protocols/Http';
-    mkdir($httpDirectory . '/Session', 0777, true);
-    $coroutineDirectory = $directory . '/vendor/workerman/coroutine/src';
-    mkdir($coroutineDirectory . '/Context', 0777, true);
-    mkdir($coroutineDirectory . '/Coroutine', 0777, true);
+                foreach ($this->bags as $bag) {
+                    $key = $bag->getStorageKey();
+                    $session[$key] = isset($session[$key]) && \is_array($session[$key]) ? $session[$key] : [];
+                    $bag->initialize($session[$key]);
+                }
 
-    // 顶层引导调用（workerman/coroutine 与 workerman 的模块初始化写法）
-    file_put_contents(
-        $httpDirectory . '/Session.php',
-        "<?php\nnamespace Workerman\\Protocols\\Http;\nclass Session\n{\n"
-        . "    public static function init(): void\n    {\n    }\n}\n\n// Init session handler\nSession::init();\n",
-    );
-    file_put_contents(
-        $httpDirectory . '/Session/FileSessionHandler.php',
-        "<?php\nnamespace Workerman\\Protocols\\Http\\Session;\nclass FileSessionHandler\n{\n"
-        . "    public static function init(): void\n    {\n    }\n}\n\nFileSessionHandler::init();\n",
-    );
-    file_put_contents(
-        $coroutineDirectory . '/Context/Fiber.php',
-        "<?php\nnamespace Workerman\\Coroutine\\Context;\nclass Fiber\n{\n"
-        . "    public static function initContext(): void\n    {\n    }\n}\n\nFiber::initContext();\n",
-    );
-    file_put_contents(
-        $coroutineDirectory . '/Coroutine/Fiber.php',
-        "<?php\nnamespace Workerman\\Coroutine\\Coroutine;\nclass Fiber\n{\n"
-        . "    public static function init(): void\n    {\n    }\n}\n\nFiber::init();\n",
-    );
+                $this->started = true;
+                $this->closed = false;
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generatePreloadHintSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/symfony-native-session-storage.php');
+        expect($generated)
+            ->toContain('protected function loadSession(mixed $session = null): void')
+            ->toContain('$session = $_SESSION;')
+            ->toContain('$_SESSION = $session;')
+            ->not->toContain('$session = &$_SESSION;');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('uses dynamic reference storage for Symfony session bag initialization in AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $fixtures = [
+        'Session/Attribute/AttributeBag.php' => ['attributes', 'symfony-session-attribute-bag.php'],
+        'Session/Flash/FlashBag.php' => ['flashes', 'symfony-session-flash-bag.php'],
+        'Session/Flash/AutoExpireFlashBag.php' => ['flashes', 'symfony-session-auto-expire-flash-bag.php'],
+        'Session/SessionBagProxy.php' => ['array', 'symfony-session-bag-proxy.php'],
+    ];
+    foreach ($fixtures as $relative => [$parameter, $target]) {
+        $source = $directory . '/vendor/symfony/http-foundation/' . $relative;
+        if (!is_dir(dirname($source))) {
+            mkdir(dirname($source), 0777, true);
+        }
+        file_put_contents(
+            $source,
+            "<?php\nclass SessionBag\n{\n"
+            . (
+                $relative === 'Session/SessionBagProxy.php'
+                    ? "    public function __construct(\n"
+                    . "        array &\$data,\n"
+                    . "        ?int &\$usageIndex,\n"
+                    . "    ) {}\n"
+                    : ''
+            )
+            . "    public function initialize(array &\${$parameter}): void\n"
+            . "    {\n        \$this->data = &\${$parameter};\n    }\n}\n",
+        );
+    }
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        foreach ($fixtures as [$parameter, $target]) {
+            $generated = (string) file_get_contents($directory . '/.typephp/build/' . $target);
+            expect($generated)->toContain("function initialize(mixed &\${$parameter}): void");
+            if ($target === 'symfony-session-bag-proxy.php') {
+                expect($generated)->toContain('mixed &$data,')->toContain('mixed &$usageIndex,');
+            }
+        }
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('prefers project support Request and Response overrides over framework defaults', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/support', 0777, true);
+    mkdir($directory . '/vendor/workerman/webman-framework/src/support', 0777, true);
+    file_put_contents($directory . '/support/Request.php', "<?php\nnamespace support;\nclass Request {}\n");
     file_put_contents(
-        $coroutineDirectory . '/Coroutine.php',
-        "<?php\nnamespace Workerman\\Coroutine;\nclass Coroutine\n{\n"
-        . "    public static function init(): void\n    {\n    }\n}\n\nCoroutine::init();\n",
+        $directory . '/vendor/workerman/webman-framework/src/support/Request.php',
+        "<?php\nnamespace support;\nclass Request {}\n",
     );
-    // 回归用例：静态属性补丁源同样必须剥掉尾部顶层引导调用，否则 AOT 扫描期报 stray code Fatal
     file_put_contents(
-        $coroutineDirectory . '/Context.php',
-        "<?php\nnamespace Workerman\\Coroutine;\nclass Context\n{\n"
-        . "    protected static string \$driver;\n\n"
-        . "    public static function initDriver(): void\n    {\n        static::\$driver ??= 'Fiber';\n    }\n}\n\nContext::initDriver();\n",
+        $directory . '/vendor/workerman/webman-framework/src/support/Response.php',
+        "<?php\nnamespace support;\nclass Response {}\n",
     );
 
     try {
         $generator = new ProjectGenerator($directory);
-        expect($generator->generateStrayBootstrapSources())->toBe([
-            '.typephp/build/http-session.php',
-            '.typephp/build/http-session-file-handler.php',
-            '.typephp/build/coroutine-context-fiber.php',
-            '.typephp/build/coroutine-fiber.php',
-            '.typephp/build/coroutine-coroutine.php',
+        expect($generator->discoverFrameworkSupportOverrides())->toBe([
+            'vendor/workerman/webman-framework/src/support/Request.php',
         ]);
+        expect(file_get_contents($generator->generateProjectYml(['include' => ['support', 'vendor']])))
+            ->toContain("  - vendor/workerman/webman-framework/src/support/Request.php\n")
+            ->not->toContain("  - vendor/workerman/webman-framework/src/support/Response.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
 
-        // 每个剥离后的 AOT 源以类结束大括号收尾，紧邻引导调用的注释行一并移除；init 方法体保持原样
-        foreach (ProjectGenerator::STRAY_BOOTSTRAP_SOURCES as $target) {
-            $content = rtrim((string) file_get_contents($directory . '/' . $target));
-            expect(str_ends_with($content, '}'))->toBeTrue();
+it('selects the PHP 8.4 intl polyfill declarations for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/polyfill-intl-grapheme';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/bootstrap80.php', <<<'PHP'
+        <?php
+        use Symfony\Polyfill\Intl\Grapheme as p;
+        if (extension_loaded('intl')) {
+            return;
         }
-        $session = (string) file_get_contents($directory . '/.typephp/build/http-session.php');
-        expect(str_contains($session, '// Init session handler'))->toBeFalse();
-        expect($session)->toContain("class Session\n{\n    public static function init(): void");
-
-        expect($generator->generateNullableStaticSources())->toBe(['.typephp/build/coroutine-context.php']);
-
-        // 回归：静态属性补丁与顶层引导剥离在同一产物上串联生效
-        $context = (string) file_get_contents($directory . '/.typephp/build/coroutine-context.php');
-        expect($context)
-            ->toContain('protected static ?string $driver = null;')
-            ->toContain("static::\$driver ??= 'Fiber';");
-        expect(str_contains($context, 'Context::initDriver();'))->toBeFalse();
+        if (!defined('GRAPHEME_EXTR_COUNT')) {
+            define('GRAPHEME_EXTR_COUNT', 0);
+        }
+        if (!defined('GRAPHEME_EXTR_MAXBYTES')) {
+            define('GRAPHEME_EXTR_MAXBYTES', 1);
+        }
+        if (!defined('GRAPHEME_EXTR_MAXCHARS')) {
+            define('GRAPHEME_EXTR_MAXCHARS', 2);
+        }
+        if (\PHP_VERSION_ID >= 80500) {
+            return require __DIR__.'/bootstrap85.php';
+        }
+        if (!function_exists('grapheme_strlen')) {
+            function grapheme_strlen(?string $string): int|false|null { return p\Grapheme::grapheme_strlen((string) $string); }
+        }
+        PHP);
+    $idnDirectory = $directory . '/vendor/symfony/polyfill-intl-idn';
+    mkdir($idnDirectory, 0777, true);
+    file_put_contents($idnDirectory . '/bootstrap80.php', <<<'PHP'
+        <?php
+        use Symfony\Polyfill\Intl\Idn as p;
+        if (!defined('IDNA_DEFAULT')) {
+            define('IDNA_DEFAULT', 0);
+        }
+        if (!defined('INTL_IDNA_VARIANT_UTS46')) {
+            define('INTL_IDNA_VARIANT_UTS46', 1);
+        }
+        if (!function_exists('idn_to_ascii')) {
+            function idn_to_ascii(?string $domain, ?int $flags = IDNA_DEFAULT): string|false { return p\Idn::idn_to_ascii((string) $domain, (int) $flags); }
+        }
+        PHP);
+    $normalizerDirectory = $directory . '/vendor/symfony/polyfill-intl-normalizer';
+    mkdir($normalizerDirectory, 0777, true);
+    file_put_contents($normalizerDirectory . '/bootstrap80.php', <<<'PHP'
+        <?php
+        use Symfony\Polyfill\Intl\Normalizer as p;
+        if (!function_exists('normalizer_is_normalized')) {
+            function normalizer_is_normalized(?string $string, ?int $form = p\Normalizer::FORM_C): bool { return p\Normalizer::isNormalized((string) $string, (int) $form); }
+        }
+        if (!function_exists('normalizer_normalize')) {
+            function normalizer_normalize(?string $string, ?int $form = p\Normalizer::FORM_C): string|false { return p\Normalizer::normalize((string) $string, (int) $form); }
+        }
+        PHP);
 
-        // yml 注入剥离源并忽略 vendor 原版
-        $yml = (string) file_get_contents($generator->generateProjectYml([]));
-        expect($yml)
-            ->toContain('  - .typephp/build/http-session.php' . "\n")
-            ->toContain('  - .typephp/build/coroutine-coroutine.php' . "\n")
-            ->toContain("\n  - vendor/workerman/workerman/src/Protocols/Http/Session.php\n")
-            ->toContain("\n  - vendor/workerman/coroutine/src/Context/Fiber.php\n")
-            ->toContain("\n  - vendor/workerman/coroutine/src/Coroutine.php\n");
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateFlattenedSources())->toBe([
+            '.typephp/build/symfony-grapheme-functions.php',
+            '.typephp/build/symfony-idn-functions.php',
+            '.typephp/build/symfony-normalizer-functions.php',
+        ]);
+        $flattened = (string) file_get_contents($directory . '/.typephp/build/symfony-grapheme-functions.php');
+        expect($flattened)
+            ->toContain('const GRAPHEME_EXTR_COUNT = 0;')
+            ->toContain('function grapheme_strlen(?string $string): int|false|null');
+        expect(str_contains($flattened, 'extension_loaded'))
+            ->toBeFalse()
+            ->and(str_contains($flattened, 'PHP_VERSION_ID'))
+            ->toBeFalse()
+            ->and(str_contains($flattened, 'function_exists'))
+            ->toBeFalse();
+        $idn = (string) file_get_contents($directory . '/.typephp/build/symfony-idn-functions.php');
+        expect($idn)->toContain('const IDNA_DEFAULT = 0;')->toContain('function idn_to_ascii(?string $domain');
+        expect(str_contains($idn, 'defined('))->toBeFalse()->and(str_contains($idn, 'function_exists'))->toBeFalse();
+        $normalizer = (string) file_get_contents($directory . '/.typephp/build/symfony-normalizer-functions.php');
+        expect($normalizer)
+            ->toContain('function normalizer_is_normalized(?string $string')
+            ->toContain('function normalizer_normalize(?string $string');
+        expect(str_contains($normalizer, 'function_exists'))->toBeFalse();
     } finally {
         removeTypephpTestDirectory($directory);
     }
 });
 
-it('rewrites fall-through switch cases into terminal AOT sources', function (): void {
+it('declares the Symfony Grapheme cluster expression without top-level execution', function (): void {
     $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
-    mkdir($directory, 0777, true);
-    mkdir($directory . '/vendor/workerman/webman-framework/src', 0777, true);
-    mkdir($directory . '/vendor/monolog/monolog/src/Monolog', 0777, true);
-
+    $sourceDirectory = $directory . '/vendor/symfony/polyfill-intl-grapheme';
+    mkdir($sourceDirectory, 0777, true);
+    $definition =
+        "\\define('SYMFONY_GRAPHEME_CLUSTER_RX', ((float) \\PCRE_VERSION >= 10.44) "
+        . "? '\\X' : Grapheme::GRAPHEME_CLUSTER_RX);";
     file_put_contents(
-        $directory . '/vendor/workerman/webman-framework/src/App.php',
-        implode("\n", [
-            '<?php',
-            'namespace Webman;',
-            'class App',
-            '{',
-            '    public static function getReflector(callable|string $call, ?string $cacheKey): mixed',
-            '    {',
-            "        if (\$call instanceof Closure || is_string(\$call)) {",
-            '            $reflector = new ReflectionFunction($call);',
-            '        } else {',
-            '            $reflector = new ReflectionMethod($call[0], $call[1]);',
-            '        }',
-            '',
-            '        if ($cacheKey !== null) {',
-            '            static::$reflectorCache[$cacheKey] = $reflector;',
-            '            if (count(static::$reflectorCache) > 1024) {',
-            '                unset(static::$reflectorCache[key(static::$reflectorCache)]);',
-            '            }',
-            '        }',
-            '',
-            '        return $reflector;',
-            '    }',
-            "    public static function stringify(mixed \$data): string",
-            '    {',
-            "        switch (gettype(\$data)) {",
-            "            case 'object':",
-            "                if (!method_exists(\$data, '__toString')) {",
-            "                    return 'Object';",
-            '                }',
-            '            default:',
-            '                return (string)$data;',
-            '        }',
-            '    }',
-            '}',
-            '',
-        ]),
-    );
-    file_put_contents(
-        $directory . '/vendor/monolog/monolog/src/Monolog/Utils.php',
-        implode("\n", [
-            '<?php',
-            'namespace Monolog;',
-            'class Utils',
-            '{',
-            "    public static function throwJsonError(int \$code): void",
-            '    {',
-            '        switch ($code) {',
-            "            case 8:",
-            "                \$msg = 'Syntax error, malformed JSON';",
-            '                break;',
-            '            default:',
-            "                \$msg = 'Unknown error';",
-            '        }',
-            '    }',
-            '    public static function parseBytes(string $value): ?int',
-            '    {',
-            "        \$val = (int) \$value;",
-            '        switch (strtolower(substr($value, -1))) {',
-            "            case 'g':",
-            '                $val *= 1024;',
-            "            case 'm':",
-            '                $val *= 1024;',
-            "            case 'k':",
-            '                $val *= 1024;',
-            '        }',
-            '        return $val;',
-            '    }',
-            '}',
-            '',
-        ]),
+        $sourceDirectory . '/Grapheme.php',
+        "<?php\nnamespace Symfony\\Polyfill\\Intl\\Grapheme;\n{$definition}\n"
+        . "final class Grapheme { public const GRAPHEME_CLUSTER_RX = 'fallback'; }\n",
     );
 
     try {
         $generator = new ProjectGenerator($directory);
-        expect($generator->generateSwitchTerminalSources())->toBe([
-            '.typephp/build/webman-app.php',
-            '.typephp/build/monolog-utils.php',
-        ]);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/symfony-grapheme.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/symfony-grapheme.php');
+        expect($source)
+            ->toContain('const SYMFONY_GRAPHEME_CLUSTER_RX = Grapheme::GRAPHEME_CLUSTER_RX;')
+            ->not->toContain('\\define(');
 
-        // 同一变量跨 ReflectionFunction/ReflectionMethod 重赋值改为分支内独立变量 + 提前 return
-        $app = (string) file_get_contents($directory . '/.typephp/build/webman-app.php');
-        expect($app)
-            ->toContain('$reflectorFunction = new ReflectionFunction($call);')
-            ->toContain('$reflectorMethod = new ReflectionMethod($call[0], $call[1]);')
-            ->toContain('return $reflectorMethod;');
-        expect(str_contains($app, '$reflector = new Reflection'))->toBeFalse();
+        file_put_contents(
+            $sourceDirectory . '/Grapheme.php',
+            "<?php\nnamespace Symfony\\Polyfill\\Intl\\Grapheme;\nfinal class Grapheme {}\n",
+        );
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'compatibility rule expected 1 match(es), found 0: '
+                . 'vendor/symfony/polyfill-intl-grapheme/Grapheme.php',
+            );
 
-        // case 'object' 不再落空到 default，自带终结 return
-        expect($app)->toContain("}\n                return (string)\$data;\n            default:");
+        file_put_contents(
+            $sourceDirectory . '/Grapheme.php',
+            "<?php\nnamespace Symfony\\Polyfill\\Intl\\Grapheme;\n{$definition}\n{$definition}\n"
+            . "final class Grapheme { public const GRAPHEME_CLUSTER_RX = 'fallback'; }\n",
+        );
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'compatibility rule expected 1 match(es), found 2: '
+                . 'vendor/symfony/polyfill-intl-grapheme/Grapheme.php',
+            );
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
 
-        $utils = (string) file_get_contents($directory . '/.typephp/build/monolog-utils.php');
-        expect($utils)->toContain("\$msg = 'Unknown error';\n                break;\n        }");
+it('skips host-provided guarded polyfills for native compilation', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/polyfill-intl-grapheme';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($directory . '/main.php', "<?php\nfunction main(): void {}\n");
+    file_put_contents($sourceDirectory . '/bootstrap80.php', "<?php\nfunction grapheme_str_split() {}\n");
 
-        // g/m/k 级联落空展开为各 case 独立连乘，总量不变
-        expect($utils)->toContain(
-            "case 'g':\n                \$val *= 1024;\n                \$val *= 1024;\n                \$val *= 1024;\n                break;",
-        );
-        expect($utils)->toContain(
-            "case 'm':\n                \$val *= 1024;\n                \$val *= 1024;\n                break;",
-        );
-        expect($utils)->toContain("case 'k':\n                \$val *= 1024;\n                break;");
+    try {
+        $generator = new ProjectGenerator($directory);
+        $yml = (string) file_get_contents($generator->generateProjectYml([
+            'include' => ['main.php'],
+            'build' => [
+                'skip_guarded_sources' => [
+                    'vendor/symfony/polyfill-intl-grapheme/bootstrap80.php',
+                ],
+            ],
+        ], 'project.native.yml'));
 
-        $yml = (string) file_get_contents($generator->generateProjectYml([]));
         expect($yml)
-            ->toContain('  - .typephp/build/webman-app.php' . "\n")
-            ->toContain('  - .typephp/build/monolog-utils.php' . "\n")
-            ->toContain("\n  - vendor/workerman/webman-framework/src/App.php\n")
-            ->toContain("\n  - vendor/monolog/monolog/src/Monolog/Utils.php\n");
+            ->not
+            ->toContain('.typephp/build/symfony-grapheme-functions.php')
+            ->toContain('vendor/symfony/polyfill-intl-grapheme/bootstrap80.php');
+        expect(is_file($directory . '/.typephp/build/symfony-grapheme-functions.php'))->toBeFalse();
     } finally {
         removeTypephpTestDirectory($directory);
     }
 });
 
-it('rewrites typed-reference captures into AOT sources', function (): void {
+it('rejects unknown guarded source skips', function (): void {
     $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
     mkdir($directory, 0777, true);
-    mkdir($directory . '/vendor/workerman/webman-framework/src/Route', 0777, true);
-    $coroutineDirectory = $directory . '/vendor/workerman/coroutine/src';
-    mkdir($coroutineDirectory . '/Barrier', 0777, true);
-    mkdir($coroutineDirectory . '/Channel', 0777, true);
-
-    // 真实 vendor 的 Route.php 与协程驱动文件为 CRLF，补丁字面量按 CRLF 匹配
-    file_put_contents(
-        $directory . '/vendor/workerman/webman-framework/src/Route/Route.php',
-        implode("\r\n", [
-            '<?php',
-            'namespace Webman\Route;',
-            'class Route',
-            '{',
-            '    public function url(array $parameters = []): string',
-            '    {',
-            '        $path = $this->path;',
-            "        \$path = preg_replace_callback('/\\{(.*?)(?:\\:[^\\}]*?)*?\\}/', function (\$matches) use (&\$parameters) {",
-            '            if (!$parameters) {',
-            '                return $matches[0];',
-            '            }',
-            '            if (isset($parameters[$matches[1]])) {',
-            '                $value = $parameters[$matches[1]];',
-            '                unset($parameters[$matches[1]]);',
-            '                return $value;',
-            '            }',
-            '            $key = key($parameters);',
-            '            if (is_int($key)) {',
-            '                $value = $parameters[$key];',
-            '                unset($parameters[$key]);',
-            '                return $value;',
-            '            }',
-            '            return $matches[0];',
-            '        }, $path);',
-            "        return count(\$parameters) > 0 ? \$path . '?' . http_build_query(\$parameters) : \$path;",
-            '    }',
-            '}',
-            '',
-        ]),
-    );
-    file_put_contents(
-        $coroutineDirectory . '/Barrier/Fiber.php',
-        implode("\r\n", [
-            '<?php',
-            'namespace Workerman\Coroutine\Barrier;',
-            'class Fiber',
-            '{',
-            '    public static function wait(array $dependencies, float $timeout): bool',
-            '    {',
-            '        $resumed = false;',
-            '        $timerId = null;',
-            '        $coroutine = 1;',
-            '        if ($timeout > 0) {',
-            '            function() use ($coroutine, &$resumed, &$timerId) {',
-            '                $timerId = 2;',
-            '            };',
-            '        }',
-            '        return $resumed;',
-            '    }',
-            '}',
-            '',
-        ]),
-    );
-    file_put_contents(
-        $coroutineDirectory . '/Channel/Fiber.php',
-        implode("\r\n", [
-            '<?php',
-            'namespace Workerman\Coroutine\Channel;',
-            'class Fiber',
-            '{',
-            '    public function push($value, float $timeout = -1): bool',
-            '    {',
-            "        if (\$timeout > 0) {",
-            '            $timedOut = false;',
-            '            $timerId = null;',
-            '            function() use (&$timedOut) {',
-            '                $timedOut = true;',
-            '            };',
-            '        }',
-            '        return true;',
-            '    }',
-            '}',
-            '',
-        ]),
-    );
 
     try {
-        $generator = new ProjectGenerator($directory);
-        expect($generator->generateRefCaptureSources())->toBe([
-            '.typephp/build/webman-route.php',
-            '.typephp/build/coroutine-barrier-fiber.php',
-            '.typephp/build/coroutine-channel-fiber.php',
-        ]);
-
-        // array 参数改为按值捕获 + 捕获未初始化的引用槽
-        $route = (string) file_get_contents($directory . '/.typephp/build/webman-route.php');
-        expect($route)->toContain('function ($matches) use ($parameters, &$remaining) {');
-        expect(str_contains($route, 'use (&$parameters)'))->toBeFalse();
-
-        // 被引用捕获的 $resumed 去掉初始化即为 REF 槽；只读的 $timerId 改为按值捕获
-        $barrier = (string) file_get_contents($directory . '/.typephp/build/coroutine-barrier-fiber.php');
-        expect($barrier)->toContain('function() use ($coroutine, &$resumed, $timerId) {');
-        expect(str_contains($barrier, '$resumed = false;'))->toBeFalse();
-        expect($barrier)->toContain('        $timerId = null;');
+        expect(fn() => new ProjectGenerator($directory)->generateProjectYml([
+            'build' => ['skip_guarded_sources' => ['vendor/unknown/bootstrap.php']],
+        ], 'project.native.yml'))
+            ->toThrow(RuntimeException::class, 'Unknown guarded source skip');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
 
-        $channel = (string) file_get_contents($directory . '/.typephp/build/coroutine-channel-fiber.php');
-        expect(str_contains($channel, '$timedOut = false;'))->toBeFalse();
-        expect($channel)->toContain('            $timerId = null;');
+it('selects the PHP 8.4 branch of the PHP 8.5 polyfill for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $php85Directory = $directory . '/vendor/symfony/polyfill-php85';
+    mkdir($php85Directory . '/Resources/stubs/Filter', 0777, true);
+    file_put_contents($php85Directory . '/bootstrap.php', <<<'PHP'
+        <?php
+        use Symfony\Polyfill\Php85 as p;
+        if (\PHP_VERSION_ID >= 80500) {
+            return;
+        }
+        if (!function_exists('get_error_handler')) {
+            function get_error_handler(): ?callable { return p\Php85::get_error_handler(); }
+        }
+        if (!function_exists('get_exception_handler')) {
+            function get_exception_handler(): ?callable { return p\Php85::get_exception_handler(); }
+        }
+        if (!function_exists('array_first')) {
+            function array_first(array $array) { return p\Php85::array_first($array); }
+        }
+        if (!function_exists('array_last')) {
+            function array_last(array $array) { return p\Php85::array_last($array); }
+        }
+        if (extension_loaded('intl') && !function_exists('locale_is_right_to_left')) {
+            function locale_is_right_to_left(string $locale): bool { return p\Php85::locale_is_right_to_left($locale); }
+        }
+        if (\PHP_VERSION_ID >= 80000) {
+            require __DIR__.'/bootstrap80.php';
+
+            return;
+        }
+        if (!class_exists('ValueError', false)) {
+            class ValueError extends Error {}
+        }
+        if (extension_loaded('intl') && !function_exists('grapheme_levenshtein')) {
+            function grapheme_levenshtein(string $first, string $second) { return false; }
+        }
+        PHP);
+    $stubs = [
+        'DelayedTargetValidation.php' => <<<'PHP'
+            <?php
+            if (\PHP_VERSION_ID < 80500) {
+                #[Attribute(Attribute::TARGET_ALL)]
+                final class DelayedTargetValidation {}
+            }
+            PHP,
+        'NoDiscard.php' => <<<'PHP'
+            <?php
+            if (\PHP_VERSION_ID < 80500) {
+                #[Attribute(Attribute::TARGET_METHOD)]
+                final class NoDiscard {}
+            }
+            PHP,
+        'Filter/FilterException.php' => <<<'PHP'
+            <?php
+            namespace Filter;
+            if (\PHP_VERSION_ID < 80500) {
+                class FilterException extends \Exception {}
+            }
+            PHP,
+        'Filter/FilterFailedException.php' => <<<'PHP'
+            <?php
+            namespace Filter;
+            if (\PHP_VERSION_ID < 80500) {
+                class FilterFailedException extends FilterException {}
+            }
+            PHP,
+    ];
+    foreach ($stubs as $path => $content) {
+        file_put_contents($php85Directory . '/Resources/stubs/' . $path, $content);
+    }
+
+    try {
+        $generated = new ProjectGenerator($directory)->generateFlattenedSources();
+        expect($generated)->toBe([
+            '.typephp/build/symfony-php85-functions.php',
+            '.typephp/build/php85-delayed-target-validation.php',
+            '.typephp/build/php85-no-discard.php',
+            '.typephp/build/php85-filter-exception.php',
+            '.typephp/build/php85-filter-failed-exception.php',
+        ]);
+        $functions = (string) file_get_contents($directory . '/.typephp/build/symfony-php85-functions.php');
+        foreach (['get_error_handler', 'get_exception_handler', 'array_first', 'array_last'] as $function) {
+            expect($functions)->toContain("function {$function}(");
+        }
+        foreach ([
+            'function_exists',
+            'PHP_VERSION_ID',
+            'extension_loaded',
+            'locale_is_right_to_left',
+            'ValueError',
+        ] as $absent) {
+            expect(str_contains($functions, $absent))->toBeFalse();
+        }
+        foreach (array_values(array_slice(ProjectGenerator::GUARDED_SOURCES, -4)) as $target) {
+            $stub = (string) file_get_contents($directory . '/' . $target);
+            expect(str_contains($stub, 'PHP_VERSION_ID'))->toBeFalse();
+        }
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('replaces the known Guzzle files wrapper with its declaration source', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $guzzleDirectory = $directory . '/vendor/guzzlehttp/guzzle/src';
+    mkdir($guzzleDirectory, 0777, true);
+    file_put_contents(
+        $guzzleDirectory . '/functions_include.php',
+        "<?php\n// loader\nif (!\\function_exists('GuzzleHttp\\describe_type')) {\n"
+        . "    require __DIR__.'/functions.php';\n}\n",
+    );
+    file_put_contents(
+        $guzzleDirectory . '/functions.php',
+        "<?php\nnamespace GuzzleHttp;\nfunction describe_type(\$value): string { return get_debug_type(\$value); }\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $yml = (string) file_get_contents($generator->generateProjectYml(['include' => ['vendor']]));
+        expect(substr_count($yml, "  - vendor/guzzlehttp/guzzle/src/functions.php\n"))->toBe(0);
+        expect($yml)->toContain("\n  - vendor/guzzlehttp/guzzle/src/functions_include.php\n");
+        $defaultYml = (string) file_get_contents($generator->generateProjectYml([]));
+        expect(substr_count($defaultYml, "  - vendor/guzzlehttp/guzzle/src/functions.php\n"))->toBe(1);
+        expect($yml)->toContain("\n  - support/bootstrap.php\n");
+        foreach (['app/model', 'app/command', 'app/functions.php', 'support'] as $path) {
+            expect(str_contains($yml, "\n  - {$path}\n"))->toBeFalse();
+        }
+        expect($yml)->toContain("\n  - app/process/Monitor.php\n");
+
+        file_put_contents(
+            $guzzleDirectory . '/functions_include.php',
+            "<?php\nif (!\\function_exists('GuzzleHttp\\describe_type')) { require \$dynamic; }\n",
+        );
+        expect(fn() => $generator->generateProjectYml(['include' => ['vendor']]))
+            ->toThrow(RuntimeException::class, 'Unsupported static loader wrapper');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('patches uninitialized scalar statics in coroutine sources into AOT sources', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory, 0777, true);
+    createWebmanHelpersFixture(
+        $directory,
+        "<?php\nfunction base_path(\$path = ''): string\n{\n    return \$path;\n}\n",
+    );
+    $coroutineDirectory = $directory . DIRECTORY_SEPARATOR . 'vendor/workerman/coroutine/src';
+    mkdir($coroutineDirectory, 0777, true);
+    file_put_contents($coroutineDirectory . DIRECTORY_SEPARATOR . 'Context.php', <<<'PHP'
+        <?php
+
+        namespace Workerman\Coroutine;
+
+        use Workerman\Worker;
 
+        class Context implements ContextInterface
+        {
+            protected static string $driver;
+
+            public static function initDriver(): void
+            {
+                static::$driver ??= match (Worker::$eventLoopClass) {
+                    default => Context\Fiber::class,
+                };
+            }
+        }
+        PHP);
+    file_put_contents($coroutineDirectory . DIRECTORY_SEPARATOR . 'WaitGroup.php', <<<'PHP'
+        <?php
+
+        namespace Workerman\Coroutine;
+
+        class WaitGroup
+        {
+            protected static string $driverClass;
+
+            public static function create(): void
+            {
+                static $id = 0;
+                static::$driverClass ??= 'Fiber';
+            }
+        }
+        PHP);
+    mkdir($coroutineDirectory . DIRECTORY_SEPARATOR . 'Barrier', 0777, true);
+    file_put_contents($coroutineDirectory . DIRECTORY_SEPARATOR . 'Barrier.php', <<<'PHP'
+        <?php
+        class Barrier
+        {
+            protected static string $driver;
+            public static function wait(object &$barrier, int $timeout = -1): void {}
+        }
+        PHP);
+    file_put_contents($coroutineDirectory . DIRECTORY_SEPARATOR . 'Barrier/BarrierInterface.php', <<<'PHP'
+        <?php
+        interface BarrierInterface
+        {
+            public static function wait(object &$barrier, int $timeout = -1): void;
+        }
+        PHP);
+    file_put_contents($coroutineDirectory . DIRECTORY_SEPARATOR . 'Barrier/Swoole.php', <<<'PHP'
+        <?php
+        class SwooleBarrier implements BarrierInterface
+        {
+            public static function wait(object &$barrier, int $timeout = -1): void {}
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generated = $generator->generateNullableStaticSources();
+
+        expect($generated)->toBe([
+            '.typephp/build/coroutine-context.php',
+            '.typephp/build/coroutine-wait-group.php',
+            '.typephp/build/coroutine-barrier.php',
+            '.typephp/build/coroutine-barrier-interface.php',
+            '.typephp/build/coroutine-barrier-swoole.php',
+        ]);
+
+        // 未初始化标量静态属性补成可空 + 默认 null，??= 守卫主体保持原样
+        $context = (string) file_get_contents($directory . '/.typephp/build/coroutine-context.php');
+        expect($context)
+            ->toContain('protected static ?string $driver = null;')
+            ->toContain('static::$driver ??= match (Worker::$eventLoopClass)');
+        expect((string) file_get_contents($directory . '/.typephp/build/coroutine-barrier.php'))
+            ->toContain('public static function wait(mixed &$barrier, int $timeout = -1): void');
+        expect((string) file_get_contents($directory . '/.typephp/build/coroutine-barrier-interface.php'))
+            ->toContain('public static function wait(mixed &$barrier, int $timeout = -1): void;');
+        expect((string) file_get_contents($directory . '/.typephp/build/coroutine-barrier-swoole.php'))
+            ->toContain('public static function wait(mixed &$barrier, int $timeout = -1): void');
+        expect(str_contains($context, 'protected static string $driver;'))->toBeFalse();
+
+        // 函数内局部 static 与已带默认值的属性不受补丁影响
+        $waitGroup = (string) file_get_contents($directory . '/.typephp/build/coroutine-wait-group.php');
+        expect($waitGroup)->toContain('protected static ?string $driverClass = null;')->toContain('static $id = 0;');
+
+        // yml 在平铺源之后注入补丁源，并忽略 vendor 原版三个文件
         $yml = (string) file_get_contents($generator->generateProjectYml([]));
         expect($yml)
-            ->toContain('  - .typephp/build/webman-route.php' . "\n")
-            ->toContain('  - .typephp/build/coroutine-barrier-fiber.php' . "\n")
-            ->toContain('  - .typephp/build/coroutine-channel-fiber.php' . "\n")
-            ->toContain("\n  - vendor/workerman/webman-framework/src/Route/Route.php\n")
-            ->toContain("\n  - vendor/workerman/coroutine/src/Barrier/Fiber.php\n")
-            ->toContain("\n  - vendor/workerman/coroutine/src/Channel/Fiber.php\n");
+            ->toContain(
+                "sources:\n  - main.php\n  - .typephp/build/helpers.php\n"
+                . "  - .typephp/build/coroutine-context.php\n  - .typephp/build/coroutine-wait-group.php\n",
+            )
+            ->toContain("\n  - vendor/workerman/coroutine/src/Context.php\n")
+            ->toContain("\n  - vendor/workerman/coroutine/src/WaitGroup.php\n")
+            ->toContain("\n  - vendor/workerman/coroutine/src/Barrier.php\n")
+            ->toContain("\n  - vendor/workerman/coroutine/src/Barrier/Swoole.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('rejects changed Swoole Barrier reference signatures', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/workerman/coroutine/src/Barrier', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/workerman/coroutine/src/Barrier/Swoole.php',
+        "<?php class SwooleBarrier { public static function wait(\$barrier): void {} }\n",
+    );
+    try {
+        expect(fn () => (new ProjectGenerator($directory))->generateNullableStaticSources())
+            ->toThrow(
+                RuntimeException::class,
+                'Coroutine Swoole Barrier reference compatibility rule expected 1 match, found 0',
+            );
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('patches under-declared handler closures into variadic AOT sources', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory, 0777, true);
+    createWebmanHelpersFixture(
+        $directory,
+        "<?php\nfunction base_path(\$path = ''): string\n{\n    return \$path;\n}\n",
+    );
+    $workermanSrc = $directory . '/vendor/workerman/workerman/src';
+    mkdir($workermanSrc . '/Connection', 0777, true);
+    mkdir($workermanSrc . '/Events', 0777, true);
+
+    $worker = <<<'PHP'
+        <?php
+        namespace Workerman;
+        class Worker
+        {
+            protected function acceptTcpConnection($socket): void
+            {
+                set_error_handler(static fn (): bool => true);
+                $newSocket = stream_socket_accept($socket, 0, $remoteAddress);
+                restore_error_handler();
+            }
+            protected function listen(): void
+            {
+                set_error_handler(function ($code, $msg) {
+                    throw new RuntimeException($msg);
+                });
+                restore_error_handler();
+            }
+            public static function stopAll(): void
+            {
+                $workers = [];
+                array_walk($workers, static fn (Worker $worker) => $worker->stop(false));
+                $workerPidArray = [];
+                array_walk($workerPidArray, static fn ($pid) => posix_kill($pid, $sig));
+            }
+            protected static function installSignal(): void
+            {
+                $signal = 2;
+                pcntl_signal($signal, static::signalHandler(...), false);
+            }
+            public static function resetStd(): void
+            {
+                // 整块删除规则按字节匹配；下面关闭段的缩进与空行必须与真实 vendor Worker.php 一致，勿改
+                if (is_resource(STDOUT)) {
+                    fclose(STDOUT);
+                }
+
+                if (is_resource(STDERR)) {
+                    fclose(STDERR);
+                }
+
+                if (is_resource(static::$outputStream)) {
+                    fclose(static::$outputStream);
+                }
+
+                $stdOutStream = fopen(static::$stdoutFile, 'a');
+            }
+        }
+        PHP;
+    file_put_contents($workermanSrc . '/Worker.php', $worker);
+    file_put_contents(
+        $workermanSrc . '/Timer.php',
+        "<?php\nnamespace Workerman;\nclass Timer\n{\n"
+        . "    public static function init(): void\n    {\n"
+        . "        pcntl_signal(SIGALRM, self::signalHandle(...), false);\n"
+        . "    }\n"
+        . "    public static function signalHandle(): void {}\n}\n",
+    );
+
+    $select = <<<'PHP'
+        <?php
+        namespace Workerman\Events;
+        class Select
+        {
+            public function onSignal(int $signal, callable $func): void
+            {
+                pcntl_signal($signal, fn () => $this->safeCall($this->signalEvents[$signal], [$signal]));
+            }
+        }
+        PHP;
+    file_put_contents($workermanSrc . '/Events/Select.php', $select);
+
+    file_put_contents(
+        $workermanSrc . '/Connection/TcpConnection.php',
+        "<?php\nnamespace Workerman\\Connection;\nclass TcpConnection\n{\n"
+        . "    public function enableSsl(): void\n    {\n"
+        . "        \$reason = '';\n"
+        . "        set_error_handler(static function (int \$code, string \$msg) use (&\$reason): bool {\n"
+        . "            \$reason = \$msg;\n            return true;\n        });\n"
+        . "        try {\n            \$ret = true;\n        } finally {\n            restore_error_handler();\n        }\n"
+        . "        // Negotiation has failed.\n    }\n}\n",
+    );
+    file_put_contents(
+        $workermanSrc . '/Connection/AsyncTcpConnection.php',
+        "<?php\nnamespace Workerman\\Connection;\nclass AsyncTcpConnection\n{\n"
+        . "    public function connect(): void\n    {\n"
+        . "        set_error_handler(fn() => false);\n"
+        . "        restore_error_handler();\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/workerman/webman-framework/src/File.php',
+        "<?php\nnamespace Webman;\nclass File\n{\n"
+        . "    public function move(string \$destination): File\n    {\n"
+        . "        set_error_handler(function (\$type, \$msg) use (&\$error) {\n"
+        . "            \$error = \$msg;\n        });\n        restore_error_handler();\n        return \$this;\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generated = $generator->generateVariadicHandlerSources();
+
+        expect($generated)->toBe([
+            '.typephp/build/workerman-worker.php',
+            '.typephp/build/workerman-timer.php',
+            '.typephp/build/workerman-tcp-connection.php',
+            '.typephp/build/workerman-async-tcp-connection.php',
+            '.typephp/build/workerman-select.php',
+            '.typephp/build/webman-file.php',
+        ]);
+
+        // 零参/两参错误处理闭包与零参信号闭包均补成可变参数形态
+        $workerPatched = (string) file_get_contents($directory . '/.typephp/build/workerman-worker.php');
+        expect($workerPatched)
+            ->toContain('set_error_handler(static fn (...$__err): bool => true);')
+            ->toContain('set_error_handler(function ($code, $msg, ...$__err) {');
+        expect(str_contains($workerPatched, 'static fn (): bool => true'))->toBeFalse();
+
+        // 停机/重载路径：array_walk 2 参(value,key)、master pcntl_signal 2 参(signo,siginfo) 均补成可变参数形态
+        expect($workerPatched)
+            ->toContain('array_walk($workers, static fn (Worker $worker, ...$__walk) => $worker->stop(false));')
+            ->toContain('array_walk($workerPidArray, static fn ($pid, ...$__walk) => posix_kill($pid, $sig));')
+            ->toContain('pcntl_signal($signal, static fn (...$__sig) => static::signalHandler($__sig[0]), false);');
+        expect(str_contains(
+            $workerPatched,
+            'array_walk($workers, static fn (Worker $worker) => $worker->stop(false));',
+        ))->toBeFalse();
+        expect(str_contains($workerPatched, 'pcntl_signal($signal, static::signalHandler(...), false);'))->toBeFalse();
+
+        $timerPatched = (string) file_get_contents($directory . '/.typephp/build/workerman-timer.php');
+        expect($timerPatched)
+            ->toContain('pcntl_signal(SIGALRM, static fn (...$__sig) => self::signalHandle(), false);')
+            ->not->toContain('pcntl_signal(SIGALRM, self::signalHandle(...), false);');
+
+        // daemon 模式 resetStd()：TypePHP 标准流 NO_CLOSE 禁止关闭，三处 fclose 段被整块删除；
+        // 日志重定向（fopen stdoutFile → outputStream）保留，与 stock 行为一致
+        expect(str_contains($workerPatched, 'is_resource(STDOUT)'))->toBeFalse();
+        expect(str_contains($workerPatched, 'fclose(STDOUT);'))->toBeFalse();
+        expect(str_contains($workerPatched, 'is_resource(STDERR)'))->toBeFalse();
+        expect(str_contains($workerPatched, 'fclose(STDERR);'))->toBeFalse();
+        expect(str_contains($workerPatched, 'is_resource(static::$outputStream)'))->toBeFalse();
+        expect(str_contains($workerPatched, 'fclose(static::$outputStream);'))->toBeFalse();
+        expect($workerPatched)->toContain('$stdOutStream = fopen(static::$stdoutFile, \'a\');');
+
+        $selectPatched = (string) file_get_contents($directory . '/.typephp/build/workerman-select.php');
+        expect($selectPatched)->toContain('pcntl_signal($signal, fn (...$__sig) => $this->safeCall(');
+
+        $tcpPatched = (string) file_get_contents($directory . '/.typephp/build/workerman-tcp-connection.php');
+        expect($tcpPatched)
+            ->toContain('set_error_handler(static function (int $code, string $msg, ...$__err) use (&$reason): bool {')
+            ->toContain("if (\$reason === null) {\n            \$reason = '';")
+            ->not->toContain("\$reason = '';\n        set_error_handler");
+
+        $asyncPatched = (string) file_get_contents($directory . '/.typephp/build/workerman-async-tcp-connection.php');
+        expect($asyncPatched)->toContain('set_error_handler(fn(...$__err) => false);');
+
+        $filePatched = (string) file_get_contents($directory . '/.typephp/build/webman-file.php');
+        expect($filePatched)->toContain('set_error_handler(function ($type, $msg, ...$__err) use (&$error) {');
+
+        // yml 注入全部补丁源，并忽略 vendor 原版文件
+        $yml = (string) file_get_contents($generator->generateProjectYml([]));
+        expect($yml)
+            ->toContain('  - .typephp/build/workerman-worker.php' . "\n")
+            ->toContain('  - .typephp/build/workerman-timer.php' . "\n")
+            ->toContain('  - .typephp/build/workerman-select.php' . "\n")
+            ->toContain("\n  - vendor/workerman/workerman/src/Worker.php\n")
+            ->toContain("\n  - vendor/workerman/workerman/src/Timer.php\n")
+            ->toContain("\n  - vendor/workerman/workerman/src/Events/Select.php\n")
+            ->toContain("\n  - vendor/workerman/webman-framework/src/File.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('strips stray top-level bootstrap calls into AOT sources', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory, 0777, true);
+
+    $httpDirectory = $directory . '/vendor/workerman/workerman/src/Protocols/Http';
+    mkdir($httpDirectory . '/Session', 0777, true);
+    $coroutineDirectory = $directory . '/vendor/workerman/coroutine/src';
+    mkdir($coroutineDirectory . '/Context', 0777, true);
+    mkdir($coroutineDirectory . '/Coroutine', 0777, true);
+
+    // 顶层引导调用（workerman/coroutine 与 workerman 的模块初始化写法）
+    file_put_contents(
+        $httpDirectory . '/Session.php',
+        "<?php\nnamespace Workerman\\Protocols\\Http;\nclass Session\n{\n"
+        . "    public static function init(): void\n    {\n    }\n}\n\n// Init session handler\nSession::init();\n",
+    );
+    file_put_contents(
+        $httpDirectory . '/Session/FileSessionHandler.php',
+        "<?php\nnamespace Workerman\\Protocols\\Http\\Session;\nclass FileSessionHandler\n{\n"
+        . "    public static function init(): void\n    {\n    }\n}\n\nFileSessionHandler::init();\n",
+    );
+    file_put_contents(
+        $coroutineDirectory . '/Context/Fiber.php',
+        "<?php\nnamespace Workerman\\Coroutine\\Context;\nclass Fiber\n{\n"
+        . "    private static \\ArrayObject \$nonFiberContext;\n"
+        . "    private static \\WeakMap \$contexts;\n\n"
+        . "    public static function set(string \$name, mixed \$value): void\n"
+        . "    {\n"
+        . "        \$fiber = \\Fiber::getCurrent();\n"
+        . "        if (\$fiber === null) {\n"
+        . "            static::\$nonFiberContext[\$name] = \$value;\n"
+        . "            return;\n"
+        . "        }\n"
+        . "        static::\$contexts[\$fiber][\$name] = \$value;\n"
+        . "    }\n\n"
+        . "    public static function initContext(): void\n    {\n    }\n}\n\nFiber::initContext();\n",
+    );
+    file_put_contents(
+        $coroutineDirectory . '/Coroutine/Fiber.php',
+        "<?php\nnamespace Workerman\\Coroutine\\Coroutine;\nclass Fiber\n{\n"
+        . "    public static function init(): void\n    {\n    }\n}\n\nFiber::init();\n",
+    );
+    file_put_contents(
+        $coroutineDirectory . '/Coroutine.php',
+        "<?php\nnamespace Workerman\\Coroutine;\nclass Coroutine\n{\n"
+        . "    public static function init(): void\n    {\n    }\n}\n\nCoroutine::init();\n",
+    );
+    // 回归用例：静态属性补丁源同样必须剥掉尾部顶层引导调用，否则 AOT 扫描期报 stray code Fatal
+    file_put_contents(
+        $coroutineDirectory . '/Context.php',
+        "<?php\nnamespace Workerman\\Coroutine;\nclass Context\n{\n"
+        . "    protected static string \$driver;\n\n"
+        . "    public static function initDriver(): void\n    {\n        static::\$driver ??= 'Fiber';\n    }\n}\n\nContext::initDriver();\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateStrayBootstrapSources())->toBe([
+            '.typephp/build/http-session.php',
+            '.typephp/build/http-session-file-handler.php',
+            '.typephp/build/coroutine-context-fiber.php',
+            '.typephp/build/coroutine-fiber.php',
+            '.typephp/build/coroutine-coroutine.php',
+        ]);
+
+        // 每个剥离后的 AOT 源以类结束大括号收尾，紧邻引导调用的注释行一并移除；init 方法体保持原样
+        foreach (ProjectGenerator::STRAY_BOOTSTRAP_SOURCES as $target) {
+            $content = rtrim((string) file_get_contents($directory . '/' . $target));
+            expect(str_ends_with($content, '}'))->toBeTrue();
+        }
+        $session = (string) file_get_contents($directory . '/.typephp/build/http-session.php');
+        expect(str_contains($session, '// Init session handler'))->toBeFalse();
+        expect($session)->toContain("class Session\n{\n    public static function init(): void");
+        $fiberContext = (string) file_get_contents($directory . '/.typephp/build/coroutine-context-fiber.php');
+        expect($fiberContext)
+            ->toContain('static::$nonFiberContext->offsetSet($name, $value);')
+            ->toContain('static::$contexts[$fiber]->offsetSet($name, $value);')
+            ->not->toContain('static::$nonFiberContext[$name] = $value;')
+            ->not->toContain('static::$contexts[$fiber][$name] = $value;');
+
+        expect($generator->generateNullableStaticSources())->toBe(['.typephp/build/coroutine-context.php']);
+
+        // 回归：静态属性补丁与顶层引导剥离在同一产物上串联生效
+        $context = (string) file_get_contents($directory . '/.typephp/build/coroutine-context.php');
+        expect($context)
+            ->toContain('protected static ?string $driver = null;')
+            ->toContain("static::\$driver ??= 'Fiber';");
+        expect(str_contains($context, 'Context::initDriver();'))->toBeFalse();
+
+        // yml 注入剥离源并忽略 vendor 原版
+        $yml = (string) file_get_contents($generator->generateProjectYml([]));
+        expect($yml)
+            ->toContain('  - .typephp/build/http-session.php' . "\n")
+            ->toContain('  - .typephp/build/coroutine-coroutine.php' . "\n")
+            ->toContain("\n  - vendor/workerman/workerman/src/Protocols/Http/Session.php\n")
+            ->toContain("\n  - vendor/workerman/coroutine/src/Context/Fiber.php\n")
+            ->toContain("\n  - vendor/workerman/coroutine/src/Coroutine.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('rewrites fall-through switch cases into terminal AOT sources', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory, 0777, true);
+    mkdir($directory . '/vendor/workerman/webman-framework/src', 0777, true);
+    mkdir($directory . '/vendor/monolog/monolog/src/Monolog', 0777, true);
+    mkdir($directory . '/vendor/illuminate/bus', 0777, true);
+    mkdir($directory . '/vendor/illuminate/collections', 0777, true);
+    mkdir($directory . '/vendor/illuminate/database/Eloquent', 0777, true);
+    mkdir($directory . '/vendor/illuminate/database/Eloquent/Concerns', 0777, true);
+    mkdir($directory . '/vendor/symfony/cache/Traits', 0777, true);
+    mkdir($directory . '/vendor/twig/twig/src/Extension', 0777, true);
+    mkdir($directory . '/vendor/twig/twig/src/Node', 0777, true);
+
+    file_put_contents($directory . '/vendor/workerman/webman-framework/src/App.php', implode("\n", [
+        '<?php',
+        'namespace Webman;',
+        'class App',
+        '{',
+        '    public static function methodNotAllowed(string $allowHeader): mixed',
+        '    {',
+        '        return static function () use ($allowHeader) {',
+        '            return $allowHeader;',
+        '        };',
+        '    }',
+        '    public static function fallback(string $plugin, int $status): mixed',
+        '    {',
+        '        return Route::getFallback($plugin, $status) ?: function () {',
+        '            throw new \RuntimeException();',
+        '        };',
+        '    }',
+        '    public static function callbacks(string $key, string $file): void',
+        '    {',
+        '            static::collectCallbacks($key, [function () use ($file) {',
+        '                return static::execPhpFile($file);',
+        '            }]);',
+        '    }',
+        '    public static function getReflector(callable|string $call, ?string $cacheKey): mixed',
+        '    {',
+        "        if (\$call instanceof Closure || is_string(\$call)) {",
+        '            $reflector = new ReflectionFunction($call);',
+        '        } else {',
+        '            $reflector = new ReflectionMethod($call[0], $call[1]);',
+        '        }',
+        '',
+        '        if ($cacheKey !== null) {',
+        '            static::$reflectorCache[$cacheKey] = $reflector;',
+        '            if (count(static::$reflectorCache) > 1024) {',
+        '                unset(static::$reflectorCache[key(static::$reflectorCache)]);',
+        '            }',
+        '        }',
+        '',
+        '        return $reflector;',
+        '    }',
+        "    public static function stringify(mixed \$data): string",
+        '    {',
+        "        switch (gettype(\$data)) {",
+        "            case 'object':",
+        "                if (!method_exists(\$data, '__toString')) {",
+        "                    return 'Object';",
+        '                }',
+        '            default:',
+        '                return (string)$data;',
+        '        }',
+        '    }',
+        '}',
+        '',
+    ]));
+    file_put_contents($directory . '/vendor/monolog/monolog/src/Monolog/Utils.php', implode("\n", [
+        '<?php',
+        'namespace Monolog;',
+        'class Utils',
+        '{',
+        "    public static function throwJsonError(int \$code): void",
+        '    {',
+        '        switch ($code) {',
+        '            case 8:',
+        "                \$msg = 'Syntax error, malformed JSON';",
+        '                break;',
+        '            default:',
+        "                \$msg = 'Unknown error';",
+        '        }',
+        '    }',
+        '    public static function parseBytes(string $value): ?int',
+        '    {',
+        "        \$val = (int) \$value;",
+        '        switch (strtolower(substr($value, -1))) {',
+        "            case 'g':",
+        '                $val *= 1024;',
+        "            case 'm':",
+        '                $val *= 1024;',
+        "            case 'k':",
+        '                $val *= 1024;',
+        '        }',
+        '        return $val;',
+        '    }',
+        '}',
+        '',
+    ]));
+    file_put_contents(
+        $directory . '/vendor/illuminate/bus/Batch.php',
+        "<?php\nclass Batch\n{\n    public function add(\$jobs)\n    {\n"
+        . "        \$count = 0;\n        \$jobs = Collection::wrap(\$jobs)->map(function (\$job) use (&\$count) {\n"
+        . "            if (is_array(\$job)) {\n                \$count += count(\$job);\n"
+        . "            } else {\n                \$count++;\n            }\n            return \$job;\n        });\n\n"
+        . "        \$this->repository->transaction(function () use (\$jobs, \$count) {\n"
+        . "            return \$count;\n        });\n    }\n"
+        . "    public function toArray()\n    {\n        return [];\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/illuminate/collections/Enumerable.php',
+        "<?php\ninterface Enumerable\n{\n    public function toArray();\n"
+        . "    public function unless(\$value, callable \$callback, ?callable \$default = null);\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/illuminate/database/Eloquent/Concerns/HasAttributes.php',
+        "<?php\ntrait HasAttributes\n{\n    public function relationsToArray()\n    {\n"
+        . "        \$attributes = [];\n        foreach (\$this->getArrayableRelations() as \$key => \$value) {\n"
+        . "            if (\$value instanceof Arrayable) {\n                \$relation = \$value->toArray();\n"
+        . "            } elseif (is_null(\$value)) {\n                \$relation = \$value;\n            }\n"
+        . "            if (array_key_exists('relation', get_defined_vars())) { // check if \$relation is in scope (could be null)\n"
+        . "                \$attributes[\$key] = \$relation ?? null;\n            }\n            unset(\$relation);\n"
+        . "        }\n        return \$attributes;\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/illuminate/database/Eloquent/Model.php',
+        "<?php\nclass Model\n{\n    public function toArray()\n    {\n        return [];\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/symfony/cache/Traits/AbstractAdapterTrait.php',
+        "<?php\ntrait AbstractAdapterTrait\n{\n    private function generateItems(iterable \$items, array &\$keys): \\Generator\n    {\n        yield from \$items;\n    }\n}\n",
+    );
+    file_put_contents($directory . '/vendor/symfony/cache/Traits/ValueWrapper.php', "<?php\nclass \xA9\n{\n}\n");
+    file_put_contents(
+        $directory . '/vendor/symfony/cache/CacheItem.php',
+        "<?php\nclass CacheItem\n{\n    private const VALUE_WRAPPER = \"\\xA9\";\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/twig/twig/src/Node/Node.php',
+        "<?php\nclass Node\n{\n    public function __construct(array \$nodes = [], array \$attributes = [], int \$lineno = 0)\n    {\n"
+        . "        \$this->nodes = \$nodes;\n        \$this->attributes = \$attributes;\n        \$this->lineno = \$lineno;\n\n"
+        . "        if (\\func_num_args() > 3) {\n"
+        . "            trigger_deprecation('twig/twig', '3.12', \\sprintf('The \"tag\" constructor argument of the \"%s\" class is deprecated and ignored (check which TokenParser class set it to \"%s\"), the tag is now automatically set by the Parser when needed.', static::class, func_get_arg(3) ?: 'null'));\n"
+        . "        }\n    }\n"
+        . "    public function getAttribute(string \$name)\n    {\n"
+        . "        \$triggerDeprecation = \\func_num_args() > 1 ? func_get_arg(1) : true;\n"
+        . "        return \$name;\n    }\n"
+        . "    public function setAttribute(string \$name, \$value): void\n    {\n"
+        . "        \$triggerDeprecation = \\func_num_args() > 2 ? func_get_arg(2) : true;\n    }\n"
+        . "    public function getNode(string \$name): self\n    {\n"
+        . "        \$triggerDeprecation = \\func_num_args() > 1 ? func_get_arg(1) : true;\n"
+        . "        return \$this;\n    }\n"
+        . "    public function setNode(string \$name, self \$node): void\n    {\n"
+        . "        \$triggerDeprecation = \\func_num_args() > 2 ? func_get_arg(2) : true;\n    }\n"
+        . "}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/twig/twig/src/Node/EmptyNode.php',
+        "<?php\nclass EmptyNode extends Node\n{\n    public function setNode(string \$name, Node \$node): void {}\n}\n",
+    );
+    mkdir($directory . '/vendor/twig/twig/src/Node/Expression', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/twig/twig/src/Node/Expression/SupportDefinedTestDeprecationTrait.php',
+        "<?php\ntrait SupportDefinedTestDeprecationTrait\n{\n"
+        . "    public function setAttribute(string \$name, \$value): void\n"
+        . "    {\n        parent::setAttribute(\$name, \$value);\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/twig/twig/src/Extension/CoreExtension.php',
+        "<?php\nclass CoreExtension\n{\n    public static function toArray(\$seq, \$preserveKeys = true)\n"
+        . "    {\n        return self::toArray(\$seq, \$preserveKeys);\n    }\n"
+        . "    private static function getPropertyChecker(string \$class, string \$property): \\Closure\n    {\n"
+        . "        static \$classReflectors = [];\n        \$class = \$classReflectors[\$class] ??= new \\ReflectionClass(\$class);\n"
+        . "        if (!\$class->hasProperty(\$property)) {\n            return static fn () => false;\n        }\n"
+        . "        \$property = \$class->getProperty(\$property);\n"
+        . "        if (!\$property->isPublic() || \$property->isStatic()) {\n            return static fn () => false;\n        }\n"
+        . "        return static fn (\$object) => \$property->isInitialized(\$object);\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/twig/twig/src/Node/IncludeNode.php',
+        "<?php\nclass IncludeNode\n{\n"
+        . "    protected function addGetTemplate(Compiler \$compiler/* , string \$template = '' */) {}\n"
+        . "    public function compile(): void\n    {\n"
+        . "        CoreExtension::toArray([]);\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/twig/twig/src/Node/WithNode.php',
+        "<?php\n\$compiler->write(\"CoreExtension::toArray(\\\$vars);\");\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/webman-app.php',
+            '.typephp/build/monolog-utils.php',
+            '.typephp/build/illuminate-bus-batch.php',
+            '.typephp/build/illuminate-collections-enumerable.php',
+            '.typephp/build/illuminate-eloquent-has-attributes.php',
+            '.typephp/build/illuminate-eloquent-model.php',
+            '.typephp/build/symfony-cache-abstract-adapter-trait.php',
+            '.typephp/build/symfony-cache-value-wrapper.php',
+            '.typephp/build/symfony-cache-item.php',
+        ]);
+
+        // 同一变量跨 ReflectionFunction/ReflectionMethod 重赋值改为分支内独立变量 + 提前 return
+        $app = (string) file_get_contents($directory . '/.typephp/build/webman-app.php');
+        expect($app)
+            ->toContain('$reflectorFunction = new ReflectionFunction($call);')
+            ->toContain('$reflectorMethod = new ReflectionMethod($call[0], $call[1]);')
+            ->toContain('return $reflectorMethod;')
+            ->toContain('static function (...$arguments) use ($allowHeader)')
+            ->toContain('function (...$arguments) {')
+            ->toContain('[function (...$arguments) use ($file)');
+        expect(str_contains($app, '$reflector = new Reflection'))->toBeFalse();
+
+        // case 'object' 不再落空到 default，自带终结 return
+        expect($app)->toContain("}\n                return (string)\$data;\n            default:");
+
+        $utils = (string) file_get_contents($directory . '/.typephp/build/monolog-utils.php');
+        expect($utils)->toContain("\$msg = 'Unknown error';\n                break;\n        }");
+
+        // g/m/k 级联落空展开为各 case 独立连乘，总量不变
+        expect($utils)->toContain(
+            "case 'g':\n                \$val *= 1024;\n                \$val *= 1024;\n                \$val *= 1024;\n                break;",
+        );
+        expect($utils)->toContain(
+            "case 'm':\n                \$val *= 1024;\n                \$val *= 1024;\n                break;",
+        );
+        expect($utils)->toContain("case 'k':\n                \$val *= 1024;\n                break;");
+        expect((string) file_get_contents($directory . '/.typephp/build/illuminate-bus-batch.php'))
+            ->toContain('public function toArray(): array')
+            ->toContain('$countState = new \stdClass();')
+            ->toContain('map(function ($job) use ($countState) {')
+            ->toContain('$countState->value = $countState->value + count($job);')
+            ->toContain('$count = $countState->value;')
+            ->not->toContain('use (&$count)');
+        expect((string) file_get_contents($directory . '/.typephp/build/illuminate-collections-enumerable.php'))
+            ->toContain('public function toArray(): array')
+            ->toContain('unless($value = null, ?callable $callback = null, ?callable $default = null)');
+        expect((string) file_get_contents($directory . '/.typephp/build/illuminate-eloquent-model.php'))
+            ->toContain('public function toArray(): array');
+        expect((string) file_get_contents($directory . '/.typephp/build/illuminate-eloquent-has-attributes.php'))
+            ->toContain('$relationSet = false;')
+            ->toContain('$relationSet = true;')
+            ->toContain('if ($relationSet) {')
+            ->not->toContain('get_defined_vars()');
+        expect((string) file_get_contents($directory . '/.typephp/build/symfony-cache-abstract-adapter-trait.php'))
+            ->toContain('generateItems(iterable $items, array $keys): \Generator');
+        expect((string) file_get_contents($directory . '/.typephp/build/symfony-cache-value-wrapper.php'))
+            ->toContain('class TypephpSymfonyCacheValueWrapper');
+        expect((string) file_get_contents($directory . '/.typephp/build/symfony-cache-item.php'))
+            ->toContain("private const VALUE_WRAPPER = 'TypephpSymfonyCacheValueWrapper';");
+        $yml = (string) file_get_contents($generator->generateProjectYml([]));
+        expect($yml)
+            ->toContain('  - .typephp/build/webman-app.php' . "\n")
+            ->toContain('  - .typephp/build/monolog-utils.php' . "\n")
+            ->toContain("\n  - vendor/workerman/webman-framework/src/App.php\n")
+            ->toContain("\n  - vendor/monolog/monolog/src/Monolog/Utils.php\n")
+            ->toContain("\n  - vendor/illuminate/collections/Enumerable.php\n")
+            ->toContain("\n  - vendor/illuminate/database/Eloquent/Model.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('moves Monolog browser style caches out of captured static locals for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/monolog/monolog/src/Monolog/Handler';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/BrowserConsoleHandler.php', <<<'PHP'
+        <?php
+        class BrowserConsoleHandler {
+            protected static $records = [];
+            private static function handleCustomStyles(string $style, string $string): string {
+                static $colors = ['blue', 'green', 'red', 'magenta', 'orange', 'black', 'grey'];
+                static $labels = [];
+                return preg_replace_callback('/x/', function (array $m) use ($string, &$colors, &$labels) {
+                    if (!isset($labels[$string])) {
+                        $labels[$string] = $colors[count($labels) % count($colors)];
+                    }
+                    $color = $labels[$string];
+                    return $color;
+                }, $style);
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/monolog-browser-console-handler.php');
+        expect($generated)
+            ->toContain('private static array $aotColors')
+            ->toContain('self::$aotLabels[$string] = self::$aotColors[')
+            ->not->toContain('static $colors =')
+            ->not->toContain('use ($string, &$colors, &$labels)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps PhpZip encrypted input separate from its integer check byte in AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/nelexa/zip/src/IO/Filter/Cipher/Pkware';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/PKCryptContext.php', <<<'PHP'
+        <?php
+        class PKCryptContext {
+            public function checkHeader(string $header, int $checkByte): void {
+                $byte = 0;
+
+                foreach (unpack('C*', $header) as $byte) {
+                    $byte = ($byte ^ $this->decryptByte()) & 0xFF;
+                    $this->updateKeys($byte);
+                }
+
+                if ($byte !== $checkByte) {
+                    throw new RuntimeException();
+                }
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/nelexa-pkcrypt-context.php');
+        expect($generated)
+            ->toContain('foreach (unpack(\'C*\', $header) as $encryptedByte)')
+            ->toContain('if ($lastByte !== $checkByte)')
+            ->not->toContain('foreach (unpack(\'C*\', $header) as $byte)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('folds PhpZip interface constants used by AOT defaults', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/nelexa/zip/src/Model', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/nelexa/zip/src/Model/ZipEntry.php',
+        "<?php class ZipEntry { private int \$level = ZipCompressionLevel::NORMAL; }\n",
+    );
+    file_put_contents($directory . '/vendor/nelexa/zip/src/ZipFile.php', <<<'PHP'
+        <?php
+        class ZipFile {
+            public function level(int $level = ZipCompressionLevel::NORMAL): void {
+                $dir = 'x';
+                foreach ($lastModDirs as $dir => $lastMod) {
+                    touch($dir, $lastMod);
+                }
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        expect(file_get_contents($directory . '/.typephp/build/nelexa-zip-entry.php'))
+            ->toContain('private int $level = 5');
+        expect(file_get_contents($directory . '/.typephp/build/nelexa-zip-file.php'))
+            ->toContain('int $level = 5')
+            ->toContain('as $lastModDir => $lastMod')
+            ->toContain('touch($lastModDir, $lastMod)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps PhpZip directory iterator branch types separate in AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/nelexa/zip/src/Util';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/FilesUtil.php', <<<'PHP'
+        <?php
+        class FilesUtil {
+            public static function search(string $folder, string $pattern, bool $recursive): void {
+                if ($recursive) {
+                    $directoryIterator = new \RecursiveDirectoryIterator($folder);
+                    $iterator = new \RecursiveIteratorIterator($directoryIterator);
+                } else {
+                    $directoryIterator = new \DirectoryIterator($folder);
+                    $iterator = new \IteratorIterator($directoryIterator);
+                }
+
+                $regexIterator = new \RegexIterator($iterator, $pattern, \RegexIterator::MATCH);
+            }
+
+            public static function convertGlobToRegEx(array $chars): string {
+                $regexPattern = '';
+                $escaping = false;
+                foreach ($chars as $currentChar) {
+                    switch ($currentChar) {
+                        default:
+                            $escaping = false;
+                            $regexPattern .= $currentChar;
+                    }
+                }
+                return $regexPattern;
+            }
+
+            public static function fileSearchWithIgnore(string $inputDir, bool $recursive, array $ignoreFiles): array {
+                if ($recursive) {
+                    $directoryIterator = new \RecursiveDirectoryIterator($inputDir);
+
+                    if (!empty($ignoreFiles)) {
+                        $directoryIterator = new IgnoreFilesRecursiveFilterIterator($directoryIterator, $ignoreFiles);
+                    }
+                    $iterator = new \RecursiveIteratorIterator($directoryIterator);
+                } else {
+                    $directoryIterator = new \DirectoryIterator($inputDir);
+
+                    if (!empty($ignoreFiles)) {
+                        $directoryIterator = new IgnoreFilesFilterIterator($directoryIterator, $ignoreFiles);
+                    }
+                    $iterator = new \IteratorIterator($directoryIterator);
+                }
+                return iterator_to_array($iterator);
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/nelexa-files-util.php');
+        expect($generated)
+            ->toContain('$recursiveDirectory = new \RecursiveDirectoryIterator')
+            ->toContain('$flatDirectory = new \DirectoryIterator')
+            ->toContain("\$regexPattern .= \$currentChar;\n                    break;")
+            ->toContain('new IgnoreFilesRecursiveFilterIterator($recursiveDirectory, $ignoreFiles)')
+            ->toContain('new IgnoreFilesFilterIterator($flatDirectory, $ignoreFiles)')
+            ->not->toContain('$directoryIterator =');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('expands CarbonInterval variable variables in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/nesbot/carbon/src/Carbon';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/CarbonInterval.php', <<<'PHP'
+        <?php
+        class CarbonInterval {
+            public function normalize($years, $months, $weeks, $days, $hours, $minutes, $seconds): void {
+                $translations = [
+                    ['option' => CarbonInterface::ONE_DAY_WORDS],
+                    ['option' => CarbonInterface::TWO_DAY_WORDS],
+                ];
+                $optionalSpace = ' ';
+                $default = $this->getTranslationMessage('list.0') ?? $this->getTranslationMessage('list') ?? ' ';
+                /** @var bool|string $join */
+                $join = $default === '' ? '' : ' ';
+                /** @var bool|array|string $altNumbers */
+                $altNumbers = false;
+                $aUnit = false;
+                $minimumUnit = 's';
+                $skip = [];
+                extract($this->getForHumansInitialVariables($syntax, $short));
+                foreach ($diffIntervalArray as $index => &$unitData) {
+                    $nextIndex = $index + 1;
+                }
+                foreach ($interval as $index => &$item) {
+                    $item = $transChoice($item[0], $item[1], $index, $actualParts);
+                }
+                while ([$part, $value, $unit] = array_shift($parts)) {
+                }
+                foreach (['years', 'months', 'weeks', 'days', 'hours', 'minutes', 'seconds'] as $unit) {
+                    $value = $$unit;
+                }
+                foreach ($factors as $source => [$target, $factor]) {
+                    foreach (['source', 'target'] as $key) {
+                        if ($$key === 'dayz') {
+                            $$key = 'daysExcludeWeeks';
+                        }
+                    }
+                }
+                switch ($key) {
+                    default:
+                        $this->$key = $value;
+                }
+                switch ($unit) {
+                    default:
+                        $instance->$unit = $value;
+                }
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/carbon-interval.php');
+        expect($generated)
+            ->toContain("['option' => 04]")
+            ->toContain("['option' => 010]")
+            ->not->toContain('CarbonInterface::ONE_DAY_WORDS')->toContain(
+                'foreach ($interval as $partIndex => &$item)',
+            )->toContain('$partIndex, $actualParts')->toContain(
+                'foreach ($diffIntervalArray as $skipIndex => &$unitData)',
+            )->toContain('$nextIndex = $skipIndex + 1;')->toContain(
+                '$humanOptions = $this->getForHumansInitialVariables',
+            )->toContain('$translator = $humanOptions[\'translator\'] ?? null;')
+            ->not->toContain('extract(')->toContain('while ($partValues = array_shift($parts))')->toContain(
+                '$unit = $partValues[2];',
+            )
+            ->not->toContain('while ([$part, $value, $unit]')->toContain("'years' => \$years")->toContain(
+                "if (\$target === 'dayz')",
+            )->toMatch('/\$this->\$key = \$value;\s+break;/')->toMatch('/\$instance->\$unit = \$value;\s+break;/')
+            ->not->toContain('$$');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('passes a CarbonTimeZone name across the AOT Carbon now boundary', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/nesbot/carbon/src/Carbon';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/CarbonTimeZone.php', <<<'PHP'
+        <?php
+        class CarbonTimeZone {
+            private function resolveCarbon(): object {
+                return Carbon::now($this);
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/carbon-time-zone.php');
+        expect($generated)
+            ->toContain('return Carbon::now($this->getName());')
+            ->not->toContain('return Carbon::now($this);');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('moves Webman database loading side effects into the AOT entrypoint', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/webman/database/src/support', 0777, true);
+    mkdir($directory . '/vendor/webman/think-orm/src', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/webman/database/src/support/Model.php',
+        "<?php\nrequire_once __DIR__ . '/../Initializer.php';\nclass Model {}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/webman/database/src/support/Db.php',
+        "<?php\nrequire_once __DIR__ . '/../Initializer.php';\nclass Db {}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/webman/database/src/Initializer.php',
+        "<?php\nclass Initializer {}\n\nInitializer::init(config('database', []));\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/webman/think-orm/src/Initializer.php',
+        "<?php\nclass Initializer {}\n\nInitializer::init();\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/webman-database-model.php',
+            '.typephp/build/webman-database-db.php',
+            '.typephp/build/webman-database-initializer.php',
+            '.typephp/build/webman-think-orm-initializer.php',
+        ]);
+        expect(file_get_contents($directory . '/.typephp/build/webman-database-model.php'))
+            ->not
+            ->toContain('require_once __DIR__');
+        expect(file_get_contents($directory . '/.typephp/build/webman-database-db.php'))
+            ->not
+            ->toContain('require_once __DIR__');
+        expect(file_get_contents($directory . '/.typephp/build/webman-database-initializer.php'))
+            ->not
+            ->toContain('Initializer::init(');
+        expect(file_get_contents($directory . '/.typephp/build/webman-think-orm-initializer.php'))
+            ->not
+            ->toContain('Initializer::init();');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('clears Webman database grammar without Closure call in AOT copies', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/database', 0777, true);
+    mkdir($directory . '/vendor/webman/database/src', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/illuminate/database/Connection.php',
+        "<?php\nclass Connection {\n    public function setQueryGrammar(Query\\Grammars\\Grammar \$grammar) {}\n}\n",
+    );
+    file_put_contents($directory . '/vendor/webman/database/src/DatabaseManager.php', <<<'PHP'
+        <?php
+        class DatabaseManager {
+            protected function closeAndFreeConnection($connection): void {
+                $clearProperties = function () {
+                    $this->queryGrammar = null;
+                };
+                $clearProperties->call($connection);
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        expect(file_get_contents($directory . '/.typephp/build/illuminate-database-connection.php'))
+            ->toContain('setQueryGrammar(?Query\Grammars\Grammar $grammar)');
+        expect(file_get_contents($directory . '/.typephp/build/webman-database-manager.php'))
+            ->toContain('$connection->setQueryGrammar(null);')
+            ->not->toContain('Closure')
+            ->not->toContain('->call(');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('clears Webman ThinkORM state without Closure call in AOT copies', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/topthink/think-orm/src/db', 0777, true);
+    mkdir($directory . '/vendor/webman/think-orm/src', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/topthink/think-orm/src/db/Connection.php',
+        "<?php\nabstract class Connection {\n    protected \$db;\n    protected \$cache;\n    protected \$builder;\n    /**\n     * 析构方法.\n     */\n    public function __destruct() {}\n}\n",
+    );
+    file_put_contents($directory . '/vendor/webman/think-orm/src/DbManager.php', <<<'PHP'
+        <?php
+        class DbManager {
+            protected function closeConnection($connection): void {
+                $clearProperties = function () {
+                    $this->db = null;
+                    $this->cache = null;
+                    $this->builder = null;
+                };
+                $clearProperties->call($connection);
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        expect(file_get_contents($directory . '/.typephp/build/think-orm-connection.php'))
+            ->toContain('function clearRuntimeStateForAot(): void')
+            ->toContain('$this->builder = null;');
+        expect(file_get_contents($directory . '/.typephp/build/webman-think-orm-db-manager.php'))
+            ->toContain('$connection->clearRuntimeStateForAot();')
+            ->not->toContain('Closure')
+            ->not->toContain('->call(');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps the Workerman parallel barrier in a reference-capable AOT slot', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/workerman/coroutine/src', 0777, true);
+    file_put_contents($directory . '/vendor/workerman/coroutine/src/Parallel.php', <<<'PHP'
+        <?php
+        class Parallel {
+            public function wait(): array {
+                $barrier = Barrier::create();
+                $barrierRef = new \stdClass();
+                    $barrierRef->value = $barrier;
+                Barrier::wait($barrier);
+                return [];
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateRefCaptureSources();
+        $content = (string) file_get_contents($directory . '/.typephp/build/coroutine-parallel.php');
+        expect($content)
+            ->toContain('$barrierState = new \stdClass()')
+            ->toContain('$barrierRef->value = $barrierState->value')
+            ->toContain('Barrier::wait($barrierState->value)')
+            ->not->toContain('$barrier = Barrier::create()');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps the Workerman websocket request header separate from response headers', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/workerman/workerman/src/Protocols', 0777, true);
+    file_put_contents($directory . '/vendor/workerman/workerman/src/Protocols/Websocket.php', <<<'PHP'
+        <?php
+        class Websocket {
+            public static function handshake(string $header, object $connection): string {
+                $handshakeMessage = $header;
+                foreach ($connection->headers as $header) {
+                    if (strpbrk($header, "\r\n") !== false) {
+                        continue;
+                    }
+                    if (stripos($header, 'Sec-WebSocket-Extensions:') === 0 && stripos($header, 'permessage-deflate') !== false) {
+                        $connection->compressed = true;
+                    }
+                    $handshakeMessage .= "$header\r\n";
+                }
+                return $handshakeMessage;
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $content = (string) file_get_contents($directory . '/.typephp/build/workerman-websocket.php');
+        expect($content)
+            ->toContain('foreach ($connection->headers as $responseHeader)')
+            ->toContain('strpbrk($responseHeader, "\r\n")')
+            ->toContain("stripos(\$responseHeader, 'Sec-WebSocket-Extensions:')")
+            ->toContain("stripos(\$responseHeader, 'permessage-deflate')")
+            ->toContain('$handshakeMessage .= "$responseHeader\r\n";')
+            ->not->toContain('foreach ($connection->headers as $header)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps the ip2region integer slot stable on 32-bit fallback', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/zoujingli/ip2region', 0777, true);
+    file_put_contents($directory . '/vendor/zoujingli/ip2region/XdbSearcher.php', <<<'PHP'
+        <?php
+        class XdbSearcher {
+            public static function getLong(string $b, int $idx) {
+                $val = ord($b[$idx]);
+                if ($val < 0 && PHP_INT_SIZE == 4) {
+                    $val = sprintf("%u", $val);
+                }
+                return $val;
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $content = (string) file_get_contents($directory . '/.typephp/build/ip2region-xdb-searcher.php');
+        expect($content)->toContain('return sprintf("%u", $val);')->not->toContain('$val = sprintf("%u", $val);');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps the ip2region v3 integer slot stable on 32-bit fallback', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/zoujingli/ip2region/src/ip2region/xdb';
+    mkdir($sourceDirectory, 0777, true);
+    $source = <<<'PHP'
+        <?php
+        class Util {
+            public static function le_getUint32($b, $idx) {
+                $val = ord($b[$idx]);
+                if ($val < 0 && PHP_INT_SIZE == 4) {
+                    $val = sprintf("%u", $val);
+                }
+                return $val;
+            }
+        }
+        PHP;
+    file_put_contents($sourceDirectory . '/Util.php', $source);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/ip2region-v3-util.php');
+        expect($content)->toContain('return sprintf("%u", $val);')->not->toContain('$val = sprintf("%u", $val);');
+
+        file_put_contents($sourceDirectory . '/Util.php', str_replace(
+            '$val = sprintf("%u", $val);',
+            'return sprintf("%u", $val);',
+            $source,
+        ));
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'SaiAdmin IP2Region v3 integer slot compatibility rule expected 1 match(es), found 0',
+            );
+
+        file_put_contents($sourceDirectory . '/Util.php', $source . "\n" . $source);
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'SaiAdmin IP2Region v3 integer slot compatibility rule expected 1 match(es), found 2',
+            );
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps the Webman monitor iterator object-typed in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/app/process', 0777, true);
+    file_put_contents(
+        $directory . '/app/process/Monitor.php',
+        "<?php\nclass Monitor\n{\n    public function check(\$monitorDir): void\n    {\n"
+        . "        if (is_file(\$monitorDir)) {\n            \$iterator = [new SplFileInfo(\$monitorDir)];\n"
+        . "        } else {\n            \$dirIterator = \$monitorDir;\n"
+        . "            \$iterator = new RecursiveIteratorIterator(\$dirIterator);\n        }\n"
+        . "        foreach (\$iterator as \$file) {}\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/app-process-monitor.php']);
+        expect(file_get_contents($directory . '/.typephp/build/app-process-monitor.php'))
+            ->toContain('$iterator = new \IteratorIterator(new \ArrayIterator([new SplFileInfo($monitorDir)]));')
+            ->toContain('$iterator = new \IteratorIterator(new RecursiveIteratorIterator($dirIterator));')
+            ->not->toContain('$iterator = [new SplFileInfo($monitorDir)];');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps ThinkORM method parameters type-stable in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/topthink/think-orm/src/model/concern', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/topthink/think-orm/src/model/concern/Conversion.php',
+        "<?php\ntrait Conversion\n{\n    public function appendRelationAttr(string \$attr, array \$append)\n    {\n"
+        . "            foreach (\$append as \$key => \$attr) {\n                \$key = is_numeric(\$key) ? \$attr : \$key;\n"
+        . "                \$this->data[\$key] = \$model->getAttr(\$attr);\n            }\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/topthink/think-orm/src/model/concern/RelationShip.php',
+        "<?php\ntrait RelationShip\n{\n    private \$parent;\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/think-orm-conversion.php',
+            '.typephp/build/think-orm-relation-ship.php',
+        ]);
+        expect(file_get_contents($directory . '/.typephp/build/think-orm-conversion.php'))
+            ->toContain('foreach ($append as $key => $appendAttr)')
+            ->toContain('$model->getAttr($appendAttr)')
+            ->not->toContain('foreach ($append as $key => $attr)');
+        expect(file_get_contents($directory . '/.typephp/build/think-orm-relation-ship.php'))
+            ->toContain('protected $parent;')
+            ->not->toContain('private $parent;');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps ThinkValidate recursive path parameters type-stable in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/topthink/think-validate/src', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/topthink/think-validate/src/Validate.php',
+        "<?php\nclass Validate\n{\n    protected function getRecursiveData(array \$data, string \$key)\n    {\n"
+        . "        \$keys = explode('.', \$key);\n        foreach (\$keys as \$key) {\n"
+        . "            if (!isset(\$data[\$key])) {\n                break;\n            }\n"
+        . "            \$value = \$data = \$data[\$key];\n"
+        . "        }\n        return \$value;\n    }\n"
+        . "    protected function parseErrorMsg(string \$msg, \$rule, string \$title) {}\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/think-validate.php']);
+        expect(file_get_contents($directory . '/.typephp/build/think-validate.php'))
+            ->toContain('foreach ($keys as $segment)')
+            ->toContain('$data[$segment]')
+            ->toContain('parseErrorMsg(mixed $msg, $rule, string $title)')
+            ->not->toContain('foreach ($keys as $key)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('rewrites Brick Math byte-string complement without integer coercion', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/brick/math/src', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/brick/math/src/BigInteger.php',
+        "<?php\nclass BigInteger\n{\n    public static function fromBytes(string \$value): void\n    {\n"
+        . "        if (\$value !== '') {\n                \$value = ~\$value;\n        }\n    }\n}\n",
+    );
+    mkdir($directory . '/vendor/brick/math/src/Internal', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/brick/math/src/Internal/Calculator.php',
+        "<?php\nclass Calculator\n{\n"
+        . "    public function run(string \$value): string { return \$this->toDecimal(\$value); }\n"
+        . "    private function toDecimal(string \$bytes): string { return \$bytes; }\n}\n",
+    );
+    mkdir($directory . '/vendor/brick/math/src/Internal/Calculator', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/brick/math/src/Internal/Calculator/NativeCalculator.php',
+        "<?php\nclass NativeCalculator\n{\n    public function div(): array\n    {\n"
+        . "        \$na = \$a * 1; // cast to number\n        \$nb = \$b * 1;\n        \$nb = \$b * 1;\n"
+        . "                \$q = intdiv(\$na, \$nb);\n                \$r = \$na % \$nb;\n"
+        . "                return [\n                    (string) \$q,\n                    (string) \$r,\n                ];\n"
+        . "            \$sum = \$blockA - \$blockB - \$carry;\n            if (\$sum < 0) {\n"
+        . "                \$sum += \$complement;\n            }\n            \$sum = (string) \$sum;\n"
+        . "                \$value = \$mul % \$complement;\n                \$carry = (\$mul - \$value) / \$complement;\n"
+        . "                \$value = (string) \$value;\n            \$r = (int) substr(\$a, 0, \$z - 1);\n"
+        . "                \$n = \$r * 10 + (int) \$a[\$i];\n                \$r = \$n % \$nb;\n"
+        . "            return [ltrim(\$q, '0') ?: '0', (string) \$r];\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/brick-math-big-integer.php',
+            '.typephp/build/brick-math-calculator.php',
+            '.typephp/build/brick-math-native-calculator.php',
+        ]);
+        expect(file_get_contents($directory . '/.typephp/build/brick-math-big-integer.php'))
+            ->toContain("\$complement .= chr(255 - ord(\$value[\$i]));")
+            ->toContain('$value = $complement;')
+            ->not->toContain('$value = ~$value;');
+        expect(file_get_contents($directory . '/.typephp/build/brick-math-calculator.php'))
+            ->toContain('typephpToDecimal($value)')
+            ->toContain('function typephpToDecimal(string $bytes)');
+        expect(file_get_contents($directory . '/.typephp/build/brick-math-native-calculator.php'))
+            ->toContain('$na = (float) $a; // AOT: force the overflow-safe string algorithm')
+            ->toContain('$nb = (float) $b;')
+            ->not
+            ->toContain('$b * 1')
+            ->toContain('$intQ = intdiv($na, $nb);')
+            ->toContain('(string) $intR,')
+            ->toContain('$sumValue = $blockA - $blockB - $carry;')
+            ->toContain('if ($sumValue < 0)')
+            ->toContain('$sumValue += $complement;')
+            ->toContain('$sum = (string) $sumValue;')
+            ->toContain('$remainderValue = $mul % $complement;')
+            ->toContain('$carry = ($mul - $remainderValue) / $complement;')
+            ->toContain('$value = (string) $remainderValue;')
+            ->toContain('$intRemainder = (int) substr($a, 0, $z - 1);')
+            ->toContain('$n = $intRemainder * 10 + (int) $a[$i];')
+            ->toContain('$intRemainder = $n % $nb;')
+            ->toContain("(string) \$intRemainder];");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('rewrites typed-reference captures into AOT sources', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory, 0777, true);
+    mkdir($directory . '/vendor/workerman/webman-framework/src/Route', 0777, true);
+    $coroutineDirectory = $directory . '/vendor/workerman/coroutine/src';
+    mkdir($coroutineDirectory . '/Barrier', 0777, true);
+    mkdir($coroutineDirectory . '/Channel', 0777, true);
+    mkdir($directory . '/vendor/guzzlehttp/guzzle/src/Handler', 0777, true);
+
+    // 真实 vendor 的 Route.php 与协程驱动文件为 CRLF，补丁字面量按 CRLF 匹配
+    file_put_contents($directory . '/vendor/workerman/webman-framework/src/Route/Route.php', implode("\r\n", [
+        '<?php',
+        'namespace Webman\Route;',
+        'class Route',
+        '{',
+        '    public function url(array $parameters = []): string',
+        '    {',
+        '        $path = $this->path;',
+        "        \$path = preg_replace_callback('/\\{(.*?)(?:\\:[^\\}]*?)*?\\}/', function (\$matches) use (&\$parameters) {",
+        '            if (!$parameters) {',
+        '                return $matches[0];',
+        '            }',
+        '            if (isset($parameters[$matches[1]])) {',
+        '                $value = $parameters[$matches[1]];',
+        '                unset($parameters[$matches[1]]);',
+        '                return $value;',
+        '            }',
+        '            $key = key($parameters);',
+        '            if (is_int($key)) {',
+        '                $value = $parameters[$key];',
+        '                unset($parameters[$key]);',
+        '                return $value;',
+        '            }',
+        '            return $matches[0];',
+        '        }, $path);',
+        "        return count(\$parameters) > 0 ? \$path . '?' . http_build_query(\$parameters) : \$path;",
+        '    }',
+        '}',
+        '',
+    ]));
+    file_put_contents($coroutineDirectory . '/Barrier/Fiber.php', implode("\r\n", [
+        '<?php',
+        'namespace Workerman\Coroutine\Barrier;',
+        'class Fiber',
+        '{',
+        '    public static function wait(array $dependencies, float $timeout): bool',
+        '    {',
+        '        $resumed = false;',
+        '        $timerId = null;',
+        '        $coroutine = 1;',
+        '        if ($timeout > 0) {',
+        '            function() use ($coroutine, &$resumed, &$timerId) {',
+        '                $timerId = 2;',
+        '            };',
+        '        }',
+        '        return $resumed;',
+        '    }',
+        '}',
+        '',
+    ]));
+    file_put_contents($coroutineDirectory . '/Channel/Fiber.php', implode("\r\n", [
+        '<?php',
+        'namespace Workerman\Coroutine\Channel;',
+        'class Fiber',
+        '{',
+        '    public function push($value, float $timeout = -1): bool',
+        '    {',
+        "        if (\$timeout > 0) {",
+        '            $timedOut = false;',
+        '            $timerId = null;',
+        '            function() use (&$timedOut) {',
+        '                $timedOut = true;',
+        '            };',
+        '        }',
+        '        return true;',
+        '    }',
+        '}',
+        '',
+    ]));
+    file_put_contents(
+        $directory . '/vendor/guzzlehttp/guzzle/src/Handler/CurlFactory.php',
+        "<?php\nclass CurlFactory\n{\n    public function headers(): callable\n    {\n"
+        . "        \$startingResponse = false;\n        \$collectingTrailers = false;\n"
+        . "        return static function () use (&\$startingResponse, &\$collectingTrailers) {\n"
+        . "            \$startingResponse = true;\n            \$collectingTrailers = true;\n        };\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/guzzlehttp/guzzle/src/Handler/StreamHandler.php',
+        "<?php\nclass StreamHandler\n{\n    public function create()\n    {\n"
+        . "        \$errors = [];\n        \\set_error_handler(static function () use (&\$errors): bool {\n"
+        . "            \$errors[] = 'error';\n            return true;\n        });\n"
+        . "        try {\n            \$resource = true;\n        } finally {\n            \\restore_error_handler();\n        }\n\n"
+        . "        if (!\$resource) {\n            foreach (\$errors as \$error) {}\n        }\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/guzzlehttp/guzzle/src/MessageFormatter.php',
+        "<?php\nclass MessageFormatter\n{\n    public function format(): string\n    {\n"
+        . "        \$cache = [];\n\n        \$result = \\preg_replace_callback('/x/', function () use (&\$cache) {\n"
+        . "            switch (\$matches[1]) {\n                default:\n"
+        . "                    if (strpos(\$matches[1], 'req_header_') === 0) {\n"
+        . "                        \$result = 'request';\n"
+        . "                    } elseif (strpos(\$matches[1], 'res_header_') === 0) {\n"
+        . "                        \$result = \$response\n"
+        . "                            ? \$response->getHeaderLine(substr(\$matches[1], 11))\n"
+        . "                                : 'NULL';\n"
+        . "                        }\n"
+        . "                }\n"
+        . "            return \$cache['x'] = 'x';\n        }, 'x');\n        return \$result;\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/guzzlehttp/guzzle/src/Pool.php',
+        "<?php\nclass Pool\n{\n"
+        . "    private static function cmpCallback(array &\$options, string \$name, array &\$results): void\n"
+        . "    {\n        \$options[\$name] = static function (\$value) use (&\$results) {\n"
+        . "            \$results[] = \$value;\n        };\n    }\n}\n",
+    );
+    mkdir($directory . '/vendor/guzzlehttp/promises/src', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/guzzlehttp/promises/src/Utils.php',
+        "<?php\n"
+        . "        \$results = [];\n        \$promise = Each::of(\$promises);\n"
+        . "        \$results = [];\n        \$rejections = [];\n\n        return Each::of(\$promises)->then(\n"
+        . "            function () use (&\$results, &\$rejections, \$count) {\n"
+        . "                if (count(\$results) !== \$count) {}\n            }\n        );\n"
+        . "        \$results = [];\n\n        return Each::of(\$promises)"
+        . "        )->then(function () use (&\$results) {\n            ksort(\$results);\n        });\n"
+        . "        function () use (\$recursive, &\$promises) {};\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateRefCaptureSources())->toBe([
+            '.typephp/build/webman-route.php',
+            '.typephp/build/coroutine-barrier-fiber.php',
+            '.typephp/build/coroutine-channel-fiber.php',
+            '.typephp/build/guzzle-curl-factory.php',
+            '.typephp/build/guzzle-stream-handler.php',
+            '.typephp/build/guzzle-message-formatter.php',
+            '.typephp/build/guzzle-pool.php',
+            '.typephp/build/guzzle-promises-utils.php',
+        ]);
+
+        // array 参数改为按值捕获 + 捕获未初始化的引用槽
+        $route = (string) file_get_contents($directory . '/.typephp/build/webman-route.php');
+        expect($route)->toContain('function ($matches) use ($parameters, &$remaining) {');
+        expect(str_contains($route, 'use (&$parameters)'))->toBeFalse();
+
+        // 被引用捕获的 $resumed 去掉初始化即为 REF 槽；只读的 $timerId 改为按值捕获
+        $barrier = (string) file_get_contents($directory . '/.typephp/build/coroutine-barrier-fiber.php');
+        expect($barrier)->toContain('function() use ($coroutine, &$resumed, $timerId) {');
+        expect(str_contains($barrier, '$resumed = false;'))->toBeFalse();
+        expect($barrier)->toContain('        $timerId = null;');
+
+        $channel = (string) file_get_contents($directory . '/.typephp/build/coroutine-channel-fiber.php');
+        expect(str_contains($channel, '$timedOut = false;'))->toBeFalse();
+        expect($channel)->toContain('            $timerId = null;');
+
+        $curlFactory = (string) file_get_contents($directory . '/.typephp/build/guzzle-curl-factory.php');
+        expect($curlFactory)
+            ->not->toContain('$startingResponse = false;')
+            ->not->toContain('$collectingTrailers = false;')->toContain(
+                'use (&$startingResponse, &$collectingTrailers)',
+            );
+
+        $streamHandler = (string) file_get_contents($directory . '/.typephp/build/guzzle-stream-handler.php');
+        expect($streamHandler)
+            ->not
+            ->toContain('$errors = [];' . "\n" . '        \set_error_handler')
+            ->toContain('if (!isset($errors)) {')
+            ->toContain('use (&$errors)');
+
+        $messageFormatter = (string) file_get_contents($directory . '/.typephp/build/guzzle-message-formatter.php');
+        expect($messageFormatter)
+            ->not
+            ->toContain('$cache = [];')
+            ->toContain("                        break;\n                }")
+            ->toContain('use (&$cache)');
+
+        $pool = (string) file_get_contents($directory . '/.typephp/build/guzzle-pool.php');
+        expect($pool)->toContain('string $name, mixed &$results): void');
+
+        $promisesUtils = (string) file_get_contents($directory . '/.typephp/build/guzzle-promises-utils.php');
+        expect($promisesUtils)
+            ->not->toContain('$results = [];' . "\n" . '        $promise = Each::of(')
+            ->not->toContain('$rejections = [];' . "\n\n" . '        return Each::of(')->toContain(
+                'if (!isset($results)) {',
+            )->toContain('if (!isset($rejections)) {')->toContain('use ($recursive, $promises)');
+
+        $yml = (string) file_get_contents($generator->generateProjectYml([]));
+        expect($yml)
+            ->toContain('  - .typephp/build/webman-route.php' . "\n")
+            ->toContain('  - .typephp/build/coroutine-barrier-fiber.php' . "\n")
+            ->toContain('  - .typephp/build/coroutine-channel-fiber.php' . "\n")
+            ->toContain('  - .typephp/build/guzzle-curl-factory.php' . "\n")
+            ->toContain('  - .typephp/build/guzzle-stream-handler.php' . "\n")
+            ->toContain('  - .typephp/build/guzzle-message-formatter.php' . "\n")
+            ->toContain('  - .typephp/build/guzzle-pool.php' . "\n")
+            ->toContain('  - .typephp/build/guzzle-promises-utils.php' . "\n")
+            ->toContain("\n  - vendor/workerman/webman-framework/src/Route/Route.php\n")
+            ->toContain("\n  - vendor/workerman/coroutine/src/Barrier/Fiber.php\n")
+            ->toContain("\n  - vendor/workerman/coroutine/src/Channel/Fiber.php\n")
+            ->toContain("\n  - vendor/guzzlehttp/guzzle/src/Handler/CurlFactory.php\n")
+            ->toContain("\n  - vendor/guzzlehttp/guzzle/src/Handler/StreamHandler.php\n")
+            ->toContain("\n  - vendor/guzzlehttp/guzzle/src/MessageFormatter.php\n")
+            ->toContain("\n  - vendor/guzzlehttp/guzzle/src/Pool.php\n")
+            ->toContain("\n  - vendor/guzzlehttp/promises/src/Utils.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('normalizes PSR-7 query decoders to one callable type', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/guzzlehttp/psr7/src', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/guzzlehttp/psr7/src/Query.php',
+        "<?php\nclass Query\n{\n    public static function parse(\$mode): void\n    {\n"
+        . "        if (\$mode === 1) {\n            \$decoder = 'rawurldecode';\n"
+        . "        } else {\n            \$decoder = 'urldecode';\n        }\n"
+        . "        if (\$mode === 2) {\n            \$encoder = 'rawurlencode';\n"
+        . "        } else {\n            \$encoder = 'urlencode';\n        }\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/guzzlehttp/psr7/src/StreamWrapper.php',
+        "<?php\nclass StreamWrapper\n{\n    public function stream_open(int \$options): bool\n    {\n"
+        . "        \$options = stream_context_get_options(\$this->context);\n"
+        . "        if (!isset(\$options['guzzle']['stream'])) {\n            return false;\n        }\n"
+        . "        \$this->stream = \$options['guzzle']['stream'];\n        return true;\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/guzzle-psr7-query.php',
+            '.typephp/build/guzzle-psr7-stream-wrapper.php',
+        ]);
+        expect(file_get_contents($directory . '/.typephp/build/guzzle-psr7-query.php'))
+            ->toContain('$decoder = static fn($value) => rawurldecode((string) $value);')
+            ->toContain('$decoder = static fn($value) => urldecode((string) $value);')
+            ->toContain('$encoder = static fn(string $value): string => rawurlencode($value);')
+            ->toContain('$encoder = static fn(string $value): string => urlencode($value);');
+        expect(file_get_contents($directory . '/.typephp/build/guzzle-psr7-stream-wrapper.php'))
+            ->toContain('$contextOptions = stream_context_get_options($this->context);')
+            ->toContain("\$contextOptions['guzzle']['stream']");
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/guzzlehttp/psr7/src/Query.php\n")
+            ->toContain("\n  - vendor/guzzlehttp/psr7/src/StreamWrapper.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Symfony session metadata initialization in a reference-capable slot', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-foundation/Session/Storage';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/MetadataBag.php', <<<'PHP'
+        <?php
+        class MetadataBag {
+            public function initialize(array &$array): void
+            {
+                $this->meta = &$array;
+            }
+        }
+        PHP);
+
+    try {
+        expect(new ProjectGenerator($directory)->generateRefCaptureSources())->toBe([
+            '.typephp/build/symfony-session-metadata-bag.php',
+        ]);
+        $generated = (string) file_get_contents($directory . '/.typephp/build/symfony-session-metadata-bag.php');
+        expect($generated)
+            ->toContain('initialize(mixed &$array): void')
+            ->not->toContain('initialize(array &$array): void');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('rewrites recursive Illuminate Arr dot storage for AOT references', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/collections', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/illuminate/collections/Arr.php',
+        "<?php\nclass Arr\n{\n    public static function dot(\$array): array\n    {\n"
+        . "        \$results = [];\n\n        \$flatten = function (\$data, \$prefix, \$currentDepth) use (&\$results, &\$flatten, \$depth): void {\n"
+        . "            foreach (\$data as \$key => \$value) {\n                \$newKey = \$prefix.\$key;\n"
+        . "                if (is_array(\$value)) {\n                    \$flatten(\$value, \$newKey.'.', \$currentDepth + 1);\n"
+        . "                } else {\n                    \$results[\$newKey] = \$value;\n                }\n            }\n"
+        . "        };\n        \$flatten(\$array, \$prepend, 0);\n        \$flatten = null;\n\n        return \$results;\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateRefCaptureSources())->toBe(['.typephp/build/illuminate-collections-arr.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/illuminate-collections-arr.php');
+        expect($source)
+            ->not
+            ->toContain('$results = [];' . "\n\n" . '        $flatten = function')
+            ->toContain('unset($flatten);')
+            ->toContain('if (!isset($results)) {')
+            ->toContain('$currentDepth, $recurse) use (&$results, $depth)')
+            ->toContain('$recurse($value, $newKey.\'.\', $currentDepth + 1, $recurse);')
+            ->toContain('$flatten($array, $prepend, 0, $flatten);');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/illuminate/collections/Arr.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('expands Postgres DSN extract into explicit configuration reads', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/database/Connectors', 0777, true);
+    file_put_contents($directory . '/vendor/illuminate/database/Connectors/PostgresConnector.php', <<<'PHP'
+        <?php
+        class PostgresConnector
+        {
+            protected function getDsn(array $config)
+            {
+                extract($config, EXTR_SKIP);
+
+                $host = isset($host) ? "host={$host};" : '';
+                $database = $connect_via_database ?? $database ?? null;
+                $port = $connect_via_port ?? $port ?? null;
+                if (isset($charset)) {
+                    $dsn .= ";client_encoding='{$charset}'";
+                }
+                if (isset($application_name)) {
+                    $dsn .= ";application_name='".str_replace("'", "\'", $application_name)."'";
+                }
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/illuminate-database-postgres-connector.php',
+        ]);
+        $source = (string) file_get_contents($directory . '/.typephp/build/illuminate-database-postgres-connector.php');
+        expect($source)
+            ->not
+            ->toContain('extract(')
+            ->toContain('$config[\'host\']')
+            ->toContain('$config[\'connect_via_database\']')
+            ->toContain('$config[\'connect_via_port\']')
+            ->toContain('$config[\'charset\']')
+            ->toContain('$config[\'application_name\']');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('declares the optional Postgres JSON path quote argument for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/database/Query/Grammars', 0777, true);
+    file_put_contents($directory . '/vendor/illuminate/database/Query/Grammars/PostgresGrammar.php', <<<'PHP'
+        <?php
+        class PostgresGrammar
+        {
+            protected function wrapJsonPathAttributes($path)
+            {
+                $quote = func_num_args() === 2 ? func_get_arg(1) : "'";
+
+                return [$path, $quote];
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/illuminate-database-postgres-grammar.php',
+        ]);
+        expect(file_get_contents($directory . '/.typephp/build/illuminate-database-postgres-grammar.php'))
+            ->toContain('protected function wrapJsonPathAttributes($path, $quote = "\'")')
+            ->not->toContain('func_num_args()')
+            ->not->toContain('func_get_arg(');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/illuminate/database/Query/Grammars/PostgresGrammar.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('declares the Blueprint dropColumn variadic arguments for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/database/Schema', 0777, true);
+    file_put_contents($directory . '/vendor/illuminate/database/Schema/Blueprint.php', <<<'PHP'
+        <?php
+        class Blueprint
+        {
+            public function dropColumn($columns)
+            {
+                $columns = is_array($columns) ? $columns : func_get_args();
+
+                return $columns;
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/illuminate-database-schema-blueprint.php',
+        ]);
+        expect(file_get_contents($directory . '/.typephp/build/illuminate-database-schema-blueprint.php'))
+            ->toContain('public function dropColumn($columns, ...$additionalColumns)')
+            ->toContain('array_merge([$columns], $additionalColumns)')
+            ->not->toContain('func_get_args()');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/illuminate/database/Schema/Blueprint.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('rejects nonempty Illuminate dynamic require data explicitly for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/filesystem', 0777, true);
+    file_put_contents($directory . '/vendor/illuminate/filesystem/Filesystem.php', <<<'PHP'
+        <?php
+        use RuntimeException;
+        class Filesystem
+        {
+            public function getRequire($__path, array $__data = [])
+            {
+                return (static function () use ($__path, $__data) {
+                        extract($__data, EXTR_SKIP);
+                    return require $__path;
+                })();
+            }
+
+            public function requireOnce($__path, array $__data = [])
+            {
+                return (static function () use ($__path, $__data) {
+                        extract($__data, EXTR_SKIP);
+                    return require_once $__path;
+                })();
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/illuminate-filesystem.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/illuminate-filesystem.php');
+        expect(substr_count($source, 'AOT dynamic require does not support injected variables.'))
+            ->toBe(2)
+            ->and($source)
+            ->not
+            ->toContain('extract(')
+            ->toContain('return require $__path;')
+            ->toContain('return require_once $__path;');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/illuminate/filesystem/Filesystem.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('declares Illuminate HTTP Response exception callbacks explicitly for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/http/Client', 0777, true);
+    file_put_contents($directory . '/vendor/illuminate/http/Client/Response.php', <<<'PHP'
+        <?php
+        class Response
+        {
+            public function throw()
+            {
+                $callback = func_get_args()[0] ?? null;
+
+                return $callback;
+            }
+
+            public function throwIf($condition)
+            {
+                return value($condition, $this) ? $this->throw(func_get_args()[1] ?? null) : $this;
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/illuminate-http-client-response.php',
+        ]);
+        $source = (string) file_get_contents($directory . '/.typephp/build/illuminate-http-client-response.php');
+        expect($source)
+            ->toContain('public function throw($callback = null)')
+            ->toContain('public function throwIf($condition, $callback = null)')
+            ->toContain('$this->throw($callback)')
+            ->not->toContain('func_get_args()');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/illuminate/http/Client/Response.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('moves Illuminate JSON resource request transforms away from the TypePHP conversion keyword', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/http/Resources/Json', 0777, true);
+    mkdir($directory . '/vendor/illuminate/http/Resources/JsonApi', 0777, true);
+    file_put_contents($directory . '/vendor/illuminate/http/Resources/Json/JsonResource.php', <<<'PHP'
+        <?php
+        class JsonResource
+        {
+            public function toAttributes(Request $request)
+            {
+                return $this->toArray($request);
+            }
+
+            public function toArray(Request $request)
+            {
+                return [];
+            }
+        }
+        PHP);
+    file_put_contents($directory . '/vendor/illuminate/http/Resources/Json/ResourceCollection.php', <<<'PHP'
+        <?php
+        class ResourceCollection extends JsonResource
+        {
+            public function toArray(Request $request)
+            {
+                return [];
+            }
+        }
+        PHP);
+    file_put_contents($directory . '/vendor/illuminate/http/Resources/JsonApi/JsonApiResource.php', <<<'PHP'
+        <?php
+        class JsonApiResource extends JsonResource
+        {
+            public function toAttributes(Request $request)
+            {
+                return $this->toArray($request);
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/illuminate-json-resource.php',
+            '.typephp/build/illuminate-resource-collection.php',
+            '.typephp/build/illuminate-json-api-resource.php',
+        ]);
+        $resource = (string) file_get_contents($directory . '/.typephp/build/illuminate-json-resource.php');
+        $collection = (string) file_get_contents($directory . '/.typephp/build/illuminate-resource-collection.php');
+        $jsonApi = (string) file_get_contents($directory . '/.typephp/build/illuminate-json-api-resource.php');
+        expect($resource)
+            ->toContain('public function toArray(): array')
+            ->toContain('return $this->resolve($this->resolveRequestFromContainer());')
+            ->toContain('public function toResourceArray(Request $request)')
+            ->toContain('return $this->toResourceArray($request);')
+            ->not->toContain('public function toArray(Request $request)');
+        expect($collection)
+            ->toContain('public function toResourceArray(Request $request)')
+            ->not->toContain('public function toArray(Request $request)');
+        expect($jsonApi)
+            ->toContain('return $this->toResourceArray($request);')
+            ->not->toContain('return $this->toArray($request);');
+
+        file_put_contents($directory . '/vendor/illuminate/http/Resources/Json/JsonResource.php', str_replace(
+            'return $this->toArray($request);',
+            'return [];',
+            (string) file_get_contents($directory . '/vendor/illuminate/http/Resources/Json/JsonResource.php'),
+        ));
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'compatibility rule expected 1 match(es), found 0: '
+                . 'vendor/illuminate/http/Resources/Json/JsonResource.php',
+            );
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('expands Blueprint integer compact options for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/database/Schema', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/illuminate/database/Schema/Blueprint.php',
+        "<?php\nclass Blueprint\n{\n"
+        . "    public function integer(\$column, \$autoIncrement = false, \$unsigned = false) {\n"
+        . "        return compact('autoIncrement', 'unsigned');\n    }\n"
+        . "    public function tinyInteger(\$column, \$autoIncrement = false, \$unsigned = false) {\n"
+        . "        return compact('autoIncrement', 'unsigned');\n    }\n"
+        . "    public function smallInteger(\$column, \$autoIncrement = false, \$unsigned = false) {\n"
+        . "        return compact('autoIncrement', 'unsigned');\n    }\n"
+        . "    public function mediumInteger(\$column, \$autoIncrement = false, \$unsigned = false) {\n"
+        . "        return compact('autoIncrement', 'unsigned');\n    }\n"
+        . "    public function bigInteger(\$column, \$autoIncrement = false, \$unsigned = false) {\n"
+        . "        return compact('autoIncrement', 'unsigned');\n    }\n}\n",
+    );
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory
+        . '/.typephp/build/illuminate-database-schema-blueprint.php');
+        expect(substr_count($generated, "['autoIncrement' => \$autoIncrement, 'unsigned' => \$unsigned]"))->toBe(5);
+        expect($generated)->not->toContain("compact('autoIncrement', 'unsigned')");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('expands the Query Builder basic where compact expression for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/database/Query', 0777, true);
+    file_put_contents($directory . '/vendor/illuminate/database/Query/Builder.php', <<<'PHP'
+        <?php
+        class Builder
+        {
+            public function where($column, $operator = null, $value = null, $boolean = 'and')
+            {
+                $type = 'Basic';
+
+                $this->wheres[] = compact(
+                    'type', 'column', 'operator', 'value', 'boolean'
+                );
+            }
+
+            public function whereColumn($first, $operator = null, $second = null, $boolean = 'and')
+            {
+                $type = 'Column';
+
+                $this->wheres[] = compact(
+                    'type', 'first', 'operator', 'second', 'boolean'
+                );
+            }
+
+            public function whereJsonLength($column, $operator, $value = null, $boolean = 'and')
+            {
+                $type = 'JsonLength';
+                $this->wheres[] = compact('type', 'column', 'operator', 'value', 'boolean');
+            }
+
+            public function having($column, $operator = null, $value = null, $boolean = 'and')
+            {
+                $type = 'Basic';
+                $this->havings[] = compact('type', 'column', 'operator', 'value', 'boolean');
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/illuminate-database-query-builder.php');
+        expect($generated)
+            ->toContain("'operator' => \$operator")
+            ->toContain("'second' => \$second")
+            ->toContain("'value' => \$value")
+            ->not->toContain("compact(\n            'type', 'column', 'operator', 'value', 'boolean'")
+            ->not->toContain("compact(\n            'type', 'first', 'operator', 'second', 'boolean'")
+            ->not->toContain("compact('type', 'column', 'operator', 'value', 'boolean')");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('expands date clause trait compact expressions for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/database/Concerns', 0777, true);
+    file_put_contents($directory . '/vendor/illuminate/database/Concerns/BuildsWhereDateClauses.php', <<<'PHP'
+        <?php
+        trait BuildsWhereDateClauses
+        {
+            protected function wherePastOrFuture($columns, $operator, $boolean)
+            {
+                $type = 'Basic';
+                $value = Carbon::now();
+                foreach (Arr::wrap($columns) as $column) {
+                    $this->wheres[] = compact('type', 'column', 'boolean', 'operator', 'value');
+                }
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory
+        . '/.typephp/build/illuminate-database-builds-where-date-clauses.php');
+        expect($generated)
+            ->toContain("'operator' => \$operator")
+            ->not->toContain("compact('type', 'column', 'boolean', 'operator', 'value')");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('initializes Eloquent one-of-many loop state for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/database/Eloquent/Relations/Concerns', 0777, true);
+    file_put_contents($directory
+    . '/vendor/illuminate/database/Eloquent/Relations/Concerns/CanBeOneOfMany.php', <<<'PHP'
+        <?php
+        trait CanBeOneOfMany
+        {
+            public function ofMany($columns, $aggregate)
+            {
+                if ($aggregate instanceof Closure) {
+                    $closure = $aggregate;
+                }
+
+                foreach ($columns as $column => $aggregate) {
+                    $values = $previous['columns'] ?? [];
+                    if (isset($previous)) {
+                        consume($previous);
+                    }
+                    if (isset($closure)) {
+                        $closure($subQuery);
+                    }
+                    if (! isset($previous)) {
+                        consume($subQuery);
+                    }
+                    $previous = ['columns' => $values];
+                }
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory
+        . '/.typephp/build/illuminate-eloquent-can-be-one-of-many.php');
+        expect($generated)
+            ->toContain('$previous = [];')
+            ->toContain('if ($previous !== [])')
+            ->toContain('if ($aggregate instanceof Closure)')
+            ->toContain('if ($previous === [])')
+            ->not->toContain('$closure');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps dotenv writer objects in stable local variable types for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/vlucas/phpdotenv/src/Repository', 0777, true);
+    file_put_contents($directory . '/vendor/vlucas/phpdotenv/src/Repository/RepositoryBuilder.php', <<<'PHP'
+        <?php
+        class RepositoryBuilder
+        {
+            public function make()
+            {
+                $reader = new MultiReader($this->readers);
+                $writer = new MultiWriter($this->writers);
+
+                if ($this->immutable) {
+                    $writer = new ImmutableWriter($writer, $reader);
+                }
+
+                if ($this->allowList !== null) {
+                    $writer = new GuardedWriter($writer, $this->allowList);
+                }
+
+                return new AdapterRepository($reader, $writer);
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/phpdotenv-repository-builder.php');
+        expect($generated)
+            ->toContain('if ($this->immutable && $this->allowList !== null)')
+            ->toContain('new GuardedWriter(new ImmutableWriter($writer, $reader), $this->allowList)')
+            ->not->toContain('$writer = new ImmutableWriter')
+            ->not->toContain('$writer = new GuardedWriter');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('terminates dotenv parser switch cases for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/vlucas/phpdotenv/src/Parser', 0777, true);
+    file_put_contents($directory . '/vendor/vlucas/phpdotenv/src/Parser/EntryParser.php', <<<'PHP'
+        <?php
+        class EntryParser
+        {
+            private static function processToken(int $state, string $token)
+            {
+                switch ($state) {
+                    case self::INITIAL_STATE:
+                        if ($token) {
+                            return 1;
+                        } else {
+                            return 2;
+                        }
+                    case self::UNQUOTED_STATE:
+                        if ($token) {
+                            return 1;
+                        } else {
+                            return 2;
+                        }
+                    case self::SINGLE_QUOTED_STATE:
+                        if ($token) {
+                            return 1;
+                        } else {
+                            return 2;
+                        }
+                    case self::DOUBLE_QUOTED_STATE:
+                        if ($token) {
+                            return 1;
+                        } else {
+                            return 2;
+                        }
+                    case self::ESCAPE_SEQUENCE_STATE:
+                        if ($token) {
+                            return 1;
+                        } else {
+                            return 2;
+                        }
+                    case self::WHITESPACE_STATE:
+                        if ($token) {
+                            return 1;
+                        } else {
+                            return 2;
+                        }
+                    case self::COMMENT_STATE:
+                        return 3;
+                }
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/phpdotenv-entry-parser.php');
+        expect(substr_count($generated, "throw new \\Error('Unreachable parser state.');"))->toBe(6);
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('uses stable JWT exception variable types for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/firebase/php-jwt/src', 0777, true);
+    file_put_contents($directory . '/vendor/firebase/php-jwt/src/JWT.php', <<<'PHP'
+        <?php
+        class JWT
+        {
+            public static function decode($payload, $timestamp)
+            {
+                if ($payload->nbf) {
+                    $ex = new BeforeValidException(
+                        'Cannot handle token with nbf prior to ' . \date(DateTime::ATOM, (int) floor($payload->nbf))
+                    );
+                    $ex->setPayload($payload);
+                    throw $ex;
+                }
+                if ($payload->iat) {
+                    $ex = new BeforeValidException(
+                        'Cannot handle token with iat prior to ' . \date(DateTime::ATOM, (int) floor($payload->iat))
+                    );
+                    $ex->setPayload($payload);
+                    throw $ex;
+                }
+                if ($payload->exp) {
+                    $ex = new ExpiredException('Expired token');
+                    $ex->setPayload($payload);
+                    $ex->setTimestamp($timestamp);
+                    throw $ex;
+                }
+            }
+
+            public static function sodium($msg, $key)
+            {
+                switch ($msg) {
+                    case 'sign':
+                        try {
+                            return sign($msg, $key);
+                        } catch (Exception $e) {
+                            throw new DomainException($e->getMessage(), 0, $e);
+                        }
+                    case 'verify':
+                        try {
+                            return verify($msg, $key);
+                        } catch (Exception $e) {
+                            throw new DomainException($e->getMessage(), 0, $e);
+                        }
+                    default:
+                        return false;
+                }
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/firebase-jwt.php');
+        expect($generated)
+            ->toContain('$beforeValidNbf = new BeforeValidException')
+            ->toContain('$beforeValidIat = new BeforeValidException')
+            ->toContain('$expired = new ExpiredException')
+            ->not->toContain('$ex =');
+        expect(substr_count($generated, "throw new DomainException('Unreachable sodium operation.');"))->toBe(2);
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('uses stable Symfony controller reflection variable types for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/symfony/http-kernel/Exception', 0777, true);
+    file_put_contents($directory
+    . '/vendor/symfony/http-kernel/Exception/ControllerDoesNotReturnResponseException.php', <<<'PHP'
+        <?php
+        class ControllerDoesNotReturnResponseException
+        {
+            private function parseControllerDefinition(callable $controller): ?array
+            {
+                if (\is_array($controller)) {
+                    try {
+                        $r = new \ReflectionMethod($controller[0], $controller[1]);
+
+                        return [
+                            'file' => $r->getFileName(),
+                            'line' => $r->getEndLine(),
+                        ];
+                    } catch (\ReflectionException) {
+                        return null;
+                    }
+                }
+                if ($controller instanceof \Closure) {
+                    $r = new \ReflectionFunction($controller);
+
+                    return [
+                        'file' => $r->getFileName(),
+                        'line' => $r->getEndLine(),
+                    ];
+                }
+                if (\is_object($controller)) {
+                    $r = new \ReflectionClass($controller);
+
+                    try {
+                        $line = $r->getMethod('__invoke')->getEndLine();
+                    } catch (\ReflectionException) {
+                        $line = $r->getEndLine();
+                    }
+
+                    return [
+                        'file' => $r->getFileName(),
+                        'line' => $line,
+                    ];
+                }
+                return null;
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory
+        . '/.typephp/build/symfony-http-kernel-controller-no-response.php');
+        expect($generated)
+            ->toContain('$methodReflection = new \ReflectionMethod')
+            ->toContain('$functionReflection = new \ReflectionFunction')
+            ->toContain('$classReflection = new \ReflectionClass')
+            ->not->toContain('$r =');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps the Symfony forwarded host array separate from the scalar host for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/symfony/http-foundation', 0777, true);
+    file_put_contents($directory . '/vendor/symfony/http-foundation/Request.php', <<<'PHP'
+        <?php
+
+        // Help opcache.preload discover always-needed symbols
+        class_exists(AcceptHeader::class);
+        class_exists(FileBag::class);
+        class_exists(HeaderBag::class);
+        class_exists(HeaderUtils::class);
+        class_exists(InputBag::class);
+        class_exists(ParameterBag::class);
+        class_exists(ServerBag::class);
+
+        class Request
+        {
+            protected static ?array $formats = null;
+
+            public function getHost(): string
+            {
+                if ($this->isFromTrustedProxy() && $host = $this->getTrustedValues(self::HEADER_X_FORWARDED_HOST)) {
+                    $host = $host[0];
+                } else {
+                    $host = '';
+                }
+
+                return strtolower($host);
+            }
+
+            public function getFormat(?string $mimeType/* , bool $subtypeFallback = false */): ?string
+            {
+                $subtypeFallback = 2 <= \func_num_args() ? func_get_arg(1) : false;
+
+                return $subtypeFallback ? $mimeType : null;
+            }
+
+            public static function create(string $method, array $parameters): array
+            {
+                switch (strtoupper($method)) {
+                    case 'POST':
+                    case 'PUT':
+                    case 'DELETE':
+                    case 'QUERY':
+                        if (true) {
+                            $contentType = 'application/x-www-form-urlencoded';
+                        }
+                        // no break
+                    case 'PATCH':
+                        $request = $parameters;
+                        $query = [];
+                        break;
+                    default:
+                        $request = [];
+                        $query = $parameters;
+                        break;
+                }
+                return [$request, $query];
+            }
+
+            /**
+             * Associates a format with mime types.
+             */
+            public function setFormat(?string $format, string|array $mimeTypes): void
+            {
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/symfony-http-foundation-request.php',
+        ]);
+        $source = (string) file_get_contents($directory . '/.typephp/build/symfony-http-foundation-request.php');
+        expect($source)
+            ->toContain('$forwardedHosts = $this->getTrustedValues')
+            ->toContain('$host = $forwardedHosts[0];')
+            ->not->toContain('$host = $this->getTrustedValues')->toContain(
+                'getFormat(?string $mimeType, bool $subtypeFallback = false)',
+            )
+            ->not->toContain('func_get_arg(1)')->toContain(
+                'public static function resetFormatsForAot(): void',
+            )->toContain('self::$formats = null;')->toContain(
+                "\$query = [];\n                break;\n            case 'PATCH':",
+            )
+            ->not->toContain('class_exists(');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/symfony/http-foundation/Request.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('replaces Symfony RequestStack closure binding with the AOT reset bridge', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-request-stack-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-foundation';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/RequestStack.php', <<<'PHP'
+        <?php
+        class RequestStack
+        {
+            public function resetRequestFormats(): void
+            {
+                static $resetRequestFormats;
+                $resetRequestFormats ??= \Closure::bind(static fn () => self::$formats = null, null, Request::class);
+                $resetRequestFormats();
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-http-foundation-request-stack.php');
+
+        expect($content)
+            ->toContain('Request::resetFormatsForAot();')
+            ->not->toContain('Closure::bind')
+            ->not->toContain('$resetRequestFormats');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('makes Symfony ResponseHeaderBag partitioned cookies explicit in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-response-headers-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-foundation';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/ResponseHeaderBag.php', <<<'PHP'
+        <?php
+        class ResponseHeaderBag
+        {
+            public function clearCookie(string $name, ?string $path = '/', ?string $domain = null, bool $secure = false, bool $httpOnly = true, ?string $sameSite = null /* , bool $partitioned = false */): void
+            {
+                $partitioned = 6 < \func_num_args() ? func_get_arg(6) : false;
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-http-foundation-response-header-bag.php');
+
+        expect($content)
+            ->toContain('?string $sameSite = null, bool $partitioned = false')
+            ->not->toContain('func_get_arg')
+            ->not->toContain('func_num_args');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Symfony PDO session payloads type-stable through an AOT holder', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-pdo-session-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-foundation/Session/Storage/Handler';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/PdoSessionHandler.php', <<<'PHP'
+        <?php
+        class PdoSessionHandler
+        {
+            private function buildDsn(array $params, string $driver): string
+            {
+                $dsn = null;
+                switch ($driver) {
+                    case 'mysql':
+                        $dsn = 'mysql:';
+                        // If "unix_socket" is not in the query, we continue with the same process as pgsql
+                        // no break
+                    case 'pgsql':
+                        $dsn ??= 'pgsql:';
+                        if (isset($params['host']) && '' !== $params['host']) {
+                            $dsn .= 'host='.$params['host'].';';
+                        }
+                        if (isset($params['port']) && '' !== $params['port']) {
+                            $dsn .= 'port='.$params['port'].';';
+                        }
+                        if (isset($params['path'])) {
+                            $dbName = substr($params['path'], 1); // Remove the leading slash
+                            $dsn .= 'dbname='.$dbName.';';
+                        }
+                        return $dsn;
+                }
+            }
+
+            private function getInsertStatement(#[\SensitiveParameter] string $sessionId, string $sessionData, int $maxlifetime): \PDOStatement
+            {
+                        $data = fopen('php://memory', 'r+');
+                        fwrite($data, $sessionData);
+                        rewind($data);
+                        $data = $sessionData;
+                $stmt->bindParam(':data', $data, \PDO::PARAM_LOB);
+            }
+
+            private function getUpdateStatement(#[\SensitiveParameter] string $sessionId, string $sessionData, int $maxlifetime): \PDOStatement
+            {
+                        $data = fopen('php://memory', 'r+');
+                        fwrite($data, $sessionData);
+                        rewind($data);
+                        $data = $sessionData;
+                $stmt->bindParam(':data', $data, \PDO::PARAM_LOB);
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-http-foundation-pdo-session-handler.php');
+
+        expect(substr_count($content, '$dataHolder = new \stdClass();'))
+            ->toBe(2)
+            ->and($content)
+            ->toContain('fwrite($dataHolder->value, $sessionData)')
+            ->toContain('rewind($dataHolder->value)')
+            ->toContain('$dataHolder->value = $sessionData')
+            ->toContain("bindParam(':data', \$dataHolder->value, \\PDO::PARAM_LOB)")
+            ->not->toContain('// no break')->toContain("case 'mysql':\n                \$dsn = 'mysql:';")->toContain(
+                "return \$dsn;\n\n            case 'pgsql':",
+            )
+            ->not->toContain('$data = fopen')
+            ->not->toContain('$data = $sessionData');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('makes Symfony URI expiration explicit in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-uri-signer-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-foundation';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/UriSigner.php', <<<'PHP'
+        <?php
+        class UriSigner
+        {
+            public function sign(string $uri/* , \DateTimeInterface|\DateInterval|int|null $expiration = null */): string
+            {
+                $expiration = null;
+
+                if (1 < \func_num_args()) {
+                    $expiration = func_get_arg(1);
+                }
+
+                return $uri;
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-http-foundation-uri-signer.php');
+
+        expect($content)
+            ->toContain('sign(string $uri, \DateTimeInterface|\DateInterval|int|null $expiration = null)')
+            ->not->toContain('func_get_arg')
+            ->not->toContain('func_num_args')
+            ->not->toContain('$expiration = null;');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Symfony controller strings separate from resolved callables for AOT', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-controller-resolver-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-kernel/Controller';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/ControllerResolver.php', <<<'PHP'
+        <?php
+        class ControllerResolver
+        {
+            protected function createController(string $controller): callable
+            {
+                if (!str_contains($controller, '::')) {
+                    $controller = $this->instantiateController($controller);
+
+                    if (!\is_callable($controller)) {
+                        throw new \InvalidArgumentException($this->getControllerError($controller));
+                    }
+
+                    return $controller;
+                }
+
+                [$class, $method] = explode('::', $controller, 2);
+
+                try {
+                    $controller = [$this->instantiateController($class), $method];
+                } catch (\Error|\LogicException $e) {
+                    throw $e;
+                }
+
+                if (!\is_callable($controller)) {
+                    throw new \InvalidArgumentException($this->getControllerError($controller));
+                }
+
+                return $controller;
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-http-kernel-controller-resolver.php');
+
+        expect($content)
+            ->toContain('$controllerInstance = $this->instantiateController($controller)')
+            ->toContain('return $controllerInstance;')
+            ->toContain('$controllerCallable = [$this->instantiateController($class), $method]')
+            ->toContain('return $controllerCallable;')
+            ->not->toContain('$controller = $this->instantiateController')
+            ->not->toContain('$controller = [$this->instantiateController');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('makes Symfony exception log channels explicit in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-error-listener-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-kernel/EventListener';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/ErrorListener.php', <<<'PHP'
+        <?php
+        class ErrorListener
+        {
+            protected function logException(\Throwable $exception, string $message, ?string $logLevel = null/* , ?string $logChannel = null */): void
+            {
+                $logChannel = (3 < \func_num_args() ? func_get_arg(3) : null) ?? $this->resolveLogChannel($exception);
+            }
+
+            private function getInheritedAttribute(string $class, string $attribute): ?object
+            {
+                $class = new \ReflectionClass($class);
+                $interfaces = [];
+                $parentInterfaces = [];
+                do {
+                    if ($attributes = $class->getAttributes($attribute, \ReflectionAttribute::IS_INSTANCEOF)) {
+                        $parentInterfaces = class_implements($class->name);
+                    }
+                    $interfaces[] = class_implements($class->name);
+                } while ($class = $class->getParentClass());
+
+                while ($interfaces) {
+                    foreach ($interfaces as $interface) {
+                        $class = new \ReflectionClass($interface);
+
+                        if ($attributes = $class->getAttributes($attribute, \ReflectionAttribute::IS_INSTANCEOF)) {
+                        }
+                    }
+                }
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-http-kernel-error-listener.php');
+
+        expect($content)
+            ->toContain('?string $logLevel = null, ?string $logChannel = null')
+            ->toContain('$logChannel ??= $this->resolveLogChannel($exception);')
+            ->not->toContain('func_get_arg')
+            ->not->toContain('func_num_args')->toContain('$reflectionClass = new \ReflectionClass($class);')->toContain(
+                '$interfaceReflection = new \ReflectionClass($interface);',
+            )
+            ->not->toContain('$class = new \ReflectionClass');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('avoids Symfony private session container shadowing in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-session-listener-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-kernel/EventListener';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/SessionListener.php', <<<'PHP'
+        <?php
+        class SessionListener
+        {
+            public function __construct(
+                private ?ContainerInterface $container = null,
+                bool $debug = false,
+                array $sessionOptions = [],
+            ) {
+                parent::__construct($container, $debug, $sessionOptions);
+            }
+
+            protected function getSession(): mixed
+            {
+                return $this->container->has('session_factory')
+                    ? $this->container->get('session_factory')
+                    : null;
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-http-kernel-session-listener.php');
+
+        expect($content)
+            ->toContain('private ?ContainerInterface $sessionContainer = null')
+            ->toContain('parent::__construct($sessionContainer, $debug, $sessionOptions)')
+            ->toContain('$this->sessionContainer->has')
+            ->toContain('$this->sessionContainer->get')
+            ->not->toContain('$this->container->');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('uses the stable Symfony main request value in the AOT interface default', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-http-kernel-interface-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-kernel';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/HttpKernelInterface.php', <<<'PHP'
+        <?php
+        interface HttpKernelInterface
+        {
+            public const MAIN_REQUEST = 1;
+            public const SUB_REQUEST = 2;
+
+            public function handle(Request $request, int $type = self::MAIN_REQUEST, bool $catch = true): Response;
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-http-kernel-interface.php');
+
+        expect($content)
+            ->toContain('public const MAIN_REQUEST = 1;')
+            ->toContain('public const SUB_REQUEST = 2;')
+            ->toContain('int $type = 1')
+            ->not->toContain('int $type = self::MAIN_REQUEST');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('avoids Symfony private MIME encoder shadowing in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-parameterized-header-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/mime/Header';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/ParameterizedHeader.php', <<<'PHP'
+        <?php
+        class ParameterizedHeader
+        {
+            private ?Rfc2231Encoder $encoder = null;
+
+            public function encode(): string
+            {
+                $this->encoder = new Rfc2231Encoder();
+
+                return $this->encoder->encodeString('value');
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-mime-parameterized-header.php');
+
+        expect($content)
+            ->toContain('private ?Rfc2231Encoder $parameterEncoder = null')
+            ->toContain('$this->parameterEncoder = new Rfc2231Encoder()')
+            ->toContain('$this->parameterEncoder->encodeString')
+            ->not->toContain('$this->encoder');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps ThinkORM table input separate from its normalized array result for AOT', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-base-query-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/db';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/BaseQuery.php', <<<'PHP'
+        <?php
+        class BaseQuery
+        {
+            protected function tableStr(string $table): array | string
+            {
+                if (!str_contains($table, ',')) {
+                    if (str_contains($table, ' ')) {
+                        [$item, $alias] = explode(' ', $table);
+                        $table          = [];
+                        $table[$item] = $alias;
+                    }
+                } else {
+                    $tables = explode(',', $table);
+                    $table  = [];
+                    foreach ($tables as $item) {
+                        $table[] = $item;
+                    }
+                }
+                return $table;
+            }
+
+            /**
+             * 指定多个数据表（数组格式）.
+             */
+            protected function tableArr(array $tables): array
+            {
+                return $tables;
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-base-query.php');
+
+        expect($content)
+            ->toContain('$tableState = new \stdClass()')
+            ->toContain('$tableState->value = $table')
+            ->toContain('$tableState->value[$item]')
+            ->toContain('$tableState->value[] = $item')
+            ->toContain('return $tableState->value')
+            ->not->toContain('$table  = []')
+            ->not->toContain('$table          = []');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps ThinkORM relation result mutable across array and model states for AOT', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-relation-query-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/db/concern';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/ModelRelationQuery.php', <<<'PHP'
+        <?php
+        trait ModelRelationQuery
+        {
+            protected function resultToModel(array &$result): void
+            {
+                $result = $this->model->newInstance($result);
+                $result->setSuffix($this->suffix);
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-model-relation-query.php');
+
+        expect($content)->toContain('resultToModel(mixed &$result)')->not->toContain('resultToModel(array &$result)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('stores the ThinkORM find result in a dynamic property before model conversion for AOT', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-find-result-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/db';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/BaseQuery.php', <<<'PHP'
+        <?php
+        class BaseQuery
+        {
+            public function find($data = null, ?Closure $closure = null)
+            {
+                if (empty($this->options['where']) && empty($this->options['scope']) && empty($this->options['order']) && empty($this->options['sort'])) {
+                    $result = [];
+                } else {
+                    $result = $this->connection->find($this);
+                }
+
+                // 数据处理
+                if (empty($result)) {
+                    return $this->resultToEmpty($closure);
+                }
+
+                if (!empty($this->model)) {
+                    // 返回模型对象
+                    $this->resultToModel($result);
+                } else {
+                    $this->result($result);
+                }
+
+                return $result;
+            }
+
+            /**
+             * 分析表达式（可用于查询或者写入操作）.
+             */
+            public function parseExpression(): void
+            {
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-base-query.php');
+
+        expect($content)
+            ->toContain('$resultState = new \stdClass()')
+            ->toContain('$resultState->value = $this->connection->find($this)')
+            ->toContain('$this->resultToModel($resultState->value)')
+            ->toContain('return $resultState->value')
+            ->not->toContain('$this->resultToModel($result)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('accepts the connection argument supplied to ThinkORM model transaction closures for AOT', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-model-transactions-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/Model.php', <<<'PHP'
+        <?php
+        class Model
+        {
+            public function write(): void
+            {
+                $db->transaction(function () use ($data, $allowFields, $db) {});
+                $db->transaction(function () use ($data, $sequence, $allowFields, $db) {});
+                $result = $db->transaction(function () use ($replace, $dataSet) {});
+                $db->transaction(function () use ($where, $db) {});
+                $untouched = function () {};
+            }
+
+            public static function query(): Query
+            {
+                return (new static())->db();
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-model.php');
+
+        expect(substr_count($content, 'transaction(function ($connection) use'))
+            ->toBe(4)
+            ->and($content)
+            ->toContain('$untouched = function () {}')
+            ->toContain('public static function where(...$args)')
+            ->toContain("return static::__callStatic('where', \$args)")
+            ->not->toContain('transaction(function () use');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps ThinkORM relation names distinct from false in attribute lookup for AOT', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-attribute-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/model/concern';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/Attribute.php', <<<'PHP'
+        <?php
+        trait Attribute
+        {
+            public function getAttr(string $name)
+            {
+                try {
+                    $relation = false;
+                    if ($this->mapping) {
+                        $name = array_search($name, $this->mapping) ?: $name;
+                    }
+                    $value    = $this->getData($name);
+                } catch (InvalidArgumentException $e) {
+                    $relation = $this->isRelationAttr($name);
+                    $value    = null;
+                }
+
+                return $this->getValue($name, $value, $relation);
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-attribute.php');
+
+        expect($content)
+            ->toContain('return $this->getValue($name, null, $this->isRelationAttr($name))')
+            ->toContain('return $this->getValue($name, $value, false)')
+            ->not->toContain('$relation = false')
+            ->not->toContain('$relation = $this->isRelationAttr($name)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('returns formatted ThinkORM timestamps before the integer fallback fixes their type for AOT', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-time-stamp-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/model/concern';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/TimeStamp.php', <<<'PHP'
+        <?php
+        trait TimeStamp
+        {
+            protected function getTimeTypeValue(string $type)
+            {
+                $value = time();
+                switch ($type) {
+                    case 'datetime':
+                    case 'date':
+                    case 'timestamp':
+                        $value = $this->formatDateTime('Y-m-d H:i:s.u');
+                        break;
+                    default:
+                        if (str_contains($type, '\\')) {
+                            $obj = new $type();
+                            if ($obj instanceof Stringable) {
+                                $value = $obj->__toString();
+                            }
+                        }
+                }
+                return $value;
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-time-stamp.php');
+
+        expect($content)
+            ->toContain("return \$this->formatDateTime('Y-m-d H:i:s.u')")
+            ->toContain('return $obj->__toString()')
+            ->toContain("                break;\n        }")
+            ->toContain('return $value')
+            ->not->toContain("\$value = \$this->formatDateTime('Y-m-d H:i:s.u')");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps ThinkORM result set mutable across array and collection states for AOT', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-result-operation-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/db/concern';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/ResultOperation.php', <<<'PHP'
+        <?php
+        trait ResultOperation
+        {
+            protected function resultSet(array &$resultSet, bool $toCollection = true): void
+            {
+                if ($toCollection) {
+                    $resultSet = new Collection($resultSet);
+                }
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-result-operation.php');
+
+        expect($content)->toContain('resultSet(mixed &$resultSet')->not->toContain('resultSet(array &$resultSet');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps ThinkORM column input separate from its parsed field array for AOT', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-fetch-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/db';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/Fetch.php', <<<'PHP'
+        <?php
+        class Fetch
+        {
+            public function column(string $field): void
+            {
+                $field = array_map('trim', explode(',', $field));
+
+                $this->query->setOption('field', $field);
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-fetch.php');
+
+        expect($content)
+            ->toContain('$columnFields = array_map')
+            ->toContain("setOption('field', \$columnFields)")
+            ->not->toContain('$field = array_map');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps ThinkORM insert IDs type-flexible through an AOT state holder', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-pdo-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/db';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/PDOConnection.php', <<<'PHP'
+        <?php
+        class PDOConnection
+        {
+            public function getTableInfo(array | string $tableName, string $fetch = '')
+            {
+                return [];
+            }
+
+            public function getFieldsType($tableName, ?string $field = null)
+            {
+                return [];
+            }
+
+            public function getTableFieldsInfo(string $tableName): array
+            {
+                $info = [];
+                foreach ($this->getFields($tableName) as $key => $val) {
+                    if (!empty($val['primary'])) {
+                        $pk[] = $key;
+                    }
+                }
+
+                if (isset($pk)) {
+                    $pk          = count($pk) > 1 ? $pk : $pk[0];
+                    $info['_pk'] = $pk;
+                }
+
+                return $info;
+            }
+
+            protected function autoInsIDType(BaseQuery $query, string $insertId)
+            {
+                if ($query->asInt()) {
+                    $insertId = (int) $insertId;
+                } elseif ($query->asFloat()) {
+                    $insertId = (float) $insertId;
+                }
+
+                return $insertId;
+            }
+
+            protected function multiConnect(bool $master = false): PDO
+            {
+                $config = [];
+                $m = 0;
+                $r = 1;
+                $dbMaster = false;
+
+                if ($m != $r) {
+                    $dbMaster = [];
+                    foreach (['hostname'] as $name) {
+                        $dbMaster[$name] = $config[$name][$m] ?? $config[$name][0];
+                    }
+                }
+
+                $dbConfig = [];
+
+                return $this->connect($dbConfig, $r, $r == $m ? false : $dbMaster);
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-pdo-connection.php');
+
+        expect($content)
+            ->toContain('getTableInfo(mixed $tableName, string $fetch = \'\')')
+            ->toContain('getFieldsType(mixed $tableName, ?string $field = null)')
+            ->toContain('$info[\'_pk\'] = count($pk) > 1 ? $pk : $pk[0]')
+            ->not->toContain('$pk          = count($pk) > 1')->toContain('$insertIdState = new \stdClass()')->toContain(
+                '$insertIdState->value = (int) $insertId',
+            )->toContain('$insertIdState->value = (float) $insertId')->toContain('return $insertIdState->value')
+            ->not->toContain('$insertId = (int)')->toContain('$dbMasterState = new \stdClass()')->toContain(
+                '$dbMasterState->value = []',
+            )->toContain('$dbMasterState->value[$name] =')->toContain('$dbMasterState->value)')
+            ->not->toContain('$dbMaster = false');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('uses a static ThinkORM query class for the AOT instanceof check', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-where-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/db/concern';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/WhereQuery.php', "<?php\n        if (\$field instanceof \$this) {}\n");
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-where-query.php');
+
+        expect($content)
+            ->toContain('$queryClass = get_class($this)')
+            ->toContain('$field instanceof $queryClass')
+            ->not->toContain('$field instanceof BaseQuery')
+            ->not->toContain('$field instanceof $this');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('initializes ThinkORM insert-all field state explicitly for AOT', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-base-builder-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/db';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/BaseBuilder.php', <<<'PHP'
+        <?php
+        class BaseBuilder
+        {
+            public function insertAll(array $dataSet): array
+            {
+                $fields = [];
+                $values = [];
+
+                foreach ($dataSet as $data) {
+                    if (!isset($insertFields)) {
+                        $insertFields = array_keys($data);
+                    }
+                }
+                return $insertFields;
+            }
+        }
+        PHP);
+    mkdir($sourceDirectory . '/builder', 0777, true);
+    file_put_contents($sourceDirectory . '/builder/Mysql.php', str_replace(
+        'class BaseBuilder',
+        'class Mysql',
+        (string) file_get_contents($sourceDirectory . '/BaseBuilder.php'),
+    ));
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        foreach (['think-orm-base-builder.php', 'think-orm-mysql-builder.php'] as $target) {
+            $content = file_get_contents($directory . '/.typephp/build/' . $target);
+
+            expect($content)
+                ->toContain('$insertFields = [];')
+                ->toContain('$hasInsertFields = false;')
+                ->toContain('if (!$hasInsertFields)')
+                ->toContain('$hasInsertFields = true;')
+                ->not->toContain('isset($insertFields)');
+        }
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('makes SaiAdmin crontab switch cases terminal in the AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-saiadmin-crontab-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/plugin/saiadmin/app/logic/tool';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/CrontabLogic.php', <<<'PHP'
+        <?php
+        class CrontabLogic
+        {
+            public function run(int $type): bool
+            {
+                switch ($type) {
+                    case 1:
+                        try {
+                            return true;
+                        } catch (\Exception $e) {
+                            return false;
+                        }
+                    case 2:
+                        try {
+                            return true;
+                        } catch (\Exception $e) {
+                            return false;
+                        }
+                    case 3:
+                        if ($type) {
+                            return true;
+                        } else {
+                            return false;
+                        }
+                    default:
+                        return false;
+                }
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/saiadmin-crontab-logic.php');
+
+        expect(substr_count($content, '                break;'))->toBe(3);
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Symfony console event objects in distinct AOT variables', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-console-application-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/console';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/Application.php', <<<'PHP'
+        <?php
+        class Application
+        {
+            protected function doRunCommand($command, $input, $output): int
+            {
+                $event = new ConsoleCommandEvent($command, $input, $output);
+                $e = null;
+
+                try {
+                    $this->dispatcher->dispatch($event, ConsoleEvents::COMMAND);
+
+                    if ($event->commandShouldRun()) {
+                        $exitCode = $command->run($input, $output);
+                    }
+                } catch (\Throwable $e) {
+                    $event = new ConsoleErrorEvent($input, $output, $e, $command);
+                    $this->dispatcher->dispatch($event, ConsoleEvents::ERROR);
+                    $e = $event->getError();
+
+                    if (0 === $exitCode = $event->getExitCode()) {
+                        $e = null;
+                    }
+                }
+
+                $event = new ConsoleTerminateEvent($command, $input, $output, $exitCode);
+                $this->dispatcher->dispatch($event, ConsoleEvents::TERMINATE);
+
+                if (null !== $e) {
+                    throw $e;
+                }
+
+                return $event->getExitCode();
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-console-application.php');
+
+        expect($content)
+            ->toContain('$commandEvent = new ConsoleCommandEvent')
+            ->toContain('$errorEvent = new ConsoleErrorEvent')
+            ->toContain('$terminateEvent = new ConsoleTerminateEvent')
+            ->toContain('return $terminateEvent->getExitCode();');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('matches ThinkORM dynamic parser calls to their AOT arity', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-builder-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/db';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents(
+        $sourceDirectory . '/Builder.php',
+        "<?php\n                return \$this->\$fun(\$query, \$key, \$exp, \$value, \$field, \$bindType, \$val[2] ?? 'AND');\n",
+    );
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-builder.php');
+
+        expect($content)
+            ->toContain('$fun === \'parseLike\'')
+            ->toContain('$this->$fun($query, $key, $exp, $value, $field, $bindType, $val[2] ?? \'AND\')')
+            ->toContain('[\'parseRegexp\', \'parseFindInSet\']')
+            ->toContain('$this->$fun($query, $key, $exp, $value, $field);')
+            ->toContain(
+                '[\'parseCompare\', \'parseBetween\', \'parseIn\', \'parseExp\', \'parseNull\', \'parseBetweenTime\', \'parseTime\', \'parseExists\', \'parseColumn\']',
+            )
+            ->toContain('$this->$fun($query, $key, $exp, $value, $field, $bindType);');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('replaces the SaiAdmin CodeEngine runtime constant guard with a declaration', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-saiadmin-code-engine-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/plugin/saiadmin/utils/code';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/CodeEngine.php', <<<'PHP'
+        <?php
+        namespace plugin\saiadmin\utils\code;
+
+        // 定义目录分隔符常量
+        defined('DS') or define('DS', DIRECTORY_SEPARATOR);
+
+        class CodeEngine
+        {
+            public function templatePath(): string
+            {
+                return base_path() . DS . 'plugin';
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/saiadmin-code-engine.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/saiadmin-code-engine.php');
+        expect($source)
+            ->toContain('const DS = DIRECTORY_SEPARATOR;')
+            ->not->toContain("defined('DS')")
+            ->not->toContain("define('DS'");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('stabilizes SaiAdmin captcha colors and uses a packaged runtime font in AOT', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-saiadmin-captcha-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/plugin/saiadmin/utils';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/Captcha.php', <<<'PHP'
+        <?php
+        class Captcha
+        {
+            public static function imageCaptcha(): array
+            {
+                $captcha = new CaptchaBuilder();
+                $captcha->setBackgroundColor(242, 243, 245);
+                $captcha->build(120, 36);
+                $uuid = Uuid::uuid4();
+                $key = $uuid->toString();
+                return ['uuid' => $key];
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/saiadmin-captcha.php');
+
+        expect($content)
+            ->toContain('$captcha->setLineColor(180, 180, 180);')
+            ->toContain('$captcha->build(120, 36, base_path(\'vendor/webman/captcha/src/Font/captcha0.ttf\'));')
+            ->toContain('Uuid::uuid4()')
+            ->toContain('$uuid->toString()');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('uses explicit SaiAdmin public routes when TypePHP reflection omits protected defaults', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-saiadmin-reflection-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/plugin/saiadmin/app/cache';
+    $controllerDirectory = $directory . '/plugin/saiadmin/app/controller';
+    mkdir($sourceDirectory, 0777, true);
+    mkdir($controllerDirectory, 0777, true);
+    file_put_contents(
+        $controllerDirectory . '/LoginController.php',
+        "<?php\nclass LoginController\n{\n"
+        . "    protected array \$noNeedLogin = ['captcha', 'login', 'refresh'];\n"
+        . "    public function captcha() : Response {}\n}\n",
+    );
+    file_put_contents(
+        $controllerDirectory . '/InstallController.php',
+        "<?php\nclass InstallController\n{\n"
+        . "    protected array \$noNeedLogin = ['index', 'install'];\n"
+        . "    public function index() {}\n}\n",
+    );
+    $source = <<<'PHP'
+        <?php
+        class ReflectionCache
+        {
+            public static function getNoNeedLogin(string $controller): array
+            {
+                // 反射逻辑
+                if (class_exists($controller)) {
+                    $ref = new ReflectionClass($controller);
+                    $data = $ref->getDefaultProperties()['noNeedLogin'] ?? [];
+                } else {
+                    $data = [];
+                }
+                return $data;
+            }
+        }
+        PHP;
+    file_put_contents($sourceDirectory . '/ReflectionCache.php', $source);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/saiadmin-reflection-cache.php');
+
+        expect($content)
+            ->toContain('LoginController::class')
+            ->toContain('$data = [\'captcha\', \'login\', \'refresh\'];')
+            ->toContain('InstallController::class')
+            ->toContain('$data = [\'index\', \'install\'];')
+            ->toContain('elseif (class_exists($controller))');
+
+        file_put_contents($sourceDirectory . '/ReflectionCache.php', str_replace(
+            '// 反射逻辑',
+            '// upstream changed',
+            $source,
+        ));
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(RuntimeException::class, 'SaiAdmin reflection compatibility rule expected 1 match(es), found 0');
+
+        file_put_contents($sourceDirectory . '/ReflectionCache.php', $source);
+        file_put_contents(
+            $controllerDirectory . '/LoginController.php',
+            "<?php\nclass LoginController\n{\n"
+            . "    protected array \$noNeedLogin = self::PUBLIC_ACTIONS;\n"
+            . "    public function captcha() : Response {}\n}\n",
+        );
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(RuntimeException::class, 'requires a static noNeedLogin list');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('declares the SaiAdmin captcha request argument in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-saiadmin-login-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/plugin/saiadmin/app/controller';
+    mkdir($sourceDirectory, 0777, true);
+    $source = <<<'PHP'
+        <?php
+        use support\Request;
+        use support\Response;
+        class LoginController
+        {
+            public function captcha() : Response
+            {
+                return new Response();
+            }
+        }
+        PHP;
+    file_put_contents($sourceDirectory . '/LoginController.php', $source);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/saiadmin-login-controller.php');
+
+        expect($content)
+            ->toContain('public function captcha(Request $request) : Response')
+            ->not->toContain('public function captcha() : Response');
+
+        file_put_contents($sourceDirectory . '/LoginController.php', str_replace(
+            'captcha() : Response',
+            'captcha(Request $request) : Response',
+            $source,
+        ));
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'SaiAdmin controller request arity compatibility rule expected 1 match(es), found 0',
+            );
+
+        file_put_contents($sourceDirectory . '/LoginController.php', $source . "\n" . $source);
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'SaiAdmin controller request arity compatibility rule expected 1 match(es), found 2',
+            );
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('makes the SaiAdmin system exception previous cause explicitly nullable', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-saiadmin-system-exception-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/plugin/saiadmin/exception';
+    mkdir($sourceDirectory, 0777, true);
+    $source = <<<'PHP'
+        <?php
+        use Throwable;
+        class SystemException extends RuntimeException
+        {
+            public function __construct($message, $code = 400, Throwable $previous = null)
+            {
+                parent::__construct($message, $code, $previous);
+            }
+        }
+        PHP;
+    file_put_contents($sourceDirectory . '/SystemException.php', $source);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/saiadmin-system-exception.php');
+
+        expect($content)->toContain('?Throwable $previous = null')->not->toContain(', Throwable $previous = null');
+
+        file_put_contents($sourceDirectory . '/SystemException.php', str_replace(
+            ', Throwable $previous = null)',
+            ', ?Throwable $previous = null)',
+            $source,
+        ));
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'SaiAdmin system exception nullable cause compatibility rule expected 1 match(es), found 0',
+            );
+
+        file_put_contents($sourceDirectory . '/SystemException.php', $source . "\n" . $source);
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'SaiAdmin system exception nullable cause compatibility rule expected 1 match(es), found 2',
+            );
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('aligns the Nelexa response stream with PSR signatures in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-nelexa-response-stream-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/nelexa/zip/src/IO/Stream';
+    mkdir($sourceDirectory, 0777, true);
+    $source = <<<'PHP'
+        <?php
+        class ResponseStream
+        {
+            public function getMetadata($key = null)
+            {
+            }
+            public function tell()
+            {
+                return $this->stream ? ftell($this->stream) : false;
+            }
+            public function seek($offset, $whence = \SEEK_SET): void {}
+            public function write($string)
+            {
+                return $this->stream !== null && $this->writable ? fwrite($this->stream, $string) : false;
+            }
+            public function read($length): string {}
+        }
+        PHP;
+    file_put_contents($sourceDirectory . '/ResponseStream.php', $source);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/nelexa-response-stream.php');
+
+        expect($content)
+            ->toContain('tell(): int')
+            ->toContain('seek(int $offset, int $whence')
+            ->toContain('write(string $string): int')
+            ->toContain('read(int $length): string');
+
+        file_put_contents($sourceDirectory . '/ResponseStream.php', str_replace(
+            'public function tell()',
+            'public function tell(): int',
+            $source,
+        ));
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'SaiAdmin Nelexa PSR stream signature compatibility rule expected 1 match(es), found 0',
+            );
+
+        file_put_contents($sourceDirectory . '/ResponseStream.php', $source . "\n" . $source);
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'SaiAdmin Nelexa PSR stream signature compatibility rule expected 1 match(es), found 2',
+            );
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('matches ThinkORM collection callbacks to each value and key arguments', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-think-orm-collection-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/topthink/think-orm/src/model';
+    mkdir($sourceDirectory, 0777, true);
+    $closure = '$this->each(function (Model $model) { return $model; });';
+    file_put_contents($sourceDirectory . '/Collection.php', "<?php\n" . str_repeat($closure . "\n", 10));
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/think-orm-model-collection.php');
+        expect(substr_count($content, 'function (Model $model, int|string $key)'))->toBe(10);
+
+        file_put_contents($sourceDirectory . '/Collection.php', "<?php\n" . str_repeat($closure . "\n", 9));
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'SaiAdmin ThinkORM collection callback arity compatibility rule expected 10 match(es), found 9',
+            );
+
+        file_put_contents($sourceDirectory . '/Collection.php', "<?php\n" . str_repeat($closure . "\n", 11));
+        expect(fn(): array => $generator->generateSwitchTerminalSources())
+            ->toThrow(
+                RuntimeException::class,
+                'SaiAdmin ThinkORM collection callback arity compatibility rule expected 10 match(es), found 11',
+            );
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('passes integral pixel coordinates to GD in the Webman captcha AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-webman-captcha-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/webman/captcha/src';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/CaptchaBuilder.php', '<?php return imagecolorat($image, $x, $y);');
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/webman-captcha-builder.php');
+
+        expect($content)
+            ->toContain('imagecolorat($image, (int) $x, (int) $y)')
+            ->not->toContain('imagecolorat($image, $x, $y)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Symfony uploaded filesize parsing type-stable for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/symfony/http-foundation/File', 0777, true);
+    file_put_contents($directory . '/vendor/symfony/http-foundation/File/UploadedFile.php', <<<'PHP'
+        <?php
+        class UploadedFile
+        {
+            private int $error = 0;
+
+            public function move(): void
+            {
+                switch ($this->error) {
+                }
+            }
+
+            private static function parseFilesize(string $size): int|float
+            {
+                $size = strtolower($size);
+                $max = ltrim($size, '+');
+                if (str_starts_with($max, '0x')) {
+                    $max = \intval($max, 16);
+                } elseif (str_starts_with($max, '0')) {
+                    $max = \intval($max, 8);
+                } else {
+                    $max = (int) $max;
+                }
+                switch (substr($size, -1)) {
+                    case 't': $max *= 1024;
+                        // no break
+                    case 'g': $max *= 1024;
+                        // no break
+                    case 'm': $max *= 1024;
+                        // no break
+                    case 'k': $max *= 1024;
+                }
+                return $max;
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/symfony-http-foundation-uploaded-file.php',
+        ]);
+        $source = (string) file_get_contents($directory . '/.typephp/build/symfony-http-foundation-uploaded-file.php');
+        expect($source)
+            ->toContain('$maxString = ltrim')
+            ->toContain('switch ((int) $this->error)')
+            ->toContain('case \'t\': $max *= 1024 * 1024 * 1024 * 1024; break;')
+            ->not->toContain('// no break');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/symfony/http-foundation/File/UploadedFile.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('rejects Illuminate Redis custom closure rebinding explicitly for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/redis', 0777, true);
+    file_put_contents($directory . '/vendor/illuminate/redis/RedisManager.php', <<<'PHP'
+        <?php
+        use Closure;
+        class RedisManager
+        {
+            public function extend($driver, Closure $callback)
+            {
+                $this->customCreators[$driver] = $callback->bindTo($this, $this);
+
+                return $this;
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/illuminate-redis-manager.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/illuminate-redis-manager.php');
+        expect($source)
+            ->toContain('AOT Redis custom driver closure binding is not supported.')
+            ->not->toContain('->bindTo(');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/illuminate/redis/RedisManager.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('uses the explicit owner for Carbon inherited default constants in AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/nesbot/carbon/src/Carbon', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/src/Carbon/CarbonInterface.php',
+        "<?php\nuse Carbon\\Constants\\TranslationOptions;\ninterface CarbonInterface extends TranslationOptions\n{\n"
+        . "    public static function translateTimeString(string \$timeString, ?string \$from = null, "
+        . "?string \$to = null, int \$mode = self::TRANSLATE_ALL): string;\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/carbon-interface.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/carbon-interface.php');
+        expect($source)
+            ->toContain('int $mode = TranslationOptions::TRANSLATE_ALL')
+            ->not->toContain('int $mode = self::TRANSLATE_ALL');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/nesbot/carbon/src/Carbon/CarbonInterface.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('folds Illuminate password facade contract constants in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/support/Facades', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/illuminate/support/Facades/Password.php',
+        "<?php\nclass Password\n{\n"
+        . "    const ResetLinkSent = PasswordBroker::RESET_LINK_SENT;\n"
+        . "    const PasswordReset = PasswordBroker::PASSWORD_RESET;\n"
+        . "    const InvalidUser = PasswordBroker::INVALID_USER;\n"
+        . "    const InvalidToken = PasswordBroker::INVALID_TOKEN;\n"
+        . "    const ResetThrottled = PasswordBroker::RESET_THROTTLED;\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/illuminate-support-password-facade.php',
+        ]);
+        $source = (string) file_get_contents($directory . '/.typephp/build/illuminate-support-password-facade.php');
+        expect($source)
+            ->toContain("const ResetLinkSent = 'passwords.sent';")
+            ->toContain("const PasswordReset = 'passwords.reset';")
+            ->toContain("const InvalidUser = 'passwords.user';")
+            ->toContain("const InvalidToken = 'passwords.token';")
+            ->toContain("const ResetThrottled = 'passwords.throttled';")
+            ->not->toContain('PasswordBroker::');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('rejects Illuminate custom instance closure rebinding explicitly for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/support', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/illuminate/support/MultipleInstanceManager.php',
+        "<?php\nclass MultipleInstanceManager\n{\n    public function extend(\$name, Closure \$callback)\n    {\n"
+        . "        \$this->customCreators[\$name] = \$callback->bindTo(\$this, \$this);\n"
+        . "        return \$this;\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/illuminate-support-multiple-instance-manager.php',
+        ]);
+        $source = (string) file_get_contents($directory
+        . '/.typephp/build/illuminate-support-multiple-instance-manager.php');
+        expect($source)
+            ->toContain('AOT custom instance creator closure binding is not supported.')
+            ->not->toContain('->bindTo(');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('defers Illuminate Sleep static reference storage in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/support', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/illuminate/support/Sleep.php',
+        "<?php\nclass Sleep\n{\n    public function run()\n    {\n        \$while = function () {\n"
+        . "            static \$return = [true, false];\n            return array_shift(\$return);\n        };\n"
+        . "        \$duration = CarbonInterval::seconds(0);\n"
+        . "        \$micro = CarbonInterval::microsecond(0);\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/illuminate-support-sleep.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/illuminate-support-sleep.php');
+        expect($source)
+            ->toContain("static \$return;\n            if (\$return === null)")
+            ->toContain('$return = [true, false];')
+            ->toContain('array_shift($return)')
+            ->toContain('new CarbonInterval(0, 0, 0, 0, 0, 0, 0)')
+            ->not->toContain('CarbonInterval::seconds(0)')->toContain('new CarbonInterval(0, 0, 0, 0, 0, 0, 0, 0)')
+            ->not->toContain('CarbonInterval::microsecond(0)')
+            ->not->toContain('static $return = [true, false];');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Illuminate excerpt strings separate from fluent objects in AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/support', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/illuminate/support/Str.php',
+        "<?php\nclass Str\n{\n    public static function excerpt(\$matches, \$radius)\n    {\n"
+        . "        \$start = ltrim(\$matches[1]);\n"
+        . "        \$start = Str::of(mb_substr(\$start, max(mb_strlen(\$start, 'UTF-8') - \$radius, 0), \$radius, 'UTF-8'))->ltrim()->unless(\n"
+        . "            fn (\$startWithRadius) => \$startWithRadius->exactly(\$start),\n        );\n"
+        . "        \$end = rtrim(\$matches[3]);\n"
+        . "        \$end = Str::of(mb_substr(\$end, 0, \$radius, 'UTF-8'))->rtrim()->unless(\n"
+        . "            fn (\$endWithRadius) => \$endWithRadius->exactly(\$end),\n        );\n"
+        . "        return \$start->append(\$matches[2], \$end)->toString();\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/illuminate-support-str.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/illuminate-support-str.php');
+        expect($source)
+            ->toContain('$startText = ltrim(')
+            ->toContain('mb_strlen($startText')
+            ->toContain('exactly($startText)')
+            ->toContain('$endText = rtrim(')
+            ->toContain('mb_substr($endText')
+            ->toContain('exactly($endText)')
+            ->toContain('return $start->append(');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Carbon dynamic unit property values type-stable for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/nesbot/carbon/src/Carbon/Traits', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/src/Carbon/Traits/Date.php',
+        "<?php\ntrait Date\n{\n    public function get(\$operator)\n    {\n"
+        . "                    \$value = \$operator === 'Of'\n"
+        . "                        ? floor(1.5)\n                        : round(1.5);\n\n"
+        . "                    \$result = \$result->subSecond();\n"
+        . "                    \$result = \$result->addSecond();\n"
+        . "                \$result = \$result->addDays(\$value - \$this->dayOfYear);\n"
+        . "                \$result = \$result->addDays(\$value - \$this->dayOfWeek);\n"
+        . "                \$result = \$result->addDays(\$value - \$this->dayOfWeekIso);\n"
+        . "                return \$this->addDays(\$value - \$dayOfYear);\n"
+        . "            \$boundMacro = @\$macro->bindTo(\$this, static::class) ?: @\$macro->bindTo(null, static::class);\n"
+        . "            return \\call_user_func_array(\$boundMacro ?: \$macro, \$parameters);\n"
+        . "                \$boundMacro = @Closure::bind(\$macro, null, static::class);\n"
+        . "                \$\$name = self::monthToInt(\$value, \$name);\n"
+        . "                \$result->\$name = \$value;\n"
+        . "                } catch (UnknownUnitException) {\n"
+        . "                    // default to macro\n"
+        . "                }\n\n"
+        . "            default:\n"
+        . "                \$macro = \$this->getLocalMacro('get'.ucfirst(\$name));\n"
+        . "                    return (int) \$value;\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/carbon-traits-date.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/carbon-traits-date.php');
+        expect($source)
+            ->toContain('$unitValue = $operator')
+            ->toContain('return (int) $unitValue;')
+            ->toContain('$result->addUnit(\'second\', -1)')
+            ->toContain('$result->addUnit(\'second\', 1)')
+            ->toContain('$result->addUnit(\'day\', $value - $this->dayOfYear)')
+            ->toContain('$result->addUnit(\'day\', $value - $this->dayOfWeek)')
+            ->toContain('$result->addUnit(\'day\', $value - $this->dayOfWeekIso)')
+            ->toContain('$this->addUnit(\'day\', $value - $dayOfYear)')
+            ->toContain('AOT Carbon closure macro binding is not supported.')
+            ->toContain('AOT Carbon static closure macro binding is not supported.')
+            ->not->toContain('->bindTo(')
+            ->not->toContain('Closure::bind(')
+            ->not->toContain('$boundMacro')->toContain(
+                '$normalizedValue = self::monthToInt($value, $name);',
+            )->toContain('case \'year\': $year = $normalizedValue; break;')->toContain(
+                'case \'second\': $second = $normalizedValue; break;',
+            )
+            ->not->toContain('$$name')
+            ->not->toContain('return (int) $value;');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/nesbot/carbon/src/Carbon/Traits/Date.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('expands Carbon boundary magic units into declared AOT calls', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/nesbot/carbon/src/Carbon/Traits', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/src/Carbon/Traits/Boundaries.php',
+        "<?php\ntrait Boundaries\n{\n    public function boundaries(\$weekStartsAt)\n    {\n"
+        . "        \$quarter = \$this->startOfQuarter()->addMonths(2)->endOfMonth();\n"
+        . "        \$start = \$this\n"
+        . "            ->subDays(\n"
+        . "                (static::DAYS_PER_WEEK + \$this->dayOfWeek - (WeekDay::int(\$weekStartsAt) ?? \$this->firstWeekDay)) %\n"
+        . "                static::DAYS_PER_WEEK,\n"
+        . "            )\n"
+        . "            ->startOfDay();\n"
+        . "        return \$this->addDays(1);\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/carbon-traits-boundaries.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/carbon-traits-boundaries.php');
+        expect($source)
+            ->toContain('->addUnit(\'month\', 2)')
+            ->toContain('->addUnit(\'day\', -(')
+            ->toContain('->addUnit(\'day\', 1)')
+            ->not->toContain('->addMonths(')
+            ->not->toContain('->addDays(')
+            ->not->toContain('->subDays(');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps the Carbon rounding parameter separate from range keys in AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/nesbot/carbon/src/Carbon/Traits', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/src/Carbon/Traits/Rounding.php',
+        "<?php\ntrait Rounding\n{\n    public function roundUnit(string \$unit, array \$ranges)\n    {\n"
+        . "        foreach (\$ranges as \$unit => [\$minimum, \$maximum]) {\n"
+        . "            if (\$normalizedUnit === \$unit) {\n"
+        . "                \$arguments = [\$this->\$unit, \$minimum];\n"
+        . "                \$initialValue = \$this->\$unit;\n            }\n"
+        . "                \$inc = (\$this->\$unit - \$minimum) * \$factor;\n"
+        . "                \$changes[\$unit] = round(\n"
+        . "                    \$minimum + (\$fraction ? \$fraction * \$function((\$this->\$unit - \$minimum) / \$fraction) : 0),\n"
+        . "            );\n"
+        . "                while (\$changes[\$unit] >= \$delta) {\n"
+        . "                    \$changes[\$unit] -= \$delta;\n            }\n        }\n"
+        . "        foreach (\$changes as \$unit => \$value) {\n"
+        . "            \$result = \$result->\$unit(\$value);\n        }\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/carbon-traits-rounding.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/carbon-traits-rounding.php');
+        expect($source)
+            ->toContain('foreach ($ranges as $rangeUnit =>')
+            ->toContain('$this->$rangeUnit')
+            ->toContain('$changes[$rangeUnit]')
+            ->toContain('foreach ($changes as $changeUnit => $value)')
+            ->toContain('$result->$changeUnit($value)')
+            ->not->toContain('foreach ($ranges as $unit =>');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('uses declared Carbon comparison methods in the AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/nesbot/carbon/src/Carbon/Traits', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/src/Carbon/Traits/Comparison.php',
+        "<?php\ntrait Comparison\n{\n"
+        . "    public function current(\$unit) { return \$this->{'isSame'.ucfirst(\$unit)}('now'); }\n"
+        . "    public function quarter(\$date) { return \$this->isSameYear(\$date); }\n"
+        . "}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/carbon-traits-comparison.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/carbon-traits-comparison.php');
+        expect($source)
+            ->toContain('$this->isSameUnit($unit, \'now\')')
+            ->toContain('$this->isSameUnit(\'year\', $date)')
+            ->not->toContain('$this->{\'isSame\'')
+            ->not->toContain('$this->isSameYear(');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('inlines Carbon validity semantics in the converter AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/nesbot/carbon/src/Carbon/Traits', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/src/Carbon/Traits/Converter.php',
+        "<?php\ntrait Converter\n{\n"
+        . "    public function iso() { if (!\$this->isValid()) { return null; } return CarbonInterval::day(); }\n"
+        . "}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/src/Carbon/Traits/Difference.php',
+        "<?php\ntrait Difference { public function day() { return CarbonInterval::day(); } "
+        . "public function hour() { return CarbonInterval::hour(); } }\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/src/Carbon/Traits/Creator.php',
+        "<?php\ntrait Creator\n{\n    public static function createSafe(\$year, \$month, \$day, \$hour, \$minute, \$second)\n"
+        . "    {\n        \$fields = static::getRangesByUnit();\n"
+        . "        foreach (\$fields as \$field => \$range) {\n"
+        . "            if (\$\$field !== null) { throw new InvalidDateException(\$field, \$\$field); }\n"
+        . "        }\n    }\n}\n",
+    );
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/src/Carbon/CarbonPeriod.php',
+        "<?php\nrequire PHP_VERSION < 8.2\n"
+        . "    ? __DIR__.'/../../lazy/Carbon/ProtectedDatePeriod.php'\n"
+        . "    : __DIR__.'/../../lazy/Carbon/UnprotectedDatePeriod.php';\n"
+        . "class CarbonPeriod { public function day() { return \\Carbon\\CarbonInterval::day(); } "
+        . 'public function month() { return CarbonInterval::month(); } '
+        . "public function dynamic(\$dateClass, \$part, \$start, \$value) { "
+        . "\$dateClass::make(\$part); "
+        . "\$dateClass::make(static::addMissingParts(\$start ?? '', \$part)); "
+        . "\$dateClass::now(); "
+        . "\$dateClass::isStrictModeEnabled(); "
+        . "\$dateClass::parse(\$value, \$this->timezoneSetting); "
+        . "} }\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/carbon-traits-creator.php',
+            '.typephp/build/carbon-traits-converter.php',
+            '.typephp/build/carbon-traits-difference.php',
+            '.typephp/build/carbon-period.php',
+        ]);
+        $creatorSource = (string) file_get_contents($directory . '/.typephp/build/carbon-traits-creator.php');
+        expect($creatorSource)
+            ->toContain('\'year\' => $year')
+            ->toContain('$fieldValues[$field]')
+            ->not->toContain('$$field');
+        $source = (string) file_get_contents($directory . '/.typephp/build/carbon-traits-converter.php');
+        expect($source)
+            ->toContain('if ($this->year === 0)')
+            ->toContain('new CarbonInterval(0, 0, 0, 1)')
+            ->not->toContain('$this->isValid()');
+        expect(file_get_contents($directory . '/.typephp/build/carbon-traits-difference.php'))
+            ->toContain('new CarbonInterval(0, 0, 0, 1)');
+        expect(file_get_contents($directory . '/.typephp/build/carbon-period.php'))
+            ->toContain('new \Carbon\CarbonInterval(0, 0, 0, 1)')
+            ->toContain('new CarbonInterval(0, 1)')
+            ->not->toContain('ProtectedDatePeriod.php')
+            ->not->toContain('UnprotectedDatePeriod.php')
+            ->not->toContain('\Carbon\new CarbonInterval');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('fails explicitly for Carbon interval trait mixin result copying in AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/nesbot/carbon/src/Carbon/Traits', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/src/Carbon/Traits/Mixin.php',
+        "<?php\ntrait Mixin\n{\n    public function copy(\$downContext, \$result)\n    {\n"
+        . "                    \$downContext->copyProperties(\$result);\n"
+        . "                    self::copyStep(\$downContext, \$result);\n"
+        . "                    self::copyNegativeUnits(\$downContext, \$result);\n"
+        . "    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/carbon-traits-mixin.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/carbon-traits-mixin.php');
+        expect($source)
+            ->toContain('AOT Carbon interval trait mixin result copying is not supported.')
+            ->not->toContain('self::copyStep(')
+            ->not->toContain('self::copyNegativeUnits(');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Carbon debug formatting dynamic in the Options AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/nesbot/carbon/src/Carbon/Traits', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/src/Carbon/Traits/Options.php',
+        "<?php\ntrait Options\n{\n    protected function addExtraDebugInfos(array &\$infos): void\n    {\n"
+        . "        if (\$this instanceof DateTimeInterface) {\n"
+        . "            \$infos['date'] ??= \$this->format(CarbonInterface::MOCK_DATETIME_FORMAT);\n"
+        . "        }\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/carbon-traits-options.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/carbon-traits-options.php');
+        expect($source)
+            ->toContain('\call_user_func([$this, \'format\'], CarbonInterface::MOCK_DATETIME_FORMAT)')
+            ->not->toContain('$this->format(');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('expands Carbon localization variable variables in the AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/nesbot/carbon/src/Carbon/Traits', 0777, true);
+    $fixture = <<<'PHP'
+        <?php
+        trait Localization
+        {
+            public static function translate($from, $to, $mode)
+            {
+                $fromTranslations = [];
+                $toTranslations = [];
+                foreach (['from', 'to'] as $key) {
+                    $language = $$key;
+                    $translationKey = $key.'Translations';
+                    $months = [];
+                    $weekdays = [];
+                        foreach (['months', 'weekdays'] as $variable) {
+                            $list = [];
+                            if ($list) {
+                                foreach ($$variable as $index => &$name) {
+                                    $name .= '|'.$list[$index];
+                                }
+                            }
+                        }
+                    }
+                    $$translationKey = array_merge(
+                        $months,
+                        $weekdays,
+                    );
+                }
+
+                // Make all dots optional
+                return [$fromTranslations, $toTranslations];
+            }
+        }
+        PHP;
+    file_put_contents($directory . '/vendor/nesbot/carbon/src/Carbon/Traits/Localization.php', $fixture);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/carbon-traits-localization.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/carbon-traits-localization.php');
+        expect($source)
+            ->toContain('$language = $key === \'from\' ? $from : $to;')
+            ->toContain('$months[$index] = $name.\'|\'.$list[$index];')
+            ->toContain('$fromTranslations = $translatedWords;')
+            ->toContain('$toTranslations = $translatedWords;')
+            ->not->toContain('$$');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('flattens the pinned Carbon DatePeriod base class guard for AOT ordering', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/nesbot/carbon/lazy/Carbon', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/nesbot/carbon/lazy/Carbon/UnprotectedDatePeriod.php',
+        "<?php\nnamespace Carbon;\nuse DatePeriod;\n"
+        . "if (!class_exists(DatePeriodBase::class, false)) {\n"
+        . "    class DatePeriodBase extends DatePeriod\n"
+        . "    {\n"
+        . "    }\n"
+        . "}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe(['.typephp/build/carbon-date-period-base.php']);
+        $source = (string) file_get_contents($directory . '/.typephp/build/carbon-date-period-base.php');
+        expect($source)->toContain('class DatePeriodBase extends DatePeriod')->not->toContain('if (!class_exists(');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('initializes the Eloquent aggregate alias slot explicitly for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/database/Eloquent/Concerns', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/illuminate/database/Eloquent/Concerns/QueriesRelationships.php',
+        "<?php\ntrait QueriesRelationships\n{\n    public function withAggregate(\$relations)\n    {\n"
+        . "        foreach (\$relations as \$name) {\n            unset(\$alias);\n"
+        . "            \$alias ??= \$name;\n        }\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/illuminate-eloquent-queries-relationships.php',
+        ]);
+        expect(file_get_contents($directory . '/.typephp/build/illuminate-eloquent-queries-relationships.php'))
+            ->toContain('$alias = null;')
+            ->not->toContain('unset($alias)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('expands the CarbonInterval milliseconds magic factory for AOT', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/support', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/illuminate/support/InteractsWithTime.php',
+        "<?php\ntrait InteractsWithTime\n{\n    protected function runTimeForHumans(\$runTime)\n    {\n"
+        . "        return CarbonInterval::milliseconds(\$runTime)->cascade()->forHumans(short: true);\n"
+        . "    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateSwitchTerminalSources())->toBe([
+            '.typephp/build/illuminate-support-interacts-with-time.php',
+        ]);
+        expect(file_get_contents($directory . '/.typephp/build/illuminate-support-interacts-with-time.php'))
+            ->toContain('new CarbonInterval(0, 0, 0, 0, 0, 0, 0, $runTime * 1000)')
+            ->not->toContain('CarbonInterval::milliseconds($runTime)');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/illuminate/support/InteractsWithTime.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('defers the Illuminate Collection unique reference storage', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/collections', 0777, true);
+    file_put_contents(
+        $directory . '/vendor/illuminate/collections/Collection.php',
+        "<?php\nclass Collection\n{\n    public function unique()\n    {\n"
+        . "        \$exists = [];\n\n        return \$this->reject(function (\$item) use (&\$exists) {\n"
+        . "            \$exists[] = \$item;\n        });\n    }\n}\n",
+    );
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateRefCaptureSources())->toBe(['.typephp/build/illuminate-collections-collection.php']);
+        expect(file_get_contents($directory . '/.typephp/build/illuminate-collections-collection.php'))
+            ->not
+            ->toContain('$exists = [];')
+            ->toContain('use (&$exists)');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/illuminate/collections/Collection.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('expands the LazyCollection sliding tap before yielding its window', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    mkdir($directory . '/vendor/illuminate/collections', 0777, true);
+    file_put_contents($directory . '/vendor/illuminate/collections/LazyCollection.php', <<<'PHP'
+        <?php
+        class LazyCollection
+        {
+            public function sliding($step)
+            {
+                return new static(function () use ($step) {
+                    $chunk = [];
+                    while (true) {
+                        if ($chunk === []) {
+                            yield (new static($chunk))->tap(function () use (&$chunk, $step) {
+                                $chunk = array_slice($chunk, $step, null, true);
+                            });
+                        }
+                    }
+                });
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateRefCaptureSources())->toBe([
+            '.typephp/build/illuminate-collections-lazy-collection.php',
+        ]);
+        $source = (string) file_get_contents($directory . '/.typephp/build/illuminate-collections-lazy-collection.php');
+        expect($source)
+            ->toContain('$window = new static($chunk);')
+            ->toContain('$chunk = array_slice($chunk, $step, null, true);')
+            ->toContain('yield $window;')
+            ->not->toContain('use (&$chunk, $step)');
+        expect(file_get_contents($generator->generateProjectYml([])))
+            ->toContain("\n  - vendor/illuminate/collections/LazyCollection.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('selects Symfony Redis 6 proxy trait declarations for the pinned extension', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $traits = $directory . '/vendor/symfony/cache/Traits';
+    mkdir($traits, 0777, true);
+    $source = <<<'PHP'
+        <?php
+        namespace Symfony\Component\Cache\Traits;
+
+        if (version_compare(phpversion('redis'), '6.1.0-dev', '>=')) {
+            trait Redis61ProxyTrait
+            {
+                public function modern(): \Redis|string|false {}
+            }
+        } else {
+            trait Redis61ProxyTrait
+            {
+                public function legacy(): \Redis|string {}
+            }
+        }
+        PHP;
+    file_put_contents($traits . '/Redis61ProxyTrait.php', $source);
+    file_put_contents($traits . '/RedisCluster61ProxyTrait.php', str_replace(
+        ['Redis61ProxyTrait', "'>='"],
+        ['RedisCluster61ProxyTrait', "'>'"],
+        $source,
+    ));
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        expect($generator->generateFlattenedSources())->toBe([
+            '.typephp/build/symfony-cache-redis61-proxy-trait.php',
+            '.typephp/build/symfony-cache-redis-cluster61-proxy-trait.php',
+        ]);
+
+        $aot = (string) file_get_contents($directory . '/.typephp/build/symfony-cache-redis61-proxy-trait.php');
+        expect($aot)
+            ->toContain('trait Redis61ProxyTrait')
+            ->toContain('function modern()')
+            ->not->toContain('function legacy()')
+            ->not->toContain("phpversion('redis')");
+        expect((string) file_get_contents($directory . '/.typephp/build/symfony-cache-redis-cluster61-proxy-trait.php'))
+            ->toContain('trait RedisCluster61ProxyTrait')
+            ->toContain('function modern()')
+            ->not->toContain('function legacy()');
+
+        $yml = (string) file_get_contents($generator->generateProjectYml([]));
+        expect($yml)
+            ->toContain('  - .typephp/build/symfony-cache-redis61-proxy-trait.php' . "\n")
+            ->toContain("\n  - vendor/symfony/cache/Traits/Redis61ProxyTrait.php\n");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('splits the Illuminate lazy proxy initializer before assigning its self reference', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $reflection = $directory . '/vendor/illuminate/reflection';
+    mkdir($reflection, 0777, true);
+    file_put_contents($reflection . '/helpers.php', <<<'PHP'
+        <?php
+        if (! function_exists('proxy')) {
+            function proxy($callback, $eager, $options)
+            {
+                $reflectionClass = new ReflectionClass('Example');
+                $proxy = $reflectionClass->newLazyProxy(function () use ($callback, $eager, &$proxy) {
+                    $instance = $callback($proxy, $eager);
+
+                    return $instance;
+                }, $options);
+                return $proxy;
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateFlattenedSources();
+        $aot = (string) file_get_contents($directory . '/.typephp/build/illuminate-reflection-helpers.php');
+        expect($aot)
+            ->toContain('$proxyInitializer = function () use ($callback, $eager, &$proxy) {')
+            ->toContain('$proxy = $reflectionClass->newLazyProxy($proxyInitializer, $options);')
+            ->not->toContain('$proxy = $reflectionClass->newLazyProxy(function ()');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Illuminate replacement arrays mutable through an AOT reference slot', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $support = $directory . '/vendor/illuminate/support';
+    mkdir($support, 0777, true);
+    file_put_contents($support . '/helpers.php', <<<'PHP'
+        <?php
+        if (! function_exists('preg_replace_array')) {
+            function preg_replace_array($pattern, array $replacements, $subject): string
+            {
+                return preg_replace_callback($pattern, function () use (&$replacements) {
+                    return array_shift($replacements);
+                }, $subject);
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateFlattenedSources();
+        $aot = (string) file_get_contents($directory . '/.typephp/build/illuminate-support-helpers.php');
+        expect($aot)
+            ->toContain('function () use ($replacements, &$remaining) {')
+            ->toContain('$remaining = $replacements;')
+            ->toContain('return array_shift($remaining);')
+            ->not->toContain('use (&$replacements)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Symfony dump branch keys type-stable in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $functions = $directory . '/vendor/symfony/var-dumper/Resources/functions';
+    mkdir($functions, 0777, true);
+    file_put_contents($functions . '/dump.php', <<<'PHP'
+        <?php
+        if (!function_exists('dump')) {
+            function dump(mixed ...$vars): mixed
+            {
+                if (array_key_exists(0, $vars) && 1 === count($vars)) {
+                    VarDumper::dump($vars[0]);
+                    $k = 0;
+                } else {
+                    foreach ($vars as $k => $v) {
+                        VarDumper::dump($v);
+                    }
+                }
+                return $vars[$k];
+            }
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateFlattenedSources();
+        $aot = (string) file_get_contents($directory . '/.typephp/build/symfony-var-dumper-functions.php');
+        expect($aot)->toContain('return $vars[0];')->not->toContain('$k = 0;')->not->toContain('return $vars[$k];');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps the PHPMailer header encoding selector string-typed in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/phpmailer/phpmailer/src';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/PHPMailer.php', <<<'PHP'
+        <?php
+        class PHPMailer {
+            public $Debugoutput = 'echo';
+
+            public function encodeHeader(string $str, string $position): string {
+                $matchcount = 0;
+                switch (strtolower($position)) {
+                    /* @noinspection PhpMissingBreakStatementInspection */
+                    case 'comment':
+                        $matchcount = preg_match_all('/[()"]/', $str, $matches);
+                    //fallthrough
+                    case 'text':
+                    default:
+                        $matchcount += preg_match_all('/[\000-\010\013\014\016-\037\177-\377]/', $str, $matches);
+                        break;
+                }
+                if ($matchcount > 0) {
+                    $encoding = 'Q';
+                } else {
+                    $encoding = false;
+                }
+                return $encoding ?: 'plain';
+            }
+
+            public function edebug(string $str): void {
+                switch ($this->Debugoutput) {
+                    case 'error_log':
+                        error_log($str);
+                        break;
+                    case 'echo':
+                    default:
+                        echo gmdate('Y-m-d H:i:s'),
+                        "\n";
+                }
+            }
+
+            public function encodeQ(string $position): string {
+                $pattern = '';
+                switch (strtolower($position)) {
+                    /* @noinspection PhpMissingBreakStatementInspection */
+                    case 'comment':
+                        $pattern = '\(\)"';
+                    /* Intentional fall through */
+                    case 'text':
+                    default:
+                        //RFC 2047 section 5.1
+                        //Replace every high ascii, control, =, ? and _ characters
+                        $pattern = '\000-\011\013\014\016-\037\075\077\137\177-\377' . $pattern;
+                        break;
+                }
+                return $pattern;
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/phpmailer.php');
+        expect($generated)
+            ->toContain('$encoding = \'\';')
+            ->not->toContain('$encoding = false;')
+            ->not->toContain('//fallthrough')->toContain(
+                "\$matchcount = preg_match_all('/[()\"]/', \$str, \$matches);\n"
+                . "                \$matchcount += preg_match_all('/[\\000-\\010\\013\\014\\016-\\037\\177-\\377]/', \$str, \$matches);\n"
+                . '                break;',
+            )->toContain(
+                "case 'comment':\n"
+                . "                \$pattern = '\\000-\\011\\013\\014\\016-\\037\\075\\077\\137\\177-\\377\\(\\)\"';\n"
+                . '                break;',
+            )->toContain("                \"\\n\";\n                break;\n        }");
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('avoids Ramsey private property shadowing in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/ramsey/collection/src';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/DoubleEndedQueue.php', <<<'PHP'
+        <?php
+        class DoubleEndedQueue extends Queue {
+            public function __construct(private readonly string $queueType, array $data = [])
+            {
+                parent::__construct($this->queueType, $data);
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/ramsey-double-ended-queue.php');
+        expect($generated)
+            ->toContain('public function __construct(string $queueType')
+            ->toContain('parent::__construct($queueType, $data);')
+            ->not->toContain('private readonly string $queueType');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Ramsey PHP time string inputs separate from integer objects in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/ramsey/uuid/src/Converter/Time';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/PhpTimeConverter.php', <<<'PHP'
+        <?php
+        class PhpTimeConverter {
+            public function calculateTime(string $seconds, string $microseconds) {
+                $seconds = new IntegerObject($seconds);
+                $microseconds = new IntegerObject($microseconds);
+                return [$seconds->toString(), $microseconds->toString()];
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/ramsey-php-time-converter.php');
+        expect($generated)
+            ->toContain('$secondsValue = new IntegerObject($seconds);')
+            ->toContain('$microsecondsValue->toString()')
+            ->not->toContain('$seconds = new IntegerObject($seconds);');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps SaiPackage empty-directory path segments separate in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/saithink/saipackage/src/service';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/Filesystem.php', <<<'PHP'
+        <?php
+        class Filesystem {
+            public static function delEmptyDir(string $path): void {
+                $path = str_replace(base_path() . DIRECTORY_SEPARATOR, '', rtrim($path, DIRECTORY_SEPARATOR));
+                $path = array_filter(explode(DIRECTORY_SEPARATOR, $path));
+                for ($i = count($path) - 1; $i >= 0; $i--) {
+                    $dirPath = base_path() . DIRECTORY_SEPARATOR . implode(DIRECTORY_SEPARATOR, $path);
+                    unset($path[$i]);
+                }
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/saipackage-filesystem.php');
+        expect($generated)
+            ->toContain('$pathParts = array_filter(')
+            ->toContain('unset($pathParts[$i]);')
+            ->not->toContain('$path = array_filter(');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps SaiPackage terminal output values type-stable in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/saithink/saipackage/src/service';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/Terminal.php', <<<'PHP'
+        <?php
+        class Terminal {
+            public function output(string $data): string {
+                $data = [
+                    'data'   => $data,
+                    'uuid'   => $this->uuid,
+                    'extend' => $this->extend,
+                    'key'    => $this->commandKey,
+                ];
+                $data = json_encode($data, JSON_UNESCAPED_UNICODE);
+                if ($data === false) {
+                    $data = json_encode(['error' => 'JSON encode error'], JSON_UNESCAPED_UNICODE);
+                }
+                return $data;
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/saipackage-terminal.php');
+        expect($generated)
+            ->toContain('$payload = [')
+            ->toContain('$encoded = json_encode($payload')
+            ->toContain('return \'{"error":"JSON encode error"}\';')
+            ->not->toContain('$data = [');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps SaiPackage version strings separate from their parts in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/saithink/saipackage/src/service';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/Version.php', <<<'PHP'
+        <?php
+        class Version {
+            public static function compare(string $v1, bool|string $v2): bool {
+                $v1 = explode('.', $v1);
+                $v2 = explode('.', $v2);
+                for ($i = 0; $i < count($v1); $i++) {
+                    if (!isset($v2[$i])) break;
+                    if ($v1[$i] < $v2[$i]) return true;
+                }
+                return count($v1) !== count($v2);
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/saipackage-version.php');
+        expect($generated)->toContain('$v1Parts = explode')->toContain('$v2Parts[$i]')->not->toContain('$v1 = explode');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Symfony command names separate from aliases in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'typephp-test-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/console/Attribute';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/AsCommand.php', <<<'PHP'
+        <?php
+        class AsCommand {
+            public function __construct(public string $name, array $aliases = [], bool $hidden = false) {
+                $name = explode('|', $name);
+                $name = array_merge($name, $aliases);
+                if ($hidden && '' !== $name[0]) array_unshift($name, '');
+                $this->name = implode('|', $name);
+            }
+        }
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = (string) file_get_contents($directory . '/.typephp/build/symfony-console-as-command.php');
+        expect($generated)
+            ->toContain('$commandNames = explode')
+            ->toContain('array_unshift($commandNames,')
+            ->not->toContain('$name = explode');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Symfony output chunk widths separate from line indexes in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-output-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/console/Formatter';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/OutputFormatter.php', <<<'PHP'
+        <?php
+                    $prefix = Helper::substr($lines[0], 0, $i = $width - $currentLineLength)."\n";
+                    $text = Helper::substr($lines[0], $i);
+        foreach ($lines as $i => $line) {
+        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generated = $generator->generateSwitchTerminalSources();
+        $target = $directory . '/.typephp/build/symfony-console-output-formatter.php';
+
+        expect($generated)
+            ->toContain('.typephp/build/symfony-console-output-formatter.php')
+            ->and(file_get_contents($target))
+            ->toContain('$chunkWidth = $width - $currentLineLength')
+            ->toContain('Helper::substr($lines[0], $chunkWidth)')
+            ->not->toContain('$i = $width - $currentLineLength');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('makes the Symfony progress finished indicator explicit in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-progress-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/console/Helper';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/ProgressIndicator.php', <<<'PHP'
+        <?php
+            public function finish(string $message/* , ?string $finishedIndicator = null */): void
+            {
+                $finishedIndicator = 1 < \func_num_args() ? func_get_arg(1) : null;
+                if (null !== $finishedIndicator && !\is_string($finishedIndicator)) {
+                    throw new \TypeError(\sprintf('Argument 2 passed to "%s()" must be of the type string or null, "%s" given.', __METHOD__, get_debug_type($finishedIndicator)));
+                }
+            }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-console-progress-indicator.php');
+
+        expect($content)
+            ->toContain('finish(string $message, ?string $finishedIndicator = null)')
+            ->not->toContain('func_get_arg')
+            ->not->toContain('func_num_args');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps Symfony question input sentinels separate from string answers in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-question-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/console/Helper';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/QuestionHelper.php', implode("\n", [
+        '<?php',
+        '            $ret = false;',
+        '                    $ret = $question->isTrimmable() ? trim($hiddenResponse) : $hiddenResponse;',
+        '            if (false === $ret) {',
+        '                $ret = $this->readInput($inputStream, $question);',
+        '                if (false === $ret) {',
+        '                if ($question->isTrimmable()) {',
+        '        $ret = \strlen($ret) > 0 ? $ret : $question->getDefault();',
+        '',
+        '        if ($normalizer = $question->getNormalizer()) {',
+        '            return $normalizer($ret);',
+        '        }',
+        '',
+        '        return $ret;',
+    ]));
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-console-question-helper.php');
+
+        expect($content)
+            ->toContain('$hasAnswer = false;')
+            ->toContain('$inputAnswer = $this->readInput')
+            ->toContain('$answer = \strlen($ret) > 0')
+            ->not->toContain('$ret = false;')
+            ->not->toContain('if (false === $ret)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('avoids Symfony style private output property shadowing in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-style-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/console/Style';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/SymfonyStyle.php', implode("\n", [
+        '<?php',
+        '    private TrimmedBufferOutput $bufferedOutput;',
+        '    public function __construct(',
+        '        private InputInterface $input,',
+        '        private OutputInterface $output,',
+        '    ) {',
+        '        $this->bufferedOutput = new TrimmedBufferOutput($output);',
+        '        parent::__construct($output);',
+        '        $this->output->write("ready");',
+        '    }',
+        '        $question = new Question($question, $default);',
+        '        $question->setValidator($validator);',
+        '',
+        '        return $this->askQuestion($question);',
+        '        $question = new Question($question);',
+        '',
+        '        $question->setHidden(true);',
+        '        $question->setValidator($validator);',
+        '',
+        '        return $this->askQuestion($question);',
+    ]));
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-console-symfony-style.php');
+
+        expect($content)
+            ->toContain('private OutputInterface $styleOutput;')
+            ->toContain('OutputInterface $output,')
+            ->toContain('$this->styleOutput = $output;')
+            ->toContain('$this->styleOutput->write')
+            ->toContain('$questionObject = new Question($question')
+            ->toContain('$this->askQuestion($questionObject)')
+            ->not->toContain('private OutputInterface $output,');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('avoids a reference to an unkeyed Symfony listener append slot in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-dispatcher-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/event-dispatcher';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/EventDispatcher.php', <<<'PHP'
+        <?php
+                        $closure = &$this->optimized[$eventName][];
+                        if (\is_array($listener) && isset($listener[0]) && $listener[0] instanceof \Closure && 2 >= \count($listener)) {
+                            $closure = static function (...$args) use (&$listener, &$closure) {
+                                if ($listener[0] instanceof \Closure) {
+                                    $listener[0] = $listener[0]();
+                                    $listener[1] ??= '__invoke';
+                                }
+                                ($closure = $listener(...))(...$args);
+                            };
+                        } else {
+                            $closure = $listener instanceof WrappedListener ? $listener : $listener(...);
+                        }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-event-dispatcher.php');
+
+        expect($content)
+            ->toContain('$this->optimized[$eventName][] = $closure;')
+            ->toContain('$listener(...$args);')
+            ->not->toContain('$closure = &$this->optimized')
+            ->not->toContain('use (&$listener, &$closure)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('preserves Symfony lazy listener arrays in its AOT interface copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-dispatcher-interface-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/event-dispatcher';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/EventDispatcherInterface.php', implode("\n", [
+        '<?php',
+        'public function addListener(string $eventName, callable $listener, int $priority = 0): void;',
+        'public function removeListener(string $eventName, callable $listener): void;',
+        'public function getListenerPriority(string $eventName, callable $listener): ?int;',
+    ]));
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-event-dispatcher-interface.php');
+
+        expect(substr_count((string) $content, 'callable|array $listener'))->toBe(3);
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('separates Symfony accept header attributes from its promoted string value in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-accept-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-foundation';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/AcceptHeaderItem.php', <<<'PHP'
+        <?php
+                foreach ($attributes as $name => $value) {
+                    $this->setAttribute($name, $value);
+                }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-http-foundation-accept-header-item.php');
+
+        expect($content)->toContain('as $name => $attributeValue')->toContain('setAttribute($name, $attributeValue)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('separates Symfony query input from its parsed array result in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-query-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-foundation';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/HeaderUtils.php', <<<'PHP'
+        <?php
+                $query = [];
+
+                foreach ($q as $k => $v) {
+                    if (false !== $i = strpos($k, '_')) {
+                        $query[substr_replace($k, hex2bin(substr($k, 0, $i)).'[', 0, 1 + $i)] = $v;
+                    } else {
+                        $query[hex2bin($k)] = $v;
+                    }
+                }
+
+                return $query;
+            }
+
+            private static function groupParts(array $matches, string $separators): array
+            {
+                foreach ($partMatches as $matches) {
+                    if ('' === $separators && '' !== $unquoted = self::unquote($matches[0][0])) {
+                        $parts[] = $unquoted;
+                    } elseif ($groupedParts = self::groupParts($matches, $separators, false)) {
+                    }
+                }
+            }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-http-foundation-header-utils.php');
+
+        expect($content)
+            ->toContain('$parsedQuery = [];')
+            ->toContain('as $encodedKey => $v')
+            ->toContain('$parsedQuery[substr_replace($encodedKey')
+            ->toContain('$parsedQuery[hex2bin($encodedKey)]')
+            ->toContain('return $parsedQuery;')
+            ->toContain('as $groupMatches')
+            ->toContain('self::groupParts($groupMatches');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('makes Symfony IP anonymization byte counts explicit in its AOT copy', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-symfony-ip-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/symfony/http-foundation';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/IpUtils.php', <<<'PHP'
+        <?php
+            public static function anonymize(string $ip/* , int $v4Bytes = 1, int $v6Bytes = 8 */): string
+            {
+                $v4Bytes = 1 < \func_num_args() ? func_get_arg(1) : 1;
+                $v6Bytes = 2 < \func_num_args() ? func_get_arg(2) : 8;
+
+            }
+        PHP);
+
+    try {
+        $generator = new ProjectGenerator($directory);
+        $generator->generateSwitchTerminalSources();
+        $content = file_get_contents($directory . '/.typephp/build/symfony-http-foundation-ip-utils.php');
+
+        expect($content)
+            ->toContain('anonymize(string $ip, int $v4Bytes = 1, int $v6Bytes = 8)')
+            ->not->toContain('func_get_arg')
+            ->not->toContain('func_num_args');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('keeps runtime-only mail and callable streams dynamic while stabilizing native scalar expressions', function (): void {
+    expect(ProjectGenerator::REGISTERED_DYNAMIC_SOURCES)
+        ->toContain('vendor/guzzlehttp/psr7/src/FnStream.php')
+        ->toContain('vendor/monolog/monolog/src/Monolog/Handler/Slack/SlackRecord.php')
+        ->toContain('vendor/phpmailer/phpmailer/src/POP3.php')
+        ->toContain('vendor/phpmailer/phpmailer/src/SMTP.php')
+        ->toContain('vendor/symfony/http-kernel/EventListener/DebugHandlersListener.php')
+        ->toContain('vendor/symfony/polyfill-mbstring')
+        ->toContain('vendor/symfony/polyfill-php83')
+        ->toContain('vendor/symfony/translation/Command')
+        ->toContain('vendor/cakephp')
+        ->toContain('vendor/league/container')
+        ->toContain('vendor/robmorgan/phinx');
+
+    $directory = sys_get_temp_dir() . '/typephp-native-scalars-' . bin2hex(random_bytes(4));
+    $fixtures = [
+        'app/process/Monitor.php' => '<?php $this->ppid = function_exists(\'posix_getppid\') ? posix_getppid() : 0;',
+        'vendor/godruoyi/php-snowflake/src/Snowflake.php' => '<?php return floor(microtime(true) * 1000) | 0;',
+        'vendor/godruoyi/php-snowflake/src/Sonyflake.php' => <<<'PHP'
+            <?php
+            $elapsedTime = floor(($this->getCurrentMillisecond() - $millisecond) / 10) | 0;
+            return floor(($this->getCurrentMillisecond() - $this->getStartTimeStamp()) / 10) | 0;
+            PHP,
+        'vendor/guzzlehttp/guzzle/src/Handler/CurlMultiHandler.php' => <<<'PHP'
+            <?php
+                    static $options = null;
+
+                    if ($options !== null) {
+                        return $options;
+                    }
+
+                    $options = [];
+            PHP,
+        'vendor/symfony/console/Helper/QuestionHelper.php' => '<?php $i = mb_strlen($fullChoice, $encoding);',
+        'vendor/symfony/console/Helper/SymfonyQuestionHelper.php' => <<<'PHP'
+            <?php
+            class SymfonyQuestionHelper extends QuestionHelper
+            {
+                public function writePrompt(mixed $default): void
+                {
+                    switch (true) {
+                        default:
+                            $text = \sprintf(' <info>%s</info> [<comment>%s</comment>]:', $text, OutputFormatter::escape($default));
+                    }
+                }
+            }
+            PHP,
+        'vendor/symfony/console/Output/AnsiColorMode.php' => '<?php return round($b / 255) << 2 | (round($g / 255) << 1) | round($r / 255);',
+        'vendor/symfony/console/Output/ConsoleSectionOutput.php' => <<<'PHP'
+            <?php
+            class ConsoleSectionOutput extends StreamOutput
+            {
+                public function __construct(
+                    $stream,
+                    array &$sections,
+                    int $verbosity,
+                ) {
+                    $this->sections = &$sections;
+                }
+
+                public function clear(): void
+                {
+                    $this->lines -= (int) ceil($this->getDisplayLength($lastLine) / $width) ?: 1;
+                }
+            }
+            PHP,
+        'vendor/symfony/http-foundation/BinaryFileResponse.php' => <<<'PHP'
+            <?php
+            $this->maxlen = $end < $fileSize ? $end - $start + 1 : -1;
+            $read = $length > $this->chunkSize || 0 > $length ? $this->chunkSize : $length;
+            PHP,
+        'vendor/symfony/http-foundation/Session/Storage/Handler/SessionHandlerFactory.php' => <<<'PHP'
+            <?php
+            class SessionHandlerFactory
+            {
+                public function create(array $params, object $config, array $options): object
+                {
+                    switch (true) {
+                        case true:
+                            $connection = DriverManager::getConnection($params, $config)->getNativeConnection();
+                            // no break;
+                        default:
+                            return new PdoSessionHandler($connection, $options);
+                    }
+                }
+            }
+            PHP,
+        'vendor/symfony/mime/Header/AbstractHeader.php' => <<<'PHP'
+            <?php
+            class AbstractHeader
+            {
+                public function encode(string $token): string
+                {
+                            $firstChar = substr($token, 0, 1);
+                            switch ($firstChar) {
+                                case ' ':
+                                case "\t":
+                                    $value .= $firstChar;
+                                    $token = substr($token, 1);
+                            }
+                    return $token;
+                }
+            }
+            PHP,
+        'vendor/symfony/http-kernel/Log/Logger.php' => <<<'PHP'
+            <?php
+            class Logger
+            {
+                public function record(string $level): void
+                {
+                    switch ($level) {
+                        case 'error':
+                            ++$this->errorCount[$key];
+                    }
+                }
+            }
+            PHP,
+        'vendor/symfony/polyfill-php80/Php80.php' => '<?php switch (preg_last_error()) {',
+        'vendor/symfony/translation/PseudoLocalizationTranslator.php' => '<?php return mb_strlen($s, $encoding);',
+    ];
+
+    foreach ($fixtures as $path => $content) {
+        $fixtureDirectory = dirname($directory . '/' . $path);
+        if (!is_dir($fixtureDirectory)) {
+            mkdir($fixtureDirectory, 0777, true);
+        }
+        file_put_contents($directory . '/' . $path, $content);
+    }
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+
+        expect(file_get_contents($directory . '/.typephp/build/app-process-monitor.php'))
+            ->toContain('? (int) posix_getppid() : 0;');
+        expect(file_get_contents($directory . '/.typephp/build/godruoyi-snowflake.php'))
+            ->toContain('return (int) floor(microtime(true) * 1000);');
+        expect(file_get_contents($directory . '/.typephp/build/godruoyi-sonyflake.php'))
+            ->toContain('$elapsedTime = (int) floor(')
+            ->toContain('return (int) floor(')
+            ->not->toContain('| 0');
+        expect(file_get_contents($directory . '/.typephp/build/guzzle-curl-multi-handler.php'))
+            ->not
+            ->toContain('static $options')
+            ->toContain('$options = [];');
+        expect(file_get_contents($directory . '/.typephp/build/symfony-console-question-helper.php'))
+            ->toContain('(int) mb_strlen($fullChoice, $encoding)');
+        expect(file_get_contents($directory . '/.typephp/build/symfony-console-symfony-question-helper.php'))
+            ->toContain("OutputFormatter::escape(\$default));\n                break;");
+        expect(file_get_contents($directory . '/.typephp/build/symfony-console-ansi-color-mode.php'))
+            ->toContain('(int) round($b / 255)');
+        expect(file_get_contents($directory . '/.typephp/build/symfony-console-section-output.php'))
+            ->toContain('$previousLineCount = max(1, (int) ceil(')
+            ->toContain('mixed &$sections');
+        expect(file_get_contents($directory . '/.typephp/build/symfony-http-foundation-binary-file-response.php'))
+            ->toContain('? (int) ($end - $start + 1) : -1;')
+            ->toContain('$length > (int) $this->chunkSize');
+        expect(file_get_contents($directory . '/.typephp/build/symfony-session-handler-factory.php'))
+            ->toContain("getNativeConnection();\n\n                return new PdoSessionHandler");
+        expect(file_get_contents($directory . '/.typephp/build/symfony-mime-abstract-header.php'))
+            ->toContain("\$token = substr(\$token, 1);\n                        break;");
+        expect(file_get_contents($directory . '/.typephp/build/symfony-http-kernel-logger.php'))
+            ->toContain("++\$this->errorCount[\$key];\n                break;");
+        expect(file_get_contents($directory . '/.typephp/build/symfony-php80.php'))
+            ->toContain('switch ((int) preg_last_error())');
+        expect(file_get_contents($directory . '/.typephp/build/symfony-pseudo-localization-translator.php'))
+            ->toContain('(int) mb_strlen($s, $encoding)');
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('materializes inherited Eloquent relation methods required by AOT trait registration', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-eloquent-relation-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/illuminate/database/Eloquent/Relations';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents(
+        $sourceDirectory . '/HasOne.php',
+        "<?php\nclass HasOne extends HasOneOrMany implements SupportsPartialRelations\n{\n}\n",
+    );
+    file_put_contents(
+        $sourceDirectory . '/MorphOne.php',
+        "<?php\nclass MorphOne extends MorphOneOrMany implements SupportsPartialRelations\n{\n}\n",
+    );
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+
+        foreach (['illuminate-eloquent-has-one.php', 'illuminate-eloquent-morph-one.php'] as $file) {
+            expect(file_get_contents($directory . '/.typephp/build/' . $file))
+                ->toContain('public function getParentKey()')
+                ->toContain('return parent::getParentKey();');
+        }
+    } finally {
+        removeTypephpTestDirectory($directory);
+    }
+});
+
+it('passes explicit path strings across Webman config internal function boundaries', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-webman-config-' . bin2hex(random_bytes(4));
+    $sourceDirectory = $directory . '/vendor/workerman/webman-framework/src';
+    mkdir($sourceDirectory, 0777, true);
+    file_put_contents($sourceDirectory . '/Config.php', <<<'PHP'
+        <?php
+        if (is_dir($file) || $file->getExtension() != 'php') {
+            continue;
+        }
+        $relativePath = substr($file, 0, -4);
+        $config = include $file;
+        PHP);
+
+    try {
+        new ProjectGenerator($directory)->generateSwitchTerminalSources();
+        $generated = file_get_contents($directory . '/.typephp/build/webman-config.php');
+
+        expect($generated)
+            ->toContain('if ($file->isDir() ||')
+            ->toContain('substr((string) $file, 0, -4)')
+            ->toContain('$config = include (string) $file;')
+            ->not->toContain('is_dir($file)');
     } finally {
         removeTypephpTestDirectory($directory);
     }
diff --git a/tests/Unit/SaiAdminProfileTest.php b/tests/Unit/SaiAdminProfileTest.php
new file mode 100644
index 0000000..5b640a0
--- /dev/null
+++ b/tests/Unit/SaiAdminProfileTest.php
@@ -0,0 +1,240 @@
+<?php
+
+declare(strict_types=1);
+
+use Tinywan\Typephp\Compiler\Profile\SaiAdminProfile;
+
+function removeSaiAdminProfileFixture(string $directory): void
+{
+    if (!is_dir($directory)) {
+        return;
+    }
+    foreach (scandir($directory) ?: [] as $name) {
+        if ($name === '.' || $name === '..') {
+            continue;
+        }
+        $path = $directory . DIRECTORY_SEPARATOR . $name;
+        if (is_dir($path)) {
+            removeSaiAdminProfileFixture($path);
+        } else {
+            unlink($path);
+        }
+    }
+    rmdir($directory);
+}
+
+function createSaiAdminProfileFixture(
+    string $directory,
+    string $ormVersion = 'v3.0.34',
+    string $saiAdminVersion = '6.1.1',
+    string $webmanVersion = 'dev-master',
+    string $workermanVersion = 'dev-master',
+): void {
+    foreach ([
+        'app/controller',
+        'app/model',
+        'support',
+        'plugin/saiadmin/app/controller',
+        'vendor/saithink/saiadmin/src/plugin/saiadmin/app/controller',
+        'plugin/saiadmin/config',
+        'plugin/saiadmin/db/data',
+        'plugin/saiadmin/public',
+        'plugin/example/app/controller',
+        'plugin/example/app/view',
+        'vendor/nesbot/carbon/src/Carbon/Traits',
+    ] as $path) {
+        mkdir($directory . '/' . $path, 0777, true);
+    }
+    foreach ([
+        'app/controller/HomeController.php',
+        'app/model/Test.php',
+        'support/Request.php',
+        'plugin/saiadmin/app/controller/LoginController.php',
+        'plugin/example/app/controller/ExampleController.php',
+    ] as $path) {
+        file_put_contents($directory . '/' . $path, "<?php\nclass Fixture {}\n");
+    }
+    file_put_contents(
+        $directory . '/vendor/saithink/saiadmin/src/plugin/saiadmin/app/controller/LoginController.php',
+        "<?php\nclass Fixture {}\n",
+    );
+    file_put_contents($directory . '/support/bootstrap.php', "<?php\nreturn true;\n");
+    file_put_contents($directory . '/plugin/saiadmin/config/app.php', "<?php\nreturn [];\n");
+    file_put_contents($directory . '/plugin/saiadmin/db/data/demo.php', "<?php\nreturn [];\n");
+    file_put_contents($directory . '/plugin/example/app/view/page.php', "<?php\n");
+    foreach ([
+        'Cast',
+        'DeprecatedPeriodProperties',
+        'IntervalRounding',
+        'IntervalStep',
+        'LocalFactory',
+        'Macro',
+        'MagicParameter',
+        'Modifiers',
+        'Mutability',
+        'ObjectInitialisation',
+        'Serialization',
+        'StaticLocalization',
+        'StaticOptions',
+        'Test',
+        'Timestamp',
+        'ToStringFormat',
+        'Units',
+        'Week',
+    ] as $trait) {
+        file_put_contents(
+            $directory . "/vendor/nesbot/carbon/src/Carbon/Traits/{$trait}.php",
+            "<?php\ntrait {$trait} {}\n",
+        );
+    }
+    file_put_contents($directory . '/composer.lock', json_encode([
+        'packages' => [
+            ['name' => 'saithink/saiadmin', 'version' => $saiAdminVersion],
+            ['name' => 'topthink/think-orm', 'version' => $ormVersion],
+            ['name' => 'nesbot/carbon', 'version' => '3.13.2'],
+            [
+                'name' => 'workerman/webman-framework',
+                'version' => $webmanVersion,
+            ],
+            [
+                'name' => 'workerman/workerman',
+                'version' => $workermanVersion,
+            ],
+        ],
+    ], JSON_THROW_ON_ERROR));
+}
+
+it('discovers SaiAdmin and installed plugin business sources and resources', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-saiadmin-profile-' . bin2hex(random_bytes(4));
+    createSaiAdminProfileFixture($directory);
+
+    try {
+        $profile = new SaiAdminProfile($directory);
+        expect($profile->assertSupported())
+            ->toBe([
+                'saithink/saiadmin' => '6.1.1',
+                'topthink/think-orm' => 'v3.0.34',
+                'nesbot/carbon' => '3.13.2',
+            ])
+            ->and($profile->sources())
+            ->toContain('support', 'plugin/saiadmin', 'plugin/example/app')
+            ->and($profile->dependencySources())
+            ->toBe(['vendor'])
+            ->and($profile->mergeCompilerSources([
+                'main.php',
+                'vendor',
+                'vendor/nikic/fast-route/src/Route.php',
+                '.typephp/build/fast-route-functions.php',
+            ]))
+            ->toBe([
+                'main.php',
+                'vendor',
+                '.typephp/build/fast-route-functions.php',
+                'app',
+                'plugin/example/app',
+                'plugin/saiadmin',
+                'support',
+            ])
+            ->and($profile->runtimeResources())
+            ->toContain('plugin/saiadmin/config', 'plugin/saiadmin/public', 'plugin/example/app/view')
+            ->and($profile->filterUserIgnores([
+                'app/model',
+                'app',
+                'app/view',
+                'support',
+                'support/bootstrap.php',
+                'vendor/example/tests',
+            ]))
+            ->toBe(['app/view', 'support/bootstrap.php', 'vendor/example/tests']);
+
+        $manifest = $profile->writeCoverageManifest(
+            ['app', 'support', 'plugin/saiadmin', 'plugin/example/app', '.typephp/build/login.php'],
+            [
+                'support/bootstrap.php',
+                'plugin/saiadmin/config',
+                'plugin/saiadmin/public',
+                'plugin/example/app/view',
+                'plugin/saiadmin/app/controller/LoginController.php',
+            ],
+            ['plugin/saiadmin/app/controller/LoginController.php' => '.typephp/build/login.php'],
+        );
+        expect($manifest['counts'])
+            ->toBe(['compiled' => 4, 'generated' => 1])
+            ->and(file_exists($directory . '/.typephp/build/source-coverage.json'))
+            ->toBeTrue();
+    } finally {
+        removeSaiAdminProfileFixture($directory);
+    }
+});
+
+it('does not reject SaiAdmin by version before applying structural compatibility rules', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-saiadmin-profile-' . bin2hex(random_bytes(4));
+
+    try {
+        createSaiAdminProfileFixture($directory, saiAdminVersion: '6.1.5');
+        expect(new SaiAdminProfile($directory)->assertSupported()['saithink/saiadmin'])->toBe('6.1.5');
+
+        foreach (['6.1.0', '6.1.6-beta.1', '6.2.0'] as $version) {
+            $lock = file_get_contents($directory . '/composer.lock');
+            file_put_contents($directory . '/composer.lock', str_replace('6.1.5', $version, (string) $lock));
+            expect(new SaiAdminProfile($directory)->assertSupported()['saithink/saiadmin'])->toBe($version);
+            file_put_contents($directory . '/composer.lock', (string) $lock);
+        }
+    } finally {
+        removeSaiAdminProfileFixture($directory);
+    }
+});
+
+it('rejects a composer version that does not match the installed SaiAdmin source', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-saiadmin-profile-' . bin2hex(random_bytes(4));
+    createSaiAdminProfileFixture($directory, saiAdminVersion: '6.1.5');
+
+    try {
+        file_put_contents(
+            $directory . '/plugin/saiadmin/app/controller/LoginController.php',
+            "<?php\nclass ChangedFixture {}\n",
+        );
+        expect(fn(): array => new SaiAdminProfile($directory)->assertSupported())
+            ->toThrow(RuntimeException::class, 'Installed SaiAdmin source does not match composer.lock package');
+    } finally {
+        removeSaiAdminProfileFixture($directory);
+    }
+});
+
+it('uses the upstream Composer constraint without an extra Webman runtime gate', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-saiadmin-profile-' . bin2hex(random_bytes(4));
+
+    try {
+        createSaiAdminProfileFixture($directory, webmanVersion: 'v2.2.4', workermanVersion: 'v5.2.2');
+        expect(new SaiAdminProfile($directory)->assertSupported())->toBe([
+            'saithink/saiadmin' => '6.1.1',
+            'topthink/think-orm' => 'v3.0.34',
+            'nesbot/carbon' => '3.13.2',
+        ]);
+    } finally {
+        removeSaiAdminProfileFixture($directory);
+    }
+});
+
+it('fails closed on unsupported dependency drift or excluded business PHP', function (): void {
+    $directory = sys_get_temp_dir() . '/typephp-saiadmin-profile-' . bin2hex(random_bytes(4));
+    createSaiAdminProfileFixture($directory, 'v4.0.0');
+
+    try {
+        $profile = new SaiAdminProfile($directory);
+        expect(fn(): array => $profile->assertSupported())
+            ->toThrow(RuntimeException::class, 'Unsupported topthink/think-orm version');
+
+        $lock = (string) file_get_contents($directory . '/composer.lock');
+        file_put_contents($directory . '/composer.lock', str_replace('v4.0.0', 'v3.0.34', $lock));
+        $profile = new SaiAdminProfile($directory);
+        expect(fn(): array => $profile->writeCoverageManifest(
+            ['app', 'support', 'plugin/saiadmin', 'plugin/example/app'],
+            ['plugin/example/app/controller/ExampleController.php'],
+            [],
+        ))
+            ->toThrow(RuntimeException::class, 'excluded without a compiled AOT replacement');
+    } finally {
+        removeSaiAdminProfileFixture($directory);
+    }
+});