com.wallstop-studios.dxmessaging 2.1.4 → 2.1.6

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

@@ -2,9 +2,20 @@ name: Markdown Link Text Check
 
 on:
   pull_request:
+    paths:
+      - "**/*.md"
+      - "**/*.markdown"
+      - ".github/scripts/check_markdown_links.py"
+      - ".github/scripts/check_markdown_url_encoding.py"
   push:
     branches:
+      - main
       - master
+    paths:
+      - "**/*.md"
+      - "**/*.markdown"
+      - ".github/scripts/check_markdown_links.py"
+      - ".github/scripts/check_markdown_url_encoding.py"
   workflow_dispatch:
 
 jobs:
@@ -12,7 +23,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Validate link text for markdown-to-markdown links
         run: python .github/scripts/check_markdown_links.py .

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

@@ -2,9 +2,20 @@ name: Markdown Link Validity
 
 on:
   pull_request:
+    paths:
+      - "**/*.md"
+      - "**/*.markdown"
+      - "docs/**"
+      - ".lychee.toml"
   push:
     branches:
+      - main
       - master
+    paths:
+      - "**/*.md"
+      - "**/*.markdown"
+      - "docs/**"
+      - ".lychee.toml"
   workflow_dispatch:
 
 jobs:
@@ -12,7 +23,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Run lychee link checker (repo-wide)
         uses: lycheeverse/lychee-action@v2

package/.github/workflows/markdownlint.yml

@@ -2,21 +2,47 @@ name: Markdown Lint
 
 on:
   pull_request:
+    paths:
+      - "**/*.md"
+      - "**/*.markdown"
+      - ".markdownlint.json"
+      - ".markdownlint-cli2.jsonc"
+      - "package.json"
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - "**/*.md"
+      - "**/*.markdown"
+      - ".markdownlint.json"
+      - ".markdownlint-cli2.jsonc"
+      - "package.json"
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
 jobs:
   markdownlint:
     name: Lint repository Markdown
     runs-on: ubuntu-latest
+    timeout-minutes: 5
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
 
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
-          cache: 'npm'
+          node-version: "20"
+          cache: "npm"
           cache-dependency-path: package.json
 
       - name: Install dependencies

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

@@ -2,9 +2,37 @@ name: Prettier Auto Fix
 
 on:
   pull_request:
+    paths:
+      - "**/*.md"
+      - "**/*.json"
+      - "**/*.asmdef"
+      - "**/*.yml"
+      - "**/*.yaml"
+      - ".github/workflows/**"
+      - ".prettierrc*"
+      - ".markdownlint*"
+      - "package.json"
+      - "package-lock.json"
+      - "scripts/check-eol.ps1"
   pull_request_target:
+    paths:
+      - "**/*.md"
+      - "**/*.json"
+      - "**/*.asmdef"
+      - "**/*.yml"
+      - "**/*.yaml"
+      - ".github/workflows/**"
+      - ".prettierrc*"
+      - ".markdownlint*"
+      - "package.json"
+      - "package-lock.json"
+      - "scripts/check-eol.ps1"
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 permissions:
   contents: write
   pull-requests: write
@@ -14,17 +42,18 @@ jobs:
     name: Format and propose changes
     if: ${{ github.event_name != 'pull_request_target' }}
     runs-on: ubuntu-latest
+    timeout-minutes: 10
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
-          cache: 'npm'
+          node-version: "20"
+          cache: "npm"
           cache-dependency-path: package.json
 
       - name: Install dependencies
@@ -44,22 +73,44 @@ jobs:
 
       - name: Markdownlint (auto-fix)
         if: ${{ github.event.pull_request.user.login == 'dependabot[bot]' }}
-        run: npx --yes markdownlint-cli@0.40.0 "**/*.md" "**/*.markdown" --config .markdownlint.json --ignore-path .markdownlintignore --fix
+        run: npx --yes markdownlint-cli2@0.20.0 "**/*.md" "**/*.markdown" --fix
+
+      - name: Renormalize line endings
+        if: ${{ github.event.pull_request.user.login == 'dependabot[bot]' }}
+        shell: bash
+        run: |
+          # Renormalize each extension separately to avoid "pathspec did not match" failures
+          # when certain file types don't exist or aren't accessible in this checkout context
+          # yaml excluded: dotfiles (.pre-commit-config.yaml) match git ls-files but not git add globs
+          for ext in md json asmdef yml; do
+            if git ls-files "*.$ext" "**/*.$ext" | grep -q .; then
+              git add --renormalize -- "*.$ext" "**/*.$ext"
+            fi
+          done
 
       - 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]' }}
