feat(queueconfig): add YAML-backed Store and wire gateway Land validation

[albertywu]

Summary

Adds the first implementation of queueconfig.Store, backed by a YAML file read once at startup. Wires it into the gateway LandController so unknown queue names are rejected at the API edge with a typed UnrecognizedQueueError that carries the queue name.

Also updated the example/server app to use an example queues.yaml config file, and verified that things work end-to-end (see Test Plan down below).

Test Plan

✅make test
✅ Ran make local-gateway-start and verified:

1. can land to a configured queue

> grpcurl -plaintext -d '{"queue":"test-queue","change":{"uris":["github://uber/submitqueue/pull/123/c3a4d5e6f7890123456789abcdef0123456789ab"]}}' \
    localhost:59232 uber.submitqueue.gateway.SubmitQueueGateway/Land
{
  "sqid": "test-queue/1"
}

2. can land again to same configured queue, and see the sqid increment

> grpcurl -plaintext -d '{"queue":"test-queue","change":{"uris":["github://uber/submitqueue/pull/123/c3a4d5e6f7890123456789abcdef0123456789ab"]}}' \
    localhost:59232 uber.submitqueue.gateway.SubmitQueueGateway/Land
{
  "sqid": "test-queue/2"
}

3. when invalid queue name is provided, server responds back with invalid request

> grpcurl -plaintext -d '{"queue":"","change":{"uris":["github://uber/submitqueue/pull/123/c3a4d5e6f7890123456789abcdef0123456789ab"]}}' \
    localhost:59232 uber.submitqueue.gateway.SubmitQueueGateway/Land
ERROR:
  Code: Unknown
  Message: LandController requires the request to have a queue name specified: invalid request

Issues

[Copilot]

Pull request overview

Introduces an initial queueconfig.Store implementation backed by a YAML file loaded at startup, and wires it into the gateway land flow so requests for unknown queues are rejected at the API edge.

Changes:

• Add extension/queueconfig/yaml Store (YAML snapshot in memory) plus tests and Bazel wiring.
• Validate LandRequest.Queue against queueconfig.Store in LandController, returning a typed UnrecognizedQueueError wrapped as a user error on misses.
• Update the example gateway server + container setup to require and provide QUEUE_CONFIG_PATH and a sample queues.yaml.

Reviewed changes

Copilot reviewed 18 out of 19 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
MODULE.bazel	Adds Bazel module repo for gopkg.in/yaml.v3.
Makefile	Includes ./extension/queueconfig/... in mock generation target.
go.mod	Promotes gopkg.in/yaml.v3 to a direct dependency.
gateway/controller/land.go	Adds queue validation via queueconfig.Store and introduces UnrecognizedQueueError.
gateway/controller/land_test.go	Updates constructor usage and adds tests for queue validation behavior.
gateway/controller/BUILD.bazel	Adds queueconfig deps for controller lib/tests.
extension/queueconfig/yaml/yaml.go	Implements YAML-backed queueconfig store loaded once at startup.
extension/queueconfig/yaml/yaml_test.go	Tests YAML store parsing/validation, Get/List behavior, and copy semantics.
extension/queueconfig/yaml/BUILD.bazel	Bazel targets for YAML store and tests.
extension/queueconfig/queueconfig.go	Adds //go:generate directive for mock generation.
extension/queueconfig/mock/queueconfig_mock.go	Adds generated GoMock for queueconfig.Store.
extension/queueconfig/mock/BUILD.bazel	Bazel target for the generated mock package.
example/server/gateway/queues.yaml	Provides sample queue configuration YAML for the example gateway.
example/server/gateway/main.go	Loads queue configs from QUEUE_CONFIG_PATH and injects into LandController.
example/server/gateway/Dockerfile	Bakes the sample queues.yaml into the image.
example/server/gateway/docker-compose.yml	Sets QUEUE_CONFIG_PATH env var for the example gateway container.
example/server/gateway/BUILD.bazel	Adds Bazel dep on the YAML queueconfig store.
example/server/docker-compose.yml	Sets QUEUE_CONFIG_PATH env var for the example stack.
entity/queue_config.go	Minor docstring wording adjustment for BuildRunner.

Files not reviewed (1)

• extension/queueconfig/mock/queueconfig_mock.go: Language not supported

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 18 out of 19 changed files in this pull request and generated 1 comment.

Files not reviewed (1)

• extension/queueconfig/mock/queueconfig_mock.go: Language not supported

[Copilot]

Pull request overview

Copilot reviewed 18 out of 19 changed files in this pull request and generated 1 comment.

Files not reviewed (1)

• extension/queueconfig/mock/queueconfig_mock.go: Language not supported