DevEx: phpc build --project --list-units for AOT debug (#764)

[PurHur]

Problem

When phpc build --project examples/003-MiniWebApp links but .phpc/bin/app prints 0 stdout bytes (#764), contributors grep lib/Cli/PhpcBuild.php and re-run full ci-local.sh llvm phases.

There is no lightweight way to see which PHP files entered the project graph, link order, and whether public/index.php is the LLVM entry.

Goal

phpc build --project examples/003-MiniWebApp --list-units
# or: phpc build --project . --list-units --dry-run

Prints to stderr (stable, grep-friendly):

• Resolved phpc.json entry + includes[]
• Sorted translation unit paths (bundled vs on-disk)
• Native entry symbol / main script path
• Optional: skipped files with reason (lint, unsupported syntax)

Exit 0 without requiring link when combined with existing --dry-run.

Scope

• CLI flag on PhpcBuild / bin/phpc.php build
• Reuse lib/Web/SourceBundler.php / project discovery used by --project
• Document in examples/003-MiniWebApp/README.md debugging section (DevEx: phpc build --project hints when linked binary prints 0 stdout bytes #792 companion)
• No change to default build output paths

Implementation hints

Piece	File	Notes
CLI	lib/Cli/PhpcBuild.php	Parse --list-units before compile
Manifest	lib/Web/ProjectManifest.php	entry, includes, binary
Bundler	lib/Web/SourceBundler.php	Same graph as link
Tests	test/unit/PhpcBuildProjectTest.php	Assert stdout lists public/index.php + src/Router.php for 003

Example output

entry: public/index.php
units: config.php, src/Router.php, templates/layout.php, …
binary: .phpc/bin/app

Acceptance criteria

./phpc build --project examples/003-MiniWebApp --list-units --dry-run | grep Router.php

Docker:

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  php bin/phpc.php build --project examples/003-MiniWebApp --list-units --dry-run

Dependencies

• AOT: Project build mode (entry file + dependency graph) #59 ✅ project build mode
• AOT: MiniWebApp native binary CLI execute emits empty stdout (post-link) #764 — primary consumer while execute is empty
• DevEx: phpc doctor --aot-project-probe for MiniWebApp #746 phpc doctor --aot-project-probe — higher-level green/red probe

Verification

Local/Docker only. No GitHub Actions.

Links

• AOT: MiniWebApp native binary CLI execute emits empty stdout (post-link) #764, DevEx: phpc build --project hints when linked binary prints 0 stdout bytes #792, DevEx: phpc doctor --aot-project-probe for MiniWebApp #746, ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78