Release v1.1.0: ship release-readiness.sh user-release gate presenter

[PurHur]

Category

bootstrap | release tooling

Problem

Daily release review cannot confirm user_release_ready — ./script/release-readiness.sh does not exist on master (verified 2026-06-15). Release meta #8739 / roadmap #78 block on a single presenter that aggregates user-facing gates without running the full ~1h strict ladder.

php-src reference: N/A (project release gate)

Repro (today)

./script/release-readiness.sh --json
# bash: ./script/release-readiness.sh: No such file or directory

Parent meta: #8739

Scope

Deliverable	Detail
script/release-readiness.sh	Quick mode (<5 min Docker): inventory check, spine sync, examples smoke subset, docs sync
--full	Adds user-release gates: examples AOT/web smoke, capability sync, CHANGELOG stub check
--json	Machine output: `{ "user_release_ready": "yes"
test/unit/CiScriptsTest.php	Assert script exists + --json schema
docs/local-ci-matrix.md	Document quick vs full modes

Suggested gate bundle (quick)

• php script/bootstrap-inventory.php --check
• php script/check-selfhost-spine-coverage-sync.php
• ./script/ci-fast.sh (or subset env RELEASE_READINESS_QUICK=1)
• php script/check-root-readme-sync.php

Suggested gate bundle (full)

• Quick bundle +
• ./script/examples-aot-smoke.sh (000–009 subset)
• ./script/examples-web-smoke.sh

Done when

• ./script/docker-exec.sh -- bash -lc './script/release-readiness.sh --json' exits 0 on green master
• ./script/release-readiness.sh --full --json reports "user_release_ready": "yes" when all user-release gates pass
• Quick mode completes in Docker in <5 min (document env skips for LLVM-heavy steps)
• Referenced from 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 gate checklist and Release roadmap: v1.1.0 #8739 must-ship list
• No GitHub Actions — local/Docker only per project CI policy

Gate commands

./script/docker-exec.sh -- bash -lc './script/release-readiness.sh --json'
./script/docker-exec.sh -- bash -lc './script/release-readiness.sh --full --json'

Roadmap

Parent: #78 — User release roadmap v1.1.0 gate checklist.

Blocks: tagging v1.1.0 until green (#8739).

Target version: v1.1.0

[PurHur]

claim: worker-lane-b — starting this run

[PurHur]

claim: worker-lane-b — continuing release-readiness.sh implementation (prior claim had no PR)

[PurHur]

Merged via #8864.

Verification (Docker quick mode):
```bash
./script/docker-exec.sh -- bash -lc './script/release-readiness.sh --json'

user_release_ready: yes, exit 0

```

Unit test:
```bash
vendor/bin/phpunit test/unit/CiScriptsTest.php --filter testReleaseReadinessScriptExistsAndJsonSchema

OK (1 test, 33 assertions)

```

Full mode runs and honestly reports `user_release_ready: no` until examples AOT/web smokes green (#8739 must-ship). Quick gate bundle is green on master.

[PurHur]

Merged via #8872.

Verification

• vendor/bin/phpunit test/unit/CiScriptsTest.php --filter ReleaseReadiness — OK (3 tests)
• ./script/docker-exec.sh -- bash -lc 'php script/bootstrap-inventory.php >/dev/null && ./script/release-readiness.sh --json' — exit 0, "user_release_ready": "yes"

Quick gates: bootstrap-inventory, spine-coverage-sync, root-readme-sync, docs-sync (examples README), examples/000 VM smoke.
Full mode (--full) adds development-status sync, capability-matrix, CHANGELOG stub, examples AOT/web smoke.