unreal-engine-mcp-server 0.4.6 → 0.5.0

package/.github/release-drafter.yml

@@ -0,0 +1,148 @@
+name: Release Drafter
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  update_release_draft:
+    permissions:
+      contents: write
+      pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Run Release Drafter
+        id: release_drafter
+        uses: release-drafter/release-drafter@v6
+        with:
+          config-name: release-drafter.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Get commits not in PRs
+        id: orphan_commits
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const { execSync } = require('child_process');
+            
+            // Get the last release tag
+            let lastTag;
+            try {
+              const { data: releases } = await github.rest.repos.listReleases({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                per_page: 1
+              });
+              lastTag = releases[0]?.tag_name;
+            } catch (e) {
+              lastTag = null;
+            }
+            
+            // Get all commits since last release
+            const range = lastTag ? `${lastTag}..HEAD` : 'HEAD~50..HEAD';
+            let commits;
+            try {
+              commits = execSync(`git log ${range} --pretty=format:"%H|%s|%an" --no-merges`, { encoding: 'utf-8' })
+                .split('\n')
+                .filter(Boolean)
+                .map(line => {
+                  const [sha, message, author] = line.split('|');
+                  return { sha, message, author };
+                });
+            } catch (e) {
+              commits = [];
+            }
+            
+            if (commits.length === 0) {
+              core.setOutput('orphan_commits', '');
+              return;
+            }
+            
+            // Get all PRs merged since last release to filter out PR commits
+            const { data: prs } = await github.rest.pulls.list({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'closed',
+              sort: 'updated',
+              direction: 'desc',
+              per_page: 100
+            });
+            
+            // Get commit SHAs that are part of PRs
+            const prCommitShas = new Set();
+            for (const pr of prs.filter(p => p.merged_at)) {
+              try {
+                const { data: prCommits } = await github.rest.pulls.listCommits({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  pull_number: pr.number
+                });
+                prCommits.forEach(c => prCommitShas.add(c.sha));
+              } catch (e) {
+                // Skip if error
+              }
+            }
+            
+            // Filter to only orphan commits (not in any PR)
+            const orphanCommits = commits.filter(c => !prCommitShas.has(c.sha));
+            
+            if (orphanCommits.length === 0) {
+              core.setOutput('orphan_commits', '');
+              return;
+            }
+            
+            // Format orphan commits
+            const formatted = orphanCommits
+              .map(c => `- ${c.message} (${c.sha.substring(0, 7)}) @${c.author}`)
+              .join('\n');
+            
+            core.setOutput('orphan_commits', formatted);
+            core.info(`Found ${orphanCommits.length} commits not in PRs`);
+
+      - name: Update release body with commits
+        if: steps.orphan_commits.outputs.orphan_commits != ''
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const releaseId = '${{ steps.release_drafter.outputs.id }}';
+            const orphanCommits = `${{ steps.orphan_commits.outputs.orphan_commits }}`;
+            
+            if (!releaseId || !orphanCommits) return;
+            
+            // Get current release body
+            const { data: release } = await github.rest.repos.getRelease({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              release_id: parseInt(releaseId)
+            });
+            
+            // Check if commits section already exists
+            if (release.body && release.body.includes('## Direct Commits')) {
+              core.info('Commits section already exists, skipping');
+              return;
+            }
+            
+            // Append commits section
+            const newBody = `${release.body || ''}\n\n## Direct Commits\n\n${orphanCommits}`;
+            
+            await github.rest.repos.updateRelease({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              release_id: parseInt(releaseId),
+              body: newBody
+            });
+            
+            core.info('Added orphan commits to release draft');

package/.github/workflows/auto-merge.yml

@@ -0,0 +1,38 @@
+name: Auto-merge Dependabot PRs
+
+on: pull_request
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  dependabot:
+    runs-on: ubuntu-latest
+    if: github.actor == 'dependabot[bot]'
+    steps:
+      - name: Dependabot metadata
+        id: metadata
+        uses: dependabot/fetch-metadata@v2
+        with:
+          github-token: "${{ secrets.GITHUB_TOKEN }}"
+
+      - name: Approve patch and minor npm updates
+        if: |
+          steps.metadata.outputs.package-ecosystem == 'npm' &&
+          (steps.metadata.outputs.update-type == 'version-update:semver-patch' || 
+           steps.metadata.outputs.update-type == 'version-update:semver-minor')
+        run: gh pr review --approve "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Enable auto-merge for npm Dependabot PRs
+        if: |
+          steps.metadata.outputs.package-ecosystem == 'npm' &&
+          (steps.metadata.outputs.update-type == 'version-update:semver-patch' || 
+           steps.metadata.outputs.update-type == 'version-update:semver-minor')
+        run: gh pr merge --auto --squash "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+permissions:
+  contents: read
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint (TS)
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: Setup Node.js
+        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        with:
+          node-version: '18'
+
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint (TypeScript/JavaScript)
+        run: |
+          echo "Running ESLint (fail on warnings)"
+          npx eslint . --ext .ts --max-warnings=0
+
+

