toddsmithsalter/dotfiles/fix-gitlab-issue

Gitlab Issue Fixer

Fix Gitlab issues by implementing solutions on feature branches with proper testing.

Prerequisites

• glab CLI installed and authenticated
• Repository cloned locally
• Test command available (auto-detected or specified)

Workflow

1. Understand the Issue

glab issue view <issue-number>

Read the issue thoroughly.

2. Create Feature Branch

git checkout main && git pull origin main
git checkout -b fix-<short-description>

Branch naming: fix-description (lowercase, hyphens).

3. Analyze the Codebase

Before coding, understand the relevant parts:

• Locate files related to the issue
• Check existing tests for patterns
• Review any referenced code in the issue

4. Implement the Fix

Make minimal, focused changes that address the issue. Follow existing code style and patterns.

5. Run Tests Locally

Detect and run the test suite. Most likely it will be pest or phpunit. Take a look what is defined in composer.json or the testing github file.

Tests must pass locally before proceeding. If tests fail:

1. Analyze failures
2. Fix the implementation
3. Re-run until all pass

6. Commit Changes

git add -A
git commit -m "Fix #<issue-number>: <concise description>"

Use conventional commit message referencing the issue number.

7. Push and Create MR

git push -u origin fix/issue-<issue-number>-<short-description>
gh pr create --title "Fix #<issue-number>: <title>" --description "Fixes #<issue-number>
 
## Changes
- <bullet points of changes>
 
## Testing
- All local tests pass
- <any additional testing done>"

8. Monitor CI

glab ci status --live

If CI fails:

1. Review the failure: glab ci view --pipelineid <pipeline-id>
2. Fix locally
3. Push additional commits
4. Repeat until CI passes

Quick Reference

# View issue
glab issue view 123
 
# Create branch
git checkout -b fix/issue-123-description
 
# After fixing and tests pass
git add -A && git commit -m "Fix #123: description"
git push -u origin fix/issue-123-description
glab mr create --fill
 
# Watch CI
glab ci status --live