+        id: auto-commit
         uses: stefanzweifel/git-auto-commit-action@v7
         with:
           commit_message: "chore(format): apply Prettier/markdownlint fixes"
           branch: ${{ github.head_ref }}
+          add_options: --renormalize
+          # NOTE: yaml excluded - all .yaml files are dotfiles, which git add patterns don't match
           file_pattern: |
             **/*.md
-            **/*.markdown
             **/*.json
             **/*.asmdef
-            **/*.asmref
             **/*.yml
-            **/*.yaml
+
+      - name: Refresh checkout after auto-commit
+        if: ${{ steps.auto-commit.outputs.changes_detected == 'true' }}
+        env:
+          HEAD_REF: ${{ github.head_ref }}
+        run: |
+          # Fetch the newly pushed commit and checkout to get normalized line endings in working tree
+          git fetch origin "$HEAD_REF"
+          git checkout -f FETCH_HEAD
 
       - name: Prettier check (Markdown)
         run: npm run format:md:check
@@ -81,9 +132,10 @@ jobs:
     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
+    timeout-minutes: 10
     steps:
       - name: Checkout fork PR HEAD
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           repository: ${{ github.event.pull_request.head.repo.full_name }}
           ref: ${{ github.event.pull_request.head.ref }}
@@ -93,8 +145,8 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
-          cache: 'npm'
+          node-version: "20"
+          cache: "npm"
           cache-dependency-path: package.json
 
       - name: Install dependencies
@@ -112,16 +164,28 @@ jobs:
           npm run format:yaml
 
       - name: Markdownlint (auto-fix)
-        run: npx --yes markdownlint-cli@0.40.0 "**/*.md" "**/*.markdown" --config .markdownlint.json --ignore-path .markdownlintignore --fix
+        run: npx --yes markdownlint-cli2@0.20.0 "**/*.md" "**/*.markdown" --fix
+
+      - name: Renormalize line endings
+        shell: bash
+        run: |
+          # Renormalize each extension separately to avoid "pathspec did not match" failures
+          # when certain file types don't exist or aren't accessible in this checkout context
+          # yaml excluded: dotfiles (.pre-commit-config.yaml) match git ls-files but not git add globs
+          for ext in md json asmdef yml; do
+            if git ls-files "*.$ext" "**/*.$ext" | grep -q .; then
+              git add --renormalize -- "*.$ext" "**/*.$ext"
+            fi
+          done
 
       - name: Detect changes
         id: changes
         shell: bash
         run: |
           if git diff --quiet; then
-            echo "has_changes=false" >> $GITHUB_OUTPUT
+            echo "has_changes=false" >> "$GITHUB_OUTPUT"
           else
-            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "has_changes=true" >> "$GITHUB_OUTPUT"
           fi
 
       - name: Create bot branch and push to base repo
@@ -137,12 +201,19 @@ jobs:
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git checkout -B "$BRANCH"
           # Stage only files we format; avoid workflows to prevent permission issues
-          git add '**/*.md' '**/*.markdown' '**/*.json' '**/*.asmdef' '**/*.asmref' '**/*.yml' '**/*.yaml'
+          # Use --renormalize to ensure line endings in git index per .gitattributes
+          # Renormalize each extension separately to avoid "pathspec did not match" failures
+          # yaml excluded: dotfiles (.pre-commit-config.yaml) match git ls-files but not git add globs
+          for ext in md json asmdef yml; do
+            if git ls-files "*.$ext" "**/*.$ext" | grep -q .; then
+              git add --renormalize -- "*.$ext" "**/*.$ext"
+            fi
+          done
           git commit -m "chore(format): apply Prettier/markdownlint fixes 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
           git push upstream "$BRANCH" --force
-          echo "branch=$BRANCH" >> $GITHUB_OUTPUT
+          echo "branch=$BRANCH" >> "$GITHUB_OUTPUT"
 
       - name: Open or update formatting PR in base repo
         if: steps.changes.outputs.has_changes == 'true'

package/.github/workflows/release-drafter.yml

