Improves error handling and GitHub setup

README.md

@@ -93,6 +93,27 @@ cp .env.example .env
 uvicorn app.main:app --reload
 ```
 
+## 📋 Known Limitations & Roadmap
+
+### Current Limitations
+
+- **GitHub API Authentication**: Currently uses Personal Access Tokens (PAT) for GitHub API access, which has limitations including:
+  - Rate limiting constraints
+  - Token management complexity
+  - Security considerations for token storage and rotation
+  - Limited scope control compared to GitHub Apps
+
+### Coming Soon
+
+- **🔧 GitHub App Integration**: Replace PAT-based authentication with a proper GitHub App to provide:
+  - Better rate limiting
+  - Fine-grained permissions
+  - Improved security model
+  - No need for users to manage personal tokens
+- **📊 Enhanced Repository Analysis**: More comprehensive codebase analysis for better AI agent recommendations
+- **🔗 Additional AI Agent Integrations**: Support for more AI coding assistants and development tools
+- **📈 Usage Analytics**: Insights into AI agent effectiveness and usage patterns
+
 ## 🤝 Contributing
 
 We welcome contributions to AGUnblock! Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started.

backend/app/services/github.py

@@ -142,4 +142,11 @@ async def get_repository_snapshot(self, owner: str, repo: str) -> Optional[Dict[
         except Exception as e:
             error_message = str(e)
             print(f"Error in get_repository_snapshot for {owner}/{repo}: {error_message}")
+
+            # Add more detailed error information for debugging
+            if hasattr(e, 'response'):
+                print(f"Response status: {e.response.status_code}")
+                print(f"Response headers: {dict(e.response.headers)}")
+                print(f"Response body: {e.response.text}")
+
             raise RuntimeError(f"Failed to fetch repository data: {error_message}")

backend/requirements.txt

@@ -1,5 +1,6 @@
-fastapi==0.104.1
-uvicorn==0.23.2
-python-dotenv==1.0.0
-httpx==0.24.1
-azure-ai-agents==1.0.0
+fastapi
+uvicorn
+python-dotenv
+httpx
+azure-ai-agents
+githubkit