kavo: Command for Claude Code

Context

• Branch: !git rev-parse --abbrev-ref HEAD
• Working tree: !git status --short
• PR: !gh pr view $ARGUMENTS --json number,title,state,isDraft,mergeable,mergeStateStatus,reviewDecision,url 2>/dev/null || echo "NO PR"
• Checks: !gh pr checks $ARGUMENTS 2>/dev/null || echo "no checks reported"

Your task

Close the loop on this PR. Argument: $ARGUMENTS

1. Refuse to merge if any of these hold. Report which one and stop:

   • there is no matching PR;
   • the PR is still a draft;
   • any required check is failing or still running — wait for it, do not merge past it;
   • mergeable is false, or there are conflicts with main;

   If the only problem is that checks are still running, say so and offer to wait rather than merging blind.

2. Say what you are about to merge — PR number, title, commit count, and the issue it closes — and get the user's go-ahead before the merge itself. This is the irreversible step.

3. Merge with squash, keeping history linear and one commit per issue. Always pass an authored --subject and --body — never let gh fall back to its default squash body, which is the concatenated list of branch commit messages (* feat(scope): … bullets and all). release-please parses the whole merged message, and a body full of pseudo-headers and nested call(inner()) code spans has silently defeated its parser before (fix commit could not be parsed → the commit is dropped from the changelog and triggers no bump; commit 9fa1434 / #354).

   gh pr merge <n> --squash --delete-branch \
     --subject "feat(core): …" \
     --body "$(cat <<'EOF'
   One or two plain-prose paragraphs summarizing the change.
   
   Refs #<n>
   EOF
   )"
   

   Write the subject as a Conventional Commit matching this repo's style (feat(core): …). Keep the body plain prose: no * type(scope): bullet lines, and rephrase any outer(inner()) nesting (metadataFor of relation.target(), not metadataFor(relation.target())).