@mutmutco/cli 4.5.226 → 4.5.228

package/dist/main.cjs

@@ -982,12 +982,14 @@ function roleFromToken(token) {
 function readCache(path2, apiUrl, now, githubTokenFingerprint) {
   try {
     const session = JSON.parse((0, import_node_fs3.readFileSync)(path2, "utf8"));
-    if (!session.token || !session.expiresAt || session.apiUrl !== apiUrl) return null;
-    if (session.githubTokenFingerprint !== githubTokenFingerprint) return null;
-    if (new Date(session.expiresAt).getTime() <= now.getTime() + REFRESH_WINDOW_MS) return null;
-    return { ...session, role: roleFromToken(session.token) };
+    if (!session.token || !session.expiresAt || session.apiUrl !== apiUrl) return { session: null, stale: false };
+    if (session.githubTokenFingerprint !== githubTokenFingerprint) {
+      return { session: null, stale: true, staleLogin: typeof session.login === "string" ? session.login : void 0 };
+    }
+    if (new Date(session.expiresAt).getTime() <= now.getTime() + REFRESH_WINDOW_MS) return { session: null, stale: false };
+    return { session: { ...session, role: roleFromToken(session.token) }, stale: false };
   } catch {
-    return null;
+    return { session: null, stale: false };
   }
 }
 function writeCache(path2, session) {
@@ -1004,53 +1006,115 @@ function writeCache(path2, session) {
   } catch {
   }
 }
-async function hubAuthSession(deps) {
-  if (!deps.baseUrl) return void 0;
+function lastHubAuthFailure() {
+  return lastFailure;
+}
+function hubAuthFailureMessage(input) {
+  const r = input.refusal;
+  const said = r ? [
+    r.error ? `Hub error: ${r.error}` : `Hub error: HTTP ${r.status ?? "unknown"}`,
+    r.reason ? `reason: ${r.reason}` : "",
+    r.hint ? `hint: ${r.hint}` : ""
+  ].filter(Boolean).join(" ") : "";
+  if (input.kind === "stale-session") {
+    return `cached Hub session is stale: it was minted from a different GitHub token${input.staleLogin ? ` (cached login ${input.staleLogin})` : ""}, and the automatic re-mint was refused${said ? ` \u2014 ${said}` : ""}. Re-authenticate so ONE token source feeds both the cache and the mint (\`gh auth login\` / \`gh auth switch\`, or unset \`MMI_GH_PAT\` so the shell falls back to the gh keyring), then retry; \`mmi-cli whoami\` confirms the identity.`;
+  }
+  if (input.kind === "refused") {
+    return `Hub refused this GitHub token for a Hub session${said ? ` \u2014 ${said}` : ""} (${MEMBERSHIP_FIX}).`;
+  }
+  return `Hub session exchange failed: ${(input.transient ?? said) || "no answer from the Hub"} \u2014 the Hub is unreachable or cold-started; retry, and \`mmi-cli doctor\` reports Hub reachability.`;
+}
+async function hubAuthSessionOutcome(deps) {
+  if (!deps.baseUrl) return {};
   const apiUrl = normalizeBaseUrl(deps.baseUrl);
   const envToken = process.env.MMI_HUB_TOKEN;
   if (envToken) {
-    return { ...{ token: envToken }, expiresAt: new Date(Date.now() + 30 * 60 * 1e3).toISOString(), apiUrl, githubTokenFingerprint: "env-override" };
+    lastFailure = void 0;
+    return { session: { ...{ token: envToken }, expiresAt: new Date(Date.now() + 30 * 60 * 1e3).toISOString(), apiUrl, githubTokenFingerprint: "env-override" } };
   }
   const now = deps.now?.() ?? /* @__PURE__ */ new Date();
   const cachePath = deps.cachePath ?? defaultHubSessionCachePath();
   const ghToken = await deps.githubToken();
-  if (!ghToken) return void 0;
-  const githubTokenFingerprint = tokenFingerprint(ghToken);
-  const cached = readCache(cachePath, apiUrl, now, githubTokenFingerprint);
-  if (cached) return cached;
-  try {
-    const res = await fetchWithRetry(
-      deps.fetch ?? fetch,
-      `${apiUrl}/auth/session`,
-      { method: "POST", headers: { ...clientVersionHeaders(), Authorization: `Bearer ${ghToken}` } },
-      { attempts: EXCHANGE_ATTEMPTS, timeoutMs: EXCHANGE_TIMEOUT_MS }
-    );
-    if (!res.ok) return void 0;
-    const body = await res.json();
-    if (!body.token || !body.expiresAt) return void 0;
-    const session = {
-      token: body.token,
-      expiresAt: body.expiresAt,
-      login: typeof body.login === "string" ? body.login : void 0,
-      // #3513: from the SIGNED token, not the response body — one rule at every hop, so the cache
-      // read and the network read cannot disagree about what counts as an assertion.
-      role: roleFromToken(body.token),
-      apiUrl,
-      githubTokenFingerprint
+  if (!ghToken) {
+    lastFailure = {
+      kind: "unreachable",
+      message: "no GitHub token available for a Hub session \u2014 `gh auth login` (or set MMI_GH_PAT/GH_TOKEN), then retry."
     };
+    return { failure: lastFailure };
+  }
+  const githubTokenFingerprint = tokenFingerprint(ghToken);
+  const cache = readCache(cachePath, apiUrl, now, githubTokenFingerprint);
+  if (cache.session) {
+    lastFailure = void 0;
+    return { session: cache.session };
+  }
+  return mintSession(deps, cachePath, apiUrl, ghToken, githubTokenFingerprint, cache);
+}
+async function mintSession(deps, cachePath, apiUrl, ghToken, githubTokenFingerprint, cache) {
+  const attempts = cache.stale ? 2 : 1;
+  let refusal;
+  let transient;
+  for (let attempt = 0; attempt < attempts; attempt += 1) {
     try {
-      writeCache(cachePath, session);
-    } catch {
+      const res = await fetchWithRetry(
+        deps.fetch ?? fetch,
+        `${apiUrl}/auth/session`,
+        { method: "POST", headers: { ...clientVersionHeaders(), Authorization: `Bearer ${ghToken}` } },
+        { attempts: EXCHANGE_ATTEMPTS, timeoutMs: EXCHANGE_TIMEOUT_MS }
+      );
+      if (!res.ok) {
+        const body2 = await res.json().catch(() => ({}));
+        refusal = {
+          status: res.status,
+          error: typeof body2.error === "string" ? body2.error : void 0,
+          reason: typeof body2.reason === "string" ? body2.reason : void 0,
+          hint: typeof body2.hint === "string" ? body2.hint : void 0
+        };
+        continue;
+      }
+      const body = await res.json();
+      if (!body.token || !body.expiresAt) {
+        refusal = { status: res.status, error: "the Hub returned no session token" };
+        continue;
+      }
+      const session = {
+        token: body.token,
+        expiresAt: body.expiresAt,
+        login: typeof body.login === "string" ? body.login : void 0,
+        // #3513: from the SIGNED token, not the response body — one rule at every hop, so the cache
+        // read and the network read cannot disagree about what counts as an assertion.
+        role: roleFromToken(body.token),
+        apiUrl,
+        githubTokenFingerprint
+      };
+      try {
+        writeCache(cachePath, session);
+      } catch {
+      }
+      lastFailure = void 0;
+      return { session };
+    } catch (e) {
+      transient = e?.message || "network error";
     }
-    return session;
-  } catch {
-    return void 0;
   }
+  const kind = cache.stale ? "stale-session" : refusal ? "refused" : "unreachable";
+  const failure = {
+    kind,
+    message: hubAuthFailureMessage({ kind, staleLogin: cache.staleLogin, refusal, transient }),
+    ...refusal?.reason ? { reason: refusal.reason } : {},
+    ...refusal?.hint ? { hint: refusal.hint } : {},
+    ...kind === "stale-session" ? { exitCode: EXIT_HUB_SESSION_STALE } : kind === "refused" ? { exitCode: EXIT_HUB_SESSION_REFUSED } : {}
+  };
+  lastFailure = failure;
+  return { failure };
+}
+async function hubAuthSession(deps) {
+  return (await hubAuthSessionOutcome(deps)).session;
 }
 async function hubAuthToken(deps) {
   return (await hubAuthSession(deps))?.token;
 }
-var import_node_crypto, import_node_fs3, import_node_path3, import_node_os2, REFRESH_WINDOW_MS, EXCHANGE_TIMEOUT_MS, EXCHANGE_ATTEMPTS;
+var import_node_crypto, import_node_fs3, import_node_path3, import_node_os2, REFRESH_WINDOW_MS, EXCHANGE_TIMEOUT_MS, EXCHANGE_ATTEMPTS, EXIT_HUB_SESSION_STALE, EXIT_HUB_SESSION_REFUSED, lastFailure, MEMBERSHIP_FIX;
 var init_hub_auth = __esm({
   "src/hub-auth.ts"() {
     "use strict";
@@ -1063,6 +1127,9 @@ var init_hub_auth = __esm({
     REFRESH_WINDOW_MS = 10 * 60 * 1e3;
     EXCHANGE_TIMEOUT_MS = 8e3;
     EXCHANGE_ATTEMPTS = 2;
+    EXIT_HUB_SESSION_STALE = 76;
+    EXIT_HUB_SESSION_REFUSED = 77;
+    MEMBERSHIP_FIX = "the token needs Organization \u2192 Members: read (`read:org`) \u2014 use a classic PAT or an App carrying that permission, or `gh auth switch` to a login that has it; then `mmi-cli whoami` confirms the identity";
   }
 });
 
@@ -9359,12 +9426,22 @@ var isWin = process.platform === "win32";
 var MMI_PLUGIN_ID = "mmi@mutmutco";
 var LEGACY_MMI_MARKETPLACE = "mmi";
 var CODEX_MARKETPLACE = "mutmutco";
-function detectSurface(env) {
+function insideOpenBotAgentWorkspace(cwd, env = process.env, home = (0, import_node_os4.homedir)()) {
+  let dir = cwd;
+  try {
+    dir ??= process.cwd();
+  } catch {
+    return false;
+  }
+  const rel = (0, import_node_path4.relative)(openbotAgentsRoot(env, home), dir);
+  return !(0, import_node_path4.isAbsolute)(rel) && (rel.split(/[\\/]/)[0] ?? "").toLowerCase().startsWith("agent-");
+}
+function detectSurface(env, cwd) {
   const has = (k) => Boolean(env[k]?.trim());
+  if (env.MMI_AGENT_SURFACE === "openbot" || insideOpenBotAgentWorkspace(cwd, env)) return "openbot";
   if (env.MMI_AGENT_SURFACE === "codex" || has("CODEX_THREAD_ID") || has("CODEX_MANAGED_BY_NPM") || has("CODEX_MANAGED_PACKAGE_ROOT") || (env.CLAUDE_PLUGIN_ROOT ?? "").includes(".codex")) {
     return "codex";
   }
-  if (env.MMI_AGENT_SURFACE === "hermes" || has("HERMES_SESSION_ID") || has("HERMES_PLUGIN_ROOT")) return "hermes";
   if (env.MMI_AGENT_SURFACE === "jervcode" || has("PI_SESSION_ID")) {
     return "jervcode";
   }
@@ -9384,8 +9461,8 @@ function surfaceToken(surface) {
       return "codex";
     case "jervcode":
       return "jervcode";
-    case "hermes":
-      return "hermes";
+    case "openbot":
+      return "openbot";
     case "opencode":
       return "opencode";
     case "shell":
@@ -9403,8 +9480,8 @@ function reloadAction(surface) {
       return "restart OpenCode";
     case "jervcode":
       return "restart JervCode (the package set is read at launch)";
-    case "hermes":
-      return "start a fresh Hermes Agent process";
+    case "openbot":
+      return "start a fresh OpenBot agent run";
     case "claude-cli":
     case "shell":
     default:
@@ -9444,7 +9521,7 @@ function nonClaudeSurfaceHealMessage(surface) {
   if (surface === "codex") {
     return "Codex ships an MMI plugin (#3563). Install or repair it with:\n  codex plugin marketplace add mutmutco/MMI-Hub && codex plugin add mmi@mutmutco\n  Update the CLI too: npm i -g @mutmutco/cli";
   }
-  return "No Hub-shipped MMI plugin on this host \u2014 the Hub ships plugins for Claude, Codex, JervCode, and Hermes only.\n  Update the CLI instead: npm i -g @mutmutco/cli   (org rules ride an AGENTS.md authored outside the Hub)";
+  return "No Hub-shipped MMI plugin on this host \u2014 the Hub ships plugins for Claude, Codex, JervCode, and OpenBot only.\n  Update the CLI instead: npm i -g @mutmutco/cli   (org rules ride an AGENTS.md authored outside the Hub)";
 }
 function healStepAborts(step, ok) {
   return !ok && step.gated;
@@ -9487,14 +9564,20 @@ function runHostBin(bin, args, opts) {
   const argv = isWin ? ["/c", bin, ...args] : args;
   return step ? execFileHard(file, argv, { ...shared, step }) : execFileP(file, argv, shared);
 }
-function hermesConfigRoot(env = process.env, home = (0, import_node_os4.homedir)(), platform2 = process.platform) {
-  if (env.HERMES_HOME?.trim()) return env.HERMES_HOME.trim();
-  if (platform2 === "win32") return (0, import_node_path4.join)(env.LOCALAPPDATA?.trim() || (0, import_node_path4.join)(home, "AppData", "Local"), "hermes");
-  return (0, import_node_path4.join)(home, ".hermes");
+function openbotAgentsRoot(env = process.env, home = (0, import_node_os4.homedir)()) {
+  return env.MMI_UPDATER_OPENBOT_AGENTS_DIR?.trim() || (0, import_node_path4.join)(home, "OpenBot", "Agents");
+}
+function openbotAgentWorkspaces(env = process.env, home = (0, import_node_os4.homedir)()) {
+  const root = openbotAgentsRoot(env, home);
+  try {
+    return (0, import_node_fs7.readdirSync)(root, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.startsWith("agent-")).map((entry) => (0, import_node_path4.join)(root, entry.name)).sort();
+  } catch {
+    return [];
+  }
 }
 function surfaceConfigRoot(surface, env = process.env, home = (0, import_node_os4.homedir)()) {
   if (surface === "codex") return env.CODEX_HOME?.trim() || (0, import_node_path4.join)(home, ".codex");
-  if (surface === "hermes") return hermesConfigRoot(env, home);
+  if (surface === "openbot") return openbotAgentsRoot(env, home);
   if (surface === "jervcode") {
     return env.JERVCODE_CODING_AGENT_DIR?.trim() || env.PI_CODING_AGENT_DIR?.trim() || (0, import_node_path4.join)(home, ".jerv", "agent");
   }
@@ -9518,7 +9601,7 @@ function marketplaceCloneCandidates(surface, home, env = process.env) {
       (0, import_node_path4.join)(root, "plugins", "marketplaces", CODEX_MARKETPLACE)
     ];
   }
-  if (surface === "hermes") return [];
+  if (surface === "openbot") return [];
   if (surface === "jervcode") return [];
   return [(0, import_node_path4.join)(home, ".claude", "plugins", "marketplaces", "mutmutco")];
 }
@@ -9628,13 +9711,26 @@ function mmiPiPackageHealthy(env = process.env, home = (0, import_node_os4.homed
 function piDoctorEnv(agentDir) {
   return { ...process.env, PI_CODING_AGENT_DIR: agentDir };
 }
-function hermesPluginRoot(env = process.env, home = (0, import_node_os4.homedir)()) {
-  return (0, import_node_path4.join)(hermesConfigRoot(env, home), "plugins", "mmi");
+function openbotManagedRecord(env = process.env, home = (0, import_node_os4.homedir)()) {
+  for (const workspace of openbotAgentWorkspaces(env, home)) {
+    const path2 = (0, import_node_path4.join)(workspace, ".agents", "skills", ".mmi-managed.json");
+    if (!(0, import_node_fs7.existsSync)(path2)) continue;
+    try {
+      const record2 = JSON.parse((0, import_node_fs7.readFileSync)(path2, "utf8"));
+      return { workspace, ...typeof record2.version === "string" ? { version: record2.version } : {} };
+    } catch {
+      return { workspace };
+    }
+  }
+  return null;
 }
-function hermesPluginTreeHealthy(root, exists = import_node_fs7.existsSync) {
-  if (!["plugin.yaml", "__init__.py"].every((file) => exists((0, import_node_path4.join)(root, file)))) return false;
+function openbotWorkspaceSkillsHealthy(env = process.env, home = (0, import_node_os4.homedir)()) {
+  const record2 = openbotManagedRecord(env, home);
+  if (!record2) return false;
   try {
-    return (0, import_node_fs7.statSync)((0, import_node_path4.join)(root, "skills")).isDirectory();
+    const recordFile = JSON.parse((0, import_node_fs7.readFileSync)((0, import_node_path4.join)(record2.workspace, ".agents", "skills", ".mmi-managed.json"), "utf8"));
+    const owned = Array.isArray(recordFile.skills) ? recordFile.skills : [];
+    return owned.length > 0 && owned.every((name) => typeof name === "string" && (0, import_node_fs7.existsSync)((0, import_node_path4.join)(record2.workspace, ".agents", "skills", name, "SKILL.md")));
   } catch {
     return false;
   }
@@ -9649,10 +9745,11 @@ function snapshotPluginGuardInput(surface = detectSurface(process.env), isOrgRep
     // Codex's native projection is authoritative; its legacy installed_plugins.json may be empty
     // while `plugin list --json` proves the managed plugin installed (#6111).
     installRecordPresent: surface === "codex" ? codexStatus?.installed === true : hasUserInstallRecord(installed, MMI_PLUGIN_ID) || hasProjectInstallRecord(installed, MMI_PLUGIN_ID, process.cwd()) || // #4188: jervcode's install record is the settings-file packages[] entry itself.
-    surface === "jervcode" && piEntry !== null || surface === "hermes" && (0, import_node_fs7.existsSync)(hermesPluginRoot()),
+    surface === "jervcode" && piEntry !== null || // #9130: OpenBot's install record is the workspace ownership file MMI itself writes.
+    surface === "openbot" && openbotManagedRecord() !== null,
     // JervCode's settings entry and native local surfaces have no marketplace clone.
-    marketplaceClonePresent: surface === "jervcode" || surface === "hermes" ? true : marketplaceClonePresent(surface, (0, import_node_os4.homedir)()),
-    pluginCachePresent: surface === "jervcode" ? mmiPiPackageHealthy() : surface === "hermes" ? hermesPluginTreeHealthy(hermesPluginRoot()) : surface === "codex" ? Boolean(
+    marketplaceClonePresent: surface === "jervcode" || surface === "openbot" ? true : marketplaceClonePresent(surface, (0, import_node_os4.homedir)()),
+    pluginCachePresent: surface === "jervcode" ? mmiPiPackageHealthy() : surface === "openbot" ? openbotWorkspaceSkillsHealthy() : surface === "codex" ? Boolean(
       codexStatus?.installed && codexStatus.enabled && codexStatus.version && (0, import_node_fs7.existsSync)((0, import_node_path4.join)(root, "plugins", "cache", CODEX_MARKETPLACE, "mmi", codexStatus.version))
     ) : (0, import_node_fs7.existsSync)((0, import_node_path4.join)(root, "plugins", "cache", "mutmutco", "mmi"))
   };
@@ -9951,7 +10048,6 @@ var SESSION_ID_ENV_VARS = [
   "CLAUDE_CODE_SESSION_ID",
   "CODEX_SESSION_ID",
   "CODEX_THREAD_ID",
-  "HERMES_SESSION_ID",
   "PI_SESSION_ID",
   // #6193: lane runners spawn the CLI through the host's extension shell operations, which strip
   // the PI_* session variables; the JervCode launcher's durable lane id (JERV_SESSION_ID) is what
@@ -9960,6 +10056,9 @@ var SESSION_ID_ENV_VARS = [
   // synth/shell identity and the claim guard contests the caller's OWN lane (the #3414/#3438
   // refusals of jerv_worktree_land's `devops pr create` from the claimed task worktree).
   "JERV_SESSION_ID"
+  // #9130: OpenBot exports no session variable of its own (its surface comes from the agent-workspace
+  // cwd). Merv's codex runtime carries CODEX_THREAD_ID, honoured above; otherwise an OpenBot claim's
+  // session is the per-process `synth-openbot-…` fallback — it proves the surface, never one lane.
 ];
 var SYNTH_SESSION_PREFIX = "synth-";
 function isHostSessionId(session) {
@@ -16032,6 +16131,9 @@ function partitionByRequired(entries, requiredContexts) {
       ignoredFailures.push(entry.name);
     }
   }
+  if (relevant.length && [...requiredContexts].some((name) => !entries.some((entry) => entry.name === name))) {
+    relevant.push("pending");
+  }
   return { relevant, ignoredFailures };
 }
 function parseNdjsonLines(stdout) {
@@ -18735,6 +18837,7 @@ function shouldWithdrawSurfaceFlag(result) {
 
 // src/secrets-transport.ts
 init_client_version();
+init_hub_auth();
 var OWNER = "mutmutco";
 var SSM_ROOT = "/mmi-future";
 var ORG_INFRA_SLUG = "_org";
@@ -18896,6 +18999,17 @@ function errorDetail(body) {
   const error = typeof body.error === "string" ? body.error : "";
   return error ? `: ${error}` : "";
 }
+function hubAuthErrorDetail(body) {
+  const parts = [errorDetail(body)];
+  if (safeServerReason(body.reason)) parts.push(` (reason: ${String(body.reason)})`);
+  if (safeServerReason(body.hint)) parts.push(` \u2014 ${String(body.hint)}`);
+  return parts.join("");
+}
+function refusedLine(prefix, res, body) {
+  const local = lastHubAuthFailure();
+  if (res.status === 401 && local) return local.message;
+  return `${prefix}: HTTP ${res.status}${hubAuthErrorDetail(body)}`;
+}
 async function upgradeMessage(res, body) {
   if (res.status !== 426) return null;
   return upgradeRequiredError(res, body ?? await readJsonBody(res));
@@ -18944,7 +19058,7 @@ async function secretsList(deps, opts) {
     return;
   }
   if (!res.ok) {
-    deps.err(await upgradeMessage(res) ?? `secrets list failed: HTTP ${res.status}${await readErr(res)}`);
+    deps.err(await upgradeMessage(res) ?? refusedLine("secrets list failed", res, await readJsonBody(res)));
     return;
   }
   const { secrets } = await res.json();
@@ -19329,6 +19443,10 @@ function missingRequiredKeys(stage, required, present, declaredSecrets) {
 }
 async function secretsPreflight(deps, opts) {
   const repo = await targetRepo(deps, opts);
+  if (opts.required.length === 0 && !opts.json) {
+    deps.log(`0 required ${opts.stage} secret names`);
+    return true;
+  }
   const qs = new URLSearchParams({ repo }).toString();
   let res;
   try {
@@ -20265,7 +20383,7 @@ async function secretsRequest(deps, key, opts) {
   });
   const body = await readJsonBody(res);
   if (!res.ok) {
-    deps.err(await upgradeMessage(res, body) ?? `secrets request failed: HTTP ${res.status}${errorDetail(body)}`);
+    deps.err(await upgradeMessage(res, body) ?? refusedLine("secrets request failed", res, body));
     return false;
   }
   if (opts.json) {
@@ -20962,7 +21080,7 @@ async function fetchSecretForUse(deps, { repo, key, slug }) {
       return null;
     }
     deps.err(
-      await upgradeMessage(res, body) ?? (res.status === 403 ? `secrets use: not authorized for ${key} (HTTP 403) \u2014 ask the master for a \`secrets grant\`${errorDetail(body)}` : `secrets use failed: HTTP ${res.status}${errorDetail(body)}`)
+      await upgradeMessage(res, body) ?? (res.status === 403 ? `secrets use: not authorized for ${key} (HTTP 403) \u2014 ask the master for a \`secrets grant\`${errorDetail(body)}` : refusedLine("secrets use failed", res, body))
     );
     return null;
   }
@@ -24970,6 +25088,7 @@ function createDocsIndexDeps(repoRoot2) {
 // src/gate-budget.ts
 var BLESSED_RUN_WITH_BUDGET_SHA = "5ce541add569e54e7ca96de67a768577d3d604e4";
 var BLESSED_RUNNER_GATE_SHA = "a19e9392e5ad9b0675f02e4304d68dd933fad60f";
+var BLESSED_KIT_AGENT_FILES_SHA = "a8b273ed418e703c0aa501a53ea87228ba28b1f0";
 var BLESSED_RUNBOOK_GUARD_SHA = "e661e0aedc0e58b73c738bf6cdfeac65e5914584";
 var REMOTE_USE = /^mutmutco\/MMI-Hub\/\.github\/actions\/run-with-budget@(\S+)$/;
 var LOCAL_USE = "./.github/actions/run-with-budget";
@@ -25345,6 +25464,9 @@ function gateSeedVars(cls, releaseTrack, runtime = "node", requiredCheckBranches
     // The pin is the CLI's blessed SHA, not an operator knob — one central place to bump (#3178).
     GATE_BUDGET_SHA: BLESSED_RUN_WITH_BUDGET_SHA,
     GATE_RUNNER_SHA: BLESSED_RUNNER_GATE_SHA,
+    // #9161: the suite-only kit-file drift action arrived after the shared runner pin, so it carries its own
+    // blessed revision — bumping GATE_RUNNER_SHA for it would move every generic repo's toolchain too.
+    KIT_AGENT_FILES_SHA: BLESSED_KIT_AGENT_FILES_SHA,
     // #8129: the guard and its bundled CLI must come from the same immutable Hub revision.
     GATE_RUNBOOK_SHA: BLESSED_RUNBOOK_GUARD_SHA,
     // #7407: repo-declared service containers and extra check steps; empty renders today's gate byte-for-byte.
@@ -27088,10 +27210,10 @@ var rollout_plan_default = {
     note: "The v4.0.0 stamp happens at cut time (D6e #4463); until then the candidate is the origin/development head artifacts (built cli/dist + npm pack), identity proven by dist content hash (D6a)."
   },
   baseline: {
-    version: "4.5.226",
-    tag: "v4.5.226",
-    commit: "360239dd3172",
-    npm: "@mutmutco/cli@4.5.226"
+    version: "4.5.228",
+    tag: "v4.5.228",
+    commit: "097f7c9ad0e0",
+    npm: "@mutmutco/cli@4.5.228"
   },
   exitCriterion: "fleet-n-of-n",
   hubOnlyShortcut: "forbidden",
@@ -27108,14 +27230,14 @@ var rollout_plan_default = {
           repo: "mutmutco/mmi-hub",
           role: "canary",
           schedule: "train",
-          v3Target: "v4.5.226"
+          v3Target: "v4.5.228"
         }
       ],
       rollbackTrigger: "Any red inside the post-contract soak window: `devops train gate` FAIL attributable to the v4 doors, Hub endpoint health probe failure, a pre-v4 client admitted instead of receiving actionable HTTP 426, or npm consumer install/doctor failure on the v4-only dist.",
       rollback: {
         independent: true,
-        mechanism: "npm dist-tag latest -> 4.5.226 and redeploy the Hub Lambda from tag v4.5.226 (360239dd3172); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
-        v3Target: "v4.5.226 (@mutmutco/cli@4.5.226, tag commit 360239dd3172 \u2014 last known-good release carrying the repo-index v4-only contract)"
+        mechanism: "npm dist-tag latest -> 4.5.228 and redeploy the Hub Lambda from tag v4.5.228 (097f7c9ad0e0); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
+        v3Target: "v4.5.228 (@mutmutco/cli@4.5.228, tag commit 097f7c9ad0e0 \u2014 last known-good release carrying the repo-index v4-only contract)"
       }
     },
     {
@@ -29272,7 +29394,8 @@ async function buildTrainApplyContext(deps) {
     repo,
     owner,
     slug: name.toLowerCase(),
-    login
+    login,
+    ...verdict.authenticatedDelegation === true ? { delegatedActor: login } : {}
   };
 }
 function commandAuthorityLabel(owner) {
@@ -32049,57 +32172,24 @@ function installedClaudePluginVersion() {
     return void 0;
   }
 }
-function readHermesPluginEvidence(env = process.env) {
-  const host = hermesConfigRoot(env);
-  const root = hermesPluginRoot(env);
-  const installRecordPresent = (0, import_node_fs25.existsSync)(root);
-  const manifestPath = (0, import_node_path22.join)(root, "plugin.yaml");
-  let installedVersion;
+function readOpenBotPluginEvidence(env = process.env) {
+  const workspaces = openbotAgentWorkspaces(env);
+  const record2 = openbotManagedRecord(env);
+  const recordPath = record2 ? (0, import_node_path22.join)(record2.workspace, ".agents", "skills", ".mmi-managed.json") : void 0;
   let manifest = "missing";
-  try {
-    const text = (0, import_node_fs25.readFileSync)(manifestPath, "utf8");
-    let version;
-    try {
-      const parsed = JSON.parse(text).version;
-      if (typeof parsed === "string" && parsed.trim()) version = parsed.trim();
-    } catch {
-    }
-    if (!version) {
-      const match = /^version:\s*["']?([^\s"'#]+)["']?\s*(?:#.*)?$/m.exec(text);
-      version = match?.[1];
-    }
-    if (version) {
-      installedVersion = version;
-      manifest = "valid";
-    } else if ((0, import_node_fs25.existsSync)(manifestPath)) manifest = "invalid";
-  } catch {
-    if ((0, import_node_fs25.existsSync)(manifestPath)) manifest = "invalid";
-  }
-  let skills = false;
-  try {
-    skills = (0, import_node_fs25.existsSync)((0, import_node_path22.join)(root, "skills")) && (0, import_node_fs25.statSync)((0, import_node_path22.join)(root, "skills")).isDirectory();
-  } catch {
-  }
-  let provisioned = false;
-  const provisionedRoot = (0, import_node_path22.join)(host, "skills", "mmi");
-  try {
-    provisioned = (0, import_node_fs25.existsSync)(provisionedRoot) && (0, import_node_fs25.statSync)(provisionedRoot).isDirectory();
-  } catch {
-  }
-  const treeOk = (0, import_node_fs25.existsSync)((0, import_node_path22.join)(root, "__init__.py")) && skills && manifest === "valid";
-  const receipt = treeOk && !provisioned ? `hermes-skills-unprovisioned:${provisionedRoot}` : void 0;
+  if (recordPath) manifest = record2?.version ? "valid" : "invalid";
   return {
-    hostPresent: (0, import_node_fs25.existsSync)(host),
-    installRecordPresent,
+    hostPresent: workspaces.length > 0,
+    installRecordPresent: record2 !== null,
     manifest,
-    payloadPresent: treeOk && provisioned,
-    ...installedVersion ? { installedVersion } : {},
-    ...receipt ? { receipt } : {}
+    payloadPresent: record2 !== null && openbotWorkspaceSkillsHealthy(env),
+    ...record2?.version ? { installedVersion: record2.version } : {},
+    ...recordPath && !record2?.version ? { receipt: `openbot-ownership-unreadable:${recordPath}` } : {}
   };
 }
 function installedSurfacePluginVersion(surface) {
   const token = surfaceToken(surface);
-  if (token === "hermes") return readHermesPluginEvidence().installedVersion;
+  if (token === "openbot") return readOpenBotPluginEvidence().installedVersion;
   if (token === "jervcode") {
     return installedJervCodePackageVersion();
   }
@@ -34298,6 +34388,22 @@ function supersedeablePublishLegShape(rec) {
 function deferredGatewayDeployLegShape(rec) {
   return rec.state === "pending" && rec.runId == null && rec.workflow === "jerv-gateway";
 }
+function releaseAssetsCarryInstallerPayload(assets, tag) {
+  const version = tag.replace(/^v/, "");
+  return assets.some((asset) => typeof asset.name === "string" && asset.name.startsWith("installer-payload-") && asset.name.endsWith(`-${version}.tar.gz`));
+}
+async function proveInstallerPayloadPresence(deps, prior, label, ref) {
+  let assets;
+  try {
+    const parsed = JSON.parse(await deps.run("gh", ["release", "view", prior.tag, "--repo", prior.repo, "--json", "assets"]));
+    assets = Array.isArray(parsed.assets) ? parsed.assets : [];
+  } catch (e) {
+    throw new Error(
+      `${label}: could not read the ${prior.tag} GitHub Release asset list (${e instanceof Error ? e.message.split("\n")[0] : String(e)}) \u2014 whether the installer payload exists is unproven, so the deploy leg cannot be closed; retry when GitHub answers; nothing was written (${ref})`
+    );
+  }
+  return releaseAssetsCarryInstallerPayload(assets, prior.tag) ? "present" : "absent";
+}
 async function proveOriginPromotionOrArchived(deps, prior, path2, label, ref, fence) {
   let liveSha = "";
   try {
@@ -34383,23 +34489,29 @@ async function supersedeContentCausedPublishLeg(deps, cwd) {
       };
     }
     if (deferredGateway) {
-      const dispatch = await appendJervGatewayReleaseDeploy(
-        deps,
-        prior.repo,
-        prior.tag,
-        prior.tagSha,
-        { note: `Jerv Gateway operator-host deploy leg for ${prior.tag} run during the publish supersession`, deployStatus: "success" }
-      );
-      phases.deploy = {
-        ...phaseEntry(deployPhaseInput("registry-publish", dispatch, { releaseSha: prior.tagSha })),
-        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-      };
-      if (dispatch.deployStatus !== "success") {
-        throw new Error(
-          `release --supersede-publish: the deferred ${prior.tag} Jerv Gateway operator-host deploy leg did not verify (${dispatch.note}) \u2014 run \`scripts/jerv-gateway-release-deploy.sh --tag ${prior.tag}\` to a healthy receipt naming the released tag and commit, then retry; nothing was written (#6742)`
+      if (prior.phases.publish.state === "failed" && await proveInstallerPayloadPresence(deps, prior, "release --supersede-publish", "#9182") === "absent") {
+        const payloadNote = `superseded: the ${prior.tag} publish never produced the installer payload (the live release carries no installer-payload asset for this version) \u2014 the deferred Jerv Gateway operator-host deploy leg was skipped, nothing was deployable from this tag; the cause fix rides the next patch train (#9182)`;
+        phases.deploy = { state: "skipped", sha: prior.tagSha, superseded: true, note: payloadNote, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+        gatewayDeploy = { workflow: "jerv-gateway", state: "skipped", note: payloadNote };
+      } else {
+        const dispatch = await appendJervGatewayReleaseDeploy(
+          deps,
+          prior.repo,
+          prior.tag,
+          prior.tagSha,
+          { note: `Jerv Gateway operator-host deploy leg for ${prior.tag} run during the publish supersession`, deployStatus: "success" }
         );
+        phases.deploy = {
+          ...phaseEntry(deployPhaseInput("registry-publish", dispatch, { releaseSha: prior.tagSha })),
+          updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        if (dispatch.deployStatus !== "success") {
+          throw new Error(
+            `release --supersede-publish: the deferred ${prior.tag} Jerv Gateway operator-host deploy leg did not verify (${dispatch.note}) \u2014 run \`scripts/jerv-gateway-release-deploy.sh --tag ${prior.tag}\` to a healthy receipt naming the released tag and commit, then retry; nothing was written (#6742)`
+          );
+        }
+        gatewayDeploy = { workflow: "jerv-gateway", state: "complete", note: dispatch.note };
       }
-      gatewayDeploy = { workflow: "jerv-gateway", state: "complete", note: dispatch.note };
     }
     const note = `superseded: content-caused publish failure on the immutable promoted ${prior.tag} \u2014 the cause fix rides the next patch train (master-approved closure, #6638)`;
     await fence(() => atomicWriteJson(path2, {
@@ -34483,7 +34595,11 @@ async function supersedeContentCausedDeployAndPublishLegs(deps, cwd) {
     }
     let deployEntry;
     let gatewayDeploy;
-    if (deferredGateway) {
+    if (deferredGateway && publish.state === "failed" && await proveInstallerPayloadPresence(deps, prior, label, "#9182") === "absent") {
+      const payloadNote = `superseded: the ${prior.tag} publish never produced the installer payload (the live release carries no installer-payload asset for this version) \u2014 the deferred Jerv Gateway operator-host deploy leg was skipped, nothing was deployable from this tag; the cause fix rides the next patch train (#9182)`;
+      deployEntry = { state: "skipped", sha: prior.tagSha, superseded: true, note: payloadNote, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+      gatewayDeploy = { workflow: "jerv-gateway", state: "skipped", note: payloadNote };
+    } else if (deferredGateway) {
       const dispatch = await appendJervGatewayReleaseDeploy(
         deps,
         prior.repo,
@@ -37401,7 +37517,15 @@ async function runReleaseAbortLocked(deps, options) {
     );
   }
   await requireCleanTree(deps);
-  if (await currentBranch(deps) !== "main") {
+  const ciCheckout = options.ciCheckout === true;
+  if (ciCheckout) {
+    if (!isHubControlRepo(ctx.repo)) {
+      throw new Error(`release --abort: the CI checkout path aborts ${ctx.repo} never; it is for the Hub release workflow only; nothing was written`);
+    }
+    if (!ctx.delegatedActor) {
+      throw new Error("release --abort: the CI checkout path needs the run's proven org-owner trigger (hub release workflow authority); nothing was written");
+    }
+  } else if (await currentBranch(deps) !== "main") {
     throw new Error("release --abort must run from the primary checkout left on main by the failed train; nothing was written");
   }
   await runGitRemoteRead(deps, ["fetch", "origin", "--tags"]);
@@ -37411,7 +37535,7 @@ async function runReleaseAbortLocked(deps, options) {
   const tagSha = await probeRemoteTag(deps, tag);
   if (!tagSha) throw new Error(`release --abort: ${tag} is not on origin; nothing was written`);
   const localTagSha = clean2(await deps.run("git", ["rev-parse", "--verify", `refs/tags/${tag}^{commit}`]));
-  const localMainSha = clean2(await deps.run("git", ["rev-parse", "main"]));
+  const localMainSha = ciCheckout ? tagSha : clean2(await deps.run("git", ["rev-parse", "main"]));
   const originMainSha = clean2(await deps.run("git", ["rev-parse", "origin/main"]));
   if (localTagSha !== tagSha || localMainSha !== tagSha) {
     throw new Error(
@@ -37442,6 +37566,17 @@ async function runReleaseAbortLocked(deps, options) {
     throw new Error(`release --abort: origin still reports ${tag} after deletion; local state was preserved`);
   }
   await deps.run("git", ["tag", "-d", tag]);
+  if (ciCheckout) {
+    const ciLedgerNote = await clearReleaseLedger(process.cwd(), { repo: ctx.repo, tag, tagSha });
+    return {
+      command: "release-abort",
+      repo: ctx.repo,
+      tag,
+      tagSha,
+      restoredMainSha: originMainSha,
+      note: `removed the unpublished ${tag} candidate from the Hub release workflow; destructive approval: @${ctx.delegatedActor} triggered this run and is a proven active org owner; origin/main stays ${originMainSha.slice(0, 12)}; repair development before recutting` + (ciLedgerNote ? `; ${ciLedgerNote}` : "")
+    };
+  }
   await deps.run("git", ["checkout", "development"]);
   await ffOnlyPull(deps, "development");
   await deps.run("git", ["branch", "-f", "main", "origin/main"]);
@@ -40783,7 +40918,7 @@ function registerBoardCommands(program3) {
     return `Claimed ${ref} for ${holder} - In Progress${reclaimed}`;
   }
   const board = program3.command("board").description("read, claim, show, and move Project v2 work items for the current repo");
-  board.command("read", { isDefault: true }).alias("list").description("read the board and print user-owned, claimable, and taken items").option("--json", "machine-readable output").option("--repo <owner/repo>", "current repo (defaults to git origin)").option("--direct", "bypass the Hub snapshot and read the live board through direct GitHub GraphQL").option("--snapshot-only", "never fall back to your personal GraphQL pool; failure exits: 20 hub-unreachable, 21 app-quota-exhausted, 22 refused. With --json, stdout is {ok:false,outcome,reason[,resetAt,pool]} (pool is rest or graphql when known); success is unchanged").option("--min-cursor <n>", "board-event cursor (from `oracle board events`) the Hub snapshot must postdate; a cached snapshot older than that event is rebuilt (#7240)").option("--bundle-details", "fetch body/comments only for user-owned and claimable issues").option("--bodies", "fetch body/comments for EVERY scoped row, including taken and unowned in-flight ones \u2014 for consumers that scope by Status rather than ownership (#4861); implies --bundle-details and costs one extra read per row").option("--allow-partial", "return partial board results when later page/detail reads fail").option("--out <path>", "write the output to this file as UTF-8 (no BOM) instead of stdout \u2014 the shell-free receipt path (#5802)").addHelpText("after", "\nread is always the authoritative live GitHub Project v2 board (#4926).\n--direct skips the Hub snapshot and uses the existing direct GitHub GraphQL read immediately.\n--allow-partial applies to the paginated path and detail reads.\n\nWhen using Windows PowerShell 5.1, avoid shell redirects: PowerShell 5.1's `> file.json` is Out-File,\nwhich writes UTF-16LE with a BOM, and Node reading it as 'utf8' then fails JSON.parse at position 1\n(#5802). Use --out instead \u2014 the CLI writes the file itself as UTF-8:\n  mmi-cli oracle board read --json --out .jerv/tmp/board.json\n").action((o) => runBoardRead(o));
+  board.command("read", { isDefault: true }).alias("list").description("read the board and print user-owned, claimable, and taken items").option("--json", "machine-readable output").option("--repo <owner/repo>", "current repo (defaults to git origin)").option("--direct", "bypass the Hub snapshot and read the live board through direct GitHub GraphQL").option("--snapshot-only", "never fall back to your personal GraphQL pool; failure exits: 20 hub-unreachable, 21 app-quota-exhausted, 22 refused. With --json, stdout is {ok:false,outcome,reason[,resetAt,pool]} (pool is rest or graphql when known) and the human-readable reason goes to stderr; success is unchanged").option("--min-cursor <n>", "board-event cursor (from `oracle board events`) the Hub snapshot must postdate; a cached snapshot older than that event is rebuilt (#7240)").option("--bundle-details", "fetch body/comments only for user-owned and claimable issues").option("--bodies", "fetch body/comments for EVERY scoped row, including taken and unowned in-flight ones \u2014 for consumers that scope by Status rather than ownership (#4861); implies --bundle-details and costs one extra read per row").option("--allow-partial", "return partial board results when later page/detail reads fail").option("--out <path>", "write the output to this file as UTF-8 (no BOM) instead of stdout \u2014 the shell-free receipt path (#5802)").addHelpText("after", "\nread is always the authoritative live GitHub Project v2 board (#4926).\n--direct skips the Hub snapshot and uses the existing direct GitHub GraphQL read immediately.\n--allow-partial applies to the paginated path and detail reads.\n\nWhen using Windows PowerShell 5.1, avoid shell redirects: PowerShell 5.1's `> file.json` is Out-File,\nwhich writes UTF-16LE with a BOM, and Node reading it as 'utf8' then fails JSON.parse at position 1\n(#5802). Use --out instead \u2014 the CLI writes the file itself as UTF-8:\n  mmi-cli oracle board read --json --out .jerv/tmp/board.json\n\nUnder --json, parse stdout ONLY and check the exit code first. A failure still prints a\nhuman-readable reason on stderr, so never pipe 2>&1 into a JSON parser (#9151) \u2014 the merged\ntext is not JSON and hides the real board failure.\n").action((o) => runBoardRead(o));
   board.command("events").description("content-free board/CI change records after a cursor, from the Hub event feed (no GitHub call) \u2014 for real-time sidebars (#7235)").option("--since <cursor>", "cursor from the previous answer; omit on first read (answers the head cursor with resync:true)").option("--wait <seconds>", "hold up to this long (max 120), polling every 2s, and return on the first event or resync", "0").option("--repo <owner/repo>", "repo whose Hub config to use (defaults to git origin)").option("--json", "machine-readable output (already the default)").addHelpText("after", "\nPrints {cursor, events, resync, more[, hidden]}. Pass the returned cursor as the next --since.\nresync:true means records were missed (retention ~1h, or a gap): re-read the board with\n`mmi-cli oracle board read --snapshot-only --json`.\n").action(async (o) => {
     try {
       if (o.since !== void 0 && !/^\d{1,15}$/.test(o.since)) throw new Error("--since must be a non-negative integer cursor");
@@ -43003,7 +43138,7 @@ function registerSecretsCommands(program3) {
       }
       const { keys, command, ...o } = parsed.value;
       const code = secretsUseExitCode(await secretsUse(d, keys, { ...o, command }));
-      if (code !== void 0) process.exitCode = code;
+      if (code !== void 0) process.exitCode = lastHubAuthFailure()?.exitCode ?? code;
     });
   });
   withDeclaredOptions(
@@ -49623,15 +49758,40 @@ var PR_LAND_STATE_READ_RETRIES = 3;
 var PR_LAND_STATE_READ_DELAY_MS = 15e3;
 var PR_LAND_MERGE_RETRY_DELAY_MS = 3e4;
 async function mergeAutoWithTransientRetry(prNumber, repo, deps) {
-  const first = await deps.mergeAuto(prNumber, repo);
-  if (first.mergeStatus !== "failed") return first;
-  const ready = await deps.probeMergeReady(prNumber, repo).catch(() => ({ open: false, mergeable: false, checksPassing: false }));
-  if (!ready.open || !ready.mergeable || !ready.checksPassing) return first;
+  const now = deps.now ?? (() => Date.now());
+  const deadline = now() + PR_LAND_ENQUEUE_TIMEOUT_MS;
   const sleep2 = deps.sleep ?? ((ms) => new Promise((resolve7) => setTimeout(resolve7, ms)));
-  await sleep2(PR_LAND_MERGE_RETRY_DELAY_MS);
-  const retried = await deps.mergeAuto(prNumber, repo);
-  if (retried.mergeStatus !== "failed") return retried;
-  return { mergeStatus: "failed", error: `merge retry after transient failure also failed: ${retried.error ?? first.error ?? "unknown error"}` };
+  const first = await deps.mergeAuto(prNumber, repo);
+  let result = first;
+  let transientRetried = false;
+  while (result.mergeStatus === "failed") {
+    const ready = await deps.probeMergeReady(prNumber, repo).catch(() => ({ open: false, mergeable: false, checksPassing: false, checksPending: false }));
+    if (ready.open && ready.checksPending) {
+      if (now() >= deadline) break;
+      await sleep2(Math.min(PR_LAND_POLL_MS, deadline - now()));
+      if (now() >= deadline) break;
+      const checks = await deps.waitForChecks(prNumber, repo, deadline - now());
+      if (checks.status !== "success" && checks.status !== "skipped") {
+        return { mergeStatus: "failed", error: `${result.error ?? "merge failed"}
+registration wait: checks-wait ${checks.status}: ${checks.detail ?? checks.reason ?? "unknown"}` };
+      }
+      if (now() >= deadline) break;
+    } else {
+      if (!ready.open || !ready.mergeable || !ready.checksPassing || transientRetried) return result;
+      transientRetried = true;
+      if (now() >= deadline) break;
+      await sleep2(Math.min(PR_LAND_MERGE_RETRY_DELAY_MS, deadline - now()));
+      if (now() >= deadline) break;
+    }
+    const retried = await deps.mergeAuto(prNumber, repo);
+    result = retried.mergeStatus !== "failed" ? retried : {
+      mergeStatus: "failed",
+      error: `merge retry after transient failure also failed: first attempt: ${first.error ?? "unknown error"}
+retry: ${retried.error ?? "unknown error"}`
+    };
+  }
+  return result.mergeStatus === "failed" ? { ...result, error: `${result.error ?? "merge failed"}
+required-check registration did not settle within the enqueue deadline` } : result;
 }
 var AUTO_MERGE_CONFIRM_RETRIES = 3;
 var AUTO_MERGE_CONFIRM_DELAY_MS = 15e3;
@@ -50025,15 +50185,15 @@ function invisibleTrailer(sha, line) {
   return {
     kind: "malformed-override-trailer",
     paths: [],
-    detail: `OVERRIDE TRAILER GIT CANNOT SEE \u2014 commit ${sha.slice(0, 8)} carries
-    ${line}
-  but \`git log --format='%(trailers:key=${TRAILER_KEY})'\` reports nothing for it, so the waiver would
-  exist only to the regex that granted it. The trailer was chosen over a flag because it can be
-  AUDITED, and a reason the auditor cannot see is not a reason this gate accepts (#3628).
-  Git reads trailers from the LAST paragraph only, and every line of that paragraph must be a
-  trailer or an indented continuation \u2014 one bare line such as \`Closes #123\` disqualifies the whole
-  block. Indent the continuation lines, and leave nothing but trailers in that paragraph.
-  This is fixable forward: push a LATER commit on this branch carrying a well-formed trailer.
+    detail: `OVERRIDE TRAILER GIT CANNOT SEE \u2014 commit ${sha.slice(0, 8)}
+  Recovery (trailer): create a LATER commit on this branch with \`${TRAILER_KEY}: <reason>\`
+  in the final trailer block, separated from the body by a blank line. Use \`Key: value\` lines
+  only in that block; indent continuation lines and keep prose such as \`Closes #123\` above it.
+  Verify: \`git log -1 --format='%(trailers:key=${TRAILER_KEY})' HEAD\` must show the waiver.
+  Then run \`mmi-cli tests policy --json --base origin/development\` from the selected worktree root
+  to refresh its receipt before retrying the focused test. Changing location alone cannot fix this trailer.
+  Rejected line: ${line}
+  Git's trailer parser reports no waiver; a regex-only reason is not git-auditable (#3628).
   The nearest waiver wins, and it supersedes this one \u2014 no force-push, no re-filed branch.`
   };
 }
@@ -50911,9 +51071,8 @@ function ghFailureReason(e) {
   const err = e;
   const head = String(err?.message ?? "").split("\n")[0]?.trim() ?? "";
   const detail = `${err?.stderr ?? ""}
-${err?.stdout ?? ""}`.split("\n").map((line) => line.trim()).find((line) => line.length > 0);
-  if (detail && head) return `${head} \u2014 ${detail}`;
-  return detail || head || "unknown error";
+${err?.stdout ?? ""}`.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+  return (detail && head ? `${head} \u2014 ${detail}` : detail || head || "unknown error").replace(/\x1b\[[0-9;]*m/g, "").replace(/\b(?:gh[pousr]_|github_pat_|AKIA|sk-)[\w-]+/g, "[redacted]").replace(/\b(authorization:\s*)(?:[^\n]*)/gi, "$1[redacted]");
 }
 var defaultGhMergeAutoIo = {
   gh: async (args, timeoutMs) => (await execFileP("gh", args, { timeout: timeoutMs })).stdout
@@ -51066,13 +51225,7 @@ async function mergeAutoEnqueueWithBody(prNumber, args, method, io, bodyFile, me
         error: stateRead.ok ? message2.split("\n")[0] : `could not confirm PR state after local branch cleanup warning: ${stateRead.error}`
       };
     }
-    if (!basePolicyBlocksImmediateMerge(message2)) {
-      return { mergeStatus: "failed", error: ghFailureReason(e) };
-    }
-    return {
-      mergeStatus: "failed",
-      error: `${ghFailureReason(e)} \u2014 auto-merge could not be armed yet (the PR's required checks have not registered); re-run the same --auto merge once they appear`
-    };
+    return { mergeStatus: "failed", error: ghFailureReason(e) };
   }
   return confirmEnqueueOutcome();
 }
@@ -51225,6 +51378,61 @@ function prMergeQueueLine(result) {
 // src/command-register-train-operations.ts
 init_github_client();
 
+// src/hub-release-ci-authority.ts
+var HUB_RELEASE_REPO = "mutmutco/MMI-Hub";
+var HUB_RELEASE_WORKFLOW = ".github/workflows/hub-release.yml";
+var HUB_RELEASE_REF = "refs/heads/development";
+var WORKFLOW_REF = `${HUB_RELEASE_REPO}/${HUB_RELEASE_WORKFLOW}@${HUB_RELEASE_REF}`;
+var LOGIN = /^[A-Za-z0-9-]{1,39}$/;
+var ID = /^[1-9][0-9]*$/;
+function hubReleaseCiRun(env) {
+  if (env.MMI_HUB_RELEASE_CI !== "1" || env.GITHUB_ACTIONS !== "true") return null;
+  if (env.GITHUB_REPOSITORY !== HUB_RELEASE_REPO || env.GITHUB_EVENT_NAME !== "workflow_dispatch") return null;
+  if (env.GITHUB_WORKFLOW_REF !== WORKFLOW_REF || env.GITHUB_REF !== HUB_RELEASE_REF) return null;
+  const runId = env.GITHUB_RUN_ID ?? "";
+  const runAttempt = env.GITHUB_RUN_ATTEMPT ?? "";
+  if (!ID.test(runId) || !ID.test(runAttempt)) return null;
+  return { runId: Number(runId), runAttempt: Number(runAttempt) };
+}
+async function hubReleaseCiAuthority(repo, deps) {
+  const run = hubReleaseCiRun(deps.env);
+  if (!run) return null;
+  const refuse = (check) => ({ ok: false, error: `hub release workflow authority refused: ${check}` });
+  if (repo.toLowerCase() !== HUB_RELEASE_REPO.toLowerCase()) return refuse(`this workflow releases ${HUB_RELEASE_REPO} only`);
+  let live;
+  try {
+    live = await deps.getJson(`repos/${HUB_RELEASE_REPO}/actions/runs/${run.runId}`);
+  } catch (e) {
+    return refuse(`live run read failed (${e instanceof Error ? e.message : String(e)})`);
+  }
+  const login = live?.triggering_actor?.login ?? "";
+  const bound = live?.id === run.runId && live.run_attempt === run.runAttempt && live.status === "in_progress" && live.event === "workflow_dispatch" && live.path === HUB_RELEASE_WORKFLOW && live.head_branch === "development" && live.repository?.full_name === HUB_RELEASE_REPO;
+  if (!bound) return refuse("live run binding");
+  if (live.triggering_actor?.type !== "User" || !LOGIN.test(login)) return refuse("the run was not triggered by a person");
+  let membership;
+  try {
+    membership = await deps.getJson(`orgs/mutmutco/memberships/${login}`);
+  } catch (e) {
+    return refuse(`org membership read for ${login} failed (${e instanceof Error ? e.message : String(e)})`);
+  }
+  if (membership?.role !== "admin" || membership?.state !== "active") return refuse(`${login} is not an active org owner`);
+  return { ok: true, role: "master", train: true, authenticatedDelegation: true, delegatedActor: login };
+}
+var GITHUB_API = "https://api.github.com";
+function pinnedGitHubGetJson(token, fetchImpl = fetch) {
+  return async (path2) => {
+    if (!token) throw new Error("GH_TOKEN is not set in this run");
+    if (!/^[A-Za-z0-9_.\/-]+$/.test(path2) || path2.includes("..")) throw new Error("refusing an unexpected API path");
+    const res = await fetchImpl(`${GITHUB_API}/${path2}`, {
+      headers: { Authorization: `Bearer ${token}`, Accept: "application/vnd.github+json", "X-GitHub-Api-Version": "2022-11-28" },
+      signal: AbortSignal.timeout(15e3)
+    });
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    return res.json();
+  };
+}
+var HUB_RELEASE_CI_ANNOUNCE_DEFERRED = "announcement deferred: the Hub cannot authorize a release-workflow session to post yet (#9138); the curated summary is in this run's step summary";
+
 // src/project-info-sync.ts
 var import_node_fs38 = require("node:fs");
 var import_node_path36 = require("node:path");
@@ -56773,9 +56981,10 @@ ${list}`);
         },
         fetchTrainAuthority: async (repo) => fetchTrainAuthority(repo, registryClientDeps(await loadConfig())),
         resolveCiPolicy: (repo) => resolveRepoMergeCiPolicy(repo, ciAuditDeps()),
-        waitForChecks: async (prNumber, repo) => {
+        waitForChecks: async (prNumber, repo, timeoutMs) => {
           const requiredContexts = await fetchRequiredCheckContexts(repo, "development").catch(() => null);
           return waitForPrChecks({
+            timeoutMs,
             resolvePolicy: () => resolveRepoMergeCiPolicy(repo, ciAuditDeps()),
             // #3024: REST-only wait loop — runPrLand's resolveRepo already guarantees `repo` is set.
             pollChecks: () => pollRestPrChecks(prNumber, repo, void 0, requiredContexts),
@@ -56817,7 +57026,8 @@ ${list}`);
           return {
             open: snapshot?.state === "open",
             mergeable: snapshot?.mergeable === "MERGEABLE",
-            checksPassing: checks === "success" || checks === "no-checks-reported"
+            checksPassing: checks === "success",
+            checksPending: checks === "pending" || checks === "failing" || checks === "no-checks-reported"
           };
         },
         readPrState: async (prNumber, repo) => {
@@ -56839,21 +57049,21 @@ ${list}`);
         // #8456: a pinned land has no update lane at all.
         ...o.expectHead ? {} : { updateBranch: (prNumber, repo) => prLandUpdateBranch(prNumber, repo, Boolean(o.repo)) },
         pollMerged: async (prNumber, repo, deadlineMs) => {
-          let lastFailure;
+          let lastFailure2;
           while (Date.now() < deadlineMs) {
             const read = await pollRestPrMerged(prNumber, repo);
             if (read.state === "merged") return true;
             if (read.state === "failed") {
-              lastFailure = read.error;
+              lastFailure2 = read.error;
               console.warn(`pr land: merged-state read FAILED (${read.error}) \u2014 retrying; this is not evidence the PR is unmerged`);
             } else {
-              lastFailure = void 0;
+              lastFailure2 = void 0;
             }
             await new Promise((resolve7) => setTimeout(resolve7, PR_LAND_POLL_MS));
           }
-          if (lastFailure) {
+          if (lastFailure2) {
             throw new Error(
-              `pr land: could not verify whether PR #${prNumber} merged \u2014 the last merged-state read FAILED (${lastFailure}). The auto-merge enqueue stands; read the PR directly (gh pr view ${prNumber} --repo ${repo} --json merged,state) and rerun cleanup if it merged.`
+              `pr land: could not verify whether PR #${prNumber} merged \u2014 the last merged-state read FAILED (${lastFailure2}). The auto-merge enqueue stands; read the PR directly (gh pr view ${prNumber} --repo ${repo} --json merged,state) and rerun cleanup if it merged.`
             );
           }
           return false;
@@ -57516,6 +57726,8 @@ function trainApplyDeps() {
     // parses, so the ONE self-spawn seam derives the prefix through the same rule the refusal names.
     runSelf: async (args) => (await execFileP(process.execPath, [process.argv[1], ...canonicalArgvFor(args)], { timeout: 3e4 })).stdout,
     trainAuthority: async (repo) => {
+      const ci2 = await hubReleaseCiAuthority(repo, { env: process.env, getJson: pinnedGitHubGetJson(process.env.GH_TOKEN) });
+      if (ci2) return ci2;
       const verdict = await fetchTrainAuthority(repo, registryClientDeps(await loadConfig()));
       return verdict.ok ? {
         ok: true,
@@ -57586,6 +57798,7 @@ function trainApplyDeps() {
         return (await execFileP(file, cmdArgs, { timeout: GH_TRAIN_TIMEOUT_MS, ...env ? { env } : {} })).stdout;
       },
       postAnnouncement: async (payload) => {
+        if (hubReleaseCiRun(process.env)) throw new Error(HUB_RELEASE_CI_ANNOUNCE_DEFERRED);
         const res = await releaseAnnouncement(payload, registryClientDeps(await loadConfig()));
         const body = res.body;
         if (!res.ok) throw new Error(body?.error ?? `Hub announcement failed (HTTP ${res.status}); verify delivery before retrying`);
@@ -57669,11 +57882,13 @@ function renderReleaseSupersedeDeploy(r) {
 }
 function renderReleaseSupersedePublish(r) {
   const base = `mmi-cli devops release --supersede-publish --apply: ${r.repo} ${r.tag} (${r.tagSha.slice(0, 12)}) \u2014 ${r.note}`;
-  return r.gatewayDeploy ? `${base}; the deferred Jerv Gateway operator-host deploy leg was run and verified during the supersession (jerv-gateway=complete): ${r.gatewayDeploy.note}` : base;
+  if (!r.gatewayDeploy) return base;
+  return r.gatewayDeploy.state === "skipped" ? `${base}; the deferred Jerv Gateway operator-host deploy leg was SKIPPED because the failed publish never produced an installer payload (jerv-gateway=skipped, superseded): ${r.gatewayDeploy.note}` : `${base}; the deferred Jerv Gateway operator-host deploy leg was run and verified during the supersession (jerv-gateway=complete): ${r.gatewayDeploy.note}`;
 }
 function renderReleaseSupersedeDeployAndPublish(r) {
   const base = `mmi-cli devops release --supersede-deploy --supersede-publish --apply: ${r.repo} ${r.tag} (${r.tagSha.slice(0, 12)}) \u2014 ${r.note}`;
-  return r.gatewayDeploy ? `${base}; the deferred Jerv Gateway operator-host deploy leg was run and verified during the closure (jerv-gateway=complete): ${r.gatewayDeploy.note}` : base;
+  if (!r.gatewayDeploy) return base;
+  return r.gatewayDeploy.state === "skipped" ? `${base}; the deferred Jerv Gateway operator-host deploy leg was SKIPPED because the failed publish never produced an installer payload (jerv-gateway=skipped, superseded): ${r.gatewayDeploy.note}` : `${base}; the deferred Jerv Gateway operator-host deploy leg was run and verified during the closure (jerv-gateway=complete): ${r.gatewayDeploy.note}`;
 }
 function renderReleasePublishRetry(r) {
   return `mmi-cli devops release --retry-publish: ${r.repo} ${r.tag} (${r.tagSha.slice(0, 12)}) \u2014 ${r.note}; ${r.runUrl}`;
@@ -58095,7 +58310,7 @@ function registerTrainOperationsCommands(program3, runProjectInfoSyncCallback) {
           if (!guard.ok) return fail(`release: ${guard.message}`);
         }
         try {
-          const result = await runReleaseAbort(trainApplyDeps(), { approved: true });
+          const result = await runReleaseAbort(trainApplyDeps(), { approved: true, ciCheckout: hubReleaseCiRun(process.env) !== null });
           return emitTrainResult("release --abort", o.json ? JSON.stringify(result, null, 2) : renderReleaseAbort(result), o.out);
         } catch (e) {
           return failGraceful(`release --abort: ${e.message}`);
@@ -60559,29 +60774,23 @@ var surfaces_default = {
       ]
     },
     {
-      token: "hermes",
-      displayName: "Hermes Agent",
+      token: "openbot",
+      displayName: "OpenBot",
       lifecycle: "active",
       artifactIds: [
-        "mmi-hermes-plugin",
+        "mmi-openbot-plugin",
         "mmi-skills",
         "mmi-cli"
       ],
       plannedArtifactIds: [],
       assembly: {
-        mode: "package-directory",
-        rootPath: "packages/hermes-plugin",
-        sync: [
-          {
-            mode: "directories",
-            sourcePath: "skills",
-            targetPath: "packages/hermes-plugin/skills"
-          }
-        ]
+        mode: "source-tree",
+        rootPath: ".pi-plugin",
+        sync: []
       },
       install: {
         mechanism: "npm",
-        locator: "@mutmutco/hermes-plugin (npm transport; MMI-Hub extracts the package into $HERMES_HOME/plugins/mmi)"
+        locator: "@mutmutco/pi-plugin (npm transport; MMI-Hub extracts its skills into each OpenBot agent workspace at <home>/OpenBot/Agents/agent-<uuid>/.agents/skills)"
       },
       upgrade: {
         mechanism: "package-manager",
@@ -60590,10 +60799,10 @@ var surfaces_default = {
       skills: {
         delivery: "provisioned",
         sourceSurfaceId: "mmi-skills",
-        artifactId: "mmi-hermes-plugin",
+        artifactId: "mmi-skills",
         invocation: {
-          entry: "/epic",
-          any: "skill_view(name='<skill>')"
+          entry: "use the epic skill",
+          any: "use the <skill> skill"
         }
       },
       cli: {
@@ -60606,20 +60815,19 @@ var surfaces_default = {
         repair: "mmi-hub"
       },
       certification: {
-        hostCommand: "hermes",
-        versionArgs: [
-          "--version"
-        ]
+        hostProbe: "none",
+        hostCommand: null,
+        versionArgs: []
       },
       compatibility: {
-        hostVersion: "0.20.1",
-        certification: "Hermes Agent v0.20.1 release v2026.8.13, upstream f80f453ae0679347e38abc917c7f94f717bf96c5 (#5053)"
+        hostVersion: "0.53.2",
+        certification: "OpenBot desktop 0.53.2 ships no host CLI: surface presence is the agent workspace root (<home>/OpenBot/Agents/agent-*), never a --version probe"
       },
       enforcementCeilings: [
-        "MMI ships no Hermes hooks (#5908): the plugin contributes skills and the /mmi command only; enforcement is host-side.",
-        "Hermes user plugins are opt-in through plugins.enabled (#6656): after a verified converge MMI-Hub enables its OWN mmi key through Hermes' own `hermes plugins enable mmi --no-allow-tool-override` command, and never reads, reorders, or writes another operator entry. Built-in tool override is explicitly declined, since MMI ships no Hermes hooks. Host process isolation remains Hermes-owned.",
-        "npm is MMI transport only: MMI-Hub extracts @mutmutco/hermes-plugin into $HERMES_HOME/plugins/mmi and provisions the canonical skills into $HERMES_HOME/skills/mmi/; a fresh Hermes Agent process is required for discovery.",
-        "Every Hermes home is covered per home (#6672): a profile under $HERMES_HOME/profiles/<name> is a full sibling home and Hermes scans only the active home's plugins/, so MMI-Hub repeats the same single-home install, skills provisioning, and host-command enable in the resolved home and in each profile home with HERMES_HOME bound to it. No profile is enumerated for any other purpose, and nothing outside those per-home MMI paths is read or written."
+        "OpenBot ships no MMI hooks: this surface contributes the provisioned skills and a standalone mmi-cli only; enforcement is host-side.",
+        "OpenBot's agent registry (%APPDATA%/OpenBot/openbot.db) is event-sourced and host-owned: MMI-Hub never reads or writes it, and enumerates agent workspaces by directory instead.",
+        "OpenBot agent shells inherit the user PATH, so the standalone mmi-cli resolves; MMI provisions the skill payload, never the shell environment. OpenBot exports no identifying variable: mmi-cli recognizes an OpenBot session by a working directory inside <home>/OpenBot/Agents/agent-<uuid> (or an explicit MMI_AGENT_SURFACE=openbot), and a session working elsewhere is classified by its runtime.",
+        "Every Agent workspace holds its own skills tree: MMI-Hub writes only <workspace>/.agents/skills/<skill> folders it recorded in .agents/skills/.mmi-managed.json, and never .claude/skills, an unrecorded folder, or a skill it does not own."
       ]
     }
   ],
@@ -60983,41 +61191,36 @@ var surfaces_default = {
       publishVisibility: "public"
     },
     {
-      id: "mmi-hermes-plugin",
+      id: "mmi-openbot-plugin",
       classification: "packaging",
       kind: "plugin",
-      ownerPath: "packages/hermes-plugin/package.json",
-      deliveryPath: "packages/hermes-plugin/package.json",
+      ownerPath: ".pi-plugin/package.json",
+      deliveryPath: ".pi-plugin/package.json",
       delivery: "npm",
-      applicability: "Hermes Agent native directory plugin transported as npm package @mutmutco/hermes-plugin; MMI-Hub extracts its package bytes into $HERMES_HOME/plugins/mmi, where Hermes v0.20.1 discovers it as an enabled user plugin.",
+      applicability: "OpenBot desktop agent workspaces; the SAME npm package as JervCode (@mutmutco/pi-plugin, surfaceToken jervcode) re-declared as OpenBot's transport so the registry can name a token-owned plugin artifact for a host that has no CLI of its own. No OpenBot-specific package exists or is planned.",
       versionCoordinated: true,
-      surfaceToken: "hermes",
+      surfaceToken: "openbot",
       versionPaths: [
         {
-          path: "packages/hermes-plugin/package.json",
-          pointer: "version"
-        },
-        {
-          path: "packages/hermes-plugin/plugin.yaml",
+          path: ".pi-plugin/package.json",
           pointer: "version"
         }
       ],
       additionalPaths: [
-        "packages/hermes-plugin/plugin.yaml",
-        "packages/hermes-plugin/__init__.py",
-        "packages/hermes-plugin/skills"
+        ".pi-plugin/skills"
       ],
       artifactIdentity: {
         kind: "npm-pack",
-        packagePath: "packages/hermes-plugin"
+        packagePath: ".pi-plugin"
       },
-      publishVisibility: "public"
+      publishVisibility: "n/a"
     }
   ]
 };
 
 // src/surface-doctor.ts
-var TOKENS = /* @__PURE__ */ new Set(["claude", "codex", "jervcode", "hermes"]);
+var TOKENS = /* @__PURE__ */ new Set(["claude", "codex", "jervcode", "openbot"]);
+var FRESH_PROCESS_SURFACES = /* @__PURE__ */ new Set(["openbot"]);
 function isActiveToken(value) {
   return TOKENS.has(value);
 }
@@ -61068,7 +61271,7 @@ function diagnoseSurface(evidence) {
   return { ...base, state: "clean" };
 }
 function reloadInstruction(descriptor) {
-  if (descriptor.token === "hermes") return "start a fresh Hermes Agent process";
+  if (descriptor.token === "openbot") return "start a fresh OpenBot agent run";
   const verb = descriptor.reload === "workspace" ? "reload" : "restart";
   return `${verb} ${descriptor.displayName}`;
 }
@@ -61080,7 +61283,7 @@ function planSurfaceRepair(diagnosis) {
       supported: false,
       owner: "mmi-hub",
       changes: [],
-      // #5833: name the SURFACE this row is about — the literal "Hermes plugin" sent every other
+      // #5833: name the SURFACE this row is about — a hard-coded host name sent every other
       // mmi-hub-owned surface (Claude Code included) chasing a different host that was already current.
       instruction: `run \`mmi-hub update\` to converge the MMI-managed ${descriptor.displayName} plugin, then ${reloadInstruction(descriptor)}`
     };
@@ -61108,9 +61311,9 @@ function buildSurfaceDoctorCheck(diagnosis) {
   const detailByState = {
     skipped: "skipped \u2014 host not active",
     clean: diagnosis.repairDetail ? `clean \u2014 repaired and verified (${diagnosis.repairDetail})` : `clean${versions ? ` \u2014 ${versions}` : ""}`,
-    "pending-reload": `pending ${descriptor.token === "hermes" ? "fresh process" : descriptor.reload === "workspace" ? "reload" : "restart"} \u2014 repaired to ${diagnosis.releasedVersion}, but ${diagnosis.installedVersion} is still the version this host has loaded${diagnosis.repairDetail ? ` (${diagnosis.repairDetail})` : ""}`,
+    "pending-reload": `pending ${FRESH_PROCESS_SURFACES.has(descriptor.token) ? "fresh process" : descriptor.reload === "workspace" ? "reload" : "restart"} \u2014 repaired to ${diagnosis.releasedVersion}, but ${diagnosis.installedVersion} is still the version this host has loaded${diagnosis.repairDetail ? ` (${diagnosis.repairDetail})` : ""}`,
     // #5833: the update already staged the released tree; the wording mirrors `mmi-hub status`.
-    staged: `loaded ${diagnosis.installedVersion}; staged ${diagnosis.releasedVersion} for next launch \u2014 ${descriptor.token === "hermes" ? "start a fresh process" : descriptor.reload === "workspace" ? "reload" : "restart"} ${descriptor.displayName} to converge`,
+    staged: `loaded ${diagnosis.installedVersion}; staged ${diagnosis.releasedVersion} for next launch \u2014 ${FRESH_PROCESS_SURFACES.has(descriptor.token) ? "start a fresh process" : descriptor.reload === "workspace" ? "reload" : "restart"} ${descriptor.displayName} to converge`,
     "freshness-unknown": `${diagnosis.installedVersion ?? "installed"} \u2014 freshness UNKNOWN, the published version could not be read`,
     stale: `stale${versions ? ` \u2014 ${versions}` : ""}`,
     missing: "missing \u2014 no install record",
@@ -62656,8 +62859,17 @@ function buildRunWatchSpec(id, o) {
   const timeoutMin = o.timeoutMin !== void 0 ? parseBrokerInt(o.timeoutMin, "--timeout", 1, 120) : 30;
   return { program: "gh", args, timeoutMs: timeoutMin * 6e4 };
 }
+function rejectPrViewQueueFields(fields, number) {
+  if (!fields || !fields.split(",").includes("mergeQueueEntry")) return;
+  throw new Error(
+    `read pr view: 'mergeQueueEntry' is not a gh pr view --json field \u2014 read the merge queue with \`mmi-cli devops read pr queue ${number} --repo <owner/repo> --json\` and drop it from --json`
+  );
+}
 function buildPrViewSpec(ref, o) {
-  const args = withJson(withRepo(["pr", "view", parseBrokerId(ref, "PR number")], parseBrokerRepo(o.repo, "--repo")), parseBrokerJsonFields(o.json), o.json);
+  const number = parseBrokerId(ref, "PR number");
+  const jsonFields = parseBrokerJsonFields(o.json);
+  rejectPrViewQueueFields(jsonFields, number);
+  const args = withJson(withRepo(["pr", "view", number], parseBrokerRepo(o.repo, "--repo")), jsonFields, o.json);
   if (o.comments) args.push("--comments");
   return { program: "gh", args, timeoutMs: SINGLE_SHOT_TIMEOUT_MS };
 }
@@ -62730,21 +62942,50 @@ function ghExitCodeOf(error) {
   const code = error.code;
   return typeof code === "number" ? code : null;
 }
+function brokerGhFailureHint(failureText, args) {
+  const target = args[0] === "pr" && args[1] === "view" ? args[2] : void 0;
+  const unknownField = /Unknown JSON field: "([^"]+)"/.exec(failureText)?.[1] ?? /Unknown JSON field: ([A-Za-z][A-Za-z0-9]*)/.exec(failureText)?.[1];
+  if (unknownField === "mergeQueueEntry") {
+    return `'mergeQueueEntry' is not a gh pr view --json field \u2014 read the merge queue with \`mmi-cli devops read pr queue ${target ?? "<number>"} --repo <owner/repo> --json\` and drop it from --json; repeating this read cannot succeed`;
+  }
+  if (unknownField) {
+    return `gh rejected --json field '${unknownField}' \u2014 drop it or use the typed read whose fields cover it (the "Available fields" list gh printed is its own vocabulary)`;
+  }
+  if (/Could not resolve to a PullRequest/i.test(failureText)) {
+    return `GitHub could not resolve the PR${target ? ` #${target}` : ""} \u2014 verify the number and that --repo names the repo that owns it before retrying; an identical re-run fails the same way`;
+  }
+  return void 0;
+}
 async function runBrokerGh(run, spec, write = (chunk) => process.stdout.write(chunk)) {
   const env = brokerChildEnv();
+  let output;
   try {
-    write(redactPrivateCredential(await run(spec.args, { timeoutMs: spec.timeoutMs, env }), env));
-    return 0;
+    output = redactPrivateCredential(await run(spec.args, { timeoutMs: spec.timeoutMs, env }), env);
   } catch (e) {
     const err = e;
     if (typeof err.stdout === "string" && err.stdout) process.stderr.write(redactPrivateCredential(err.stdout, env));
     const code = ghExitCodeOf(e);
     if (code !== null) {
       if (typeof err.stderr === "string" && err.stderr) process.stderr.write(redactPrivateCredential(err.stderr, env));
+      const failure = `${typeof err.stdout === "string" ? err.stdout : ""}${typeof err.stderr === "string" ? err.stderr : ""}`;
+      const recovery = brokerGhFailureHint(failure, spec.args) ?? "inspect stderr; retry the same typed read and only parse stdout after success";
+      process.stderr.write(`read: gh ${spec.args.slice(0, 2).join(" ")} failed on the App pool (exit ${code}) \u2014 ${recovery}
+`);
       return code;
     }
     throw new Error(`read: gh ${spec.args.slice(0, 2).join(" ")} did not finish on the App pool (${err.message ?? e}) \u2014 re-run the same command to refresh (same custody); reads never fall back to personal`);
   }
+  if (spec.args.includes("--json")) {
+    try {
+      JSON.parse(output);
+    } catch {
+      process.stderr.write(`read: gh ${spec.args.slice(0, 2).join(" ")} returned ${output.trim() ? "invalid" : "empty"} JSON on the App pool \u2014 retry the same typed read; only parse stdout after success
+`);
+      return 1;
+    }
+  }
+  write(output);
+  return 0;
 }
 async function runBrokerRestChecks(deps, spec, resolveRepo2) {
   const repo = await resolveRepo2(spec.repo);
@@ -63032,11 +63273,33 @@ var RELEASE_TAG_RE = new RegExp(`^repos/${NAME}/${NAME}/releases/tags/(${NAME})$
 var RELEASE_ASSET_RE = new RegExp(`^repos/${NAME}/${NAME}/releases/assets/\\d+$`);
 var API_GET_ALLOWED_SHAPES = "repos/{owner}/{repo}/pulls/{n}/files, repos/{owner}/{repo}/compare/{a}...{b}, repos/{owner}/{repo}/contents/{path}[?ref=<branch>], repos/{owner}/{repo}/actions/runs[?per_page=1-100&page=<n>&status=&branch=&event=&head_sha=<40-hex>&created=<date-range>&actor=, each key at most once], repos/{owner}/{repo}/actions/runs/{id}, repos/{owner}/{repo}/actions/runs/{id}/jobs, repos/{owner}/{repo}/actions/runs/{id}/attempts/{n}/jobs, repos/{owner}/{repo}/actions/runs/{id}/artifacts, repos/{owner}/{repo}/actions/artifacts/{id}/zip (needs --out <file>), repos/{owner}/{repo}/actions/jobs/{id}/logs (needs --out <file>), repos/{owner}/{repo}/releases[?per_page=1-100&page=<n>, each key at most once], repos/{owner}/{repo}/releases/latest, repos/{owner}/{repo}/releases/tags/{tag}, repos/{owner}/{repo}/releases/assets/{id} (needs --out <file>)";
 var API_GET_RECOVERY = " No other GET read exists \u2014 do not retry path variants; use a dedicated mmi-cli subcommand or ask a human token holder. This refusal exits 1 on stderr with nothing on stdout: check the exit code and never merge stderr into stdout (2>&1) before JSON-parsing.";
+var TYPED_READ_ROUTE_RE = new RegExp(`^repos/(${NAME})/(${NAME})/(issues|pulls)(?:/(comments/\\d+|\\d+)(?:/([a-z_]+))?)?$`);
+function typedReadHint(path2) {
+  const match = TYPED_READ_ROUTE_RE.exec(path2.split("?")[0]);
+  if (!match) return "";
+  const [, owner, repo, kind, item, sub] = match;
+  const slug = `${owner}/${repo}`;
+  const say = (command, note = "") => ` Typed read for this route: \`${command}\`${note}.`;
+  if (kind === "issues") {
+    if (!item) return say(`mmi-cli devops read issue list --repo ${slug} --json number,title,state,labels`);
+    if (item.startsWith("comments/")) {
+      const id = item.slice("comments/".length);
+      return say(`mmi-cli devops read issue view <issue> --repo ${slug} --json comments`, `; a comment is read through its issue, so match the comment whose url ends in issuecomment-${id}`);
+    }
+    if (sub === "events" || sub === "timeline") {
+      return say(`mmi-cli devops read issue view ${item} --repo ${slug} --json state,stateReason,closedAt,labels,assignees,comments`, "; the raw event/timeline history itself has no read");
+    }
+    return say(`mmi-cli devops read issue view ${item} --repo ${slug} --json title,body,state,labels,comments`);
+  }
+  if (!item) return say(`mmi-cli devops read pr list --repo ${slug} --json number,title,state,headRefName`);
+  if (item.startsWith("comments/")) return say(`mmi-cli devops read pr view <pr> --repo ${slug} --json comments,reviews`);
+  return say(`mmi-cli devops read pr view ${item} --repo ${slug} --json title,state,comments,reviews,commits,statusCheckRollup`);
+}
 function parseApiGetPath(rawPath) {
   const path2 = rawPath.trim();
   const refuse = () => {
     const hint = /^[A-Za-z]:[/\\]/.test(path2) ? " Git Bash/MSYS may have rewritten a leading-slash argument; retry with MSYS_NO_PATHCONV=1 and the slash-free repos/... path. The endpoint must still be allowlisted." : "";
-    return new Error(`api get: refusing '${rawPath}' \u2014 only these GET reads are allowed (#7219): ${API_GET_ALLOWED_SHAPES}.${API_GET_RECOVERY}${hint}`);
+    return new Error(`api get: refusing '${rawPath}' \u2014 only these GET reads are allowed (#7219): ${API_GET_ALLOWED_SHAPES}.${API_GET_RECOVERY}${typedReadHint(path2)}${hint}`);
   };
   if (/[%#\\]/.test(path2) || path2.split("?")[0].split("/").some((seg) => seg === "." || seg === ".." || seg === "")) throw refuse();
   const q = path2.indexOf("?");
@@ -65737,22 +66000,23 @@ function mmiDoctorDeps(opts = {}) {
     if (!token || token === "opencode") return void 0;
     const descriptor = doctorSurface(token);
     const snapshot = snapshotPluginGuardInput(runtimeSurface, isOrgRepo);
-    const hermes = token === "hermes" ? readHermesPluginEvidence(process.env) : void 0;
-    const installedVersion = hermes?.installedVersion ?? installedSurfacePluginVersion(runtimeSurface);
+    const native = token === "openbot" ? readOpenBotPluginEvidence(process.env) : void 0;
+    const installedVersion = native?.installedVersion ?? installedSurfacePluginVersion(runtimeSurface);
     const stagedVersion = token === "claude" ? stagedClaudePluginVersion() : void 0;
     surfaceEvidence = {
       descriptor,
-      // Hermes' root is the host evidence: a configured but uninstalled MMI tree is missing, while an
-      // absent root is skipped. Other mature surfaces retain their established org/install applicability.
-      applicable: hermes ? hermes.hostPresent : isOrgRepo || snapshot.installRecordPresent || snapshot.pluginCachePresent,
-      installRecordPresent: hermes?.installRecordPresent ?? snapshot.installRecordPresent,
-      deliveryPresent: hermes ? hermes.installRecordPresent : snapshot.marketplaceClonePresent,
-      payloadPresent: hermes?.payloadPresent ?? snapshot.pluginCachePresent,
-      manifest: hermes?.manifest ?? (installedVersion ? "valid" : snapshot.installRecordPresent ? "invalid" : "missing"),
+      // A native evidence reader IS the host evidence: a configured but uninstalled MMI tree is missing,
+      // while an absent root is skipped. Other mature surfaces retain their established org/install
+      // applicability.
+      applicable: native ? native.hostPresent : isOrgRepo || snapshot.installRecordPresent || snapshot.pluginCachePresent,
+      installRecordPresent: native?.installRecordPresent ?? snapshot.installRecordPresent,
+      deliveryPresent: native ? native.installRecordPresent : snapshot.marketplaceClonePresent,
+      payloadPresent: native?.payloadPresent ?? snapshot.pluginCachePresent,
+      manifest: native?.manifest ?? (installedVersion ? "valid" : snapshot.installRecordPresent ? "invalid" : "missing"),
       guardState: buildPluginGuardDecision(snapshot).state,
       ...installedVersion ? { installedVersion } : {},
       ...stagedVersion ? { stagedVersion } : {},
-      ...hermes?.receipt ? { receipt: hermes.receipt } : {}
+      ...native?.receipt ? { receipt: native.receipt } : {}
     };
     return surfaceEvidence;
   };

package/dist/runbook-sweep.cjs

@@ -8640,6 +8640,7 @@ init_error_codes();
 
 // src/secrets-transport.ts
 init_client_version();
+init_hub_auth();
 var KEY_MAX_PATH_SEGMENTS = 4;
 var KEY_RE = new RegExp(`^(?:[a-z0-9][a-z0-9-]*/){0,${KEY_MAX_PATH_SEGMENTS}}[A-Za-z][A-Za-z0-9_]*$`);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "4.5.226",
+  "version": "4.5.228",
   "description": "MMI Future CLI — the org dev toolbox and shared cross-IDE engine for every registry-declared MMI coding surface.",
   "type": "module",
   "license": "UNLICENSED",