proagents 1.6.19 → 1.6.21

package/.proagents/cicd/jenkins.md

@@ -1,317 +0,0 @@
-# Jenkins Pipeline Templates
-
-Declarative Jenkins pipeline configurations.
-
----
-
-## Complete Jenkinsfile
-
-```groovy
-// Jenkinsfile
-pipeline {
-    agent any
-
-    environment {
-        NODE_VERSION = '20'
-        NPM_CONFIG_CACHE = "${WORKSPACE}/.npm"
-    }
-
-    options {
-        buildDiscarder(logRotator(numToKeepStr: '10'))
-        timeout(time: 30, unit: 'MINUTES')
-        disableConcurrentBuilds()
-    }
-
-    tools {
-        nodejs 'NodeJS-20'
-    }
-
-    stages {
-        stage('Install') {
-            steps {
-                sh 'npm ci'
-            }
-        }
-
-        stage('Validate') {
-            parallel {
-                stage('Lint') {
-                    steps {
-                        sh 'npm run lint'
-                    }
-                }
-                stage('Type Check') {
-                    steps {
-                        sh 'npm run type-check'
-                    }
-                }
-            }
-        }
-
-        stage('Test') {
-            parallel {
-                stage('Unit Tests') {
-                    steps {
-                        sh 'npm run test:unit -- --coverage'
-                    }
-                    post {
-                        always {
-                            junit 'junit.xml'
-                            publishCoverage adapters: [
-                                coberturaAdapter('coverage/cobertura-coverage.xml')
-                            ]
-                        }
-                    }
-                }
-                stage('Integration Tests') {
-                    steps {
-                        sh 'npm run test:integration'
-                    }
-                }
-            }
-        }
-
-        stage('Security Scan') {
-            steps {
-                sh 'npm audit --audit-level=high'
-            }
-        }
-
-        stage('Build') {
-            steps {
-                sh 'npm run build'
-            }
-            post {
-                success {
-                    archiveArtifacts artifacts: 'dist/**/*', fingerprint: true
-                }
-            }
-        }
-
-        stage('Deploy to Staging') {
-            when {
-                branch 'develop'
-            }
-            steps {
-                script {
-                    deployToEnvironment('staging')
-                }
-            }
-        }
-
-        stage('Deploy to Production') {
-            when {
-                branch 'main'
-            }
-            input {
-                message "Deploy to production?"
-                ok "Deploy"
-                submitter "admin,deploy-team"
-            }
-            steps {
-                script {
-                    deployToEnvironment('production')
-                }
-            }
-        }
-    }
-
-    post {
-        always {
-            cleanWs()
-        }
-        success {
-            slackSend(
-                color: 'good',
-                message: "Build succeeded: ${env.JOB_NAME} #${env.BUILD_NUMBER}"
-            )
-        }
-        failure {
-            slackSend(
-                color: 'danger',
-                message: "Build failed: ${env.JOB_NAME} #${env.BUILD_NUMBER}"
-            )
-        }
-    }
-}
-
-def deployToEnvironment(String environment) {
-    withCredentials([string(credentialsId: "${environment}-deploy-token", variable: 'DEPLOY_TOKEN')]) {
-        sh "npx proagents deploy --env ${environment}"
-    }
-}
-```
-
----
-
-## Multibranch Pipeline
-
-```groovy
-// Jenkinsfile for multibranch
-pipeline {
-    agent any
-
-    stages {
-        stage('Build & Test') {
-            steps {
-                sh 'npm ci'
-                sh 'npm test'
-                sh 'npm run build'
-            }
-        }
-
-        stage('Deploy') {
-            when {
-                anyOf {
-                    branch 'main'
-                    branch 'develop'
-                }
-            }
-            steps {
-                script {
-                    def environment = env.BRANCH_NAME == 'main' ? 'production' : 'staging'
-                    deployToEnvironment(environment)
-                }
-            }
-        }
-    }
-}
-```
-
----
-
-## Shared Library
-
-```groovy
-// vars/nodePipeline.groovy
-def call(Map config = [:]) {
-    pipeline {
-        agent any
-
-        tools {
-            nodejs config.nodeVersion ?: 'NodeJS-20'
-        }
-
-        stages {
-            stage('Install') {
-                steps {
-                    sh 'npm ci'
-                }
-            }
-
-            stage('Test') {
-                steps {
-                    sh 'npm test'
-                }
-            }
-
-            stage('Build') {
-                steps {
-                    sh 'npm run build'
-                }
-            }
-
-            stage('Deploy') {
-                when {
-                    expression { config.deploy == true }
-                }
-                steps {
-                    sh "npx proagents deploy --env ${config.environment}"
-                }
-            }
-        }
-    }
-}
-
-// Usage in Jenkinsfile
-@Library('my-shared-lib') _
-
-nodePipeline(
-    nodeVersion: 'NodeJS-20',
-    deploy: true,
-    environment: 'staging'
-)
-```
-
----
-
-## Docker Agent
-
-```groovy
-pipeline {
-    agent {
-        docker {
-            image 'node:20'
-            args '-v $HOME/.npm:/root/.npm'
-        }
-    }
-
-    stages {
-        stage('Build') {
-            steps {
-                sh 'npm ci'
-                sh 'npm run build'
-            }
-        }
-    }
-}
-```
-
----
-
-## Kubernetes Agent
-
-```groovy
-pipeline {
-    agent {
-        kubernetes {
-            yaml '''
-apiVersion: v1
-kind: Pod
-spec:
-  containers:
-  - name: node
-    image: node:20
-    command:
-    - sleep
-    args:
-    - infinity
-  - name: docker
-    image: docker:dind
-    securityContext:
-      privileged: true
-'''
-        }
-    }
-
-    stages {
-        stage('Build') {
-            steps {
-                container('node') {
-                    sh 'npm ci'
-                    sh 'npm run build'
-                }
-            }
-        }
-
-        stage('Docker Build') {
-            steps {
-                container('docker') {
-                    sh 'docker build -t myapp:latest .'
-                }
-            }
-        }
-    }
-}
-```
-
----
-
-## Best Practices
-
-1. **Use Declarative Pipelines**: Easier to read and maintain
-2. **Shared Libraries**: DRY with shared pipeline code
-3. **Parallel Stages**: Run independent stages in parallel
-4. **Input Gates**: Require approval for production
-5. **Clean Workspace**: Always clean up after builds
-6. **Credentials Management**: Use Jenkins credentials store

