metheus-governance-mcp-cli 0.2.82 → 0.2.84

package/README.md

@@ -233,6 +233,15 @@ Behavior:
 - When the Telegram username matches exactly one server bot role, the CLI still auto-fills the local `role_profile` and blank AI defaults from your local `bot-runner.json` `role_profiles` mapping.
 - `bot edit` without flags now uses the same sequential flow every time: provider -> bot entry -> username/token review -> grouped server-role review when needed -> AI field choices -> default choice -> save.
 - when the CLI asks for `AI model`, it now shows client-specific model choices first and still allows manual entry when you need a custom model name.
+- display labels are converted to tested execution model IDs at runtime:
+  - `gpt-5.4` -> `gpt-5.4`
+  - `gpt-5.3-codex` -> `gpt-5.3-codex`
+  - `gpt-5.3-codex-spark` -> `gpt-5.3-codex-spark`
+  - older uppercase GPT labels are still accepted as compatibility aliases
+  - `Sonnet 4.6r` -> `sonnet`
+  - `Haiku 4.5` -> `haiku`
+  - `Opus 4.6` -> `opus`
+  - `Gemini 3.1 Pro` -> `gemini-2.5-pro`
 - if one server bot name maps to multiple server roles, `bot edit` keeps the Telegram env entry bound to the server identity and lets you review the local `role_profiles` for each detected role instead of forcing one role/profile UUID choice up front.
 - In the normal Telegram edit path, the CLI keeps or re-resolves the server bot binding automatically. It no longer asks you to pick `approval / worker / review / monitor` or a server bot UUID first.
 - `bot set-default` without flags starts a guided numbered flow: provider -> bot entry -> confirm default change.
