Merge branch 'main' into hiaga/docFixes

Author: hiaga

.github/dependabot.yml

@@ -38,6 +38,9 @@ updates:
       eslint:
         patterns:
           - "*eslint*"
+      openapi-validator:
+        patterns:
+          - "@microsoft.azure/openapi-validator*"
     versioning-strategy: increase-if-necessary
   - package-ecosystem: "npm"
     directories:

.github/workflows/src/summarize-checks/summarize-checks.js

@@ -363,6 +363,12 @@ export async function summarizeChecksImpl(
 ) {
   core.info(`Handling ${event_name} event for PR #${issue_number} in ${owner}/${repo}.`);
 
+  const prUrl = `https://github.com/${owner}/${repo}/pull/${issue_number}`;
+  core.summary.addRaw("PR: ");
+  core.summary.addLink(prUrl, prUrl);
+  core.summary.write();
+  core.setOutput("summary", process.env.GITHUB_STEP_SUMMARY);
+
   let labelNames = await getExistingLabels(github, owner, repo, issue_number);
 
   /** @type {[CheckRunData[], CheckRunData[], import("./labelling.js").ImpactAssessment | undefined]} */
@@ -441,6 +447,9 @@ export async function summarizeChecksImpl(
   core.info(
     `Updating comment '${NEXT_STEPS_COMMENT_ID}' on ${owner}/${repo}#${issue_number} with body: ${commentBody}`,
   );
+  core.summary.addRaw(`\n${commentBody}\n\n`);
+  core.summary.write();
+
   // this will remain commented until we're comfortable with the change.
   // await commentOrUpdate(
   //   { github, context, core },
@@ -457,6 +466,9 @@ export async function summarizeChecksImpl(
   core.info(
     `Summarize checks has identified that status of "[TEST-IGNORE] Automated merging requirements met" commit status should be updated to: ${JSON.stringify(automatedChecksMet)}.`,
   );
+  core.summary.addHeading("Automated Checks Met", 2);
+  core.summary.addCodeBlock(JSON.stringify(automatedChecksMet, null, 2));
+  core.summary.write();
 }
 
 /**

.github/workflows/summarize-checks.yaml

@@ -68,3 +68,13 @@ jobs:
             const { default: summarizeChecks } =
               await import('${{ github.workspace }}/.github/workflows/src/summarize-checks/summarize-checks.js');
             return await summarizeChecks({ github, context, core });
+
+      # May be used by downstream workflows
+      - name: Set job-summary artifact
+        if: ${{ always() && steps.summarize-checks.outputs.summary }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: job-summary
+          path: ${{ steps.summarize-checks.outputs.summary }}
+          # If the file doesn't exist, just don't add the artifact
+          if-no-files-found: ignore

eng/tools/lint-diff/package.json

@@ -21,7 +21,9 @@
   "dependencies": {
     "@apidevtools/json-schema-ref-parser": "^14.1.1",
     "@azure-tools/specs-shared": "file:../../../.github/shared",
-    "@microsoft.azure/openapi-validator": "^2.2.4",
+    "@microsoft.azure/openapi-validator": "2.2.4",
+    "@microsoft.azure/openapi-validator-core": "1.0.6",
+    "@microsoft.azure/openapi-validator-rulesets": "2.1.7",
     "autorest": "^3.7.2",
     "axios": "^1.8.3",
     "change-case": "^5.4.4",