Git Commit & Push

When to Use

Use this when committing and pushing code changes across any service (core-api, console, worker). Runs validation checks before committing to ensure code quality.

Process

1. Pre-Commit Validation

• All modified files follow project coding standards
• No debug code, console.log, or TODO comments left behind
• No sensitive data (API keys, credentials) — verify via .gitignore
• Run git status to review staged and unstaged changes
• Document: modified files by service, nature of changes (feature/fix/refactor), breaking changes

2. Core-API Validation

cd core-api && npm run lint
cd core-api && npm run test

Requirements: 0 errors, 0 warnings, 100% tests pass, 80%+ coverage.

3. Console Validation

cd console && npm run lint
cd console && npm run typecheck
cd console && npm run test

Requirements: 0 errors, 0 warnings.

4. Worker Validation

task worker:format && task worker:lint
cd worker && go test ./...

Requirements: go fmt passes, go vet 0 issues, 100% tests pass.

5. Build Check

cd core-api && npm run build
cd console && npm run build
task worker:check

Requirements: all builds pass with 0 errors.

6. API Contract Sync

If API changes were made in core-api:

task console:gen-api

7. Commit Message

Follow Conventional Commits: type(scope): description

• Types: feat, fix, docs, style, refactor, perf, test, chore
• Scopes: core-api, console, worker, api, db, deps
• Subject: max 50 chars, no period, imperative mood
• Body: max 72 chars per line, explains what and why
• Footer: reference issues with Closes # or Fixes #

Examples:

feat(core-api): add target service history endpoint
fix(console): resolve dashboard loading state
chore(deps): update NestJS to v10

8. Commit & Push

git add <files>
git commit -m "<message>"
git push origin <current-branch>

For new branches: git push -u origin <current-branch>

9. Completion Summary

• Modified services and files
• Test results: Core-API ✅ Console ✅ Worker ✅
• Lint results: all pass ✅
• Commit hash and message
• Status: READY FOR REVIEW