claude-code-templates 1.21.5 → 1.21.6

package/components/commands/automation/ci-pipeline.md

@@ -0,0 +1,378 @@
+---
+allowed-tools: Read, Write, Edit, Bash
+argument-hint: [pipeline-name] | setup | status | fix
+description: Manage and automate CI/CD pipeline configuration with GitHub Actions, multi-environment support, and deployment strategies
+model: sonnet
+---
+
+# CI/CD Pipeline Manager
+
+Manage CI/CD pipeline automation: $ARGUMENTS
+
+## Current Pipeline State
+
+- GitHub Actions: !`find .github/workflows -name "*.yml" -o -name "*.yaml" 2>/dev/null | head -5`
+- CI configuration: @.github/workflows/ (if exists)
+- Package scripts: @package.json
+- Environment files: !`find . -name ".env*" | head -3`
+- Recent workflow runs: !`gh run list --limit 5 2>/dev/null || echo "GitHub CLI not available"`
+
+## Task
+
+Automate CI/CD pipeline management with comprehensive workflow orchestration.
+
+## Pipeline Operations
+
+### Setup New Pipeline
+Create complete CI/CD pipeline with:
+
+```yaml
+# .github/workflows/ci.yml
+name: CI Pipeline
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18, 20]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+      
+      - name: Install dependencies
+        run: npm ci
+      
+      - name: Run linter
+        run: npm run lint
+      
+      - name: Run tests
+        run: npm run test:coverage
+      
+      - name: Build application
+        run: npm run build
+      
+      - name: Upload coverage
+        uses: codecov/codecov-action@v3
+        with:
+          file: ./coverage/lcov.info
+```
+
+### Multi-Environment Deployment
+```yaml
+# .github/workflows/deploy.yml
+name: Deploy
+on:
+  push:
+    branches: [main]
+  release:
+    types: [published]
+
+jobs:
+  deploy-staging:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    environment: staging
+    steps:
+      - uses: actions/checkout@v4
+      - name: Deploy to Staging
+        run: |
+          npm run build:staging
+          npm run deploy:staging
+        env:
+          STAGING_API_URL: ${{ secrets.STAGING_API_URL }}
+          STAGING_SECRET: ${{ secrets.STAGING_SECRET }}
+
+  deploy-production:
+    if: github.event_name == 'release'
+    runs-on: ubuntu-latest
+    environment: production
+    needs: [test]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Deploy to Production
+        run: |
+          npm run build:production
+          npm run deploy:production
+        env:
+          PROD_API_URL: ${{ secrets.PROD_API_URL }}
+          PROD_SECRET: ${{ secrets.PROD_SECRET }}
+```
+
+### Security & Quality Gates
+```yaml
+  security-scan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Run security audit
+        run: npm audit --audit-level=moderate
+      
+      - name: Scan for secrets
+        uses: trufflesecurity/trufflehog@main
+        with:
+          path: ./
+          base: main
+          head: HEAD
+      
+      - name: SAST Scan
+        uses: github/super-linter@v4
+        env:
+          DEFAULT_BRANCH: main
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+### Performance Testing
+```yaml
+  performance:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Performance Test
+        run: |
+          npm run build
+          npm run start:test &
+          sleep 10
+          npx lighthouse http://localhost:3000 --output=json --output-path=./lighthouse.json
+      
+      - name: Comment PR
+        uses: actions/github-script@v6
+        with:
+          script: |
+            const fs = require('fs');
+            const lighthouse = JSON.parse(fs.readFileSync('./lighthouse.json'));
+            const score = lighthouse.lhr.categories.performance.score * 100;
+            
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `⚡ Performance Score: ${score}/100`
+            });
+```
+
+## Advanced Features
+
+### 1. **Matrix Strategy Testing**
+```yaml
+strategy:
+  matrix:
+    os: [ubuntu-latest, windows-latest, macos-latest]
+    node-version: [16, 18, 20]
+    include:
+      - os: ubuntu-latest
+        node-version: 20
+        coverage: true
+```
+
+### 2. **Conditional Workflows**
+```yaml
+- name: Skip CI
+  if: contains(github.event.head_commit.message, '[skip ci]')
+  run: echo "Skipping CI as requested"
+
+- name: Deploy only on version tags
+  if: startsWith(github.ref, 'refs/tags/v')
+  run: npm run deploy
+```
+
+### 3. **Workflow Dependencies**
+```yaml
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    
+  deploy:
+    needs: [test, build]
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+```
+
+### 4. **Cache Optimization**
+```yaml
+- name: Cache node modules
+  uses: actions/cache@v3
+  with:
+    path: ~/.npm
+    key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+    restore-keys: |
+      ${{ runner.os }}-node-
+
+- name: Cache build output
+  uses: actions/cache@v3
+  with:
+    path: dist
+    key: build-${{ github.sha }}
+```
+
+### 5. **Artifact Management**
+```yaml
+- name: Upload build artifacts
+  uses: actions/upload-artifact@v3
+  with:
+    name: dist-files
+    path: dist/
+    retention-days: 7
+
+- name: Download artifacts
+  uses: actions/download-artifact@v3
+  with:
+    name: dist-files
+    path: dist/
+```
+
+### 6. **Environment Management**
+```yaml
+environments:
+  staging:
+    url: https://staging.example.com
+    
+  production:
+    url: https://example.com
+    protection_rules:
+      - type: required_reviewers
+        required_reviewers:
+          - devops-team
+      - type: wait_timer
+        wait_timer: 5
+```
+
+## Pipeline Monitoring
+
+### Status Checks
+```bash
+# Check workflow status
+gh run list --workflow=ci.yml --limit=10
+
+# View specific run
+gh run view [run-id] --log
+
+# Monitor failure rate
+gh api repos/:owner/:repo/actions/runs \
+  --jq '.workflow_runs[0:20] | map(select(.conclusion=="failure")) | length'
+```
+
+### Performance Metrics
+```bash
+# Average build time
+gh api repos/:owner/:repo/actions/runs \
+  --jq '.workflow_runs[0:50] | map(.run_duration_ms) | add / length'
+
+# Success rate calculation
+gh api repos/:owner/:repo/actions/runs \
+  --jq '.workflow_runs[0:100] | [group_by(.conclusion)[] | {conclusion: .[0].conclusion, count: length}]'
+```
+
+## Troubleshooting
+
+### Common Issues
+
+#### 1. **Workflow Permission Issues**
+```yaml
+permissions:
+  contents: read
+  actions: write
+  security-events: write
+  pull-requests: write
+```
+
+#### 2. **Secret Management**
+```bash
+# Add repository secret
+gh secret set STAGING_API_URL --body "https://staging-api.example.com"
+
+# List secrets
+gh secret list
+```
+
+#### 3. **Timeout Configuration**
+```yaml
+jobs:
+  long-running-job:
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    steps:
+      - name: Long task
+        timeout-minutes: 30
+        run: npm run long-task
+```
+
+#### 4. **Debugging Workflows**
+```yaml
+- name: Debug information
+  run: |
+    echo "Event name: ${{ github.event_name }}"
+    echo "Ref: ${{ github.ref }}"
+    echo "SHA: ${{ github.sha }}"
+    echo "Actor: ${{ github.actor }}"
+```
+
+## Best Practices
+
+### 1. **Fail Fast Strategy**
+- Run fastest jobs first
+- Use `fail-fast: true` in matrix
+- Implement early validation steps
+
+### 2. **Security First**
+- Never store secrets in code
+- Use least privilege permissions
+- Scan for vulnerabilities early
+
+### 3. **Efficiency Optimization**
+- Use appropriate cache strategies
+- Minimize workflow duration
+- Parallel job execution
+
+### 4. **Monitoring & Alerting**
+- Track build success rates
+- Monitor deployment frequency
+- Alert on critical failures
+
+## Integration Examples
+
+### Docker Integration
+```yaml
+- name: Build Docker image
+  run: |
+    docker build -t myapp:${{ github.sha }} .
+    docker tag myapp:${{ github.sha }} myapp:latest
+
+- name: Push to registry
+  run: |
+    echo ${{ secrets.DOCKER_PASSWORD }} | docker login -u ${{ secrets.DOCKER_USERNAME }} --password-stdin
+    docker push myapp:${{ github.sha }}
+    docker push myapp:latest
+```
+
+### Cloud Deployment
+```yaml
+- name: Deploy to AWS
+  uses: aws-actions/configure-aws-credentials@v2
+  with:
+    aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+    aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+    aws-region: us-east-1
+
+- name: Deploy to S3
+  run: |
+    aws s3 sync dist/ s3://my-bucket --delete
+    aws cloudfront create-invalidation --distribution-id ${{ secrets.CLOUDFRONT_ID }} --paths "/*"
+```
+
+This pipeline manager provides comprehensive automation for modern CI/CD workflows with security, performance, and monitoring built-in.

package/components/commands/automation/husky.md

@@ -0,0 +1,130 @@
+---
+allowed-tools: Bash, Read
+argument-hint: [--skip-install] | [--only-lint] | [--skip-tests]
+description: Run comprehensive CI checks and fix issues until repository is in working state
+model: sonnet
+---
+
+# Husky CI Pre-commit Checks
+
+Run comprehensive CI checks and fix issues: $ARGUMENTS
+
+## Current Repository State
+
+- Git status: !`git status --porcelain`
+- Package manager: !`which pnpm npm yarn | head -1`
+- Current branch: !`git branch --show-current`
+- Package.json: @package.json
+- Environment file: @.env (if exists)
+
+## Task
+
+Verify repository is in working state and fix issues. All commands run from repo root.
+
+## CI Check Protocol
+
+### Step 0: Environment Setup
+- Update dependencies: `pnpm i` (unless --skip-install)
+- Source environment: `.env` file if exists
+
+### Step 1: Linting
+- Check linter passes: `pnpm lint`
+- Fix formatting issues automatically when possible
+
+### Step 2: TypeScript & Build
+- Run comprehensive build checks:
+  ```bash
+  pnpm nx run-many --targets=build:types,build:dist,build:app,generate:docs,dev:run,typecheck
+  ```
+- If specific command fails, debug that command individually
+- Fix TypeScript errors and build issues
+
+### Step 3: Test Coverage
+- Source `.env` file first if exists
+- Run test coverage: `pnpm nx run-many --target=test:coverage`
+- **NEVER** run normal test command (times out)
+- Run individual packages one by one for easier debugging
+- For snapshot test failures: explain thesis before updating snapshots
+
+### Step 4: Package Validation
+- Sort package.json: `pnpm run sort-package-json`
+- Lint packages: `pnpm nx run-many --targets=lint:package,lint:deps`
+
+### Step 5: Double Check
+- If fixes made in any step, re-run all preceding checks
+- Ensure no regression introduced
+
+### Step 6: Staging
+- Check status: `git status`
+- Add files: `git add`
+- **EXCLUDE**: Git submodules in `lib/*` folders
+- **DO NOT COMMIT**: Only stage files
+
+## Error Handling Protocol
+
+### 1. Diagnosis
+- Explain why command broke with complete analysis
+- Cite source code and logs supporting thesis
+- Add console logs if needed for confirmation
+- Ask for help if insufficient context
+
+### 2. Fix Implementation
+- Propose specific fix with full explanation
+- Explain why fix will work
+- If fix fails, return to Step 1
+
+### 3. Impact Analysis
+- Consider if same bug exists elsewhere
+- Search codebase for similar patterns
+- Fix related issues proactively
+
+### 4. Cleanup
+- Remove all added console.logs after fixing
+- Run `pnpm run lint` to format files
+- Ask user before staging changes
+- Suggest commit message (don't commit)
+
+## Development Notes
+
+### File Organization
+- Functions/types like `createTevmNode` are in:
+  - Implementation: `createTevmNode.js`
+  - Types: `TevmNode.ts`
+  - Tests: `createTevmNode.spec.ts`
+
+### Tool-Specific Tips
+
+#### pnpm i
+- If fails, abort unless simple syntax error (missing comma)
+
+#### pnpm lint (Biome)
+- Lints entire codebase
+- Auto-fixes most formatting issues
+
+#### TypeScript Builds
+- Look for types in node_modules if not obvious
+- For tevm packages, check monorepo structure
+- Consult documentation if multiple failures
+
+#### Test Execution
+- Use Vite test runner
+- Run packages individually for debugging
+- Add console logs to test assumptions
+- Explain snapshot changes before updating
+
+## Success Criteria
+
+Print checklist at end with ✅ for passed steps:
+- ✅ Dependencies updated
+- ✅ Linting passed
+- ✅ TypeScript/Build passed
+- ✅ Tests passed
+- ✅ Package validation passed
+- ✅ Files staged (no commits made)
+
+## Safety Guidelines
+
+- **Fix errors proactively** - TypeScript/tests will catch regressions
+- **Never commit** - Only stage changes
+- **One step at a time** - Don't proceed until current step passes
+- **Ask permission** before staging if fixes were made