@0xbigboss/gh-pulse-core 1.0.0

package/dist/reports/team.cjs

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTeamReport = buildTeamReport;
+const utils_1 = require("./utils.cjs");
+const context_1 = require("./context.cjs");
+const filters_1 = require("../filters.cjs");
+function buildTeamReport(cache, options) {
+    const { pullRequests, commits } = (0, context_1.loadReportData)(cache, options.repos);
+    const now = options.meta.generated_at;
+    const exclude = options.excludeAuthors;
+    const teamSet = new Set(options.teamMembers);
+    const prLookup = buildPullRequestLookup(pullRequests);
+    const events = cache
+        .getEvents({ since: options.timeRange.start, until: options.timeRange.end })
+        .filter((event) => options.repos.includes(event.repo));
+    const prEvents = events.filter((event) => 'pr_number' in event);
+    const reviewEvents = events.filter((event) => event.type === 'review_submitted');
+    const opened = prEvents.filter((event) => event.type === 'pr_opened' &&
+        teamHasAuthor(teamSet, event.author) &&
+        !(0, filters_1.isExcludedAuthor)(event.author, exclude, options.excludeBots));
+    const merged = prEvents.filter((event) => event.type === 'pr_merged' &&
+        prAuthorInTeam(prLookup, teamSet, event.repo, event.pr_number, exclude, options.excludeBots));
+    const closed = prEvents.filter((event) => event.type === 'pr_closed' &&
+        prAuthorInTeam(prLookup, teamSet, event.repo, event.pr_number, exclude, options.excludeBots));
+    const mergedPrs = merged
+        .map((event) => prLookup.get(`${event.repo}#${event.pr_number}`))
+        .filter((pr) => Boolean(pr))
+        .filter((pr) => options.includeDrafts || !pr.draft);
+    const cycleTimes = mergedPrs.map((pr) => {
+        const prEventsForPr = cache.getEventsForPr(pr.repo, pr.number);
+        const metrics = (0, utils_1.computeCycleTime)(pr, prEventsForPr);
+        return { pr: (0, utils_1.buildPullRequestSummary)(pr, now), metrics };
+    });
+    const cycleTimeValues = cycleTimes
+        .map((entry) => entry.metrics?.total_time)
+        .filter((value) => typeof value === 'number' && value > 0);
+    const reviewValues = cycleTimes
+        .map((entry) => entry.metrics?.review_time)
+        .filter((value) => typeof value === 'number' && value >= 0);
+    const reviewEngagement = mergedPrs.map((pr) => {
+        const prEventsForPr = cache.getEventsForPr(pr.repo, pr.number);
+        const metrics = (0, utils_1.computeReviewEngagement)(pr, prEventsForPr);
+        return { pr: (0, utils_1.buildPullRequestSummary)(pr, now), metrics };
+    });
+    const memberBreakdown = buildMemberBreakdown(options.teamMembers, pullRequests, commits, reviewEvents, exclude, options.excludeBots, options.timeRange.start, options.timeRange.end);
+    const blockers = findBlockers(pullRequests, options.includeDrafts, exclude, options.excludeBots, options.thresholds, now);
+    return {
+        type: 'team',
+        meta: options.meta,
+        team_size: options.teamMembers.length,
+        velocity: {
+            prs_opened: opened.length,
+            prs_merged: merged.length,
+            prs_closed: closed.length,
+            cycle_time_p50: (0, utils_1.percentile)(cycleTimeValues, 50),
+            cycle_time_p90: (0, utils_1.percentile)(cycleTimeValues, 90),
+            review_turnaround_p50: (0, utils_1.percentile)(reviewValues, 50),
+            review_turnaround_p90: (0, utils_1.percentile)(reviewValues, 90),
+        },
+        members: memberBreakdown,
+        blockers,
+        cycle_times: cycleTimes,
+        review_engagement: reviewEngagement,
+    };
+}
+function buildMemberBreakdown(teamMembers, pullRequests, commits, reviewEvents, exclude, excludeBots, since, until) {
+    return [...teamMembers]
+        .filter((member) => !(0, filters_1.isExcludedAuthor)(member, exclude, excludeBots))
+        .map((member) => {
+        const authored = pullRequests.filter((pr) => pr.author === member &&
+            pr.created_at >= since &&
+            pr.created_at <= until &&
+            !(0, filters_1.isExcludedAuthor)(pr.author, exclude, excludeBots));
+        const reviewed = reviewEvents.filter((event) => event.type === 'review_submitted' &&
+            event.reviewer === member &&
+            !(0, filters_1.isExcludedAuthor)(event.reviewer, exclude, excludeBots));
+        const memberCommits = commits.filter((commit) => commit.author === member &&
+            commit.committed_at >= since &&
+            commit.committed_at <= until &&
+            !(0, filters_1.isExcludedAuthor)(commit.author, exclude, excludeBots));
+        const linesChanged = memberCommits.reduce((total, commit) => total + commit.additions + commit.deletions, 0);
+        return {
+            user: member,
+            prs_authored: authored.length,
+            prs_reviewed: reviewed.length,
+            commits: memberCommits.length,
+            lines_changed: linesChanged,
+        };
+    })
+        .toSorted((a, b) => a.user.localeCompare(b.user));
+}
+function findBlockers(pullRequests, includeDrafts, exclude, excludeBots, thresholds, now) {
+    return pullRequests
+        .filter((pr) => pr.state === 'open')
+        .filter((pr) => includeDrafts || !pr.draft)
+        .filter((pr) => !(0, filters_1.isExcludedAuthor)(pr.author, exclude, excludeBots))
+        .flatMap((pr) => {
+        const blockers = [];
+        const summary = (0, utils_1.buildPullRequestSummary)(pr, now);
+        const staleDays = diffDays(pr.updated_at, now);
+        const stuckDays = diffDays(pr.created_at, now);
+        if (staleDays >= thresholds.stale_days) {
+            blockers.push({ pr: summary, status: 'stale', days: staleDays });
+        }
+        if (stuckDays >= thresholds.stuck_days) {
+            blockers.push({ pr: summary, status: 'stuck', days: stuckDays });
+        }
+        return blockers;
+    })
+        .toSorted((a, b) => b.days - a.days);
+}
+function diffDays(start, end) {
+    return Math.floor((end - start) / (24 * 60 * 60 * 1000));
+}
+function teamHasAuthor(team, author) {
+    return team.has(author);
+}
+function prAuthorInTeam(lookup, team, repo, number, exclude, excludeBots) {
+    const pr = lookup.get(`${repo}#${number}`);
+    if (!pr || (0, filters_1.isExcludedAuthor)(pr.author, exclude, excludeBots)) {
+        return false;
+    }
+    return teamHasAuthor(team, pr.author);
+}
+function buildPullRequestLookup(pullRequests) {
+    return new Map(pullRequests.map((pr) => [`${pr.repo}#${pr.number}`, pr]));
+}