package/.proagents/collaboration/README.md

@@ -1,143 +0,0 @@
-# Real-Time Collaboration
-
-Enable multiple developers to work together on features.
-
----
-
-## Overview
-
-Real-time collaboration allows team members to work together on the same feature with shared context and synchronized progress.
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    Collaboration Session                     │
-├─────────────────────────────────────────────────────────────┤
-│                                                             │
-│  Developer 1 ──────┐                                       │
-│                    │                                       │
-│  Developer 2 ──────┼───► Shared Session ───► Feature      │
-│                    │         │                             │
-│  Reviewer ─────────┘         │                             │
-│                              ▼                             │
-│                    ┌─────────────────┐                     │
-│                    │ Synchronized:   │                     │
-│                    │ • Context       │                     │
-│                    │ • Progress      │                     │
-│                    │ • Decisions     │                     │
-│                    │ • Changes       │                     │
-│                    └─────────────────┘                     │
-│                                                             │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Quick Start
-
-### Start a Session
-
-```bash
-# Start collaboration session
-proagents collab start --feature user-auth
-
-# Output:
-Session started: sess_abc123
-Share this link: https://proagents.io/collab/sess_abc123
-```
-
-### Join a Session
-
-```bash
-# Join by session ID
-proagents collab join sess_abc123
-
-# Join by link
-proagents collab join https://proagents.io/collab/sess_abc123
-```
-
----
-
-## Collaboration Modes
-
-| Mode | Description | Use Case |
-|------|-------------|----------|
-| **Pair Programming** | Two developers, one feature | Complex implementation |
-| **Mob Programming** | Whole team, one feature | Knowledge sharing |
-| **Review Mode** | Developer + reviewer | Code review |
-| **Observer Mode** | Watch without editing | Training, oversight |
-
----
-
-## Features
-
-| Feature | Description |
-|---------|-------------|
-| **Shared Context** | Everyone sees the same codebase state |
-| **Real-Time Sync** | Changes broadcast instantly |
-| **Role-Based Access** | Different permissions per role |
-| **Chat Integration** | In-session communication |
-| **Decision Logging** | Track all decisions made |
-
----
-
-## Documentation Files
-
-| File | Description |
-|------|-------------|
-| [sessions.md](./sessions.md) | Session management |
-| [roles.md](./roles.md) | Collaboration roles |
-| [sync.md](./sync.md) | Synchronization details |
-
----
-
-## Configuration
-
-```yaml
-# proagents.config.yaml
-
-collaboration:
-  enabled: true
-
-  # Default session settings
-  sessions:
-    max_participants: 5
-    idle_timeout: "30m"
-    auto_save_interval: "5m"
-
-  # Roles
-  roles:
-    driver:
-      can_edit: true
-      can_execute: true
-
-    navigator:
-      can_edit: false
-      can_suggest: true
-
-    observer:
-      can_edit: false
-      can_suggest: false
-
-  # Communication
-  chat:
-    enabled: true
-    voice: false  # Requires external tool
-
-  # Sync settings
-  sync:
-    realtime: true
-    conflict_resolution: "last_writer_wins"
-```
-
----
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `proagents collab start` | Start new session |
-| `proagents collab join` | Join existing session |
-| `proagents collab leave` | Leave current session |
-| `proagents collab status` | Show session status |
-| `proagents collab invite` | Invite participant |
-| `proagents collab kick` | Remove participant |

package/.proagents/collaboration/roles.md

