llm-contract 0.10.1 — Download trends

Adds a daily npm-download graph to the GitHub and npm package README, refreshed automatically every 12 hours.

llm-contract 0.10.0 — One-command setup

llm-contract 0.10.0 — one command from install to passing test

The package now closes the hardest part of AI evaluation: getting started.

New

• npx llm-contract init creates a runnable behavioral test suite.
• The initializer adds an npm run test:ai script automatically.
• Generated guidance helps Cursor, Codex, Claude, Gemini, Antigravity, and other coding agents preserve behavioral contracts.
• Safe-by-default initialization stops before replacing existing files; --force is explicit.
• --dir supports monorepos and --no-agents supports teams with existing instruction systems.
• The quickstart requires no provider SDK or API key.

Verification

• TypeScript typecheck passes.
• 54 tests pass across 18 test files.
• ESM, CommonJS, declarations, adapters, and CLI builds pass.

npm install llm-contract
npx llm-contract init
npm run test:ai

llm-contract v0.9.0

llm-contract 0.9.0

The first public release of llm-contract: deterministic-first behavioral contract testing and regression detection for LLMs and AI agents.

Highlights

• Reusable TypeScript contracts with synchronous or asynchronous custom assertions.
• Syntactic, structural, semantic, grounding, and behavioral validation layers.
• Zod, Valibot, and a documented zero-dependency JSON Schema subset.
• Dataset suites, structured baseline comparison, regression/fix detection, and repeated-run stability analysis.
• Stable failure categories, weighted soft checks, hard invariants, and inspectable evidence.
• CI policies for pass rate, regressions, flakiness, scores, and zero-tolerance failures.
• Terminal, JSON, Markdown, and self-contained HTML reports.
• Provider-agnostic ESM/CommonJS library and CLI.

Install

npm install llm-contract

Links

• npm package
• GitHub Packages mirror: @alivirgo/llm-contract
• Documentation
• Launch article: Stop Shipping Broken AI

The release was verified across Node.js 18, 20, 22, and 24. The repository CI and local release checks pass all 53 tests.