proagents 1.6.19 → 1.6.21

package/.proagents/cicd/README.md

@@ -1,338 +0,0 @@
-# CI/CD Pipeline Templates
-
-Pre-configured continuous integration and deployment pipelines.
-
----
-
-## Overview
-
-Ready-to-use CI/CD templates for popular platforms, integrated with ProAgents workflow.
-
-## Documentation
-
-| Document | Description |
-|----------|-------------|
-| [GitHub Actions](./github-actions.md) | GitHub CI/CD templates |
-| [GitLab CI](./gitlab-ci.md) | GitLab pipeline templates |
-| [Jenkins](./jenkins.md) | Jenkins pipeline templates |
-| [Azure DevOps](./azure-devops.md) | Azure Pipelines templates |
-
----
-
-## Quick Start
-
-```bash
-# Generate CI/CD config for your platform
-proagents cicd init github-actions
-
-# Validate pipeline config
-proagents cicd validate
-
-# Test pipeline locally
-proagents cicd test
-```
-
----
-
-## GitHub Actions Template
-
-```yaml
-# .github/workflows/ci.yml
-name: CI
-
-on:
-  push:
-    branches: [main, develop]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run linting
-        run: npm run lint
-
-      - name: Run tests
-        run: npm test -- --coverage
-
-      - name: Upload coverage
-        uses: codecov/codecov-action@v3
-
-  security:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Security scan
-        run: npx proagents security scan --ci
-
-  build:
-    needs: [test, security]
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Build
-        run: npm run build
-
-      - name: Upload artifacts
-        uses: actions/upload-artifact@v3
-        with:
-          name: build
-          path: dist/
-```
-
----
-
-## GitLab CI Template
-
-```yaml
-# .gitlab-ci.yml
-stages:
-  - test
-  - security
-  - build
-  - deploy
-
-variables:
-  NODE_VERSION: "20"
-
-test:
-  stage: test
-  image: node:${NODE_VERSION}
-  script:
-    - npm ci
-    - npm run lint
-    - npm test -- --coverage
-  coverage: '/Lines\s*:\s*(\d+\.?\d*)%/'
-  artifacts:
-    reports:
-      coverage_report:
-        coverage_format: cobertura
-        path: coverage/cobertura-coverage.xml
-
-security:
-  stage: security
-  script:
-    - npx proagents security scan --ci
-  allow_failure: false
-
-build:
-  stage: build
-  script:
-    - npm ci
-    - npm run build
-  artifacts:
-    paths:
-      - dist/
-
-deploy:staging:
-  stage: deploy
-  script:
-    - npx proagents deploy --env staging
-  environment:
-    name: staging
-  only:
-    - develop
-
-deploy:production:
-  stage: deploy
-  script:
-    - npx proagents deploy --env production
-  environment:
-    name: production
-  when: manual
-  only:
-    - main
-```
-
----
-
-## Pipeline Stages
-
-### Standard Pipeline
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    CI/CD Pipeline                            │
-├─────────────────────────────────────────────────────────────┤
-│                                                             │
-│  ┌────────┐   ┌──────────┐   ┌───────┐   ┌────────┐       │
-│  │  Test  │──▶│ Security │──▶│ Build │──▶│ Deploy │       │
-│  └────────┘   └──────────┘   └───────┘   └────────┘       │
-│       │            │             │            │            │
-│       ▼            ▼             ▼            ▼            │
-│    Lint         Scan         Compile     Staging          │
-│    Unit         Audit        Bundle      Production       │
-│    Coverage     SAST         Artifacts                    │
-│                                                             │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### Stage Configuration
-
-```yaml
-# proagents.config.yaml
-cicd:
-  stages:
-    test:
-      parallel: true
-      jobs:
-        - lint
-        - unit_tests
-        - integration_tests
-
-    security:
-      required: true
-      jobs:
-        - dependency_audit
-        - sast_scan
-        - secret_scan
-
-    build:
-      jobs:
-        - compile
-        - bundle
-        - docker_build
-
-    deploy:
-      environments:
-        staging:
-          auto_deploy: true
-          branch: "develop"
-
-        production:
-          auto_deploy: false
-          branch: "main"
-          require_approval: true
-```
-
----
-
-## Branch Strategies
-
-### GitFlow
-
-```yaml
-cicd:
-  branching:
-    strategy: "gitflow"
-
-    branches:
-      main:
-        deploy_to: "production"
-        protected: true
-
-      develop:
-        deploy_to: "staging"
-
-      "feature/*":
-        run_tests: true
-        deploy_to: "preview"
-
-      "hotfix/*":
-        run_tests: true
-        deploy_to: "staging"
-```
-
-### Trunk-Based
-
-```yaml
-cicd:
-  branching:
-    strategy: "trunk"
-
-    branches:
-      main:
-        deploy_to: "production"
-        require_pr: true
-
-      "feature/*":
-        run_tests: true
-        preview_deploy: true
-```
-
----
-
-## Caching
-
-### Dependency Caching
-
-```yaml
-# GitHub Actions
-- uses: actions/cache@v3
-  with:
-    path: ~/.npm
-    key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
-    restore-keys: |
-      ${{ runner.os }}-node-
-
-# GitLab CI
-cache:
-  key: ${CI_COMMIT_REF_SLUG}
-  paths:
-    - node_modules/
-```
-
----
-
-## Notifications
-
-```yaml
-cicd:
-  notifications:
-    on_success:
-      channels: ["slack:#deployments"]
-
-    on_failure:
-      channels: ["slack:#alerts"]
-      mention: ["@oncall"]
-
-    on_approval_needed:
-      channels: ["slack:#deployments"]
-```
-
----
-
-## Commands
-
-```bash
-# Initialize CI/CD config
-proagents cicd init [platform]
-
-# Validate config
-proagents cicd validate
-
-# Run pipeline locally
-proagents cicd run
-
-# View pipeline status
-proagents cicd status
-
-# Trigger deployment
-proagents cicd deploy staging
-```
-
----
-
-## Best Practices
-
-1. **Fail Fast**: Run quick checks first
-2. **Parallelize**: Run independent jobs in parallel
-3. **Cache Dependencies**: Speed up builds
-4. **Pin Versions**: Use specific tool versions
-5. **Secure Secrets**: Never expose in logs
-6. **Require Reviews**: For production deployments
-7. **Monitor Pipelines**: Track build times and failures

package/.proagents/cicd/azure-devops.md

@@ -1,267 +0,0 @@
-# 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