@imenam/mcp-github 1.1.54 → 1.1.55

package/dist/utils/git.js

@@ -3,16 +3,11 @@ import path from "path";
 import fs from "fs";
 import { logToFile } from "../logger.js";
 import { getConfig, updateEnvFile } from "./config.js";
+import { getRole } from "./role.js";
+import { getGitAuthHeader, getGitHubRemoteUrl, repoName, resolveTarget } from "./target.js";
 export function getCurrentBranch(repoPath) {
     return execGitSecure("branch --show-current", { cwd: repoPath }).toString().trim();
 }
-export function getGitAuthHeader() {
-    const { GITHUB_TOKEN } = getConfig();
-    if (!GITHUB_TOKEN)
-        return null;
-    const auth = Buffer.from(`x-access-token:${GITHUB_TOKEN}`).toString('base64');
-    return `Authorization: Basic ${auth}`;
-}
 // `safe.directory='*'` désactive la protection "dubious ownership" de Git pour
 // CE process. Indispensable car le MCP exécute git (souvent en root dans le
 // conteneur) sur un dépôt qui peut appartenir à un autre utilisateur (ex. `node`,
@@ -24,19 +19,37 @@ function buildGitCommand(command, extra = "") {
     return `${GIT_BASE}${extra ? ` ${extra}` : ""} ${rest}`;
 }
 export function execGitSecure(command, options) {
+    // Sans terminal, git ne doit jamais demander d'identifiants : il échoue à la place.
+    const execOptions = { ...options, env: { ...process.env, ...options?.env, GIT_TERMINAL_PROMPT: "0" } };
     const authHeader = getGitAuthHeader();
     if (!authHeader) {
-        return execSync(buildGitCommand(command), options);
+        return execSync(buildGitCommand(command), execOptions);
     }
     const secureCommand = buildGitCommand(command, `-c http.extraHeader="${authHeader}"`);
     try {
-        return execSync(secureCommand, options);
+        return execSync(secureCommand, execOptions);
     }
     catch (error) {
         error.message = error.message.replace(authHeader, "[REDACTED_AUTH_HEADER]");
         throw error;
     }
 }
