Skip to content

build: adopt libopenapi v0.41.8 with YAML index fix - #1040

Merged
CaliLuke merged 1 commit into
mainfrom
luca/libopenapi-v0418
Oct 27, 2026
Merged

CaliLuke merged 1 commit into
mainfrom
luca/libopenapi-v0418

Conversation

@CaliLuke

Copy link
Copy Markdown
Owner

Adopt libopenapi v0.41.8 plus the pending effective YAML component-index correction in upstream PR #673, using the published CaliLuke/libopenapi commit 2be7e43876e4. Released v0.41.8 alone still fails the existing alias/merge reference regressions.

Update the isolated contract validator to Vacuum v0.35.4 with released libopenapi v0.41.8, replacing its enum-fix fork override. Dependency notes retain the exact return-to-upstream condition and validation evidence.

Validation: lint and the full root test suite (both passed in the push gate); focused importer normal/rejected cases and YAML races; OpenAPI v3 suite; contract lint and downstream client-generation smoke; generated compilation and independent-process determinism. All 34 captured ordinary/nullable design and generated artifacts are byte-identical to the previous pin.

@coderabbitai

coderabbitai Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review.

Recent review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: 2c234144-ce02-40b0-bd1a-275a27160ad4
Commits

Reviewing files that changed from the base of the PR and between 9c30b10 and 735fbae.

Files ignored due to path filters: 1
  • go.sum is excluded by !**/*.sum
Files selected for processing: 6
  • .agents/skills/loom-framework/references/openapi-validation.md
  • go.mod
  • http/codegen/openapi/internal/ir/lean/discriminator_metadata/README.md
  • http/codegen/openapi/v3/contract_vacuum_test.go
  • internal/openapiimport/testdata/yaml_merge_race/README.md
  • internal/openapiimport/tla/yaml_index_owner/README.md

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

Recent review details
Context from checks skipped due to timeout: 14
  • GitHub Check: testdata-compile (http/codegen)
  • GitHub Check: testdata-compile (jsonrpc/codegen)
  • GitHub Check: race (grpc)
  • GitHub Check: race (http)
  • GitHub Check: testdata-compile (expr)
  • GitHub Check: ci
  • GitHub Check: generated-code-quality
  • GitHub Check: testdata-compile (grpc/codegen)
  • GitHub Check: race (remaining)
  • GitHub Check: race (generator)
  • GitHub Check: testdata-compile (codegen/service)
  • GitHub Check: openapi-contract
  • GitHub Check: Analyze (go)
  • GitHub Check: pulse-redis
Additional context used
Code guidelines: 1
AGENTS.md — auto-discovered
Path-based instructions: 2
Source excerpt: **Go**: Use the stable release pinned in the root `go.mod`.

CodeRabbit inference engine (AGENTS.md)

Files:

  • http/codegen/openapi/v3/contract_vacuum_test.go
Source excerpt: Write table-driven tests in `*_test.go`.

CodeRabbit inference engine (AGENTS.md)

Files:

  • http/codegen/openapi/v3/contract_vacuum_test.go
Additional comments: 6
go.mod: 1

8-8: LGTM!

internal/openapiimport/testdata/yaml_merge_race/README.md: 1

37-43: LGTM!

Also applies to: 64-66

internal/openapiimport/tla/yaml_index_owner/README.md: 1

107-116: LGTM!

Also applies to: 118-121, 123-131

http/codegen/openapi/v3/contract_vacuum_test.go: 1

21-22: LGTM!

Also applies to: 35-35

.agents/skills/loom-framework/references/openapi-validation.md: 1

16-16: LGTM!

Also applies to: 35-35, 37-38, 40-41, 43-45

http/codegen/openapi/internal/ir/lean/discriminator_metadata/README.md: 1

32-32: LGTM!

📝 Summary

Summary by CodeRabbit

  • Documentation

    • Updated API contract validation guidance to reflect the current validation requirements and clarify how component references and enum values are checked.
    • Expanded troubleshooting notes with additional results for YAML aliases and merged component definitions.
  • Tests

    • Updated contract checks to use newer validation tooling and verify API specifications against the revised requirements. These changes improve validation coverage without changing user-facing API behavior.

The root libopenapi dependency changed to a newer pseudo-version. The Vacuum contract test and related documentation now specify Vacuum v0.35.4 and released libopenapi v0.41.8. Supporting documentation records importer and contract validation results.

Changes: OpenAPI dependency and contract

Layer / File(s) Summary
libopenapi correction and importer verification
go.mod, internal/openapiimport/testdata/yaml_merge_race/README.md, internal/openapiimport/tla/yaml_index_owner/README.md
The root dependency uses a newer CaliLuke libopenapi pseudo-version. The documentation records upstream v0.41.8 behavior, TLC results, and importer validation results.
Vacuum contract gate pins and instructions
http/codegen/openapi/v3/contract_vacuum_test.go, .agents/skills/loom-framework/references/openapi-validation.md, http/codegen/openapi/internal/ir/lean/discriminator_metadata/README.md, internal/openapiimport/testdata/yaml_merge_race/README.md
The contract test and gate documentation use Vacuum v0.35.4 and released libopenapi v0.41.8. The instructions describe the direct requirement and when to remove the pin.

Priority: Normal

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Bug fix

Merge Risk: Minimal · up to 735fb

No verified merge-blocking risk remains in the dependency and contract-gate updates.

Pre-merge checks: Passed 4 · Failed 1

Failed Failed checks: 1 warning

Check name Status Explanation Resolution
Docstring Coverage Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Documentation-only edits and deletions within survi… Write docstrings for the functions missing them to satisfy the coverage threshold.
Passed Passed checks: 4 passed
Check name Status Explanation
Title check Passed The title clearly and concisely identifies the main dependency update and YAML index fix described in the changeset.
Description check Passed The description directly explains the libopenapi and Vacuum updates, the YAML index correction, and the reported validation results.
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Full details: Docstring Coverage

Explanation

Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 1 functions across 1 files. (5 skipped: 5 unsupported.)

Resolution

Write docstrings for the functions missing them to satisfy the coverage threshold.

Finishing Touches: 💡 1
📝 Generate docstrings: 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

A rabbit checks the version trail,
With ears held high above the detail.
New pins are noted, tests are run,
The merge paths pass beneath the sun.
Then off I hop, my review done!

Comment @coderabbitai help to get the list of available commands.

@CaliLuke
CaliLuke merged commit 05e0117 into main Oct 27, 2026
18 checks passed
@CaliLuke
CaliLuke deleted the luca/libopenapi-v0418 branch October 28, 2026 00:47
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