@yawlabs/mcph 0.37.0 → 0.38.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 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.38.0 — 2026-04-18
+
+- **`mcph reset-learning` CLI subcommand** — Deletes `~/.mcph/state.json` so cross-session learning starts fresh; prints the entry counts that were cleared. Pairs with v0.37.0's doctor RELIABILITY section: once a namespace has been flagged flaky, the dispatch penalty branch (v0.36.0) keeps suppressing it until enough new successes pile up — but if the user has since fixed the underlying cause (rotated a token, swapped the upstream, re-authed), that history is stale and the penalty has overstayed its welcome. This gives them a direct CLI lever to clear it. Scope is all-or-nothing by design; a per-namespace flag is footgunny (user clears one, forgets the others, keeps getting silently mis-ranked). No-op with an explanatory message when `MCPH_DISABLE_PERSISTENCE` is set or the file doesn't exist, so `mcph reset-learning` never surprises. Exit 0 on success or no-op, exit 1 on I/O error (permissions, disk).
+
 ## 0.37.0 — 2026-04-18
 
 - **`mcph doctor` RELIABILITY section** — New block surfaces flaky dormant namespaces pulled directly from `~/.mcph/state.json`, using the same ≥3-dispatches / <80%-success definition as `mcp_connect_health`'s cross-session reliability block — so the CLI diagnostic and the LLM-facing health tool agree on what "flaky" means. Sorted worst-rate first, capped at 5. Silently omitted when no namespace qualifies, state.json doesn't exist yet, or `MCPH_DISABLE_PERSISTENCE` is set. Threshold constants + sort logic extracted into `selectFlakyNamespaces` so handleHealth and doctor can't drift apart.

package/dist/index.js

@@ -1004,7 +1004,7 @@ function selectFlakyNamespaces(entries, limit) {
 }
 
 // src/doctor-cmd.ts
