Skip to content

test: verify all 48 timestamp bits in UUID v7 - #233

Open
renanmpimentel wants to merge 1 commit into
google:masterfrom
renanmpimentel:test/v7-full-timestamp
Open

renanmpimentel wants to merge 1 commit into
google:masterfrom
renanmpimentel:test/v7-full-timestamp

Conversation

@renanmpimentel

@renanmpimentel renanmpimentel commented Oct 22, 2026 •

Copy link
Copy Markdown

Why this test matters

A v7 implementation could discard the highest of its 48 timestamp bits yet pass tests using smaller times. This deterministic clock case checks the whole timestamp field and catches truncation above 2^40 ms.

Supertest audit method

I used the Supertest test-audit skill to probe whether the existing suite would catch a plausible violation of this contract. The regression was applied only in an isolated worktree. The regression proof records three executed states: the existing tests pass with that regression, the new assertion fails against the same regression, and the new test passes with the original production code restored. The published diff adds tests only.

Change and verification

Adds a deterministic public API test that checks all 48 timestamp bits in a UUID v7. It fixes the clock at 2 << 40 Unix milliseconds and verifies the six timestamp bytes, then restores the shared clock and monotonic state.

Regression proof: setting the highest timestamp byte to zero leaves the existing go test ./... suite passing, but fails this assertion (000000000000 instead of 020000000000). With production code restored, go test ./..., go test -race ./..., go vet ./..., gofmt, and git diff --check pass.

This PR changes tests only.

Repository guidance

CONTRIBUTING.md asks for tests and a signed CLA. Tests, race tests, vet, and formatting passed locally; the GitHub CLA check currently fails, so contribution acceptance is pending that external requirement.

@renanmpimentel
renanmpimentel requested a review from a team as a code owner October 22, 2026 21:12
@google-cla

google-cla Bot commented Oct 22, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

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