apache
diff --git a/‎.github/deploy-ecosystem-configs.json‎
Lines changed: 19 additions & 0 deletions b/‎.github/deploy-ecosystem-configs.json‎
Lines changed: 19 additions & 0 deletions
diff --git a/‎.github/workflows/auto-docs.yml‎
Lines changed: 154 additions & 0 deletions b/‎.github/workflows/auto-docs.yml‎
Lines changed: 154 additions & 0 deletions
diff --git a/‎.github/workflows/deploy-ecosystem.yml‎
Lines changed: 185 additions & 0 deletions b/‎.github/workflows/deploy-ecosystem.yml‎
Lines changed: 185 additions & 0 deletions
diff --git a/‎.gitignore‎
Lines changed: 2 additions & 1 deletion b/‎.gitignore‎
Lines changed: 2 additions & 1 deletion
diff --git a/‎.licenserc.yaml‎
Lines changed: 5 additions & 2 deletions b/‎.licenserc.yaml‎
Lines changed: 5 additions & 2 deletions
@@ -0,0 +1,19 @@
+{
+  "projects": [
+    {
+      "name": "Reslens",
+      "path": "ecosystem/monitoring/reslens",
+      "vercel_project_id": "prj_cGTEEoWrPjwmgHT8Oh3GDnt8AV3j"
+    },
+    {
+      "name": "Beacon",
+      "path": "ecosystem/ai-tools/beacon",
+      "vercel_project_id": "prj_k3vjg1KTaQFVhhxasQunxgLNGBbk"
+    },
+    {
+      "name": "Nexus",
+      "path": "ecosystem/ai-tools/nexus",
+      "vercel_project_id":"prj_Kam9DhhjI7zb5yPfrQXfyhGnf5TT"
+    }
+  ]
+}
@@ -0,0 +1,154 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+name: Auto-Generate Documentation
+
+on:
+  push:
+    paths:
+      - 'ecosystem/**'
+    branches:
+      - main
+      - master
+  # Allow manual triggering
+  workflow_dispatch:
+
+jobs:
+  update-docs:
+    runs-on: ubuntu-latest
+    env:
+      # Required by Pocketflow; must be uppercase "GEMINI" to use Gemini-specific path
+      LLM_PROVIDER: GEMINI
+      GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+      GEMINI_MODEL: ${{ secrets.GEMINI_MODEL || 'models/gemini-2.5-pro' }}
+    
+    # Skip if commit message contains [skip docs] (only applicable to push events)
+    # github.event.head_commit is null for workflow_dispatch, so guard with event_name and default string
+    if: ${{ github.event_name != 'push' || !contains(github.event.head_commit.message || '', '[skip docs]') }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 2  # Need at least 2 commits for diff
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          cd ecosystem/pocketflow
+          pip install -r requirements.txt
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Detect changed tools
+        id: detect-tools
+        env:
+          LLM_PROVIDER: GEMINI
+          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+          GEMINI_MODEL: ${{ secrets.GEMINI_MODEL || 'models/gemini-2.5-pro' }}
+        run: |
+          cd ecosystem/pocketflow
+          # Export env vars for Python scripts
+          export GEMINI_API_KEY="$GEMINI_API_KEY"
+          export GEMINI_MODEL="$GEMINI_MODEL"
+          
+          # Detect changed tools
+          CHANGED_TOOLS=$(python3 scripts/detect_changed_tools.py --base-ref HEAD^)
+          
+          if [ -z "$CHANGED_TOOLS" ]; then
+            echo "No tools changed, skipping documentation update"
+            echo "changed=false" >> $GITHUB_OUTPUT
+            exit 0
+          fi
+          
+          # Convert newline-separated list to space-separated for GITHUB_OUTPUT
+          # GITHUB_OUTPUT requires single-line values, so we use spaces as delimiter
+          TOOLS_LIST=$(echo "$CHANGED_TOOLS" | tr '\n' ' ' | sed 's/[[:space:]]*$//')
+          
+          echo "Changed tools: $CHANGED_TOOLS"
+          echo "tools=$TOOLS_LIST" >> $GITHUB_OUTPUT
+          echo "changed=true" >> $GITHUB_OUTPUT
+
+      - name: Generate documentation for changed tools
+        if: steps.detect-tools.outputs.changed == 'true'
+        env:
+          LLM_PROVIDER: GEMINI
+          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+          GEMINI_MODEL: ${{ secrets.GEMINI_MODEL || 'models/gemini-2.5-pro' }}
+        run: |
+          cd ecosystem/pocketflow
+          # Export all env vars to ensure they're available to subprocess calls
+          export LLM_PROVIDER="$LLM_PROVIDER"
+          export GEMINI_API_KEY="$GEMINI_API_KEY"
+          export GEMINI_MODEL="$GEMINI_MODEL"
+          
+          # Read tools from previous step (space-separated)
+          TOOLS="${{ steps.detect-tools.outputs.tools }}"
+          
+          # Process each tool (bash splits on spaces by default)
+          for tool in $TOOLS; do
+            if [ -n "$tool" ]; then
+              echo "Generating documentation for: $tool"
+              python3 scripts/run_pocketflow_for_tool.py \
+                --tool "$tool" \
+                --single-file \
+                --skip-format || echo "Failed to generate docs for $tool"
+            fi
+          done
+
+      - name: Check for changes
+        id: check-changes
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Commit changes
+        if: steps.check-changes.outputs.has_changes == 'true'
+        run: |
+          git add ecosystem/AI-Tooling/beacon/content/*.mdx
+          git commit -m "docs: auto-update documentation [skip docs]" || exit 0
+
+      - name: Create Pull Request
+        if: steps.check-changes.outputs.has_changes == 'true'
+        uses: peter-evans/create-pull-request@v5
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: "docs: auto-update documentation [skip docs]"
+          title: "docs: Auto-update documentation"
+          body: |
+            This PR contains automatically generated documentation updates.
+            
+            **Changed tools:**
+            ${{ steps.detect-tools.outputs.tools }}
+            
+            Generated by Pocketflow based on code changes.
+          branch: auto-docs-update
+          delete-branch: true
+          labels: documentation, automated
+
@@ -0,0 +1,185 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+name: Deploy Ecosystem Projects to Vercel
+
+on:
+  push:
+    branches:
+      - master
+      - development
+    paths:
+      - 'ecosystem/**'
+      - '.github/workflows/deploy-ecosystem.yml'
+      - '.github/deploy-ecosystem-configs.json'
+  workflow_dispatch:
+    inputs:
+      project_name:
+        description: 'Specific project to deploy (leave empty to deploy all changed projects)'
+        required: false
+        type: string
+      force_deploy_all:
+        description: 'Force deploy all projects regardless of changes'
+        required: false
+        type: boolean
+        default: false
+
+jobs:
+  determine-projects:
+    name: Determine Projects to Deploy
+    runs-on: ubuntu-latest
+    container:
+      image: node:20-bookworm-slim
+    outputs:
+      projects: ${{ steps.filter.outputs.projects }}
+      projects_json: ${{ steps.filter.outputs.projects_json }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Read deployment config
+        id: config
+        shell: bash
+        run: |
+          # Read JSON config file and output as multiline string
+          echo "config_json<<EOF" >> "$GITHUB_OUTPUT"
+          cat .github/deploy-ecosystem-configs.json >> "$GITHUB_OUTPUT"
+          echo "EOF" >> "$GITHUB_OUTPUT"
+
+      - name: Filter projects based on inputs
+        id: filter
+        shell: bash
+        run: |
+          # Use Node.js to parse JSON (already available in container)
+          node << 'EOF'
+          const fs = require('fs');
+          const configJson = `${{ steps.config.outputs.config_json }}`;
+          const config = JSON.parse(configJson);
+          
+          const eventName = '${{ github.event_name }}';
+          const projectName = '${{ inputs.project_name }}';
+          const forceDeployAll = '${{ inputs.force_deploy_all }}' === 'true';
+          
+          let projectsToDeploy = [];
+          
+          // Filter out projects with skip: true
+          const availableProjects = config.projects.filter(p => !p.skip);
+          
+          // Manual trigger: deploy specific project or all
+          if (eventName === 'workflow_dispatch') {
+            if (projectName) {
+              const project = availableProjects.find(p => p.name === projectName);
+              if (project) {
+                projectsToDeploy = [project];
+              } else {
+                projectsToDeploy = availableProjects;
+              }
+            } else if (forceDeployAll) {
+              projectsToDeploy = availableProjects;
+            } else {
+              projectsToDeploy = availableProjects;
+            }
+          } else {
+            // For push events, deploy all available projects (excluding skipped ones)
+            projectsToDeploy = availableProjects;
+          }
+          
+          // Output results
+          const outputFile = process.env.GITHUB_OUTPUT;
+          const projectsJson = JSON.stringify(projectsToDeploy);
+          const projectsNames = JSON.stringify(projectsToDeploy.map(p => p.name));
+          
+          fs.appendFileSync(outputFile, `projects_json<<EOF\n${projectsJson}\nEOF\n`);
+          fs.appendFileSync(outputFile, `projects=${projectsNames}\n`);
+          EOF
+
+      - name: Show projects to deploy
+        run: |
+          echo "Projects to deploy: ${{ steps.filter.outputs.projects }}"
+          PROJECTS="${{ steps.filter.outputs.projects }}"
+          if [ "$PROJECTS" = "[]" ]; then
+            echo "No projects to deploy"
+          fi
+
+  deploy:
+    name: Deploy ${{ matrix.project.name }}
+    needs: determine-projects
+    if: needs.determine-projects.outputs.projects != '[]'
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        project: ${{ fromJson(needs.determine-projects.outputs.projects_json) }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Vercel CLI
+        run: npm install --global vercel@latest
+
+      - name: Configure Git for Vercel
+        working-directory: ${{ matrix.project.path }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "support@resilientdb.com"
+
+      - name: Pull Vercel Environment Information
+        working-directory: ${{ matrix.project.path }}
+        env:
+          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
+          VERCEL_ORG_ID: ${{ matrix.project.vercel_org_id || secrets.VERCEL_ORG_ID }}
+          VERCEL_PROJECT_ID: ${{ matrix.project.vercel_project_id }}
+        run: |
+          if [ -n "$VERCEL_PROJECT_ID" ] && [ -n "$VERCEL_ORG_ID" ]; then
+            mkdir -p .vercel
+            echo "$VERCEL_ORG_ID" > .vercel/org-id
+            echo "$VERCEL_PROJECT_ID" > .vercel/project-id
+          fi
+
+          vercel pull --yes --environment=production --token=$VERCEL_TOKEN || echo "Could not pull Vercel config, continuing..."
+
+      - name: Create deployment commit with correct author
+        run: |
+          # Configure git user
+          git config user.name "github-actions[bot]"
+          git config user.email "support@resilientdb.com"
+          # Create an empty commit with correct author for Vercel to see
+          git commit --allow-empty -m "ci: authorize deploy for ${{ matrix.project.name }}" || echo "Skipping commit creation"
+
+      - name: Deploy to Vercel
+        working-directory: ${{ matrix.project.path }}
+        env:
+          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
+        run: vercel deploy --prod --yes --token=$VERCEL_TOKEN
+
+      - name: Deployment Summary
+        if: always()
+        run: |
+          echo "### Deployment: ${{ matrix.project.name }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Path:** ${{ matrix.project.path }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Status:** ${{ job.status }}" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
@@ -20,4 +20,5 @@ apache_release
 resdb/
 100*_db/
 gmon.out
-.history/
+.history/
+service/tools/data/cert
@@ -14,8 +14,11 @@ header:
     - 'dev/.rat-excludes'
     - 'documents/doxygen/.gitignore'
     - 'third_party/loc_script/src/index.js'
-
+    - 'ecosystem/**/*.mdx'
+    - 'ecosystem/**/*.json'
+    - 'ecosystem/**/LICENSE*'
+    - 'ecosystem/monitoring/reslens/src/lib/**'
+    - 'ecosystem/third_party/**'
 
 
   comment: on-failure
-