Skip to content

Self-host P1: commit regenerated bootstrap-inventory.md #830

Description

@PurHur

Problem

docs/bootstrap-inventory.md is generated by script/bootstrap-inventory.php and enforced in CI via #765 (ci_ensure_generated_doc in script/ci-common.sh).

script/bootstrap-selfhost-compile-probe.php --update-inventory can append a compiler_blockers / NEXT_LOWER section after a failed self-host compile (#816). That section drifts unless committed in the same PR as probe or compiler fixes.

Contributors see Stale docs/bootstrap-inventory.md in CI without knowing whether to run inventory only or inventory + probe update.

Goal

Committed docs/bootstrap-inventory.md on master always matches:

php script/bootstrap-inventory.php
# optional when probe section changed:
php script/bootstrap-selfhost-compile-probe.php --update-inventory
php script/bootstrap-inventory.php   # if probe rewrites headers

Scope

  • Document regen commands in docs/bootstrap-selfhost.md and PR checklist
  • After Self-host: wire compile-probe into Makefile and CI #829 wires probe into CI: fail with actionable message listing both commands
  • Keep compiler_blockers table in sync with actual bin/compile.php -l on test/selfhost/compiler_minimal
  • No manual edits to inventory tables (generator only)

Implementation hints

Piece File Notes
Generator script/bootstrap-inventory.php --check exit 1 when stale
Probe append script/bootstrap-selfhost-compile-probe.php bootstrapSelfhostProbeAppendInventory()
CI script/ci-common.sh ci_run_inventory_checks() Runs before PHPUnit
Test test/unit/BootstrapInventoryTest.php --check integration

When to regen

Change Command
New file on bin/vm.php path php script/bootstrap-inventory.php
Self-host probe finds new blocker php script/bootstrap-selfhost-compile-probe.php --update-inventory
Capability / bootstrap doc cross-links make bootstrap-profile

Acceptance criteria

php script/bootstrap-inventory.php --check
git diff --exit-code docs/bootstrap-inventory.md

Passes on master after this issue's PR.

Full CI:

./script/ci-local.sh   # inventory check in ci-common (no stale doc)

Dependencies

Verification

Local only:

php script/bootstrap-inventory.php && git status docs/bootstrap-inventory.md

No GitHub Actions.

Links

Activity

  1. added a commit that references this issue on May 23, 2026
  2. added a commit that references this issue on May 23, 2026
    6080e5c
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