pr

/pr

Push the current feature branch and open a GitHub pull request, after running a full documentation audit.

Usage

/pr
/pr <optional PR title override>

Pre-conditions (check before proceeding)

1. Working tree is clean (git status --porcelain returns empty). If dirty, stop and tell the user to commit or stash first.
2. Not on main — never open a PR from main. If on main, stop and report the error.
3. Branch is rebased onto current main. Run git fetch origin, then check git rev-list HEAD..origin/main --count. If the count is > 0 (main has commits this branch doesn't have):
   • Run git rebase origin/main.
   • If it succeeds (exit 0), continue — but note that history was rewritten, so a git push --force-with-lease origin <branch> will be needed in Step 3.
   • If it has conflicts, stop immediately: list the conflicting files from git diff --name-only --diff-filter=U, tell the user to resolve them manually and re-run /pr when done. If count is 0 (already up to date), continue with a regular push in Step 3.

Steps

1. Gather context

Run these in parallel:

• git log main..HEAD --oneline — list commits on this branch.
• git diff main..HEAD --stat — files changed.
• Read CHANGELOG.md (current ## [Unreleased] section).
• Read AGENTS.md (Repo Map + AGL API sections).

2. Documentation audit (REQUIRED — do not skip)

Work through the full checklist from AGENTS.md § Documentation Checklist. All four artifact types must be addressed before the PR is opened.

CHANGELOG.md — add bullet(s) under the appropriate sub-heading (### Added, ### Changed, ### Fixed) in ## [Unreleased]. One concise sentence per logical capability. Do not duplicate existing entries.

AGENTS.md — Repo Map — add any new files introduced by this branch; update descriptions if a file's role changed. Cross-check by running:

find custom_components/haggle tests -name "*.py" | sort

AGENTS.md — AGL API — if this branch corrected an API fact (endpoint, field name, token lifetime, header), update that bullet now.