@@ -1,248 +0,0 @@
-# Collaboration Roles
-
-Define and manage roles for collaborative development sessions.
-
----
-
-## Role Types
-
-### Driver
-
-The active coder who controls the keyboard:
-
-```yaml
-roles:
-  driver:
-    description: "Active coder with keyboard control"
-    permissions:
-      can_edit: true
-      can_execute: true
-      can_commit: true
-      can_push: false  # Requires review
-
-    responsibilities:
-      - "Write code based on navigator guidance"
-      - "Execute tests and commands"
-      - "Implement agreed-upon solutions"
-
-    rotation:
-      enabled: true
-      interval: "25m"  # Pomodoro-style
-```
-
-### Navigator
-
-The strategic guide who reviews and directs:
-
-```yaml
-roles:
-  navigator:
-    description: "Strategic reviewer and guide"
-    permissions:
-      can_edit: false
-      can_suggest: true
-      can_comment: true
-      can_approve: true
-
-    responsibilities:
-      - "Review code as it's written"
-      - "Think strategically about approach"
-      - "Catch errors and suggest improvements"
-      - "Research and provide context"
-
-    rotation:
-      swap_with: "driver"
-```
-
-### Observer
-
-Learning or oversight participant:
-
-```yaml
-roles:
-  observer:
-    description: "Passive participant (learning/oversight)"
-    permissions:
-      can_edit: false
-      can_suggest: false
-      can_comment: true
-      can_view: true
-
-    use_cases:
-      - "Training new team members"
-      - "Management oversight"
-      - "Cross-team learning"
-```
-
-### Reviewer
-
-Code review specialist:
-
-```yaml
-roles:
-  reviewer:
-    description: "Focused code reviewer"
-    permissions:
-      can_edit: false
-      can_comment: true
-      can_request_changes: true
-      can_approve: true
-
-    responsibilities:
-      - "Review code quality"
-      - "Check for bugs and issues"
-      - "Ensure standards compliance"
-      - "Approve or request changes"
-```
-
----
-
-## Role Configuration
-
-### Session Roles
-
-```yaml
-collaboration:
-  sessions:
-    pair_programming:
-      roles:
-        - driver: 1
-        - navigator: 1
-      rotation: true
-
-    mob_programming:
-      roles:
-        - driver: 1
-        - navigator: "unlimited"
-        - observer: "unlimited"
-      rotation: true
-
-    review_session:
-      roles:
-        - author: 1
-        - reviewer: "1-3"
-      rotation: false
-```
-
-### Role Assignment
-
-```bash
-# Assign role when joining
-proagents collab join sess_abc123 --role navigator
-
-# Change role during session
-proagents collab role driver
-
-# View current roles
-proagents collab roles
-```
-
----
-
-## Role Rotation
-
-### Automatic Rotation
-
-```yaml
-collaboration:
-  rotation:
-    enabled: true
-
-    # Rotation interval
-    interval: "25m"
-
-    # Rotation style
-    style: "round_robin"  # round_robin, random, volunteer
-
-    # Notification
-    notify_before: "2m"
-
-    # Pause on
-    pause_on:
-      - "active_debugging"
-      - "complex_implementation"
-```
-
-### Manual Rotation
-
-```bash
-# Trigger rotation
-proagents collab rotate
-
-# Skip rotation
-proagents collab rotate --skip
-
-# Extend current turn
-proagents collab rotate --extend 10m
-```
-
-### Rotation Notification
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│ 🔄 Role Rotation in 2 minutes                               │
-├─────────────────────────────────────────────────────────────┤
-│                                                             │
-│ Current: Alice (driver) → Bob (navigator)                  │
-│ Next:    Bob (driver) → Alice (navigator)                  │
-│                                                             │
-│ [Rotate Now]  [Extend 5m]  [Skip]                          │
-│                                                             │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Permission Matrix
-
-| Action | Driver | Navigator | Observer | Reviewer |
-|--------|--------|-----------|----------|----------|
-| View code | ✅ | ✅ | ✅ | ✅ |
-| Edit code | ✅ | ❌ | ❌ | ❌ |
-| Run commands | ✅ | ❌ | ❌ | ❌ |
-| Suggest edits | ✅ | ✅ | ❌ | ✅ |
-| Add comments | ✅ | ✅ | ✅ | ✅ |
-| Commit | ✅ | ❌ | ❌ | ❌ |
-| Approve | ❌ | ✅ | ❌ | ✅ |
-
----
-
-## Custom Roles
-
-### Define Custom Role
-
-```yaml
-collaboration:
-  custom_roles:
-    security_reviewer:
-      description: "Security-focused reviewer"
-      base: "reviewer"
-      permissions:
-        can_block_on_security: true
-      focus_areas:
-        - "authentication"
-        - "authorization"
-        - "data_handling"
-        - "input_validation"
-
-    documentation_writer:
-      description: "Documentation specialist"
-      permissions:
-        can_edit: true
-        scope: "docs/**"
-      responsibilities:
-        - "Write documentation"
-        - "Update README"
-        - "Add code comments"
-```
-
----
-
-## Role Best Practices
-
-1. **Rotate Regularly**: Prevents fatigue, shares knowledge
-2. **Clear Responsibilities**: Everyone knows their role
-3. **Respect Permissions**: Driver drives, navigator navigates
-4. **Communicate**: Constant dialogue between roles
-5. **Take Breaks**: Rotate includes break opportunities
-6. **Flexibility**: Adjust roles based on task needs