claude-mpm 4.17.0__py3-none-any.whl → 4.18.3__py3-none-any.whl

claude_mpm/skills/bundled/database-migration.md

@@ -0,0 +1,199 @@
+---
+skill_id: database-migration
+skill_version: 0.1.0
+description: Safe patterns for evolving database schemas in production.
+updated_at: 2025-10-30T17:00:00Z
+tags: [database, migration, schema, production]
+---
+
+# Database Migration
+
+Safe patterns for evolving database schemas in production.
+
+## Migration Principles
+
+1. **Backward compatible** - New code works with old schema
+2. **Reversible** - Can rollback if needed
+3. **Tested** - Verify on staging before production
+4. **Incremental** - Small changes, not big-bang
+5. **Zero downtime** - No service interruption
+
+## Safe Migration Pattern
+
+### Phase 1: Add New (Compatible)
+```sql
+-- Add new column (nullable initially)
+ALTER TABLE users ADD COLUMN full_name VARCHAR(255) NULL;
+
+-- Deploy new code that writes to both old and new
+UPDATE users SET full_name = CONCAT(first_name, ' ', last_name);
+```
+
+### Phase 2: Migrate Data
+```sql
+-- Backfill existing data
+UPDATE users
+SET full_name = CONCAT(first_name, ' ', last_name)
+WHERE full_name IS NULL;
+```
+
+### Phase 3: Make Required
+```sql
+-- Make column required
+ALTER TABLE users ALTER COLUMN full_name SET NOT NULL;
+```
+
+### Phase 4: Remove Old (After New Code Deployed)
+```sql
+-- Remove old columns
+ALTER TABLE users DROP COLUMN first_name;
+ALTER TABLE users DROP COLUMN last_name;
+```
+
+## Common Migrations
+
+### Adding Index
+```sql
+-- Create index concurrently (PostgreSQL)
+CREATE INDEX CONCURRENTLY idx_users_email ON users(email);
+```
+
+### Renaming Column
+```sql
+-- Phase 1: Add new column
+ALTER TABLE users ADD COLUMN email_address VARCHAR(255);
+
+-- Phase 2: Copy data
+UPDATE users SET email_address = email;
+
+-- Phase 3: Drop old column (after deploy)
+ALTER TABLE users DROP COLUMN email;
+```
+
+### Changing Column Type
+```sql
+-- Phase 1: Add new column with new type
+ALTER TABLE products ADD COLUMN price_cents INTEGER;
+
+-- Phase 2: Migrate data
+UPDATE products SET price_cents = CAST(price * 100 AS INTEGER);
+
+-- Phase 3: Drop old column
+ALTER TABLE products DROP COLUMN price;
+ALTER TABLE products RENAME COLUMN price_cents TO price;
+```
+
+### Adding Foreign Key
+```sql
+-- Add column first
+ALTER TABLE orders ADD COLUMN user_id INTEGER NULL;
+
+-- Populate data
+UPDATE orders SET user_id = (
+    SELECT id FROM users WHERE users.email = orders.user_email
+);
+
+-- Add foreign key
+ALTER TABLE orders
+ADD CONSTRAINT fk_orders_users
+FOREIGN KEY (user_id) REFERENCES users(id);
+```
+
+## Migration Tools
+
+### Python (Alembic)
+```python
+# Generate migration
+alembic revision --autogenerate -m "add user full_name"
+
+# Apply migration
+alembic upgrade head
+
+# Rollback
+alembic downgrade -1
+```
+
+### JavaScript (Knex)
+```javascript
+// Create migration
+knex migrate:make add_full_name
+
+// Apply migrations
+knex migrate:latest
+
+// Rollback
+knex migrate:rollback
+```
+
+### Rails
+```ruby
+# Generate migration
+rails generate migration AddFullNameToUsers full_name:string
+
+# Run migrations
+rails db:migrate
+
+# Rollback
+rails db:rollback
+```
+
+## Testing Migrations
+
+```python
+def test_migration_forward_backward():
+    # Apply migration
+    apply_migration("add_full_name")
+
+    # Verify schema
+    assert column_exists("users", "full_name")
+
+    # Rollback
+    rollback_migration()
+
+    # Verify rollback
+    assert not column_exists("users", "full_name")
+```
+
+## Dangerous Operations
+
+### ❌ Avoid in Production
+```sql
+-- Locks table for long time
+ALTER TABLE users ADD COLUMN email VARCHAR(255) NOT NULL;
+
+-- Can't rollback
+DROP TABLE old_users;
+
+-- Breaks existing code immediately
+ALTER TABLE users DROP COLUMN email;
+```
+
+### ✅ Safe Alternatives
+```sql
+-- Add as nullable first
+ALTER TABLE users ADD COLUMN email VARCHAR(255) NULL;
+
+-- Rename instead of drop
+ALTER TABLE old_users RENAME TO archived_users;
+
+-- Keep old column until new code deployed
+-- (multi-phase approach)
+```
+
+## Rollback Strategy
+
+```sql
+-- Every migration needs DOWN
+-- UP
+ALTER TABLE users ADD COLUMN full_name VARCHAR(255);
+
+-- DOWN
+ALTER TABLE users DROP COLUMN full_name;
+```
+
+## Remember
+- Test migrations on copy of production data
+- Have rollback plan ready
+- Monitor during deployment
+- Communicate with team about schema changes
+- Keep migrations small and focused

