commit

Commit

Goals

• Commit only the intended changes.
• Match the target repository's commit-message convention.
• For branches that may become GitHub pull requests, reuse a checkout-local commit author only when it was already verified or configured for this workflow. Otherwise, configure it from the authenticated GitHub login before creating commits.
• Preserve unrelated user changes.
• Include validation evidence in the commit body when it helps review.
• Reference the implemented GitHub issue in a footer when the work belongs to an issue.

Steps

1. Inspect git status --short --branch, git diff, and git diff --staged.

2. Stage only files that belong to the current task.

3. Re-read newly added files before committing. Do not commit generated output, secrets, local run artifacts, private board names, card ids, account names, or host paths.

4. If this branch may be pushed to GitHub or published as a pull request, first check whether this checkout already has a local Git author verified by this workflow:

   current_name="$(git config --local --get user.name || true)"
   current_email="$(git config --local --get user.email || true)"
   author_verified="$(git config --local --get symphony-trello.github-author-verified || true)"
   if [ -z "$current_name" ] || [ -z "$current_email" ] || [ "$author_verified" != "true" ]; then
     if ! github_name="$(gh api user --jq '.login // ""')" || [ -z "$github_name" ]; then
       echo "GitHub identity lookup failed: could not resolve user login" >&2
       exit 1
     fi
     if ! github_email="$(gh api user --jq '.email // ""')"; then
       echo "GitHub identity lookup failed: could not resolve user email metadata" >&2
       exit 1
     fi
     if [ -z "$github_email" ]; then
       if ! github_email="$(gh api user/emails --jq '[.[] | select(.email | endswith("@users.noreply.github.com")) | .email][0] // ""' 2>/dev/null)"; then
         echo "GitHub identity lookup failed: gh api user/emails needs the user:email scope; run gh auth refresh -s user:email for this account" >&2
         exit 1
       fi
     fi
     if [ -z "$github_email" ]; then
       echo "GitHub identity lookup failed: configure a public email or accessible GitHub noreply email for this account" >&2
       exit 1
     fi
     git config --local user.name "$github_name"
     git config --local user.email "$github_email"
     git config --local symphony-trello.github-author-verified true
   fi