proagents 1.0.0

package/proagents/config/integrations/slack.yaml

@@ -0,0 +1,230 @@
+# Slack Integration Configuration
+# Copy these settings to your proagents.config.yaml under 'integrations.slack'
+
+# =============================================================================
+# BASIC CONFIGURATION
+# =============================================================================
+
+slack:
+  enabled: true
+
+  # Webhook URL (use environment variable!)
+  # Set in .env: SLACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx
+  # Or use Bot Token for richer features:
+  # Set in .env: SLACK_BOT_TOKEN=xoxb-xxx
+
+# =============================================================================
+# CHANNEL CONFIGURATION
+# =============================================================================
+
+  channels:
+    # Default channel for notifications
+    default: "#dev-notifications"
+
+    # Channel mapping by event type
+    mapping:
+      feature_start: "#dev-features"
+      deployment: "#deployments"
+      alerts: "#dev-alerts"
+      code_review: "#code-review"
+
+    # DM settings
+    direct_messages:
+      enabled: true
+      # Send DM for personal notifications
+      on:
+        - assigned_review
+        - mentioned
+        - blocked
+
+# =============================================================================
+# NOTIFICATION EVENTS
+# =============================================================================
+
+  notifications:
+    # Feature lifecycle
+    feature:
+      on_start: true
+      on_complete: true
+      on_blocked: true
+
+    # Development phases
+    phases:
+      on_analysis_complete: false
+      on_implementation_complete: false
+      on_testing_complete: false
+      on_review_ready: true
+
+    # Pull requests
+    pull_requests:
+      on_created: true
+      on_approved: true
+      on_merged: true
+      on_changes_requested: true
+
+    # Deployments
+    deployment:
+      on_staging: true
+      on_production: true
+      on_rollback: true
+      on_failure: true
+
+    # Alerts
+    alerts:
+      on_security_issue: true
+      on_test_failure: true
+      on_ci_failure: true
+
+# =============================================================================
+# MESSAGE FORMATTING
+# =============================================================================
+
+  formatting:
+    # Include rich formatting
+    use_blocks: true
+
+    # Include buttons for actions
+    include_actions: true
+
+    # Color coding
+    colors:
+      success: "#36a64f"
+      warning: "#ffcc00"
+      error: "#ff0000"
+      info: "#0066cc"
+
+# =============================================================================
+# MESSAGE TEMPLATES
+# =============================================================================
+
+  templates:
+    feature_start: |
+      :rocket: *New Feature Started*
+      *{{feature_name}}*
+      Developer: {{developer}}
+      Branch: `{{branch}}`
+      <{{tracking_url}}|View in tracker>
+
+    pr_created: |
+      :pull_request: *PR Ready for Review*
+      *{{pr_title}}*
+      Author: {{author}}
+      <{{pr_url}}|View PR> • {{files_changed}} files changed
+
+    deployment_production: |
+      :white_check_mark: *Deployed to Production*
+      *{{feature_name}}*
+      Version: `{{version}}`
+      Commit: `{{commit_sha}}`
+      <{{deployment_url}}|View deployment>
+
+    deployment_failure: |
+      :x: *Deployment Failed*
+      Environment: {{environment}}
+      Error: {{error_message}}
+      <{{logs_url}}|View logs>
+      cc: @oncall
+
+    security_alert: |
+      :warning: *Security Alert*
+      Severity: {{severity}}
+      Issue: {{description}}
+      File: `{{file_path}}`
+      Action required: <{{action_url}}|Review now>
+
+# =============================================================================
+# INTERACTIVE FEATURES
+# =============================================================================
+
+  interactive:
+    # Enable interactive buttons
+    enabled: true
+
+    # Available actions in messages
+    actions:
+      deployment:
+        - label: "View Logs"
+          action: "view_logs"
+        - label: "Rollback"
+          action: "rollback"
+          style: "danger"
+
+      pr_review:
+        - label: "Approve"
+          action: "approve"
+          style: "primary"
+        - label: "Request Changes"
+          action: "request_changes"
+
+# =============================================================================
+# THREADING
+# =============================================================================
+
+  threading:
+    # Use threads for updates
+    enabled: true
+
+    # Start thread for feature and post updates there
+    thread_on:
+      - feature_start
+
+    # Reply in thread for these events
+    reply_in_thread:
+      - phase_complete
+      - commit
+      - pr_update
+
+# =============================================================================
+# MENTIONS
+# =============================================================================
+
+  mentions:
+    # Mention settings
+    enabled: true
+
+    # Who to mention
+    mapping:
+      # Mention specific users/groups by event
+      deployment_failure: ["@oncall", "@devops"]
+      security_alert: ["@security-team"]
+      blocked: ["@tech-lead"]
+
+    # User ID mapping (for @mentions to work)
+    # users:
+    #   developer1: "U01234567"
+    #   tech_lead: "U76543210"
+
+# =============================================================================
+# RATE LIMITING
+# =============================================================================
+
+  rate_limiting:
+    # Prevent notification spam
+    enabled: true
+
+    # Max messages per hour per channel
+    max_per_hour: 30
+
+    # Batch similar notifications
+    batch_similar: true
+    batch_window_seconds: 60
+
+# =============================================================================
+# EXAMPLE USAGE
+# =============================================================================
+
+# After configuration:
+#
+# 1. Feature starts:
+#    → #dev-features: ":rocket: New Feature Started..."
+#
+# 2. PR created:
+#    → #code-review: ":pull_request: PR Ready for Review..."
+#    → Buttons: [View PR] [Approve]
+#
+# 3. Deployment:
+#    → #deployments: ":white_check_mark: Deployed to Production..."
+#
+# 4. Failure:
+#    → #dev-alerts: ":x: Deployment Failed..."
+#    → Mentions @oncall

