Skip to content

docs(skills): cover the local contract override in /fetch-protos - #1328

Merged
bmc08gt merged 1 commit into
code/cashfrom
docs/fetch-protos-skill
Aug 26, 2026
Merged

docs(skills): cover the local contract override in /fetch-protos#1328
bmc08gt merged 1 commit into
code/cashfrom
docs/fetch-protos-skill

Conversation

@bmc08gt

@bmc08gt bmc08gt commented Aug 25, 2026

Copy link
Copy Markdown
Collaborator

When the contract change you need is not released yet, /fetch-protos told you to publish one from the client repo. That path still exists for CI release builds, but it is no longer the way to try a field — Maven Central will not take a version number twice, so a throwaway release burns a real version.

protoLocalRoot in local.properties includes ocp-client-protocol and flipcash2-client-protocol from the orchestrator workspace as composite builds. Gradle substitutes them for the published coordinates because the group and module match, so the pins in gradle/libs.versions.toml are ignored while it is set. local.properties is untracked and CI never writes it.

The skill now:

  • reports the override in its pre-flight context alongside the pinned versions
  • replaces the publish-first paragraph with the local loop, and says to skip Step 2 and Step 3 in that mode since there is no pin to bump
  • notes that Step 4 also builds the client repo when the override is on, so a broken .proto surfaces as a codegen failure in the included build
  • warns against leaving protoLocalRoot set on a handed-off branch, where it silently overrides the pins for whoever builds next

The full loop, including what stops a local state from shipping, is in docs/proto-local-development.md in the cross-platform orchestrator.

The matching iOS change is code-payments/code-ios-app#647.

The skill told you to publish a release when the contract change you need
isn't out yet. That path still exists for CI release builds, but it is no
longer the way to try a field: `protoLocalRoot` in `local.properties`
includes both client repos as composite builds, and Gradle substitutes them
for the published coordinates.

Adds the override to the pre-flight context, replaces the publish-first
paragraph with the local loop, notes that Step 4 then builds the client repo
too, and warns against leaving the property set on a handed-off branch.
@github-actions github-actions Bot added the type: docs Documentation label Aug 25, 2026
@bmc08gt
bmc08gt merged commit bf47dac into code/cash Aug 26, 2026
3 checks passed
@bmc08gt
bmc08gt deleted the docs/fetch-protos-skill branch August 26, 2026 13:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type: docs Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant