feat: Enhance configuration system with smart mode selection and multi-pass processing

- Added comprehensive TypeScript configuration interface for PatchBotConfig
- Implemented mode-specific configuration with support for architect, patcher, and hybrid modes
- Added multi-pass processing configuration with flexible mode sequencing
- Enhanced environment variable handling with type-safe helpers
- Supported multiple API keys for OpenAI, Anthropic, and OpenRouter providers
- Updated .env.example with new configuration options and detailed comments
- Improved mode selection logic with repository-specific configuration support

Author: stevengonsalvez

.env.example

@@ -8,10 +8,29 @@ LOG_LEVEL=debug
 # Go to https://smee.io/new set this to the URL that you are redirected to.
 WEBHOOK_PROXY_URL=
 
+# GitHub App Setup (required)
+# Your GitHub App's private key, get this from the GitHub App settings page
+# To generate: Go to https://github.com/settings/apps -> Your app -> General -> Private keys -> Generate a private key
+# Copy the contents of the downloaded .pem file and paste it here
+# For multi-line values in .env, use quotes and \n for line breaks:
+PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----
+...
+-----END RSA PRIVATE KEY-----"
+
 # patchmycode Configuration
 # API keys for LLM services (required for code fixing)
+# OpenAI API Key - Required for GPT models
 OPENAI_API_KEY=
+# Anthropic API Key - Required for Claude models
 ANTHROPIC_API_KEY=
+# OpenRouter API Key - Optional for access to multiple models through OpenRouter
+OPENROUTER_API_KEY=
+
+# Multiple key setup (optional)
+# For load balancing or fallbacks, you can configure multiple API keys
+# Separate multiple keys with commas (,)
+OPENAI_API_KEYS=key1,key2,key3
+ANTHROPIC_API_KEYS=key1,key2,key3
 
 # Label that triggers patchmycode to fix an issue
 PATCH_TRIGGER_LABEL=fix:auto
@@ -26,22 +45,37 @@ GIT_TIMEOUT=60000
 PATCH_PR_LABELS=automated-fix,patchmycode-generated
 
 # Comment templates
-PATCH_PROCESSING_COMMENT="🤖 Im working on fixing this issue automatically..."
-PATCH_SUCCESS_COMMENT="✅ Ive created a pull request with a fix for this issue."
-PATCH_FAILURE_COMMENT="❌ I wasnt able to automatically fix this issue."
+PATCH_PROCESSING_COMMENT="🤖 I'm working on fixing this issue automatically..."
+PATCH_SUCCESS_COMMENT="✅ I've created a pull request with a fix for this issue."
+PATCH_FAILURE_COMMENT="❌ I wasn't able to automatically fix this issue."
 
-# LLM model to use
-# For OpenAI models:
+# Mode-specific model configuration
+# Default model to use for all modes if mode-specific models aren't specified
 PATCH_MODEL=gpt-4o
-# For Anthropic/Claude models (MUST use --use-anthropic flag):
-# PATCH_MODEL=claude-3-7-sonnet-20250219
-# PATCH_MODEL=claude-3-opus-20240229
-# PATCH_MODEL=claude-3-sonnet-20240229
+
+# Mode-specific models (optional)
+PATCH_MODEL_ARCHITECT=claude-3-7-sonnet-20250219
+PATCH_MODEL_PATCHER=gpt-4o
+PATCH_MODEL_HYBRID_SECURITY=claude-3-opus-20240229
+PATCH_MODEL_HYBRID_PERFORMANCE=gpt-4o-mini
+PATCH_MODEL_HYBRID_TYPESCRIPT=gpt-4o
+
+# Default processing mode
+PATCH_DEFAULT_MODE=patcher
 
 # Additional arguments to pass to the AI engine (comma-separated)
 # IMPORTANT: When using Claude models, you MUST include --use-anthropic here
 # PATCH_EXTRA_ARGS=--use-anthropic
 
