proagents 1.0.0

package/proagents/integrations/README.md

@@ -0,0 +1,97 @@
+# Integrations
+
+Third-party tool integrations for ProAgents.
+
+---
+
+## Overview
+
+ProAgents integrates with various development tools to provide a seamless workflow experience.
+
+---
+
+## Available Integrations
+
+| Category | Tools | Documentation |
+|----------|-------|---------------|
+| **Project Management** | Jira, Linear, Asana, Trello, Notion | [PM Integrations](./pm/) |
+| **Version Control** | GitHub, GitLab | [Config](../config/integrations/) |
+| **Communication** | Slack | [Config](../config/integrations/slack.yaml) |
+
+---
+
+## Quick Links
+
+### Configuration Files
+
+All integration configurations are in [`config/integrations/`](../config/integrations/):
+
+| File | Purpose |
+|------|---------|
+| [github.yaml](../config/integrations/github.yaml) | GitHub integration |
+| [jira.yaml](../config/integrations/jira.yaml) | Jira integration |
+| [linear.yaml](../config/integrations/linear.yaml) | Linear integration |
+| [notion.yaml](../config/integrations/notion.yaml) | Notion integration |
+| [slack.yaml](../config/integrations/slack.yaml) | Slack integration |
+
+### Detailed Guides
+
+| Guide | Description |
+|-------|-------------|
+| [PM Integration Setup](../getting-started/pm-integration.md) | Getting started with PM tools |
+| [PM Directory](./pm/) | Detailed PM integration docs |
+
+---
+
+## Setting Up Integrations
+
+### 1. Choose Your Tools
+
+Identify which tools your team uses:
+- Project management (Jira, Linear, etc.)
+- Communication (Slack)
+- Version control (GitHub, GitLab)
+
+### 2. Configure Integration
+
+Copy and customize the configuration:
+
+```bash
+# View available configs
+ls proagents/config/integrations/
+
+# Edit for your project
+vim proagents/config/integrations/jira.yaml
+```
+
+### 3. Add Credentials
+
+Set up environment variables:
+
+```bash
+# .env or environment
+JIRA_API_TOKEN=your-token
+SLACK_WEBHOOK_URL=your-webhook
+GITHUB_TOKEN=your-token
+```
+
+### 4. Enable in Config
+
+```yaml
+# proagents.config.yaml
+integrations:
+  jira:
+    enabled: true
+  slack:
+    enabled: true
+  github:
+    enabled: true
+```
+
+---
+
+## Related Resources
+
+- [Configuration Guide](../config/README.md)
+- [PM Integration Guide](./pm/)
+- [Getting Started](../getting-started/)

package/proagents/integrations/pm/README.md

