@cosmicdrift/kumiko-cli 0.412.0 → 0.413.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-cli",
-  "version": "0.412.0",
+  "version": "0.413.0",
   "description": "CLI for Kumiko apps. `bunx @cosmicdrift/kumiko-cli new app <name>` scaffolds a runnable workspace; `add feature <name>` mounts a feature; `check` runs boot validation plus the guard suites with the step list derived from kumiko.json; `agent lint`, `project` and `consumer` operate on an existing app; `handbuch build` renders the HTML handbuch.",
   "license": "MIT",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -36,19 +36,19 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-dev-server": "0.412.0",
-    "@cosmicdrift/kumiko-feature-ast": "0.412.0",
-    "@cosmicdrift/kumiko-guards": "0.412.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.412.0",
-    "@cosmicdrift/kumiko-testing": "0.412.0",
+    "@cosmicdrift/kumiko-dev-server": "0.413.0",
+    "@cosmicdrift/kumiko-feature-ast": "0.413.0",
+    "@cosmicdrift/kumiko-guards": "0.413.0",
+    "@cosmicdrift/kumiko-server-runtime": "0.413.0",
+    "@cosmicdrift/kumiko-testing": "0.413.0",
     "marked": "^18.1.2",
     "zod": "^4.6.7"
   },
   "peerDependencies": {
     "sharp": "^0.35.5",
-    "@cosmicdrift/kumiko-bundled-features": "0.412.0",
-    "@cosmicdrift/kumiko-framework": "0.412.0",
-    "@cosmicdrift/kumiko-renderer": "0.412.0"
+    "@cosmicdrift/kumiko-bundled-features": "0.413.0",
+    "@cosmicdrift/kumiko-framework": "0.413.0",
+    "@cosmicdrift/kumiko-renderer": "0.413.0"
   },
   "peerDependenciesMeta": {
     "sharp": {
@@ -65,9 +65,9 @@
     }
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.412.0",
-    "@cosmicdrift/kumiko-framework": "0.412.0",
-    "@cosmicdrift/kumiko-renderer": "0.412.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.413.0",
+    "@cosmicdrift/kumiko-framework": "0.413.0",
+    "@cosmicdrift/kumiko-renderer": "0.413.0",
     "sharp": "^0.35.5"
   },
   "publishConfig": {

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.413.0",
+    "type": "fix",
+    "title": "Help output of kumiko and create-kumiko-app starts without loading the scaffolder",
+    "detail": "Both CLIs imported the `@cosmicdrift/kumiko-dev-server` barrel at the top, so every call, including `--help`, loaded framework, server-runtime and renderer (about 0.7 s cold). `kumiko new app`, `kumiko add feature`, `kumiko ports` and the create-kumiko-app scaffold step now import those modules when they run. Measured on an idle machine: `kumiko --help` 0.67 s to 0.03 s, `kumiko check --help` 0.67 s to 0.03 s, `create-kumiko-app --help` 0.65 s to 0.02 s."
+  },
   {
     "version": "0.405.0",
     "type": "improvement",

package/src/commands/ports.ts

@@ -1,9 +1,4 @@
 import { resolve } from "node:path";
-import {
-  findPortCollisions,
-  listAppPorts,
-  scanWorkspaceApps,
-} from "@cosmicdrift/kumiko-guards/repo-manifest/app-ports";
 import type { CliCommand, CliCommandContext } from "./types";
 
 // Fixed column order so the table reads the same in every run.
@@ -14,6 +9,9 @@ export async function runPorts(ctx: CliCommandContext): Promise<number> {
     ctx.out.err("  usage: kumiko ports [workspace-root]");
     return 1;
   }
+  const { findPortCollisions, listAppPorts, scanWorkspaceApps } = await import(
+    "@cosmicdrift/kumiko-guards/repo-manifest/app-ports"
+  );
   const root = resolve(ctx.cwd, ctx.argv[0] ?? ".");
   const apps = scanWorkspaceApps(root);
   if (apps.length === 0) {

package/src/index.ts

@@ -9,8 +9,6 @@
 // `consumer`). Workspace-only maintainer commands (ci:guards, dev, build, …)
 // stay in the framework repo's bin/kumiko.ts.
 
-import { scaffoldApp, scaffoldAppFeature } from "@cosmicdrift/kumiko-dev-server";
-import { renderTestSetup } from "@cosmicdrift/kumiko-testing/scaffold";
 import type { CliCommand } from "./commands";
 import { APP_COMMANDS, findAppCommand } from "./commands";
 import { missingPeerMessage } from "./missing-peer";
@@ -48,7 +46,7 @@ export async function runCli(options: RunCliOptions): Promise<number> {
   }
 
   if (first === "new") return await runNew(argv.slice(1), out, cwd);
-  if (first === "add") return runAdd(argv.slice(1), out, cwd);
+  if (first === "add") return await runAdd(argv.slice(1), out, cwd);
 
   const appCommand = findAppCommand(first);
   if (appCommand) {
@@ -89,6 +87,9 @@ async function runNew(args: readonly string[], out: Output, cwd: string): Promis
     return 1;
   }
   try {
+    // Loaded on demand: the dev-server barrel costs ~0.6 s cold, which every --help paid before.
+    const { scaffoldApp } = await import("@cosmicdrift/kumiko-dev-server");
+    const { renderTestSetup } = await import("@cosmicdrift/kumiko-testing/scaffold");
     const result = await scaffoldApp({
       name,
       destination: `${cwd}/${name}`,
@@ -109,7 +110,7 @@ async function runNew(args: readonly string[], out: Output, cwd: string): Promis
   }
 }
 
-function runAdd(args: readonly string[], out: Output, cwd: string): number {
+async function runAdd(args: readonly string[], out: Output, cwd: string): Promise<number> {
   const [subject, name] = args;
   if (subject !== "feature") {
     out.err(`kumiko add: only "add feature <name>" is supported. Got "${subject ?? "(nothing)"}".`);
@@ -120,6 +121,7 @@ function runAdd(args: readonly string[], out: Output, cwd: string): number {
     return 1;
   }
   try {
+    const { scaffoldAppFeature } = await import("@cosmicdrift/kumiko-dev-server");
     const result = scaffoldAppFeature({ name, appRoot: cwd });
     out.log(`✓ Added feature ${result.featureName}:`);
     for (const f of result.files) out.log(`  ${f}`);