From 532d0c3b8f2b89149b1bcddae7725797aaab2908 Mon Sep 17 00:00:00 2001 From: P-Theo Date: Wed, 9 Sep 2026 23:11:33 +0300 Subject: [PATCH 1/2] docs: gate version bumps behind release PRs and clear the prerelease cache --- docs/release.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/docs/release.md b/docs/release.md index a2b781b..dce2ff2 100644 --- a/docs/release.md +++ b/docs/release.md @@ -40,7 +40,7 @@ The host reuses the newest generation without contacting the registry, so the st ## 4. Publish a prerelease -Use a version such as `0.1.0-rc.1`. +Use a version such as `0.1.0-rc.1`, bumped and merged through a release pull request as in step 6 — before step 1, so the tarball under test is the artifact that ships. ```sh npm publish --tag next @@ -50,6 +50,12 @@ Always pass a tag. An untagged publish becomes `latest`, prerelease version or n ## 5. Install from the registry +Delete the `@next` cache directory first: `plugin add` reuses the newest cached generation without contacting the registry, so a prerelease left over from an earlier verification would be installed instead — and routed by its old exports map. + +```sh +rm -rf ~/.cache/opencode/npm/opencode2-tps@next +``` + Add the prerelease with the CLI's plugin command, which installs it into the host cache and adds the entry to `cli.json` (remove any `latest` entry first — the last entry wins): ```sh @@ -62,9 +68,16 @@ This is the only step that exercises registry resolution, the plugin-add routing `npm version` refuses a dirty tree, so commit the work first. It writes the version, commits it, and tags it `v` to match the existing tags. +`main` only accepts commits through a pull request, so the bump travels on a release branch. Merge it with a merge commit — a rebase or squash merge rewrites the commit and leaves the tag pointing outside `main`'s history: + ```sh +git checkout -b release/ npm version patch -git push --follow-tags +git push -u origin release/ +gh pr create --base main --head release/ --title --body "..." +gh pr merge release/ --merge --delete-branch --auto +git checkout main && git pull +git push origin v npm publish ``` From e4a34a7c2f82b884174352e800e603671b6f05f9 Mon Sep 17 00:00:00 2001 From: P-Theo Date: Wed, 9 Sep 2026 23:11:38 +0300 Subject: [PATCH 2/2] 0.3.0 --- package-lock.json | 4 ++-- package.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index 22cecf5..39616b4 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "opencode2-tps", - "version": "0.3.0-rc.1", + "version": "0.3.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "opencode2-tps", - "version": "0.3.0-rc.1", + "version": "0.3.0", "license": "MIT", "devDependencies": { "@babel/core": "^7.29.7", diff --git a/package.json b/package.json index 02e41aa..bd3543f 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "opencode2-tps", - "version": "0.3.0-rc.1", + "version": "0.3.0", "description": "Live token-throughput indicator for the OpenCode 2 TUI prompt composer", "license": "MIT", "author": "P-Theo",