unoverse 0.1.7 → 0.1.9

package/bin/unoverse.mjs

@@ -50,18 +50,39 @@ const OPERATOR_COMMANDS = new Set([
 
 const [, , cmd, ...args] = process.argv;
 
-const HELP = `
-  ⬡ unoverse
+// 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.
+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");
+const dim = paint("2");
+const cyan = paint("36");
+const green = paint("32");
 
-  unoverse create [name]   What are you building? Studio project · universe · client app
-                           No name scaffolds into the folder you are in; a name makes one
-  unoverse studio          Launch Unoverse Studio (authoring: components, nodes, skills)
-  unoverse where           Where your universe is — addresses probed live, not recited
-  unoverse update          Update this CLI to the latest version
-  unoverse help            This
+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));
 
-  Standing in a universe folder adds: start · stop · check · logs · deploy
-`;
+const HELP = [
+  "",
+  `  ${cyan("⬡")} ${bold("unoverse")}`,
+  "",
+  ...CMDS.flatMap(([cmd, desc, note]) => [
+    `  ${green(cmd)}${" ".repeat(PAD - cmd.length)}   ${desc}`,
+    ...(note ? [`  ${" ".repeat(PAD)}   ${dim(note)}`] : []),
+  ]),
+  "",
+].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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unoverse",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "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",