metheus-governance-mcp-cli 0.2.74 → 0.2.75

package/lib/bot-commands.mjs

@@ -108,6 +108,70 @@ function maskSecret(rawValue) {
   return `${text.slice(0, 4)}...${text.slice(-4)}`;
 }
 
+function supportsANSIColors() {
+  if (process.env.NO_COLOR) return false;
+  if (!process.stdout?.isTTY) return false;
+  const term = String(process.env.TERM || "").trim().toLowerCase();
+  return term !== "dumb";
+}
+
+function colorText(text, colorCode) {
+  const value = String(text || "");
+  if (!value || !supportsANSIColors()) return value;
+  return `\u001b[${colorCode}m${value}\u001b[0m`;
+}
+
+function padRight(text, width) {
+  const value = String(text || "");
+  if (value.length >= width) return value.slice(0, width);
+  return `${value}${" ".repeat(width - value.length)}`;
+}
+
+function wrapAsciiLine(text, width) {
+  const value = String(text || "");
+  if (!value) return [""];
+  const words = value.split(/\s+/).filter(Boolean);
+  if (!words.length) return [""];
+  const lines = [];
+  let current = "";
+  words.forEach((word) => {
+    const candidate = current ? `${current} ${word}` : word;
+    if (candidate.length <= width) {
+      current = candidate;
+      return;
+    }
+    if (current) {
+      lines.push(current);
+      current = word;
+      return;
+    }
+    let remaining = word;
+    while (remaining.length > width) {
+      lines.push(remaining.slice(0, width));
+      remaining = remaining.slice(width);
+    }
+    current = remaining;
+  });
+  if (current) lines.push(current);
+  return lines.length ? lines : [""];
+}
+
+function formatAsciiBlock(title, lines = [], { accentColor = "36" } = {}) {
+  const contentWidth = 62;
+  const blockLines = [
+    title ? String(title || "").trim() : "",
+    ...ensureArray(lines).flatMap((line) => wrapAsciiLine(line, contentWidth)),
+  ].filter((line, index, all) => !(index > 0 && !line && !all[index - 1]));
+  const border = `+${"-".repeat(contentWidth + 2)}+`;
+  const formatted = [colorText(border, accentColor)];
+  blockLines.forEach((line, index) => {
+    const rendered = `| ${padRight(line, contentWidth)} |`;
+    formatted.push(index === 0 ? colorText(rendered, accentColor) : rendered);
+  });
+  formatted.push(colorText(border, accentColor));
+  return `${formatted.join("\n")}\n`;
+}
+
 function formatEnvValue(rawValue) {
   const text = String(rawValue ?? "");
   if (!text) return "";
@@ -125,6 +189,13 @@ function providerTokenKey(provider, deps) {
   return safeObject(requireDependency(deps, "providerEnvConfig")(provider)).tokenKey || "";
 }
 
+function shouldRenderPromptChrome(flags) {
+  const parsedFlags = safeObject(flags);
+  if (boolFromRaw(parsedFlags["non-interactive"] ?? parsedFlags.yes, false)) return false;
+  if (boolFromRaw(parsedFlags.json, false)) return false;
+  return true;
+}
+
 function printBotUsage(deps) {
   const cliName = String(deps?.cliName || "metheus-governance-mcp-cli").trim() || "metheus-governance-mcp-cli";
   process.stdout.write(
@@ -156,6 +227,24 @@ function printBotUsage(deps) {
 }
 
 function createPrompter() {
+  let flowTitle = "";
+  let flowSubtitle = "";
+  let stepIndex = 0;
+  function write(text) {
+    process.stdout.write(String(text || ""));
+  }
+  function printFlowBanner() {
+    if (!flowTitle) return;
+    const lines = flowSubtitle ? [flowSubtitle] : [];
+    write(`\n${formatAsciiBlock(flowTitle, lines, { accentColor: "35" })}`);
+  }
+  function beginPrompt(title, lines = []) {
+    stepIndex += 1;
+    const bannerTitle = flowTitle
+      ? `${flowTitle} | STEP ${stepIndex}`
+      : `STEP ${stepIndex}`;
+    write(`\n${formatAsciiBlock(bannerTitle, [title, ...ensureArray(lines)], { accentColor: "36" })}`);
+  }
   const scriptedPromptAnswersRaw = String(process.env.METHEUS_SCRIPTED_PROMPT_ANSWERS || "").trim();
   if (scriptedPromptAnswersRaw) {
     let scriptedAnswers = [];
@@ -167,17 +256,31 @@ function createPrompter() {
     }
     let answerIndex = 0;
     return {
+      setFlow(title, subtitle = "") {
+        flowTitle = String(title || "").trim();
+        flowSubtitle = String(subtitle || "").trim();
+        stepIndex = 0;
+        printFlowBanner();
+      },
+      beginPrompt,
       ask(promptText) {
-        process.stdout.write(promptText);
+        write(promptText);
         const answer = answerIndex < scriptedAnswers.length ? scriptedAnswers[answerIndex] : "";
         answerIndex += 1;
-        process.stdout.write(`${answer}\n`);
+        write(`${answer}\n`);
         return Promise.resolve(String(answer || ""));
       },
       close() {},
     };
   }
   return {
+    setFlow(title, subtitle = "") {
+      flowTitle = String(title || "").trim();
+      flowSubtitle = String(subtitle || "").trim();
+      stepIndex = 0;
+      printFlowBanner();
+    },
+    beginPrompt,
     ask(promptText) {
       return new Promise((resolve) => {
         const rl = readline.createInterface({
@@ -195,8 +298,13 @@ function createPrompter() {
 }
 
 async function promptLine(ui, promptText, defaultValue = "") {
+  ui.beginPrompt(promptText, [
+    String(defaultValue || "").trim()
+      ? `Press Enter to keep the current value: ${defaultValue}`
+      : "Type a value and press Enter.",
+  ]);
   const suffix = String(defaultValue || "").trim() ? ` [${defaultValue}]` : "";
-  const answer = await ui.ask(`${promptText}${suffix}: `);
+  const answer = await ui.ask(`${colorText(">", "32")} ${promptText}${suffix}: `);
   const text = String(answer || "").trim();
   return text || String(defaultValue || "").trim();
 }
@@ -205,18 +313,19 @@ async function promptRequiredLine(ui, promptText, defaultValue = "") {
   while (true) {
     const answer = await promptLine(ui, promptText, defaultValue);
     if (answer) return answer;
-    process.stdout.write("Value is required.\n");
+    process.stdout.write(`${colorText("Value is required.\n", "31")}`);
   }
 }
 
 async function promptYesNo(ui, promptText, defaultValue = true) {
+  ui.beginPrompt(promptText, ["Choose y or n, then press Enter."]);
   const hint = defaultValue ? "Y/n" : "y/N";
   while (true) {
-    const answer = String(await ui.ask(`${promptText} [${hint}]: `) || "").trim().toLowerCase();
+    const answer = String(await ui.ask(`${colorText(">", "32")} ${promptText} [${hint}]: `) || "").trim().toLowerCase();
     if (!answer) return defaultValue;
     if (["y", "yes", "1", "true"].includes(answer)) return true;
     if (["n", "no", "0", "false"].includes(answer)) return false;
-    process.stdout.write("Choose y or n.\n");
+    process.stdout.write(`${colorText("Choose y or n.\n", "31")}`);
   }
 }
 
@@ -249,16 +358,20 @@ async function promptChoice(ui, title, options, { defaultIndex = 0, allowCancel
   if (!list.length) {
     throw new Error(`no options available for ${title}`);
   }
+  const guidance = [
+    "Choose one option by number and press Enter.",
+    allowCancel ? "Enter 0 to cancel." : "",
+  ].filter(Boolean);
+  ui.beginPrompt(title, guidance);
   while (true) {
-    process.stdout.write(`${title}\n`);
     list.forEach((option, index) => {
-      process.stdout.write(`  ${index + 1}. ${formatChoiceLabel(option)}\n`);
+      process.stdout.write(`  ${colorText(`[${index + 1}]`, "33")} ${formatChoiceLabel(option)}\n`);
     });
     if (allowCancel) {
-      process.stdout.write("  0. Cancel\n");
+      process.stdout.write(`  ${colorText("[0]", "33")} Cancel\n`);
     }
     const defaultLabel = defaultIndex >= 0 && defaultIndex < list.length ? String(defaultIndex + 1) : "";
-    const answer = String(await ui.ask(`> ${defaultLabel ? `[${defaultLabel}] ` : ""}`) || "").trim();
+    const answer = String(await ui.ask(`${colorText(">", "32")} ${defaultLabel ? `[${defaultLabel}] ` : ""}`) || "").trim();
     if (!answer && defaultLabel) {
       return list[defaultIndex];
     }
@@ -267,7 +380,7 @@ async function promptChoice(ui, title, options, { defaultIndex = 0, allowCancel
     if (Number.isFinite(numeric) && numeric >= 1 && numeric <= list.length) {
       return list[numeric - 1];
     }
-    process.stdout.write("Select a valid number.\n");
+    process.stdout.write(`${colorText("Select a valid number.\n", "31")}`);
   }
 }
 
@@ -2254,6 +2367,9 @@ async function removeTokenOnlyProvider(ui, provider, flags, deps) {
 }
 
 async function runBotSetup(ui, flags, deps) {
+  if (shouldRenderPromptChrome(flags)) {
+    ui.setFlow("BOT SETUP", "Guided local bot management");
+  }
   const provider = await selectProvider(ui, flags.provider, deps);
   const telegramActions = [
     { value: "list", label: "List bots" },
@@ -2384,6 +2500,9 @@ async function runBotShow(ui, flags, deps, explicitProvider = "") {
 }
 
 async function runBotAdd(ui, flags, deps) {
+  if (shouldRenderPromptChrome(flags)) {
+    ui.setFlow("BOT ADD", "Create a local bot entry from server bot identity and local token");
+  }
   const provider = await selectProvider(ui, flags.provider, deps);
   if (provider === "telegram") {
     await addTelegramBot(ui, flags, deps);
@@ -2393,6 +2512,9 @@ async function runBotAdd(ui, flags, deps) {
 }
 
 async function runBotEdit(ui, flags, deps) {
+  if (shouldRenderPromptChrome(flags)) {
+    ui.setFlow("BOT EDIT", "Update an existing local bot entry");
+  }
   const provider = await selectProvider(ui, flags.provider, deps);
   if (provider === "telegram") {
     await editTelegramBot(ui, flags, deps);
@@ -2402,6 +2524,9 @@ async function runBotEdit(ui, flags, deps) {
 }
 
 async function runBotRemove(ui, flags, deps) {
+  if (shouldRenderPromptChrome(flags)) {
+    ui.setFlow("BOT REMOVE", "Delete a local bot entry");
+  }
   const provider = await selectProvider(ui, flags.provider, deps);
   if (provider === "telegram") {
     const nonInteractive = boolFromRaw(flags["non-interactive"] ?? flags.yes, false);
@@ -2427,11 +2552,17 @@ async function runBotRemove(ui, flags, deps) {
 }
 
 async function runBotVerify(ui, flags, deps) {
+  if (shouldRenderPromptChrome(flags)) {
+    ui.setFlow("BOT VERIFY", "Check local token, server binding, and linked routes");
+  }
   const provider = await selectProvider(ui, flags.provider, deps);
   await verifyProviderEntry(ui, provider, flags, deps);
 }
 
 async function runBotSetDefault(ui, flags, deps) {
+  if (shouldRenderPromptChrome(flags)) {
+    ui.setFlow("BOT SET-DEFAULT", "Choose the default Telegram local entry");
+  }
   const provider = await selectProvider(ui, flags.provider, deps);
   if (provider !== "telegram") {
     throw new Error("bot set-default currently supports only --provider telegram");
@@ -2461,6 +2592,9 @@ async function runBotSetDefault(ui, flags, deps) {
 }
 
 async function runBotMigrate(ui, flags, deps) {
+  if (shouldRenderPromptChrome(flags)) {
+    ui.setFlow("BOT MIGRATE", "Convert legacy Telegram token config into a named entry");
+  }
   const provider = String(flags.provider || "").trim()
     ? requireDependency(deps, "normalizeBotProvider")(flags.provider)
     : "telegram";
@@ -2511,6 +2645,9 @@ async function runBotMigrate(ui, flags, deps) {
 }
 
 async function runBotGlobal(ui, flags, deps) {
+  if (shouldRenderPromptChrome(flags)) {
+    ui.setFlow("BOT GLOBAL", "Edit Telegram global local settings");
+  }
   const provider = String(flags.provider || "").trim()
     ? requireDependency(deps, "normalizeBotProvider")(flags.provider)
     : "telegram";

package/package.json

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