+/** Indique si la branche existe sur le remote, via `git ls-remote` (code 2 : absente). */
+export function remoteBranchExists(repoPath, remoteUrl, branch) {
+    try {
+        execGitSecure(`ls-remote --exit-code --heads ${remoteUrl} refs/heads/${branch}`, { cwd: repoPath, stdio: "pipe" });
+        return true;
+    }
+    catch (error) {
+        if (error.status === 2)
+            return false;
+        throw error;
+    }
+}
+/** Fait pointer `origin` sur l'URL attendue pour le rôle de l'instance. */
+export function ensureOrigin(repoPath, remoteUrl) {
+    execGitSecure(`remote set-url origin ${remoteUrl}`, { cwd: repoPath });
+}
 /**
  * Aligne la propriété et les droits du dépôt sur l'utilisateur de l'agent.
  *
@@ -71,21 +84,18 @@ export function alignRepoOwnership(repoPath) {
 }
 export async function performClone() {
     const config = getConfig();
+    if (getRole() === "remote") {
+        throw new Error("En rôle remote, le clone se fait sur la machine de l'agent : utilisez l'outil 'clone'.");
+    }
     if (!config.GITHUB_TOKEN) {
         throw new Error("GITHUB_TOKEN est manquant. Le clonage nécessite une authentification.");
     }
-    if (!config.TARGET_REPO || !config.TARGET_REPO.includes("/")) {
-        throw new Error("TARGET_REPO must be defined as 'owner/repo'");
-    }
-    const repoParts = config.TARGET_REPO.split("/");
-    const repo = repoParts[1];
-    if (!repo) {
-        throw new Error("Invalid TARGET_REPO format. Expected 'owner/repo'");
-    }
-    const remote = `https://github.com/${config.TARGET_REPO}.git`;
-    const finalRepoPath = path.join(config.CLONE_DIR, repo);
+    const target = resolveTarget();
+    const remote = getGitHubRemoteUrl(target);
+    const finalRepoPath = path.join(config.CLONE_DIR, repoName(target));
     logToFile(`[CLONE] Destination calculée : ${finalRepoPath}`);
     if (fs.existsSync(finalRepoPath)) {
+        ensureOrigin(finalRepoPath, remote);
         alignRepoOwnership(finalRepoPath);
         process.env.REPO_PATH = finalRepoPath;
         await updateEnvFile("REPO_PATH", finalRepoPath);
@@ -107,7 +117,7 @@ export async function performClone() {
         alignRepoOwnership(finalRepoPath);
         process.env.REPO_PATH = finalRepoPath;
         await updateEnvFile("REPO_PATH", finalRepoPath);
-        return `Successfully cloned ${config.TARGET_REPO} into ${finalRepoPath}. Run 'init_working_dir' to switch to the target branch.`;
+        return `Successfully cloned ${target.repo} into ${finalRepoPath}. Run 'init_working_dir' to switch to the target branch.`;
     }
     catch (error) {
         const msg = `Clone failed: ${error.message}`;

package/dist/utils/git.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"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"}

package/dist/utils/role.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Rôle de l'instance, fixé par la variable GITHUB_MCP_ROLE.
+ *
+ * - `standalone` (défaut) : une seule instance, sur la machine de l'agent, qui détient
+ *   le token et exécute git en direct vers GitHub.
+ * - `remote` : instance déclarée dans mcp-http-gateway. Seule à connaître le token, le
+ *   dépôt et les branches. Elle expose le proxy git sur 127.0.0.1:MCP_HTTP_RELAY_PORT
+ *   et fait exécuter git sur la machine de l'agent par le relais agent
+ *   (`mcp-http-gateway --mcp`), à travers ce proxy.
+ */
+export type Role = "standalone" | "remote";
+export declare function getRole(): Role;
+/** Route de l'instance remote dans le gateway (MCP_SERVER_ROUTE, ex. /github). */
+export declare function getGatewayRoute(): string;
+//# sourceMappingURL=role.d.ts.map

package/dist/utils/role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../src/utils/role.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,IAAI,GAAG,YAAY,GAAG,QAAQ,CAAC;AAI3C,wBAAgB,OAAO,IAAI,IAAI,CAK9B;AAED,kFAAkF;AAClF,wBAAgB,eAAe,IAAI,MAAM,CAMxC"}

package/dist/utils/role.js

@@ -0,0 +1,18 @@
+const ROLES = ["standalone", "remote"];
+export function getRole() {
+    const raw = process.env.GITHUB_MCP_ROLE?.trim();
+    if (!raw)
+        return "standalone";
+    if (ROLES.includes(raw))
+        return raw;
+    throw new Error(`GITHUB_MCP_ROLE="${raw}" invalide (attendu : ${ROLES.join(" | ")})`);
+}
+/** Route de l'instance remote dans le gateway (MCP_SERVER_ROUTE, ex. /github). */
+export function getGatewayRoute() {
+    const route = process.env.MCP_SERVER_ROUTE?.trim().replace(/\/+$/, "");
+    if (!route || !route.startsWith("/")) {
+        throw new Error("MCP_SERVER_ROUTE est requis quand GITHUB_MCP_ROLE=remote (route déclarée au gateway, ex. /github)");
+    }
+    return route;
+}
+//# sourceMappingURL=role.js.map

package/dist/utils/role.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.js","sourceRoot":"","sources":["../../src/utils/role.ts"],"names":[],"mappings":"AAYA,MAAM,KAAK,GAAoB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AAExD,MAAM,UAAU,OAAO;IACrB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IAChD,IAAI,CAAC,GAAG;QAAE,OAAO,YAAY,CAAC;IAC9B,IAAK,KAA2B,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAW,CAAC;IACnE,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,yBAAyB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACxF,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,mGAAmG,CAAC,CAAC;IACvH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/target.d.ts