package/dist/reports/team.d.cts

@@ -0,0 +1,6 @@
+import type { Cache } from "../cache.cjs";
+import type { ReportInputs, TeamReport } from "./types.cjs";
+export interface TeamReportOptions extends ReportInputs {
+    meta: TeamReport['meta'];
+}
+export declare function buildTeamReport(cache: Cache, options: TeamReportOptions): TeamReport;

package/dist/reports/team.d.ts

@@ -0,0 +1,6 @@
+import type { Cache } from "../cache.js";
+import type { ReportInputs, TeamReport } from "./types.js";
+export interface TeamReportOptions extends ReportInputs {
+    meta: TeamReport['meta'];
+}
+export declare function buildTeamReport(cache: Cache, options: TeamReportOptions): TeamReport;

package/dist/reports/team.js

@@ -0,0 +1,124 @@
+import { buildPullRequestSummary, computeCycleTime, computeReviewEngagement, percentile, } from "./utils.js";
+import { loadReportData } from "./context.js";
+import { isExcludedAuthor } from "../filters.js";
+export function buildTeamReport(cache, options) {
+    const { pullRequests, commits } = loadReportData(cache, options.repos);
+    const now = options.meta.generated_at;
+    const exclude = options.excludeAuthors;
+    const teamSet = new Set(options.teamMembers);
+    const prLookup = buildPullRequestLookup(pullRequests);
+    const events = cache
+        .getEvents({ since: options.timeRange.start, until: options.timeRange.end })
+        .filter((event) => options.repos.includes(event.repo));
+    const prEvents = events.filter((event) => 'pr_number' in event);
+    const reviewEvents = events.filter((event) => event.type === 'review_submitted');
+    const opened = prEvents.filter((event) => event.type === 'pr_opened' &&
+        teamHasAuthor(teamSet, event.author) &&
+        !isExcludedAuthor(event.author, exclude, options.excludeBots));
+    const merged = prEvents.filter((event) => event.type === 'pr_merged' &&
+        prAuthorInTeam(prLookup, teamSet, event.repo, event.pr_number, exclude, options.excludeBots));
+    const closed = prEvents.filter((event) => event.type === 'pr_closed' &&
+        prAuthorInTeam(prLookup, teamSet, event.repo, event.pr_number, exclude, options.excludeBots));
+    const mergedPrs = merged
+        .map((event) => prLookup.get(`${event.repo}#${event.pr_number}`))
+        .filter((pr) => Boolean(pr))
+        .filter((pr) => options.includeDrafts || !pr.draft);
+    const cycleTimes = mergedPrs.map((pr) => {
+        const prEventsForPr = cache.getEventsForPr(pr.repo, pr.number);
+        const metrics = computeCycleTime(pr, prEventsForPr);
+        return { pr: buildPullRequestSummary(pr, now), metrics };
+    });
+    const cycleTimeValues = cycleTimes
+        .map((entry) => entry.metrics?.total_time)
+        .filter((value) => typeof value === 'number' && value > 0);
+    const reviewValues = cycleTimes
+        .map((entry) => entry.metrics?.review_time)
+        .filter((value) => typeof value === 'number' && value >= 0);
+    const reviewEngagement = mergedPrs.map((pr) => {
+        const prEventsForPr = cache.getEventsForPr(pr.repo, pr.number);
+        const metrics = computeReviewEngagement(pr, prEventsForPr);
+        return { pr: buildPullRequestSummary(pr, now), metrics };
+    });
+    const memberBreakdown = buildMemberBreakdown(options.teamMembers, pullRequests, commits, reviewEvents, exclude, options.excludeBots, options.timeRange.start, options.timeRange.end);
+    const blockers = findBlockers(pullRequests, options.includeDrafts, exclude, options.excludeBots, options.thresholds, now);
+    return {
+        type: 'team',
+        meta: options.meta,
+        team_size: options.teamMembers.length,
+        velocity: {
+            prs_opened: opened.length,
+            prs_merged: merged.length,
+            prs_closed: closed.length,
+            cycle_time_p50: percentile(cycleTimeValues, 50),
+            cycle_time_p90: percentile(cycleTimeValues, 90),
+            review_turnaround_p50: percentile(reviewValues, 50),
+            review_turnaround_p90: percentile(reviewValues, 90),
+        },
+        members: memberBreakdown,
+        blockers,
+        cycle_times: cycleTimes,
+        review_engagement: reviewEngagement,
+    };
+}
+function buildMemberBreakdown(teamMembers, pullRequests, commits, reviewEvents, exclude, excludeBots, since, until) {
+    return [...teamMembers]
+        .filter((member) => !isExcludedAuthor(member, exclude, excludeBots))
+        .map((member) => {
+        const authored = pullRequests.filter((pr) => pr.author === member &&
+            pr.created_at >= since &&
+            pr.created_at <= until &&
+            !isExcludedAuthor(pr.author, exclude, excludeBots));
+        const reviewed = reviewEvents.filter((event) => event.type === 'review_submitted' &&
+            event.reviewer === member &&
+            !isExcludedAuthor(event.reviewer, exclude, excludeBots));
+        const memberCommits = commits.filter((commit) => commit.author === member &&
+            commit.committed_at >= since &&
+            commit.committed_at <= until &&
+            !isExcludedAuthor(commit.author, exclude, excludeBots));
+        const linesChanged = memberCommits.reduce((total, commit) => total + commit.additions + commit.deletions, 0);
+        return {
+            user: member,
+            prs_authored: authored.length,
+            prs_reviewed: reviewed.length,
+            commits: memberCommits.length,
+            lines_changed: linesChanged,
+        };
+    })
+        .toSorted((a, b) => a.user.localeCompare(b.user));
+}
+function findBlockers(pullRequests, includeDrafts, exclude, excludeBots, thresholds, now) {
+    return pullRequests
+        .filter((pr) => pr.state === 'open')
+        .filter((pr) => includeDrafts || !pr.draft)
+        .filter((pr) => !isExcludedAuthor(pr.author, exclude, excludeBots))
+        .flatMap((pr) => {
+        const blockers = [];
+        const summary = buildPullRequestSummary(pr, now);
+        const staleDays = diffDays(pr.updated_at, now);
+        const stuckDays = diffDays(pr.created_at, now);
+        if (staleDays >= thresholds.stale_days) {
+            blockers.push({ pr: summary, status: 'stale', days: staleDays });
+        }
+        if (stuckDays >= thresholds.stuck_days) {
+            blockers.push({ pr: summary, status: 'stuck', days: stuckDays });
+        }
+        return blockers;
+    })
+        .toSorted((a, b) => b.days - a.days);
+}
+function diffDays(start, end) {
+    return Math.floor((end - start) / (24 * 60 * 60 * 1000));
+}
+function teamHasAuthor(team, author) {
+    return team.has(author);
+}
+function prAuthorInTeam(lookup, team, repo, number, exclude, excludeBots) {
+    const pr = lookup.get(`${repo}#${number}`);
+    if (!pr || isExcludedAuthor(pr.author, exclude, excludeBots)) {
+        return false;
+    }
+    return teamHasAuthor(team, pr.author);
+}
+function buildPullRequestLookup(pullRequests) {
+    return new Map(pullRequests.map((pr) => [`${pr.repo}#${pr.number}`, pr]));
+}

