claude-autopm 1.15.3 → 1.15.5

package/autopm/.claude/agents/core/mcp-manager.md

@@ -194,11 +194,11 @@ autopm mcp enable playwright-mcp
 # Set up visual testing baselines
 ```
 
-### GitHub Integration
+### Playwright Testing
 ```bash
-autopm mcp enable github-mcp
-# Configure PAT token
-# Set default repository
+autopm mcp enable playwright-mcp
+# Configure browser automation
+# Set test defaults
 ```
 
 ## Metrics and Monitoring

package/autopm/.claude/examples/mcp/README.md

@@ -25,7 +25,7 @@ autopm mcp sync
 
 ```bash
 # Copy and modify
-cp .claude/examples/mcp/github-mcp.md .claude/mcp/my-custom-server.md
+cp .claude/examples/mcp/playwright-mcp.md .claude/mcp/my-custom-server.md
 nano .claude/mcp/my-custom-server.md
 
 # Enable and sync
@@ -46,7 +46,6 @@ autopm mcp add
 - **context7.md** - Context7 up-to-date documentation database
 
 ### Integration Servers
-- **github-mcp.md** - GitHub repository management
 - **filesystem-mcp.md** - Local filesystem operations
 
 ### Testing Servers

package/autopm/.claude/mcp/MCP-REGISTRY.md

@@ -20,11 +20,6 @@ Example MCP server configurations are available in `.claude/examples/mcp/`:
 **Use Cases**: E2E testing, visual testing, browser automation
 **Example**: `.claude/examples/mcp/playwright-mcp.md`
 
-### github-mcp
-**Description**: GitHub MCP server for repository management
-**Use Cases**: Issue tracking, PR management, repository analysis
-**Example**: `.claude/examples/mcp/github-mcp.md`
-
 ### filesystem-mcp
 **Description**: Local filesystem access server
 **Use Cases**: File operations, directory navigation, content management
@@ -101,7 +96,7 @@ autopm mcp add
 cp .claude/examples/mcp/context7.md .claude/mcp/
 
 # Or from installed framework
-cp /path/to/framework/autopm/.claude/examples/mcp/github-mcp.md .claude/mcp/
+cp /path/to/framework/autopm/.claude/examples/mcp/playwright-mcp.md .claude/mcp/
 ```
 
 ### ✅ Enabling/Disabling Servers

package/autopm/scripts/package.json.template

@@ -1,30 +1,33 @@
 {
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
   "scripts": {
     "// Safety Scripts": "Safeguards against bad commits",
     "precommit": "npm test && npm run build && npm run lint",
     "verify": "npm test && npm run build && npm run lint && npm run typecheck",
     "safe-commit": "./scripts/safe-commit.sh",
     "prepush": "npm run verify && npm run test:e2e",
-    
+
     "// Quick Checks": "Quick checks",
     "check": "npm run lint && npm run typecheck",
     "check:all": "npm run verify",
-    
+
     "// Git Helpers": "Git helper commands",
     "commit": "npm run precommit && git add -A && git commit",
     "push:safe": "npm run prepush && git push",
-    
+
     "// CI/CD Simulation": "Local CI/CD simulation",
     "ci:local": "npm ci && npm run verify && npm run test:e2e",
     "ci:validate": "npm run ci:local",
-    
+
     "// Emergency": "Emergency",
     "fix": "npm run lint -- --fix && npm run format",
     "format": "prettier --write .",
     "clean:hooks": "rm -f .git/hooks/pre-* && npm run setup:hooks",
     "setup:hooks": "husky install || cp scripts/hooks/* .git/hooks/"
   },
-  
+
   "husky": {
     "hooks": {
       "pre-commit": "npm run precommit",
@@ -32,7 +35,7 @@
       "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
     }
   },
-  
+
   "// Usage examples": [
     "npm run safe-commit 'feat: add new feature'",
     "npm run verify",

package/install/install.js

@@ -339,6 +339,63 @@ ${this.colors.BOLD}Examples:${this.colors.NC}
         this.printSuccess(`Installed ${script}`);
       }
     }
+
+    // Install package.json if it doesn't exist
+    const packageJsonPath = path.join(this.targetDir, 'package.json');
+    const packageJsonTemplatePath = path.join(this.autopmDir, 'scripts', 'package.json.template');
+
+    if (!fs.existsSync(packageJsonPath) && fs.existsSync(packageJsonTemplatePath)) {
+      this.printStep('Creating package.json from template...');
+      const templateContent = fs.readFileSync(packageJsonTemplatePath, 'utf-8');
+
+      // Try to get project name from directory
+      const projectName = path.basename(this.targetDir);
+
+      // Parse template and add name field
+      const packageJson = JSON.parse(templateContent);
+      packageJson.name = projectName;
+      packageJson.version = packageJson.version || '1.0.0';
+      packageJson.description = packageJson.description || '';
+      packageJson.main = packageJson.main || 'index.js';
+      packageJson.license = packageJson.license || 'ISC';
+
+      fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2), 'utf-8');
+      this.printSuccess('Created package.json');
+    } else if (fs.existsSync(packageJsonPath)) {
+      this.printInfo('package.json already exists, skipping');
+    }
+  }
+
+  installDependencies() {
+    const packageJsonPath = path.join(this.targetDir, 'package.json');
+
+    if (!fs.existsSync(packageJsonPath)) {
+      this.printInfo('No package.json found, skipping dependency installation');
+      return;
+    }
+
+    this.printStep('Installing npm dependencies...');
+
+    try {
+      // Check if package.json has dependencies
+      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+      if (!packageJson.dependencies || Object.keys(packageJson.dependencies).length === 0) {
+        this.printInfo('No dependencies to install');
+        return;
+      }
+
+      // Run npm install
+      execSync('npm install', {
+        cwd: this.targetDir,
+        encoding: 'utf-8',
+        stdio: 'inherit'
+      });
+
+      this.printSuccess('Dependencies installed successfully');
+    } catch (error) {
+      this.printWarning(`Failed to install dependencies: ${error.message}`);
+      this.printInfo('You can manually run: npm install');
+    }
   }
 
   checkToolAvailability() {
@@ -903,6 +960,9 @@ See: https://github.com/rafeekpro/ClaudeAutoPM
       await this.setupGitHooks();
     }
 
+    // Install npm dependencies
+    this.installDependencies();
+
     // Final success message
     console.log('');
     this.printMsg('GREEN', '╔══════════════════════════════════════════╗');

package/package.json

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

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

@@ -1,350 +0,0 @@
----
-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/github-mcp.md

@@ -1,350 +0,0 @@
----
-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)