Repository navigation
feat: integrate production audits and Rust 1.97 guidance - #4
Closed
jason931225 wants to merge 10 commits into
Closed
jason931225 wants to merge 10 commits into
jason931225 wants to merge 10 commits into
Conversation
added 9 commits
August 12, 2026 16:37
Add 14 original rules covering the load-bearing gaps versus microsoft/rust-guidelines v2026.6, plus a tightly scoped ffi- category. Existing rule bodies are unchanged except bidirectional See Also links. Index regenerated; release version left at 1.5.1.
Add the sixteen load-bearing rules pass 1 skipped, and revise proj-prelude-module and proj-pub-use-reexport so the corpus no longer contradicts the Microsoft book on preludes and re-exports.
Pin the compile-check toolchain and CI to 1.97.1, add lint-warnings-deny-config and num-bit-width for the 1.97 APIs that change how agents should write code, and fix link_section validation on Mach-O.
Rewrite overlapping Microsoft examples, add M- clause locators, and fix generated-table pipes, changelog trailer, Key Points, and See Also capitalization so the issue #3 branch matches corpus style.
The earlier refresh classified 1.97 but inherited the existing 1.95 and 1.96 coverage. Audit all three release-note sets, add rule-shaped guidance for the useful language, library, Cargo, and compatibility changes, and execute their behavior in the pinned CI harness.
jason931225
changed the title
Merge the existing Rust 1.97 audit branch into the Microsoft and Zero To Production guidance branch. Correct unsafe, async, performance, ownership, FFI, validation, and operational claims; pin CI actions; make the reviewed example baseline exact; and validate current Rust 1.97.1 behavior.
jason931225
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This keeps the existing PR branch, reconciles the full Rust 1.95–1.97 audit from PR #5, and completes two independent clause-level source audits:
The corpus now contains 343 rules across 27 categories. The final adversarial pass corrected unsafe/FFI contracts, async cancellation and bounded-admission semantics, ownership claims, numeric and float behavior, validated types, release profiles, LTO/PGO/codegen guidance, hashing security, type layout, and CI/example admission. Performance guidance is measurement-driven rather than based on universal speed or allocation claims.
Provider-, framework-, and 2022-version-specific tutorial recipes are explicitly dispositioned rather than imported as timeless guidance.
Coverage evidence
Microsoft Pragmatic Rust Guidelines
bbf7b03f3a51548f187888fb8c516e8118ebb1c2M-*pages individually dispositionedZero To Production In Rust
5de8b3ef43e1175f18579130c9bef9ef492f63c527deb5ac65a9a1bb6320f75eRust 1.95–1.97 reconciliation
ce04df8988405e6b4ee25be3d32db1e31c1f6d83is the second parent of the reconciliation commitupdate/try_update,cfg_select!, if-let guards, ordering consistency, fallible bool/non-zero conversions, bit helpers, and mutable collection insertionOriginality
Verification
bash checks/check.shat791a2478cbf00f28d943bd18a2dbcbb5b008574b:OK: 343 rules valid; index lists all 343 of them.OK: index up to date (343 rules, 27 categories)OK: exact compile-suspect baseline parity (94 reviewed)All checks passed.Additional checks passed:
rustfmt --check --edition 2024 checks/tests/source_guidance.rs checks/tests/release_195_197.rsgit diff --checkfor both merge parentsGitHub check runs may remain absent pending maintainer approval for the first-time-contributor workflow.
Closes #3