unoverse 0.1.9 → 0.1.11

package/bin/unoverse.mjs

@@ -50,9 +50,12 @@ const OPERATOR_COMMANDS = new Set([
 
 const [, , cmd, ...args] = process.argv;
 
-// Same visual language as the operator half and the boot readout
-// (packages/base/src/boot.ts): dim structure, ONE accent, green for the words you type.
-// NO_COLOR is honoured — a help screen is the first thing piped into a file.
+// FIRST CONTACT. Someone who has never seen this reads it, so it answers two questions
+// before listing anything: what is this, and what do I type first. A flat list of six
+// commands answered neither.
+//
+// Visual language matches the boot readout (packages/base/src/boot.ts): dim structure,
+// one accent, green for the words you type. No em dashes (house style).
 const COLOR = !process.env.NO_COLOR && process.stdout.isTTY !== false;
 const paint = (code) => (t) => (COLOR ? `\x1b[${code}m${t}\x1b[0m` : t);
 const bold = paint("1");
@@ -60,29 +63,25 @@ const dim = paint("2");
 const cyan = paint("36");
 const green = paint("32");
 
-const CMDS = [
-  ["create [name]", "What are you building? Studio project · universe · client app",
-   "No name scaffolds into the folder you are in; a name makes one"],
-  ["studio", "Author components, nodes, agent skills"],
-  ["where", "Your universe's addresses, probed live, not recited"],
-  ["update", "Update this CLI to the latest version"],
-  ["help", "This"],
-];
-const PAD = Math.max(...CMDS.map(([c]) => c.length));
+const PAD = 16;
+const row = (cmd, desc) => `    ${green(cmd)}${" ".repeat(Math.max(1, PAD - cmd.length))}${desc}`;
 
 const HELP = [
   "",
   `  ${cyan("⬡")} ${bold("unoverse")}`,
   "",
-  ...CMDS.flatMap(([cmd, desc, note]) => [
-    `  ${green(cmd)}${" ".repeat(PAD - cmd.length)}   ${desc}`,
-    ...(note ? [`  ${" ".repeat(PAD)}   ${dim(note)}`] : []),
-  ]),
+  `  ${dim("Build agent-powered apps. Interfaces as data, workflows on a canvas,")}`,
+  `  ${dim("agent skills in plain markdown.")}`,
+  "",
+  `  ${bold("First time")}`,
+  row("create", `Asks what you're building, then sets it up`),
+  "",
+  `  ${bold("After that")}`,
+  row("studio", "Design components, nodes and agent skills"),
+  row("where", "Your universe's addresses"),
+  row("update", "Update this CLI"),
   "",
 ].join("\n");
-// NO "in a universe folder, add: ..." line. It named a thing a new user has never seen
-// and listed commands they cannot run. The CLI already knows where you are standing, so
-// those commands appear when they apply and stay invisible when they do not.
 
 switch (cmd) {
   case "create":

package/lib/create.mjs

@@ -99,14 +99,15 @@ export async function create(nameArg) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   try {
     console.log(`\n  ${cyan("⬡ What are you building?")}\n`);
-    console.log("  1. A Studio project    — author components, nodes, agent skills (most people start here)");
-    console.log("  2. A universe          — run the full platform on your own infrastructure (operators)");
-    console.log("  3. A client app        — a website/embed against an existing universe\n");
+    console.log(`  1. ${"A Studio project".padEnd(20)}Components, nodes and agent skills`);
+    console.log(`  ${dim("   " + "".padEnd(20) + "Most people start here")}`);
+    console.log(`  2. ${"A universe".padEnd(20)}Run the platform on your own infrastructure`);
+    console.log(`  3. ${"A client app".padEnd(20)}A website that talks to a universe\n`);
 
     const choice = (await ask(rl, "Choose [1]: ")) || "1";
 
     if (choice === "1") {
-      console.log(`\n  ${dim("Launching Unoverse Studio — it creates and manages your projects.")}\n`);
+      console.log(`\n  ${dim("Launching Unoverse Studio. It creates and manages your projects.")}\n`);
       rl.close();
       const r = spawnSync("npx", ["-y", "@unoverse-platform/studio@latest"], { stdio: "inherit" });
       process.exit(r.status ?? 0);
@@ -114,10 +115,10 @@ export async function create(nameArg) {
 
     if (choice === "2") {
       console.log(`\n  ${cyan("A universe needs a registry access token.")}`);
-      console.log(`  ${dim("It authorizes the platform's images — issued by your Unoverse admin.")}\n`);
+      console.log(`  ${dim("It authorizes the platform's images. Your Unoverse admin issues it.")}\n`);
       const token = await ask(rl, "Registry access token: ");
       if (!token) {
-        fail("no token — the universe kit is available to licensed operators");
+        fail("no token. The universe kit is available to licensed operators");
         process.exit(1);
       }
       process.stdout.write("  validating against the registry...");
@@ -145,7 +146,7 @@ export async function create(nameArg) {
         env: { ...process.env, UNOVERSE_DOCR_TOKEN: token },
       });
       if (r.status !== 0) {
-        fail("setup did not finish — run 'unoverse init' in that folder to pick it up");
+        fail("setup did not finish. Run 'unoverse init' in that folder to pick it up");
         process.exit(r.status ?? 1);
       }
       console.log(`
@@ -153,7 +154,7 @@ export async function create(nameArg) {
     cd ${name}`}
     unoverse start
 
-  ${cyan("Build with Claude:")} open the folder in Claude Code — it ships an
+  ${cyan("Build with Claude:")} open the folder in Claude Code. It ships an
   authoring skill (components, nodes, agent skills) and a builder MCP that
   constructs workflows live on your Canvas. Ask for what you want.
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unoverse",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "The Unoverse front door — create a Studio project, a universe, or a client app, and launch Studio.",
   "license": "SEE LICENSE IN README.md",
   "type": "module",