unoverse 0.1.212 → 0.1.213

package/lib/login.mjs

@@ -174,7 +174,7 @@ export async function login(universeInput, { log = console.log } = {}) {
   if (!config.authEnabled) {
     throw new Error(
       `${origin} has authentication switched off, so there is no account to sign in with.\n` +
-        `  To deploy there, set UNOVERSE_TOKEN to a deploy key minted on the universe itself.`,
+        `  To deploy there, set UNOVERSE_TOKEN to a publish key minted on the universe itself.`,
     );
   }
   if (!config.issuer) throw new Error(`${origin} has no identity provider configured.`);
@@ -257,13 +257,13 @@ export async function tokenFor(origin, { interactive = true, log = console.log }
   } else if (!config.authEnabled) {
     throw new Error(
       `${origin} has authentication switched off.\n` +
-        `  To deploy there, set UNOVERSE_TOKEN to a deploy key minted on the universe itself.`,
+        `  To deploy there, set UNOVERSE_TOKEN to a publish key minted on the universe itself.`,
     );
   }
 
   if (!interactive || !process.stdin.isTTY) {
     throw new Error(
-      `No credential for ${origin}. In CI, set UNOVERSE_TOKEN to a deploy key.\n` +
+      `No credential for ${origin}. In CI, set UNOVERSE_TOKEN to a publish key.\n` +
         `  At a terminal, run: unoverse login ${origin}`,
     );
   }

package/lib/publish.mjs

@@ -1,5 +1,5 @@
 /**
- * unoverse publish — ship an asset workspace's items to its universe.
+ * unoverse deploy studio: ship an asset workspace's items to its universe.
  *
  * The terminal face of @unoverse-platform/base items/publish. The order is the safety:
  * LINT, then COMPARE (a dry-run per item against the universe), then a plan and a
@@ -49,7 +49,7 @@ const ask = async (question) => {
 };
 
 /**
- * `unoverse publish [project] [--to <universe>] [--dry-run] [--yes]`
+ * `unoverse deploy studio [project] [--to <universe> | --env <name>] [--dry-run] [--yes]`
  * Run from anywhere inside an asset workspace. bin/unoverse.mjs routes here only when
  * the nearest marker up from cwd is a design home.
  */
@@ -59,7 +59,9 @@ export async function publish(args) {
     const i = args.indexOf(`--${name}`);
     return i >= 0 ? args[i + 1] : undefined;
   };
-  const positional = args.find((a) => !a.startsWith("--") && a !== opt("to"));
+  // An option's value is never the project: `--env uat` must not read "uat" as one.
+  const optionValues = new Set(["to", "env"].map(opt).filter(Boolean));
+  const positional = args.find((a) => !a.startsWith("--") && !optionValues.has(a));
 
   const ws = findWorkspace();
   if (ws?.kind !== "assets") die("no design/ folder here or above. Run this inside your workspace.");
@@ -81,10 +83,20 @@ export async function publish(args) {
     die(`no project "${project}" in ${designRoot}. Found: ${projects.join(", ") || "none"}`);
   }
 
-  // ── which universe: --to overrides, unoverse.yaml remembers, the login answers,
-  //    and only a machine that knows nothing asks ─────────────────────────────
+  // ── which universe: --to overrides, --env names one from unoverse.yaml's
+  //    `environments:`, `universe:` is the default, the login answers, and only a
+  //    machine that knows nothing asks ─────────────────────────────────────────
   const config = await readConfig(ws.root);
-  let universe = opt("to") ?? config.universe;
+  const envName = opt("env");
+  let envUniverse;
+  if (envName && !opt("to")) {
+    envUniverse = config.environments?.[envName];
+    if (!envUniverse) {
+      const known = Object.keys(config.environments ?? {});
+      die(`no environment "${envName}" in unoverse.yaml. ${known.length ? `Found: ${known.join(", ")}` : "Add one:\n\n    environments:\n      " + envName + ": https://your-universe.example"}`);
+    }
+  }
+  let universe = opt("to") ?? envUniverse ?? config.universe;
   if (!universe) {
     // THE LOGIN ALREADY NAMED THE UNIVERSE. `unoverse login` takes an address and
     // keeps a session for it, so a machine signed in to exactly one universe has

package/lib/ui.mjs

@@ -22,7 +22,7 @@ export async function ask(rl, q) {
 }
 
 export const OPTIONS = [
-  ["Studio", "Components, agents and workflows", "Most people start here"],
+  ["Studio", "Components, apps, agents and nodes", "Most people start here"],
   ["Universe", "Run the platform yourself, on your own infrastructure"],
   ["Client", "A client accelerator that talks to unoverse"],
 ];

package/lib/workspace.mjs

@@ -6,10 +6,11 @@
  * reason studio keeps one: this package is plain node and cannot import base's TypeScript.
  * Keep the three in step.
  *
- * `unoverse.yaml` at the workspace root is the COMMITTED project config — today one key,
- * `universe:`, the publish target. It is config, not a secret: the whole team and CI
- * publish to the same place, which is exactly why it belongs in the repo. Credentials
- * never live here (they are per machine, in ~/.unoverse — see session.mjs).
+ * `unoverse.yaml` at the workspace root is the COMMITTED project config: `universe:`, the
+ * default deploy target, and `environments:`, named targets (`uat`, `production`) that CI
+ * picks with `--env`. It is config, not a secret: the whole team and CI deploy to the same
+ * places, which is exactly why it belongs in the repo. Credentials never live here (they
+ * are per machine in ~/.unoverse, see session.mjs, or a CI secret in UNOVERSE_TOKEN).
  */
 import { existsSync, renameSync, readFileSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";

package/package.json

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

package/vendor/base/lint/design/index.mjs

@@ -924,6 +924,15 @@ function componentNamesForFile(file) {
   const org = projectSegs.join("/");
   const cached = componentNamesCache.get(org);
   if (cached !== undefined) return cached;
+  // A PARTIAL SET IS WORSE THAN NO SET (the app-sizes trap below, same cause). A developer's
+  // project has no design system on disk, so DS falls back to DESIGN_ROOT and only the org's
+  // own names would be left: every marketplace name a preview uses (`card`) then reads as
+  // unknown, and a fresh Studio workspace failed lint on its own sample. Unverifiable here,
+  // so not asserted.
+  if (DS === DESIGN_ROOT) {
+    componentNamesCache.set(org, null);
+    return null;
+  }
   const dirs = [
     join(DS, "components"),
     join(DESIGN_ROOT, ...projectSegs, "components"),