raise-pr

You are running an end-to-end PR workflow for the hyperswitch-control-center repo. Walk through each step below, printing a clear status update before and after every action.

Step 0: Assess current state

Run git status and git diff --stat to understand what's changed. Print a summary:

=== Current Changes ===
<list of modified/new/deleted files>

If there are no changes at all, stop and tell the user: "No changes detected. Nothing to commit."

Step 1: Format code

Print: [1/5] Running formatter (npm run re:format)...

Run:

npm run re:format

If it succeeds: print ✓ Formatting passed

If it fails: print the error output, then stop with:

✗ Formatting failed. Fix the errors above before raising a PR.

After formatting succeeds, check if re:format modified any files (git diff --name-only). If it did, print: → Formatter made changes to: <list of files> — these will be included in the commit.

Step 2: Lint

Print: [2/5] Running linter (npm run lint:hooks)...

Run:

npm run lint:hooks

If it succeeds: print ✓ Lint passed

If it fails: print the full lint output so the user can see exactly which rules and files failed, then stop with:

✗ Lint failed. Fix the errors above before raising a PR.
(Tip: run `npm run lint:hooks` locally to reproduce)

Do not proceed past this point if lint fails.

Step 3: Commit

Print: [3/5] Preparing commit...

3a: Stage changes

Run git diff --name-only and git status --short to see what will be staged.

Protected files — never stage these unless the user explicitly asks:

config.toml (contains local environment config that varies per developer)
webpack.dev.js / webpack.dev.ts / any file matching webpack.dev* (local dev overrides)

Before staging, check if any of these files appear in the diff. If they do, warn the user:

⚠ Skipping protected files (not staging):
  - config.toml
  - webpack.dev.js
These contain local config and are excluded by default. Say "include config.toml" or "include webpack.dev" if you want them staged.

Stage everything except protected files:

git add -A
git restore --staged config.toml webpack.dev.js webpack.dev.ts  # unstage if accidentally staged

(Only run git restore --staged for files that are actually present/staged.)

3b: Generate commit message

Look at the staged diff (git diff --cached --stat and git diff --cached) to understand what changed. Draft a conventional commit message following this repo's style:

fix: <description> for bug fixes
feat: <description> for new features
chore: <description> for tooling / non-functional changes
refactor: <description> for refactors

Show the user the proposed commit message and ask them to confirm or edit it:

Proposed commit message:
  <message>

Press Enter to use this, or type a new message:

Wait for the user's response. Use their message if they provide one, otherwise use the proposed message.

3c: Create commit

git commit -m "<confirmed message>"

Print: ✓ Committed: <message>

If the commit is rejected by a pre-commit hook, print the hook output clearly and stop:

✗ Pre-commit hook failed. See output above.

Step 4: Build PR body from template

Print: [4/5] Building PR description...

The repo uses .github/PULL_REQUEST_TEMPLATE.md as the standard PR body. Use it as the base — fill it in intelligently from the staged diff and commit message rather than asking the user for every field.

The template structure (fill these in):

## Type of Change — check all boxes that apply based on the diff:

[x] Bugfix if fixing a bug (fix: commit, error handling changes, etc.)
[x] New feature if adding new capability (feat: commit)
[x] Enhancement if improving existing functionality
[x] Refactoring if restructuring without behaviour change
[x] Dependency updates if package.json / lock files changed
[x] Documentation if only docs/comments changed
[x] CI/CD if workflow files changed

## Description — write 2–4 sentences summarising what changed and why, based on the diff. Be specific about files and components touched.

## Motivation and Context — explain the problem this solves or the need it addresses. If the user provided context earlier in the conversation, use it here. Otherwise infer from the diff.

## How did you test it? — infer from the changes:

If test files were modified, say so
Otherwise note: "Tested manually" and list the relevant flows based on what changed

## Where to test it? — check the appropriate environment(s):

[x] INTEG by default for most changes
Add [x] SANDBOX if the change affects payment flows or connector logic
Leave [ ] PROD unchecked unless the user says otherwise

## Checklist — pre-fill:

[x] I ran \npm run re:build`` — leave unchecked, remind the user to verify
[x] I reviewed submitted code — check this
[ ] I added unit tests for my changes where possible — check only if test files are in the diff

After filling in all sections, show the user the complete PR body and ask:

Here's the PR description I've drafted. Reply with any edits, or press Enter to use it as-is:

Wait for their response. Apply any edits they provide before proceeding.

Step 5: Push and raise PR

Print: [5/5] Pushing branch and creating PR...

5a: Push

git push -u origin HEAD

If push fails (e.g. protected branch, no remote), print the error and stop with guidance.

5b: Create PR

gh pr create \
  --title "<commit message or user-supplied title>" \
  --body "<constructed body from template>" \
  --base main

If the user wants to target a different base branch, ask before pushing.

If creation succeeds: print the PR URL clearly:
```
✓ PR raised successfully!
→ <PR URL>
```
If creation fails: print the gh error output and stop.

Final summary

After all steps complete successfully, print:

=== Done! ===
✓ Formatted
✓ Linted
✓ Committed: <message>
✓ PR raised: <URL>

If any step failed earlier, you would have already stopped and reported the error — no need to summarize failures here.