@vibe-validate/cli 0.17.6 → 0.18.0

package/dist/services/github-fetcher.js

@@ -0,0 +1,441 @@
+/**
+ * GitHubFetcher - Fetch PR metadata and check results from GitHub API
+ *
+ * Uses `gh` CLI to fetch:
+ * - Complete PR metadata (title, author, labels, linked issues, etc.)
+ * - Check results (GitHub Actions + external status checks)
+ * - Run logs from GitHub Actions
+ * - File changes from git diff
+ *
+ * @packageDocumentation
+ */
+import { fetchPRDetails as ghFetchPRDetails, fetchPRChecks, fetchRunLogs as ghFetchRunLogs, fetchRunDetails as ghFetchRunDetails, fetchRunJobs as ghFetchRunJobs, getDiffStats, getCommitCount, listWorkflowRuns, } from '@vibe-validate/git';
+/**
+ * GitHubFetcher - Fetch PR data from GitHub API via gh CLI
+ */
+export class GitHubFetcher {
+    owner;
+    repo;
+    /**
+     * Create GitHubFetcher
+     *
+     * @param owner - Repository owner (optional, defaults to current repo)
+     * @param repo - Repository name (optional, defaults to current repo)
+     */
+    constructor(owner, repo) {
+        this.owner = owner;
+        this.repo = repo;
+    }
+    /**
+     * Fetch complete PR metadata
+     *
+     * @param prNumber - PR number
+     * @returns PR metadata
+     */
+    async fetchPRDetails(prNumber) {
+        const fields = [
+            'number',
+            'title',
+            'url',
+            'headRefName',
+            'baseRefName',
+            'author',
+            'isDraft',
+            'mergeable',
+            'mergeStateStatus',
+            'labels',
+            'closingIssuesReferences',
+        ];
+        const data = ghFetchPRDetails(prNumber, this.owner, this.repo, fields);
+        // Map GitHub API response to PRMetadata schema
+        return {
+            number: data.number,
+            title: data.title,
+            url: data.url,
+            branch: data.headRefName,
+            base_branch: data.baseRefName,
+            author: data.author.login,
+            draft: data.isDraft ?? false,
+            mergeable: data.mergeable === 'MERGEABLE',
+            merge_state_status: this.normalizeMergeStateStatus(data.mergeStateStatus ?? 'UNKNOWN'),
+            labels: data.labels?.map((label) => label.name) ?? [],
+            linked_issues: this.extractLinkedIssues(data.closingIssuesReferences),
+        };
+    }
+    /**
+     * Fetch check results (GitHub Actions + external)
+     *
+     * @param prNumber - PR number
+     * @returns Check results
+     */
+    async fetchChecks(prNumber) {
+        const data = fetchPRChecks(prNumber, this.owner, this.repo);
+        const checks = [];
+        for (const check of data.statusCheckRollup ?? []) {
+            const type = this.classifyCheck(check);
+            if (type === 'CheckRun') {
+                checks.push(this.mapCheckRun(check));
+            }
+            else {
+                checks.push(this.mapStatusContext(check));
+            }
+        }
+        return checks;
+    }
+    /**
+     * Fetch run logs for a GitHub Actions run
+     *
+     * @param runId - GitHub run ID
+     * @param jobId - GitHub job ID (optional, for matrix strategy jobs)
+     * @returns Raw log output
+     *
+     * When jobId is provided, fetches logs for a specific job within the run.
+     * This is critical for matrix strategy builds where extraction needs job-specific logs.
+     */
+    async fetchRunLogs(runId, jobId) {
+        return ghFetchRunLogs(runId, this.owner, this.repo, jobId);
+    }
+    /**
+     * Fetch details for a specific GitHub Actions run
+     *
+     * Useful for watching specific failed runs to test extraction.
+     *
+     * @param runId - GitHub run ID
+     * @returns Run details
+     */
+    async fetchRunDetails(runId) {
+        const fields = ['name', 'status', 'conclusion', 'workflowName', 'createdAt', 'updatedAt', 'url'];
+        const data = ghFetchRunDetails(runId, this.owner, this.repo, fields);
+        // Map GitHub API response to RunDetails
+        return {
+            run_id: runId,
+            name: data.name,
+            workflow: data.workflowName,
+            status: this.normalizeStatus(data.status),
+            conclusion: data.conclusion ? this.normalizeConclusion(data.conclusion) : undefined,
+            started_at: data.createdAt,
+            duration: this.calculateDuration(data.createdAt, data.updatedAt),
+            url: data.url,
+        };
+    }
+    /**
+     * Fetch jobs for a workflow run
+     *
+     * @param runId - Run ID
+     * @returns List of jobs for the run
+     */
+    async fetchRunJobs(runId) {
+        return ghFetchRunJobs(runId, this.owner, this.repo);
+    }
+    /**
+     * Fetch all workflow runs for a PR
+     *
+     * @param prNumber - PR number
+     * @returns List of workflow runs
+     */
+    async fetchRunsForPR(prNumber) {
+        // First get the PR branch name
+        const prData = ghFetchPRDetails(prNumber, this.owner, this.repo, ['headRefName']);
+        const branchName = prData.headRefName;
+        // Fetch workflow runs for the branch
+        const runs = listWorkflowRuns(branchName, this.owner, this.repo, 20, ['databaseId', 'workflowName', 'status', 'conclusion', 'createdAt', 'updatedAt']);
+        // Transform to expected format
+        return runs.map((run) => ({
+            run_id: run.databaseId,
+            workflow_name: run.workflowName,
+            status: run.status,
+            conclusion: run.conclusion,
+            started_at: run.createdAt,
+            duration: this.calculateDuration(run.createdAt, run.updatedAt),
+        }));
+    }
+    /**
+     * Fetch file changes for a PR
+     *
+     * Uses git diff --numstat to get file change statistics.
+     *
+     * @param _prNumber - PR number (unused - we use git diff from current branch)
+     * @returns File change context
+     */
+    async fetchFileChanges(_prNumber) {
+        // Get diff stats using getDiffStats from @vibe-validate/git (architectural compliance)
+        const diffOutput = getDiffStats('origin/main', 'HEAD');
+        // Get commit count using getCommitCount from @vibe-validate/git (architectural compliance)
+        const commitCount = getCommitCount('origin/main', 'HEAD');
+        // Parse diff output
+        const lines = diffOutput.trim().split('\n').filter((line) => line.length > 0);
+        let totalInsertions = 0;
+        let totalDeletions = 0;
+        const files = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const parts = line.split('\t');
+            if (parts.length !== 3)
+                continue;
+            // Skip binary file markers (0\t0\t-)
+            if (parts[0] === '0' && parts[1] === '0' && parts[2] === '-') {
+                continue;
+            }
+            const insertions = parts[0] === '-' ? 0 : Number.parseInt(parts[0], 10);
+            const deletions = parts[1] === '-' ? 0 : Number.parseInt(parts[1], 10);
+            const file = parts[2];
+            // Detect new files - next line is 0\t0\t- marker
+            const nextLine = i + 1 < lines.length ? lines[i + 1] : '';
+            const nextParts = nextLine.split('\t');
+            const isNewFile = nextParts.length === 3 && nextParts[0] === '0' && nextParts[1] === '0' && nextParts[2] === '-';
+            totalInsertions += insertions;
+            totalDeletions += deletions;
+            files.push({
+                file,
+                insertions,
+                deletions,
+                new_file: isNewFile,
+            });
+        }
+        // Sort by total changes (insertions + deletions) and limit to top 10
+        // Using toSorted to avoid mutation (sonarjs requirement)
+        const topFiles = [...files]
+            .sort((a, b) => b.insertions + b.deletions - (a.insertions + a.deletions))
+            .slice(0, 10);
+        return {
+            files_changed: files.length,
+            insertions: totalInsertions,
+            deletions: totalDeletions,
+            commits: Number.parseInt(commitCount.trim(), 10),
+            top_files: topFiles,
+        };
+    }
+    /**
+     * Classify check type
+     *
+     * @param check - Check object from GitHub API
+     * @returns 'CheckRun' or 'StatusContext'
+     */
+    classifyCheck(check) {
+        return check.__typename === 'CheckRun' ? 'CheckRun' : 'StatusContext';
+    }
+    /**
+     * Map CheckRun to internal CheckResult
+     *
+     * @param check - CheckRun from GitHub API
+     * @returns CheckResult
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    mapCheckRun(check) {
+        const runId = this.extractRunId(check.detailsUrl);
+        const jobId = this.extractJobId(check.detailsUrl);
+        const workflow = this.extractWorkflowName(check.name);
+        return {
+            type: 'github_action',
+            name: check.name,
+            status: this.normalizeStatus(check.status),
+            conclusion: check.conclusion ? this.normalizeConclusion(check.conclusion) : undefined,
+            run_id: runId ?? undefined,
+            job_id: jobId ?? undefined,
+            workflow,
+            started_at: check.startedAt,
+            duration: this.calculateDuration(check.startedAt, check.completedAt),
+        };
+    }
+    /**
+     * Map StatusContext to internal CheckResult
+     *
+     * @param check - StatusContext from GitHub API
+     * @returns CheckResult
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    mapStatusContext(check) {
+        return {
+            type: 'external',
+            name: check.context,
+            status: 'completed',
+            conclusion: this.normalizeStatusContextState(check.state),
+            url: check.targetUrl,
+            provider: this.detectProvider(check.context),
+        };
+    }
+    /**
+     * Extract run ID from GitHub Actions URL
+     *
+     * @param url - GitHub Actions URL
+     * @returns Run ID or null
+     */
+    extractRunId(url) {
+        const regex = /\/runs\/(\d+)/;
+        const match = regex.exec(url);
+        return match ? Number.parseInt(match[1], 10) : null;
+    }
+    /**
+     * Extract job ID from GitHub Actions URL
+     *
+     * Matrix strategy jobs have URLs like:
+     * https://github.com/owner/repo/actions/runs/12345/job/67890
+     *
+     * @param url - GitHub Actions URL
+     * @returns Job ID or null
+     */
+    extractJobId(url) {
+        const regex = /\/job\/(\d+)/;
+        const match = regex.exec(url);
+        return match ? Number.parseInt(match[1], 10) : null;
+    }
+    /**
+     * Extract workflow name from check name
+     *
+     * @param checkName - Check name (e.g., "CI / Build")
+     * @returns Workflow name
+     */
+    extractWorkflowName(checkName) {
+        // Extract workflow name before first /
+        const parts = checkName.split('/');
+        return parts[0].trim();
+    }
+    /**
+     * Calculate duration between two timestamps
+     *
+     * @param start - Start time (ISO 8601)
+     * @param end - End time (ISO 8601, optional - defaults to now)
+     * @returns Human-readable duration (e.g., "2m30s")
+     */
+    calculateDuration(start, end) {
+        if (!start)
+            return '0s';
+        const startTime = new Date(start).getTime();
+        // Handle invalid start time
+        if (Number.isNaN(startTime))
+            return '0s';
+        const endTime = end ? new Date(end).getTime() : Date.now();
+        // Handle invalid end time (fall back to now)
+        const effectiveEndTime = Number.isNaN(endTime) ? Date.now() : endTime;
+        const durationMs = effectiveEndTime - startTime;
+        // Handle negative duration (clock skew or invalid data)
+        if (durationMs < 0 || Number.isNaN(durationMs))
+            return '0s';
+        const seconds = Math.floor(durationMs / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        if (hours > 0) {
+            return `${hours}h${minutes % 60}m${seconds % 60}s`;
+        }
+        else if (minutes > 0) {
+            return `${minutes}m${seconds % 60}s`;
+        }
+        else {
+            return `${seconds}s`;
+        }
+    }
+    /**
+     * Normalize GitHub status to CheckStatus
+     *
+     * @param status - GitHub status
+     * @returns CheckStatus
+     */
+    normalizeStatus(status) {
+        const normalized = status.toLowerCase();
+        if (normalized === 'completed')
+            return 'completed';
+        if (normalized === 'in_progress')
+            return 'in_progress';
+        return 'queued';
+    }
+    /**
+     * Normalize GitHub conclusion to CheckConclusion
+     *
+     * @param conclusion - GitHub conclusion
+     * @returns CheckConclusion
+     */
+    normalizeConclusion(conclusion) {
+        const normalized = conclusion.toLowerCase();
+        if (normalized === 'success')
+            return 'success';
+        if (normalized === 'failure')
+            return 'failure';
+        if (normalized === 'neutral')
+            return 'neutral';
+        if (normalized === 'cancelled')
+            return 'cancelled';
+        if (normalized === 'skipped')
+            return 'skipped';
+        if (normalized === 'timed_out')
+            return 'timed_out';
+        return 'action_required';
+    }
+    /**
+     * Normalize StatusContext state to CheckConclusion
+     *
+     * @param state - StatusContext state
+     * @returns CheckConclusion
+     */
+    normalizeStatusContextState(state) {
+        const normalized = state.toLowerCase();
+        if (normalized === 'success')
+            return 'success';
+        if (normalized === 'failure' || normalized === 'error')
+            return 'failure';
+        if (normalized === 'pending')
+            return 'action_required';
+        return 'neutral';
+    }
+    /**
+     * Normalize merge state status
+     *
+     * @param status - GitHub merge state status
+     * @returns MergeStateStatus
+     */
+    normalizeMergeStateStatus(status) {
+        const normalized = status.toUpperCase();
+        if (normalized === 'BEHIND')
+            return 'BEHIND';
+        if (normalized === 'BLOCKED')
+            return 'BLOCKED';
+        if (normalized === 'CLEAN')
+            return 'CLEAN';
+        if (normalized === 'DIRTY')
+            return 'DIRTY';
+        if (normalized === 'DRAFT')
+            return 'DRAFT';
+        if (normalized === 'HAS_HOOKS')
+            return 'HAS_HOOKS';
+        if (normalized === 'UNSTABLE')
+            return 'UNSTABLE';
+        return 'UNKNOWN';
+    }
+    /**
+     * Extract linked issues from closing issues references
+     *
+     * @param closingIssuesReferences - Closing issues references from GitHub API
+     * @returns Linked issues
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    extractLinkedIssues(closingIssuesReferences) {
+        if (!closingIssuesReferences?.nodes)
+            return [];
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return closingIssuesReferences.nodes.map((issue) => ({
+            number: issue.number,
+            title: issue.title,
+            url: issue.url,
+        }));
+    }
+    /**
+     * Detect provider from check name
+     *
+     * @param checkName - Check name
+     * @returns Provider name
+     */
+    detectProvider(checkName) {
+        const lower = checkName.toLowerCase();
+        if (lower.includes('codecov'))
+            return 'codecov';
+        if (lower.includes('sonar'))
+            return 'sonarcloud';
+        if (lower.includes('circleci'))
+            return 'circleci';
+        if (lower.includes('travis'))
+            return 'travis';
+        if (lower.includes('jenkins'))
+            return 'jenkins';
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=github-fetcher.js.map

package/dist/services/github-fetcher.js.map

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

package/dist/services/history-summary-builder.d.ts

@@ -0,0 +1,74 @@
+/**
+ * History Summary Builder
+ *
+ * Fetches workflow runs for a PR branch and calculates:
+ * - Total number of runs
+ * - Recent pattern (passed/failed/flaky)
+ * - Success rate
+ *
+ * Provides context for pattern recognition without full history details.
+ *
+ * @packageDocumentation
+ */
+import type { CheckHistorySummary } from '../schemas/watch-pr-result.schema.js';
+/**
+ * HistorySummaryBuilder
+ *
+ * Builds a condensed history summary for pattern recognition.
+ */
+export declare class HistorySummaryBuilder {
+    private readonly _owner;
+    private readonly _repo;
+    constructor(_owner: string, _repo: string);
+    /**
+     * Build history summary for a PR branch
+     *
+     * @param branch - Branch name
+     * @returns History summary with total runs, pattern, and success rate
+     */
+    buildSummary(branch: string): Promise<CheckHistorySummary>;
+    /**
+     * Fetch workflow runs for a branch via gh CLI
+     *
+     * @param branch - Branch name
+     * @returns Array of workflow runs (sorted by created_at DESC)
+     */
+    private fetchWorkflowRuns;
+    /**
+     * Detect pattern from recent runs
+     *
+     * Patterns:
+     * - "Passed last N runs" - All recent runs passed
+     * - "Failed last N runs" - All recent runs failed
+     * - "Flaky (alternating)" - Alternating pass/fail
+     * - "Recently fixed (was failing)" - Recent passes after failures
+     * - Generic pattern otherwise
+     *
+     * @param runs - All runs (sorted DESC)
+     * @returns Pattern description
+     */
+    private detectPattern;
+    /**
+     * Count consecutive runs with the same conclusion (starting from most recent)
+     *
+     * @param runs - Workflow runs
+     * @param conclusion - Conclusion to check
+     * @returns Count of consecutive runs
+     */
+    private countConsecutive;
+    /**
+     * Check if runs are alternating between success and failure
+     *
+     * @param runs - Workflow runs (at least 4 required)
+     * @returns True if alternating pattern detected
+     */
+    private isAlternating;
+    /**
+     * Calculate success rate from recent runs
+     *
+     * @param runs - Recent workflow runs (up to 10)
+     * @returns Success rate as percentage string (e.g., "75%")
+     */
+    private calculateSuccessRate;
+}
+//# sourceMappingURL=history-summary-builder.d.ts.map

package/dist/services/history-summary-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-summary-builder.d.ts","sourceRoot":"","sources":["../../src/services/history-summary-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAUhF;;;;GAIG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM;IAGhC;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA+BhE;;;;;OAKG;YACW,iBAAiB;IA+B/B;;;;;;;;;;;;OAYG;IAEH,OAAO,CAAC,aAAa;IAsDrB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAmBrB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;CAU7B"}