Skip to main content
All CollectionsData & operationsIssues & Pull Requests dataset
Issues and PRs > Resolving PR first merged at
Issues and PRs > Resolving PR first merged at
Tom Williams avatar
Written by Tom Williams
Updated over 3 months ago

Dataset: Issues & Pull Requests

Entity: Issues

Field ID: resolving_pr_first_merged_at

Type: Datetime

Description: The earliest merge date among all resolving PRs. (via auto-closing keywords). It is only applicable to issues.

Source: Calculated

Transformation logic:

  • Pull Requests: Not applicable. This field will always be null.

  • Issues: The earliest occurrence of all merged_at fields inherited from the PRs that resolve the issue (via auto-closing keywords). The null values are ignored. A null value is returned only if all merged_at values are null.

Definition of resolving pull requests:

A resolving pull request is a pull request that:

  • Contains an auto-closing keyword to an issue

  • Has a state equal to OPEN or MERGED, not CLOSED

  • Has a base ref that has not been used as a head ref by a previous pull request associated with the issue

This last condition ensures that release PRs (e.g. PR from master to staging then staging to production) do not get considered as resolving if they follow a proper implementation PR (e.g. from my-feature-branch to master), even though they contain references to issues through commits.

This condition replaces the rule from GitHub, GitLab, and Bitbucket that resolving pull requests must target the main branch. This condition is not practical for Keypup since the main branch can change over time. Using this definition would mean that any resolving PR preceding a change of main branch would no longer be considered as resolving, which would impact historical reporting.

The Keypup definition also brings some flexibility in case of emergency releases. If you push an emergency fix referencing an issue to the main branch and then release this fix through release PRs, then the first release PR will be considered as a resolving PR (GitHub/GitLab/Bitbucket would simply ignore it). This information can then be used for incident reporting in Keypup.

From:

Github (PRs)

Gitlab (PRs)

Bitbucket

JIRA

N/A

ClickUp

N/A

Trello

N/A

Did this answer your question?