proagents 1.0.0

package/proagents/cicd/azure-devops.md

@@ -0,0 +1,267 @@
+# Azure DevOps Pipeline Templates
+
+Azure Pipelines YAML configurations.
+
+---
+
+## Complete Pipeline
+
+```yaml
+# azure-pipelines.yml
+trigger:
+  branches:
+    include:
+      - main
+      - develop
+  paths:
+    exclude:
+      - README.md
+      - docs/*
+
+pr:
+  branches:
+    include:
+      - main
+      - develop
+
+pool:
+  vmImage: 'ubuntu-latest'
+
+variables:
+  nodeVersion: '20.x'
+  npm_config_cache: $(Pipeline.Workspace)/.npm
+
+stages:
+  - stage: Validate
+    displayName: 'Validate'
+    jobs:
+      - job: Lint
+        displayName: 'Lint & Type Check'
+        steps:
+          - task: NodeTool@0
+            inputs:
+              versionSpec: $(nodeVersion)
+            displayName: 'Install Node.js'
+
+          - task: Cache@2
+            inputs:
+              key: 'npm | "$(Agent.OS)" | package-lock.json'
+              restoreKeys: |
+                npm | "$(Agent.OS)"
+              path: $(npm_config_cache)
+            displayName: 'Cache npm'
+
+          - script: npm ci
+            displayName: 'Install dependencies'
+
+          - script: npm run lint
+            displayName: 'Run ESLint'
+
+          - script: npm run type-check
+            displayName: 'Run TypeScript check'
+
+  - stage: Test
+    displayName: 'Test'
+    dependsOn: Validate
+    jobs:
+      - job: UnitTests
+        displayName: 'Unit Tests'
+        steps:
+          - task: NodeTool@0
+            inputs:
+              versionSpec: $(nodeVersion)
+
+          - script: npm ci
+            displayName: 'Install dependencies'
+
+          - script: npm run test:unit -- --coverage
+            displayName: 'Run unit tests'
+
+          - task: PublishTestResults@2
+            inputs:
+              testResultsFormat: 'JUnit'
+              testResultsFiles: '**/junit.xml'
+            condition: always()
+
+          - task: PublishCodeCoverageResults@1
+            inputs:
+              codeCoverageTool: 'Cobertura'
+              summaryFileLocation: '$(System.DefaultWorkingDirectory)/coverage/cobertura-coverage.xml'
+
+      - job: IntegrationTests
+        displayName: 'Integration Tests'
+        services:
+          postgres:
+            image: postgres:15
+            ports:
+              - 5432:5432
+            env:
+              POSTGRES_DB: test_db
+              POSTGRES_USER: test
+              POSTGRES_PASSWORD: test
+        steps:
+          - task: NodeTool@0
+            inputs:
+              versionSpec: $(nodeVersion)
+
+          - script: npm ci
+            displayName: 'Install dependencies'
+
+          - script: npm run test:integration
+            displayName: 'Run integration tests'
+            env:
+              DATABASE_URL: postgresql://test:test@localhost:5432/test_db
+
+  - stage: Security
+    displayName: 'Security'
+    dependsOn: Validate
+    jobs:
+      - job: SecurityScan
+        displayName: 'Security Scan'
+        steps:
+          - task: NodeTool@0
+            inputs:
+              versionSpec: $(nodeVersion)
+
+          - script: npm ci
+            displayName: 'Install dependencies'
+
+          - script: npm audit --audit-level=high
+            displayName: 'NPM Audit'
+            continueOnError: true
+
+  - stage: Build
+    displayName: 'Build'
+    dependsOn:
+      - Test
+      - Security
+    jobs:
+      - job: Build
+        displayName: 'Build Application'
+        steps:
+          - task: NodeTool@0
+            inputs:
+              versionSpec: $(nodeVersion)
+
+          - script: npm ci
+            displayName: 'Install dependencies'
+
+          - script: npm run build
+            displayName: 'Build'
+
+          - publish: $(System.DefaultWorkingDirectory)/dist
+            artifact: build
+            displayName: 'Publish build artifact'
+
+  - stage: DeployStaging
+    displayName: 'Deploy to Staging'
+    dependsOn: Build
+    condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/develop'))
+    jobs:
+      - deployment: DeployStaging
+        displayName: 'Deploy to Staging'
+        environment: 'staging'
+        strategy:
+          runOnce:
+            deploy:
+              steps:
+                - download: current
+                  artifact: build
+
+                - script: |
+                    npx proagents deploy --env staging
+                  displayName: 'Deploy to staging'
+                  env:
+                    DEPLOY_TOKEN: $(STAGING_DEPLOY_TOKEN)
+
+  - stage: DeployProduction
+    displayName: 'Deploy to Production'
+    dependsOn: Build
+    condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
+    jobs:
+      - deployment: DeployProduction
+        displayName: 'Deploy to Production'
+        environment: 'production'
+        strategy:
+          runOnce:
+            deploy:
+              steps:
+                - download: current
+                  artifact: build
+
+                - script: |
+                    npx proagents deploy --env production
+                  displayName: 'Deploy to production'
+                  env:
+                    DEPLOY_TOKEN: $(PROD_DEPLOY_TOKEN)
+```
+
+---
+
+## Template Usage
+
+```yaml
+# azure-pipelines.yml
+resources:
+  repositories:
+    - repository: templates
+      type: git
+      name: MyProject/pipeline-templates
+
+extends:
+  template: node-app.yml@templates
+  parameters:
+    nodeVersion: '20.x'
+    runIntegrationTests: true
+    deployToStaging: true
+```
+
+---
+
+## Multi-Stage with Approvals
+
+```yaml
+stages:
+  - stage: DeployProduction
+    jobs:
+      - deployment: Production
+        environment: 'production'  # Requires approval in Azure DevOps
+        strategy:
+          runOnce:
+            deploy:
+              steps:
+                - script: echo "Deploying..."
+```
+
+---
+
+## Matrix Strategy
+
+```yaml
+jobs:
+  - job: Test
+    strategy:
+      matrix:
+        Node18:
+          nodeVersion: '18.x'
+        Node20:
+          nodeVersion: '20.x'
+        Node22:
+          nodeVersion: '22.x'
+    steps:
+      - task: NodeTool@0
+        inputs:
+          versionSpec: $(nodeVersion)
+      - script: npm test
+```
+
+---
+
+## Best Practices
+
+1. **Use Stages**: Organize pipeline into logical stages
+2. **Caching**: Cache npm dependencies
+3. **Environments**: Use environments for deployment approvals
+4. **Templates**: Use templates for reusable pipelines
+5. **Service Containers**: Use for database/service dependencies
+6. **Variable Groups**: Store secrets in variable groups

