@andre.buzeli/git-mcp 15.12.5

package/src/providers/providerManager.js

@@ -0,0 +1,317 @@
+import { Octokit } from "@octokit/rest";
+import axios from "axios";
+import { getProvidersEnv } from "../utils/repoHelpers.js";
+
+export class ProviderManager {
+  constructor() {
+    const { githubToken, giteaUrl, giteaToken } = getProvidersEnv();
+    this.githubToken = githubToken || "";
+    this.giteaUrl = giteaUrl || "";
+    this.giteaToken = giteaToken || "";
+    this.github = this.githubToken ? new Octokit({ auth: this.githubToken }) : null;
+    this._githubOwner = "";
+    this._giteaOwner = "";
+    this._ownerFetchedAt = 0;
+    this._remoteUrlsCache = new Map(); // Cache para URLs de remotes
+    this._cacheExpiry = 10 * 60 * 1000; // 10 minutos
+  }
+
+  async getGitHubOwner() {
+    if (!this.github) return "";
+    const now = Date.now();
+    if (this._githubOwner && now - this._ownerFetchedAt < 5 * 60 * 1000) return this._githubOwner;
+    try {
+      const me = await this.github.rest.users.getAuthenticated();
+      this._githubOwner = me.data.login || "";
+      this._ownerFetchedAt = now;
+      return this._githubOwner;
+    } catch {
+      return "";
+    }
+  }
+
+  async getGiteaOwner() {
+    if (!this.giteaUrl || !this.giteaToken) return "";
+    const now = Date.now();
+    if (this._giteaOwner && now - this._ownerFetchedAt < 5 * 60 * 1000) return this._giteaOwner;
+    try {
+      const r = await axios.get(`${this.giteaUrl}/api/v1/user`, {
+        headers: { Authorization: `token ${this.giteaToken}` },
+        timeout: 8000,
+      });
+      const d = r.data || {};
+      this._giteaOwner = d.login || d.username || "";
+      this._ownerFetchedAt = now;
+      return this._giteaOwner;
+    } catch {
+      return "";
+    }
+  }
+
+  async getPrioritizedUser() {
+    // 1. Gitea
+    if (this.giteaUrl && this.giteaToken) {
+      try {
+        const r = await axios.get(`${this.giteaUrl}/api/v1/user`, {
+          headers: { Authorization: `token ${this.giteaToken}` },
+          timeout: 5000
+        });
+        if (r.data) {
+          return {
+            username: r.data.login || r.data.username,
+            email: r.data.email,
+            provider: 'gitea'
+          };
+        }
+      } catch (e) { /* ignore */ }
+    }
+
+    // 2. GitHub
+    if (this.github) {
+      try {
+        const me = await this.github.rest.users.getAuthenticated();
+        let email = me.data.email;
+
+        // Se email for null (privado), tenta buscar lista de emails
+        if (!email) {
+          try {
+            const emailsLog = await this.github.rest.users.listEmailsForAuthenticatedUser();
+            const primary = emailsLog.data.find(e => e.primary) || emailsLog.data[0];
+            if (primary) email = primary.email;
+          } catch { /* ignore scope errors */ }
+        }
+
+        return {
+          username: me.data.login,
+          email,
+          provider: 'github'
+        };
+      } catch (e) { /* ignore */ }
+    }
+
+    return null;
+  }
+
+  async getRemoteUrls(repoName, organization) {
+    const cacheKey = `urls_${organization || ""}_${repoName}`;
+    const now = Date.now();
+
+    // Verificar cache
+    if (this._remoteUrlsCache.has(cacheKey)) {
+      const cached = this._remoteUrlsCache.get(cacheKey);
+      if (now - cached.timestamp < this._cacheExpiry) {
+        return cached.urls;
+      }
+    }
+
+    const urls = {};
+
+    // GitHub URL
+    if (this.github) {
+      const owner = organization || await this.getGitHubOwner();
+      if (owner) {
+        urls.github = `https://github.com/${owner}/${repoName}.git`;
+      }
+    }
+
+    // Gitea URL
+    if (this.giteaUrl && this.giteaToken) {
+      const owner = organization || await this.getGiteaOwner();
+      if (owner) {
+        const base = this.giteaUrl.replace(/\/$/, "");
+        urls.gitea = `${base}/${owner}/${repoName}.git`;
+      }
+    }
+
+    // Cachear resultado
+    this._remoteUrlsCache.set(cacheKey, { urls, timestamp: now });
+
+    return urls;
+  }
+
+  async ensureRepos({ repoName, createIfMissing = true, description = "Managed by git-mcpv2", isPublic = false, organization }) {
+    // Por padrão, repositórios são PRIVADOS. Use isPublic=true para público.
+    const isPrivate = !isPublic;
+    const results = { github: null, gitea: null };
+    // GitHub
+    if (this.github) {
+      const owner = organization || await this.getGitHubOwner();
+      if (owner) {
+        try {
+          const full = `${owner}/${repoName}`;
+          try {
+            await this.github.rest.repos.get({ owner, repo: repoName });
+            results.github = { ok: true, repo: full, created: false };
+          } catch {
+            if (createIfMissing) {
+              let cr;
+              if (organization) {
+                // Criar repo na organização
+                cr = await this.github.rest.repos.createInOrg({
+                  org: organization,
+                  name: repoName,
+                  description,
+                  private: isPrivate,
+                  auto_init: false,
+                });
+              } else {
+                // Criar repo no usuário pessoal
+                cr = await this.github.rest.repos.createForAuthenticatedUser({
+                  name: repoName,
+                  description,
+                  private: isPrivate,
+                  auto_init: false,
+                });
+              }
+              results.github = { ok: true, repo: cr.data.full_name, created: true };
+            } else {
+              results.github = { ok: false, error: "missing" };
+            }
+          }
+        } catch (e) {
+          results.github = { ok: false, error: String(e?.message || e) };
+        }
+      }
+    }
+    // Gitea
+    if (this.giteaUrl && this.giteaToken) {
+      const owner = organization || await this.getGiteaOwner();
+      if (owner) {
+        try {
+          const base = this.giteaUrl.replace(/\/$/, "");
+          const getRepo = await axios.get(`${base}/api/v1/repos/${owner}/${repoName}`,
+            { headers: { Authorization: `token ${this.giteaToken}` }, timeout: 8000 });
+          if (getRepo.status === 200) {
+            results.gitea = { ok: true, repo: `${owner}/${repoName}`, created: false };
+          }
+        } catch (e) {
+          if (createIfMissing) {
+            try {
+              const createUrl = organization
+                ? `${this.giteaUrl}/api/v1/orgs/${organization}/repos`
+                : `${this.giteaUrl}/api/v1/user/repos`;
+              const cr = await axios.post(createUrl,
+                { name: repoName, description, private: isPrivate, auto_init: false },
+                { headers: { Authorization: `token ${this.giteaToken}` }, timeout: 8000 });
+              results.gitea = { ok: true, repo: `${cr.data?.owner?.login || owner}/${repoName}`, created: true };
+            } catch (err) {
+              results.gitea = { ok: false, error: String(err?.message || err) };
+            }
+          } else {
+            results.gitea = { ok: false, error: "missing" };
+          }
+        }
+      }
+    }
+    return results;
+  }
+
+  async listAllRepos(options = {}) {
+    const { maxPages = 10, perPage = 100, organization } = options;
+    const results = { github: [], gitea: [] };
+
+    // GitHub - com paginação
+    if (this.github) {
+      try {
+        let page = 1;
+        let hasMore = true;
+        while (hasMore && page <= maxPages) {
+          let data;
+          if (organization) {
+            // Listar repos da organização
+            const resp = await this.github.rest.repos.listForOrg({
+              org: organization,
+              per_page: perPage,
+              page,
+              type: "all"
+            });
+            data = resp.data;
+          } else {
+            // Listar repos do usuário
+            const resp = await this.github.rest.repos.listForAuthenticatedUser({
+              per_page: perPage,
+              page,
+              visibility: "all"
+            });
+            data = resp.data;
+          }
+          results.github.push(...data.map(r => ({
+            name: r.name,
+            fullName: r.full_name,
+            url: r.html_url,
+            isPrivate: r.private
+          })));
+          hasMore = data.length === perPage;
+          page++;
+        }
+      } catch (e) {
+        console.error("GitHub List Error:", e.message);
+      }
+    }
+
+    // Gitea - com paginação
+    if (this.giteaUrl && this.giteaToken) {
+      try {
+        let page = 1;
+        let hasMore = true;
+        const base = this.giteaUrl.replace(/\/$/, "");
+        while (hasMore && page <= maxPages) {
+          const endpoint = organization
+            ? `${base}/api/v1/orgs/${organization}/repos?limit=${perPage}&page=${page}`
+            : `${base}/api/v1/user/repos?limit=${perPage}&page=${page}`;
+          const { data } = await axios.get(endpoint, {
+            headers: { Authorization: `token ${this.giteaToken}` }
+          });
+          results.gitea.push(...data.map(r => ({
+            name: r.name,
+            fullName: r.full_name,
+            url: r.html_url,
+            isPrivate: r.private
+          })));
+          hasMore = data.length === perPage;
+          page++;
+        }
+      } catch (e) {
+        console.error("Gitea List Error:", e.message);
+      }
+    }
+    return results;
+  }
+
+  async listOrgs() {
+    const results = { github: [], gitea: [] };
+
+    // GitHub
+    if (this.github) {
+      try {
+        const { data } = await this.github.rest.orgs.listForAuthenticatedUser({ per_page: 100 });
+        results.github = data.map(o => ({
+          name: o.login,
+          description: o.description || "",
+          url: o.html_url
+        }));
+      } catch (e) {
+        console.error("GitHub ListOrgs Error:", e.message);
+      }
+    }
+
+    // Gitea
+    if (this.giteaUrl && this.giteaToken) {
+      try {
+        const base = this.giteaUrl.replace(/\/$/, "");
+        const { data } = await axios.get(`${base}/api/v1/user/orgs`, {
+          headers: { Authorization: `token ${this.giteaToken}` }
+        });
+        results.gitea = (data || []).map(o => ({
+          name: o.username || o.name,
+          description: o.description || "",
+          url: o.html_url || `${base}/${o.username || o.name}`
+        }));
+      } catch (e) {
+        console.error("Gitea ListOrgs Error:", e.message);
+      }
+    }
+
+    return results;
+  }
+}