claude_mpm/skills/bundled/docker-containerization.md

@@ -0,0 +1,194 @@
+---
+skill_id: docker-containerization
+skill_version: 0.1.0
+description: Essential Docker patterns for containerizing applications.
+updated_at: 2025-10-30T17:00:00Z
+tags: [docker, containers, deployment, devops]
+---
+
+# Docker Containerization
+
+Essential Docker patterns for containerizing applications.
+
+## Basic Dockerfile Structure
+
+```dockerfile
+# Use official base image
+FROM python:3.11-slim
+
+# Set working directory
+WORKDIR /app
+
+# Copy dependency files first (better caching)
+COPY requirements.txt .
+
+# Install dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY . .
+
+# Expose port
+EXPOSE 8000
+
+# Run application
+CMD ["python", "app.py"]
+```
+
+## Multi-Stage Builds
+
+```dockerfile
+# Build stage
+FROM node:18 AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+# Production stage
+FROM node:18-slim
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY package*.json ./
+RUN npm ci --only=production
+EXPOSE 3000
+CMD ["node", "dist/server.js"]
+```
+
+## Docker Compose
+
+```yaml
+version: '3.8'
+
+services:
+  web:
+    build: .
+    ports:
+      - "8000:8000"
+    environment:
+      - DATABASE_URL=postgresql://db:5432/myapp
+    depends_on:
+      - db
+    volumes:
+      - ./src:/app/src  # Hot reload in dev
+
+  db:
+    image: postgres:15
+    environment:
+      - POSTGRES_DB=myapp
+      - POSTGRES_PASSWORD=secret
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+
+volumes:
+  postgres_data:
+```
+
+## Best Practices
+
+### ✅ DO
+```dockerfile
+# Use specific versions
+FROM python:3.11-slim
+
+# Non-root user
+RUN useradd -m appuser
+USER appuser
+
+# Layer caching
+COPY requirements.txt .
+RUN pip install -r requirements.txt
+COPY . .
+
+# Health check
+HEALTHCHECK --interval=30s CMD curl -f http://localhost:8000/health || exit 1
+```
+
+### ❌ DON'T
+```dockerfile
+# Avoid latest tag
+FROM python:latest
+
+# Avoid running as root
+USER root
+
+# Don't copy unnecessary files
+COPY . .  # Includes .git, node_modules, etc.
+
+# Use .dockerignore instead
+```
+
+## .dockerignore
+
+```
+.git
+.gitignore
+node_modules
+__pycache__
+*.pyc
+.env
+.vscode
+README.md
+docker-compose.yml
+```
+
+## Common Commands
+
+```bash
+# Build image
+docker build -t myapp:1.0 .
+
+# Run container
+docker run -p 8000:8000 myapp:1.0
+
+# Run with environment variables
+docker run -e DATABASE_URL=postgresql://... myapp:1.0
+
+# Interactive shell
+docker run -it myapp:1.0 /bin/bash
+
+# View logs
+docker logs container_id
+
+# Stop container
+docker stop container_id
+
+# Remove container
+docker rm container_id
+
+# Remove image
+docker rmi myapp:1.0
+
+# Prune unused resources
+docker system prune -a
+```
+
+## Docker Compose Commands
+
+```bash
+# Start services
+docker-compose up
+
+# Start in background
+docker-compose up -d
+
+# View logs
+docker-compose logs -f
+
+# Stop services
+docker-compose down
+
+# Rebuild
+docker-compose build
+
+# Run command in service
+docker-compose exec web python manage.py migrate
+```
+
+## Remember
+- Keep images small (use slim/alpine variants)
+- Use specific version tags
+- Leverage layer caching
+- Don't include secrets in images
+- Use .dockerignore to exclude files