O CMake aparentemente já tem, há algum tempo, algo chamado "API de arquivo CMake" :
O CMake fornece uma API baseada em arquivo que os clientes podem usar para obter informações semânticas sobre os buildsystems que o CMake gera. Os clientes podem usar a API gravando arquivos de consulta em um local específico em uma árvore de build para solicitar zero ou mais Object Kinds. Quando o CMake gera o buildsystem nessa árvore de build, ele lê os arquivos de consulta e grava os arquivos de resposta para o cliente ler.
Não entendo quando e por quem isso deve ser usado. Consequentemente, não entendo se, como mantenedor de um projeto que emprega CMake, preciso me preocupar com essa API e "atender" às solicitações satisfatórias usando-a. Preciso?
Observação: se a resposta depender do tipo de projeto CMake que eu mantenho, escolha alguns exemplos (pois eu uso o CMake em mais de um tipo de projeto).
Não - a API de arquivo do CMake deve ser usada por desenvolvedores de IDEs e integrações de IDE.
Você não.