@runcore-sh/runcore 0.1.2

package/dist/github/retry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Retry utilities for GitHub API calls.
+ * Exponential backoff with jitter, error classification, and structured errors.
+ * Mirrors the Linear retry pattern with GitHub-specific error handling.
+ */
+/** Classifies errors as transient (retry) or permanent (don't retry). */
+export type ErrorKind = "transient" | "permanent" | "auth";
+export declare class GitHubApiError extends Error {
+    readonly kind: ErrorKind;
+    readonly statusCode?: number | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, kind: ErrorKind, statusCode?: number | undefined, cause?: unknown | undefined);
+}
+/**
+ * Classify an error from the GitHub API.
+ * - 401/403 → auth (don't retry, token is bad or insufficient scope)
+ * - 429, 500, 502, 503, 504 → transient (retry)
+ * - Network errors → transient
+ * - Everything else → permanent
+ */
+export declare function classifyError(err: unknown): ErrorKind;
+export interface RetryOpts {
+    /** Maximum number of attempts (including the first). Default: 3. */
+    maxAttempts?: number;
+    /** Base delay in ms before first retry. Default: 1000. */
+    baseDelayMs?: number;
+    /** Maximum delay in ms. Default: 30000. */
+    maxDelayMs?: number;
+    /** Label for logging. */
+    label?: string;
+    /** Per-attempt timeout in ms. Default: 15000. */
+    timeoutMs?: number;
+}
+/**
+ * Execute `fn` with exponential backoff + jitter.
+ * Only retries transient errors. Auth and permanent errors fail immediately.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, opts?: RetryOpts): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/github/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/github/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,yEAAyE;AACzE,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAE3D,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,SAAS;aACf,UAAU,CAAC,EAAE,MAAM;aACnB,KAAK,CAAC,EAAE,OAAO;gBAH/B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,SAAS,EACf,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAgCrD;AAED,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,CAAC,CAAC,CA+DZ"}

package/dist/github/retry.js

@@ -0,0 +1,117 @@
+/**
+ * Retry utilities for GitHub API calls.
+ * Exponential backoff with jitter, error classification, and structured errors.
+ * Mirrors the Linear retry pattern with GitHub-specific error handling.
+ */
+import { traceApiCall } from "../tracing/instrument.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("github");
+export class GitHubApiError extends Error {
+    kind;
+    statusCode;
+    cause;
+    constructor(message, kind, statusCode, cause) {
+        super(message);
+        this.kind = kind;
+        this.statusCode = statusCode;
+        this.cause = cause;
+        this.name = "GitHubApiError";
+    }
+}
+/**
+ * Classify an error from the GitHub API.
+ * - 401/403 → auth (don't retry, token is bad or insufficient scope)
+ * - 429, 500, 502, 503, 504 → transient (retry)
+ * - Network errors → transient
+ * - Everything else → permanent
+ */
+export function classifyError(err) {
+    if (err instanceof GitHubApiError)
+        return err.kind;
+    const msg = err instanceof Error ? err.message : String(err);
+    const lower = msg.toLowerCase();
+    // Auth failures
+    if (lower.includes("401") || lower.includes("403") || lower.includes("unauthorized") || lower.includes("forbidden") || lower.includes("bad credentials")) {
+        return "auth";
+    }
+    // Rate-limited or server errors
+    if (lower.includes("429") || lower.includes("rate limit") || lower.includes("secondary rate limit") || lower.includes("abuse detection")) {
+        return "transient";
+    }
+    if (/\b50[0-4]\b/.test(msg))
+        return "transient";
+    // Network errors
+    if (lower.includes("econnreset") ||
+        lower.includes("etimedout") ||
+        lower.includes("econnrefused") ||
+        lower.includes("enotfound") ||
+        lower.includes("fetch failed") ||
+        lower.includes("network") ||
+        lower.includes("socket hang up") ||
+        lower.includes("aborted")) {
+        return "transient";
+    }
+    return "permanent";
+}
+/**
+ * Execute `fn` with exponential backoff + jitter.
+ * Only retries transient errors. Auth and permanent errors fail immediately.
+ */
+export async function withRetry(fn, opts) {
+    const maxAttempts = opts?.maxAttempts ?? 3;
+    const baseDelay = opts?.baseDelayMs ?? 1000;
+    const maxDelay = opts?.maxDelayMs ?? 30_000;
+    const label = opts?.label ?? "GitHubAPI";
+    const timeoutMs = opts?.timeoutMs ?? 15_000;
+    return traceApiCall("github", label, async (span) => {
+        span.setAttribute("retry.max_attempts", maxAttempts);
+        let lastError;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            try {
+                const result = await withTimeout(fn(), timeoutMs, label);
+                span.setAttribute("retry.attempts", attempt);
+                return result;
+            }
+            catch (err) {
+                lastError = err;
+                const kind = classifyError(err);
+                span.addEvent("retry.attempt_failed", {
+                    attempt,
+                    "error.kind": kind,
+                    "error.message": err instanceof Error ? err.message : String(err),
+                });
+                if (kind === "auth") {
+                    throw new GitHubApiError(`${label}: authentication failed — check GITHUB_TOKEN`, "auth", undefined, err);
+                }
+                if (kind === "permanent") {
+                    throw new GitHubApiError(`${label}: ${err instanceof Error ? err.message : String(err)}`, "permanent", undefined, err);
+                }
+                if (attempt < maxAttempts) {
+                    const errMsg = err instanceof Error ? err.message : String(err);
+                    const isRateLimited = errMsg.includes("429") || errMsg.toLowerCase().includes("rate limit");
+                    const effectiveBase = isRateLimited ? Math.max(baseDelay, 5_000) : baseDelay;
+                    const delay = Math.min(effectiveBase * 2 ** (attempt - 1), maxDelay);
+                    const jitter = delay * (0.5 + Math.random() * 0.5);
+                    log.warn(`${label}: attempt ${attempt}/${maxAttempts} failed${isRateLimited ? " (rate limited)" : ""}, retrying in ${Math.round(jitter)}ms`);
+                    await sleep(jitter);
+                }
+            }
+        }
+        span.setAttribute("retry.attempts", maxAttempts);
+        throw new GitHubApiError(`${label}: failed after ${maxAttempts} attempts`, "transient", undefined, lastError);
+    });
+}
+function withTimeout(promise, ms, label) {
+    if (ms <= 0 || !Number.isFinite(ms))
+        return promise;
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new GitHubApiError(`${label}: timed out after ${ms}ms`, "transient"));
+        }, ms);
+        promise.then((val) => { clearTimeout(timer); resolve(val); }, (err) => { clearTimeout(timer); reject(err); });
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/github/retry.js.map

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