package/.github/workflows/dependency-review.yml

@@ -0,0 +1,17 @@
+name: 'Dependency Review'
+on: [pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  dependency-review:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 'Checkout Repository'
+        uses: actions/checkout@v6 # v4
+      - name: 'Dependency Review'
+        uses: actions/dependency-review-action@v4 # v4
+        with:
+          fail-on-severity: high
+          deny-licenses: GPL-3.0, AGPL-1.0, AGPL-3.0

package/.github/workflows/gemini-issue-triage.yml

@@ -0,0 +1,172 @@
+name: '🏷️ Gemini Issue Triage'
+
+on:
+  issues:
+    types:
+      - 'opened'
+      - 'reopened'
+  workflow_dispatch:
+    inputs:
+      issue_number:
+        description: 'Issue number to triage'
+        required: true
+        type: 'number'
+
+concurrency:
+  group: '${{ github.workflow }}-${{ github.event.issue.number || github.event.inputs.issue_number }}'
+  cancel-in-progress: true
+
+permissions:
+  contents: 'read'
+  issues: 'write'
+
+jobs:
+  triage-issue:
+    if: |-
+      github.event_name == 'workflow_dispatch' ||
+      (
+        github.event_name == 'issues' &&
+        contains(github.event.issue.labels.*.name, 'needs-triage')
+      )
+    timeout-minutes: 5
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: 'Get issue data for manual trigger'
+        id: 'get_issue_data'
+        if: github.event_name == 'workflow_dispatch'
+        uses: 'actions/github-script@v8'
+        with:
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          script: |
+            const { data: issue } = await github.rest.issues.get({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: ${{ github.event.inputs.issue_number }},
+            });
+            core.setOutput('title', issue.title);
+            core.setOutput('body', issue.body);
+            core.setOutput('labels', issue.labels.map(label => label.name).join(','));
+            return issue;
+
+      - name: 'Checkout'
+        uses: 'actions/checkout@v6'
+
+      - name: 'Get Repository Labels'
+        id: 'get_labels'
+        uses: 'actions/github-script@v8'
+        with:
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          script: |
+            const { data: labels } = await github.rest.issues.listLabelsForRepo({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+            });
+            // Filter to area labels
+            const areaLabels = labels.map(l => l.name).filter(n => 
+              n.startsWith('area/') || n.startsWith('tool/') || n.startsWith('type/')
+            );
+            core.setOutput('available_labels', areaLabels.join(','));
+            core.info(`Found ${areaLabels.length} area labels: ${areaLabels.join(', ')}`);
+
+      - name: Analyze Issue with Gemini
+        id: gemini_analysis
+        uses: google-github-actions/run-gemini-cli@v0 # v0
+        env:
+          GITHUB_TOKEN: ''  # No auth token for untrusted input analysis
+          ISSUE_TITLE: '${{ github.event_name == ''workflow_dispatch'' && steps.get_issue_data.outputs.title || github.event.issue.title }}'
+          ISSUE_BODY: '${{ github.event_name == ''workflow_dispatch'' && steps.get_issue_data.outputs.body || github.event.issue.body }}'
+          AVAILABLE_LABELS: '${{ steps.get_labels.outputs.available_labels }}'
+        with:
+          # Use Gemini API key only (free tier) - no Vertex AI
+          gemini_api_key: '${{ secrets.GEMINI_API_KEY }}'
+          settings: |
+            {
+              "maxSessionTurns": 10
+            }
+          prompt: |
+            ## Role
+            You are an issue triage assistant for Unreal Engine MCP Server.
+
+            ## Task
+            Analyze this GitHub issue and select the most appropriate label.
+
+            Issue Title: ${{ env.ISSUE_TITLE }}
+            Issue Body: ${{ env.ISSUE_BODY }}
+            
+            Available Labels: ${{ env.AVAILABLE_LABELS }}
+
+            ## Area Definitions
+            - area/plugin: Issues with the C++ McpAutomationBridge plugin
+            - area/server: Issues with the Node.js MCP server
+            - area/tools: Issues with specific tool implementations
+            - area/testing: Issues with tests or test infrastructure
+            - area/docs: Documentation issues
+            - type/bug: Bug reports
+            - type/enhancement: Feature requests
+            - type/question: Questions or support requests
+
+            ## Output
+            Select exactly ONE label. Output only valid JSON:
+            {"label": "area/server"}
+
+      - name: 'Apply Label'
+        if: steps.gemini_analysis.outputs.summary != ''
+        uses: 'actions/github-script@v8'
+        env:
+          ISSUE_NUMBER: '${{ github.event.issue.number || github.event.inputs.issue_number }}'
+          GEMINI_OUTPUT: '${{ steps.gemini_analysis.outputs.summary }}'
+          AVAILABLE_LABELS: '${{ steps.get_labels.outputs.available_labels }}'
+        with:
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          script: |
+            const fs = require('fs');
+            const summary = process.env.GEMINI_OUTPUT;
+            
+            // Parse Gemini output for labels
+            let parsed = {};
+            try {
+              // Try to find JSON block
+              const match = summary.match(/```json\n([\s\S]*?)\n```/);
+              if (match) {
+                parsed = JSON.parse(match[1]);
+              } else {
+                 parsed = JSON.parse(summary);
+              }
+            } catch (e) {
+              core.warning('Failed to parse Gemini output as JSON');
+              return;
+            }
+            
+            const label = parsed.label;
+            if (!label) {
+               core.warning('No label returned from Gemini');
+               return;
+            }
+
+            const availableLabels = (process.env.AVAILABLE_LABELS || '').split(',');
+            if (!availableLabels.includes(label)) {
+              core.warning(`Label '${label}' not in available labels; skipping`);
+              return;
+            }
+            
+            const issueNumber = parseInt(process.env.ISSUE_NUMBER);
+            
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: issueNumber,
+              labels: [label]
+            });
+            core.info(`Added label '${label}' to issue #${issueNumber}`);
+            
+            // Remove needs-triage label
+            try {
+              await github.rest.issues.removeLabel({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: issueNumber,
+                name: 'needs-triage'
+              });
+            } catch (e) {
+              if (e.status !== 404) throw e;
+            }

