proagents 1.0.0

package/proagents/config/integrations/github.yaml

@@ -0,0 +1,211 @@
+# GitHub Integration Configuration
+# Copy these settings to your proagents.config.yaml under 'integrations.github'
+
+# =============================================================================
+# BASIC CONFIGURATION
+# =============================================================================
+
+github:
+  enabled: true
+
+  # Repository Settings
+  repository:
+    owner: "your-org"            # GitHub org or username
+    name: "your-repo"            # Repository name
+    default_branch: "main"       # main | master
+
+  # Authentication
+  # Set in .env: GITHUB_TOKEN=ghp_xxx
+  # Required scopes: repo, workflow (for actions)
+
+# =============================================================================
+# BRANCH CONFIGURATION
+# =============================================================================
+
+  branches:
+    # Branch naming pattern
+    pattern: "{{type}}/{{name}}"  # e.g., feature/user-auth
+
+    # Branch types
+    types:
+      feature: "feature"
+      bug_fix: "fix"
+      quick_change: "hotfix"
+      refactoring: "refactor"
+
+    # Branch protection
+    protection:
+      require_pr: true
+      require_reviews: 1
+      require_ci_pass: true
+
+# =============================================================================
+# PULL REQUESTS
+# =============================================================================
+
+  pull_requests:
+    # Auto-create PR when implementation complete
+    auto_create: true
+
+    # PR settings
+    settings:
+      draft: false               # Create as draft PR
+      auto_merge: false          # Enable auto-merge
+      delete_branch_on_merge: true
+
+    # Default reviewers
+    reviewers:
+      auto_assign: true
+      # Assign based on CODEOWNERS or specify
+      # default: ["reviewer1", "reviewer2"]
+
+    # Labels to add automatically
+    labels:
+      feature: ["enhancement"]
+      bug_fix: ["bug"]
+      quick_change: ["maintenance"]
+
+    # PR template (uses your existing template or this)
+    template: |
+      ## Summary
+      {{summary}}
+
+      ## Changes
+      {{changes}}
+
+      ## Test Plan
+      {{test_plan}}
+
+      ## Checklist
+      - [ ] Tests added/updated
+      - [ ] Documentation updated
+      - [ ] No breaking changes
+
+      ---
+      Generated by ProAgents
+
+# =============================================================================
+# ISSUES INTEGRATION
+# =============================================================================
+
+  issues:
+    # Sync with GitHub Issues
+    enabled: true
+
+    # Create GitHub issue for features
+    create_on_feature_start: false  # Usually use Jira/Linear instead
+
+    # Link PR to issue
+    link_pr_to_issue: true
+
+    # Close issue on merge
+    close_on_merge: true
+
+    # Labels
+    labels:
+      feature: ["enhancement", "proagents"]
+      bug_fix: ["bug", "proagents"]
+
+# =============================================================================
+# GITHUB ACTIONS
+# =============================================================================
+
+  actions:
+    # Wait for CI checks
+    wait_for_checks: true
+
+    # Required checks before merge
+    required_checks:
+      - "test"
+      - "lint"
+      - "build"
+
+    # Timeout for checks (minutes)
+    check_timeout: 30
+
+    # Trigger workflows
+    trigger_on:
+      pr_created: true
+      pr_merged: true
+
+# =============================================================================
+# RELEASES
+# =============================================================================
+
+  releases:
+    # Auto-create release on deployment
+    auto_create: true
+
+    # Tag format
+    tag_format: "v{{version}}"
+
+    # Generate release notes from commits
+    auto_notes: true
+
+    # Release types
+    types:
+      major: "Breaking changes"
+      minor: "New features"
+      patch: "Bug fixes"
+
+# =============================================================================
+# WEBHOOKS
+# =============================================================================
+
+  webhooks:
+    # Receive GitHub events
+    enabled: false
+
+    # Events to subscribe
+    events:
+      - push
+      - pull_request
+      - check_run
+      - deployment
+
+    # Webhook secret (for validation)
+    # Set in .env: GITHUB_WEBHOOK_SECRET=xxx
+
+# =============================================================================
+# COMMIT SETTINGS
+# =============================================================================
+
+  commits:
+    # Commit message format
+    convention: "conventional"  # conventional | simple
+
+    # Sign commits (requires GPG setup)
+    sign: false
+
+    # Co-author attribution
+    co_author: "ProAgents <proagents@example.com>"
+
+    # Commit message templates
+    templates:
+      feature: "feat({{scope}}): {{message}}"
+      fix: "fix({{scope}}): {{message}}"
+      docs: "docs({{scope}}): {{message}}"
+      refactor: "refactor({{scope}}): {{message}}"
+
+# =============================================================================
+# EXAMPLE USAGE
+# =============================================================================
+
+# After configuration:
+#
+# 1. Feature starts:
+#    /feature start "Add OAuth login"
+#    → Creates branch: feature/add-oauth-login
+#    → Commits follow conventional format
+#
+# 2. Implementation complete:
+#    /feature review
+#    → Creates PR with template
+#    → Assigns reviewers
+#    → Adds labels
+#    → Links to tracking issue
+#
+# 3. PR merged:
+#    → Branch deleted
+#    → Related issues closed
+#    → Release created (if configured)

