Skip to content

chore: backfill public API visibility markers - #895

Merged
Aniruddha-Shriwant merged 1 commit into
mainfrom
chore/backfill-operation-visibility
Sep 10, 2026
Merged

Aniruddha-Shriwant merged 1 commit into
mainfrom
chore/backfill-operation-visibility

Conversation

@Aniruddha-Shriwant

@Aniruddha-Shriwant Aniruddha-Shriwant commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Description

Establishes a one-time visibility baseline for the existing OpenAPI inventory by adding x-internal: false to every operation that does not already have an explicit marker.

This preserves current rendered behavior for previously unmarked operations and treats them as grandfathered public documentation. It does not reclassify the 10 operations already marked x-internal: true.

This PR is intentionally mechanical:

  • 571 x-internal: false additions across 493 modular source files
  • 10 existing x-internal: true decisions preserved
  • 544 corresponding additions across 10 generated role bundles
  • no request, response, schema, runtime, or API behavior changes

After this PR merges, #887 can enforce the native Redocly visibility rule globally without a changed-file wrapper.

Validation

  • Confirmed every source Operation Object has a boolean x-internal value: 571 false, 10 true, 0 missing, 0 invalid
  • Confirmed all 11 role roots pass the native Redocly visibility rule
  • Regenerated all 11 bundles with repository-pinned Redocly CLI 2.19.0
  • Confirmed every committed bundle matches a fresh Redocly 2.19.0 build
  • Confirmed source and bundle diffs contain only x-internal: false additions
  • Contract inventory: 493 source files, 10 affected roles, bulk mode, 0 request/response risk-marker lines

Clickup

app.clickup.com

@Aniruddha-Shriwant
Aniruddha-Shriwant merged commit ced041b into main Sep 10, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/L Large PR

Development

Successfully merging this pull request may close these issues.

2 participants