@cosmicdrift/kumiko-dev-server 0.349.0 → 0.351.0

package/bin/kumiko-build.ts

@@ -31,6 +31,13 @@ import {
   runCodegen,
 } from "@cosmicdrift/kumiko-dev-server/cli";
 
+if (process.argv.slice(2).some((arg) => arg === "--help" || arg === "-h")) {
+  process.stdout.write(
+    "Usage: kumiko-build [app-dir]   build client (dist/) and server (dist-server/) bundles\n",
+  );
+  process.exit(0);
+}
+
 const explicit = process.argv[2];
 const cwd = explicit ? resolve(process.cwd(), explicit) : process.cwd();
 

package/bin/kumiko-dev.ts

@@ -26,9 +26,14 @@ const MAX_CRASHES = 5;
 const CRASH_WINDOW_MS = 10_000;
 const CRASH_BACKOFF_MS = 500;
 
+const USAGE = "Usage: kumiko-dev <server-entry.ts> [server args...]\n";
 const entry = process.argv[2];
+if (entry === "--help" || entry === "-h") {
+  process.stdout.write(USAGE);
+  process.exit(0);
+}
 if (entry === undefined || entry === "") {
-  process.stderr.write("Usage: kumiko-dev <server-entry.ts>\n");
+  process.stderr.write(USAGE);
   process.exit(2);
 }
 

package/bin/kumiko-schema-check.ts

@@ -98,7 +98,13 @@ async function readMountedFeatures(runConfigPath: string): Promise<Set<string>>
   return set;
 }
 
+const USAGE = "Usage: kumiko-schema-check [--run-config <path>] [--generate <path>]";
+
 async function main(): Promise<void> {
+  if (process.argv.slice(2).some((arg) => arg === "--help" || arg === "-h")) {
+    console.log(USAGE);
+    process.exit(0);
+  }
   const args = parseArgs(process.argv.slice(2));
 
   if (!existsSync(args.runConfigPath)) {

package/dist/init-deploy-cli.js

@@ -8,6 +8,15 @@ import { getFlag, getNumberFlag, getStringFlag, parseArgs, } from "@cosmicdrift/
 import * as z from "zod";
 import { checkDeployDrift, scaffoldDeploy } from "./scaffold-deploy.js";
 const USAGE = "Usage: kumiko-init-deploy --app <name> [--port <n>] [--github-org <org>] [--out <dir>] [--force | --check]";
+const HELP = `${USAGE}
+
+  --app <name>         app name (default: package.json "name" without its @scope/)
+  --port <n>           port the container exposes
+  --github-org <org>   GitHub org for the image reference
+  --out <dir>          project directory to scaffold into (default: cwd)
+  --force              overwrite existing deploy files
+  --check              drift check only, exit 1 if deploy/ is stale
+  -h, --help           print this help and exit`;
 const packageNameSchema = z.object({ name: z.string().optional() });
 /** package.json `name` without its `@scope/` prefix, if present and valid. */
 function defaultAppName(cwd) {
@@ -74,6 +83,10 @@ function reportScaffold(target, force, out) {
     return 0;
 }
 export async function runInitDeployCli({ argv, cwd, out, }) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        out.log(HELP);
+        return 0;
+    }
     const args = parseArgs(argv);
     const force = getFlag(args, "force");
     const check = getFlag(args, "check");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.349.0",
+  "version": "0.351.0",
   "description": "Dev-tooling for Kumiko apps: local dev-server bootstrap (runDevApp), scaffolding, codegen. Its compose-stacks/env-schema subpaths are consumed at prod boot too — see @cosmicdrift/kumiko-server-runtime for the prod runner itself.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -64,11 +64,11 @@
     "kumiko-upgrade": "./bin/kumiko-upgrade.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.349.0",
-    "@cosmicdrift/kumiko-framework": "0.349.0",
-    "@cosmicdrift/kumiko-headless": "0.349.0",
-    "@cosmicdrift/kumiko-renderer-web": "0.349.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.349.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.351.0",
+    "@cosmicdrift/kumiko-framework": "0.351.0",
+    "@cosmicdrift/kumiko-headless": "0.351.0",
+    "@cosmicdrift/kumiko-renderer-web": "0.351.0",
+    "@cosmicdrift/kumiko-server-runtime": "0.351.0",
     "bun-types": "^1.3.13",
     "ts-morph": "^28.0.0",
     "zod": "^4.4.3"

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.351.0",
+    "type": "fix",
+    "title": "--help prints usage instead of running the command (init-deploy, build, dev, schema-check, kumiko-testing integration)",
+    "detail": "`--help` prints usage on every bin\n`kumiko-init-deploy --help` used to write the deploy files, and `kumiko-testing integration --help` crashed while parsing its arguments. Both now print their usage and exit 0, as do `kumiko-build`, `kumiko-dev`, `kumiko-schema-check` and `create-kumiko-app`."
+  },
   {
     "version": "0.349.0",
     "type": "improvement",