thrivekit 2.0.0

package/templates/config/fullstack.json

@@ -0,0 +1,86 @@
+{
+  "auth": {
+    "testUser": "",
+    "testPassword": "",
+    "loginEndpoint": "/api/auth/login",
+    "loginMethod": "POST",
+    "tokenType": "session",
+    "tokenHeader": "Authorization",
+    "tokenPrefix": "Bearer"
+  },
+
+  "docker": {
+    "enabled": false,
+    "composeFile": "docker-compose.yml",
+    "serviceName": "web",
+    "execPrefix": "docker compose exec -T"
+  },
+
+  "paths": {
+    "frontend": "frontend",
+    "backend": ".",
+    "tests": "tests",
+    "e2e": "frontend/tests/e2e"
+  },
+
+  "commands": {
+    "devFrontend": "cd frontend && npm run dev",
+    "devBackend": "python manage.py runserver",
+    "install": "npm install && pip install -r requirements.txt",
+    "seed": "",
+    "resetDb": ""
+  },
+
+  "migrations": {
+    "command": "python manage.py migrate",
+    "pattern": "migrations/.*\\.py$"
+  },
+
+  "checks": {
+    "typescript": "cd frontend && npx tsc --noEmit",
+    "lint": "ruff check .",
+    "lintFrontend": "cd frontend && npm run lint",
+    "test": "python manage.py test --keepdb --parallel",
+    "testFrontend": "cd frontend && npm test"
+  },
+
+  "api": {
+    "baseUrl": "http://localhost:8000",
+    "healthEndpoint": "/api/health",
+    "timeout": 30
+  },
+
+  "playwright": {
+    "enabled": true,
+    "testDir": "frontend/tests/e2e",
+    "projects": ["chromium", "mobile"],
+    "baseUrl": "http://localhost:3000"
+  },
+
+  "verification": {
+    "codeReviewEnabled": true,
+    "browserEnabled": true,
+    "a11yEnabled": true,
+    "mobileViewport": 375,
+    "screenshotOnFailure": true
+  },
+
+  "urls": {
+    "frontend": "http://localhost:3000",
+    "backend": "http://localhost:8000",
+    "docs": "http://localhost:8000/api/docs"
+  },
+
+  "env": {
+    "required": ["DATABASE_URL", "SECRET_KEY"],
+    "optional": ["REDIS_URL", "SENTRY_DSN"]
+  },
+
+  "maxIterations": 20,
+  "maxSessionSeconds": 600,
+
+  "contextRotThreshold": {
+    "maxStories": 10,
+    "maxFilesChanged": 20
+  }
+}

package/templates/config/go.json

@@ -0,0 +1,81 @@
+{
+  "auth": {
+    "testUser": "",
+    "testPassword": "",
+    "loginEndpoint": "/api/auth/login",
+    "loginMethod": "POST",
+    "tokenType": "jwt",
+    "tokenHeader": "Authorization",
+    "tokenPrefix": "Bearer"
+  },
+
+  "docker": {
+    "enabled": false,
+    "composeFile": "docker-compose.yml",
+    "serviceName": "app",
+    "execPrefix": "docker compose exec -T"
+  },
+
+  "paths": {
+    "src": ".",
+    "tests": ".",
+    "e2e": "tests/e2e"
+  },
+
+  "commands": {
+    "dev": "go run .",
+    "install": "go mod download",
+    "seed": "",
+    "resetDb": ""
+  },
+
+  "migrations": {
+    "command": "migrate -path migrations -database $DATABASE_URL up",
+    "pattern": "migrations/.*\\.sql$"
+  },
+
+  "checks": {
+    "build": "go build ./...",
+    "lint": "golangci-lint run",
+    "test": "go test ./..."
+  },
+
+  "api": {
+    "baseUrl": "http://localhost:8080",
+    "healthEndpoint": "/health",
+    "timeout": 30
+  },
+
+  "playwright": {
+    "enabled": false,
+    "testDir": "tests/e2e",
+    "projects": ["chromium"],
+    "baseUrl": "http://localhost:8080"
+  },
+
+  "verification": {
+    "codeReviewEnabled": true,
+    "browserEnabled": true,
+    "a11yEnabled": false,
+    "mobileViewport": 375,
+    "screenshotOnFailure": true
+  },
+
+  "urls": {
+    "app": "http://localhost:8080",
+    "docs": "http://localhost:8080/swagger"
+  },
+
+  "env": {
+    "required": ["DATABASE_URL"],
+    "optional": ["REDIS_URL"]
+  },
+
+  "maxIterations": 20,
+  "maxSessionSeconds": 600,
+
+  "contextRotThreshold": {
+    "maxStories": 10,
+    "maxFilesChanged": 20
+  }
+}