package/proagents/config/integrations/jira.yaml

@@ -0,0 +1,144 @@
+# Jira Integration Configuration
+# Copy these settings to your proagents.config.yaml under 'integrations.jira'
+
+# =============================================================================
+# BASIC CONFIGURATION
+# =============================================================================
+
+jira:
+  enabled: true
+
+  # Connection Settings
+  connection:
+    base_url: "https://your-company.atlassian.net"  # Your Jira instance URL
+    api_version: "3"  # Jira Cloud API version
+
+    # Authentication (use environment variables!)
+    auth:
+      type: "api_token"  # api_token | oauth | basic
+      # Set these in .env file:
+      # JIRA_EMAIL=your-email@company.com
+      # JIRA_API_TOKEN=your-api-token
+
+  # Project Settings
+  project:
+    key: "PROJ"                    # Your Jira project key
+    default_issue_type: "Story"    # Story | Bug | Task | etc.
+    default_priority: "Medium"     # Highest | High | Medium | Low | Lowest
+
+# =============================================================================
+# ISSUE MAPPING
+# =============================================================================
+
+  # Map ProAgents modes to Jira issue types
+  issue_types:
+    feature: "Story"
+    bug_fix: "Bug"
+    quick_change: "Task"
+    refactoring: "Task"
+
+  # Custom field mappings
+  custom_fields:
+    # Map ProAgents data to Jira custom fields
+    # Format: jira_field_id: proagents_source
+    feature_branch: "customfield_10001"
+    pr_link: "customfield_10002"
+    test_coverage: "customfield_10003"
+
+# =============================================================================
+# WORKFLOW SYNC
+# =============================================================================
+
+  # Map ProAgents phases to Jira transitions
+  transitions:
+    # When ProAgents enters a phase, transition Jira to corresponding status
+    analysis_start: "In Progress"
+    implementation_start: "In Development"
+    testing_start: "In Testing"
+    code_review_start: "In Review"
+    deployment_start: "Deploying"
+    complete: "Done"
+    blocked: "Blocked"
+
+  # Auto-create issues
+  auto_create:
+    on_feature_start: true
+    include_requirements: true
+    include_acceptance_criteria: true
+
+  # Auto-update issues
+  auto_update:
+    on_phase_change: true
+    on_commit: false  # Can be noisy
+    on_pr_create: true
+    on_deployment: true
+
+# =============================================================================
+# COMMENTS AND LOGGING
+# =============================================================================
+
+  comments:
+    # Add comments to Jira issues during workflow
+    on_analysis_complete: true
+    on_implementation_complete: true
+    on_test_results: true
+    on_deployment: true
+
+    # Comment format
+    format: "markdown"  # markdown | plain
+
+    # Include details in comments
+    include:
+      - commit_links
+      - pr_links
+      - test_coverage
+      - deployment_url
+
+# =============================================================================
+# SPRINT INTEGRATION
+# =============================================================================
+
+  sprints:
+    enabled: true
+
+    # Auto-assign new issues to current sprint
+    auto_assign_sprint: true
+
+    # Sprint field (usually standard, but can be custom)
+    sprint_field: "customfield_10020"
+
+# =============================================================================
+# NOTIFICATIONS
+# =============================================================================
+
+  notifications:
+    # Notify watchers
+    notify_watchers: true
+
+    # Add mentions
+    mention_on:
+      - deployment
+      - blocker
+
+# =============================================================================
+# EXAMPLE USAGE
+# =============================================================================
+
+# After configuration, ProAgents will:
+#
+# 1. Create Jira issue when you start a feature:
+#    /feature start "Add user authentication"
+#    → Creates PROJ-123: Add user authentication
+#
+# 2. Update Jira as you progress:
+#    Phase: Analysis → Jira: In Progress
+#    Phase: Implementation → Jira: In Development
+#    Phase: Testing → Jira: In Testing
+#
+# 3. Add comments with details:
+#    "Analysis completed. See requirements: [link]"
+#    "PR created: #456. Ready for review."
+#
+# 4. Complete when done:
+#    /feature complete
+#    → Jira: Done, with full summary

