myasnikovdaniil c6cba19946 feat(release): keep a line's backport record and reports across batch pull requests (#5264)
## What this PR does

This PR keeps backport batch record of a line across batch pull
requests. Before it lived only in body of open batch PR, so once that PR
merged or closed it was gone, and a conflict deferred in merged batch
showed up as missing in `check` and on cut. Three `check --cut` results
also did not match the docs, all three are fixed here.

- `check --cut` fails when workflow original is the only thing left
waiting. Before it passed as soon as pick next to it got `backport/skip`
or landed by hand.
- `run`, `check`, `fold` and `notify` read line record from newest
trusted batch PR in any state (opened by bot or by someone with write or
admin access). If newest record is in doubt (author no longer trusted,
bot batch without block, unreadable block, closed record newer than open
batch) command stops and doesn't fall back to older one.
- Record is written only while its PR is open. Merged and closed batch
PRs are never edited or commented, so run that picks nothing with no
open batch writes nothing and says so.
- Every run makes report: each original merged to `main` since line
branched in exactly one category, what the run read (heads, policy, tool
commit, Actions run, flags) and each drop with its reason and merge
commit. Latest report sits in body next to record and each one also goes
to immutable comment. Report ID is hash of classification without PR
number, so identical runs post one comment. `backport-batch report --pr
N [--id ID]` reads it back, merged batches too, it needs `main` in local
clone to check drops.
- `run --defer --push` of last pick used to refuse with "close batch
pull request instead". Now it writes report and record with reason while
PR is open, then closes PR and deletes branch, both only while head is
still the same. If close stops halfway next `run --push` finishes it,
and it never deletes branch that moved or that new batch uses.
- `run --drop N --reason R` keeps original off one line, `--undrop`
withdraws it. Drop is stored in line record bound to merge commit and
carried to next batches. Original the line already carries can't be
dropped, and `backport/include` doesn't lift a drop.
- Output names policy rules instead of internal numbers (no more "rule
101"), `--push` prints PR URL.

Reasons and file names from record are accepted only in the clean
one-line form a run writes them, and everything printed is escaped.

Record version 2 reads unversioned blocks that open batches carry today.
I ran new tool next to current one without `--push` on today's history
for release-1.7 and release-1.6, every original got same category and
`check` output is the same.

### Downstream repositories

- [x] No downstream repository is affected by this change
- [ ] [cozystack/website](https://github.com/cozystack/website) -
follow-up:
- [ ]
[cozystack/terraform-provider-cozystack](https://github.com/cozystack/terraform-provider-cozystack)
- follow-up:
- [ ]
[cozystack/ansible-cozystack](https://github.com/cozystack/ansible-cozystack)
- follow-up:
- [ ] [cozystack/ccp](https://github.com/cozystack/ccp) - follow-up:
- [ ] [cozystack/talm](https://github.com/cozystack/talm) - follow-up:
- [ ] [cozystack/cozyhr](https://github.com/cozystack/cozyhr) -
follow-up:
- [ ] [cozystack/cozy-proxy](https://github.com/cozystack/cozy-proxy) -
follow-up:
- [ ]
[cozystack/cozystack-telemetry-server](https://github.com/cozystack/cozystack-telemetry-server)
- follow-up:
- [ ]
[cozystack/external-apps-example](https://github.com/cozystack/external-apps-example)
- follow-up:
- [ ] [cozystack/examples](https://github.com/cozystack/examples) -
follow-up:
- [ ] [cozystack/community](https://github.com/cozystack/community) -
follow-up:

### Release note

```release-note
feat(release): backport batch keeps line record and report of every run across batch pull requests, check --cut fails on workflow change left waiting alone, deferred conflict stays deferred after its batch merges, --defer of last pick closes the batch, and new run --drop keeps a fix off one line.
```


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

<!-- coderabbit-ai-generated:v1 -->

## Summary by CodeRabbit

* **New Features**
* Maintainers can permanently exclude a change from a release line with
`--drop`, or undo that decision with `--undrop`.
* Added a `report` command to view validated batch reports in JSON or a
readable summary.
* Deferring every remaining change can close an emptied batch. A later
`run --push` can complete an interrupted close.
* Batch reports now show change classifications, including deferred and
dropped items.

* **Bug Fixes**
* Checks more clearly distinguish missing, deferred, skipped, and
carried changes, with cut checks enforcing outstanding workflow
requirements.
* Batch operations refuse edited or untrusted records and avoid writing
to closed pull requests.

* **Documentation**
* Updated command and release-process guidance for drops, reports, cut
checks, and batch closure.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-11-11 12:12:39 +05:00
2025-10-08 09:43:34 +05:00
2024-02-08 12:04:32 +01:00

Cozystack Cozystack

GitHub Release Apache-2.0 License Commit activity OpenSSF Best Practices OpenSSF Scorecard CLOMonitor Support

Cozystack

Cozystack is a free and open-source platform and framework for building clouds.

Cozystack is a CNCF Sandbox project that was originally built and sponsored by Ænix.

With Cozystack, you can transform a bunch of servers into an intelligent system with a simple REST API for spawning Kubernetes clusters, Database-as-a-Service, virtual machines, load balancers, HTTP caching services, and other services with ease.

Use Cozystack to build your own cloud or provide a cost-effective development environment.

Cozystack user interface

Use-Cases

Documentation

The documentation is located on the cozystack.io website.

Read the Getting Started section for a quick start.

If you encounter any difficulties, start with the troubleshooting guide and work your way through the process that we've outlined.

Versioning

Versioning adheres to the Semantic Versioning principles.
A full list of the available releases is available in the GitHub repository's Release section.

Contributions

Contributions are highly appreciated and very welcomed!

In case of bugs, please check if the issue has already been opened by checking the GitHub Issues section. If it isn't, you can open a new one. A detailed report will help us replicate it, assess it, and work on a fix.

You are welcome to take on the fix yourself. Commits are used to generate the changelog, and their author will be referenced in it.

If you have a concrete feature request, open an issue. For a cross-cutting or architectural change, open a design proposal in the community repo. For questions or early ideas, use GitHub Discussions. See CONTRIBUTING.md for the full routing.

Community

You are welcome to join us in #cozystack, on either CNCF Slack (get an invite) or Kubernetes Slack (get an invite), in our Telegram group, and at our community meetings. Add them to your Google Calendar or iCal for convenience.

Project documents

Document What it covers
Governance How decisions are made and who makes them
Contributor Ladder How to grow from contributor to maintainer
Maintainers Who maintains the project
Code of Conduct What we expect of each other
Security Policy Reporting a vulnerability, and which releases get fixes
Adopters Who runs Cozystack in production
Roadmap Where the project is going

License

Cozystack is licensed under Apache 2.0.
The code is provided as-is with no warranties.

Commercial Support

A list of companies providing commercial support for this project can be found on official site.

Languages
Go 49.8%
Shell 35.8%
TypeScript 6.6%
Go Template 5.1%
Makefile 1.4%
Other 1.1%