package/.github/workflows/greetings.yml

@@ -0,0 +1,23 @@
+name: Greetings
+
+on: [pull_request_target, issues]
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  greeting:
+    runs-on: ubuntu-latest
+    # Skip for bots and repository owner
+    if: >-
+      github.actor != 'dependabot[bot]' &&
+      github.actor != 'renovate[bot]' &&
+      github.actor != 'github-actions[bot]' &&
+      github.actor != github.repository_owner
+    steps:
+    - uses: actions/first-interaction@v3
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        issue-message: '👋 Thanks for opening this issue! We appreciate your feedback and report. A maintainer will check this out soon.'
+        pr-message: '👋 Thanks for your first Pull Request! We love contributions. Please ensure you have signed off your commits and followed the contribution guidelines.'

package/.github/workflows/labeler.yml

@@ -0,0 +1,16 @@
+name: "Pull Request Labeler"
+on:
+  - pull_request_target
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  triage:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/labeler@v6
+      with:
+        repo-token: "${{ secrets.GITHUB_TOKEN }}"
+        sync-labels: true

package/.github/workflows/links.yml

@@ -0,0 +1,80 @@
+name: '🔗 Check Broken Links'
+
+on:
+  push:
+    branches: ['main']
+    paths:
+      - '**.md'
+      - 'docs/**'
+  pull_request:
+    branches: ['main']
+    paths:
+      - '**.md'
+      - 'docs/**'
+  schedule:
+    - cron: '0 0 * * 0'
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: 'read'
+  issues: 'write'
+
+jobs:
+  check-links:
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: 'Checkout'
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: 'Check for broken links'
+        uses: lycheeverse/lychee-action@a8c4c7cb88f0c7386610c35eb25108e448569cb0 # v2.7.0
+        with:
+          args: >-
+            --verbose
+            --no-progress
+            --exclude '^https://github.com/.*/issues/new'
+            --exclude '^https://github.com/.*/compare/'
+            --exclude 'localhost'
+            --exclude '127.0.0.1'
+            --exclude 'file://'
+            --exclude 'npmjs.com'
+            --exclude 'unrealengine.com'
+            --exclude 'rustwasm.github.io'
+            --exclude 'github.com/modelcontextprotocol/sdk'
+
+            '**/*.md'
+            'docs/**'
+          fail: true
+
+      - name: 'Create issue on failure'
+        if: failure() && github.event_name == 'schedule'
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        with:
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          script: |
+            const title = '🔗 Broken links detected in documentation';
+            const body = `The weekly link check found broken links in the documentation.
+            
+            Please review the [workflow run](${process.env.GITHUB_SERVER_URL}/${process.env.GITHUB_REPOSITORY}/actions/runs/${process.env.GITHUB_RUN_ID}) for details.`;
+            
+            const { data: issues } = await github.rest.issues.listForRepo({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'open',
+              labels: 'area/docs'
+            });
+            
+            const existingIssue = issues.find(i => i.title === title);
+            if (!existingIssue) {
+              await github.rest.issues.create({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                title: title,
+                body: body,
+                labels: ['area/docs', 'type/bug']
+              });
+            }

