Skip to content

Regenerate from v1.7.2+ — drop three unreachable endpoints, add SubgraphLimits - #171

Merged
jfrench9 merged 1 commit into
mainfrom
refactor/drop-shadowed-routes-subgraph-limits
Aug 7, 2026
Merged

Regenerate from v1.7.2+ — drop three unreachable endpoints, add SubgraphLimits#171
jfrench9 merged 1 commit into
mainfrom
refactor/drop-shadowed-routes-subgraph-limits

Conversation

@jfrench9

@jfrench9 jfrench9 commented Aug 7, 2026

Copy link
Copy Markdown
Member

Regenerated against RoboFinSystems/robosystems#1073.

Removed — three endpoints that could only ever 404

getSubgraphQuota, batchProcessQueries, recommendOperator. All three shipped shadowed on the API: a literal path segment registered after a param-segment sibling never wins, because matching stops at the first route whose path matches and params are validated only afterward. They were documented in the OpenAPI spec and generated into this client, but no call to any of them has ever returned a 200.

That is what makes this cheap. Removal breaks symbol resolution, never behavior — no integrator can hold a working integration against a permanent 404. Retracting is the expensive direction only when there is working behavior to protect, and there is none here.

Gone with them: BatchOperatorRequest, BatchOperatorResponse, OperatorRecommendation, OperatorRecommendationRequest, OperatorRecommendationRequestContextType0, OperatorRecommendationResponse, SubgraphQuotaResponse.

Added — SubgraphLimits on getGraphLimits

getSubgraphQuota's data moves onto GraphLimitsResponse.subgraphs, next to documents, which it mirrors: current_count / max_allowed / remaining / approaching_limit. Populated for parent user graphs; absent for shared repositories and subgraphs.

The API now computes approaching_limit rather than leaving callers to derive it, and callers that already fetch limits get the count without a second round-trip.

total_size_mb / max_size_mb are not carried over — they were an unimplemented TODO on the old response that always returned None.

Also picked up — drift since the last generation

Not part of the endpoint change; these are additive backend fields this regen catches up on:

  • EventBlockEnvelope payload-drift field and the eventBlocks filter arg
  • FiscalCalendar stranded-obligation reporting (strandedObligationCount, strandedObligationSample, the stranded_obligations blocker code) and ClosePeriod request/response fields
  • PromoteObligations request/response shapes
  • BackfillPlanHistory operation

schema.graphql refreshed accordingly (2434 → 2445 lines), so the hermetic drift gate stays clean.

Verification

just test-all green — 518 passed, 17 skipped; ruff check + format clean; basedpyright 0 errors.

Version

Left at its current value for you to set on publish. The behavioral case for a patch/minor is above; it is still a public-symbol removal against the integration template's >=1,<2 pin, so the call is yours.

Merge after RoboFinSystems/robosystems#1073.

The API removed three routes that had shipped shadowed: a literal segment
registered after a param-segment sibling never wins, so `getSubgraphQuota`,
`batchProcessQueries` and `recommendOperator` could only ever 404. Removing
them breaks symbol resolution, never behavior — no integration could have
been working against them.

`getSubgraphQuota`'s data moves to `getGraphLimits`, which gains a
`subgraphs` block (`SubgraphLimits`) alongside `documents`. The API now
computes `approaching_limit` rather than leaving callers to derive it.

Also picks up backend drift since the last generation: event-block payload
drift, stranded-obligation reporting on the fiscal calendar, and the
promote-obligations request/response shapes.
@jfrench9
jfrench9 merged commit 168a76b into main Aug 7, 2026
1 check passed
@jfrench9
jfrench9 deleted the refactor/drop-shadowed-routes-subgraph-limits branch August 7, 2026 06:36
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.

1 participant