@jentic/arazzo-validator 1.0.0-alpha.24 → 1.0.0-alpha.26

package/src/cli/index.cjs

@@ -0,0 +1,159 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.formatDiagnostics = formatDiagnostics;
+exports.hasFailures = hasFailures;
+exports.main = main;
+exports.severityMap = void 0;
+var _interopRequireWildcard2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/interopRequireWildcard"));
+var _nodeFs = require("node:fs");
+var _commander = require("commander");
+var _vscodeLanguageserverTypes = require("vscode-languageserver-types");
+var _validateUri = require("../validators/validate-uri.cjs");
+var _validate = require("../validators/validate.cjs");
+var _document = require("../document.cjs");
+var _index = require("./formatters/index.cjs");
+const severityMap = exports.severityMap = {
+  error: _vscodeLanguageserverTypes.DiagnosticSeverity.Error,
+  warning: _vscodeLanguageserverTypes.DiagnosticSeverity.Warning,
+  info: _vscodeLanguageserverTypes.DiagnosticSeverity.Information,
+  hint: _vscodeLanguageserverTypes.DiagnosticSeverity.Hint
+};
+function formatDiagnostics(format, filePath, diagnostics, options = {}) {
+  switch (format) {
+    case 'codeframe':
+      return (0, _index.formatCodeframe)(filePath, diagnostics, options);
+    case 'json':
+      return (0, _index.formatJSON)(filePath, diagnostics, options);
+    case 'github-actions':
+      return (0, _index.formatGitHubActions)(filePath, diagnostics, options);
+    case 'stylish':
+    default:
+      return (0, _index.formatStylish)(filePath, diagnostics, options);
+  }
+}
+function hasFailures(diagnostics, failSeverity) {
+  const threshold = severityMap[failSeverity];
+  return diagnostics.some(d => d.severity !== undefined && d.severity <= threshold);
+}
+function parseMaxProblems(value) {
+  const parsed = Number.parseInt(value, 10);
+  if (Number.isNaN(parsed) || parsed < 0) {
+    throw new _commander.InvalidArgumentError('Must be a non-negative integer.');
+  }
+  return parsed;
+}
+async function readStdin() {
+  const chunks = [];
+  return new Promise((resolve, reject) => {
+    process.stdin.on('data', chunk => {
+      if (typeof chunk === 'string') {
+        chunks.push(Buffer.from(chunk));
+      } else {
+        chunks.push(chunk);
+      }
+    });
+    process.stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+    process.stdin.on('error', reject);
+  });
+}
+async function runValidation(file, options) {
+  let diagnostics;
+  let filePath;
+  let sourceContent;
+  if (options.stdinRetrievalUri) {
+    // read from stdin
+    sourceContent = await readStdin();
+    filePath = options.stdinRetrievalUri;
+    const textDocument = (0, _document.createTextDocument)(filePath, sourceContent);
+    diagnostics = await (0, _validate.validate)(textDocument);
+  } else if (file) {
+    // validate file/URL
+    filePath = file;
+    diagnostics = await (0, _validateUri.validateURI)(file);
+    // try to read file content for code snippets (only for local files)
+    if (!file.startsWith('http://') && !file.startsWith('https://')) {
+      try {
+        sourceContent = (0, _nodeFs.readFileSync)(file, 'utf-8');
+      } catch {
+        // ignore - file might not be readable
+      }
+    }
+  } else {
+    throw new Error('No input provided. Specify a file or use --stdin-retrieval-uri');
+  }
+  return {
+    diagnostics,
+    filePath,
+    sourceContent
+  };
+}
+async function main(argv = process.argv) {
+  // dynamic import for package.json to get version
+  const pkg = await Promise.resolve().then(() => (0, _interopRequireWildcard2.default)(require('../../package.json')));
+  _commander.program.name('arazzo-validator').description('Validate and lint Arazzo Specification documents').version(pkg.default.version).exitOverride(err => {
+    if (err.code === 'commander.invalidArgument') {
+      process.exitCode = 2;
+    }
+    throw err;
+  }).argument('[file]', 'File path or URL to validate').option('--stdin-retrieval-uri <uri>', 'Read from stdin, use URI for reference resolution').addOption(new _commander.Option('-f, --format <format>', 'Output format').choices(['stylish', 'codeframe', 'json', 'github-actions']).default('stylish')).option('-o, --output <file>', 'Write output to file instead of stdout').addOption(new _commander.Option('--fail-severity <level>', 'Minimum severity to trigger failure').choices(['error', 'warning', 'info', 'hint']).default('error')).option('--max-problems <n>', 'Limit output to N problems', parseMaxProblems).option('-q, --quiet', 'Suppress output, only return exit code', false).option('-v, --verbose', 'Show additional information', false).action(async (file, opts) => {
+    try {
+      if (opts.verbose) {
+        console.error(`Validating: ${file ?? opts.stdinRetrievalUri ?? 'stdin'}`);
+      }
+      const startTime = performance.now();
+      const {
+        diagnostics,
+        filePath,
+        sourceContent
+      } = await runValidation(file, opts);
+      const duration = performance.now() - startTime;
+      if (opts.verbose) {
+        const errorCount = diagnostics.filter(d => d.severity === _vscodeLanguageserverTypes.DiagnosticSeverity.Error).length;
+        const warningCount = diagnostics.filter(d => d.severity === _vscodeLanguageserverTypes.DiagnosticSeverity.Warning).length;
+        console.error(`Completed in ${(duration / 1000).toFixed(2)}s`);
+        console.error(`Found ${diagnostics.length} problems (${errorCount} errors, ${warningCount} warnings)`);
+      }
+
+      // format output
+      const output = formatDiagnostics(opts.format, filePath, diagnostics, {
+        maxProblems: opts.maxProblems,
+        sourceContent
+      });
+
+      // write output
+      if (!opts.quiet && output) {
+        if (opts.output) {
+          (0, _nodeFs.writeFileSync)(opts.output, output);
+          if (opts.verbose) {
+            console.error(`Output written to ${opts.output}`);
+          }
+        } else {
+          console.log(output);
+        }
+      }
+
+      // exit code based on fail severity
+      const failed = hasFailures(diagnostics, opts.failSeverity);
+      if (failed) {
+        process.exitCode = 1;
+      } else if (!opts.quiet && (opts.format === 'stylish' || opts.format === 'codeframe')) {
+        // show success message for human-readable formats only
+        console.log(`No results with a severity of '${opts.failSeverity}' or higher found!`);
+      }
+    } catch (error) {
+      if (error instanceof Error) {
+        console.error(`Error: ${error.message}`);
+      } else {
+        console.error('An unexpected error occurred');
+      }
+      process.exitCode = 2;
+    }
+  });
+  try {
+    await _commander.program.parseAsync(argv);
+  } catch {
+    // exitOverride throws - error already handled, exit code already set
+  }
+}