@@ -0,0 +1,344 @@
+# Project Management Integrations
+
+Detailed guides for integrating ProAgents with project management tools.
+
+---
+
+## Supported Tools
+
+| Tool | Status | Configuration |
+|------|--------|---------------|
+| [Jira](#jira) | Full Support | [jira.yaml](../../config/integrations/jira.yaml) |
+| [Linear](#linear) | Full Support | [linear.yaml](../../config/integrations/linear.yaml) |
+| [GitHub Issues](#github-issues) | Full Support | [github.yaml](../../config/integrations/github.yaml) |
+| [GitLab Issues](#gitlab-issues) | Full Support | Via GitLab API |
+| [Asana](#asana) | Supported | Custom config |
+| [Trello](#trello) | Supported | Custom config |
+| [Notion](#notion) | Supported | [notion.yaml](../../config/integrations/notion.yaml) |
+
+---
+
+## Jira
+
+### Setup
+
+1. **Get API Token**
+   - Go to [Atlassian Account Settings](https://id.atlassian.com/manage-profile/security/api-tokens)
+   - Create new API token
+   - Save securely
+
+2. **Configure ProAgents**
+
+```yaml
+# proagents.config.yaml
+integrations:
+  jira:
+    enabled: true
+    base_url: "https://your-org.atlassian.net"
+    project_key: "PROJ"
+
+    # Feature sync
+    auto_create_issues: true
+    auto_update_status: true
+
+    # Status mapping
+    transition_mapping:
+      analysis_complete: "In Progress"
+      implementation_complete: "In Review"
+      deployed: "Done"
+```
+
+3. **Set Environment Variables**
+
+```bash
+JIRA_EMAIL=your-email@company.com
+JIRA_API_TOKEN=your-api-token
+```
+
+### Features
+
+- **Auto-create issues** when features start
+- **Status sync** as workflow progresses
+- **Link PRs** to Jira issues
+- **Time logging** for phases
+
+### Detailed Config
+
+See [config/integrations/jira.yaml](../../config/integrations/jira.yaml) for full options.
+
+---
+
+## Linear
+
+### Setup
+
+1. **Get API Key**
+   - Linear Settings → API → Personal API keys
+   - Create new key
+
+2. **Configure ProAgents**
+
+```yaml
+# proagents.config.yaml
+integrations:
+  linear:
+    enabled: true
+    team_id: "TEAM-123"
+
+    auto_link_prs: true
+    sync_status: true
+```
+
+3. **Set Environment Variables**
+
+```bash
+LINEAR_API_KEY=your-api-key
+```
+
+### Features
+
+- **Bi-directional sync** with Linear issues
+- **Auto-link PRs** to issues
+- **Label management** based on workflow phase
+- **Priority mapping**
+
+### Detailed Config
+
+See [config/integrations/linear.yaml](../../config/integrations/linear.yaml) for full options.
+
+---
+
+## GitHub Issues
+
+### Setup
+
+1. **Get Personal Access Token**
+   - GitHub Settings → Developer settings → Personal access tokens
+   - Create token with `repo` scope
+
+2. **Configure ProAgents**
+
+```yaml
+# proagents.config.yaml
+integrations:
+  github:
+    enabled: true
+
+    issues:
+      auto_create: true
+      auto_close: true
+      labels_from_workflow: true
+
+    pull_requests:
+      auto_create: true
+      template: true
+```
+
+3. **Set Environment Variables**
+
+```bash
+GITHUB_TOKEN=your-token
+```
+
+### Features
+
+- **Issue creation** for features
+- **Auto-close issues** on deployment
+- **PR templates** from workflow
+- **Label automation**
+
+### Detailed Config
+
+See [config/integrations/github.yaml](../../config/integrations/github.yaml) for full options.
+
+---
+
+## GitLab Issues
+
+### Setup
+
+Similar to GitHub, using GitLab API tokens.
+
+```yaml
+integrations:
+  gitlab:
+    enabled: true
+    project_id: "12345"
+    auto_create_issues: true
+```
+
+```bash
+GITLAB_TOKEN=your-token
+GITLAB_URL=https://gitlab.com  # or self-hosted URL
+```
+
+---
+
+## Asana
+
+### Setup
+
+```yaml
+integrations:
+  asana:
+    enabled: true
+    workspace_id: "your-workspace-id"
+    project_id: "your-project-id"
+```
+
+```bash
+ASANA_ACCESS_TOKEN=your-token
+```
+
+### Features
+
+- Task creation and tracking
+- Section-based status management
+- Due date synchronization
+
+---
+
+## Trello
+
+### Setup
+
+```yaml
+integrations:
+  trello:
+    enabled: true
+    board_id: "your-board-id"
+
+    list_mapping:
+      backlog: "Backlog"
+      in_progress: "In Progress"
+      review: "Review"
+      done: "Done"
+```
+
+```bash
+TRELLO_API_KEY=your-key
+TRELLO_TOKEN=your-token
+```
+
+### Features
+
+- Card creation for features
+- List-based status tracking
+- Label automation
+
+---
+
+## Notion
+
+### Setup
+
+1. **Create Integration**
+   - [Notion Integrations](https://www.notion.so/my-integrations)
+   - Create new integration
+   - Share database with integration
+
+2. **Configure ProAgents**
+
+```yaml
+integrations:
+  notion:
+    enabled: true
+    database_id: "your-database-id"
+    sync_documentation: true
+```
+
+3. **Set Environment Variables**
+
+```bash
+NOTION_API_KEY=your-integration-token
+```
+
+### Features
+
+- **Database sync** for features
+- **Documentation sync** to Notion pages
+- **Status property** updates
+- **Rich content** support
+
+### Detailed Config
+
+See [config/integrations/notion.yaml](../../config/integrations/notion.yaml) for full options.
+
+---
+
+## Common Patterns
+
+### Status Synchronization
+
+All PM tools follow similar status mapping:
+
+| ProAgents Phase | Typical PM Status |
+|-----------------|-------------------|
+| Analysis | Backlog / To Do |
+| Design | In Progress |
+| Implementation | In Progress |
+| Testing | In Review |
+| Deployed | Done |
+
+### Environment Variables
+
+Best practices for credentials:
+
+```bash
+# .env.local (not committed)
+JIRA_API_TOKEN=xxx
+LINEAR_API_KEY=xxx
+GITHUB_TOKEN=xxx
+
+# Or use secrets manager
+# AWS Secrets Manager, HashiCorp Vault, etc.
+```
+
+### Webhooks
+
+For real-time updates, configure webhooks:
+
+```yaml
+webhooks:
+  enabled: true
+  events:
+    - feature_started
+    - feature_completed
+    - deployment_success
+    - deployment_failure
+```
+
+---
+
+## Troubleshooting
+
+### Connection Issues
+
+1. Verify API credentials
+2. Check network/firewall
+3. Ensure correct base URL
+4. Verify permissions
+
+### Sync Issues
+
+1. Check status mapping configuration
+2. Verify project/board IDs
+3. Check webhook delivery
+4. Review error logs
+
+### Rate Limiting
+
+Most APIs have rate limits:
+- Jira: 100 requests/minute
+- Linear: 1000 requests/hour
+- GitHub: 5000 requests/hour
+
+ProAgents handles rate limiting automatically.
+
+---
+
+## Related Resources
+
+- [Getting Started with PM Integration](../../getting-started/pm-integration.md)
+- [Configuration Reference](../../config/README.md)
+- [Sync Configuration](../../pm-integration/)

package/proagents/learning/README.md

@@ -0,0 +1,136 @@
+# ProAgents Self-Learning System
+
+ProAgents learns from your usage and adapts to your project and preferences over time.
+
+## How It Works
+
+### 1. What Gets Learned
+
+**User Preferences:**
+- Which checkpoints you usually skip
+- Which ones you always review
+- Your preferred detail level
+- Common corrections you make
+
+**Project Patterns:**
+- Code conventions (naming, formatting)
+- Architecture patterns
+- State management approach
+- API patterns
+- Testing patterns
+
+**Feature History:**
+- Completed features and their outcomes
+- Issues encountered and resolutions
+- Time spent on each phase
+
+### 2. Learning Storage
+
+```
+/proagents/.learning/
+├── global/                    # Cross-project learnings
+│   └── user-preferences.json
+└── projects/                  # Per-project learnings
+    └── [project-hash]/
+        ├── patterns.json
+        ├── corrections.json
+        └── metrics.json
+```
+
+### 3. How Learnings Are Applied
+
+**Automatic Behavior:**
+- Skip checkpoints you usually skip
+- Apply corrections you've made 3+ times
+- Follow code patterns from existing codebase
+- Use preferred naming conventions
+
+**Example:**
+
+*Before learning:*
+```
+AI: "What state management should we use?"
+User: "Use Zustand"
+```
+
+*After learning:*
+```
+AI: "I see this project uses Zustand for state management.
+     I'll follow that pattern."
+```
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+learning:
+  enabled: true
+  track_preferences: true
+  track_patterns: true
+  track_corrections: true
+  auto_apply_corrections: true
+  auto_adjust_checkpoints: true
+```
+
+## Feedback Collection
+
+### Implicit Feedback
+- Modifications to AI output
+- Skipped phases/checkpoints
+- Time spent reviewing
+
+### Explicit Feedback
+At end of each feature:
+```
+"How was this workflow?"
+[Good] [Needs improvement] [Suggestions]
+```
+
+## Privacy
+
+- All learning data is stored locally
+- Nothing is sent to external servers
+- You can delete learning data at any time:
+  ```
+  rm -rf /proagents/.learning/
+  ```
+
+## Resetting Learnings
+
+```bash
+# Reset all learnings
+proagents learning reset
+
+# Reset specific category
+proagents learning reset --preferences
+proagents learning reset --patterns
+```
+
+## Learning Reports
+
+View what's been learned:
+
+```bash
+proagents learning report
+```
+
+Output:
+```
+ProAgents Learning Report
+=========================
+Patterns Learned: 45
+Auto-corrections: 23
+Checkpoints optimized: 12
+
+Top Patterns:
+- Component naming: PascalCase
+- State management: Zustand
+- API calls: React Query
+```
+
+## Files
+
+- [data-collection.md](./data-collection.md) - What data is collected
+- [adaptation.md](./adaptation.md) - How learnings are applied
+- [reports.md](./reports.md) - Learning report formats
+- [implementation-guide.md](./implementation-guide.md) - Technical implementation guide