add AI-powered GitHub workflows and development agents

.github/workflows/issue-triage.yml

@@ -0,0 +1,32 @@
+name: AI Issue Triage
+
+on:
+  issues:
+    types: [opened]
+
+jobs:
+  triage:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.10'
+
+    - name: Install dependencies
+      run: |
+        pip install google-generativeai PyGithub
+
+    - name: Run AI Bug Triager
+      env:
+        GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: |
+        python scripts/ai_bug_triager.py 
+          --repo "${{ github.repository }}" 
+          --issue "${{ github.event.issue.number }}" 
+          --github-token "$GITHUB_TOKEN" 
+          --gemini-api-key "$GEMINI_API_KEY"

.github/workflows/pr-review.yml

@@ -91,4 +91,122 @@ jobs:
             owner: context.repo.owner,
             repo: context.repo.repo,
             body: comment
-          });
+          });
+
+  ai-code-review:
+    runs-on: ubuntu-latest
+    needs: quality-and-safety
+    if: github.event.pull_request.draft == false
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.10'
+
+    - name: Install dependencies
+      run: |
+        pip install google-generativeai PyGithub
+
+    - name: Run AI Reviewer
+      env:
+        GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: |
+        python scripts/ai_pr_reviewer.py \
+          --repo "${{ github.repository }}" \
+          --pr "${{ github.event.pull_request.number }}" \
+          --github-token "$GITHUB_TOKEN" \
+          --gemini-api-key "$GEMINI_API_KEY"
+
+  trading-risk-guard:
+    runs-on: ubuntu-latest
+    needs: quality-and-safety
+    if: github.event.pull_request.draft == false
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.10'
+
+    - name: Run Trading Risk Guard
+      run: |
+        # Get list of changed files
+        CHANGED_FILES=$(git diff --name-only origin/main...HEAD | tr '\n' ' ')
+        if [ ! -z "$CHANGED_FILES" ]; then
+          python scripts/trading_risk_guard.py $CHANGED_FILES
+        else
+          echo "No files changed, skipping scan."
+        fi
+
+  automated-backtest:
+    runs-on: ubuntu-latest
+    needs: quality-and-safety
+    if: github.event.pull_request.draft == false
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.10'
+
+    - name: Install dependencies
+      run: |
+        pip install google-generativeai PyGithub pandas upstox-python-sdk
+
+    - name: Run Automated Backtest
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        UPSTOX_ACCESS_TOKEN: ${{ secrets.UPSTOX_ACCESS_TOKEN }}
+      run: |
+        # Run the backtest script for changed strategies
+        python scripts/automated_backtest.py \
+          --repo "${{ github.repository }}" \
+          --pr "${{ github.event.pull_request.number }}" \
+          --github-token "$GITHUB_TOKEN" \
+          --upstox-token "$UPSTOX_ACCESS_TOKEN"
+
+  docs-and-changelog:
+    runs-on: ubuntu-latest
+    needs: quality-and-safety
+    if: github.event.pull_request.draft == false
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.10'
+
+    - name: Install dependencies
+      run: |
+        pip install google-generativeai PyGithub
+
+    - name: Run AI Docs Agent
+      env:
+        GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: |
+        python scripts/ai_docs_agent.py \
+          --repo "${{ github.repository }}" \
+          --pr "${{ github.event.pull_request.number }}" \
+          --github-token "$GITHUB_TOKEN" \
+          --gemini-api-key "$GEMINI_API_KEY"

requirements.txt

@@ -58,6 +58,8 @@ gast==0.6.0
 google-auth==2.23.4
 google-auth-httplib2==0.2.0
 google-auth-oauthlib==1.1.0
+google-generativeai==0.8.3
+PyGithub==2.5.0
 google-pasta==0.2.0
 greenlet==3.1.1
 grpcio==1.71.0

scripts/ai_bug_triager.py

