project-setup

# Project Setup

Create a new GitHub repository with standard dwmkerr project configuration.

## What Gets Created

1. **Private GitHub repo** with description
2. **Branch protection** - prevent direct push to main
3. **Squash merges only** for pull requests
4. **Actions can create PRs** enabled
5. **MIT License**
6. **Basic README** with intro and quickstart

## Setup Process

### 1. Create the Repository

```bash
gh repo create <repo-name> \
  --private \
  --description "<short description>" \
  --clone
```

### 2. Configure Repository Settings

```bash
# Require squash merges only, disable merge commits and rebase
gh api repos/dwmkerr/<repo-name> \
  --method PATCH \
  --field allow_squash_merge=true \
  --field allow_merge_commit=false \
  --field allow_rebase_merge=false \
  --field delete_branch_on_merge=true

# Allow GitHub Actions to create PRs
gh api repos/dwmkerr/<repo-name> \
  --method PATCH \
  --field allow_auto_merge=true

gh api repos/dwmkerr/<repo-name>/actions/permissions/workflow \
  --method PUT \
  --field can_approve_pull_request_reviews=true \
  --field default_workflow_permissions=write
```

### 3. Set Up Branch Protection

```bash
gh api repos/dwmkerr/<repo-name>/branches/main/protection \
  --method PUT \
  --field "required_pull_request_reviews[dismiss_stale_reviews]=false" \
  --field "required_pull_request_reviews[require_code_owner_reviews]=false" \
  --field "required_pull_request_reviews[required_approving_review_count]=0" \
  --field "enforce_admins=false" \
  --field "required_linear_history=true" \
  --field "allow_force_pushes=false" \
  --field "allow_deletions=false" \
  --field "restrictions=null"
```

### 4. Create MIT License

Create `LICENSE` file:

```
MIT License

Copyright (c) 2025 Dave Kerr

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights