@@ -17,10 +17,10 @@ Thank you for your interest in contributing to CCProxy API! This guide will help
1717 ``` bash
1818 git clone https://github.com/CaddyGlow/ccproxy-api.git
1919 cd ccproxy-api
20- make setup # Installs dependencies and sets up dev environment
20+ ./Taskfile setup # Installs dependencies and sets up dev environment
2121 ```
2222
23- > ** Note** : Pre-commit hooks are automatically installed with ` make setup`
23+ > ** Note** : Pre-commit hooks are automatically installed with ` ./Taskfile setup`
2424
2525## Development Workflow
2626
@@ -40,13 +40,13 @@ git checkout -b feature/your-feature-name
4040
4141``` bash
4242# Recommended: Run comprehensive checks with auto-fixes
43- make pre-commit
43+ ./Taskfile pre-commit
4444
4545# Alternative: Run individual checks
46- make format # Format code
47- make lint # Check linting
48- make typecheck # Check types
49- make test-unit # Run fast tests
46+ ./Taskfile format # Format code
47+ ./Taskfile lint # Check linting
48+ ./Taskfile typecheck # Check types
49+ ./Taskfile test-unit # Run fast tests
5050```
5151
5252### 4. Commit Your Changes
@@ -65,7 +65,7 @@ git commit -m "feat: add new feature"
6565
6666Before pushing:
6767``` bash
68- make ci # Runs full CI pipeline locally (pre-commit + tests)
68+ ./Taskfile ci # Runs full CI pipeline locally (pre-commit + tests)
6969```
7070
7171### 6. Push and Create PR
@@ -83,11 +83,11 @@ All code must pass these checks before merging:
8383
8484| Check | Command | Purpose | Auto-fix |
8585| -------| ---------| ---------| ----------|
86- | ** Formatting** | ` make format` | Code style consistency | ✅ |
87- | ** Linting** | ` make lint` | Error detection | Partial (` make lint-fix` ) |
88- | ** Type Checking** | ` make typecheck` | Type safety | ❌ |
89- | ** Tests** | ` make test` | Functionality | ❌ |
90- | ** Pre-commit** | ` make pre-commit` | All checks combined | ✅ |
86+ | ** Formatting** | ` ./Taskfile format` | Code style consistency | ✅ |
87+ | ** Linting** | ` ./Taskfile lint` | Error detection | Partial (` ./Taskfile lint-fix` ) |
88+ | ** Type Checking** | ` ./Taskfile typecheck` | Type safety | ❌ |
89+ | ** Tests** | ` ./Taskfile test` | Functionality | ❌ |
90+ | ** Pre-commit** | ` ./Taskfile pre-commit` | All checks combined | ✅ |
9191
9292## Architecture: DI & Services
9393
@@ -160,27 +160,23 @@ The CCProxy test suite uses a streamlined architecture with 606 focused tests or
160160
161161``` bash
162162# All tests with coverage (recommended)
163- make test
163+ ./Taskfile test
164164
165165# Fast unit tests only - isolated components, service boundary mocking
166- make test-unit
166+ ./Taskfile test-unit
167167
168168# Integration tests - cross-component behavior, minimal mocking
169- make test-integration
169+ ./Taskfile test-integration
170170
171171# Plugin tests - centralized plugin testing
172- make test-plugins
173-
174- # Performance tests - benchmarks and load testing
175- make test-performance
172+ ./Taskfile test-plugins
176173
177174# Coverage report with HTML output
178- make test-coverage
175+ ./Taskfile test-coverage
179176
180177# Specific patterns
181- make test-file FILE=unit/auth/test_auth.py
182- make test-match MATCH=" authentication"
183- make test-watch # Auto-run on file changes
178+ ./Taskfile test-file tests/unit/auth/test_auth.py
179+ ./Taskfile test-match authentication
184180```
185181
186182#### Test Organization
@@ -271,56 +267,56 @@ chore: update dependencies
271267
272268Test the full CI pipeline locally:
273269``` bash
274- make ci # Same as GitHub Actions CI workflow
270+ ./Taskfile ci # Same as GitHub Actions CI workflow
275271```
276272
277273## Common Development Tasks
278274
279275### Running the Dev Server
280276``` bash
281- make dev # Starts with debug logging and auto-reload
277+ ./Taskfile dev # Starts with debug logging and auto-reload
282278```
283279
284280### Debugging Requests
285281``` bash
286282# Enable verbose logging
287283CCPROXY_VERBOSE_API=true \
288284CCPROXY_REQUEST_LOG_DIR=/tmp/ccproxy/request \
289- make dev
285+ ./Taskfile dev
290286
291287# View last request
292288scripts/show_request.sh
293289```
294290
295291### Building and Testing Docker
296292``` bash
297- make docker-build
298- make docker-run
293+ ./Taskfile docker-build
294+ ./Taskfile docker-run
299295```
300296
301297### Documentation
302298``` bash
303- make docs-build # Build docs
304- make docs-serve # Serve locally at http://localhost:8000
299+ ./Taskfile docs-build # Build docs
300+ ./Taskfile docs-serve # Serve locally at http://localhost:8000
305301```
306302
307303## Troubleshooting
308304
309305### Type Errors
310306``` bash
311- make typecheck
307+ ./Taskfile typecheck
312308# Or for detailed output:
313309uv run mypy . --show-error-codes
314310```
315311
316312### Formatting Issues
317313``` bash
318- make format # Auto-fixes most issues
314+ ./Taskfile format # Auto-fixes most issues
319315```
320316
321317### Linting Errors
322318``` bash
323- make lint-fix # Auto-fix what's possible
319+ ./Taskfile lint-fix # Auto-fix what's possible
324320# Manual fix required for remaining issues
325321```
326322
@@ -336,7 +332,7 @@ uv run pytest tests/test_file.py -s
336332### Pre-commit Hook Failures
337333``` bash
338334# Run manually to see all issues
339- make pre-commit
335+ ./Taskfile pre-commit
340336
341337# Skip hooks temporarily (not recommended)
342338git commit --no-verify -m " WIP: debugging"
0 commit comments