Improves error handling and setup

Adds more detailed error logging to the repository snapshot function for easier debugging, including response status, headers, and body.

Updates project dependencies by specifying them in requirements.txt.

Adds a section to the README outlining current limitations regarding GitHub API authentication using PATs and future plans for GitHub App integration, and enhancing repository analysis and usage analytics.

Author: thegovind

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