Manual Testing Guide for Module 1 Solution

Prerequisites

1. Ensure you're in a git repository with some changes
2. Install uv following instructions at: https://docs.astral.sh/uv/getting-started/installation/
3. Install dependencies:

   uv sync --all-extras

Test 1: Validate the Solution

Run the automated validation script:

uv run python validate_solution.py

This will check:

• Git environment
• Python imports
• Server creation
• Tool registration
• Tool execution
• Template creation

Test 2: Run Unit Tests

uv run pytest test_server.py -v

Test 3: Test with Claude Code

1. Configure MCP Server

   Add the server to Claude Code:

   # Add the MCP server
   claude mcp add pr-agent -- uv --directory /absolute/path/to/module1/solution run server.py
   
   # Verify it's configured
   claude mcp list

2. Restart Claude Code to pick up the new server

3. Make Some Git Changes

   In any git repository:

   echo "test change" >> README.md
   git add README.md

4. Test with Claude

   Ask Claude:

   • "Can you analyze my git changes?"
   • "What PR templates are available?"
   • "Based on my changes, which PR template should I use?"

Test 4: Direct Server Testing

You can also test the server directly:

import asyncio
from server import analyze_file_changes, get_pr_templates, suggest_template

async def test():
    # Test analyze_file_changes
    changes = await analyze_file_changes("main", True)
    print("Changes:", changes[:200] + "...")
    
    # Test get_pr_templates
    templates = await get_pr_templates()
    print("Templates available:", len(json.loads(templates)))
    
    # Test suggest_template
    suggestion = await suggest_template(
        "Fixed authentication bug", 
        "bug"
    )
    print("Suggestion:", json.loads(suggestion)["recommended_template"]["type"])

asyncio.run(test())

Expected Behavior

1. analyze_file_changes should return JSON with:

   • base_branch
   • files_changed
   • statistics
   • commits
   • diff (if include_diff=True)

2. get_pr_templates should return JSON array of templates with:

   • filename
   • type
   • content

3. suggest_template should return JSON with:

   • recommended_template
   • reasoning
   • template_content
   • usage_hint

Troubleshooting

• "Git not found": Ensure you're in a git repository
• Import errors: Check virtual environment is activated
• MCP connection failed: Verify the path in the claude mcp add command is absolute
• No tools showing: Restart Claude Code after adding the server