gitlab-duo-mcp-bridge 0.2.0 → 0.3.0

package/dist/src/config.js

@@ -30,13 +30,28 @@ function isTruthy(value) {
         return false;
     return ["1", "true", "yes", "on"].includes(value.trim().toLowerCase());
 }
+export function resolveModel(model) {
+    if (!model)
+        return undefined;
+    const MODEL_MAPPING = {
+        sonnet: "claude_sonnet_4_6",
+        haiku: "claude_haiku_4_5_20251001",
+        opus: "claude_opus_4_5_20251101",
+        "gpt5-codex": "gpt_5_codex",
+        gpt5: "gpt_5",
+        "gpt5-mini": "gpt_5_mini",
+        gemini: "gemini_2_5_flash_vertex",
+    };
+    const key = model.trim().toLowerCase();
+    return MODEL_MAPPING[key] ?? model;
+}
 export function loadConfig(env = process.env) {
     return {
         command: trimmedOrUndefined(env.DUO_CLI_COMMAND) ?? "glab",
         baseArgs: splitArgs(env.DUO_CLI_BASE_ARGS, ["duo", "cli", "run"]),
         goalFlag: trimmedOrUndefined(env.DUO_CLI_GOAL_FLAG) ?? "--goal",
         modelFlag: trimmedOrUndefined(env.DUO_CLI_MODEL_FLAG) ?? "--model",
-        model: trimmedOrUndefined(env.GITLAB_DUO_MODEL),
+        model: resolveModel(trimmedOrUndefined(env.GITLAB_DUO_MODEL)),
         extraArgs: splitArgs(env.DUO_CLI_EXTRA_ARGS, []),
         timeoutMs: parseIntOr(env.DUO_TIMEOUT_MS, 120_000),
         cwd: trimmedOrUndefined(env.DUO_CLI_CWD),

package/dist/src/server.js

@@ -4,6 +4,7 @@
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
+import { resolveModel } from "./config.js";
 import { buildReviewGoal } from "./goal.js";
 import { runDuo } from "./duoRunner.js";
 import { buildPointerGoal, writeGoalFile, } from "./goalFile.js";
@@ -119,7 +120,7 @@ export async function handleReview(config, input) {
                 baseArgs: config.baseArgs,
                 goalFlag: config.goalFlag,
                 modelFlag: config.modelFlag,
-                model: input.model ?? config.model,
+                model: resolveModel(input.model) ?? config.model,
                 extraArgs: config.extraArgs,
                 timeoutMs: input.timeoutMs ?? config.timeoutMs,
                 cwd: effectiveCwd,

package/dist/src/setup.js

@@ -1,6 +1,11 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import os from "node:os";
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
 export async function runSetup() {
     const home = os.homedir();
     const platform = os.platform();
@@ -143,18 +148,102 @@ export async function runSetup() {
         path: path.join(home, ".continue", "mcpServers", "gitlab-duo.json"),
         key: "raw",
     });
-    process.stderr.write("Iniciando la configuración automática de gitlab-duo-mcp-bridge...\n\n");
-    let configuredCount = 0;
+    process.stderr.write("Starting setup of gitlab-duo-mcp-bridge...\n\n");
+    const rl = readline.createInterface({ input, output });
+    process.stderr.write("Where would you like to configure gitlab-duo-mcp-bridge?\n");
+    process.stderr.write("  1. Globally (system-wide for detected IDEs & MCP clients)\n");
+    process.stderr.write("  2. Locally (in the current project directory)\n\n");
+    let choice = "1";
+    try {
+        const choiceAnswer = await rl.question("Enter choice (1 or 2) [1]: ");
+        if (choiceAnswer.trim() === "2" || choiceAnswer.trim().toLowerCase() === "locally") {
+            choice = "2";
+        }
+    }
+    catch (err) {
+        // Gracefully fallback to choice "1" on any error
+    }
+    if (choice === "2") {
+        rl.close();
+        process.stderr.write("\nConfiguring locally in the current project directory...\n\n");
+        const localPath = path.join(process.cwd(), "mcp.json");
+        try {
+            let config = {};
+            try {
+                const content = await fs.readFile(localPath, "utf8");
+                if (content.trim() !== "") {
+                    config = JSON.parse(content);
+                }
+            }
+            catch (err) {
+                if (err.code !== "ENOENT") {
+                    process.stderr.write(`⚠️ Could not read or parse existing mcp.json at ${localPath}: ${err.message}\n`);
+                }
+            }
+            if (!config.mcpServers) {
+                config.mcpServers = {};
+            }
+            config.mcpServers["gitlab-duo"] = newConfigEntry;
+            await fs.writeFile(localPath, JSON.stringify(config, null, 2), "utf8");
+            process.stderr.write(`✅ Successfully configured locally: mcp.json\n   └─ Path: ${localPath}\n\n`);
+            process.stderr.write("🎉 Configuration complete!\n");
+            process.stderr.write("Remember to restart or reload your AI client/agent to detect the 'duo_review' tool.\n");
+            await checkGitLabConnection();
+            printMiniGuide();
+        }
+        catch (err) {
+            process.stderr.write(`❌ Error configuring locally at ${localPath}: ${err.message}\n`);
+        }
+        return;
+    }
+    process.stderr.write("\nScanning for active MCP client configuration directories...\n\n");
+    const detectedTargets = [];
     for (const target of targets) {
         const parentDir = path.dirname(target.path);
         try {
-            // Check if parent directory exists
             await fs.access(parentDir);
+            detectedTargets.push(target);
         }
         catch {
             // Parent directory does not exist, so client is likely not installed or used. Skip it.
-            continue;
         }
+    }
+    if (detectedTargets.length === 0) {
+        rl.close();
+        process.stderr.write("⚠️ No active MCP client configuration directories were found.\n");
+        process.stderr.write("If you use Claude Desktop, Cursor, Cline, Roo Code, Windsurf, Zed, or Continue, please make sure they are installed and have been opened at least once.\n");
+        return;
+    }
+    process.stderr.write("We detected the following MCP client(s):\n");
+    detectedTargets.forEach((target, index) => {
+        process.stderr.write(`  ${index + 1}. ${target.name}\n`);
+    });
+    process.stderr.write("\n");
+    let selectedTargets = detectedTargets;
+    try {
+        const answer = await rl.question("Do you want to configure all detected clients? (Y/n): ");
+        const parsedAnswer = answer.trim().toLowerCase();
+        if (parsedAnswer !== "" && parsedAnswer !== "y" && parsedAnswer !== "yes") {
+            selectedTargets = [];
+            for (const target of detectedTargets) {
+                const individualAnswer = await rl.question(`Configure ${target.name}? (y/N): `);
+                if (individualAnswer.trim().toLowerCase().startsWith("y")) {
+                    selectedTargets.push(target);
+                }
+            }
+        }
+    }
+    finally {
+        rl.close();
+    }
+    if (selectedTargets.length === 0) {
+        process.stderr.write("\n⚠️ No clients were selected for configuration.\n");
+        return;
+    }
+    process.stderr.write("\n");
+    let configuredCount = 0;
+    for (const target of selectedTargets) {
+        const parentDir = path.dirname(target.path);
         try {
             let config = {};
             if (target.key === "raw") {
@@ -176,7 +265,7 @@ export async function runSetup() {
                 }
                 catch (err) {
                     if (err.code !== "ENOENT") {
-                        process.stderr.write(`⚠️ No se pudo leer o parsear ${target.name} en ${target.path}: ${err.message}\n`);
+                        process.stderr.write(`⚠️ Could not read or parse ${target.name} at ${target.path}: ${err.message}\n`);
                         continue;
                     }
                 }
@@ -190,20 +279,76 @@ export async function runSetup() {
             await fs.mkdir(parentDir, { recursive: true });
             // Write config back
             await fs.writeFile(target.path, JSON.stringify(config, null, 2), "utf8");
-            process.stderr.write(`✅ Configurado con éxito: ${target.name}\n   └─ Ruta: ${target.path}\n`);
+            process.stderr.write(`✅ Successfully configured: ${target.name}\n   └─ Path: ${target.path}\n`);
             configuredCount++;
         }
         catch (err) {
-            process.stderr.write(`❌ Error al configurar ${target.name} en ${target.path}: ${err.message}\n`);
+            process.stderr.write(`❌ Error configuring ${target.name} at ${target.path}: ${err.message}\n`);
         }
     }
     process.stderr.write("\n");
     if (configuredCount > 0) {
-        process.stderr.write(`🎉 ¡Configuración completa! Se configuraron ${configuredCount} cliente(s) MCP.\n`);
-        process.stderr.write("Recuerda reiniciar o recargar tu cliente de IA para que detecte la herramienta 'duo_review'.\n");
+        process.stderr.write(`🎉 Configuration complete! Successfully configured ${configuredCount} MCP client(s).\n`);
+        process.stderr.write("Remember to restart or reload your AI client to detect the 'duo_review' tool.\n");
+        await checkGitLabConnection();
+        printMiniGuide();
     }
     else {
-        process.stderr.write("⚠️ No se encontraron directorios de configuración de clientes MCP activos.\n");
-        process.stderr.write("Si usas Claude Desktop, Cursor, Cline, Roo Code, Windsurf, Zed o Continue, asegúrate de haberlos instalado e iniciado al menos una vez.\n");
+        process.stderr.write("⚠️ No clients were configured.\n");
+    }
+}
+async function checkGitLabConnection() {
+    process.stderr.write("\nChecking GitLab CLI installation and connection...\n");
+    try {
+        const { stdout } = await execAsync("glab auth status");
+        process.stderr.write("✅ GitLab CLI and connection verified successfully!\n");
+        if (stdout) {
+            process.stderr.write(stdout
+                .trim()
+                .split("\n")
+                .map((line) => `   ${line}`)
+                .join("\n") + "\n\n");
+        }
     }
+    catch (err) {
+        process.stderr.write("⚠️ Connection check failed or GitLab CLI not fully authenticated:\n");
+        if (err.code === "ENOENT" || (err.message && err.message.includes("not found"))) {
+            process.stderr.write("   Could not find the 'glab' executable. Please make sure GitLab CLI is installed and added to your PATH.\n\n");
+        }
+        else {
+            const errorOutput = err.stderr || err.stdout || err.message || String(err);
+            process.stderr.write(errorOutput
+                .trim()
+                .split("\n")
+                .map((line) => `   ${line}`)
+                .join("\n") + "\n\n");
+        }
+    }
+}
+function printMiniGuide() {
+    process.stderr.write(`📋 QUICK COMMAND & USAGE GUIDE
+=============================
+
+1. How to ask your AI agent to run a review:
+   - "Review my current uncommitted changes with @duo_review"
+   - "Run @duo_review on src/auth.ts and src/db.ts"
+   - "Use @duo_review with model: sonnet to review this project"
+
+2. AI Model Abstractions (Friendly Names):
+   You can use simple, friendly model names instead of complex GitLab identifiers!
+   The bridge automatically maps them for you:
+   
+   • sonnet      -> claude_sonnet_4_6
+   • haiku       -> claude_haiku_4_5_20251001
+   • opus        -> claude_opus_4_5_20251101
+   • gpt5        -> gpt_5
+   • gpt5-mini   -> gpt_5_mini
+   • gpt5-codex  -> gpt_5_codex
+   • gemini      -> gemini_2_5_flash_vertex
+
+3. How to use friendly models:
+   - In your agent's config or env: set GITLAB_DUO_MODEL="sonnet"
+   - In your prompt: "Review with @duo_review using model: gemini"
+
+=============================\n\n`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitlab-duo-mcp-bridge",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server that wraps the GitLab Duo CLI as a clean, fault-tolerant duo_review tool for AI coding agents.",
   "type": "module",
   "bin": {