dohertj2/mxaccessgw
1
0
Fork 0
Code Issues 14 Pull Requests 2 Actions Packages Projects Releases Wiki Activity

fix(IPC-23,IPC-24,IPC-25,IPC-32): proto-comment regen wave + codegen-freshness guards

Browse Source 
Proto comments (comment-only, no wire change):
- mxaccess_worker.proto GatewayHello.max_frame_bytes: every worker->gateway frame
  must serialize within the negotiated max; reply builders truncate (IPC-23).
- mxaccess_gateway.proto DrainEventsReply: count-cap + byte-cap, drain-until-empty
  caller contract (IPC-23).
- mxaccess_gateway.proto ReplayGap.oldest_available_sequence: empty-ring value is
  highest-observed+1, oldest-1 resume formula stays valid (GWC-25 deferred amendment).

Regen wave: Contracts/Generated (C# XML doc), rust vendored protos (byte-copy),
Go bindings (worker binding was genuinely stale - lacked MaxFrameBytes entirely),
Python worker _pb2 (real descriptor delta), Java aggregates (javadoc, zero
protobuf-version churn under the pinned toolchain), client descriptor set.

IPC-24: pinned Java toolchain regenerates with no gencode-version churn, so the
unconditional churn-revert step in ci.yml is a fossil - deleted it; git diff is
now a true message-level drift gate for the single-file Java aggregates.

IPC-25: pin protoc-gen-go v1.36.11 / protoc-gen-go-grpc 1.6.2 in the Go generate
script (+ fix a latent pwsh-7 parse bug); add Check 4 to check-codegen.ps1
(regenerate Go+Python bindings, fail on diff, tool-missing fails not skips); add
the pinned-generator installs to the portable CI job.

IPC-32: relabel check-codegen banners 1/4..4/4 (folded into the Check 4 edit).

Docs: ClientProtoGeneration.md, Contracts.md, GatewayTesting.md, build.gradle
checkGeneratedClean caveat. Tracking: IPC-23/24/25/32 -> Done, GWC-25 proto note
resolved, change-log 2026-08-07.
This commit is contained in:
Joseph Doherty
2026-08-07 07:32:22 -04:00
parent 97f79e79ef
commit eacdd2d453
22 changed files with 469 additions and 82 deletions
Download Patch File Download Diff File Expand all files Collapse all files
clients/java/src/main/generated/main/java/mxaccess_gateway/v1/MxaccessGateway.java
+221
View File
@@ -69110,24 +69110,59 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
com.google.protobuf.MessageOrBuilder {
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
java.util.List<mxaccess_gateway.v1.MxaccessGateway.MxEvent>
getEventsList();
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
mxaccess_gateway.v1.MxaccessGateway.MxEvent getEvents(int index);
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
int getEventsCount();
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
java.util.List<? extends mxaccess_gateway.v1.MxaccessGateway.MxEventOrBuilder>
getEventsOrBuilderList();
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
mxaccess_gateway.v1.MxaccessGateway.MxEventOrBuilder getEventsOrBuilder(
@@ -69175,6 +69210,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
@SuppressWarnings("serial")
private java.util.List<mxaccess_gateway.v1.MxaccessGateway.MxEvent> events_;
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
@java.lang.Override
@@ -69182,6 +69224,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return events_;
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
@java.lang.Override
@@ -69190,6 +69239,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return events_;
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
@java.lang.Override
@@ -69197,6 +69253,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return events_.size();
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
@java.lang.Override
@@ -69204,6 +69267,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return events_.get(index);
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
@java.lang.Override
@@ -69567,6 +69637,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
mxaccess_gateway.v1.MxaccessGateway.MxEvent, mxaccess_gateway.v1.MxaccessGateway.MxEvent.Builder, mxaccess_gateway.v1.MxaccessGateway.MxEventOrBuilder> eventsBuilder_;
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public java.util.List<mxaccess_gateway.v1.MxaccessGateway.MxEvent> getEventsList() {
@@ -69577,6 +69654,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
}
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public int getEventsCount() {
@@ -69587,6 +69671,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
}
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public mxaccess_gateway.v1.MxaccessGateway.MxEvent getEvents(int index) {
@@ -69597,6 +69688,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
}
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public Builder setEvents(
@@ -69614,6 +69712,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return this;
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public Builder setEvents(
@@ -69628,6 +69733,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return this;
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public Builder addEvents(mxaccess_gateway.v1.MxaccessGateway.MxEvent value) {
@@ -69644,6 +69756,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return this;
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public Builder addEvents(
@@ -69661,6 +69780,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return this;
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public Builder addEvents(
@@ -69675,6 +69801,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return this;
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public Builder addEvents(
@@ -69689,6 +69822,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return this;
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public Builder addAllEvents(
@@ -69704,6 +69844,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return this;
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public Builder clearEvents() {
@@ -69717,6 +69864,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return this;
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public Builder removeEvents(int index) {
@@ -69730,6 +69884,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return this;
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public mxaccess_gateway.v1.MxaccessGateway.MxEvent.Builder getEventsBuilder(
@@ -69737,6 +69898,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
return internalGetEventsFieldBuilder().getBuilder(index);
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public mxaccess_gateway.v1.MxaccessGateway.MxEventOrBuilder getEventsOrBuilder(
@@ -69747,6 +69915,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
}
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public java.util.List<? extends mxaccess_gateway.v1.MxaccessGateway.MxEventOrBuilder>
@@ -69758,6 +69933,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
}
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public mxaccess_gateway.v1.MxaccessGateway.MxEvent.Builder addEventsBuilder() {
@@ -69765,6 +69947,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
mxaccess_gateway.v1.MxaccessGateway.MxEvent.getDefaultInstance());
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public mxaccess_gateway.v1.MxaccessGateway.MxEvent.Builder addEventsBuilder(
@@ -69773,6 +69962,13 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
index, mxaccess_gateway.v1.MxaccessGateway.MxEvent.getDefaultInstance());
}
/**
* <pre>
* The reply is bounded by both a server-side count cap and the negotiated
* worker-frame byte cap; a reply may therefore carry fewer events than
* `max_events` and fewer than are queued. Callers drain iteratively until an
* empty reply.
* </pre>
*
* <code>repeated .mxaccess_gateway.v1.MxEvent events = 1;</code>
*/
public java.util.List<mxaccess_gateway.v1.MxaccessGateway.MxEvent.Builder>
@@ -75305,6 +75501,11 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
* after_worker_sequence = oldest_available_sequence - 1 in the next
* StreamEventsRequest, which will cause the server to replay starting at
* oldest_available_sequence (the first retained event).
* When nothing is retained (the replay ring is empty), this is the next sequence
* that can be delivered — `highest observed + 1` — and the `oldest - 1` resume
* formula remains valid: it resolves to the highest sequence already seen, so the
* follow-up resume replays nothing, reports no gap, and every newer live event
* passes. The interval evicted is unchanged.
* </pre>
*
* <code>uint64 oldest_available_sequence = 2;</code>
@@ -75386,6 +75587,11 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
* after_worker_sequence = oldest_available_sequence - 1 in the next
* StreamEventsRequest, which will cause the server to replay starting at
* oldest_available_sequence (the first retained event).
* When nothing is retained (the replay ring is empty), this is the next sequence
* that can be delivered — `highest observed + 1` — and the `oldest - 1` resume
* formula remains valid: it resolves to the highest sequence already seen, so the
* follow-up resume replays nothing, reports no gap, and every newer live event
* passes. The interval evicted is unchanged.
* </pre>
*
* <code>uint64 oldest_available_sequence = 2;</code>
@@ -75781,6 +75987,11 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
* after_worker_sequence = oldest_available_sequence - 1 in the next
* StreamEventsRequest, which will cause the server to replay starting at
* oldest_available_sequence (the first retained event).
* When nothing is retained (the replay ring is empty), this is the next sequence
* that can be delivered — `highest observed + 1` — and the `oldest - 1` resume
* formula remains valid: it resolves to the highest sequence already seen, so the
* follow-up resume replays nothing, reports no gap, and every newer live event
* passes. The interval evicted is unchanged.
* </pre>
*
* <code>uint64 oldest_available_sequence = 2;</code>
@@ -75800,6 +76011,11 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
* after_worker_sequence = oldest_available_sequence - 1 in the next
* StreamEventsRequest, which will cause the server to replay starting at
* oldest_available_sequence (the first retained event).
* When nothing is retained (the replay ring is empty), this is the next sequence
* that can be delivered — `highest observed + 1` — and the `oldest - 1` resume
* formula remains valid: it resolves to the highest sequence already seen, so the
* follow-up resume replays nothing, reports no gap, and every newer live event
* passes. The interval evicted is unchanged.
* </pre>
*
* <code>uint64 oldest_available_sequence = 2;</code>
@@ -75823,6 +76039,11 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
* after_worker_sequence = oldest_available_sequence - 1 in the next
* StreamEventsRequest, which will cause the server to replay starting at
* oldest_available_sequence (the first retained event).
* When nothing is retained (the replay ring is empty), this is the next sequence
* that can be delivered — `highest observed + 1` — and the `oldest - 1` resume
* formula remains valid: it resolves to the highest sequence already seen, so the
* follow-up resume replays nothing, reports no gap, and every newer live event
* passes. The interval evicted is unchanged.
* </pre>
*
* <code>uint64 oldest_available_sequence = 2;</code>
clients/java/src/main/generated/main/java/mxaccess_worker/v1/MxaccessWorker.java
+15
View File
@@ -3797,6 +3797,9 @@ public final class MxaccessWorker extends com.google.protobuf.GeneratedFile {
* instead of a hard-coded default; 0 (an older gateway that never set the field) means
* "use the worker's built-in default". Sits above the public gRPC cap by an
* envelope-overhead margin so an accepted gRPC payload always fits one worker frame.
* Every worker-&gt;gateway frame — events, heartbeats, faults, and control replies
* including DrainEvents — must serialize within this limit; reply builders truncate
* to fit rather than emit an oversized frame.
* </pre>
*
* <code>uint32 max_frame_bytes = 4;</code>
@@ -3941,6 +3944,9 @@ public final class MxaccessWorker extends com.google.protobuf.GeneratedFile {
* instead of a hard-coded default; 0 (an older gateway that never set the field) means
* "use the worker's built-in default". Sits above the public gRPC cap by an
* envelope-overhead margin so an accepted gRPC payload always fits one worker frame.
* Every worker-&gt;gateway frame — events, heartbeats, faults, and control replies
* including DrainEvents — must serialize within this limit; reply builders truncate
* to fit rather than emit an oversized frame.
* </pre>
*
* <code>uint32 max_frame_bytes = 4;</code>
@@ -4499,6 +4505,9 @@ public final class MxaccessWorker extends com.google.protobuf.GeneratedFile {
* instead of a hard-coded default; 0 (an older gateway that never set the field) means
* "use the worker's built-in default". Sits above the public gRPC cap by an
* envelope-overhead margin so an accepted gRPC payload always fits one worker frame.
* Every worker-&gt;gateway frame — events, heartbeats, faults, and control replies
* including DrainEvents — must serialize within this limit; reply builders truncate
* to fit rather than emit an oversized frame.
* </pre>
*
* <code>uint32 max_frame_bytes = 4;</code>
@@ -4515,6 +4524,9 @@ public final class MxaccessWorker extends com.google.protobuf.GeneratedFile {
* instead of a hard-coded default; 0 (an older gateway that never set the field) means
* "use the worker's built-in default". Sits above the public gRPC cap by an
* envelope-overhead margin so an accepted gRPC payload always fits one worker frame.
* Every worker-&gt;gateway frame — events, heartbeats, faults, and control replies
* including DrainEvents — must serialize within this limit; reply builders truncate
* to fit rather than emit an oversized frame.
* </pre>
*
* <code>uint32 max_frame_bytes = 4;</code>
@@ -4535,6 +4547,9 @@ public final class MxaccessWorker extends com.google.protobuf.GeneratedFile {
* instead of a hard-coded default; 0 (an older gateway that never set the field) means
* "use the worker's built-in default". Sits above the public gRPC cap by an
* envelope-overhead margin so an accepted gRPC payload always fits one worker frame.
* Every worker-&gt;gateway frame — events, heartbeats, faults, and control replies
* including DrainEvents — must serialize within this limit; reply builders truncate
* to fit rather than emit an oversized frame.
* </pre>
*
* <code>uint32 max_frame_bytes = 4;</code>
clients/java/zb-mom-ww-mxgateway-client/build.gradle
+8 -7
View File
@@ -63,10 +63,11 @@ protobuf {
// or a plugin/protobuf version bump, silently drifts the committed output. checkGeneratedClean
// fails when the regenerated tree differs from what is committed.
//
// Caveat (repo memory project_java_generated_churn): the protobuf gradle plugin also rewrites
// MxaccessGateway.java with a spurious protobuf-runtime-version delta on every build even when no
// .proto changed. CI reverts that one file (git checkout) before invoking this task; locally, do the
// same when you did not touch a .proto. See docs/GatewayTesting.md "Continuous Integration".
// The grpc/protobuf toolchain is pinned (build.gradle: grpcVersion / protobufVersion), so a
// regeneration is byte-identical to the committed single-file aggregates modulo real .proto
// changes — no spurious protobuf-runtime-version churn (IPC-24 verified this and deleted the old
// unconditional CI churn-revert step, which masked message-level drift). Regenerate and commit
// after any .proto change. See docs/GatewayTesting.md "Continuous Integration".
tasks.register('checkGeneratedClean') {
group = 'verification'
description = 'Fails if the committed generated Java tree differs from a fresh regeneration.'
@@ -83,9 +84,9 @@ tasks.register('checkGeneratedClean') {
def dirty = stdout.toString().trim()
if (!dirty.isEmpty()) {
throw new GradleException(
"Generated Java is stale or churned:\n${dirty}\n" +
"Regenerate and commit after a .proto change, or 'git checkout' the spurious " +
"MxaccessGateway.java protobuf-version churn when no .proto changed.")
"Generated Java is stale:\n${dirty}\n" +
"Regenerate and commit the Java client after a .proto change " +
"(gradle :zb-mom-ww-mxgateway-client:generateProto).")
}
}
}