Git push with checks and report

Push orchestrator: collect state, push, report. Runs autonomously — no confirmation prompts.

Input

$ARGUMENTS — optional flags (--force-with-lease).

Step 1 — Pre-check

One call:

bash ${CLAUDE_PLUGIN_ROOT}/lib/gp-precheck.sh

Parse the structured block. Single-value fields are KEY: value; list fields (UNCOMMITTED_LIST) span from the line after KEY: to the next top-level KEY:.

Step 2 — Decide

Blocking (report and stop):

• ERRORS contains detached HEAD → "Checkout a branch before push".
• ERRORS contains no remote → "Add a remote: git remote add origin <url>".
• UNPUSHED_COMMITS = 0 and HAS_UPSTREAM = true → "Nothing to push" (if UNCOMMITTED_FILES > 0, add: commit first with /yoke:gca).

Non-blocking:

• GH_AUTH != ok → push still proceeds; only PR/URL info is skipped in the report.
• UNCOMMITTED_FILES > 0 → never blocks. git push sends only commits; note them in the report.

PUSH_MODE:

• HAS_UPSTREAM = false → set-upstream
• $ARGUMENTS contains --force-with-lease → force-with-lease
• otherwise → normal

Step 3 — Push

One call:

bash ${CLAUDE_PLUGIN_ROOT}/lib/gp-push.sh "<BRANCH>" "<PUSH_MODE>"

If PUSH_STATUS = FAILED → show PUSH_ERROR. If it contains "non-fast-forward" → suggest git pull --rebase or /yoke:gp --force-with-lease. Stop.

Step 4 — Report

Fill from the gp-push.sh block; Commits: ← PUSHED_LIST:

Pushed to origin/<BRANCH>: +<PUSHED_COMMITS> commits

Commits:
  <PUSHED_LIST>

Stats: <DIFF_STAT>
Link: <BRANCH_URL>

• Omit the Link: line when BRANCH_URL = empty.
• PR_EXISTS = true → add PR: <PR_TITLE> (<PR_URL>) and suggest /yoke:pr to update it.
• PR_EXISTS = false → suggest /yoke:pr to create one.
• UNCOMMITTED_FILES (carried from Step 1) > 0 → add Uncommitted (not pushed): <N> files.

Print the report and the suggestion — do not ask a follow-up question.

Rules

• Runs autonomously: no confirmation prompts.
• Remote: origin. When multiple remotes exist — push to origin.
• gh is optional; its absence only removes PR/URL info, never blocks the push.
• The only mutation is git push (inside lib/gp-push.sh).
• Output limit: max 20 commits.