Skip to content

Docs: Root README north-star drift guard (post-#764 closed claims) #1832

@PurHur

Description

@PurHur

Problem

#764 ✅ closed — examples/README.md and examples/003-MiniWebApp/README.md document native execute as green, but root README.md still claims partial/blocked execute in multiple places:

Location Stale claim
§ What works today 003 AOT execute 🚧 partial — home ✅
Quick start L68 native execute blocked #764
Shipped examples table (if present) may lag examples/README.md

#1822 guards examples/README.md only. Root README drift recurred after #764 close and will recur after #1760 gate flips unless automated.

Goal

  1. Add script/check-root-readme-sync.php (or extend an existing checker) that fails on known-stale phrases in README.md:
    • blocked #764, empty stdout until, execute 🚧, native execute blocked
  2. Allow #764 only in closed/historical context (same policy as Docs: examples/README drift guard — assert no stale #764 blocked wording #1822 / CapabilitySyntaxTest)
  3. Wire into ci-fast.sh via ROOT_README_SYNC_GATE (default 0 until Docs: Rewrite README feature list to match current compiler (2026) #48 / Docs: Sync North Star 1 status — README, #1044, development-status.md (#764 closed) #1525 land; flip to 1 in same PR as doc fix)

Scope

Acceptance criteria

php script/check-root-readme-sync.php   # passes after #48/#1525
ROOT_README_SYNC_GATE=1 ./script/ci-fast.sh
docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev ./script/ci-fast.sh

Fails with actionable line numbers when stale north-star wording returns.

Dependencies

Non-goals

Links

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions