proagents 1.6.17 → 1.6.18

package/.proagents/approval-workflows/notifications.md

@@ -1,320 +0,0 @@
-# Approval Notifications
-
-Configure notifications for approval workflow events.
-
----
-
-## Notification Events
-
-| Event | Description | Default |
-|-------|-------------|---------|
-| `approval_requested` | New approval needed | Notify approvers |
-| `approval_granted` | Approval given | Notify requester |
-| `approval_rejected` | Approval denied | Notify requester |
-| `approval_reminder` | Pending reminder | Notify approvers |
-| `approval_escalated` | Escalated to next level | Notify escalation target |
-| `approval_expired` | Timeout reached | Notify all parties |
-
----
-
-## Configuration
-
-### Notification Setup
-
-```yaml
-approvals:
-  notifications:
-    enabled: true
-
-    # Default channels
-    default_channels:
-      - "email"
-      - "slack"
-
-    # Event-specific settings
-    events:
-      approval_requested:
-        channels: ["slack", "email"]
-        template: "approval_request"
-        priority: "high"
-
-      approval_granted:
-        channels: ["slack"]
-        template: "approval_granted"
-        priority: "normal"
-
-      approval_rejected:
-        channels: ["slack", "email"]
-        template: "approval_rejected"
-        priority: "high"
-
-      approval_reminder:
-        channels: ["slack"]
-        template: "approval_reminder"
-        schedule:
-          - after: "4h"
-          - after: "12h"
-          - after: "20h"
-```
-
-### Channel Configuration
-
-```yaml
-approvals:
-  notifications:
-    channels:
-      slack:
-        webhook_url_env: "SLACK_WEBHOOK_URL"
-        default_channel: "#approvals"
-
-        # Channel routing
-        routing:
-          security_review: "#security-approvals"
-          production_deploy: "#prod-approvals"
-
-      email:
-        smtp:
-          host: "smtp.company.com"
-          port: 587
-          from: "approvals@company.com"
-
-      teams:
-        webhook_url_env: "TEAMS_WEBHOOK_URL"
-
-      pagerduty:
-        api_key_env: "PAGERDUTY_API_KEY"
-        service_id: "P123ABC"
-        # Only for urgent approvals
-        events: ["approval_escalated"]
-```
-
----
-
-## Notification Templates
-
-### Slack Templates
-
-```yaml
-approvals:
-  notifications:
-    templates:
-      approval_request:
-        slack:
-          blocks:
-            - type: "header"
-              text: "🔔 Approval Required"
-            - type: "section"
-              fields:
-                - "*Feature:*\n{{feature.name}}"
-                - "*Requester:*\n{{requester.name}}"
-                - "*Stage:*\n{{stage.name}}"
-            - type: "section"
-              text: "{{description}}"
-            - type: "actions"
-              elements:
-                - type: "button"
-                  text: "Review"
-                  url: "{{review_url}}"
-                  style: "primary"
-```
-
-### Email Templates
-
-```yaml
-approvals:
-  notifications:
-    templates:
-      approval_request:
-        email:
-          subject: "[Action Required] Approval needed: {{feature.name}}"
-          body: |
-            Hi {{approver.name}},
-
-            Your approval is required for:
-
-            **Feature:** {{feature.name}}
-            **Requester:** {{requester.name}}
-            **Stage:** {{stage.name}}
-
-            **Description:**
-            {{description}}
-
-            Please review and approve at:
-            {{review_url}}
-
-            This request will expire in {{timeout}}.
-
-            ---
-            ProAgents Approval System
-```
-
----
-
-## Reminder Configuration
-
-### Reminder Schedule
-
-```yaml
-approvals:
-  notifications:
-    reminders:
-      enabled: true
-
-      schedule:
-        # First reminder
-        - after: "4h"
-          message: "Reminder: Approval pending for {{feature.name}}"
-
-        # Second reminder
-        - after: "12h"
-          message: "Second reminder: Approval still pending"
-          escalate: false
-
-        # Final reminder before escalation
-        - after: "20h"
-          message: "Final reminder: Will escalate in 4 hours"
-          escalate_warning: true
-
-      # Business hours only
-      business_hours:
-        enabled: true
-        start: "09:00"
-        end: "18:00"
-        timezone: "America/New_York"
-        skip_weekends: true
-```
-
----
-
-## Escalation Notifications
-
-### Escalation Setup
-
-```yaml
-approvals:
-  notifications:
-    escalation:
-      # Notify when escalating
-      notify_original_approvers: true
-      notify_escalation_target: true
-      notify_requester: true
-
-      template:
-        subject: "⚠️ Escalated: {{feature.name}} approval"
-        message: |
-          This approval has been escalated due to timeout.
-
-          Original approvers: {{original_approvers}}
-          Escalated to: {{escalation_target}}
-          Pending since: {{pending_duration}}
-```
-
----
-
-## Recipient Configuration
-
-### Dynamic Recipients
-
-```yaml
-approvals:
-  notifications:
-    recipients:
-      # Always notify
-      always:
-        - "{{requester.email}}"
-
-      # Based on stage
-      by_stage:
-        code_review:
-          - "{{codeowners}}"
-          - "@tech-leads"
-
-        security_review:
-          - "@security-team"
-
-        production_deploy:
-          - "@devops"
-          - "{{manager.email}}"
-
-      # Escalation chain
-      escalation:
-        - level: 1
-          recipients: ["@tech-leads"]
-        - level: 2
-          recipients: ["@engineering-managers"]
-        - level: 3
-          recipients: ["@directors"]
-```
-
----
-
-## Notification Preferences
-
-### User Preferences
-
-```yaml
-approvals:
-  notifications:
-    user_preferences:
-      enabled: true
-
-      # Users can configure
-      configurable:
-        - channels      # Which channels to use
-        - frequency     # Immediate vs digest
-        - quiet_hours   # Do not disturb
-
-      defaults:
-        channels: ["slack", "email"]
-        frequency: "immediate"
-        quiet_hours:
-          enabled: false
-```
-
-### Digest Mode
-
-```yaml
-approvals:
-  notifications:
-    digest:
-      enabled: true
-
-      # Combine notifications
-      schedule: "0 9 * * *"  # Daily at 9 AM
-
-      template:
-        subject: "Daily Approval Summary"
-        include:
-          - pending_approvals
-          - completed_approvals
-          - upcoming_deadlines
-```
-
----
-
-## Commands
-
-```bash
-# Test notification
-proagents approvals test-notification --event approval_requested
-
-# View notification history
-proagents approvals notifications --last 24h
-
-# Configure preferences
-proagents approvals preferences set --channel slack --frequency immediate
-
-# Mute notifications temporarily
-proagents approvals mute --duration 2h
-```
-
----
-
-## Best Practices
-
-1. **Don't Over-Notify**: Balance urgency with noise
-2. **Use Right Channels**: Urgent → Slack/PagerDuty, Normal → Email
-3. **Clear Templates**: Include all needed context
-4. **Respect Time Zones**: Send during business hours
-5. **Allow Preferences**: Let users configure their notifications
-6. **Track Delivery**: Monitor notification delivery rates

