v1.3.0
npm distribution. Kairo becomes installable like a real developer
tool. No new architecture subsystems, no schema changes, no new MCP
tools — packaging, distribution, install smoke, docs.
Added
-
PUBLISHING.md— single-file maintainer runbook covering npm
account / 2FA prerequisites, the pre-publish gate (mirrors the
install-smoke CI job), the actualnpm publishflow, and the
72-hournpm deprecate/npm unpublishdiscipline. Every
npm publishis a human decision; this file is the reference. -
publishConfig.access: "public"inpackage.json— defensive
(the package name is unscoped, so this is already npm's default,
but explicit-over-implicit is cheaper to get right once). -
Expanded npm
keywords(15 entries, up from 7) for npm search
discoverability: addsclaude,cursor,ai-coding,agent-memory,
local-first,deterministic,cli,typescript. No behaviour
change — npm metadata only. -
Install-smoke now exercises
kairo initend-to-end. The CI
job (1) installs the packed tarball into a fresh project, (2)
runskairo init --jsonand assertsmcpJson === 'written',
(3) verifies.mcp.jsonexists and wireskairo, (4) re-runs
kairo init --jsonand asserts the second run reportsmcpJson === 'skipped'(idempotency contract). Catches every packaging
regression that affects the documented Quick start path.
Changed
- README Quick start now leads with
npm install -g kairo-mcp.
The git-install path is preserved as a "dev tip" fallback for users
who want main-branch builds. Thenpx -p kairo-mcp kairo init
no-install path is documented honestly — including why-p kairo-mcpis needed (npm packages with multiple bins resolve
npx <pkg>to the bin matching the package name, which here is the
MCP server, not the CLI).
Not done in this release (deliberate)
- No actual
npm publishfrom this commit. v1.3.0 is ready
to publish, but the publish itself is a human action run from a
clean local checkout with 2FA. SeePUBLISHING.md. - No MCP tool, schema, persisted artefact, or stability registry
changes. The CLI surface remains experimental per ADR-0016.
Notes
- 193/193 tests pass.
npm pack --dry-runconfirms a clean 266 kB / 384-file tarball:
no.kairo/, no tests, no fixtures, no.git, no.github. Only
dist/,README.md,LICENSE,CHANGELOG.mdship.- The three bins (
kairo,kairo-mcp,kairo-inspect) all land on
PATH afternpm install -g kairo-mcp. After publish, the
documented Quick start becomesnpm install -g kairo-mcp; cd your-project; kairo init— three commands, ≤60 seconds.