package/src/cli/index.mjs

@@ -0,0 +1,154 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { program, Option, InvalidArgumentError } from 'commander';
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+import { validateURI } from "../validators/validate-uri.mjs";
+import { validate as validateDocument } from "../validators/validate.mjs";
+import { createTextDocument } from "../document.mjs";
+import { formatStylish, formatCodeframe, formatJSON, formatGitHubActions } from "./formatters/index.mjs";
+export const severityMap = {
+  error: DiagnosticSeverity.Error,
+  warning: DiagnosticSeverity.Warning,
+  info: DiagnosticSeverity.Information,
+  hint: DiagnosticSeverity.Hint
+};
+export function formatDiagnostics(format, filePath, diagnostics, options = {}) {
+  switch (format) {
+    case 'codeframe':
+      return formatCodeframe(filePath, diagnostics, options);
+    case 'json':
+      return formatJSON(filePath, diagnostics, options);
+    case 'github-actions':
+      return formatGitHubActions(filePath, diagnostics, options);
+    case 'stylish':
+    default:
+      return formatStylish(filePath, diagnostics, options);
+  }
+}
+export function hasFailures(diagnostics, failSeverity) {
+  const threshold = severityMap[failSeverity];
+  return diagnostics.some(d => d.severity !== undefined && d.severity <= threshold);
+}
+function parseMaxProblems(value) {
+  const parsed = Number.parseInt(value, 10);
+  if (Number.isNaN(parsed) || parsed < 0) {
+    throw new InvalidArgumentError('Must be a non-negative integer.');
+  }
+  return parsed;
+}
+async function readStdin() {
+  const chunks = [];
+  return new Promise((resolve, reject) => {
+    process.stdin.on('data', chunk => {
+      if (typeof chunk === 'string') {
+        chunks.push(Buffer.from(chunk));
+      } else {
+        chunks.push(chunk);
+      }
+    });
+    process.stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+    process.stdin.on('error', reject);
+  });
+}
+async function runValidation(file, options) {
+  let diagnostics;
+  let filePath;
+  let sourceContent;
+  if (options.stdinRetrievalUri) {
+    // read from stdin
+    sourceContent = await readStdin();
+    filePath = options.stdinRetrievalUri;
+    const textDocument = createTextDocument(filePath, sourceContent);
+    diagnostics = await validateDocument(textDocument);
+  } else if (file) {
+    // validate file/URL
+    filePath = file;
+    diagnostics = await validateURI(file);
+    // try to read file content for code snippets (only for local files)
+    if (!file.startsWith('http://') && !file.startsWith('https://')) {
+      try {
+        sourceContent = readFileSync(file, 'utf-8');
+      } catch {
+        // ignore - file might not be readable
+      }
+    }
+  } else {
+    throw new Error('No input provided. Specify a file or use --stdin-retrieval-uri');
+  }
+  return {
+    diagnostics,
+    filePath,
+    sourceContent
+  };
+}
+export async function main(argv = process.argv) {
+  // dynamic import for package.json to get version
+  const pkg = await import('../../package.json', {
+    with: {
+      type: 'json'
+    }
+  });
+  program.name('arazzo-validator').description('Validate and lint Arazzo Specification documents').version(pkg.default.version).exitOverride(err => {
+    if (err.code === 'commander.invalidArgument') {
+      process.exitCode = 2;
+    }
+    throw err;
+  }).argument('[file]', 'File path or URL to validate').option('--stdin-retrieval-uri <uri>', 'Read from stdin, use URI for reference resolution').addOption(new Option('-f, --format <format>', 'Output format').choices(['stylish', 'codeframe', 'json', 'github-actions']).default('stylish')).option('-o, --output <file>', 'Write output to file instead of stdout').addOption(new Option('--fail-severity <level>', 'Minimum severity to trigger failure').choices(['error', 'warning', 'info', 'hint']).default('error')).option('--max-problems <n>', 'Limit output to N problems', parseMaxProblems).option('-q, --quiet', 'Suppress output, only return exit code', false).option('-v, --verbose', 'Show additional information', false).action(async (file, opts) => {
+    try {
+      if (opts.verbose) {
+        console.error(`Validating: ${file ?? opts.stdinRetrievalUri ?? 'stdin'}`);
+      }
+      const startTime = performance.now();
+      const {
+        diagnostics,
+        filePath,
+        sourceContent
+      } = await runValidation(file, opts);
+      const duration = performance.now() - startTime;
+      if (opts.verbose) {
+        const errorCount = diagnostics.filter(d => d.severity === DiagnosticSeverity.Error).length;
+        const warningCount = diagnostics.filter(d => d.severity === DiagnosticSeverity.Warning).length;
+        console.error(`Completed in ${(duration / 1000).toFixed(2)}s`);
+        console.error(`Found ${diagnostics.length} problems (${errorCount} errors, ${warningCount} warnings)`);
+      }
+
+      // format output
+      const output = formatDiagnostics(opts.format, filePath, diagnostics, {
+        maxProblems: opts.maxProblems,
+        sourceContent
+      });
+
+      // write output
+      if (!opts.quiet && output) {
+        if (opts.output) {
+          writeFileSync(opts.output, output);
+          if (opts.verbose) {
+            console.error(`Output written to ${opts.output}`);
+          }
+        } else {
+          console.log(output);
+        }
+      }
+
+      // exit code based on fail severity
+      const failed = hasFailures(diagnostics, opts.failSeverity);
+      if (failed) {
+        process.exitCode = 1;
+      } else if (!opts.quiet && (opts.format === 'stylish' || opts.format === 'codeframe')) {
+        // show success message for human-readable formats only
+        console.log(`No results with a severity of '${opts.failSeverity}' or higher found!`);
+      }
+    } catch (error) {
+      if (error instanceof Error) {
+        console.error(`Error: ${error.message}`);
+      } else {
+        console.error('An unexpected error occurred');
+      }
+      process.exitCode = 2;
+    }
+  });
+  try {
+    await program.parseAsync(argv);
+  } catch {
+    // exitOverride throws - error already handled, exit code already set
+  }
+}

