@yawlabs/mcph 0.31.0 → 0.33.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.33.0 — 2026-04-18
+
+- **`mcph doctor` ENVIRONMENT section** — New block enumerating every behavior-modifier env var mcph actually reads (`MCPH_POLL_INTERVAL`, `MCPH_SERVER_CAP`, `MCPH_MIN_COMPLIANCE`, `MCPH_AUTO_LOAD`, `MCPH_PRUNE_RESPONSES`). Each shows its current value, or `(not set — <default>)` when unset. Closes a diagnostic gap where users reporting "my server cap isn't taking effect" or "compliance filter isn't blocking anything" had no doctor signal on whether the knob was even set. TOKEN / URL / DISABLE_PERSISTENCE still get their dedicated sections (richer context there).
+
+## 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.

package/dist/index.js

@@ -946,7 +946,7 @@ function errorMessage(err) {
 }
 
 // src/doctor-cmd.ts
-var VERSION = true ? "0.31.0" : "dev";
+var VERSION = true ? "0.33.0" : "dev";
 async function runDoctor(opts = {}) {
   const lines = [];
   const write = opts.out ?? ((s) => process.stdout.write(s));
@@ -981,6 +981,7 @@ async function runDoctor(opts = {}) {
   print(`  value:  ${config.apiBase}`);
   print(`  source: ${config.apiBaseSource}`);
   print("");
+  renderEnvSection({ env, print });
   await renderStateSection({ home, env, print });
   const clients = probeClients({ home, os, cwd });
   print("INSTALLED CLIENTS (probed config files)");
@@ -1034,6 +1035,24 @@ async function runDoctor(opts = {}) {
   }
   return { exitCode, lines, snapshot: { version: VERSION, config, clients } };
 }
+function renderEnvSection(opts) {
+  const { env, print } = opts;
+  const vars = [
+    { name: "MCPH_POLL_INTERVAL", defaultHint: "default 60s" },
+    { name: "MCPH_SERVER_CAP", defaultHint: "default 6" },
+    { name: "MCPH_MIN_COMPLIANCE", defaultHint: "filter inactive" },
+    { name: "MCPH_AUTO_LOAD", defaultHint: "auto-load inactive" },
+    { name: "MCPH_PRUNE_RESPONSES", defaultHint: "pruning active" }
+  ];
+  const widest = vars.reduce((m, v) => Math.max(m, v.name.length), 0);
+  print("ENVIRONMENT (behavior overrides)");
+  for (const v of vars) {
+    const raw = env[v.name];
+    const value = raw === void 0 || raw === "" ? `(not set \u2014 ${v.defaultHint})` : raw;
+    print(`  ${v.name.padEnd(widest)}  ${value}`);
+  }
+  print("");
+}
 async function renderStateSection(opts) {
   const { home, env, print } = opts;
   const raw = env.MCPH_DISABLE_PERSISTENCE;
@@ -1264,6 +1283,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";
@@ -2135,60 +2208,6 @@ 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;
@@ -3890,7 +3909,7 @@ function categorizeSpawnError(err) {
 }
 async function connectToUpstream(config, onDisconnect, onListChanged) {
   const client = new Client(
-    { name: "mcph", version: true ? "0.31.0" : "dev" },
+    { name: "mcph", version: true ? "0.33.0" : "dev" },
     { capabilities: {} }
   );
   let transport;
@@ -4407,7 +4426,7 @@ var ConnectServer = class _ConnectServer {
     this.apiUrl = apiUrl6;
     this.token = token6;
     this.server = new Server(
-      { name: "mcph", version: true ? "0.31.0" : "dev" },
+      { name: "mcph", version: true ? "0.33.0" : "dev" },
       {
         capabilities: {
           tools: { listChanged: true },
@@ -6443,6 +6462,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));
@@ -6487,9 +6507,16 @@ ${installBlock}
   );
   process.exit(0);
 } else if (subcommand === "--version" || subcommand === "-V") {
-  process.stdout.write(`mcph ${true ? "0.31.0" : "dev"}
+  process.stdout.write(`mcph ${true ? "0.33.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.31.0",
+  "version": "0.33.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)",