metheus-governance-mcp-cli 0.2.104 → 0.2.105

package/README.md

@@ -95,7 +95,7 @@ Runner template:
   },
   "role_profiles": {
     "monitor": {
-      "client": "codex",
+      "client": "gpt",
       "model": "",
       "permission_mode": "read_only",
       "reasoning_effort": "low"
@@ -106,7 +106,7 @@ Runner template:
       "bot_id": "<server_bot_uuid>",
       "bot_name": "<bot_name>",
       "role_profile": "monitor",
-      "client": "codex",
+      "client": "gpt",
       "model": "",
       "permission_mode": "read_only",
       "reasoning_effort": "low"
@@ -194,15 +194,18 @@ Fill provider bot secrets and provider-local transport options locally. Project
 Built-in helper command for legacy fallback/testing:
 
 ```bash
-metheus-governance-mcp-cli local-bot-bridge --client codex --no-update
+metheus-governance-mcp-cli local-bot-bridge --client gpt --no-update
 ```
 
 Supported `--client` values:
-- `codex`
+- `gpt`
 - `claude`
 - `gemini`
 - `sample`
 
+Compatibility note:
+- `codex` is still accepted as an alias for `gpt` because the GPT adapter runs through the Codex CLI binary.
+
 Use `sample` first for smoke tests before switching to a real AI client.
 
 Gemini CLI note:
@@ -378,7 +381,7 @@ Execution model:
 - local runner stores workspace mapping and role profiles
 - runner resolves `project_id -> workspace_dir`
 - runner resolves server bot role to a local `role_profile`
-- runner executes the mapped client adapter (`codex` / `claude` / `gemini`)
+- runner executes the mapped client adapter (`gpt` / `claude` / `gemini`)
 - legacy `command` remains readable for migration, but execution is disabled by default unless `METHEUS_ALLOW_LEGACY_RUNNER_COMMAND=1`
 
 Commands:
@@ -421,7 +424,8 @@ Why `workspace_dir` matters:
 - without a valid project mapping, bots may answer with a generic local root instead of the real project workspace
 
 Role profile fields:
-- `client`: `codex`, `claude`, `gemini`, or `sample`
+- `client`: `gpt`, `claude`, `gemini`, or `sample`
+- `codex` is still accepted as a compatibility alias for `gpt`
 - `model`: optional CLI-specific model name
 - `permission_mode`: `read_only`, `workspace_write`, `danger_full_access`
 - `reasoning_effort`: `low`, `medium`, `high`

package/cli.mjs

@@ -185,7 +185,7 @@ const CTXPACK_PUSH_TOOL_NAMES = ["ctxpack.push", "ctxpack.update", "ctxpack.save
 const CLI_META = loadCLIMeta();
 const CLI_NAME = CLI_META.name || "metheus-governance-mcp-cli";
 const CLI_VERSION = CLI_META.version || "0.0.0";
-const DEFAULT_BOT_RUNNER_CLIENT = DEFAULT_LOCAL_AI_CLIENT;
+const DEFAULT_BOT_RUNNER_CLIENT = "gpt";
 const SELF_UPDATE_CHECK_INTERVAL_MS = 6 * 60 * 60 * 1000;
 const SELF_UPDATE_TIMEOUT_SECONDS = 6;
 const SELF_UPDATE_ENV_KEY = "METHEUS_CLI_AUTO_UPDATE";
@@ -253,7 +253,7 @@ function printUsage() {
       `  ${cmd} doctor [--project-id <uuid>] [--ctxpack-key <key>] [--base-url <url>] [--timeout-seconds <n>] [--strict <true|false>]`,
       `  ${cmd} proxy [--project-id <uuid>] [--ctxpack-key <key>] [--base-url <url>] [--workspace-dir <path|auto>] [--include-drafts <true|false>] [--auto-pull-on-conflict <true|false>] [--timeout-seconds <n>]`,
       `  ${cmd} selftest [--json <true|false>]`,
-      `  ${cmd} local-bot-bridge [--client <codex|claude|gemini|sample>] [--cwd <path>] [--model <name>] [--permission-mode <read_only|workspace_write|danger_full_access>] [--reasoning-effort <low|medium|high>]`,
+      `  ${cmd} local-bot-bridge [--client <gpt|claude|gemini|sample>] [--cwd <path>] [--model <name>] [--permission-mode <read_only|workspace_write|danger_full_access>] [--reasoning-effort <low|medium|high>]`,
       `  ${cmd} runner list [--json <true|false>]`,
       `  ${cmd} runner once [--route-name <name> | --bot-name <server_name> | --bot-id <uuid>] [--project-id <uuid>] [--provider <telegram|slack|kakaotalk>] [--role <monitor|review|worker|approval>] [--role-profile <name>] [--mentions-only <true|false>] [--reply-to-bot-messages <true|false>] [--direct-messages <true|false>] [--ignore-edited-messages <true|false>] [--dry-run-delivery <true|false>] [--context-comments <n>] [--archive-replies <true|false>]`,
       `  ${cmd} runner start [--route-name <name> | --bot-name <server_name> | --bot-id <uuid>] [--project-id <uuid>] [--provider <telegram|slack|kakaotalk>] [--role <monitor|review|worker|approval>] [--role-profile <name>] [--mentions-only <true|false>] [--reply-to-bot-messages <true|false>] [--direct-messages <true|false>] [--ignore-edited-messages <true|false>] [--dry-run-delivery <true|false>] [--poll-interval-ms <n>] [--context-comments <n>] [--archive-replies <true|false>]`,
@@ -832,7 +832,7 @@ function defaultLocalBotBridgeCommand(client = DEFAULT_BOT_RUNNER_CLIENT) {
 function defaultBotRunnerRoleProfiles() {
   return {
     monitor: {
-      client: "codex",
+      client: "gpt",
       model: "",
       permission_mode: "read_only",
       reasoning_effort: "low",
@@ -844,7 +844,7 @@ function defaultBotRunnerRoleProfiles() {
       reasoning_effort: "medium",
     },
     worker: {
-      client: "codex",
+      client: "gpt",
       model: "",
       permission_mode: "danger_full_access",
       reasoning_effort: "medium",
@@ -1243,6 +1243,7 @@ function normalizeBotRunnerConfigContents(parsed, filePath) {
   const defaults = defaultBotRunnerRoleProfiles();
   const rawRoleProfiles = safeObject(raw.role_profiles || raw.roleProfiles);
   const roleProfiles = {};
+  let migrated = rawVersion < BOT_RUNNER_CONFIG_VERSION;
   const roleProfileNames = new Set([
     ...Object.keys(defaults),
     ...Object.keys(rawRoleProfiles).map((name) => normalizeRunnerRoleProfileName(name)).filter(Boolean),
@@ -1253,6 +1254,10 @@ function normalizeBotRunnerConfigContents(parsed, filePath) {
       rawRoleProfiles[profileName],
       defaults[profileName] || {},
     );
+    const rawClient = String(safeObject(rawRoleProfiles[profileName]).client || safeObject(rawRoleProfiles[profileName]).cli || "").trim().toLowerCase();
+    if (rawClient === "codex") {
+      migrated = true;
+    }
   }
 
   const botBindings = {};
@@ -1262,6 +1267,10 @@ function normalizeBotRunnerConfigContents(parsed, filePath) {
     if (!binding.name || (!binding.botID && !binding.botName)) continue;
     if (!binding.roleProfile && !binding.client && !binding.model && !binding.permissionMode && !binding.reasoningEffort) continue;
     botBindings[binding.name] = binding;
+    const rawClient = String(safeObject(rawBinding).client || "").trim().toLowerCase();
+    if (rawClient === "codex") {
+      migrated = true;
+    }
   }
 
   const projectMappings = {};
@@ -1274,7 +1283,6 @@ function normalizeBotRunnerConfigContents(parsed, filePath) {
   }
 
   const routes = [];
-  let migrated = rawVersion < BOT_RUNNER_CONFIG_VERSION;
   for (const rawRoute of ensureArray(raw.routes)) {
     const routeSource = safeObject(rawRoute);
     const route = normalizeRunnerRoute(routeSource);

package/lib/bot-commands.mjs

@@ -813,7 +813,7 @@ function telegramEntryDisplayName(entry) {
 
 function displayLocalAIClientName(clientName) {
   const normalized = String(clientName || "").trim().toLowerCase();
-  if (normalized === "codex" || normalized === "gpt") return "GPT";
+  if (normalized === "gpt" || normalized === "codex") return "GPT";
   if (normalized === "claude") return "Claude";
   if (normalized === "gemini") return "Gemini";
   if (normalized === "sample") return "Sample";
@@ -1758,7 +1758,7 @@ async function promptAIClient(ui, deps, defaultValue = "") {
 
 function suggestedAIModelsForClient(clientName) {
   const normalizedClient = String(clientName || "").trim().toLowerCase();
-  if (normalizedClient === "codex") {
+  if (normalizedClient === "gpt") {
     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 model" },

package/lib/local-ai-adapters.mjs

@@ -3,8 +3,8 @@ import os from "node:os";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 
-export const SUPPORTED_LOCAL_AI_CLIENTS = ["codex", "claude", "gemini", "sample"];
-export const DEFAULT_LOCAL_AI_CLIENT = "codex";
+export const SUPPORTED_LOCAL_AI_CLIENTS = ["gpt", "claude", "gemini", "sample"];
+export const DEFAULT_LOCAL_AI_CLIENT = "gpt";
 
 const SUPPORTED_PERMISSION_MODES = ["read_only", "workspace_write", "danger_full_access"];
 const SUPPORTED_REASONING_EFFORTS = ["low", "medium", "high"];
@@ -18,7 +18,7 @@ const GEMINI_HOME_SYNC_FILES = [
   "settings.json",
 ];
 const LOCAL_AI_MODEL_MAPPINGS = {
-  codex: [
+  gpt: [
     {
       display: "gpt-5.4",
       execution: "gpt-5.4",
@@ -589,8 +589,8 @@ function runSampleAdapter(payload) {
 
 export function normalizeLocalAIClientName(rawValue, fallback = DEFAULT_LOCAL_AI_CLIENT) {
   const value = String(rawValue || "").trim().toLowerCase();
-  if (["gpt", "openai-gpt", "openai"].includes(value)) {
-    return "codex";
+  if (["gpt", "openai-gpt", "openai", "codex"].includes(value)) {
+    return "gpt";
   }
   if (SUPPORTED_LOCAL_AI_CLIENTS.includes(value)) {
     return value;
@@ -734,7 +734,7 @@ export function runLocalAIClient({
     METHEUS_AI_RUNNER_REASONING_EFFORT: normalizedReasoningEffort,
     METHEUS_RUNNER_WORKSPACE_DIR: resolvedWorkspaceDir,
   };
-  if (normalizedClient === "codex") {
+  if (normalizedClient === "gpt") {
     return runCodexAdapter({
       promptText,
       workspaceDir: resolvedWorkspaceDir,

package/lib/selftest-bot-commands.mjs

@@ -236,20 +236,20 @@ export async function runSelftestBotCommands(push, deps) {
   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("gpt", "gpt-5.4") === "gpt-5.4"
+        && resolveLocalAIExecutionModel("gpt", "gpt-5.3-codex") === "gpt-5.3-codex"
+        && resolveLocalAIExecutionModel("gpt", "gpt-5.3-codex-spark") === "gpt-5.3-codex-spark"
+        && resolveLocalAIExecutionModel("gpt", "GPT-5.4") === "gpt-5.4"
+        && resolveLocalAIExecutionModel("gpt", "GPT-5.3-CODEX") === "gpt-5.3-codex"
+        && resolveLocalAIExecutionModel("gpt", "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") === "auto-gemini-3",
       [
-        `gpt54=${resolveLocalAIExecutionModel("codex", "gpt-5.4")}`,
-        `gpt53codex=${resolveLocalAIExecutionModel("codex", "gpt-5.3-codex")}`,
-        `spark=${resolveLocalAIExecutionModel("codex", "gpt-5.3-codex-spark")}`,
+        `gpt54=${resolveLocalAIExecutionModel("gpt", "gpt-5.4")}`,
+        `gpt53codex=${resolveLocalAIExecutionModel("gpt", "gpt-5.3-codex")}`,
+        `spark=${resolveLocalAIExecutionModel("gpt", "gpt-5.3-codex-spark")}`,
         `claude=${resolveLocalAIExecutionModel("claude", "Sonnet 4.6r")}`,
         `gemini=${resolveLocalAIExecutionModel("gemini", "gemini-3.1-pro")}`,
       ].join(" "),
@@ -257,11 +257,11 @@ export async function runSelftestBotCommands(push, deps) {
 
     push(
       "blank_model_defaults_to_first_display_model_for_each_client",
-      suggestLocalAIModelDisplayName("codex", "") === "gpt-5.4"
+      suggestLocalAIModelDisplayName("gpt", "") === "gpt-5.4"
         && suggestLocalAIModelDisplayName("claude", "") === "Sonnet 4.6r"
         && suggestLocalAIModelDisplayName("gemini", "") === "gemini-3.1-pro",
       [
-        `codex=${suggestLocalAIModelDisplayName("codex", "")}`,
+        `gpt=${suggestLocalAIModelDisplayName("gpt", "")}`,
         `claude=${suggestLocalAIModelDisplayName("claude", "")}`,
         `gemini=${suggestLocalAIModelDisplayName("gemini", "")}`,
       ].join(" "),
@@ -367,7 +367,7 @@ export async function runSelftestBotCommands(push, deps) {
         && String(addState.TELEGRAM_BOT_SERVER_ROLES || "") === "monitor"
         && String(addState.TELEGRAM_BOT_TOKEN || "") === "selftest-main-token"
         && String(addState.TELEGRAM_BOT_ROLE_PROFILE || "") === "monitor"
-        && String(addState.TELEGRAM_BOT_AI_CLIENT || "") === "codex"
+        && String(addState.TELEGRAM_BOT_AI_CLIENT || "") === "gpt"
         && String(addState.TELEGRAM_BOT_AI_PERMISSION_MODE || "") === "read_only"
         && String(addState.TELEGRAM_BOT_AI_REASONING_EFFORT || "") === "low"
         && String(addGlobals.TELEGRAM_DEFAULT_BOT_KEY || "") === "monitorselftestbot",
@@ -553,7 +553,7 @@ export async function runSelftestBotCommands(push, deps) {
     push(
       "bot_show_returns_selected_telegram_entry",
       safeObject(showPayload.entry).key === "monitorselftestbot"
-        && safeObject(showPayload.entry).client === "codex"
+        && safeObject(showPayload.entry).client === "gpt"
         && safeObject(showPayload.serverBinding).mode === "single",
       `key=${String(safeObject(showPayload.entry).key || "")} client=${String(safeObject(showPayload.entry).client || "")} mode=${String(safeObject(showPayload.serverBinding).mode || "")}`,
     );
@@ -773,7 +773,7 @@ export async function runSelftestBotCommands(push, deps) {
       String(aliasAddState.TELEGRAM_BOT_SERVER_BOT_ID || "") === mock.bots[0].id
         && String(aliasAddState.TELEGRAM_BOT_SERVER_NAME || "") === "MonitorSelftestBot"
         && String(aliasAddState.TELEGRAM_BOT_SERVER_ROLES || "") === "monitor"
-        && String(aliasAddState.TELEGRAM_BOT_AI_CLIENT || "") === "codex"
+        && String(aliasAddState.TELEGRAM_BOT_AI_CLIENT || "") === "gpt"
         && String(aliasAddState.TELEGRAM_BOT_AI_MODEL || "") === "gpt-5.4"
         && String(aliasAddState.TELEGRAM_BOT_AI_PERMISSION_MODE || "") === "read_only"
         && String(aliasAddState.TELEGRAM_BOT_AI_REASONING_EFFORT || "") === "low",

package/package.json

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

package/postinstall.mjs

@@ -75,7 +75,7 @@ function botRunnerTemplate() {
       },
       role_profiles: {
         monitor: {
-          client: "codex",
+          client: "gpt",
           model: "",
           permission_mode: "read_only",
           reasoning_effort: "low",
@@ -87,7 +87,7 @@ function botRunnerTemplate() {
           reasoning_effort: "medium",
         },
         worker: {
-          client: "codex",
+          client: "gpt",
           model: "",
           permission_mode: "danger_full_access",
           reasoning_effort: "medium",
@@ -104,7 +104,7 @@ function botRunnerTemplate() {
           bot_id: "<server_bot_uuid>",
           bot_name: "<bot_name>",
           role_profile: "monitor",
-          client: "codex",
+          client: "gpt",
           model: "",
           permission_mode: "read_only",
           reasoning_effort: "low",