package/src/resources/index.js

@@ -0,0 +1,276 @@
+// Resource único com documentação completa do git-mcp
+
+const TOOLS_GUIDE = `# git-mcp - Guia Completo
+
+## ⭐ Fluxo Recomendado (Automatizado)
+\`\`\`
+git-workflow action="update" message="sua mensagem" → Executa status, add, commit e push automaticamente
+\`\`\`
+
+## Fluxo Manual (se preferir controle individual)
+\`\`\`
+1. git-workflow status → ver arquivos modificados
+2. git-workflow add files=["."] → adicionar ao staging
+3. git-workflow commit message="msg" → criar commit
+4. git-workflow push → enviar para GitHub e Gitea
+\`\`\`
+
+---
+
+## git-workflow
+Operações Git essenciais.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| **update** | **⭐ RECOMENDADO - Fluxo completo automatizado** | **message, files=["."], gitignore=["pattern"], force, skipIfClean, organization** |
+| status | Ver arquivos modificados/staged | - |
+| add | Adicionar ao staging | files=["."] ou ["arquivo.js"] |
+| commit | Criar commit | message="descrição" (obrigatório) |
+| push | Enviar para GitHub+Gitea | force=true se histórico divergir |
+| init | Inicializar repo + criar remotes | createGitignore=true, organization |
+| ensure-remotes | Configurar remotes | organization |
+| clean | Remover arquivos não rastreados | - |
+
+**Exemplo update:** \`{ "projectPath": "/path", "action": "update", "message": "feat: nova func", "gitignore": ["*.log"] }\`
+**Com organização:** \`{ "projectPath": "/path", "action": "init", "organization": "automacao-casa" }\`
+
+---
+
+## git-branches
+Gerenciar branches.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| list | Listar branches | - |
+| create | Criar branch | branch="feature/nome" |
+| checkout | Trocar de branch | branch="nome" |
+| delete | Deletar branch | branch="nome", force=true |
+| rename | Renomear | branch="old", newBranch="new" |
+
+**Convenções:** feature/*, bugfix/*, hotfix/*, release/*
+
+---
+
+## git-merge (NOVO)
+Mesclar branches.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| merge | Mesclar branch | sourceBranch="feature/x", targetBranch="main" |
+| status | Verificar conflitos | - |
+| abort | Abortar merge | - |
+
+**Opções:** fastForwardOnly=true (só FF), squash=true (um commit)
+
+---
+
+## git-diff (NOVO)
+Visualizar diferenças.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| show | Ver mudanças locais | filepath="src/file.js" (opcional) |
+| compare | Comparar commits | fromRef="HEAD~1", toRef="HEAD" |
+| stat | Estatísticas | fromRef="HEAD~1", toRef="HEAD" |
+
+---
+
+## git-clone (NOVO)
+Clonar repositórios.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| clone | Clonar repo | url="https://...", targetPath="./pasta" |
+
+**Opções:** branch="main", depth=1 (shallow clone)
+
+---
+
+## git-tags
+Versionamento semântico.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| list | Listar tags | - |
+| create | Criar tag | tag="v1.0.0", message="opcional" |
+| delete | Deletar tag | tag="v1.0.0" |
+| push | Enviar para remotes | tag="v1.0.0" |
+
+**Versões:** v1.0.0 (inicial), v1.1.0 (feature), v1.0.1 (bugfix), v2.0.0 (breaking)
+
+---
+
+## git-stash
+Salvar mudanças temporariamente.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| list | Ver stashes salvos | - |
+| save | Salvar mudanças | message="WIP", includeUntracked=true |
+| pop | Restaurar e remover | ref="stash@{0}" |
+| apply | Restaurar sem remover | ref="stash@{0}" |
+| drop | Remover sem restaurar | ref="stash@{0}" |
+| clear | Remover todos | - |
+
+---
+
+## git-reset
+Desfazer commits. ⚠️ CUIDADO
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| soft | Mantém mudanças staged | ref="HEAD~1" |
+| mixed | Mantém arquivos, remove staging | ref="HEAD~1" |
+| hard | ⚠️ DESCARTA tudo | ref="HEAD~1" |
+| hard-clean | ⚠️⚠️ DESCARTA + remove untracked | ref="HEAD" |
+
+**Refs:** HEAD~1 (1 commit), HEAD~2 (2 commits), SHA específico
+
+---
+
+## git-remote
+Operações em repos remotos GitHub/Gitea.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| list | Ver remotes configurados | - |
+| list-all | Listar todos repos da conta ou org | organization |
+| list-orgs | Listar organizações disponíveis | - |
+| ensure | Criar repos + configurar remotes | organization, isPublic |
+| release-create | Criar release | tag="v1.0.0", name="", body="", organization |
+| topics-set | Definir tópicos | topics=["js","mcp"], organization |
+| label-create | Criar label | name="bug", color="ff0000", organization |
+| repo-delete | ⚠️ Deletar repo | organization |
+| milestone-create | Criar milestone | title="v1.0", organization |
+| fork-create | Criar fork | organization |
+| fork-list | Listar forks | organization |
+| star-set | Dar estrela | - |
+| star-unset | Remover estrela | - |
+| contents-create | Criar arquivo via API | path="", content="", branch="", organization |
+
+**Exemplo com organização:** \`{ "projectPath": "/path", "action": "ensure", "organization": "minha-org" }\`
+
+---
+
+## 🏢 Organizações (Suporte Opcional)
+Criar repos dentro de organizações GitHub/Gitea.
+
+**Parâmetro:** \`organization\` (opcional em git-workflow, git-remote, git-issues, git-pulls)
+
+| Uso | Exemplo |
+|-----|---------|
+| Conta pessoal (padrão) | \`{ "action": "init", ... }\` → usuario/repo |
+| Em organização | \`{ "action": "init", "organization": "minha-org" }\` → minha-org/repo |
+| Listar orgs | \`{ "action": "list-orgs" }\` via git-remote |
+
+**Nota:** O token precisa ter permissão de criar repos na organização.
+
+
+## git-issues
+Gerenciar issues.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| create | Criar issue | title="Bug: ...", body="Descrição" |
+| list | Listar issues | - |
+| comment | Comentar | number=1, body="Comentário" |
+
+---
+
+## git-pulls
+Gerenciar Pull Requests.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| create | Criar PR | head="feature/x", base="main", title="" |
+| list | Listar PRs | - |
+| files | Ver arquivos do PR | number=1 |
+
+---
+
+## git-sync
+Sincronizar com remotes.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| fetch | Baixar sem aplicar | remote="github", branch="" |
+| pull | Baixar e aplicar | remote="github", branch="" |
+
+---
+
+## git-config
+Configurações Git.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| get | Obter valor | key="user.name" |
+| set | Definir valor | key="user.name", value="Nome" |
+| unset | Remover | key="user.name" |
+| list | Listar todas | scope="local" |
+
+**Keys:** user.name, user.email, core.autocrlf
+
+---
+
+## git-files
+Ler arquivos do histórico Git.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| list | Listar arquivos | ref="HEAD" |
+| read | Ler conteúdo | filepath="package.json", ref="HEAD" |
+
+---
+
+## git-history
+Ver histórico de commits.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| log | Listar commits | ref="HEAD", maxCount=50 |
+
+---
+
+## git-ignore
+Gerenciar .gitignore.
+
+| Action | Descrição | Parâmetros |
+|--------|-----------|------------|
+| list | Ver padrões | - |
+| create | Criar .gitignore | patterns=["node_modules/","*.log"] |
+| add | Adicionar padrões | patterns=["dist/"] |
+| remove | Remover padrões | patterns=["*.log"] |
+
+---
+
+## Erros Comuns
+
+| Erro | Causa | Solução |
+|------|-------|---------|
+| PUSH_REJECTED | Histórico divergente | push com force=true |
+| REMOTE_NOT_FOUND | Remote não configurado | git-remote ensure |
+| BRANCH_NOT_FOUND | Branch não existe | git-branches list |
+| TAG_ALREADY_EXISTS | Tag duplicada | Deletar ou usar outro nome |
+| NOTHING_TO_STASH | Working tree limpa | Nada a fazer |
+| INSUFFICIENT_HISTORY | HEAD~N muito grande | Verificar git-history log |
+| AUTH_*_INVALID | Token inválido | Verificar GITHUB_TOKEN/GITEA_TOKEN |
+| MERGE_CONFLICT | Conflito durante merge | Resolver manualmente ou abort |
+| INVALID_PATH | Path traversal detectado | Usar caminhos absolutos válidos |
+| CLONE_FAILED | Erro ao clonar | Verificar URL e autenticação |
+`;
+
+export function getResources() {
+  return [{
+    uri: "git://tools-guide",
+    name: "git-mcp Tools Guide",
+    description: "Documentação completa de todas as tools e actions do git-mcp",
+    mimeType: "text/markdown"
+  }];
+}
+
+export function readResource(uri) {
+  if (uri === "git://tools-guide") {
+    return TOOLS_GUIDE;
+  }
+  return null;
+}