package/dist/reports/types.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/reports/types.d.cts

@@ -0,0 +1,144 @@
+import type { Commit, CycleTimeMetrics, GitHubUsername, PullRequest, RepoFullName, ReviewEngagement, Timestamp } from "../types.cjs";
+import type { CacheFreshness } from "../cache.cjs";
+export type ReportAudience = 'personal' | 'individual' | 'team' | 'exec';
+export interface ReportMeta {
+    audience: ReportAudience;
+    period_label: string;
+    start: Timestamp;
+    end: Timestamp;
+    generated_at: Timestamp;
+    repos: RepoFullName[];
+    data_freshness: CacheFreshness;
+}
+export interface PullRequestSummary {
+    repo: RepoFullName;
+    number: number;
+    title: string;
+    author: GitHubUsername;
+    state: string;
+    draft: boolean;
+    updated_at: Timestamp;
+    created_at: Timestamp;
+    age_days: number;
+    url?: string;
+}
+export interface CommitSummary {
+    repo: RepoFullName;
+    sha: string;
+    author: GitHubUsername;
+    committed_at: Timestamp;
+    message: string;
+    additions: number;
+    deletions: number;
+    files_changed: number;
+}
+export interface ReviewDebtSection {
+    requested: PullRequestSummary[];
+    team_prs: PullRequestSummary[];
+}
+export interface OpenWorkSection {
+    open_prs: PullRequestSummary[];
+}
+export interface PersonalSummarySection {
+    prs_opened: number;
+    prs_merged: number;
+    prs_closed: number;
+    commits: number;
+    repos_touched: number;
+    lines_changed: number;
+}
+export interface PersonalReport {
+    type: 'personal' | 'individual';
+    user: GitHubUsername;
+    meta: ReportMeta;
+    summary: PersonalSummarySection;
+    review_debt: ReviewDebtSection;
+    open_work: OpenWorkSection;
+    authored_prs: PullRequestSummary[];
+    commits_detail: CommitSummary[];
+}
+export interface TeamVelocitySection {
+    prs_opened: number;
+    prs_merged: number;
+    prs_closed: number;
+    cycle_time_p50: number | null;
+    cycle_time_p90: number | null;
+    review_turnaround_p50: number | null;
+    review_turnaround_p90: number | null;
+}
+export interface TeamMemberBreakdown {
+    user: GitHubUsername;
+    prs_authored: number;
+    prs_reviewed: number;
+    commits: number;
+    lines_changed: number;
+}
+export interface BlockerEntry {
+    pr: PullRequestSummary;
+    status: 'stale' | 'stuck';
+    days: number;
+}
+export interface TeamReport {
+    type: 'team';
+    meta: ReportMeta;
+    team_size: number;
+    velocity: TeamVelocitySection;
+    members: TeamMemberBreakdown[];
+    blockers: BlockerEntry[];
+    cycle_times: Array<{
+        pr: PullRequestSummary;
+        metrics: CycleTimeMetrics | null;
+    }>;
+    review_engagement: Array<{
+        pr: PullRequestSummary;
+        metrics: ReviewEngagement | null;
+    }>;
+}
+export interface TrendPoint {
+    bucket_start: Timestamp;
+    bucket_end: Timestamp;
+    prs_merged: number;
+    cycle_time_p50: number | null;
+}
+export interface RepoHealthEntry {
+    repo: RepoFullName;
+    status: 'active' | 'stale' | 'dormant';
+    last_activity_at: Timestamp | null;
+}
+export interface HighlightEntry {
+    pr: PullRequestSummary;
+    reasons: string[];
+}
+export interface ExecReport {
+    type: 'exec';
+    meta: ReportMeta;
+    velocity_trends: TrendPoint[];
+    cycle_time_trends: TrendPoint[];
+    repo_health: RepoHealthEntry[];
+    highlights: HighlightEntry[];
+    team_breakdown: TeamMemberBreakdown[];
+}
+export type Report = PersonalReport | TeamReport | ExecReport;
+export interface ReportInputs {
+    repos: RepoFullName[];
+    timeRange: {
+        start: Timestamp;
+        end: Timestamp;
+        label: string;
+    };
+    includeDrafts: boolean;
+    blockersOnly: boolean;
+    excludeAuthors: Set<GitHubUsername>;
+    excludeBots: boolean;
+    teamMembers: GitHubUsername[];
+    subjectUser?: GitHubUsername;
+    thresholds: {
+        stale_days: number;
+        stuck_days: number;
+        large_pr_lines: number;
+    };
+}
+export interface ReportDataContext {
+    pullRequests: PullRequest[];
+    commits: Commit[];
+}

