Function generateWorkflowsSection

eng/update-readme.mjs:530–581

* Generate the workflows section with a table of all agentic workflows

(workflowsDir)

 * Generate the workflows section with a table of all agentic workflows
 */
function generateWorkflowsSection(workflowsDir) {
  if (!fs.existsSync(workflowsDir)) {
    console.log(`Workflows directory does not exist: ${workflowsDir}`);
    return "";
  }

  // Get all .md workflow files (flat, no subfolders)
  const workflowFiles = fs.readdirSync(workflowsDir).filter((file) => {
    return file.endsWith(".md") && file !== ".gitkeep";
  });

  // Parse each workflow file
  const workflowEntries = workflowFiles
    .map((file) => {
      const filePath = path.join(workflowsDir, file);
      const metadata = parseWorkflowMetadata(filePath);
      if (!metadata) return null;

      return {
        file,
        name: metadata.name,
        description: metadata.description,
        triggers: metadata.triggers,
        tags: metadata.tags,
      };
    })
    .filter((entry) => entry !== null)
    .sort((a, b) => a.name.localeCompare(b.name));

  console.log(`Found ${workflowEntries.length} workflow(s)`);

  if (workflowEntries.length === 0) {
    return "";
  }

  // Create table header
  let content =
    "| Name | Description | Triggers |\n| ---- | ----------- | -------- |\n";

  // Generate table rows for each workflow
  for (const workflow of workflowEntries) {
    const link = `../workflows/${workflow.file}`;
    const triggers =
      workflow.triggers.length > 0 ? workflow.triggers.join(", ") : "N/A";

    content += `| [${workflow.name}](${link}) | ${formatTableCell(
      workflow.description
    )} | ${triggers} |\n`;
  }

  return `${TEMPLATES.workflowsSection}\n${TEMPLATES.workflowsUsage}\n\n${content}`;
}

/**
 * Generate the skills section with a table of all skills