Skip to content

feat(spec): add OpenAPI 3.1 specification lock, catalog generator, and coverage tracking - #443

Merged
robbecker-wf merged 1 commit into
10xfrom
10x-openapi-spec-baseline
Sep 17, 2026
Merged

robbecker-wf merged 1 commit into
10xfrom
10x-openapi-spec-baseline

Conversation

@robbecker-wf

@robbecker-wf robbecker-wf commented Sep 16, 2026 •

Copy link
Copy Markdown
Contributor

Stacked PR: Part 1 of 7

Stack Overview:

  1. #443 10x-openapi-spec-baseline (this PR) -> 10x
  2. #444 10x-security-and-transport -> 10x-openapi-spec-baseline
  3. #445 10x-service-contracts-conformance -> 10x-security-and-transport
  4. #446 10x-schema-models-and-strict-analysis -> 10x-service-contracts-conformance
  5. #447 10x-test-pyramid-and-smoke -> 10x-schema-models-and-strict-analysis
  6. #448 10x-ci-and-spec-sync -> 10x-test-pyramid-and-smoke
  7. #449 10x-conformance-plan -> 10x-ci-and-spec-sync

Summary

Establishes a reproducible OpenAPI 3.1 specification baseline pinned to GitHub's REST API description (2022-11-28).

  • Lockfile: Pinned upstream commit, SHA-256 digest, OpenAPI version, and generator schema in tool/spec/github-openapi.lock.json.
  • Spec Loader & Generator: Added OpenAPI loader with $ref resolution and deterministic generator producing immutable REST contracts in lib/src/common/generated/rest_contracts.g.dart (1,229 operations).
  • Bindings Manifest & Coverage: Tracked supported/partial/deprecated service bindings in tool/spec/bindings.yaml and generated documentation in docs/api-coverage.md.
  • Tooling & Validation: Added tool/spec_sync.dart supporting --check, --update, --offline, and --report-json; added regression tests in test/unit/spec_sync_test.dart.

…d coverage tracking

Co-authored-by: Cursor <cursoragent@cursor.com>
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