[7/N] feat(gateway): add request history lookups

[albertywu]

Summary

feat(gateway): add request history lookups

Test Plan

✅ make fmt && make build && make test && make e2e-test

Local full-stack gRPC verification

• Date: 2026-07-15
• Commit: d814bd69c547418294ba684d49900264189a48fe
• Started a clean local Gateway, Orchestrator, Runway, and MySQL stack with make local-submitqueue-start.
• Called the real Gateway server with grpcurl using api/submitqueue/gateway/proto/gateway.proto.
• Submitted the same pinned change twice. Request 1 landed; request 2 reached error as a duplicate of the in-flight request.

Endpoint	Verified behavior
GetRequestSummaryByID	Returned the landed summary and an error summary containing lastError.
GetRequestSummaryByChangeURI	Returned both matching summaries, newest first.
List	Returned both queue receipts over two pages with pageSize: 1.
GetRequestHistoryByID	Returned chronological histories ending in landed and error.
GetRequestHistoryByChangeURI	Returned both histories in ascending sqid order and preserved terminal lastError.

Exact gRPC requests and stdout

Setup: Land request 1

RPC: uber.submitqueue.gateway.SubmitQueueGateway/Land

Request:

{"queue":"e2e-test-queue","change":{"uris":["github://uber/grpc-verification/pull/790/d814bd69c547418294ba684d49900264189a48fe"]},"strategy":"REBASE"}

STDOUT:

{
  "sqid": "e2e-test-queue/1"
}

Setup: Land request 2 with the same pinned change

RPC: uber.submitqueue.gateway.SubmitQueueGateway/Land

Request:

{"queue":"e2e-test-queue","change":{"uris":["github://uber/grpc-verification/pull/790/d814bd69c547418294ba684d49900264189a48fe"]},"strategy":"REBASE"}

STDOUT:

{
  "sqid": "e2e-test-queue/2"
}

GetRequestSummaryByID: successful request

RPC: uber.submitqueue.gateway.SubmitQueueGateway/GetRequestSummaryByID

Request:

{"sqid":"e2e-test-queue/1"}

STDOUT:

{
  "request": {
    "sqid": "e2e-test-queue/1",
    "queue": "e2e-test-queue",
    "changeUris": [
      "github://uber/grpc-verification/pull/790/d814bd69c547418294ba684d49900264189a48fe"
    ],
    "receivedAtMs": "1784136105896",
    "status": "landed",
    "metadata": {
      "batch_id": "e2e-test-queue/batch/1"
    }
  }
}

GetRequestSummaryByID: duplicate request

RPC: uber.submitqueue.gateway.SubmitQueueGateway/GetRequestSummaryByID

Request:

{"sqid":"e2e-test-queue/2"}

STDOUT:

{
  "request": {
    "sqid": "e2e-test-queue/2",
    "queue": "e2e-test-queue",
    "changeUris": [
      "github://uber/grpc-verification/pull/790/d814bd69c547418294ba684d49900264189a48fe"
    ],
    "receivedAtMs": "1784136105938",
    "status": "error",
    "lastError": "request e2e-test-queue/2 is a duplicate of in-flight request e2e-test-queue/1"
  }
}

GetRequestSummaryByChangeURI

RPC: uber.submitqueue.gateway.SubmitQueueGateway/GetRequestSummaryByChangeURI

Request:

{"changeUri":"github://uber/grpc-verification/pull/790/d814bd69c547418294ba684d49900264189a48fe"}

STDOUT:

{
  "requests": [
    {
      "sqid": "e2e-test-queue/2",
      "queue": "e2e-test-queue",
      "changeUris": [
        "github://uber/grpc-verification/pull/790/d814bd69c547418294ba684d49900264189a48fe"
      ],
      "receivedAtMs": "1784136105938",
      "status": "error",
      "lastError": "request e2e-test-queue/2 is a duplicate of in-flight request e2e-test-queue/1"
    },
    {
      "sqid": "e2e-test-queue/1",
      "queue": "e2e-test-queue",
      "changeUris": [
        "github://uber/grpc-verification/pull/790/d814bd69c547418294ba684d49900264189a48fe"
      ],
      "receivedAtMs": "1784136105896",
      "status": "landed",
      "metadata": {
        "batch_id": "e2e-test-queue/batch/1"
      }
    }
  ]
}

List: first page

RPC: uber.submitqueue.gateway.SubmitQueueGateway/List

Request:

{"queue":"e2e-test-queue","receivedAtOrAfterMs":1784136105896,"receivedBeforeMs":1784136105939,"pageSize":1}

STDOUT:

{
  "requests": [
    {
      "sqid": "e2e-test-queue/2",
      "queue": "e2e-test-queue",
      "changeUris": [
        "github://uber/grpc-verification/pull/790/d814bd69c547418294ba684d49900264189a48fe"
      ],
      "receivedAtMs": "1784136105938",
      "status": "error",
      "lastError": "request e2e-test-queue/2 is a duplicate of in-flight request e2e-test-queue/1"
    }
  ],
  "nextPageToken": "bGFzdF9yZWNlaXZlZF9hdF9tcz0xNzg0MTM2MTA1OTM4Jmxhc3RfcmVxdWVzdF9pZD1lMmUtdGVzdC1xdWV1ZSUyRjImcXVldWU9ZTJlLXRlc3QtcXVldWUmcmVjZWl2ZWRfYXRfb3JfYWZ0ZXJfbXM9MTc4NDEzNjEwNTg5NiZyZWNlaXZlZF9iZWZvcmVfbXM9MTc4NDEzNjEwNTkzOQ"
}

