chore: add research bot, tests, and CI

Author: openlifeos

.bot/state.json

@@ -0,0 +1,7 @@
+{
+  "arxiv_ids": [
+    "2508.09960",
+    "2508.12038",
+    "2508.16943"
+  ]
+}

.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master, "**" ]
+  pull_request:
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Install dev deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install pytest ruff
+      - name: Ruff
+        run: |
+          ruff --version
+          ruff check awesome-isaac-gym/scripts awesome-isaac-gym/tests
+      - name: Pytest
+        run: |
+          pytest -q awesome-isaac-gym/tests
+
+  bot-idempotency:
+    runs-on: ubuntu-latest
+    if: ${{ github.event_name == 'pull_request' && startsWith(github.head_ref, 'research-bot/') }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Run bot and verify no diff
+        run: |
+          python awesome-isaac-gym/scripts/research_bot.py || true
+          git status --porcelain
+          # Ensure the bot is idempotent for its own PR branch
+          if ! git diff --quiet; then
+            echo "Bot produced changes on its own PR branch. Please re-run the bot locally and commit the updates." >&2
+            exit 1
+          fi
+

.github/workflows/research-bot.yml

@@ -0,0 +1,58 @@
+name: Research Bot
+
+on:
+  schedule:
+    - cron: '0 9 * * 1' # Every Monday 09:00 UTC
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  update:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pyyaml
+
+      - name: Run research bot
+        run: |
+          python scripts/research_bot.py
+
+      - name: Create Pull Request (draft)
+        if: |
+          github.event_name == 'workflow_dispatch' ||
+          github.event_name == 'schedule'
+        uses: peter-evans/create-pull-request@v5
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          branch: research-bot/auto-update
+          commit-message: "chore(research): update latest research section"
+          title: "chore(research): update latest research"
+          body: |
+            This automated PR updates the Latest Research section with newly published arXiv papers related to Isaac Gym / Isaac Lab.
+
+            - Created by Research Bot on a schedule or manual dispatch.
+            - Marked as draft and requires maintainer approval to merge.
+            - Content between markers is managed automatically:
+              `<!-- research-bot:start -->` … `<!-- research-bot:end -->`.
+
+            If the changes look good, convert this PR from Draft and merge.
+          labels: |
+            bot
+            needs-approval
+          draft: true
+

.research-bot.yaml

@@ -0,0 +1,28 @@
+"""
+Configuration for the Research Bot.
+If PyYAML is not available in your Actions runner, this file will be ignored
+and defaults in the script will be used. The provided workflow installs PyYAML.
+"""
+
+# Search queries for arXiv (joined with OR across queries)
+queries:
+  - "\"isaac gym\""
+  - omniisaac
+  - "\"isaac lab\""
+  - "\"omni isaac\""
+
+# Look back this many days for new papers
+days_back: 14
+
+# Max results fetched per query from arXiv API
+max_results: 25
+
+# Max items to include in the README section per run
+output_count: 10
+
+# README path to update
+readme_path: README.md
+
+# Section title to add/update. Content between markers is managed by the bot.
+section_title: "## 🧠 Latest Research (auto-updated)"
+

README.md

@@ -366,6 +366,14 @@ Comprehensive tutorial series from RSS 2021 Workshop:
 
 ---
 
+## 🤖 Automated Research Updates
+
+- Source: arXiv queries for “isaac gym”, “omni isaac”, and “isaac lab”.
+- Schedule: weekly (Mon 09:00 UTC) or manual via Actions “Research Bot”.
+- Output: updates content between the ‘research-bot:start’ and ‘research-bot:end’ markers in this README.
+- Safety: opens a Draft PR labeled “needs-approval”; nothing merges automatically.
+- Config: edit `.research-bot.yaml` to adjust queries and limits.
+
 ## 🌟 Contributing
 
 Contributions are welcome! Please read our [contribution guidelines](CONTRIBUTING.md) before submitting a pull request.