BreakShield CI – Detects Breaking API Changes in PRs Using AST

holesvojta2 pts0 comments

BreakShield CI — Catch breaking API changes before they ship

Free during beta · No credit card required<br>Stop shipping<br>broken APIs<br>BreakShield CI watches every pull request and catches breaking changes in TypeScript interfaces and OpenAPI specs — with AST-verified proof of exactly who gets affected.<br>Install on GitHub — it's freeSee how it works ↓<br>Analysis time<br>95%AST confidence<br>0Config files needed

Pull Request #42 — refactor: clean up UserResponse APImain ← feature/cleanup<br>✕BreakShield CI<br>1 breaking change · HIGH risk · merge blocked

Details<br>breakshield-cibot · just now🔴 HIGH RISK<br>⚡ BreakShield CI — API Contract Analysis<br>UserResponse.email<br>removed fieldsrc/types/user.ts94% — AST-verified<br>Property email removed from UserResponse. 2 consumer files affected.<br>src/components/UserCard.tsx:23 · 94% confidence<br>return `${user.name} `<br>src/pages/profile.tsx:41 · 88% confidence<br>const { email, name } = user

Works with any GitHub repositoryTypeScriptOpenAPINext.jsNestJSExpressFastify

How it works<br>Zero setup. Works on every PR.<br>Install once. BreakShield CI runs automatically on every pull request — no YAML, no CLI, no config.<br>01

30 seconds<br>Install the GitHub App<br>One click. BreakShield CI gets read access to your pull requests and repository contents. Nothing else.

02

Automatic<br>Open a pull request<br>Push your branch and open a PR as usual. BreakShield CI starts analyzing in the background immediately.

03

Get instant results<br>A detailed report appears in your PR with breaking changes, affected files, exact line numbers, and a risk level.

Features<br>Built for teams that care about API contracts<br>🔬<br>AST-verified evidence<br>Every finding is backed by real code. We parse your TypeScript with ts-morph and show you the exact line that breaks — not a guess, not a regex match. If there's no evidence, there's no warning.

📋<br>TypeScript + OpenAPI<br>Interfaces, type aliases, functions, REST endpoints, request bodies, response schemas.

🎯<br>Confidence scoring<br>Each finding is scored 0–100. Noise is filtered automatically.

🛡️<br>Merge protection<br>HIGH and CRITICAL risk PRs get a failing check run that blocks merge.

Results in seconds<br>Analysis runs in the background. No waiting, no timeouts.

📊<br>Risk levels<br>SAFE · LOW · MEDIUM · HIGH · CRITICAL — based on blast radius.

Detection<br>Every breaking change that matters<br>⚠ Breaking — blocks merge<br>Removed fieldUserResponse.email deleted<br>Changed typeid: string → id: number<br>Removed endpointDELETE /users/{id} gone<br>Optional → requiredname?: string → name: string<br>Removed parametergetUser(id, opts) → getUser(id)<br>Added required fieldNew required email in request body

✓ Safe — passes<br>Added optional fieldNew bio?: string added<br>New endpoint addedPOST /users/search added<br>Widened typestring → string | null

Pricing<br>Free during beta<br>No limits, no credit card. Help us improve by using it and sharing feedback.<br>Beta<br>$0/mo<br>Free forever during beta

✓Unlimited repositories<br>✓Unlimited pull requests<br>✓TypeScript + OpenAPI analysis<br>✓AST-verified consumer evidence<br>✓PR comments + Check Runs<br>✓Risk scoring & merge protection<br>✓Priority support<br>Install for free →<br>“We merged a PR that removed a field used in 6 places. Took 3 hours to debug in production. BreakShield CI would have caught it in seconds.”<br>— Every backend developer, at least once

Your next breaking change<br>is already in a PR<br>Install BreakShield CI in 30 seconds. Free during beta.<br>Install on GitHub — it's free

breakshield breaking free pull request install

Related Articles