@@ -0,0 +1,135 @@
+name: Release Drafter
+
+on:
+  push:
+    branches:
+      - main
+      - master
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: release-drafter
+  cancel-in-progress: false
+
+jobs:
+  update-release-draft:
+    if: github.repository == 'wallstop/DxMessaging'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Extract version from package.json
+        id: version
+        run: |
+          if [ ! -f package.json ]; then
+            echo "Error: package.json not found"
+            exit 1
+          fi
+          VERSION=$(jq -r '.version // empty' package.json)
+          if [ -z "$VERSION" ]; then
+            echo "Error: version field not found in package.json"
+            exit 1
+          fi
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "Extracted version: $VERSION"
+
+      - name: Extract changelog for version
+        id: changelog
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          echo "Looking for version: $VERSION"
+
+          if [ ! -f CHANGELOG.md ]; then
+            echo "Warning: CHANGELOG.md not found"
+            echo "No changelog file found." > /tmp/changelog_section.md
+            echo "changelog_file=/tmp/changelog_section.md" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # Extract the changelog section for this version
+          # Matches from "## [VERSION]" until the next "## [" or end of file
+          CHANGELOG_CONTENT=$(awk -v ver="$VERSION" '
+            BEGIN { found=0; content="" }
+            /^## \[/ {
+              if (found) exit
+              if (index($0, "[" ver "]") > 0) {
+                found=1
+                next
+              }
+            }
+            found { content = content $0 "\n" }
+            END { print content }
+          ' CHANGELOG.md)
+
+          # Handle empty changelog
+          if [ -z "$CHANGELOG_CONTENT" ] || [ "$CHANGELOG_CONTENT" = $'\n' ]; then
+            CHANGELOG_CONTENT="No changelog entry found for version $VERSION"
+          fi
+
+          # Write to file for multi-line handling
+          echo "$CHANGELOG_CONTENT" > /tmp/changelog_section.md
+          echo "changelog_file=/tmp/changelog_section.md" >> "$GITHUB_OUTPUT"
+
+      - name: Run Release Drafter
+        uses: release-drafter/release-drafter@v6
+        id: release_drafter
+        with:
+          config-name: release-drafter.yml
+          version: ${{ steps.version.outputs.version }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Update release body with changelog
+        uses: actions/github-script@v8
+        env:
+          RELEASE_ID: ${{ steps.release_drafter.outputs.id }}
+          VERSION: ${{ steps.version.outputs.version }}
+          DRAFTER_BODY: ${{ steps.release_drafter.outputs.body }}
+          CHANGELOG_FILE: ${{ steps.changelog.outputs.changelog_file }}
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const fs = require('fs');
+
+            const releaseId = parseInt(process.env.RELEASE_ID, 10);
+            if (!Number.isInteger(releaseId) || releaseId <= 0) {
+              throw new Error('Invalid releaseId: ' + process.env.RELEASE_ID + '. Expected a positive integer.');
+            }
+            const version = process.env.VERSION;
+            const drafterBody = process.env.DRAFTER_BODY || '';
+            const changelogFile = process.env.CHANGELOG_FILE;
+
+            let changelogContent = '';
+            try {
+              changelogContent = fs.readFileSync(changelogFile, 'utf8').trim();
+            } catch (err) {
+              console.log('Warning: Could not read changelog file:', err.message);
+              changelogContent = 'No changelog content available.';
+            }
+
+            const bodyParts = [
+              '## Changelog',
+              '',
+              changelogContent,
+              '',
+              '---',
+              '',
+              drafterBody
+            ];
+            const body = bodyParts.join('\n');
+
+            await github.rest.repos.updateRelease({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              release_id: releaseId,
+              body: body,
+              name: version,
+              tag_name: version
+            });
+
+            console.log('Updated release draft for version ' + version);

package/.github/workflows/spellcheck.yml

@@ -0,0 +1,56 @@
+name: Spellcheck
+
+on:
+  pull_request:
+    paths:
+      - "**/*.md"
+      - "**/*.cs"
+      - "**/*.json"
+      - "**/*.yaml"
+      - "**/*.yml"
+      - "**/*.ps1"
+      - "**/*.js"
+      - ".github/**"
+      - ".llm/**"
+      - ".cspell.json"
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - "**/*.md"
+      - "**/*.cs"
+      - "**/*.json"
+      - "**/*.yaml"
+      - "**/*.yml"
+      - "**/*.ps1"
+      - "**/*.js"
+      - ".github/**"
+      - ".llm/**"
+      - ".cspell.json"
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  spellcheck:
+    name: Check spelling
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - name: Run cspell
+        uses: streetsidesoftware/cspell-action@v8
+        with:
+          strict: true
+          config: '.cspell.json'
+          incremental_files_only: true

package/.github/workflows/sync-wiki.yml

@@ -0,0 +1,139 @@
+name: Sync Wiki
+
+on:
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - 'docs/**'
+      - 'scripts/wiki/**'
+      - '.github/workflows/sync-wiki.yml'
+  workflow_dispatch:
+
+# Prevent concurrent wiki updates
+concurrency:
+  group: wiki-sync
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+
+jobs:
+  validate:
+    name: Validate Wiki Content
+    runs-on: ubuntu-latest
+    outputs:
+      should-deploy: ${{ steps.check.outputs.should-deploy }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 2
+
+      - name: Check for documentation changes
+        id: check
+        run: |
+          # Check if parent commit exists (guards against initial commit)
+          if git rev-parse HEAD~1 >/dev/null 2>&1; then
+            # Normal case: compare with parent commit
+            if git diff --name-only HEAD~1 HEAD | grep -qE '^docs/'; then
+              echo "should-deploy=true" >> "${GITHUB_OUTPUT}"
+              echo "Documentation changes detected"
+            else
+              echo "should-deploy=false" >> "${GITHUB_OUTPUT}"
+              echo "No documentation changes"
+            fi
+          else
+            # Initial commit: check if docs/ exists in tree
+            if git ls-tree --name-only -r HEAD | grep -qE '^docs/'; then
+              echo "should-deploy=true" >> "${GITHUB_OUTPUT}"
+              echo "Initial commit with documentation detected"
+            else
+              echo "should-deploy=false" >> "${GITHUB_OUTPUT}"
+              echo "Initial commit without documentation"
+            fi
+          fi
+
+      - name: Validate Markdown files
+        if: steps.check.outputs.should-deploy == 'true'
+        run: |
+          echo "Validating Markdown structure..."
+          find docs -name "*.md" -type f | while read -r file; do
+            # Check for valid UTF-8
+            if ! iconv -f UTF-8 -t UTF-8 "$file" > /dev/null 2>&1; then
+              echo "ERROR: Invalid UTF-8 in $file"
+              exit 1
+            fi
+            # Check file is not empty
+            if [ ! -s "$file" ]; then
+              echo "ERROR: Empty file: $file"
+              exit 1
+            fi
+          done
+          echo "Validation passed"
+
+  sync:
+    name: Sync to Wiki
+    needs: validate
+    if: needs.validate.outputs.should-deploy == 'true' || github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout main repository
+        uses: actions/checkout@v6
+        with:
+          path: main
+
+      - name: Clone wiki repository
+        run: |
+          git clone "https://x-access-token:${{ github.token }}@github.com/${{ github.repository }}.wiki.git" wiki
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '20'
+
+      - name: Transform and copy documentation
+        run: |
+          cd main
+          node scripts/wiki/transform-docs-to-wiki.js ../wiki
+
+      - name: Generate sidebar
+        run: |
+          cd main
+          node scripts/wiki/generate-wiki-sidebar.js ../wiki
+
+      - name: Validate transformed content
+        run: |
+          cd wiki
+          if [ ! -f "Home.md" ]; then
+            echo "::error::Home.md not generated"
+            exit 1
+          fi
+          echo "Content validation passed"
+
+      - name: Commit and push to wiki
+        run: |
+          cd wiki
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          if git diff --quiet && git diff --staged --quiet; then
+            echo "No changes to commit"
+            exit 0
+          fi
+
+          git add -A
+          git commit -m "Sync wiki from docs/ - ${{ github.sha }}"
+
+          for i in 1 2 3; do
+            if git push; then
+              echo "Push successful"
+              exit 0
+            fi
+            echo "Push attempt $i failed, retrying in 5s..."
+            sleep 5
+          done
+
+          echo "::error::Failed to push after 3 attempts"
+          exit 1

package/.github/workflows/update-dotnet-tools.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
@@ -60,9 +60,13 @@ jobs:
             echo "changed=true" >> "$GITHUB_OUTPUT"
           fi
 
+      - name: Renormalize line endings
+        if: steps.git_changes.outputs.changed == 'true'
+        run: git add --renormalize -- '.config/dotnet-tools.json'
+
       - name: Create Pull Request
         if: steps.git_changes.outputs.changed == 'true'
-        uses: peter-evans/create-pull-request@v7
+        uses: peter-evans/create-pull-request@v8
         with:
           branch: chore/update-dotnet-tools
           title: "chore: update .NET local tools"
@@ -76,5 +80,5 @@ jobs:
       - name: No changes summary
         if: steps.git_changes.outputs.changed != 'true'
         run: |
-          echo "## .NET tools are up to date" >> $GITHUB_STEP_SUMMARY
+          echo "## .NET tools are up to date" >> "$GITHUB_STEP_SUMMARY"