package/proagents/config/rules/README.md

@@ -0,0 +1,73 @@
+# Project Rules Configuration
+
+Place your project-specific rules here. These are enforced during code generation and review.
+
+---
+
+## How It Works
+
+1. Copy templates from this directory
+2. Customize rules for your project
+3. ProAgents validates code against these rules
+4. Rules can block commits or show warnings
+
+---
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `custom-rules.yaml` | Project-specific validation rules |
+| `validation-rules.yaml` | Input/output validation rules |
+
+---
+
+## Quick Start
+
+```bash
+# Copy the template
+cp proagents/config/rules/custom-rules.template.yaml \
+   proagents/config/rules/custom-rules.yaml
+
+# Edit for your project
+vim proagents/config/rules/custom-rules.yaml
+```
+
+---
+
+## Rule Severity Levels
+
+| Level | Behavior |
+|-------|----------|
+| `error` | Blocks progress, must fix |
+| `warning` | Shows alert, can proceed |
+| `info` | Informational only |
+| `off` | Disabled |
+
+---
+
+## Rule Types
+
+| Type | Description |
+|------|-------------|
+| `naming` | File/variable naming patterns |
+| `import` | Import restrictions |
+| `structure` | Code organization rules |
+| `pattern` | Code pattern requirements |
+| `security` | Security-related checks |
+| `coverage` | Test coverage requirements |
+| `custom` | Custom business rules |
+
+---
+
+## Example Rule
+
+```yaml
+rules:
+  - id: require-error-boundary
+    type: pattern
+    condition: "page_component"
+    requires: "ErrorBoundary wrapper"
+    message: "All page components must have error boundaries"
+    severity: error
+```

package/proagents/config/rules/custom-rules.template.yaml

