Skip to content

Feat: Clarify governance revalidation semantics and enum docs#29

Merged
rian-be merged 2 commits into
mainfrom
develop
Jun 24, 2026
Merged

Feat: Clarify governance revalidation semantics and enum docs#29
rian-be merged 2 commits into
mainfrom
develop

Conversation

@rian-be

@rian-be rian-be commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Summary

This PR hardens governance version resolution so revalidation becomes an explicit runtime state instead of an implicit branch.

Added

  • pending revalidation semantics through PendingMutationReason.Revalidation
  • end to end coverage for stale approval renewal and re-execution
  • versioned resolution example updates that show revalidation behavior
  • XML docs for public governance enums

Changed

  • revalidation now persists as visible pending request state instead of silently staying approved
  • version aware resolution history now records revalidation decisions explicitly
  • versioned resolution example documentation now describes the revalidation pending path
  • public governance enums now have complete XML documentation

Result

Governance version resolution is now easier to audit and reason about, with revalidation represented as first class runtime state and covered by tests and examples.

Testing

  • dotnet test Tests/ModularityKit.Mutator.Governance.Tests/ModularityKit.Mutator.Governance.Tests.csproj -c Release
  • dotnet build Examples/Governance/VersionedResolution/VersionedResolution.csproj -c Release

Linked Issues

Checklist

  • Revalidation has explicit runtime semantics
  • Revalidation is represented as a visible pending request state
  • Stale approval resolution is covered by tests
  • Example coverage shows the revalidation branch
  • Public governance enums have XML docs

@github-actions github-actions Bot added examples Runnable examples and sample apps tests Test coverage and test changes labels Jun 24, 2026
@rian-be rian-be merged commit 826cca2 into main Jun 24, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

examples Runnable examples and sample apps tests Test coverage and test changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Task]: Harden governance version resolution semantics

1 participant