docs(audit): close ~44 LOW NatSpec / contract-doc findings in one sweep

[hardyjosh]

Bundles the documentation-only LOW audit findings:

• 9 events get @notice + @param per parameter (was @dev only)
• 5 ICloneableV2 typed-overload initialisers get full NatSpec
• 4 setters / view functions get missing @param
• 9 contract/function NatSpec blocks rewritten to match actual behaviour
• 3 error definitions get better param names and docs
• 4 LibProdDeploy constants get per-constant role docs
• 1 setAdmin block gets a one-step-transfer lockout warning
• 1 PassthroughProtocolAdapter PRECONDITION on registered-oracle decimals
• 2 BeaconSetDeployer @param admin docs expand on conferred authority
• 3 AGENTS.md / CLAUDE.md process-doc refinements
• 3 SPEC.md drift fixes (§9 newOracleRegistry signature, §10 example call, §10 returns)

No executable code or test changes. nix CI green (test/static/legal).

Closes #30, #31, #32, #78, #79, #80, #84, #88, #92, #93, #95, #96, #97, #98, #99, #100, #101, #102, #103, #104, #105, #120, #147, #157, #160, #161, #165, #166, #167, #169, #170, #174, #178, #182, #189, #190, #191, #192, #202, #204, #211, #217, #219.

Co-Authored-By: Claude Opus 4.7 noreply@anthropic.com

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 67f89aca-83e5-4b32-9955-dbfc7d9a823c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/audit-low-natspec-sweep

---

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.}

[hardyjosh]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• docs(audit): close ~44 LOW NatSpec / contract-doc findings in one sweep #229 👈 (View in Graphite)
• test(audit): close 10 MEDIUM test-coverage gaps in one sweep #228 : 1 other dependent PR (#230 )
• fix(morpho): require 8-decimal upstream oracle (audit #187) #224 : 2 other dependent PRs (#225 , #227 )
• refactor(interface): rename to AggregatorV2V3Interface + add getRoundData #222 : 1 other dependent PR (#223 )
• chore: remove MultiPythOracleAdapter for Euler launch #238
• docs: README refresh + integrator notes for corporate-action auto-pause (RAI-325) #26 : 1 other dependent PR (#221 )
• feat(deploy): thread CorporateActionPauseConfig through unified deployers (RAI-322) #25
• test: auto-pause revert propagation through protocol adapters (RAI-321) #24
• feat(oracle): wire corporate-action auto-pause into BasePythOracleAdapter (RAI-320) #23
• feat(lib): LibCorporateActionsPause reader helper (RAI-319) #22
• docs(spec): corporate-action-aware auto-pause semantics (RAI-318) #21
• deps: migrate from git submodules to soldeer #237
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[hardyjosh]

Deferred for Euler launch. Pure-docs sweep across 44 LOW NatSpec issues; addresses no functional concern.