Skip to content

feat(stovepipe): define queue status API and RFC - #854

Open
mnoah1 wants to merge 7 commits into
mainfrom
mnoah1/stovepipe-queue-state-api
Open

mnoah1 wants to merge 7 commits into
mainfrom
mnoah1/stovepipe-queue-state-api

Conversation

@mnoah1

@mnoah1 mnoah1 commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Why?

Queue enablement needs a dedicated lookup: validation results and the current queue row do not identify the state covering an arbitrary commit.

What?

Define GetQueueStatus with an optional change URI and an enablement field of type QueueEnablementStatus, commit generated bindings, and document inclusive boundaries, intermediate commits and error semantics in the indexed RFC. The RPC remains unimplemented until the final layer.

Test Plan

Build the published bindings and run the Stovepipe server tests. The final stack also passes all 27 Stovepipe unit, MySQL integration, service integration and end-to-end targets.

Revert Plan

Revert this layer together with any dependent layers in the stack.

Stack

Review in this order; each PR targets the preceding branch.

  1. API and RFC (this PR)
  2. Storage
  3. Transitions and materialization
  4. Lookup

@mnoah1
mnoah1 added this pull request to stack #858 October 14, 2026 15:45
@mnoah1 mnoah1 changed the title feat(stovepipe): [DRAFT] define queue status API and RFC feat(stovepipe): define queue status API and RFC Oct 14, 2026
@mnoah1
mnoah1 marked this pull request as ready for review October 14, 2026 17:57
@mnoah1
mnoah1 requested review from a team, behinddwalls and sbalabanov as code owners October 14, 2026 17:57
// Required stable repo-and-ref queue name.
string queue = 1;
// Optional immutable commit URI. Empty selects the latest materialized state.
string change_uri = 2;

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.

this can be any commit and not just the ones we processed?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Yes that's correct.

@behinddwalls behinddwalls left a comment

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.

Proto and RFC look good: the wire change is additive, the zero value is a sentinel, and the RFC matches the proto fields. I have one suggestion about a test.

Comment thread api/stovepipe/proto/stovepipe.proto Outdated
Summary:
Queue enablement needs a dedicated lookup: validation results and the current queue row do not identify the state covering an arbitrary commit.

Define GetQueueStatus with an optional change URI and one selected state, commit generated bindings, and document inclusive boundaries, intermediate commits and error semantics in the indexed RFC. The RPC remains unimplemented until the final layer.

Part 1 of 4: API and RFC → storage → transitions and materialization → lookup.

Test Plan:
Build the published bindings and run the Stovepipe server tests. The final stack also passes all 27 Stovepipe unit, MySQL integration, service integration and end-to-end targets.
@mnoah1
mnoah1 force-pushed the mnoah1/stovepipe-queue-state-api branch from 95adb11 to 8c55c7e Compare October 14, 2026 22:35

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants