create-pr

name	create-pr
description	Create a pull request for Agent Health following all compliance requirements. Use after implementing a feature or fix. Handles SPDX headers, DCO signoff, CHANGELOG, and the PR template.

Create Pull Request for Agent Health

You are helping the user create a compliant PR for the Agent Health project.

Pre-flight Checks

Run these before creating the PR:

1. Build & Tests

npm run build:all && npm run test:all

Must pass. Never use --no-verify.

2. SPDX License Headers

Every new .ts, .tsx, .js source file needs:

/* Copyright OpenSearch Contributors
 SPDX-License-Identifier: Apache-2.0 */

Check for missing headers:

grep -rL 'SPDX-License-Identifier' src/ cli/ server/ services/ --include='*.ts' --include='*.tsx'

3. DCO Signoff

Every commit needs Signed-off-by: line:

git log --format='%H %s' origin/main..HEAD | while read hash msg; do
  git log -1 --format='%b' $hash | grep -q 'Signed-off-by:' || echo "MISSING: $hash $msg"
done

Fix missing signoff (for last commit):

git commit --amend -s --no-edit

4. CHANGELOG.md

Add entry under ## [Unreleased] in the appropriate section:

• ### Added — new features
• ### Fixed — bug fixes
• ### Changed — modifications to existing features
• ### Removed — removed features

Format: - Description of change ([#PR](link))

Create the PR

gh pr create --title "<type>: <concise description>" --body "$(cat <<'EOF'
## Summary
- <bullet 1>
- <bullet 2>

## Test plan
- [ ] Unit tests added/updated
- [ ] `npm run build:all && npm run test:all` passes
- [ ] Manual verification: <describe what to check>

EOF
)"

Title Conventions

• feat: — new feature
• fix: — bug fix
• refactor: — code restructuring (no behavior change)
• docs: — documentation only
• test: — test additions/changes
• chore: — maintenance tasks

Keep title under 70 characters.

After PR Creation

• CI will run: tests, coverage, DCO check, changelog check, link checker
• Address review feedback with new commits (don't force-push unless asked)
• Ensure all CI checks pass before requesting re-review