Skip to content

Clarify UUIDv7 drift overflow semantics#81

Merged
dexcompiler merged 2 commits into
mainfrom
codex/80-uuidv7-drift-overflow-semantics
May 15, 2026
Merged

Clarify UUIDv7 drift overflow semantics#81
dexcompiler merged 2 commits into
mainfrom
codex/80-uuidv7-drift-overflow-semantics

Conversation

@dexcompiler
Copy link
Copy Markdown
Owner

Summary

  • apply CounterOverflowBehavior consistently when UUIDv7 logical time is ahead of physical time and the counter is exhausted
  • pin ThrowException and SpinWait behavior for restored future max-counter state
  • document drift/restored-state overflow behavior and update changelogs

Validation

  • dotnet test tests/Clockworks.Tests.csproj --filter UuidV7FactoryTests -v minimal
  • dotnet test property-tests/Clockworks.PropertyTests.fsproj --filter FullyQualifiedName~UuidV7FactoryProperties -v minimal
  • dotnet test Clockworks.sln -v minimal -m:1
  • npm run docs:build
  • dotnet pack src/Clockworks.csproj -c Release -v minimal

Fixes #80

@dexcompiler
Copy link
Copy Markdown
Owner Author

@copilot review this pr

Copy link
Copy Markdown
Contributor

Copilot AI commented May 15, 2026

@copilot review this pr

Reviewed at 6b7d99b.

I re-ran validation on this branch:

  • dotnet test tests/Clockworks.Tests.csproj --filter UuidV7FactoryTests -v minimal
  • dotnet test property-tests/Clockworks.PropertyTests.fsproj --filter FullyQualifiedName~UuidV7FactoryProperties -v minimal
  • dotnet test Clockworks.sln -v minimal -m:1
  • dotnet pack src/Clockworks.csproj -c Release -v minimal
  • docs build from the docs workspace (npm --prefix docs run docs:build) ✅

I did not find additional issues to change in this PR.

@dexcompiler dexcompiler merged commit f9232cd into main May 15, 2026
7 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.

Clarify UUIDv7 overflow behavior while logical time is ahead of physical time

2 participants