@yawlabs/mcph 0.30.0 → 0.32.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to `@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.
 
+## 0.32.0 — 2026-04-18
+
+- **Unknown CLI subcommand detection + typo suggestions** — `mcph <typo>` (e.g. `mcph instal`, `mcph docto`) now exits 2 with `unknown subcommand "X". Did you mean: install?` instead of silently falling through to MCP-server mode and erroring opaquely on the missing token. Bare flags (anything with a leading `-`) still fall through so server startup can parse them.
+
+## 0.31.0 — 2026-04-18
+
+- **"Did you mean?" suggestions on `mcp_connect_activate`** — When a caller tries to activate a namespace that doesn't exist, the error message now splits the two underlying cases: (a) not installed at all (with up to 3 fuzzy-matched installed namespaces via substring containment or ≤2 edit distance, or a pointer to `mcp_connect_discover` when nothing is close), and (b) installed but disabled in the dashboard (with a pointer to `mcp.hosting` to enable). Replaces the previous conflated "`X` not found or disabled" message.
+
 ## 0.30.0 — 2026-04-18
 
 - **Inline bundle completions in `discover()`** — When a curated bundle has some installed servers but is missing one or two, `mcp_connect_discover` surfaces a "Bundle completions" block with the partial bundle id, what's already installed, and what to add. Top 3 entries, ranked by fewest-missing first (cheapest to complete), tie-broken by most-momentum then id. Same data source as `mcp_connect_bundles action="match"`, but inline so the model can act on the nudge without the extra round-trip. Suppressed when no curated bundle has any overlap with the installed set.

package/dist/index.js

@@ -946,7 +946,7 @@ function errorMessage(err) {
 }
 
 // src/doctor-cmd.ts
-var VERSION = true ? "0.30.0" : "dev";
+var VERSION = true ? "0.32.0" : "dev";
 async function runDoctor(opts = {}) {
   const lines = [];
   const write = opts.out ?? ((s) => process.stdout.write(s));
@@ -1264,6 +1264,60 @@ function compareSemver(a, b) {
   return 0;
 }
 
+// src/fuzzy.ts
+function levenshtein(a, b) {
+  if (a === b) return 0;
+  const aLen = a.length;
+  const bLen = b.length;
+  if (aLen === 0) return bLen;
+  if (bLen === 0) return aLen;
+  let prev = new Array(bLen + 1);
+  let curr = new Array(bLen + 1);
+  for (let j = 0; j <= bLen; j++) prev[j] = j;
+  for (let i = 1; i <= aLen; i++) {
+    curr[0] = i;
+    for (let j = 1; j <= bLen; j++) {
+      const cost = a.charCodeAt(i - 1) === b.charCodeAt(j - 1) ? 0 : 1;
+      curr[j] = Math.min(
+        curr[j - 1] + 1,
+        // insertion
+        prev[j] + 1,
+        // deletion
+        prev[j - 1] + cost
+        // substitution
+      );
+    }
+    [prev, curr] = [curr, prev];
+  }
+  return prev[bLen];
+}
+function closestNames(query, candidates, limit) {
+  if (limit <= 0) return [];
+  const q = query.toLowerCase();
+  const scored = [];
+  for (const c of candidates) {
+    if (c === query) continue;
+    const lc = c.toLowerCase();
+    let score = null;
+    if (lc === q) {
+      score = 0;
+    } else if (lc.startsWith(q) || q.startsWith(lc)) {
+      score = 1;
+    } else if (lc.includes(q) || q.includes(lc)) {
+      score = 2;
+    } else {
+      const d = levenshtein(q, lc);
+      if (d <= 2) score = 2 + d;
+    }
+    if (score !== null) scored.push({ name: c, score });
+  }
+  scored.sort((a, b) => {
+    if (a.score !== b.score) return a.score - b.score;
+    return a.name.localeCompare(b.name);
+  });
+  return scored.slice(0, limit).map((s) => s.name);
+}
+
 // src/install-cmd.ts
 import { existsSync as existsSync2 } from "fs";
 import { chmod, mkdir as mkdir3, readFile as readFile4, writeFile as writeFile2 } from "fs/promises";
@@ -3836,7 +3890,7 @@ function categorizeSpawnError(err) {
 }
 async function connectToUpstream(config, onDisconnect, onListChanged) {
   const client = new Client(
-    { name: "mcph", version: true ? "0.30.0" : "dev" },
+    { name: "mcph", version: true ? "0.32.0" : "dev" },
     { capabilities: {} }
   );
   let transport;
@@ -4353,7 +4407,7 @@ var ConnectServer = class _ConnectServer {
     this.apiUrl = apiUrl6;
     this.token = token6;
     this.server = new Server(
-      { name: "mcph", version: true ? "0.30.0" : "dev" },
+      { name: "mcph", version: true ? "0.32.0" : "dev" },
       {
         capabilities: {
           tools: { listChanged: true },
@@ -5320,10 +5374,21 @@ ${activeCount} loaded in this session, ${totalTools} tools in context${tokenSumm
         serverId: existing.config.id
       };
     }
-    const serverConfig = this.config?.servers.find((s) => s.namespace === namespace && s.isActive);
-    if (!serverConfig) {
-      return { ok: false, isChanged: false, message: `"${namespace}" not found or disabled.` };
+    const anyMatch = this.config?.servers.find((s) => s.namespace === namespace);
+    if (!anyMatch) {
+      const allNamespaces = this.config?.servers.map((s) => s.namespace) ?? [];
+      const suggestions = closestNames(namespace, allNamespaces, 3);
+      const hint = suggestions.length > 0 ? ` Did you mean: ${suggestions.join(", ")}?` : " Use mcp_connect_discover to see installed servers.";
+      return { ok: false, isChanged: false, message: `"${namespace}" is not installed.${hint}` };
     }
+    if (!anyMatch.isActive) {
+      return {
+        ok: false,
+        isChanged: false,
+        message: `"${namespace}" is installed but disabled. Enable it at https://mcp.hosting to activate.`
+      };
+    }
+    const serverConfig = anyMatch;
     if (!profileAllows(this.profile, namespace)) {
       return {
         ok: false,
@@ -6378,6 +6443,7 @@ To load the top pack in one step, call \`mcp_connect_activate\` with namespaces=
 };
 
 // src/index.ts
+var KNOWN_SUBCOMMANDS = ["compliance", "install", "doctor", "help", "--help", "-h", "--version", "-V"];
 var subcommand = process.argv[2];
 if (subcommand === "compliance") {
   runComplianceCommand(process.argv.slice(3)).then((code) => process.exit(code));
@@ -6422,9 +6488,16 @@ ${installBlock}
   );
   process.exit(0);
 } else if (subcommand === "--version" || subcommand === "-V") {
-  process.stdout.write(`mcph ${true ? "0.30.0" : "dev"}
+  process.stdout.write(`mcph ${true ? "0.32.0" : "dev"}
 `);
   process.exit(0);
+} else if (subcommand && !subcommand.startsWith("-")) {
+  const visible = KNOWN_SUBCOMMANDS.filter((s) => !s.startsWith("-") && s !== "help");
+  const suggestions = closestNames(subcommand, visible, 3);
+  const hint = suggestions.length > 0 ? ` Did you mean: ${suggestions.join(", ")}?` : " Run `mcph --help` for the list of subcommands.";
+  process.stderr.write(`mcph: unknown subcommand "${subcommand}".${hint}
+`);
+  process.exit(2);
 } else {
   runServer();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yawlabs/mcph",
-  "version": "0.30.0",
+  "version": "0.32.0",
   "description": "mcp.hosting — one install, all your MCP servers, managed from the cloud",
   "license": "UNLICENSED",
   "author": "Yaw Labs <contact@yaw.sh> (https://yaw.sh)",