v1.15.1

What's Changed

• build(deps): bump jsonschema/oas3/tests/testsuite from 646f11d to 8b826d6 by @dependabot[bot] in #132
• fix: add explicit flags for overlay commands to match documentation by @TristanSpeakEasy in #135
• chore(cmd): update openapi dependency to latest main by @github-actions[bot] in #134

Full Changelog: v1.15.0...v1.15.1

OpenAPI CLI v1.15.1

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

• 443f8a8 fix: add explicit flags for overlay commands to match documentation (#135)

Others

• 0b4c862 Merge pull request #134 from speakeasy-api/bot/update-cmd-openapi-dependency
• 0fe6793 build(deps): bump jsonschema/oas3/tests/testsuite (#132)
• ab3bd34 chore(cmd): update openapi dependency to latest main

---

Full Changelog: v1.15.0...v1.15.1

Released by GoReleaser.

v1.15.0

What's Changed

• build(deps): bump jsonschema/oas3/tests/testsuite from d69537a to 646f11d by @dependabot[bot] in #125
• fix(deps): bump golang.org/x/text from 0.32.0 to 0.33.0 in the go-minor-patch group across 1 directory by @dependabot[bot] in #126
• fix: rename 3_2_0.yaml to expected_3_2_0_upgraded.yaml and add upgrade test by @TristanSpeakEasy in #129
• feat(overlay): add full support for Overlay specification 1.1.0 by @TristanSpeakEasy in #130
• chore(cmd): update openapi dependency to latest main by @github-actions[bot] in #127
• feat(cli): add overlay upgrade command for upgrading to Overlay 1.1.0 by @TristanSpeakEasy in #131

Full Changelog: v1.14.0...v1.15.0

OpenAPI CLI v1.15.0

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Features

• 361dde0 feat(cli): add overlay upgrade command for upgrading to Overlay 1.1.0 (#131)
• 7194fef feat(overlay): add full support for Overlay specification 1.1.0 (#130)

Bug fixes

• ba4cb1b fix(deps): bump golang.org/x/text (#126)
• 79617f7 fix: rename 3_2_0.yaml to expected_3_2_0_upgraded.yaml and add upgrade test (#129)

Others

• f5a0299 build(deps): bump jsonschema/oas3/tests/testsuite (#125)
• 0dee2a9 chore(cmd): update openapi dependency to latest main (#127)

---

Full Changelog: v1.14.0...v1.15.0

Released by GoReleaser.

v1.14.0

New Features

JSON Schema $id and $anchor Reference Resolution (#123)

Implements full JSON Schema $id and $anchor reference resolution for OpenAPI 3.1+ documents. This enables proper resolution of references that use $id URIs (absolute or relative) and $anchor fragment identifiers within JSON Schema definitions.

Capabilities

• $id Resolution: Resolve references to $id URIs within the same document or across external documents
• Relative $id Handling: Properly resolve relative $id URIs that build on parent base URIs
• $anchor Resolution: Resolve fragment identifiers like #my-anchor to schemas with matching $anchor values
• Nested Reference Rebasing: Correctly rebase nested references relative to their containing $id scope

Implementation Details

Introduced a Schema Registry system that:

• Registers schemas with $id and $anchor during document population for O(1) lookups
• Computes effective base URIs for each schema, properly handling relative $id resolution
• Resolves references via the registry when standard JSON Pointer resolution fails
• Maintains circular reference detection for registry-resolved references

No Breaking Changes

The new functionality is additive and fully backward compatible.

OpenAPI CLI v1.14.0

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Features

• 58b79e9 feat: add support for $id and $anchor reference resolution (#123)

Others

• 59985e9 build(deps): bump jsonschema/oas3/tests/testsuite (#122)
• c60b597 chore(cmd): update openapi dependency to latest main (#124)

---

Full Changelog: v1.13.1...v1.14.0

Released by GoReleaser.

v1.13.1

Bug Fixes

• jsonschema/oas3: Fix infinite loop in GetReferenceChain() with circular references (#120)

Details

The GetReferenceChain() method now tracks visited schemas to prevent infinite loops when encountering circular references in the parent chain (e.g., self-referential schemas like linked list nodes).

OpenAPI CLI v1.13.1

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

• 26c5ce1 fix: prevent infinite loop in GetReferenceChain() with circular references (#120)

Others

• df7febb chore(cmd): update openapi dependency to latest main (#121)

---

Full Changelog: v1.13.0...v1.13.1

Released by GoReleaser.

v1.13.0

What's New

Reference Chain Tracking API

This release adds a new API for tracking reference resolution chains in JSON Schema, enabling callers to understand how nested $ref references were resolved and which schemas share common references.

New Methods on JSONSchema:

• GetReferenceChain() - Returns the full chain of references from outermost (top-level parent) to innermost (immediate parent)
• GetImmediateReference() - Returns just the immediate parent reference that resolved to this schema
• GetTopLevelReference() - Returns the outermost reference that started the resolution chain

Each method returns ReferenceChainEntry containing both the referencing schema and its $ref value.

Example

For a response schema referencing Schema1, which in turn references SchemaShared:

Response → Schema1 → SchemaShared

Calling GetReferenceChain() on the resolved SchemaShared returns:

1. Response schema with reference "#/components/schemas/Schema1"
2. Schema1 with reference "#/components/schemas/SchemaShared"

Full Changelog

• feat: add reference chain tracking API for nested schema references (#119)

OpenAPI CLI v1.13.0

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Features

• e557409 feat: add reference chain tracking API for nested schema references (#119)

Others

• f38f2bd build(deps): bump jsonschema/oas3/tests/testsuite (#118)
• b4c15d7 chore(cmd): update openapi dependency to latest main (#117)

---

Full Changelog: v1.12.8...v1.13.0

Released by GoReleaser.

v1.12.8

What's Changed

• chore(deps): bump jsonschema/oas3/tests/testsuite from d69537a to 910af73 by @dependabot[bot] in #112
• ci(deps): bump the github-actions group with 3 updates by @dependabot[bot] in #114
• fix(deps): bump the go-minor-patch group across 1 directory with 2 updates by @dependabot[bot] in #115
• chore(cmd): update openapi dependency to latest main by @github-actions[bot] in #116

Full Changelog: v1.12.7...v1.12.8

OpenAPI CLI v1.12.8

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

• c3d150e fix(deps): bump the go-minor-patch group across 1 directory with 2 updates (#115)

Others

• ea7e120 chore(cmd): update openapi dependency to latest main (#116)
• 89b01a3 chore(deps): bump jsonschema/oas3/tests/testsuite (#112)
• 55be37e ci(deps): bump the github-actions group with 3 updates (#114)

---

Full Changelog: v1.12.7...v1.12.8

Released by GoReleaser.

v1.12.7

What's Changed

• fix: prevent race condition panic when unmarshalling YAML with duplicate keys by @TristanSpeakEasy in #110
• chore(cmd): update openapi dependency to latest main by @github-actions[bot] in #111

Full Changelog: v1.12.6...v1.12.7

OpenAPI CLI v1.12.7

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

• 4734f4d fix: prevent race condition panic when unmarshalling YAML with duplicate keys (#110)

Others

• cd7c2d8 chore(cmd): update openapi dependency to latest main (#111)

---

Full Changelog: v1.12.6...v1.12.7

Released by GoReleaser.

v1.12.6

What's Changed

• fix: convert YAML numbers with leading zeros to JSON strings by @TristanSpeakEasy in #108
• chore(cmd): update openapi dependency to latest main by @github-actions[bot] in #109

Full Changelog: v1.12.5...v1.12.6

OpenAPI CLI v1.12.6

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

• 0f1a2b0 fix: convert YAML numbers with leading zeros to JSON strings (#108)

Others

• a9fb29b chore(cmd): update openapi dependency to latest main (#109)

---

Full Changelog: v1.12.5...v1.12.6

Released by GoReleaser.

v1.12.5

What's Changed

• fix: validate empty component names in schema $ref and use spec-compliant separator by @TristanSpeakEasy in #106
• chore(cmd): update openapi dependency to latest main by @github-actions[bot] in #107

Full Changelog: v1.12.4...v1.12.5

OpenAPI CLI v1.12.5

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

• 0a6a0de fix: validate empty component names in schema $ref and use spec-compliant separator (#106)

Others

• 76cb102 chore(cmd): update openapi dependency to latest main (#107)

---

Full Changelog: v1.12.4...v1.12.5

Released by GoReleaser.

v1.12.4

What's Changed

• test: improve test coverage by @TristanSpeakEasy in #104
• chore(cmd): update openapi dependency to latest main by @github-actions[bot] in #105

Full Changelog: v1.12.3...v1.12.4

OpenAPI CLI v1.12.4

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Others

• c4b3dac chore(cmd): update openapi dependency to latest main (#105)

---

Full Changelog: v1.12.3...v1.12.4

Released by GoReleaser.