Language: JIT include/require compile-time lowering (#54 follow-up)

[PurHur]

Problem

#54 closed with AOT literal-path bundling via LiteralIncludeDiscovery + SourceBundler in bin/compile.php. JIT still throws on OpCode::TYPE_INCLUDE:

// lib/JIT.php — TYPE_INCLUDE
throw new \LogicException('include/require must be resolved before AOT compile …');

examples/003-MiniWebApp/ needs multi-file execution in all three modes (VM ✅, AOT bundle ✅, JIT ❌). phpc serve JIT mode (#207) and compliance JIT tests for two-file apps remain blocked.

Goal

include / require with static path expressions (__DIR__ . '/file.php', string literal) compile in JIT the same way AOT bundles them today — no runtime TYPE_INCLUDE in generated LLVM for v1.

Dynamic include $path stays out of scope (document in docs/capabilities.md).

Implementation hints

Approach	Files	Notes
Reuse bundler	lib/AOT/LiteralIncludeDiscovery.php, SourceBundler	Share discovery from entry / current function
JIT compile	lib/JIT.php	Lower bundled units as nested functions or inlined blocks
Compiler	lib/Compiler.php	Optionally replace TYPE_INCLUDE with bundled symbol refs at compile time
Once	#120	Dedup table at JIT module scope
Tests	test/compliance/cases/include_two_file_jit.phpt	Mirror VM two-file fixture

Acceptance criteria

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  php bin/jit.php examples/003-MiniWebApp/public/index.php

Does not throw on TYPE_INCLUDE (may still fail on #58/#145 until OOP lands).

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  ./script/ci-local.sh --filter include_two_file

Verification (local / Docker only)

make test-docker

No GitHub Actions required.

Dependencies

• Language: include/require in JIT and AOT (multi-file applications) #54 ✅ AOT bundling (reference implementation)
• Language: Magic constants __DIR__, __FILE__, __LINE__ for multi-file apps #85 __DIR__ for path resolution
• Language: require_once and include_once deduplication #120 require_once dedup
• Web: Nested include inherits parent variable scope (template partials) #471 / Stdlib: extract() and compact() JIT/AOT parity (#275 follow-up) #476 include scope (VM frame push)
• Blocks: Reference app: examples/003-MiniWebApp (router, templates, forms) #67 multi-file JIT, Web: JIT/AOT mode for bin/serve.php (compile per script on first request) #207 serve JIT

Related

• AOT: Project build mode (entry file + dependency graph) #59 --project graph (AOT UX)
• 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 ROADMAP Phase 1 Language