From a8aee6bfabb6825645478ea6a217cc69cfecc282 Mon Sep 17 00:00:00 2001 From: Sean Keever <33592180+swkeever@users.noreply.github.com> Date: Thu, 19 Nov 2026 20:52:53 -0500 Subject: [PATCH 1/3] docs(lavaflow): describe successful merge outcomes --- content/platform/guides/lavaflow.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/content/platform/guides/lavaflow.md b/content/platform/guides/lavaflow.md index 933c43a7..0600c720 100644 --- a/content/platform/guides/lavaflow.md +++ b/content/platform/guides/lavaflow.md @@ -1272,9 +1272,7 @@ New reasons may appear. While merging is paused, a waiting merge gets `reason` `paused`. LavaFlow takes a queued fix out of the merge queue, so it shows `waiting_for_checks`, and -queues it again when merging resumes. A fix that merged into a project that -doesn't deploy it automatically gets `reason` `manual_deploy`: deploy it to -ship the fix. +queues it again when merging resumes. LavaFlow records a successful merge as `merged`. LavaFlow doesn't bill merges. From 0c4d72dc7b2f8b34e93ec54af4c040c99179d425 Mon Sep 17 00:00:00 2001 From: Sean Keever <33592180+swkeever@users.noreply.github.com> Date: Thu, 19 Nov 2026 21:04:53 -0500 Subject: [PATCH 2/3] docs(lavaflow): describe covering pull requests in the CLI --- content/cli/lavaflow.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/cli/lavaflow.md b/content/cli/lavaflow.md index af0b9de9..00885351 100644 --- a/content/cli/lavaflow.md +++ b/content/cli/lavaflow.md @@ -443,6 +443,8 @@ A reason your CLI doesn't know shows as `Other` with its code. When no reviewer could run, the review reads `Review: error; no reviewer could run`, followed by `Review stopped:` with the reason. +For an issue covered by an existing pull request, the `Fix:` block shows that pull request and its GitHub state. + The `Source:` line gives the commit's short SHA and where it came from: | Shown | Meaning | From 6e6e38195341682bccf5044cf7f13f843b76902b Mon Sep 17 00:00:00 2001 From: Sean Keever <33592180+swkeever@users.noreply.github.com> Date: Thu, 19 Nov 2026 21:15:02 -0500 Subject: [PATCH 3/3] docs(lavaflow): end the pull request lifecycle at merge --- content/platform/guides/lavaflow.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/content/platform/guides/lavaflow.md b/content/platform/guides/lavaflow.md index 0600c720..2f882cdb 100644 --- a/content/platform/guides/lavaflow.md +++ b/content/platform/guides/lavaflow.md @@ -12,7 +12,8 @@ LavaFlow turns production errors into reviewed fixes. 5. **Pull request**: LavaFlow opens a pull request with the fix in the project's [linked repository](#link-a-repository). 6. **Review**: you review the pull request like any other, unless you let LavaFlow merge. 7. **Merge**: you merge it, or [let LavaFlow merge it](#merge-fixes) once LavaFlow's reviewers and the required checks pass. -8. **Deployed**: when a deployment Volcano confirmed has the fix goes live, LavaFlow [resolves the issue](#after-a-fix-merges). + +LavaFlow finishes work on the pull request when it merges. Volcano picks and runs the models, so there is no model or API key to set up. @@ -1305,10 +1306,11 @@ in your repository's Actions tab. ## After a fix merges -Once a fix's pull request merges, by you or by LavaFlow, LavaFlow watches the -resource's deployments from the repository, including deployments more than a -week later. Verification has bounded retries for each deployment; another -deployment starts fresh attempts. When LavaFlow verifies that a live deployment +The project's deployment workflow runs independently of the pull request. +After the merge, Volcano tracks the resource's deployments from the repository +to determine when to resolve the issue. This includes deployments more than a +week later. Verification has bounded retries for each deployment, and another +deployment starts fresh attempts. When Volcano verifies that a live deployment includes the merge, it records the recurrence cutoff as the run's `pull_request.deployed_at` and resolves the [issue](issues.md) as of that moment, unless the error was seen after it. Where @@ -1318,8 +1320,7 @@ code don't keep it open; `resolved_at` is 2 minutes after `deployed_at`. A deployment whose [reported commit](deployment-source.md#commit) has `verification: repository` never counts, because Volcano didn't match its files against the commit. -[Resolve the issue](issues.md#resolve-or-ignore-an-issue) yourself, or deploy -the merge with a push to the repository. +You can also [resolve the issue yourself](issues.md#resolve-or-ignore-an-issue). If the error happens again, the issue reopens, as any resolved issue does. For an issue with `exception: true`, LavaFlow then starts a new run on it, no