Skip to content

Commit ab47c71

Browse files
infracoreinfracore
andauthored
Add Delimit — API breaking change detection (27 types) (#718)
Co-authored-by: infracore <infracore@delimit.ai>
1 parent 06c55a5 commit ab47c71

1 file changed

Lines changed: 48 additions & 0 deletions

File tree

src/content/tools/delimit.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
name: Delimit
3+
description: |
4+
Catch breaking API changes before merge. 27 detection types (17 breaking, 10 non-breaking), semver classification, migration guides, and policy enforcement for OpenAPI specs. Works as a GitHub Action, CLI, and MCP server for AI coding assistants.
5+
categories:
6+
- linting
7+
- testing
8+
link: https://delimit.ai
9+
languages:
10+
any: true
11+
repo: https://github.com/delimit-ai/delimit
12+
oaiSpecs:
13+
oas: true
14+
overlays: false
15+
arazzo: false
16+
oasVersions:
17+
v2: true
18+
v3: true
19+
v3_1: true
20+
v3_2: false
21+
---
22+
23+
## Overview
24+
25+
Delimit detects breaking API changes in OpenAPI specs with 27 change types — deterministic rules, not AI inference. Same input always produces the same result.
26+
27+
## Features
28+
29+
- **GitHub Action** — runs on every PR, posts severity-graded comments with migration guides
30+
- **CLI**`npx delimit-cli lint`, `diff`, `explain` for local development
31+
- **MCP Server** — 81 tools for AI coding assistants (Claude Code, Codex, Cursor, Gemini CLI)
32+
- **Policy enforcement** — custom rules in `.delimit/policies.yml` with presets (strict/default/relaxed)
33+
- **Semver classification** — deterministic MAJOR/MINOR/PATCH/NONE recommendation
34+
35+
## Usage
36+
37+
```yaml
38+
# GitHub Action
39+
- uses: delimit-ai/delimit-action@v1
40+
with:
41+
spec: api/openapi.yaml
42+
```
43+
44+
```bash
45+
# CLI
46+
npx delimit-cli lint old.yaml new.yaml
47+
npx delimit-cli diff old.yaml new.yaml
48+
```

0 commit comments

Comments
 (0)