metheus-governance-mcp-cli 0.2.87 → 0.2.89

package/cli.mjs

@@ -12,6 +12,7 @@ import {
   DEFAULT_LOCAL_AI_CLIENT,
   resolveLocalAIExecutionModel,
   resolveGeminiReasoningConfig,
+  suggestLocalAIModelDisplayName,
   SUPPORTED_LOCAL_AI_CLIENTS,
   normalizeLocalAIClientName,
   normalizeLocalAIPermissionMode,
@@ -856,13 +857,14 @@ function normalizeRunnerRoleProfileName(rawValue) {
 
 function normalizeRunnerRoleProfile(profileName, rawProfile, defaults = {}) {
   const profile = safeObject(rawProfile);
+  const normalizedClient = normalizeLocalAIClientName(
+    profile.client || profile.cli || defaults.client || DEFAULT_BOT_RUNNER_CLIENT,
+    normalizeLocalAIClientName(defaults.client || DEFAULT_BOT_RUNNER_CLIENT),
+  );
   return {
     name: normalizeRunnerRoleProfileName(profileName || profile.name),
-    client: normalizeLocalAIClientName(
-      profile.client || profile.cli || defaults.client || DEFAULT_BOT_RUNNER_CLIENT,
-      normalizeLocalAIClientName(defaults.client || DEFAULT_BOT_RUNNER_CLIENT),
-    ),
-    model: String(profile.model || defaults.model || "").trim(),
+    client: normalizedClient,
+    model: suggestLocalAIModelDisplayName(normalizedClient, profile.model || defaults.model || ""),
     permissionMode: normalizeLocalAIPermissionMode(
       profile.permission_mode
         || profile.permissionMode
@@ -968,6 +970,7 @@ function serializeRunnerRoleProfile(profile) {
 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();
   if (!botID && !botName && normalizedName) {
@@ -984,8 +987,8 @@ function normalizeRunnerBotBinding(bindingName, rawBinding, defaults = {}) {
     roleProfile: normalizeRunnerRoleProfileName(
       binding.role_profile || binding.roleProfile || binding.execution_profile || binding.executionProfile || defaults.roleProfile,
     ),
-    client: normalizeLocalAIClientName(binding.client || defaults.client || "", ""),
-    model: String(binding.model || defaults.model || "").trim(),
+    client: normalizedClient,
+    model: suggestLocalAIModelDisplayName(normalizedClient, binding.model || defaults.model || ""),
     permissionMode: normalizeLocalAIPermissionMode(
       binding.permission_mode || binding.permissionMode || defaults.permissionMode || "",
       "",
@@ -3359,6 +3362,7 @@ function buildBotCommandDeps() {
     normalizeLocalAIClientName,
     normalizeLocalAIPermissionMode,
     normalizeLocalAIReasoningEffort,
+    suggestLocalAIModelDisplayName,
     resolveGeminiReasoningConfig,
     supportedLocalAIClients: SUPPORTED_LOCAL_AI_CLIENTS,
     summarizeProviderSupport,
@@ -5211,6 +5215,7 @@ TELEGRAM_BOT_REVIEW_TOKEN=review-token
     cliPath: fileURLToPath(import.meta.url),
     parseSimpleEnvText,
     resolveLocalAIExecutionModel,
+    suggestLocalAIModelDisplayName,
     resolveGeminiReasoningConfig,
   });
 

package/lib/bot-commands.mjs

@@ -58,6 +58,14 @@ function uniqueNormalizedValues(values, deps, fallback = "") {
   return fallbackKey ? [fallbackKey] : [];
 }
 
+function suggestDisplayedAIModel(deps, clientName, rawModelValue = "") {
+  const helper = deps?.suggestLocalAIModelDisplayName;
+  if (typeof helper === "function") {
+    return String(helper(clientName, rawModelValue)).trim();
+  }
+  return String(rawModelValue || "").trim();
+}
+
 function normalizeServerBotIdentityText(rawValue) {
   return String(rawValue || "").trim().replace(/^@+/, "").toLowerCase();
 }
@@ -633,21 +641,22 @@ function displayLocalAIClientName(clientName) {
   return String(clientName || "").trim();
 }
 
-function formatRuntimeReasoningField(clientName, reasoningEffort) {
+function formatRuntimeReasoningField(clientName, reasoningEffort, style = "equals") {
   const normalizedClient = String(clientName || "").trim().toLowerCase();
   const normalizedEffort = String(reasoningEffort || "").trim();
+  const separator = style === "colon" ? ":" : "=";
   if (!normalizedEffort) {
-    if (normalizedClient === "claude") return "thinking=(blank)";
-    if (normalizedClient === "gemini") return "thinking=(blank)";
-    return "reasoning=(blank)";
+    if (normalizedClient === "claude") return `thinking${separator}(blank)`;
+    if (normalizedClient === "gemini") return `thinking${separator}(blank)`;
+    return `reasoning${separator}(blank)`;
   }
   if (normalizedClient === "claude") {
-    return `thinking=${normalizedEffort} (Claude effort)`;
+    return `thinking${separator}${normalizedEffort} (Claude effort)`;
   }
   if (normalizedClient === "gemini") {
-    return `thinking=${normalizedEffort} (Gemini level)`;
+    return `thinking${separator}${normalizedEffort} (Gemini level)`;
   }
-  return `reasoning=${normalizedEffort}`;
+  return `reasoning${separator}${normalizedEffort}`;
 }
 
 function telegramEntryDisplayDescription(entry) {
@@ -739,9 +748,24 @@ async function editTelegramBotGuided(ui, parsed, selected, current, flags, deps)
   let groupedServerName = "";
   let serverManagedIdentity = Boolean(current.serverBotID || current.__preferServerIdentity);
   if (!serverManagedIdentity) {
-    const initialServerBot = await autoResolveTelegramServerBot(current, flags, deps);
-    if (String(initialServerBot.botID || "").trim() || initialServerBot.matchMode === "group") {
+    const initialBinding = await resolveTelegramServerBindingDetails(
+      {
+        serverBotID: current.serverBotID,
+        botUsername: current.username,
+        botKey: current.key,
+        roleProfile: current.roleProfile,
+      },
+      flags,
+      deps,
+    );
+    if (initialBinding.ok && (String(initialBinding.serverBotID || "").trim() || initialBinding.mode === "group")) {
       serverManagedIdentity = true;
+      current.__preferServerIdentity = true;
+      if (initialBinding.mode === "single") {
+        current.serverBotID = String(initialBinding.serverBotID || "").trim();
+        current.roleProfile = String(initialBinding.role || current.roleProfile || "").trim();
+        applyRoleProfileDefaults(current, resolveRoleProfileDefaults(current.roleProfile, deps));
+      }
     }
   }
   let usernameAction = "keep";
@@ -1568,9 +1592,10 @@ function resolveRoleProfileDefaults(roleProfileName, deps) {
   }
   const config = requireDependency(deps, "loadBotRunnerConfig")({ persistIfNeeded: true });
   const profile = safeObject(safeObject(config.roleProfiles || {})[profileName]);
+  const normalizedClient = requireDependency(deps, "normalizeLocalAIClientName")(profile.client || "", "");
   return {
-    client: requireDependency(deps, "normalizeLocalAIClientName")(profile.client || "", ""),
-    model: String(profile.model || "").trim(),
+    client: normalizedClient,
+    model: suggestDisplayedAIModel(deps, normalizedClient, profile.model || ""),
     permissionMode: requireDependency(deps, "normalizeLocalAIPermissionMode")(
       profile.permission_mode || profile.permissionMode || "",
       "",
@@ -1618,10 +1643,11 @@ function currentRoleProfileState(roleName, deps) {
   const defaults = resolveRoleProfileDefaults(normalizedRole, deps);
   const config = requireDependency(deps, "loadBotRunnerConfig")({ persistIfNeeded: true });
   const profile = safeObject(safeObject(config.roleProfiles || {})[normalizedRole]);
+  const normalizedClient = requireDependency(deps, "normalizeLocalAIClientName")(profile.client || defaults.client || "", "");
   return {
     role: normalizedRole,
-    client: requireDependency(deps, "normalizeLocalAIClientName")(profile.client || defaults.client || "", ""),
-    model: String(profile.model || defaults.model || "").trim(),
+    client: normalizedClient,
+    model: suggestDisplayedAIModel(deps, normalizedClient, profile.model || defaults.model || ""),
     permissionMode: requireDependency(deps, "normalizeLocalAIPermissionMode")(
       profile.permission_mode || profile.permissionMode || defaults.permissionMode || "",
       "",
@@ -1639,7 +1665,7 @@ function formatRoleProfileSummary(profile) {
     current.client ? `client:${displayLocalAIClientName(current.client)}` : "client:(blank)",
     current.model ? `model:${current.model}` : "model:(blank)",
     current.permissionMode ? `permission:${current.permissionMode}` : "permission:(blank)",
-    current.reasoningEffort ? `reasoning:${current.reasoningEffort}` : "reasoning:(blank)",
+    formatRuntimeReasoningField(current.client, current.reasoningEffort, "colon"),
   ].join(" | ");
 }
 

package/lib/local-ai-adapters.mjs

@@ -256,15 +256,33 @@ function localAIModelMappingsForClient(clientName) {
   return Array.isArray(LOCAL_AI_MODEL_MAPPINGS[normalizedClient]) ? LOCAL_AI_MODEL_MAPPINGS[normalizedClient] : [];
 }
 
-export function resolveLocalAIExecutionModel(clientName, rawModelValue = "") {
+function findLocalAIModelMapping(clientName, rawModelValue = "") {
   const modelValue = String(rawModelValue || "").trim();
-  if (!modelValue) return "";
+  if (!modelValue) return null;
   const normalizedModel = normalizeModelAliasText(modelValue);
-  const match = localAIModelMappingsForClient(clientName).find((item) => (
+  return localAIModelMappingsForClient(clientName).find((item) => (
     normalizeModelAliasText(item.display) === normalizedModel
     || normalizeModelAliasText(item.execution) === normalizedModel
     || ensureArray(item.aliases).some((alias) => normalizeModelAliasText(alias) === normalizedModel)
-  ));
+  )) || null;
+}
+
+export function suggestLocalAIModelDisplayName(clientName, rawModelValue = "") {
+  const modelValue = String(rawModelValue || "").trim();
+  const match = findLocalAIModelMapping(clientName, modelValue);
+  if (match) {
+    return String(match.display || modelValue).trim();
+  }
+  if (modelValue) {
+    return modelValue;
+  }
+  return String(localAIModelMappingsForClient(clientName)[0]?.display || "").trim();
+}
+
+export function resolveLocalAIExecutionModel(clientName, rawModelValue = "") {
+  const modelValue = String(rawModelValue || "").trim();
+  if (!modelValue) return "";
+  const match = findLocalAIModelMapping(clientName, modelValue);
   return match ? String(match.execution || "").trim() : modelValue;
 }
 

package/lib/selftest-bot-commands.mjs

@@ -229,6 +229,7 @@ export async function runSelftestBotCommands(push, deps) {
   const cliPath = String(requireDependency(deps, "cliPath") || "").trim();
   const parseSimpleEnvText = requireDependency(deps, "parseSimpleEnvText");
   const resolveLocalAIExecutionModel = requireDependency(deps, "resolveLocalAIExecutionModel");
+  const suggestLocalAIModelDisplayName = requireDependency(deps, "suggestLocalAIModelDisplayName");
   const resolveGeminiReasoningConfig = requireDependency(deps, "resolveGeminiReasoningConfig");
   let tempHome = "";
   let mock = null;
@@ -254,6 +255,18 @@ export async function runSelftestBotCommands(push, deps) {
       ].join(" "),
     );
 
+    push(
+      "blank_model_defaults_to_first_display_model_for_each_client",
+      suggestLocalAIModelDisplayName("codex", "") === "gpt-5.4"
+        && suggestLocalAIModelDisplayName("claude", "") === "Sonnet 4.6r"
+        && suggestLocalAIModelDisplayName("gemini", "") === "gemini-3.1-pro",
+      [
+        `codex=${suggestLocalAIModelDisplayName("codex", "")}`,
+        `claude=${suggestLocalAIModelDisplayName("claude", "")}`,
+        `gemini=${suggestLocalAIModelDisplayName("gemini", "")}`,
+      ].join(" "),
+    );
+
     const geminiLowReasoning = resolveGeminiReasoningConfig("gemini-3.1-pro", "low");
     const geminiMediumReasoning = resolveGeminiReasoningConfig("gemini-3.1-pro", "medium");
     const geminiHighReasoning = resolveGeminiReasoningConfig("gemini-3.1-pro", "high");
@@ -403,7 +416,7 @@ export async function runSelftestBotCommands(push, deps) {
             "3", // select role to edit: worker
             "2", // worker: edit settings
             "3", // worker AI client: claude
-            "2", // worker AI model: Sonnet 4.6r
+            "3", // worker AI model: Sonnet 4.6r
             "4", // worker permission: danger_full_access
             "4", // worker reasoning: high
             "y", // edit another role
@@ -453,8 +466,9 @@ export async function runSelftestBotCommands(push, deps) {
         "bot_show_reports_grouped_server_roles",
         safeObject(groupedShowPayload.serverBinding).mode === "group"
           && safeObject(safeObject(groupedShowPayload.serverBinding).effectiveRoleProfiles).worker?.client === "claude"
-          && safeObject(safeObject(groupedShowPayload.serverBinding).effectiveRoleProfiles).approval?.client === "gemini",
-        `mode=${String(safeObject(groupedShowPayload.serverBinding).mode || "")} worker=${String(safeObject(safeObject(groupedShowPayload.serverBinding).effectiveRoleProfiles).worker?.client || "")} approval=${String(safeObject(safeObject(groupedShowPayload.serverBinding).effectiveRoleProfiles).approval?.client || "")}`,
+          && safeObject(safeObject(groupedShowPayload.serverBinding).effectiveRoleProfiles).approval?.client === "gemini"
+          && String(safeObject(safeObject(groupedShowPayload.serverBinding).effectiveRoleProfiles).monitor?.model || "") === "gpt-5.4",
+        `mode=${String(safeObject(groupedShowPayload.serverBinding).mode || "")} worker=${String(safeObject(safeObject(groupedShowPayload.serverBinding).effectiveRoleProfiles).worker?.client || "")} approval=${String(safeObject(safeObject(groupedShowPayload.serverBinding).effectiveRoleProfiles).approval?.client || "")} monitor_model=${String(safeObject(safeObject(groupedShowPayload.serverBinding).effectiveRoleProfiles).monitor?.model || "")}`,
       );
     } finally {
       await groupedMock.close();
@@ -542,7 +556,7 @@ export async function runSelftestBotCommands(push, deps) {
         "2", // change AI client
         "4", // gemini
         "2", // change AI model
-        "2", // gemini model: gemini-3.1-pro
+        "3", // gemini model: gemini-3.1-pro
         "2", // change permission mode
         "3", // workspace_write
         "2", // change reasoning effort

package/lib/selftest-runner-scenarios.mjs

@@ -326,7 +326,7 @@ export async function runSelftestRunnerScenarios(push, deps) {
     envBindingExecutionPlan.mode === "role_profile"
       && envBindingExecutionPlan.roleProfileName === "approval"
       && envBindingExecutionPlan.roleProfile?.client === "claude"
-      && envBindingExecutionPlan.roleProfile?.model === "sonnet"
+      && envBindingExecutionPlan.roleProfile?.model === "Sonnet 4.6r"
       && envBindingExecutionPlan.roleProfile?.reasoningEffort === "medium",
     `role_profile=${envBindingExecutionPlan.roleProfileName} client=${String(envBindingExecutionPlan.roleProfile?.client || "(none)")} model=${String(envBindingExecutionPlan.roleProfile?.model || "(none)")}`,
   );

package/package.json

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