feat: LLM-Agnostic MCP Server with Peer Review Integration

.gitignore

@@ -5,6 +5,11 @@ npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 lerna-debug.log*
+
+# Claude Code temporary files
+tmpclaude-*
+nul
+.claude/
 # Ignore Visual Studio files
 .vs/
 *.vsidx
@@ -164,6 +169,22 @@ dist/*
 !dist/providers/**
 !dist/types/
 !dist/types/**
+!dist/mcp/
+!dist/mcp/**
 
 # ArchDoc configuration (contains API keys)
 .archdoc.config.json
+
+# SQLite database (local analysis history)
+pr-agent.db
+*.db
+
+# Local MCP configuration override (optional - for user-specific settings)
+# Note: The project .mcp.json is tracked for team-wide configuration
+.mcp.local.json
+*.db
+
+# Temporary test output and analysis files
+*-output.txt
+*-output-*.txt
+*-snapshot.txt

.mcp.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://github.com/modelcontextprotocol/specification/blob/main/schema/mcp.schema.json",
+  "$comment": "===== PR Agent: CLI Tool + MCP Server =====",
+  "$comment2": "This repository is primarily a CLI tool (pr-agent) for analyzing pull requests.",
+  "$comment3": "It also includes an MCP server (src/mcp/) that exposes the same functionality via MCP.",
+  "$comment4": "",
+  "$comment5": "Setup: npm install --legacy-peer-deps && npm run build",
+  "$comment6": "",
+  "$comment7": "Available MCP Tools (see server.json for full schemas):",
+  "$comment8": "  • analyze - Analyze PR/branch changes with diff parsing, risk detection, complexity scoring, Jira ticket extraction",
+  "$comment9": "  • dashboard - Start web dashboard to view analysis history, code quality trends, and ROI metrics",
+  "$comment10": "",
+  "$comment11": "The MCP server imports and reuses the CLI's PRAnalyzerAgent and analysis tools.",
+  "$comment12": "",
+  "$comment13": "===== Required MCP Servers for Full Functionality =====",
+  "$comment14": "The Atlassian Rovo MCP Server provides Jira/Confluence access via OAuth (requires Node.js 18+)",
+  "$comment15": "GitHub MCP server enables repository and PR management",
+  "$comment16": "The PR Agent extracts Jira ticket IDs, then uses the Atlassian MCP server to fetch ticket details.",
+  "mcpServers": {
+    "pr-agent": {
+      "command": "npm",
+      "args": ["run", "mcp"],
+      "env": {
+        "NODE_ENV": "development"
+      }
+    },
+    "atlassian": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "mcp-remote", "https://mcp.atlassian.com/v1/mcp"]
+    },
+    "github": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-github"]
+    }
+  }
+}

.pr-analyzer.yml

@@ -1,28 +1,46 @@
 # PR Analyzer Configuration
-# This file configures the AI-powered PR analysis
+# This file documents available configuration options for the PR Analyzer
+# GitHub Action reads from environment variables, CLI uses .pragent.config.json
 
 # Analysis settings
 analysis:
   # Maximum complexity level to flag (1-5)
   max_complexity: 4
-  
+
   # Whether to include potential risks in analysis
   include_risks: true
-  
+
   # Whether to include complexity rating
   include_complexity: true
 
 # AI model settings
 ai:
   # Model to use for analysis
-  model: "claude-3-5-sonnet-20241022"
-  
+  model: "claude-sonnet-4-5-20250929"
+
   # Maximum tokens for response
-  max_tokens: 1500
-  
+  max_tokens: 50000
+
   # Temperature for creativity (0.0-1.0)
   temperature: 0.2
 
+# Peer Review settings (CLI only - requires .pragent.config.json)
+peerReview:
+  # Enable peer review against Jira tickets
+  enabled: false
+
+  # Analyze acceptance criteria compliance
+  analyzeAcceptanceCriteria: true
+
+  # Rate ticket quality (completeness, clarity)
+  rateTicketQuality: true
+
+  # Generate test suggestions based on AC
+  generateTestSuggestions: true
+
+  # Check for scope creep (changes outside ticket scope)
+  checkScopeCreep: true
+
 # File patterns to include/exclude
 files:
   # Include these file patterns
@@ -35,7 +53,11 @@ files:
     - "**/*.java"
     - "**/*.go"
     - "**/*.rs"
-
+    - "**/*.cs"
+    - "**/*.cpp"
+    - "**/*.c"
+    - "**/*.h"
+
   # Exclude these file patterns
   exclude:
     - "**/*.test.*"

.vscode/mcp.json

