Add summary step

Author: ryanjbaxter

.github/workflows/run-github-actions-workflow-generator.yml

@@ -310,13 +310,93 @@ jobs:
             "--workflow.generator.workflows.release-train.test.env.COMMERCIAL_REPO_PASSWORD=secrets.COMMERCIAL_ARTIFACTORY_PASSWORD"
 
       - name: Commit and push changes
+        id: commit
         working-directory: repo
         run: |
           git add .github/
           if git diff --staged --quiet; then
             echo "No changes to commit for ${{ matrix.repo }}@${{ matrix.branch }}."
+            echo "changed=false" >> "$GITHUB_OUTPUT"
           else
             git commit -m "Update generated GitHub Actions workflow files"
             git push
             echo "Changes pushed to ${{ matrix.repo }}@${{ matrix.branch }}."
+            echo "changed=true" >> "$GITHUB_OUTPUT"
           fi
+
+      - name: Record result
+        if: always()
+        id: record
+        env:
+          REPO: ${{ matrix.repo }}
+          BRANCH: ${{ matrix.branch }}
+          CHANGED: ${{ steps.commit.outputs.changed }}
+        run: |
+          safe="${REPO//\//-}-${BRANCH//\//-}"
+          safe="${safe//./-}"
+          echo "safe-name=${safe}" >> "$GITHUB_OUTPUT"
+          echo '{"repo":"'"$REPO"'","branch":"'"$BRANCH"'","changed":'"${CHANGED:-false}"'}' \
+            > "result-${safe}.json"
+
+      - name: Upload result
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: result-${{ steps.record.outputs.safe-name }}
+          path: result-${{ steps.record.outputs.safe-name }}.json
+
+  summary:
+    name: Summary
+    needs: generate
+    runs-on: ubuntu-latest
+    if: always()
+    steps:
+      - name: Download results
+        uses: actions/download-artifact@v4
+        with:
+          pattern: result-*
+          merge-multiple: true
+          path: results
+
+      - name: Write summary
+        run: |
+          node - << 'JSEOF'
+          const fs = require('fs');
+          const path = require('path');
+
+          const files = fs.readdirSync('results').filter(f => f.endsWith('.json'));
+          const results = files
+            .map(f => JSON.parse(fs.readFileSync(path.join('results', f), 'utf8')))
+            .sort((a, b) => {
+              if (a.changed !== b.changed) return a.changed ? -1 : 1;
+              return `${a.repo}@${a.branch}`.localeCompare(`${b.repo}@${b.branch}`);
+            });
+
+          const updated   = results.filter(r => r.changed);
+          const unchanged = results.filter(r => !r.changed);
+
+          let md = '## Workflow Generator Results\n\n';
+
+          if (updated.length > 0) {
+            md += `### Updated (${updated.length})\n\n`;
+            md += '| Repository | Branch |\n|---|---|\n';
+            for (const r of updated) {
+              md += `| \`${r.repo}\` | \`${r.branch}\` |\n`;
+            }
+            md += '\n';
+          } else {
+            md += '> No changes were made.\n\n';
+          }
+
+          if (unchanged.length > 0) {
+            md += `<details><summary>Unchanged (${unchanged.length})</summary>\n\n`;
+            md += '| Repository | Branch |\n|---|---|\n';
+            for (const r of unchanged) {
+              md += `| \`${r.repo}\` | \`${r.branch}\` |\n`;
+            }
+            md += '\n</details>\n';
+          }
+
+          fs.appendFileSync(process.env.GITHUB_STEP_SUMMARY, md);
+          console.log(md);
+          JSEOF