create-kumiko-app 0.410.0 → 0.411.0

package/README.md

@@ -15,6 +15,7 @@ are resolved automatically — picking `auth-email-password` pulls in
 
 ```sh
 bun create kumiko-app my-app --yes      # take every recommended feature
+bun create kumiko-app my-app --blank    # no demo tasks, no seeded password; set it via "forgot password"
 bun create kumiko-app --print-manifest  # JSON dump of the picker choices
 ```
 

package/feature-manifest.json

@@ -1,6 +1,6 @@
 {
   "source": "samples/apps/use-all-bundled APP_FEATURES (composeFeatures includeBundled + signup)",
-  "featureCount": 92,
+  "featureCount": 93,
   "features": [
     {
       "name": "account-security",
@@ -2249,6 +2249,28 @@
         "recommended": false
       }
     },
+    {
+      "name": "presence",
+      "description": "Who else is on this record right now: a browser sends a heartbeat every 15 seconds for one row of an allow-listed entity and gets the other viewers and editors back, with a live signal to them on a change. State is ephemeral (Redis hash per tenant, entity and row, in-memory without Redis), keyed by the session tenant, expires after ttlSeconds without a heartbeat and holds user ids only; display names are looked up per response. A caller sees presence only for rows visible to them. Mount with createPresenceFeature({ entities: [\"task\"] }).",
+      "toggleableDefault": null,
+      "requires": [],
+      "optionalRequires": [],
+      "configReads": [],
+      "exposesApis": [],
+      "usesApis": [],
+      "extensionsUsed": [],
+      "configKeys": [],
+      "secrets": [],
+      "writeHandlers": [
+        "presence:write:heartbeat",
+        "presence:write:leave"
+      ],
+      "uiHints": {
+        "displayLabel": "Presence",
+        "category": "communication",
+        "recommended": false
+      }
+    },
     {
       "name": "rate-limiting",
       "description": "Adds an ops-side `rate-limiting:query:status` query handler for inspecting current bucket state; the actual request throttling is wired automatically by the dispatcher when any handler declares a `rateLimit` option (e.g. `{ per: 'user', limit: 3, windowSeconds: 60 }`) or when you pass `context.rateLimit` to `buildServer`. Loading this feature is optional if you only need L3 per-handler rate limits and have no need for ops introspection.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-kumiko-app",
-  "version": "0.410.0",
+  "version": "0.411.0",
   "description": "`bun create kumiko-app <name>` — scaffold a new Kumiko app with an interactive feature picker.",
   "license": "MIT",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -27,10 +27,10 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-dev-server": "0.410.0",
-    "@cosmicdrift/kumiko-framework": "0.410.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.410.0",
-    "@cosmicdrift/kumiko-testing": "0.410.0",
+    "@cosmicdrift/kumiko-dev-server": "0.411.0",
+    "@cosmicdrift/kumiko-framework": "0.411.0",
+    "@cosmicdrift/kumiko-server-runtime": "0.411.0",
+    "@cosmicdrift/kumiko-testing": "0.411.0",
     "@inquirer/core": "^10.3.2",
     "@inquirer/prompts": "^7.10.1"
   },

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.411.0",
+    "type": "improvement",
+    "title": "--blank flag",
+    "detail": "`bun create kumiko-app <name> --blank` scaffolds the blank starter: no demo tasks, no seeded password; the creator sets one through \"forgot password\" after the first start with `KUMIKO_BOOTSTRAP_ADMIN_EMAIL`."
+  },
   {
     "version": "0.409.0",
     "type": "improvement",

package/src/index.ts

@@ -4,14 +4,19 @@
 // --print-manifest / --yes) → resolve deps → map to scaffold entries →
 // scaffoldApp() → print next-steps.
 
-import { type ScaffoldFeatureEntry, scaffoldApp } from "@cosmicdrift/kumiko-dev-server";
+import {
+  type ScaffoldFeatureEntry,
+  type ScaffoldStarter,
+  scaffoldApp,
+} from "@cosmicdrift/kumiko-dev-server";
 import { renderTestSetup } from "@cosmicdrift/kumiko-testing/scaffold";
 import { resolveDeps } from "./dep-resolver";
 import { FEATURE_CONSTRUCTORS } from "./feature-constructors";
 import { loadManifest, type Manifest } from "./manifest";
 import { buildChoices, runPicker } from "./picker";
 
-const USAGE = "Usage: bun create kumiko-app <name> [--yes] [--print-manifest] [-h | --help]";
+const USAGE =
+  "Usage: bun create kumiko-app <name> [--yes] [--blank] [--print-manifest] [-h | --help]";
 
 export type CliArgs = {
   /** App name (kebab-case). Required for `scaffold` mode. */
@@ -20,6 +25,8 @@ export type CliArgs = {
   readonly printManifest?: boolean;
   /** Skip the interactive picker, take every `recommended:true` feature. */
   readonly yes?: boolean;
+  /** `blank` scaffolds no demo tasks and no seeded password; the creator sets one via password reset. */
+  readonly starter?: ScaffoldStarter;
   /** Print usage and exit 0 without scaffolding. */
   readonly help?: boolean;
   /** Override cwd for scaffoldApp (mostly for the smoke test). */
@@ -76,6 +83,7 @@ export async function runCreate(args: CliArgs): Promise<number> {
     cwd: args.cwd,
     features,
     testSetup: renderTestSetup,
+    ...(args.starter !== undefined && { starter: args.starter }),
   });
 
   log("");
@@ -86,7 +94,11 @@ export async function runCreate(args: CliArgs): Promise<number> {
   log("  bun install");
   log("  cp .env.example .env  # set JWT_SECRET + KUMIKO_SECRETS_MASTER_KEY_V1");
   log("  docker compose up -d   # if you don't have Postgres + Redis running yet");
-  log("  bun dev                # demo tasks are pre-seeded — URL + login in the banner");
+  log(
+    args.starter === "blank"
+      ? "  bun dev                # URL + local dev login in the banner; prod admin: see README"
+      : "  bun dev                # demo tasks are pre-seeded — URL + login in the banner",
+  );
   return 0;
 }
 
@@ -101,6 +113,7 @@ export function parseArgv(argv: readonly string[]): CliArgs {
   for (const arg of argv) {
     if (arg === "--print-manifest") out.printManifest = true;
     else if (arg === "--yes" || arg === "-y") out.yes = true;
+    else if (arg === "--blank") out.starter = "blank";
     else if (arg === "--help" || arg === "-h") out.help = true;
     else if (!arg.startsWith("-") && out.name === undefined) out.name = arg;
   }