delimit-cli 3.3.0 → 3.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +34 -62
  2. package/glama.json +1 -0
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -1,89 +1,61 @@
1
1
  # delimit
2
2
 
3
- Catch breaking API changes before they ship.
3
+ Stop Describing. Start Building.
4
4
 
5
5
  [![npm](https://img.shields.io/npm/v/delimit-cli)](https://www.npmjs.com/package/delimit-cli)
6
- [![GitHub Action](https://img.shields.io/badge/Marketplace-Delimit-blue)](https://github.com/marketplace/actions/delimit-api-governance)
7
6
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
8
7
 
9
- Deterministic diff engine for OpenAPI specs. Detects breaking changes, classifies semver, enforces policy, and posts PR comments with migration guides. No API keys, no external services.
8
+ 77 MCP governance tools for AI coding assistants. Prevents hallucinated results, verifies tests actually ran, enforces policies, and catches breaking API changes. Works with Claude Code, Codex, and Cursor.
10
9
 
11
- ---
12
-
13
- ## GitHub Action (recommended)
14
-
15
- ```yaml
16
- name: API Contract Check
17
- on: pull_request
18
-
19
- jobs:
20
- delimit:
21
- runs-on: ubuntu-latest
22
- permissions:
23
- pull-requests: write
24
- steps:
25
- - uses: actions/checkout@v4
26
- - uses: delimit-ai/delimit-action@v1
27
- with:
28
- spec: api/openapi.yaml
29
- ```
30
-
31
- One input. Delimit fetches the base branch version automatically. Runs in **advisory mode** by default -- posts a PR comment but does not fail your build. Set `mode: enforce` to block merges on breaking changes.
32
-
33
- ---
34
-
35
- ## CLI
10
+ ## Install
36
11
 
37
12
  ```bash
38
- npx delimit-cli lint api/openapi.yaml
39
- npx delimit-cli diff old.yaml new.yaml
40
- npx delimit-cli explain old.yaml new.yaml --template migration
13
+ npx delimit-cli setup
41
14
  ```
42
15
 
43
- Or install globally:
16
+ 10 seconds. No API keys. No account. Installs MCP tools into your existing AI coding assistant.
44
17
 
45
- ```bash
46
- npm install -g delimit-cli
47
- delimit init --preset default
48
- delimit lint api/openapi.yaml
49
- ```
18
+ ## What happens
50
19
 
51
- ### Commands
20
+ Your AI agent gets 77 governance tools that verify its own work:
52
21
 
53
- | Command | What it does |
54
- |---------|-------------|
55
- | `delimit init [--preset]` | Create `.delimit/policies.yml` with a policy preset |
56
- | `delimit lint <spec>` | Diff + policy check. Exit 1 on violations. |
57
- | `delimit diff <old> <new>` | Raw diff with `[BREAKING]` / `[safe]` tags |
58
- | `delimit explain <old> <new>` | Human-readable summary (7 templates) |
22
+ - **Test verification** confirms tests actually ran, measures coverage
23
+ - **Security audit** — scans dependencies, detects hardcoded secrets and anti-patterns
24
+ - **API governance** catches breaking changes in OpenAPI specs before they ship
25
+ - **Repo analysis** code quality, health checks, config validation
26
+ - **Deploy tracking** plan, build, publish, verify, rollback
27
+ - **Multi-model consensus** Grok + Gemini + Codex deliberate on strategic decisions
59
28
 
60
- ### Policy presets
29
+ ## Real examples
61
30
 
62
- ```bash
63
- delimit init --preset strict # All breaking changes are errors
64
- delimit init --preset default # Breaking = error, type changes = warn
65
- delimit init --preset relaxed # Everything is a warning
66
- ```
31
+ These happened in a single session:
67
32
 
68
- Or inline: `delimit lint --policy strict api/openapi.yaml`
33
+ | Command | Result |
34
+ |---------|--------|
35
+ | "keep building" | Parallel agents replaced 37 dead tools with real implementations |
36
+ | "fix the 502 error" | Traced Vercel → Caddy → Docker, found wrong IP, fixed, verified |
37
+ | "run test coverage" | 299 → 1,113 tests, zero written manually |
38
+ | "run consensus on pricing" | 3 AI models debated, reached unanimous agreement |
69
39
 
70
- ---
40
+ ## Free vs Pro
71
41
 
72
- ## What it catches
42
+ **Free (15 tools)**: lint, diff, policy, semver, test coverage, security audit, repo analysis, zero-spec extraction, and more.
73
43
 
74
- 10 breaking change types (endpoint removed, method removed, required param added, param removed, response removed, required field added, response field removed, type changed, format changed, enum value removed) plus 7 non-breaking types for full visibility. Every change classified as `MAJOR`, `MINOR`, `PATCH`, or `NONE`.
44
+ **Pro ($10/mo)**: governance, deploy tracking, memory/vault, multi-model deliberation, evidence collection. Activate with `delimit activate YOUR_KEY`.
75
45
 
76
- Supports OpenAPI 3.0, 3.1, and Swagger 2.0 in YAML or JSON.
46
+ ## Also works in CI
77
47
 
78
- ---
48
+ ```yaml
49
+ - uses: delimit-ai/delimit-action@v1
50
+ with:
51
+ spec: api/openapi.yaml
52
+ ```
79
53
 
80
54
  ## Links
81
55
 
82
56
  - [delimit.ai](https://delimit.ai)
83
- - [GitHub Action](https://github.com/marketplace/actions/delimit-api-governance)
84
- - [delimit-cli on npm](https://www.npmjs.com/package/delimit-cli)
85
- - [Quickstart repo](https://github.com/delimit-ai/delimit-quickstart)
86
-
87
- ## License
57
+ - [GitHub](https://github.com/delimit-ai/delimit)
58
+ - [Pricing](https://delimit.ai/pricing)
59
+ - [Docs](https://delimit.ai/docs)
88
60
 
89
- MIT
61
+ MIT License
package/glama.json ADDED
@@ -0,0 +1 @@
1
+ { "$schema": "https://glama.ai/mcp/schemas/server.json", "maintainers": ["infracore"] }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "delimit-cli",
3
- "version": "3.3.0",
4
- "description": "AI agent guardrails for developers. Install governance tools into Claude Code with one command.",
3
+ "version": "3.4.0",
4
+ "description": "Stop Describing. Start Building. 77 MCP governance tools for AI coding assistants.",
5
5
  "main": "index.js",
6
6
  "bin": {
7
7
  "delimit": "./bin/delimit-cli.js",