package/dist/reports/types.d.ts

@@ -0,0 +1,144 @@
+import type { Commit, CycleTimeMetrics, GitHubUsername, PullRequest, RepoFullName, ReviewEngagement, Timestamp } from "../types.js";
+import type { CacheFreshness } from "../cache.js";
+export type ReportAudience = 'personal' | 'individual' | 'team' | 'exec';
+export interface ReportMeta {
+    audience: ReportAudience;
+    period_label: string;
+    start: Timestamp;
+    end: Timestamp;
+    generated_at: Timestamp;
+    repos: RepoFullName[];
+    data_freshness: CacheFreshness;
+}
+export interface PullRequestSummary {
+    repo: RepoFullName;
+    number: number;
+    title: string;
+    author: GitHubUsername;
+    state: string;
+    draft: boolean;
+    updated_at: Timestamp;
+    created_at: Timestamp;
+    age_days: number;
+    url?: string;
+}
+export interface CommitSummary {
+    repo: RepoFullName;
+    sha: string;
+    author: GitHubUsername;
+    committed_at: Timestamp;
+    message: string;
+    additions: number;
+    deletions: number;
+    files_changed: number;
+}
+export interface ReviewDebtSection {
+    requested: PullRequestSummary[];
+    team_prs: PullRequestSummary[];
+}
+export interface OpenWorkSection {
+    open_prs: PullRequestSummary[];
+}
+export interface PersonalSummarySection {
+    prs_opened: number;
+    prs_merged: number;
+    prs_closed: number;
+    commits: number;
+    repos_touched: number;
+    lines_changed: number;
+}
+export interface PersonalReport {
+    type: 'personal' | 'individual';
+    user: GitHubUsername;
+    meta: ReportMeta;
+    summary: PersonalSummarySection;
+    review_debt: ReviewDebtSection;
+    open_work: OpenWorkSection;
+    authored_prs: PullRequestSummary[];
+    commits_detail: CommitSummary[];
+}
+export interface TeamVelocitySection {
+    prs_opened: number;
+    prs_merged: number;
+    prs_closed: number;
+    cycle_time_p50: number | null;
+    cycle_time_p90: number | null;
+    review_turnaround_p50: number | null;
+    review_turnaround_p90: number | null;
+}
+export interface TeamMemberBreakdown {
+    user: GitHubUsername;
+    prs_authored: number;
+    prs_reviewed: number;
+    commits: number;
+    lines_changed: number;
+}
+export interface BlockerEntry {
+    pr: PullRequestSummary;
+    status: 'stale' | 'stuck';
+    days: number;
+}
+export interface TeamReport {
+    type: 'team';
+    meta: ReportMeta;
+    team_size: number;
+    velocity: TeamVelocitySection;
+    members: TeamMemberBreakdown[];
+    blockers: BlockerEntry[];
+    cycle_times: Array<{
+        pr: PullRequestSummary;
+        metrics: CycleTimeMetrics | null;
+    }>;
+    review_engagement: Array<{
+        pr: PullRequestSummary;
+        metrics: ReviewEngagement | null;
+    }>;
+}
+export interface TrendPoint {
+    bucket_start: Timestamp;
+    bucket_end: Timestamp;
+    prs_merged: number;
+    cycle_time_p50: number | null;
+}
+export interface RepoHealthEntry {
+    repo: RepoFullName;
+    status: 'active' | 'stale' | 'dormant';
+    last_activity_at: Timestamp | null;
+}
+export interface HighlightEntry {
+    pr: PullRequestSummary;
+    reasons: string[];
+}
+export interface ExecReport {
+    type: 'exec';
+    meta: ReportMeta;
+    velocity_trends: TrendPoint[];
+    cycle_time_trends: TrendPoint[];
+    repo_health: RepoHealthEntry[];
+    highlights: HighlightEntry[];
+    team_breakdown: TeamMemberBreakdown[];
+}
+export type Report = PersonalReport | TeamReport | ExecReport;
+export interface ReportInputs {
+    repos: RepoFullName[];
+    timeRange: {
+        start: Timestamp;
+        end: Timestamp;
+        label: string;
+    };
+    includeDrafts: boolean;
+    blockersOnly: boolean;
+    excludeAuthors: Set<GitHubUsername>;
+    excludeBots: boolean;
+    teamMembers: GitHubUsername[];
+    subjectUser?: GitHubUsername;
+    thresholds: {
+        stale_days: number;
+        stuck_days: number;
+        large_pr_lines: number;
+    };
+}
+export interface ReportDataContext {
+    pullRequests: PullRequest[];
+    commits: Commit[];
+}

