Add tool version capture to Build Notes PDF

.github/workflows/build.yaml

@@ -211,6 +211,9 @@ jobs:
         dotnet-version: ['8.x', '9.x', '10.x']
 
     steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
       - name: Download package
         uses: actions/download-artifact@v7
         with:
@@ -253,13 +256,30 @@ jobs:
             || { echo "✗ Self-validation failed"; exit 1; }
           echo "✓ Self-validation succeeded"
 
+      - name: Capture tool versions
+        shell: bash
+        run: |
+          echo "Capturing tool versions..."
+          # Create short job ID: int-win-8, int-win-9, int-ubuntu-8, etc.
+          OS_SHORT=$(echo "${{ matrix.os }}" | sed 's/windows-latest/win/;s/ubuntu-latest/ubuntu/')
+          DOTNET_SHORT=$(echo "${{ matrix.dotnet-version }}" | sed 's/\.x$//')
+          JOB_ID="int-${OS_SHORT}-${DOTNET_SHORT}"
+          versionmark --capture --job-id "${JOB_ID}"
+          echo "✓ Tool versions captured"
+
       - name: Upload validation test results
         if: always()
         uses: actions/upload-artifact@v6
         with:
           name: validation-test-results-${{ matrix.os }}-dotnet${{ matrix.dotnet-version }}
           path: validation-${{ matrix.os }}-dotnet${{ matrix.dotnet-version }}.trx
 
+      - name: Upload version capture
+        uses: actions/upload-artifact@v6
+        with:
+          name: version-capture-${{ matrix.os }}-dotnet${{ matrix.dotnet-version }}
+          path: versionmark-int-*.json
+
   # Builds the supporting documentation including user guides, requirements,
   # trace matrices, code quality reports, and build notes.
   build-docs:
@@ -297,6 +317,13 @@ jobs:
           name: codeql-sarif
           path: codeql-results
 
+      - name: Download all version captures
+        uses: actions/download-artifact@v7
+        with:
+          path: version-captures
+          pattern: 'version-capture-*'
+        continue-on-error: true
+
       - name: Setup dotnet
         uses: actions/setup-dotnet@v5
         with:
@@ -317,6 +344,13 @@ jobs:
       - name: Restore Tools
         run: dotnet tool restore
 
+      - name: Capture tool versions for build-docs
+        shell: bash
+        run: |
+          echo "Capturing tool versions..."
+          versionmark --capture --job-id "build-docs"
+          echo "✓ Tool versions captured"
+
       - name: Generate Requirements Report, Justifications, and Trace Matrix
         run: >
           dotnet reqstream
@@ -370,6 +404,20 @@ jobs:
           --report docs/buildnotes.md
           --report-depth 1
 
+      - name: Publish Tool Versions
+        shell: bash
+        run: |
+          echo "Publishing tool versions..."
+          versionmark --publish --report docs/buildnotes/versions.md --report-depth 2 \
+            -- "versionmark-*.json" "version-captures/**/versionmark-*.json"
+          echo "✓ Tool versions published"
+
+      - name: Display Tool Versions Report
+        shell: bash
+        run: |
+          echo "=== Tool Versions Report ==="
+          cat docs/buildnotes/versions.md
+
       - name: Generate Build Notes HTML with Pandoc
         shell: bash
         run: >

docs/buildnotes/definition.yaml

@@ -5,6 +5,7 @@ resource-path:
 input-files:
   - docs/buildnotes/title.txt
   - docs/buildnotes/introduction.md
+  - docs/buildnotes/versions.md
   - docs/buildnotes.md
 template: template.html
 table-of-contents: true