claude-autopm 1.15.2 → 1.15.3

package/autopm/.claude/mcp/context7.md

@@ -0,0 +1,205 @@
+---
+name: context7
+command: npx
+args: ["-y", "@upstash/context7-mcp"]
+description: MCP server for Context7 - Up-to-date documentation database
+category: documentation
+status: inactive
+env:
+  DEFAULT_MINIMUM_TOKENS: "${DEFAULT_MINIMUM_TOKENS:-10000}"
+---
+
+# Context7 MCP Server
+
+Official MCP server for [Context7](https://context7.com) - provides up-to-date documentation for libraries and frameworks.
+
+## 🎯 Features
+
+- **Up-to-date Documentation**: Always current library documentation
+- **Smart Search**: Resolve library names to Context7 IDs
+- **Token Control**: Configure minimum tokens for documentation retrieval
+- **Multi-library Support**: Access documentation for any supported library
+
+## 📦 Installation
+
+### Option 1: Using AutoPM (Recommended)
+
+```bash
+# Install from npm with automatic configuration
+autopm mcp install @upstash/context7-mcp --enable
+
+# Configure API key
+echo "CONTEXT7_API_KEY=your-key-here" >> .claude/.env
+
+# Test connection
+autopm mcp test context7
+```
+
+### Option 2: Manual Setup
+
+```bash
+# Copy this example to your project
+cp .claude/examples/mcp/context7.md .claude/mcp/
+
+# Enable the server
+autopm mcp enable context7
+
+# Sync configuration
+autopm mcp sync
+```
+
+## 🔑 Configuration
+
+### Environment Variables
+
+Add to `.claude/.env`:
+
+```bash
+# Optional: Minimum tokens for documentation retrieval (default: 10000)
+DEFAULT_MINIMUM_TOKENS=10000
+```
+
+Note: Context7 API key is not required for basic usage.
+
+## 🔧 Available Tools
+
+### 1. `resolve-library-id`
+Resolves a general library name into a Context7-compatible library ID.
+
+**Example:**
+```
+Library: "react" → ID: "react/latest"
+Library: "nextjs" → ID: "next/latest"
+```
+
+### 2. `get-library-docs`
+Fetches documentation for a library using a Context7-compatible library ID.
+
+**Parameters:**
+- `libraryId` (required): Context7 library ID (e.g., "react/latest")
+- `topic` (optional): Specific topic to focus on
+- `tokens` (optional): Minimum tokens to retrieve (default: 10000)
+
+**Example:**
+```
+get-library-docs("react/latest", topic="hooks")
+get-library-docs("nextjs/14", topic="app-router", tokens=15000)
+```
+
+## 📚 Usage in Agent Definitions
+
+Reference Context7 documentation in your agents:
+
+```markdown
+## MCP Servers Used
+
+This agent uses Context7 for up-to-date documentation:
+- `mcp://context7/react/latest` - React documentation
+- `mcp://context7/nextjs/14` - Next.js 14 documentation
+- `mcp://context7/typescript/latest` - TypeScript reference
+```
+
+## 🧪 Testing
+
+```bash
+# Test the connection
+autopm mcp test context7
+
+# Check status
+autopm mcp status
+
+# Verify in Claude Code
+/mcp
+```
+
+## 🔐 Security
+
+- Context7 MCP server does not require authentication for basic usage
+- Never commit `.claude/.env` with sensitive data
+- Review Context7's [privacy policy](https://context7.com/privacy)
+
+## 📖 Supported Libraries
+
+Context7 supports hundreds of libraries including:
+- **Frontend**: React, Vue, Angular, Svelte, Next.js
+- **Backend**: Express, Fastify, NestJS, Django, Flask
+- **Databases**: PostgreSQL, MongoDB, Redis, MySQL
+- **Cloud**: AWS, Azure, GCP services
+- **And many more...**
+
+Visit [Context7](https://context7.com) to browse all available documentation.
+
+## 🆘 Troubleshooting
+
+### Server Not Starting
+
+```bash
+# Check npm package is available
+npm view @upstash/context7-mcp
+
+# Reinstall
+npm install -g @upstash/context7-mcp
+
+# Test manually
+npx -y @upstash/context7-mcp
+```
+
+### Library Not Found
+
+Use `resolve-library-id` to find the correct library ID:
+```
+resolve-library-id("your-library-name")
+```
+
+### Token Limit Issues
+
+Adjust `DEFAULT_MINIMUM_TOKENS` in your environment:
+```bash
+echo "DEFAULT_MINIMUM_TOKENS=5000" >> .claude/.env
+```
+
+## 🔗 Links
+
+- **NPM Package**: https://www.npmjs.com/package/@upstash/context7-mcp
+- **GitHub**: https://github.com/upstash/context7
+- **Context7 Website**: https://context7.com
+- **Documentation**: https://upstash.com/docs/redis/integrations/mcp
+- **Blog Post**: https://upstash.com/blog/context7-mcp
+
+## 📝 Example Agent Configuration
+
+```markdown
+---
+name: react-expert
+description: React development expert with Context7 documentation
+mcpServers:
+  - context7
+---
+
+# React Expert Agent
+
+This agent has access to:
+- `mcp://context7/react/latest` - Current React documentation
+- `mcp://context7/react-router/latest` - React Router docs
+- `mcp://context7/redux/latest` - Redux documentation
+```
+
+## 🎓 Best Practices
+
+1. **Use Specific Library IDs**: `react/18` instead of `react/latest` for stability
+2. **Configure Token Limits**: Adjust based on your needs
+3. **Cache Results**: Context7 provides fresh docs but cache for performance
+4. **Topic Filtering**: Use specific topics to reduce token usage
+5. **Test Regularly**: Ensure documentation sources are accessible
+
+## 🆕 Updates
+
+Context7 MCP server is actively maintained by Upstash. Check for updates:
+
+```bash
+npm update -g @upstash/context7-mcp
+```
+
+---
+
+**Need help?** Visit [Context7 documentation](https://context7.com) or [Upstash support](https://upstash.com/support)

package/autopm/.claude/mcp/github-mcp.md

@@ -0,0 +1,350 @@
+---
+name: github-mcp
+command: npx
+args: ["@modelcontextprotocol/server-github"]
+env:
+  GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_TOKEN:-}"
+  GITHUB_API_URL: "${GITHUB_API_URL:-https://api.github.com}"
+envFile: .claude/.env
+description: GitHub MCP server for repository management and collaboration
+category: integration
+status: active
+version: ">=1.0.0"
+---
+
+# GitHub MCP Server
+
+## Description
+
+The GitHub MCP Server provides comprehensive GitHub integration through the Model Context Protocol, enabling repository management, issue tracking, pull request workflows, and collaborative development features.
+
+## Features
+
+- **Repository Management**: Create, clone, configure repositories
+- **Issue Tracking**: Create, update, search issues
+- **Pull Requests**: Create, review, merge PRs
+- **Actions/Workflows**: Manage GitHub Actions
+- **Code Search**: Search across repositories
+- **Release Management**: Create and manage releases
+- **Team Collaboration**: Manage teams and permissions
+
+## Configuration
+
+### Required Environment Variables
+
+- `GITHUB_PERSONAL_ACCESS_TOKEN`: Your GitHub PAT (required)
+
+### Optional Environment Variables
+
+- `GITHUB_API_URL`: GitHub API endpoint (for GitHub Enterprise)
+- `GITHUB_DEFAULT_OWNER`: Default repository owner
+- `GITHUB_DEFAULT_REPO`: Default repository name
+
+### Token Permissions
+
+Required scopes for full functionality:
+```
+repo          - Full repository access
+workflow      - GitHub Actions workflows
+write:packages - Package registry
+admin:org     - Organization management (optional)
+gist          - Gist creation (optional)
+```
+
+## Usage Examples
+
+### Basic Setup
+
+```bash
+# Enable the server
+autopm mcp enable github-mcp
+
+# Configure authentication
+echo "GITHUB_TOKEN=ghp_your_token_here" >> .claude/.env
+
+# For a specific repository
+echo "GITHUB_DEFAULT_OWNER=your-username" >> .claude/.env
+echo "GITHUB_DEFAULT_REPO=your-repo" >> .claude/.env
+
+# Sync configuration
+autopm mcp sync
+```
+
+### Integration with Agents
+
+Commonly used with:
+- `github-operations-specialist` - For DevOps workflows
+- `code-analyzer` - For PR reviews
+- `test-runner` - For CI/CD integration
+
+## MCP Commands
+
+### Repository Operations
+
+```javascript
+// Get repository info
+github.getRepository({ owner, repo })
+
+// Create repository
+github.createRepository({
+  name: "new-repo",
+  description: "Repository description",
+  private: false,
+  auto_init: true
+})
+
+// List repositories
+github.listRepositories({ type: "owner" })
+```
+
+### Issue Management
+
+```javascript
+// Create issue
+github.createIssue({
+  title: "Bug: Application crashes",
+  body: "Detailed description...",
+  labels: ["bug", "high-priority"],
+  assignees: ["username"]
+})
+
+// Update issue
+github.updateIssue({
+  issue_number: 123,
+  state: "closed",
+  labels: ["resolved"]
+})
+
+// Search issues
+github.searchIssues({
+  query: "is:open label:bug"
+})
+```
+
+### Pull Request Workflows
+
+```javascript
+// Create PR
+github.createPullRequest({
+  title: "Feature: Add new functionality",
+  head: "feature-branch",
+  base: "main",
+  body: "PR description..."
+})
+
+// Review PR
+github.createReview({
+  pull_number: 456,
+  event: "APPROVE",
+  body: "LGTM!"
+})
+
+// Merge PR
+github.mergePullRequest({
+  pull_number: 456,
+  merge_method: "squash"
+})
+```
+
+### GitHub Actions
+
+```javascript
+// Trigger workflow
+github.triggerWorkflow({
+  workflow_id: "ci.yml",
+  ref: "main",
+  inputs: { environment: "production" }
+})
+
+// Get workflow runs
+github.listWorkflowRuns({
+  workflow_id: "ci.yml",
+  status: "completed"
+})
+```
+
+## Advanced Features
+
+### Code Search
+
+```javascript
+// Search code
+github.searchCode({
+  query: "function TODO in:file language:js repo:owner/repo"
+})
+
+// Search commits
+github.searchCommits({
+  query: "fix bug author:username"
+})
+```
+
+### Release Management
+
+```javascript
+// Create release
+github.createRelease({
+  tag_name: "v1.0.0",
+  name: "Version 1.0.0",
+  body: "Release notes...",
+  draft: false,
+  prerelease: false
+})
+
+// Upload release asset
+github.uploadReleaseAsset({
+  release_id: 789,
+  name: "app.zip",
+  data: fileBuffer
+})
+```
+
+### Webhooks
+
+```javascript
+// Create webhook
+github.createWebhook({
+  config: {
+    url: "https://example.com/webhook",
+    content_type: "json"
+  },
+  events: ["push", "pull_request"]
+})
+```
+
+## Workflow Integration
+
+### Automated PR Workflow
+
+```yaml
+workflow:
+  - create_branch: feature/new-feature
+  - commit_changes:
+      message: "Add new feature"
+  - create_pr:
+      title: "Feature: New functionality"
+      reviewers: ["reviewer1", "reviewer2"]
+  - wait_for_checks: true
+  - auto_merge:
+      method: squash
+      delete_branch: true
+```
+
+### Issue Triage
+
+```yaml
+triage:
+  rules:
+    - if: "title contains 'bug'"
+      then:
+        - add_label: bug
+        - assign_to: bug-team
+    - if: "title contains 'feature'"
+      then:
+        - add_label: enhancement
+        - add_to_project: feature-requests
+```
+
+## Best Practices
+
+1. **Authentication**
+   - Use fine-grained PATs
+   - Rotate tokens regularly
+   - Store securely in .env
+
+2. **Rate Limiting**
+   - Monitor API usage
+   - Implement caching
+   - Use conditional requests
+
+3. **Branch Protection**
+   - Require PR reviews
+   - Enable status checks
+   - Protect main branch
+
+4. **Automation**
+   - Use GitHub Actions for CI/CD
+   - Automate repetitive tasks
+   - Implement proper error handling
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Authentication Failed**
+   - Verify token is valid
+   - Check token permissions
+   - Ensure token hasn't expired
+
+2. **Rate Limit Exceeded**
+   - Check rate limit status
+   - Implement exponential backoff
+   - Use authenticated requests
+
+3. **Permission Denied**
+   - Verify repository access
+   - Check organization permissions
+   - Ensure proper token scopes
+
+### Debug Mode
+
+```bash
+# Enable debug logging
+export GITHUB_DEBUG=true
+export NODE_DEBUG=github
+```
+
+## Security Considerations
+
+1. **Token Security**
+   - Never commit tokens
+   - Use environment variables
+   - Implement token rotation
+
+2. **Repository Access**
+   - Use least privilege principle
+   - Review collaborator permissions
+   - Enable 2FA
+
+3. **Webhook Security**
+   - Validate webhook signatures
+   - Use HTTPS endpoints
+   - Implement IP allowlisting
+
+## GitHub Enterprise
+
+For GitHub Enterprise Server:
+
+```bash
+# Configure enterprise URL
+export GITHUB_API_URL=https://github.enterprise.com/api/v3
+export GITHUB_GRAPHQL_URL=https://github.enterprise.com/api/graphql
+```
+
+## Rate Limits
+
+### API Limits
+- Authenticated: 5,000 requests/hour
+- Search: 30 requests/minute
+- GraphQL: 5,000 points/hour
+
+### Checking Rate Limit
+
+```javascript
+github.getRateLimit()
+// Returns: { limit, remaining, reset }
+```
+
+## Version History
+
+- **1.0.0**: Initial MCP integration
+- **1.1.0**: Added Actions support
+- **1.2.0**: GraphQL API integration
+- **1.3.0**: Enterprise support
+- **1.4.0**: Advanced search capabilities
+
+## Related Resources
+
+- [GitHub API Documentation](https://docs.github.com/en/rest)
+- [GitHub Actions](https://docs.github.com/en/actions)
+- [GitHub Operations Specialist](../agents/devops/github-operations-specialist.md)

package/autopm/.claude/mcp/playwright-mcp.md

@@ -0,0 +1,312 @@
+---
+name: playwright-mcp
+command: npx
+args: ["@playwright/mcp"]
+env:
+  PLAYWRIGHT_BROWSER: "${PLAYWRIGHT_BROWSER:-chromium}"
+  PLAYWRIGHT_HEADLESS: "${PLAYWRIGHT_HEADLESS:-true}"
+envFile: .claude/.env
+description: Playwright MCP server for browser automation and E2E testing
+category: testing
+status: active
+version: ">=1.0.0"
+---
+
+# Playwright MCP Server
+
+## Description
+
+The Playwright MCP Server enables browser automation, visual testing, and end-to-end testing capabilities through the Model Context Protocol. It provides direct browser control for testing web applications, capturing screenshots, and validating user interfaces.
+
+## Features
+
+- **Browser Automation**: Control Chromium, Firefox, and WebKit
+- **Visual Testing**: Screenshot capture and comparison
+- **E2E Testing**: Automated user flow testing
+- **Accessibility Testing**: WCAG compliance checks
+- **Performance Monitoring**: Page load metrics
+- **Network Interception**: Mock API responses
+- **Mobile Emulation**: Test responsive designs
+
+## Configuration
+
+### Environment Variables
+
+- `PLAYWRIGHT_BROWSER`: Browser engine (chromium|firefox|webkit)
+- `PLAYWRIGHT_HEADLESS`: Run in headless mode (true|false)
+- `PLAYWRIGHT_SLOW_MO`: Slow down operations by ms
+- `PLAYWRIGHT_TIMEOUT`: Default timeout in ms
+- `PLAYWRIGHT_VIDEO`: Record videos (on|off|retain-on-failure)
+- `PLAYWRIGHT_TRACE`: Record traces (on|off|retain-on-failure)
+
+### Browser Options
+
+```yaml
+browsers:
+  chromium:
+    channel: chrome  # or 'msedge', 'chrome-beta'
+    args:
+      - --disable-dev-shm-usage
+      - --no-sandbox
+  firefox:
+    firefoxUserPrefs:
+      "media.navigator.streams.fake": true
+  webkit:
+    # Safari-specific options
+```
+
+## Usage Examples
+
+### Basic Setup
+
+```bash
+# Enable the server
+autopm mcp enable playwright-mcp
+
+# Configure for headed mode during development
+echo "PLAYWRIGHT_HEADLESS=false" >> .claude/.env
+echo "PLAYWRIGHT_SLOW_MO=100" >> .claude/.env
+
+# Sync configuration
+autopm mcp sync
+```
+
+### Integration with Agents
+
+Used extensively with:
+- `e2e-test-engineer` - For E2E test creation
+- `react-frontend-engineer` - For UI testing
+- `ux-design-expert` - For visual regression
+
+### Test Examples
+
+```javascript
+// Navigation
+await page.goto('https://example.com');
+
+// Interaction
+await page.click('button#submit');
+await page.fill('input#email', 'test@example.com');
+
+// Assertions
+await expect(page).toHaveTitle('Example Site');
+await expect(page.locator('.message')).toBeVisible();
+
+// Screenshots
+await page.screenshot({ path: 'screenshot.png' });
+```
+
+## MCP Commands
+
+### Navigation
+- `navigate(url)` - Go to URL
+- `reload()` - Reload page
+- `goBack()` - Navigate back
+- `goForward()` - Navigate forward
+
+### Interaction
+- `click(selector)` - Click element
+- `fill(selector, value)` - Fill input
+- `select(selector, value)` - Select option
+- `check(selector)` - Check checkbox
+- `press(key)` - Press keyboard key
+
+### Validation
+- `screenshot(options)` - Capture screenshot
+- `textContent(selector)` - Get text
+- `isVisible(selector)` - Check visibility
+- `waitForSelector(selector)` - Wait for element
+
+## Visual Testing
+
+### Screenshot Comparison
+
+```yaml
+visual_testing:
+  baseline_dir: .playwright/baselines
+  diff_dir: .playwright/diffs
+  threshold: 0.2  # 20% difference threshold
+  ignore_areas:
+    - selector: .timestamp
+    - selector: .dynamic-content
+```
+
+### Full Page Screenshots
+
+```javascript
+await page.screenshot({
+  fullPage: true,
+  animations: 'disabled',
+  mask: ['.sensitive-data']
+});
+```
+
+## Mobile Testing
+
+### Device Emulation
+
+```javascript
+// iPhone 12
+{
+  viewport: { width: 390, height: 844 },
+  userAgent: 'Mozilla/5.0 (iPhone...)',
+  deviceScaleFactor: 3,
+  isMobile: true,
+  hasTouch: true
+}
+```
+
+### Responsive Testing
+
+```yaml
+viewports:
+  - name: mobile
+    width: 375
+    height: 667
+  - name: tablet
+    width: 768
+    height: 1024
+  - name: desktop
+    width: 1920
+    height: 1080
+```
+
+## Performance Testing
+
+### Metrics Collection
+
+```javascript
+const metrics = await page.metrics();
+// Returns: JSHeapUsedSize, Timestamp, etc.
+
+const performance = await page.evaluate(() =>
+  JSON.stringify(window.performance.timing)
+);
+```
+
+### Network Monitoring
+
+```javascript
+// Monitor requests
+page.on('request', request => {
+  console.log('Request:', request.url());
+});
+
+// Mock responses
+await page.route('**/api/*', route => {
+  route.fulfill({
+    status: 200,
+    body: JSON.stringify({ mocked: true })
+  });
+});
+```
+
+## Accessibility Testing
+
+### ARIA Validation
+
+```javascript
+const accessibilityTree = await page.accessibility.snapshot();
+```
+
+### Keyboard Navigation
+
+```javascript
+await page.keyboard.press('Tab');
+await page.keyboard.press('Enter');
+```
+
+## Debugging
+
+### Debug Mode
+
+```bash
+# Enable debugging
+export DEBUG=pw:api
+export PWDEBUG=1
+
+# Slow mode for debugging
+export PLAYWRIGHT_SLOW_MO=1000
+```
+
+### Trace Viewer
+
+```bash
+# Record trace
+npx playwright test --trace on
+
+# View trace
+npx playwright show-trace trace.zip
+```
+
+## Best Practices
+
+1. **Selectors**
+   - Use data-testid attributes
+   - Avoid fragile CSS selectors
+   - Prefer user-facing attributes
+
+2. **Waits**
+   - Use auto-waiting
+   - Avoid hard-coded delays
+   - Wait for specific conditions
+
+3. **Test Isolation**
+   - Fresh browser context per test
+   - Clean up test data
+   - No test interdependencies
+
+4. **Error Handling**
+   - Comprehensive error messages
+   - Screenshot on failure
+   - Trace on failure
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Browser Launch Failed**
+   - Install system dependencies
+   - Check browser binaries
+   - Verify permissions
+
+2. **Timeout Errors**
+   - Increase timeout values
+   - Check network conditions
+   - Verify element selectors
+
+3. **Flaky Tests**
+   - Add proper waits
+   - Mock external dependencies
+   - Use retry logic
+
+## Security Considerations
+
+1. **Credentials**
+   - Never hardcode passwords
+   - Use environment variables
+   - Implement secure storage
+
+2. **Cross-Origin**
+   - Handle CORS properly
+   - Use context isolation
+   - Validate origins
+
+3. **Data Privacy**
+   - Mask sensitive data in screenshots
+   - Clear cookies/storage
+   - Use test data only
+
+## Version History
+
+- **1.0.0**: Initial MCP integration
+- **1.1.0**: Added visual testing
+- **1.2.0**: Mobile emulation support
+- **1.3.0**: Performance metrics
+- **1.4.0**: Accessibility testing
+
+## Related Resources
+
+- [Playwright Documentation](https://playwright.dev)
+- [MCP Browser Control](https://modelcontextprotocol.org/browser)
+- [E2E Test Engineer Agent](../agents/frameworks/e2e-test-engineer.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-autopm",
-  "version": "1.15.2",
+  "version": "1.15.3",
   "description": "Autonomous Project Management Framework for Claude Code - Advanced AI-powered development automation",
   "main": "bin/autopm.js",
   "bin": {