package/dist/reports/types.js

@@ -0,0 +1 @@
+export {};

package/dist/reports/utils.cjs

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPullRequestSummary = buildPullRequestSummary;
+exports.computeCycleTime = computeCycleTime;
+exports.computeReviewEngagement = computeReviewEngagement;
+exports.percentile = percentile;
+const time_1 = require("../time.cjs");
+function buildPullRequestSummary(pr, now) {
+    return {
+        repo: pr.repo,
+        number: pr.number,
+        title: pr.title,
+        author: pr.author,
+        state: pr.state,
+        draft: pr.draft,
+        updated_at: pr.updated_at,
+        created_at: pr.created_at,
+        age_days: (0, time_1.diffInDays)(pr.created_at, now),
+    };
+}
+function computeCycleTime(pr, events) {
+    if (pr.merged_at === null) {
+        return null;
+    }
+    const openedAt = minTimestamp(events.filter((event) => event.type === 'pr_opened').map((e) => e.opened_at));
+    const readyAt = minTimestamp(events.filter((event) => event.type === 'pr_ready').map((e) => e.ready_at));
+    const firstReviewAt = minTimestamp(events.filter((event) => event.type === 'review_submitted').map((event) => event.submitted_at));
+    const openTime = openedAt ?? pr.created_at;
+    const readyTime = readyAt ?? openTime;
+    const reviewStart = firstReviewAt ?? null;
+    const draftTime = readyAt ? readyTime - openTime : null;
+    const reviewTime = reviewStart ? reviewStart - readyTime : 0;
+    const mergeTime = reviewStart ? pr.merged_at - reviewStart : 0;
+    const totalTime = pr.merged_at - openTime;
+    return {
+        draft_time: draftTime,
+        review_time: reviewTime,
+        merge_time: mergeTime,
+        total_time: totalTime,
+    };
+}
+function computeReviewEngagement(pr, events) {
+    const comments = events.filter((event) => event.type === 'comment_added');
+    const reviews = events.filter((event) => event.type === 'review_submitted');
+    if (comments.length === 0 && reviews.length === 0) {
+        return null;
+    }
+    const firstComment = minTimestamp(comments.map((event) => event.commented_at));
+    const firstReview = minTimestamp(reviews.map((event) => event.submitted_at));
+    return {
+        time_to_first_comment: firstComment ? firstComment - pr.created_at : null,
+        time_to_first_review: firstReview ? firstReview - pr.created_at : null,
+        review_count: reviews.length,
+        comment_count: comments.length,
+    };
+}
+function percentile(values, pct) {
+    if (values.length === 0) {
+        return null;
+    }
+    const sorted = [...values].toSorted((a, b) => a - b);
+    const index = Math.floor((pct / 100) * (sorted.length - 1));
+    return sorted[index] ?? null;
+}
+function minTimestamp(values) {
+    const filtered = values.filter((value) => typeof value === 'number');
+    if (filtered.length === 0) {
+        return null;
+    }
+    return Math.min(...filtered);
+}

package/dist/reports/utils.d.cts

@@ -0,0 +1,6 @@
+import type { CycleTimeMetrics, Event, PullRequest, ReviewEngagement, Timestamp } from "../types.cjs";
+import type { PullRequestSummary } from "./types.cjs";
+export declare function buildPullRequestSummary(pr: PullRequest, now: Timestamp): PullRequestSummary;
+export declare function computeCycleTime(pr: PullRequest, events: Event[]): CycleTimeMetrics | null;
+export declare function computeReviewEngagement(pr: PullRequest, events: Event[]): ReviewEngagement | null;
+export declare function percentile(values: number[], pct: number): number | null;

package/dist/reports/utils.d.ts

@@ -0,0 +1,6 @@
+import type { CycleTimeMetrics, Event, PullRequest, ReviewEngagement, Timestamp } from "../types.js";
+import type { PullRequestSummary } from "./types.js";
+export declare function buildPullRequestSummary(pr: PullRequest, now: Timestamp): PullRequestSummary;
+export declare function computeCycleTime(pr: PullRequest, events: Event[]): CycleTimeMetrics | null;
+export declare function computeReviewEngagement(pr: PullRequest, events: Event[]): ReviewEngagement | null;
+export declare function percentile(values: number[], pct: number): number | null;