metheus-governance-mcp-cli 0.2.73 → 0.2.74

package/README.md

@@ -247,8 +247,8 @@ Behavior:
   - `AI_PERMISSION_MODE`
   - `AI_REASONING_EFFORT`
 - Slack and KakaoTalk currently use a single local token entry per provider in this command flow.
-- `bot verify` checks the configured local token, cross-checks the server bot binding, and prints the effective runtime role profile summary that the runner will use.
-- `bot show` prints one local bot entry in detail, including grouped role summaries when one server bot name expands to multiple roles.
+- `bot verify` checks the configured local token, cross-checks the server bot binding, prints the effective runtime role profile summary that the runner will use, and shows which local runner routes currently point at this bot entry.
+- `bot show` prints one local bot entry in detail, including grouped role summaries when one server bot name expands to multiple roles and any linked local runner routes.
 - `bot global` edits Telegram-wide local settings such as API base URL, allowed updates, and default bot key.
 - `bot set-default` updates `TELEGRAM_DEFAULT_BOT_KEY`.
 - `bot migrate` moves legacy `TELEGRAM_BOT_TOKEN` into a named Telegram bot entry.

package/lib/bot-commands.mjs

@@ -840,6 +840,7 @@ function buildBotShowPayload(provider, state, entry, deps, extras = {}) {
         reasoningEffort: selectedEntry.reasoningEffort,
       } : null,
       serverBinding: safeObject(extras.serverBinding),
+      routeLinks: safeObject(extras.routeLinks),
       ...safeObject(extras),
     };
   }
@@ -857,6 +858,60 @@ function buildBotShowPayload(provider, state, entry, deps, extras = {}) {
   };
 }
 
