metheus-governance-mcp-cli 0.2.108 → 0.2.110

package/README.md

@@ -103,8 +103,8 @@ Runner template:
   },
   "bot_bindings": {
     "primary_monitor_bot": {
-      "bot_id": "<server_bot_uuid>",
-      "bot_name": "<bot_name>",
+      "server_bot_id": "<server_bot_uuid>",
+      "server_bot_name": "<server_bot_name>",
       "role_profile": "monitor",
       "client": "gpt",
       "model": "",
@@ -119,7 +119,7 @@ Runner template:
       "project_id": "<project_uuid>",
       "provider": "telegram",
       "role": "monitor",
-      "bot_id": "<server_bot_uuid>",
+      "server_bot_id": "<server_bot_uuid>",
       "trigger_policy": {
         "mentions_only": true,
         "direct_messages": true,
@@ -283,7 +283,7 @@ Behavior:
 - 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, 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.
-- In `bot show` and `bot verify`, `saved_local_file` means the values already stored on disk under `~/.metheus/telegram-bots/*.env`, while `current_server_protocol` means the fresh `/api/v1/me/bots` response from the server right now.
+- In `bot show` and `bot verify`, `saved_local_file` means the values already stored on disk under `~/.metheus/telegram-bots/*.env`, while `live_server_response` means the fresh `/api/v1/me/bots` response from the server right now.
 - `bot global` edits Telegram-wide local settings such as API base URL, allowed updates, and the default Telegram bot selector.
 - `bot set-default` changes the default Telegram bot selection.
 - `bot migrate` moves legacy `TELEGRAM_BOT_TOKEN` into a named Telegram bot entry.

package/cli.mjs

@@ -1006,8 +1006,8 @@ function normalizeRunnerBotBinding(bindingName, rawBinding, defaults = {}) {
   const binding = safeObject(rawBinding);
   const normalizedName = String(bindingName || binding.name || "").trim();
   const normalizedClient = normalizeLocalAIClientName(binding.client || defaults.client || "", "");
-  let botID = String(binding.bot_id || binding.botID || defaults.botID || "").trim();
-  let botName = String(binding.bot_name || binding.botName || defaults.botName || "").trim();
+  let botID = String(binding.server_bot_id || binding.serverBotID || binding.bot_id || binding.botID || defaults.botID || "").trim();
+  let botName = String(binding.server_bot_name || binding.serverBotName || binding.bot_name || binding.botName || defaults.botName || "").trim();
   if (!botID && !botName && normalizedName) {
     if (isUUID(normalizedName)) {
       botID = normalizedName;
@@ -1038,8 +1038,8 @@ function normalizeRunnerBotBinding(bindingName, rawBinding, defaults = {}) {
 function serializeRunnerBotBinding(binding) {
   const normalized = normalizeRunnerBotBinding(binding?.name, binding);
   return {
-    ...(normalized.botName ? { bot_name: normalized.botName } : {}),
-    ...(normalized.botID ? { bot_id: normalized.botID } : {}),
+    ...(normalized.botName ? { server_bot_name: normalized.botName } : {}),
+    ...(normalized.botID ? { server_bot_id: normalized.botID } : {}),
     ...(normalized.roleProfile ? { role_profile: normalized.roleProfile } : {}),
     ...(normalized.client ? { client: normalized.client } : {}),
     ...(normalized.model ? { model: normalized.model } : {}),
@@ -1129,6 +1129,8 @@ function botRunnerConfigTemplate() {
     role_profiles: defaultBotRunnerRoleProfiles(),
     bot_bindings: {
       "<bot_name>": {
+        server_bot_name: "<server_bot_name>",
+        server_bot_id: "<server_bot_uuid>",
         role_profile: "monitor",
       },
     },
@@ -1140,8 +1142,8 @@ function botRunnerConfigTemplate() {
         provider: "telegram",
         role: "monitor",
         role_profile: "monitor",
-        bot_name: "",
-        bot_id: "",
+        server_bot_name: "",
+        server_bot_id: "",
         destination_id: "",
         destination_label: "",
         archive_thread_id: "",
@@ -1176,8 +1178,8 @@ function serializeRunnerRoute(route) {
     provider: normalized.provider,
     role: normalized.role,
     ...(normalized.roleProfile ? { role_profile: normalized.roleProfile } : {}),
-    bot_name: normalized.botName,
-    bot_id: normalized.botID,
+    server_bot_name: normalized.botName,
+    server_bot_id: normalized.botID,
     destination_id: normalized.destinationID,
     destination_label: normalized.destinationLabel,
     archive_thread_id: normalized.archiveThreadID,
@@ -1693,8 +1695,8 @@ function normalizeRunnerRoute(rawRoute, overrides = {}) {
   const role = normalizeBotRole(route.role || route.bot_role || route.botRole);
   const roleProfile = normalizeRunnerRoleProfileName(route.role_profile || route.roleProfile || route.execution_profile || route.executionProfile);
   const name = String(route.name || "").trim();
-  const botName = String(route.bot_name || route.botName || "").trim();
-  const botID = String(route.bot_id || route.botID || "").trim();
+  const botName = String(route.server_bot_name || route.serverBotName || route.bot_name || route.botName || "").trim();
+  const botID = String(route.server_bot_id || route.serverBotID || route.bot_id || route.botID || "").trim();
   const command = String(route.command || "").trim();
   const destinationID = String(route.destination_id || route.destinationID || "").trim();
   const destinationLabel = String(route.destination_label || route.destinationLabel || "").trim();
@@ -1769,7 +1771,7 @@ function validateRunnerRoute(route, { requireCommand = true, config = null } = {
     errors.push("workspace_dir is missing for project_id; configure project_mappings or route.workspace_dir");
   }
   if (route.botID && !isUUID(route.botID)) {
-    errors.push("bot_id must be a valid UUID");
+    errors.push("server_bot_id must be a valid UUID");
   }
   if (route.archiveThreadID && !isUUID(route.archiveThreadID)) {
     errors.push("archive_thread_id must be a valid UUID");
@@ -2631,13 +2633,13 @@ async function runRunnerList(flags) {
         `    provider: ${row.provider}`,
         `    project_id: ${row.projectID}`,
         `    server_bot_name: ${row.botName}`,
-        `    bot_id: ${row.botID}`,
+        `    server_bot_id: ${row.botID}`,
         `    role: ${row.role}`,
         `    role_profile: ${row.roleProfile}`,
         `    destination_label: ${row.destinationLabel}`,
         `    poll_interval_ms: ${row.pollIntervalMs}`,
         `    run_once: ${CLI_NAME} runner once --route-name ${row.name}`,
-        row.botName ? `    run_once_by_bot_name: ${CLI_NAME} runner once --bot-name "${row.botName}"` : "",
+        row.botName ? `    run_once_by_server_bot_name: ${CLI_NAME} runner once --bot-name "${row.botName}"` : "",
       ].join("\n") + "\n",
     );
   });
@@ -4300,7 +4302,7 @@ async function runDoctor(flags) {
             rows,
             strictMode ? "fail" : "warn",
             `runner route ${routeLabel} server_bot_id`,
-            `route bot_id ${route.botID} != local env ${envConfig.serverBotID}`,
+            `route server_bot_id ${route.botID} != local env ${envConfig.serverBotID}`,
           );
         }
         if (route.botID && !envConfig.serverBotID) {
@@ -4323,7 +4325,7 @@ async function runDoctor(flags) {
               rows,
               strictMode ? "fail" : "warn",
               `runner route ${routeLabel} server_bot_id`,
-              `route bot_id ${route.botID} is set, but local env entry does not carry SERVER_BOT_ID`,
+              `route server_bot_id ${route.botID} is set, but local env entry does not carry SERVER_BOT_ID`,
             );
           }
         }

package/lib/bot-commands.mjs

@@ -1276,9 +1276,9 @@ function summarizeTelegramRouteLinks(parsedEnv, entry, serverBinding, deps) {
     const routeRole = String(route.role_profile || route.roleProfile || route.role || "").trim();
     let matchedBy = "";
     if (serverBotID && routeBotID === serverBotID) {
-      matchedBy = "bot_id";
+      matchedBy = "server_bot_id";
     } else if (routeBotName && normalizedNames.has(routeBotName)) {
-      matchedBy = "bot_name";
+      matchedBy = "server_bot_name";
     } else if (!routeBotID && !routeBotName && entryKey && defaultBotKey && entryKey === defaultBotKey) {
       matchedBy = "default_bot";
     }
@@ -1343,7 +1343,7 @@ function printBotShow(provider, state, entry, deps, extras = {}) {
       `global_file: ${state.filePath}`,
       `entry_file: ${resolveTelegramEntryFilePath(selectedEntry, deps) || "-"}`,
       `server_name: ${telegramEntryDisplayName(selectedEntry)}`,
-      `comparison_help: saved_local_file = values stored on disk | current_server_protocol = fresh /api/v1/me/bots response`,
+      `comparison_help: saved_local_file = values saved on this machine | live_server_response = fresh /api/v1/me/bots response`,
     ];
     appendTextSection(lines, "saved_local_file", [
       `default_entry: ${selectedEntry.isDefault ? "yes" : "no"}`,
@@ -1378,7 +1378,7 @@ function printBotShow(provider, state, entry, deps, extras = {}) {
         liveLines.push(`server_role_ids_now: ${formatTelegramServerRoleIDs(serverBinding.serverRoleIDs) || "-"}`);
         liveLines.push(`runtime_role_profile: ${formatRoleProfileOutputLine(serverBinding.effectiveRoleProfile)}`);
       }
-      appendTextSection(lines, "current_server_protocol", liveLines);
+      appendTextSection(lines, "live_server_response", liveLines);
     }
     const routeLines = [`count: ${intFromRaw(routeLinks.total, 0)}`];
     ensureArray(routeLinks.routes).forEach((route) => {
@@ -2850,7 +2850,7 @@ async function verifyProviderEntry(ui, provider, flags, deps) {
       `global_file: ${envConfig.filePath}`,
       provider === "telegram" ? `entry_file: ${resolveTelegramEntryFilePath(envConfig, deps) || "-"}` : "",
       `detail: ${result.detail || "-"}`,
-      provider === "telegram" ? `comparison_help: saved_local_file = values stored on disk | current_server_protocol = fresh /api/v1/me/bots response` : "",
+      provider === "telegram" ? `comparison_help: saved_local_file = values saved on this machine | live_server_response = fresh /api/v1/me/bots response` : "",
     ];
     if (provider === "telegram") {
       appendTextSection(lines, "saved_local_file", [
@@ -2881,7 +2881,7 @@ async function verifyProviderEntry(ui, provider, flags, deps) {
       } else if (serverBinding.effectiveRoleProfile) {
         liveLines.push(`runtime_role_profile: ${formatRoleProfileOutputLine(serverBinding.effectiveRoleProfile)}`);
       }
-      appendTextSection(lines, "current_server_protocol", liveLines);
+      appendTextSection(lines, "live_server_response", liveLines);
     }
     if (provider === "telegram" && routeLinks) {
       const routeSection = [`count: ${intFromRaw(routeLinks.total, 0)}`];

package/lib/runner-data.mjs

@@ -83,7 +83,7 @@ export function selectRunnerBot(bots, route, deps) {
   }
   const names = matches.map((item) => `${item.name} (${item.id})`).join(", ");
   throw new Error(
-    `Multiple active ${providerLabel} bot profiles matched role "${normalizedRoute.role}". Set bot_name or bot_id. Matches: ${names}`,
+    `Multiple active ${providerLabel} bot profiles matched role "${normalizedRoute.role}". Set server_bot_name or server_bot_id in the route config, or use --bot-name / --bot-id on the command line. Matches: ${names}`,
   );
 }
 

package/package.json

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

package/postinstall.mjs

@@ -13,6 +13,9 @@ const PROVIDERS = [
 function resolveTargetPath(provider) {
   const home = String(process.env.USERPROFILE || process.env.HOME || os.homedir() || "").trim();
   if (!home) return "";
+  if (provider === "telegram") {
+    return path.join(home, ".metheus", "telegram-bots", "global.env");
+  }
   return path.join(home, ".metheus", `${provider}.env`);
 }
 
@@ -21,27 +24,16 @@ function template(provider, label, tokenKey) {
     return [
       `# Metheus local ${label} bot settings`,
       "# Keep this file on your machine only. Do not commit it.",
-      "# Store Telegram bot secrets and local transport options here.",
-      "# Project chat destinations must be managed on the Metheus server.",
-      "# Per-bot local AI client/model binding can also be defined here.",
+      "# Store Telegram-wide transport options here.",
+      "# Per-bot secrets and AI settings live in ~/.metheus/telegram-bots/<ServerBotName>.env.",
       "",
-      "# Legacy single-bot fallback:",
-      `# ${tokenKey}=`,
-      "",
-      "# Preferred multi-bot mapping:",
       "TELEGRAM_API_BASE_URL=",
       "TELEGRAM_AUTO_CLEAR_WEBHOOK=true",
       "TELEGRAM_ALLOWED_UPDATES=message,edited_message",
-      "TELEGRAM_DEFAULT_BOT_KEY=main",
+      "TELEGRAM_DEFAULT_BOT_KEY=",
       "",
-      "TELEGRAM_BOT_MAIN_SERVER_BOT_ID=",
-      "TELEGRAM_BOT_MAIN_USERNAME=",
-      "TELEGRAM_BOT_MAIN_TOKEN=",
-      "TELEGRAM_BOT_MAIN_ROLE_PROFILE=",
-      "TELEGRAM_BOT_MAIN_AI_CLIENT=",
-      "TELEGRAM_BOT_MAIN_AI_MODEL=",
-      "TELEGRAM_BOT_MAIN_AI_PERMISSION_MODE=",
-      "TELEGRAM_BOT_MAIN_AI_REASONING_EFFORT=",
+      "# Legacy single-bot fallback:",
+      `${tokenKey}=`,
       "",
     ].join("\n");
   }
@@ -101,8 +93,8 @@ function botRunnerTemplate() {
       },
       bot_bindings: {
         "<binding_key>": {
-          bot_id: "<server_bot_uuid>",
-          bot_name: "<bot_name>",
+          server_bot_id: "<server_bot_uuid>",
+          server_bot_name: "<server_bot_name>",
           role_profile: "monitor",
           client: "gpt",
           model: "",
@@ -117,8 +109,8 @@ function botRunnerTemplate() {
           project_id: "<project_uuid>",
           provider: "telegram",
           role: "monitor",
-          bot_name: "",
-          bot_id: "<server_bot_uuid>",
+          server_bot_name: "",
+          server_bot_id: "<server_bot_uuid>",
           destination_id: "",
           destination_label: "",
           archive_thread_id: "",