Skip to content

ContractGuard v1.0.1 — Explainable OpenAPI compatibility checks

Choose a tag to compare

View all tags
@mingxian233 mingxian233 released this 23 Sep 05:56
· 2 commits to main since this release
v1.0.1
517018f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

ContractGuard v1.0.1 strengthens reliability, security, documentation, and open-source usability for local-first OpenAPI compatibility analysis.

Highlights

  • Direction-aware compatibility rules with stable IDs, precise locations, evidence, and remediation.
  • Web workspace plus JSON, Markdown, and HTML exports.
  • CLI/CI gate with configurable thresholds and exit code 2 for incompatible changes.
  • Optional DeepSeek summaries that cannot alter findings, scores, compatibility decisions, or CI exit codes.
  • Bounded AI responses, runtime JSON validation, timeout handling, and grounded change IDs.
  • Safer analysis IDs, filenames, local JSON Pointer handling, and temporary-file cleanup.
  • English and Chinese documentation, structured issue forms, contributor guidance, and an inspectable sample report.

Verification

  • 67 automated tests across the core engine, API, CLI, and Web app.
  • 2 end-to-end fixture cases.
  • Documentation-link, example-configuration, and smoke checks in CI.
  • GitHub Actions CI passed on Node.js 22 for the tagged commit.

Try it

Current boundaries

Local $ref only; no external or cross-file references; composition semantics are partial; the compatibility score is a risk-ordering heuristic, not a guarantee of production safety.

Assets 2
Loading