com.wallstop-studios.dxmessaging 2.0.0-rc27.1 → 2.0.0-rc27.3

package/.csharpierignore

@@ -0,0 +1 @@
+Runtime/Binaries/*.xml

package/.csharpierrc.json

@@ -0,0 +1,3 @@
+{
+  "endOfLine": "crlf"
+}

package/.editorconfig

@@ -1,6 +1,6 @@
 
 [*]
-charset = utf-8-bom
+charset = utf-8
 end_of_line = crlf
 trim_trailing_whitespace = false
 insert_final_newline = false

package/.gitattributes

@@ -1,10 +1,32 @@
 ###############################################################################
-# Normalize line endings and enforce CRLF in working trees across platforms.
-# This aligns with .editorconfig (end_of_line = crlf) and keeps checkouts
-# consistent regardless of OS or user git settings.
+# Line endings
+#
+# Enforce CRLF in the working tree for all text files to align with
+# .editorconfig (end_of_line = crlf, charset = utf-8 without BOM) and avoid
+# formatter diffs on Linux runners.
 ###############################################################################
 * text=auto eol=crlf
 
+# Be explicit for common text file types in this repo
+*.cs        text eol=crlf
+*.csproj    text eol=crlf
+*.sln       text eol=crlf
+*.json      text eol=crlf
+*.yaml      text eol=crlf
+*.yml       text eol=crlf
+*.md        text eol=crlf
+*.xml       text eol=crlf
+*.uxml      text eol=crlf
+*.uss       text eol=crlf
+*.shader    text eol=crlf
+*.hlsl      text eol=crlf
+*.compute   text eol=crlf
+*.cginc     text eol=crlf
+*.asmdef    text eol=crlf
+*.asmref    text eol=crlf
+*.meta      text eol=crlf
+*.ps1       text eol=crlf
+
 ###############################################################################
 # Set default behavior for command prompt diff.
 #

package/.github/dependabot.yml

@@ -1,10 +1,32 @@
 version: 2
 updates:
+  # GitHub Actions workflow updates
   - package-ecosystem: "github-actions"
     directory: "/"
     schedule:
-      interval: "weekly"
+      interval: "daily"
     assignees:
       - wallstop
     reviewers:
-      - wallstop
+      - wallstop
+
+  # NuGet: .csproj/props/targets and .config/dotnet-tools.json (local tools)
+  - package-ecosystem: "nuget"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    assignees:
+      - wallstop
+    reviewers:
+      - wallstop
+
+  # npm/UPM: package.json at repo root (Unity package manifest)
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    versioning-strategy: increase
+    assignees:
+      - wallstop
+    reviewers:
+      - wallstop

package/.github/workflows/csharpier-autofix.yml

@@ -16,39 +16,41 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
 
       - name: Setup .NET
-        uses: actions/setup-dotnet@v4
+        uses: actions/setup-dotnet@v5
         with:
-          dotnet-version: '8.0.x'
+          dotnet-version: "8.0.x"
 
       - name: Restore .NET tools
         run: dotnet tool restore
 
       - name: Run CSharpier (format repository)
-        if: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository }}
+        if: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && github.event.pull_request.user.login == 'dependabot[bot]' }}
         run: dotnet tool run csharpier format
 
-      - name: Commit formatting changes to PR branch (same-repo PRs only)
-        if: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository }}
-        uses: stefanzweifel/git-auto-commit-action@v5
+      - name: Commit formatting changes to PR branch (Dependabot only)
+        if: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && github.event.pull_request.user.login == 'dependabot[bot]' }}
+        uses: stefanzweifel/git-auto-commit-action@v7
         with:
-          commit_message: 'chore(format): apply CSharpier formatting'
+          commit_message: "chore(format): apply CSharpier formatting"
           branch: ${{ github.head_ref }}
+          file_pattern: |
+            **/*.cs
 
       - name: Verify formatting (CI gate)
         run: dotnet tool run csharpier check .
 
   format_fork:
