chore(release): prepare 0.1.1-beta.0 prerelease

Author: timrichardson

.github/workflows/release.yml

@@ -21,9 +21,33 @@ jobs:
           cache: npm
       - run: npm ci
       - run: npm test
-      - run: npm publish --provenance
+      - name: Derive release metadata
+        id: meta
+        shell: bash
+        run: |
+          version="${GITHUB_REF_NAME#v}"
+          if [[ "$version" == *-* ]]; then
+            prerelease_part="${version#*-}"
+            dist_tag="${prerelease_part%%.*}"
+            echo "prerelease=true" >> "$GITHUB_OUTPUT"
+          else
+            dist_tag="latest"
+            echo "prerelease=false" >> "$GITHUB_OUTPUT"
+          fi
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+          echo "dist_tag=$dist_tag" >> "$GITHUB_OUTPUT"
+      - name: Ensure tag matches package version
+        shell: bash
+        run: |
+          package_version=$(node -p "JSON.parse(require('node:fs').readFileSync('package.json', 'utf8')).version")
+          if [[ "$package_version" != "${{ steps.meta.outputs.version }}" ]]; then
+            echo "Tag version ${{ steps.meta.outputs.version }} does not match package.json version $package_version" >&2
+            exit 1
+          fi
+      - run: npm publish --tag "${{ steps.meta.outputs.dist_tag }}" --provenance
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
       - uses: softprops/action-gh-release@v2
         with:
           generate_release_notes: true
+          prerelease: ${{ steps.meta.outputs.prerelease }}

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.1-beta.0
+
+- mark the package as an explicit prerelease line
+- publish prereleases to the npm `beta` dist-tag instead of `latest`
+- document OpenCode installation via `opencode-planner@beta`
+
 ## 0.1.0
 
 - initial standalone npm package for the `plan` agent plugin

README.md

@@ -1,6 +1,6 @@
 # opencode-planner
 
-`opencode-planner` is an OpenCode plugin that adds a dedicated `plan` agent for read-only planning before implementation.
+`opencode-planner` is an experimental OpenCode plugin that adds a dedicated `plan` agent for read-only planning before implementation.
 
 Repository: <https://github.com/timrichardson/opencode-planner>
 
@@ -10,17 +10,19 @@ Add this to `opencode.json`:
 
 ```json
 {
-  "plugin": ["opencode-planner@latest"]
+  "plugin": ["opencode-planner@beta"]
 }
 ```
 
 Then restart OpenCode.
 
+`beta` is the recommended install channel until the package has a stable release. This keeps prereleases off `latest`.
+
 If you want reproducible installs instead of automatic plugin refreshes, pin an exact version:
 
 ```json
 {
-  "plugin": ["opencode-planner@0.1.0"]
+  "plugin": ["opencode-planner@0.1.1-beta.0"]
 }
 ```
 
@@ -32,9 +34,12 @@ If you want reproducible installs instead of automatic plugin refreshes, pin an
 
 ## Auto-updates
 
-OpenCode installs npm plugins automatically. Using `opencode-planner@latest` gives the smoothest update path for most users.
+OpenCode installs npm plugins automatically. During the prerelease phase, `opencode-planner@beta` gives the smoothest update path for most users.
+
+For this package's current prerelease phase, use `opencode-planner@beta` instead of `@latest`.
 
-- `@latest`: pick up new published plugin versions on restart
+- `@beta`: pick up new prerelease plugin versions on restart without opting into a future stable channel
+- `@latest`: reserved for stable releases
 - exact version pin: stay fixed until the config is changed deliberately
 
 If OpenCode appears to keep an older cached plugin, clear the cache under `~/.cache/opencode/` and restart.
@@ -50,8 +55,8 @@ npm test
 1. Update `CHANGELOG.md`.
 2. Bump the version in `package.json`.
 3. Commit the release.
-4. Create and push a git tag like `v0.1.1`.
-5. Publish to npm.
+4. Create and push a git tag like `v0.1.1-beta.0` for prereleases or `v0.1.1` for stable releases.
+5. Let GitHub Actions publish to npm using the correct dist-tag.
 6. Publish matching GitHub release notes.
 
 The repository includes GitHub Actions templates for CI and npm publishing from version tags.
@@ -62,7 +67,7 @@ Set this repository secret for automated npm publishing:
 
 - `NPM_TOKEN`
 
-The release workflow publishes on version tags like `v0.1.0` and creates GitHub release notes automatically.
+The release workflow publishes prerelease tags like `v0.1.1-beta.0` to the npm `beta` dist-tag, stable tags like `v0.1.1` to `latest`, and creates matching GitHub release notes automatically.
 
 ## License
 

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-planner",
-  "version": "0.1.0",
-  "description": "OpenCode plugin that adds a dedicated planning agent with read-only planning constraints.",
+  "version": "0.1.1-beta.0",
+  "description": "Experimental OpenCode plugin that adds a dedicated planning agent with read-only planning constraints.",
   "type": "module",
   "author": "Tim Richardson",
   "exports": {