+# Mode-specific extra arguments (comma-separated, optional)
+# PATCH_EXTRA_ARGS_ARCHITECT=--use-anthropic,--extra-arg
+# PATCH_EXTRA_ARGS_PATCHER=--timeout=300
+# PATCH_EXTRA_ARGS_HYBRID_SECURITY=--use-anthropic,--security-focus
+
+# Multi-pass processing configuration
+PATCH_ENABLE_MULTIPASS=true
+PATCH_MULTIPASS_SEQUENCE=architect,patcher
+
 # Branch configuration
 PATCH_BRANCH_PREFIX=patch-fix-
 
@@ -54,3 +88,6 @@ PATCH_PR_DRAFT=false
 PATCH_INCLUDE_FILES=
 # Files to exclude from analysis (glob patterns, comma-separated)
 PATCH_EXCLUDE_FILES=node_modules/**,.git/**
+
+# Repository specific configuration path
+PATCH_CONFIG_PATH=.patchmycode/config.json

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,53 @@
+---
+name: Bug report
+about: Create a report to help us fix issues
+title: 'Bug: '
+labels: 'bug'
+assignees: ''
+---
+
+## Description
+<!-- A clear and concise description of what the bug is -->
+
+## Reproduction Steps
+<!-- Steps to reproduce the behavior -->
+1. 
+2. 
+3. 
+
+## Expected Behavior
+<!-- A clear and concise description of what you expected to happen -->
+
+## Current Behavior
+<!-- A clear description of what actually happens -->
+
+## Error Messages
+<!-- If applicable, add error messages or logs to help explain your problem -->
+```
+// Paste error message or logs here
+```
+
+## Code Context
+<!-- If you can identify where the issue is occurring, please share code snippets -->
+```
+// Paste relevant code here
+```
+
+## Fix Scope
+<!-- This helps the bot choose the right mode for fixing the issue -->
+- [ ] This is likely a small, isolated bug (patcher mode)
+- [ ] This might require architectural changes (architect mode)
+- [ ] This might be related to security issues (hybrid:security mode)
+- [ ] This is likely a performance problem (hybrid:performance mode)
+- [ ] This is related to TypeScript types (hybrid:typescript mode)
+
+## Additional Context
+<!-- Add any other context about the problem here -->
+
+## Screenshots
+<!-- If applicable, add screenshots to help explain your problem -->
+
+## Environment
+- OS: [e.g. Windows 10, macOS 14.0]
+- Browser/Version: [e.g. Chrome 121, Firefox 125]
+- App Version: [e.g. 1.0.5] 

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,39 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: 'Feature: '
+labels: 'enhancement'
+assignees: ''
+---
+
+## Feature Description
+<!-- A clear and concise description of the feature you want to be implemented -->
+
+## Problem Context
+<!-- Why is this feature needed? What problem does it solve? -->
+
+## Proposed Implementation
+<!-- Describe how you think this could be implemented. Include code snippets if possible.
+     The more details you provide, the more accurately the bot can select the best mode. -->
+```
+// Example code or pseudocode here
+```
+
+## Architectural Considerations
+<!-- Describe any architectural impacts this feature might have.
+     This will help the bot determine if it should use architect mode. -->
+
+## Alternative Solutions
+<!-- Describe any alternative solutions or features you've considered -->
+
+## Additional Context
+<!-- Add any other context or screenshots about the feature request here -->
+
+## Mode Hints (Optional)
+<!-- If you have preferences for how this should be fixed, uncomment one of the options below -->
+<!-- - I suggest using architect mode for this issue -->
+<!-- - I suggest using patcher mode for this issue -->
+<!-- - I suggest using multipass (architect+patcher) mode for this issue -->
+<!-- - I suggest using hybrid:security mode for this issue -->
+<!-- - I suggest using hybrid:performance mode for this issue -->
+<!-- - I suggest using hybrid:typescript mode for this issue --> 

.gitignore

@@ -6,3 +6,4 @@ npm-debug.log
 coverage
 lib
 .env.archive
+.cursor/mcp.json