package/src/config/arazzo/arazzo/lint/index.cjs

@@ -0,0 +1,8 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _valuePattern10X = _interopRequireDefault(require("./value--pattern-1-0-X.cjs"));
+const lints = [_valuePattern10X.default];
+var _default = exports.default = lints;

package/src/config/arazzo/arazzo/lint/index.mjs

@@ -0,0 +1,3 @@
+import valuePattern1_0_XLint from "./value--pattern-1-0-X.mjs";
+const lints = [valuePattern1_0_XLint];
+export default lints;

package/src/config/arazzo/arazzo/lint/value--pattern-1-0-X.cjs

@@ -0,0 +1,30 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _vscodeLanguageserverTypes = require("vscode-languageserver-types");
+var _codes = _interopRequireDefault(require("../../../codes.cjs"));
+var _targetSpecs = require("../../target-specs.cjs");
+const valuePattern1_0_XLint = {
+  code: _codes.default.ARAZZO1_ARAZZO_VALUE_PATTERN_1_0_X,
+  source: 'apilint',
+  message: "'arazzo' value must be one of 1.0.0, 1.0.1",
+  severity: _vscodeLanguageserverTypes.DiagnosticSeverity.Error,
+  linterFunction: 'apilintValueRegex',
+  linterParams: ['1\\.0\\.[01]{1}'],
+  marker: 'value',
+  data: {
+    quickFix: [{
+      message: "update to '1.0.0'",
+      action: 'updateValue',
+      functionParams: ['1.0.0']
+    }, {
+      message: "update to '1.0.1'",
+      action: 'updateValue',
+      functionParams: ['1.0.1']
+    }]
+  },
+  targetSpecs: _targetSpecs.Arazzo10X
+};
+var _default = exports.default = valuePattern1_0_XLint;

