unoverse 0.1.10 → 0.1.12

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,30 +63,24 @@ const dim = paint("2");
 const cyan = paint("36");
 const green = paint("32");
 
-const CMDS = [
-  // TWO LINES, not one with a caveat. "No name scaffolds into the folder you are in;
-  // a name makes one" made the reader hold both cases in their head to understand either.
-  ["create", "What are you building? Studio project · universe · client app"],
-  ["create <name>", "The same, in a new folder"],
-  ["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.map(([cmd, desc]) =>
-    `  ${green(cmd)}${" ".repeat(PAD - cmd.length)}   ${desc}`,
-  ),
+  `  ${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("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/lib/urls.mjs

@@ -1,13 +1,41 @@
 /**
- * `unoverse where` — the deployed stack's addresses, PROBED, not recited.
+ * `unoverse where` answers one question: where is my universe, right now.
  *
- * Named `urls` until 0.1.5; that spelling still works as an alias.
+ * BOTH HALVES. It used to report only the deployed stack, and `unoverse open` handled
+ * localhost separately. Folding `open` into `where` (2026-07-31) lost the local half
+ * until this: "where is it" means the copy on this machine AND the one on your server,
+ * because on any given day it is one, the other, or both.
+ *
+ * PROBED, not recited. Every address is actually requested and reported by what
+ * answered. A URL you cannot click is a hope, not an address.
+ *
+ * Deployed facts come from .env.production first, the ground's terraform outputs as
+ * enrichment. Local needs no config: a port is either listening or it is not.
  *
- * Run it in a universe folder (or anywhere above one). It reads the deployment's
- * own facts — .env.production first, the ground's terraform outputs as enrichment —
- * builds every URL a person or client would use, then actually requests each one
- * and reports what answered. A URL you cannot click is a hope, not an address.
+ * Named `urls` until 0.1.5; that spelling still works as an alias.
  */
+
+// What docker-compose publishes on this machine (docker-compose.yml).
+const LOCAL = [
+  { label: "Canvas", url: "http://localhost:3001" },
+  { label: "API", url: "http://localhost:4105", note: "MCP at /mcp" },
+  { label: "Logs", url: "http://localhost:8080", note: "Dozzle" },
+];
+
+/** One titled block of probed addresses. */
+function section(title, rows, subtitle) {
+  const labelWidth = Math.max(...rows.map((r) => r.label.length));
+  const urlWidth = Math.max(...rows.map((r) => r.url.length));
+  const up = rows.filter((r) => r.up).length;
+  console.log("");
+  console.log(`  ${up === rows.length ? green("●") : up ? cyan("●") : red("●")} ${bold(title)}   ${dim(`${up} of ${rows.length} answering${subtitle ? `  ·  ${subtitle}` : ""}`)}`);
+  console.log("");
+  for (const r of rows) {
+    const status = r.up ? dim(`${r.status}`) : red("no answer");
+    console.log(`  ${r.up ? green("●") : red("✗")} ${dim(r.label.padEnd(labelWidth))}   ${cyan(r.url.padEnd(urlWidth))}   ${status}${r.note ? `  ${dim(r.note)}` : ""}`);
+  }
+}
+
 import { existsSync, readFileSync } from "node:fs";
 import { join, resolve, dirname } from "node:path";
 import { spawnSync } from "node:child_process";
@@ -66,52 +94,47 @@ async function probe(url) {
 
 export async function urls() {
   const root = findUniverseRoot();
-  if (!root) {
-    console.log(`\n  ${red("✗")} no .env.production found here or above — run this inside a universe folder`);
-    console.log(`  ${dim("(a universe is deployed from its checkout: terraform apply renders .env.production)")}\n`);
-    process.exit(1);
-  }
 
-  const env = parseEnv(join(root, ".env.production"));
-  const tf = terraformOutputs(root);
-  const domain = env.DOMAIN || "";
-
-  // The same law as the ground: DOMAIN drives HTTPS URLs; without it, the
-  // explicit API_URL (rendered by terraform) carries the LB address.
-  const apiBase = domain ? `https://api.${domain}` : env.API_URL || tf.api_url || "";
-  const candidates = [];
-  if (apiBase) {
-    candidates.push({ label: "API", url: apiBase, note: "MCP at /mcp" });
-    candidates.push({ label: "Health", url: `${apiBase}/health` });
-  }
-  const canvas = tf.canvas_url && tf.canvas_url.startsWith("http") ? tf.canvas_url : null;
-  if (canvas) candidates.push({ label: "Canvas", url: canvas, note: "add to IdP origins" });
-  if (env.DEPLOY_HOST) candidates.push({ label: "Dozzle", url: `http://${env.DEPLOY_HOST}:8080`, note: "logs, admin IP only" });
-  if (tf.cognito_hosted_ui) candidates.push({ label: "Login", url: tf.cognito_hosted_ui });
+  // LOCAL first, and unconditionally. Whether something is listening on this machine is
+  // a fact, not a configuration question, so it needs no universe folder to answer.
+  const local = await Promise.all(LOCAL.map(async (c) => ({ ...c, ...(await probe(c.url)) })));
 
-  if (!candidates.length) {
-    console.log(`\n  ${red("✗")} .env.production has neither DOMAIN nor API_URL — re-render it from the ground:`);
-    console.log(`  ${dim("cd infra/<ground> && terraform output -raw env_production > ../../.env.production")}\n`);
-    process.exit(1);
+  // DEPLOYED, only if this checkout has been deployed. No .env.production is not an
+  // error: plenty of universes only ever run locally.
+  let deployed = [];
+  let domain = "";
+  if (root) {
+    const env = parseEnv(join(root, ".env.production"));
+    const tf = terraformOutputs(root);
+    domain = env.DOMAIN || "";
+    // The same law as the ground: DOMAIN drives HTTPS URLs; without it, the
+    // explicit API_URL (rendered by terraform) carries the LB address.
+    const apiBase = domain ? `https://api.${domain}` : env.API_URL || tf.api_url || "";
+    const candidates = [];
+    if (apiBase) {
+      candidates.push({ label: "API", url: apiBase, note: "MCP at /mcp" });
+      candidates.push({ label: "Health", url: `${apiBase}/health` });
+    }
+    const canvas = tf.canvas_url && tf.canvas_url.startsWith("http") ? tf.canvas_url : null;
+    if (canvas) candidates.push({ label: "Canvas", url: canvas, note: "add to IdP origins" });
+    if (env.DEPLOY_HOST) candidates.push({ label: "Logs", url: `http://${env.DEPLOY_HOST}:8080`, note: "admin IP only" });
+    if (tf.cognito_hosted_ui) candidates.push({ label: "Login", url: tf.cognito_hosted_ui });
+    deployed = await Promise.all(candidates.map(async (c) => ({ ...c, ...(await probe(c.url)) })));
   }
 
-  const results = await Promise.all(candidates.map(async (c) => ({ ...c, ...(await probe(c.url)) })));
-
-  const labelWidth = Math.max(...results.map((r) => r.label.length));
-  const urlWidth = Math.max(...results.map((r) => r.url.length));
-  const upCount = results.filter((r) => r.up).length;
-  const rule = dim("─".repeat(Math.min(70, urlWidth + labelWidth + 12)));
-  const mark = (r) => (r.up ? green("●") : red("✗"));
+  const anyUp = [...local, ...deployed].some((r) => r.up);
+  const rule = dim("─".repeat(64));
 
   console.log("");
   console.log(`  ${rule}`);
-  console.log(`  ${upCount === results.length ? green("●") : red("●")} ${bold("universe")}   ${dim(`${upCount} of ${results.length} answering${domain ? "" : "  ·  domainless (plain HTTP) — set domain in terraform.tfvars to upgrade"}`)}`);
-  console.log("");
-  for (const r of results) {
-    const status = r.up ? dim(`${r.status}`) : red("no answer");
-    console.log(`  ${mark(r)} ${dim(r.label.padEnd(labelWidth))}   ${cyan(r.url.padEnd(urlWidth))}   ${status}${r.note ? `  ${dim(r.note)}` : ""}`);
+  section("on this machine", local, local.some((r) => r.up) ? "" : "not running  ·  unoverse start");
+  if (deployed.length) {
+    section("deployed", deployed, domain ? "" : "domainless (plain HTTP)");
+  } else {
+    console.log("");
+    console.log(`  ${dim("● deployed")}   ${dim(root ? "nothing to probe yet" : "not deployed from here  ·  unoverse deploy")}`);
   }
   console.log(`  ${rule}`);
   console.log("");
-  if (upCount < results.length) process.exit(1);
+  if (!anyUp) process.exit(1);
 }

package/package.json

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