grey-haven-commit-format

# Grey Haven Commit Message Format

Follow Grey Haven Studio's **actual** commit message standards, enforced by commitlint configuration from production templates.

## Format Structure

```
<type>(<scope>): <subject>

[optional body]

[optional footer]
```

## CRITICAL Rules (Commitlint Enforced)

**These rules are automatically enforced by commitlint:**

1. **Header max length: 100 characters** (NOT 72 or 50!)
2. **Type: REQUIRED** and must be lowercase
3. **Subject: REQUIRED** and lowercase (NO sentence-case, start-case, pascal-case, or upper-case)
4. **Body: blank line before** (if included)
5. **Footer: blank line before** (if included)

## Commit Types

Use **exactly** these types from Grey Haven's commitlint configuration:

| Type | Use Case | Example |
|------|----------|---------|
| **feat** | New feature for the user | `feat(auth): add magic link authentication` |
| **fix** | Bug fix for the user | `fix(api): resolve race condition in order processing` |
| **docs** | Documentation changes only | `docs(readme): update TanStack Start setup guide` |
| **style** | Code style changes (formatting) - no logic changes | `style: apply Prettier to all TypeScript files` |
| **refactor** | Code refactoring - neither fixes a bug nor adds a feature | `refactor(repositories): simplify user query logic` |
| **test** | Adding or updating tests | `test(auth): add integration tests for OAuth flow` |
| **chore** | Maintenance tasks, dependency updates | `chore(deps): upgrade React to v19.1.0` |
| **perf** | Performance improvements | `perf(db): add composite index on user_id and created_at` |
| **ci** | CI/CD configuration changes | `ci: add Vitest coverage threshold check` |
| **build** | Build system or dependency changes | `build: configure bun for monorepo` |
| **revert** | Revert a previous commit | `revert: feat(auth): add OAuth authentication` |

**Any other type will be REJECTED by commitlint.**

## Subject Line Rules

### Requirements
- **Max length: 100 characters**