@kirrosh/zond 0.27.0 → 0.27.1

package/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.27.1] — 2026-07-09
+
+m-27 Bucket E (agentic discoverability): metadata release — no engine changes.
+
+### Added
+- **Claude Code plugin / self-serve marketplace (ARV-395):**
+  `.claude-plugin/{plugin,marketplace}.json` — install skills via
+  `/plugin marketplace add kirrosh/zond`; skills mirrored to root
+  `skills/<name>/SKILL.md` (synced from init templates, drift-checked in
+  `bun run check`), also picked up by SkillsMP / `npx skills add kirrosh/zond`.
+- **Agent discovery files (ARV-394):** `llms.txt` (machine index of docs) and
+  `context7.json` (Context7 config with agent rules) at the repo root.
+
+### Changed
+- **Agentic metadata (ARV-393, ARV-400):** canonical tagline in npm
+  `description`, task-shaped `keywords`, `repository`/`homepage`/`bugs` links;
+  agent-first README top (what → when → install → minimal example).
+
 ## [0.27.0] — 2026-07-09
 
 m-27 start-distribution: every install channel works on a clean machine,

package/README.md

@@ -1,8 +1,18 @@
 # zond
 
-API hygiene scanner for small teams — AI-powered API testing for Claude Code, Cursor, and CI/CD.
+API hygiene scanner for small teams and their coding agents — test REST API endpoints against the OpenAPI spec, catch contract drift, track coverage.
 
-Say "test my API" — get working tests, coverage dashboard, and CI config in minutes.
+**Use it when you need to:** test REST API endpoints from an OpenAPI spec,
+verify an API contract after a deploy, debug a failing HTTP request with
+stored run history, or raise endpoint coverage. Works standalone or through
+a coding agent (Claude Code, Cursor) — say "test my API" and the agent
+drives zond for you.
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/kirrosh/zond/master/install.sh | sh   # or: npm i -g @kirrosh/zond
+zond init && zond add api my-api --spec ./openapi.json
+zond audit --api my-api --safe    # read-only pass: spec lint → probes → tests → coverage → HTML report
+```
 
 > **Safe by default.** The first run (`zond audit --safe`) sends read-only
 > GET traffic — no writes, no deletes, nothing destructive. Mutating
@@ -21,6 +31,12 @@ Zond reads your OpenAPI spec and gives your AI agent everything it needs to test
 | **npm** (needs Node 20+) | `npm install -g @kirrosh/zond` |
 | **Windows** | `iwr https://raw.githubusercontent.com/kirrosh/zond/master/install.ps1 \| iex` |
 | **Manual** | grab a binary from [releases](https://github.com/kirrosh/zond/releases/latest) (darwin arm64/x64, linux x64/arm64, win x64) |
+| **Claude Code plugin** | `/plugin marketplace add kirrosh/zond` then `/plugin install zond@zond` — the agent skills without `zond init` |
+| **Agent skills** ([skills.sh](https://www.skills.sh)) | `npx skills add kirrosh/zond` |
+
+The plugin/skills channels ship the [five zond skills](skills/) (audit
+pipeline, depth checks, fixture seeding, triage, target warm-up); the zond
+binary itself still comes from any of the channels above.
 
 Every channel ships the same self-contained binary — no Bun or Node
 required at runtime (npm uses Node only as a thin launcher).

package/package.json

@@ -1,16 +1,31 @@
 {
   "name": "@kirrosh/zond",
-  "version": "0.27.0",
-  "description": "API testing platform — define tests in YAML, run from CLI, generate from OpenAPI specs",
+  "version": "0.27.1",
+  "description": "API hygiene scanner for small teams and their coding agents — test REST API endpoints against the OpenAPI spec, catch contract drift, track coverage.",
   "license": "MIT",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kirrosh/zond.git"
+  },
+  "homepage": "https://github.com/kirrosh/zond#readme",
+  "bugs": {
+    "url": "https://github.com/kirrosh/zond/issues"
+  },
   "keywords": [
-    "api",
-    "testing",
+    "api-testing",
+    "rest-api",
     "openapi",
-    "yaml",
+    "contract-testing",
+    "contract-drift",
+    "schema-validation",
+    "api-coverage",
+    "api-hygiene",
+    "coding-agents",
+    "ai-agents",
+    "claude-code",
+    "sarif",
     "cli",
-    "rest",
     "http"
   ],
   "files": [
@@ -31,11 +46,12 @@
     "test": "bun run test:unit && bun run test:mocked",
     "test:unit": "bun test tests/",
     "test:mocked": "bun run scripts/run-mocked-tests.ts",
-    "check": "tsc --noEmit --project tsconfig.json",
+    "check": "tsc --noEmit --project tsconfig.json && bun run scripts/sync-plugin-skills.ts --check",
     "schemas": "bun run scripts/emit-json-schemas.ts",
     "schemas:check": "bun run scripts/emit-json-schemas.ts --check",
     "lint:dead": "knip --reporter compact",
-    "build": "bun build --compile src/cli/index.ts --outfile dist/zond && bun run scripts/codesign-darwin.ts ./dist/zond"
+    "build": "bun build --compile src/cli/index.ts --outfile dist/zond && bun run scripts/codesign-darwin.ts ./dist/zond",
+    "sync:plugin": "bun run scripts/sync-plugin-skills.ts"
   },
   "devDependencies": {
     "@readme/openapi-parser": "^5.5.0",