@@ -259,7 +268,7 @@ Non-interactive examples:
 ```bash
 metheus-governance-mcp-cli bot global --provider telegram --non-interactive true --api-base-url http://127.0.0.1:8999/telegram --auto-clear-webhook false --allowed-updates message,edited_message,channel_post
 metheus-governance-mcp-cli bot add --provider telegram --non-interactive true --server-bot-id <server_bot_uuid> --token <telegram_bot_token> --default true
-metheus-governance-mcp-cli bot add --provider telegram --non-interactive true --server-bot-id <server_bot_uuid> --token <telegram_bot_token> --ai-client gpt --ai-model "GPT-5.4" --ai-permission-mode read_only --ai-reasoning-effort low
+metheus-governance-mcp-cli bot add --provider telegram --non-interactive true --server-bot-id <server_bot_uuid> --token <telegram_bot_token> --ai-client gpt --ai-model "gpt-5.4" --ai-permission-mode read_only --ai-reasoning-effort low
 metheus-governance-mcp-cli bot edit --provider telegram --bot-key ryoai_bot --non-interactive true --ai-client claude --ai-model "Sonnet 4.6r" --ai-permission-mode danger_full_access --ai-reasoning-effort high
 metheus-governance-mcp-cli bot set-default --provider telegram --bot-key main --non-interactive true
 metheus-governance-mcp-cli bot migrate --provider telegram --bot-key main --server-bot-id <server_bot_uuid> --bot-name <telegram_username> --role-profile monitor --ai-client codex --ai-permission-mode read_only --ai-reasoning-effort low --non-interactive true

package/cli.mjs

@@ -10,6 +10,7 @@ import http from "node:http";
 import https from "node:https";
 import {
   DEFAULT_LOCAL_AI_CLIENT,
+  resolveLocalAIExecutionModel,
   SUPPORTED_LOCAL_AI_CLIENTS,
   normalizeLocalAIClientName,
   normalizeLocalAIPermissionMode,
@@ -5207,6 +5208,7 @@ TELEGRAM_BOT_REVIEW_TOKEN=review-token
   await runSelftestBotCommands(push, {
     cliPath: fileURLToPath(import.meta.url),
     parseSimpleEnvText,
+    resolveLocalAIExecutionModel,
   });
 
   const payload = buildSelftestPayload(checks);

package/lib/bot-commands.mjs

@@ -1462,21 +1462,21 @@ function suggestedAIModelsForClient(clientName) {
   const normalizedClient = String(clientName || "").trim().toLowerCase();
   if (normalizedClient === "codex") {
     return [
-      { value: "GPT-5.4", label: "GPT-5.4", description: "recommended GPT model" },
-      { value: "GPT-5.3-CODEX", label: "GPT-5.3-CODEX", description: "stable GPT codex-style model" },
-      { value: "GPT-5.3-CODEX-Spark", label: "GPT-5.3-CODEX-Spark", description: "faster GPT codex-style model" },
+      { value: "gpt-5.4", label: "gpt-5.4", description: "recommended GPT model" },
+      { value: "gpt-5.3-codex", label: "gpt-5.3-codex", description: "stable GPT codex model" },
+      { value: "gpt-5.3-codex-spark", label: "gpt-5.3-codex-spark", description: "faster GPT codex model" },
     ];
   }
   if (normalizedClient === "claude") {
     return [
-      { value: "Sonnet 4.6r", label: "Sonnet 4.6r", description: "recommended Claude Sonnet model" },
-      { value: "Haiku 4.5", label: "Haiku 4.5", description: "faster Claude Haiku model" },
-      { value: "Opus 4.6", label: "Opus 4.6", description: "highest-capability Claude model" },
+      { value: "Sonnet 4.6r", label: "Sonnet 4.6r", description: "display label; runs as sonnet" },
+      { value: "Haiku 4.5", label: "Haiku 4.5", description: "display label; runs as haiku" },
+      { value: "Opus 4.6", label: "Opus 4.6", description: "display label; runs as opus" },
     ];
   }
   if (normalizedClient === "gemini") {
     return [
-      { value: "Gemini 3.1 Pro", label: "Gemini 3.1 Pro", description: "recommended Gemini model" },
+      { value: "Gemini 3.1 Pro", label: "Gemini 3.1 Pro", description: "display label; runs as gemini-2.5-pro" },
     ];
   }
   if (normalizedClient === "sample") {

package/lib/local-ai-adapters.mjs

@@ -8,6 +8,50 @@ export const DEFAULT_LOCAL_AI_CLIENT = "codex";
 
 const SUPPORTED_PERMISSION_MODES = ["read_only", "workspace_write", "danger_full_access"];
 const SUPPORTED_REASONING_EFFORTS = ["low", "medium", "high"];
+const LOCAL_AI_MODEL_MAPPINGS = {
+  codex: [
+    {
+      display: "gpt-5.4",
+      execution: "gpt-5.4",
+      aliases: ["gpt-5.4", "gpt 5.4", "GPT-5.4"],
+    },
+    {
+      display: "gpt-5.3-codex",
+      execution: "gpt-5.3-codex",
+      aliases: ["gpt-5.3-codex", "gpt 5.3 codex", "GPT-5.3-CODEX"],
+    },
+    {
+      display: "gpt-5.3-codex-spark",
+      execution: "gpt-5.3-codex-spark",
+      aliases: ["gpt-5.3-codex-spark", "gpt 5.3 codex spark", "GPT-5.3-CODEX-Spark"],
+    },
+  ],
+  claude: [
+    {
+      display: "Sonnet 4.6r",
+      execution: "sonnet",
+      aliases: ["sonnet 4.6r", "claude-sonnet-4", "claude-3.7-sonnet", "sonnet"],
+    },
+    {
+      display: "Haiku 4.5",
+      execution: "haiku",
+      aliases: ["haiku 4.5", "haiku"],
+    },
+    {
+      display: "Opus 4.6",
+      execution: "opus",
+      aliases: ["opus 4.6", "opus"],
+    },
+  ],
+  gemini: [
+    {
+      display: "Gemini 3.1 Pro",
+      execution: "gemini-2.5-pro",
+      aliases: ["gemini 3.1 pro", "gemini-3.1-pro", "gemini-2.5-pro", "gemini 2.5 pro"],
+    },
+  ],
+  sample: [],
+};
 
 function tryJsonParse(text) {
   try {
@@ -25,6 +69,10 @@ function firstNonEmptyString(values) {
   return "";
 }
 
+function ensureArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+
 function intFromRawAllowZero(rawValue, fallback = 0) {
   const parsed = Number.parseInt(String(rawValue ?? "").trim(), 10);
   if (!Number.isFinite(parsed) || parsed < 0) {
@@ -176,6 +224,30 @@ function normalizeCliOutput(rawText) {
   };
 }
 
+function normalizeModelAliasText(rawValue) {
+  return String(rawValue || "")
+    .trim()
+    .toLowerCase()
+    .replace(/[_\s]+/g, "-");
+}
+
+function localAIModelMappingsForClient(clientName) {
+  const normalizedClient = normalizeLocalAIClientName(clientName, "");
+  return Array.isArray(LOCAL_AI_MODEL_MAPPINGS[normalizedClient]) ? LOCAL_AI_MODEL_MAPPINGS[normalizedClient] : [];
+}
+
+export function resolveLocalAIExecutionModel(clientName, rawModelValue = "") {
+  const modelValue = String(rawModelValue || "").trim();
+  if (!modelValue) return "";
+  const normalizedModel = normalizeModelAliasText(modelValue);
+  const match = localAIModelMappingsForClient(clientName).find((item) => (
+    normalizeModelAliasText(item.display) === normalizedModel
+    || normalizeModelAliasText(item.execution) === normalizedModel
+    || ensureArray(item.aliases).some((alias) => normalizeModelAliasText(alias) === normalizedModel)
+  ));
+  return match ? String(match.execution || "").trim() : modelValue;
+}
+
 function buildCodexArgs({ workspaceDir, model, permissionMode, reasoningEffort, outputPath }) {
   const args = ["exec"];
   if (model) {
@@ -487,6 +559,7 @@ export function runLocalAIClient({
   const normalizedClient = normalizeLocalAIClientName(client);
   const normalizedPermissionMode = normalizeLocalAIPermissionMode(permissionMode);
   const normalizedReasoningEffort = normalizeLocalAIReasoningEffort(reasoningEffort);
+  const resolvedExecutionModel = resolveLocalAIExecutionModel(normalizedClient, model);
   const resolvedWorkspaceDir = ensureWorkspaceDir(workspaceDir);
   const promptText = buildLocalBotPrompt(inputPayload);
   if (normalizedClient === "sample") {
@@ -497,6 +570,7 @@ export function runLocalAIClient({
     ...env,
     METHEUS_AI_RUNNER_CLIENT: normalizedClient,
     METHEUS_AI_RUNNER_MODEL: String(model || "").trim(),
+    METHEUS_AI_RUNNER_EXECUTION_MODEL: resolvedExecutionModel,
     METHEUS_AI_RUNNER_PERMISSION_MODE: normalizedPermissionMode,
     METHEUS_AI_RUNNER_REASONING_EFFORT: normalizedReasoningEffort,
     METHEUS_RUNNER_WORKSPACE_DIR: resolvedWorkspaceDir,
@@ -505,7 +579,7 @@ export function runLocalAIClient({
     return runCodexAdapter({
       promptText,
       workspaceDir: resolvedWorkspaceDir,
-      model: String(model || "").trim(),
+      model: resolvedExecutionModel,
       permissionMode: normalizedPermissionMode,
       reasoningEffort: normalizedReasoningEffort,
       env: nextEnv,
@@ -515,7 +589,7 @@ export function runLocalAIClient({
     return runClaudeAdapter({
       promptText,
       workspaceDir: resolvedWorkspaceDir,
-      model: String(model || "").trim(),
+      model: resolvedExecutionModel,
       permissionMode: normalizedPermissionMode,
       reasoningEffort: normalizedReasoningEffort,
       env: nextEnv,
@@ -525,7 +599,7 @@ export function runLocalAIClient({
     return runGeminiAdapter({
       promptText,
       workspaceDir: resolvedWorkspaceDir,
-      model: String(model || "").trim(),
+      model: resolvedExecutionModel,
       permissionMode: normalizedPermissionMode,
       env: nextEnv,
     });

package/lib/selftest-bot-commands.mjs

@@ -228,9 +228,31 @@ function runCLI({ cliPath, args, env, input = "" }) {
 export async function runSelftestBotCommands(push, deps) {
   const cliPath = String(requireDependency(deps, "cliPath") || "").trim();
   const parseSimpleEnvText = requireDependency(deps, "parseSimpleEnvText");
+  const resolveLocalAIExecutionModel = requireDependency(deps, "resolveLocalAIExecutionModel");
   let tempHome = "";
   let mock = null;
   try {
+    push(
+      "display_model_labels_map_to_tested_execution_ids",
+      resolveLocalAIExecutionModel("codex", "gpt-5.4") === "gpt-5.4"
+        && resolveLocalAIExecutionModel("codex", "gpt-5.3-codex") === "gpt-5.3-codex"
+        && resolveLocalAIExecutionModel("codex", "gpt-5.3-codex-spark") === "gpt-5.3-codex-spark"
+        && resolveLocalAIExecutionModel("codex", "GPT-5.4") === "gpt-5.4"
+        && resolveLocalAIExecutionModel("codex", "GPT-5.3-CODEX") === "gpt-5.3-codex"
+        && resolveLocalAIExecutionModel("codex", "GPT-5.3-CODEX-Spark") === "gpt-5.3-codex-spark"
+        && resolveLocalAIExecutionModel("claude", "Sonnet 4.6r") === "sonnet"
+        && resolveLocalAIExecutionModel("claude", "Haiku 4.5") === "haiku"
+        && resolveLocalAIExecutionModel("claude", "Opus 4.6") === "opus"
+        && resolveLocalAIExecutionModel("gemini", "Gemini 3.1 Pro") === "gemini-2.5-pro",
+      [
+        `gpt54=${resolveLocalAIExecutionModel("codex", "gpt-5.4")}`,
+        `gpt53codex=${resolveLocalAIExecutionModel("codex", "gpt-5.3-codex")}`,
+        `spark=${resolveLocalAIExecutionModel("codex", "gpt-5.3-codex-spark")}`,
+        `claude=${resolveLocalAIExecutionModel("claude", "Sonnet 4.6r")}`,
+        `gemini=${resolveLocalAIExecutionModel("gemini", "Gemini 3.1 Pro")}`,
+      ].join(" "),
+    );
+
     tempHome = fs.mkdtempSync(path.join(os.tmpdir(), "metheus-bot-selftest-"));
     mock = await createMockServer().listen();
     const env = buildSpawnEnv(tempHome);
@@ -684,7 +706,7 @@ export async function runSelftestBotCommands(push, deps) {
         "--server-bot-id", mock.bots[0].id,
         "--token", "selftest-main-token",
         "--ai-client", "gpt",
-        "--ai-model", "GPT-5.4",
+        "--ai-model", "gpt-5.4",
         "--ai-permission-mode", "read_only",
         "--ai-reasoning-effort", "low",
         "--verify", "true",
@@ -697,7 +719,7 @@ export async function runSelftestBotCommands(push, deps) {
       String(aliasAddState.TELEGRAM_BOT_MONITORSELFTESTBOT_SERVER_BOT_ID || "") === mock.bots[0].id
         && String(aliasAddState.TELEGRAM_BOT_MONITORSELFTESTBOT_USERNAME || "") === ""
         && String(aliasAddState.TELEGRAM_BOT_MONITORSELFTESTBOT_AI_CLIENT || "") === "codex"
-        && String(aliasAddState.TELEGRAM_BOT_MONITORSELFTESTBOT_AI_MODEL || "") === "GPT-5.4"
+        && String(aliasAddState.TELEGRAM_BOT_MONITORSELFTESTBOT_AI_MODEL || "") === "gpt-5.4"
         && String(aliasAddState.TELEGRAM_BOT_MONITORSELFTESTBOT_AI_PERMISSION_MODE || "") === "read_only"
         && String(aliasAddState.TELEGRAM_BOT_MONITORSELFTESTBOT_AI_REASONING_EFFORT || "") === "low",
       `client=${String(aliasAddState.TELEGRAM_BOT_MONITORSELFTESTBOT_AI_CLIENT || "")} model=${String(aliasAddState.TELEGRAM_BOT_MONITORSELFTESTBOT_AI_MODEL || "")}`,

package/package.json

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