List: second page

RPC: uber.submitqueue.gateway.SubmitQueueGateway/List

Request:

{"queue":"e2e-test-queue","receivedAtOrAfterMs":1784136105896,"receivedBeforeMs":1784136105939,"pageSize":1,"pageToken":"bGFzdF9yZWNlaXZlZF9hdF9tcz0xNzg0MTM2MTA1OTM4Jmxhc3RfcmVxdWVzdF9pZD1lMmUtdGVzdC1xdWV1ZSUyRjImcXVldWU9ZTJlLXRlc3QtcXVldWUmcmVjZWl2ZWRfYXRfb3JfYWZ0ZXJfbXM9MTc4NDEzNjEwNTg5NiZyZWNlaXZlZF9iZWZvcmVfbXM9MTc4NDEzNjEwNTkzOQ"}

STDOUT:

{
  "requests": [
    {
      "sqid": "e2e-test-queue/1",
      "queue": "e2e-test-queue",
      "changeUris": [
        "github://uber/grpc-verification/pull/790/d814bd69c547418294ba684d49900264189a48fe"
      ],
      "receivedAtMs": "1784136105896",
      "status": "landed",
      "metadata": {
        "batch_id": "e2e-test-queue/batch/1"
      }
    }
  ]
}

GetRequestHistoryByID: successful request

RPC: uber.submitqueue.gateway.SubmitQueueGateway/GetRequestHistoryByID

Request:

{"sqid":"e2e-test-queue/1"}

STDOUT:

{
  "events": [
    {
      "timestampMs": "1784136105896",
      "status": "accepted"
    },
    {
      "timestampMs": "1784136106080",
      "status": "started"
    },
    {
      "timestampMs": "1784136106791",
      "status": "batched",
      "metadata": {
        "batch_id": "e2e-test-queue/batch/1"
      }
    },
    {
      "timestampMs": "1784136106965",
      "status": "scored",
      "metadata": {
        "batch_id": "e2e-test-queue/batch/1",
        "score": "0.7000"
      }
    },
    {
      "timestampMs": "1784136108484",
      "status": "landed",
      "metadata": {
        "batch_id": "e2e-test-queue/batch/1"
      }
    }
  ]
}

GetRequestHistoryByID: duplicate request

RPC: uber.submitqueue.gateway.SubmitQueueGateway/GetRequestHistoryByID

Request:

{"sqid":"e2e-test-queue/2"}

STDOUT:

{
  "events": [
    {
      "timestampMs": "1784136105938",
      "status": "accepted"
    },
    {
      "timestampMs": "1784136106086",
      "status": "started"
    },
    {
      "timestampMs": "1784136106461",
      "status": "error",
      "lastError": "request e2e-test-queue/2 is a duplicate of in-flight request e2e-test-queue/1"
    }
  ]
}

GetRequestHistoryByChangeURI

RPC: uber.submitqueue.gateway.SubmitQueueGateway/GetRequestHistoryByChangeURI

Request:

{"changeUri":"github://uber/grpc-verification/pull/790/d814bd69c547418294ba684d49900264189a48fe"}

STDOUT:

{
  "histories": [
    {
      "sqid": "e2e-test-queue/1",
      "events": [
        {
          "timestampMs": "1784136105896",
          "status": "accepted"
        },
        {
          "timestampMs": "1784136106080",
          "status": "started"
        },
        {
          "timestampMs": "1784136106791",
          "status": "batched",
          "metadata": {
            "batch_id": "e2e-test-queue/batch/1"
          }
        },
        {
          "timestampMs": "1784136106965",
          "status": "scored",
          "metadata": {
            "batch_id": "e2e-test-queue/batch/1",
            "score": "0.7000"
          }
        },
        {
          "timestampMs": "1784136108484",
          "status": "landed",
          "metadata": {
            "batch_id": "e2e-test-queue/batch/1"
          }
        }
      ]
    },
    {
      "sqid": "e2e-test-queue/2",
      "events": [
        {
          "timestampMs": "1784136105938",
          "status": "accepted"
        },
        {
          "timestampMs": "1784136106086",
          "status": "started"
        },
        {
          "timestampMs": "1784136106461",
          "status": "error",
          "lastError": "request e2e-test-queue/2 is a duplicate of in-flight request e2e-test-queue/1"
        }
      ]
    }
  ]
}

Issues

Stack

1. [1/N] feat(storage): add request read-model stores #340
2. [2/N] feat(gateway): persist request receipts on Land #341
3. [3/N] feat(request): materialize request log status #342
4. [4/N] feat(submitqueue): activate request status materialization #343
5. [5/N] feat(gateway): add request summary lookups #344
6. [6/N] feat(gateway): add queue request listing #345
7. @ [7/N] feat(gateway): add request history lookups #346