Files
RedBear-OS/local/docs
vasilito 037e0f6a13
redbear-ci / check (push) Waiting to run
docs: document --check-sweep flag in BUILD-SYSTEM.md and SCRIPT-BEHAVIOR-MATRIX.md
Add the --check-sweep option to the authoritative build-system reference
since it was missing from the documentation despite being a key gating
mechanism.

BUILD-SYSTEM.md (canonical reference):
- Added --check-sweep row to the §2 Options table with a clear pointer
  to the new §2.1 section
- Added §2.1 'Pre-build check sweep' section that documents:
  * What it does: cargo check --target <triple> --offline on every fork
    + every config recipe BEFORE the cook/prefix cycle
  * Why it exists: surfaces all type/borrow errors at once instead of
    one-at-a-time deep inside a multi-minute relibc rebuild
  * Implementation: redbear_check_sweep() in build-redbear.sh
  * Toolchain requirement: ~/.redoxer/<triple>/toolchain/bin/cargo
  * Skip list: bootloader (bare-metal/UEFI, custom targets)
  * Log location: $REDBEAR_BUILD_LOGS_DIR/check-sweep-<name>.log
  * Exit codes: 0 on success, 1 on any failure with summary
  * Current evidence: 48/48 packages pass on redbear-mini with
    --check-sweep after the 2026-07-28 refactor round

SCRIPT-BEHAVIOR-MATRIX.md (per-script roles):
- Updated the build-redbear.sh table entry to call out --check-sweep
  in the 'enforces' description
- Added a new 'build-redbear.sh Flag Reference' table with the full
  flag list and effect descriptions (mirrors the actual --help output)
- The new section highlights that --check-sweep is the recommended
  pre-build gate to surface all type/borrow errors up-front

Verification: --check-sweep redbear-mini passes 48/48 packages, matching
the documented behavior.
2026-07-29 10:01:28 +09:00
..