package/.proagents/compliance/README.md

@@ -1,206 +0,0 @@
-# Audit Trail & Compliance
-
-Complete audit logging and compliance features for regulated environments.
-
----
-
-## Overview
-
-ProAgents provides comprehensive audit logging and compliance features for organizations requiring regulatory compliance (SOC 2, GDPR, HIPAA, PCI-DSS).
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    Compliance System                         │
-├─────────────────────────────────────────────────────────────┤
-│                                                             │
-│  Audit Logging ──────────────────────────────────────────  │
-│  ├── All code changes tracked                              │
-│  ├── All access logged                                     │
-│  ├── All deployments recorded                              │
-│  └── All approvals documented                              │
-│                                                             │
-│  Compliance Features ────────────────────────────────────  │
-│  ├── Immutable audit logs                                  │
-│  ├── Retention policies                                    │
-│  ├── Access control tracking                               │
-│  └── Compliance reports                                    │
-│                                                             │
-│  Supported Standards ────────────────────────────────────  │
-│  ├── SOC 2 Type II                                         │
-│  ├── GDPR                                                  │
-│  ├── HIPAA                                                 │
-│  ├── PCI-DSS                                               │
-│  └── ISO 27001                                             │
-│                                                             │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Quick Start
-
-### Enable Compliance Mode
-
-```yaml
-# proagents.config.yaml
-
-compliance:
-  enabled: true
-  level: "standard"  # basic, standard, strict
-
-  frameworks:
-    - "soc2"
-    - "gdpr"
-```
-
-### View Audit Trail
-
-```bash
-# View recent audit events
-proagents audit list
-
-# View specific event
-proagents audit show event-123
-
-# Generate compliance report
-proagents compliance report --framework soc2
-```
-
----
-
-## Features
-
-| Feature | Description |
-|---------|-------------|
-| **Immutable Logs** | Write-once audit logs with cryptographic verification |
-| **Complete Tracking** | All changes, access, and actions logged |
-| **Retention Policies** | Configurable data retention by event type |
-| **Access Control** | Track all access to code and systems |
-| **Compliance Reports** | Generate reports for auditors |
-| **Evidence Collection** | Automated evidence gathering |
-
----
-
-## Documentation Files
-
-| File | Description |
-|------|-------------|
-| [audit-logging.md](./audit-logging.md) | Audit log structure and events |
-| [compliance-frameworks.md](./compliance-frameworks.md) | Supported compliance frameworks |
-| [retention-policies.md](./retention-policies.md) | Data retention configuration |
-| [reports.md](./reports.md) | Compliance report generation |
-| [access-control.md](./access-control.md) | Access tracking and control |
-
----
-
-## Audit Event Types
-
-### Code Changes
-- File modifications
-- Commits and merges
-- Branch operations
-- PR activity
-
-### Access Events
-- Repository access
-- Secrets access
-- Production access
-- Admin operations
-
-### Deployment Events
-- Staging deployments
-- Production deployments
-- Rollbacks
-- Configuration changes
-
-### Security Events
-- Failed login attempts
-- Permission changes
-- Security scan results
-- Vulnerability findings
-
----
-
-## Compliance Dashboard
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│ Compliance Dashboard                                         │
-├─────────────────────────────────────────────────────────────┤
-│                                                             │
-│ Frameworks:                                                 │
-│ ├── SOC 2: ✅ Compliant (Last audit: Jan 15)               │
-│ ├── GDPR: ✅ Compliant                                      │
-│ └── PCI-DSS: ⚠️ Review needed (2 items)                    │
-│                                                             │
-│ Audit Events (Last 30 days):                               │
-│ ├── Total: 1,234                                           │
-│ ├── Code Changes: 892                                      │
-│ ├── Access Events: 297                                     │
-│ └── Deployments: 45                                        │
-│                                                             │
-│ Pending Actions:                                            │
-│ ├── 2 access reviews due                                   │
-│ └── 1 policy update required                               │
-│                                                             │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Configuration
-
-```yaml
-# proagents.config.yaml
-
-compliance:
-  enabled: true
-
-  # Compliance level
-  level: "strict"  # basic, standard, strict
-
-  # Active frameworks
-  frameworks:
-    - "soc2"
-    - "gdpr"
-    - "hipaa"
-
-  # Audit settings
-  audit:
-    enabled: true
-    immutable: true
-    signed: true  # Cryptographic signing
-
-  # Retention (days)
-  retention:
-    security_events: 2555  # 7 years
-    code_changes: 1825     # 5 years
-    deployments: 1095      # 3 years
-    access_logs: 365       # 1 year
-
-  # Notifications
-  alerts:
-    compliance_violation: true
-    retention_expiry: true
-    access_anomaly: true
-
-  # Reports
-  reports:
-    auto_generate: true
-    schedule: "monthly"
-    recipients:
-      - "compliance@company.com"
-```
-
----
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `proagents audit list` | List audit events |
-| `proagents audit show <id>` | Show event details |
-| `proagents audit export` | Export audit logs |
-| `proagents compliance status` | Show compliance status |
-| `proagents compliance report` | Generate compliance report |
-| `proagents compliance check` | Run compliance check |