@tritard/waterbrother 0.16.157 → 0.16.159

package/README.md

@@ -328,23 +328,41 @@ Current Telegram behavior:
 Partners should ship updates by pushing a version tag, not by running `npm publish` locally.
 
 1. Add an npm publish token as the repository secret `NPM_TOKEN`. The token must be able to publish `@tritard/waterbrother`.
-2. Bump the package version locally:
+2. If you already committed the feature/docs slice, run one command from a tracked-clean repo:
 
 ```bash
-npm run release:version -- patch
+npm run release:patch
 ```
 
-Use `minor`, `major`, or an explicit version like `0.16.136` when appropriate.
+That command now:
+- bumps the patch version
+- commits `package.json` and `package-lock.json`
+- tags the release
+- pushes `main`
+- pushes the release tag
+- waits until the npm registry reports the new version
 
-3. Push `main` and the new tag:
+3. If you want the feature plus version bump to ship as one release commit, skip the separate feature commit and run:
 
 ```bash
-git push origin main --tags
+npm run release:patch:tracked
 ```
 
-4. GitHub Actions runs `.github/workflows/publish.yml` and publishes the package after `npm ci`, `npm run check`, and `npm run smoke` pass.
+That mode stages the current tracked worktree slice plus release metadata into the single `Release vX.Y.Z` commit. It ignores the repo's local checkpoint noise, but it still excludes untracked scratch files.
 
-5. Users update with:
+For non-patch releases, use:
+
+```bash
+npm run release:ship -- minor
+npm run release:ship -- major
+npm run release:ship -- 0.16.200
+npm run release:minor:tracked
+npm run release:major:tracked
+```
+
+GitHub Actions still publishes from `.github/workflows/publish.yml` after `npm ci`, `npm run check`, and `npm run smoke` pass.
+
+Users update with:
 
 ```bash
 npm install -g @tritard/waterbrother@latest

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tritard/waterbrother",
-  "version": "0.16.157",
+  "version": "0.16.159",
   "description": "Waterbrother: bring-your-own-model coding CLI with local tools, sessions, operator modes, and approval controls",
   "type": "module",
   "bin": {
@@ -21,6 +21,13 @@
     "soak:long-session": "node scripts/long-session-soak.mjs",
     "release:version": "node scripts/release-version.mjs",
     "release:await-publish": "node scripts/await-publish.mjs",
+    "release:ship": "node scripts/release-ship.mjs",
+    "release:patch": "node scripts/release-ship.mjs patch",
+    "release:patch:tracked": "node scripts/release-ship.mjs patch --include-tracked",
+    "release:minor": "node scripts/release-ship.mjs minor",
+    "release:minor:tracked": "node scripts/release-ship.mjs minor --include-tracked",
+    "release:major": "node scripts/release-ship.mjs major",
+    "release:major:tracked": "node scripts/release-ship.mjs major --include-tracked",
     "test": "vitest run",
     "test:watch": "vitest"
   },