DevEx: phpc.json JSON Schema and phpc validate-manifest

[PurHur]

Problem

lib/Web/ProjectManifest.php reads a minimal phpc.json (binary field for phpc serve --aot). #106 and #155 will add entry, public, includes, and PSR-4 autoload, but there is no machine-readable schema or validator—typos fail late at serve/build time.

Goal

• docs/phpc-json.schema.json (or schema/phpc.json) describing supported keys
• ./phpc validate-manifest [dir] exits 0/1 with actionable errors (unknown keys, bad paths, missing public/index.php)

Scope (v1)

• Schema for fields implemented today: binary, optional public
• Stub fields for DevEx: phpc.json project manifest (entry, includes, public assets) #106 / DevEx: PSR-4 autoload paths in phpc.json project manifest #155: entry, includes, autoload.psr-4 (document as optional until implemented)
• Validator in bin/phpc.php subcommand; no external deps beyond json_decode
• phpc doctor (DevEx: phpc doctor — probe LLVM, extensions, and loopback bind #253) may call validator when phpc.json exists
• Example manifest in Reference: MiniWebApp lint-first skeleton (examples/003-MiniWebApp) #246 skeleton

Acceptance criteria

echo '{"binary": "missing"}' > /tmp/phpc.json
./phpc validate-manifest /tmp
# exit 1, message: binary path not found

Verification (local only)

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  vendor/bin/phpunit --filter ProjectManifest

Dependencies

• DevEx: phpc.json project manifest (entry, includes, public assets) #106 manifest fields
• DevEx: PSR-4 autoload paths in phpc.json project manifest #155 autoload section
• DevEx: phpc doctor — probe LLVM, extensions, and loopback bind #253 doctor integration (optional)

Related

• lib/Web/ProjectManifest.php, bin/serve-aot.php

[PurHur]

Merged in #390: phpc.json JSON Schema, ManifestValidator, and phpc validate-manifest CLI.