docs(secrets): add wire-evolution policy header to secrets_hub.proto (review follow-up)

Claude-Session: https://claude.ai/code/session_014WNM4vjoVksyyBraTXSZE1
2026-08-07 05:56:09 -04:00
parent 5fd7bf524a
commit cf6d19d09d
1 changed files with 6 additions and 0 deletions
@@ -4,6 +4,12 @@ package zb.mom.ww.secrets.hub.v1;

 option csharp_namespace = "ZB.MOM.WW.Secrets.Replicator.Grpc.V1";

+// Wire-compatibility policy: this contract evolves additively only. Never
+// renumber or repurpose an existing field number. When a field is removed, add
+// a `reserved` range (and `reserved` name) covering it in the same change so a
+// future editor cannot accidentally reuse the retired tag. There are no
+// `reserved` declarations today because no field has ever been removed.
+
 // The central-hosted secrets hub, as seen by a site node.
 //
 // PULL-ONLY BY CONSTRUCTION. This service mirrors exactly the read half of