deepdebug-local-agent 0.3.1 → 0.3.2

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

@@ -1,4 +1,5 @@
 import { GitHubProvider } from './github-provider.js';
+import { BitbucketProvider } from './bitbucket-provider.js';
 
 /**
  * GitProviderRegistry
@@ -15,10 +16,10 @@ export class GitProviderRegistry {
     registerDefaults() {
         // Registrar providers disponíveis
         this.register('github', GitHubProvider);
+        this.register('bitbucket', BitbucketProvider);
 
-        // GitLab e Bitbucket serão implementados depois
+        // GitLab será implementado depois
         // this.register('gitlab', GitLabProvider);
-        // this.register('bitbucket', BitbucketProvider);
     }
 
     /**
@@ -28,13 +29,13 @@ export class GitProviderRegistry {
      */
     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
+     * Cria instância de um provider
      * @param {string} id - ID do provider
-     * @param {object} config - Configuração do provider
+     * @param {object} config - Configuração do provider
      * @returns {BaseGitProvider}
      */
     create(id, config = {}) {
@@ -48,7 +49,7 @@ export class GitProviderRegistry {
     }
 
     /**
-     * Lista IDs dos providers disponíveis
+     * Lista IDs dos providers disponíveis
      * @returns {string[]}
      */
     listProviders() {
@@ -57,7 +58,7 @@ export class GitProviderRegistry {
 
     /**
      * Detecta provider a partir da URL
-     * @param {string} url - URL do repositório
+     * @param {string} url - URL do repositório
      * @returns {string|null} - ID do provider
      */
     detectProviderFromUrl(url) {
@@ -74,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
+     * Cria provider a partir da URL do repositório
+     * @param {string} url - URL do repositório
+     * @param {object} config - Configuração
      * @returns {BaseGitProvider}
      */
     createFromUrl(url, config = {}) {
@@ -97,7 +98,7 @@ export class GitProviderRegistry {
 let instance = null;
 
 /**
- * Obtém instância singleton do GitProviderRegistry
+ * Obtém instância singleton do GitProviderRegistry
  * @returns {GitProviderRegistry}
  */
 export function getGitProviderRegistry() {

package/src/git/github-provider.js

@@ -4,7 +4,7 @@ import { run } from '../utils/exec-utils.js';
 /**
  * GitHubProvider
  *
- * Implementação do Git provider para GitHub.
+ * Implementação do Git provider para GitHub.
  */
 export class GitHubProvider extends BaseGitProvider {
 
@@ -170,7 +170,7 @@ export class GitHubProvider extends BaseGitProvider {
 
         const cloneUrl = this.getCloneUrl(owner, repo, true);
 
-        // Inserir token na URL para autenticação
+        // Inserir token na URL para autenticação
         const authedUrl = cloneUrl.replace(
             'https://',
             `https://${this.accessToken}@`
@@ -216,12 +216,12 @@ export class GitHubProvider extends BaseGitProvider {
         let sha = fromRef;
 
         if (!fromRef.match(/^[a-f0-9]{40}$/)) {
-            // É um nome de branch, precisamos do SHA
+            // É um nome de branch, precisamos do SHA
             const branch = await this.getBranch(owner, repo, fromRef);
             sha = branch.sha;
         }
 
-        // Criar a referência
+        // Criar a referência
         const data = await this.apiRequest(`/repos/${owner}/${repo}/git/refs`, {
             method: 'POST',
             body: JSON.stringify({
@@ -268,7 +268,7 @@ export class GitHubProvider extends BaseGitProvider {
     }
 
     async createCommit(owner, repo, branch, message, changes) {
-        // 1. Obter referência atual
+        // 1. Obter referência atual
         const branchData = await this.getBranch(owner, repo, branch);
         const baseSha = branchData.sha;
 
@@ -327,7 +327,7 @@ export class GitHubProvider extends BaseGitProvider {
             })
         });
 
-        // 6. Atualizar referência da branch
+        // 6. Atualizar referência da branch
         await this.apiRequest(`/repos/${owner}/${repo}/git/refs/heads/${branch}`, {
             method: 'PATCH',
             body: JSON.stringify({
@@ -442,6 +442,299 @@ export class GitHubProvider extends BaseGitProvider {
         };
     }
 
+    // ==========================================
+    // PULL REQUEST COMMENTS / REVIEWS
+    // ==========================================
+
+    /**
+     * List general (issue-level) comments on a PR.
+     * GitHub treats PRs as issues, so general comments use the issues API.
+     */
+    async listPRComments(owner, repo, prNumber, options = {}) {
+        const { page = 1, perPage = 100 } = options;
+
+        const comments = await this.apiRequest(
+            `/repos/${owner}/${repo}/issues/${prNumber}/comments?page=${page}&per_page=${perPage}`
+        );
+
+        return comments.map(c => ({
+            id: c.id,
+            body: c.body,
+            authorUsername: c.user?.login,
+            authorName: c.user?.login,
+            createdAt: c.created_at,
+            updatedAt: c.updated_at,
+            htmlUrl: c.html_url,
+            resolved: undefined, // General comments don't have resolved state in GitHub
+            type: 'general'
+        }));
+    }
+
+    /**
+     * List review comments (inline code comments) on a PR.
+     * These are comments attached to specific lines in the diff.
+     */
+    async listPRReviewComments(owner, repo, prNumber, options = {}) {
+        const { page = 1, perPage = 100 } = options;
+
+        const comments = await this.apiRequest(
+            `/repos/${owner}/${repo}/pulls/${prNumber}/comments?page=${page}&per_page=${perPage}`
+        );
+
+        return comments.map(c => ({
+            id: c.id,
+            body: c.body,
+            path: c.path,
+            line: c.line || c.original_line,
+            side: c.side,
+            commitId: c.commit_id,
+            authorUsername: c.user?.login,
+            authorName: c.user?.login,
+            createdAt: c.created_at,
+            updatedAt: c.updated_at,
+            htmlUrl: c.html_url,
+            resolved: c.resolved !== undefined ? c.resolved : undefined,
+            threadId: c.pull_request_review_id,
+            inReplyToId: c.in_reply_to_id || null,
+            type: 'review'
+        }));
+    }
+
+    /**
+     * Get a specific review comment by ID
+     */
+    async getPRComment(owner, repo, prNumber, commentId) {
+        // Try review comment first, then general
+        try {
+            const c = await this.apiRequest(`/repos/${owner}/${repo}/pulls/comments/${commentId}`);
+            return {
+                id: c.id,
+                body: c.body,
+                path: c.path,
+                line: c.line || c.original_line,
+                side: c.side,
+                commitId: c.commit_id,
+                authorUsername: c.user?.login,
+                authorName: c.user?.login,
+                createdAt: c.created_at,
+                updatedAt: c.updated_at,
+                htmlUrl: c.html_url,
+                resolved: c.resolved !== undefined ? c.resolved : undefined,
+                threadId: c.pull_request_review_id,
+                inReplyToId: c.in_reply_to_id || null,
+                type: 'review'
+            };
+        } catch {
+            // Fall back to general comment (issues API)
+            const c = await this.apiRequest(`/repos/${owner}/${repo}/issues/comments/${commentId}`);
+            return {
+                id: c.id,
+                body: c.body,
+                authorUsername: c.user?.login,
+                authorName: c.user?.login,
+                createdAt: c.created_at,
+                updatedAt: c.updated_at,
+                htmlUrl: c.html_url,
+                resolved: undefined,
+                type: 'general'
+            };
+        }
+    }
+
+    /**
+     * Add a general comment to a PR
+     */
+    async addPRComment(owner, repo, prNumber, body) {
+        const data = await this.apiRequest(`/repos/${owner}/${repo}/issues/${prNumber}/comments`, {
+            method: 'POST',
+            body: JSON.stringify({ body })
+        });
+
+        return {
+            id: data.id,
+            body: data.body,
+            authorUsername: data.user?.login,
+            authorName: data.user?.login,
+            createdAt: data.created_at,
+            updatedAt: data.updated_at,
+            htmlUrl: data.html_url,
+            type: 'general'
+        };
+    }
+
+    /**
+     * Add an inline review comment on a specific line of code.
+     *
+     * @param {object} comment - { body, path, line, side, commitId }
+     *   - path: file path relative to repo root
+     *   - line: line number in the diff
+     *   - side: 'LEFT' (old) or 'RIGHT' (new) - default 'RIGHT'
+     *   - commitId: the HEAD commit SHA of the PR
+     */
+    async addPRReviewComment(owner, repo, prNumber, comment) {
+        const requestBody = {
+            body: comment.body,
+            path: comment.path,
+            commit_id: comment.commitId,
+            side: comment.side || 'RIGHT'
+        };
+
+        // GitHub uses 'line' for single-line or 'start_line' + 'line' for multi-line
+        if (comment.line) {
+            requestBody.line = comment.line;
+        }
+
+        // If replying to an existing thread, use in_reply_to
+        if (comment.inReplyToId) {
+            requestBody.in_reply_to = comment.inReplyToId;
+        }
+
+        const data = await this.apiRequest(`/repos/${owner}/${repo}/pulls/${prNumber}/comments`, {
+            method: 'POST',
+            body: JSON.stringify(requestBody)
+        });
+
+        return {
+            id: data.id,
+            body: data.body,
+            path: data.path,
+            line: data.line || data.original_line,
+            side: data.side,
+            commitId: data.commit_id,
+            authorUsername: data.user?.login,
+            authorName: data.user?.login,
+            createdAt: data.created_at,
+            updatedAt: data.updated_at,
+            htmlUrl: data.html_url,
+            threadId: data.pull_request_review_id,
+            inReplyToId: data.in_reply_to_id || null,
+            type: 'review'
+        };
+    }
+
+    /**
+     * Reply to an existing review comment thread.
+     * GitHub uses the pulls/comments endpoint with in_reply_to.
+     */
+    async replyToPRComment(owner, repo, prNumber, commentId, body) {
+        // For review comments, use the reply endpoint
+        const data = await this.apiRequest(
+            `/repos/${owner}/${repo}/pulls/${prNumber}/comments/${commentId}/replies`, {
+                method: 'POST',
+                body: JSON.stringify({ body })
+            }
+        );
+
+        return {
+            id: data.id,
+            body: data.body,
+            path: data.path,
+            line: data.line || data.original_line,
+            authorUsername: data.user?.login,
+            authorName: data.user?.login,
+            createdAt: data.created_at,
+            updatedAt: data.updated_at,
+            htmlUrl: data.html_url,
+            inReplyToId: commentId,
+            type: 'review'
+        };
+    }
+
+    /**
+     * Resolve a review comment thread in GitHub.
+     *
+     * GitHub doesn't have a direct "resolve comment" API.
+     * Resolution is done by submitting a review that resolves the thread.
+     * We use the GraphQL API for thread resolution.
+     *
+     * Fallback: If GraphQL is not available, we reply with a "Resolved" message.
+     */
+    async resolvePRComment(owner, repo, prNumber, commentId) {
+        try {
+            // Try GraphQL approach (thread resolution)
+            const query = `
+                mutation($threadId: ID!) {
+                    resolveReviewThread(input: { threadId: $threadId }) {
+                        thread { isResolved }
+                    }
+                }
+            `;
+
+            await fetch('https://api.github.com/graphql', {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${this.accessToken}`,
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    query,
+                    variables: { threadId: String(commentId) }
+                })
+            });
+
+            return { resolved: true };
+        } catch {
+            // Fallback: add a reply indicating resolution
+            await this.replyToPRComment(owner, repo, prNumber, commentId,
+                '✅ Resolved by InspTech AI — fix has been applied.');
+            return { resolved: true };
+        }
+    }
+
+    /**
+     * Unresolve a review comment thread in GitHub via GraphQL.
+     */
+    async unresolvePRComment(owner, repo, prNumber, commentId) {
+        try {
+            const query = `
+                mutation($threadId: ID!) {
+                    unresolveReviewThread(input: { threadId: $threadId }) {
+                        thread { isResolved }
+                    }
+                }
+            `;
+
+            await fetch('https://api.github.com/graphql', {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${this.accessToken}`,
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    query,
+                    variables: { threadId: String(commentId) }
+                })
+            });
+
+            return { resolved: false };
+        } catch {
+            return { resolved: false };
+        }
+    }
+
+    /**
+     * List only unresolved review comments.
+     * Uses the reviews API to find pending threads.
+     */
+    async listUnresolvedPRComments(owner, repo, prNumber) {
+        const reviewComments = await this.listPRReviewComments(owner, repo, prNumber);
+
+        // Group by thread (in_reply_to chain) and filter unresolved
+        const threads = new Map();
+        for (const c of reviewComments) {
+            const threadKey = c.inReplyToId || c.id;
+            if (!threads.has(threadKey)) {
+                threads.set(threadKey, []);
+            }
+            threads.get(threadKey).push(c);
+        }
+
+        // Return root comments of unresolved threads
+        return reviewComments.filter(c =>
+            !c.inReplyToId && (c.resolved === false || c.resolved === undefined)
+        );
+    }
+
     // ==========================================
     // WEBHOOKS
     // ==========================================