package/templates/config/minimal.json

@@ -0,0 +1,76 @@
+{
+  "auth": {
+    "testUser": "",
+    "testPassword": "",
+    "loginEndpoint": "/api/auth/login",
+    "loginMethod": "POST",
+    "tokenType": "session",
+    "tokenHeader": "Authorization",
+    "tokenPrefix": "Bearer"
+  },
+
+  "docker": {
+    "enabled": false,
+    "composeFile": "docker-compose.yml",
+    "serviceName": "app",
+    "execPrefix": "docker compose exec -T"
+  },
+
+  "paths": {
+    "src": "src",
+    "tests": "tests",
+    "e2e": "tests/e2e"
+  },
+
+  "commands": {
+    "dev": "",
+    "install": "",
+    "seed": "",
+    "resetDb": ""
+  },
+
+  "migrations": {
+    "command": "",
+    "pattern": ""
+  },
+
+  "checks": {},
+
+  "api": {
+    "baseUrl": "http://localhost:3000",
+    "healthEndpoint": "/health",
+    "timeout": 30
+  },
+
+  "playwright": {
+    "enabled": false,
+    "testDir": "tests/e2e",
+    "projects": ["chromium"],
+    "baseUrl": "http://localhost:3000"
+  },
+
+  "verification": {
+    "codeReviewEnabled": false,
+    "browserEnabled": false,
+    "a11yEnabled": false,
+    "mobileViewport": 375,
+    "screenshotOnFailure": false
+  },
+
+  "urls": {
+    "app": "http://localhost:3000"
+  },
+
+  "env": {
+    "required": [],
+    "optional": []
+  },
+
+  "maxIterations": 20,
+  "maxSessionSeconds": 600,
+
+  "contextRotThreshold": {
+    "maxStories": 10,
+    "maxFilesChanged": 20
+  }
+}

package/templates/config/node.json

@@ -0,0 +1,81 @@
+{
+  "auth": {
+    "testUser": "",
+    "testPassword": "",
+    "loginEndpoint": "/api/auth/login",
+    "loginMethod": "POST",
+    "tokenType": "jwt",
+    "tokenHeader": "Authorization",
+    "tokenPrefix": "Bearer"
+  },
+
+  "docker": {
+    "enabled": false,
+    "composeFile": "docker-compose.yml",
+    "serviceName": "app",
+    "execPrefix": "docker compose exec -T"
+  },
+
+  "paths": {
+    "src": "src",
+    "tests": "tests",
+    "e2e": "tests/e2e"
+  },
+
+  "commands": {
+    "dev": "npm run dev",
+    "install": "npm install",
+    "seed": "",
+    "resetDb": ""
+  },
+
+  "migrations": {
+    "command": "npx prisma migrate deploy",
+    "pattern": "prisma/migrations/.*"
+  },
+
+  "checks": {
+    "typescript": "npx tsc --noEmit",
+    "lint": "npm run lint",
+    "test": "npm test"
+  },
+
+  "api": {
+    "baseUrl": "http://localhost:3000",
+    "healthEndpoint": "/api/health",
+    "timeout": 30
+  },
+
+  "playwright": {
+    "enabled": true,
+    "testDir": "tests/e2e",
+    "projects": ["chromium", "mobile"],
+    "baseUrl": "http://localhost:3000"
+  },
+
+  "verification": {
+    "codeReviewEnabled": true,
+    "browserEnabled": true,
+    "a11yEnabled": true,
+    "mobileViewport": 375,
+    "screenshotOnFailure": true
+  },
+
+  "urls": {
+    "app": "http://localhost:3000",
+    "docs": "http://localhost:3000/api/docs"
+  },
+
+  "env": {
+    "required": ["DATABASE_URL"],
+    "optional": ["REDIS_URL", "SENTRY_DSN"]
+  },
+
+  "maxIterations": 20,
+  "maxSessionSeconds": 600,
+
+  "contextRotThreshold": {
+    "maxStories": 10,
+    "maxFilesChanged": 20
+  }
+}

package/templates/config/python.json