package/.github/workflows/pr-size-labeler.yml

@@ -0,0 +1,137 @@
+name: '📏 Gemini PR Size Labeler'
+
+on:
+  pull_request_target:
+    types: ['opened', 'reopened', 'synchronize']
+
+permissions:
+  pull-requests: 'write'
+  contents: 'read'
+
+concurrency:
+  group: '${{ github.workflow }}-${{ github.event.pull_request.number }}'
+  cancel-in-progress: true
+
+jobs:
+  label-pr:
+    timeout-minutes: 5
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: 'Get PR diff stats'
+        id: 'diff_stats'
+        uses: 'actions/github-script@v8'
+        with:
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          script: |
+            const { data: pr } = await github.rest.pulls.get({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.payload.pull_request.number
+            });
+            
+            const additions = pr.additions || 0;
+            const deletions = pr.deletions || 0;
+            const totalChanges = additions + deletions;
+            const filesChanged = pr.changed_files || 0;
+            
+            core.setOutput('total_changes', totalChanges);
+            core.setOutput('files_changed', filesChanged);
+            core.setOutput('additions', additions);
+            core.setOutput('deletions', deletions);
+            
+            core.info(`PR #${pr.number}: +${additions} -${deletions} (${totalChanges} total) in ${filesChanged} files`);
+
+      - name: 'Determine size label'
+        id: 'size_label'
+        run: |
+          TOTAL=${{ steps.diff_stats.outputs.total_changes }}
+          
+          if [ $TOTAL -lt 10 ]; then
+            echo "size_label=size/xs" >> $GITHUB_OUTPUT
+          elif [ $TOTAL -lt 50 ]; then
+            echo "size_label=size/s" >> $GITHUB_OUTPUT
+          elif [ $TOTAL -lt 200 ]; then
+            echo "size_label=size/m" >> $GITHUB_OUTPUT
+          elif [ $TOTAL -lt 1000 ]; then
+            echo "size_label=size/l" >> $GITHUB_OUTPUT
+          else
+            echo "size_label=size/xl" >> $GITHUB_OUTPUT
+          fi
+
+      - name: 'Apply size label'
+        uses: 'actions/github-script@v8'
+        env:
+          SIZE_LABEL: '${{ steps.size_label.outputs.size_label }}'
+        with:
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          script: |
+            const prNumber = context.payload.pull_request.number;
+            const newLabel = process.env.SIZE_LABEL;
+            
+            // Get current labels
+            const { data: currentLabels } = await github.rest.issues.listLabelsOnIssue({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: prNumber
+            });
+            
+            // Remove old size labels
+            const sizeLabels = ['size/xs', 'size/s', 'size/m', 'size/l', 'size/xl'];
+            for (const label of currentLabels) {
+              if (sizeLabels.includes(label.name) && label.name !== newLabel) {
+                await github.rest.issues.removeLabel({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: prNumber,
+                  name: label.name
+                });
+                core.info(`Removed old label: ${label.name}`);
+              }
+            }
+            
+            // Add new size label
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: prNumber,
+              labels: [newLabel]
+            });
+            core.info(`Applied label: ${newLabel}`);
+
+      - name: 'Comment on large PRs'
+        if: steps.size_label.outputs.size_label == 'size/xl'
+        uses: 'actions/github-script@v8'
+        with:
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          script: |
+            const prNumber = context.payload.pull_request.number;
+            
+            // Check if we already commented
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: prNumber
+            });
+            
+            const botComment = comments.find(c => 
+              c.user && c.user.login && c.user.login.includes('[bot]') && 
+              c.body.includes('This pull request is quite large')
+            );
+            
+            if (!botComment) {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: prNumber,
+                body: `## 📏 Large PR Detected
+            
+            This pull request is quite large (1000+ lines changed), which can make reviewing challenging.
+            
+            **Suggestions:**
+            - Consider breaking this into smaller, focused PRs
+            - Separate refactoring from new features
+            - Split bug fixes from feature additions
+            
+            This helps reviewers provide better feedback and speeds up the merge process. Thank you! 🙏`
+              });
+            }