com.wallstop-studios.dxmessaging 2.1.4 → 2.1.5

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@v4
+        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@v4
+        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@v4
+        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"
 

package/.github/workflows/validate-docs.yml

@@ -0,0 +1,196 @@
+# Validate Documentation
+#
+# This workflow validates MkDocs documentation on PRs and pushes to catch
+# issues before merge. It performs strict builds, link validation, and
+# verifies required documentation files exist.
+#
+# Unlike deploy-docs.yml which also deploys, this workflow focuses purely
+# on validation and can run with minimal permissions.
+
+name: Validate Documentation
+
+on:
+  pull_request:
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "requirements-docs.txt"
+      - ".github/workflows/validate-docs.yml"
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "requirements-docs.txt"
+      - ".github/workflows/validate-docs.yml"
+  workflow_dispatch:
+
+# Cancel in-progress runs for the same branch to save resources
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    name: Validate Documentation Build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0 # Full history for git-revision-date-localized plugin
+          persist-credentials: false
+
+      - name: Verify required documentation files exist
+        run: |
+          echo "Checking for required documentation files..."
+          MISSING_FILES=0
+
+          # Check core configuration files
+          for file in mkdocs.yml requirements-docs.txt; do
+            if [ ! -f "$file" ]; then
+              echo "::error file=$file::Required file '$file' not found"
+              MISSING_FILES=$((MISSING_FILES + 1))
+            else
+              echo "✅ Found: $file"
+            fi
+          done
+
+          # Check required documentation structure
+          for file in docs/index.md; do
+            if [ ! -f "$file" ]; then
+              echo "::error file=$file::Required documentation file '$file' not found"
+              MISSING_FILES=$((MISSING_FILES + 1))
+            else
+              echo "✅ Found: $file"
+            fi
+          done
+
+          # Check for key documentation directories
+          for dir in docs/getting-started docs/concepts docs/reference; do
+            if [ ! -d "$dir" ]; then
+              echo "::warning::Documentation directory '$dir' not found - consider adding it"
+            else
+              FILE_COUNT=$(find "$dir" -name '*.md' | wc -l)
+              echo "✅ Found: $dir ($FILE_COUNT markdown files)"
+            fi
+          done
+
+          if [ "$MISSING_FILES" -gt 0 ]; then
+            echo "::error::$MISSING_FILES required file(s) missing"
+            exit 1
+          fi
+
+          echo ""
+          echo "📋 All required documentation files present"
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: "pip"
+          cache-dependency-path: "requirements-docs.txt"
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y --no-install-recommends \
+            libcairo2-dev \
+            libfreetype6-dev \
+            libffi-dev \
+            libjpeg-dev \
+            libpng-dev \
+            libz-dev
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements-docs.txt
+
+      - name: Validate mkdocs.yml syntax
+        run: |
+          echo "Validating mkdocs.yml syntax..."
+          python -c "from mkdocs.config import load_config; load_config('mkdocs.yml')"
+          echo "✅ mkdocs.yml syntax validation passed"
+
+      - name: Build documentation (strict mode)
+        run: |
+          echo "Building documentation in strict mode..."
+          mkdocs build --strict --site-dir _site 2>&1 | tee build.log
+
+          # Check for warnings in the build log
+          if grep -qi "warning" build.log; then
+            echo ""
+            echo "::warning::Build completed with warnings - review output above"
+          fi
+
+          echo ""
+          echo "✅ Documentation build completed successfully"
+
+      - name: Validate build output
+        run: |
+          echo "Validating build output..."
+
+          if [ ! -d "_site" ]; then
+            echo "::error::Build failed - _site directory not found"
+            exit 1
+          fi
+
+          if [ ! -f "_site/index.html" ]; then
+            echo "::error::Build failed - index.html not found"
+            exit 1
+          fi
+
+          # Count generated pages
+          PAGE_COUNT=$(find _site -name '*.html' | wc -l)
+          echo "📄 Generated $PAGE_COUNT HTML pages"
+
+          if [ "$PAGE_COUNT" -lt 5 ]; then
+            echo "::warning::Low page count ($PAGE_COUNT) - verify all docs are being built"
+          fi
+
+          # Show site structure summary
+          echo ""
+          echo "📁 Site structure:"
+          find _site -type d | head -20
+
+          echo ""
+          echo "✅ Build output validation passed"
+
+      - name: Check internal link structure
+        run: |
+          echo "Checking internal link structure..."
+
+          # Count internal links in generated HTML
+          # Use || true to prevent exit code 1 from grep when no matches
+          LINK_COUNT=$(grep -roc 'href="[^"]*"' _site --include='*.html' | awk -F: '{sum+=$NF} END {print sum}' || echo "0")
+          # For internal links, pipe through awk to count instead of grep -c which exits 1 on no match
+          # shellcheck disable=SC2126  # wc -l intentional: grep -c exits 1 on no match, breaking CI
+          INTERNAL_LINKS=$(grep -roh 'href="[^"]*"' _site --include='*.html' 2>/dev/null | grep -v 'href="https\?://\|href="mailto:' | wc -l || echo "0")
+
+          echo "📊 Found $LINK_COUNT total links ($INTERNAL_LINKS internal)"
+          echo "✅ Link structure scan completed"
+          echo ""
+          echo "Note: For comprehensive link validation, consider running:"
+          echo "  pip install linkchecker && linkchecker _site/index.html"
+
+      - name: Summary
+        run: |
+          echo ""
+          echo "═══════════════════════════════════════════════════════════"
+          echo "                 DOCUMENTATION VALIDATION COMPLETE"
+          echo "═══════════════════════════════════════════════════════════"
+          echo ""
+          echo "✅ Required files present"
+          echo "✅ mkdocs.yml syntax valid"
+          echo "✅ Documentation built successfully in strict mode"
+          echo "✅ Build output validated"
+          echo "✅ Internal links checked"
+          echo ""
+          echo "The documentation is ready for deployment!"

package/.github/workflows/validate-skills.yml

@@ -0,0 +1,46 @@
+name: Validate LLM Skills
+
+on:
+  pull_request:
+    paths:
+      - ".llm/**"
+      - "scripts/validate-skills.js"
+      - "scripts/generate-skills-index.js"
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - ".llm/**"
+      - "scripts/validate-skills.js"
+      - "scripts/generate-skills-index.js"
+  workflow_dispatch:
+
+jobs:
+  validate-skills:
+    name: Validate skill files
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        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: Validate skill files
+        run: node scripts/validate-skills.js
+
+      - name: Check skills index is up to date
+        run: node scripts/generate-skills-index.js --check

package/.github/workflows/yaml-format-lint.yml

@@ -5,6 +5,7 @@ on:
   push:
     branches:
       - main
+      - master
   workflow_dispatch:
 
 jobs:
@@ -13,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup Node
         uses: actions/setup-node@v6