Function main

scripts/docs/src/generate-cli-docs.ts:591–647

()

}

async function main(): Promise<void> {
  const repoRoot = getRepoRoot();
  const cli = await getProgram(repoRoot);

  const outputArg = process.argv[2];

  if (!outputArg) {
    throw new Error(
      "Output directory is required. Usage: generate-cli-docs <output-directory>",
    );
  }

  const outputDir = resolve(process.cwd(), outputArg);
  await mkdir(outputDir, { recursive: true });

  const topLevelCommands = cli.commands.filter(
    (command) => command.parent === cli && !isHiddenCommand(command),
  );

  if (topLevelCommands.length === 0) {
    console.warn("No top-level commands found. Nothing to document.");
    return;
  }

  const docs = topLevelCommands.map((command) =>
    buildCommandDoc(command, cli.name()),
  );
  const indexDoc = buildIndexDoc(topLevelCommands, cli.name());

  for (const doc of [...docs, indexDoc]) {
    const filePath = join(outputDir, doc.fileName);
    await mkdir(dirname(filePath), { recursive: true });
    const formatted = await formatWithPrettier(doc.mdx, filePath);
    await writeFile(filePath, formatted, "utf8");
    console.log(`✅ Saved ${doc.commandPath} docs to ${filePath}`);
  }

  if (process.env.GITHUB_ACTIONS) {
    const commentMarker = "<!-- generate-cli-docs -->";
    const combinedMarkdown = docs
      .map((doc) => doc.markdown)
      .join("\n\n---\n\n");

    const commentBody = [
      commentMarker,
      "",
      "Your PR updates Lingo.dev CLI behavior. Please review the regenerated reference docs below.",
      "",
      combinedMarkdown,
    ].join("\n");

    await createOrUpdateGitHubComment({
      commentMarker,
      body: commentBody,
    });
  }
}