package/dist/github/types.d.ts

@@ -0,0 +1,527 @@
+/**
+ * TypeScript interfaces for the GitHub integration.
+ *
+ * Covers: API client types, webhook payloads, PR review, issue triage,
+ * commit analysis, and repo health monitoring.
+ */
+export interface GitHubConfig {
+    /** GitHub personal access token (or app token). Env: GITHUB_TOKEN. */
+    token?: string;
+    /** GitHub webhook secret for signature verification. Env: GITHUB_WEBHOOK_SECRET. */
+    webhookSecret?: string;
+    /** Base URL for GitHub API (defaults to https://api.github.com). */
+    apiBaseUrl?: string;
+    /** Default owner/repo (e.g., "user/repo"). */
+    defaultRepo?: string;
+    /** Feature toggles. */
+    features?: GitHubFeatureFlags;
+}
+export interface GitHubFeatureFlags {
+    /** Enable PR review automation. Default: true. */
+    prReview?: boolean;
+    /** Enable issue triage. Default: true. */
+    issueTriage?: boolean;
+    /** Enable commit analysis. Default: true. */
+    commitAnalysis?: boolean;
+    /** Enable repo health monitoring. Default: true. */
+    repoHealth?: boolean;
+    /** Enable webhook processing. Default: true. */
+    webhooks?: boolean;
+    /** Enable PR merge readiness checks. Default: true. */
+    prReadiness?: boolean;
+    /** Enable release notes generation. Default: true. */
+    releaseNotes?: boolean;
+    /** Enable contributor stats. Default: true. */
+    contributorStats?: boolean;
+    /** Enable issue SLA tracking. Default: true. */
+    issueSLA?: boolean;
+}
+export interface GitHubUser {
+    id: number;
+    login: string;
+    name: string | null;
+    avatar_url: string;
+    html_url: string;
+}
+export interface GitHubRepo {
+    id: number;
+    name: string;
+    full_name: string;
+    owner: GitHubUser;
+    html_url: string;
+    description: string | null;
+    default_branch: string;
+    open_issues_count: number;
+    stargazers_count: number;
+    forks_count: number;
+    created_at: string;
+    updated_at: string;
+    pushed_at: string;
+}
+export interface GitHubLabel {
+    id: number;
+    name: string;
+    color: string;
+    description: string | null;
+}
+export interface GitHubMilestone {
+    id: number;
+    number: number;
+    title: string;
+    state: "open" | "closed";
+    due_on: string | null;
+}
+export interface GitHubIssue {
+    id: number;
+    number: number;
+    title: string;
+    body: string | null;
+    state: "open" | "closed";
+    labels: GitHubLabel[];
+    assignees: GitHubUser[];
+    milestone: GitHubMilestone | null;
+    user: GitHubUser;
+    html_url: string;
+    created_at: string;
+    updated_at: string;
+    closed_at: string | null;
+    pull_request?: {
+        url: string;
+    };
+}
+export interface GitHubPullRequest {
+    id: number;
+    number: number;
+    title: string;
+    body: string | null;
+    state: "open" | "closed";
+    draft: boolean;
+    merged: boolean;
+    merged_at: string | null;
+    labels: GitHubLabel[];
+    user: GitHubUser;
+    assignees: GitHubUser[];
+    requested_reviewers: GitHubUser[];
+    html_url: string;
+    diff_url: string;
+    head: {
+        ref: string;
+        sha: string;
+    };
+    base: {
+        ref: string;
+        sha: string;
+    };
+    additions: number;
+    deletions: number;
+    changed_files: number;
+    created_at: string;
+    updated_at: string;
+    mergeable: boolean | null;
+    mergeable_state: string;
+}
+export interface GitHubPRFile {
+    filename: string;
+    status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
+    additions: number;
+    deletions: number;
+    changes: number;
+    patch?: string;
+}
+export interface GitHubCommit {
+    sha: string;
+    message: string;
+    author: {
+        name: string;
+        email: string;
+        date: string;
+    } | null;
+    committer: {
+        name: string;
+        email: string;
+        date: string;
+    } | null;
+    html_url: string;
+    stats?: {
+        additions: number;
+        deletions: number;
+        total: number;
+    };
+    files?: GitHubPRFile[];
+}
+export interface GitHubReview {
+    id: number;
+    user: GitHubUser;
+    body: string | null;
+    state: "APPROVED" | "CHANGES_REQUESTED" | "COMMENTED" | "DISMISSED" | "PENDING";
+    submitted_at: string;
+    html_url: string;
+}
+export interface GitHubComment {
+    id: number;
+    body: string;
+    user: GitHubUser;
+    created_at: string;
+    updated_at: string;
+    html_url: string;
+}
+export interface GitHubWebhookPayload {
+    action: string;
+    sender: GitHubUser;
+    repository: GitHubRepo;
+    organization?: {
+        login: string;
+        id: number;
+    };
+    installation?: {
+        id: number;
+    };
+}
+export interface GitHubPRWebhookPayload extends GitHubWebhookPayload {
+    action: "opened" | "closed" | "reopened" | "synchronize" | "edited" | "ready_for_review" | "review_requested";
+    number: number;
+    pull_request: GitHubPullRequest;
+}
+export interface GitHubIssueWebhookPayload extends GitHubWebhookPayload {
+    action: "opened" | "closed" | "reopened" | "edited" | "labeled" | "unlabeled" | "assigned" | "unassigned";
+    issue: GitHubIssue;
+}
+export interface GitHubPushWebhookPayload extends GitHubWebhookPayload {
+    ref: string;
+    before: string;
+    after: string;
+    commits: Array<{
+        id: string;
+        message: string;
+        timestamp: string;
+        author: {
+            name: string;
+            email: string;
+            username?: string;
+        };
+        added: string[];
+        removed: string[];
+        modified: string[];
+    }>;
+    head_commit: {
+        id: string;
+        message: string;
+        timestamp: string;
+        author: {
+            name: string;
+            email: string;
+            username?: string;
+        };
+    } | null;
+    forced: boolean;
+}
+export interface GitHubIssueCommentWebhookPayload extends GitHubWebhookPayload {
+    action: "created" | "edited" | "deleted";
+    issue: GitHubIssue;
+    comment: GitHubComment;
+}
+export interface GitHubPRReviewWebhookPayload extends GitHubWebhookPayload {
+    action: "submitted" | "edited" | "dismissed";
+    pull_request: GitHubPullRequest;
+    review: GitHubReview;
+}
+export interface PRReviewResult {
+    prNumber: number;
+    repo: string;
+    summary: string;
+    findings: PRFinding[];
+    metrics: PRMetrics;
+    recommendation: "approve" | "request_changes" | "comment";
+    reviewedAt: string;
+}
+export interface PRFinding {
+    severity: "info" | "warning" | "error";
+    category: PRFindingCategory;
+    message: string;
+    file?: string;
+    line?: number;
+}
+export type PRFindingCategory = "size" | "complexity" | "testing" | "documentation" | "security" | "convention" | "breaking_change";
+export interface PRMetrics {
+    filesChanged: number;
+    additions: number;
+    deletions: number;
+    hasTests: boolean;
+    hasDocChanges: boolean;
+    largeFiles: string[];
+    binaryFiles: string[];
+}
+export interface IssueTriage {
+    issueNumber: number;
+    repo: string;
+    category: IssueCategory;
+    priority: IssuePriority;
+    suggestedLabels: string[];
+    suggestedAssignees: string[];
+    summary: string;
+    triagedAt: string;
+}
+export type IssueCategory = "bug" | "feature" | "enhancement" | "question" | "documentation" | "maintenance" | "security";
+export type IssuePriority = "critical" | "high" | "medium" | "low";
+export interface TriageConfig {
+    /** Label mappings: keyword → label name. */
+    labelRules: Array<{
+        keywords: string[];
+        label: string;
+    }>;
+    /** Priority rules based on content signals. */
+    priorityRules: {
+        criticalKeywords: string[];
+        highKeywords: string[];
+    };
+    /** Auto-assign by label or path pattern. */
+    assigneeRules: Array<{
+        labels?: string[];
+        paths?: string[];
+        assignees: string[];
+    }>;
+}
+export interface CommitAnalysis {
+    sha: string;
+    repo: string;
+    quality: CommitQuality;
+    patterns: CommitPattern[];
+    issues: CommitIssue[];
+    analyzedAt: string;
+}
+export interface CommitQuality {
+    score: number;
+    messageQuality: "good" | "fair" | "poor";
+    hasCoAuthors: boolean;
+    hasBreakingChange: boolean;
+    isConventional: boolean;
+    sizeCategory: "tiny" | "small" | "medium" | "large" | "huge";
+}
+export type CommitPattern = "feature" | "bugfix" | "refactor" | "test" | "docs" | "chore" | "ci" | "style" | "perf" | "revert" | "merge" | "wip";
+export interface CommitIssue {
+    severity: "info" | "warning" | "error";
+    message: string;
+}
+export interface RepoHealthReport {
+    repo: string;
+    generatedAt: string;
+    overall: HealthGrade;
+    metrics: RepoHealthMetrics;
+    trends: RepoHealthTrends;
+}
+export type HealthGrade = "A" | "B" | "C" | "D" | "F";
+export interface RepoHealthMetrics {
+    /** Commits in the last 30 days. */
+    commitFrequency: number;
+    /** Average days to close an issue. */
+    avgIssueResolutionDays: number;
+    /** Average days from PR open to merge. */
+    avgPRReviewDays: number;
+    /** Number of open issues. */
+    openIssues: number;
+    /** Number of open PRs. */
+    openPRs: number;
+    /** Number of stale issues (no activity in 30+ days). */
+    staleIssues: number;
+    /** Number of stale PRs. */
+    stalePRs: number;
+    /** Contributors in the last 30 days. */
+    activeContributors: number;
+    /** Bus factor — number of contributors responsible for 80% of commits. Lower = riskier. */
+    busFactor: number;
+    /** CI/CD health from GitHub Actions. Null if no workflow runs found. */
+    ciHealth: CIHealthMetrics | null;
+}
+export interface CIHealthMetrics {
+    /** Total workflow runs in the period. */
+    totalRuns: number;
+    /** Number of successful runs. */
+    successfulRuns: number;
+    /** Success rate as a percentage (0-100). */
+    successRate: number;
+    /** Average run duration in seconds. Null if no completed runs. */
+    avgDurationSeconds: number | null;
+    /** Number of distinct failing workflows. */
+    failingWorkflows: number;
+}
+export interface RepoHealthTrends {
+    commitTrend: "increasing" | "stable" | "decreasing";
+    issueTrend: "improving" | "stable" | "worsening";
+    prTrend: "improving" | "stable" | "worsening";
+}
+export interface GitHubWorkflowRun {
+    id: number;
+    name: string | null;
+    head_branch: string | null;
+    head_sha: string;
+    status: "queued" | "in_progress" | "completed" | "waiting" | "requested" | "pending";
+    conclusion: "success" | "failure" | "cancelled" | "skipped" | "timed_out" | "action_required" | "neutral" | "stale" | null;
+    workflow_id: number;
+    html_url: string;
+    created_at: string;
+    updated_at: string;
+    run_started_at: string | null;
+    run_attempt: number;
+}
+export interface GitHubWorkflowRunsResponse {
+    total_count: number;
+    workflow_runs: GitHubWorkflowRun[];
+}
+export interface DuplicateCandidate {
+    issueNumber: number;
+    title: string;
+    similarity: number;
+    url: string;
+}
+export interface CommitQualityTrend {
+    repo: string;
+    period: {
+        from: string;
+        to: string;
+    };
+    recentAvgScore: number;
+    olderAvgScore: number;
+    direction: "improving" | "stable" | "declining";
+    totalAnalyzed: number;
+    conventionalCommitRate: number;
+    authorBreakdown: AuthorQualitySummary[];
+}
+export interface AuthorQualitySummary {
+    author: string;
+    commitCount: number;
+    avgScore: number;
+    conventionalRate: number;
+}
+export interface PRReadinessReport {
+    prNumber: number;
+    repo: string;
+    ready: boolean;
+    checks: PRReadinessCheck[];
+    blockers: string[];
+    checkedAt: string;
+}
+export interface PRReadinessCheck {
+    name: string;
+    passed: boolean;
+    details: string;
+}
+export interface ReleaseNotes {
+    repo: string;
+    version: string;
+    from: string;
+    to: string;
+    generatedAt: string;
+    sections: ReleaseNotesSection[];
+    breakingChanges: string[];
+    contributors: string[];
+    markdown: string;
+}
+export interface ReleaseNotesSection {
+    title: string;
+    icon: string;
+    commits: ReleaseNoteEntry[];
+}
+export interface ReleaseNoteEntry {
+    sha: string;
+    message: string;
+    author: string;
+    scope?: string;
+}
+export interface ContributorStats {
+    repo: string;
+    period: {
+        from: string;
+        to: string;
+    };
+    contributors: ContributorProfile[];
+    generatedAt: string;
+}
+export interface ContributorProfile {
+    login: string;
+    commits: number;
+    prsOpened: number;
+    prsMerged: number;
+    reviewsGiven: number;
+    linesAdded: number;
+    linesRemoved: number;
+}
+export interface SLAConfig {
+    targets: Record<IssuePriority, SLATarget>;
+}
+export interface SLATarget {
+    /** Maximum hours for first response. */
+    responseHours: number;
+    /** Maximum hours for resolution. */
+    resolutionHours: number;
+}
+export interface SLAReport {
+    repo: string;
+    period: {
+        from: string;
+        to: string;
+    };
+    generatedAt: string;
+    overall: SLACompliance;
+    byPriority: Record<IssuePriority, SLACompliance>;
+    breaches: SLABreach[];
+}
+export interface SLACompliance {
+    total: number;
+    withinSLA: number;
+    breached: number;
+    complianceRate: number;
+}
+export interface SLABreach {
+    issueNumber: number;
+    title: string;
+    priority: IssuePriority;
+    type: "response" | "resolution";
+    targetHours: number;
+    actualHours: number;
+    url: string;
+}
+export interface GitHubCheckRun {
+    id: number;
+    name: string;
+    status: "queued" | "in_progress" | "completed";
+    conclusion: "success" | "failure" | "neutral" | "cancelled" | "skipped" | "timed_out" | "action_required" | null;
+    html_url: string;
+    started_at: string | null;
+    completed_at: string | null;
+}
+export interface GitHubCheckRunsResponse {
+    total_count: number;
+    check_runs: GitHubCheckRun[];
+}
+export interface GitHubCompareResult {
+    status: "ahead" | "behind" | "diverged" | "identical";
+    ahead_by: number;
+    behind_by: number;
+    total_commits: number;
+    commits: Array<{
+        sha: string;
+        commit: {
+            message: string;
+            author: {
+                name: string;
+                email: string;
+                date: string;
+            } | null;
+        };
+        html_url: string;
+    }>;
+}
+export interface GitHubTag {
+    name: string;
+    commit: {
+        sha: string;
+        url: string;
+    };
+}
+export interface GitHubIssueEvent {
+    id: number;
+    event: string;
+    created_at: string;
+    actor: GitHubUser | null;
+}
+//# sourceMappingURL=types.d.ts.map