package/src/config/arazzo/arazzo/lint/value--pattern-1-0-X.mjs

@@ -0,0 +1,25 @@
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+import ApilintCodes from "../../../codes.mjs";
+import { Arazzo10X } from "../../target-specs.mjs";
+const valuePattern1_0_XLint = {
+  code: ApilintCodes.ARAZZO1_ARAZZO_VALUE_PATTERN_1_0_X,
+  source: 'apilint',
+  message: "'arazzo' value must be one of 1.0.0, 1.0.1",
+  severity: DiagnosticSeverity.Error,
+  linterFunction: 'apilintValueRegex',
+  linterParams: ['1\\.0\\.[01]{1}'],
+  marker: 'value',
+  data: {
+    quickFix: [{
+      message: "update to '1.0.0'",
+      action: 'updateValue',
+      functionParams: ['1.0.0']
+    }, {
+      message: "update to '1.0.1'",
+      action: 'updateValue',
+      functionParams: ['1.0.1']
+    }]
+  },
+  targetSpecs: Arazzo10X
+};
+export default valuePattern1_0_XLint;

package/src/config/arazzo/arazzo/meta.cjs

@@ -0,0 +1,10 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _index = _interopRequireDefault(require("./lint/index.cjs"));
+const meta = {
+  lint: _index.default
+};
+var _default = exports.default = meta;

package/src/config/arazzo/arazzo/meta.mjs

@@ -0,0 +1,5 @@
+import lint from "./lint/index.mjs";
+const meta = {
+  lint
+};
+export default meta;

package/src/config/arazzo/arazzo-specification-1/lint/allowed-fields.cjs

@@ -0,0 +1,18 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = void 0;
+var _vscodeLanguageserverTypes = require("vscode-languageserver-types");
+var _apidomLs = require("@speclynx/apidom-ls");
+var _targetSpecs = require("../../target-specs.cjs");
+const allowedFieldsLint = {
+  code: _apidomLs.ApilintCodes.NOT_ALLOWED_FIELDS,
+  source: 'apilint',
+  message: 'Object includes not allowed fields',
+  severity: _vscodeLanguageserverTypes.DiagnosticSeverity.Error,
+  linterFunction: 'allowedFields',
+  linterParams: [['arazzo', 'info', 'sourceDescriptions', 'workflows', 'components'], 'x-'],
+  marker: 'key',
+  targetSpecs: _targetSpecs.Arazzo1
+};
+var _default = exports.default = allowedFieldsLint;

package/src/config/arazzo/arazzo-specification-1/lint/allowed-fields.mjs

@@ -0,0 +1,14 @@
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+import { ApilintCodes } from '@speclynx/apidom-ls';
+import { Arazzo1 } from "../../target-specs.mjs";
+const allowedFieldsLint = {
+  code: ApilintCodes.NOT_ALLOWED_FIELDS,
+  source: 'apilint',
+  message: 'Object includes not allowed fields',
+  severity: DiagnosticSeverity.Error,
+  linterFunction: 'allowedFields',
+  linterParams: [['arazzo', 'info', 'sourceDescriptions', 'workflows', 'components'], 'x-'],
+  marker: 'key',
+  targetSpecs: Arazzo1
+};
+export default allowedFieldsLint;

