DevEx: Keep phpc init --profile miniwebapp template in sync with examples/003-MiniWebApp #695

Problem

./phpc init --profile miniwebapp scaffolds from templates/init-miniwebapp/ (#632), but the canonical reference app is examples/003-MiniWebApp/. The trees have drifted (e.g. public/index.php, src/Router.php differ today).

New projects get an older skeleton; bugs fixed in the example do not reach phpc init users.

Goal

Treat examples/003-MiniWebApp as source of truth and keep templates/init-miniwebapp/ aligned (or generate the template from the example in CI).

Scope

• Document sync policy in templates/init-miniwebapp/README.md and examples/003-MiniWebApp/README.md
• Add script/check-init-miniwebapp-parity.sh (diff key files: public/index.php, src/Router.php, phpc.json, config.php, template partials)
• Wire check into ./script/ci-fast.sh or ExamplesManifestTest (fast, no LLVM)
• When intentional divergence is needed, require a comment marker in both trees

Acceptance criteria

./script/check-init-miniwebapp-parity.sh   # exit 0 when in sync
./script/ci-fast.sh

After phpc init --profile miniwebapp /tmp/mw && ./phpc lint --all /tmp/mw, lint matches example capabilities (PATH_INFO, REQUEST_METHOD, templates).

Verification (local / Docker only)

./phpc init --profile miniwebapp /tmp/mw-test
./phpc lint --all /tmp/mw-test
./script/check-init-miniwebapp-parity.sh
docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev ./script/ci-fast.sh

Dependencies

• DevEx: phpc init --profile miniwebapp (Router + templates scaffold) #632 init profile (closed) — this issue is ongoing maintenance
• Reference app: MiniWebApp runtime green (lint 0, VM serve, routes) #539 runtime tracker for example behavior
• AOT: Native user-class object model for phpc build --project #568 blocks AOT parity notes in template README until link green

Non-goals

• Auto-sync on every commit without an explicit check (silent drift)
• Changing example routes without updating init template in the same PR

Links

• templates/init-miniwebapp/
• examples/003-MiniWebApp/
• lib/Cli/PhpcInit.php
• 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 ROADMAP Phase 4 Polish