Skip to content

Clarify UUIDv7 collision and skew guarantees#74

Merged
dexcompiler merged 2 commits into
mainfrom
codex/67-uuidv7-collision-docs
May 14, 2026
Merged

Clarify UUIDv7 collision and skew guarantees#74
dexcompiler merged 2 commits into
mainfrom
codex/67-uuidv7-collision-docs

Conversation

@dexcompiler
Copy link
Copy Markdown
Owner

Summary

  • clarify UuidV7Factory and IUuidV7Factory XML docs so per-instance monotonic allocation is not confused with deterministic global uniqueness
  • add a dedicated UUIDv7 guide section for collision and clock-skew semantics across one factory, multiple threads, multiple factories, fleets, and restarts
  • update README and changelog docs with singleton guidance, probabilistic cross-factory uniqueness, and storage uniqueness constraints for high-assurance shared namespaces

Why

UuidV7Factory already handles backward wall-clock movement inside one live factory instance by continuing from its CAS-protected logical (timestamp, counter) frontier. The previous docs did not draw a sharp enough line between that deterministic local guarantee and probabilistic cross-process/fleet uniqueness.

Validation

  • dotnet test Clockworks.sln -v minimal -m:1
  • cp assets/clockworks-display-resized.png docs/public/logo.png
  • DOCS_VERSION=dev npm run docs:build

Note: npm ci in docs/ reported existing moderate dependency advisories but completed successfully; this PR does not modify docs dependencies.

Fixes #67

@dexcompiler dexcompiler marked this pull request as ready for review May 14, 2026 22:07
@dexcompiler dexcompiler changed the title [codex] Clarify UUIDv7 collision and skew guarantees Clarify UUIDv7 collision and skew guarantees May 14, 2026
@dexcompiler dexcompiler merged commit 687ed50 into main May 14, 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.

Docs: clarify UuidV7Factory collision guarantees under clock skew

1 participant