Function parseWorkflowMetadata

eng/yaml-parser.mjs:262–298

* Parse workflow metadata from a standalone .md workflow file * @param {string} filePath - Path to the workflow .md file * @returns {object|null} Workflow metadata or null on error

(filePath)

 * @returns {object|null} Workflow metadata or null on error
 */
function parseWorkflowMetadata(filePath) {
  return safeFileOperation(
    () => {
      if (!fs.existsSync(filePath)) {
        return null;
      }

      const frontmatter = parseFrontmatter(filePath);

      // Validate required fields
      if (!frontmatter?.name || !frontmatter?.description) {
        console.warn(
          `Invalid workflow at ${filePath}: missing name or description in frontmatter`
        );
        return null;
      }

      // Extract triggers from the 'on' field (top-level keys)
      const onField = frontmatter.on;
      const triggers = [];
      if (onField && typeof onField === "object") {
        triggers.push(...Object.keys(onField));
      } else if (typeof onField === "string") {
        triggers.push(onField);
      }

      return {
        name: frontmatter.name,
        description: frontmatter.description,
        triggers,
        path: filePath,
      };
    },
    filePath,
    null
  );
}

/**
 * Parse a generic YAML file (used for tools.yml and other config files)