package/src/config/arazzo/arazzo-specification-1/lint/index.cjs

@@ -0,0 +1,11 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _allowedFields = _interopRequireDefault(require("./allowed-fields.cjs"));
+var _requiredFields = _interopRequireDefault(require("./required-fields.cjs"));
+var _infoType = _interopRequireDefault(require("./info--type.cjs"));
+var _infoRequired = _interopRequireDefault(require("./info--required.cjs"));
+const lints = [_allowedFields.default, _requiredFields.default, _infoType.default, _infoRequired.default];
+var _default = exports.default = lints;

package/src/config/arazzo/arazzo-specification-1/lint/index.mjs

@@ -0,0 +1,6 @@
+import allowedFieldsLint from "./allowed-fields.mjs";
+import requiredFieldsLint from "./required-fields.mjs";
+import infoTypeLint from "./info--type.mjs";
+import infoRequiredLint from "./info--required.mjs";
+const lints = [allowedFieldsLint, requiredFieldsLint, infoTypeLint, infoRequiredLint];
+export default lints;

package/src/config/arazzo/arazzo-specification-1/lint/info--required.cjs

@@ -0,0 +1,27 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _vscodeLanguageserverTypes = require("vscode-languageserver-types");
+var _codes = _interopRequireDefault(require("../../../codes.cjs"));
+var _targetSpecs = require("../../target-specs.cjs");
+const infoRequiredLint = {
+  code: _codes.default.ARAZZO1_ARAZZO_SPECIFICATION_FIELD_INFO_REQUIRED,
+  source: 'apilint',
+  message: "should always have an 'info' section",
+  severity: _vscodeLanguageserverTypes.DiagnosticSeverity.Error,
+  linterFunction: 'hasRequiredField',
+  linterParams: ['info'],
+  marker: 'key',
+  data: {
+    quickFix: [{
+      message: "add 'info' section",
+      action: 'addChild',
+      snippetYaml: 'info: \n  \n',
+      snippetJson: '"info": {\n  \n  },\n'
+    }]
+  },
+  targetSpecs: _targetSpecs.Arazzo1
+};
+var _default = exports.default = infoRequiredLint;

package/src/config/arazzo/arazzo-specification-1/lint/info--required.mjs

@@ -0,0 +1,22 @@
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+import ApilintCodes from "../../../codes.mjs";
+import { Arazzo1 } from "../../target-specs.mjs";
+const infoRequiredLint = {
+  code: ApilintCodes.ARAZZO1_ARAZZO_SPECIFICATION_FIELD_INFO_REQUIRED,
+  source: 'apilint',
+  message: "should always have an 'info' section",
+  severity: DiagnosticSeverity.Error,
+  linterFunction: 'hasRequiredField',
+  linterParams: ['info'],
+  marker: 'key',
+  data: {
+    quickFix: [{
+      message: "add 'info' section",
+      action: 'addChild',
+      snippetYaml: 'info: \n  \n',
+      snippetJson: '"info": {\n  \n  },\n'
+    }]
+  },
+  targetSpecs: Arazzo1
+};
+export default infoRequiredLint;

package/src/config/arazzo/arazzo-specification-1/lint/info--type.cjs

@@ -0,0 +1,21 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _vscodeLanguageserverTypes = require("vscode-languageserver-types");
+var _codes = _interopRequireDefault(require("../../../codes.cjs"));
+var _targetSpecs = require("../../target-specs.cjs");
+const infoTypeLint = {
+  code: _codes.default.ARAZZO1_ARAZZO_SPECIFICATION_FIELD_INFO_TYPE,
+  source: 'apilint',
+  message: 'info must be an object',
+  severity: _vscodeLanguageserverTypes.DiagnosticSeverity.Error,
+  linterFunction: 'apilintElementOrClass',
+  linterParams: [['info']],
+  marker: 'value',
+  target: 'info',
+  data: {},
+  targetSpecs: _targetSpecs.Arazzo1
+};
+var _default = exports.default = infoTypeLint;

package/src/config/arazzo/arazzo-specification-1/lint/info--type.mjs

