DevEx: phpc doctor --gates — 007 ThrowsWeb ladder rows

[PurHur]

Problem

phpc doctor --gates documents env ladders for 005-SessionsWeb (#1903) and 006-FileUploadWeb (#2010), but 007-ThrowsWeb will add THROWSWEB_* gates (#2101, #2093) without a presenter-facing index.

Contributors grep ci-defaults.env instead of one command.

Goal

Extend bin/phpc.php / lib/Cli/PhpcDoctor.php (or equivalent) so:

./phpc doctor --gates | grep -i throws

lists, in order:

Gate	Purpose	Default	Issue
THROWSWEB_WEB_SMOKE_GATE	phpc serve + curl invalid POST	0 → 1	#2093
THROWSWEB_AOT_LINK_GATE	phpc build --project 007	0	#2101
THROWSWEB_AOT_SMOKE_GATE	native 500 response	0	#2101

Include one-line “how to run” (make … or ./script/examples-web-smoke.sh --throws-only when added).

Implementation hints

File	Change
lib/Cli/PhpcDoctor.php	New section ThrowsWeb (007) after FileUploadWeb block
docs/local-ci-matrix.md	Cross-link gate names
test/unit/PhpcDoctorGatesTest.php	Assert section exists when #2076 directory present

Mirror #1903 structure; do not duplicate full curl recipes (link examples/007-ThrowsWeb/README.md).

Acceptance criteria

• phpc doctor --gates lists all THROWSWEB_* vars with current defaults from script/ci-defaults.env
• test/unit/PhpcDoctorGatesTest.php updated
• docs/GETTING-STARTED.md optional one-liner points to doctor (after Examples: 007-ThrowsWeb — throw/catch presenter app (post-#195/#57) #2076)

Verification

./phpc doctor --gates | grep -i throws
./script/ci-fast.sh --filter PhpcDoctorGates

No GitHub Actions.

Dependencies

• Examples: 007-ThrowsWeb — throw/catch presenter app (post-#195/#57) #2076 — example exists
• Testing: THROWSWEB_WEB_SMOKE_GATE + examples-web-smoke 007 slice #2093, Testing: THROWSWEB_AOT_LINK_GATE + THROWSWEB_AOT_SMOKE_GATE (007-ThrowsWeb) #2101 — gate names stable

Links

• DevEx: phpc doctor --gates lists 005-SessionsWeb ladder (#1887–#1894) #1903 (005 pattern) · ROADMAP 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78