@@ -0,0 +1,188 @@
+# Custom Rules Template
+# Copy to custom-rules.yaml and customize for your project
+
+# Rule severity levels:
+# - error: Blocks progress, must fix
+# - warning: Shows alert, can proceed
+# - info: Informational only
+# - off: Disabled
+
+rules:
+  # ==========================================
+  # NAMING RULES
+  # ==========================================
+
+  - id: component-naming
+    type: naming
+    pattern: "^[A-Z][a-zA-Z]*$"
+    applies_to: "components/**/*.tsx"
+    message: "Components must use PascalCase"
+    severity: error
+
+  - id: hook-naming
+    type: naming
+    pattern: "^use[A-Z][a-zA-Z]*$"
+    applies_to: "hooks/**/*.ts"
+    message: "Hooks must start with 'use' prefix"
+    severity: error
+
+  - id: constant-naming
+    type: naming
+    pattern: "^[A-Z][A-Z0-9_]*$"
+    applies_to: "constants/**/*.ts"
+    message: "Constants must use UPPER_SNAKE_CASE"
+    severity: warning
+
+  # ==========================================
+  # IMPORT RULES
+  # ==========================================
+
+  - id: no-relative-parent-imports
+    type: import
+    pattern: "from '\\.\\./"
+    applies_to: "src/**/*.{ts,tsx}"
+    message: "Use absolute imports instead of relative parent imports"
+    severity: warning
+    auto_fix: true
+
+  - id: no-default-export
+    type: import
+    pattern: "export default"
+    applies_to: "src/components/**/*.tsx"
+    exclude: "src/pages/**"
+    message: "Use named exports for components"
+    severity: info
+
+  # ==========================================
+  # STRUCTURE RULES
+  # ==========================================
+
+  - id: no-business-logic-in-components
+    type: structure
+    rule: "Components should not import directly from /services/"
+    message: "Use hooks to access services, not direct imports"
+    severity: warning
+
+  - id: feature-folder-structure
+    type: structure
+    rule: "Feature folders must contain index.ts"
+    applies_to: "src/features/*"
+    message: "Feature folders must export via index.ts"
+    severity: error
+
+  # ==========================================
+  # PATTERN RULES
+  # ==========================================
+
+  - id: require-error-boundary
+    type: pattern
+    condition: "page_component"
+    requires: "ErrorBoundary"
+    message: "All page components must have error boundaries"
+    severity: error
+
+  - id: require-loading-state
+    type: pattern
+    condition: "uses_async_data"
+    requires: "loading state handling"
+    message: "Components fetching data must handle loading state"
+    severity: warning
+
+  - id: require-empty-state
+    type: pattern
+    condition: "renders_list"
+    requires: "empty state handling"
+    message: "Lists must handle empty state"
+    severity: warning
+
+  # ==========================================
+  # SECURITY RULES
+  # ==========================================
+
+  - id: no-dangerously-set-html
+    type: security
+    pattern: "dangerouslySetInnerHTML"
+    message: "Avoid dangerouslySetInnerHTML - XSS risk"
+    severity: error
+    exceptions:
+      - "src/components/RichTextRenderer.tsx"
+
+  - id: no-eval
+    type: security
+    pattern: "\\beval\\("
+    message: "Never use eval() - security risk"
+    severity: error
+
+  - id: no-hardcoded-secrets
+    type: security
+    patterns:
+      - "password\\s*=\\s*['\"][^'\"]+['\"]"
+      - "api[_-]?key\\s*=\\s*['\"][^'\"]+['\"]"
+      - "secret\\s*=\\s*['\"][^'\"]+['\"]"
+    message: "No hardcoded secrets - use environment variables"
+    severity: error
+
+  # ==========================================
+  # TESTING RULES
+  # ==========================================
+
+  - id: min-test-coverage
+    type: coverage
+    minimum: 80
+    applies_to: "src/**/*.{ts,tsx}"
+    exclude:
+      - "src/**/*.d.ts"
+      - "src/**/index.ts"
+    message: "Minimum 80% test coverage required"
+    severity: warning
+
+  - id: require-component-tests
+    type: coverage
+    condition: "new_component"
+    requires: "test file"
+    message: "New components must have tests"
+    severity: error
+
+  # ==========================================
+  # CUSTOM BUSINESS RULES
+  # ==========================================
+
+  # Example: Analytics tracking
+  - id: require-analytics-on-buttons
+    type: custom
+    condition: "Button component with onClick"
+    requires: "analytics tracking call"
+    message: "All button clicks should be tracked"
+    severity: info
+
+  # Example: Accessibility
+  - id: require-aria-labels
+    type: custom
+    condition: "interactive element without visible text"
+    requires: "aria-label attribute"
+    message: "Interactive elements need aria-labels"
+    severity: warning
+
+# ==========================================
+# GLOBAL SETTINGS
+# ==========================================
+
+settings:
+  # Paths to exclude from all rules
+  global_exclude:
+    - "node_modules/**"
+    - "dist/**"
+    - "build/**"
+    - "coverage/**"
+    - "**/*.test.{ts,tsx}"
+    - "**/*.spec.{ts,tsx}"
+
+  # Auto-fix settings
+  auto_fix:
+    enabled: true
+    require_confirmation: true
+
+  # Reporting
+  reporting:
+    format: "detailed"  # summary | detailed
+    group_by: "severity"  # severity | type | file