-    name: Fork PR bot formatting PR
-    if: ${{ github.event_name == 'pull_request_target' && github.event.pull_request.head.repo.full_name != github.repository }}
+    name: Fork PR bot formatting PR (Dependabot only)
+    if: ${{ github.event_name == 'pull_request_target' && github.event.pull_request.head.repo.full_name != github.repository && github.event.pull_request.user.login == 'dependabot[bot]' }}
     runs-on: ubuntu-latest
     steps:
       - name: Checkout fork PR HEAD
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           repository: ${{ github.event.pull_request.head.repo.full_name }}
           ref: ${{ github.event.pull_request.head.ref }}
@@ -56,9 +58,9 @@ jobs:
           fetch-depth: 0
 
       - name: Setup .NET
-        uses: actions/setup-dotnet@v4
+        uses: actions/setup-dotnet@v5
         with:
-          dotnet-version: '8.0.x'
+          dotnet-version: "8.0.x"
 
       - name: Install CSharpier (pinned)
         run: dotnet tool install -g csharpier --version 1.1.2
@@ -88,7 +90,8 @@ jobs:
           git config user.name "github-actions[bot]"
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git checkout -B "$BRANCH"
-          git add -A
+          # Only stage C# files to avoid touching workflow YAML (requires special permissions)
+          git add '**/*.cs'
           git commit -m "chore(format): apply CSharpier formatting for PR #${{ github.event.pull_request.number }}"
           git remote add upstream "https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git"
           git fetch upstream
@@ -97,7 +100,7 @@ jobs:
 
       - name: Open or update formatting PR in base repo
         if: steps.changes.outputs.has_changes == 'true'
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const prNumber = context.payload.pull_request.number;
@@ -123,7 +126,7 @@ jobs:
 
       - name: Comment link on original PR
         if: steps.changes.outputs.has_changes == 'true'
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const prNumber = context.payload.pull_request.number;
@@ -136,7 +139,13 @@ jobs:
               const body = `A formatting PR has been opened: #${fmtPr.number} (applies CSharpier to this PR).`;
               // Avoid duplicate comments by checking recent comments
               const comments = await github.rest.issues.listComments({ owner, repo, issue_number: prNumber, per_page: 50 });
-              const already = comments.data.some(c => c.body && c.body.includes(`#${fmtPr.number}`) && c.user && c.user.login === 'github-actions[bot]');
+              const already = comments.data.some(
+                (c) =>
+                  c.body &&
+                  c.body.includes(`#${fmtPr.number}`) &&
+                  c.user &&
+                  c.user.login === 'github-actions[bot]'
+              );
               if (!already) {
                 await github.rest.issues.createComment({ owner, repo, issue_number: prNumber, body });
               }

package/.github/workflows/format-on-demand.yml

