From 454f094c364fa6c2003d3b61fe43b89e5db886dd Mon Sep 17 00:00:00 2001
From: Ayaan Zaidi <hi@obviy.us>
Date: Fri, 27 Mar 2026 20:31:28 +0530
Subject: [PATCH] fix: avoid source imports in cli startup metadata build

---
 scripts/write-cli-startup-metadata.ts | 32 +++++++++++++++++++++++++--
 1 file changed, 30 insertions(+), 2 deletions(-)

diff --git a/scripts/write-cli-startup-metadata.ts b/scripts/write-cli-startup-metadata.ts
index 67648c38646..630275ecc08 100644
--- a/scripts/write-cli-startup-metadata.ts
+++ b/scripts/write-cli-startup-metadata.ts
@@ -1,7 +1,7 @@
 import { mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { renderRootHelpText } from "../src/cli/program/root-help.ts";
+import { pathToFileURL } from "node:url";
 
 function dedupe(values: string[]): string[] {
   const seen = new Set<string>();
@@ -76,9 +76,37 @@ function readBundledChannelCatalogIds(): string[] {
     .map((entry) => entry.id);
 }
 
+async function renderBundledRootHelpText(): Promise<string> {
+  const bundleName = readdirSync(distDir).find(
+    (entry) => entry.startsWith("root-help-") && entry.endsWith(".js"),
+  );
+  if (!bundleName) {
+    throw new Error("No root-help bundle found in dist; cannot write CLI startup metadata.");
+  }
+  const moduleUrl = pathToFileURL(path.join(distDir, bundleName)).href;
+  const mod = (await import(moduleUrl)) as { outputRootHelp?: () => void };
+  if (typeof mod.outputRootHelp !== "function") {
+    throw new Error(`Bundle ${bundleName} does not export outputRootHelp.`);
+  }
+
+  let output = "";
+  const originalWrite = process.stdout.write.bind(process.stdout);
+  const captureWrite: typeof process.stdout.write = ((chunk: string | Uint8Array) => {
+    output += String(chunk);
+    return true;
+  }) as typeof process.stdout.write;
+  process.stdout.write = captureWrite;
+  try {
+    mod.outputRootHelp();
+  } finally {
+    process.stdout.write = originalWrite;
+  }
+  return output;
+}
+
 const catalog = readBundledChannelCatalogIds();
 const channelOptions = dedupe([...CORE_CHANNEL_ORDER, ...catalog]);
-const rootHelpText = renderRootHelpText();
+const rootHelpText = await renderBundledRootHelpText();
 
 mkdirSync(distDir, { recursive: true });
 writeFileSync(