@codemation/cli 0.0.22 → 0.0.24

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as CliProgram, i as CliPathResolver, n as CliProgramFactory, o as ConsumerOutputBuilder, r as CodemationCliApplicationSession, s as ConsumerBuildOptionsParser, t as CliBin } from "./CliBin-PdQvm7od.js";
+import { a as CliProgram, i as CliPathResolver, n as CliProgramFactory, o as ConsumerOutputBuilder, r as CodemationCliApplicationSession, s as ConsumerBuildOptionsParser, t as CliBin } from "./CliBin-CWXW_92Y.js";
 import { CodemationPluginDiscovery } from "@codemation/host/server";
 
 export { CliBin, CliPathResolver, CliProgram, CliProgramFactory, CodemationCliApplicationSession, CodemationPluginDiscovery, ConsumerBuildOptionsParser, ConsumerOutputBuilder };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemation/cli",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "publishConfig": {
     "access": "public"
   },
@@ -38,8 +38,8 @@
     "reflect-metadata": "^0.2.2",
     "typescript": "^5.9.3",
     "ws": "^8.19.0",
-    "@codemation/next-host": "0.1.0",
-    "@codemation/host": "0.1.0"
+    "@codemation/next-host": "0.1.2",
+    "@codemation/host": "0.1.2"
   },
   "devDependencies": {
     "@types/http-proxy": "^1.17.15",

package/src/CliProgramFactory.ts

@@ -21,6 +21,8 @@ import { HostPackageRootResolver } from "./database/HostPackageRootResolver";
 import { PrismaMigrationDeployer } from "@codemation/host/persistence";
 import { DevBootstrapSummaryFetcher } from "./dev/DevBootstrapSummaryFetcher";
 import { DevCliBannerRenderer } from "./dev/DevCliBannerRenderer";
+import { DevNextChildProcessOutputFilter } from "./dev/DevNextChildProcessOutputFilter";
+import { DevNextStartupBannerLineFilter } from "./dev/DevNextStartupBannerLineFilter";
 import { CliDevProxyServerFactory } from "./dev/CliDevProxyServerFactory";
 import { DevApiRuntimeFactory } from "./dev/DevApiRuntimeFactory";
 import { DevRebuildQueueFactory } from "./dev/DevRebuildQueueFactory";
@@ -100,6 +102,7 @@ export class CliProgramFactory {
       new DevApiRuntimeFactory(devSessionServices.loopbackPortAllocator, appConfigLoader, pluginDiscovery),
       new CliDevProxyServerFactory(),
       new DevRebuildQueueFactory(),
+      new DevNextChildProcessOutputFilter(new DevNextStartupBannerLineFilter()),
     );
     return new CliProgram(
       buildOptionsParser,

package/src/commands/DevCommand.ts

@@ -13,6 +13,7 @@ import type { DevBootstrapSummaryFetcher } from "../dev/DevBootstrapSummaryFetch
 import type { CliDevProxyServer } from "../dev/CliDevProxyServer";
 import type { CliDevProxyServerFactory } from "../dev/CliDevProxyServerFactory";
 import type { DevCliBannerRenderer } from "../dev/DevCliBannerRenderer";
+import type { DevNextChildProcessOutputFilter } from "../dev/DevNextChildProcessOutputFilter";
 import { ConsumerEnvDotenvFilePredicate } from "../dev/ConsumerEnvDotenvFilePredicate";
 import type { DevRebuildQueueFactory } from "../dev/DevRebuildQueueFactory";
 import type { DevSourceWatcher } from "../dev/DevSourceWatcher";
@@ -49,6 +50,7 @@ export class DevCommand {
     private readonly devApiRuntimeFactory: DevApiRuntimeFactory,
     private readonly cliDevProxyServerFactory: CliDevProxyServerFactory,
     private readonly devRebuildQueueFactory: DevRebuildQueueFactory,
+    private readonly devNextChildProcessOutputFilter: DevNextChildProcessOutputFilter,
   ) {}
 
   async execute(
@@ -112,11 +114,16 @@ export class DevCommand {
       await this.startPackagedUiWhenNeeded(prepared, processState, uiProxyBase);
       this.bindShutdownSignalsToChildProcesses(processState, proxyServer);
       await this.spawnDevUiWhenNeeded(prepared, processState, gatewayBaseUrl);
+      this.devCliBannerRenderer.renderGatewayListeningHint(
+        prepared.devMode === "watch-framework" ? prepared.nextPort : prepared.gatewayPort,
+        commandName,
+        prepared.devMode,
+        prepared.devMode === "watch-framework" ? prepared.gatewayPort : undefined,
+      );
       await this.startWatcherForSourceRestart(prepared, processState, watcher, devMode, gatewayBaseUrl, proxyServer, {
         commandName,
         configPathOverride: args.configPathOverride,
       });
-      this.logPackagedUiDevHintWhenNeeded(devMode, gatewayPort, commandName);
       await stopPromise;
     } finally {
       if (previousDevelopmentServerToken === undefined) {
@@ -234,9 +241,10 @@ export class DevCommand {
     });
     state.currentPackagedUi = spawn(nextHostCommand.command, nextHostCommand.args, {
       cwd: nextHostCommand.cwd,
-      ...this.devDetachedChildSpawnOptions(),
+      ...this.devDetachedChildSpawnPipeOptions(),
       env: nextHostEnvironment,
     });
+    this.devNextChildProcessOutputFilter.attach(state.currentPackagedUi);
     state.currentPackagedUi.on("error", (error) => {
       if (state.stopRequested || state.isRestartingUi) {
         return;
@@ -276,14 +284,18 @@ export class DevCommand {
     proxyServer.setBuildStatus("idle");
   }
 
-  private devDetachedChildSpawnOptions(): Readonly<{
-    stdio: "inherit";
+  /**
+   * Next startup lines are filtered (see {@link DevNextChildProcessOutputFilter}) so the CLI can
+   * own the primary “open this URL” message without the internal loopback port dominating stdout.
+   */
+  private devDetachedChildSpawnPipeOptions(): Readonly<{
+    stdio: ["ignore", "pipe", "pipe"];
     detached: boolean;
     windowsHide?: boolean;
   }> {
     return process.platform === "win32"
-      ? { stdio: "inherit", detached: true, windowsHide: true }
-      : { stdio: "inherit", detached: true };
+      ? { stdio: ["ignore", "pipe", "pipe"], detached: true, windowsHide: true }
+      : { stdio: ["ignore", "pipe", "pipe"], detached: true };
   }
 
   private bindShutdownSignalsToChildProcesses(
@@ -341,9 +353,10 @@ export class DevCommand {
     });
     state.currentDevUi = spawn("pnpm", ["exec", "next", "dev"], {
       cwd: nextHostRoot,
-      ...this.devDetachedChildSpawnOptions(),
+      ...this.devDetachedChildSpawnPipeOptions(),
       env: nextHostEnvironment,
     });
+    this.devNextChildProcessOutputFilter.attach(state.currentDevUi);
     state.currentDevUi.on("exit", (code) => {
       const normalizedCode = code ?? 0;
       if (state.stopRequested || state.isRestartingUi) {
@@ -591,17 +604,4 @@ export class DevCommand {
     await this.consumerBuildArtifactsPublisher.publish(snapshot, discoveredPlugins);
     this.cliLogger.debug(`Dev: consumer output published (${snapshot.buildVersion}).`);
   }
-
-  private logPackagedUiDevHintWhenNeeded(
-    devMode: DevMode,
-    gatewayPort: number,
-    commandName: "dev" | "dev:plugin",
-  ): void {
-    if (devMode !== "packaged-ui") {
-      return;
-    }
-    this.cliLogger.info(
-      `codemation ${commandName}: open http://127.0.0.1:${gatewayPort} — this uses the packaged @codemation/next-host UI. Use \`codemation ${commandName} --watch-framework\` only when working on the framework UI itself.`,
-    );
-  }
 }

package/src/dev/DevCliBannerRenderer.ts

@@ -49,6 +49,45 @@ export class DevCliBannerRenderer {
     this.renderRuntimeSummary(summary);
   }
 
+  /**
+   * URL to open in the browser: packaged UI uses the CLI gateway port; watch-framework uses the
+   * Next.js dev port (PORT). When they differ, {@link devGatewayPort} is shown in the footer.
+   */
+  renderGatewayListeningHint(
+    browserPort: number,
+    commandName: "dev" | "dev:plugin",
+    devMode: "packaged-ui" | "watch-framework",
+    devGatewayPort?: number,
+  ): void {
+    const url = `http://127.0.0.1:${browserPort}`;
+    const footer =
+      devMode === "watch-framework"
+        ? chalk.dim(
+            devGatewayPort !== undefined && devGatewayPort !== browserPort
+              ? `The dev gateway (API + runtime) is at http://127.0.0.1:${devGatewayPort}. Open the URL above for the Next.js UI (HMR).`
+              : "Open the URL above for the Next.js UI.",
+          )
+        : chalk.dim(
+            `The UI is served through this URL (not the internal Next port). Framework UI work in the monorepo: \`codemation ${commandName} --watch-framework\`.`,
+          );
+    const bodyLines = [
+      chalk.whiteBright.bold("Codemation is running"),
+      "",
+      `${chalk.hex("#9ca3af")("Open in your browser:")}  ${chalk.greenBright.underline(url)}`,
+      "",
+      footer,
+    ];
+    const box = boxen(bodyLines.join("\n"), {
+      padding: { top: 0, bottom: 0, left: 1, right: 1 },
+      margin: { top: 1, bottom: 0 },
+      borderStyle: "double",
+      borderColor: "green",
+      title: chalk.bold("Codemation dev"),
+      titleAlignment: "center",
+    });
+    process.stdout.write(`${box}\n`);
+  }
+
   /**
    * Shown after hot reload / watcher restarts (no figlet).
    */

package/src/dev/DevNextChildProcessOutputFilter.ts

@@ -0,0 +1,30 @@
+import type { ChildProcess } from "node:child_process";
+import { createInterface } from "node:readline";
+
+import type { DevNextStartupBannerLineFilter } from "./DevNextStartupBannerLineFilter";
+
+/**
+ * Attaches to a spawned Next child process and forwards streams while dropping
+ * {@link DevNextStartupBannerLineFilter} matches (startup banner only).
+ */
+export class DevNextChildProcessOutputFilter {
+  constructor(private readonly lineFilter: DevNextStartupBannerLineFilter) {}
+
+  attach(child: ChildProcess): void {
+    this.pipeFilteredStream(child.stdout, process.stdout);
+    this.pipeFilteredStream(child.stderr, process.stderr);
+  }
+
+  private pipeFilteredStream(source: NodeJS.ReadableStream | null, sink: NodeJS.WritableStream): void {
+    if (!source) {
+      return;
+    }
+    const rl = createInterface({ input: source, crlfDelay: Infinity });
+    rl.on("line", (line) => {
+      if (this.lineFilter.shouldSuppress(line)) {
+        return;
+      }
+      sink.write(`${line}\n`);
+    });
+  }
+}

package/src/dev/DevNextStartupBannerLineFilter.ts

@@ -0,0 +1,25 @@
+/**
+ * Filters noisy Next.js `next start` / `next dev` startup lines so the CLI can
+ * surface the Codemation gateway URL as the primary “where to browse” signal.
+ */
+export class DevNextStartupBannerLineFilter {
+  shouldSuppress(line: string): boolean {
+    const t = line.replace(/\r$/, "").trimEnd();
+    if (t.length === 0) {
+      return false;
+    }
+    if (/^\s*▲\s+Next\.js/.test(t)) {
+      return true;
+    }
+    if (/^\s*-\s+Local:\s+/.test(t)) {
+      return true;
+    }
+    if (/^\s*-\s+Network:\s+/.test(t)) {
+      return true;
+    }
+    if (/^\s*✓\s+Ready\b/.test(t)) {
+      return true;
+    }
+    return false;
+  }
+}