@@ -0,0 +1,81 @@
+{
+  "auth": {
+    "testUser": "",
+    "testPassword": "",
+    "loginEndpoint": "/api/auth/login",
+    "loginMethod": "POST",
+    "tokenType": "jwt",
+    "tokenHeader": "Authorization",
+    "tokenPrefix": "Bearer"
+  },
+
+  "docker": {
+    "enabled": false,
+    "composeFile": "docker-compose.yml",
+    "serviceName": "app",
+    "execPrefix": "docker compose exec -T"
+  },
+
+  "paths": {
+    "src": "src",
+    "tests": "tests",
+    "e2e": "tests/e2e"
+  },
+
+  "commands": {
+    "dev": "uvicorn main:app --reload",
+    "install": "pip install -r requirements.txt",
+    "seed": "",
+    "resetDb": ""
+  },
+
+  "migrations": {
+    "command": "alembic upgrade head",
+    "pattern": "alembic/versions/.*\\.py$"
+  },
+
+  "checks": {
+    "lint": "ruff check .",
+    "typecheck": "mypy .",
+    "test": "pytest"
+  },
+
+  "api": {
+    "baseUrl": "http://localhost:8000",
+    "healthEndpoint": "/api/health",
+    "timeout": 30
+  },
+
+  "playwright": {
+    "enabled": false,
+    "testDir": "tests/e2e",
+    "projects": ["chromium"],
+    "baseUrl": "http://localhost:8000"
+  },
+
+  "verification": {
+    "codeReviewEnabled": true,
+    "browserEnabled": true,
+    "a11yEnabled": false,
+    "mobileViewport": 375,
+    "screenshotOnFailure": true
+  },
+
+  "urls": {
+    "app": "http://localhost:8000",
+    "docs": "http://localhost:8000/docs"
+  },
+
+  "env": {
+    "required": ["DATABASE_URL"],
+    "optional": ["REDIS_URL", "SENTRY_DSN"]
+  },
+
+  "maxIterations": 20,
+  "maxSessionSeconds": 600,
+
+  "contextRotThreshold": {
+    "maxStories": 10,
+    "maxFilesChanged": 20
+  }
+}

package/templates/config/rust.json

@@ -0,0 +1,81 @@
+{
+  "auth": {
+    "testUser": "",
+    "testPassword": "",
+    "loginEndpoint": "/api/auth/login",
+    "loginMethod": "POST",
+    "tokenType": "jwt",
+    "tokenHeader": "Authorization",
+    "tokenPrefix": "Bearer"
+  },
+
+  "docker": {
+    "enabled": false,
+    "composeFile": "docker-compose.yml",
+    "serviceName": "app",
+    "execPrefix": "docker compose exec -T"
+  },
+
+  "paths": {
+    "src": "src",
+    "tests": "tests",
+    "e2e": "tests/e2e"
+  },
+
+  "commands": {
+    "dev": "cargo run",
+    "install": "cargo build",
+    "seed": "",
+    "resetDb": ""
+  },
+
+  "migrations": {
+    "command": "sqlx migrate run",
+    "pattern": "migrations/.*\\.sql$"
+  },
+
+  "checks": {
+    "build": "cargo build",
+    "lint": "cargo clippy -- -D warnings",
+    "test": "cargo test"
+  },
+
+  "api": {
+    "baseUrl": "http://localhost:8080",
+    "healthEndpoint": "/health",
+    "timeout": 30
+  },
+
+  "playwright": {
+    "enabled": false,
+    "testDir": "tests/e2e",
+    "projects": ["chromium"],
+    "baseUrl": "http://localhost:8080"
+  },
+
+  "verification": {
+    "codeReviewEnabled": true,
+    "browserEnabled": true,
+    "a11yEnabled": false,
+    "mobileViewport": 375,
+    "screenshotOnFailure": true
+  },
+
+  "urls": {
+    "app": "http://localhost:8080",
+    "docs": "http://localhost:8080/swagger"
+  },
+
+  "env": {
+    "required": ["DATABASE_URL"],
+    "optional": ["REDIS_URL"]
+  },
+
+  "maxIterations": 20,
+  "maxSessionSeconds": 600,
+
+  "contextRotThreshold": {
+    "maxStories": 10,
+    "maxFilesChanged": 20
+  }
+}

package/templates/examples/CLAUDE-django.md

