feat(stovepipe): add project status lookup by request ID

Makefile

@@ -613,6 +613,7 @@ GO_GENERATE_PACKAGES := \
 	./platform/extension/hook/... \
 	./platform/extension/messagequeue/... \
 	./runway/extension/merger/... \
+	./stovepipe/controller/... \
 	./stovepipe/core/requestlog/... \
 	./stovepipe/extension/buildrunner/... \
 	./stovepipe/extension/projectstatus/... \

api/stovepipe/proto/stovepipe.proto

@@ -106,6 +106,20 @@ message GetRequestHistoryByURIResponse {
     repeated RequestHistory histories = 1;
 }
 
+// GetProjectStatusByIDRequest selects the validation status for the ID returned from Ingest.
+message GetProjectStatusByIDRequest {
+    // Logical queue containing the validation request.
+    string queue = 1;
+    // Canonical decimal request identifier returned from Ingest.
+    string request_id = 2;
+    // Required consumer-defined project IDs whose recorded results are requested.
+    repeated string projects = 3;
+    // Maximum requested projects to return in one page. Zero selects the server default.
+    int32 page_size = 4;
+    // Opaque continuation token for requested-project result pagination.
+    string page_token = 5;
+}
+
 // GetProjectStatusByURIRequest selects the validation status for an exact commit URI.
 message GetProjectStatusByURIRequest {
     // Logical queue containing the validation request.
@@ -130,6 +144,32 @@ message ProjectValidation {
     }
 }
 
+// GetProjectStatusByIDResponse contains the selected validation's current projection.
+message GetProjectStatusByIDResponse {
+    // Queue-scoped decimal identifier of the validation request.
+    string request_id = 1;
+    // Logical queue containing the validation request.
+    string queue = 2;
+    // VCS-agnostic URI of the commit under validation.
+    string change_uri = 3;
+    // Baseline URI for incremental validation. Empty for a full build.
+    string base_uri = 4;
+    // Stable public lifecycle state of the validation request.
+    string request_state = 5;
+    // Unix millisecond timestamp of the newest durable lifecycle or result record.
+    int64 updated_at_ms = 10;
+    // Whole-repository breakage degree. Absent until the result is durable.
+    oneof repository_result {
+        double repository_breakage_degree = 6;
+    }
+    // True after the implementation has durably finished producing relevant project results.
+    bool project_results_complete = 7;
+    // Recorded results for requested projects.
+    repeated ProjectValidation projects = 8;
+    // Opaque continuation token for another requested-project result page. Empty on the final page.
+    string next_page_token = 9;
+}
+
 // GetProjectStatusByURIResponse contains the selected validation's current projection.
 message GetProjectStatusByURIResponse {
     // Queue-scoped decimal identifier of the validation request.
@@ -214,6 +254,8 @@ service Stovepipe {
     rpc GetRequestHistoryByID(GetRequestHistoryByIDRequest) returns (GetRequestHistoryByIDResponse) {}
     // GetRequestHistoryByURI returns retained histories for an exact commit URI.
     rpc GetRequestHistoryByURI(GetRequestHistoryByURIRequest) returns (GetRequestHistoryByURIResponse) {}
+    // GetProjectStatusByID returns the current validation status for one request ID.
+    rpc GetProjectStatusByID(GetProjectStatusByIDRequest) returns (GetProjectStatusByIDResponse) {}
     // GetProjectStatusByURI returns the current validation status for an exact commit URI.
     rpc GetProjectStatusByURI(GetProjectStatusByURIRequest) returns (GetProjectStatusByURIResponse) {}
     // List returns a queue-scoped page of current request summaries.