+function describeRouteRuntimeProfile(routeRole, serverBinding) {
+  const binding = safeObject(serverBinding);
+  if (binding.mode === "group") {
+    return safeObject(safeObject(binding.effectiveRoleProfiles)[String(routeRole || "").trim()]);
+  }
+  return safeObject(binding.effectiveRoleProfile);
+}
+
+function summarizeTelegramRouteLinks(parsedEnv, entry, serverBinding, deps) {
+  const selectedEntry = safeObject(entry);
+  const binding = safeObject(serverBinding);
+  const config = safeObject(requireDependency(deps, "loadBotRunnerConfig")({ persistIfNeeded: true }));
+  const routes = ensureArray(config.routes);
+  const entryKey = String(selectedEntry.key || "").trim();
+  const defaultBotKey = String(safeObject(parsedEnv).TELEGRAM_DEFAULT_BOT_KEY || "").trim();
+  const serverBotID = String(binding.serverBotID || selectedEntry.serverBotID || "").trim();
+  const normalizedNames = new Set(
+    [
+      normalizeServerBotIdentityText(selectedEntry.username),
+      normalizeServerBotIdentityText(binding.name),
+      normalizeServerBotIdentityText(entryKey),
+    ].filter(Boolean),
+  );
+  const linkedRoutes = [];
+  routes.forEach((rawRoute, index) => {
+    const route = safeObject(rawRoute);
+    if (route.enabled === false) return;
+    if (String(route.provider || "").trim().toLowerCase() !== "telegram") return;
+    const routeName = String(route.name || route.route_name || `telegram-route-${index + 1}`).trim();
+    const routeBotID = String(route.bot_id || route.botID || "").trim();
+    const routeBotName = normalizeServerBotIdentityText(route.bot_name || route.botName || "");
+    const routeRole = String(route.role_profile || route.roleProfile || route.role || "").trim();
+    let matchedBy = "";
+    if (serverBotID && routeBotID === serverBotID) {
+      matchedBy = "bot_id";
+    } else if (routeBotName && normalizedNames.has(routeBotName)) {
+      matchedBy = "bot_name";
+    } else if (!routeBotID && !routeBotName && entryKey && defaultBotKey && entryKey === defaultBotKey) {
+      matchedBy = "default_bot";
+    }
+    if (!matchedBy) return;
+    linkedRoutes.push({
+      routeName,
+      matchedBy,
+      routeRole,
+      runtimeRoleProfile: describeRouteRuntimeProfile(routeRole, binding),
+    });
+  });
+  return {
+    total: linkedRoutes.length,
+    routes: linkedRoutes,
+  };
+}
+
 function printBotList(provider, state, deps) {
   process.stdout.write(`${providerLabel(provider, deps)}\n`);
   process.stdout.write(`  file: ${state.filePath}\n`);
@@ -895,6 +950,7 @@ function printBotShow(provider, state, entry, deps, extras = {}) {
   if (provider === "telegram") {
     const selectedEntry = entry || {};
     const serverBinding = safeObject(extras.serverBinding);
+    const routeLinks = safeObject(extras.routeLinks);
     process.stdout.write(`${providerLabel(provider, deps)} bot\n`);
     process.stdout.write(`  file: ${state.filePath}\n`);
     process.stdout.write(`  name: ${telegramEntryDisplayName(selectedEntry)}\n`);
@@ -924,6 +980,16 @@ function printBotShow(provider, state, entry, deps, extras = {}) {
         process.stdout.write(`  runtime_role_profile: ${formatRoleProfileOutputLine(serverBinding.effectiveRoleProfile)}\n`);
       }
     }
+    process.stdout.write(`  route_links: ${intFromRaw(routeLinks.total, 0)}\n`);
+    ensureArray(routeLinks.routes).forEach((route) => {
+      const routeRuntime = safeObject(route.runtimeRoleProfile);
+      const routeDetail = [
+        `matched_by=${String(route.matchedBy || "-")}`,
+        route.routeRole ? `route_role=${String(route.routeRole || "").trim()}` : "",
+        Object.keys(routeRuntime).length ? `runtime=${formatRoleProfileOutputLine(routeRuntime)}` : "",
+      ].filter(Boolean).join(" ");
+      process.stdout.write(`  linked_route[${String(route.routeName || "-")}]: ${routeDetail || "-"}\n`);
+    });
     return;
   }
   const tokenKey = providerTokenKey(provider, deps);
@@ -2047,11 +2113,17 @@ async function verifyProviderEntry(ui, provider, flags, deps) {
   );
   let overallOK = Boolean(result.ok);
   let serverBinding = null;
+  let routeLinks = null;
   if (provider === "telegram") {
     serverBinding = await resolveTelegramServerBindingDetails(envConfig, flags, deps);
     if (serverBinding && !serverBinding.ok) {
       overallOK = false;
     }
+    routeLinks = summarizeTelegramRouteLinks(state.parsed, {
+      key: envConfig.botKey,
+      serverBotID: envConfig.serverBotID,
+      username: envConfig.botUsername,
+    }, serverBinding, deps);
   }
   const interactiveJsonChoice = (
     !boolFromRaw(flags.json, false)
@@ -2084,6 +2156,7 @@ async function verifyProviderEntry(ui, provider, flags, deps) {
         permissionMode: envConfig.permissionMode || "",
         reasoningEffort: envConfig.reasoningEffort || "",
         serverBinding,
+        routeLinks,
       }, null, 2)}\n`,
     );
   } else {
@@ -2099,6 +2172,7 @@ async function verifyProviderEntry(ui, provider, flags, deps) {
       provider === "telegram" ? `reasoning_effort: ${envConfig.reasoningEffort || "-"}` : "",
       `detail: ${result.detail || "-"}`,
       serverBinding ? `server_binding: ${serverBinding.ok ? "OK" : "FAIL"}${serverBinding.detail ? ` (${serverBinding.detail})` : ""}` : "",
+      routeLinks ? `route_links: ${intFromRaw(routeLinks.total, 0)}` : "",
     ].filter(Boolean);
     if (provider === "telegram" && serverBinding) {
       lines.push(`server_binding_mode: ${serverBinding.mode || "-"}`);
@@ -2113,6 +2187,17 @@ async function verifyProviderEntry(ui, provider, flags, deps) {
         lines.push(`runtime_role_profile: ${formatRoleProfileOutputLine(serverBinding.effectiveRoleProfile)}`);
       }
     }
+    if (provider === "telegram" && routeLinks) {
+      ensureArray(routeLinks.routes).forEach((route) => {
+        const routeRuntime = safeObject(route.runtimeRoleProfile);
+        const routeDetail = [
+          `matched_by=${String(route.matchedBy || "-")}`,
+          route.routeRole ? `route_role=${String(route.routeRole || "").trim()}` : "",
+          Object.keys(routeRuntime).length ? `runtime=${formatRoleProfileOutputLine(routeRuntime)}` : "",
+        ].filter(Boolean).join(" ");
+        lines.push(`linked_route[${String(route.routeName || "-")}]: ${routeDetail || "-"}`);
+      });
+    }
     process.stdout.write(`${lines.join("\n")}\n`);
   }
   if (!overallOK) {
@@ -2281,12 +2366,13 @@ async function runBotShow(ui, flags, deps, explicitProvider = "") {
       flags,
       deps,
     );
-    const payload = buildBotShowPayload(provider, state, entry, deps, { serverBinding });
+    const routeLinks = summarizeTelegramRouteLinks(state.parsed, entry, serverBinding, deps);
+    const payload = buildBotShowPayload(provider, state, entry, deps, { serverBinding, routeLinks });
     if (boolFromRaw(flags.json, false)) {
       process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
       return;
     }
-    printBotShow(provider, state, entry, deps, { serverBinding });
+    printBotShow(provider, state, entry, deps, { serverBinding, routeLinks });
     return;
   }
   const payload = buildBotShowPayload(provider, state, null, deps);

package/lib/selftest-bot-commands.mjs

@@ -84,6 +84,11 @@ function readTrailingJSON(rawText) {
   return readJSON(text.slice(start));
 }
 
+function intFromRaw(rawValue, fallback = 0) {
+  const parsed = Number.parseInt(String(rawValue ?? "").trim(), 10);
+  return Number.isFinite(parsed) ? parsed : fallback;
+}
+
 function createMockServer(options = {}) {
   const serverBots = ensureArray(options.serverBots).length
     ? ensureArray(options.serverBots)
@@ -434,6 +439,37 @@ export async function runSelftestBotCommands(push, deps) {
       env,
     });
     const showPayload = readJSON(showResult.stdout);
+    const runnerConfigPath = path.join(tempHome, ".metheus", "bot-runner.json");
+    const runnerConfig = readJSON(fs.readFileSync(runnerConfigPath, "utf8"));
+    runnerConfig.routes = [
+      {
+        name: "telegram-monitor",
+        enabled: true,
+        project_id: "03c586a2-006d-4051-83b4-f353a5813176",
+        provider: "telegram",
+        bot_id: mock.bots[0].id,
+        role_profile: "monitor",
+      },
+      {
+        name: "telegram-default",
+        enabled: true,
+        project_id: "03c586a2-006d-4051-83b4-f353a5813176",
+        provider: "telegram",
+      },
+    ];
+    fs.writeFileSync(runnerConfigPath, `${JSON.stringify(runnerConfig, null, 2)}\n`, "utf8");
+    const showWithRoutesResult = await runCLI({
+      cliPath,
+      args: [
+        "bot", "show",
+        "--provider", "telegram",
+        "--bot-key", "monitorselftestbot",
+        "--base-url", baseURL,
+        "--json", "true",
+      ],
+      env,
+    });
+    const showWithRoutesPayload = readJSON(showWithRoutesResult.stdout);
     push(
       "bot_show_returns_selected_telegram_entry",
       safeObject(showPayload.entry).key === "monitorselftestbot"
@@ -441,6 +477,15 @@ export async function runSelftestBotCommands(push, deps) {
         && safeObject(showPayload.serverBinding).mode === "single",
       `key=${String(safeObject(showPayload.entry).key || "")} client=${String(safeObject(showPayload.entry).client || "")} mode=${String(safeObject(showPayload.serverBinding).mode || "")}`,
     );
+    push(
+      "bot_show_reports_linked_runner_routes",
+      intFromRaw(safeObject(showWithRoutesPayload.routeLinks).total, 0) >= 1
+        && ensureArray(safeObject(showWithRoutesPayload.routeLinks).routes).some((route) => (
+          String(safeObject(route).routeName || "") === "telegram-monitor"
+          && String(safeObject(route).matchedBy || "") === "bot_id"
+        )),
+      `routes=${JSON.stringify(safeObject(showWithRoutesPayload.routeLinks))}`,
+    );
 
     await runCLI({
       cliPath,
@@ -584,6 +629,14 @@ export async function runSelftestBotCommands(push, deps) {
         && String(verifyPayload.client || "") === "claude",
       `verify=${String(verifyPayload.ok)} mode=${String(safeObject(verifyPayload.serverBinding).mode || "")} server=${String(safeObject(verifyPayload.serverBinding).detail || "")}`,
     );
+    push(
+      "bot_verify_reports_linked_runner_routes",
+      intFromRaw(safeObject(verifyPayload.routeLinks).total, 0) >= 1
+        && ensureArray(safeObject(verifyPayload.routeLinks).routes).some((route) => (
+          String(safeObject(route).routeName || "") === "telegram-monitor"
+        )),
+      `routes=${JSON.stringify(safeObject(verifyPayload.routeLinks))}`,
+    );
 
     await runCLI({
       cliPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metheus-governance-mcp-cli",
-  "version": "0.2.73",
+  "version": "0.2.74",
   "description": "Metheus Governance MCP CLI (setup + stdio proxy)",
   "type": "module",
   "files": [