Description

krova-node


The single home for the Krova Cloud JavaScript / TypeScript packages — SDK,
CLI, MCP server, webhook verifier, and the n8n node. A pnpm-workspace monorepo:
the CLI/MCP consume the SDK via workspace:*, so everything stays in sync and a
cross-package change is one PR.

| Package | npm | What it is |
| — | — | — |
| packages/sdk | @krovacloud/sdk | Typed TypeScript SDK for the Krova Cloud API |
| packages/cli | @krovacloud/cli | The krova CLI (pure Node — built on the SDK) |
| packages/mcp | @krovacloud/mcp | MCP server for Claude/Cursor/etc. |
| packages/webhook | @krovacloud/webhook | Outbound-webhook signature verification |
| packages/n8n-node | n8n-nodes-krova | n8n community node |

Develop

pnpm install
pnpm -r build      # topological — the SDK builds before its consumers
pnpm -r test
pnpm -r typecheck

Releasing (automatic, no manual version bumps)

Every push to main runs scripts/release.mjs: for each
package that changed since its last release tag, it patch-increments the
latest version on npm, publishes it (with provenance), and records a
@ git tag + GitHub release. Unchanged packages are skipped.
An explicit higher version in a package’s package.json is honored as-is.

Publishing uses npm trusted publishing (OIDC) — the release workflow has
id-token: write and runs pnpm publish --provenance, so no NPM_TOKEN (or
any long-lived npm token) is required. See “How releases work” in
CONTRIBUTING.md.