@oss-autopilot/core - v3.42.2
    Preparing search index...

    Class PRMonitor

    Fetches and enriches open PRs from GitHub for the configured user.

    In v2, all PR data is fetched fresh on each run — no local PR tracking. CI status, reviews, merge conflicts, and maintainer comments are enriched for each PR to compute a FetchedPRStatus.

    Index
    constructor
    fetchCompareStatus fetchMergedPRActivity fetchPRClosedBy fetchRecentlyClosedPRs fetchRecentlyMergedPRs fetchRepoMetadata fetchReviewedOpenPRs fetchReviewedPRActivity fetchUserClosedPRCounts fetchUserMergedPRCounts fetchUserOpenPRs generateDigest

    • Whether base is still an ancestor of head in the PR's repository (#1857): ahead / identical yes, behind / diverged no (rebase or force-push), missing when GitHub no longer has base. See fetchCompareStatus in reviewed-prs-fetch.ts.

      Parameters

      • prUrl: string
      • base: string
      • head: string

      Returns Promise<CompareStatus>

    • Everything the merged-PR notes selection reads for one PR (#1861): issue comments, reviews, inline review comments and commits, each paginated. Four calls per PR (more past 100 items). truncatedLists names the lists that hit the pagination cap; the lists arrive oldest-first, so it is the newest activity (including the user's own reply) that would be missing from those.

      The four calls run together; when more than one fails, a rate-limit or auth error is rethrown ahead of the others so the run stops instead of reporting a 404 that the throttled call never got to verify.

      Parameters

      • prUrl: string

      Returns Promise<MergedPRActivity & { truncatedLists: MergedPRActivityList[] }>

      If prUrl is not a GitHub PR URL

      Octokit errors (404 when the PR is gone, rate limit, auth) unchanged

    • Login of the account that closed a PR (#1863), or undefined when GitHub reports none. The Search API items behind fetchRecentlyClosedPRs carry no closed_by, so this is one issues.get per PR (PRs are issues to that endpoint). Lets the daily run act only on PRs the user closed themselves, not ones a maintainer or bot closed.

      Parameters

      • prUrl: string

      Returns Promise<string | undefined>

      If prUrl is not a GitHub PR or issue URL

      Octokit errors (404 when the PR is gone, rate limit, auth) unchanged

    • Fetch PRs closed without merge in the last N days.

      Parameters

      • days: number = 7

        Lookback window in days (default: 7)

      Returns Promise<
          {
              closedAt: string;
              closedBy?: string;
              issueUrl?: string;
              number: number;
              openedAt?: string;
              repo: string;
              title: string;
              url: string;
          }[],
      >

      Recently closed PRs

    • Fetch PRs merged in the last N days.

      Parameters

      • days: number = 7

        Lookback window in days (default: 7)

      Returns Promise<
          {
              issueUrl?: string;
              mergedAt: string;
              number: number;
              openedAt?: string;
              repo: string;
              title: string;
              url: string;
          }[],
      >

      Recently merged PRs

    • Fetch metadata (star count and primary language) for a list of repositories. Both fields come from the same repos.get() call — zero additional API cost.

      Parameters

      • repos: string[]

      Returns Promise<Map<string, { language: string | null; stars: number }>>

    • The PR, comments, reviews, inline comments and commits the review follow-up scan reads for one reviewed PR (#1857); five calls, a rate-limit or auth error rethrown ahead of any other. See fetchReviewedPRActivity in reviewed-prs-fetch.ts.

      Parameters

      • prUrl: string

      Returns Promise<ReviewedPRActivity & { truncatedLists: ReviewedPRActivityList[] }>

    • Fetch closed-without-merge PR counts per repository for the configured user.

      Parameters

      • OptionalstarFilter: StarFilter

        Optional filter to exclude low-star repos

      Returns Promise<PRCountsResult<number>>

      Per-repo closed counts with monthly breakdowns

    • Fetch merged PR counts and latest merge dates per repository for the configured user.

      Parameters

      • OptionalstarFilter: StarFilter

        Optional filter to exclude low-star repos

      Returns Promise<PRCountsResult<{ count: number; lastMergedAt: string }>>

      Per-repo merged counts with monthly breakdowns

    • Fetch all open PRs for the configured user fresh from GitHub. This is the main entry point for the v2 architecture.

      Returns Promise<FetchPRsResult>

      All open PRs enriched with status, plus any failures

      If no GitHub username is configured

      import { PRMonitor, requireGitHubToken } from '@oss-autopilot/core';

      const monitor = new PRMonitor(requireGitHubToken());
      const { prs, failures } = await monitor.fetchUserOpenPRs();
      console.log(`Found ${prs.length} open PRs, ${failures.length} failures`);

    • Generate a daily digest from fetched PRs.

      Parameters

      • prs: FetchedPR[]

        All open PRs (active + shelved)

      • recentlyClosedPRs: {
            closedAt: string;
            closedBy?: string;
            issueUrl?: string;
            number: number;
            openedAt?: string;
            repo: string;
            title: string;
            url: string;
        }[] = []

        PRs closed without merge in the last 7 days

        • closedAt: string
        • OptionalclosedBy?: string
        • OptionalissueUrl?: string

          Issue the PR closes, parsed from the PR body (#1824).

        • number: number
        • OptionalopenedAt?: string

          When the PR was opened (#1461). Carried from the Search API's created_at so close detection can persist it into the outcome ledger. Optional: digests persisted by older producers don't have it.

        • repo: string
        • title: string
        • url: string
      • recentlyMergedPRs: {
            issueUrl?: string;
            mergedAt: string;
            number: number;
            openedAt?: string;
            repo: string;
            title: string;
            url: string;
        }[] = []

        PRs merged in the last 7 days

        • OptionalissueUrl?: string

          Issue the PR closes, parsed from the PR body (#1824).

        • mergedAt: string
        • number: number
        • OptionalopenedAt?: string

          When the PR was opened (#1461). Carried from the Search API's created_at so merge detection can persist it into the outcome ledger. Optional: digests persisted by older producers don't have it.

        • repo: string
        • title: string
        • url: string

      Returns {
          autoUnshelvedPRs: {
              daysSinceActivity: number;
              number: number;
              repo: string;
              status: "needs_addressing" | "waiting_on_maintainer";
              title: string;
              url: string;
          }[];
          generatedAt: string;
          needsAddressingPRs: FetchedPR[];
          openPRs: FetchedPR[];
          recentlyClosedPRs: {
              closedAt: string;
              closedBy?: string;
              issueUrl?: string;
              number: number;
              openedAt?: string;
              repo: string;
              title: string;
              url: string;
          }[];
          recentlyMergedPRs: {
              issueUrl?: string;
              mergedAt: string;
              number: number;
              openedAt?: string;
              repo: string;
              title: string;
              url: string;
          }[];
          shelvedPRs: {
              daysSinceActivity: number;
              number: number;
              repo: string;
              status: "needs_addressing"
              | "waiting_on_maintainer";
              title: string;
              url: string;
          }[];
          summary: {
              mergeRate: number;
              totalActivePRs: number;
              totalMergedAllTime: number;
              totalNeedingAttention: number;
          };
          waitingOnMaintainerPRs: FetchedPR[];
      }

      Daily digest with categorized PRs and summary stats

    Settings
    Member Visibility

    On This Page
    Constructors
    Methods