@@ -0,0 +1,13 @@
+export interface Target {
+    repo: string;
+    targetBranch: string;
+    baseBranch: string;
+    readOnly: boolean;
+}
+export declare function resolveTarget(): Target;
+/** Nom du dossier du dépôt : la partie `repo` de `owner/repo`. */
+export declare function repoName(target: Target): string;
+export declare function getGitHubRemoteUrl(target: Target): string;
+/** En-tête d'authentification ajouté aux commandes git : le token GitHub. */
+export declare function getGitAuthHeader(): string | null;
+//# sourceMappingURL=target.d.ts.map

package/dist/utils/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/utils/target.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,aAAa,IAAI,MAAM,CAYtC;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAKhD"}

package/dist/utils/target.js

@@ -0,0 +1,38 @@
+/**
+ * Cible des opérations git (dépôt, branches), lue dans la configuration de l'instance,
+ * et moyens de la joindre en rôle `standalone`.
+ */
+import { getConfig } from "./config.js";
+export function resolveTarget() {
+    const config = getConfig();
+    if (!config.TARGET_REPO || !config.TARGET_REPO.includes("/")) {
+        throw new Error("TARGET_REPO must be defined as 'owner/repo'");
+    }
+    if (!config.TARGET_BRANCH)
+        throw new Error("TARGET_BRANCH is not defined.");
+    return {
+        repo: config.TARGET_REPO,
+        targetBranch: config.TARGET_BRANCH,
+        baseBranch: config.BASE_BRANCH,
+        readOnly: config.READ_ONLY,
+    };
+}
+/** Nom du dossier du dépôt : la partie `repo` de `owner/repo`. */
+export function repoName(target) {
+    const name = target.repo.split("/")[1];
+    if (!name)
+        throw new Error("Invalid TARGET_REPO format. Expected 'owner/repo'");
+    return name;
+}
+export function getGitHubRemoteUrl(target) {
+    return `https://github.com/${target.repo}.git`;
+}
+/** En-tête d'authentification ajouté aux commandes git : le token GitHub. */
+export function getGitAuthHeader() {
+    const { GITHUB_TOKEN } = getConfig();
+    if (!GITHUB_TOKEN)
+        return null;
+    const auth = Buffer.from(`x-access-token:${GITHUB_TOKEN}`).toString("base64");
+    return `Authorization: Basic ${auth}`;
+}
+//# sourceMappingURL=target.js.map

package/dist/utils/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../src/utils/target.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AASxC,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC5E,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,WAAW;QACxB,YAAY,EAAE,MAAM,CAAC,aAAa;QAClC,UAAU,EAAE,MAAM,CAAC,WAAW;QAC9B,QAAQ,EAAE,MAAM,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,sBAAsB,MAAM,CAAC,IAAI,MAAM,CAAC;AACjD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB;IAC9B,MAAM,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,CAAC;IACrC,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9E,OAAO,wBAAwB,IAAI,EAAE,CAAC;AACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imenam/mcp-github",
-  "version": "1.1.54",
+  "version": "1.1.55",
   "main": "index.js",
   "type": "module",
   "files": [

package/public/index.html

@@ -1480,7 +1480,8 @@
             state.extras = {
                 AGENT_NAME: data.AGENT_NAME || '',
                 CLONE_DIR: data.CLONE_DIR || '',
-                REPO_PATH: data.REPO_PATH || ''
+                REPO_PATH: data.REPO_PATH || '',
+                ROLE: data.ROLE || 'standalone'
             };
         }
 
@@ -1596,6 +1597,9 @@
 
             $('btnClone').disabled = !state.config.TARGET_REPO || !state.config.TARGET_BRANCH;
             $('btnClean').disabled = !state.extras.REPO_PATH;
+            // En rôle remote, la copie de travail est sur la machine de l'agent.
+            $('btnClone').hidden = state.extras.ROLE === 'remote';
+            $('btnClean').hidden = state.extras.ROLE === 'remote';
 
             const preview = $('cmdPreview');
             if (preview) preview.textContent = buildCommandPreview();