CI: North Star 1 gate-flip bundle — #1530 done; #1523 + #1752 remain before #1044 close

[PurHur]

Problem

North Star 1 AOT execute is green on master (#764 ✅, #1529 ✅, #1524 ✅). Two default-off env gates still hide deploy-path and shell-smoke regressions from ./script/ci-local.sh:

Gate	Default	Issue	What it runs
MINIWEBAPP_WEB_SMOKE_AOT_GATE	0	#1523	examples-web-smoke.sh --miniwebapp-only --aot
DEPLOY_SMOKE_003_EXECUTE	0	#1530	deploy-smoke.sh --example 003 execute

#1044 DoD has 2/10 boxes open largely because of these flips. #1752 (phpc doctor --gates) should land in the same PR so contributor docs match CI defaults.

Goal

One focused PR that:

1. Sets MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 in script/ci-defaults.env (CI: Default MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 — examples-web-smoke 003 --aot curls (#676 step 3) #1523)
2. Sets DEPLOY_SMOKE_003_EXECUTE=1 in script/ci-defaults.env (CI: Default DEPLOY_SMOKE_003_EXECUTE=1 — deploy-smoke 003 execute in ci-local #1530)
3. Updates test/unit/CiScriptsTest.php expected default strings
4. Updates docs/local-ci-matrix.md, docs/miniwebapp-gates.md, docs/miniwebapp-aot-unskip-matrix.md
5. Refreshes phpc doctor --gates output (DevEx: phpc doctor --gates refresh after North Star 1 default-on gate flips (#1523, #1530) #1752)
6. Closes CI: Default MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 — examples-web-smoke 003 --aot curls (#676 step 3) #1523, CI: Default DEPLOY_SMOKE_003_EXECUTE=1 — deploy-smoke 003 execute in ci-local #1530; refreshes 🌐 North Star 1: Web-capable PHP application (living tracker) #1044 checklist

Implementation hints

File	Change
script/ci-defaults.env	Flip both defaults to 1
script/ci-common.sh	Confirm both gates run in llvm phase (already wired)
test/unit/CiScriptsTest.php	Assert new default strings
bin/phpc.php (doctor --gates)	Show both as default-on
docs/local-ci-matrix.md	Gate table

Pre-flight (must pass before PR):

make docker-build-22
MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 ./script/examples-web-smoke.sh --miniwebapp-only --aot
DEPLOY_SMOKE_003_EXECUTE=1 ./script/deploy-smoke.sh --example 003
./script/ci-local.sh   # full gate with new defaults
phpc doctor --gates

Acceptance criteria

• ./script/ci-local.sh fails if either smoke regresses (no opt-in env needed)
• Opt-out documented: MINIWEBAPP_WEB_SMOKE_AOT_GATE=0, DEPLOY_SMOKE_003_EXECUTE=0
• 🌐 North Star 1: Web-capable PHP application (living tracker) #1044 updated; remaining DoD → docs (Docs: Sync North Star 1 status — README, #1044, development-status.md (#764 closed) #1525, Examples: Sync examples/README.md run matrix after #764 close #1531, Docs: Production deployment guide (nginx + AOT binary + CGI/FastCGI) #445)

Verification (local / Docker only)

No GitHub Actions required (#394 ✅). Use ./script/docker-ci-local.sh on harness hosts.

Dependencies

• AOT: MiniWebApp native binary CLI execute emits empty stdout (post-link) #764 ✅, Testing: examples-web-smoke.sh --aot 003 PATH_INFO curls (blocked #764) #833 ✅ — smoke implementations exist
• Docs: Sync North Star 1 status — README, #1044, development-status.md (#764 closed) #1525, Examples: Sync examples/README.md run matrix after #764 close #1531 — docs sync (can follow in same PR or immediately after)

Links

• Living tracker 🌐 North Star 1: Web-capable PHP application (living tracker) #1044
• ROADMAP 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 batch priorities
• Testing: MiniWebApp AOT unskip matrix after #568 (orchestrate #454 #485 #478 #610) #676 step 3 (web-smoke --aot) + deploy execute

[PurHur]

PM note: gate coupling on master (2026-05-24)

Code-path audit for implementers (no code in this comment):

DEPLOY_SMOKE_003_EXECUTE (#1530)

script/ci-common.sh ci_run_deploy_smoke() already runs deploy-smoke.sh --example 003 when MINIWEBAPP_AOT_EXECUTE_GATE=1 (default in ci-defaults.env). Flipping DEPLOY_SMOKE_003_EXECUTE default to 1 is still required for:

• Honest phpc doctor --gates / CiScriptsTest default strings
• Independent opt-in when operators set MINIWEBAPP_AOT_EXECUTE_GATE=0

MINIWEBAPP_WEB_SMOKE_AOT_GATE (#1523)

script/examples-web-smoke.sh miniwebapp_aot_require_pass() treats MINIWEBAPP_AOT_EXECUTE_GATE=1 OR MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 as require-pass. Full ci-local.sh already calls ci_run_examples_web_smoke_aot → examples-web-smoke.sh --aot (all examples + 003).

#1523 scope should include:

1. export MINIWEBAPP_WEB_SMOKE_AOT_GATE="${MINIWEBAPP_WEB_SMOKE_AOT_GATE:-1}" in script/ci-defaults.env
2. Optional dedicated ci_run_miniwebapp_web_smoke_aot → --miniwebapp-only --aot (faster/isolated north-star slice)
3. test/unit/CiScriptsTest.php + docs/local-ci-matrix.md + bin/phpc.php doctor output (DevEx: phpc doctor --gates refresh after North Star 1 default-on gate flips (#1523, #1530) #1752)

Pre-flight (Docker harness)

make docker-build-22
MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 ./script/examples-web-smoke.sh --miniwebapp-only --aot
DEPLOY_SMOKE_003_EXECUTE=1 ./script/deploy-smoke.sh --example 003
./script/docker-ci-local.sh

Blocks #1044 close together with docs #1525 / #1531.

[PurHur]

PM audit — ready for implementation PR (2026-05-24 batch 67)

Blockers cleared:

• Docs: Sync capability-syntax + capability-matrix rows post-#764 (execute ✅) #1767 ✅ (capability docs merged Docs: sync capability generators post-#764 execute close (#1767) #1775)
• Wave-3 PR queue empty — no competing CI-heavy PRs open

Pre-flight still required before merge:

make docker-build-22
MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 ./script/examples-web-smoke.sh --miniwebapp-only --aot
DEPLOY_SMOKE_003_EXECUTE=1 ./script/deploy-smoke.sh --example 003
./script/docker-ci-local.sh
phpc doctor --gates

This remains priority #1 on ROADMAP #78 for #1044 close.

[PurHur]

Batch 68: Doc follow-ups #1789 (gate ladder), #1791 (ExamplesReadmeTest), #1752 (doctor --gates) — bundle with this gate-flip PR or immediately after.

[PurHur]

PM status (batch 69 — 2026-05-24)

No open PR targeting this bundle. Issue remains #1 North Star 1 priority on #78 and #1044.

Current master state (verified)

Gate	Location	Default
DEPLOY_SMOKE_003_EXECUTE	script/ci-defaults.env:20	0
MINIWEBAPP_WEB_SMOKE_AOT_GATE	script/examples-web-smoke.sh only (not in ci-defaults.env yet)	0

Implementation PR should add MINIWEBAPP_WEB_SMOKE_AOT_GATE export to script/ci-defaults.env per acceptance criteria in this issue body.

Pre-flight checklist (assignee)

• MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 ./script/examples-web-smoke.sh --miniwebapp-only --aot
• [PLOY_SMOKE_003_EXECUTE=1 ./script/deploy-smoke.sh --example 003`
• ./script/ci-local.sh full gate with flipped defaults
• phpc doctor --gates shows both default-on (DevEx: phpc doctor --gates refresh after North Star 1 default-on gate flips (#1523, #1530) #1752)
• Update test/unit/CiScriptsTest.php, docs/local-ci-matrix.md, docs/miniwebapp-gates.md

Follow-on (same PR or immediate next)

#1525, #1531, #1789, #1791, #1778 — docs/README matrix sync

[PurHur]

Correction: pre-flight checklist item 2 should read DEPLOY_SMOKE_003_EXECUTE=1 ./script/deploy-smoke.sh --example 003 (typo in prior comment).

[PurHur]

PM note (batch 71, 2026-05-24)

Still the #1 North Star 1 blocker on the critical path to #1044 close.

Pre-flight commands unchanged — run locally/Docker before opening the bundled PR:

make docker-build-22
MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 ./script/examples-web-smoke.sh --miniwebapp-only --aot
DEPLOY_SMOKE_003_EXECUTE=1 ./script/deploy-smoke.sh --example 003
./script/ci-local.sh
./phpc doctor --gates

Doc follow-ups (same PR or immediately after): #1789, #1525, #1531, #1791.

No open PRs currently target this bundle.

[PurHur]

Timeline note — batch 73 (2026-05-25)

Status: 📋 open · no open PR · highest-priority NS1 implementation item.

Pre-flight still required before PR:

MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 ./script/examples-web-smoke.sh --miniwebapp-only --aot
DEPLOY_SMOKE_003_EXECUTE=1 ./script/deploy-smoke.sh --example 003
./script/ci-local.sh
phpc doctor --gates

On merge: closes #1523, #1530; refresh #1044 checklist; unblocks docs issues #1525, #1531, #1789.

[PurHur]

Bundle status (batch 64 — 2026-05-25)

Child	Status	Landed
#1530 deploy-smoke 003 execute	✅ closed	PR #1825 — DEPLOY_SMOKE_003_EXECUTE:-1 in script/ci-defaults.env
#1523 web-smoke --aot 003	📋 open	Still opt-in (MINIWEBAPP_WEB_SMOKE_AOT_GATE:-0 in script only)
#1752 phpc doctor --gates	📋 open	Land with #1523 flip

Next implementation PR: flip MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 in ci-defaults.env + CiScriptsTest + doctor output + doc matrix (#1752, #1789). Pre-flight:

MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 ./script/examples-web-smoke.sh --miniwebapp-only --aot
./script/ci-local.sh

Tracker refresh: #1044 DoD updated (deploy-smoke ✅). No open PRs on queue.

[PurHur]

Gate-flip bundle complete via merged #1836: MINIWEBAPP_WEB_SMOKE_AOT_GATE=1 default-on + doctor stage 3c. DEPLOY_SMOKE_003_EXECUTE=1 was already default-on (#1530). Remaining #1044 DoD: docs sync (#1525, #1531, #445).

[PurHur]

Gate-flip bundle landed in #1836 (#1523 + #1752). DEPLOY_SMOKE_003_EXECUTE was already default-on. Follow-up docs for #1044: #1525, #1531, #445.