@@ -0,0 +1,16 @@
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+import ApilintCodes from "../../../codes.mjs";
+import { Arazzo1 } from "../../target-specs.mjs";
+const infoTypeLint = {
+  code: ApilintCodes.ARAZZO1_ARAZZO_SPECIFICATION_FIELD_INFO_TYPE,
+  source: 'apilint',
+  message: 'info must be an object',
+  severity: DiagnosticSeverity.Error,
+  linterFunction: 'apilintElementOrClass',
+  linterParams: [['info']],
+  marker: 'value',
+  target: 'info',
+  data: {},
+  targetSpecs: Arazzo1
+};
+export default infoTypeLint;

package/src/config/arazzo/arazzo-specification-1/lint/required-fields.cjs

@@ -0,0 +1,44 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _vscodeLanguageserverTypes = require("vscode-languageserver-types");
+var _codes = _interopRequireDefault(require("../../../codes.cjs"));
+var _targetSpecs = require("../../target-specs.cjs");
+const requiredFieldsLint = {
+  code: _codes.default.ARAZZO1_ARAZZO_SPECIFICATION_REQUIRED_FIELDS,
+  source: 'apilint',
+  message: 'Arazzo Specification Object must contain following fields: info, sourceDescriptions, workflows',
+  severity: _vscodeLanguageserverTypes.DiagnosticSeverity.Error,
+  linterFunction: 'hasRequiredField',
+  linterParams: ['info', 'sourceDescriptions', 'workflows'],
+  marker: 'key',
+  conditions: [{
+    targets: [{
+      path: 'root'
+    }],
+    function: 'missingFields',
+    params: [['info', 'sourceDescriptions', 'workflows']]
+  }],
+  data: {
+    quickFix: [{
+      message: "add 'info' section",
+      action: 'addChild',
+      snippetYaml: 'info: \n  \n',
+      snippetJson: '"info": {\n  \n  },\n'
+    }, {
+      message: "add 'sourceDescriptions' section",
+      action: 'addChild',
+      snippetYaml: 'sourceDescriptions:\n  - \n',
+      snippetJson: '"sourceDescriptions": [\n  \n  ],\n'
+    }, {
+      message: "add 'workflows' section",
+      action: 'addChild',
+      snippetYaml: 'workflows:\n  - \n',
+      snippetJson: '"workflows": [\n  \n  ],\n'
+    }]
+  },
+  targetSpecs: _targetSpecs.Arazzo1
+};
+var _default = exports.default = requiredFieldsLint;

package/src/config/arazzo/arazzo-specification-1/lint/required-fields.mjs

@@ -0,0 +1,39 @@
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+import ApilintCodes from "../../../codes.mjs";
+import { Arazzo1 } from "../../target-specs.mjs";
+const requiredFieldsLint = {
+  code: ApilintCodes.ARAZZO1_ARAZZO_SPECIFICATION_REQUIRED_FIELDS,
+  source: 'apilint',
+  message: 'Arazzo Specification Object must contain following fields: info, sourceDescriptions, workflows',
+  severity: DiagnosticSeverity.Error,
+  linterFunction: 'hasRequiredField',
+  linterParams: ['info', 'sourceDescriptions', 'workflows'],
+  marker: 'key',
+  conditions: [{
+    targets: [{
+      path: 'root'
+    }],
+    function: 'missingFields',
+    params: [['info', 'sourceDescriptions', 'workflows']]
+  }],
+  data: {
+    quickFix: [{
+      message: "add 'info' section",
+      action: 'addChild',
+      snippetYaml: 'info: \n  \n',
+      snippetJson: '"info": {\n  \n  },\n'
+    }, {
+      message: "add 'sourceDescriptions' section",
+      action: 'addChild',
+      snippetYaml: 'sourceDescriptions:\n  - \n',
+      snippetJson: '"sourceDescriptions": [\n  \n  ],\n'
+    }, {
+      message: "add 'workflows' section",
+      action: 'addChild',
+      snippetYaml: 'workflows:\n  - \n',
+      snippetJson: '"workflows": [\n  \n  ],\n'
+    }]
+  },
+  targetSpecs: Arazzo1
+};
+export default requiredFieldsLint;

package/src/config/arazzo/arazzo-specification-1/meta.cjs

@@ -0,0 +1,10 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _index = _interopRequireDefault(require("./lint/index.cjs"));
+const meta = {
+  lint: _index.default
+};
+var _default = exports.default = meta;

package/src/config/arazzo/arazzo-specification-1/meta.mjs

@@ -0,0 +1,5 @@
+import lint from "./lint/index.mjs";
+const meta = {
+  lint
+};
+export default meta;