Function getCanonicalToolDocNames

scripts/generate-docs.ts:2987–3011

* Compute the canonical set of stripped block types that should have a * `docs/tools/*.mdx` file — namely every visible `category: 'tools'` block * (matching the writer filter at the top of this script). Any existing MDX * not in this set is stale and gets cleaned up. * * Uses `extractAllBlockC

()

 * version naturally wins for both generation and cleanup.
 */
async function getCanonicalToolDocNames(): Promise<Set<string>> {
  const validToolDocs = new Set<string>()
  const blockFiles = (await glob(`${BLOCKS_PATH}/*.ts`)).sort()

  for (const blockFile of blockFiles) {
    const fileContent = fs.readFileSync(blockFile, 'utf-8')
    const configs = extractAllBlockConfigs(fileContent)

    for (const config of configs) {
      // Match the writer filter: integration blocks, the documented
      // native-resource blocks (category 'blocks'), and trigger-only service
      // blocks (category 'triggers') whose pages the trigger pass writes.
      const stripped = config.type ? stripVersionSuffix(config.type) : ''
      const isDocumentedResource = NATIVE_RESOURCE_BLOCK_TYPES.has(stripped)
      const isTriggerService =
        config.category === 'triggers' &&
        !config.hideFromToolbar &&
        stripped !== 'sim_workspace_event'
      if (!isIntegrationBlock(config) && !isDocumentedResource && !isTriggerService) continue
      validToolDocs.add(stripped)
    }
  }

  return validToolDocs
}

/**
 * Remove any `docs/tools/*.mdx` that no longer corresponds to a visible