Skip to content

feat(stovepipe): define GetProjectStatusByURI API - #637

Open
mnoah1 wants to merge 1 commit into
mainfrom
mnoah1/stovepipe-get-validation-api
Open

feat(stovepipe): define GetProjectStatusByURI API#637
mnoah1 wants to merge 1 commit into
mainfrom
mnoah1/stovepipe-get-validation-api

Conversation

@mnoah1

@mnoah1 mnoah1 commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Summary

Define and publish the Stovepipe GetProjectStatusByURI current-state API for queue- and commit-scoped validation lookup.

Intent

  • Provide CD clients with the current request lifecycle and durable validation result for an exact commit URI.
  • Keep the RFC and reviewed protobuf contract together in one core design change.
  • Reserve a paginated project-result shape for the later project-level rollout.

Changes

  • Adds the GetProjectStatusByURI request, response, RPC, and generated gRPC/YARPC bindings.
  • Uses optional scalar breakage degrees so an absent result remains distinct from fully green degree zero.
  • Defines authoritative request selection, public lifecycle states, project-list completion, pagination, and phased rollout behavior.
  • Links the RFC to the published protobuf types instead of duplicating the wire contract.

Test Plan

问题

Stack

  1. @ feat(stovepipe): define GetProjectStatusByURI API #637
  2. feat(stovepipe): implement GetProjectStatusByURI controller #649

@mnoah1 mnoah1 changed the title docs(stovepipe): propose GetValidation API [draft/wipdocs(stovepipe): propose GetValidation API Aug 26, 2026
@mnoah1 mnoah1 changed the title [draft/wipdocs(stovepipe): propose GetValidation API [draft/wip] docs(stovepipe): propose GetValidation API Aug 26, 2026
@mnoah1 mnoah1 changed the title [draft/wip] docs(stovepipe): propose GetValidation API docs(stovepipe): propose GetValidation API Aug 26, 2026
@mnoah1 mnoah1 changed the title docs(stovepipe): propose GetValidation API [draft/wip] docs(stovepipe): propose GetValidation API Aug 26, 2026
mnoah1 added a commit that referenced this pull request Aug 27, 2026
Summary:
Intent:
- Expose a stable, queue-scoped contract for reading retained request history.
- Establish the shared validation result shape used by recorded validation facts.

Changes:
- Add request-ID and URI history requests with cursor pagination.
- Add the history projection messages and generated gRPC and YARPC bindings.
- Align the request-history RFC example on the public entry identifier.

This PR builds on #637 in the Stovepipe API proposal stack.

---

<sub>Generated by the 🪄 [pr-create](https://sg.uberinternal.com/code.uber.internal/uber-code/devexp-agent-marketplace/-/blob/claude-code/plugins/dev/uber-dev/skills/pr-create/SKILL.md) skill in devexp-agent-marketplace</sub>
@mnoah1
mnoah1 force-pushed the mnoah1/stovepipe-get-validation-api branch from a3459c7 to 09423b6 比较 August 27, 2026 15:39
@mnoah1
mnoah1 changed the base branch from mnoah1/stovepipe-history-api to main August 27, 2026 15:39
@mnoah1 mnoah1 changed the title [draft/wip] docs(stovepipe): propose GetValidation API docs(stovepipe): propose GetProjectStatusByURI API Aug 27, 2026
@mnoah1
mnoah1 force-pushed the mnoah1/stovepipe-get-validation-api branch 2 times, most recently from 93837f3 to e595f9e 比较 August 27, 2026 17:27
@mnoah1 mnoah1 changed the title docs(stovepipe): propose GetProjectStatusByURI API feat(stovepipe): define GetProjectStatusByURI API Aug 27, 2026
@mnoah1
mnoah1 force-pushed the mnoah1/stovepipe-get-validation-api branch from e595f9e to b3d1fab 比较 August 27, 2026 20:35
@mnoah1
mnoah1 marked this pull request as ready for review August 27, 2026 20:45
@mnoah1
mnoah1 requested review from a team, behinddwalls and sbalabanov as code owners August 27, 2026 20:45
@mnoah1
mnoah1 force-pushed the mnoah1/stovepipe-get-validation-api branch from 93199d8 to b3d1fab 比较 August 28, 2026 18:31
}

// ProjectValidation contains one planned project and any recorded result.
message ProjectValidation {

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should this be just ProjectStatus

optional double repository_breakage_degree = 6;
// Whether every planned project has one durable result and completion is recorded. False
// until the project list is available.
bool project_results_complete = 7;

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what is this for? I am unable to relate what does it support?

// Breakage degree measures how broken the whole repository is on [0.0, 1.0]. Unset until its
// fact is recorded; zero is fully green and one is fully broken. Values are directly
// comparable: lower values are greener, and any value above zero is not green.
optional double repository_breakage_degree = 6;

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why is this optional? I assume if project is not provided we are retruning overall status plus paged projects

注册 for free to join this conversation on GitHub. Already have an account? 登录 to comment

标签

None yet

项目

None yet

Development

Successfully merging this pull request may close these issues.

2 participants