Function cleanupStaleToolDocs

scripts/generate-docs.ts:3019–3044

* Remove any `docs/tools/*.mdx` that no longer corresponds to a visible * `category: 'tools'` block — covers both hidden blocks and blocks that * have been re-categorized to `'blocks'` / `'triggers'`. Keeps the * tools/ docs directory in lockstep with the canonical block registry.

(validToolDocs: Set<string>)

 * tools/ docs directory in lockstep with the canonical block registry.
 */
function cleanupStaleToolDocs(validToolDocs: Set<string>): void {
  console.log('Cleaning up stale tool docs...')

  const existingDocs = fs
    .readdirSync(DOCS_OUTPUT_PATH)
    .filter((file: string) => file.endsWith('.mdx'))

  let removedCount = 0

  for (const docFile of existingDocs) {
    const blockType = path.basename(docFile, '.mdx')
    if (HANDWRITTEN_INTEGRATION_DOCS.has(blockType)) continue
    if (validToolDocs.has(blockType)) continue

    const docPath = path.join(DOCS_OUTPUT_PATH, docFile)
    fs.unlinkSync(docPath)
    console.log(`✓ Removed stale tool doc: ${blockType}.mdx`)
    removedCount++
  }

  if (removedCount > 0) {
    console.log(`✓ Cleaned up ${removedCount} stale tool doc files`)
  } else {
    console.log('✓ No stale tool docs to clean up')
  }
}

// ============================================================================
// Trigger Documentation Generation