@@ -0,0 +1,96 @@
+import os
+import sys
+import argparse
+import google.generativeai as genai
+from github import Github
+
+def triage_issue(repo_name, issue_number, github_token, gemini_api_key):
+    """
+    AI Bug Triager Agent.
+    Analyzes new issues and suggests root causes and fixes.
+    """
+    # 1. Setup
+    g = Github(github_token)
+    repo = g.get_repo(repo_name)
+    issue = repo.get_issue(int(issue_number))
+
+    genai.configure(api_key=gemini_api_key)
+    model = genai.GenerativeModel('gemini-1.5-pro')
+
+    # 2. Analyze Issue Content
+    print(f"🐞 Triaging Issue #{issue_number}: {issue.title}")
+
+    # Get a list of key files to help the AI map the issue
+    # We'll provide a simplified directory structure
+    file_structure = """
+    - app.py (Main Entry)
+    - services/ (Trading, Auth, Data Services)
+    - strategies/ (Trading Strategies)
+    - ui/ (Frontend React Code)
+    - database/ (Models and Repositories)
+    - core/ (Config, Security, WebSockets)
+    """
+
+    prompt = f"""
+    You are a Senior Debugging Engineer for an Algorithmic Trading Platform. 
+    Analyze the following GitHub Issue and suggest a root cause and fix.
+
+    Issue Title: {issue.title}
+    Issue Body: {issue.body}
+
+    Codebase Overview:
+    {file_structure}
+
+    Tasks:
+    1. Identify the likely files involved.
+    2. If there's a stack trace, explain what the error means.
+    3. Suggest a specific fix or investigation steps.
+    4. Assign a priority (Low, Medium, High, Critical).
+
+    Format your response as:
+    ### 🕵️ AI Diagnosis
+    - **Likely Files:** [e.g., services/upstox_service.py]
+    - **Root Cause:** [Explain what's happening]
+    - **Priority:** [Priority Level]
+
+    ### 🛠️ Suggested Fix
+    ```python
+    # [Your suggested code or investigation steps]
+    ```
+    """
+
+    response = model.generate_content(prompt)
+    ai_output = response.text.strip()
+
+    # 3. Post to GitHub
+    comment = f"## 🤖 AI Bug Triager Response
+
+{ai_output}
+
+*This is an automated response to help speed up resolution.*"
+    issue.create_comment(comment)
+
+    # 4. Add labels based on priority (if AI suggests)
+    if "Priority: Critical" in ai_output:
+        issue.add_to_labels("critical", "bug")
+    elif "Priority: High" in ai_output:
+        issue.add_to_labels("high-priority", "bug")
+    else:
+        issue.add_to_labels("bug")
+
+    print("✅ Issue triage completed.")
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--repo", required=True)
+    parser.add_argument("--issue", required=True)
+    parser.add_argument("--github-token", required=True)
+    parser.add_argument("--gemini-api-key", required=True)
+
+    args = parser.parse_args()
+
+    try:
+        triage_issue(args.repo, args.issue, args.github_token, args.gemini_api_key)
+    except Exception as e:
+        print(f"❌ Error in Bug Triager: {e}")
+        sys.exit(1)

scripts/ai_docs_agent.py

@@ -0,0 +1,82 @@
+import os
+import sys
+import argparse
+import google.generativeai as genai
+from github import Github
+from datetime import datetime
+
+def generate_docs_and_changelog(repo_name, pr_number, github_token, gemini_api_key):
+    """
+    AI Documentation & Changelog Agent.
+    Analyzes the PR and generates a semantic changelog and doc updates.
+    """
+    # 1. Setup
+    g = Github(github_token)
+    repo = g.get_repo(repo_name)
+    pr = repo.get_pull(int(pr_number))
+
+    genai.configure(api_key=gemini_api_key)
+    model = genai.GenerativeModel('gemini-1.5-pro')
+
+    # 2. Analyze PR Diff for Documentation Needs
+    print(f"📄 Analyzing PR #{pr_number} for documentation impact...")
+    files = pr.get_files()
+    file_list = [f.filename for f in files]
+
+    # Combined diff for better context (limiting size for LLM)
+    combined_diff = "
+".join([f.patch for f in files if f.patch])[:10000]
+
+    prompt = f"""
+    You are a Technical Writer and Senior Developer. Review the following Pull Request details and diff.
+    PR Title: {pr.title}
+    PR Body: {pr.body}
+    Changed Files: {', '.join(file_list)}
+
+    Tasks:
+    1. Generate a "Semantic Changelog" entry (What changed? Why? Impact?).
+    2. Identify if any NEW services, strategies, or APIs were added that require new documentation files.
+    3. Suggest updates to the main README.md or existing docs/ files if necessary.
+
+    Diff:
+    {combined_diff}
+
+    Format your response as:
+    ### 📝 Semantic Changelog
+    [A human-readable summary of the changes]
+
+    ### 📚 Documentation Impact
+    - [Impact 1: e.g., Update README to include new Upstox endpoint]
+    - [Impact 2: e.g., New strategy 'X' added to docs/strategies/]
+    """
+
+    response = model.generate_content(prompt)
+    ai_output = response.text.strip()
+
+    # 3. Post to GitHub
+    comment = f"## 🤖 AI Documentation & Changelog Agent
+
+{ai_output}
+
+"
+    pr.create_issue_comment(comment)
+    print("✅ Documentation & Changelog suggestions posted.")
+
+    # 4. (Optional) Auto-update CHANGELOG.md if in a specific branch/environment
+    # For now, we'll just suggest the update to keep it safe.
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--repo", required=True)
+    parser.add_argument("--pr", required=True)
+    parser.add_argument("--github-token", required=True)
+    parser.add_argument("--gemini-api-key", required=True)
+
+    args = parser.parse_args()
+
+    try:
+        generate_docs_and_changelog(args.repo, args.pr, args.github_token, args.gemini_api_key)
+        print("✅ Docs Agent run completed.")
+    except Exception as e:
+        print(f"❌ Error in Docs Agent: {e}")
+        sys.exit(1)