feature: Added 'google.api.field_info' format annotation to UUID.

CHANGELOG.md

@@ -19,6 +19,19 @@ Date format: `YYYY-MM-DD`
 
 ---
 
+## [1.58.0] - 2026-01-05
+
+### Added
+- **feature:** Added `google.api.field_info` format annotation to UUID value field with UUID4 format specification per [AIP-202](https://google.aip.dev/202), enabling machine-readable format validation and enhancing API documentation. See [protocolbuffers/protobuf#2224](https://github.com/protocolbuffers/protobuf/issues/2224#issuecomment-3711636308) for more details.
+
+### Changed
+### Deprecated
+### Removed
+### Fixed
+### Security
+
+---
+
 ## [1.57.4] - 2025-12-29
 
 ### Added
@@ -32,8 +45,6 @@ Date format: `YYYY-MM-DD`
 
 ---
 
----
-
 ## [1.57.3] - 2025-12-29
 
 ### Added
@@ -503,7 +514,8 @@ package sixafter.types.proto.v1;
 ### Fixed
 ### Security
 
-[Unreleased]: https://github.com/sixafter/types/compare/v1.57.4...HEAD
+[Unreleased]: https://github.com/sixafter/types/compare/v1.58.0...HEAD
+[1.58.0]: https://github.com/sixafter/types/compare/v1.57.4...v1.58.0
 [1.57.4]: https://github.com/sixafter/types/compare/v1.57.3...v1.57.4
 [1.57.3]: https://github.com/sixafter/types/compare/v1.57.2...v1.57.3
 [1.57.2]: https://github.com/sixafter/types/compare/v1.57.1...v1.57.2

buf.lock

@@ -0,0 +1,6 @@
+# Generated by buf. DO NOT EDIT.
+version: v2
+deps:
+  - name: buf.build/googleapis/googleapis
+    commit: 004180b77378443887d3b55cabc00384
+    digest: b5:e8f475fe3330f31f5fd86ac689093bcd274e19611a09db91f41d637cb9197881ce89882b94d13a58738e53c91c6e4bae7dc1feba85f590164c975a89e25115dc

buf.yaml

@@ -15,6 +15,9 @@
 # ref: https://buf.build/docs/configuration/v2/buf-yaml/
 version: v2
 
+deps:
+  - buf.build/googleapis/googleapis
+
 # Define the module for this proto package
 modules:
   - path: .

go.mod

@@ -22,6 +22,7 @@ go 1.25
 require (
 	github.com/google/uuid v1.6.0
 	github.com/stretchr/testify v1.11.1
+	google.golang.org/genproto/googleapis/api v0.0.0-20251222181119-0a764e51fe1b
 	google.golang.org/protobuf v1.36.11
 )
 

go.sum

@@ -8,6 +8,8 @@ github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZb
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
 github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+google.golang.org/genproto/googleapis/api v0.0.0-20251222181119-0a764e51fe1b h1:uA40e2M6fYRBf0+8uN5mLlqUtV192iiksiICIBkYJ1E=
+google.golang.org/genproto/googleapis/api v0.0.0-20251222181119-0a764e51fe1b/go.mod h1:Xa7le7qx2vmqB/SzWUBa7KdMjpdpAHlh5QCSnjessQk=
 google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=
 google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=

proto/v1/uuid.proto

@@ -19,6 +19,8 @@ syntax = "proto3";
 
 package sixafter.types.proto.v1;
 
+import "google/api/field_info.proto";
+
 option cc_enable_arenas = true;
 option csharp_namespace = "SixAfter.Types.V1.WellKnownTypes";
 option go_package = "github.com/sixafter/types/proto/v1/pb;types";
@@ -42,5 +44,7 @@ message UUID {
   // MUST be exactly 16 bytes.
   // The value should follow the canonical RFC 4122 binary encoding.
   // If the value is not 16 bytes, the message is considered invalid.
-  bytes value = 1;
+  // See AIP-148 Standard Fields: https://google.aip.dev/148
+  // See AIP-202 Fields: https://google.aip.dev/202
+  bytes value = 1 [(google.api.field_info).format = UUID4];
 }