@@ -0,0 +1,174 @@
+# Project Instructions for AI Coding Agents
+
+## Naming Conventions
+- **Files**: `snake_case.py` — e.g., `user_views.py`, `auth_serializers.py`
+- **Functions/Variables**: `snake_case` — e.g., `get_user_by_id`, `is_authenticated`
+- **Classes**: `PascalCase` — e.g., `UserViewSet`, `AuthSerializer`
+- **Models**: `PascalCase` singular — e.g., `User`, `BlogPost` (Django pluralizes table names)
+- **Constants**: `SCREAMING_SNAKE` — e.g., `MAX_UPLOAD_SIZE`, `DEFAULT_PAGE_SIZE`
+- **URL patterns**: `kebab-case` — e.g., `/api/user-profile/`, `/api/blog-posts/`
+- **Template files**: `snake_case.html` — e.g., `user_detail.html`
+
+## Tech Stack
+- **Backend**: Django 5, Django REST Framework
+- **Database**: PostgreSQL
+- **Cache/Queue**: Redis, Celery
+- **Testing**: pytest, pytest-django
+
+## Code Quality Standards
+
+### Python Style
+- Follow PEP 8
+- Use type hints for function signatures
+- Maximum line length: 88 (Black default)
+- Use f-strings for string formatting
+
+```python
+# Good
+def get_user_by_email(email: str) -> User | None:
+    """Fetch a user by their email address."""
+    return User.objects.filter(email=email).first()
+```
+
+### Django Models
+- Use explicit `related_name` on ForeignKey/M2M
+- Add `__str__` method to all models
+- Use model managers for complex queries
+- Add indexes for frequently queried fields
+
+```python
+class Order(models.Model):
+    user = models.ForeignKey(
+        User,
+        on_delete=models.CASCADE,
+        related_name='orders'
+    )
+    created_at = models.DateTimeField(auto_now_add=True, db_index=True)
+
+    class Meta:
+        ordering = ['-created_at']
+
+    def __str__(self):
+        return f"Order {self.id} by {self.user.email}"
+```
+
+### Django REST Framework
+- Use serializers for all input/output
+- Use ViewSets for CRUD operations
+- Use proper permission classes
+- Return appropriate HTTP status codes
+
+```python
+class OrderViewSet(viewsets.ModelViewSet):
+    serializer_class = OrderSerializer
+    permission_classes = [IsAuthenticated]
+
+    def get_queryset(self):
+        # Only return user's own orders
+        return Order.objects.filter(user=self.request.user)
+
+    def perform_create(self, serializer):
+        serializer.save(user=self.request.user)
+```
+
+### Error Handling
+- Use DRF exceptions for API errors
+- Log errors with context
+- Never expose internal errors to users
+- Handle specific exceptions, not bare except
+
+```python
+# Bad
+try:
+    process_order(order)
+except Exception:
+    pass
+
+# Good
+try:
+    process_order(order)
+except PaymentError as e:
+    logger.error(f"Payment failed for order {order.id}: {e}")
+    raise ValidationError({"payment": "Payment processing failed"})
+except InventoryError as e:
+    logger.warning(f"Inventory issue for order {order.id}: {e}")
+    raise ValidationError({"inventory": str(e)})
+```
+
+### Database Queries
+- Avoid N+1 queries (use select_related/prefetch_related)
+- Use .only() or .defer() for large models
+- Use database transactions for multi-step operations
+- Add indexes for filter/order fields
+
+```python
+# Bad - N+1 query
+orders = Order.objects.all()
+for order in orders:
+    print(order.user.email)  # Hits DB for each order
+
+# Good
+orders = Order.objects.select_related('user').all()
+for order in orders:
+    print(order.user.email)  # No additional queries
+```
+
+### Security
+- Use Django's CSRF protection
+- Validate all user input with serializers
+- Use parameterized queries (Django ORM does this)
+- Never trust user input for file paths or shell commands
+
+### Testing
+- Use pytest and pytest-django
+- Use fixtures for test data
+- Test API endpoints with APIClient
+- Mock external services
+
+```python
+@pytest.mark.django_db
+class TestOrderAPI:
+    def test_create_order(self, authenticated_client, product):
+        response = authenticated_client.post('/api/orders/', {
+            'product_id': product.id,
+            'quantity': 2,
+        })
+        assert response.status_code == 201
+        assert Order.objects.count() == 1
+
+    def test_cannot_create_order_unauthenticated(self, client):
+        response = client.post('/api/orders/', {})
+        assert response.status_code == 401
+```
+
+## File Structure
+```
+project/
+├── config/           # Django settings, URLs, WSGI
+├── apps/
+│   ├── users/        # User-related models, views
+│   ├── orders/       # Order-related models, views
+│   └── common/       # Shared utilities
+├── tests/            # Test files
+└── manage.py
+```
+
+## Environment Variables
+```python
+# settings.py
+DATABASE_URL = os.getenv('DATABASE_URL')
+SECRET_KEY = os.getenv('SECRET_KEY')
+DEBUG = os.getenv('DEBUG', 'False').lower() == 'true'
+```
+
+## Pre-commit Hooks
+This project uses thrivekit hooks. Run `/vibe-check` before committing.
+
+## Common Commands
+```bash
+make up              # Start Docker services
+make migrate         # Run migrations
+make test            # Run tests
+make shell           # Django shell
+make logs            # View logs
+```