package/proagents/cicd/github-actions.md

@@ -0,0 +1,375 @@
+# GitHub Actions Templates
+
+Ready-to-use GitHub Actions workflows for CI/CD.
+
+---
+
+## Complete CI Workflow
+
+```yaml
+# .github/workflows/ci.yml
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+env:
+  NODE_VERSION: '20'
+
+jobs:
+  # Lint and type check
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint
+        run: npm run lint
+
+      - name: Run TypeScript check
+        run: npm run type-check
+
+  # Unit and integration tests
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test -- --coverage
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v3
+        with:
+          files: ./coverage/lcov.info
+          fail_ci_if_error: true
+
+  # Security scanning
+  security:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Run security audit
+        run: npm audit --audit-level=high
+
+      - name: Run Snyk scan
+        uses: snyk/actions/node@master
+        env:
+          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
+
+  # Build
+  build:
+    needs: [lint, test, security]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: build
+          path: dist/
+          retention-days: 7
+```
+
+---
+
+## Deployment Workflow
+
+```yaml
+# .github/workflows/deploy.yml
+name: Deploy
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Environment to deploy'
+        required: true
+        default: 'staging'
+        type: choice
+        options:
+          - staging
+          - production
+
+jobs:
+  deploy-staging:
+    if: github.ref == 'refs/heads/main' || github.event.inputs.environment == 'staging'
+    runs-on: ubuntu-latest
+    environment: staging
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download build
+        uses: actions/download-artifact@v4
+        with:
+          name: build
+          path: dist/
+
+      - name: Deploy to staging
+        run: |
+          # Your deployment command
+          npx proagents deploy --env staging
+        env:
+          DEPLOY_TOKEN: ${{ secrets.STAGING_DEPLOY_TOKEN }}
+
+      - name: Run smoke tests
+        run: npm run test:smoke -- --env staging
+
+  deploy-production:
+    if: github.event.inputs.environment == 'production'
+    needs: [deploy-staging]
+    runs-on: ubuntu-latest
+    environment: production
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download build
+        uses: actions/download-artifact@v4
+        with:
+          name: build
+          path: dist/
+
+      - name: Deploy to production
+        run: |
+          npx proagents deploy --env production
+        env:
+          DEPLOY_TOKEN: ${{ secrets.PROD_DEPLOY_TOKEN }}
+
+      - name: Notify deployment
+        uses: slackapi/slack-github-action@v1
+        with:
+          payload: |
+            {
+              "text": "✅ Deployed to production: ${{ github.sha }}"
+            }
+        env:
+          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK }}
+```
+
+---
+
+## PR Workflow
+
+```yaml
+# .github/workflows/pr.yml
+name: PR Checks
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  pr-checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Check PR title
+        uses: amannn/action-semantic-pull-request@v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Run affected tests
+        run: |
+          # Only test changed files
+          npm run test -- --changedSince=origin/main
+
+      - name: Check bundle size
+        uses: preactjs/compressed-size-action@v2
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Add coverage comment
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          message: |
+            ## Coverage Report
+            ${{ steps.coverage.outputs.summary }}
+```
+
+---
+
+## Scheduled Jobs
+
+```yaml
+# .github/workflows/scheduled.yml
+name: Scheduled Jobs
+
+on:
+  schedule:
+    # Daily at 6 AM UTC
+    - cron: '0 6 * * *'
+
+jobs:
+  dependency-update:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check for updates
+        run: npx proagents deps check --ci
+
+      - name: Create PR for updates
+        if: steps.check.outputs.has_updates == 'true'
+        run: npx proagents deps update --create-pr
+
+  security-scan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Run security scan
+        run: npx proagents security scan --ci
+
+      - name: Create issue on findings
+        if: failure()
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: 'Security vulnerabilities detected',
+              body: 'Please review the security scan results.',
+              labels: ['security', 'automated']
+            })
+```
+
+---
+
+## Reusable Workflows
+
+```yaml
+# .github/workflows/reusable-test.yml
+name: Reusable Test Workflow
+
+on:
+  workflow_call:
+    inputs:
+      node-version:
+        required: false
+        type: string
+        default: '20'
+    secrets:
+      npm-token:
+        required: false
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ inputs.node-version }}
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.npm-token }}
+
+      - name: Run tests
+        run: npm test
+```
+
+### Using Reusable Workflow
+
+```yaml
+# .github/workflows/ci.yml
+jobs:
+  test:
+    uses: ./.github/workflows/reusable-test.yml
+    with:
+      node-version: '20'
+    secrets:
+      npm-token: ${{ secrets.NPM_TOKEN }}
+```
+
+---
+
+## Matrix Builds
+
+```yaml
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        node: [18, 20, 22]
+      fail-fast: false
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+
+      - run: npm ci
+      - run: npm test
+```
+
+---
+
+## Best Practices
+
+1. **Cache Dependencies**: Use `actions/cache` or built-in caching
+2. **Parallel Jobs**: Run independent jobs in parallel
+3. **Fail Fast**: Use `fail-fast: false` for matrix builds
+4. **Environment Protection**: Use environments for deployments
+5. **Reusable Workflows**: DRY with reusable workflows
+6. **Secrets Management**: Never hardcode secrets