@@ -0,0 +1,31 @@
+{
+  "$comment": "MCP Server Configuration for PR Agent (CLI Tool + MCP Server)",
+  "$comment2": "PR Agent is primarily a CLI tool for PR analysis that also exposes MCP server functionality",
+  "$comment3": "The MCP server (src/mcp/) imports and reuses the CLI's core analysis engine",
+  "$comment4": "After 'npm install && npm run build', the server provides these tools:",
+  "$comment5": "  - analyze: Parse git diff, detect risks, calculate complexity, extract Jira tickets",
+  "$comment6": "  - dashboard: Start web dashboard for viewing analysis history and metrics",
+  "$comment7": "",
+  "$comment8": "For full Jira integration, also install @modelcontextprotocol/server-atlassian",
+  "$comment9": "For GitHub integration, also install @modelcontextprotocol/server-github",
+  "servers": {
+    "pr-agent": {
+      "type": "stdio",
+      "command": "npm",
+      "args": ["run", "mcp"],
+      "cwd": "${workspaceFolder}",
+      "description": "PR Agent MCP Server - AI-powered PR analysis (analyze, dashboard)"
+    },
+    "atlassian": {
+      "type": "http",
+      "url": "https://mcp.atlassian.com/v1/mcp",
+      "description": "Official Atlassian Rovo MCP Server - Jira and Confluence Cloud access via OAuth"
+    },
+    "github": {
+      "type": "stdio",
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-github"],
+      "description": "GitHub MCP Server - Repository and PR management"
+    }
+  }
+}

CLAUDE.md

@@ -0,0 +1,94 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+PR Agent is an AI-powered pull request analyzer available as both a CLI tool and a GitHub Action. It analyzes code changes using multiple AI providers (Anthropic Claude, OpenAI GPT, Google Gemini) and provides summaries, risk detection, complexity scoring, and architecture-aware recommendations.
+
+## Build & Development Commands
+
+```bash
+# Install dependencies (--legacy-peer-deps required for LangChain peer dependency conflicts)
+npm install --legacy-peer-deps
+
+# Build everything (TypeScript + GitHub Action bundle)
+npm run build
+
+# Build TypeScript only
+npm run build:tsc
+
+# Build GitHub Action only (uses @vercel/ncc)
+npm run build:action
+
+# Clean and rebuild
+npm run build:clean
+
+# Run tests
+npm test
+npm test -- --watch        # Watch mode
+npm test -- --coverage     # With coverage
+
+# Run single test file
+npm test -- tests/config-loader.test.ts
+
+# Development mode (no build needed)
+npm run dev
+
+# Run CLI from built dist
+npm run cli
+```
+
+## Architecture
+
+The project follows a modular monolith pattern with four layers:
+
+### Entry Points
+- `src/cli/index.ts` - CLI entry point using Commander.js
+- `src/action.ts` - GitHub Action entry point
+- `src/index.ts` - Probot app integration
+
+### Core Analysis Engine
+- `src/agents/pr-analyzer-agent.ts` - Main LangChain-based analysis workflow
+- `src/agents/base-pr-agent-workflow.ts` - LangGraph workflow orchestration
+
+### AI Provider Layer
+- `src/providers/` - Provider implementations (Anthropic, OpenAI, Google)
+- `src/providers/provider.factory.ts` - Factory pattern for instantiation
+- `src/providers/provider.interface.ts` - Common interface all providers implement
+
+### Tools & Utilities
+- `src/tools/pr-analysis-tools.ts` - Diff parsing and analysis tools
+- `src/utils/arch-docs-parser.ts` - Parse `.arch-docs` documentation folder
+- `src/utils/arch-docs-rag.ts` - RAG (Retrieval-Augmented Generation) for architecture context
+- `src/utils/branch-resolver.ts` - Git branch detection and resolution
+- `src/cli/utils/config-loader.ts` - Configuration file management
+
+### Data Flow
+```
+User Input → CLI/Action Interface → Config Loader → PRAnalyzerAgent
+    → Parse Diff → Load Architecture Docs (optional) → Build RAG Context
+    → Provider Factory → AI Provider → Structured Analysis Results
+    → Format Output (CLI terminal or GitHub PR comment)
+```
+
+## Key Configuration Files
+
+- `.pragent.config.json` - User configuration (AI provider, model, API keys, analysis settings)
+- `.pr-analyzer.yml` - GitHub Action configuration
+- `action.yml` - GitHub Action manifest
+
+## Technology Stack
+
+- **Framework**: TypeScript/Node.js (ES Modules), requires Node.js >=18.0.0
+- **AI Orchestration**: LangChain v1.x with LangGraph for workflow management
+- **CLI Framework**: Commander.js with Inquirer for interactive prompts
+- **Testing**: Jest with ts-jest
+- **Action Bundling**: @vercel/ncc bundles the GitHub Action into a single file
+
+## Important Notes
+
+- Large diffs (>50KB) automatically use agent-based chunking (configurable via `analysis.agentThreshold`)
+- The GitHub Action bundle in `dist/` must be committed after changes to action code
+- Environment variables `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, or `GOOGLE_API_KEY` can be used instead of config file
+- Default branch detection uses: config file → GitHub API → git commands → fallback to `origin/main`