feat: implement new result output format for validation

packages/ruleset/package.json

@@ -35,7 +35,7 @@
     "validator": "13.15.35"
   },
   "devDependencies": {
-    "@stoplight/spectral-core": "1.23.1",
+    "@stoplight/spectral-core": "1.24.0",
     "jest": "29.7.0"
   },
   "engines": {

packages/ruleset/src/ibm-oas.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2017 - 2025 IBM Corporation.
+ * Copyright 2017 - 2026 IBM Corporation.
  * SPDX-License-Identifier: Apache2.0
  */
 
@@ -12,11 +12,13 @@ const ibmRules = require('./rules');
 // However, we want to enable this rule also for OpenAPI 3.1.x documents,
 // so we'll just tweak Spectral's rule definition here.
 oas.rules['no-$ref-siblings'].formats = [oas3];
+oas.documentationUrl =
+  'https://meta.stoplight.io/docs/spectral/4dec24461f3af-open-api-rules';
 
 module.exports = {
   extends: oas,
   documentationUrl:
-    'https://github.com/IBM/openapi-validator/blob/main/docs/ibm-cloud-rules.md',
+    'https://ibm.github.io/openapi-validator/docs/ibm-cloud-rules.html',
   formats: [oas3],
   rules: {
     // Original list created from Spectral with:

packages/utilities/package.json

@@ -22,7 +22,7 @@
     "pkg": "echo no executables to build in this package"
   },
   "devDependencies": {
-    "@stoplight/spectral-core": "1.23.1",
+    "@stoplight/spectral-core": "1.24.0",
     "jest": "29.7.0",
     "typescript": "5.9.3"
   },

packages/validator/package.json

@@ -26,7 +26,7 @@
     "@ibm-cloud/openapi-ruleset": "1.33.15",
     "@ibm-cloud/openapi-ruleset-utilities": "1.9.4",
     "@stoplight/spectral-cli": "6.16.3",
-    "@stoplight/spectral-core": "1.23.1",
+    "@stoplight/spectral-core": "1.24.0",
     "@stoplight/spectral-parsers": "1.0.5",
     "@stoplight/spectral-ref-resolver": "1.0.5",
     "ajv": "8.20.0",

packages/validator/src/cli-validator/utils/print-results.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2017 - 2023 IBM Corporation.
+ * Copyright 2017 - 2026 IBM Corporation.
  * SPDX-License-Identifier: Apache2.0
  */
 
@@ -38,6 +38,7 @@ module.exports = function print(context, results) {
       console.log(chalk[color](`  Message :   ${result.message}`));
       console.log(chalk[color](`  Rule    :   ${result.rule}`));
       console.log(chalk[color](`  Path    :   ${result.path.join('.')}`));
+      console.log(chalk[color](`  DocLink :   ${result.docLink}`));
       console.log(chalk[color](`  Line    :   ${result.line}`));
       console.log('');
     });