Document native extra_scripts support boundary

[zackees]

Summary

• document the native extra_scripts support boundary in the build docs
• add negative script_runtime coverage for unsupported prefixes, imports, scopes, and PRE projenv
• assert unsupported shapes fail with --platformio guidance instead of silently partially replaying scripts

Testing

• cargo fmt --all --check
• cargo test -p fbuild-build script_runtime -- --nocapture

Closes #38.

[coderabbitai]

Warning

Rate limit exceeded

@zackees has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 3 minutes and 22 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 3 minutes and 22 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: ef154ad7-3f4d-449b-ab47-9341ed06e823

📥 Commits

Reviewing files that changed from the base of the PR and between 360df2b and d19e294.

📒 Files selected for processing (3)

• crates/fbuild-build/README.md
• crates/fbuild-build/src/README.md
• crates/fbuild-build/src/script_runtime.rs

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/issue-38-extra-scripts-boundary

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}