package/proagents/config/integrations/linear.yaml

@@ -0,0 +1,157 @@
+# Linear Integration Configuration
+# Copy these settings to your proagents.config.yaml under 'integrations.linear'
+
+# =============================================================================
+# BASIC CONFIGURATION
+# =============================================================================
+
+linear:
+  enabled: true
+
+  # Connection Settings
+  connection:
+    # Authentication (use environment variables!)
+    # Set in .env: LINEAR_API_KEY=lin_api_xxx
+    api_url: "https://api.linear.app/graphql"
+
+  # Team Settings
+  team:
+    id: "TEAM-123"              # Your Linear team ID
+    key: "ENG"                  # Team key prefix for issues
+
+# =============================================================================
+# ISSUE CONFIGURATION
+# =============================================================================
+
+  # Default settings for new issues
+  defaults:
+    priority: 2                  # 0=No Priority, 1=Urgent, 2=High, 3=Normal, 4=Low
+    estimate: null               # Story points (null = unestimated)
+
+  # Map ProAgents modes to Linear labels
+  labels:
+    feature: "feature"
+    bug_fix: "bug"
+    quick_change: "chore"
+    refactoring: "refactor"
+
+  # Project assignment
+  projects:
+    auto_assign: true
+    # Map features to projects by pattern
+    mapping:
+      "auth*": "project_auth_id"
+      "payment*": "project_payments_id"
+      "*": "project_default_id"      # Fallback
+
+# =============================================================================
+# WORKFLOW SYNC
+# =============================================================================
+
+  # Map ProAgents phases to Linear workflow states
+  workflow_states:
+    # Format: proagents_phase: linear_state_name
+    pending: "Backlog"
+    analysis_start: "In Progress"
+    implementation_start: "In Progress"
+    testing_start: "In Review"
+    code_review_start: "In Review"
+    complete: "Done"
+    cancelled: "Canceled"
+
+  # Auto-sync settings
+  sync:
+    # Create Linear issue when feature starts
+    create_on_start: true
+
+    # Update Linear status with phase changes
+    update_on_phase: true
+
+    # Add comments for key events
+    comment_on:
+      - analysis_complete
+      - pr_created
+      - tests_passed
+      - deployed
+
+    # Link to GitHub PRs
+    link_github_prs: true
+
+# =============================================================================
+# CYCLE (SPRINT) INTEGRATION
+# =============================================================================
+
+  cycles:
+    enabled: true
+
+    # Auto-assign to current cycle
+    auto_assign_current: true
+
+    # Include in cycle reports
+    include_in_reports: true
+
+# =============================================================================
+# BIDIRECTIONAL SYNC
+# =============================================================================
+
+  bidirectional:
+    enabled: true
+
+    # If issue is updated in Linear, reflect in ProAgents
+    sync_from_linear:
+      priority: true
+      assignee: true
+      labels: true
+      due_date: true
+
+    # Conflict resolution
+    conflict_resolution: "linear_wins"  # linear_wins | proagents_wins | newest
+
+# =============================================================================
+# COMMENTS AND UPDATES
+# =============================================================================
+
+  comments:
+    # Format for automated comments
+    format: "markdown"
+
+    # Templates
+    templates:
+      analysis_complete: |
+        **Analysis Complete**
+        - Requirements documented
+        - Implementation plan ready
+        - Estimated effort: {{estimate}}
+
+      pr_created: |
+        **Pull Request Created**
+        [PR #{{pr_number}}]({{pr_url}})
+        - Branch: `{{branch}}`
+        - Changes: {{files_changed}} files
+
+      deployed: |
+        **Deployed to {{environment}}**
+        - Commit: {{commit_sha}}
+        - URL: {{deployment_url}}
+
+# =============================================================================
+# EXAMPLE USAGE
+# =============================================================================
+
+# After configuration:
+#
+# 1. Start feature:
+#    /feature start "Add dark mode"
+#    → Creates ENG-456: Add dark mode
+#    → Assigns to current cycle
+#    → Sets status: In Progress
+#
+# 2. Automatic updates as you work:
+#    - Comments added for milestones
+#    - PR automatically linked
+#    - Status updated with phases
+#
+# 3. View in Linear:
+#    - Full history in activity feed
+#    - Links to code and PRs
+#    - Cycle velocity tracking

package/proagents/config/integrations/notion.yaml

@@ -0,0 +1,203 @@
+# Notion Integration Configuration
+# Copy these settings to your proagents.config.yaml under 'integrations.notion'
+
+# =============================================================================
+# BASIC CONFIGURATION
+# =============================================================================
+
+notion:
+  enabled: true
+
+  # Authentication
+  # Set in .env: NOTION_API_KEY=secret_xxx
+  # Create integration at: https://www.notion.so/my-integrations
+
+# =============================================================================
+# DATABASE CONFIGURATION
+# =============================================================================
+
+  databases:
+    # Features/Tasks database
+    features:
+      id: "your-database-id"  # From database URL
+      properties:
+        # Map ProAgents fields to Notion properties
+        title: "Name"           # Title property
+        status: "Status"        # Select property
+        phase: "Phase"          # Select property
+        developer: "Assignee"   # Person property
+        branch: "Branch"        # Text property
+        pr_url: "PR Link"       # URL property
+        created: "Created"      # Date property
+
+    # Documentation database (optional)
+    documentation:
+      id: "your-docs-database-id"
+      properties:
+        title: "Title"
+        category: "Category"
+        last_updated: "Last Updated"
+
+    # Changelog database (optional)
+    changelog:
+      id: "your-changelog-database-id"
+      properties:
+        title: "Change"
+        type: "Type"
+        date: "Date"
+        commit: "Commit"
+
+# =============================================================================
+# SYNC SETTINGS
+# =============================================================================
+
+  sync:
+    # What to sync
+    features:
+      enabled: true
+      create_on_start: true
+      update_on_phase: true
+
+    documentation:
+      enabled: true
+      # Sync generated docs to Notion
+      auto_sync: true
+      # Sync on these events
+      sync_on:
+        - feature_complete
+        - documentation_update
+
+    changelog:
+      enabled: true
+      # Create entry for each change
+      auto_create: true
+
+# =============================================================================
+# STATUS MAPPING
+# =============================================================================
+
+  status_mapping:
+    # Map ProAgents phases to Notion status options
+    pending: "Not Started"
+    analysis: "Planning"
+    requirements: "Planning"
+    design: "Planning"
+    implementation: "In Progress"
+    testing: "In Progress"
+    review: "In Review"
+    documentation: "In Review"
+    deployment: "Deploying"
+    complete: "Done"
+    blocked: "Blocked"
+
+# =============================================================================
+# CONTENT TEMPLATES
+# =============================================================================
+
+  templates:
+    # Page content for new features
+    feature_page: |
+      ## Overview
+      {{description}}
+
+      ## Requirements
+      {{requirements}}
+
+      ## Implementation Plan
+      {{implementation_plan}}
+
+      ## Progress
+      - [ ] Analysis
+      - [ ] Design
+      - [ ] Implementation
+      - [ ] Testing
+      - [ ] Review
+      - [ ] Documentation
+
+      ## Links
+      - Branch: `{{branch}}`
+      - PR: {{pr_url}}
+
+      ---
+      *Generated by ProAgents*
+
+    # Documentation page template
+    documentation_page: |
+      # {{title}}
+
+      {{content}}
+
+      ---
+      Last updated: {{date}}
+      Generated by ProAgents
+
+# =============================================================================
+# PAGE STRUCTURE
+# =============================================================================
+
+  pages:
+    # Where to create feature pages
+    features_parent: "your-parent-page-id"
+
+    # Documentation structure
+    docs_parent: "your-docs-page-id"
+
+    # Include sub-pages
+    include_subpages: true
+
+# =============================================================================
+# BIDIRECTIONAL SYNC
+# =============================================================================
+
+  bidirectional:
+    enabled: false  # Enable to sync changes FROM Notion
+
+    # What to sync back
+    sync_from_notion:
+      status: true
+      assignee: true
+      priority: false
+
+    # Polling interval (Notion doesn't have webhooks)
+    poll_interval_minutes: 5
+
+# =============================================================================
+# BLOCKS AND FORMATTING
+# =============================================================================
+
+  formatting:
+    # Use Notion blocks for rich content
+    use_blocks: true
+
+    # Convert markdown to Notion blocks
+    convert_markdown: true
+
+    # Code block language detection
+    auto_detect_language: true
+
+    # Table of contents
+    include_toc: true
+
+# =============================================================================
+# EXAMPLE USAGE
+# =============================================================================
+
+# After configuration:
+#
+# 1. Feature starts:
+#    → New page created in Features database
+#    → Status: "Planning"
+#    → Content from template
+#
+# 2. Phase changes:
+#    → Status property updated
+#    → Progress checkboxes updated
+#
+# 3. Documentation generated:
+#    → New page in Docs database
+#    → Linked to feature page
+#
+# 4. Feature complete:
+#    → Status: "Done"
+#    → Changelog entry created
+#    → Links added (PR, deployment)