@yawlabs/mcph 0.29.0 → 0.31.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.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.
+
 ## 0.29.0 — 2026-04-18
 
 - **Compliance-aware routing (`MCPH_MIN_COMPLIANCE`)** — Phase 3 item. Set the env var to `A`, `B`, `C`, `D`, or `F` and `mcp_connect_activate` refuses to load any installed server whose reported `complianceGrade` is below the floor, with an error that names the grade and the env var to unset. `mcp_connect_discover` annotates below-grade servers in place (so the model knows they exist and why they won't auto-activate) and emits a "Compliance filter active" header. Forward-compatible schema: the optional `complianceGrade` field on `UpstreamServerConfig` rides the existing `/api/connect/config` response — the feature kicks in automatically once the backend starts populating grades. Ungraded servers always pass (don't punish unknown).

package/dist/index.js

@@ -946,7 +946,7 @@ function errorMessage(err) {
 }
 
 // src/doctor-cmd.ts
-var VERSION = true ? "0.29.0" : "dev";
+var VERSION = true ? "0.31.0" : "dev";
 async function runDoctor(opts = {}) {
   const lines = [];
   const write = opts.out ?? ((s) => process.stdout.write(s));
@@ -1824,6 +1824,15 @@ function matchBundles(installedNamespaces) {
 function bundleActivateHint(bundle) {
   return `mcp_connect_activate({ namespaces: ${JSON.stringify(bundle.namespaces)} })`;
 }
+function topPartialBundles(installedNamespaces, limit) {
+  if (limit <= 0) return [];
+  const { partial } = matchBundles(installedNamespaces);
+  return partial.slice().sort((a, b) => {
+    if (a.missing.length !== b.missing.length) return a.missing.length - b.missing.length;
+    if (a.have.length !== b.have.length) return b.have.length - a.have.length;
+    return a.bundle.id.localeCompare(b.bundle.id);
+  }).slice(0, limit);
+}
 
 // src/compliance.ts
 var GRADE_ORDER = {
@@ -2126,6 +2135,60 @@ function stepBindingKey(step, index) {
   return typeof step.id === "string" && step.id.length > 0 ? step.id : String(index);
 }
 
+// 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/guide.ts
 import { readFile as readFile5 } from "fs/promises";
 var GUIDE_READ_TIMEOUT_MS = 1e3;
@@ -3827,7 +3890,7 @@ function categorizeSpawnError(err) {
 }
 async function connectToUpstream(config, onDisconnect, onListChanged) {
   const client = new Client(
-    { name: "mcph", version: true ? "0.29.0" : "dev" },
+    { name: "mcph", version: true ? "0.31.0" : "dev" },
     { capabilities: {} }
   );
   let transport;
@@ -4344,7 +4407,7 @@ var ConnectServer = class _ConnectServer {
     this.apiUrl = apiUrl6;
     this.token = token6;
     this.server = new Server(
-      { name: "mcph", version: true ? "0.29.0" : "dev" },
+      { name: "mcph", version: true ? "0.31.0" : "dev" },
       {
         capabilities: {
           tools: { listChanged: true },
@@ -5239,6 +5302,14 @@ var ConnectServer = class _ConnectServer {
         lines.push(`  ${o.bareName} \u2014 available in: ${o.namespaces.join(", ")}${suffix}`);
       }
     }
+    const allInstalled = this.config.servers.map((s) => s.namespace);
+    const bundleGaps = topPartialBundles(allInstalled, 3);
+    if (bundleGaps.length > 0) {
+      lines.push("\nBundle completions (install to unlock curated stacks):");
+      for (const { bundle, have, missing } of bundleGaps) {
+        lines.push(`  ${bundle.id} \u2014 have: ${have.join(", ")}; add: ${missing.join(", ")}`);
+      }
+    }
     const inactive = this.config.servers.filter((s) => !s.isActive);
     if (inactive.length > 0) {
       lines.push("\nDisabled servers:");
@@ -5303,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,
@@ -6405,7 +6487,7 @@ ${installBlock}
   );
   process.exit(0);
 } else if (subcommand === "--version" || subcommand === "-V") {
-  process.stdout.write(`mcph ${true ? "0.29.0" : "dev"}
+  process.stdout.write(`mcph ${true ? "0.31.0" : "dev"}
 `);
   process.exit(0);
 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yawlabs/mcph",
-  "version": "0.29.0",
+  "version": "0.31.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)",