Skip to content

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

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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions