@yawlabs/mcp 0.60.1 → 0.60.3

package/CHANGELOG.md

@@ -1,6 +1,23 @@
 # Changelog
 
-All notable changes to `@yawlabs/mcp` (formerly `@yawlabs/mcph`) are documented here. This project uses [semantic versioning](https://semver.org) and a CI-gated release flow: pushing a `vX.Y.Z` tag triggers `.github/workflows/release.yml`, which publishes to npm.
+All notable changes to `@yawlabs/mcp` (formerly `@yawlabs/mcph`) are documented here. This project uses [semantic versioning](https://semver.org) and a script-gated release flow: `./release.sh <version>` runs lint + tests + build, bumps, tags, publishes to npm, and creates the GitHub release.
+
+## 0.60.2 -- pnpm/bun global stores upgrade with their owning tool
+
+- `yaw-mcp upgrade` now detects pnpm global stores (`<pnpm-home>/global/<n>/node_modules/...`) and bun global installs (`~/.bun/install/global/...`) as their own install methods. `--run` spawns `pnpm add -g` / `bun add -g @yawlabs/mcp@latest` instead of misclassifying them as local node_modules trees -- which would have npm-installed a foreign package-lock + node_modules into the tool manager's internal store.
+- `yaw-mcp doctor`'s UPGRADE AVAILABLE hint includes pnpm/bun globals in the "`yaw-mcp upgrade --run` works here" set.
+
+## 0.60.1 -- scoop/custom-prefix npm globals detected correctly
+
+- npm prefixes that live in a `bin` directory (scoop's nodejs persist dir, custom prefixes) put globals at `<prefix>/node_modules` with no `npm`/`lib`/`AppData` marker in the path, so they misclassified as `local-node-modules` -- `upgrade --run` then refused (pre-0.60.0) or npm-installed into the node prefix instead of upgrading the global. New `/bin/node_modules/` marker classifies them as `global-npm`.
+
+## 0.60.0 -- nag removed; `upgrade --run` actually upgrades
+
+- **The free-tier nag interstitial is gone.** Yaw MCP is free (the Pro tier is retired); `src/nag.ts`, its state file handling, and the dispatch gate were deleted. `YAW_MCP_NO_NAG` no longer has any effect -- there is nothing left to suppress. Remaining Pro references in help text, README, and the package description now read Yaw Team.
+- **`yaw-mcp upgrade --run` upgrades local node_modules installs in place** instead of refusing and printing another command: it derives the package-tree root from the running entrypoint's path and runs `npm install @yawlabs/mcp@latest` there.
+- **New `bundled-app` install method** for the copy that ships inside Yaw Terminal (`app.asar.unpacked`): upgrade/doctor say plainly that it updates with the app instead of suggesting an npm command that can never affect it.
+- **Method-aware `doctor` upgrade hints**: the UPGRADE AVAILABLE section prints the user's terminal action for their install method, never a command that turns around and prints another command.
+- Upgrade/doctor output puts commands on their own line with no trailing punctuation so they copy cleanly.
 
 ## 0.58.0 -- Rename to Yaw MCP + local-first Free mode + Pro nag + sync client
 

package/dist/index.js

@@ -2820,6 +2820,7 @@ async function gcExpiredTrials(opts) {
 
 // src/upgrade-cmd.ts
 import { spawn as spawn2 } from "child_process";
+import { realpathSync } from "fs";
 var UPGRADE_USAGE = `Usage: yaw-mcp upgrade [--run] [--json]
 
   Show (or execute) the command to upgrade @yawlabs/mcp to the latest version.
@@ -2849,6 +2850,8 @@ function detectInstallMethod(argvPath) {
   if (/\/lib\/node_modules\/@yawlabs\/mcp\//.test(normalized)) return "global-npm";
   if (/\/AppData\/Roaming\/npm\/node_modules\/@yawlabs\/mcp\//.test(normalized)) return "global-npm";
   if (/\/bin\/node_modules\/@yawlabs\/mcp\//.test(normalized)) return "global-npm";
+  if (/\/pnpm\/global\/\d+\/node_modules\/@yawlabs\/mcp\//.test(normalized)) return "pnpm-global";
+  if (/\/\.bun\/install\/global\/node_modules\/@yawlabs\/mcp\//.test(normalized)) return "bun-global";
   if (/\/node_modules\/@yawlabs\/mcp\//.test(normalized)) return "local-node-modules";
   if (/\/(yaw-mcp|mcph)\/(dist|src)\//.test(normalized)) return "dev-checkout";
   return "unknown";
@@ -2858,6 +2861,52 @@ function localInstallRoot(argvPath) {
   const idx = argvPath.replace(/\\/g, "/").indexOf("/node_modules/");
   return idx > 0 ? argvPath.slice(0, idx) : null;
 }
+async function defaultNpmPrefix() {
+  if (process.env.VITEST) return null;
+  return new Promise((resolve5) => {
+    const child = spawn2("npm", ["prefix", "-g"], {
+      shell: process.platform === "win32",
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    let out = "";
+    const timer = setTimeout(() => {
+      child.kill();
+      resolve5(null);
+    }, 3e3);
+    child.stdout?.on("data", (d) => {
+      out += String(d);
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      resolve5(code === 0 && out.trim() ? out.trim() : null);
+    });
+    child.on("error", () => {
+      clearTimeout(timer);
+      resolve5(null);
+    });
+  });
+}
+function comparablePath(p) {
+  let real = p;
+  try {
+    real = realpathSync(p);
+  } catch {
+  }
+  const normalized = real.replace(/\\/g, "/");
+  return process.platform === "win32" ? normalized.toLowerCase() : normalized;
+}
+async function refineInstallMethod(method, argvPath, npmPrefix = defaultNpmPrefix) {
+  if (method !== "local-node-modules" && method !== "unknown") return method;
+  if (!argvPath) return method;
+  const prefix = await npmPrefix();
+  if (!prefix) return method;
+  const entry = comparablePath(argvPath);
+  const pfx = comparablePath(prefix);
+  if (entry.startsWith(`${pfx}/node_modules/`) || entry.startsWith(`${pfx}/lib/node_modules/`)) {
+    return "global-npm";
+  }
+  return method;
+}
 function buildUpgradePlan(input) {
   const { current, latest, method } = input;
   const stale = latest !== null && current !== "dev" && compareSemverLocal(current, latest) < 0;
@@ -2866,6 +2915,12 @@ function buildUpgradePlan(input) {
     case "global-npm":
       command = "npm install -g @yawlabs/mcp@latest";
       break;
+    case "pnpm-global":
+      command = "pnpm add -g @yawlabs/mcp@latest";
+      break;
+    case "bun-global":
+      command = "bun add -g @yawlabs/mcp@latest";
+      break;
     case "npx":
       command = null;
       break;
@@ -2940,7 +2995,7 @@ async function runUpgrade(opts = {}) {
   const fetcher = opts.fetchLatest ?? defaultFetchLatest;
   const current = opts.currentVersion ?? readCurrentVersion();
   const argvPath = opts.argvPath ?? process.argv[1];
-  const method = detectInstallMethod(argvPath);
+  const method = await refineInstallMethod(detectInstallMethod(argvPath), argvPath, opts.npmPrefix);
   let latest;
   try {
     latest = await fetcher();
@@ -2988,9 +3043,9 @@ async function runUpgrade(opts = {}) {
     return { exitCode: 0, lines };
   }
   const installRoot = method === "local-node-modules" ? localInstallRoot(argvPath) : null;
-  const autoRunnable = method === "global-npm" || method === "local-node-modules" && installRoot !== null;
+  const runSpec = method === "global-npm" ? { cmd: "npm", args: ["install", "-g", "@yawlabs/mcp@latest"] } : method === "pnpm-global" ? { cmd: "pnpm", args: ["add", "-g", "@yawlabs/mcp@latest"] } : method === "bun-global" ? { cmd: "bun", args: ["add", "-g", "@yawlabs/mcp@latest"] } : method === "local-node-modules" && installRoot !== null ? { cmd: "npm", args: ["install", "@yawlabs/mcp@latest"], cwd: installRoot } : null;
   if (!opts.run) {
-    if (autoRunnable) {
+    if (runSpec) {
       print("Run `yaw-mcp upgrade --run` to upgrade in place, or run it yourself:");
     } else {
       print("Run it yourself (--run can't safely automate this install method):");
@@ -2999,34 +3054,33 @@ async function runUpgrade(opts = {}) {
     print(`  ${plan.command}`);
     return { exitCode: 1, lines };
   }
-  if (!autoRunnable) {
+  if (!runSpec) {
     printErr(`yaw-mcp upgrade --run: a "${method}" install can't be upgraded automatically. Run it yourself:`);
     printErr("");
     printErr(`  ${plan.command}`);
     return { exitCode: 2, lines };
   }
   const runner = opts.spawnImpl ?? defaultSpawn;
-  const npmArgs = method === "global-npm" ? ["install", "-g", "@yawlabs/mcp@latest"] : ["install", "@yawlabs/mcp@latest"];
-  if (installRoot) {
-    print(`Running in ${installRoot}:`);
+  if (runSpec.cwd) {
+    print(`Running in ${runSpec.cwd}:`);
   } else {
     print("Running:");
   }
   print(`  ${plan.command}`);
   print("");
-  const code = await runner("npm", npmArgs, installRoot ?? void 0);
+  const code = await runner(runSpec.cmd, runSpec.args, runSpec.cwd);
   if (code === 0) {
     print("");
     print(`\u2713 Upgraded @yawlabs/mcp to ${latest}`);
     return { exitCode: 0, lines };
   }
-  printErr(`yaw-mcp upgrade: npm exited ${code}. Try running the command yourself:`);
+  printErr(`yaw-mcp upgrade: ${runSpec.cmd} exited ${code}. Try running the command yourself:`);
   printErr("");
   printErr(`  ${plan.command}`);
   return { exitCode: 3, lines };
 }
 function readCurrentVersion() {
-  return true ? "0.60.1" : "dev";
+  return true ? "0.60.3" : "dev";
 }
 
 // src/usage-hints.ts
@@ -3088,7 +3142,7 @@ function selectFlakyNamespaces(entries, limit) {
 }
 
 // src/doctor-cmd.ts
-var VERSION = true ? "0.60.1" : "dev";
+var VERSION = true ? "0.60.3" : "dev";
 async function runDoctor(opts = {}) {
   if (opts.json) return runDoctorJson(opts);
   const lines = [];
@@ -3160,7 +3214,7 @@ async function runDoctor(opts = {}) {
   const latest = skipCheck ? null : await fetchLatestVersion(opts.registryFetch);
   const staleHint = latest && VERSION !== "dev" && compareSemver(VERSION, latest) < 0 ? latest : null;
   if (staleHint) {
-    const method = detectInstallMethod(process.argv[1]);
+    const method = await refineInstallMethod(detectInstallMethod(process.argv[1]), process.argv[1]);
     print("UPGRADE AVAILABLE");
     if (method === "bundled-app") {
       print(`  Running ${VERSION}; npm latest is ${staleHint}. This copy ships inside`);
@@ -3168,7 +3222,7 @@ async function runDoctor(opts = {}) {
     } else if (method === "npx") {
       print(`  Running ${VERSION}; npm latest is ${staleHint}. npx fetches the latest`);
       print("  on each spawn \u2014 restart your MCP client to pick it up.");
-    } else if (method === "global-npm" || method === "local-node-modules") {
+    } else if (method === "global-npm" || method === "pnpm-global" || method === "bun-global" || method === "local-node-modules") {
       print(`  Running ${VERSION}; npm latest is ${staleHint}. To upgrade in place:`);
       print("");
       print("    yaw-mcp upgrade --run");
@@ -5076,16 +5130,21 @@ function defaultSpawn2(cmd, args) {
 async function maybeAutoUpgrade(deps = {}) {
   const optOut = process.env.YAW_MCP_AUTO_UPGRADE;
   if (optOut === "0" || optOut?.toLowerCase() === "false") return;
-  const current = deps.currentVersion ?? (true ? "0.60.1" : "dev");
+  const current = deps.currentVersion ?? (true ? "0.60.3" : "dev");
   if (current === "dev") return;
   const method = detectInstallMethod(deps.argvPath ?? process.argv[1]);
   const latest = await (deps.fetchLatestImpl ?? fetchLatestVersion2)();
   if (latest === null) return;
   const plan = buildUpgradePlan({ current, latest, method });
   if (!plan.stale) return;
-  if (method === "global-npm") {
-    log("info", "yaw-mcp is out of date; upgrading the global install in the background", { current, latest });
-    (deps.spawnImpl ?? defaultSpawn2)("npm", ["install", "-g", "@yawlabs/mcp@latest"]);
+  const globalSpec = method === "global-npm" ? { cmd: "npm", args: ["install", "-g", "@yawlabs/mcp@latest"] } : method === "pnpm-global" ? { cmd: "pnpm", args: ["add", "-g", "@yawlabs/mcp@latest"] } : method === "bun-global" ? { cmd: "bun", args: ["add", "-g", "@yawlabs/mcp@latest"] } : null;
+  if (globalSpec) {
+    log("info", "yaw-mcp is out of date; upgrading the global install in the background", {
+      current,
+      latest,
+      tool: globalSpec.cmd
+    });
+    (deps.spawnImpl ?? defaultSpawn2)(globalSpec.cmd, globalSpec.args);
     return;
   }
   if (method === "bundled-app") {
@@ -7349,7 +7408,7 @@ function categorizeSpawnError(err) {
 }
 async function connectToUpstream(config, onDisconnect, onListChanged) {
   const client = new Client(
-    { name: "yaw-mcp", version: true ? "0.60.1" : "dev" },
+    { name: "yaw-mcp", version: true ? "0.60.3" : "dev" },
     { capabilities: {} }
   );
   let transport;
@@ -7658,7 +7717,7 @@ var ConnectServer = class _ConnectServer {
     this.apiUrl = apiUrl5;
     this.token = token5;
     this.server = new Server(
-      { name: "yaw-mcp", version: true ? "0.60.1" : "dev" },
+      { name: "yaw-mcp", version: true ? "0.60.3" : "dev" },
       {
         capabilities: {
           tools: { listChanged: true },
@@ -10629,7 +10688,7 @@ if (subcommand === "compliance") {
 `);
   process.exit(0);
 } else if (subcommand === "--version" || subcommand === "-V") {
-  process.stdout.write(`yaw-mcp ${true ? "0.60.1" : "dev"}
+  process.stdout.write(`yaw-mcp ${true ? "0.60.3" : "dev"}
 `);
   process.exit(0);
 } else if (subcommand && !subcommand.startsWith("-")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yawlabs/mcp",
-  "version": "0.60.1",
+  "version": "0.60.3",
   "mcpName": "io.github.YawLabs/mcp",
   "description": "Yaw MCP -- MCP servers, managed. Free to run locally; Yaw Team adds cross-machine sync.",
   "license": "UNLICENSED",