-var VERSION = true ? "0.37.0" : "dev";
+var VERSION = true ? "0.38.0" : "dev";
 async function runDoctor(opts = {}) {
   const lines = [];
   const write = opts.out ?? ((s) => process.stdout.write(s));
@@ -1791,9 +1791,61 @@ ${USAGE}` };
 }
 var INSTALL_USAGE = USAGE;
 
+// src/reset-learning-cmd.ts
+import { unlink } from "fs/promises";
+import { homedir as homedir6 } from "os";
+import { join as join6 } from "path";
+async function runResetLearning(opts = {}) {
+  const home = opts.home ?? homedir6();
+  const env = opts.env ?? process.env;
+  const write = opts.out ?? ((s) => process.stdout.write(s));
+  const writeErr = opts.err ?? ((s) => process.stderr.write(s));
+  const lines = [];
+  const print = (s = "") => {
+    lines.push(s);
+    write(`${s}
+`);
+  };
+  const printErr = (s) => {
+    lines.push(s);
+    writeErr(`${s}
+`);
+  };
+  const filePath = join6(userConfigDir(home), STATE_FILENAME);
+  const raw = env.MCPH_DISABLE_PERSISTENCE;
+  const disabled = raw !== void 0 && raw !== "" && (raw === "1" || raw.toLowerCase() === "true");
+  if (disabled) {
+    print("mcph reset-learning: persistence is disabled (MCPH_DISABLE_PERSISTENCE) \u2014 nothing to clear.");
+    return { exitCode: 0, lines, removed: false, path: filePath };
+  }
+  const persisted = await loadState(filePath);
+  const learningCount = Object.keys(persisted.learning).length;
+  const packCount = persisted.packHistory.length;
+  try {
+    await unlink(filePath);
+  } catch (err) {
+    if (isFileNotFound2(err)) {
+      print("mcph reset-learning: no persisted state to reset.");
+      print(`  path: ${filePath}`);
+      return { exitCode: 0, lines, removed: false, path: filePath };
+    }
+    const msg = err instanceof Error ? err.message : String(err);
+    printErr(`mcph reset-learning: failed to remove ${filePath}: ${msg}`);
+    return { exitCode: 1, lines, removed: false, path: filePath };
+  }
+  print("mcph reset-learning: cleared persisted state.");
+  print(`  path: ${filePath}`);
+  print(`  learning entries removed:     ${learningCount}`);
+  print(`  pack history entries removed: ${packCount}`);
+  return { exitCode: 0, lines, removed: true, path: filePath };
+}
+function isFileNotFound2(err) {
+  return !!err && typeof err === "object" && "code" in err && err.code === "ENOENT";
+}
+
 // src/server.ts
 import { readFile as readFile6 } from "fs/promises";
-import { homedir as homedir6 } from "os";
+import { homedir as homedir7 } from "os";
 import { isAbsolute, relative, resolve as resolve3 } from "path";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -4013,7 +4065,7 @@ function categorizeSpawnError(err) {
 }
 async function connectToUpstream(config, onDisconnect, onListChanged) {
   const client = new Client(
-    { name: "mcph", version: true ? "0.37.0" : "dev" },
+    { name: "mcph", version: true ? "0.38.0" : "dev" },
     { capabilities: {} }
   );
   let transport;
@@ -4494,7 +4546,7 @@ var ConnectServer = class _ConnectServer {
     this.apiUrl = apiUrl6;
     this.token = token6;
     this.server = new Server(
-      { name: "mcph", version: true ? "0.37.0" : "dev" },
+      { name: "mcph", version: true ? "0.38.0" : "dev" },
       {
         capabilities: {
           tools: { listChanged: true },
@@ -5929,7 +5981,7 @@ ${activeCount} loaded in this session, ${totalTools} tools in context${tokenSumm
     }
     const ALLOWED_FILENAMES = ["claude_desktop_config.json", "mcp.json", "settings.json", "mcp_config.json"];
     try {
-      const resolved = filepath.startsWith("~/") || filepath.startsWith("~\\") ? resolve3(homedir6(), filepath.slice(2)) : resolve3(filepath);
+      const resolved = filepath.startsWith("~/") || filepath.startsWith("~\\") ? resolve3(homedir7(), filepath.slice(2)) : resolve3(filepath);
       const resolvedBasename = resolved.split(/[/\\]/).pop() || "";
       if (!ALLOWED_FILENAMES.includes(resolvedBasename)) {
         return {
@@ -5946,7 +5998,7 @@ ${activeCount} loaded in this session, ${totalTools} tools in context${tokenSumm
         const rel = relative(base, p);
         return rel === "" || !rel.startsWith("..") && !isAbsolute(rel);
       };
-      if (!isUnder(homedir6(), resolved) && !isUnder(process.cwd(), resolved)) {
+      if (!isUnder(homedir7(), resolved) && !isUnder(process.cwd(), resolved)) {
         return {
           content: [
             { type: "text", text: "Import path must be under your home directory or the current working directory." }
@@ -6547,7 +6599,17 @@ 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 KNOWN_SUBCOMMANDS = [
+  "compliance",
+  "install",
+  "doctor",
+  "reset-learning",
+  "help",
+  "--help",
+  "-h",
+  "--version",
+  "-V"
+];
 var subcommand = process.argv[2];
 if (subcommand === "compliance") {
   runComplianceCommand(process.argv.slice(3)).then((code) => process.exit(code));
@@ -6561,6 +6623,8 @@ if (subcommand === "compliance") {
   runInstall(parsed.options).then((r) => process.exit(r.exitCode));
 } else if (subcommand === "doctor") {
   runDoctor().then((r) => process.exit(r.exitCode));
+} else if (subcommand === "reset-learning") {
+  runResetLearning().then((r) => process.exit(r.exitCode));
 } else if (subcommand === "--help" || subcommand === "-h" || subcommand === "help") {
   const installBlock = `    ${INSTALL_USAGE.replace(/^Usage: /, "").replace(/\n/g, "\n    ")}`;
   process.stdout.write(
@@ -6572,6 +6636,7 @@ if (subcommand === "compliance") {
     mcph install <client> [flags]     Auto-edit an MCP client's config to launch mcph
     mcph doctor                       Print loaded config + detected clients (support diagnostic)
     mcph compliance <target> [flags]  Run the compliance suite against an MCP server
+    mcph reset-learning               Clear cross-session learning history (~/.mcph/state.json)
     mcph --version                    Print version
 
   Install:
@@ -6592,7 +6657,7 @@ ${installBlock}
   );
   process.exit(0);
 } else if (subcommand === "--version" || subcommand === "-V") {
-  process.stdout.write(`mcph ${true ? "0.37.0" : "dev"}
+  process.stdout.write(`mcph ${true ? "0.38.0" : "dev"}
 `);
   process.exit(0);
 } else if (subcommand && !subcommand.startsWith("-")) {

package/package.json

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