deepdebug-local-agent 1.0.22 → 1.1.0

package/src/git/base-git-provider.js

@@ -1,8 +1,8 @@
 /**
  * BaseGitProvider
  *
- * Interface abstrata para Git providers (GitHub, GitLab, Bitbucket).
- * Cada provider deve implementar esta interface.
+ * Abstract interface for Git providers (GitHub, GitLab, Bitbucket).
+ * Each provider must implement this interface.
  *
  * @abstract
  */
@@ -22,7 +22,7 @@ export class BaseGitProvider {
     // ==========================================
 
     /**
-     * Identificador único do provider
+     * Unique identifier of the provider
      * @returns {string} Ex: 'github', 'gitlab', 'bitbucket'
      */
     getId() {
@@ -30,7 +30,7 @@ export class BaseGitProvider {
     }
 
     /**
-     * Nome amigável do provider
+     * Friendly name of the provider
      * @returns {string} Ex: 'GitHub', 'GitLab', 'Bitbucket'
      */
     getName() {
@@ -38,7 +38,7 @@ export class BaseGitProvider {
     }
 
     /**
-     * URL base da API
+     * Base URL of the API
      * @returns {string}
      */
     getApiBaseUrl() {
@@ -50,7 +50,7 @@ export class BaseGitProvider {
     // ==========================================
 
     /**
-     * Define o token de acesso
+     * Sets the access token
      * @param {string} token
      */
     setAccessToken(token) {
@@ -58,9 +58,9 @@ export class BaseGitProvider {
     }
 
     /**
-     * Retorna URL para OAuth authorization
-     * @param {string} redirectUri - URI de callback
-     * @param {string} state - State para CSRF protection
+     * Returns the URL for OAuth authorization
+     * @param {string} redirectUri - Callback URI
+     * @param {string} state - State for CSRF protection
      * @returns {string}
      */
     getAuthorizationUrl(redirectUri, state) {
@@ -68,9 +68,9 @@ export class BaseGitProvider {
     }
 
     /**
-     * Troca authorization code por access token
+     * Exchanges an authorization code for an access token
      * @param {string} code - Authorization code
-     * @param {string} redirectUri - URI de callback
+     * @param {string} redirectUri - Callback URI
      * @returns {Promise<TokenResponse>}
      */
     async exchangeCodeForToken(code, redirectUri) {
@@ -78,7 +78,7 @@ export class BaseGitProvider {
     }
 
     /**
-     * Valida se o token ainda é válido
+     * Validates whether the token is still valid
      * @returns {Promise<boolean>}
      */
     async validateToken() {
@@ -90,7 +90,7 @@ export class BaseGitProvider {
     // ==========================================
 
     /**
-     * Obtém informações do usuário autenticado
+     * Gets information about the authenticated user
      * @returns {Promise<UserInfo>}
      */
     async getCurrentUser() {
@@ -102,7 +102,7 @@ export class BaseGitProvider {
     // ==========================================
 
     /**
-     * Lista repositórios do usuário
+     * Lists the user's repositories
      * @param {object} options - { page, perPage, sort }
      * @returns {Promise<Repository[]>}
      */
@@ -111,9 +111,9 @@ export class BaseGitProvider {
     }
 
     /**
-     * Obtém informações de um repositório
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
+     * Gets information about a repository
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
      * @returns {Promise<Repository>}
      */
     async getRepository(owner, repo) {
@@ -121,10 +121,10 @@ export class BaseGitProvider {
     }
 
     /**
-     * Clona um repositório
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {string} destPath - Caminho de destino
+     * Clones a repository
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {string} destPath - Destination path
      * @param {object} options - { branch, depth }
      * @returns {Promise<CloneResult>}
      */
@@ -137,9 +137,9 @@ export class BaseGitProvider {
     // ==========================================
 
     /**
-     * Lista branches do repositório
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
+     * Lists the repository branches
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
      * @returns {Promise<Branch[]>}
      */
     async listBranches(owner, repo) {
@@ -147,11 +147,11 @@ export class BaseGitProvider {
     }
 
     /**
-     * Cria uma nova branch
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {string} branchName - Nome da nova branch
-     * @param {string} fromRef - Ref de origem (sha ou branch)
+     * Creates a new branch
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {string} branchName - Name of the new branch
+     * @param {string} fromRef - Source ref (sha or branch)
      * @returns {Promise<Branch>}
      */
     async createBranch(owner, repo, branchName, fromRef) {
@@ -159,10 +159,10 @@ export class BaseGitProvider {
     }
 
     /**
-     * Obtém informações de uma branch
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {string} branch - Nome da branch
+     * Gets information about a branch
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {string} branch - Branch name
      * @returns {Promise<Branch>}
      */
     async getBranch(owner, repo, branch) {
@@ -174,10 +174,10 @@ export class BaseGitProvider {
     // ==========================================
 
     /**
-     * Lista commits de uma branch
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {string} branch - Nome da branch
+     * Lists commits of a branch
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {string} branch - Branch name
      * @param {object} options - { page, perPage }
      * @returns {Promise<Commit[]>}
      */
@@ -186,12 +186,12 @@ export class BaseGitProvider {
     }
 
     /**
-     * Cria um commit com mudanças
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {string} branch - Nome da branch
-     * @param {string} message - Mensagem do commit
-     * @param {FileChange[]} changes - Lista de mudanças
+     * Creates a commit with changes
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {string} branch - Branch name
+     * @param {string} message - Commit message
+     * @param {FileChange[]} changes - List of changes
      * @returns {Promise<Commit>}
      */
     async createCommit(owner, repo, branch, message, changes) {
@@ -203,11 +203,11 @@ export class BaseGitProvider {
     // ==========================================
 
     /**
-     * Obtém conteúdo de um arquivo
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {string} path - Caminho do arquivo
-     * @param {string} ref - Branch ou sha
+     * Gets the content of a file
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {string} path - File path
+     * @param {string} ref - Branch or sha
      * @returns {Promise<FileContent>}
      */
     async getFileContent(owner, repo, path, ref = 'main') {
@@ -215,14 +215,14 @@ export class BaseGitProvider {
     }
 
     /**
-     * Cria ou atualiza um arquivo
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {string} path - Caminho do arquivo
-     * @param {string} content - Conteúdo (base64 ou texto)
-     * @param {string} message - Mensagem do commit
+     * Creates or updates a file
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {string} path - File path
+     * @param {string} content - Content (base64 or text)
+     * @param {string} message - Commit message
      * @param {string} branch - Branch
-     * @param {string} sha - SHA atual (para update)
+     * @param {string} sha - Current SHA (for update)
      * @returns {Promise<FileCommit>}
      */
     async createOrUpdateFile(owner, repo, path, content, message, branch, sha = null) {
@@ -234,9 +234,9 @@ export class BaseGitProvider {
     // ==========================================
 
     /**
-     * Lista pull requests
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
+     * Lists pull requests
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
      * @param {object} options - { state, page, perPage }
      * @returns {Promise<PullRequest[]>}
      */
@@ -245,9 +245,9 @@ export class BaseGitProvider {
     }
 
     /**
-     * Cria um pull request
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
+     * Creates a pull request
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
      * @param {object} pr - { title, body, head, base }
      * @returns {Promise<PullRequest>}
      */
@@ -256,10 +256,10 @@ export class BaseGitProvider {
     }
 
     /**
-     * Obtém informações de um pull request
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {number} prNumber - Número do PR
+     * Gets information about a pull request
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {number} prNumber - PR number
      * @returns {Promise<PullRequest>}
      */
     async getPullRequest(owner, repo, prNumber) {
@@ -271,10 +271,10 @@ export class BaseGitProvider {
     // ==========================================
 
     /**
-     * Lista comentários de um pull request
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {number} prNumber - Número do PR
+     * Lists comments of a pull request
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {number} prNumber - PR number
      * @param {object} options - { page, perPage }
      * @returns {Promise<PRComment[]>}
      */
@@ -283,10 +283,10 @@ export class BaseGitProvider {
     }
 
     /**
-     * Lista apenas comentários de review (inline no código)
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {number} prNumber - Número do PR
+     * Lists only review comments (inline in the code)
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {number} prNumber - PR number
      * @param {object} options - { page, perPage }
      * @returns {Promise<PRReviewComment[]>}
      */
@@ -295,11 +295,11 @@ export class BaseGitProvider {
     }
 
     /**
-     * Obtém um comentário específico
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {number} prNumber - Número do PR
-     * @param {string|number} commentId - ID do comentário
+     * Gets a specific comment
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {number} prNumber - PR number
+     * @param {string|number} commentId - Comment ID
      * @returns {Promise<PRComment>}
      */
     async getPRComment(owner, repo, prNumber, commentId) {
@@ -307,11 +307,11 @@ export class BaseGitProvider {
     }
 
     /**
-     * Adiciona um comentário geral ao PR
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {number} prNumber - Número do PR
-     * @param {string} body - Conteúdo do comentário
+     * Adds a general comment to the PR
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {number} prNumber - PR number
+     * @param {string} body - Comment content
      * @returns {Promise<PRComment>}
      */
     async addPRComment(owner, repo, prNumber, body) {
@@ -319,10 +319,10 @@ export class BaseGitProvider {
     }
 
     /**
-     * Adiciona um comentário inline no código (review comment)
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {number} prNumber - Número do PR
+     * Adds an inline comment in the code (review comment)
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {number} prNumber - PR number
      * @param {object} comment - { body, path, line, side, commitId }
      * @returns {Promise<PRReviewComment>}
      */
@@ -331,12 +331,12 @@ export class BaseGitProvider {
     }
 
     /**
-     * Responde a um comentário existente (thread reply)
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {number} prNumber - Número do PR
-     * @param {string|number} commentId - ID do comentário pai
-     * @param {string} body - Conteúdo da resposta
+     * Replies to an existing comment (thread reply)
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {number} prNumber - PR number
+     * @param {string|number} commentId - Parent comment ID
+     * @param {string} body - Reply content
      * @returns {Promise<PRComment>}
      */
     async replyToPRComment(owner, repo, prNumber, commentId, body) {
@@ -344,11 +344,11 @@ export class BaseGitProvider {
     }
 
     /**
-     * Marca um comentário/thread como resolvido
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {number} prNumber - Número do PR
-     * @param {string|number} commentId - ID do comentário/thread
+     * Marks a comment/thread as resolved
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {number} prNumber - PR number
+     * @param {string|number} commentId - Comment/thread ID
      * @returns {Promise<{ resolved: boolean }>}
      */
     async resolvePRComment(owner, repo, prNumber, commentId) {
@@ -356,11 +356,11 @@ export class BaseGitProvider {
     }
 
     /**
-     * Marca um comentário/thread como não resolvido
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {number} prNumber - Número do PR
-     * @param {string|number} commentId - ID do comentário/thread
+     * Marks a comment/thread as unresolved
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {number} prNumber - PR number
+     * @param {string|number} commentId - Comment/thread ID
      * @returns {Promise<{ resolved: boolean }>}
      */
     async unresolvePRComment(owner, repo, prNumber, commentId) {
@@ -368,11 +368,11 @@ export class BaseGitProvider {
     }
 
     /**
-     * Lista comentários não resolvidos de um PR
-     * Convenience method - filtra listPRComments + listPRReviewComments
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {number} prNumber - Número do PR
+     * Lists unresolved comments of a PR
+     * Convenience method - filters listPRComments + listPRReviewComments
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {number} prNumber - PR number
      * @returns {Promise<PRComment[]>}
      */
     async listUnresolvedPRComments(owner, repo, prNumber) {
@@ -391,9 +391,9 @@ export class BaseGitProvider {
     // ==========================================
 
     /**
-     * Cria um webhook
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
+     * Creates a webhook
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
      * @param {object} webhook - { url, events, secret }
      * @returns {Promise<Webhook>}
      */
@@ -406,10 +406,10 @@ export class BaseGitProvider {
     // ==========================================
 
     /**
-     * Constrói URL de clone
-     * @param {string} owner - Owner do repo
-     * @param {string} repo - Nome do repo
-     * @param {boolean} useHttps - Usar HTTPS (default) ou SSH
+     * Builds a clone URL
+     * @param {string} owner - Repo owner
+     * @param {string} repo - Repo name
+     * @param {boolean} useHttps - Use HTTPS (default) or SSH
      * @returns {string}
      */
     getCloneUrl(owner, repo, useHttps = true) {
@@ -417,8 +417,8 @@ export class BaseGitProvider {
     }
 
     /**
-     * Parsea URL de repositório para extrair owner e repo
-     * @param {string} url - URL do repositório
+     * Parses a repository URL to extract owner and repo
+     * @param {string} url - Repository URL
      * @returns {{ owner: string, repo: string }}
      */
     parseRepositoryUrl(url) {

package/src/git/bitbucket-provider.js

@@ -4,7 +4,7 @@ import { run } from '../utils/exec-utils.js';
 /**
  * BitbucketProvider
  *
- * Implementação do Git provider para Bitbucket Cloud.
+ * Git provider implementation for Bitbucket Cloud.
  *
  * Bitbucket API 2.0: https://developer.atlassian.com/cloud/bitbucket/rest/intro/
  *
@@ -661,7 +661,7 @@ export class BitbucketProvider extends BaseGitProvider {
         const data = await this.apiRequest(`/repositories/${workspace}/${repoSlug}/hooks`, {
             method: 'POST',
             body: JSON.stringify({
-                description: webhook.description || 'InspTech AI Webhook',
+                description: webhook.description || 'VisionHammer Webhook',
                 url: webhook.url,
                 active: true,
                 events: webhook.events || ['repo:push', 'pullrequest:created', 'pullrequest:updated'],

package/src/git/git-provider-registry.js

@@ -4,7 +4,7 @@ import { BitbucketProvider } from './bitbucket-provider.js';
 /**
  * GitProviderRegistry
  *
- * Factory/Registry para gerenciar Git providers.
+ * Factory/Registry for managing Git providers.
  */
 export class GitProviderRegistry {
 
@@ -14,28 +14,28 @@ export class GitProviderRegistry {
     }
 
     registerDefaults() {
-        // Registrar providers disponíveis
+        // Register the available providers
         this.register('github', GitHubProvider);
         this.register('bitbucket', BitbucketProvider);
 
-        // GitLab será implementado depois
+        // GitLab will be implemented later
         // this.register('gitlab', GitLabProvider);
     }
 
     /**
-     * Registra um provider
-     * @param {string} id - ID do provider
-     * @param {class} ProviderClass - Classe do provider
+     * Registers a provider
+     * @param {string} id - Provider ID
+     * @param {class} ProviderClass - Provider class
      */
     register(id, ProviderClass) {
         this.providers.set(id, ProviderClass);
-        console.log(`📦 Registered git provider: ${id}`);
+        console.log(`📦 Registered git provider: ${id}`);
     }
 
     /**
-     * Cria instância de um provider
-     * @param {string} id - ID do provider
-     * @param {object} config - Configuração do provider
+     * Creates an instance of a provider
+     * @param {string} id - Provider ID
+     * @param {object} config - Provider configuration
      * @returns {BaseGitProvider}
      */
     create(id, config = {}) {
@@ -49,7 +49,7 @@ export class GitProviderRegistry {
     }
 
     /**
-     * Lista IDs dos providers disponíveis
+     * Lists the IDs of the available providers
      * @returns {string[]}
      */
     listProviders() {
@@ -57,9 +57,9 @@ export class GitProviderRegistry {
     }
 
     /**
-     * Detecta provider a partir da URL
-     * @param {string} url - URL do repositório
-     * @returns {string|null} - ID do provider
+     * Detects the provider from the URL
+     * @param {string} url - Repository URL
+     * @returns {string|null} - Provider ID
      */
     detectProviderFromUrl(url) {
         if (url.includes('github.com')) {
@@ -75,9 +75,9 @@ export class GitProviderRegistry {
     }
 
     /**
-     * Cria provider a partir da URL do repositório
-     * @param {string} url - URL do repositório
-     * @param {object} config - Configuração
+     * Creates a provider from the repository URL
+     * @param {string} url - Repository URL
+     * @param {object} config - Configuration
      * @returns {BaseGitProvider}
      */
     createFromUrl(url, config = {}) {
@@ -98,7 +98,7 @@ export class GitProviderRegistry {
 let instance = null;
 
 /**
- * Obtém instância singleton do GitProviderRegistry
+ * Gets the singleton instance of GitProviderRegistry
  * @returns {GitProviderRegistry}
  */
 export function getGitProviderRegistry() {