@@ -62,27 +62,51 @@ npm run test # vitest
6262
6363All four must pass before shipping. Run in order: lint -> typecheck -> build -> test.
6464
65- ## npm Publishing (Local Only)
65+ ## Release Protocol
6666
67- - npm publish is manual/local (no GitHub Action publish workflow).
68- - Use this command:
67+ ### Version Bumping
68+
69+ | Change Type | Bump | Example |
70+ | -------------| ------| ---------|
71+ | New MCP tools, new views, new metrics | minor | 1.0.1 → 1.1.0 |
72+ | Bug fixes, description changes, doc sync | patch | 1.1.0 → 1.1.1 |
73+ | Breaking: removed tool, changed tool params | major | 1.1.0 → 2.0.0 |
74+
75+ ### Release Flow
76+
77+ ```
78+ 1. All quality gates pass (lint → typecheck → build → test)
79+ 2. Bump version in package.json
80+ 3. Commit: "chore(release): bump to vX.Y.Z"
81+ 4. Tag: git tag vX.Y.Z
82+ 5. Push: git push origin main --tags
83+ 6. Publish: pnpm publish:npm
84+ ```
85+
86+ ### Commands
6987
7088``` bash
89+ # Bump version (edit package.json, then:)
90+ git add package.json && git commit -m " chore(release): bump to vX.Y.Z"
91+ git tag vX.Y.Z
92+ git push origin main --tags
93+
94+ # Publish to npm (runs lint → typecheck → build → test → publish)
7195pnpm publish:npm
7296```
7397
74- What it does:
98+ ### Prerequisites
99+ - ` npm login ` completed on your machine
100+ - npm account/package permissions set
101+ - if npm 2FA is enabled, provide OTP during publish
102+
103+ ### What ` pnpm publish:npm ` does
751041 . lint
761052 . typecheck
771063 . build
781074 . test
791085 . ` npm publish --access public `
80109
81- Prerequisites:
82- - ` npm login ` completed on your machine
83- - npm account/package permissions set
84- - if npm 2FA is enabled, provide OTP during publish
85-
86110### ESLint Rules
87111- Strict type-checked config (` strictTypeChecked ` )
88112- No ` any ` — use ` unknown ` + type guards
0 commit comments