[mandre]

fixes #237

Description

Add --post-command and --post-command-commit-message options that run an arbitrary shell command after cherry-pick(s) succeed but before the result is committed and pushed. If the command produces changes, they are staged and included in an additional fixup commit.

This is useful when backporting across major version branches where the cherry-picked code contains import paths or references that are correct on the source branch but wrong on the target branch (e.g. Go module paths, Python package versions, namespace renames).

How Has This Been Tested?

Untested, apart from the newly added unit tests. This was produced with the help of opus-4.6. The code looks good to me, but since I'm not a big javascript person, my view doesn't really count 😄

Checklist

• Tests added if applicable.
• Documentation updated if applicable.

Merge criteria:

• The commits and have meaningful messages; the author will squash them after approval or will ask to merge with squash.
• Testing instructions have been added in the PR body (for PRs involving changes that are not immediately obvious).
• The developer has manually tested the changes and verified that the changes work

Note: dist/cli/index.js and dist/gha/index.js are automatically generated by git hooks and gh workflows.

First time here?

This project follows git conventional commits pattern, therefore the commits should have the following format:

<type>(<optional scope>): <subject>
empty separator line
<optional body>
empty separator line
<optional footer>

Where the type must be one of [build, chore, ci, docs, feat, fix, perf, refactor, revert, style, test]

NOTE: if you are still in a work in progress branch and you want to push your changes remotely, consider adding --no-verify for both commit and push, e.g., git push origin <feat-branch> --no-verify - this could become useful to push changes where there are still tests failures. Once the pull request is ready, please amend the commit and force-push it to keep following the adopted git commit standard.

How to prepare for a new release?

There is no need to manually update package.json version and CHANGELOG.md information. This process has been automated in Prepare Release Github workflow.

Therefore whenever enough changes are merged into the main branch, one of the maintainers will trigger this workflow that will automatically update version and changelog based on the commits on the git tree.

More details can be found in package release section of the README.

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟢	Statements	86.22% (-1.75% 🔻)	657/762
🟢	Branches	81.23% (-1.09% 🔻)	316/389
🟢	Functions	83.78% (-1.77% 🔻)	155/185
🟢	Lines	86.26% (-1.82% 🔻)	634/735

Show files with reduced coverage 🔻

St.❔	File	Statements	Branches	Functions	Lines
🟢	runner/runner.ts	87.5% (-0.7% 🔻)	88.33% (+0.4% 🔼)	79.49% (-3.85% 🔻)	87.43% (-0.7% 🔻)
🔴	git/git-cli.ts	56.25% (-11.44% 🔻)	33.33% (-7.41% 🔻)	75% (-10.71% 🔻)	55.7% (-11.49% 🔻)

Test suite run success

239 tests passing in 19 suites.

Report generated by 🧪jest coverage report action from e734034

[lampajr]

Thanks @mandre , overall looks good and working!! It seems pretty easy to give it a try imho 🚀

I just left one nit-picking comment and maybe it might be better to move the "runScript" method into another service as it is not git-related.

[lampajr]

I'd rename this to something a bit more generic, e.g., runScript, as this might be used in the future for other hooks (e.g., pre-command)