rebase-commit-push-pr

name	rebase-commit-push-pr
description	Fetch origin/main, rebase current branch, resolve conflicts safely, then commit and push changes; create a PR if none exists for the branch.
license	MIT
compatibility	Requires git repository with origin remote and GitHub CLI (gh) for PR checks/creation.
metadata	{"author":"farm","version":"1.0"}

Safely sync a working branch with origin/main, handle rebase conflicts, then publish and open a PR if needed.

Steps

1. Inspect branch and working tree

   • git branch --show-current
   • git status --short
   • If there are unresolved conflicts already, stop and ask for user direction.

2. Fetch and rebase onto main

   • git fetch origin main
   • git rebase origin/main

3. Resolve rebase conflicts (if any)

   • Check conflicted files: git status --short
   • Resolve each conflict intentionally (do not run destructive resets).
   • Stage resolved files: git add <paths> or git rm <paths>.
   • Continue: git rebase --continue.
   • Repeat until rebase finishes or explicit user input is required.

4. Commit user-requested local changes (only if needed)

   • If git status --short is empty, skip commit.
   • Else stage desired files (git add -A by default), then commit with a conventional message.

5. Push branch

   • git push
   • If push is rejected after rebase, use git push --force-with-lease only when user explicitly asked for rewritten-history push.

6. Ensure a PR exists

   • Detect current branch PR:
     • gh pr list --head "$(git branch --show-current)" --json number,title,state,url
   • If no PR exists, create one:
     • gh pr create --fill
     • If --fill fails due to missing metadata, provide explicit --title and --body.

7. Report result

   • Branch name
   • Rebase outcome (and conflict files resolved)
   • Commit hash/title created in this run (or note "no new commit")
   • Push destination
   • PR URL (existing or newly created)

Guardrails

• Never use git reset --hard, git checkout --, or force push without explicit user approval.
• Do not amend commits unless explicitly requested.
• If hooks/tests fail during commit or push, surface the first failure and stop.