metheus-governance-mcp-cli 0.2.81 → 0.2.83

package/README.md

@@ -232,7 +232,15 @@ Behavior:
 - For Telegram, the CLI tries to match the verified bot identity against the server `me/bots` list first. If the server exposes one logical bot name with multiple roles such as `approval`, `worker`, `review`, and `monitor`, the CLI does not ask you to choose one UUID. It binds by server bot name and keeps the local role/AI fields empty so runtime can use the server bot role for each route.
 - 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.
+- when the CLI asks for `AI model`, it now shows client-specific display labels 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.2`
+  - `GPT-5.3-CODEX` -> `gpt-5.2-codex`
+  - `GPT-5.3-CODEX-Spark` -> `gpt-5.1-codex-mini`
+  - `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.

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

@@ -1065,7 +1065,7 @@ function printBotList(provider, state, deps) {
           `    username: ${entry.username ? `@${entry.username}` : "-"}`,
           `    token: ${entry.token ? maskSecret(entry.token) : "-"}`,
           `    role_profile: ${entry.roleProfile || "-"}`,
-          `    ai_client: ${entry.client || "-"}`,
+          `    ai_client: ${entry.client ? displayLocalAIClientName(entry.client) : "-"}`,
           `    model: ${entry.model || "-"}`,
           `    permission_mode: ${entry.permissionMode || "-"}`,
           `    reasoning_effort: ${entry.reasoningEffort || "-"}`,
@@ -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: "display label; runs as gpt-5.2" },
+      { value: "GPT-5.3-CODEX", label: "GPT-5.3-CODEX", description: "display label; runs as gpt-5.2-codex" },
+      { value: "GPT-5.3-CODEX-Spark", label: "GPT-5.3-CODEX-Spark", description: "display label; runs as gpt-5.1-codex-mini" },
     ];
   }
   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") {
@@ -1949,7 +1949,7 @@ async function buildTelegramEntrySelectionRows(entries, flags, deps) {
     const descriptionParts = [
       current.key ? `local:${current.key}` : "",
       current.serverBotID ? `server:${current.serverBotID}` : "",
-      current.client ? `AI:${current.client}` : "",
+      current.client ? `AI:${displayLocalAIClientName(current.client)}` : "",
     ].filter(Boolean);
     return {
       value: current.key,
@@ -2423,7 +2423,7 @@ async function verifyProviderEntry(ui, provider, flags, deps) {
       provider === "telegram" ? `bot_key: ${envConfig.botKey || "-"}` : "",
       provider === "telegram" ? `server_bot_id: ${envConfig.serverBotID || "-"}` : "",
       provider === "telegram" ? `role_profile: ${envConfig.roleProfile || "-"}` : "",
-      provider === "telegram" ? `ai_client: ${envConfig.client || "-"}` : "",
+      provider === "telegram" ? `ai_client: ${envConfig.client ? displayLocalAIClientName(envConfig.client) : "-"}` : "",
       provider === "telegram" ? `ai_model: ${envConfig.model || "-"}` : "",
       provider === "telegram" ? `permission_mode: ${envConfig.permissionMode || "-"}` : "",
       provider === "telegram" ? `reasoning_effort: ${envConfig.reasoningEffort || "-"}` : "",

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.2",
+      aliases: ["gpt-5.4", "gpt 5.4", "gpt-5.2", "gpt 5.2", "gpt-5"],
+    },
+    {
+      display: "GPT-5.3-CODEX",
+      execution: "gpt-5.2-codex",
+      aliases: ["gpt-5.3-codex", "gpt 5.3 codex", "gpt-5.2-codex", "gpt 5.2 codex", "gpt-5-codex"],
+    },
+    {
+      display: "GPT-5.3-CODEX-Spark",
+      execution: "gpt-5.1-codex-mini",
+      aliases: ["gpt-5.3-codex-spark", "gpt 5.3 codex spark", "gpt-5.1-codex-mini", "gpt 5.1 codex mini"],
+    },
+  ],
+  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,28 @@ 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.2"
+        && resolveLocalAIExecutionModel("codex", "GPT-5.3-CODEX") === "gpt-5.2-codex"
+        && resolveLocalAIExecutionModel("codex", "GPT-5.3-CODEX-Spark") === "gpt-5.1-codex-mini"
+        && 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);

package/package.json

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