Skip to content

Backfill now replays first approvals for GitHub PR triggers #862

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
promptless wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Backfill now replays first approvals for GitHub PR triggers #862

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
15d01c6
docs(triggers): backfill now replays first approvals for GitHub PR tr…
promptless[bot] Aug 13, 2026
4dbd81b
docs(changelog): announce first-approval GitHub PR trigger backfill
promptless[bot] Aug 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion src/content/changelog/changelogs/august-2026.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: August 2026
subtitle: Lots of changes in August.
subtitle: GitLab merge-request comment triggers, scheduled documentation checks, first-approval PR backfills, and bug fixes.
date: '2026-08-01T00:00:00.000Z'
hidden: false
---
Expand All @@ -21,6 +21,8 @@ hidden: false

* **Research breakdown now reads Knowledge Base inline and attributes delegated research:** Each trigger's research breakdown—on the Triggers page and a suggestion's **Triggers & Analysis** tab—now shows Knowledge Base reads inline, in the sequence the agent read them, instead of grouped at the end. Delegated research appears as an attributed branch labeled with the subagent type and its tool-call count. A "research agents" callout appears next to the summary when Promptless delegates research. See [Research breakdown](/docs/work-the-queue/web-interface#research-breakdown).

* **Backfill first-approval GitHub PR triggers:** A GitHub PR trigger that fires only on first approval can now be backfilled. The backfill preview lists open pull requests whose first approval landed within the selected window, including pull requests opened before the window. These triggers previously returned no backfill results. See [Backfill suggestions](/docs/connect/triggers#backfill-suggestions).

**Bug Fixes:**

* **Image changes now show a before/after diff and apply correctly:** Image and screenshot changes in a suggestion previously appeared as empty file cards in the dashboard suggestion viewer; they now display as a side-by-side before/after image diff, and an added or deleted image shows only the side that exists. Suggestions that changed only images were also mislabeled as rejected and couldn't be applied at all—they now show their real status and can be applied and published like any other suggestion. Finally, rejecting an individual image in a suggestion used to delete the file; it now restores the original version, matching how rejecting a text file already worked.
2 changes: 1 addition & 1 deletion src/content/docs/docs/connect/triggers.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ Backfill suggestions lets you run Promptless on pull requests that already exist

Open the **Backfill suggestions** panel on a trigger row, choose a window of the **last 14 days**, **last 30 days**, or **last 90 days**, and select **Preview**. The preview lists the pull requests opened or merged in that window that the trigger matches, applying the same repository, topic, directory, and branch filters it uses for live events. When a trigger scopes repositories by GitHub topic (the **Trigger on repos with certain topics** option, covered in [Repository topics](/docs/connect/triggers/github-prs#repository-topics)), the preview lists pull requests only from repositories that carry a matching topic. Backfill covers up to 1,000 pull requests per repository in the window.

Backfill matches pull requests that were opened or merged but it doesn't replay historical approvals. A trigger that activates only on first approval returns no backfill results because approval matching applies only to live events going forward.
Backfill also replays first approvals for GitHub PR triggers that activate only on first approval: the preview includes open pull requests whose first approval landed within the selected window, even if they were opened before the window. GitLab merge request and Bitbucket PR triggers don't offer a first-approval option, so this backfill behavior applies only to GitHub.

@promptless promptless Bot Aug 15, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

list_matching_pull_requests docstring: backfill now replays approval-shaped events for GitHub PR triggers with a first_approval-only clause, matching PRs whose first active approval landed in the window even if opened long before it.

Source: https://github.com/Promptless/promptless/blob/922f2a1fe0bfd05d7dbfa6a676e1d35d7212f7e4/runtime/replays/service.py#L993-L1002

@promptless promptless Bot Aug 15, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

_recent_pull_request_search_queries: approval-mode search stays is:open but widens the date filter from created:>= to updated:>=, so PRs opened before the backfill window are included when their approval landed inside it.

Source: https://github.com/Promptless/promptless/blob/922f2a1fe0bfd05d7dbfa6a676e1d35d7212f7e4/runtime/replays/git_sources/github.py#L599-L628

@promptless promptless Bot Aug 15, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

MergeRequestLifecycleEvent (GitLab MR / Bitbucket PR triggers) is Literal["opened", "merge"] and explicitly excludes first_approval, because the webhook lifecycle mapper never emits it for those providers -- confirms GitLab/Bitbucket first-approval triggers have no backfill analogue.

Source: https://github.com/Promptless/promptless/blob/922f2a1fe0bfd05d7dbfa6a676e1d35d7212f7e4/runtime/promptless_config/models.py#L64-L69


When the preview looks right, select **Launch backfill** to run it. Promptless processes each pull request live, exactly as it does for a new event: your publishing policy applies, so backfilled pull requests can create documentation PRs and send notifications. The panel updates with progress as the run works through the list.

Expand Down
Loading