@yawlabs/mcph 0.34.0 → 0.36.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.36.0 — 2026-04-18
+
+- **Negative signal in dispatch ranking (`boostFactor` penalty branch)** — The learning store's `boostFactor` now drops *below* 1.0 for namespaces with flaky history, mirroring the existing upward boost. Threshold is the same ≥3 dispatches / <80% success gate used by discover's inline reliability warning (v0.35.0) and health's cross-session block (v0.34.0) — so a server flagged flaky in those views also loses rank points at dispatch time rather than quietly continuing to win routing. Floor is `-10%` (`LEARNING_MIN_BOOST = 0.9`), symmetric with the existing `+10%` ceiling. Rate-based signal trumps count-based: a namespace with 10 successes but a 50% overall rate is flaky, not useful, and the penalty branch beats the positive branch in that case.
+
+## 0.35.0 — 2026-04-18
+
+- **Inline reliability warning in `mcp_connect_discover`** — Discover now annotates dormant (not currently loaded) servers with `reliability: P% success across N past calls` when persisted learning shows ≥3 dispatches and <80% success. Renders under the server card right after the live health warning, so the LLM sees the flaky history *before* it picks a server to activate — not only after `handleHealth` surfaces it post-hoc. Thresholds match the cross-session reliability block from v0.34.0 so the two views stay consistent. Suppressed for loaded servers (the live per-call warning already covers them with fresher data).
+
 ## 0.34.0 — 2026-04-18
 
 - **Cross-session reliability block in `mcp_connect_health`** — New section at the bottom of health output surfaces flaky *dormant* namespaces pulled from persisted learning: `<namespace> — N calls, P% success, last used <age> ago`. Threshold is deliberately high (≥3 dispatches, <80% success) so a one-off failure doesn't light up the panel; loaded namespaces are skipped (in-session block already covers them). Sorted worst-rate first, ties broken by most calls then alpha; capped at 5. Also fixes a gap where `handleHealth` returned early on an empty-connections session and never showed dormant history — now it falls through so operators can see which past servers were unreliable even before loading anything.

package/dist/index.js

@@ -946,7 +946,7 @@ function errorMessage(err) {
 }
 
 // src/doctor-cmd.ts
-var VERSION = true ? "0.34.0" : "dev";
+var VERSION = true ? "0.36.0" : "dev";
 async function runDoctor(opts = {}) {
   const lines = [];
   const write = opts.out ?? ((s) => process.stdout.write(s));
@@ -2355,6 +2355,8 @@ function pushToolCall(history, record, limit = HISTORY_LIMIT) {
 // src/learning.ts
 var LEARNING_MIN_OBSERVATIONS = 3;
 var LEARNING_MAX_BOOST = 1.1;
+var LEARNING_MIN_BOOST = 0.9;
+var PENALTY_RATE_THRESHOLD = 0.8;
 var SATURATION_AT = 10;
 var LearningStore = class {
   usage = /* @__PURE__ */ new Map();
@@ -2377,13 +2379,23 @@ var LearningStore = class {
   get(namespace) {
     return this.usage.get(namespace);
   }
-  // Boost factor in [1.0, LEARNING_MAX_BOOST]. Grows with successful
-  // observation count, saturating at SATURATION_AT successes so a
-  // heavily-used server can't runaway-win against legitimately better
-  // matches.
+  // Boost factor in [LEARNING_MIN_BOOST, LEARNING_MAX_BOOST]. Penalty
+  // branch wins when a namespace has been dispatched enough times and
+  // its success rate has fallen below 80%; otherwise the positive
+  // branch grows the factor with successful observation count, saturating
+  // at SATURATION_AT successes so a heavily-used server can't runaway-win
+  // against legitimately better matches.
   boostFactor(namespace) {
     const u = this.usage.get(namespace);
-    if (!u || u.succeeded < LEARNING_MIN_OBSERVATIONS) return 1;
+    if (!u) return 1;
+    if (u.dispatched >= LEARNING_MIN_OBSERVATIONS) {
+      const rate = u.succeeded / u.dispatched;
+      if (rate < PENALTY_RATE_THRESHOLD) {
+        const distance = Math.min(1, (PENALTY_RATE_THRESHOLD - rate) / PENALTY_RATE_THRESHOLD);
+        return 1 - distance * (1 - LEARNING_MIN_BOOST);
+      }
+    }
+    if (u.succeeded < LEARNING_MIN_OBSERVATIONS) return 1;
     const progress = Math.min(1, u.succeeded / SATURATION_AT);
     return 1 + progress * (LEARNING_MAX_BOOST - 1);
   }
@@ -3922,7 +3934,7 @@ function categorizeSpawnError(err) {
 }
 async function connectToUpstream(config, onDisconnect, onListChanged) {
   const client = new Client(
-    { name: "mcph", version: true ? "0.34.0" : "dev" },
+    { name: "mcph", version: true ? "0.36.0" : "dev" },
     { capabilities: {} }
   );
   let transport;
@@ -4323,6 +4335,8 @@ async function reportTools(serverId, tools) {
 // src/usage-hints.ts
 var MAX_PEERS = 3;
 var MIN_SUCCESS_TO_SHOW = 1;
+var RELIABILITY_MIN_OBSERVATIONS = 3;
+var RELIABILITY_THRESHOLD = 0.8;
 function buildCoUsageMap(packs) {
   const result = /* @__PURE__ */ new Map();
   for (const pack of packs) {
@@ -4355,6 +4369,13 @@ function formatUsageHint(usage, coUsedWith) {
   if (parts.length === 0) return null;
   return `usage: ${parts.join("; ")}`;
 }
+function formatReliabilityWarning(usage) {
+  if (!usage || usage.dispatched < RELIABILITY_MIN_OBSERVATIONS) return null;
+  const rate = usage.succeeded / usage.dispatched;
+  if (rate >= RELIABILITY_THRESHOLD) return null;
+  const pct = Math.round(rate * 100);
+  return `reliability: ${pct}% success across ${usage.dispatched} past calls`;
+}
 
 // src/server.ts
 var DEFAULT_POLL_INTERVAL_MS = 6e4;
@@ -4439,7 +4460,7 @@ var ConnectServer = class _ConnectServer {
     this.apiUrl = apiUrl6;
     this.token = token6;
     this.server = new Server(
-      { name: "mcph", version: true ? "0.34.0" : "dev" },
+      { name: "mcph", version: true ? "0.36.0" : "dev" },
       {
         capabilities: {
           tools: { listChanged: true },
@@ -5314,6 +5335,10 @@ var ConnectServer = class _ConnectServer {
       if (shadow) lines.push(`    ${shadow}`);
       const warning = formatHealthWarning(connection?.health, this.activationFailures.get(server.namespace));
       if (warning) lines.push(`    ${warning}`);
+      if (!connection) {
+        const reliability = formatReliabilityWarning(this.learning.get(server.namespace));
+        if (reliability) lines.push(`    ${reliability}`);
+      }
       const usageHint = formatUsageHint(this.learning.get(server.namespace), coUsageMap.get(server.namespace) ?? []);
       if (usageHint) lines.push(`    ${usageHint}`);
       if (!connection) {
@@ -6540,7 +6565,7 @@ ${installBlock}
   );
   process.exit(0);
 } else if (subcommand === "--version" || subcommand === "-V") {
-  process.stdout.write(`mcph ${true ? "0.34.0" : "dev"}
+  process.stdout.write(`mcph ${true ? "0.36.0" : "dev"}
 `);
   process.exit(0);
 } else if (subcommand && !subcommand.startsWith("-")) {

package/package.json

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