@kaminari-ad/mcp 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -7,6 +7,71 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-05-18
+
+Patch release — clear Node-version error message, correct `engines`
+declaration, and the default API URL is now the real API host. No
+tool surface change.
+
+### Fixed
+
+- **Default `KAMINARI_AD_API_URL` pointed at the wrong host.**
+  v0.2.0 defaulted to `https://kaminari.ad`, which is the marketing
+  landing page — `kaminari.ad` does NOT serve `/api/v1/*` routes
+  (returns HTTP 404 for every tool call). The actual API host is
+  `https://app.kaminari.ad` (note the `app.` subdomain).
+  Users who set `KAMINARI_AD_API_URL` explicitly were unaffected;
+  users who relied on the default got 404 on every tool call. The
+  internal `gen-api-types` script already used the correct host
+  (`app.kaminari.ad`) for OpenAPI generation — only the runtime
+  default drifted. Now corrected here, in `.env.example`, and pinned
+  by a unit test against future regressions.
+- **Cryptic `webidl.util.markAsUncloneable is not a function`
+  startup crash on Node < 22.19.** The underlying `undici@8.x`
+  removed feature probes in v8.0.3 and now imports `markAsUncloneable`
+  unconditionally — that symbol only exists on Node 22.19+. v0.2.0
+  declared `engines.node = ">=22.13.0"`, so npm warned but did not
+  block install on Node 22.13–22.18 or Node 20; users hit the
+  cryptic webidl error at first invocation.
+  - `engines.node` bumped to `>=22.19.0` to match the real floor.
+    Consumers with `engine-strict=true` (or `npm install
+    --engine-strict`) are now blocked at install time with a clear
+    `EBADENGINE` message.
+  - New runtime preflight in `bin.ts::main()` catches the case where
+    install slipped through (npx pulls fresh on every run; npx does
+    not honour `engine-strict` by default). Prints a clean message
+    and exits with code 2, BEFORE any dynamic import pulls undici:
+
+    ```
+    @kaminari-ad/mcp requires Node.js >=22.19.0 (you have v20.x.x).
+    The underlying undici 8.x HTTP client uses markAsUncloneable
+    from node:worker_threads, available only on Node 22.19+.
+    Older Node crashes at import time with the cryptic message
+    `webidl.util.markAsUncloneable is not a function`.
+
+    Please upgrade Node and re-run: https://nodejs.org/en/download
+    ```
+
+### Internal
+
+- `tsup.config.ts` flipped to `splitting: true`. Required for the
+  preflight to actually run before undici loads: without splitting
+  esbuild inlines every dynamic `await import("./presentation/...")`
+  call into the top-level bundle, eagerly importing undici/MCP SDK/
+  pino at startup. With splitting on, transport bootstraps stay as
+  separate chunks loaded only after `main()` runs the Node check.
+- `scripts/check-bundle-size.ts` rewritten to aggregate every
+  runtime `.js` chunk under `dist/` instead of just `dist/bin.js`.
+  With splitting on, `bin.js` is a thin ~5 KB preflight + dispatch
+  shim and the actual shipping cost lives in the transport / vendor
+  chunks. Total artifact: 173 KB across 5 chunks (smaller than
+  v0.2.0's 218 KB monolithic bundle thanks to tree-shaking now seeing
+  each chunk in isolation). Limit unchanged at 500 KB.
+- `src/shared/check-node-version.ts` — pure function extracted from
+  `bin.ts` so the version preflight can be unit-tested without
+  `process.exit` side effects. Test pins all boundary cases (22.18 /
+  22.19 / 22.20 / 23.x / 20.x / prerelease tags / garbage input).
+
 ## [0.2.0] - 2026-05-17
 
 Comprehensive parser-drift sweep across all `/api/v1/*` list
@@ -571,7 +636,9 @@ Initial public release. The first version that ships to npm under
   need them.
 - Invoice PDF fetcher — same reason.
 
-[Unreleased]: https://github.com/kaminari-ad/mcp/compare/v0.1.5...HEAD
+[Unreleased]: https://github.com/kaminari-ad/mcp/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/kaminari-ad/mcp/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/kaminari-ad/mcp/compare/v0.1.5...v0.2.0
 [0.1.5]: https://github.com/kaminari-ad/mcp/compare/v0.1.0...v0.1.5
 [0.1.4]: https://github.com/kaminari-ad/mcp/compare/v0.1.0...v0.1.4
 [0.1.3]: https://github.com/kaminari-ad/mcp/compare/v0.1.0...v0.1.3

package/README.md

@@ -121,7 +121,7 @@ make test-unit       # unit only
 make test-isolation  # tenant-isolation suite
 ```
 
-Or directly with `npm` if you have Node 22 LTS on the host (matches `.nvmrc` / `engines.node`):
+Or directly with `npm` if you have Node `>=22.19.0` on the host (matches `engines.node`; `.nvmrc` pins the minor for dev parity with CI). The package gates strictly at `22.19.0` because `undici@8.x` requires `markAsUncloneable` from `node:worker_threads` (Node 22.19+).
 
 ```bash
 npm ci --legacy-peer-deps