README.md

PM33 Integration Examples

Enterprise-grade PM tool integration patterns and examples, extracted from PM33's PMO transformation platform.

🎯 Overview

This repository showcases production-tested patterns for integrating with popular PM tools like Jira, Linear, Monday, and Asana. These patterns power PM33's agentic AI teams that transform individual PMs into fully functional PMOs.

Key Features

• 🔒 Multi-tenant Architecture: Organization-isolated data access
• ⚡ Enterprise Rate Limiting: Production-tested rate limiting strategies
• 🧠 Intelligent Field Mapping: AI-powered field mapping with confidence scoring
• 🔄 Robust Error Handling: Comprehensive error recovery and retry logic
• 📊 Real-time Monitoring: Performance metrics and health monitoring
• 🚀 Scalable Design: Battle-tested in production environments

📁 Repository Structure

pm33-integration-examples/
├── jira/                          # Jira integration patterns
│   ├── client/                    # API client implementation
│   ├── field-mapping/             # Intelligent field mapping
│   ├── rate-limiting/             # Rate limiting strategies
│   └── examples/                  # Complete integration examples
├── linear/                        # Linear integration patterns
├── monday/                        # Monday.com integration patterns
├── asana/                         # Asana integration patterns
├── common/                        # Shared utilities and patterns
│   ├── auth/                      # Authentication patterns
│   ├── error-handling/            # Error recovery strategies
│   ├── rate-limiting/             # Universal rate limiting
│   └── testing/                   # Integration testing patterns
├── docs/                          # Documentation and guides
└── examples/                      # End-to-end integration examples

🚀 Quick Start

Prerequisites

• Node.js 18+ with TypeScript
• Redis (for rate limiting and caching)
• API credentials for your PM tool

Installation

# Clone the repository
git clone https://github.com/your-org/pm33-integration-examples.git
cd pm33-integration-examples

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local

Basic Jira Integration Example

import { JiraApiClient, createJiraClient } from './jira/client'

// Create enterprise-grade Jira client
const jiraClient = createJiraClient({
  baseUrl: 'https://your-domain.atlassian.net',
  authType: 'token',
  username: 'your-email@company.com',
  apiToken: 'your-api-token',
  id: 'jira-prod'
}, 'your-organization-id')

// Test connection
const { success, serverInfo } = await jiraClient.testConnection()
console.log('Jira connection:', success ? '✅' : '❌')

// Fetch projects with automatic rate limiting
const projects = await jiraClient.getProjects()
console.log(`Found ${projects.length} projects`)

// Advanced search with field mapping
const { issues, total } = await jiraClient.searchIssues(
  'project = "PROJ" AND updated >= -7d',
  0, 50, ['summary', 'status', 'assignee']
)

🔧 Integration Patterns

1. Multi-Tenant Authentication

All clients include organization-level isolation for enterprise security:

// ✅ Correct: Organization-isolated client
const client = createJiraClient(config, 'org-12345')

// ❌ Wrong: Global client without isolation  
const client = new JiraApiClient(config)

2. Intelligent Rate Limiting

Production-tested rate limiting that adapts to different PM tool APIs:

const rateLimits = {
  'cloud': {
    requestsPerSecond: 10,
    requestsPerHour: 3600,
    burstLimit: 20,
    concurrentRequests: 5
  }
}

3. Field Mapping with Confidence Scoring

AI-powered field mapping that learns and adapts:

const fieldMapping = await mapFields(sourceFields, targetFields)
// Returns: { mappings: [...], confidence: 0.89, suggestions: [...] }

📋 Available Integrations

Tool	Status	Client	Field Mapping	Rate Limiting	Examples
Jira	✅ Complete	✅	✅	✅	✅
Linear	🔄 In Progress	⏳	⏳	✅	⏳
Monday	📋 Planned	⏳	⏳	✅	⏳
Asana	📋 Planned	⏳	⏳	✅	⏳

📖 Documentation

• Integration Patterns Guide - Core patterns and best practices
• Authentication Guide - Multi-tenant auth implementation
• Rate Limiting Guide - Production rate limiting strategies
• Field Mapping Guide - AI-powered field mapping
• Testing Guide - Integration testing patterns
• Deployment Guide - Production deployment patterns

🤝 Contributing

We welcome contributions! These patterns are battle-tested in PM33's production environment serving enterprise customers.

Development Setup

# Install dependencies
npm install

# Run tests
npm test

# Run linting
npm run lint

# Type checking
npm run type-check

Guidelines

• All code must include comprehensive TypeScript types
• Integration patterns must be multi-tenant by default
• Include rate limiting for all external API calls
• Add comprehensive error handling and recovery
• Document with real-world examples

🏢 About PM33

PM33 transforms individual Product Managers into fully functional PMOs through agentic AI teams. Our platform provides PMO-level strategic capabilities including:

• Strategic Intelligence AI Team: Market analysis and competitive positioning
• Workflow Execution AI Team: Automated task management and PM tool integration
• Data Intelligence AI Team: Historical pattern recognition and predictive analytics
• Communication AI Team: Stakeholder alignment and executive reporting

Learn more: pm-33.com

📄 License

MIT License - see LICENSE for details.

🔗 Links

• PM33 Platform: https://pm-33.io
• Documentation: https://docs.pm-33.com
• Community: https://community.pm-33.com

---

Built with ❤️ by the PM33 team. Empowering Product Managers with PMO-level capabilities through agentic AI.