@@ -0,0 +1,305 @@
+name: Opt-in Formatting
+
+on:
+  issue_comment:
+    types: [created]
+  workflow_dispatch:
+    inputs:
+      pr_number:
+        description: PR number to format
+        required: true
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  by_comment:
+    name: Run on /format comment
+    if: >-
+      ${{ github.event_name == 'issue_comment' &&
+          github.event.action == 'created' &&
+          github.event.issue.pull_request &&
+          (contains(github.event.comment.body, '/format') || contains(github.event.comment.body, '/autofix') || contains(github.event.comment.body, '/lint-fix')) }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Resolve PR metadata and authorize request
+        id: meta
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const prNumber = context.payload.issue.number;
+            const pr = (await github.rest.pulls.get({ ...context.repo, pull_number: prNumber })).data;
+            const commenter = context.payload.comment.user.login;
+            const prAuthor = pr.user.login;
+            const assoc = context.payload.comment.author_association; // OWNER, MEMBER, COLLABORATOR, CONTRIBUTOR, etc.
+
+            const isMaintainer = ['OWNER','MEMBER','COLLABORATOR'].includes(assoc);
+            const isAuthor = commenter === prAuthor;
+            const allowed = isMaintainer || isAuthor;
+
+            core.setOutput('allowed', String(allowed));
+            core.setOutput('pr', String(prNumber));
+            core.setOutput('base_ref', pr.base.ref);
+            core.setOutput('head_repo', pr.head.repo.full_name);
+            core.setOutput('head_ref', pr.head.ref);
+            core.setOutput('same_repo', String(pr.head.repo.full_name === `${context.repo.owner}/${context.repo.repo}`));
+
+      - name: Exit if not authorized
+        if: ${{ steps.meta.outputs.allowed != 'true' }}
+        run: |
+          echo "Commenter is not authorized to trigger formatting." 1>&2
+          exit 1
+
+      - name: Checkout PR branch (same-repo)
+        if: ${{ steps.meta.outputs.same_repo == 'true' }}
+        uses: actions/checkout@v5
+        with:
+          ref: ${{ steps.meta.outputs.head_ref }}
+          fetch-depth: 0
+
+      - name: Checkout PR fork head
+        if: ${{ steps.meta.outputs.same_repo != 'true' }}
+        uses: actions/checkout@v5
+        with:
+          repository: ${{ steps.meta.outputs.head_repo }}
+          ref: ${{ steps.meta.outputs.head_ref }}
+          persist-credentials: false
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: '20'
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Restore .NET tools
+        run: dotnet tool restore
+
+      - name: Apply Prettier fixes
+        run: |
+          npx --yes prettier@3.3.3 --write "**/*.{md,markdown}"
+          npx --yes prettier@3.3.3 --write "**/*.{json,asmdef,asmref}"
+          npx --yes prettier@3.3.3 --write "**/*.{yml,yaml}"
+
+      - name: Apply markdownlint fixes
+        run: |
+          npx --yes markdownlint-cli@0.40.0 "**/*.md" "**/*.markdown" --config .markdownlint.json --ignore-path .markdownlintignore --fix
+
+      - name: Apply CSharpier formatting
+        run: dotnet tool run csharpier format
+
+      - name: Detect changes
+        id: changes
+        shell: bash
+        run: |
+          if git diff --quiet; then
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+          else
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Commit changes to PR branch (same-repo)
+        if: ${{ steps.meta.outputs.same_repo == 'true' && steps.changes.outputs.has_changes == 'true' }}
+        uses: stefanzweifel/git-auto-commit-action@v7
+        with:
+          commit_message: "chore(format): apply requested formatting"
+          branch: ${{ steps.meta.outputs.head_ref }}
+          file_pattern: |
+            **/*.cs
+            **/*.md
+            **/*.markdown
+            **/*.json
+            **/*.asmdef
+            **/*.asmref
+
+      - name: Create bot branch and PR (fork)
+        if: ${{ steps.meta.outputs.same_repo != 'true' && steps.changes.outputs.has_changes == 'true' }}
+        shell: bash
+        env:
+          GH_REPO: ${{ github.repository }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euo pipefail
+          BRANCH="bot/format/pr-${{ steps.meta.outputs.pr }}"
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git checkout -B "$BRANCH"
+          # Stage only supported text files; avoid workflows to prevent permission issues
+          git add '**/*.cs' '**/*.md' '**/*.markdown' '**/*.json' '**/*.asmdef' '**/*.asmref'
+          git commit -m "chore(format): apply requested formatting for PR #${{ steps.meta.outputs.pr }}"
+          git remote add upstream "https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git"
+          git fetch upstream
+          git push upstream "$BRANCH" --force
+
+      - name: Open/Update formatting PR (fork)
+        if: ${{ steps.meta.outputs.same_repo != 'true' && steps.changes.outputs.has_changes == 'true' }}
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const prNumber = Number(core.getInput('pr')) || Number('${{ steps.meta.outputs.pr }}');
+            const baseRef = '${{ steps.meta.outputs.base_ref }}';
+            const headBranch = `bot/format/pr-${prNumber}`;
+            const {owner, repo} = context.repo;
+            const title = `chore(format): Apply formatting to PR #${prNumber}`;
+            const body = [
+              `This automated PR applies Prettier/markdownlint/CSharpier formatting to the changes from PR #${prNumber}.`,
+              '',
+              `- Source PR (fork): #${prNumber}`,
+              `- Target branch: ${baseRef}`,
+            ].join('\n');
+            const existing = await github.rest.pulls.list({ owner, repo, state: 'open', head: `${owner}:${headBranch}` });
+            if (existing.data.length === 0) {
+              await github.rest.pulls.create({ owner, repo, head: headBranch, base: baseRef, title, body });
+            }
+
+      - name: Comment result on PR
+        if: ${{ steps.changes.outputs.has_changes == 'true' }}
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const prNumber = Number('${{ steps.meta.outputs.pr }}');
+            const sameRepo = '${{ steps.meta.outputs.same_repo }}' === 'true';
+            const body = sameRepo
+              ? 'Applied formatting as requested and pushed commits to this PR branch.'
+              : 'Opened a formatting PR against the base repository with requested fixes.';
+            await github.rest.issues.createComment({ ...context.repo, issue_number: prNumber, body });
+
+      - name: No-op comment (nothing to change)
+        if: ${{ steps.changes.outputs.has_changes != 'true' }}
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const prNumber = Number('${{ steps.meta.outputs.pr }}');
+            const body = 'No formatting changes were necessary.';
+            await github.rest.issues.createComment({ ...context.repo, issue_number: prNumber, body });
+
+  by_dispatch:
+    name: Run via manual dispatch
+    if: ${{ github.event_name == 'workflow_dispatch' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Resolve PR metadata
+        id: meta
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const prNumber = Number(core.getInput('pr_number'));
+            if (!prNumber) core.setFailed('pr_number is required');
+            const pr = (await github.rest.pulls.get({ ...context.repo, pull_number: prNumber })).data;
+            core.setOutput('pr', String(prNumber));
+            core.setOutput('base_ref', pr.base.ref);
+            core.setOutput('head_repo', pr.head.repo.full_name);
+            core.setOutput('head_ref', pr.head.ref);
+            core.setOutput('same_repo', String(pr.head.repo.full_name === `${context.repo.owner}/${context.repo.repo}`));
+
+      - name: Checkout PR branch (same-repo)
+        if: ${{ steps.meta.outputs.same_repo == 'true' }}
+        uses: actions/checkout@v5
+        with:
+          ref: ${{ steps.meta.outputs.head_ref }}
+          fetch-depth: 0
+
+      - name: Checkout PR fork head
+        if: ${{ steps.meta.outputs.same_repo != 'true' }}
+        uses: actions/checkout@v5
+        with:
+          repository: ${{ steps.meta.outputs.head_repo }}
+          ref: ${{ steps.meta.outputs.head_ref }}
+          persist-credentials: false
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: '20'
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Restore .NET tools
+        run: dotnet tool restore
+
+      - name: Apply Prettier fixes
+        run: |
+          npx --yes prettier@3.3.3 --write "**/*.{md,markdown}"
+          npx --yes prettier@3.3.3 --write "**/*.{json,asmdef,asmref}"
+          npx --yes prettier@3.3.3 --write "**/*.{yml,yaml}"
+
+      - name: Apply markdownlint fixes
+        run: |
+          npx --yes markdownlint-cli@0.40.0 "**/*.md" "**/*.markdown" --config .markdownlint.json --ignore-path .markdownlintignore --fix
+
+      - name: Apply CSharpier formatting
+        run: dotnet tool run csharpier format
+
+      - name: Detect changes
+        id: changes
+        shell: bash
+        run: |
+          if git diff --quiet; then
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+          else
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Commit changes to PR branch (same-repo)
+        if: ${{ steps.meta.outputs.same_repo == 'true' && steps.changes.outputs.has_changes == 'true' }}
+        uses: stefanzweifel/git-auto-commit-action@v7
+        with:
+          commit_message: "chore(format): apply requested formatting"
+          branch: ${{ steps.meta.outputs.head_ref }}
+          file_pattern: |
+            **/*.cs
+            **/*.md
+            **/*.markdown
+            **/*.json
+            **/*.asmdef
+            **/*.asmref
+
+      - name: Create bot branch and PR (fork)
+        if: ${{ steps.meta.outputs.same_repo != 'true' && steps.changes.outputs.has_changes == 'true' }}
+        shell: bash
+        env:
+          GH_REPO: ${{ github.repository }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euo pipefail
+          BRANCH="bot/format/pr-${{ steps.meta.outputs.pr }}"
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git checkout -B "$BRANCH"
+          # Stage only supported text files; avoid workflows to prevent permission issues
+          git add '**/*.cs' '**/*.md' '**/*.markdown' '**/*.json' '**/*.asmdef' '**/*.asmref'
+          git commit -m "chore(format): apply requested formatting for PR #${{ steps.meta.outputs.pr }}"
+          git remote add upstream "https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git"
+          git fetch upstream
+          git push upstream "$BRANCH" --force
+
+      - name: Open/Update formatting PR (fork)
+        if: ${{ steps.meta.outputs.same_repo != 'true' && steps.changes.outputs.has_changes == 'true' }}
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const prNumber = Number('${{ steps.meta.outputs.pr }}');
+            const baseRef = '${{ steps.meta.outputs.base_ref }}';
+            const headBranch = `bot/format/pr-${prNumber}`;
+            const {owner, repo} = context.repo;
+            const title = `chore(format): Apply formatting to PR #${prNumber}`;
+            const body = [
+              `This automated PR applies Prettier/markdownlint/CSharpier formatting to the changes from PR #${prNumber}.`,
+              '',
+              `- Source PR (fork): #${prNumber}`,
+              `- Target branch: ${baseRef}`,
+            ].join('\n');
+            const existing = await github.rest.pulls.list({ owner, repo, state: 'open', head: `${owner}:${headBranch}` });
+            if (existing.data.length === 0) {
+              await github.rest.pulls.create({ owner, repo, head: headBranch, base: baseRef, title, body });
+            }
+

package/.github/workflows/json-format-check.yml

@@ -4,7 +4,7 @@ on:
   pull_request:
   push:
     branches:
-      - master
+      - main
   workflow_dispatch:
 
 jobs:
@@ -13,13 +13,22 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Setup Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
-          node-version: '20'
+          node-version: "20"
+          cache: 'npm'
+          cache-dependency-path: package.json
 
-      - name: Prettier check (repo-wide)
-        run: npx -y prettier@3.3.3 --check "**/*.{json,asmdef}"
+      - name: Install dependencies
+        run: |
+          if [ -f package-lock.json ]; then
+            npm ci
+          else
+            npm i --no-audit --no-fund
+          fi
 
+      - name: Prettier check (JSON / asmdef)
+        run: npm run format:json:check

package/.github/workflows/lint-doc-links.yml

@@ -0,0 +1,30 @@
+name: Lint Docs Links
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Run Markdown link linter
+        shell: pwsh
+        run: ./scripts/lint-doc-links.ps1 -VerboseOutput
+
+      - name: Check dead links (lychee)
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: >-
+            -c .lychee.toml
+            --no-progress
+            --include-fragments
+            --verbose
+            "./**/*.md"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/markdown-json.yml

@@ -0,0 +1,45 @@
+name: Markdown & JSON Lint/Format
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: package.json
+
+      - name: Install dependencies
+        run: |
+          if [ -f package-lock.json ]; then
+            npm ci
+          else
+            npm i --no-audit --no-fund
+          fi
+
+      - name: Prettier check (Markdown)
+        run: npm run format:md:check
+
+      - name: Prettier check (JSON / asmdef / asmref)
+        run: npm run format:json:check
+
+      - name: Markdown lint
+        run: npm run lint:markdown
+
+      - name: Enforce EOL (CRLF) and No BOM
+        shell: pwsh
+        run: ./scripts/check-eol.ps1 -VerboseOutput

package/.github/workflows/markdown-link-text-check.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Validate link text for markdown-to-markdown links
         run: python .github/scripts/check_markdown_links.py .

package/.github/workflows/markdown-link-validity.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Run lychee link checker (repo-wide)
         uses: lycheeverse/lychee-action@v2

package/.github/workflows/markdownlint.yml

@@ -10,11 +10,22 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
-      - name: Run markdownlint (repo-wide)
-        uses: DavidAnson/markdownlint-cli2-action@v11
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
         with:
-          config: .markdownlint.jsonc
-          globs: |
-            ./**/*.md
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: package.json
+
+      - name: Install dependencies
+        run: |
+          if [ -f package-lock.json ]; then
+            npm ci
+          else
+            npm i --no-audit --no-fund
+          fi
+
+      - name: Run markdownlint via npm script (CLI2 + repo config)
+        run: npm run lint:markdown