chore: establish npm beta prerelease channel (#581)

* chore: establish beta release packages

* ci: support Mergify prerelease queue checks

---------

Co-authored-by: CharlieHelps <charlie@charlielabs.ai>

Author: github-actions[bot]

.changeset/pre.json

@@ -0,0 +1,23 @@
+{
+	"mode": "pre",
+	"tag": "beta",
+	"initialVersions": {
+		"hevy-mcp": "1.28.0"
+	},
+	"changesets": [
+		"bright-lions-exercise",
+		"bright-otters-guide",
+		"calm-lions-report",
+		"calm-tools-guide",
+		"flat-experts-scream",
+		"gate-release-workflow",
+		"gitstream-approve-lgtm",
+		"gitstream-review-status-labels",
+		"goofy-parks-repair",
+		"graceful-stdio-shutdown",
+		"lovely-candles-smash",
+		"quiet-lions-debug",
+		"tasty-waves-smoke",
+		"thin-views-smash"
+	]
+}

.changeset/tasty-waves-smoke.md

@@ -0,0 +1,2 @@
+---
+---

.changeset/thin-views-smash.md

@@ -0,0 +1,2 @@
+---
+---

.github/workflows/build-and-test.yml

@@ -65,7 +65,16 @@ jobs:
         run: npx commitlint --from ${{ github.event.pull_request.base.sha }} --to ${{ github.event.pull_request.head.sha }} --verbose
 
       - name: Check for changeset
-        if: github.event_name == 'pull_request' && matrix.node-version == '24.x' && github.actor != 'dependabot[bot]' && github.head_ref != 'changeset-release/main'
+        if: >-
+          github.event_name == 'pull_request' &&
+          matrix.node-version == '24.x' &&
+          github.actor != 'dependabot[bot]' &&
+          github.head_ref != 'changeset-release/main' &&
+          !(
+            github.event.pull_request.head.repo.full_name == github.repository &&
+            github.event.pull_request.user.login == 'mergify[bot]' &&
+            startsWith(github.head_ref, 'mergify/merge-queue/')
+          )
         run: npx changeset status --since=origin/${{ github.base_ref }}
 
       - name: Run Check

CHANGELOG.md

@@ -1,3 +1,26 @@
+## 1.28.1-beta.0
+
+### Patch Changes
+
+- [#574](https://github.com/chrisdoc/hevy-mcp/pull/574) [`0a26ed0`](https://github.com/chrisdoc/hevy-mcp/commit/0a26ed09f5fe536870412ece125deb4f07a38d86) Thanks [@charliecreates](https://github.com/apps/charliecreates)! - Expose MCP registry metadata through the package `mcpName` field and a synchronized `server.json` manifest.
+
+- [#563](https://github.com/chrisdoc/hevy-mcp/pull/563) [`4c80e87`](https://github.com/chrisdoc/hevy-mcp/commit/4c80e87d8b6cbf82c11cd194d642a33bc1995980) Thanks [@charliecreates](https://github.com/apps/charliecreates)! - Provide MCP clients with concise server-level guidance for safe tool selection,
+  recommended workout workflows, pagination, retries, and API-key setup.
+
+- [#569](https://github.com/chrisdoc/hevy-mcp/pull/569) [`209a7d4`](https://github.com/chrisdoc/hevy-mcp/commit/209a7d45535de6da63d8e376bf7f230b0498cab7) Thanks [@charliecreates](https://github.com/apps/charliecreates)! - Print the CLI version with the package name to stderr.
+
+- [#567](https://github.com/chrisdoc/hevy-mcp/pull/567) [`23cb9af`](https://github.com/chrisdoc/hevy-mcp/commit/23cb9af1c485afdbe2ce70188059ff3cf54f0b84) Thanks [@charliecreates](https://github.com/apps/charliecreates)! - Improve MCP tool descriptions with aliases, use-case guidance, side-effect classification, and operational constraints for more reliable LLM tool selection.
+
+- [#575](https://github.com/chrisdoc/hevy-mcp/pull/575) [`fc4dd6f`](https://github.com/chrisdoc/hevy-mcp/commit/fc4dd6f934a0a7581b0d03464961618b154fa1d1) Thanks [@charliecreates](https://github.com/apps/charliecreates)! - Report privacy-safe malformed stdin diagnostics while continuing to process later MCP messages.
+
+- [#570](https://github.com/chrisdoc/hevy-mcp/pull/570) [`d4b6872`](https://github.com/chrisdoc/hevy-mcp/commit/d4b6872bb9d0d5d1dd336b2baa14e9f05eaa5f00) Thanks [@charliecreates](https://github.com/apps/charliecreates)! - Gracefully close and flush the stdio transport on SIGINT or SIGTERM, with a
+  bounded forced-exit fallback when shutdown stalls or other handles remain open.
+
+- [#562](https://github.com/chrisdoc/hevy-mcp/pull/562) [`e29d5b7`](https://github.com/chrisdoc/hevy-mcp/commit/e29d5b793088788d771c0665986e61463442fd76) Thanks [@charliecreates](https://github.com/apps/charliecreates)! - Notify users on stderr about newer major releases or when they are more than
+  two minor versions behind, using package-manager-neutral guidance.
+
+- [#572](https://github.com/chrisdoc/hevy-mcp/pull/572) [`d1f629e`](https://github.com/chrisdoc/hevy-mcp/commit/d1f629ee2b2b5221d259676f453cbfb74242dbf3) Thanks [@charliecreates](https://github.com/apps/charliecreates)! - Add opt-in, privacy-bounded stderr diagnostics for tool invocations and Hevy API responses.
+
 ## 1.28.0
 
 ### Minor Changes

README.md

@@ -70,6 +70,25 @@ HEVY_API_KEY=your_hevy_api_key_here npx -y hevy-mcp
 HEVY_API_KEY=your_hevy_api_key_here bunx hevy-mcp@latest
 ```
 
+### Prerelease channel
+
+Install `hevy-mcp@beta` to opt into changes merged to `main` that have not yet
+reached a stable release:
+
+```bash
+npm install hevy-mcp@beta
+
+# npx launcher
+npx -y hevy-mcp@beta
+
+# bun launcher
+bunx hevy-mcp@beta
+```
+
+Beta builds may be less stable and can change before their stable release.
+`npm install hevy-mcp@latest` remains the stable channel. To switch back from
+beta, install `hevy-mcp@latest` again.
+
 ### Manual Installation
 
 ```bash

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "hevy-mcp",
-	"version": "1.28.0",
+	"version": "1.28.1-beta.0",
 	"description": "A Model Context Protocol (MCP) server implementation that interfaces with the Hevy fitness tracking app and its API.",
 	"keywords": [
 		"api",

server.json

@@ -7,12 +7,12 @@
 		"url": "https://github.com/chrisdoc/hevy-mcp",
 		"source": "github"
 	},
-	"version": "1.28.0",
+	"version": "1.28.1-beta.0",
 	"packages": [
 		{
 			"registryType": "npm",
 			"identifier": "hevy-mcp",
-			"version": "1.28.0",
+			"version": "1.28.1-beta.0",
 			"transport": {
 				"type": "stdio"
 			},

tests/unit/server-manifest.test.ts

@@ -250,9 +250,6 @@ describe("server manifest metadata", () => {
 		const packageJson = JSON.parse(
 			await readFile(join(rootDir, "package.json"), "utf8"),
 		);
-		const nextVersion = packageJson.version.replace(/\d+$/, (patch: string) =>
-			String(Number(patch) + 1),
-		);
 		const fixturePackageJson = {
 			name: packageJson.name,
 			version: packageJson.version,
@@ -295,36 +292,31 @@ describe("server manifest metadata", () => {
 			},
 		});
 
-		const [
-			updatedPackageJson,
-			updatedManifest,
-			committedFiles,
-			head,
-			tag,
-			status,
-		] = await Promise.all([
-			readFile(join(fixtureDir, "package.json"), "utf8").then(JSON.parse),
-			readFile(join(fixtureDir, "server.json"), "utf8").then(JSON.parse),
-			execFileAsync(
-				"git",
-				["show", "--name-only", "--pretty=format:", "HEAD"],
-				{ cwd: fixtureDir },
-			),
-			execFileAsync("git", ["rev-parse", "HEAD"], { cwd: fixtureDir }),
-			execFileAsync("git", ["rev-list", "-n", "1", `v${nextVersion}`], {
-				cwd: fixtureDir,
-			}),
-			execFileAsync("git", ["status", "--porcelain"], { cwd: fixtureDir }),
-		]);
-
-		expect(updatedPackageJson.version).toBe(nextVersion);
-		expect(updatedManifest.version).toBe(nextVersion);
-		expect(updatedManifest.packages[0].version).toBe(nextVersion);
+		const [updatedPackageJson, updatedManifest, committedFiles, tag, status] =
+			await Promise.all([
+				readFile(join(fixtureDir, "package.json"), "utf8").then(JSON.parse),
+				readFile(join(fixtureDir, "server.json"), "utf8").then(JSON.parse),
+				execFileAsync(
+					"git",
+					["show", "--name-only", "--pretty=format:", "HEAD"],
+					{ cwd: fixtureDir },
+				),
+				execFileAsync("git", ["tag", "--points-at", "HEAD"], {
+					cwd: fixtureDir,
+				}),
+				execFileAsync("git", ["status", "--porcelain"], { cwd: fixtureDir }),
+			]);
+
+		expect(updatedPackageJson.version).not.toBe(packageJson.version);
+		expect(updatedManifest.version).toBe(updatedPackageJson.version);
+		expect(updatedManifest.packages[0].version).toBe(
+			updatedPackageJson.version,
+		);
 		expect(committedFiles.stdout.trim().split("\n")).toEqual([
 			"package.json",
 			"server.json",
 		]);
-		expect(tag.stdout.trim()).toBe(head.stdout.trim());
+		expect(tag.stdout.trim()).toBe(`v${updatedPackageJson.version}`);
 		expect(status.stdout).toBe("");
 	});