[Tooling] Add protocheck CLI tool

[bryanchriswhite]

Summary

Add protocheck CLI tool and unstable subcommand to resolve stable serialization issue related to map protobuf message fields:

go run ./tools/scripts/protocheck/cmd unstable -h:

Recursively list or fix all protobuf files which omit the 'stable_marshaler_all' option.

Usage:
  protocheck unstable [flags]

Flags:
  -f, --fix    If present, protocheck will add the 'gogoproto.stable_marshaler_all' option to files which were discovered to be unstable.
  -h, --help   help for unstable

Global Flags:
  -p, --file-pattern string   Set the pattern passed to filepath.Match(), used to include file names which match. (default "*.proto")
  -r, --root string           Set the path of the directory from which to start walking the filesystem tree in search of files matching --file-pattern. (default "./proto")

Issue

This mitigates non-deterministic serialization due to usage of map fields in protobuf message fields.

It does not address any non-deterministic serialization due to mis-usage of repeated protobuf message fields, which is a much more complex concern.

• [Protobufs] Ensure deterministic serialization #761

Type of change

Select one or more:

• New feature, functionality or library
• Bug fix
• Code health or cleanup
• Documentation
• Other (specify)

Testing

• Documentation: make docusaurus_start; only needed if you make doc changes
• Unit Tests: make go_develop_and_test
• LocalNet E2E Tests: make test_e2e
• DevNet E2E Tests: Add the devnet-test-e2e label to the PR.

Sanity Checklist

• I have tested my changes using the available tooling
• I have commented my code
• I have performed a self-review of my own code; both comments & source code
• I create and reference any new tickets, if applicable
• I have left TODOs throughout the codebase, if applicable

[okdas]

Looks good, one more thing I'd love this script to do though is to return non-zero exit code on make check_proto_unstable_marshalers.

Currently:

❯ make check_proto_unstable_marshalers
INF Recursively checking for files matching "*.proto" in "./proto"
INF Found 52 unstable marshaler proto files:
INF 	proto/poktroll/gateway/query.proto
... more
❯ echo $?
0

Why: that will allow us to add make check_proto_unstable_marshalers as a CI step which will act as a gate before we merge into the main branch.

[bryanchriswhite]

Looks good, one more thing I'd love this script to do though is to return non-zero exit code on `make ...

Nice observation! 😎 That was an oversight on my part. 🙇 Will fix.

[Olshansk]

@bryanchriswhite Thanks for building the tool!

Just a couple things. Per my comment in #772, I'm thinking we could:

1. Make it part of CI (or at least a TODO)
2. Document it here: https://dev.poktroll.com/develop/developer_guide/debug_tips