package/proagents/config/rules/validation-rules.template.yaml

@@ -0,0 +1,177 @@
+# Validation Rules Template
+# Copy to validation-rules.yaml and customize for your project
+
+# These rules validate data at system boundaries:
+# - API inputs/outputs
+# - Form data
+# - External integrations
+
+validation:
+  # ==========================================
+  # API VALIDATION
+  # ==========================================
+
+  api:
+    # Request validation
+    requests:
+      require_content_type: true
+      allowed_content_types:
+        - "application/json"
+        - "multipart/form-data"
+      max_body_size: "10mb"
+      require_auth_header: true
+      auth_exceptions:
+        - "POST /api/auth/login"
+        - "POST /api/auth/register"
+        - "GET /api/health"
+
+    # Response validation
+    responses:
+      require_json: true
+      require_status_codes: true
+      require_error_format: true
+      error_format:
+        required_fields:
+          - "error"
+          - "message"
+        optional_fields:
+          - "code"
+          - "details"
+
+  # ==========================================
+  # INPUT VALIDATION
+  # ==========================================
+
+  inputs:
+    # String validation
+    strings:
+      default_max_length: 255
+      default_min_length: 1
+      sanitize_html: true
+      trim_whitespace: true
+
+    # Email validation
+    email:
+      pattern: "^[^@]+@[^@]+\\.[^@]+$"
+      max_length: 255
+      normalize: true  # lowercase
+
+    # Password validation
+    password:
+      min_length: 8
+      require_uppercase: true
+      require_lowercase: true
+      require_number: true
+      require_special: false
+      blocked_passwords_file: "common-passwords.txt"
+
+    # URL validation
+    url:
+      require_https: true
+      allowed_protocols:
+        - "https"
+        - "http"  # Only for development
+      validate_domain: false
+
+    # Phone validation
+    phone:
+      formats:
+        - "+1XXXXXXXXXX"
+        - "XXX-XXX-XXXX"
+      normalize: true
+
+  # ==========================================
+  # FILE VALIDATION
+  # ==========================================
+
+  files:
+    uploads:
+      max_size: "10mb"
+      allowed_types:
+        images:
+          - "image/jpeg"
+          - "image/png"
+          - "image/gif"
+          - "image/webp"
+        documents:
+          - "application/pdf"
+          - "application/msword"
+          - "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+      scan_for_malware: true
+      sanitize_filenames: true
+
+  # ==========================================
+  # DATABASE VALIDATION
+  # ==========================================
+
+  database:
+    # Query validation
+    queries:
+      max_results: 1000
+      require_pagination: true
+      timeout_ms: 30000
+
+    # Data validation
+    data:
+      sanitize_inputs: true
+      validate_foreign_keys: true
+      check_constraints: true
+
+  # ==========================================
+  # BUSINESS RULES
+  # ==========================================
+
+  business:
+    # User limits
+    users:
+      max_username_length: 30
+      min_username_length: 3
+      username_pattern: "^[a-zA-Z0-9_]+$"
+
+    # Content limits
+    content:
+      max_title_length: 200
+      max_description_length: 2000
+      max_tags: 10
+
+    # Rate limits
+    rates:
+      max_requests_per_minute: 60
+      max_uploads_per_day: 100
+
+  # ==========================================
+  # CUSTOM VALIDATORS
+  # ==========================================
+
+  custom:
+    # Example: Validate product SKU format
+    - name: "product_sku"
+      pattern: "^[A-Z]{3}-[0-9]{6}$"
+      message: "SKU must be in format XXX-000000"
+
+    # Example: Validate order ID
+    - name: "order_id"
+      pattern: "^ORD-[0-9]{8}-[A-Z0-9]{4}$"
+      message: "Invalid order ID format"
+
+# ==========================================
+# VALIDATION SETTINGS
+# ==========================================
+
+settings:
+  # Error handling
+  on_validation_error:
+    log: true
+    response_code: 400
+    include_details: true  # Set false in production
+
+  # Sanitization
+  sanitization:
+    trim_strings: true
+    normalize_unicode: true
+    remove_null_bytes: true
+
+  # Localization
+  messages:
+    language: "en"
+    custom_messages_file: "validation-messages.json"