Community · E2 · artifact verified

Catch contract drift hidden in OpenAPI prose

OAS Sentinel compares two OpenAPI documents in two layers: deterministic checks find structural breaks, and Jev answers bounded semantic questions about changed prose - retries, ordering, pagination, error meaning - that schema diffs cannot see.

01 · Role in the system

What Jev does here

Structural compatibility is checked deterministically; the semantic layer sends bounded questions to Jev about what changed in descriptions, examples, defaults, retry behavior, ordering, pagination, authorization, and error semantics. Jev never writes a review and never changes a specification - it returns typed decisions with probabilities, and deterministic Python decides whether to pass, request review, or block. The output is a counts table plus per-operation findings, available as markdown or SARIF. A dry-run mode needs no API key: it shows exactly which changed prose would be sent for semantic review. The reproducible benchmark suite exercises ten semantic-only contract changes, and a separate repository verifies the published GitHub Action and SARIF upload from a real consumer workflow. Ships on PyPI and the GitHub Marketplace as an independent, unaffiliated community project.

02 · Control boundary

Where Jev sits

Deterministic diff first; bounded semantic questions to Jev second; deterministic code turns typed answers into pass, review, or block with SARIF output.

Code owns the loop, permissions, thresholds, validation, and side effects. Jev owns only the bounded judgments described above.

03 · Known limits

What this evidence does not prove

  • Semantic review needs an API key and sends the changed prose of your specification to the provider; the dry-run shows the scope before you enable it.
  • The benchmark suite is ten hand-built semantic changes, not a corpus study.
  • An independent community project, explicitly unaffiliated with TypeSafe AI, in early status.

04 · Attribution

Public sources

This is a Community record: the project was published by a third-party community author.