open source is social v-it.org
add release and ship targets, CLAUDE.md release instructions
+28
-1
+18
CLAUDE.md
+18
CLAUDE.md
···
35
35
- Always run `make test` before committing — all tests must pass.
36
36
- Hand-test affected CLI commands (`./bin/vit.js <command>`) to verify behavior beyond what tests cover.
37
37
38
+
## Releasing
39
+
40
+
Every commit that changes files in `bin/` or `src/` — the packaged CLI code — **must** be followed by a release and publish to npm:
41
+
42
+
```bash
43
+
make ship # bump patch version, tag, push, publish to npm
44
+
make ship BUMP=minor # for new commands or features
45
+
make ship BUMP=major # for breaking changes
46
+
```
47
+
48
+
**This is non-negotiable.** If your commit touches `bin/` or `src/`, run `make ship` before you're done. Use `patch` (default) for fixes and small improvements, `minor` for new commands or features, `major` for breaking changes.
49
+
50
+
`make ship` runs tests, bumps the version in `package.json`, creates a git commit and tag (`vX.Y.Z`), pushes to origin, and publishes to npm — all in one step.
51
+
52
+
Individual targets if needed:
53
+
- `make release` — test, bump, commit, tag, push (no npm publish)
54
+
- `make publish` — npm publish only (assumes version is already bumped)
55
+
38
56
## Hosting
39
57
40
58
The `docs/` directory is published to [v-it.org](https://v-it.org) via GitHub Pages. Pushing to main auto-deploys.
+10
-1
Makefile
+10
-1
Makefile
···
1
-
.PHONY: install link test test-node clean
1
+
BUMP ?= patch
2
+
3
+
.PHONY: install link test test-node clean release publish ship
2
4
3
5
install:
4
6
bun install
···
16
18
clean:
17
19
rm -rf node_modules/
18
20
21
+
release: test
22
+
npm version $(BUMP)
23
+
git push
24
+
git push --tags
25
+
19
26
publish:
20
27
npm publish
28
+
29
+
ship: release publish