Function generateReference

scripts/generate-docs.ts:293–432

(
  title: string,
  outputPath: string,
  toolsWithAnnotations: ToolWithAnnotations[],
  categories: Record<string, ToolWithAnnotations[]>,
  sortedCategories: string[],
)

}

async function generateReference(
  title: string,
  outputPath: string,
  toolsWithAnnotations: ToolWithAnnotations[],
  categories: Record<string, ToolWithAnnotations[]>,
  sortedCategories: string[],
) {
  console.log(`Found ${toolsWithAnnotations.length} tools`);

  // Generate markdown documentation
  let markdown = `<!-- AUTO GENERATED DO NOT EDIT - run 'npm run gen' to update-->

# ${title}

`;
  // Generate table of contents
  for (const category of sortedCategories) {
    const categoryTools = categories[category];
    const categoryName = labels[category];
    const anchorName = categoryName.toLowerCase().replace(/\s+/g, '-');
    markdown += `- **[${categoryName}](#${anchorName})** (${categoryTools.length} tools)\n`;

    // Sort tools within category for TOC
    categoryTools.sort(sortTools);
    for (const tool of categoryTools) {
      // Generate proper markdown anchor link: backticks are removed, keep underscores, lowercase
      const anchorLink = tool.name.toLowerCase();
      markdown += `  - [\`${tool.name}\`](#${anchorLink})\n`;
    }
  }
  markdown += '\n';

  for (const category of sortedCategories) {
    const categoryTools = categories[category];
    const categoryName = labels[category];

    markdown += `## ${categoryName}\n\n`;

    if (OFF_BY_DEFAULT_CATEGORIES.includes(category)) {
      const flagName = `--${buildFlag(category)}`;

      markdown += `> NOTE: The ${categoryName} category is not active by default. Use the '${flagName}' flag.\n\n`;
    }

    // Sort tools within category
    categoryTools.sort(sortTools);

    for (const tool of categoryTools) {
      markdown += `### \`${tool.name}\`\n\n`;

      if (tool.description) {
        // Escape HTML tags but preserve JS function syntax
        let escapedDescription = escapeHtmlTags(tool.description);

        const requiredFlags: string[] = [];

        const isOffByDefault = OFF_BY_DEFAULT_CATEGORIES.includes(category);
        if (isOffByDefault) {