Skip to content

docs: finish the cross-epoch + iCentral doc updates the fix PRs missed - #296

Merged
hardyjosh merged 1 commit into
mainfrom
docs/post-fix-consistency
Aug 10, 2026
Merged

hardyjosh merged 1 commit into
mainfrom
docs/post-fix-consistency

Conversation

@hardyjosh

@hardyjosh hardyjosh commented Aug 10, 2026 •

Copy link
Copy Markdown
Collaborator

Doc consistency follow-up surfaced by the post-fix mutation run (@ c7c22c3), which found no code defects and no coverage gaps — every non-equivalent mutant is killed by the existing suite — but flagged four doc sites the fix PRs (#292–#295) left contradicting the hardened code:

  • README cross-epoch section still documented pauseTimeAfter >= maxAge and called == maxAge 'airtight' — a config it calls valid now reverts at init. Rewritten to the strict > maxAge rule + forward-skew-margin rationale.
  • maxAge struct-field NatSpec said 'MUST be <= pauseTimeAfter'; init enforces strict <. Corrected.
  • iCentral immutable comment still said 'fixed for the beacon's whole life', contradicting the struct doc corrected in #293.
  • Two test comments with stale >= / 'airtight at equality' phrasing.

Doc/comment + README only — zero code lines changed. 192 tests; fmt/slither/reuse clean. Last doc loose end before the pre-audit evidence is regenerated over the final tip.

🤖 Generated with Claude Code

The post-fix mutation run (@ c7c22c3) found no code defects and no coverage
gaps, but its adversarial pass flagged four doc sites the fix PRs (#292-295)
left contradicting the hardened code:

- README.md cross-epoch invariant section still documented the pre-hardening
  pauseTimeAfter >= maxAge and called the == maxAge boundary 'airtight' — a
  config the README calls valid now reverts at init. Rewritten to the strict
  > maxAge rule with the forward-skew-margin rationale (matches the contract
  NatSpec), and the config example comment fixed.
- DIAVaultOracle maxAge struct-field NatSpec said 'MUST be <= pauseTimeAfter';
  init enforces strict <. Corrected (the sibling pauseTimeAfter field was
  already updated).
- MorphoPairAdapterBeaconSetDeployer iCentral immutable's inline comment still
  said 'fixed for the beacon's whole life', contradicting the struct-field
  NatSpec corrected in #293. Aligned.
- Two DIAVaultOracle test comments still reasoned with the non-strict >= /
  'airtight at equality' phrasing. Corrected (assertions were already right).

Doc/comment + README only — zero code lines changed. 192 tests;
fmt/slither/reuse clean.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013hi8wq9YkjWPcGACXCEKeL
@hardyjosh
hardyjosh marked this pull request as ready for review August 10, 2026 17:26

Copy link
Copy Markdown
Collaborator Author

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

@hardyjosh
hardyjosh merged commit ec27652 into main Aug 10, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant