@probelabs/visor 0.1.0

package/dist/github-check-service.js

@@ -0,0 +1,382 @@
+"use strict";
+/**
+ * GitHub Check Service for creating and managing check runs based on failure conditions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubCheckService = void 0;
+/**
+ * Service for managing GitHub Check Runs based on Visor failure conditions
+ */
+class GitHubCheckService {
+    octokit;
+    maxAnnotations = 50; // GitHub API limit
+    constructor(octokit) {
+        this.octokit = octokit;
+    }
+    /**
+     * Create a new check run in queued status
+     */
+    async createCheckRun(options, summary) {
+        try {
+            const response = await this.octokit.rest.checks.create({
+                owner: options.owner,
+                repo: options.repo,
+                name: options.name,
+                head_sha: options.head_sha,
+                status: 'queued',
+                details_url: options.details_url,
+                external_id: options.external_id,
+                output: summary
+                    ? {
+                        title: summary.title,
+                        summary: summary.summary,
+                        text: summary.text,
+                    }
+                    : undefined,
+            });
+            return {
+                id: response.data.id,
+                url: response.data.html_url || '',
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to create check run: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Update check run to in_progress status
+     */
+    async updateCheckRunInProgress(owner, repo, check_run_id, summary) {
+        try {
+            await this.octokit.rest.checks.update({
+                owner,
+                repo,
+                check_run_id,
+                status: 'in_progress',
+                output: summary
+                    ? {
+                        title: summary.title,
+                        summary: summary.summary,
+                        text: summary.text,
+                    }
+                    : undefined,
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to update check run to in_progress: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Complete a check run with results based on failure conditions
+     */
+    async completeCheckRun(owner, repo, check_run_id, checkName, failureResults, reviewIssues = [], executionError) {
+        try {
+            const { conclusion, summary } = this.determineCheckRunConclusion(checkName, failureResults, reviewIssues, executionError);
+            const annotations = this.convertIssuesToAnnotations(reviewIssues);
+            await this.octokit.rest.checks.update({
+                owner,
+                repo,
+                check_run_id,
+                status: 'completed',
+                conclusion,
+                completed_at: new Date().toISOString(),
+                output: {
+                    title: summary.title,
+                    summary: summary.summary,
+                    text: summary.text,
+                    annotations: annotations.slice(0, this.maxAnnotations), // GitHub limit
+                },
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to complete check run: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Determine check run conclusion based on failure conditions and issues
+     */
+    determineCheckRunConclusion(checkName, failureResults, reviewIssues, executionError) {
+        // Handle execution errors first
+        if (executionError) {
+            return {
+                conclusion: 'failure',
+                summary: {
+                    title: '❌ Check Execution Failed',
+                    summary: `The ${checkName} check failed to execute properly.`,
+                    text: `**Error:** ${executionError}\n\nPlease check your configuration and try again.`,
+                },
+            };
+        }
+        // Check for failed conditions
+        const failedConditions = failureResults.filter(result => result.failed);
+        const errorConditions = failedConditions.filter(result => result.severity === 'error');
+        const warningConditions = failedConditions.filter(result => result.severity === 'warning');
+        // Count issues by severity
+        const criticalIssues = reviewIssues.filter(issue => issue.severity === 'critical').length;
+        const errorIssues = reviewIssues.filter(issue => issue.severity === 'error').length;
+        const warningIssues = reviewIssues.filter(issue => issue.severity === 'warning').length;
+        const totalIssues = reviewIssues.length;
+        // Determine conclusion based on failure conditions and issues
+        let conclusion;
+        let title;
+        let summaryText;
+        let details;
+        if (errorConditions.length > 0 || criticalIssues > 0) {
+            conclusion = 'failure';
+            title = '🚨 Check Failed';
+            summaryText = `${checkName} check failed due to ${errorConditions.length > 0 ? 'failure conditions' : 'critical issues'}.`;
+            details = this.formatCheckDetails(failureResults, reviewIssues, {
+                failedConditions: errorConditions.length,
+                warningConditions: warningConditions.length,
+                criticalIssues,
+                errorIssues,
+                warningIssues,
+                totalIssues,
+            });
+        }
+        else if (warningConditions.length > 0 || errorIssues > 0) {
+            conclusion = 'neutral';
+            title = '⚠️ Check Completed with Warnings';
+            summaryText = `${checkName} check completed but found ${warningConditions.length > 0 ? 'warning conditions' : 'error-level issues'}.`;
+            details = this.formatCheckDetails(failureResults, reviewIssues, {
+                failedConditions: 0,
+                warningConditions: warningConditions.length,
+                criticalIssues,
+                errorIssues,
+                warningIssues,
+                totalIssues,
+            });
+        }
+        else if (warningIssues > 0) {
+            conclusion = 'neutral';
+            title = '⚠️ Check Completed with Minor Issues';
+            summaryText = `${checkName} check completed with ${warningIssues} warning${warningIssues === 1 ? '' : 's'}.`;
+            details = this.formatCheckDetails(failureResults, reviewIssues, {
+                failedConditions: 0,
+                warningConditions: 0,
+                criticalIssues,
+                errorIssues,
+                warningIssues,
+                totalIssues,
+            });
+        }
+        else {
+            conclusion = 'success';
+            title = '✅ Check Passed';
+            summaryText = `${checkName} check completed successfully with no issues found.`;
+            details = this.formatCheckDetails(failureResults, reviewIssues, {
+                failedConditions: 0,
+                warningConditions: 0,
+                criticalIssues: 0,
+                errorIssues: 0,
+                warningIssues: 0,
+                totalIssues: 0,
+            });
+        }
+        return {
+            conclusion,
+            summary: {
+                title,
+                summary: summaryText,
+                text: details,
+            },
+        };
+    }
+    /**
+     * Format detailed check results for the check run summary
+     */
+    formatCheckDetails(failureResults, reviewIssues, counts) {
+        const sections = [];
+        // Summary section
+        sections.push('## 📊 Summary');
+        sections.push(`- **Total Issues:** ${counts.totalIssues}`);
+        if (counts.criticalIssues > 0) {
+            sections.push(`- **Critical Issues:** ${counts.criticalIssues}`);
+        }
+        if (counts.errorIssues > 0) {
+            sections.push(`- **Error Issues:** ${counts.errorIssues}`);
+        }
+        if (counts.warningIssues > 0) {
+            sections.push(`- **Warning Issues:** ${counts.warningIssues}`);
+        }
+        sections.push('');
+        // Failure conditions section
+        if (failureResults.length > 0) {
+            sections.push('## 🔍 Failure Condition Results');
+            const failedConditions = failureResults.filter(result => result.failed);
+            const passedConditions = failureResults.filter(result => !result.failed);
+            if (failedConditions.length > 0) {
+                sections.push('### ❌ Failed Conditions');
+                failedConditions.forEach(condition => {
+                    sections.push(`- **${condition.conditionName}**: ${condition.message || condition.expression}`);
+                    if (condition.severity === 'error') {
+                        sections.push(`  - ⚠️ **Severity:** Error`);
+                    }
+                });
+                sections.push('');
+            }
+            if (passedConditions.length > 0) {
+                sections.push('### ✅ Passed Conditions');
+                passedConditions.forEach(condition => {
+                    sections.push(`- **${condition.conditionName}**: ${condition.message || 'Condition passed'}`);
+                });
+                sections.push('');
+            }
+        }
+        // Issues by category section
+        if (reviewIssues.length > 0) {
+            const issuesByCategory = this.groupIssuesByCategory(reviewIssues);
+            sections.push('## 🐛 Issues by Category');
+            Object.entries(issuesByCategory).forEach(([category, issues]) => {
+                if (issues.length > 0) {
+                    sections.push(`### ${this.getCategoryEmoji(category)} ${category.charAt(0).toUpperCase() + category.slice(1)} (${issues.length})`);
+                    // Show only first 5 issues per category to keep the summary concise
+                    const displayIssues = issues.slice(0, 5);
+                    displayIssues.forEach(issue => {
+                        const severityIcon = this.getSeverityIcon(issue.severity);
+                        sections.push(`- ${severityIcon} **${issue.file}:${issue.line}** - ${issue.message}`);
+                    });
+                    if (issues.length > 5) {
+                        sections.push(`- *...and ${issues.length - 5} more ${category} issues*`);
+                    }
+                    sections.push('');
+                }
+            });
+        }
+        // Footer
+        sections.push('---');
+        sections.push('*Generated by [Visor](https://github.com/probelabs/visor) - AI-powered code review*');
+        return sections.join('\n');
+    }
+    /**
+     * Convert review issues to GitHub check run annotations
+     */
+    convertIssuesToAnnotations(reviewIssues) {
+        return reviewIssues
+            .slice(0, this.maxAnnotations) // Respect GitHub's annotation limit
+            .map(issue => ({
+            path: issue.file,
+            start_line: issue.line,
+            end_line: issue.endLine || issue.line,
+            annotation_level: this.mapSeverityToAnnotationLevel(issue.severity),
+            message: issue.message,
+            title: `${issue.category} Issue`,
+            raw_details: issue.suggestion || undefined,
+        }));
+    }
+    /**
+     * Map Visor issue severity to GitHub annotation level
+     */
+    mapSeverityToAnnotationLevel(severity) {
+        switch (severity) {
+            case 'critical':
+            case 'error':
+                return 'failure';
+            case 'warning':
+                return 'warning';
+            case 'info':
+            default:
+                return 'notice';
+        }
+    }
+    /**
+     * Group issues by category
+     */
+    groupIssuesByCategory(issues) {
+        const grouped = {};
+        issues.forEach(issue => {
+            const category = issue.category || 'general';
+            if (!grouped[category]) {
+                grouped[category] = [];
+            }
+            grouped[category].push(issue);
+        });
+        return grouped;
+    }
+    /**
+     * Get emoji for issue category
+     */
+    getCategoryEmoji(category) {
+        const emojiMap = {
+            security: '🔐',
+            performance: '⚡',
+            style: '🎨',
+            logic: '🧠',
+            architecture: '🏗️',
+            documentation: '📚',
+            general: '📝',
+        };
+        return emojiMap[category.toLowerCase()] || '📝';
+    }
+    /**
+     * Get icon for issue severity
+     */
+    getSeverityIcon(severity) {
+        const iconMap = {
+            critical: '🚨',
+            error: '❌',
+            warning: '⚠️',
+            info: 'ℹ️',
+        };
+        return iconMap[severity.toLowerCase()] || 'ℹ️';
+    }
+    /**
+     * Create multiple check runs for different checks with failure condition support
+     */
+    async createMultipleCheckRuns(options, checkResults) {
+        const results = [];
+        for (const checkResult of checkResults) {
+            try {
+                // Create check run
+                const checkRun = await this.createCheckRun({
+                    ...options,
+                    name: `Visor: ${checkResult.checkName}`,
+                    external_id: `visor-${checkResult.checkName}-${options.head_sha.substring(0, 7)}`,
+                });
+                // Update to in progress
+                await this.updateCheckRunInProgress(options.owner, options.repo, checkRun.id, {
+                    title: `Running ${checkResult.checkName} check...`,
+                    summary: `Analyzing code with ${checkResult.checkName} check using AI.`,
+                });
+                // Complete with results
+                await this.completeCheckRun(options.owner, options.repo, checkRun.id, checkResult.checkName, checkResult.failureResults, checkResult.reviewIssues, checkResult.executionError);
+                results.push({
+                    checkName: checkResult.checkName,
+                    id: checkRun.id,
+                    url: checkRun.url,
+                });
+            }
+            catch (error) {
+                console.error(`Failed to create check run for ${checkResult.checkName}:`, error);
+                // Continue with other checks even if one fails
+            }
+        }
+        return results;
+    }
+    /**
+     * Get check runs for a specific commit
+     */
+    async getCheckRuns(owner, repo, ref) {
+        try {
+            const response = await this.octokit.rest.checks.listForRef({
+                owner,
+                repo,
+                ref,
+                filter: 'all',
+            });
+            return response.data.check_runs
+                .filter(check => check.name.startsWith('Visor:'))
+                .map(check => ({
+                id: check.id,
+                name: check.name,
+                status: check.status,
+                conclusion: check.conclusion,
+            }));
+        }
+        catch (error) {
+            throw new Error(`Failed to get check runs: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+exports.GitHubCheckService = GitHubCheckService;
+//# sourceMappingURL=github-check-service.js.map

package/dist/github-check-service.js.map

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

package/dist/github-comments.d.ts

@@ -0,0 +1,109 @@
+import { Octokit } from '@octokit/rest';
+export interface Comment {
+    id: number;
+    body: string;
+    user: {
+        login: string;
+    };
+    created_at: string;
+    updated_at: string;
+}
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelay: number;
+    maxDelay: number;
+    backoffFactor: number;
+}
+export interface CommentMetadata {
+    commentId: string;
+    lastUpdated: string;
+    triggeredBy: string;
+    commitSha?: string;
+}
+/**
+ * Manages GitHub PR comments with dynamic updating capabilities
+ */
+export declare class CommentManager {
+    private octokit;
+    private retryConfig;
+    constructor(octokit: Octokit, retryConfig?: Partial<RetryConfig>);
+    /**
+     * Find existing Visor comment by comment ID marker
+     */
+    findVisorComment(owner: string, repo: string, prNumber: number, commentId?: string): Promise<Comment | null>;
+    /**
+     * Update existing comment or create new one with collision detection
+     */
+    updateOrCreateComment(owner: string, repo: string, prNumber: number, content: string, options?: {
+        commentId?: string;
+        triggeredBy?: string;
+        allowConcurrentUpdates?: boolean;
+        commitSha?: string;
+    }): Promise<Comment>;
+    /**
+     * Format comment content with metadata markers
+     */
+    formatCommentWithMetadata(content: string, metadata: CommentMetadata): string;
+    /**
+     * Create collapsible sections for comment content
+     */
+    createCollapsibleSection(title: string, content: string, isExpanded?: boolean): string;
+    /**
+     * Group review results by check type with collapsible sections
+     */
+    formatGroupedResults(results: Array<{
+        checkType: string;
+        content: string;
+        score?: number;
+        issuesFound?: number;
+    }>, groupBy?: 'check' | 'severity'): string;
+    /**
+     * Generate unique comment ID
+     */
+    private generateCommentId;
+    /**
+     * Check if comment is a Visor comment
+     */
+    private isVisorComment;
+    /**
+     * Extract comment ID from comment body
+     */
+    extractCommentId(body: string): string | null;
+    /**
+     * Handle rate limiting with exponential backoff
+     */
+    private handleRateLimit;
+    /**
+     * Check if error is a rate limit error
+     */
+    private isRateLimitError;
+    /**
+     * Check if error should not be retried (auth errors, not found, etc.)
+     */
+    private isNonRetryableError;
+    /**
+     * Retry wrapper with exponential backoff
+     */
+    private withRetry;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Group results by specified criteria
+     */
+    private groupResults;
+    /**
+     * Get severity group based on score
+     */
+    private getSeverityGroup;
+    /**
+     * Get emoji for check type
+     */
+    private getCheckTypeEmoji;
+    /**
+     * Format group title with score and issue count
+     */
+    private formatGroupTitle;
+}
+//# sourceMappingURL=github-comments.d.ts.map

package/dist/github-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-comments.d.ts","sourceRoot":"","sources":["../src/github-comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAAc;gBAErB,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAWhE;;OAEG;IACU,gBAAgB,CAC3B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IA6B1B;;OAEG;IACU,qBAAqB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GACL,OAAO,CAAC,OAAO,CAAC;IAuDnB;;OAEG;IACI,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM;IAYpF;;OAEG;IACI,wBAAwB,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,OAAe,GAC1B,MAAM;IAUT;;OAEG;IACI,oBAAoB,CACzB,OAAO,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAC5F,OAAO,GAAE,OAAO,GAAG,UAAoB,GACtC,MAAM;IAkBT;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKpD;;OAEG;YACW,eAAe;IAc7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;YACW,SAAS;IAmCvB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAIzB"}